การนำ Bootconfig ไปใช้ใน Android 12

ใน Android 12 คุณลักษณะ bootconfig จะมาแทนที่ androidboot.* ตัวเลือก cmdline เคอร์เนลที่ใช้กับ Android 11 และต่ำกว่า คุณลักษณะ bootconfig เป็นกลไกสำหรับส่งรายละเอียดการกำหนดค่าจากบิลด์และ bootloader ไปยัง Android 12

คุณลักษณะนี้มีวิธีแยกพารามิเตอร์การกำหนดค่าสำหรับพื้นที่ผู้ใช้ Android ออกจากพารามิเตอร์สำหรับเคอร์เนล การย้ายพารามิเตอร์เคอร์เนล androidboot.* ที่มีความยาวไปยังไฟล์ bootconfig จะสร้างพื้นที่บน cmdline ของเคอร์เนล และทำให้พร้อมใช้งานสำหรับการขยายในอนาคตที่ง่ายดาย

ทั้งเคอร์เนลและพื้นที่ผู้ใช้ Android ต้องรองรับ bootconfig

  • รุ่นแรกที่รองรับนี้: Android 12
  • เคอร์เนลเวอร์ชันแรกที่รองรับนี้: 12-5.4.xx kernel

ใช้คุณลักษณะ bootconfig สำหรับอุปกรณ์ ใหม่ ที่เปิดตัวด้วยเวอร์ชันเคอร์เนล 12-5.10.xx คุณไม่จำเป็นต้องใช้งานหากคุณกำลังอัปเกรดอุปกรณ์

ตัวอย่างและที่มา

เมื่อคุณดูตัวอย่างและซอร์สโค้ดในส่วนนี้ โปรดทราบว่ารูปแบบของโค้ด bootconfig แตกต่างเพียงเล็กน้อยจากรูปแบบของเคอร์เนล cmdline ที่ใช้ใน Android 11 และต่ำกว่า อย่างไรก็ตาม ข้อแตกต่างต่อไปนี้มีความสำคัญต่อการใช้งานของคุณ:

  • พารามิเตอร์ต้องคั่นด้วยลำดับหลีกขึ้นบรรทัดใหม่ \n ไม่ใช่ด้วยการเว้นวรรค

ตัวอย่าง Bootloader

สำหรับตัวอย่าง bootloader ดูการใช้งาน Bootloader อ้างอิง Cuttlefish U-boot สองคอมมิตในการอ้างอิงมีการระบุไว้ด้านล่าง ครั้งแรก uprevs เวอร์ชันส่วนหัวของบูตสนับสนุนเวอร์ชันล่าสุด ในตัวอย่าง คอมมิตแรกอัพเดต (หรืออัพเรฟ) เวอร์ชันรองรับเวอร์ชันถัดไป v4. ประการที่สองทำสองสิ่ง มันเพิ่มการจัดการ bootconfig และสาธิตการเพิ่มพารามิเตอร์ที่รันไทม์:

ตัวอย่างการสร้าง

สำหรับตัวอย่างบิลด์ที่แสดงการเปลี่ยนแปลง mkbootimg ในการสร้าง vendor_boot.img ด้วย vendor boot header v4 โปรดดู mkbootimg changes for bootconfig ดูการเปลี่ยนแปลงของปลาหมึกเพื่อทำดังต่อไปนี้:

การดำเนินการ

พันธมิตรต้องเพิ่มการสนับสนุนให้กับ bootloaders และย้ายพารามิเตอร์ build-time androidboot.* จากเคอร์เนล cmdline ไปยังไฟล์ bootconfig วิธีที่ดีที่สุดในการใช้การเปลี่ยนแปลงนี้คือทำทีละน้อย ดูส่วนการใช้งานที่ เพิ่มขึ้นและการตรวจสอบ สำหรับข้อมูลเกี่ยวกับการปฏิบัติตามกระบวนการที่เพิ่มขึ้น

หากคุณมีการเปลี่ยนแปลงที่ค้นหาไฟล์ /proc/cmdline สำหรับพารามิเตอร์ androidboot.* ให้ชี้ไปที่ไฟล์ /proc/bootconfig แทน คุณสมบัติ ro.boot.* ถูกตั้งค่าด้วยค่า bootconfig ใหม่ ดังนั้นคุณไม่จำเป็นต้องทำการเปลี่ยนแปลงโค้ดโดยใช้คุณสมบัติเหล่านั้น

สร้างการเปลี่ยนแปลง

ขั้นแรก ให้ uprev เวอร์ชันส่วนหัวสำหรับบูตของคุณเป็นเวอร์ชัน 4:

- BOARD_BOOT_HEADER_VERSION := 3

+ BOARD_BOOT_HEADER_VERSION := 4

เพิ่มพารามิเตอร์ cmdline เคอร์เนล bootconfig สิ่งนี้ทำให้เคอร์เนลมองหาส่วน bootconfig:

BOARD_KERNEL_CMDLINE += bootconfig

พารามิเตอร์ bootconfig ถูกสร้างขึ้นจากพารามิเตอร์ในตัวแปร BOARD_BOOTCONFIG เหมือนกับที่เคอร์เนล cmdline สร้างขึ้นจาก BOARD\_KERNEL\_CMDLINE

พารามิเตอร์ androidboot.* ใดๆ สามารถย้ายได้ตามที่เป็น คล้ายกับต่อไปนี้:

