Утилита для прошивки микроконтроллеров. Предназначена для чтения, записи и получения информации о RISC микроконтроллерах семейства AVR (в частности, К1946ВМ014), работающих с загрузчиком Optiboot (или другим совместимым) через последовательный порт (UART). Поддерживает полноценную работу с Flash и EEPROM памятью микроконтроллеров. Работает с Intel HEX файлами.

Утилита разработана и используется с ядром RuCore для Arduino IDE (но может быть использована и как самостоятельный инструмент).

Проект создан с любовью к отечественной электронике и open-source сообществу. Буду рад вашим Pull Requests и Issues!

Использование

easymcu [-p порт] [-b скорость] команда [аргументы]
 
# Получить сигнатуру устройства:
easymcu -p /dev/cu.usbserial-1234 info
 
#Прочитать прошивку в файл:
easymcu -p /dev/cu.usbserial-1234 read -o backup.hex
 
#Записать прошивку:
easymcu -p /dev/cu.usbserial-1234 write firmware.hex
 
#Прочитать EEPROM в файл:
easymcu -p /dev/ttyUSB0 read_eeprom -o eeprom_backup.hex
 
#Записать данные в EEPROM:
easymcu -p /dev/ttyUSB0 write_eeprom eeprom_data.hex
 
#Прочитать EEPROM с явным указанием размера (например, для других МК):
easymcu -p /dev/ttyUSB0 read_eeprom -o eeprom.hex -s 64

**Флаги:**q

-p, --port порт - Полный путь к UART порту, к которому подключена плата. Например, /dev/cu.usbserial-1234 или /dev/ttyUSB0.
-b, --baud скорость - Скорость обмена данными (baud rate). По умолчанию 115200.
-o, --output файл - Имя выходного файла для команды read.
-s, --size размер - Размер Flash-памяти в байтах для команды read. По умолчанию 8192.
-m, --mcu <чип> - Указать чип для валидации записи.
--skip-verify - Пропустить верификацию после записи.

Команды:

info Получить информацию об устройстве и прочитать его сигнатуру.
read - Прочитать Flash-память микроконтроллера и сохранить её в HEX файл. Требует указания флага -o.
write путь_к_файлу - Записать указанный HEX файл во Flash-память микроконтроллера.
read_eeprom - Прочитать EEPROM-память микроконтроллера и сохранить её в HEX файл. Требует указания флага -o.
write_eeprom путь_к_файлу Записать указанный HEX файл в EEPROM-память микроконтроллера.

Установка

Для установки скачайте актуальынй релиз и выполните установку для вашей ОС.

При сборке из исходных кодов достаточно указать make install

Статический анализатор

Проект проверяется статическим анализатором от PVS-Studio (для разработки на C, C++, C#, Go, и Java а так же Web (JS и TS)).

Нашли уязвимость? Пожалуйста, ознакомьтесь Политикой безопасности перед тем, как открывать Issue.

Хотите улучшить решение или принять участие в разработке? Вы можете подать обращение или внести правки и отправить пул реквест в соотвествии с инструкцией в вежливой форме.

Проект поставляется с MIT лицензией Gitverse (если не указано иного для библиотеки или файла). Подробнее указано в соотвествующем файле.