إدارة الطاقة

لتوفير إدارة الطاقة الخاصة بالمركبة، يوفّر Android خدمة CarPowerManagementService وواجهة CarPowerManager.

يتم تفعيل عمليات الانتقال بين الحالات من خلال وحدة التحكّم الرئيسية في المركبة (VMCU). للتواصل مع وحدة VMCU، يجب أن يطبّق مسؤولو الدمج عدة مكوّنات. يكون مسؤولو الدمج مسؤولين عن الدمج مع طبقة تجريد الأجهزة في المركبة (VHAL) وتنفيذ النواة. ويتحمّل مسؤولو الدمج أيضًا مسؤولية إيقاف مصادر التنشيط وضمان عدم تأجيل عمليات إيقاف التشغيل إلى أجل غير مسمى.

المصطلحات

يتم استخدام المصطلحات التالية في هذا المستند:

معالج التطبيقات (AP)
وهي جزء من المنظومة على رقاقة (SoC).
حزمة دعم لوحة الجهاز (BSP)
طبقة البرامج التي تحتوي على البرامج الثابتة لعملية التشغيل الخاصة بالأجهزة وبرامج تشغيل الأجهزة التي تسمح لنظام التشغيل المضمّن بالعمل في بيئة أجهزة معيّنة (لوحة أم)، مدمجة مع نظام التشغيل المضمّن.
CarPowerManager (CPM)
تتيح واجهة برمجة تطبيقات للتطبيقات للتسجيل في تغييرات حالة الطاقة.
CarPowerManagementService (CPMS)
تنسّق هذه الخدمة عمليات الانتقال بين حالات الطاقة، وتتفاعل مع طبقة VHAL للتحكّم في حالة الطاقة، وتُجري المكالمات النهائية لتعليق التشغيل وإيقافه.
CarPowerPolicyDaemon (CPPD)
تُدير سياسات الطاقة وتكشف عن واجهات AIDL للعمليات الأصلية لتسجيل مستمعي سياسة الطاقة.
إدخال أو إخراج للأغراض العامة (GPIO)
دبوس إشارة رقمي للاستخدام العام
طبقة تجريد الأجهزة (HAL)
طبقة برامج يجب أن تتفاعل معها جميع الوحدات الأخرى ذات المستوى الأعلى للوصول إلى وظائف الأجهزة.
إسبات
يُشار إليه أيضًا باسم التعليق على القرص (S2D/S4). يتم وضع SoC في وضع الطاقة S4 (الإسبات) ويتم كتابة محتوى ذاكرة الوصول العشوائي (RAM) على وسائط غير متطايرة (مثل الفلاش أو القرص) ويتم إيقاف تشغيل النظام بالكامل.
معالج الوسائط (MP)
يُرجى الاطّلاع على المنظومة على رقاقة (SoC).
دائرة متكاملة لإدارة الطاقة (PMIC)
شريحة تُستخدَم لإدارة متطلبات الطاقة لنظام المضيف.
منظومة على رقاقة (SoC)
المعالج الرئيسي الذي يشغّل نظام AAOS، وعادةً ما توفّره شركات مصنّعة، مثل Intel وMediaTek وNvidia وQualcomm وRenesas وTexas Instruments.
تعليق
يُشار إليه أيضًا باسم التعليق في ذاكرة الوصول العشوائي (S2R أو STR). يتم وضع SoC في وضع الطاقة S3 ويتم إيقاف تشغيل وحدة المعالجة المركزية بينما تظل ذاكرة الوصول العشوائي قيد التشغيل.
طبقة تجريد الأجهزة في المركبة (VHAL)
واجهة برمجة تطبيقات Android المستخدَمة للتفاعل مع شبكة المركبة يكون الشريك من الفئة 1 أو المصنّع الأصلي للجهاز مسؤولاً عن كتابة هذه الوحدة. يمكن لشبكة المركبة استخدام أي طبقة أجهزة (مثل CAN وLIN وMOST وEthernet). تستخرج طبقة VHAL شبكة المركبة هذه لتمكين نظام AAOS من التفاعل مع المركبة.
معالج واجهة المركبة (VIP)
يُرجى الاطّلاع على وحدة التحكّم الدقيقة (MCU) في المركبة.
وحدة التحكّم الرئيسية في المركبة (VMCU)
هو وحدة التحكّم الدقيقة التي توفّر الواجهة بين شبكة المركبة وشريحة النظام (SoC). تتواصل شريحة النظام مع وحدة التحكّم الدقيقة في المركبة من خلال إشارات USB وUART وSPI وGPIO.

