ช่างเชื่อม

โมดูลนี้มีฟังก์ชันสำหรับบทบาทเครื่องมือเชื่อมต่อชุดข้อความ

สรุป

การแจกแจง
otJoinerState enum
กำหนดสถานะเครื่องมือเชื่อมต่อ

Typedef
otJoinerCallback)(otError aError, void *aContext) typedef
void(*
ระบบจะเรียกใช้ตัวชี้เพื่อแจ้งว่าการดำเนินการผนวกเสร็จสมบูรณ์
otJoinerDiscerner typedef
หมายถึงเครื่องมือแยกส่วน
otJoinerState typedef
กำหนดสถานะเครื่องมือเชื่อมต่อ

ฟังก์ชัน
otJoinerGetDiscerner(otInstance *aInstance)
รับเครื่องมือแยกหน้าจอ
otJoinerGetId(otInstance *aInstance)
const otExtAddress *
รับรหัสผู้เชื่อม
otJoinerGetState(otInstance *aInstance)
รับสถานะเครื่องมือเชื่อม
otJoinerSetDiscerner(otInstance *aInstance, otJoinerDiscerner *aDiscerner)
ตั้งค่าตัวแยกส่วน
otJoinerStart(otInstance *aInstance, const char *aPskd, const char *aProvisioningUrl, const char *aVendorName, const char *aVendorModel, const char *aVendorSwVersion, const char *aVendorData, otJoinerCallback aCallback, void *aContext)
เปิดใช้บทบาทเครื่องมือผนวกชุดข้อความ
otJoinerStateToString(otJoinerState aState)
const char *
แปลงค่าการแจงนับสถานะเครื่องมือเชื่อมต่อที่ระบุเป็นสตริงที่มนุษย์อ่านได้
otJoinerStop(otInstance *aInstance)
void
ปิดใช้บทบาทเครื่องมือผนวกชุดข้อความ

โครงสร้าง
otJoinerDiscerner

หมายถึงเครื่องมือแยกส่วน

การแจกแจง

otJoinerState

 otJoinerState

กำหนดสถานะเครื่องมือเชื่อมต่อ

Typedef

otJoinerCallback

void(* otJoinerCallback)(otError aError, void *aContext)

ระบบจะเรียกใช้ตัวชี้เพื่อแจ้งว่าการดำเนินการผนวกเสร็จสมบูรณ์

รายละเอียด
พารามิเตอร์
[in] aError
OT_ERROR_NONE หากขั้นตอนการเข้าร่วมสำเร็จ OT_ERROR_SECURITY หากขั้นตอนการเข้าร่วมล้มเหลวเนื่องจากข้อมูลเข้าสู่ระบบเพื่อรักษาความปลอดภัย OT_ERROR_NOT_FOUND หากไม่พบเครือข่ายที่เข้าร่วมได้ OT_ERROR_RESPONSE_TIMEOUT หากการตอบกลับหมดเวลา
[in] aContext
ตัวชี้ไปยังบริบทเฉพาะแอปพลิเคชัน

otJoinerDiscerner

struct otJoinerDiscerner otJoinerDiscerner

หมายถึงเครื่องมือแยกส่วน

otJoinerState

enum otJoinerState otJoinerState

กำหนดสถานะเครื่องมือเชื่อมต่อ

ฟังก์ชัน

otJoinerGetDiscerner

const otJoinerDiscerner * otJoinerGetDiscerner(
  otInstance *aInstance
)

รับเครื่องมือแยกหน้าจอ

ดูข้อมูลเพิ่มเติมได้ที่ otJoinerSetDiscerner

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
ตัวชี้ไปยัง Joiner Discerner หรือ NULL หากไม่ได้ตั้งค่าไว้

otJoinerGetId

const otExtAddress * otJoinerGetId(
  otInstance *aInstance
)

รับรหัสผู้เชื่อม

หากไม่ได้ตั้งค่า Joiner Discerner รหัส Joiner จะเป็น 64 บิตแรกของผลลัพธ์ของการประมวลผล SHA-256 ผ่าน IEEE EUI-64 ที่กําหนดจากโรงงาน ไม่เช่นนั้น ระบบจะคํานวณรหัส Joiner จากค่า Joiner Discerner

นอกจากนี้ รหัส Joiner ยังใช้เป็นที่อยู่ขยาย IEEE 802.15.4 ของอุปกรณ์ในระหว่างกระบวนการจัดเตรียมด้วย

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
ตัวชี้ไปยังรหัสเครื่องมือเชื่อมต่อ

otJoinerGetState

otJoinerState otJoinerGetState(
  otInstance *aInstance
)

รับสถานะเครื่องมือเชื่อม

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
การส่งคืน
สถานะเครื่องมือเชื่อมต่อ

otJoinerSetDiscerner

otError otJoinerSetDiscerner(
  otInstance *aInstance,
  otJoinerDiscerner *aDiscerner
)

ตั้งค่าตัวแยกส่วน

Joiner Discerner ใช้เพื่อคำนวณรหัส Joiner ระหว่างขั้นตอนการเปิดใช้เทรด ดูข้อมูลเพิ่มเติมได้ที่ otJoinerGetId

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aDiscerner
ตัวชี้ไปยังตัวแยกส่วน หาก NULL ล้างตัวเลือกการตั้งค่าก่อนหน้านี้
แสดงผลค่า
OT_ERROR_NONE
อัปเดต Joiner Discerner เรียบร้อยแล้ว
OT_ERROR_INVALID_ARGS
aDiscerner ไม่ถูกต้อง (ความยาวที่ระบุไม่อยู่ในช่วงที่ถูกต้อง)
OT_ERROR_INVALID_STATE
มีกระบวนการเข้าร่วมที่ดำเนินอยู่ ดังนั้นจึงไม่สามารถเปลี่ยนแปลง Joiner Discerner

otJoinerStart

otError otJoinerStart(
  otInstance *aInstance,
  const char *aPskd,
  const char *aProvisioningUrl,
  const char *aVendorName,
  const char *aVendorModel,
  const char *aVendorSwVersion,
  const char *aVendorData,
  otJoinerCallback aCallback,
  void *aContext
)

เปิดใช้บทบาทเครื่องมือผนวกชุดข้อความ

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread
[in] aPskd
ตัวชี้ไปยัง PSKd
[in] aProvisioningUrl
ตัวชี้ไปยัง URL การจัดสรร (อาจเป็น NULL)
[in] aVendorName
ตัวชี้ไปยังชื่อผู้ให้บริการ (อาจเป็น NULL)
[in] aVendorModel
ตัวชี้ไปยังโมเดลผู้ให้บริการ (อาจเป็น NULL)
[in] aVendorSwVersion
ตัวชี้ไปยังเวอร์ชัน SW ของผู้ให้บริการ (อาจเป็น NULL)
[in] aVendorData
ตัวชี้ไปยังข้อมูลผู้ให้บริการ (อาจเป็น NULL)
[in] aCallback
ตัวชี้ไปยังฟังก์ชันที่เรียกใช้เมื่อการดำเนินการผนวกเสร็จสมบูรณ์
[in] aContext
ตัวชี้ไปยังบริบทเฉพาะแอปพลิเคชัน
แสดงผลค่า
OT_ERROR_NONE
เริ่มต้นบทบาทผู้ผนวกเรียบร้อยแล้ว
OT_ERROR_BUSY
ความพยายามครั้งก่อนหน้ายังคงดำเนินอยู่
OT_ERROR_INVALID_ARGS
aPskd หรือ aProvisioningUrl ไม่ถูกต้อง
OT_ERROR_INVALID_STATE
ไม่ได้เปิดใช้สแต็ก IPv6 หรือเปิดใช้สแต็กเทรดอย่างสมบูรณ์

otJoinerStateToString

const char * otJoinerStateToString(
  otJoinerState aState
)

แปลงค่าการแจงนับสถานะเครื่องมือเชื่อมต่อที่ระบุเป็นสตริงที่มนุษย์อ่านได้

รายละเอียด
พารามิเตอร์
[in] aState
สถานะเครื่องมือเชื่อมต่อ
การส่งคืน
ตัวแทนสตริงที่มนุษย์อ่านได้ของ aState

otJoinerStop

void otJoinerStop(
  otInstance *aInstance
)

ปิดใช้บทบาทเครื่องมือผนวกชุดข้อความ

รายละเอียด
พารามิเตอร์
[in] aInstance
ตัวชี้ไปยังอินสแตนซ์ OpenThread

มาโคร

OT_JOINER_MAX_DISCERNER_LENGTH

 OT_JOINER_MAX_DISCERNER_LENGTH 64

ความยาวสูงสุดของตัวตัดเครื่องมือเชื่อมเป็นบิต

แหล่งข้อมูล

หัวข้ออ้างอิง API ของ OpenThread จะมาจากซอร์สโค้ดซึ่งพร้อมใช้งานใน GitHub ดูข้อมูลเพิ่มเติมหรือมีส่วนร่วมในเอกสารประกอบของเราได้ที่แหล่งข้อมูล