Инструменты прошивки модулей на базе MCom-03

Поддерживаемые модули и памяти:

• MCom-03 BuB r1.3.0, r1.5.0 (QSPI0, QSPI1);
• NGFW-CB r1.0 с установленным ELV-MC03-SMARC r1.0, r1.1 (QSPI0);
• ROCK Pi N10 с установленным ELV-MC03-SMARC r1.0, r1.1 (QSPI0);
• ELV-SMARC-CB r1.0 с установленным ELV-MC03-SMARC r1.0, r1.1 (QSPI0);
• ELV-SMARC-CB r2.9.1 с установленным ELV-MC03-SMARC r2.2 (QSPI0);
• ELV-SMARC-CB r2.10 с установленным ELV-MC03-SMARC r1.0, r1.1 (QSPI0);
• ELV-SMARC-CB r2.10.3 с установленным ELV-MC03-SMARC r1.0, r1.1, r2.6.1 (QSPI0);
• ELV-SMARC-CB r3.1.0 с установленным ELV-MC03-SMARC r1.0, r1.1, r2.6.1 (QSPI0);
• ELV-SMARC-CB r3.2.1 с установленным ELV-MC03-SMARC r1.0, r1.1, r2.7.1 (QSPI0);
• ELV-MC03-CB r1.1.0 с установленным ELV-MC03 r1.2, r2.2 (QSPI0);
• MONO-BOARD r1.1.1 (QSPI0).

Прошивка выполняется по интерфейсу UART0: MCom-03 BootROM в режиме загрузки по UART принимает образ spi-flasher, spi-flasher запускается на RISC0, повышает частоты, принимает образы для прошивки по UART, прошивает соответствующую память QSPI и EEPROM.

Установка

Проверялось на Python 3.9. Требуются свежие версии pip, setuptools. Актуальные поддерживаемые версии Python см. в tox.ini:

export PATH=~/.local/bin:$PATH
python3 -m pip install --upgrade --user pip
hash pip3
pip3 install setuptools --upgrade

Пакет является стандартным пакетом Python. Установка выполняется любым из методов:

git clone https://github.com/elvees/mcom03-flash-tools.git
cd mcom03-flash-tools
pip3 install . --user

# or if you want to hack the code
pip3 install -e . --user

# or just
pip3 install git+https://github.com/elvees/mcom03-flash-tools.git --user

Note

Пакет использует пакет setuptools scm, для работы пакета при установке требуется директория .git. Установка из zip-файла не содержащего .git (например, zip-файл, загруженный через веб-интерфейс GitHub Download ZIP) не поддерживается.

Напряжение падов QSPI

Контроллер QSPI0 поддерживает только режим 1.8 В. Контроллер QSPI1 может настраивать пады в режим 1.8 В или 3.3 В.

Для конфигурации падов QSPI1 в режим 1.8 В используется параметр --voltage18. По умолчанию для QSPI1 утилита настраивает режим 3.3 В. Для QSPI0 данный параметр игнорируется и не влияет на работу падов.

Important

При использовании м/сх памяти, подключенных к QSPI1, с напряжением I/O 3.3 В указание параметра --voltage18 может привести к повреждению падов MCom-03.

Important

Параметр --voltage18 следует указывать для всех команд обращения к памяти (flash, read, erase).

Подготовка модуля

1. Установить переключатели в режим загрузки с UART:

   • на модуле NGFW-CB (BOOT2,1,0): ON, OFF, OFF
   • на модуле MCom-03 BuB (BOOT2,1,0): OFF, ON, ON
   • на модуле conga-SEVAL (BOOT_SEL2,1,0): ON, OFF, OFF
   • на модуле ROCK Pi N10 снять джампер с пинов GPIO 25,26 (GND,ADC_IN1)
   • на модуле ELV-SMARC-CB r1.0 (BOOT SOURCE: 1, 2, 3): ON, OFF, OFF
   • на модуле ELV-SMARC-CB r2.9.1, r2.10.3, r3.1.0, r3.2.1 (BTSL2,1,0): ON, OFF, OFF
   • на модуле ELV-MC03-CB (BOOT2,1,0): OFF, ON, ON
   • на модуле MONO-BOARD r1.1.1 (BOOT_SEL3,2,1): ON, OFF, OFF

