بيانات تشخيص المصنع - النظام الأساسي

تتضمن هذه الوحدة تجريد النظام الأساسي لميزات التشخيص.

ملخّص

عمليات التعداد
otGpioMode{
  OT_GPIO_MODE_INPUT = 0,
  OT_GPIO_MODE_OUTPUT = 1
} 		تعداد
تحدد أوضاع Gpio.

الدوال
otPlatDiagAlarmCallback(otInstance *aInstance)
void
لمعالجة حدث التنبيه.
otPlatDiagChannelSet(uint8_t aChannel)
void
لضبط القناة لاستخدامها في بيانات تشخيص المصنع.
otPlatDiagGpioGet(uint32_t aGpio, bool *aValue)
للحصول على قيمة gpio.
otPlatDiagGpioGetMode(uint32_t aGpio, otGpioMode *aMode)
للحصول على وضع gpio.
otPlatDiagGpioSet(uint32_t aGpio, bool aValue)
لضبط قيمة gpio.
otPlatDiagGpioSetMode(uint32_t aGpio, otGpioMode aMode)
لضبط وضع gpio.
otPlatDiagModeGet(void)
bool
يشير إلى ما إذا كان وضع بيانات تشخيص المصنع مفعَّلاً أم لا.
otPlatDiagModeSet(bool aMode)
void
تعمل هذه السياسة على تفعيل/إيقاف وضع بيانات التشخيص على الإعدادات الأصلية.
otPlatDiagProcess(otInstance *aInstance, uint8_t aArgsLength, char *aArgs[], char *aOutput, size_t aOutputMaxLen)
معالجة سطر أوامر بيانات تشخيص المصنع.
otPlatDiagRadioGetPowerSettings(otInstance *aInstance, uint8_t aChannel, int16_t *aTargetPower, int16_t *aActualPower, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)
احصل على إعدادات الطاقة للقناة المحدّدة.
otPlatDiagRadioGetRawPowerSetting(otInstance *aInstance, uint8_t *aRawPowerSetting, uint16_t *aRawPowerSettingLength)
الحصول على إعداد الطاقة اللاسلكية الأولية لوحدة التشخيص
otPlatDiagRadioRawPowerSettingEnable(otInstance *aInstance, bool aEnable)
يمكنك تفعيل/إيقاف طبقة النظام الأساسي لاستخدام إعداد الطاقة الأولي الذي تم ضبطه من قِبل otPlatDiagRadioSetRawPowerSetting().
otPlatDiagRadioReceived(otInstance *aInstance, otRadioFrame *aFrame, otError aError)
void
لمعالجة إطار الراديو الذي تم استلامه.
otPlatDiagRadioSetRawPowerSetting(otInstance *aInstance, const uint8_t *aRawPowerSetting, uint16_t aRawPowerSettingLength)
اضبط إعدادات الطاقة اللاسلكية الأولية لوحدة التشخيص.
otPlatDiagRadioTransmitCarrier(otInstance *aInstance, bool aEnable)
بدء/إيقاف طبقة النظام الأساسي لنقل موجة حامل مستمرة.
otPlatDiagRadioTransmitStream(otInstance *aInstance, bool aEnable)
بدء/إيقاف طبقة النظام الأساسي لنقل تدفق الأحرف.
otPlatDiagTxPowerSet(int8_t aTxPower)
void
لضبط طاقة الإرسال لاستخدامها في بيانات التشخيص للمصنع

عمليات التعداد

otGpioMode

 otGpioMode

تحدد أوضاع Gpio.

أماكن إقامة
OT_GPIO_MODE_INPUT

وضع الإدخال بدون مقاومة السحب.

OT_GPIO_MODE_OUTPUT

وضع الإخراج

الدوال

otPlatDiagAlarmCallback

void otPlatDiagAlarmCallback(
  otInstance *aInstance
)

لمعالجة حدث التنبيه.

