3.19.34 Параметры Nios II

Это параметры, определенные для процессора Altera Nios II.

-G num

Поместить глобальные и статические объекты размером не более num байт в секции малых данных или BSS вместо обычных секций данных или BSS. Значение по умолчанию для num равно 8.

-mgpopt=option

-mgpopt

-mno-gpopt

Генерировать (не генерировать) GP-относительные обращения. Признаются следующие имена параметров option:

‘none’

Не генерировать GP-относительные обращения.

‘local’

Генерировать GP-относительные обращения для объектов малых данных, которые не являются внешними, слабыми или неинициализированными общими символами. Также использовать GP-относительную адресацию для объектов, которые явно помещены в секцию малых данных с помощью атрибута section.

‘global’

Как для ‘local’, но также генерировать GP-относительные обращения для объектов малых данных, которые являются внешними, слабыми или общими. Если вы используете этот параметр, вы должны убедиться, что все части вашей программы (включая библиотеки) скомпилированы с одинаковым параметром -G.

‘data’

Генерировать GP-относительные обращения для всех объектов данных в программе. Если вы используете этот параметр, весь сегмент данных и BSS вашей программы должен поместиться в 64К памяти, и вы должны использовать соответствующий скрипт компоновщика для размещения их в адресном диапазоне глобального указателя.

‘all’

Генерировать GP-относительные адреса для указателей функций, а также указателей данных. Если вы используете этот параметр, весь сегмент текста, данных и BSS вашей программы должен поместиться в 64К памяти, и вы должны использовать соответствующий скрипт компоновщика для размещения их в адресном диапазоне глобального указателя.

-mgpopt эквивалентно -mgpopt=local, а -mno-gpopt эквивалентно -mgpopt=none.

Значение по умолчанию — -mgpopt, за исключением случаев, когда указан -fpic или -fPIC для генерации позиционно-независимого кода. Обратите внимание, что Nios II ABI не допускает GP-относительных обращений из общих библиотек.

Возможно, вам потребуется явно указать -mno-gpopt при построении программ, содержащих большое количество малых данных, включая большие секции данных GOT. В этом случае 16-битный смещение для GP-относительной адресации может быть недостаточно для доступа ко всей секции малых данных.

-mgprel-sec=regexp

Этот параметр указывает дополнительные имена секций, к которым можно получить доступ с помощью GP-относительной адресации. Он наиболее полезен в сочетании с атрибутами section в объявлениях переменных (см. Общие атрибуты переменных) и пользовательским скриптом компоновщика. regexp — это POSIX расширенное регулярное выражение.

Этот параметр не влияет на поведение параметра -G, и указанные секции дополняют стандартные секции .sdata и .sbss малых данных, которые распознаются параметром -mgpopt.

-mr0rel-sec=regexp

Этот параметр указывает имена секций, к которым можно получить доступ с помощью 16-битного смещения от r0; то есть в нижних 32К или верхних 32К 32-битного адресного пространства. Он наиболее полезен в сочетании с атрибутами section в объявлениях переменных (см. Общие атрибуты переменных) и пользовательским скриптом компоновщика. regexp — это POSIX расширенное регулярное выражение.

В отличие от использования GP-относительной адресации для малых данных, нулевая адресация никогда не генерируется по умолчанию, и в стандартных скриптах компоновщика нет обычных имен секций для секций в нижней или верхней областях памяти.

-mel

-meb

Сгенерировать код с порядком байтов little-endian (по умолчанию) или big-endian (экспериментальный).

-march=arch

Указывает имя целевой архитектуры Nios II. GCC использует это имя для определения типа инструкций, которые могут быть выпущены при генерации кода ассемблера. Допустимые имена: ‘r1’, ‘r2’.

Для программ доступен препроцессорный макрос __nios2_arch__, со значением 1 или 2, указывающим уровень целевой ISA.

-mbypass-cache

-mno-bypass-cache

Принудительно заставить все инструкции загрузки и сохранения всегда обходить кэш, используя варианты инструкций ввода/вывода. По умолчанию кэш не обходится.

-mno-cache-volatile

-mcache-volatile

Доступ к памяти с атрибутом volatile обходит кэш, используя варианты инструкций загрузки и сохранения ввода/вывода. По умолчанию кэш не обходится.

-mno-fast-sw-div

-mfast-sw-div

Не использовать табличную быструю операцию деления для малых чисел. По умолчанию используется быстрое деление при -O3 и выше.

