Параметры platformio.ini: различия между версиями

Материал из MIK32 микроконтроллер
(Добавлены параметры для текущей ветки)
Нет описания правки
 
(не показано 8 промежуточных версий 2 участников)
Строка 1: Строка 1:
== (Текущий релиз) board_debug - для опций, связанных с отладчиком ==
== Пример platformio.ini ==
'''board_debug.interface''' - выбор отладчика;
<syntaxhighlight lang="ini">
; Пример комментария
[env:mik32v2]
platform = MIK32
board = mik32v2
framework = framework-mik32v2-sdk
board_build.ldscript = spifi
</syntaxhighlight>


принимает значения - имена файлов в папке openocd\scripts\interface\ftdi без ".cfg";
== Настройки platformio.ini ==


по умолчанию board_debug.interface=m-link;
====== '''upload_protocol''' - выбор отладчика; ======
Возможные значения:


некоторые варианты:
* mikron-link - Программатор MIK32;
* olimex-arm-usb-ocd - Olimex ARM-USB-OCD;
* olimex-arm-usb-ocd-h - Olimex ARM-USB-OCD-H;
* olimex-arm-usb-tiny-h - Olimex ARM-USB-TINY-H;
* olimex-jtag-tiny - Olimex ARM-USB-TINY;
* jlink - JLink;
* altera-usb-blaster - USB Blaster;
* sipeed-rv-debugger - Sipeed RV Debugger.
Значение по умолчанию: <code>mikron-link</code>;


* m-link - Программатор MIK32;
Пример использования: <code>upload_protocol = jlink</code>.
* olimex-arm-usb-ocd-h - Olimex ARM-USB-OCD-H;
 
====== '''board_build.ldscript''' - выбор имени файла скрипта линковки; ======
По умолчанию поиск начинается в папке проекта. Можно задать путь к скрипту линковки.
 
При использовании framework = framework-mik32v2-sdk можно использовать следующие варианты:
* eeprom;
* spifi;
* ram;
При использовании framework = framework-mik32v2-sdk расширение .ld будет добавлено к имени файла, если не было указано.


'''board_debug.ldscript''' - выбор ld скрипта,
Значение по умолчанию: <code>eeprom</code>;


принимает значения - имена файлов в папке shared\ldscripts без ".ld";
Пример использования: <code>board_build.ldscript = spifi</code>.


по умолчанию board_debug.ldscript=eeprom;  
======  '''upload_speed''' - частота тактового сигнала интерфейса jtag, кГц. ======
Значение по умолчанию: <code>500</code>;


возможные значения: eeprom, ram, spifi;
Пример использования: <code>upload_speed = 3200</code>;


'''board_debug.adapter_speed''' - выбор частоты JTAG, в кГц;
Возможные значения: от <code>100</code> до <code>3200</code>.


по умолчанию board_debug.adapter_speed=500;
======  '''board_build.f_cpu''' - переопределение частоты основного генератора тактовой частоты, Гц в формате длинного числа Си. ======
Значение по умолчанию: <code>32000000</code>;


== (Ветка main) Настройки загрузки программы в МК ==
Пример использования: <code>board_build.f_cpu = 4000000</code>.
'''upload_protocol''' - выбор отладчика;


Значение по умолчанию: m-link;
Возможные значения: от <code>1000000</code> до <code>32000000</code>.


Возможные значения:
====== '''board_upload.maximum_size''' - переопределение максимального размера программы, байты. ======
Размер программы вычисляется Platformio по суммарному размеру секций .text и .data. Если для размещения программы используется только один вид памяти, то maximum_size нужно установить по объему этой памяти. Полезно для настройки максимального объема внешней памяти.


* m-link - Программатор MIK32;
Значение по умолчанию: <code>8192</code>;
* jlink - JLink;
* olimex-arm-usb-ocd - Olimex ARM-USB-OCD;
* olimex-arm-usb-ocd-h - Olimex ARM-USB-OCD-H;
* olimex-arm-usb-tiny-h - Olimex ARM-USB-TINY-H;
* olimex-jtag-tiny - Olimex ARM-USB-TINY.
'''board_build.ldscript''' - выбор ld скрипта;


Значение по умолчанию: eeprom;  
Пример использования: <code>board_upload.maximum_size = 4194304</code>;


Возможные значения:
Возможные значения: от <code>4</code> до <code>2147483648</code>.


* eeprom;
Больше настроек можно найти в официальной документации проекта: https://docs.platformio.org/en/latest/projectconf/sections/env/index.html#options
* spifi;
* ram.

Текущая версия от 15:06, 17 января 2025

Пример platformio.ini

; Пример комментария
[env:mik32v2]
platform = MIK32
board = mik32v2
framework = framework-mik32v2-sdk
board_build.ldscript = spifi

Настройки platformio.ini

upload_protocol - выбор отладчика;

Возможные значения:

  • mikron-link - Программатор MIK32;
  • olimex-arm-usb-ocd - Olimex ARM-USB-OCD;
  • olimex-arm-usb-ocd-h - Olimex ARM-USB-OCD-H;
  • olimex-arm-usb-tiny-h - Olimex ARM-USB-TINY-H;
  • olimex-jtag-tiny - Olimex ARM-USB-TINY;
  • jlink - JLink;
  • altera-usb-blaster - USB Blaster;
  • sipeed-rv-debugger - Sipeed RV Debugger.

Значение по умолчанию: mikron-link;

Пример использования: upload_protocol = jlink.

board_build.ldscript - выбор имени файла скрипта линковки;

По умолчанию поиск начинается в папке проекта. Можно задать путь к скрипту линковки.

При использовании framework = framework-mik32v2-sdk можно использовать следующие варианты:

  • eeprom;
  • spifi;
  • ram;

При использовании framework = framework-mik32v2-sdk расширение .ld будет добавлено к имени файла, если не было указано.

Значение по умолчанию: eeprom;

Пример использования: board_build.ldscript = spifi.

upload_speed - частота тактового сигнала интерфейса jtag, кГц.

Значение по умолчанию: 500;

Пример использования: upload_speed = 3200;

Возможные значения: от 100 до 3200.

board_build.f_cpu - переопределение частоты основного генератора тактовой частоты, Гц в формате длинного числа Си.

Значение по умолчанию: 32000000;

Пример использования: board_build.f_cpu = 4000000.

Возможные значения: от 1000000 до 32000000.

board_upload.maximum_size - переопределение максимального размера программы, байты.

Размер программы вычисляется Platformio по суммарному размеру секций .text и .data. Если для размещения программы используется только один вид памяти, то maximum_size нужно установить по объему этой памяти. Полезно для настройки максимального объема внешней памяти.

Значение по умолчанию: 8192;

Пример использования: board_upload.maximum_size = 4194304;

Возможные значения: от 4 до 2147483648.

Больше настроек можно найти в официальной документации проекта: https://docs.platformio.org/en/latest/projectconf/sections/env/index.html#options

Источник — http://wiki.mik32.ru/index.php?title=Параметры_platformio.ini&oldid=2380