التفاصيل
المَعلمات
[in] aInstance
مثيل OpenThread للطلب الحالي.

otPlatDiagChannelSet

void otPlatDiagChannelSet(
  uint8_t aChannel
)

لضبط القناة لاستخدامها في بيانات تشخيص المصنع.

التفاصيل
المَعلمات
[in] aChannel
قيمة القناة.

otPlatDiagGpioGet

otError otPlatDiagGpioGet(
  uint32_t aGpio,
  bool *aValue
)

للحصول على قيمة gpio.

التفاصيل
المَعلمات
[in] aGpio
رقم gpio.
[out] aValue
يشير ذلك المصطلح إلى مؤشر يتم فيه وضع قيمة gpio.
قيم الإرجاع
OT_ERROR_NONE
تم الحصول على قيمة gpio بنجاح.
OT_ERROR_FAILED
حدث خطأ في النظام الأساسي أثناء الحصول على قيمة gpio.
OT_ERROR_INVALID_ARGS
aGpio غير متوافق أو aValue فارغة.
OT_ERROR_INVALID_STATE
لم يتم تفعيل وضع التشخيص أو لم يتم ضبط aGpio كإدخال.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الدالة أو إعدادها على النظام الأساسي.

otPlatDiagGpioGetMode

otError otPlatDiagGpioGetMode(
  uint32_t aGpio,
  otGpioMode *aMode
)

للحصول على وضع gpio.

التفاصيل
المَعلمات
[in] aGpio
رقم gpio.
[out] aMode
مؤشر يشير إلى مكان وضع وضع gpio.
قيم الإرجاع
OT_ERROR_NONE
تم الحصول على وضع gpio بنجاح.
OT_ERROR_FAILED
لم يتم تنفيذ الوضع الذي يعرضه النظام الأساسي في OpenThread أو حدث خطأ في النظام الأساسي أثناء الحصول على وضع gpio.
OT_ERROR_INVALID_ARGS
aGpio غير متوافق أو aMode فارغة.
OT_ERROR_INVALID_STATE
لم يتم تفعيل وضع التشخيص.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الدالة أو إعدادها على النظام الأساسي.

otPlatDiagGpioSet

otError otPlatDiagGpioSet(
  uint32_t aGpio,
  bool aValue
)

لضبط قيمة gpio.

التفاصيل
المَعلمات
[in] aGpio
رقم gpio.
[in] aValue
true لتعيين gpio على مستوى عالٍ، أو false بخلاف ذلك.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط gpio بنجاح.
OT_ERROR_FAILED
حدث خطأ في النظام الأساسي أثناء ضبط gpio.
OT_ERROR_INVALID_ARGS
‫"aGpio" غير متاح
OT_ERROR_INVALID_STATE
لم يتم تفعيل وضع التشخيص أو لم يتم ضبط aGpio باعتباره إخراجًا.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الدالة أو إعدادها على النظام الأساسي.

otPlatDiagGpioSetMode

otError otPlatDiagGpioSetMode(
  uint32_t aGpio,
  otGpioMode aMode
)

لضبط وضع gpio.

التفاصيل
المَعلمات
[in] aGpio
رقم gpio.
[out] aMode
وضع gpio.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط وضع gpio بنجاح.
OT_ERROR_FAILED
حدث خطأ في النظام الأساسي أثناء ضبط وضع gpio.
OT_ERROR_INVALID_ARGS
aGpio أو aMode غير متاح.
OT_ERROR_INVALID_STATE
لم يتم تفعيل وضع التشخيص.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الدالة أو إعدادها على النظام الأساسي.

otPlatDiagModeGet

bool otPlatDiagModeGet(
  void
)

يشير إلى ما إذا كان وضع بيانات تشخيص المصنع مفعَّلاً أم لا.

التفاصيل
المرتجعات
TRUE في حالة تمكين وضع بيانات تشخيص المصنع، على FALSE في الحالات الأخرى.

