Wiren Board 5: Build an image to download in USB Mass-Storage mode/en: различия между версиями

Версия 19:22, 31 мая 2019

Другие языки:

English
русский

Эта инструкция описывает, как собрать bootstream для загрузки Linux с USB Mass Storage Gadget. При этом содержимое SD-карты становится доступно по USB как обычная флешка.

Структура bootstream:

U-Boot SPL - первичный загрузчик, проводит начальную инициализацию
U-Boot - собственно загрузчик, запускает Linux
Образ ядра Linux, состоит из нескольких частей
- zImage - cобственно ядро
- initramfs - файловая система с модулями для поддержки USB gadget, входит в zImage
- DTB - информация о периферии, необходимая для работы ядра. Дописывается в конец zImage, в конфиге должна быть включена опция CONFIG_ARM_APPENDED_DTB

Скачать готовый bootstream

Сборка Linux

Получить исходники ядра из git,

$ git clone https://github.com/contactless/linux.git
$ cd linux
$ git checkout dev/v4.1.15

Скачать initramfs из репозитория и распаковать

$ unzip initramfs_usbgadget.zip
$ sudo tar xvf initramfs_usbgadget.tar

Инициализировать окружение для сборки ядра. При необходимости, изменить в этом файле переменные DT и CROSS_COMPILE

$ . ./scripts/kbuild-env.sh
$ set +e

Задать конфиг ядра

$ make mxs_usbgadget_defconfig

Собрать ядро и модули, установив их в распакованную initramfs

$ INSTALL_MOD_PATH=./initramfs_usbgadget/ ./scripts/kbuild.sh

Собрать ядро с appended DTB и initramfs

$ ./scripts/kbuild-dtb.sh

Сборка U-Boot

Получить исходники U-Boot из git. Нужна ветка wb_v2015.07

$ cd ..
$ git clone https://github.com/contactless/u-boot.git
$ cd u-boot
$ git checkout wb_v2015.07

Задать конфиг U-Boot

$ make mx28_wirenboard5_usbgadget_defconfig

Скопировать ранее собранный образ [[Special:MyLanguage/kernel+initramfs]+DTB] в директорию U-Boot

$ cp ../linux/zImage-imx28-evk ./zImage

Собрать совмещенный образ [U-Boot+[[kernel+initramfs]+DTB|kernel+initramfs]+DTB] в директорию U-Boot

$ cp ../linux/zImage-imx28-evk ./zImage

Собрать совмещенный образ [U-Boot+[[kernel+initramfs]+DTB]], пригодный для загрузки по USB (bootstream)

$ CROSS_COMPILE='arm-linux-gnueabi-' make -j4 u-boot.sb

Сборка mxsldr

Эта утилита нужна для загрузки полученного образа по USB. Требуется установленная библиотека libusb-1.0 (apt-get install libusb-1.0-0-dev)

$ cd ..
$ git clone http://git.denx.de/mxsldr.git
$ cd mxsldr
$ make

Загрузка собранного образа с помощью mxsldr

$ ./mxsldr ../u-boot/u-boot.sb

@@ Строка 1: / Строка 1: @@
 <languages/>