2. Подключить кабель USB для UART-консоли модуля.

3. Подать питание на модуль (если модуль уже включен, то нажать кнопку Reset).

   Для модуля NGFW-CB необходимо дополнительно нажать кнопку Power.

4. Если на ПК открыто приложение использующее UART (minicom), то приложение необходимо закрыть.

Прошивка QSPI0

1. Запустить:

   mcom03-flash --port /dev/ttyUSBx flash qspi0 <file-to-write>
   

   /dev/ttyUSBx — устройство терминала UART0 на ПК.

2. После завершения прошивки будет выведена фраза Checking succeeded и указана длительность и скорость прошивки. Скорость прошивки ограничена скоростью UART 115200 б/с и составляет ~8 КБ/с.

   Note

   Если при запуске на модуле NGFW-CB будет выдано исключение из-за несовпадения CRC, возможно, после включения питания не была нажата кнопка Power.

Important

Для загрузки с QSPI0 установить переключатели в положения:

• на модуле NGFW-CB (BOOT2,1,0): ON, ON, ON
• на модуле MCom-03 BuB (BOOT2,1,0): OFF, OFF, OFF
• на модуле conga-SEVAL (BOOT_SEL2,1,0): ON, ON, ON
• на модуле ROCK Pi N10 установить джампер на пины GPIO 25,26 (GND,ADC_IN1)
• на модуле ELV-SMARC-CB r1.0 (BOOT SOURCE: 1, 2, 3): ON, ON, ON
• на модуле ELV-SMARC-CB r2.9.1, r2.10.3, r3.1.0, r3.2.1 (BTSL2,1,0): ON, ON, ON
• на модуле ELV-MC03-CB (BOOT2,1,0): OFF, OFF, OFF
• на модуле MONO-BOARD r1.1.1 (BOOT_SEL3,2,1): ON, ON, ON

Чтение QSPI0

Для чтения образа используется команда read утилиты mcom03-flash:

mcom03-flash --port /dev/ttyUSBx read qspi0 <output-file> [size-in-bytes]

Если размер не указан, то будет прочитано содержимое всей памяти. Пример использования:

mcom03-flash --port /dev/ttyUSB0 read qspi0 new-file.img 256K

Очистка QSPI0

Для очистки памяти используется команда erase утилиты mcom03-flash:

mcom03-flash --port /dev/ttyUSBx erase qspi0 [size-in-bytes]

Если размер не указан, то будет очищена вся память. Пример использования:

mcom03-flash --port /dev/ttyUSBx erase qspi0 1M

Запись данных в I2C ID EERPOM

Согласно SMARC HW Specification Version 2.1, I2C ID EEPROM должна быть совместима с Atmel 24C32 и использовать I2C адрес 0x57.

Для записи данных в EEPROM используется команда write утилиты mcom03-eeprom:

mcom03-eeprom write <string>

Для выбора шины I2C предусмотрена опция -b. Команда с выбором шины:

mcom03-eeprom -b 0 write <string>

Информация о других флагах (выбор адреса I2C, регистра и т. д.) доступна в справке утилиты:

mcom03-eeprom --help

Перечень значений для прошивки в ID EEPROM носителей SMARC приведён в таблице:

Плата-носитель	Имя платы для прошивки
NGFW-CB r1.0	ngfwcb-r1.0
ELV-SMARC-CB r1.0	elvsmarccb-r1.0
ELV-SMARC-CB r2.9.1	elvsmarccb-r2.9
ELV-SMARC-CB r2.10	elvsmarccb-r2.10
ELV-SMARC-CB r2.10.3	elvsmarccb-r2.10.3
ELV-SMARC-CB r3.1.0	elvsmarccb-r3.1.0
ELV-SMARC-CB r3.2.1	elvsmarccb-r3.2.1

Для носителей, не указанных в таблице, прошивка ID EEPROM не требуется.

Чтение данных из I2C ID EEPROM

Для чтения содержимого EEPROM используется команда read утилиты mcom03-eeprom. Утилита читает и выводит в виде строки указанное с ключом -d количество байтов, записанных в EEPROM:

mcom03-eeprom -d 128 read