網絡協處理器

該模塊包括控制線程堆棧的執行的功能。

概要

類型定義
`otNcpDelegateAllowPeekPoke )(uint32_t aAddress, uint16_t aCount)`	類型定義 `bool(*` 定義委託（函數指針）類型以控制偷看/戳操作的行為。
`otNcpHandlerJoinLegacyNode )(const otExtAddress *aExtAddress)`	類型定義 `void(*` 定義用於啟動加入過程的處理程序（函數指針）類型。
`otNcpHandlerSetLegacyUlaPrefix )(const uint8_t *aUlaPrefix)`	類型定義 `void(*` 定義用於設置舊版ULA前綴的處理程序（函數指針）類型。
`otNcpHandlerStartLegacy )(void)`	類型定義 `void(*` 定義用於啟動舊版網絡的處理程序（函數指針）類型。
`otNcpHandlerStopLegacy )(void)`	類型定義 `void(*` 定義用於停止舊版網絡的處理程序（函數指針）類型。
`otNcpLegacyHandlers`	類型定義 `struct otNcpLegacyHandlers` 定義一個包含所有舊式處理程序（函數指針）的結構。

職能
`otNcpHandleDidReceiveNewLegacyUlaPrefix (const uint8_t *aUlaPrefix)`	`void` 舊式堆棧調用此回調以通知舊式ULA前綴已更改。
`otNcpHandleLegacyNodeDidJoin (const otExtAddress *aExtAddr)`	`void` 舊式堆棧調用此回調以通知新的舊式節點確實已加入網絡。
`otNcpInit ( otInstance *aInstance)`	`void` 初始化NCP。
`otNcpPlatLogv ( otLogLevel aLogLevel, otLogRegion aLogRegion, const char *aFormat, va_list aArgs)`	`void` 使用`otNcpStreamWrite`寫入OpenThread日誌。
`otNcpRegisterLegacyHandlers (const otNcpLegacyHandlers *aHandlers)`	`void` 此方法向NCP註冊一組舊式處理程序。
`otNcpRegisterPeekPokeDelagates ( otNcpDelegateAllowPeekPoke aAllowPeekDelegate, otNcpDelegateAllowPeekPoke aAllowPokeDelegate)`	`void` 此方法向NCP模塊註冊偷看/戳委託功能。
`otNcpStreamWrite (int aStreamId, const uint8_t *aDataPtr, int aDataLen)`	`otError` 通過特定的流向主機發送數據。

結構
otNcpLegacyHandlers	定義一個包含所有舊式處理程序（函數指針）的結構。

類型定義

otNcpDelegateAllowPeekPoke

bool(* otNcpDelegateAllowPeekPoke)(uint32_t aAddress, uint16_t aCount)

定義委託（函數指針）類型以控制偷看/戳操作的行為。

調用該委託函數來決定是允許窺視還是戳特定的存儲區域。如果啟用了對偷看/戳命令的NCP支持，則使用它。

細節

參量

`[in] aAddress`	內存區域的起始地址。
`[in] aCount`	窺視或戳的字節數。

退貨

設置為TRUE允許窺視/戳入給定的存儲區域，否則為FALSE。

otNcpHandlerJoinLegacyNode

void(* otNcpHandlerJoinLegacyNode)(const otExtAddress *aExtAddress)

定義用於啟動加入過程的處理程序（函數指針）類型。

調用以啟動到任何或特定節點的舊版加入過程。

細節

參量

[in] aExtAddress

指向節點要加入的擴展地址的指針；如果需要加入任何相鄰節點，則為NULL。

otNcpHandlerSetLegacyUlaPrefix

void(* otNcpHandlerSetLegacyUlaPrefix)(const uint8_t *aUlaPrefix)

定義用於設置舊版ULA前綴的處理程序（函數指針）類型。

調用以設置舊版ULA前綴。

細節

參量

[in] aUlaPrefix

指向包含舊版ULA前綴的緩衝區的指針。

otNcpHandlerStartLegacy

void(* otNcpHandlerStartLegacy)(void)

定義用於啟動舊版網絡的處理程序（函數指針）類型。

