잼 감지

이 모듈에는 신호 전파 감지 기능을 위한 기능이 포함되어 있습니다.

요약

이 모듈의 기능은 혼잡 감지 기능 (OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE)이 사용 설정된 경우 사용할 수 있습니다.

Typedef

otJamDetectionCallback)(bool aJamState, void *aContext) typedef
void(*
신호 걸림 감지가 사용 설정되어 있고 걸림이 감지되면 포인터가 호출됩니다.

함수

otJamDetectionGetBusyPeriod(otInstance *aInstance)
uint8_t
잼 감지 바쁨 기간 가져오기 (초)
otJamDetectionGetHistoryBitmap(otInstance *aInstance)
uint64_t
현재 기록 비트맵을 가져옵니다.
otJamDetectionGetRssiThreshold(otInstance *aInstance)
int8_t
잼 감지 RSSI 임계값 (dBm 단위)을 가져옵니다.
otJamDetectionGetState(otInstance *aInstance)
bool
잼 감지 상태를 가져옵니다.
otJamDetectionGetWindow(otInstance *aInstance)
uint8_t
혼잡 감지 창 (초)을 가져옵니다.
otJamDetectionIsEnabled(otInstance *aInstance)
bool
잼 감지 상태 가져오기 (사용/사용 중지)
otJamDetectionSetBusyPeriod(otInstance *aInstance, uint8_t aBusyPeriod)
잼 감지 바쁨 기간 (초)을 설정합니다.
otJamDetectionSetRssiThreshold(otInstance *aInstance, int8_t aRssiThreshold)
잼 감지 RSSI 임계값 (dBm 단위)을 설정합니다.
otJamDetectionSetWindow(otInstance *aInstance, uint8_t aWindow)
잼 감지 기간을 초 단위로 설정합니다.
otJamDetectionStart(otInstance *aInstance, otJamDetectionCallback aCallback, void *aContext)
전파 방해 감지를 시작합니다.
otJamDetectionStop(otInstance *aInstance)
방해금지 감지를 중지합니다.

Typedef

otJamDetectionCallback

void(* otJamDetectionCallback)(bool aJamState, void *aContext)

신호 걸림 감지가 사용 설정되어 있고 걸림이 감지되면 포인터가 호출됩니다.

세부정보
매개변수
[in] aJamState
현재 걸림 상태 (걸림이 감지되면 true, 그렇지 않은 경우 false)
[in] aContext
애플리케이션별 컨텍스트에 대한 포인터입니다.

함수

otJamDetectionGetBusyPeriod

uint8_t otJamDetectionGetBusyPeriod(
  otInstance *aInstance
)

잼 감지 바쁨 기간 가져오기 (초)

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
잼 감지 바쁨 기간

otJamDetectionGetHistoryBitmap

uint64_t otJamDetectionGetHistoryBitmap(
  otInstance *aInstance
)

현재 기록 비트맵을 가져옵니다.

이 값은 모니터링/디버깅 목적으로 전파 방해가 감지되는 모듈의 현재 상태에 관한 정보를 제공합니다. 이 메서드는 64비트 값을 반환합니다. 여기서 각 비트는 가장 최근 간격의 경우 비트 0에서, 가장 오래된 간격 (63초 이전)의 경우 비트 63부터 시작하여 1초 간격에 해당합니다. 전파 방해 감지 모듈이 상응하는 1초 간격 동안 높은 신호 수준을 관찰/감지한 경우 비트가 1로 설정됩니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
현재 기록 비트맵입니다.

otJamDetectionGetRssiThreshold

int8_t otJamDetectionGetRssiThreshold(
  otInstance *aInstance
)

잼 감지 RSSI 임계값 (dBm 단위)을 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
잼 감지 RSSI 기준점입니다.

otJamDetectionGetState

bool otJamDetectionGetState(
  otInstance *aInstance
)

잼 감지 상태를 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
잼 감지 상태입니다 (true 잼이 감지되고 그렇지 않은 경우 'false').

otJamDetectionGetWindow

uint8_t otJamDetectionGetWindow(
  otInstance *aInstance
)

혼잡 감지 창 (초)을 가져옵니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
잼 감지 창

otJamDetectionIsEnabled

bool otJamDetectionIsEnabled(
  otInstance *aInstance
)

잼 감지 상태 가져오기 (사용/사용 중지)

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환
잼 감지 상태입니다 (사용 설정된 경우 true, 그렇지 않은 경우 false).

otJamDetectionSetBusyPeriod

otError otJamDetectionSetBusyPeriod(
  otInstance *aInstance,
  uint8_t aBusyPeriod
)

잼 감지 바쁨 기간 (초)을 설정합니다.

감지를 트리거하려면 RSSI가 기준점을 초과해야 하는 감지 기간 내 집계 시간(초)입니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aBusyPeriod
잼 감지 혼잡 기간 (0이 아니고 Jam 감지 기간 이하여야 함)
반환 값
OT_ERROR_NONE
창을 설정했습니다.
OT_ERROR_INVALID_ARGS
입력한 내용이 유효한 범위 내에 있지 않습니다.

otJamDetectionSetRssiThreshold

otError otJamDetectionSetRssiThreshold(
  otInstance *aInstance,
  int8_t aRssiThreshold
)

잼 감지 RSSI 임계값 (dBm 단위)을 설정합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aRssiThreshold
RSSI 기준점입니다.
반환 값
OT_ERROR_NONE
기준점을 설정했습니다.

otJamDetectionSetWindow

otError otJamDetectionSetWindow(
  otInstance *aInstance,
  uint8_t aWindow
)

잼 감지 기간을 초 단위로 설정합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aWindow
체증 감지 창 (유효 범위는 1~63)
반환 값
OT_ERROR_NONE
창을 설정했습니다.
OT_ERROR_INVALID_ARGS
지정된 입력 매개변수가 유효한 범위 (1~63) 내에 있지 않습니다.

otJamDetectionStart

otError otJamDetectionStart(
  otInstance *aInstance,
  otJamDetectionCallback aCallback,
  void *aContext
)

전파 방해 감지를 시작합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
[in] aCallback
전파 상태 변경을 알리기 위해 호출되는 함수에 대한 포인터입니다.
[in] aContext
애플리케이션별 컨텍스트에 대한 포인터입니다.
반환 값
OT_ERROR_NONE
전파 방해가 감지되었습니다.
OT_ERROR_ALREADY
이전에 잼 감지가 시작되었습니다.

otJamDetectionStop

otError otJamDetectionStop(
  otInstance *aInstance
)

방해금지 감지를 중지합니다.

세부정보
매개변수
[in] aInstance
OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값
OT_ERROR_NONE
전파 방해가 감지되었습니다.
OT_ERROR_ALREADY
잼 감지가 이미 중지되었습니다.

자료

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