ใน 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
ดูการเปลี่ยนแปลงของปลาหมึกเพื่อทำดังต่อไปนี้:
- ใช้ (หรือ uprev ไป) เวอร์ชันส่วนหัวการบูตของผู้ขาย v4
- เพิ่ม
bootconfig to the kernel cmdline and move selected parameters to 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
จากส่วนหัวของอิมเมจสำหรับบูตของผู้ขาย
รูปที่ 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
นี่คือขั้นตอนสำหรับการใช้งานที่เพิ่มขึ้นโดยมีการตรวจสอบความถูกต้อง:
- ทำการ เปลี่ยนแปลง bootloader และบิลด์ จากนั้นทำดังต่อไปนี้:
- ใช้ตัวแปร
BOARD_BOOTCONFIG
เพื่อเพิ่มพารามิเตอร์ bootconfig ใหม่ - รักษาพารามิเตอร์ cmdline ของเคอร์เนลตามที่เป็นอยู่ เพื่อให้อุปกรณ์สามารถบู๊ตได้อย่างถูกต้อง ทำให้การดีบักและการตรวจสอบทำได้ง่ายขึ้นมาก
- ใช้ตัวแปร
- ตรวจสอบ งานของคุณโดยตรวจสอบเนื้อหาของ
/proc/bootconfig
ตรวจสอบว่าคุณเห็นพารามิเตอร์ที่เพิ่มใหม่หลังจากที่อุปกรณ์บูตแล้ว - ย้าย พารามิเตอร์
androidboot.*
จากเคอร์เนล cmdline ไปยัง bootconfig โดยใช้ตัวแปรBOARD_BOOTCONFIG
และ bootloader - ตรวจสอบ ว่าพารามิเตอร์แต่ละตัวมีอยู่ใน
/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