تصميم النظام

يوضّح هذا القسم كيفية تمثيل نظام التشغيل Android Automotive OS لحالة الطاقة في معالج التطبيقات والوحدات التي تنفّذ نظام إدارة الطاقة. توضّح هذه المادة أيضًا كيفية عمل هذه الوحدات معًا وكيفية حدوث انتقالات الحالة عادةً.

جهاز حالة تشغيل السيارة

يستخدم نظام التشغيل AAOS آلة حالة لتمثيل حالة الطاقة في معالج التطبيقات. يوفّر جهاز الحالة الحالات الموضّحة أدناه:

جهاز حالة تشغيل السيارة

الشكل 1: جهاز حالة الطاقة في السيارة

يتم تمييز الانتقالات الأكثر شيوعًا باللون الأزرق. في ما يلي الحالات والانتقالات الشائعة:

  • التعليق في ذاكرة الوصول العشوائي (RAM): تكون السيارة ونظام SoC غير مفعَّلين، ولا يتم تنفيذ أي رمز برمجي. يتم الحفاظ على الطاقة في ذاكرة الوصول العشوائي (RAM) الخاصة بالشريحة (SoC).
  • انتظِر VHAL. عندما يتفاعل السائق مع المركبة، على سبيل المثال، من خلال فتح باب، تطبّق وحدة VMCU الطاقة على شريحة SoC. يستأنف نظام AAOS العمل من وضع "التعليق في ذاكرة RAM" ويدخل في وضع "الانتظار لطبقة VHAL"، حيث ينتظر التنسيق مع طبقة VHAL.
  • مفعَّلة يطلب VHAL من AAOS الدخول في حالة التشغيل. في هذه الحالة، يكون نظام AAOS قيد التشغيل بالكامل ويتفاعل مع السائق.
  • الاستعداد لإيقاف التطبيق عندما ينتهي السائق من القيادة، تطلب طبقة VHAL من نظام AAOS الدخول في مرحلة "التحضير قبل إيقاف التشغيل" من خلال إرسال SHUTDOWN_PREPARE. في هذه الحالة، يتلقّى مستمعو تغييرات حالة الطاقة القيمة STATE_PRE_SHUTDOWN_PREPARE. هذا بمثابة تحذير مبكر بأنّ عملية الإيقاف ستبدأ.
  • الاستعداد للإيقاف: عندما يكمل جميع المستمعين أو يتم الوصول إلى مهلة "الاستعداد قبل إيقاف التشغيل"، يدخل نظام Android في مرحلة "الاستعداد لإيقاف التشغيل" الأساسية، ويُرسل إشعارًا إلى المستمعين باستخدام STATE_SHUTDOWN_PREPARE. تكون الشاشة والصوت متوقفَين ولا يتفاعل نظام AAOS مع السائق. يظل نظام Android قيد التشغيل ويمكنه إجراء عمليات التنظيف والتحديث، مثل تنفيذ "وضع المرآب".
  • انتظِر حتى تنتهي طبقة VHAL. في هذه المرحلة، يُعلم نظام AAOS طبقة VHAL بأنّه جاهز لإيقاف التشغيل. من المتوقّع أن تضع وحدة VMCU شريحة SoC في وضع "النوم العميق" وأن تفصل الطاقة عن معالج التطبيق. بعد ذلك، يكون نظام AAOS في حالة "التعليق في ذاكرة RAM"، على الرغم من عدم تنفيذ أي رمز برمجي.

وحدات إدارة الطاقة

يتألف نظام إدارة الطاقة من الوحدات التالية:

اسم الوحدة الوصف
CarPowerManager واجهة برمجة تطبيقات Java أو C++‎
CarPowerManagementService تنسّق هذه الخدمة عمليات الانتقال بين حالات الطاقة وتفوّض إدارة سياسات الطاقة إلى CarPowerPolicyDaemon.
CarPowerPolicyDaemon يدير سياسات الطاقة ويتواصل مع عملاء سياسات الطاقة الأصلية.
طبقة تجريد الأجهزة في المركبة واجهة لوحدة التحكّم في المركبة (VMCU)
Kernel تنفيذ التعليق على ذاكرة RAM أو القرص

يتم تنفيذ ميزة السكون العميق/الإسبات (تعليق Android في ذاكرة الوصول العشوائي/القرص) في النواة. تظهر هذه الميزة في مساحة المستخدم كملف خاص في /sys/power/state. يتم تعليق نظام AAOS من خلال كتابة mem أو disk في هذا الملف.

تنسّق خدمة CPMS حالة الطاقة مع الخدمات الأخرى وطبقات HAL. تنفّذ خدمة CPMS جهاز الحالة الموضّح أعلاه وترسل إشعارات إلى كل مراقب عند حدوث انتقال في حالة الطاقة. تستخدم هذه الخدمة أيضًا طبقة VHAL لإرسال الرسائل إلى الجهاز.

يُعدّ CPPD المصدر الموثوق به لسياسات الطاقة. وتدير سياسات الطاقة طوال مراحل نشاط الجهاز، كما تُرسل إشعارات إلى CPMS وVHAL والمستمعين الأصليين الآخرين بشأن التغييرات في سياسات الطاقة. تفوّض خدمة CPMS طلبات تغيير سياسة الطاقة إلى CPPD.

تتواصل خدمة CPMS مع وحدة VMCU من خلال قراءة وكتابة سمات VHAL ذات الصلة بحالة الطاقة، مثل AP_POWER_STATE_REQ وAP_POWER_STATE_REPORT. يمكن للتطبيقات استخدام الواجهة المحدّدة في CPM لمراقبة التغييرات في حالة الطاقة. تتيح هذه الواجهة أيضًا للتطبيقات تسجيل مستمعي سياسة الطاقة. تمت إضافة تعليقات توضيحية إلى واجهة برمجة تطبيقات Java هذه باستخدام @SystemApi و@hide، ما يجعلها متاحة فقط للتطبيقات المميّزة. في ما يلي توضيح للعلاقة بين هذه الوحدات والتطبيقات والخدمات:

المخطّط البياني المرجعي لمكوّنات الطاقة

الشكل 2: مخطّط بياني مرجعي لمكوّنات الطاقة

تسلسل الرسائل

تناول القسم السابق الوحدات التي يتألف منها نظام إدارة الطاقة. يستخدم هذا القسم مثالَي الدخول في وضع السكون العميق والخروج من وضع السكون العميق لتوضيح كيفية تواصل الوحدات والتطبيقات:

الدخول في وضع السكون العميق

يمكن لوحدة VMCU فقط بدء وضع السكون العميق. بعد بدء وضع السكون العميق، ترسل وحدة VMCU إشعارًا إلى خدمة CPMS من خلال طبقة VHAL. تغيّر خدمة CPMS الحالة إلى SHUTDOWN PREPARE وتبثّ عملية الانتقال هذه إلى جميع المراقبين (التطبيقات والخدمات التي تراقب خدمة CPMS) من خلال استدعاء طريقة onStateChanged() باستخدام معرّف حالة جديد يوفّره مدير الطاقة في السيارة (CPM).

يتوسّط CPM بين التطبيقات أو الخدمات وCPMS. يتم استدعاء طريقة onStateChanged() للتطبيقات أو الخدمات بشكل متزامن في طريقة onStateChanged() الخاصة بـ "مدير الشركاء في المنتدى". يجب أن تكمل معظم التطبيقات والخدمات عملية الإعداد قبل العودة من هذه المكالمة. يُسمح للخدمات المميّزة بمواصلة استعداداتها بشكل غير متزامن بعد العودة إلى PRE_SHUTDOWN_PREPARE وSUSPEND_ENTER وPOST_SUSPEND_ENTER. في هذه الحالة، من المفترض أن تطلب الخدمة المميّزة complete()‎ على عنصر CompletablePowerStateChangeFuture المقدَّم عند الانتهاء من إعداده. يُرجى العِلم أنّه لا يُسمح بالإعداد غير المتزامن لـ SHUTDOWN_PREPARE. قبل إرسال DEEP_SLEEP_ENTRY إلى VHAL، يرسل CPMS طلبات تأجيل إيقاف التشغيل بشكل دوري إلى VHAL.

