Быстрый запуск
Подготовка
Для проведения работ необходимо загрузить ПО на ваш компьютер, на котором предустановлена ОС windows 7 и выше. Для этого откройте сайт diasom
Зарегистрируйте проект или войдите с почты организации. Вам откроется содержание клиентского раздела. По пути Клиентский раздел Миниатюрные промышленные SoM Раздел 2: Полезная информация для программиста раздел 2.4. Тут находим Файл образа ОС ds-rk3568-evb.img+ , скачайте этот файл
Также нужно скачать и установить программу терминала актуальной версии PyTTY
Программу для работы с образами дисков Win32DiskImager
Драйверы FTDI COM порта
Работы проводятся с применением загрузочного образа операционной системы ds-rk3568-evb.img и соответствующими сценариями, запускаемыми скриптом ./evb_test.sh из консоли
После установки требуемого ПО убедитесь, что у вас есть всё оборудование из этого списка:
Лабораторный источник питания, обеспечивающий напряжение питания в диапазоне 11 – 13 В, ток до 3 А
Кабель питания
Кабель USB Type-A- USB Type-C
ПЭВМ с ОС Windows
Ethernet патчкорд cat 5e - 2 штуки
Настольный монитор с HDMI интерфейсом и HDMI кабелем
SD card reader
DS-RK3568-EVB
microSD карта
USB Flash накопитель
WLAN модуль
NVME накопитель
Коммутатор с функцией DHCP
Чтобы узнать стандартную и опциональную комплектации отладочных компонентов DS-RK3568-EVB в зависимости от версии, перейдите в соответствующий раздел.
Это оборудование является обязательным. Из заведомо исправных компонентов соберите отладочный комплект на базе платы DS-RK3568-EVB. Установите на своё место microSD карту, USB Flash накопитель, WLAN модуль, NVME накопитель. Подключите настольный монитор к HDMI порту, Ethernet порты к коммутатору с функцией DHCP и доступом в интернет.
Подача питания на плату DS-RK3568-EVB
Ознакомьтесь с расположением разъемов на плате на рисунке. Питание находится в левом верхнем углу, а номер серии – в правом нижнем. Сопоставьте схему со своей отладочной платой

Для корректной подачи питания на вашу отладочную плату необходимо проверить, какой у неё серийный номер. В случае, если вы видите серию rev.1.1. и ниже – плата рассчитана на максимальное напряжение в 5В. Если серия выше, на такую плату можно подать 12 В

Рекомендуется использовать лабораторный (специализированный) источник питания для подключения отладочной платы. Среднее потребление отладочной платы не превышает 1,0 А, но используемых источник питания должен обеспечивать ток не менее 1,5 А, для обеспечения импульсного потребления. Не превышать напряжение питания выше 13В
При подключении строго соблюдать полярность. Подача напряжения неправильной полярности может привести к неисправности модуля питания платы!
После того, как узнаете номер серии своей платы, опираясь на схему ниже, подключите кабель

