รองรับอุปกรณ์แบบไม่ใช้แบตเตอรี่

หน้านี้จะอธิบายวิธีที่ Android จัดการกับผลิตภัณฑ์ที่มีแบตเตอรี่แบบถอดได้หรือไม่มีแบตเตอรี่ภายใน อุปกรณ์ในภายหลังจะเชื่อมต่อกับแหล่งจ่ายไฟภายนอกแทน เช่น เต้ารับ AC หรือพอร์ต USB บนอุปกรณ์อื่น

มีแบตเตอรี่ไหม

แอปพลิเคชันอาจใช้โค้ดต่อไปนี้เพื่อตรวจสอบว่าอุปกรณ์มีแบตเตอรี่อยู่หรือไม่

```
final Intent batteryInfo = registerReceiver(null, new
IntentFilter(Intent.ACTION_BATTERY_CHANGED));

return batteryInfo.getBooleanExtra(BatteryManager.EXTRA_PRESENT, true);
```

ลักษณะการทํางานของอุปกรณ์ที่ไม่มีแบตเตอรี่

หาก Android ไม่พบอุปกรณ์แบตเตอรี่สำหรับผลิตภัณฑ์ ระบบจะใช้ค่าเริ่มต้นที่เกี่ยวข้องกับแบตเตอรี่ต่อไปนี้ โปรดทราบว่าค่าเริ่มต้นมีการเปลี่ยนแปลงในรุ่น Android 9 ตารางนี้แสดงความแตกต่าง

สถานะแบตเตอรี่	Android 9 ขึ้นไป	Android 8.1 และต่ำกว่า
นำเสนอ	เท็จ	จริง
สถานะ	ไม่ทราบ	กำลังชาร์จ
ความจุที่เหลือ	0	100%
สุขภาพ	ไม่ทราบ	ดี
สถานะออนไลน์ของที่ชาร์จ AC	ไม่มีการแก้ไข	บังคับให้เป็น "จริง"

ผู้ผลิตอาจเปลี่ยนแปลงการตั้งค่าเริ่มต้นโดยใช้ไดรเวอร์เคอร์เนล power_supply หรือ Health HAL

Android 9 ขึ้นไป

Android 9 นำโค้ดก่อนหน้านี้บางส่วนสำหรับอุปกรณ์ที่ไม่มีแบตเตอรี่ออก ซึ่งโดยค่าเริ่มต้นจะหลอกว่ามีแบตเตอรี่ กำลังชาร์จ 100% และอยู่ในสถานะดีพร้อมการอ่านอุณหภูมิปกติในเทอร์มิสเตอร์

API เฟรมเวิร์กส่วนใหญ่ที่จัดการข้อมูลนี้จะยังคงจัดการสถานการณ์ทั่วไปเหมือนเดิม นั่นคือ ระบบจะถือว่ากำลังชาร์จ (ไม่ได้ใช้พลังงานจากแบตเตอรี่) และจะไม่ถือว่ามีแบตเตอรี่เหลือน้อย หากอินเทอร์เฟซผู้ใช้วาดไอคอนแบตเตอรี่ ไอคอนดังกล่าวจะปรากฏขึ้นพร้อมกับเครื่องหมายตกใจ และเปอร์เซ็นต์แบตเตอรี่จะแสดงเป็น 0% แต่อุปกรณ์จะไม่ปิดเนื่องจากแบตเตอรี่เหลือน้อย และระบบจะกำหนดเวลางานที่ต้องชาร์จแบตเตอรี่หรือแบตเตอรี่ต้องเต็ม

Android 8.1 และต่ำกว่า

เนื่องจากไม่ทราบสถานะแบตเตอรี่ API เฟรมเวิร์ก Android จึงจะถือว่าระบบกำลังชาร์จ (หรือไม่ได้ใช้พลังงานแบตเตอรี่) และจะไม่ถือว่าแบตเตอรี่เหลือน้อย หากอินเทอร์เฟซผู้ใช้แสดงผลไอคอนแบตเตอรี่ ไอคอนดังกล่าวจะปรากฏขึ้นพร้อมกับเครื่องหมายตกใจ และเปอร์เซ็นต์แบตเตอรี่จะแสดงเป็น 0% แต่อุปกรณ์จะไม่ปิดเนื่องจากแบตเตอรี่เหลือน้อย และระบบจะกำหนดเวลางานที่ต้องชาร์จหรือแบตเตอรี่เต็ม

การใช้งาน

รหัสเริ่มต้นของ Android 9 อาจทำงานได้อย่างถูกต้องสำหรับอุปกรณ์ของคุณ แต่เราขอแนะนำให้เปลี่ยนเคอร์เนลหรือ HAL เพื่อแสดงสถานะพลังงานและแบตเตอรี่ของผลิตภัณฑ์อย่างถูกต้องตามที่อธิบายไว้ข้างต้น หาก Android 9 ขึ้นไปไม่พบอุปกรณ์ชาร์จประเภทแหล่งจ่ายไฟ Linux ระบบจะตั้งค่าสถานะอุปกรณ์ชาร์จทุกประเภท (AC, USB, ไร้สาย) เป็นออฟไลน์โดยค่าเริ่มต้น หากที่ชาร์จทั้งหมดออฟไลน์แต่ไม่มีการตรวจพบอุปกรณ์ที่ใช้แบตเตอรี่ ระบบจะยังคงถือว่าอุปกรณ์กำลังชาร์จอยู่ ในแง่ที่ว่าอุปกรณ์ทำงานโดยใช้แหล่งจ่ายไฟภายนอก ไม่ใช่แบตเตอรี่ ตามที่อธิบายไว้ก่อนหน้านี้

หากผลิตภัณฑ์ไม่มีแบตเตอรี่และเชื่อมต่อกับแหล่งจ่ายไฟอยู่เสมอ คุณควรใช้ไดรเวอร์ charger คลาส power_supply ของเคอร์เนล Linux สำหรับแหล่งจ่ายไฟ AC หรือ USB ซึ่งตั้งค่าแอตทริบิวต์ sysfs online เป็น true หรือจะกำหนดค่าพร็อพเพอร์ตี้ออนไลน์ของที่ชาร์จ AC ใน HAL ของ Health สำหรับอุปกรณ์ก็ได้ โดยให้ใช้ HAL ของ Health ตามที่อธิบายไว้ในการใช้ Health 2.0

Health HAL ที่กำหนดเองนี้ใช้ Health::getHealthInfo() เวอร์ชันที่กำหนดเองซึ่งแก้ไขค่าของ BatteryProperties.chargerAcOnline = true

หากต้องการเริ่มต้นใช้งาน ให้คัดลอกไฟล์ hardware/interfaces/health/2.0/default/Health.cpp ไปยังการติดตั้งใช้งาน Health HAL ของคุณเอง และแก้ไขไฟล์ตาม Health 2.0 README