- BOARD_KERNEL_CMDLINE += androidboot..selinux=enforcing

+ BOARD_BOOTCONFIG += androidboot..selinux=enforcing

การเปลี่ยนแปลง Bootloader

bootloader ตั้งค่า initramfs ก่อนที่จะข้ามไปที่เคอร์เนล การ กำหนดค่าการบูตเคอร์เนล จะค้นหาส่วน bootconfig และมองหาส่วนท้ายสุดของ initramfs, พร้อมกับตัวอย่างที่คาดไว้

bootloader รับข้อมูลโครงร่าง vendor_boot.img จากส่วนหัวของอิมเมจสำหรับบูตของผู้ขาย

Diagram of bootconfig memory allocation layout

รูปที่ 1. การจัดสรรหน่วยความจำ bootconfig ของ Android 12

bootloader สร้างส่วน bootconfig ในหน่วยความจำ ส่วน bootconfig ประกอบด้วยการจัดสรรหน่วยความจำสำหรับสิ่งต่อไปนี้:

  • พารามิเตอร์
  • 4 B ขนาด parameters size
  • 4 B ขนาด parameters checksum
  • สตริงมายากล bootconfig 12 B ( #BOOTCONFIG\n )

พารามิเตอร์มาจากแหล่งที่มาสองแหล่ง: พารามิเตอร์ที่รู้จัก ณ เวลาสร้าง และพารามิเตอร์ที่ไม่รู้จักในเวลาสร้าง ต้องเพิ่มพารามิเตอร์ที่ไม่รู้จัก

พารามิเตอร์ที่ทราบ ณ เวลาบิลด์จะถูกรวมเข้ากับส่วนท้ายของอิมเมจ vendor_boot ในส่วน bootconfig ขนาดของส่วนถูกเก็บไว้ (เป็นไบต์) ในช่องส่วนหัวการบูตของผู้ขาย vendor_bootconfig_size

พารามิเตอร์ที่ไม่รู้จักในขณะสร้างจะทราบเฉพาะที่รันไทม์ใน bootloader ต้องเพิ่มสิ่งเหล่านี้ที่ส่วนท้ายของส่วนพารามิเตอร์ bootconfig ก่อนที่จะใช้ตัวอย่าง bootconfig

หากคุณต้องการเพิ่มพารามิเตอร์ใดๆ หลังจากที่ใช้ตัวอย่าง bootconfig แล้ว ให้เขียนทับตัวอย่างและนำไปใช้ใหม่

การใช้งานและการตรวจสอบที่เพิ่มขึ้น

ใช้คุณลักษณะ bootconfig ทีละส่วนโดยทำตามขั้นตอนที่ระบุในส่วนนี้ ปล่อยให้พารามิเตอร์ cmdline เคอร์เนลไม่ถูกแตะต้องในขณะที่เพิ่มพารามิเตอร์ bootconfig

นี่คือขั้นตอนสำหรับการใช้งานที่เพิ่มขึ้นโดยมีการตรวจสอบความถูกต้อง:

  1. ทำการ เปลี่ยนแปลง bootloader และบิลด์ จากนั้นทำดังต่อไปนี้:
    1. ใช้ตัวแปร BOARD_BOOTCONFIG เพื่อเพิ่มพารามิเตอร์ bootconfig ใหม่
    2. รักษาพารามิเตอร์ cmdline ของเคอร์เนลตามที่เป็นอยู่ เพื่อให้อุปกรณ์สามารถบู๊ตได้อย่างถูกต้อง ทำให้การดีบักและการตรวจสอบทำได้ง่ายขึ้นมาก
  2. ตรวจสอบ งานของคุณโดยตรวจสอบเนื้อหาของ /proc/bootconfig ตรวจสอบว่าคุณเห็นพารามิเตอร์ที่เพิ่มใหม่หลังจากที่อุปกรณ์บูตแล้ว
  3. ย้าย พารามิเตอร์ androidboot.* จากเคอร์เนล cmdline ไปยัง bootconfig โดยใช้ตัวแปร BOARD_BOOTCONFIG และ bootloader
  4. ตรวจสอบ ว่าพารามิเตอร์แต่ละตัวมีอยู่ใน /proc/bootconfig และ ไม่ได้ อยู่ใน /proc/cmdline หากคุณสามารถยืนยันได้ แสดงว่าการใช้งานของคุณสำเร็จ

ข้อควรพิจารณาในการอัพเกรดและดาวน์เกรด OTA

เมื่อคุณจัดการการอัปเกรด OTA และดาวน์เกรดระหว่าง Android เวอร์ชันต่างๆ หรือเวอร์ชันเคอร์เนลต่างๆ ควรใช้ความระมัดระวังเป็นพิเศษ

Android 12 เป็นเวอร์ชันแรกที่รองรับ bootconfig หากดาวน์เกรดเป็นเวอร์ชันก่อนหน้านั้น ต้องใช้พารามิเตอร์เคอร์เนล cmdline แทน bootconfig

เคอร์เนลเวอร์ชัน 12-5.4 และใหม่กว่ารองรับ bootconfig หากดาวน์เกรดเป็นเวอร์ชันก่อนหน้านั้น (รวมถึง 11-5.4) ต้องใช้พารามิเตอร์ cmdline ของเคอร์เนล

การอัปเกรดจาก 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