Различия

Показаны различия между двумя версиями страницы.

--- boards:nms-uq7-komdiv-mk:user-guide [2026/07/13 10:45] – удалено - внешнее изменение (Дата неизвестна) 127.0.0.1
+++ boards:nms-uq7-komdiv-mk:user-guide [2026/07/22 14:46] (текущий) – [Сборка образа системы] Артем Слепов
@@ Строка 1: / Строка 1: @@
+====== Руководство пользователя ======
+Страница содержит руководство по подготовке программной части, сборке rootfs и ядра Linux для модуля **Q7_KOMDIV_MK**.
+===== Общая информация =====
+**Q7_KOMDIV_MK** используется как вычислительный модуль в составе встраиваемых и серверных систем. Для работы модуля требуется подготовить загрузчик, ядро Linux и корневую файловую систему.
+В рамках данной страницы используется следующее окружение:
+{{tablelayout?rowsHeaderSource=Auto}}
+^ Компонент      ^ Версия / описание                               ^
+| Хостовая ОС    | Ubuntu 24.04                                    |
+| Rootfs         | Buildroot 2025.02.7 + buildroot-external-inmys  |
+| Ядро Linux     | k5500vk018-linux                                |
+| Архитектура    | KOMDIV-64 (MIPS64)                              |
+| Сборка rootfs  | через Docker-контейнер komdiv-sdk               |
+===== Состав программной части Q7_KOMDIV_MK =====
+Для работы модуля требуется три основных компонента:
+^ Компонент ^ Описание ^ Доступ к исходну кода ^ Место прошивки ^
+| Загрузчик | Barebox | Приватный репозиторий с доступом по токену | SPI FLASH 4MB на модуле |
+| Ядро Linux | Linux с поддержкой k5500vk018 | Приватный репозиторий с доступом по токену | eMMC 4GB на модуле/внешняя SD-карта|
+| Rootfs | Buildroot 2025.02.7 + buildroot-external-inmys | Публичный GitHub Inmys | eMMC 4GB на модуле/внешняя SD-карта |
+<note important>На данный момент исходный код распространяется через репозитории с приватным доступом.
+Для получения токена обратитесь на почту info@inmys.ru</note>
+===== Подготовка окружения =====
+Сборка выполняется на **Ubuntu 24.04**.
+Перед началом работы необходимо обновить список пакетов и установить кросс-компилятор для MIPS (требуется для сборки barebox):
+<code>
+sudo apt update
+sudo apt install -y cpp-mips64el-linux-gnuabi64
+</code>
+Также предполагается, что на хостовой машине установлен Docker.
+===== Сборка BareBox =====
+<note>Исходники загрузчика будут доступны в августе</note>
+<code>
+git clone gitlab.inmys.online ...
+make ARCH=mips CROSS_COMPILE=mips64el-linux-gnuabi64- srisa_defconfig
+make ARCH=mips CROSS_COMPILE=mips64el-linux-gnuabi64- -j24
+</code>
+Результат сборки находится по пути ''images/barebox-rbm_c1k5500vk018-el.img''
+===== Сборка образа системы =====
+Введите логин и токен вместо ''XXXXX'' и ''YYYYY'' и выполните команду:
+<code>
+LOGIN="XXXXX"; TOKEN="YYYYY"; printf "machine gitlab.inmys.online\nlogin %s\npassword %s\n" "$LOGIN" "$TOKEN" > .gitlab.netrc
+</code>
+Выполните следующие команды:
+<code>
+mkdir -p container
+cd container
+wget https://nextcloud.inmys.online/nextcloud/index.php/s/ZJFE4wx3pMwf9yn/download -O Dockerfile
+sudo docker build -t komdiv-sdk .
+cd ..
+wget https://buildroot.org/downloads/buildroot-2025.02.7.tar.gz
+tar -xf buildroot-2025.02.7.tar.gz
+git clone https://github.com/inmys/buildroot-external-inmys.git  -b nms-q7-k5500vk018
+sudo docker run -it -e USER=$USER -e USERID=$UID -v $(pwd):/BR -v "$(pwd)/.gitlab.netrc:/root/.netrc:ro" --cpus=12 -t komdiv-sdk bash
+</code>
+В Docker-контейнере выполнить:
+<code>
+make BR2_EXTERNAL=$PWD/buildroot-external-inmys -C buildroot-2025.02.7 O=$PWD/output br_defconfig
+cd output
+export FORCE_UNSAFE_CONFIGURE=1
+make -j12
+</code>
+После завершения сборки необходимо выйти из контейнера сочетанием клавиш ''Ctrl + D''
+Результаты сборки находятся в директории ''output/images/''
+===== Прошивка загрузчика в SPI-флешку =====
+Осуществляется программатором FT2232H-56Q Mini Module с установленным переходником FT2232H-56Q Mini Module_Adapter
+Необходимо подключить программатор FT2232H-56Q Mini Module к ПК
+и подключить прищепку к плате, красным проводом вверх. Правильное положение прищепки достигается, если плата Q7_KOMDIV_MK установлена в отладочную плату NMS-Q7-EVM-MINI
+| {{ :inmys:prj:inmys:brd:nms-uq7-k5500vk018:v2:bringup:photo_2026-05-27_19-13-12.jpg?500 |}} | {{ :inmys:prj:inmys:brd:nms-uq7-k5500vk018:v2:bringup:photo_2026-05-27_19-13-14.jpg?500 |}} |
+==== Linux (Пример для Ubuntu 24.04) ====
+Установка зависимостей:
+<code>
+sudo apt update && sudo apt install flashrom -y
+</code>
+Прошивка производится с помощью скрипта [[https://disk.360.yandex.ru/d/YOFf-XhxbfylWQ|burn-barebox.sh]]:
+<code>
+chmod +x burn-barebox.sh
+./burn-barebox.sh barebox-rbm_c1k5500vk018-el.img
+</code>
+<hidden Пример успешного вывода>
+<code>
++0 records in
++0 records out
+4194304 bytes (4,2 MB, 4,0 MiB) copied, 0,0105851 s, 396 MB/s
++1 records in
++1 records out
+bytes (963 kB, 941 KiB) copied, 0,0058463 s, 165 MB/s
+flashrom unknown on Linux 6.14.0-28-generic (x86_64)
+flashrom is free software, get the source code at https://flashrom.org
+Using clock_gettime for delay loops (clk_id: 1, resolution: 1ns).
+Found Winbond flash chip "W25Q32.V" (4096 kB, SPI) on ft2232_spi.
+===
+This flash part has status UNTESTED for operations: WP
+The test status of this chip may have been updated in the latest development
+version of flashrom. If you are running the latest development version,
+please email a report to flashrom@flashrom.org if any of the above operations
+work correctly for you with this flash chip. Please include the flashrom log
+file for all operations you tested (see the man page for details), and mention
+which mainboard or programmer you tested in the subject line.
+Thanks for your help!
+Reading old flash chip contents... done.
+Erasing and writing flash chip... Erase/write done.
+Verifying flash... VERIFIED.
+</code>
+</hidden>
+==== Windows ====
+  * Скачать и установить flashrom для windows https://github.com/therealdreg/flashrom_build_windows_x64
+  * Через Zadig заменить драйвер ftdi на winusb. Подоходит вот эта инструкция: https://docs.mikron.ru/wiki/dev-tools/debuggers/ft2232.html
+  * Открыть через командную строку flashrom.exe с правами администратора
+Определение флешки программатором:
+<code>
+.\flashrom.exe -p ft2232_spi:type=2232H,port=A,divisor=4
+</code>
+Чтение файла из памяти:
+<code>
+.\flashrom.exe --progress -V -c "W25Q32JV" -p ft2232_spi:type=2232H,port=A,divisor=4 -r filename.bin
+</code>
+Запись файла в память:
+<code>
+.\flashrom.exe --progress -V -c "W25Q32JV" -p ft2232_spi:type=2232H,port=A,divisor=4 -w filename.bin
+</code>
+===== Подготовка загрузочной флешки =====
+Скачать ресурсы: https://disk.360.yandex.ru/d/11mHF4DiqqxNxQ
+Для первого запуска необходимо подготовить загрузочную флешку. Для прошивки флешки необходимо, чтобы в той же директории, что и скрипт, находились vmlinuz и файл .dtb.
+Прошивка USB-флешки/SD-карты
+<code>
+sudo chmod +x burn-boot-usb.sh
+sudo ./burn-boot-usb.sh /dev/sdX #где X - буква прошиваемой флешки
+</code>
+В конце ожидайте вывод: ''Флешка подготовлена''
+===== Первый запуск =====
+В Barebox установлен приоритет загрузки на USB или SD-карточку. Поэтому если вставлен внешний накопитель, то загрузка будет происходить с него.
+  * Вставьте флешку в отладочную плату и подайте питание
+  * Дождитесь конца загрузки и зайдите под root/root
+  * Установите уникальные MAC-адреса, разметьте EMMC и перенесите образ на EMMC следующими командами:
+<code>
+./auto-burn-macs.sh
+echo 'n p 1  +1G n p 2  +1G n p 3  +1G w' | tr ' ' '\n' | fdisk -u /dev/mmcblk0
+mke2fs /dev/mmcblk0p1
+mke2fs /dev/mmcblk0p2
+mke2fs /dev/mmcblk0p3
+mount /dev/mmcblk0p1 /boot
+mount /dev/sdc1 /mnt
+cp /mnt/k5500vk018-inmys-q7.dtb /boot
+cp /mnt/vmlinuz /boot
+sync
+</code>
+После того как команды были успешно выполнены, можно выключать питание и работать без флешки. Платформа готова к работе.

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы