पावर से जुड़ी नीति

यह पक्का करने के लिए कि हार्डवेयर और सॉफ़्टवेयर कॉम्पोनेंट (जैसे, डिसप्ले, ऑडियो, और आवाज़ से इंटरैक्ट करने की सुविधा) को ज़रूरत के हिसाब से चालू और बंद किया जा सके, AAOS एक पावर पॉलिसी उपलब्ध कराता है. इसमें हार्डवेयर और सॉफ़्टवेयर कॉम्पोनेंट के लिए, चालू और बंद होने की संभावित स्थितियों का एक सेट होता है. वीएचएएल या सिस्टम के खास अधिकार वाली वेंडर सेवाएं, Android की पावर स्टेट में बदलाव होने पर या उन शर्तों के पूरा होने पर नई पावर पॉलिसी लागू कर सकती हैं जिनके पूरा होने का वे इंतज़ार कर रही हैं.

पावर पॉलिसी को इन स्थितियों में लागू किया जा सकता है: वीएचएएल के इंतज़ार में, चालू है, और बंद होने से पहले तैयारी करें. हालांकि, कभी-कभी कुछ पाबंदियां लागू हो सकती हैं. 'वीएचएएल के लिए इंतज़ार करें' और 'चालू है' के उलट, पावर पॉलिसी ग्रुप में 'शटडाउन से पहले तैयारी करें' के लिए, डिफ़ॉल्ट पावर पॉलिसी कॉन्फ़िगर नहीं की जा सकती. शटडाउन की तैयारी के मुख्य फ़ेज़ में, गैराज मोड चालू रहता है. इसलिए, पावर स्टेट में बदलाव होने पर इसमें कोई रुकावट नहीं आनी चाहिए. हालांकि, सामान्य पावर नीति लागू नहीं की जा सकती. हालांकि, एक खास पावर नीति लागू की जाती है. यह सिस्टम पावर नीति है, जिसका नाम उपयोगकर्ता के इंटरैक्शन के बिना है. इसे शटडाउन की तैयारी के मुख्य चरण में लागू किया जाता है.

AAOS की पावर स्टेट

AAOS डिवाइसों में पावर की स्थिति का यह डायग्राम दिखता है:

AAOS की पावर स्टेट का डायग्राम

पहली इमेज. AAOS की पावर स्टेट का डायग्राम.

हर पावर स्टेट के बारे में यहां बताया गया है:

वैल्यू ब्यौरा
बंद है
  • ऐप्लिकेशन प्रोसेसर (एपी), मेमोरी, और पेरिफ़ेरल को कोई पावर नहीं दी जाती है.
वीएचएएल के लिए इंतज़ार करें
  • जब ड्राइवर वाहन से इंटरैक्ट करता है (उदाहरण के लिए, दरवाज़ा खोलकर), तब वीएमसीयू, एपी, मेमोरी, और पेरिफ़ेरल को पावर देता है.
  • AAOS, तीन में से किसी एक स्थिति से ट्रांज़िशन करता है: बंद है, RAM में निलंबित है (एसटीआर, वीएचएएल के पूरा होने का इंतज़ार करें). इसके बाद, यह वीएचएएल के पूरा होने का इंतज़ार करें स्थिति में चला जाता है. यहां यह वीएचएएल के साथ समन्वय का इंतज़ार करता है.
चालू है
  • VHAL, AAOS को चालू होने का निर्देश देता है. इस स्थिति में, AAOS पूरी तरह से काम करता है और ड्राइवर के साथ इंटरैक्ट करता है.
  • डिसप्ले को पावर से जुड़ी नीति कंट्रोल करती है. इसे Android डिसप्ले के चालू/बंद होने से जुड़े कॉल कंट्रोल नहीं करते.
शटडाउन की तैयारी
  • जब ड्राइवर गाड़ी चलाना बंद कर देता है, तब VHAL, AAOS को Shutdown Prepare मोड में जाने का निर्देश देता है. यह मोड, Pre Shutdown Prepare फ़ेज़ से शुरू होता है. इसके बाद, यह Core Shutdown Prepare फ़ेज़ में चला जाता है. कोर फ़ेज़ में, डिसप्ले और ऑडियो बंद रहता है. साथ ही, AAOS ड्राइवर के साथ इंटरैक्ट नहीं करता है. Android सिस्टम अब भी काम कर रहा है और ऐप्लिकेशन के साथ-साथ Android सिस्टम को भी अपडेट कर सकता है. सभी अपडेट पूरे होने के बाद, Android सिस्टम Wait for VHAL Finish में चला जाता है.
