Реализация bootconfig в Android 12

В Android 12 функция bootconfig заменяет параметры командной строки ядра androidboot.* , используемые в Android 11 и ниже. Функция bootconfig — это механизм передачи данных конфигурации из сборки и загрузчика в Android 12.

Эта функция позволяет отделить параметры конфигурации для пользовательского пространства Android от параметров для ядра. Перемещение длинных параметров ядра androidboot.* в файл bootconfig создает место в командной строке ядра и делает его доступным для будущего расширения.

И ядро, и пользовательское пространство Android должны поддерживать bootconfig .

• Первая версия с такой поддержкой: Android 12
• Первая версия ядра, которая имеет такую ​​поддержку: ядро ​​12-5.4.xx

Реализуйте функцию bootconfig для новых устройств, запускаемых с версией ядра 12-5.10.xx. Вам не нужно реализовывать ее, если вы обновляете устройства.

Примеры и источник

При просмотре примеров и исходного кода в этом разделе обратите внимание, что формат кода bootconfig лишь немного отличается от формата ядра cmdline, используемого в Android 11 и ниже. Однако для вашего использования важно следующее различие:

• Параметры должны быть разделены escape-последовательностью новой строки \n , а не пробелами.

Пример загрузчика

Пример загрузчика см. в справочной реализации загрузчика Cuttlefish U-boot. Ниже перечислены два коммита в справке. Первый обновляет версию поддержки заголовка загрузки до последней версии. В примере первый коммит обновляет (или обновляет) поддержку версии до следующей, v4. Второй делает две вещи: добавляет обработку bootconfig и демонстрирует добавление параметров во время выполнения:

• Обновите поддержку версии загрузочного заголовка до последней версии v4 .
• Добавьте обработку bootconfig .

Пример сборки

Пример сборки, демонстрирующий изменения mkbootimg для сборки vendor_boot.img с заголовком загрузки поставщика v4, см. в разделе mkbootimg changes for bootconfig . См. изменения Cuttlefish, чтобы сделать следующее:

• Используйте (или перейдите к предыдущей версии) загрузочного заголовка поставщика v4 .
• Добавьте bootconfig в командную строку ядра и переместите выбранные параметры в bootconfig .

Выполнение

Партнеры должны добавить поддержку в свои загрузчики и переместить параметры androidboot.* времени сборки из командной строки ядра в файл bootconfig. Лучший способ реализовать это изменение — сделать это постепенно; см. раздел Инкрементальная реализация и проверка для получения информации о соблюдении инкрементального процесса.

Если у вас есть изменения, которые ищут файл /proc/cmdline для androidboot.* , укажите вместо этого файл /proc/bootconfig . Свойства ro.boot.* устанавливаются с новыми значениями bootconfig , поэтому вам не нужно вносить изменения в код, использующий эти свойства.

Изменения сборки

Сначала обновите версию заголовка загрузки до версии 4:

- BOARD_BOOT_HEADER_VERSION := 3

+ BOARD_BOOT_HEADER_VERSION := 4

Добавьте параметр bootconfig ядра cmdline. Это заставит ядро ​​искать раздел bootconfig:

BOARD_KERNEL_CMDLINE += bootconfig

Параметры bootconfig создаются из параметров в переменной BOARD_BOOTCONFIG , подобно тому, как строка ядра cmdline создается из BOARD\_KERNEL\_CMDLINE .

Любые параметры androidboot.* можно перенести как есть, например так:

- BOARD_KERNEL_CMDLINE += androidboot..selinux=enforcing

+ BOARD_BOOTCONFIG += androidboot..selinux=enforcing

Изменения загрузчика

Загрузчик настраивает initramfs перед переходом к ядру. Конфигурация загрузки ядра ищет раздел bootconfig и ищет его в самом конце initramfs, с ожидаемым трейлером.

Загрузчик получает информацию о макете vendor_boot.img из заголовка загрузочного образа поставщика.

Рисунок 1. Распределение памяти bootconfig в Android 12

Загрузчик создает раздел bootconfig в памяти. Раздел bootconfig содержит распределение памяти для следующего:

• Параметры
• 4 B размер parameters size
• 4 B parameters checksum суммы
• 12 B магическая строка конфигурации загрузки ( #BOOTCONFIG\n )

Параметры берутся из двух источников: параметры, известные во время сборки, и параметры, которые неизвестны во время сборки. Неизвестные параметры должны быть добавлены.

Параметры, известные во время сборки, упаковываются в конец образа vendor_boot в разделе bootconfig. Размер раздела сохраняется (в байтах) в поле заголовка загрузки поставщика vendor_bootconfig_size .

Параметры, которые неизвестны во время сборки, известны только во время выполнения в загрузчике. Их необходимо добавить в конец раздела параметров bootconfig перед применением трейлера bootconfig.

Если вам необходимо добавить какие-либо параметры после применения трейлера bootconfig, перезапишите трейлер и примените его повторно.

Поэтапная реализация и проверка

Реализуйте функцию bootconfig постепенно, следуя процессу, приведенному в этом разделе. Оставьте параметры ядра cmdline нетронутыми, пока добавляются параметры bootconfig.

Вот шаги для постепенной реализации с проверкой:

1. Внесите изменения в загрузчик и сборку, затем выполните следующие действия:
   1. Используйте переменную BOARD_BOOTCONFIG для добавления нового параметра bootconfig.
   2. Сохраните параметры cmdline ядра такими, какие они есть, чтобы устройство могло продолжать корректно загружаться. Это значительно упрощает отладку и проверку.
2. Проверьте свою работу, проверив содержимое /proc/bootconfig . Убедитесь, что вы видите новый добавленный параметр после загрузки устройства.
3. Переместите параметры androidboot.* из командной строки ядра в bootconfig, используя переменную BOARD_BOOTCONFIG и загрузчик.
4. Проверьте , что каждый из параметров существует в /proc/bootconfig И что их нет в /proc/cmdline . Если вы можете это проверить, ваша реализация прошла успешно.

Рекомендации по обновлению и понижению версии OTA

При управлении обновлениями и понижениями OTA между различными версиями Android или различными версиями ядра следует проявлять особую осторожность.

Android 12 — первая версия с поддержкой bootconfig. При понижении до любой более ранней версии вместо bootconfig необходимо использовать параметры ядра cmdline.

Версии ядра 12-5.4 и более поздние поддерживают bootconfig. При понижении до любой более ранней версии (включая 11-5.4) необходимо использовать параметры командной строки ядра.

Обновления с Android 11 и ниже до Android 12 и выше могут продолжать использовать параметры ядра cmdline. То же самое касается обновления версий ядра.

Поиск неисправностей

Если при выполнении шага проверки вы не видите ожидаемых параметров в /proc/bootconfig , проверьте журналы ядра в logcat . Запись в журнале для bootconfig всегда присутствует, если ядро ​​поддерживает ее.

Пример вывода журнала

$ adb logcat | grep bootconfig
02-24 17:00:07.610     0     0 I Load bootconfig: 128 bytes 9 nodes

Если вы видите возвращенный журнал ошибок, то возникла проблема с загрузкой bootconfig. Чтобы увидеть различные типы ошибок, просмотрите init/main.c .