अन्य सूचनाएं

इस मॉड्यूल में, अलग-अलग तरह के व्यवहार के लिए प्लैटफ़ॉर्म के ऐब्स्ट्रैक्शन शामिल हैं.

खास जानकारी

गिनती

otPlatMcuPowerState{
  OT_PLAT_MCU_POWER_STATE_ON = 0,
  OT_PLAT_MCU_POWER_STATE_LOW_POWER = 1,
  OT_PLAT_MCU_POWER_STATE_OFF = 2
}
enum
माइक्रो-कंट्रोलर की पावर स्टेट की गिनती.
otPlatResetReason enum
रीसेट करने की संभावित वजहों के कोड की गिनती.

फ़ंक्शन

otPlatAssertFail(const char *aFilename, int aLineNumber)
void
दावा करने के लिए प्लैटफ़ॉर्म के हिसाब से लागू करने की सुविधा देता है.
otPlatGetMcuPowerState(otInstance *aInstance)
MCU की मौजूदा मनचाही पावर की स्थिति का पता लगाता है.
otPlatGetResetReason(otInstance *aInstance)
यह पिछले प्लैटफ़ॉर्म को रीसेट करने की वजह दिखाता है.
otPlatReset(otInstance *aInstance)
void
अगर यह सुविधा काम करती है, तो प्लैटफ़ॉर्म पर सॉफ़्टवेयर रीसेट करता है.
otPlatResetToBootloader(otInstance *aInstance)
बूटलोडर मोड चालू होने पर, इसे लॉन्च करने के लिए प्लैटफ़ॉर्म पर हार्डवेयर रीसेट किया जाता है.
otPlatSetMcuPowerState(otInstance *aInstance, otPlatMcuPowerState aState)
MCU की पावर की मनचाही स्थिति सेट करता है.
otPlatWakeHost(void)
void
होस्ट के MCU को चालू करने के लिए, प्लैटफ़ॉर्म के हिसाब से कार्रवाई करता है.

गिनती

otPlatMcuPowerState

 otPlatMcuPowerState

माइक्रो-कंट्रोलर की पावर स्टेट की गिनती.

OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL के चालू होने पर, इन वैल्यू का इस्तेमाल एनसीपी कॉन्फ़िगरेशन के लिए किया जाता है.

पावर की स्थिति, एनसीपी के माइक्रो-कंट्रोलर (एमसीयू) की पावर की मनचाही स्थिति के बारे में बताती है.ऐसा तब होता है, जब प्लैटफ़ॉर्म का ऑपरेटिंग सिस्टम कुछ समय से इस्तेमाल में न हो. इसका मतलब है कि सभी चालू टास्क/इवेंट प्रोसेस किए जाते हैं और MCU, ऊर्जा की बचत करने वाली पावर की स्थिति में बदलाव कर सकता है.

पावर की स्थिति से मुख्य तौर पर यह तय होता है कि होस्ट को एनसीपी के साथ कैसे इंटरैक्ट करना चाहिए. साथ ही, यह भी तय होता है कि एनसीपी से संपर्क करने से पहले, होस्ट को किसी बाहरी ट्रिगर ("पोक") की ज़रूरत है या नहीं.

रीसेट करने के बाद, MCU की पावर की स्थिति OT_PLAT_POWER_STATE_ON होनी चाहिए.

प्रॉपर्टी
OT_PLAT_MCU_POWER_STATE_LOW_POWER

एनसीपी का एमसीयू, कम पावर (ऊर्जा की बचत करने वाली) स्थिति में जा सकता है.

जब एनसीपी की पावर की स्थिति को LOW_POWER पर सेट किया जाता है, तो एनसीपी से संपर्क करने से पहले, होस्ट उसे एनसीपी (उदाहरण के लिए, रुकावट जैसा कोई बाहरी ट्रिगर) को "पोक" कर देगा. एनसीपी को मैसेज भेजें. "पोक" करने का तरीका, प्लैटफ़ॉर्म कोड से तय होता है. यह होस्ट के लिए बने एनसीपी के इंटरफ़ेस पर आधारित होता है.

पावर की स्थिति LOW_POWER पर सेट होने के बावजूद, एनसीपी किसी भी समय होस्ट को मैसेज भेज सकता है. ध्यान दें कि एनसीपी से मैसेज मिलने का मतलब यह नहीं है कि एनसीपी की पावर की स्थिति बदल गई है. इसका मतलब है कि जब तक पावर की स्थिति को साफ़ तौर पर नहीं बदला जाता, तब तक एनसीपी से बात करने के लिए, होस्ट “पोक” करता रहेगा (otPlatSetMcuPowerState() को कॉल करके स्टेटस को ON में बदला जा सकता है).

OT_PLAT_MCU_POWER_STATE_OFF

एनसीपी की सुविधा पूरी तरह से बंद है.

