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

Навигация

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

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

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

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


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


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


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


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


Репозиторий можно склонировать с использованием https (если у вас нет аккаунта на github.com):
<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>


или ssh, если у вас есть аккаунт:
Если вы собираете ядро для '''Wiren Board 6''' и новее, ([https://support.wirenboard.com/t/linux-kernel-modules-linux-headers/16179/6 могут быть нюансы с версией]):
<pre>
git clone git@github.com:contactless/linux.git KERNEL
</pre>


'''3.'''  Инициализируйте внешние модули:
<syntaxhighlight lang="bash">
<pre>
$ sudo apt install gcc-arm-linux-gnueabihf
cd KERNEL</pre>
</syntaxhighlight>
<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>


==Сборка==
Для '''Wiren Board 5''' и более старых понадобится другой компилятор:


Сборка ядра с упаковкой в tar.gz архивы:
<syntaxhighlight lang="bash">
./build.sh
$ sudo apt install gcc-arm-linux-gnueabi
Сборка в пакет Debian
</syntaxhighlight>
./build_deb.sh


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


== Установка на Wiren Board ==
<syntaxhighlight lang="bash">
$ git clone https://github.com/wirenboard/linux
$ cd linux
$ git submodule update --init --recursive
</syntaxhighlight>


export kernel_version=3.19.0-imxv5-x0.1
== Сборка ==
(строку версии стоит взять из вывода сборочных скриптов из предыдущего пункта)
Все промежуточные и конечные артефакты сборки - объектные файлы, dtb, модули ядра .ko, zImage и т.д. - будут находится в поддиректории '''.build-wbX''', где X зависит от модели контроллера.
В этой же директории находится конфигурация ядра (см. ниже).


Скрипты:
Чаще всего для использования на контроллере удобней всего собрать deb-пакет с файлами ядра.  
* 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


Если вам нужны только некоторые бинарные файлы (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>


Можно поменять значение VERSION_SUFFIX на свой вкус согласно правилам оформления версий пакетов в Debian.
Это значение будет добавлено в конец номера версии пакета и поможет отличить собранное вручную ядро от
ядра из репозитория Wiren Board.


=== Редактирование конфига ядра ===
После сборки в корне появятся файлы пакетов (пример для Wiren Board 6):


cd KERNEL
* linux-image-wb6_4.9.22-wb1~my~test~kernel_armhf.deb - образ ядра, модули и dtbs;
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- menuconfig
* linux-headers-wb6_4.9.22-wb1~my~test~kernel_armhf.deb - нужен для разработки
или
* linux-libc-dev_4.9.22-wb1~my~test~kernel_armhf.deb  - нужен для разработки
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- xconfig


На контроллер достаточно скопировать файл пакета linux-image-wb6, в нём уже содержится всё необходимое.


=== Список изменений относительно стандартного конфига ===
== Разные модели контроллеров ==
{| 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*
|}


  ./config_diff.sh
== Настройка ядра ==
При запуске скрипт сборки 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>


Конфигурация по-умолчанюи при этом берётся из файлов в '''arch/arm/configs/''', например '''imx6_wirenboard_defconfig'''.


=== Применение изменений в стандартный конфиг ===
Чтобы поменять конфигурацию, запустите '''make''' с необходимыми параметрами:


Этот пункт нужен, чтобы изменить стандартный конфиг Wiren Board, например чтобы отправить патч или pull request.
<syntaxhighlight lang="bash">
cd KERNEL
$ make KBUILD_OUTPUT=.build-wb6 ARCH=arm CROSS_COMPILE=arm-linux-gnueabihf- menuconfig # для Wiren Board 6
</syntaxhighlight>


make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- savedefconfig
вместо '''menuconfig''' можно использовать графический '''xconfig'''.


  cp defconfig ./arch/arm/configs/mxs_wirenboard_defconfig
После сохранения, конфигурация заишется в сборочную директорию: '''.build-wbX/.config'''.
</translate>
 
Теперь вы можете собрать ядро с новой конфигурацией, выполнив обычную команду
<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/Служебная:Сравнение_версий/18817...79974