Перейти к содержанию

Навигация

How To Build Linux Kernel: различия между версиями

How To Build Linux Kernel (просмотреть исходный код)

Версия 19:50, 21 марта 2024

6511 байт добавлено ,  1 месяц назад
пакет rsync добавил
(пакет rsync добавил)
 
(не показано 13 промежуточных версий 5 участников)
Строка 1: Строка 1:
<languages/>
{{DISPLAYTITLE:Сборка ядра Linux}}
<translate>
Сборка ядра Linux вручную может понадобиться, например, если нужно включить в ядро
<!--T:1-->
модули, отсутствующие в стандартной поставке Wiren Board. Если вы не знаете, для чего
Вам может понадобиться собрать своё ядро (например, чтобы включить нужные модули). Чтобы собрать ядро для Wiren Board, нужно взять использовать специальный репозиторий, содержащий ядро, адаптированное для Wiren Board.
вам это нужно, то, скорее всего, вам не нужно собирать ядро вручную.


Начиная с 8 апреля 2021 года, скрипты для сборки deb-пакетов ядра Linux для Wiren Board
добавлены в репозиторий с кодом ядра: http://github.com/wirenboard/linux.


<!--T:2-->
== Подготовка сборочной машины ==
'''0.''' Сборку ядра следует проводить на вашем настольном компьютере под управлением Linux (не на Wiren Board - теоретически это возможно, но потребует несколько гигабайт свободного места, и займёт много времени).
Сборка ядра должна производиться на настольном компьютере, ноутбуке или сервере под управлением Linux.
Убедитесь, что у вас установлен git (http://en.wikipedia.org/wiki/Git_%28software%29). Если нет, установите его:<pre>
Собирать ядро на самом Wiren Board не стоит - у контроллера не хватит дискового пространства для получения
sudo apt-get install git
репозитория, а также вычислительной мощности. Даже на настольном компьютере сборка ядра может занять
</pre>
десятки минут.
Установите произвольные имя пользователя и почту:
<pre>
git config --global user.name "Imya Familiya"
git config --global user.email "vash@adres.ru"
</pre>


Сборочные скрипты писались с расчётом на дистрибутивы Debian и Ubuntu, инструкции в этой статье приводятся
также из расчёта использования этих дистрибутивов. Инструкция была проверена в Ubuntu 18.04.


<!--T:3-->
Для сборки ядра понадобится установить пакеты с необходимым для сборки ПО:
'''1.''' Скачайте набор скриптов, который упрощает сборку:
<pre>
git clone https://github.com/contactless/build_kernel.git
cd build_kernel
</pre>
'''2.''' Склонируйте и инициализируйте репозиторий Linux.


<!--T:4-->
<syntaxhighlight lang="bash">
<pre>
$ sudo apt update && sudo apt install build-essential libncurses5-dev fakeroot lzop bc git bison flex libssl-dev rsync
git clone https://github.com/contactless/linux KERNEL
</syntaxhighlight>
</pre>


<!--T:6-->
Если вы собираете ядро для '''Wiren Board 6''' и новее, ([https://support.wirenboard.com/t/linux-kernel-modules-linux-headers/16179/6 могут быть нюансы с версией]):
'''3.''' Инициализируйте внешние модули:
<pre>
cd KERNEL</pre>
<pre>
git submodule init</pre>
<pre>
git submodule update</pre>
'''4.''' Установите конфиг для сборки под Wiren Board<pre>
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- mxs_wirenboard_defconfig
</pre>


==Сборка== <!--T:7-->
<syntaxhighlight lang="bash">
$ sudo apt install gcc-arm-linux-gnueabihf
</syntaxhighlight>


<!--T:8-->
Для '''Wiren Board 5''' и более старых понадобится другой компилятор:
Сборка ядра с упаковкой в tar.gz архивы:
./build.sh
Сборка в пакет Debian
./build_deb.sh


<syntaxhighlight lang="bash">
$ sudo apt install gcc-arm-linux-gnueabi
</syntaxhighlight>


== Установка на Wiren Board == <!--T:9-->
== Получение исходного кода ==
Исходный код ядра Linux с правками от команды Wiren Board хранится в репозитории на Github. Чтобы получить его на
свой компьютер, выполните команды:


<!--T:10-->
<syntaxhighlight lang="bash">
export kernel_version=3.19.0-imxv5-x0.1
$ git clone https://github.com/wirenboard/linux
(строку версии стоит взять из вывода сборочных скриптов из предыдущего пункта)
$ cd linux
$ git submodule update --init --recursive
</syntaxhighlight>


<!--T:11-->
== Сборка ==
Скрипты:
Все промежуточные и конечные артефакты сборки - объектные файлы, dtb, модули ядра .ko, zImage и т.д. - будут находится в поддиректории '''.build-wbX''', где X зависит от модели контроллера.
* tools/copy_kernel_latest_deb.sh - копирует и устанавливает последний deb-пакет с ядром. Аргумент: папка с rootfs (или примонтированный eMMC/microSD накопитель Wiren Board)
В этой же директории находится конфигурация ядра (см. ниже).
* tools/scp_kernel_latest_deb.sh - - копирует и устанавливает последний deb-пакет с ядром. Аргумент: root@hostname, где hostname - это IP-адрес Wiren Board


Чаще всего для использования на контроллере удобней всего собрать deb-пакет с файлами ядра.


== Работа с конфигом ядра == <!--T:12-->
Если вам нужны только некоторые бинарные файлы (zImage, модули и dtbs), то после успешной сборки deb-пакета их можно будет найти в сборочной поддиректории  '''.build-wbX'''.


=== Сборка deb-пакета ===
<syntaxhighlight lang="bash">
$ make mrproper
$ KERNEL_FLAVOUR=wb6 VERSION_SUFFIX="~my~test~kernel" ./scripts/package/wb/do_build_deb.sh  # Wiren Board 6
</syntaxhighlight>


=== Редактирование конфига ядра === <!--T:13-->
Можно поменять значение VERSION_SUFFIX на свой вкус согласно правилам оформления версий пакетов в Debian.
Это значение будет добавлено в конец номера версии пакета и поможет отличить собранное вручную ядро от
ядра из репозитория Wiren Board.


<!--T:14-->
После сборки в корне появятся файлы пакетов (пример для Wiren Board 6):
cd KERNEL
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- menuconfig
или
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- xconfig


* linux-image-wb6_4.9.22-wb1~my~test~kernel_armhf.deb - образ ядра, модули и dtbs;
* linux-headers-wb6_4.9.22-wb1~my~test~kernel_armhf.deb - нужен для разработки
* linux-libc-dev_4.9.22-wb1~my~test~kernel_armhf.deb  - нужен для разработки


=== Список изменений относительно стандартного конфига === <!--T:15-->
На контроллер достаточно скопировать файл пакета linux-image-wb6, в нём уже содержится всё необходимое.


<!--T:16-->
== Разные модели контроллеров ==
./config_diff.sh
{| class="wikitable"
|-
! Модель контроллера
! KERNEL_FLAVOUR
! файл defconfig
! сборочная директория
! переменная CROSS_COMPILE
! файлы dts и dtb
|-
| Wiren Board 6
| wb6
| imx6_wirenboard_defconfig
| .build-wb6
| CROSS_COMPILE=arm-linux-gnueabihf-  
| imx6ul-wirenboard6*
|-
| Wiren Board 5 и ниже
| wb2
| mxs_wirenboard_defconfig
| .build-wb2
| CROSS_COMPILE=arm-linux-gnueabi-
| imx28-wirenboard5*
|-
| Wiren Board 7
| wb7
| wirenboard7_defconfig
| .build-wb7
| CROSS_COMPILE=arm-linux-gnueabihf-
| sun8i-r40-wirenboard7*
|}


== Настройка ядра ==
При запуске скрипт сборки deb-пакета спрашивает, использовать ли конфигурацию по-умолчанию:
<syntaxhighlight lang="bash">
$ KERNEL_FLAVOUR=wb7  scripts/package/wb/do_build_deb.sh
Building kernel packages for wb7 (Wiren Board 7)
Revision: -wb100
Architecture: armhf
Config: wirenboard7_defconfig
.config already present
Use wirenboard7_defconfig instead? (y/N)
</syntaxhighlight>


=== Применение изменений в стандартный конфиг === <!--T:17-->
Конфигурация по-умолчанюи при этом берётся из файлов в '''arch/arm/configs/''', например '''imx6_wirenboard_defconfig'''.


<!--T:18-->
Чтобы поменять конфигурацию, запустите '''make''' с необходимыми параметрами:
Этот пункт нужен, чтобы изменить стандартный конфиг Wiren Board, например чтобы отправить патч или pull request.
cd KERNEL


<!--T:19-->
<syntaxhighlight lang="bash">
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- savedefconfig
$ make KBUILD_OUTPUT=.build-wb6 ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- menuconfig # для Wiren Board 6
</syntaxhighlight>


  <!--T:20-->
вместо '''menuconfig''' можно использовать графический '''xconfig'''.
cp defconfig ./arch/arm/configs/mxs_wirenboard_defconfig
 
</translate>
После сохранения, конфигурация заишется в сборочную директорию: '''.build-wbX/.config'''.
 
Теперь вы можете собрать ядро с новой конфигурацией, выполнив обычную команду
<syntaxhighlight lang="bash">
$ KERNEL_FLAVOUR=wb7 scripts/package/wb/do_build_deb.sh
</syntaxhighlight>
 
и ответив N, чтобы использовать новую конфигурацию, вместо конфигурации по-умолчанию:
 
<syntaxhighlight lang="bash">
Use wirenboard7_defconfig instead? (y/N)
</syntaxhighlight>
 
Когда вы полностью довольны результатом, можно посмотреть изменения относительно исходной версии:
 
<syntaxhighlight lang="bash">
# для Wiren Board 6
$ make KBUILD_OUTPUT=.build-wb6 ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- savedefconfig # приводит конфигурацию к стандартному виду и записывает в .build-wb6/defconfig
$ diff -u arch/arm/configs/imx6_wirenboard_defconfig .build-wb6/defconfig  # посмотреть её отличия от исходной конфигурации
</syntaxhighlight>
 
Чтобы заменить исходную версию настроек своей (например, при подготовке патча или pull request):
 
<syntaxhighlight lang="bash">
# для Wiren Board 6
$ make KBUILD_OUTPUT=.build-wb6 ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- savedefconfig
$ cp .build-wb6/defconfig arch/arm/configs/imx6_wirenboard_defconfig
</syntaxhighlight>
 
После этого скрипт '''do_build_deb.sh''' будет использовать обновлённую конфигуацию при ответе "y".
 
=== Сборка вручную ===
Этот этап не требуется для стандартных задач.
Если вы хотите выполнить вручную какой-либо этап сборки, то можно запустить '''make''' вручную.
 
<syntaxhighlight lang="bash">
# для Wiren Board 6
$ make KBUILD_OUTPUT=.build-wb6 ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- zImage dtbs modules -j4
</syntaxhighlight>
 
(-j4 запускает сборку в 4 потока, можно это убрать или поменять значение на более подходящее вашему компьютеру, идеальное значение - количество ядер CPU)
 
В результате появятся нужные нам файлы:
 
* .build-wb6/arch/arm/boot/zImage - образ ядра, который нужно скопировать в /boot/zImage на контроллере;
* .build-wb6/arch/arm/boot/dtb/* - файлы device tree, используемые для настройки оборудования при запуске, копируются в директорию /boot/dtbs/.
 
Файлы модулей можно найти с помощью команды:
 
<syntaxhighlight lang="bash">
$ find . -name '*.ko'
</syntaxhighlight>
 
Далее файлы модулей копируются на контроллер в директорию /lib/modules/<версия ядра>/kernel/ с сохранением исходного пути, как было
при сборке.
Brainroot
wb_editors
890

правок

Источник — https://wirenboard.com/wiki/Служебная:Сравнение_версий/36854...79974