-This manual describes how to build bootstream to boot Linux from USB Mass Storage Gadget. In this case, the contents of the SD-card becomes available via USB as a normal USB flash drive.
+Эта инструкция описывает, как собрать bootstream для загрузки Linux с USB Mass Storage Gadget. При этом содержимое SD-карты становится доступно по USB как обычная флешка.
-The structure of the bootstream:
+Структура bootstream:
-* '''U-Boot SPL''' - primary boot loader performs initial initialization
+* '''U-Boot SPL''' - первичный загрузчик, проводит начальную инициализацию
-* '''U-Boot''' - the boot loader itself, runs Linux
+* '''U-Boot''' - собственно загрузчик, запускает Linux
-* The Linux kernel image consists of several parts
+* Образ ядра Linux, состоит из нескольких частей
-** '''zImage''' - kernel
+** '''zImage''' - cобственно ядро
-** '''initramfs''' -  file system with modules to support USB gadget, is included in '''zImage'''
+** '''initramfs''' - файловая система с модулями для поддержки USB gadget, входит в '''zImage'''
-** '''DTB''' - nformation about the periphery required for the kernel to work. Is appended to the end of the '''zImage''', ''CONFIG_ARM_APPENDED_DTB'' option should be enabled in the config
+** '''DTB''' - информация о периферии, необходимая для работы ядра. Дописывается в конец '''zImage''', в конфиге должна быть включена опция ''CONFIG_ARM_APPENDED_DTB''
-[https://github.com/contactless/wirenboard/tree/https://github.com/contactless/wirenboard/blob/master/contrib/u-boot/wb5_usbfw.sb Download bootstream]
+[https://github.com/contactless/wirenboard/tree/https://github.com/contactless/wirenboard/blob/master/contrib/u-boot/wb5_usbfw.sb Скачать готовый bootstream]
-== Building Linux ==
+== Сборка Linux ==
-* To get the kernel sources from git,''
+* Получить исходники ядра из git,''
   <nowiki>
 $ git clone https://github.com/contactless/linux.git
 $ cd linux
 $ git checkout dev/v4.1.15 </nowiki>
-* Download initramfs from [https://github.com/contactless/wirenboard/tree/master/initramfs_usbgadget repository] and unzip
+* Скачать initramfs из [https://github.com/contactless/wirenboard/tree/master/initramfs_usbgadget репозитория] и распаковать
   <nowiki>
 $ unzip initramfs_usbgadget.zip
 $ sudo tar xvf initramfs_usbgadget.tar</nowiki>
-* Initialize the environment to build the kernel. If necessary, change the ''DT'' and ''CROSS_COMPILE'' variables in this file
+* Инициализировать окружение для сборки ядра. При необходимости, изменить в этом файле переменные ''DT'' и ''CROSS_COMPILE''
   <nowiki>
 $ . ./scripts/kbuild-env.sh
 $ set +e</nowiki>
-* Set the config of the kernel
+* Задать конфиг ядра
   <nowiki>$ make mxs_usbgadget_defconfig</nowiki>
-* Build the kernel and modules by installing them in unpacked initramfs
+* Собрать ядро и модули, установив их в распакованную initramfs
   <nowiki>$ INSTALL_MOD_PATH=./initramfs_usbgadget/ ./scripts/kbuild.sh</nowiki>
-* Build kernel with appended DTB and initramfs
+* Собрать ядро с appended DTB и initramfs
   <nowiki>$ ./scripts/kbuild-dtb.sh</nowiki>
-== Building U-Boot ==
+== Сборка U-Boot ==
-* Get u-Boot sources from git. You need a ''wb_v2015.07'' branch
+* Получить исходники U-Boot из git. Нужна ветка ''wb_v2015.07''
   <nowiki>
 $ cd ..
@@ Строка 44: / Строка 44: @@
 $ cd u-boot
 $ git checkout wb_v2015.07</nowiki>
-* Set u-Boot config
+* Задать конфиг U-Boot
   <nowiki>$ make mx28_wirenboard5_usbgadget_defconfig</nowiki>
-* Copy a previously collected image of '''[[kernel+initramfs]+DTB]''' to the U-Boot folder
+* Скопировать ранее собранный образ '''[[Special:MyLanguage/kernel+initramfs]+DTB]''' в директорию U-Boot
   $ cp ../linux/zImage-imx28-evk ./zImage
-* Build a combined image '''[U-Boot+[[kernel+initramfs]+DTB|kernel+initramfs]+DTB]''' into U-Boot folder
+* Собрать совмещенный образ '''[U-Boot+[[kernel+initramfs]+DTB|kernel+initramfs]+DTB]''' в директорию U-Boot
   $ cp ../linux/zImage-imx28-evk ./zImage
-* Build a combined '''[U-Boot+[[kernel+initramfs]+DTB]]''' image suitable for booting to USB (bootstream)
+* Собрать совмещенный образ '''[U-Boot+[[kernel+initramfs]+DTB]]''', пригодный для загрузки по USB (bootstream)
   <nowiki>$ CROSS_COMPILE='arm-linux-gnueabi-' make -j4 u-boot.sb</nowiki>
-== Assembling mxsldr ==
+== Сборка mxsldr ==
-This utility is needed to download the resulting image via USB. Requires ''libusb-1.0'' library installed (<nowiki>apt-get install libusb-1.0-0-dev</nowiki>)
+Эта утилита нужна для загрузки полученного образа по USB.
+Требуется установленная библиотека ''libusb-1.0'' (<nowiki>apt-get install libusb-1.0-0-dev</nowiki>)
   <nowiki>
@@ Строка 65: / Строка 66: @@
-== Loading a built image using mxsldr ==
+== Загрузка собранного образа с помощью mxsldr ==
   <nowiki>$ ./mxsldr ../u-boot/u-boot.sb</nowiki>

Навигация