عندما تنتهي جميع عناصر CPM من الاستعدادات لإيقاف التشغيل، ترسل CPMS AP_POWER_STATE_REPORT إلى VHAL، والتي تُرسل بعد ذلك إشعارًا إلى VMCU بأنّ AP جاهز للتعليق. يستدعي CPMS أيضًا طريقة التعليق، والتي تعلّق النواة.

يتم توضيح التسلسل الموضّح أعلاه في ما يلي:

الدخول في وضع السكون العميق

الشكل 3: الدخول في وضع النوم العميق

واجهات البرمجة التي يوفّرها CPM

يصف هذا القسم واجهة برمجة تطبيقات Java التي يوفّرها CPM لتطبيقات النظام وخدماته. تتيح واجهة برمجة التطبيقات هذه لبرنامج النظام تنفيذ ما يلي:

  • مراقبة تغييرات حالة الطاقة في نقطة الوصول
  • تطبيق سياسات الطاقة

اتّبِع الخطوات التالية لطلب واجهات برمجة التطبيقات التي يوفّرها CPM:

  1. للحصول على مثيل CPM، استخدِم Car API.
  2. استدعِ الطريقة المناسبة على العنصر الذي تم إنشاؤه في الخطوة 1.

إنشاء عنصر CarPowerManager

لإنشاء عنصر CPM، استدعِ طريقة getCarManager() لعنصر Car. هذه الطريقة هي واجهة تُستخدم لإنشاء كائنات CPM. حدِّد android.car.Car.POWER_SERVICE كوسيطة لإنشاء عنصر CPM.

Car car = Car.createCar(this);
CarPowerManager powerManager =
  (CarPowerManager) car.getCarManager(android.car.Car.POWER_SERVICE);

‫CarPowerStateListener والتسجيل

يمكن للتطبيقات والخدمات التابعة للنظام تلقّي إشعارات بتغيير حالة الطاقة من خلال تنفيذ CarPowerManager.CarPowerStateListener. تحدّد هذه الواجهة طريقة واحدة onStateChanged()، وهي دالّة رد اتصال يتم استدعاؤها عند تغيير حالة الطاقة في CPMS. يحدّد المثال التالي فئة مجهولة جديدة تنفّذ الواجهة:

private final CarPowerManager.CarPowerStateListener powerListener =
  new CarPowerManager.CarPowerStateListener () {
    @Override
     public void onStateChanged(int state) {
       Log.i(TAG, "onStateChanged() state = " + state);
     }
};

لإرشاد كائن المستمع هذا لمراقبة انتقال حالة الطاقة، قم بإنشاء تنفيذ جديد موضوع وتسجيل المستمع وهذا الموضوع إلى كائن CPM:

executor = new ThreadPerTaskExecutor();
powerManager.setListener(powerListener, executor);

عند تغيير حالة الطاقة، يتم استدعاء الإجراء onStateChanged() الخاص بعنصر المستمع مع قيمة تمثّل حالة الطاقة الجديدة. يتم تحديد الارتباط بين القيمة الفعلية وحالة الطاقة في CarPowerManager ويظهر في الجدول التالي:

الاسم الوصف
STATE_ON أدخِل الحالة "مفعَّل". النظام يعمل بشكل كامل.
STATE_SHUTDOWN_CANCELLED يتم إلغاء إيقاف التشغيل وتعود حالة الطاقة إلى الحالة العادية.
STATE_SHUTDOWN_ENTER من المتوقّع أن يتم إغلاق التطبيقات والاستعداد لإيقاف التشغيل.
STATE_POST_SHUTDOWN_ENTER اكتملت الاستعدادات لإيقاف التشغيل وأصبحت وحدة VMCU جاهزة لإيقاف التشغيل. الدخول في حالة إيقاف التشغيل
STATE_PRE_SHUTDOWN_PREPARE تم طلب عملية إيقاف التشغيل، ولكن لم تبدأ CPMS العملية بعد. لا تزال الشاشة والصوت قيد التشغيل
STATE_SHUTDOWN_PREPARE قد يتم تشغيل "وضع السكون" خلال هذه الفترة.
STATE_SUSPEND_ENTER من المتوقّع أن تنظّف التطبيقات البيانات وتكون جاهزة لوضع "التعليق في ذاكرة RAM".
STATE_POST_SUSPEND_ENTER اكتملت الاستعدادات لتعليق التشغيل في ذاكرة الوصول العشوائي (RAM)، وأصبحت وحدة التحكّم في الأجهزة الافتراضية (VMCU) جاهزة لتعليق التشغيل في ذاكرة الوصول العشوائي (RAM). أدخِل حالة التعليق.
STATE_SUSPEND_EXIT الاستيقاظ من وضع التعليق أو الاستئناف من وضع تعليق تم إلغاؤه
STATE_HIBERNATION_ENTER من المتوقّع أن يتم تنظيف التطبيقات وتجهيزها للإسبات.
STATE_POST_HIBERNATION_ENTER اكتملت الاستعدادات للإسبات وأصبحت وحدة VMCU جاهزة للإسبات. أدخِل حالة الإسبات.
STATE_HIBERNATION_EXIT الاستيقاظ من وضع الإسبات أو الاستئناف من وضع إسبات تم إلغاؤه
STATE_WAIT_FOR_VHAL يبدأ النظام في العمل، ولكنه ينتظر إنشاء اتصال مع VHAL قبل الانتقال إلى حالة التشغيل.