एनसीपी को SPINEL_MCU_POWER_STATE_ON पर वापस लाने के लिए, एनसीपी को रीसेट पिन के ज़रिए रीसेट करना ज़रूरी है. रीसेट करने के बाद, रैम में कोई बदलाव नहीं होता.

OT_PLAT_MCU_POWER_STATE_ON

एनसीपी का एमसीयू हर समय चालू और चालू रहता है.

जब एनसीपी ने पावर की स्थिति ON पर सेट की हो, तो होस्ट किसी भी "पोक" या बाहरी ट्रिगर के बिना, एनसीपी को मैसेज भेज सकता है.

otPlatResetReason

 otPlatResetReason

रीसेट करने की संभावित वजहों के कोड की गिनती.

ये उसी क्रम में हैं जिसमें Spinel रीसेट करने की वजह के कोड मौजूद हैं.

फ़ंक्शन

otPlatAssertFail

void otPlatAssertFail(
  const char *aFilename,
  int aLineNumber
)

दावा करने के लिए प्लैटफ़ॉर्म के हिसाब से लागू करने की सुविधा देता है.

ब्यौरा
पैरामीटर
[in] aFilename
उस फ़ाइल का नाम जहां दावा किया गया है.
[in] aLineNumber
फ़ाइल में वह लाइन नंबर जहां दावा किया गया है.

otPlatGetMcuPowerState

otPlatMcuPowerState otPlatGetMcuPowerState(
  otInstance *aInstance
)

MCU की मौजूदा मनचाही पावर की स्थिति का पता लगाता है.

यह सिर्फ़ तब लागू होता है और NCP कॉन्फ़िगरेशन के लिए इस्तेमाल किया जाता है, जब OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL चालू होता है.

रीसेट करने के बाद, पावर की स्थिति को OT_PLAT_POWER_STATE_ON दिखाना ज़रूरी है. कार्रवाई के दौरान, पावर की स्थिति सिर्फ़ otPlatSetMcuPowerState() पर की गई सफल कॉल के ज़रिए ही बदली जानी चाहिए.

ब्यौरा
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
लौटाए गए सामान
पावर की मौजूदा स्थिति.

otPlatGetResetReason

otPlatResetReason otPlatGetResetReason(
  otInstance *aInstance
)

यह पिछले प्लैटफ़ॉर्म को रीसेट करने की वजह दिखाता है.

ब्यौरा
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस स्ट्रक्चर.

otPlatReset

void otPlatReset(
  otInstance *aInstance
)

अगर यह सुविधा काम करती है, तो प्लैटफ़ॉर्म पर सॉफ़्टवेयर रीसेट करता है.

ब्यौरा
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस स्ट्रक्चर.

otPlatResetToBootloader

otError otPlatResetToBootloader(
  otInstance *aInstance
)

बूटलोडर मोड चालू होने पर, इसे लॉन्च करने के लिए प्लैटफ़ॉर्म पर हार्डवेयर रीसेट किया जाता है.

इसका इस्तेमाल तब किया जाता है, जब OPENTHREAD_CONFIG_PLATFORM_BOOTLOADER_MODE_ENABLE चालू हो.

ब्यौरा
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस स्ट्रक्चर.
रिटर्न वैल्यू
OT_ERROR_NONE
बूटलोडर पर रीसेट किया गया.
OT_ERROR_BUSY
कार्रवाई नहीं की जा सकी, क्योंकि कोई दूसरी कार्रवाई जारी है.
OT_ERROR_NOT_CAPABLE
बूटलोडर पर रीसेट नहीं किया जा सकता.

otPlatSetMcuPowerState

otError otPlatSetMcuPowerState(
  otInstance *aInstance,
  otPlatMcuPowerState aState
)

MCU की पावर की मनचाही स्थिति सेट करता है.

यह सिर्फ़ तब लागू होता है और NCP कॉन्फ़िगरेशन के लिए इस्तेमाल किया जाता है, जब OPENTHREAD_CONFIG_NCP_ENABLE_MCU_POWER_STATE_CONTROL चालू होता है.

ब्यौरा
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
[in] aState
एमसीयू पावर की नई स्थिति.
रिटर्न वैल्यू
OT_ERROR_NONE
पावर सप्लाई की स्थिति अपडेट कर दी गई है.
OT_ERROR_FAILED
इस प्लैटफ़ॉर्म पर, MCU की पावर की स्थिति काम नहीं करती.

otPlatWakeHost

void otPlatWakeHost(
  void
)

होस्ट के MCU को चालू करने के लिए, प्लैटफ़ॉर्म के हिसाब से कार्रवाई करता है.

इसका इस्तेमाल सिर्फ़ एनसीपी कॉन्फ़िगरेशन के लिए किया जाता है.

संसाधन

OpenThread API के रेफ़रंस के विषय, सोर्स कोड से मिलते हैं. यह सोर्स GitHub पर उपलब्ध है. ज़्यादा जानकारी या हमारे दस्तावेज़ में योगदान देने के लिए, संसाधन देखें.