वीएचएएल के पूरा होने का इंतज़ार करें
  • AAOS, VHAL को सूचना देता है कि इसे बंद किया जा सकता है. वाहन के माइक्रो कंट्रोलर यूनिट (वीएमसीयू) को सिस्टम-ऑन-चिप (एसओसी) को डीप स्लीप मोड में रखना चाहिए और एपी से पावर हटाना चाहिए. इसके बाद, AAOS, एसटीआर मोड में होता है. हालांकि, इस दौरान कोई कोड नहीं चलता है.
  • अगर VHAL पूरा नहीं होता है और ड्राइवर वापस आ जाता है, तो मुख्य यूनिट (एचयू) को सीधे तौर पर VHAL के लिए इंतज़ार करने की स्थिति में चला जाना चाहिए.
सस्पेंड-टू-रैम (एसटीआर)
  • वाहन और एपी बंद हैं, कोई कोड नहीं चलाया जा रहा है, और एपी रैम को पावर मिलती रहती है.
डिस्क पर सेव करके बंद करना (एसटीडी)
  • वाहन और एपी बंद हैं. कोई कोड नहीं चल रहा है. साथ ही, प्रोसेसिंग यूनिट और एपी रैम को पावर नहीं मिल रही है.

पावर पॉलिसी क्या होती है?

डिवाइस बनाने वाली कंपनियां, /vendor/etc/automotive/power_policy.xml में पावर से जुड़ी नीतियां तय करती हैं. ये नीतियां:

  • इससे पावर पॉलिसी तय होती है.
  • इससे पावर पॉलिसी ग्रुप तय होते हैं. इनमें डिफ़ॉल्ट पावर पॉलिसी शामिल होती है. साथ ही, पावर स्टेट में बदलाव होने पर ये अपने-आप लागू हो जाती हैं.
  • यह सिस्टम पावर नीति को बदलता है.

पावर से जुड़ी नीति

पावर नीति में, हार्डवेयर और सॉफ़्टवेयर कॉम्पोनेंट की पावर की अनुमानित स्थितियां शामिल होती हैं. AAOS, पावर पॉलिसी में इन कॉम्पोनेंट के साथ काम करता है:

AUDIO
MEDIA
DISPLAY
BLUETOOTH 		WIFI
CELLULAR
ETHERNET
PROJECTION 		एनएफ़सी
INPUT
VOICE_INTERACTION
VISUAL_INTERACTION 		TRUSTED_DEVICE_DETECTION
LOCATION
MICROPHONE
CPU

वेंडर, पावर पॉलिसी के साथ इस्तेमाल करने के लिए, पावर के अपने कस्टम कॉम्पोनेंट भी तय कर सकते हैं. पावर से जुड़ी नीतियों की तरह ही, कस्टम पावर कॉम्पोनेंट को भी इसी एक्सएमएल फ़ाइल में तय करें. उदाहरण के लिए: 

<customComponents>
  CUSTOM_COMPONENT_1000
  CUSTOM_COMPONENT_SPECIAL_SENSOR
  CUSTOM_COMPONENT_AUX_INPUT
</customComponents>

पावर से जुड़ी नीति का ग्रुप

पावर पॉलिसी ग्रुप, डिफ़ॉल्ट पावर पॉलिसी तय करता है. यह पावर स्टेट ट्रांज़िशन के दौरान अपने-आप लागू होती है. वेंडर, Wait for VHAL और On के लिए, पावर से जुड़ी डिफ़ॉल्ट नीति तय कर सकते हैं.

सिस्टम की पावर से जुड़ी नीतियां

AAOS में सिस्टम पावर की दो नीतियां काम करती हैं. ये नीतियां उपयोगकर्ता के इंटरैक्शन के बिना और सस्पेंड करने की तैयारी हैं. डिवाइस के साइलेंट मोड, गैराज मोड, Suspend-to-RAM या Suspend-to-disk में जाने पर, सिस्टम पावर नीति लागू होती है.

यहां दी गई टेबल में, सिस्टम की पावर पॉलिसी में हर कॉम्पोनेंट के व्यवहार के बारे में बताया गया है. लागू करने वाले लोग, उपयोगकर्ता के इंटरैक्शन के बिना सिस्टम पावर नीति में ब्लूटूथ, एनएफ़सी, और भरोसेमंद डिवाइस का पता लगाने की सुविधा को बदल सकते हैं. बदलाव, /vendor/etc/automotive/power_policy.xml में लागू किए जाते हैं.

उपयोगकर्ता का कोई इंटरैक्शन नहीं

उपयोगकर्ता के इंटरैक्शन के बिना सिस्टम पावर नीति के काम करने के तरीके के बारे में इस टेबल में बताया गया है:

घटक पावर स्टेट कॉन्फ़िगर किया जा सकता है
ऑडियो बंद है नहीं
मीडिया बंद है नहीं
डिसप्ले बंद है नहीं
ब्लूटूथ बंद है हां
वाई-फ़ाई चालू है नहीं
सेल्यूलर चालू है नहीं
ईथरनेट चालू है नहीं
अनुमान बंद है नहीं
एनएफ़सी बंद है हां
इनपुट बंद है नहीं
Assistant बंद है नहीं
उपयोगकर्ता इंटरैक्शन बंद है नहीं
उपयोगकर्ता के लॉगिन के लिए, भरोसेमंद डिवाइस का पता लगाना चालू है हां
जगह बंद है नहीं
माइक्रोफ़ोन बंद है नहीं
सीपीयू चालू है नहीं

निलंबित करने की तैयारी

suspend prep सिस्टम पावर नीति के काम करने के तरीके के बारे में इस टेबल में बताया गया है:

कॉम्पोनेंट पावर स्टेट OEM के हिसाब से कॉन्फ़िगर किया जा सकता है
ऑडियो बंद है नहीं
मीडिया लागू नहीं नहीं
डिसप्ले लागू नहीं नहीं
ब्लूटूथ बंद है नहीं
वाई-फ़ाई बंद है नहीं
सेल्यूलर लागू नहीं नहीं
ईथरनेट लागू नहीं नहीं
अनुमान लागू नहीं नहीं
एनएफ़सी लागू नहीं नहीं
इनपुट लागू नहीं नहीं
Assistant लागू नहीं नहीं
उपयोगकर्ता इंटरैक्शन लागू नहीं नहीं
उपयोगकर्ता के लॉगिन के लिए, भरोसेमंद डिवाइस का पता लगाना लागू नहीं नहीं
जगह बंद है नहीं
माइक्रोफ़ोन बंद है नहीं
सीपीयू बंद है नहीं

वीएचएएल के साथ इंटरैक्शन

सिस्टम लेयर में चलने वाला कार पावर पॉलिसी डेमॉन, वीएचएएल से मिले अनुरोधों को सुनने के लिए दो प्रॉपर्टी की सदस्यता लेता है:

  • POWER_POLICY_REQ वीएचएएल, इस प्रॉपर्टी में पावर पॉलिसी आईडी लिखता है.
  • POWER_POLICY_GROUP_REQ VHAL, इस प्रॉपर्टी में पावर पॉलिसी ग्रुप आईडी लिखता है.

सिस्टम में मौजूद मौजूदा पावर नीति को VHAL के अलावा अन्य मॉड्यूल भी बदल सकते हैं. ऐसे में, कार पावर पॉलिसी डेमॉन, CURRENT_POWER_POLICY प्रॉपर्टी को अपडेट करता है, ताकि वीएचएएल को बदलाव के बारे में सूचना मिल सके.

नेटिव प्रोसेस के साथ इंटरैक्शन

CarPowerManagementService (CPMS), पावर मैनेजमेंट से जुड़ी नीति को लागू करने की ज़िम्मेदारी, कार की पावर मैनेजमेंट से जुड़ी नीति के डेमॉन को सौंपता है. सिस्टम में बिजली से जुड़ी नीतियों के लिए, डेमॉन ही एकमात्र भरोसेमंद सोर्स है. कार पावर पॉलिसी डेमॉन, पावर पॉलिसी की स्थिति को मैनेज करता है. साथ ही, CPMS, VHAL, और अन्य नेटिव क्लाइंट को बदलावों के बारे में सूचना देता है.

कार की पावर से जुड़ी नीति का डेमॉन, एचएएल और अन्य नेटिव प्रोसेस के इस्तेमाल के लिए एआईडीएल इंटरफ़ेस एक्सपोर्ट करता है. पावर से जुड़ी नई नीति में बदलाव होने पर, उन्हें सूचना दी जा सकती है. दूसरे शब्दों में कहें, तो जब हर डिवाइस को अपनी पावर स्टेट बदलनी हो.

