Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기
이 페이지는 Cloud Translation API를 통해 번역되었습니다.
Switch to English

채널 매니저

이 모듈에는 채널 관리자 기능이 포함되어 있습니다.

요약

이 모듈의 기능은 채널 관리자 기능 ( OPENTHREAD_CONFIG_CHANNEL_MANAGER_ENABLE )이 활성화 된 경우 사용할 수 있습니다. Channel Manager는 FTD 빌드에서만 사용할 수 있습니다.

기능

otChannelManagerGetAutoChannelSelectionEnabled ( otInstance *aInstance)
bool
이 기능은 자동 채널 선택 기능이 활성화되었는지 여부를 나타냅니다.
otChannelManagerGetAutoChannelSelectionInterval ( otInstance *aInstance)
uint32_t
이 함수는 자동 채널 선택 기능에 사용되는주기 간격 (초)을 가져옵니다.
otChannelManagerGetDelay ( otInstance *aInstance)
uint16_t
이 함수는 채널 변경에 대해 채널 관리자가 사용하는 지연 (초)을 가져옵니다.
otChannelManagerGetFavoredChannels ( otInstance *aInstance)
uint32_t
이 함수는 선호하는 채널 마스크를 가져옵니다.
otChannelManagerGetRequestedChannel ( otInstance *aInstance)
uint8_t
이 함수는 otChannelManagerRequestChannelChange() 대한 마지막 호출에서 채널을 가져옵니다.
otChannelManagerGetSupportedChannels ( otInstance *aInstance)
uint32_t
이 함수는 지원되는 채널 마스크를 가져옵니다.
otChannelManagerRequestChannelChange ( otInstance *aInstance, uint8_t aChannel)
void
이 함수는 스레드 네트워크 채널 변경을 요청합니다.
otChannelManagerRequestChannelSelect ( otInstance *aInstance, bool aSkipQualityCheck)
이 함수는 ChannelManager 가 새 채널을 확인 및 선택하고 채널 변경을 시작하도록 요청합니다.
otChannelManagerSetAutoChannelSelectionEnabled ( otInstance *aInstance, bool aEnabled)
void
이 기능은 자동 채널 선택 기능을 활성화 / 비활성화합니다.
otChannelManagerSetAutoChannelSelectionInterval ( otInstance *aInstance, uint32_t aInterval)
이 기능은 자동 채널 선택 기능에 사용되는주기 간격 (초)을 설정합니다.
otChannelManagerSetDelay ( otInstance *aInstance, uint16_t aDelay)
이 기능은 채널 변경에 사용되는 지연 (초)을 설정합니다.
otChannelManagerSetFavoredChannels ( otInstance *aInstance, uint32_t aChannelMask)
void
이 기능은 선호 채널 마스크를 설정합니다.
otChannelManagerSetSupportedChannels ( otInstance *aInstance, uint32_t aChannelMask)
void
이 기능은 지원되는 채널 마스크를 설정합니다.

기능

otChannelManagerGetAutoChannelSelectionEnabled

bool otChannelManagerGetAutoChannelSelectionEnabled(
  otInstance *aInstance
)

이 기능은 자동 채널 선택 기능이 활성화되었는지 여부를 나타냅니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
활성화 된 경우 TRUE, 비활성화 된 경우 FALSE.

otChannelManagerGetAutoChannelSelectionInterval

uint32_t otChannelManagerGetAutoChannelSelectionInterval(
  otInstance *aInstance
)

이 함수는 자동 채널 선택 기능에 사용되는주기 간격 (초)을 가져옵니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
간격 (초)입니다.

otChannelManagerGetDelay

uint16_t otChannelManagerGetDelay(
  otInstance *aInstance
)

이 함수는 채널 변경에 대해 채널 관리자가 사용하는 지연 (초)을 가져옵니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
채널 변경을위한 지연 (초)입니다.

otChannelManagerGetFavoredChannels

uint32_t otChannelManagerGetFavoredChannels(
  otInstance *aInstance
)

이 함수는 선호하는 채널 마스크를 가져옵니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
비트 마스크로 선호되는 채널입니다.

otChannelManagerGetRequestedChannel

uint8_t otChannelManagerGetRequestedChannel(
  otInstance *aInstance
)

이 함수는 otChannelManagerRequestChannelChange() 대한 마지막 호출에서 채널을 가져옵니다.

세부
보고
마지막으로 요청 된 채널이거나 아직 채널 변경 요청이없는 경우 0입니다.

otChannelManagerGetSupportedChannels

uint32_t otChannelManagerGetSupportedChannels(
  otInstance *aInstance
)

이 함수는 지원되는 채널 마스크를 가져옵니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
비트 마스크로 지원되는 채널.

otChannelManagerRequestChannelChange

void otChannelManagerRequestChannelChange(
  otInstance *aInstance,
  uint8_t aChannel
)

이 함수는 스레드 네트워크 채널 변경을 요청합니다.

네트워크는 지정된 지연 후에 주어진 채널로 전환합니다 ( otChannelManagerSetDelay () 참조). 채널 변경은 Pending Operational Dataset을 업데이트하여 수행됩니다.

이 함수에 대한 후속 호출은 진행중인 이전에 요청한 채널 변경을 취소합니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aChannel
Thread 네트워크의 새 채널입니다.

otChannelManagerRequestChannelSelect

otError otChannelManagerRequestChannelSelect(
  otInstance *aInstance,
  bool aSkipQualityCheck
)

이 함수는 ChannelManager 가 새 채널을 확인 및 선택하고 채널 변경을 시작하도록 요청합니다.

채널을 매개 변수로 지정해야하는 otChannelManagerRequestChannelChange()otChannelManagerRequestChannelChange() 함수는 ChannelManager 가 채널을 선택하도록 요청합니다 (수집 된 채널 품질 정보에 따라).

호출되면 채널 관리자는 다음 3 단계를 수행합니다.

1) ChannelManager 는 채널 변경이 도움이 될지 결정합니다. aSkipQualityCheck 가 true로 설정된 aSkipQualityCheck 검사를 건너 뛸 수 있습니다 (채널 선택을 강제 실행하고 품질 검사 건너 뛰기). 이 단계에서는 장치에서 수집 된 링크 품질 메트릭 (예 : CCA 실패율, 인접 항목 당 프레임 및 메시지 오류율 등)을 사용하여 현재 채널 품질이 채널 변경을 정당화하는 수준인지 확인합니다.

2) 첫 번째 단계가 통과되면 ChannelManager 는 잠재적으로 더 나은 채널을 선택합니다. ChannelMonitor 모듈에서 수집 한 채널 품질 데이터를 사용합니다. 이 단계에서는 지원되고 선호되는 채널이 사용됩니다. ( otChannelManagerSetSupportedChannels ()otChannelManagerSetFavoredChannels () 참조 ).

3) 새로 선택한 채널이 현재 채널과 다른 경우 ChannelManager 는 채널 변경 프로세스를 요청 / 시작합니다 (내부적으로 RequestChannelChange() 호출).

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aSkipQualityCheck
품질 검사 (1 단계)를 건너 뛸지 여부를 나타냅니다.
반환 값
OT_ERROR_NONE
채널 선택이 성공적으로 완료되었습니다.
OT_ERROR_NOT_FOUND
지원되는 채널 마스크가 비어있어서 채널을 선택할 수 없습니다.

otChannelManagerSetAutoChannelSelectionEnabled

void otChannelManagerSetAutoChannelSelectionEnabled(
  otInstance *aInstance,
  bool aEnabled
)

이 기능은 자동 채널 선택 기능을 활성화 / 비활성화합니다.

활성화되면 ChannelManager 는 주기적으로 RequestChannelSelect(false) 호출합니다. 주기 간격은 SetAutoChannelSelectionInterval() 으로 설정할 수 있습니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aEnabled
이 기능을 활성화 또는 비활성화할지 여부를 나타냅니다.

otChannelManagerSetAutoChannelSelectionInterval

otError otChannelManagerSetAutoChannelSelectionInterval(
  otInstance *aInstance,
  uint32_t aInterval
)

이 기능은 자동 채널 선택 기능에 사용되는주기 간격 (초)을 설정합니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aInterval
간격 (초)입니다.
반환 값
OT_ERROR_NONE
간격이 성공적으로 설정되었습니다.
OT_ERROR_INVALID_ARGS
aInterval 이 유효하지 않습니다 (0).

otChannelManagerSetDelay

otError otChannelManagerSetDelay(
  otInstance *aInstance,
  uint16_t aDelay
)

이 기능은 채널 변경에 사용되는 지연 (초)을 설정합니다.

지연은 스레드 네트워크 내의 모든 슬리피 엔드 장치가 사용하는 최대 데이터 폴링 간격보다 길어야합니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aDelay
초 단위로 지연됩니다.
반환 값
OT_ERROR_NONE
지연이 성공적으로 업데이트되었습니다.
OT_ERROR_INVALID_ARGS
주어진 지연 aDelay 가 너무 짧습니다.

otChannelManagerSetFavoredChannels

void otChannelManagerSetFavoredChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

이 기능은 선호 채널 마스크를 설정합니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aChannelMask
채널 마스크.

otChannelManagerSetSupportedChannels

void otChannelManagerSetSupportedChannels(
  otInstance *aInstance,
  uint32_t aChannelMask
)

이 기능은 지원되는 채널 마스크를 설정합니다.

세부
매개 변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aChannelMask
채널 마스크.