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

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

ملخّص

التعدادات

otGpioMode{
  OT_GPIO_MODE_INPUT = 0,
  OT_GPIO_MODE_OUTPUT = 1
}
تعداد
تحديد أوضاع "نظام تحديد المواقع العالمي (GPS)".

الدوال

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

تحديد أوضاع "نظام تحديد المواقع العالمي (GPS)".

أماكن إقامة
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
صحيح لضبط الجهاز الافتراضي على مستوى عالٍ أو على "خطأ" بخلاف ذلك.
قيم الإرجاع
OT_ERROR_NONE
تم ضبط نظام تحديد المواقع العالمي (GPS) بنجاح.
OT_ERROR_FAILED
حدث خطأ في النظام الأساسي أثناء ضبط نظام تحديد المواقع العالمي (GPS).
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 في حال تفعيل وضع "بيانات تشخيص المصنع" أو "خطأ" في الحالات الأخرى

otPlatDiagModeSet

void otPlatDiagModeSet(
  bool aMode
)

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

التفاصيل
المَعلمات
[in] aMode
TRUE لتفعيل وضع "بيانات التشخيص"، خطأ "خطأ" في الحالات الأخرى.

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
لم يتم تنفيذ هذه الطريقة.

otPlatDiagRadioRawPowerSettingEnabled

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
لم يتم تنفيذ هذه الطريقة.

otPlatDiagRadioTransmitمشغّل شبكة الجوّال

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. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.