-mno-hw-mul

-mhw-mul

-mno-hw-mulx

-mhw-mulx

-mno-hw-div

-mhw-div

Включить или отключить генерацию компилятором инструкций mul, mulx и div семейств. По умолчанию генерируются инструкции mul, а не div и mulx.

-mbmx

-mno-bmx

-mcdx

-mno-cdx

Включить или отключить генерацию инструкций Nios II R2 BMX (битовая манипуляция) и CDX (плотность кода). Включение этих инструкций также требует -march=r2. Поскольку эти инструкции являются необязательными расширениями архитектуры R2, по умолчанию они не генерируются.

-mcustom-insn=N

-mno-custom-insn

Каждый параметр -mcustom-insn=N включает использование пользовательской инструкции с кодированием N при генерации кода, использующего insn. Например, -mcustom-fadds=253 генерирует пользовательскую инструкцию 253 для операций сложения с плавающей запятой одинарной точности вместо стандартного поведения, которое использует вызов библиотеки.

Поддерживаются следующие значения insn. За исключением случаев, специально оговоренных, операции с плавающей запятой ожидают реализации с нормальной семантикой IEEE 754 и напрямую соответствуют операторам C или эквивалентным встроенным функциям GCC (см. Другие встроенные функции, предоставляемые GCC).

Одинарная точность с плавающей запятой:

‘fadds’, ‘fsubs’, ‘fdivs’, ‘fmuls’

Бинарные арифметические операции.

‘fnegs’

Унарное отрицание.

‘fabss’

Унарное абсолютное значение.

‘fcmpeqs’, ‘fcmpges’, ‘fcmpgts’, ‘fcmples’, ‘fcmplts’, ‘fcmpnes’

Операции сравнения.

‘fmins’, ‘fmaxs’

Минимальное и максимальное значение с плавающей запятой. Эти инструкции генерируются только при указании -ffinite-math-only.

‘fsqrts’

Операция извлечения квадратного корня.

‘fcoss’, ‘fsins’, ‘ftans’, ‘fatans’, ‘fexps’, ‘flogs’

Тригонометрические и экспоненциальные функции с плавающей запятой. Эти инструкции генерируются только при указании также -funsafe-math-optimizations.

Двойная точность с плавающей запятой:

‘faddd’, ‘fsubd’, ‘fdivd’, ‘fmuld’

Бинарные арифметические операции.

‘fnegd’

Унарное отрицание.

‘fabsd’

Унарное абсолютное значение.

‘fcmpeqd’, ‘fcmpged’, ‘fcmpgtd’, ‘fcmpled’, ‘fcmpltd’, ‘fcmpned’

Операции сравнения.

‘fmind’, ‘fmaxd’

Минимальное и максимальное значение двойной точности. Эти инструкции генерируются только при указании -ffinite-math-only.

‘fsqrtd’

Операция извлечения квадратного корня.

‘fcosd’, ‘fsind’, ‘ftand’, ‘fatand’, ‘fexpd’, ‘flogd’

Тригонометрические и экспоненциальные функции двойной точности. Эти инструкции генерируются только при указании также -funsafe-math-optimizations.

Преобразования:

‘fextsd’

Преобразование из одинарной точности в двойную.

‘ftruncds’

Преобразование из двойной точности в одинарную.

‘fixsi’, ‘fixsu’, ‘fixdi’, ‘fixdu’

Преобразование из плавающей запятой в целые типы со знаком или без знака с усечением к нулю.

‘round’

Преобразование из одинарной плавающей запятой в целые со знаком, округление до ближайшего целого и при равенстве — от нуля. Это соответствует функции __builtin_lroundf, когда используется -fno-math-errno.

‘floatis’, ‘floatus’, ‘floatid’, ‘floatud’

Преобразование из целых типов со знаком или без знака в типы с плавающей запятой.

Кроме того, для использования любых инструкций с плавающей запятой двойной точности должны быть предоставлены все следующие инструкции передачи для внутренних регистров X и Y. Пользовательские инструкции, принимающие два операнда с плавающей запятой двойной точности, ожидают первого операнда в 64-битном регистре X. Другой операнд (или только операнд унарной операции) передаётся пользовательской арифметической инструкции с наименее значащей половиной в регистре-источнике src1 и наиболее значащей половиной в src2. Пользовательская инструкция, возвращающая результат двойной точности, возвращает наиболее значащие 32 бита в целевом регистре, а другую половину — в 32-битном регистре Y. GCC автоматически генерирует необходимые последовательности кода для записи регистра X и/или чтения регистра Y при использовании инструкций с плавающей запятой двойной точности.