Для версии 1.3.0
Шлейф тип B, настроить блок питания на напряжение 12В и ток 100 мА
Для версии 1.2.1
Шлейф тип B, настроить блок питания на напряжение 12В и ток 100 мА
Для версии 1.2.0
Шлейф тип А, настроить блок питания на напряжение 12В и ток 100 мА
Для версии 1.0.1
Шлейф тип А, настроить блок питания на напряжение 5 В, ток 3000 мА
Для версии 1.1.0
Шлейф тип А, настроить блок питания на напряжение 5 В, ток 3000 мА
Подайте питание на плату DS-RK3568-EVB, проконтролировав потребление тока от источника питания, в установившемся режиме после загрузки ядра, в диапазоне 125 - 270 мА, или для версий 1.0.1 и 1.1.0 диапазон токов будет 300 – 650 мА. В случае выхода тока потребления за указанный диапазон, выключить питание. Плата неисправна
Убедиться в свечении светодиодов 5V (VD39) и 3V3 (VD40) возле разъема 5V_SYS
Убедиться в свечении светодиодов непосредственно на модуле. При отсутствии свечения отладочный комплект неисправен
Убедившись в исправности отладочного комплекта, снимите питание
Запуск процессорного модуля
Подключение к консоли модуля по отладочному интерфейсу
Соедините головной компьютер и нижний разъем «DEBUG» группы из двух разъемов USB Type-C
Подайте питание на отладочную плату
Откройте Диспетчер устройств. Во разделе Порты должно появиться COM и LPT/USB Serial Port (COMxx)
Важно - адрес СОМхх потребуется при последующих действиях, его необходимо запомнить
На головной машине запустить программу терминала PyTTY
Открыть сессию по последовательному интерфейсу СОМхх на скорости 1 500 000 с параметрами порта Serial СOMXX Data bits 8 Stop bits 1
Факт открытия окна терминала связи подтверждает работоспособность отладочного интерфейса
Подготовка загрузочной microSD карты
Чтобы загрузить требуемую для корректной работы ОС, Вам понадобится microSD, SD card reader и образ диска с сайта diasom. Подключите к компьютеру microSD через SD card reader и убедитесь, что накопитель определился в системе. Запомнить имя накопителя, которое отображается в системе.
Запустите Win32 Disk Imager
Во вкладке Device выберите нужный накопитель
Во вкладке ImageFile укажите путь до образа диска
Нажмите левой кнопкой мыши на кнопку Write и согласитесь с предупреждением программы. Дождитесь записи образа на карту

