संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

nl:: बुनाई::डिवाइस की लेयर::सॉफ़्टवेयर अपडेट मैनेजर

खास जानकारी

इनहेरिटेंस

डायरेक्ट जाने-पहचाने सब-क्लास:
nl::Weave::DeviceLayer::SoftwareUpdateManagerImpl
nl::Weave::DeviceLayer::SoftwareUpdateManagerImpl
nl::Weave::DeviceLayer::SoftwareUpdateManagerImpl

सार्वजनिक प्रकार

ActionType{
  kAction_Ignore,
  kAction_DownloadNow,
  kAction_DownloadLater,
  kAction_ApplicationManaged
}
enum
जब कोई सॉफ़्टवेयर अपडेट उपलब्ध होता है, तो सॉफ़्टवेयर सॉफ़्टवेयर अपडेट उपलब्ध एपीआई इवेंट कॉलबैक के हिस्से के रूप में, इनमें से एक कार्रवाई चुन सकता है.
EventCallback)(void *apAppState, EventType aEvent, const InEventParam &aInParam, OutEventParam &aOutParam) टाइपडेफ़
void(*
EventType{
  kEvent_PrepareQuery,
  kEvent_PrepareQuery_Metadata,
  kEvent_QueryPrepareFailed,
  kEvent_QuerySent,
  kEvent_SoftwareUpdateAvailable,
  kEvent_FetchPartialImageInfo,
  kEvent_PrepareImageStorage,
  kEvent_StartImageDownload,
  kEvent_StoreImageBlock,
  kEvent_ComputeImageIntegrity,
  kEvent_ResetPartialImageInfo,
  kEvent_ReadyToInstall,
  kEvent_StartInstallImage,
  kEvent_Finished,
  kEvent_DefaultCheck = 100
}
enum
SoftwareUpdateManager ऑब्जेक्ट से जनरेट हुए एपीआई इवेंट.
RetryPolicyCallback)(void *aAppState, RetryParam &aRetryParam, uint32_t &aOutIntervalMsec) टाइपडेफ़
void(*
State enum

दोस्तों की क्लास

Internal::GenericPlatformManagerImpl
friend class

सार्वजनिक फ़ंक्शन

Abort(void)
CheckNow(void)
GetState(void)
State
ImageInstallComplete(WEAVE_ERROR aError)
IsInProgress(void)
bool
PrepareImageStorageComplete(WEAVE_ERROR aError)
SetEventCallback(void *const aAppState, const EventCallback aEventCallback)
SetQueryIntervalWindow(uint32_t aMinWaitTimeMs, uint32_t aMaxWaitTimeMs)
SetRetryPolicyCallback(const RetryPolicyCallback aRetryPolicyCallback)
void

सार्वजनिक स्थिर फ़ंक्शन

DefaultEventHandler(void *apAppState, EventType aEvent, const InEventParam & aInParam, OutEventParam & aOutParam)
void

सुरक्षित किए गए फ़ंक्शन

SoftwareUpdateManager()=default
SoftwareUpdateManager(const SoftwareUpdateManager &)=delete
SoftwareUpdateManager(const SoftwareUpdateManager &&)=delete
operator=(const SoftwareUpdateManager &)=delete
~SoftwareUpdateManager()=default

स्ट्रक्चर

nl:: बुना::DeviceLayer::SoftwareUpdateManager::फिर से कोशिश करनाParam

यूनियन

nl:: बुनाई:: डिवाइस लेयर::SoftwareUpdateManager::InEventParam
nl:: बुनाई::डिवाइस लेयर::SoftwareUpdateManager::OutEventParam

सार्वजनिक प्रकार

कार्रवाई प्रकार

 ActionType

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

डिफ़ॉल्ट कार्रवाई kAction_Now पर सेट हो जाएगी.

प्रॉपर्टी
kAction_ApplicationManaged

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

सॉफ़्टवेयर अपडेट मैनेजर स्टेट मशीन, ApplicationManaged स्थिति में चली जाएगी. शेड्यूल किए गए सॉफ़्टवेयर अपडेट की जांच (अगर चालू है, तो) तब तक निलंबित रहेगी, जब तक कि ऐप्लिकेशन को रद्द नहीं किया जाता या ImageInstallcomplete एपीआई में कॉल नहीं किया जाता.

kAction_DownloadLater

डाउनलोड शुरू होने पर रोकें.

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

kAction_DownloadNow

डाउनलोड तुरंत शुरू करें.

एक kEvent_FetchPartialImageInfo API इवेंट कॉलबैक के तुरंत बाद जनरेट किया जाएगा.

kAction_Ignore

डाउनलोड को पूरी तरह से अनदेखा करें.

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

इवेंट कॉलबैक

void(* EventCallback)(void *apAppState, EventType aEvent, const InEventParam &aInParam, OutEventParam &aOutParam)

इवेंट टाइप

 EventType

SoftwareUpdateManager ऑब्जेक्ट से जनरेट हुए एपीआई इवेंट.

प्रॉपर्टी
kEvent_ComputeImageIntegrity

इमेज के लिए पूरी सुरक्षा देने की सुविधा की जांच करें.

ऐप्लिकेशन का अनुरोध, डाउनलोड की गई इमेज पर, इंटेग्रिटी जांच मान की गिनती करने का है. डाउनलोड पूरा होने के बाद जनरेट होता है.

kEvent_DefaultCheck

इवेंट मैनेज करने के डिफ़ॉल्ट तरीके को देखें.

ऐप्लिकेशन में इवेंट के सही डिफ़ॉल्ट हैंडलिंग की पुष्टि करने के लिए इस्तेमाल किया जाता है.

ऐप्लिकेशन को यह इवेंट हैंडल नहीं करना चाहिए.

kEvent_FetchPartialImageInfo

कुछ हद तक डाउनलोड की गई इमेज के लिए, स्थिति की जानकारी फ़ेच करना.

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

ऐप्लिकेशन के आंशिक इमेज की लंबाई को PartialImageLenInBytes आउटपुट पैरामीटर में दिखाना ज़रूरी है. यह बताने के लिए कि कोई भी आंशिक इमेज मौजूद नहीं है या आंशिक इमेज का यूआरआई मेल नहीं खाता है, ऐप्लिकेशन, PartialImageLenInBytes की वैल्यू को 0 पर सेट कर सकता है.

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

kEvent_Finished

सॉफ़्टवेयर अपडेट करने की प्रोसेस पूरी हुई.

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

kEvent_PrepareImageStorage

नई इमेज सेव करने की तैयारी करें.

नई फ़र्मवेयर इमेज डाउनलोड करने के लिए लोकल स्टोरेज तैयार करने के लिए ज़रूरी कदम उठाने के लिए, ऐप्लिकेशन से अनुरोध करता है. ऐप्लिकेशन, उदाहरण के लिए फ़्लैश पेजों को मिटाने के लिए इसका इस्तेमाल कर सकता है.

ReadyImageStorage इवेंट तभी जनरेट होता है, जब नई फ़र्मवेयर इमेज डाउनलोड हो रही हो. जब पहले से डाउनलोड किया गया कोई डाउनलोड फिर से शुरू होता है, तो ReadyImageStorage जनरेट नहीं होता है.

ऐप्लिकेशन को PrepareImageStorageComplete() तरीके को कॉल करके, तैयारी की प्रक्रिया पूरी होने का सिग्नल भेजना है. यह इवेंट कॉलबैक में या बाद में किया जा सकता है. अगर Weave टास्क को छोड़कर किसी काम से कॉल किया जाता है, तो कॉलर को Weave स्टैक लॉक पकड़ना होगा.

ऐप्लिकेशन डिफ़ॉल्ट इवेंट हैंडलर को पास करके, DeployImageStorage इवेंट को अनदेखा कर सकता है. अगर ऐसा होता है, तो सिस्टम अपने-आप इमेज डाउनलोड होने की स्थिति पर पहुंच जाता है.

किसी रुके हुए डाउनलोड को फिर से शुरू करने के लिए, ऐप्लिकेशन को इमेज यूआरआई (इवेंट पैरामीटर के तौर पर दिया गया) में बनाए रखना चाहिए. साथ ही, बाद के FetchFetchImageInfo इवेंट को मैनेज करते समय इसका इस्तेमाल करना चाहिए.

kEvent_PrepareQuery

ImageQuery मैसेज को तैयार करें.

सॉफ़्टवेयर अपडेट जांच के ट्रिगर होने पर जनरेट होता है. ऐप्लिकेशन को SofwareUpdate:ImageQuery मैसेज पर प्रॉडक्ट से जुड़ी जानकारी देने का मौका देता है.

kEvent_PrepareQuery_Metadata

ImageQuery के अनुरोध के लिए मेटा-डेटा तैयार करना.

ऐप्लिकेशन को ज़रूरत पड़ने पर SofwareUpdate:ImageQuery मैसेज के साथ अतिरिक्त मेटा-डेटा जोड़ने का मौका देता है. इसे तब जनरेट किया जाता है, जब ऐप्लिकेशन से मेटा-डेटा पाने के लिए तैयार हो.

kEvent_QueryPrepareFailed

ImageQuery के अनुरोध को तैयार करने में कोई गड़बड़ी हुई.

यह तब जनरेट होता है, जब लागू करने के दौरान सॉफ़्टवेयर अपडेट क्वेरी भेजते समय कोई गड़बड़ी होती है.

kEvent_QuerySent

ImageQuery के लिए अनुरोध भेज दिया गया है.

सूचना देने वाला ऐसा इवेंट जो यह बताता है कि SofwareUpdate:ImageQuery मैसेज भेज दिया गया है.

kEvent_ReadyToInstall

इमेज इंस्टॉल किए जाने के लिए तैयार है.

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

kEvent_ResetPartialImageInfo

आंशिक रूप से डाउनलोड की गई इमेज की स्थिति रीसेट करें.

ऐप्लिकेशन से डाउनलोड की गई इमेज से जुड़ी स्थायी स्थिति को भूलने का अनुरोध करता है. जब भी डाउनलोड की गई कोई इमेज पूरी तरह से ठीक नहीं हो पाती है, तो रीसेट किए गए पार्शियलImageInfo इवेंट जनरेट होता है. रीसेट आंशिक इमेज जानकारी इवेंट प्रोसेस हो जाने के बाद, बाद के FetchSharedImageInfo इवेंट से पता चलना चाहिए कि कोई आंशिक इमेज उपलब्ध नहीं है.

ध्यान दें कि रीसेट आंशिक इमेज जानकारी इवेंट को संभालते समय, ऐप्लिकेशन को इमेज डेटा को साफ़ करने की ज़रूरत नहीं होती है, सिर्फ़ इमेज से जुड़ी राज्य जानकारी (यानी यूआरआई और आंशिक इमेज लंबाई) को साफ़ करना होता है.

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

kEvent_SoftwareUpdateAvailable

सॉफ़्टवेयर का अपडेट उपलब्ध है.

तब जनरेट होता है, जब किसी क्वेरी के जवाब में SofwareUpdate:ImageQueryResponse पर मौजूद अपडेट की जानकारी मिलती है.

kEvent_StartImageDownload

इमेज डाउनलोड शुरू हो गया है.

इमेज डाउनलोड करने वाले लेन-देन के शुरू होने के बारे में जानकारी देने वाला इवेंट.

kEvent_StartInstallImage

इमेज इस्टॉल करना शुरू करें.

ऐप्लिकेशन से, डाउनलोड की गई फ़र्मवेयर इमेज इंस्टॉल करने का अनुरोध किया जाता है.

kEvent_StoreImageBlock

इमेज डेटा का ब्लॉक सेव करें.

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

किसी ब्लॉक किए गए डाउनलोड को फिर से शुरू करने के लिए, ऐप्लिकेशन को सेव किए गए इमेज बाइट की कुल संख्या को बनाए रखना चाहिए. साथ ही, बाद के FetchFetchImageInfo इवेंट को मैनेज करते समय इस वैल्यू का इस्तेमाल करना चाहिए.

दोबारा नीति का कॉलबैक दें

void(* RetryPolicyCallback)(void *aAppState, RetryParam &aRetryParam, uint32_t &aOutIntervalMsec)

राज्य

 State

दोस्तों की क्लास

आंतरिक::सामान्य प्लेटफ़ॉर्म मैनेजरImpl

friend class Internal::GenericPlatformManagerImpl

सार्वजनिक फ़ंक्शन

रद्द करें

WEAVE_ERROR Abort(
  void
)

अभी देखें

WEAVE_ERROR CheckNow(
  void
)

गेटस्टेट

State GetState(
  void
)

इमेज इंस्टॉल करना पूरा हुआ

WEAVE_ERROR ImageInstallComplete(
  WEAVE_ERROR aError
)

InInProgress

bool IsInProgress(
  void
)

imageImageStorage पूर्ण

WEAVE_ERROR PrepareImageStorageComplete(
  WEAVE_ERROR aError
)

setEventCallback

WEAVE_ERROR SetEventCallback(
  void *const aAppState,
  const EventCallback aEventCallback
)

setQueryIntervalविंडो

WEAVE_ERROR SetQueryIntervalWindow(
  uint32_t aMinWaitTimeMs,
  uint32_t aMaxWaitTimeMs
)

फिर से कोशिश करें की नीति को कॉलबैक करें

void SetRetryPolicyCallback(
  const RetryPolicyCallback aRetryPolicyCallback
)

सार्वजनिक स्थिर फ़ंक्शन

डिफ़ॉल्ट इवेंट हैंडलर

void DefaultEventHandler(
  void *apAppState,
  EventType aEvent,
  const InEventParam & aInParam,
  OutEventParam & aOutParam
)

सुरक्षित किए गए फ़ंक्शन

सॉफ़्टवेयर अपडेट मैनेजर

 SoftwareUpdateManager()=default

सॉफ़्टवेयर अपडेट मैनेजर

 SoftwareUpdateManager(
  const SoftwareUpdateManager &
)=delete

सॉफ़्टवेयर अपडेट मैनेजर

 SoftwareUpdateManager(
  const SoftwareUpdateManager &&
)=delete

ऑपरेटर=

SoftwareUpdateManager & operator=(
  const SoftwareUpdateManager &
)=delete

~SoftwareUpdateManager

 ~SoftwareUpdateManager()=default