otPlatDiagModeSet

void otPlatDiagModeSet(
  bool aMode
)

تعمل هذه السياسة على تفعيل/إيقاف وضع بيانات التشخيص على الإعدادات الأصلية.

التفاصيل
المَعلمات
[in] aMode
TRUE لتمكين وضع التشخيص، وإلا سيتم عرضه على FALSE.

otPlatDiagProcess

otError otPlatDiagProcess(
  otInstance *aInstance,
  uint8_t aArgsLength,
  char *aArgs[],
  char *aOutput,
  size_t aOutputMaxLen
)

معالجة سطر أوامر بيانات تشخيص المصنع.

يجب أن ينتهي ناتج هذه الدالة (المحتوى المكتوب في aOutput) بـ \0 ويكون \0 داخل المخزن المؤقت للمخرجات.

التفاصيل
المَعلمات
[in] aInstance
مثيل OpenThread للطلب الحالي.
[in] aArgsLength
عدد الوسيطات في aArgs.
[in] aArgs
وسيطات سطر أوامر بيانات التشخيص.
[out] aOutput
نتيجة تنفيذ بيانات التشخيص.
[in] aOutputMaxLen
حجم المخزن المؤقت للمخرجات
قيم الإرجاع
OT_ERROR_INVALID_ARGS
الأمر متوافق ولكن تم تقديم وسيطات غير صالحة.
OT_ERROR_NONE
تمت معالجة الأمر بنجاح.
OT_ERROR_INVALID_COMMAND
الأمر غير صالح أو غير معتمد.

otPlatDiagRadioGetPowerSettings

otError otPlatDiagRadioGetPowerSettings(
  otInstance *aInstance,
  uint8_t aChannel,
  int16_t *aTargetPower,
  int16_t *aActualPower,
  uint8_t *aRawPowerSetting,
  uint16_t *aRawPowerSettingLength
)

احصل على إعدادات الطاقة للقناة المحدّدة.

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[in] aChannel
قناة الراديو
[out] aTargetPower
الطاقة المستهدفة: 0.01 ديسيبل ملي واط
[out] aActualPower
الطاقة الفعلية بـ 0.01 ديسيبل ملي واط.
[out] aRawPowerSetting
مؤشر يشير إلى مصفوفة البايت الخاصة بإعداد الطاقة الأولية.
[in,out] aRawPowerSettingLength
عند الإدخال، يشير إلى حجم aRawPowerSetting. عند الإخراج، يظهر مؤشر لطول بيانات إعدادات الطاقة الأولية.
قيم الإرجاع
OT_ERROR_NONE
تم الحصول على القوة المستهدفة بنجاح.
OT_ERROR_INVALID_ARGS
قيمة aChannel غير صالحة أو aActualPower أو aRawPowerSetting أو aRawPowerSettingLength فارغة أو قصيرة جدًا.
OT_ERROR_NOT_FOUND
لم يتم العثور على إعدادات التشغيل لجهاز "aChannel".
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الطريقة.

otPlatDiagRadioGetRawPowerSetting

otError otPlatDiagRadioGetRawPowerSetting(
  otInstance *aInstance,
  uint8_t *aRawPowerSetting,
  uint16_t *aRawPowerSettingLength
)

الحصول على إعداد الطاقة اللاسلكية الأولية لوحدة التشخيص

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[out] aRawPowerSetting
مؤشر يشير إلى مصفوفة البايت الخاصة بإعداد الطاقة الأولية.
[in,out] aRawPowerSettingLength
عند الإدخال، يشير إلى حجم aRawPowerSetting. عند الإخراج، يظهر مؤشر لطول بيانات إعدادات الطاقة الأولية.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط إعدادات الطاقة الأولية بنجاح.
OT_ERROR_INVALID_ARGS
قيمة aRawPowerSetting أو aRawPowerSettingLength فارغة أو قصيرة جدًا.
OT_ERROR_NOT_FOUND
لم يتم ضبط إعداد الطاقة الأولية.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الطريقة.

