잼 감지

GitHub에서 소스 보기

OpenThread 노드에서 신호 감쇠 감지를 위한 구성 가능한 메커니즘을 제공하려면 Jam 감지 기능을 사용 설정합니다.

이 기능은 특정 채널에서 신호 잡음을 감지하는 기능이 필요한 기기 인증에 유용합니다. 각 인증 유형의 요구사항을 충족하도록 구성할 수 있습니다.

작동 방식

Jam 감지는 지정된 기간 동안 노드의 RSSI (수신 신호 강도 표시기)를 모니터링하여 채널이 막혔는지 확인합니다.

Jam 감지가 사용 설정된 경우:

  1. Jam 감지 상태가 false로 설정되어 있습니다.
  2. 노드는 1초 간격으로 RSSI를 여러 번 샘플링합니다.
  3. 1초의 전체 RSSI가 모든 샘플에 대해 구성된 RSSI 임곗값보다 높게 유지되는 경우, 1초 간격으로 간격이 차단된 것으로 간주됩니다.
  4. 1초 간격의 총합이 특정 시점에 이전의 구성된 감지 기간초 내에 구성된 사용 중 기간초의 집계 수 이상 같은 경우 해당 시점의 Jam 감지 상태는 true로 설정됩니다.
  5. 1초 간격의 총 집계 수가 특정 시점에 앞서 구성된 감지 기간초 내에 구성된 사용 중 기간초의 집계 횟수보다 작은 경우 해당 시점의 Jam 감지 상태는 false로 설정됩니다.

기록 비트맵

OpenThread APIwpantund 속성에서는 이전 63초의 비트맵을 가져올 수 있습니다. 이 비트맵은 RSSI가 각각 이전 63초에 구성된 RSSI 임계값을 초과했는지를 나타냅니다.

예를 들어 다음 비트맵을 검색할 수 있습니다.

0xC248068C416E7FF0

바이너리로 변환하면 RSSI가 이전 63초 동안 구성된 RSSI 임곗값을 초과하는 모든 인스턴스가 생성됩니다.

11000010 01001000 00000110 10001100 01000001 01101110 01111111 11110000

감지 기간이 16초로 설정되어 있고 사용량이 많은 기간이 8초로 설정된 경우 이전 16초 동안 RSSI 임계값이 8초 이상 초과된 첫 번째 인스턴스인 Jam 감지 상태는 51초로 true가 됩니다. 이 예에서 Jam 감지 상태는 다음 13초 동안 true로 유지됩니다.

11000010 01001000 00000110 10001100 01000001 01101110 01111111 11110000
                                      [00001 01101110 011] = 8 in 16

-45dBm이 구성된 RSSI 임곗값인 경우 이 비트맵은 다음 그래프로 표시될 수 있습니다.

OT 잼 감지

사용 설정 방법

이 기능은 기본적으로 사용 중지되어 있습니다.

정의

Jam 감지를 사용 설정하려면 OpenThread를 빌드하기 전에 openthread/src/core/config/openthread-core-default-config.h 파일에서 OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE1로 정의합니다.

#ifndef OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE
#define OPENTHREAD_CONFIG_JAM_DETECTION_ENABLE 1
#endif

옵션별

또는 OpenThread를 빌드할 때 -DOT_JAM_DETECTION=ON 빌드 옵션을 사용합니다.

./script/build -DOT_JAM_DETECTION=ON

매개변수

Jam Detection 매개변수는 OpenThread API, Spinel 프로토콜 또는 네트워크 공동 프로세서 (NCP) 관리용 wpantund 명령줄 도구인 wpanctl를 통해서만 구성할 수 있습니다. 후속 구성 없이 기능이 사용 설정된 경우 기본값이 적용됩니다.

다음 매개변수를 사용하여 이 기능을 맞춤설정합니다.

매개변수
RSSI 기준
기본값
0 dBm
설명
채널이 막힌 것으로 간주할 기준점 RSSI 수준을 dBm 단위로 지정합니다.
감지 창
기본값
63초
설명
신호 감쇠 여부를 확인할 시간(초)을 지정합니다. 범위는 1~63입니다.
바쁨 기간
기본값
63초
설명
Jam을 트리거하려면 감지 기간 내에 RSSI 임계값이 RSSI 임계값 이상이어야 하는 총 시간(초)을 지정합니다. 감지 기간보다 작아야 합니다. 범위는 1~63입니다.

API

OpenThread

Jam Detection API를 사용하여 OpenThread 애플리케이션에서 직접 Jam 감지 기능을 관리할 수 있습니다. OpenThread API는 다음과 같은 기능을 제공합니다.

  • 기능 시작 및 중지하기
  • Jam 감지 상태 보기
  • 모든 매개변수 관리
  • 현재 Jam 감지 기록 비트맵 검색
  • 잼이 감지되면 콜백 함수를 등록합니다.

스피넬

Spinel 프로토콜을 사용하면 호스트 기기가 NCP와 직접 통신할 수 있습니다. 이 프로토콜은 openthread/src/lib/spinel/spinel.h에서 다음 기능을 제공하는 Jam 감지 속성을 노출합니다.

  • 기능 시작 및 중지하기
  • Jam 감지 상태 보기
  • 모든 매개변수 관리
  • 현재 Jam 감지 기록 비트맵 검색

CLI

OpenThread

이 기능과 관련된 OpenThread CLI 명령어가 없습니다.

완판트

wpanctl CLI를 사용하여 OpenThread NCP 구성의 Jam 감지 기능을 관리합니다. wpantund는 NCP 재설정 시 모든 Jam 감지 구성을 유지합니다.

wpanctl는 다음 wpantund 속성에 대한 액세스를 제공합니다.

속성
JamDetection:Status
형식
boolean
설명
읽기 전용입니다. Jam 감지 상태. 현재 신호 차단이 감지되었는지를 나타냅니다.
JamDetection:Enable
형식
boolean
설명
Jam 감지 기능을 사용 설정 또는 중지합니다.
JamDetection:RssiThreshold
형식
dBm
설명
채널이 차단된 것으로 간주할 기준점 RSSI 수준을 dBm 단위로 지정합니다.
JamDetection:Window
형식
설명
신호 감쇠 여부를 확인할 시간(초)을 지정합니다. 범위는 1~63입니다.
JamDetection:BusyPeriod
형식
설명
Jam 감지를 트리거하려면 JamDetection:Window 내에서 RSSI가 JamDetection:RssiThreshold보다 커야 하는 총 시간(초)을 지정합니다. JamDetection:Window보다 작아야 합니다. 범위는 1~63입니다.
JamDetection:Debug:HistoryBitmap
형식
64비트 값
설명
모니터링 및 디버깅 목적으로 Jam 감지 상태 기록에 관한 정보를 제공합니다.

예를 들어 NCP의 Jam Detection State를 가져오는 방법은 다음과 같습니다.

sudo wpanctl getprop JamDetection:Status
JamDetection:Status = false

NCP에서 Jam 감지 RSSI 임계값을 -45dBm으로 설정하려면 다음 단계를 따르세요.

sudo wpanctl setprop JamDetection:RssiThreshold -45
sudo wpanctl getprop JamDetection:RssiThreshold
JamDetection:RssiThreshold = -45

wpantund 속성에 관한 자세한 내용은 wpantund GitHub 저장소를 참고하세요.