Wiren Board 5: Восстановление прошивки

В Wiren Board 5 прошивка хранится в микросхеме eMMC, напаянной на плату. Чтобы перезалить прошивку, контроллер можно подключить к компьютеру через порт Micro-USB как накопитель, и записать на него прошивку.

ВНИМАНИЕ: при этом способе полностью перезаписывается внутренний накопитель Wiren Board. Все пользовательские данные будут потеряны. Если вы хотите их сохранить, смотрите статью Пропажа файлов при обновлении прошивки.

Инструкция для компьютера с Linux

1. Скачайте в одну папку:
   • wb5_usbfw.sb.
   • mxsldr - если у вас настольный компьютер, скачайте mxsldr.bin (архитектура amd64); если у вас другое устройство с Linux (например, Raspberry Pi), соберите mxsldr по инструкции. Переименуйте файл в mxsldr.
   • прошивку - на странице https://github.com/contactless/wirenboard/releases найдите файл для вашей версии платы с расширением .img.zip, скачайте и разархивируйте.

   Все дальнейшие команды выполняйте в этой папке.

2. Выключите контроллер.
3. Определите тип процессорного модуля: обычный или индустриальный. Для этого посмотрите маркировку чипа памяти на плате процессорного модуля:
   • обычная версия: SanDisk,
   • индустриальная версия: 6VA18JW983.
4. Соедините разъём Micro USB контроллера (обычно подписан как FW) с портом USB компьютера. Настоятельно рекомендуется также подключить контроллер и по Debug USB для отслеживания процесса прошивки. Для industrial версии подключение по Debug USB в процессе прошивки - обязательно.
5. Перейдите в папку с собранным mxsldr.
6. Затем:
   • (для версии WB5.3) замкните перемычку FW рядом с разъёмом Micro USB;
   • (для версии WB5.6+) зажмите маленькую кнопку рядом с разъёмом Micro USB.
7. Не снимая перемычку/не отпуская кнопку, подключите к контроллеру питание, подождите несколько секунд и запустите на компьютере

   $ sudo ./mxsldr /X/XX/wb5_usbfw.sb
   

   Где /X/XX/wb5_usbfw.sb - это путь к скачанному файлу.
8. При успешной загрузке образа через несколько секунд замигает зеленый светодиод, память контроллера определится на компьютере как накопитель.
9. Затем:
   • (для версии WB5.3) снимите пермычку FW;
   • (для версии WB5.6+) отпустите кнопку FW.
10. Поймите, как в вашей системе определился новый накопитель (например, как /dev/sdb). Это можно посмотреть в выводе

    dmesg | tail
    

    

    tail. Нужный накопитель - /dev/sdb

    Примечание:

    Если у вас industrial версия процессорного модуля и вывод команды не совпадает с указанным на скриншоте (нет устройства вида "sd*"), то нужно открыть Debug консоль контроллера и ввести в неё следующее:

    /sbin/modprobe g_mass_storage file=/dev/mmcblk0 iManufacturer="Wiren Board" iProduct="Wiren Board"
    

    затем уже в терминале ПК снова ввести

    dmesg | tail
    

    для того, чтобы узнать, как накопитель определился в системе.

11. Важно! Операционная система вашего компьютера может автоматически подмонтировать разделы диска контроллера, которые появятся после выполнения команды mxsldr. В этом случае запись прошивки не выполнится успешно. Перед выполнением следующих пунктов проверьте, что ни один из разделов диска контроллера не смонтирован (командой mount — в выводе не должны упоминаться диски контроллера вида /dev/sdbN — как в этом примере), и отмонтируйте все такие смонитрованнные разделы командой umount /dev/sdbN.
12. Внимание! Если вы ошибётесь с определением имени накопителя, и в следующем пункте подставите название, соответствующее другому вашему накопителю, его содержимое будет потеряно.
13. Чтобы записать прошивку в контроллер, замените в команде ниже
    • /X/XX/XXXXX_emmc_wb5.img на путь к заранее распакованному файлу прошивки,
    • /dev/sdX на название раздела, под которым накопитель определился в системе,

    и выполните команду

    $ sudo dd if=/X/XX/XXXXX_emmc_wb5.img of=/dev/sdX bs=1M conv=fdatasync && sync
    

14. После завершения записи отключите контроллер от USB, отключите питание от контроллера и включите снова.