‘fwrx’

Запись src1 в наименее значащую половину X и src2 в наиболее значащую половину X.

‘fwry’

Запись src1 в Y.

‘frdxhi’, ‘frdxlo’

Чтение наиболее или наименее (соответственно) значащей половины X и сохранение её в dest.

‘frdy’

Чтение значения Y и сохранение его в dest.

Обратите внимание, что вы можете получить больший локальный контроль над генерацией пользовательских инструкций Nios II, используя атрибуты функций target("custom-insn=N") и target("no-custom-insn") (см. Объявление атрибутов функций) или директивы (см. Директивы для конкретных функций).

-mcustom-fpu-cfg=name

Этот параметр включает предопределённый, именованный набор кодировок пользовательских инструкций (см. -mcustom-insn выше). В настоящее время определены следующие наборы:

-mcustom-fpu-cfg=60-1 эквивалентно:

-mcustom-fmuls=252
-mcustom-fadds=253
-mcustom-fsubs=254
-fsingle-precision-constant

-mcustom-fpu-cfg=60-2 эквивалентно:

-mcustom-fmuls=252
-mcustom-fadds=253
-mcustom-fsubs=254
-mcustom-fdivs=255
-fsingle-precision-constant

-mcustom-fpu-cfg=72-3 эквивалентно:

-mcustom-floatus=243
-mcustom-fixsi=244
-mcustom-floatis=245
-mcustom-fcmpgts=246
-mcustom-fcmples=249
-mcustom-fcmpeqs=250
-mcustom-fcmpnes=251
-mcustom-fmuls=252
-mcustom-fadds=253
-mcustom-fsubs=254
-mcustom-fdivs=255
-fsingle-precision-constant

-mcustom-fpu-cfg=fph2 эквивалентно:

-mcustom-fabss=224
-mcustom-fnegs=225
-mcustom-fcmpnes=226
-mcustom-fcmpeqs=227
-mcustom-fcmpges=228
-mcustom-fcmpgts=229
-mcustom-fcmples=230
-mcustom-fcmplts=231
-mcustom-fmaxs=232
-mcustom-fmins=233
-mcustom-round=248
-mcustom-fixsi=249
-mcustom-floatis=250
-mcustom-fsqrts=251
-mcustom-fmuls=252
-mcustom-fadds=253
-mcustom-fsubs=254
-mcustom-fdivs=255

Присваивания пользовательских инструкций, задаваемые индивидуальными параметрами -mcustom-insn=, переопределяют те, которые заданы -mcustom-fpu-cfg=, независимо от порядка параметров в командной строке.

Обратите внимание, что вы можете получить больший локальный контроль над выбором конфигурации FPU, используя атрибут функции target("custom-fpu-cfg=name") (см. Объявление атрибутов функций) или директиву (см. Директивы для конкретных функций).

Имя fph2 — это сокращение от Nios II Floating Point Hardware 2 Component. Обратите внимание, что пользовательские инструкции, включенные параметрами -mcustom-fmins=233 и -mcustom-fmaxs=234, генерируются только при указании -ffinite-math-only. Пользовательская инструкция, включенная параметром -mcustom-round=248, генерируется только при указании -fno-math-errno. В отличие от других конфигураций, -fsingle-precision-constant не устанавливается.

Доступны следующие дополнительные параметры ‘-m’ для целевой системы Altera Nios II ELF (bare-metal):

-mhal

Связь с HAL BSP. Это подавляет связывание с предоставленным GCC C-начальным и завершающим кодом, и обычно используется в сочетании с -msys-crt0= для указания местоположения альтернативного начального кода, предоставляемого HAL BSP.

-msmallc

Связывание с ограниченной версией C-библиотеки, -lsmallc, вместо Newlib.

-msys-crt0=startfile

startfile — имя файла startfile (crt0), используемого при линковке. Этот параметр полезен только в сочетании с -mhal.

-msys-lib=systemlib

systemlib — имя библиотеки, которая предоставляет системные вызовы низкого уровня, необходимые C-библиотеке, например, read и write. Этот параметр обычно используется для связывания с библиотекой, предоставленной HAL BSP.