Android 10 ขึ้นไปรองรับพาร์ติชันที่ปรับขนาดได้โดยทำดังนี้ กำลังย้ายการใช้งาน Fastboot จาก Bootloader ไปยัง userspace ช่วงเวลานี้ การย้ายตำแหน่งทำให้สามารถย้ายโค้ด Flash ไปไว้ในที่ที่บำรุงรักษาและทดสอบได้ ตำแหน่งทั่วไปที่มีเฉพาะส่วนของผู้ให้บริการเฉพาะของ Fastboot ที่ใช้งานโดย ชั้นแอบสแตรกชันของฮาร์ดแวร์ (HAL) นอกจากนี้ Android 12 และที่สูงกว่ารองรับ RAM ดิสก์ที่กะพริบผ่านคำสั่ง Fastboot ที่เพิ่มขึ้น
รวม Fastboot และการกู้คืนเข้าด้วยกัน
เนื่องจาก Fastboot และการกู้คืนของ userspace มีความคล้ายคลึงกัน คุณจึงผสานรวมทั้งสองเป็น พาร์ติชันหรือไบนารี ซึ่งจะมีข้อดีต่างๆ เช่น ใช้พื้นที่น้อยลง พาร์ติชันโดยรวมน้อยลง และการมี Fastboot และการกู้คืน เคอร์เนลและไลบรารี
Bootloader ต้องใช้บล็อกการควบคุมการเปิดเครื่องใหม่เพื่อรองรับ fastbootd
(BCB) ของ boot-fastboot
เพื่อเข้าสู่โหมด fastbootd
, Bootloader
เขียน boot-fastboot
ในช่องคำสั่งของข้อความ BCB และออกจากฟิลด์
ช่อง recovery
ของ BCB ไม่เปลี่ยนแปลง (เพื่อเปิดใช้การรีสตาร์ทการกู้คืนที่หยุดชะงัก
งาน) ช่อง status
, stage
และ reserved
ยังคงเหมือนเดิมเช่นกัน
Bootloader โหลดและเปิดเครื่องเข้าสู่อิมเมจการกู้คืนเมื่อเห็น
boot-fastboot
ในช่องคำสั่ง BCB การกู้คืนจะแยกวิเคราะห์ข้อความ BCB
และเปลี่ยนเป็นโหมด fastbootd
คำสั่ง ADB
ส่วนนี้อธิบายคำสั่ง adb
สำหรับการผสานรวม fastbootd
จะมีผลลัพธ์ต่างกัน ขึ้นอยู่กับว่าเป็นการทำงานโดยระบบหรือ
ตามการกู้คืน
คำสั่ง | คำอธิบาย |
---|---|
reboot fastboot |
|
คำสั่ง Fastboot
ส่วนนี้อธิบายคำสั่ง Fastboot สำหรับการผสานรวม fastbootd
รวมถึงคำสั่งใหม่สำหรับแฟลชและจัดการพาร์ติชันเชิงตรรกะ ใช้บ้าง
จะมีผลลัพธ์ที่แตกต่างกัน โดยขึ้นอยู่กับว่ามีการดำเนินการตามคำสั่งนั้นหรือไม่
Bootloader หรือโดย fastbootd
คำสั่ง | คำอธิบาย |
---|---|
reboot recovery |
|
reboot fastboot |
รีบูตเข้าสู่ fastbootd |
getvar is-userspace |
|
getvar is-logical:<partition> |
แสดงผล yes หากพาร์ติชันที่ระบุเป็นพาร์ติชันเชิงตรรกะ
no หรือไม่เช่นนั้น
พาร์ติชันลอจิคัลรองรับคำสั่งทั้งหมดที่ระบุไว้ด้านล่าง |
getvar super-partition-name |
แสดงผลชื่อของซูเปอร์พาร์ติชัน ชื่อมีช่องปัจจุบัน คำต่อท้ายหากซูเปอร์พาร์ติชันเป็นพาร์ติชัน A/B (มักจะไม่ใช่) |
create-logical-partition <partition> <size> |
สร้างพาร์ติชันเชิงตรรกะที่มีชื่อและขนาดที่ระบุ ชื่อต้องไม่ มีเป็นพาร์ติชันเชิงตรรกะอยู่แล้ว |
delete-logical-partition <partition> |
ลบพาร์ติชันตรรกะที่ระบุ (ล้างข้อมูลพาร์ติชันอย่างมีประสิทธิภาพ) |
resize-logical-partition <partition> <size> |
ปรับขนาดพาร์ติชันตรรกะเป็นขนาดใหม่โดยไม่เปลี่ยนเนื้อหา ไม่สำเร็จหากมีพื้นที่ไม่เพียงพอที่จะทำการปรับขนาด |
update-super <partition> |
ผสานการเปลี่ยนแปลงข้อมูลเมตาซูเปอร์พาร์ติชันเข้าด้วยกัน หากผสานไม่ได้
(เช่น รูปแบบในอุปกรณ์เป็นเวอร์ชันที่ไม่รองรับ) จากนั้น
ล้มเหลว พารามิเตอร์ wipe ที่ไม่บังคับจะเขียนทับ
แทนการทำการผสานรวม |
flash <partition> [ <filename> ] |
เขียนไฟล์ลงในพาร์ติชัน Flash อุปกรณ์ต้องอยู่ในสถานะปลดล็อกแล้ว |
erase <partition> |
ลบพาร์ติชัน (ไม่จำเป็นต้องลบแบบปลอดภัย) อุปกรณ์ต้องอยู่ใน สถานะปลดล็อก |
getvar <variable> | all |
แสดงตัวแปร Bootloader หรือตัวแปรทั้งหมด หากตัวแปรไม่ ที่มีอยู่แล้วจะแสดงผลข้อผิดพลาด |
set_active <slot> |
ตั้งค่าช่องเปิดเครื่อง A/B ที่ระบุเป็น สล็อตคือชุดพาร์ติชันที่ซ้ำกันซึ่งบูตได้สำหรับการสนับสนุน A/B
อย่างอิสระ สล็อตจะมีชื่อว่า |
reboot |
รีบูตอุปกรณ์ตามปกติ |
reboot-bootloader (หรือ reboot bootloader ) |
รีบูตอุปกรณ์ลงใน Bootloader |
fastboot fetch vendor_boot <out.img> |
ใช้ใน Android 12 ขึ้นไปเพื่อ รองรับ Ramdisk ของผู้ให้บริการที่มี Flash
รับขนาดพาร์ติชันทั้งหมดและขนาดกลุ่ม ได้รับข้อมูล
แต่ละกลุ่ม
จากนั้นเย็บข้อมูลเข้าด้วยกันเป็น
โปรดดูรายละเอียดที่หัวข้อ |
fastboot flash vendor_boot:default <vendor-ramdisk.img> |
ใช้ใน Android 12 ขึ้นไปเพื่อรองรับ RAM ของผู้ให้บริการแบบแฟลช นี่เป็นรูปแบบพิเศษของคำสั่ง Flash โดยจะใช้ฟังก์ชันรูปภาพ
โปรดดูรายละเอียดที่หัวข้อ
|
fastboot flash vendor_boot:<foo> <vendor-ramdisk.img> |
ใช้ใน Android 12 ขึ้นไปเพื่อ
รองรับ RAMD ของผู้ให้บริการแฟลช ดึงรูปภาพ โปรดดูรายละเอียดที่หัวข้อ
|
Fastboot และ Bootloader
Bootloader กะพริบ bootloader
, radio
และ boot/recovery
พาร์ติชัน หลังจากนั้นอุปกรณ์จะเปิดเครื่องใน Fastboot (userspace) และกะพริบ
พาร์ติชันอื่นๆ ทั้งหมด Bootloader ควรรองรับคำสั่งต่อไปนี้
คำสั่ง | คำอธิบาย |
---|---|
download |
ดาวน์โหลดรูปภาพเพื่อแฟลช |
flash recovery <image>/ flash boot <image>/ flash
bootloader <image>/ |
แฟลชพาร์ติชัน recovery/boot และ Bootloader |
reboot |
รีบูตอุปกรณ์ |
reboot fastboot |
รีบูตเพื่อเข้าสู่ Fastboot |
reboot recovery |
รีบูตเพื่อกู้คืน |
getvar |
รับตัวแปร Bootloader ที่จำเป็นสำหรับการแฟลชการกู้คืน/การเปิดเครื่อง
รูปภาพ (เช่น current-slot และ
max-download-size ) |
oem <command> |
คำสั่งที่กำหนดโดย OEM |
พาร์ติชันแบบไดนามิก
Bootloader ต้องไม่อนุญาตให้มีการกะพริบหรือลบพาร์ติชันแบบไดนามิก
และต้องแสดงข้อผิดพลาดหากมีการพยายามดำเนินการเหล่านี้ แบบปรับปรุงใหม่
อุปกรณ์แบ่งพาร์ติชันแบบไดนามิก เครื่องมือ Fastboot (และ Bootloader) รองรับแรง
เพื่อแฟลชพาร์ติชันแบบไดนามิกโดยตรงขณะอยู่ในโหมด Bootloader สำหรับ
ตัวอย่างเช่น หาก system
เป็นพาร์ติชันแบบไดนามิกในอุปกรณ์รีด
การใช้คำสั่ง fastboot --force flash system
จะเปิดใช้ Bootloader
(แทน fastbootd
) เพื่อแฟลชพาร์ติชัน
การชาร์จนอกโหมด
หากอุปกรณ์รองรับการชาร์จนอกโหมดหรือการรีบูตอัตโนมัติเป็นกรณีพิเศษ
เมื่อมีการใช้พลังงาน
คำสั่ง fastboot oem off-mode-charge 0
ต้อง
ข้ามโหมดพิเศษเหล่านี้เพื่อให้อุปกรณ์เปิดเครื่องเสมือนว่าผู้ใช้กด
ปุ่มเปิด/ปิด
HAL ของ Fastboot OEM
ในการเปลี่ยน Fastboot ของ Bootloader โดยสมบูรณ์ Fastboot ต้องจัดการทุกอย่างที่มีอยู่ Fastboot คำสั่งเหล่านี้หลายคำสั่งมาจาก OEM และมีการทำเอกสารประกอบ แต่ ต้องมีการใช้งานที่กำหนดเอง คําสั่งเฉพาะ OEM จํานวนมากไม่ได้ จัดทำเป็นเอกสาร ในการจัดการคำสั่งดังกล่าว Fastboot HAL จะระบุ คำสั่ง OEM นอกจากนี้ OEM ยังใช้คำสั่งของตัวเองได้อีกด้วย
คำจำกัดความของ Fastboot HAL มีดังนี้
import IFastbootLogger;
/**
* IFastboot interface implements vendor specific fastboot commands.
*/
interface IFastboot {
/**
* Returns a bool indicating whether the bootloader is enforcing verified
* boot.
*
* @return verifiedBootState True if the bootloader is enforcing verified
* boot and False otherwise.
*/
isVerifiedBootEnabled() generates (bool verifiedBootState);
/**
* Returns a bool indicating the off-mode-charge setting. If off-mode
* charging is enabled, the device autoboots into a special mode when
* power is applied.
*
* @return offModeChargeState True if the setting is enabled and False if
* not.
*/
isOffModeChargeEnabled() generates (bool offModeChargeState);
/**
* Returns the minimum battery voltage required for flashing in mV.
*
* @return batteryVoltage Minimum battery voltage (in mV) required for
* flashing to be successful.
*/
getBatteryVoltageFlashingThreshold() generates (int32_t batteryVoltage);
/**
* Returns the file system type of the partition. This is only required for
* physical partitions that need to be wiped and reformatted.
*
* @return type Can be ext4, f2fs or raw.
* @return result SUCCESS if the operation is successful,
* FAILURE_UNKNOWN if the partition is invalid or does not require
* reformatting.
*/
getPartitionType(string partitionName) generates (FileSystemType type, Result result);
/**
* Executes a fastboot OEM command.
*
* @param oemCmd The oem command that is passed to the fastboot HAL.
* @response result Returns the status SUCCESS if the operation is
* successful,
* INVALID_ARGUMENT for bad arguments,
* FAILURE_UNKNOWN for an invalid/unsupported command.
*/
doOemCommand(string oemCmd) generates (Result result);
};
เปิดใช้ Fastbootd
วิธีเปิดใช้ fastbootd
ในอุปกรณ์
เพิ่ม
fastbootd
ไปยังPRODUCT_PACKAGES
ในdevice.mk
:PRODUCT_PACKAGES += fastbootd
ตรวจสอบว่ามีแพ็กเกจ Fastboot HAL, HAL การควบคุมการเปิดเครื่อง และ HAL สถานะการทำงาน เป็นส่วนหนึ่งของอิมเมจการกู้คืน
เพิ่มสิทธิ์ SEPolicy เฉพาะอุปกรณ์ที่จำเป็นใน
fastbootd
สำหรับ เช่นfastbootd
ต้องการสิทธิ์ในการเขียนพาร์ติชันเฉพาะอุปกรณ์เพื่อ แฟลชพาร์ติชันนั้น นอกจากนี้ การใช้ Fastboot HAL ยังอาจ ต้องใช้สิทธิ์เฉพาะอุปกรณ์
หากต้องการตรวจสอบ Fastboot ของพื้นที่ผู้ใช้ ให้เรียกใช้ Vendor Test Suite (VTS)
RAM ของผู้ให้บริการ Flash
Android 12 ขึ้นไปให้การสนับสนุนสำหรับ
ramdisks ที่กะพริบด้วยคำสั่ง Fastboot ที่เพิ่มซึ่งจะดึง
รูปภาพ vendor_boot
รูปจากอุปกรณ์ คำสั่งจะแสดง Fastboot ฝั่งโฮสต์
เพื่ออ่านส่วนหัวการเปิดเครื่องของผู้ให้บริการ สร้างอิมเมจใหม่ และแฟลชอิมเมจใหม่
หากต้องการดึงอิมเมจ vendor_boot
แบบเต็ม มีการเพิ่มคำสั่ง fetch:vendor_boot
ทั้งโปรโตคอล Fastboot และการใช้งาน Fastbootd ของโปรโตคอล
ใน Android 12 โปรดทราบว่า Fastbootd
ใช้โค้ดนี้ แต่ตัว Bootloader เองอาจไม่สามารถใช้งานได้ OEM สามารถเพิ่มได้
คำสั่ง fetch:vendor_boot
สำหรับการใช้งาน Bootloader
แต่หากระบบไม่รู้จักคำสั่งนี้ในโหมด Bootloader
การแฟลช RAM ของผู้ให้บริการแต่ละรายในโหมด Bootloader ไม่ได้รับการรองรับจากผู้ให้บริการ
ตัวเลือก
การเปลี่ยนแปลง Bootloader
ใช้คำสั่ง getvar:max-fetch-size
และ fetch:name
ใน
fastbootd
หากต้องการรองรับการแฟลช RAM ของผู้ให้บริการใน Bootloader คุณต้อง
ให้ใช้คำสั่ง 2 ข้อนี้
การเปลี่ยนแปลง Fastbootd
getvar:max-fetch-size
คล้ายกับ max-download-size
ซึ่งระบุ
ขนาดสูงสุดที่อุปกรณ์สามารถส่งในการตอบสนอง DATA หนึ่งครั้ง ผู้ขับขี่ต้องไม่
ดึงข้อมูลขนาดที่ใหญ่กว่าค่านี้
fetch:name[:offset[:size]]
ดำเนินการตรวจสอบอุปกรณ์หลายครั้ง หากทั้งหมด
รายการต่อไปนี้เป็นจริง คำสั่ง fetch:name[:offset[:size]]
จะแสดงผลข้อมูล
- อุปกรณ์กำลังใช้บิลด์ที่แก้ไขข้อบกพร่องได้
- อุปกรณ์ปลดล็อกอยู่ (สถานะเปิดเครื่องสีส้ม)
- ชื่อพาร์ติชันที่ดึงข้อมูลคือ
vendor_boot
- ค่า
size
อยู่ในช่วง 0 <size
<=max-fetch-size
เมื่อค่าเหล่านี้ได้รับการยืนยันแล้ว fetch:name[:offset[:size]]
จะแสดงผลขนาดพาร์ติชัน
และออฟเซ็ต
ข้อควรทราบ
fetch:name
เทียบเท่ากับfetch:name:0
ซึ่งเทียบเท่ากับfetch:name:0:partition_size
fetch:name:offset
เทียบเท่ากับ วันที่fetch:name:offset:(partition_size - offset)
ดังนั้น fetch:name[:offset[:size]]
=
fetch:name:offset:(partition_size - offset)
เมื่อไม่ได้ระบุ offset
หรือ partition_size
(หรือทั้ง 2 อย่าง) ฟังก์ชัน
ระบบจะใช้ค่าเริ่มต้น ซึ่งสำหรับ offset
จะเป็น 0 และสำหรับ size
คือ
ที่คำนวณได้เป็น partition_size - offset
- ออฟเซ็ตที่ระบุ ไม่ได้ระบุขนาด:
size = partition_size - offset
- ไม่ได้ระบุ: ค่าเริ่มต้นที่ใช้สำหรับทั้ง 2 อย่าง ได้แก่
size = partition_size
- 0
เช่น fetch:foo
ดึงข้อมูลพาร์ติชัน foo
ทั้งหมดที่ออฟเซ็ต 0
การเปลี่ยนผู้ขับขี่
มีการเพิ่มคำสั่งลงในเครื่องมือ Fastboot เพื่อใช้การเปลี่ยนแปลงไดรเวอร์ แต่ละรายการคือ ซึ่งเชื่อมโยงกับคำจำกัดความที่สมบูรณ์ในตารางของ Fastboot คำสั่ง
fastboot fetch vendor_boot out.img
- เรียกใช้
getvar max-fetch-size
เพื่อระบุขนาดกลุ่ม - เรียกใช้
getvar partition-size:vendor_boot[_a]
เพื่อระบุ ของทั้งพาร์ติชัน - โทร
fastboot fetch vendor_boot[_a]:offset:size
สำหรับแต่ละรายการ บางส่วน (กลุ่มมีขนาดใหญ่กว่าvendor_boot
ดังนั้นจึงมีเพียงกลุ่มเดียว) - ต่อข้อมูลเข้าด้วยกันเป็น
out.img
- เรียกใช้
fastboot flash vendor_boot:default vendor-ramdisk.img
นี่เป็นรูปแบบพิเศษของคำสั่ง Flash โดยจะดึงข้อมูล รูปภาพ
vendor_boot
รูป เหมือนกับว่ามีคนเรียกfastboot fetch
- หากการเปิดเครื่องของผู้ให้บริการคือเวอร์ชันส่วนหัว
3
จะทำงานดังต่อไปนี้
- แทนที่ RAM ของผู้ให้บริการด้วยอิมเมจที่ระบุ
- กะพริบรูปภาพ
vendor_boot
ใหม่
- ถ้าส่วนหัวการเปิดเครื่องของผู้ให้บริการคือ เวอร์ชัน
4
จะทำงานดังต่อไปนี้
- แทนที่ RAM ของผู้ให้บริการทั้งหมดด้วยอิมเมจที่ระบุเพื่อให้
อิมเมจที่ระบุกลายเป็นส่วนย่อย ramdisk ของผู้ให้บริการเพียง 1 รายการใน
รูปภาพ
vendor_boot
รูป - คำนวณขนาดและออฟเซ็ตในตาราง RAM ของผู้ให้บริการใหม่
- กะพริบรูปภาพ
vendor_boot
ใหม่
- แทนที่ RAM ของผู้ให้บริการทั้งหมดด้วยอิมเมจที่ระบุเพื่อให้
อิมเมจที่ระบุกลายเป็นส่วนย่อย ramdisk ของผู้ให้บริการเพียง 1 รายการใน
รูปภาพ
- หากการเปิดเครื่องของผู้ให้บริการคือเวอร์ชันส่วนหัว
3
จะทำงานดังต่อไปนี้
fastboot flash vendor_boot:foo vendor-ramdisk.img
ดึงข้อมูล
vendor_boot image
เหมือนกับมีการเรียกfastboot fetch
- หากส่วนหัวการเปิดเครื่องของผู้ให้บริการเป็นเวอร์ชัน 3 ข้อผิดพลาดจะแสดงข้อผิดพลาด
หากส่วนหัวการเปิดเครื่องของผู้ให้บริการเป็นเวอร์ชัน 4 ระบบจะดำเนินการดังต่อไปนี้
- ค้นหาส่วนย่อย RAM ของผู้ให้บริการที่มีชื่อ
foo
หากไม่พบ หรือ หากมีการจับคู่ที่ตรงกันหลายรายการ ระบบจะแสดงข้อผิดพลาด - แทนที่ส่วน RAM ของผู้ให้บริการด้วยอิมเมจที่ระบุ
- คำนวณขนาดและออฟเซ็ตแต่ละขนาดใหม่ในตาราง RAM ของผู้ให้บริการ
- กะพริบรูปภาพ
vendor_boot
ใหม่
- ค้นหาส่วนย่อย RAM ของผู้ให้บริการที่มีชื่อ
Mkbootimg
ชื่อ default
สงวนไว้สำหรับการตั้งชื่อ Fragment ramdisk ของผู้ให้บริการใน
Android 12 ขึ้นไป ขณะที่ Fastboot flash vendor_boot:default
ความหมายยังคงเหมือนเดิม คุณต้องไม่ตั้งชื่อส่วนย่อย ramdisk เป็น
default
การเปลี่ยนแปลงใน SELinux
มีการเปลี่ยนแปลงใน
fastbootd.te
เพื่อรองรับ RAM ดิสก์ของผู้ให้บริการแฟลช