원본 링크

이 모듈에는 원시 링크 레이어 구성을 제어하는 함수가 포함되어 있습니다.

요약

Typedef
otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi) typedef
void(*
IEEE 802.15.4 프레임 수신에 대한 포인터
otLinkRawReceiveDone)(otInstance *aInstance, otRadioFrame *aFrame, otError aError) typedef
void(*
IEEE 802.15.4 프레임 수신에 대한 포인터
otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError) typedef
void(*
IEEE 802.15.4 프레임 수신에 대한 포인터

함수
otLinkRawEnergyScan(otInstance *aInstance, uint8_t aScanChannel, uint16_t aScanDuration, otLinkRawEnergyScanDone aCallback)
무선 통신에서 에너지 스캔 시퀀스를 시작합니다.
otLinkRawGetCaps(otInstance *aInstance)
라디오 기능을 활용하세요.
otLinkRawGetPromiscuous(otInstance *aInstance)
bool
무차별 모드의 상태를 가져옵니다.
otLinkRawGetRadioTime(otInstance *aInstance)
uint64_t
라디오 칩의 현재 플랫폼 시간 (64비트 너비)을 가져옵니다.
otLinkRawGetRssi(otInstance *aInstance)
int8_t
최신 RSSI 측정값을 가져옵니다.
otLinkRawGetTransmitBuffer(otInstance *aInstance)
무선이 전송에서 수신으로 전환됩니다.
otLinkRawIsEnabled(otInstance *aInstance)
bool
원시 링크 레이어의 사용 여부를 나타냅니다.
otLinkRawReceive(otInstance *aInstance)
라디오를 절전 모드에서 수신으로 전환합니다.
otLinkRawSetMacFrameCounter(otInstance *aInstance, uint32_t aMacFrameCounter)
현재 MAC 프레임 카운터 값을 설정합니다.
otLinkRawSetMacFrameCounterIfLarger(otInstance *aInstance, uint32_t aMacFrameCounter)
새 값이 현재 값보다 큰 경우에만 현재 MAC 프레임 카운터 값을 설정합니다.
otLinkRawSetMacKey(otInstance *aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey *aPrevKey, const otMacKey *aCurrKey, const otMacKey *aNextKey)
MAC 키와 키 색인을 업데이트합니다.
otLinkRawSetPromiscuous(otInstance *aInstance, bool aEnable)
무차별 모드를 사용 설정하거나 사용 중지합니다.
otLinkRawSetReceiveDone(otInstance *aInstance, otLinkRawReceiveDone aCallback)
원시 링크 레이어를 사용 설정/사용 중지합니다.
otLinkRawSetShortAddress(otInstance *aInstance, uint16_t aShortAddress)
주소 필터링의 짧은 주소를 설정합니다.
otLinkRawSleep(otInstance *aInstance)
라디오를 수신에서 절전으로 전환합니다.
otLinkRawSrcMatchAddExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
소스 데이터 이동 색인에 확장 주소를 추가합니다.
otLinkRawSrcMatchAddShortEntry(otInstance *aInstance, uint16_t aShortAddress)
소스 데이터 이동 색인에 짧은 주소 추가
otLinkRawSrcMatchClearExtEntries(otInstance *aInstance)
소스 데이터 이동 색인에서 모든 확장 주소를 삭제합니다.
otLinkRawSrcMatchClearExtEntry(otInstance *aInstance, const otExtAddress *aExtAddress)
라디오의 소스 데이터 이동 색인에서 확장된 주소를 삭제합니다.
otLinkRawSrcMatchClearShortEntries(otInstance *aInstance)
소스 데이터 이동 색인에서 짧은 주소를 모두 삭제합니다.
otLinkRawSrcMatchClearShortEntry(otInstance *aInstance, uint16_t aShortAddress)
소스 데이터 이동 색인에서 짧은 주소를 삭제합니다.
otLinkRawSrcMatchEnable(otInstance *aInstance, bool aEnable)
대기 중인 프레임에 대한 소스 일치를 사용 설정/사용 중지합니다.
otLinkRawTransmit(otInstance *aInstance, otLinkRawTransmitDone aCallback)
무선의 전송 시퀀스를 시작합니다.

Typedef

otLinkRawEnergyScanDone

void(* otLinkRawEnergyScanDone)(otInstance *aInstance, int8_t aEnergyScanMaxRssi)

IEEE 802.15.4 프레임 수신에 대한 포인터

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aEnergyScanMaxRssi
스캔된 채널에서 발견된 최대 RSSI입니다.

otLinkRawReceiveDone

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

IEEE 802.15.4 프레임 수신에 대한 포인터

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aFrame
수신된 프레임을 가리키는 포인터 또는 수신 작업이 취소된 경우 NULL.
[in] aError
프레임을 성공적으로 수신하면 OT_ERROR_NONE이 반환됩니다. 수신이 중단되고 프레임이 수신되지 않은 경우 OT_ERROR_ABORT를 반환합니다.

otLinkRawTransmitDone

void(* otLinkRawTransmitDone)(otInstance *aInstance, otRadioFrame *aFrame, otRadioFrame *aAckFrame, otError aError)

IEEE 802.15.4 프레임 수신에 대한 포인터

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aFrame
전송된 프레임을 가리키는 포인터입니다.
[in] aAckFrame
ACK 프레임을 가리키는 포인터.
[in] aError
OT_ERROR_NONE 프레임이 전송되었을 때. 프레임이 전송되었지만 ACK가 수신되지 않은 경우 OT_ERROR_NO_ACK: 채널에서의 활동으로 인해 전송할 수 없는 경우 OT_ERROR_CHANNEL_ACCESS_FAILURE 다른 이유로 전송이 취소된 경우 OT_ERROR_ABORT를 반환합니다.

함수

otLinkRawEnergyScan

otError otLinkRawEnergyScan(
  otInstance *aInstance,
  uint8_t aScanChannel,
  uint16_t aScanDuration,
  otLinkRawEnergyScanDone aCallback
)

무선 통신에서 에너지 스캔 시퀀스를 시작합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aScanChannel
에너지 스캔을 실행할 채널입니다.
[in] aScanDuration
채널을 스캔할 시간(밀리초)입니다.
[in] aCallback
스캔된 채널이 완료될 때 호출되는 함수에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
채널 검색이 시작되었습니다.
OT_ERROR_BUSY
무선 통신에서 에너지 스캔을 실행 중입니다.
OT_ERROR_NOT_IMPLEMENTED
무선 통신에서 에너지 스캔을 지원하지 않습니다.
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawGetCaps

otRadioCaps otLinkRawGetCaps(
  otInstance *aInstance
)

라디오 기능을 활용하세요.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
라디오 기능 비트 벡터입니다. 스택은 이 값에 따라 일부 함수를 사용 설정 또는 사용 중지합니다.

otLinkRawGetPromiscuous

bool otLinkRawGetPromiscuous(
  otInstance *aInstance
)

무차별 모드의 상태를 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값
true
무차별 모드가 사용 설정되었습니다.
false
무차별 모드가 사용 중지되었습니다.

otLinkRawGetRadioTime

uint64_t otLinkRawGetRadioTime(
  otInstance *aInstance
)

라디오 칩의 현재 플랫폼 시간 (64비트 너비)을 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
현재 라디오 시간(마이크로초)입니다.

otLinkRawGetRssi

int8_t otLinkRawGetRssi(
  otInstance *aInstance
)

최신 RSSI 측정값을 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
유효한 경우 RSSI(dBm) RSSI가 잘못된 경우 127입니다.

otLinkRawGetTransmitBuffer

otRadioFrame * otLinkRawGetTransmitBuffer(
  otInstance *aInstance
)

무선이 전송에서 수신으로 전환됩니다.

전송 버퍼에 대한 포인터를 반환합니다.

호출자는 이 버퍼에 IEEE 802.15.4 프레임을 형성한 다음 otLinkRawTransmit()을 호출하여 전송을 요청합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
전송 버퍼에 대한 포인터 또는 원시 링크 계층이 사용 설정되지 않은 경우 NULL.

otLinkRawIsEnabled

bool otLinkRawIsEnabled(
  otInstance *aInstance
)

원시 링크 레이어의 사용 여부를 나타냅니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값
true
원시 링크 레이어가 사용 설정됩니다.
false
원시 링크 레이어가 사용 중지됩니다.

otLinkRawReceive

otError otLinkRawReceive(
  otInstance *aInstance
)

라디오를 절전 모드에서 수신으로 전환합니다.

라디오를 켜 줘.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
수신으로 전환되었습니다.
OT_ERROR_INVALID_STATE
무선이 비활성화되었거나 전송 중입니다.

otLinkRawSetMacFrameCounter

otError otLinkRawSetMacFrameCounter(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

현재 MAC 프레임 카운터 값을 설정합니다.

MAC 카운터를 현재 값과 관계없이 항상 지정된 새 값 aMacFrameCounter로 설정합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aMacFrameCounter
MAC 프레임 카운터 값입니다.
반환 값
OT_ERROR_NONE
성공한 경우
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSetMacFrameCounterIfLarger

otError otLinkRawSetMacFrameCounterIfLarger(
  otInstance *aInstance,
  uint32_t aMacFrameCounter
)

새 값이 현재 값보다 큰 경우에만 현재 MAC 프레임 카운터 값을 설정합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aMacFrameCounter
MAC 프레임 카운터 값입니다.
반환 값
OT_ERROR_NONE
성공한 경우
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSetMacKey

otError otLinkRawSetMacKey(
  otInstance *aInstance,
  uint8_t aKeyIdMode,
  uint8_t aKeyId,
  const otMacKey *aPrevKey,
  const otMacKey *aCurrKey,
  const otMacKey *aNextKey
)

MAC 키와 키 색인을 업데이트합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aKeyIdMode
키 ID 모드입니다.
[in] aKeyId
키 색인입니다.
[in] aPrevKey
이전 MAC 키입니다.
[in] aCurrKey
현재 MAC 키입니다.
[in] aNextKey
다음 MAC 키입니다.
반환 값
OT_ERROR_NONE
성공한 경우
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSetPromiscuous

otError otLinkRawSetPromiscuous(
  otInstance *aInstance,
  bool aEnable
)

무차별 모드를 사용 설정하거나 사용 중지합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aEnable
무차별 모드를 사용 설정하거나 사용 중지하는 값입니다.
반환 값
OT_ERROR_NONE
성공한 경우
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSetReceiveDone

otError otLinkRawSetReceiveDone(
  otInstance *aInstance,
  otLinkRawReceiveDone aCallback
)

원시 링크 레이어를 사용 설정/사용 중지합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aCallback
IEEE 802.15.4 프레임 수신 시 호출된 함수에 대한 포인터입니다. 원시 링크 레이어를 사용 중지하는 NULL입니다.
반환 값
OT_ERROR_FAILED
라디오를 사용/사용 중지할 수 없습니다.
OT_ERROR_INVALID_STATE
OpenThread IPv6 인터페이스가 이미 사용 설정된 경우
OT_ERROR_NONE
사용 설정 상태가 성공적으로 설정된 경우입니다.

otLinkRawSetShortAddress

otError otLinkRawSetShortAddress(
  otInstance *aInstance,
  uint16_t aShortAddress
)

주소 필터링의 짧은 주소를 설정합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aShortAddress
IEEE 802.15.4 약식 주소
반환 값
OT_ERROR_NONE
성공한 경우
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSleep

otError otLinkRawSleep(
  otInstance *aInstance
)

라디오를 수신에서 절전으로 전환합니다.

라디오를 끄세요.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
절전 모드로 전환되었습니다.
OT_ERROR_BUSY
무선이 전송 중이었습니다.
OT_ERROR_INVALID_STATE
라디오가 사용 중지되었습니다.

otLinkRawSrcMatchAddExtEntry

otError otLinkRawSrcMatchAddExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

소스 데이터 이동 색인에 확장 주소를 추가합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aExtAddress
추가할 확장 주소입니다.
반환 값
OT_ERROR_NONE
소스 데이터 이동 색인에 확장 주소를 추가했습니다.
OT_ERROR_NO_BUFS
소스 데이터 이동 색인에 사용 가능한 항목이 없습니다.
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSrcMatchAddShortEntry

otError otLinkRawSrcMatchAddShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

소스 데이터 이동 색인에 짧은 주소 추가

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aShortAddress
추가할 짧은 주소입니다.
반환 값
OT_ERROR_NONE
소스 데이터 이동 색인에 짧은 주소를 추가했습니다.
OT_ERROR_NO_BUFS
소스 데이터 이동 색인에 사용 가능한 항목이 없습니다.
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSrcMatchClearExtEntries

otError otLinkRawSrcMatchClearExtEntries(
  otInstance *aInstance
)

소스 데이터 이동 색인에서 모든 확장 주소를 삭제합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
성공한 경우
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSrcMatchClearExtEntry

otError otLinkRawSrcMatchClearExtEntry(
  otInstance *aInstance,
  const otExtAddress *aExtAddress
)

라디오의 소스 데이터 이동 색인에서 확장된 주소를 삭제합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aExtAddress
삭제할 확장 주소입니다.
반환 값
OT_ERROR_NONE
소스 데이터 이동 색인에서 확장 주소를 삭제했습니다.
OT_ERROR_NO_ADDRESS
확장 주소가 원본 데이터 이동 색인에 없습니다.
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSrcMatchClearShortEntries

otError otLinkRawSrcMatchClearShortEntries(
  otInstance *aInstance
)

소스 데이터 이동 색인에서 짧은 주소를 모두 삭제합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
성공한 경우
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSrcMatchClearShortEntry

otError otLinkRawSrcMatchClearShortEntry(
  otInstance *aInstance,
  uint16_t aShortAddress
)

소스 데이터 이동 색인에서 짧은 주소를 삭제합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aShortAddress
삭제할 짧은 주소입니다.
반환 값
OT_ERROR_NONE
소스 데이터 이동 색인에서 짧은 주소를 삭제했습니다.
OT_ERROR_NO_ADDRESS
짧은 주소가 소스 데이터 이동 색인에 없습니다.
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawSrcMatchEnable

otError otLinkRawSrcMatchEnable(
  otInstance *aInstance,
  bool aEnable
)

대기 중인 프레임에 대한 소스 일치를 사용 설정/사용 중지합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aEnable
대기 중인 프레임에 대한 소스 일치를 사용 설정/사용 중지합니다.
반환 값
OT_ERROR_NONE
성공한 경우
OT_ERROR_INVALID_STATE
원시 링크 레이어가 사용 설정되지 않은 경우

otLinkRawTransmit

otError otLinkRawTransmit(
  otInstance *aInstance,
  otLinkRawTransmitDone aCallback
)

무선의 전송 시퀀스를 시작합니다.

호출자는 전송을 요청하기 전에 otLinkRawGetTransmitBuffer()에 의해 제공된 버퍼에 IEEE 802.15.4 프레임을 형성해야 합니다. 채널과 전송 전력도 otRadioFrame 구조에 포함됩니다.

전송 시퀀스는 다음으로 구성됩니다.

  1. 라디오를 수신에서 전송으로 전환합니다.
  2. 주어진 채널과 주어진 전송 전력에서 PSDU를 전송합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aCallback
전송 완료 시 호출되는 함수에 대한 포인터.
반환 값
OT_ERROR_NONE
전송으로 전환되었습니다.
OT_ERROR_INVALID_STATE
라디오가 수신 상태가 아니었습니다.

자료

OpenThread API 참조 주제는 GitHub에서 제공되는 소스 코드에서 비롯됩니다. 자세한 내용을 알아보거나 문서에 참여하려면 리소스를 참고하세요.