======= Getting Started SMARC-SOM RK3588 ======
<note important>Модули RK3588 реввизии V1 являются инженерными образцами, поэтому содержат нюансы:

Это аппаратные ISSUE, который будут исправлены в серийном изделии:

1) SD-карта работает только в Linux, загрузить Uboot  с нее не получится. 

2) I2C_GP (General Purpose по SMARC) шина, работает на модуле в Software режиме. 

3) HDMI HPD сигнал инвертирован, из-за этого драйвер сыпет сообщениями, но само видео работает</note>

Данный раздел посвящен описанию процесса прошивки модулей SMARC RK3588 и обзору программного обеспечения.

Бинарные релизы доступны для скачивания на [[https://disk.yandex.ru/client/disk/InmysOnlyShared/SOM-RK3588|Яндекс Диске]]. 

Предоставляется 2 варианта программного обеспечения
  * [[https://wiki.inmys.ru/doku.php?id=boards:nms-sm-rk3588:debian:start|Сборка Debian 12]] (с ядром и библиотеками Rockchip) для прототипирования
  * [[https://wiki.inmys.ru/doku.php?id=boards:nms-sm-rk3588:buildroot:start|Сборка Buildroot]] //Рекомендуется для работы конечного прикладного ПО в изделии заказчика.//
===== Прошивка модулей =====
Процессорный модуль V1 может загружаться только с EMMC. Прошивка EMMC производится через **кастомный** кабель USB-A-USB-A(с отрезанным питанием) и Maskrom-режим. 

Необходимо установить на хост утилиту [[https://github.com/xboot/xrock|xrock]]:

<code>
git clone https://github.com/xboot/xrock
sudo apt install libusb-1.0-0-dev
cd xrock
make
sudo make install
</code>

Прошивка в отладочной плате NMS-SM-EVM производится через вертикальный USB3.0 разъем X10. Требуется, [[https://www.dns-shop.ru/product/c65e98589c783361/kabel-dexp-usb-20-type-a---usb-20-type-a/?utm_medium=organic&utm_source=google&utm_referrer=https%3A%2F%2Fwww.google.ru%2F|например, вот такой кабель]]. **Питание по USB должно быть отрезано**

Для отключения загрузки модуля с EMMC небходимо, чтобы при подаче 12V питания на отладку установлен джампер в разъеме X2(Disable EMMC boot). После подачия питания убрать джампер. 

{{:boards:nms-sm-rk3588:bringup:evm-info.png?800}}

После подачи питания, модуль должен быть виден на шине USB хоста:

{{:boards:nms-sm-rk3588:bringup:lsusb_rk.png}}

==== Прошивка Debian ====
[[https://disk.yandex.ru/d/yNjYk8RBwNAMUA|Скачать ресурсы]]

Debian прошивается единым образом с нулевым смещением:
<code>
gunzip rk3588-inmys-debian-12.img.gz
#enter to maskrom mode
sudo xrock maskrom ./rk3588_ddr_lp4_2112MHz_lp5_2400MHz_v1.16.bin ./rk3588_usbplug_v1.11.bin --rc4-off
#burn image
sudo xrock flash write 0 ./rk3588-inmys-debian-12.img
</code>

Возможно использование скрипта burn_image.sh:

{{:boards:nms-sm-rk3588:bringup:burn_deb.png}}

==== Прошивка сборки Buildroot ====
[[https://disk.yandex.ru/d/Gy6LUfTtZtOOzQ|Скачать ресурсы]]

Прошивка на основе Buidlroot определяется:  

  * MBR + таблицой разделов mbr.dat
  * Загрузчиком u-boot-rockchip.bin. U-boot загружает Linux через extlinux.conf файл.
  * rootfs.ext2 - образом корневой файловой системы, которая монтируется Linux в режиме Readonly
  * p3.ext2 - образом файловой системы, которая монтируется как Read-write директория /opt

Прошивка производится скриптом //burn_buildroot.sh//:

{{:boards:nms-sm-rk3588:bringup:burn_br.png}}