إلغاء تسجيل CarPowerStateListener

لإلغاء تسجيل جميع عناصر المستمعين المسجّلة في CPM، يمكنك استدعاء الإجراء clearListener:

powerManager.clearListener();

تكامل الأنظمة في عملية تنفيذ Android

يتحمّل مسؤولو الدمج مسؤولية العناصر التالية:

  • تنفيذ واجهة النواة لتعليق Android
  • تنفيذ وظائف VHAL من أجل:
    • نقل عملية بدء التعليق أو إيقاف التشغيل من السيارة إلى Android
    • إرسال رسالة الاستعداد لإيقاف التشغيل من Android إلى السيارة
    • بدء إيقاف تشغيل Android أو تعليقه من خلال واجهة Linux kernel
  • تأكَّد من إيقاف جميع مصادر التنشيط عندما يكون الجهاز في وضع التعليق.
  • تأكَّد من إغلاق التطبيقات بسرعة كافية حتى لا يتم تأجيل عملية إيقاف التشغيل إلى أجل غير مسمى.
  • تأكَّد من أنّ حزمة دعم لوحة الجهاز (BSP) تفعّل (أو توقف) مكوّنات الجهاز وفقًا لسياسة الطاقة حتى لا يتم حظر وضع التعليق أو الإسبات

واجهة النواة: ‎/sys/power/state

يضع نظام AAOS الجهاز في وضع التعليق عندما يكتب تطبيق أو خدمة mem للتعليق في ذاكرة الوصول العشوائي (RAM) أو disk للتعليق في القرص في ملف يقع في /sys/power/state. يجب أن يوفّر مدمج النظام وظيفة تراقب هذا الملف وتضع نظام التشغيل Linux في حالة تعليق الطاقة. قد ترسل هذه الدالة إشارة GPIO إلى وحدة VMCU لإعلامها بأنّ الجهاز قد تم إيقافه بالكامل. ويكون مسؤولاً أيضًا عن إزالة أي حالات سباق بين إرسال VHAL للرسالة النهائية إلى VMCU ودخول النظام في وضع التعليق أو إيقاف التشغيل.

مسؤولية طبقة VHAL

توفّر طبقة VHAL واجهة بين شبكة المركبة ونظام Android. طبقة VHAL:

  • تنشر بدء التعليق أو إيقاف التشغيل من السيارة إلى Android.
  • يرسل رسالة جاهزية إيقاف التشغيل من Android إلى السيارة.
  • يبدأ إيقاف تشغيل Android أو تعليقه من خلال واجهة نواة Linux.

عندما تُعلم خدمة CPMS طبقة VHAL بأنّها جاهزة لإيقاف التشغيل، ترسل طبقة VHAL رسالة جاهزية إيقاف التشغيل إلى وحدة VMCU. عادةً ما تنقل الأجهزة الملحقة على الشريحة، مثل UART وSPI وUSB، الرسالة. بعد إرسال الرسالة، يستدعي CPMS أمر النواة لتعليق الجهاز أو إيقاف تشغيله. وقبل إجراء ذلك، قد تبدّل طبقة VHAL أو حزمة BSP حالة منفذ GPIO لإعلام وحدة VMCU بأنّه من الآمن فصل الطاقة عن الجهاز.

يجب أن تتوافق طبقة VHAL مع السمات التالية التي تتحكّم في إدارة الطاقة من خلال طبقة VHAL:

الاسم الوصف
AP_POWER_STATE_REPORT يُبلغ Android عن عمليات انتقال الحالة إلى وحدة VMCU باستخدام هذه السمة، وذلك من خلال قيم تعداد VehicleApPowerStateReport.
AP_POWER_STATE_REQ تستخدم وحدة VMCU هذه السمة لتوجيه Android للانتقال إلى حالات طاقة مختلفة، باستخدام قيم تعداد VehicleApPowerStateReq.

AP_POWER_STATE_REPORT

استخدِم هذه السمة للإبلاغ عن حالة إدارة الطاقة الحالية في Android. تحتوي هذه السمة على عددين صحيحين:

  • ‫int32Values[0]: تعداد VehicleApPowerStateReport للحالة الحالية
  • ‫int32Values[1]: الوقت بالمللي ثانية لتأجيل الإجراء أو تفعيل وضع السكون أو إيقاف التشغيل. يعتمد معنى هذه القيمة على القيمة الأولى.

يمكن أن تأخذ القيمة الأولى إحدى القيم التالية. VehicleApPowerStateReport.aidl يحتوي على أوصاف أكثر تحديدًا، والتي يتم تخزينها في hardware/interfaces/automotive/vehicle/aidl/android/hardware/automotive/vehicle.

اسم القيمة الوصف القيمة الثانية
WAIT_FOR_VHAL يبدأ معالج التطبيقات ويحتاج إلى إنشاء اتصال مع VHAL.
DEEP_SLEEP_ENTRY نقطة الوصول تدخل في وضع السكون العميق. يجب أن تعيد وحدة VMCU تشغيل نقطة الوصول بعد الوقت المحدّد في القيمة الثانية. يجب ضبطه
DEEP_SLEEP_EXIT يخرج معالج التطبيقات من حالة السكون العميق.
HIBERNATION_ENTRY يدخل المعالج AP في حالة الإسبات. يجب أن تعيد وحدة VMCU تشغيل نقطة الوصول بعد الوقت المحدّد في القيمة الثانية. يجب ضبطه
HIBERNATION_EXIT يخرج المعالج من حالة الإسبات.
SHUTDOWN_POSTPONE نظام Android غير جاهز لإيقاف التشغيل. يجب أن تنتظر وحدة VMCU الوقت المحدّد في القيمة الثانية قبل إيقاف نقطة الوصول. قد يطلب Android تأجيل إضافي من خلال إصدار تقارير SHUTDOWN_POSTPONE إضافية. يجب ضبطه
SHUTDOWN_PREPARE يستعد Android لإيقاف التشغيل. يجب ضبطه
SHUTDOWN_START نقطة الوصول جاهزة لإيقاف التشغيل. يجب أن تعيد وحدة VMCU تشغيل نقطة الوصول بعد الوقت المحدّد في القيمة الثانية. (لا يلزم أن تتوافق وحدة VMCU مع ميزة التشغيل المحدّد بوقت). يجب ضبطه
SHUTDOWN_CANCELLED يتوقف Android عن الاستعداد لإيقاف التشغيل وسينتقل إلى WAIT_FOR_VHAL.
تفعيل يعمل Android بشكل طبيعي.

ويمكن ضبط الحالة بشكل مستقل أو استجابةً لطلب من خلال وحدة VMCU.

AP_POWER_STATE_REQ

يتم إرسال هذه السمة من خلال وحدة VMCU لنقل Android إلى حالة طاقة مختلفة، وتحتوي على عددَين صحيحَين:

  • ‫int32Values[0]: قيمة تعداد VehicleApPowerStateReq التي تمثّل الحالة الجديدة التي سيتم الانتقال إليها
  • ‫int32Values[1]: قيمة تعداد VehicleApPowerStateShutdownParam يتم إرسال هذه القيمة فقط لرسالة SHUTDOWN_PREPARE وتنقل إلى Android الخيارات التي تحتوي عليها.

تمثّل قيمة العدد الصحيح الأولى الحالة الجديدة التي سينتقل إليها Android. يتم تحديد الدلالات في VehicleApPowerStateReq.aidl وهي موضّحة أدناه:

اسم القيمة الوصف
تفعيل يجب أن تبدأ نقطة الوصول في العمل بشكل كامل.
SHUTDOWN_PREPARE يجب أن تستعد نقطة الوصول لإيقاف التشغيل. تشير القيمة الثانية إلى ما إذا كان يُسمح للمعالج المساعد بتأجيل إيقاف التشغيل وما إذا كان من المتوقع أن يتم إيقاف تشغيل المعالج المساعد أو دخوله في وضع السكون العميق.
CANCEL_SHUTDOWN يجب أن تتوقف نقطة الوصول عن الاستعداد لإيقاف التشغيل والاستعداد للتشغيل.
انتهى الإعداد سيتم الآن إيقاف نقطة الوصول أو تعليقها.

تم تحديد VehicleApPowerStateShutdownParam في VehicleApPowerStateShutdownParam.aidl. يحتوي هذا التعداد على العناصر التالية:

اسم القيمة الوصف
CAN_SLEEP يمكن أن يدخل AP في وضع السكون العميق بدلاً من إيقاف التشغيل تمامًا. يُسمح بتأجيل الموعد.
CAN_HIBERNATE يمكن أن يدخل نقطة الوصول في وضع الإسبات بدلاً من إيقاف التشغيل تمامًا. يُسمح بتأجيل الموعد.
SHUTDOWN_ONLY من المفترض أن يتم إيقاف نقطة الوصول. يُسمح بتأجيل الموعد. لا يُسمح بوضع السكون العميق.
SLEEP_IMMEDIATELY قد يدخل معالج التطبيقات في وضع السكون العميق، ولكن يجب أن يدخل في وضع السكون أو يتم إيقافه على الفور. لا يُسمح بتأجيلها.
HIBERNATE_IMMEDIATELY قد يدخل معالج التطبيقات في وضع التعليق على القرص، ولكن يجب أن يدخل في وضع الإسبات أو يتم إيقافه على الفور. لا يُسمح بتأجيلها.
SHUTDOWN_IMMEDIATELY يجب إيقاف نقطة الوصول على الفور. لا يُسمح بتأجيل التحديث. لا يُسمح بوضع السكون العميق.

مصادر التنشيط

يجب على مسؤول الدمج إيقاف مصادر التنشيط المناسبة عندما يكون الجهاز في وضع التعليق. وتشمل مصادر التنشيط الشائعة إشارات الاتصال بالشبكة والمودم وشبكة Wi-Fi والبلوتوث. يجب أن يكون مصدر التنشيط الصالح الوحيد هو مقاطعة من وحدة VMCU لتنشيط شريحة SoC. يفترض هذا أن وحدة VMCU يمكنها الاستماع إلى المودم لأحداث التنشيط عن بُعد (مثل تشغيل المحرك عن بُعد). إذا تم نقل هذه الوظيفة إلى معالج التطبيقات، يجب إضافة مصدر تنشيط آخر لتشغيل المودم.

التطبيقات

يجب أن يحرص المصنّعون الأصليون للأجهزة على كتابة التطبيقات بحيث يمكن إيقافها بسرعة وعدم تأجيل العملية إلى أجل غير مسمى.

الملحق

الأدلة في شجرة الرمز المصدر

Content الدليل
الرمز البرمجي المرتبط بـ CarPowerManager packages/services/Car/car-lib/src/android/car/hardware/power
وCarPowerManagementService وما إلى ذلك. packages/services/Car/service/src/com/android/car/power
الخدمات التي تتعامل مع طبقة VHAL، مثل VehicleHal وHAlClient packages/services/Car/service/src/com/android/car/hal
واجهة VHAL وتعريفات السمات hardware/interfaces/automotive/vehicle/aidl/android/hardware/automotive/vehicle/
نموذج تطبيق لتقديم فكرة عن CarPowerManager packages/services/Car/tests/EmbeddedKitchenSinkApp/src/com/google/android/car/kitchensink

مخطّط الفئات

يعرض مخطّط الفئات هذا فئات Java وواجهاتها في نظام إدارة الطاقة:

مخطّط بياني لفئة الطاقة

الشكل 4. مخطّط بياني لفئة الطاقة

علاقة العناصر

يوضّح الشكل 5 العناصر التي تحتوي على مراجع لعناصر أخرى. وتعني الحافة أنّ الكائن المصدر يحتوي على مرجع للكائن المستهدف. على سبيل المثال، يحتوي VehicleHAL على مرجع إلى عنصر PropertyHalService.

مخطّط مرجعي للعناصر

الشكل 5: مخطّط بياني مرجعي للعناصر