ICarPowerPolicyServer.aidl

  package android.frameworks.automotive.powerpolicy;

  import android.frameworks.automotive.powerpolicy.CarPowerPolicy;
  import android.frameworks.automotive.powerpolicy.CarPowerPolicyFilter;
  import android.frameworks.automotive.powerpolicy.ICarPowerPolicyChangeCallback;
  import android.frameworks.automotive.powerpolicy.PowerComponent;

  /**
   * ICarPowerPolicyServer is an interface implemented by the power policy daemon.
   * VHAL changes the power policy and the power policy daemon notifies the change to
   * registered subscribers. When subscribing to policy changes, a filter can be specified so
   * that the registered callbacks can listen only to a specific power component's change.
   */

  @VintfStability
  interface ICarPowerPolicyServer {
    /**
     * Gets the current power policy.
     * @throws IllegalStateException if the current policy is not set.
     */
    CarPowerPolicy getCurrentPowerPolicy();

    /**
     * Gets whether the power component is turned on or off.
     *
     * @param componentId Power component ID defined in PowerComponent.aidl to check power
     * state.
     * @return True if the component's power state is on.
     * @throws IllegalArgumentException if the componentId is invalid.
     */
    boolean getPowerComponentState(in PowerComponent componentId);

    /**
     * Subscribes to power policy change.
     * Notification is sent to the registered callback when the power policy changes and the
     * power state of the components which the callback is interested in changes.
     *
     * @param callback Callback that is invoked when the power policy changes.
     * @param filter The list of components which the callback is interested in.
     * @throws IllegalArgumentException if the callback is already registered.
     * @throws IllegalStateException if the callback is dead.
     */
    void registerPowerPolicyChangeCallback(in ICarPowerPolicyChangeCallback callback,
        in CarPowerPolicyFilter filter);

    /**
     * Unsubscribes from power policy change.
     *
     * @param callback Callback that doesn't want to receive power policy change.
     * @throws IllegalArgumentException if the callback is not registered.
     */
    void unregisterPowerPolicyChangeCallback(in ICarPowerPolicyChangeCallback callback);

    /**
     * Applies the power policy.
     *
     * 
{@code policyId} should be one of power policy IDs defined in
     * {@code /vendor/etc/automotive/power_policy.xml} or predefined system power policies.
     *
     * @param policyId ID of power policy.
     * @throws IllegalArgumentException if {@code policyId} is invalid.
     */
    void applyPowerPolicy(in @utf8InCpp String policyId);

    /**
     * Sets the current power policy group.
     *
     * 
{@code policyGroupId} should be one of power policy group IDs defined in
     * {@code /vendor/etc/automotive/power_policy.xml}.
     *
     * @param policyGroupId ID of power policy group.
     * @throws IllegalArgumentException if {@code policyGroupId} is invalid.
     */
    void setPowerPolicyGroup(in @utf8InCpp String policyGroupId);
  }

ICarPowerPolicyChangeCallback.aidl

  package android.frameworks.automotive.powerpolicy;

  import android.frameworks.automotive.powerpolicy.CarPowerPolicy;

  /**
   * ICarPowerPolicyChangeCallback is notified when a power policy changes.
   */

  @VintfStability
  oneway interface ICarPowerPolicyChangeCallback {
    /**
     * Called when a power policy is fully changed.
     *
     * @param policy The current policy.
     */
    void onPolicyChanged(in CarPowerPolicy policy);
  }

Java मॉड्यूल के साथ इंटरैक्शन

CarPowerManager पावर मैनेजमेंट की नीति को चालू करने के तरीके बताता है:

  • मौजूदा पावर पॉलिसी पाना
  • पावर की नई नीति लागू करना
  • पावर से जुड़ी नई नीति का ग्रुप सेट करना

सिर्फ़ सिस्टम के खास अधिकार वाले मॉड्यूल, इन तरीकों का इस्तेमाल कर सकते हैं. जिन मॉड्यूल को पावर पॉलिसी लागू होने पर सूचना चाहिए वे पावर पॉलिसी में बदलाव की सूचना पाने के लिए, लिसनर को रजिस्टर कर सकते हैं. इसके लिए, उन्हें CarPowerManager का इस्तेमाल करना होगा