調用以啟動舊版網絡。

otNcpHandlerStopLegacy

void(* otNcpHandlerStopLegacy)(void)

定義用於停止舊版網絡的處理程序（函數指針）類型。

調用以停止舊版網絡。

otNcpLegacyHandlers

struct otNcpLegacyHandlers otNcpLegacyHandlers

定義一個包含所有舊式處理程序（函數指針）的結構。

職能

otNcpHandleDidReceiveNewLegacyUlaPrefix

void otNcpHandleDidReceiveNewLegacyUlaPrefix(
  const uint8_t *aUlaPrefix
)

舊式堆棧調用此回調以通知舊式ULA前綴已更改。

細節

參量

[in] aUlaPrefix

指向收到的ULA前綴的指針。

otNcpHandleLegacyNodeDidJoin

void otNcpHandleLegacyNodeDidJoin(
  const otExtAddress *aExtAddr
)

舊式堆棧調用此回調以通知新的舊式節點確實已加入網絡。

細節

參量

[in] aExtAddr

指向加入節點的擴展地址的指針。

otNcpInit

void otNcpInit(
  otInstance *aInstance
)

初始化NCP。

細節

參量

[in] aInstance

OpenThread實例結構。

otNcpPlatLogv

void otNcpPlatLogv(
  otLogLevel aLogLevel,
  otLogRegion aLogRegion,
  const char *aFormat,
  va_list aArgs
)

使用otNcpStreamWrite寫入OpenThread日誌。

細節

參量

`[in] aLogLevel`	日誌級別。
`[in] aLogRegion`	日誌區域。
`[in] aFormat`	指向格式字符串的指針。
`[in] aArgs`	va_list與aFormat匹配。

otNcpRegisterLegacyHandlers

void otNcpRegisterLegacyHandlers(
  const otNcpLegacyHandlers *aHandlers
)

此方法向NCP註冊一組舊式處理程序。

NCP代碼使用struct aHandlers提供的一組處理程序來啟動/停止舊式網絡。 aHandlers可以為NULL，以禁用NCP上的舊版支持。給定處理程序結構中的各個處理程序也可以為NULL。

細節

參量

[in] aHandlers

指向處理程序結構的指針。

otNcpRegisterPeekPokeDelagates

void otNcpRegisterPeekPokeDelagates(
  otNcpDelegateAllowPeekPoke aAllowPeekDelegate,
  otNcpDelegateAllowPeekPoke aAllowPokeDelegate
)

此方法向NCP模塊註冊偷看/戳委託功能。

NCP模塊調用委託函數，以決定是允許窺視還是戳特定的存儲區域。如果委託指針設置為NULL，則它允許對任何地址進行窺視/戳操作。

細節

參量

`[in] aAllowPeekDelegate`	委託函數指針進行窺視操作。
`[in] aAllowPokeDelegate`	委託函數指針進行戳操作。

otNcpStreamWrite

otError otNcpStreamWrite(
  int aStreamId,
  const uint8_t *aDataPtr,
  int aDataLen
)

通過特定的流向主機發送數據。

此函數嘗試使用給定的aStreamId將給定的數據發送到主機。這對於報告錯誤消息，實現調試/診斷控制台以及可能的其他類型的數據流很有用。

寫入全部或全部被接受或被拒絕。不嘗試部分寫入。

細節

參量

`[in] aStreamId`	要寫入的流的數字標識符。如果設置為“ 0”，則默認為調試流。
`[in] aDataPtr`	指向要在流上發送的數據的指針。如果aDataLen不為零，則此參數不得為NULL。
`[in] aDataLen`	從aDataPtr發送的數據字節數。

返回值

`OT_ERROR_NONE`	數據已排隊等待傳遞到主機。
`OT_ERROR_BUSY`	沒有足夠的資源來完成此請求。這通常是暫時的情況。
`OT_ERROR_INVALID_ARGS`	給定的aStreamId無效。

巨集

OT_NCP_LEGACY_ULA_PREFIX_LENGTH

 OT_NCP_LEGACY_ULA_PREFIX_LENGTH 8

舊版ULA大小（以字節為單位）