원시 링크

이 모듈에는 원시 링크 계층 구성을 제어하는 기능이 포함되어 있습니다.

요약

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)`	`otError` 이 방법은 라디오에서 에너지 스캔 시퀀스를 시작합니다.
`otLinkRawGetCaps ( otInstance *aInstance)`	`otRadioCaps` 라디오 기능을 얻으십시오.
`otLinkRawGetPromiscuous ( otInstance *aInstance)`	`bool` 이 함수는 무차별 모드의 상태를 가져옵니다.
`otLinkRawGetRadioTime ( otInstance *aInstance)`	`uint64_t` 라디오 칩의 현재 플랫폼 시간 (64 비트 너비)을 가져옵니다.
`otLinkRawGetRssi ( otInstance *aInstance)`	`int8_t` 최신 RSSI 측정 값을 가져옵니다.
`otLinkRawGetTransmitBuffer ( otInstance *aInstance)`	`otRadioFrame *` 라디오가 전송에서 수신으로 전환됩니다.
`otLinkRawIsEnabled ( otInstance *aInstance)`	`bool` 이 함수는 원시 링크 계층이 활성화되었는지 여부를 나타냅니다.
`otLinkRawReceive ( otInstance *aInstance)`	`otError` 라디오를 절전에서 수신으로 전환합니다.
`otLinkRawSetMacFrameCounter ( otInstance *aInstance, uint32_t aMacFrameCounter)`	`otError` 현재 MAC 프레임 카운터 값을 설정합니다.
`otLinkRawSetMacKey ( otInstance aInstance, uint8_t aKeyIdMode, uint8_t aKeyId, const otMacKey aPrevKey, const otMacKey aCurrKey, const otMacKey aNextKey)`	`otError` MAC 키 및 키 색인을 업데이트합니다.
`otLinkRawSetPromiscuous ( otInstance *aInstance, bool aEnable)`	`otError` 이 기능은 무차별 모드를 활성화 또는 비활성화합니다.
`otLinkRawSetReceiveDone ( otInstance *aInstance, otLinkRawReceiveDone aCallback)`	`otError` 이 기능은 원시 링크 계층을 활성화 / 비활성화합니다.
`otLinkRawSetShortAddress ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` 주소 필터링을위한 단축 주소를 설정합니다.
`otLinkRawSleep ( otInstance *aInstance)`	`otError` 라디오를 수신에서 절전으로 전환합니다.
`otLinkRawSrcMatchAddExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` 소스 데이터 이동 색인에 확장 주소를 추가합니다.
`otLinkRawSrcMatchAddShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` 소스 데이터 이동 색인에 짧은 주소를 추가합니다.
`otLinkRawSrcMatchClearExtEntries ( otInstance *aInstance)`	`otError` 소스 데이터 이동 색인에서 모든 확장 주소를 제거합니다.
`otLinkRawSrcMatchClearExtEntry ( otInstance aInstance, const otExtAddress aExtAddress)`	`otError` 라디오의 소스 일치 테이블에 대한 확장 주소를 제거합니다.
`otLinkRawSrcMatchClearShortEntries ( otInstance *aInstance)`	`otError` 소스 데이터 이동 색인에서 모든 짧은 주소를 제거합니다.
`otLinkRawSrcMatchClearShortEntry ( otInstance *aInstance, uint16_t aShortAddress)`	`otError` 소스 데이터 이동 색인에 대한 짧은 주소를 제거합니다.
`otLinkRawSrcMatchEnable ( otInstance *aInstance, bool aEnable)`	`otError` 프레임 보류에 대한 소스 일치를 활성화 / 비활성화합니다.
`otLinkRawTransmit ( otInstance *aInstance, otLinkRawTransmitDone aCallback)`	`otError` 이 방법은 라디오에서 전송 시퀀스를 시작합니다.

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_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_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 인스턴스에 대한 포인터입니다.

보고

유효한 경우 dBm 단위의 RSSI입니다. 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 프레임 카운터 값을 설정합니다.

세부

매개 변수

`[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 Ip6 인터페이스가 이미 활성화 된 경우.
`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 구조에 포함됩니다.

전송 순서는 다음으로 구성됩니다.

라디오를 수신에서 전송으로 전환합니다.
지정된 채널과 지정된 전송 전력에서 PSDU를 전송합니다.

세부

매개 변수

`[in] aInstance`	OpenThread 인스턴스에 대한 포인터입니다.
`[in] aCallback`	전송 완료시 호출되는 함수에 대한 포인터입니다.

반환 값

`OT_ERROR_NONE`	Transmit으로 성공적으로 전환되었습니다.
`OT_ERROR_INVALID_STATE`	라디오가 수신 상태가 아닙니다.