otPlatDiagRadioRawPowerSettingEnable

otError otPlatDiagRadioRawPowerSettingEnable(
  otInstance *aInstance,
  bool aEnable
)

يمكنك تفعيل/إيقاف طبقة النظام الأساسي لاستخدام إعداد الطاقة الأولي الذي تم ضبطه من قِبل otPlatDiagRadioSetRawPowerSetting().

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[in] aEnable
TRUE للتفعيل أو FALSE لإيقاف إعداد الطاقة الأوّلي.
قيم الإرجاع
OT_ERROR_NONE
تم تفعيل/إيقاف إعداد الطاقة الأولية بنجاح.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الطريقة.

otPlatDiagRadioReceived

void otPlatDiagRadioReceived(
  otInstance *aInstance,
  otRadioFrame *aFrame,
  otError aError
)

لمعالجة إطار الراديو الذي تم استلامه.

التفاصيل
المَعلمات
[in] aInstance
مثيل OpenThread للطلب الحالي.
[in] aFrame
إطار الراديو الذي تم استلامه
[in] aError
حالة إطار الراديو الذي تم استلامه

otPlatDiagRadioSetRawPowerSetting

otError otPlatDiagRadioSetRawPowerSetting(
  otInstance *aInstance,
  const uint8_t *aRawPowerSetting,
  uint16_t aRawPowerSettingLength
)

اضبط إعدادات الطاقة اللاسلكية الأولية لوحدة التشخيص.

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[in] aRawPowerSetting
مؤشر يشير إلى مصفوفة البايت الخاصة بإعداد الطاقة الأولية.
[in] aRawPowerSettingLength
تمثّل هذه السمة طول aRawPowerSetting.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط إعدادات الطاقة الأولية بنجاح.
OT_ERROR_INVALID_ARGS
قيمة aRawPowerSetting فارغة أو aRawPowerSettingLength طويلة جدًا.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الطريقة.

otPlatDiagRadioTransmitCarrier

otError otPlatDiagRadioTransmitCarrier(
  otInstance *aInstance,
  bool aEnable
)

بدء/إيقاف طبقة النظام الأساسي لنقل موجة حامل مستمرة.

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[in] aEnable
TRUE للتمكين أو FALSE لإيقاف طبقة النظام الأساسي لإرسال موجة حامل مستمرة.
قيم الإرجاع
OT_ERROR_NONE
تم التفعيل/الإيقاف بنجاح .
OT_ERROR_INVALID_STATE
لم يكن الراديو في حالة الاستلام.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الطريقة.

otPlatDiagRadioTransmitStream

otError otPlatDiagRadioTransmitStream(
  otInstance *aInstance,
  bool aEnable
)

بدء/إيقاف طبقة النظام الأساسي لنقل تدفق الأحرف.

التفاصيل
المَعلمات
[in] aInstance
بنية النسخة الافتراضية OpenThread
[in] aEnable
TRUE للتمكين أو FALSE لإيقاف طبقة النظام الأساسي لإرسال البث.
قيم الإرجاع
OT_ERROR_NONE
تم التفعيل/الإيقاف بنجاح.
OT_ERROR_INVALID_STATE
لم يكن الراديو في حالة الاستلام.
OT_ERROR_NOT_IMPLEMENTED
لم يتم تنفيذ هذه الدالة.

otPlatDiagTxPowerSet

void otPlatDiagTxPowerSet(
  int8_t aTxPower
)

لضبط طاقة الإرسال لاستخدامها في بيانات التشخيص للمصنع

التفاصيل
المَعلمات
[in] aTxPower
قيمة طاقة الإرسال.

المراجِع

تنشأ المواضيع المرجعية لواجهة برمجة تطبيقات OpenThread من رمز المصدر المتاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في مستنداتنا، يمكنك الاطّلاع على المراجع.