Извлеките карту из SD card reader
Вы записали образ диска на microSD. Образ содержит первоначальный загрузчик, barebox, образ ОС Linux и необходимую для её работы область exr4. Структура хранения данных описана здесь:
- image ds - rk3568 - evb - sdcard.img { hdimage { partition - table - type = "gpt" } partition boot { image = "barebox-diasom-rk3568-evb.img" partition - type - uuid = 0 fc63daf - 8483 - 4772 - 8e79 - 3 d69d8477de4 offset = 32 K size = 2560 K # 512 K * 5 } partition env { image = "/dev/null" partition - type - uuid = 6 c3737f2 - 07 f8 - 45 d1 - ad45 - 15 d260aab24d size = 32 K } partition root { image = "rootfs.ext4" partition - type - uuid = b921b045 - 1 df0 - 41 c3 - af44 - 4 c6f280d3fae } }
Важно - Если вы используете модуль с прошитым устройством еММС последовательность выбора устройств для загрузки модуля такова, что имея исправный загрузчик на еММС, очередь загрузки никогда не дойдёт до microSD карты. Чтобы обеспечить загрузку с microSD карты нужно удалить загрузчик с еММС. Информация о том, как это можно исправить, находится здесь
Ввод в работу загруженного образа ОС
Подключитесь, как в прошлых пунктах, с помощью кабеля TypeC и PyTTY к отладочному интерфейсу
Снимите питание, нужно выждать интервал не менее 5 секунд. Затем подать питание
Наблюдать лог загрузки в окне отладочному интерфейсу
В конце загрузки ОС выведет приглашение на ввод пароля
Логин:root Пароль:root
Отладочный комплект готов к программированию
Работа с интерфейсами платы
При загрузке встроенной ОС модуля автоматически начинают работу интерфейсы DSI и HDMI. При наличии подключенных дисплеев, на их экраны выдается изображение рабочего стола. Обращение с другими имеющимися интерфейсами отладочного комплекта приведено ниже.
Перед началом работы с любым интерфейсом отладочного комплекта обеспечьте его правильное подключение с устройством, соблюдая распиновки разъемов и при необходимости уровни сигналов. Вспомогательные материалы здесь.
После обеспечения правильного подключения устройства и предыдущих разделов необходимо подать питание на отладочный комплект и дождаться приглашения к работе встроенной операционной системой: (ввод логина root и пустого пароля).
DSI
По завершению подключения и загрузки, на подключенном по интерфейсу DSI монитору, наблюдать изображение рабочего стола встроенной ОС. Интерфейс готов к взаимодействию на программном уровне.
HDMI
По завершению подключения и загрузки, на подключенном по интерфейсу HDMI монитору, наблюдать изображение рабочего стола встроенной ОС. Интерфейс готов к взаимодействию на программном уровне.
GPU
По выполнению предыдущих пунктов подсистема GPU готова к взаимодействию на программном уровне.
Gigabit Ethernet (GE)
При наличии коммутатора, подключите GE порт к коммутатору. На головной ПЭВМ, порту, к которому будет производиться подключение, вручную назначить IP следующие адрес и маску подсети
-192.168.0.2/255.255.255.0Обеспечить GE соединение. Для этого необходимо произвести действия, описанные в разделе Запуск процессорного модуля, а также соединить верхний порт платы DS-RK3568-EVB и GE порт головной машины, заведомо исправным Ethernet патчкордом.
В окне запущенного на головной машине PyTTY наблюдать сообщение, подтверждающее установления соединения.
В противном случае проверьте кабельное соединение.
В окне запущенного приложения запускаем команду
ifconfig end1 192.168.0.1mask 255.255.255.0, после этого вводим в это же окноifconfigНаблюдаем результат выполнения команды в виде выдачи свойств, например верхнего порта GE
На головной машине запустить консоль управления, выполнив команду
cmd, в консоли управления запуститьping 192.168.0.1Убедиться в прохождении запросов и ответов. Порт готов к работе.
Аналогичным образом проводятся работы с нижним портом платы DSRK3568-EVB. Для этого переключаем патчкорд из верхнего разъема в нижний. ОС выдаст аналогичное сообщение для end0. Выполняем полную последовательность, заменяя end1 на end0.
CSI
После правильного подключения устройства с интерфейсом CSI и загрузки интерфейс готов к взаимодействию на программном уровне
microSD и eMMC.
Устройство еММС готово к работе по завершению загрузки встроенной ОС. Для работы с microSD картой, установите карту в разъем Х3. Устройство готово к использованию.
CAN
Подключить устройство, соблюдая назначение контактов разъемов, назначения пинов можно посмотреть в этом разделе: Х14 (Приложение 1. Таблица 13) – CAN2, или Х15 (Приложение 1. Таблица 14) – CAN1. Подключенный интерфейс готов к работе с помощью программных средств пользователя.
Обратите внимание, что в версии 1.2.1 разъемы были перевернуты и назначения пинов различаются по сравнению с другими версиями отладочных комплектов.
SPI
Подключить устройство, соблюдая назначение контактов разъемов, назначения пинов можно посмотреть в этом разделе: Х17 (Приложение 1. Таблица 16) – SPI2, или X19 (Приложение 1. Таблица 18) – SPI1.
Уровень логического сигнала задается путем установки перемычки между контактами 1 и 2 для 5 В, или между контактами 2 и 3 для 3 В, соответствующих разъемов: Х16 для SPI2, и Х18 для SPI1.
Подключенный интерфейс готов к работе с помощью программных средств пользователя.
UART
Подключить устройство, соблюдая назначение контактов разъемов, назначения пинов можно посмотреть в этом разделе: Х21 (Приложение 1. Таблица 20) – UART3, Х23 (Приложение 1. Таблица 22) – UART7, Х25 (Приложение 1. Таблица 24) – UART8, или Х27 (Приложение 1. Таблица 26) – UART9.
Уровень логического сигнала задается путем установки перемычки между контактами 1 и 2 для 5 В, или между контактами 2 и 3 для 3 В, соответствующих разъемов: Х20 для UART3, и Х22 для UART7, Х24 для UART8, Х26 для UART9.
Подключенный интерфейс готов к работе с помощью программных средств пользователя.
GPIO
Подключить требуемый вход/выход, соблюдая назначение контактов разъемов, назначения пинов можно посмотреть в этом разделе: Х12 (Приложение 1. Таблица 11). Подключенный вход/выход готов к работе с помощью программных средств пользователя.
Работа со сборками
Для работы со сборками ознакомьтесь с этим документом. Он содержит краткую инструкцию по сборке необходимых программных компонентов.