Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

OpenThread API로 개발

1. 소개

26b7f4f6b3ea0700.png

Nest에서 출시한 OpenThreadThread® 네트워킹 프로토콜의 오픈소스 구현입니다. Nest는 커넥티드 홈을 위한 제품 개발을 가속화하기 위해 Nest 제품에 사용되는 기술을 개발자들에게 널리 제공하기 위해 OpenThread를 출시했습니다.

스레드 사양은 홈 애플리케이션을 위한 IPv6 기반의 안정적이고 안전한 저전력 무선 기기 간 통신 프로토콜을 정의합니다. OpenThread는 MAC 보안, 메시 링크 확립, 메시 라우팅을 통해 IPv6, 6LoWPAN, IEEE 802.15.4 등의 모든 스레드 네트워킹 계층을 구현합니다.

이 Codelab에서는 OpenThread API를 사용하여 스레드 네트워크를 시작하고 기기 역할의 변경사항을 모니터링 및 대응하며 UDP 메시지를 전송하며 이러한 작업을 실제 하드웨어의 버튼 및 LED에 연결합니다.

2a6db2e258c32237.png

실습 내용

  • Nordic nRF52840 개발자 보드의 버튼 및 LED를 프로그래밍하는 방법
  • 일반적인 OpenThread API 및 otInstance 클래스를 사용하는 방법
  • OpenThread 상태 변경을 모니터링하고 이에 대응하는 방법
  • 스레드 네트워크의 모든 기기에 UDP 메시지를 보내는 방법
  • Makefile 수정 방법

준비물

하드웨어

  • Nordic Semiconductor nRF52840 개발 보드 3개
  • 보드 연결용 USB-마이크로 USB 케이블 3개
  • USB 포트가 3개 이상인 Linux 머신

소프트웨어:

  • GNU 도구 모음
  • Nordic nRF5x 명령줄 도구
  • Seger J-Link 소프트웨어
  • OpenThread
  • Git

달리 명시되지 않는 한 이 Codelab의 콘텐츠는크리에이티브 커먼즈 저작자 표시 3.0 라이선스, 코드 샘플은Apache 2.0 라이선스에서 확인할 수 있습니다.

2 시작하기

하드웨어 Codelab 완료

이 Codelab을 시작하기 전에 다음과 같은 nRF52840 보드 및 OpenThread가 포함된 스레드 네트워크 빌드 Codelab을 완료해야 합니다.

  • 빌드 및 플래시에 필요한 모든 소프트웨어 세부정보
  • OpenThread를 빌드하고 Nordic nRF52840 보드에서 플래시하는 방법을 알아봅니다.
  • 스레드 네트워크의 기본사항을 보여줍니다.

OpenThread를 빌드하고 보드를 플래시하는 데 필요한 환경은 이 Codelab에 자세히 설명되어 있지 않습니다. 보드 플래시에 관한 기본 안내만 있습니다. 이미 스레드 스레드 네트워크 Codelab을 완료했다고 가정합니다.

Linux 머신

이 Codelab은 i386 또는 x86 기반 Linux 시스템을 사용하여 모든 스레드 개발 보드를 플래시하도록 설계되었습니다. 모든 단계는 Ubuntu 14.04.5 LTS (Trusty Tahr)에서 테스트되었습니다.

Nordic Semiconductor nRF52840 보드

이 Codelab은 세 개의 nRF52840 PDK 보드를 사용합니다.

A6693da3ce213856.png

소프트웨어 설치

OpenThread를 빌드하고 플래시하려면 SEGGER J-Link, nRF5x 명령줄 도구, ARM GNU 도구 체인 및 다양한 Linux 패키지를 설치해야 합니다. 필요에 따라 '스레드 네트워크 Codelab 빌드'를 완료했다면 필요한 모든 항목을 이미 설치했을 것입니다. 그렇지 않은 경우 이 Codelab을 완료하여 OpenThread를 빌드하고 nRF52840 개발 보드에 플래시할 수 있는지 확인하세요.

3. 저장소 복제

OpenThread에는 이 Codelab의 시작점으로 사용할 수 있는 애플리케이션 코드 예가 함께 제공됩니다.

OpenThread Nordic nRF528xx 예시 저장소를 클론하고 OpenThread를 빌드합니다.

$ git clone --recursive https://github.com/openthread/ot-nrf528xx
$ cd ot-nrf528xx
$ ./script/bootstrap

4. OpenThread API 기본사항

OpenThread의 공개 API는 OpenThread 저장소의 ./openthread/include/openthread에 있습니다. 이러한 API는 애플리케이션에서 사용할 수 있도록 스레드 수준 및 플랫폼 수준 모두에서 다양한 OpenThread 기능에 액세스할 수 있습니다.

  • OpenThread 인스턴스 정보 및 제어
  • IPv6, UDP, CoAP와 같은 애플리케이션 서비스
  • 네트워크 사용자 인증 정보 관리(커커스 및 연결자 역할 포함)
  • 경계 라우터 관리
  • 자녀 감독 및 Jam 감지와 같은 고급 기능

모든 OpenThread API에 대한 참조 정보는 openthread.io/reference를 참조하세요.

API 사용

API를 사용하려면 헤더 파일을 애플리케이션 파일 중 하나에 포함하세요. 그런 다음 원하는 함수를 호출합니다.

예를 들어 OpenThread에 포함된 CLI 예시 앱은 다음 API 헤더를 사용합니다.

./openthread/examples/apps/cli/main.c

#include <openthread/config.h>
#include <openthread/cli.h>
#include <openthread/diag.h>
#include <openthread/tasklet.h>
#include <openthread/platform/logging.h>

OpenThread 인스턴스

otInstance 구조는 OpenThread API 작업 시 자주 사용하게 되는 요소입니다. 초기화되면 이 구조는 OpenThread 라이브러리의 정적 인스턴스를 나타내며 사용자가 OpenThread API를 호출할 수 있도록 허용합니다.

예를 들어 OpenThread 인스턴스는 CLI 예시 앱의 main() 함수에서 초기화됩니다.

./openthread/examples/apps/cli/main.c

int main(int argc, char *argv[])
{
    otInstance *instance

...

#if OPENTHREAD_ENABLE_MULTIPLE_INSTANCES
    // Call to query the buffer size
    (void)otInstanceInit(NULL, &otInstanceBufferLength);

    // Call to allocate the buffer
    otInstanceBuffer = (uint8_t *)malloc(otInstanceBufferLength);
    assert(otInstanceBuffer);

    // Initialize OpenThread with the buffer
    instance = otInstanceInit(otInstanceBuffer, &otInstanceBufferLength);
#else
    instance = otInstanceInitSingle();
#endif

...

    return 0;
}

플랫폼별 함수

OpenThread에 포함된 예시 애플리케이션 중 하나에 플랫폼별 함수를 추가하려면 모든 함수에 otSys 네임스페이스를 사용하여 ./openthread/examples/platforms/openthread-system.h 헤더에서 먼저 선언합니다. 그런 다음 플랫폼별 소스 파일에 구현합니다. 이렇게 추상화하면 다른 예시 플랫폼에도 동일한 함수 헤더를 사용할 수 있습니다.

예를 들어 nRF52840 버튼과 LED에 연결하는 데 사용할 GPIO 함수는 openthread-system.h에 선언되어야 합니다.

원하는 텍스트 편집기에서 ./openthread/examples/platforms/openthread-system.h 파일을 엽니다.

./openthread/examples/platforms/openthread-system.h

작업: 플랫폼별 GPIO 함수 선언을 추가합니다.

openthread/instance.h 헤더의 #include 뒤에 다음 함수 선언을 추가합니다.

/**
 * Init LED module.
 *
 */
void otSysLedInit(void);
void otSysLedSet(uint8_t aLed, bool aOn);
void otSysLedToggle(uint8_t aLed);

/**
* A callback will be called when GPIO interrupts occur.
*
*/
typedef void (*otSysButtonCallback)(otInstance *aInstance);
void otSysButtonInit(otSysButtonCallback aCallback);
void otSysButtonProcess(otInstance *aInstance);

다음 단계에서 이를 구현합니다.

otSysButtonProcess 함수 선언은 otInstance을 사용합니다. 이렇게 하면 필요한 경우 애플리케이션이 버튼을 누를 때 OpenThread 인스턴스에 대한 정보에 액세스할 수 있습니다. 이는 애플리케이션의 필요에 따라 다릅니다. 함수를 구현할 때 필요하지 않으면 OpenThread API의 OT_UNUSED_VARIABLE 매크로를 사용하여 일부 도구 모음의 사용되지 않는 변수에 대한 빌드 오류를 숨길 수 있습니다. 이에 대한 예는 나중에 살펴보겠습니다.

5 GPIO 플랫폼 추상화 구현

이전 단계에서는 ./openthread/examples/platforms/openthread-system.h에서 GPIO에 사용할 수 있는 플랫폼별 함수 선언을 살펴봤습니다. nRF52840 개발 보드의 버튼 및 LED에 액세스하려면 nRF52840 플랫폼에서 이러한 기능을 구현해야 합니다. 이 코드에서는 다음과 같은 함수를 추가합니다.

  • GPIO 핀 및 모드 초기화
  • 핀의 전압 제어
  • GPIO 인터럽트 사용 설정 및 콜백 등록

./src/src 디렉터리에 gpio.c이라는 새 파일을 만듭니다. 이 새 파일에서 다음 콘텐츠를 추가합니다.

./src/src/gpio.c (새 파일)

작업: 정의가 추가됩니다.

이는 OpenThread 애플리케이션 수준에서 사용되는 nRF52840 특정 값 및 변수 사이의 추상화 역할을 합니다.

/**
 * @file
 *   This file implements the system abstraction for GPIO and GPIOTE.
 *
 */

#define BUTTON_GPIO_PORT 0x50000300UL
#define BUTTON_PIN 11 // button #1

#define GPIO_LOGIC_HI 0
#define GPIO_LOGIC_LOW 1

#define LED_GPIO_PORT 0x50000300UL
#define LED_1_PIN 13 // turn on to indicate leader role
#define LED_2_PIN 14 // turn on to indicate router role
#define LED_3_PIN 15 // turn on to indicate child role
#define LED_4_PIN 16 // turn on to indicate UDP receive

nRF52840 버튼 및 LED에 대한 자세한 내용은 Nordic Semiconductor 정보 센터를 참조하세요.

작업: '헤더 포함'을 추가합니다.

그런 다음 GPIO 기능에 필요한 헤더 포함을 추가합니다.

/* Header for the functions defined here */
#include "openthread-system.h"

#include <string.h>

/* Header to access an OpenThread instance */
#include <openthread/instance.h>

/* Headers for lower-level nRF52840 functions */
#include "platform-nrf5.h"
#include "hal/nrf_gpio.h"
#include "hal/nrf_gpiote.h"
#include "nrfx/drivers/include/nrfx_gpiote.h"

작업: 버튼 1의 콜백 및 인터럽트 함수를 추가합니다.

다음으로 이 코드를 추가합니다. in_pin1_handler 함수는 버튼 누르기 기능이 초기화될 때 등록되는 콜백입니다 (이 파일의 뒷부분).

이 콜백은 OT_UNUSED_VARIABLE 매크로를 사용합니다. in_pin1_handler에 전달된 변수가 실제로 함수에서 사용되지 않기 때문입니다.

/* Declaring callback function for button 1. */
static otSysButtonCallback sButtonHandler;
static bool                sButtonPressed;

/**
 * @brief Function to receive interrupt and call back function
 * set by the application for button 1.
 *
 */
static void in_pin1_handler(uint32_t pin, nrf_gpiote_polarity_t action)
{
    OT_UNUSED_VARIABLE(pin);
    OT_UNUSED_VARIABLE(action);
    sButtonPressed = true;
}

작업: LED를 구성하는 함수를 추가합니다.

이 코드를 추가하여 초기화 중에 모든 LED의 모드와 상태를 구성합니다.

/**
 * @brief Function for configuring: PIN_IN pin for input, PIN_OUT pin for output,
 * and configures GPIOTE to give an interrupt on pin change.
 */

void otSysLedInit(void)
{
    /* Configure GPIO mode: output */
    nrf_gpio_cfg_output(LED_1_PIN);
    nrf_gpio_cfg_output(LED_2_PIN);
    nrf_gpio_cfg_output(LED_3_PIN);
    nrf_gpio_cfg_output(LED_4_PIN);

    /* Clear all output first */
    nrf_gpio_pin_write(LED_1_PIN, GPIO_LOGIC_LOW);
    nrf_gpio_pin_write(LED_2_PIN, GPIO_LOGIC_LOW);
    nrf_gpio_pin_write(LED_3_PIN, GPIO_LOGIC_LOW);
    nrf_gpio_pin_write(LED_4_PIN, GPIO_LOGIC_LOW);

    /* Initialize gpiote for button(s) input.
     Button event handlers are set in the application (main.c) */
    ret_code_t err_code;
    err_code = nrfx_gpiote_init();
    APP_ERROR_CHECK(err_code);
}

작업: LED 모드를 설정하는 함수를 추가합니다.

이 기능은 기기 역할이 변경될 때 사용됩니다.

/**
 * @brief Function to set the mode of an LED.
 */

void otSysLedSet(uint8_t aLed, bool aOn)
{
    switch (aLed)
    {
    case 1:
        nrf_gpio_pin_write(LED_1_PIN, (aOn == GPIO_LOGIC_HI));
        break;
    case 2:
        nrf_gpio_pin_write(LED_2_PIN, (aOn == GPIO_LOGIC_HI));
        break;
    case 3:
        nrf_gpio_pin_write(LED_3_PIN, (aOn == GPIO_LOGIC_HI));
        break;
    case 4:
        nrf_gpio_pin_write(LED_4_PIN, (aOn == GPIO_LOGIC_HI));
        break;
    }
}

작업: LED의 모드를 전환하는 함수를 추가합니다.

이 함수는 기기가 멀티캐스트 UDP 메시지를 수신할 때 LED4를 전환하는 데 사용됩니다.

/**
 * @brief Function to toggle the mode of an LED.
 */
void otSysLedToggle(uint8_t aLed)
{
    switch (aLed)
    {
    case 1:
        nrf_gpio_pin_toggle(LED_1_PIN);
        break;
    case 2:
        nrf_gpio_pin_toggle(LED_2_PIN);
        break;
    case 3:
        nrf_gpio_pin_toggle(LED_3_PIN);
        break;
    case 4:
        nrf_gpio_pin_toggle(LED_4_PIN);
        break;
    }
}

작업: 버튼 누르기를 초기화하고 처리하는 함수를 추가합니다.

첫 번째 함수는 버튼 누르기를 위해 보드를 초기화하고 두 번째 버튼은 버튼 1을 누르면 멀티캐스트 UDP 메시지를 전송합니다.

/**
 * @brief Function to initialize the button.
 */
void otSysButtonInit(otSysButtonCallback aCallback)
{
    nrfx_gpiote_in_config_t in_config = NRFX_GPIOTE_CONFIG_IN_SENSE_LOTOHI(true);
    in_config.pull                    = NRF_GPIO_PIN_PULLUP;

    ret_code_t err_code;
    err_code = nrfx_gpiote_in_init(BUTTON_PIN, &in_config, in_pin1_handler);
    APP_ERROR_CHECK(err_code);

    sButtonHandler = aCallback;
    sButtonPressed = false;

    nrfx_gpiote_in_event_enable(BUTTON_PIN, true);
}

void otSysButtonProcess(otInstance *aInstance)
{
    if (sButtonPressed)
    {
        sButtonPressed = false;
        sButtonHandler(aInstance);
    }
}

작업:gpio.c 파일을 저장하고 닫습니다.

6. API: 기기 역할 변경사항에 반응

이 애플리케이션에서는 기기 역할에 따라 다른 LED가 켜지기를 원합니다. 리더, 라우터, 최종 기기 역할을 추적해 보겠습니다. 다음과 같이 LED에 할당할 수 있습니다.

  • LED1 = 리더
  • LED2 = 라우터
  • LED3 = 최종 기기

이 기능을 사용 설정하려면 애플리케이션에서 기기 역할이 변경된 시기와 그에 따라 올바른 LED를 사용 설정하는 방법을 알아야 합니다. 첫 번째 부분에는 OpenThread 인스턴스를 사용하고, 두 번째 부분에는 GPIO 플랫폼 추상화를 사용합니다.

원하는 텍스트 편집기에서 ./openthread/examples/apps/cli/main.c 파일을 엽니다.

./openthread/examples/apps/cli/main.c

작업: '헤더 포함'을 추가합니다.

main.c 파일의 include 섹션에서 역할 변경 기능에 필요한 API 헤더 파일을 추가합니다.

#include <openthread/instance.h>
#include <openthread/thread.h>
#include <openthread/thread_ftd.h>

작업: OpenThread 인스턴스 상태 변경을 위한 핸들러 함수 선언을 추가합니다.

이 선언은 main.c의 앞, 헤더 포함 및 #if 문 앞에 추가합니다. 이 함수는 기본 애플리케이션 이후에 정의됩니다.

void handleNetifStateChanged(uint32_t aFlags, void *aContext);

작업: 상태 변경 핸들러 함수에 관한 콜백 등록을 추가합니다.

main.c에서 otAppCliInit 호출 후 이 함수를 main() 함수에 추가합니다. 이 콜백 등록은 OpenThread 인스턴스 상태가 변경될 때마다 handleNetifStateChange 함수를 호출하도록 OpenThread에 지시합니다.

/* Register Thread state change handler */
otSetStateChangedCallback(instance, handleNetifStateChanged, instance);

작업: 상태 변경 구현을 추가합니다.

main.cmain() 함수 뒤에 handleNetifStateChanged 함수를 구현합니다. 이 함수는 OpenThread 인스턴스의 OT_CHANGED_THREAD_ROLE 플래그를 확인하고 변경되었으면 필요에 따라 LED를 켜거나 turns니다.

void handleNetifStateChanged(uint32_t aFlags, void *aContext)
{
   if ((aFlags & OT_CHANGED_THREAD_ROLE) != 0)
   {
       otDeviceRole changedRole = otThreadGetDeviceRole(aContext);

       switch (changedRole)
       {
       case OT_DEVICE_ROLE_LEADER:
           otSysLedSet(1, true);
           otSysLedSet(2, false);
           otSysLedSet(3, false);
           break;

       case OT_DEVICE_ROLE_ROUTER:
           otSysLedSet(1, false);
           otSysLedSet(2, true);
           otSysLedSet(3, false);
           break;

       case OT_DEVICE_ROLE_CHILD:
           otSysLedSet(1, false);
           otSysLedSet(2, false);
           otSysLedSet(3, true);
           break;

       case OT_DEVICE_ROLE_DETACHED:
       case OT_DEVICE_ROLE_DISABLED:
           /* Clear LED4 if Thread is not enabled. */
           otSysLedSet(4, false);
           break;
        }
    }
}

7 API: 멀티캐스트를 사용하여 LED 사용 설정

또한 애플리케이션에서 한 보드에서 Button1을 누르면 네트워크의 다른 모든 기기에 UDP 메시지를 전송합니다. 메시지 수신을 확인하기 위해 응답에서 다른 보드의 LED4를 전환합니다.

이 기능을 사용 설정하려면 애플리케이션에서 다음을 수행해야 합니다.

  • 시작 시 UDP 연결 초기화
  • 메시 로컬 멀티캐스트 주소로 UDP 메시지를 보낼 수 있어야 합니다.
  • 수신 UDP 메시지 처리
  • 수신 UDP 메시지에 대한 응답으로 LED4 전환

원하는 텍스트 편집기에서 ./openthread/examples/apps/cli/main.c 파일을 엽니다.

./openthread/examples/apps/cli/main.c

작업: '헤더 포함'을 추가합니다.

main.c 파일 상단의 include 섹션에서 멀티캐스트 UDP 기능에 필요한 API 헤더 파일을 추가합니다.

#include <string.h>

#include <openthread/message.h>
#include <openthread/udp.h>

#include "utils/code_utils.h"

code_utils.h 헤더는 런타임 조건을 검증하고 오류를 적절하게 처리하는 otEXPECTotEXPECT_ACTION 매크로에 사용됩니다.

작업: 정의 및 상수를 추가합니다.

main.c 파일의 include 섹션 뒤와 #if 문 앞에 UDP 관련 상수를 추가하고 다음을 정의합니다.

#define UDP_PORT 1212

static const char UDP_DEST_ADDR[] = "ff03::1";
static const char UDP_PAYLOAD[]   = "Hello OpenThread World!";

ff03::1는 메시 로컬 멀티캐스트 주소입니다. 이 주소로 전송된 메시지는 네트워크의 모든 전체 스레드 기기로 전송됩니다. OpenThread의 멀티캐스트 지원에 관한 자세한 내용은 openthread.io의 멀티캐스트를 참고하세요.

작업: 함수 선언을 추가합니다.

main.c 파일의 otTaskletsSignalPending 정의 이후 및 main() 함수 앞에 UDP 소켓 함수와 UDP 소켓을 나타내는 정적 변수를 추가합니다.

static void initUdp(otInstance *aInstance);
static void sendUdp(otInstance *aInstance);

static void handleButtonInterrupt(otInstance *aInstance);

void handleUdpReceive(void *aContext, otMessage *aMessage, 
                      const otMessageInfo *aMessageInfo);

static otUdpSocket sUdpSocket;

작업: GPIO LED 및 버튼을 초기화하는 호출을 추가합니다.

main.c에서 otSetStateChangedCallback 함수 뒤에 있는 이 함수 호출을 main() 함수에 추가합니다. 이러한 함수는 GPIO 및 GPIOTE 핀을 초기화하고 버튼 푸시 이벤트를 처리하도록 버튼 핸들러를 설정합니다.

/* init GPIO LEDs and button */
otSysLedInit();
otSysButtonInit(handleButtonInterrupt);

조치: UDP 초기화 호출을 추가합니다.

main.c에서 방금 추가한 otSysButtonInit 호출 후에 이 함수를 main() 함수에 추가합니다.

initUdp(instance);

이 호출은 애플리케이션 시작 시 UDP 소켓이 초기화되도록 합니다. 그러지 않으면 기기에서 UDP 메시지를 보내거나 받을 수 없습니다.

작업: GPIO 버튼 이벤트를 처리하는 호출을 추가합니다.

main.cwhile 루프에서 otSysProcessDrivers 호출 후 main() 함수에 이 함수 호출을 추가합니다. gpio.c에서 선언된 이 함수는 버튼이 눌렸는지 확인하고, 버튼을 누르면 위의 단계에서 설정한 핸들러 (handleButtonInterrupt)를 호출합니다.

otSysButtonProcess(instance);

작업: 버튼 인터럽트 핸들러를 구현합니다.

main.c에서 이전 단계에서 추가한 handleNetifStateChanged 함수 뒤에 handleButtonInterrupt 함수의 구현을 추가합니다.

/**
 * Function to handle button push event
 */
void handleButtonInterrupt(otInstance *aInstance)
{
    sendUdp(aInstance);
}

작업: UDP 초기화를 구현합니다.

main.c에서 방금 추가한 handleButtonInterrupt 함수 뒤에 initUdp 함수 구현을 추가합니다.

/**
 * Initialize UDP socket
 */
void initUdp(otInstance *aInstance)
{
    otSockAddr  listenSockAddr;

    memset(&sUdpSocket, 0, sizeof(sUdpSocket));
    memset(&listenSockAddr, 0, sizeof(listenSockAddr));

    listenSockAddr.mPort    = UDP_PORT;

    otUdpOpen(aInstance, &sUdpSocket, handleUdpReceive, aInstance);
    otUdpBind(aInstance, &sUdpSocket, &listenSockAddr, OT_NETIF_THREAD);
}

UDP_PORT은 앞에서 정의한 포트 (1212)입니다. otUdpOpen 함수는 소켓을 열고 UDP 메시지가 수신된 경우 콜백 함수 (handleUdpReceive)를 등록합니다. otUdpBindOT_NETIF_THREAD을 전달하여 소켓을 스레드 네트워크 인터페이스에 결합합니다. 다른 네트워크 인터페이스 옵션은 UDP API 참조otNetifIdentifier 열거형을 참조하세요.

작업: UDP 메시지를 구현합니다.

main.c에서 방금 추가한 initUdp 함수 뒤에 sendUdp 함수 구현을 추가합니다.

/**
 * Send a UDP datagram
 */
void sendUdp(otInstance *aInstance)
{
    otError       error = OT_ERROR_NONE;
    otMessage *   message;
    otMessageInfo messageInfo;
    otIp6Address  destinationAddr;

    memset(&messageInfo, 0, sizeof(messageInfo));

    otIp6AddressFromString(UDP_DEST_ADDR, &destinationAddr);
    messageInfo.mPeerAddr    = destinationAddr;
    messageInfo.mPeerPort    = UDP_PORT;

    message = otUdpNewMessage(aInstance, NULL);
    otEXPECT_ACTION(message != NULL, error = OT_ERROR_NO_BUFS);

    error = otMessageAppend(message, UDP_PAYLOAD, sizeof(UDP_PAYLOAD));
    otEXPECT(error == OT_ERROR_NONE);

    error = otUdpSend(aInstance, &sUdpSocket, message, &messageInfo);

 exit:
    if (error != OT_ERROR_NONE && message != NULL)
    {
        otMessageFree(message);
    }
}

otEXPECTotEXPECT_ACTION 매크로를 확인합니다. 그러면 UDP 메시지가 유효하고 버퍼에 올바르게 할당되며, 그렇지 않은 경우 함수가 버퍼를 해제하는 exit 블록으로 이동하여 오류를 매끄럽게 처리합니다.

UDP를 초기화하는 데 사용되는 함수에 대한 자세한 내용은 openthread.io에 대한 IPv6UDP 참조를 확인하세요.

작업: UDP 메시지 처리를 구현합니다.

main.c에서 방금 추가한 sendUdp 함수 뒤에 handleUdpReceive 함수 구현을 추가합니다. 이 함수는 LED 4를 전환합니다.

/**
 * Function to handle UDP datagrams received on the listening socket
 */
void handleUdpReceive(void *aContext, otMessage *aMessage,
                      const otMessageInfo *aMessageInfo)
{
    OT_UNUSED_VARIABLE(aContext);
    OT_UNUSED_VARIABLE(aMessage);
    OT_UNUSED_VARIABLE(aMessageInfo);

    otSysLedToggle(4);
}

8 API: 스레드 네트워크 구성

쉽게 설명하기 위해, 스레드가 켜져 있을 때 기기가 즉시 스레드를 시작하고 네트워크에 조인하기를 바랍니다. 이렇게 하려면 otOperationalDataset 구조를 사용합니다. 이 구조에는 스레드 네트워크 사용자 인증 정보를 기기로 전송하는 데 필요한 모든 매개변수가 있습니다.

이 구조를 사용하면 OpenThread에 내장된 네트워크 기본값이 재정의되어 애플리케이션의 보안을 강화하고 네트워크의 스레드 노드를 애플리케이션을 실행하는 노드로 제한할 수 있습니다.

원하는 텍스트 편집기에서 ./openthread/examples/apps/cli/main.c 파일을 다시 엽니다.

./openthread/examples/apps/cli/main.c

작업: 헤더 포함을 추가합니다.

main.c 파일 상단의 include 섹션에서 스레드 네트워크를 구성하는 데 필요한 API 헤더 파일을 추가합니다.

#include <openthread/dataset_ftd.h>

작업: 네트워크 구성을 설정하기 위한 함수 선언을 추가합니다.

이 선언은 main.c의 앞, 헤더 포함 및 #if 문 앞에 추가합니다. 이 함수는 기본 애플리케이션 함수 다음에 정의됩니다.

static void setNetworkConfiguration(otInstance *aInstance);

작업: 네트워크 구성 호출을 추가합니다.

main.c에서 otSetStateChangedCallback 함수 뒤에 있는 이 함수 호출을 main() 함수에 추가합니다. 이 함수는 스레드 네트워크 데이터 세트를 구성합니다.

/* Override default network credentials */
setNetworkConfiguration(instance);

작업: 스레드 네트워크 인터페이스 및 스택을 사용 설정하는 호출을 추가합니다.

main.c에서 otSysButtonInit 함수 뒤에 있는 이 함수 호출을 main() 함수에 추가합니다.

/* Start the Thread network interface (CLI cmd > ifconfig up) */
otIp6SetEnabled(instance, true);

/* Start the Thread stack (CLI cmd > thread start) */
otThreadSetEnabled(instance, true);

작업: 스레드 네트워크 구성을 구현합니다.

main.c에서 main() 함수 뒤에 setNetworkConfiguration 함수 구현을 추가합니다.

/**
 * Override default network settings, such as panid, so the devices can join a
 network
 */
void setNetworkConfiguration(otInstance *aInstance)
{
    static char          aNetworkName[] = "OTCodelab";
    otOperationalDataset aDataset;

    memset(&aDataset, 0, sizeof(otOperationalDataset));

    /*
     * Fields that can be configured in otOperationDataset to override defaults:
     *     Network Name, Mesh Local Prefix, Extended PAN ID, PAN ID, Delay Timer,
     *     Channel, Channel Mask Page 0, Network Key, PSKc, Security Policy
     */
    aDataset.mActiveTimestamp                      = 1;
    aDataset.mComponents.mIsActiveTimestampPresent = true;

    /* Set Channel to 15 */
    aDataset.mChannel                      = 15;
    aDataset.mComponents.mIsChannelPresent = true;

    /* Set Pan ID to 2222 */
    aDataset.mPanId                      = (otPanId)0x2222;
    aDataset.mComponents.mIsPanIdPresent = true;

    /* Set Extended Pan ID to C0DE1AB5C0DE1AB5 */
    uint8_t extPanId[OT_EXT_PAN_ID_SIZE] = {0xC0, 0xDE, 0x1A, 0xB5, 0xC0, 0xDE, 0x1A, 0xB5};
    memcpy(aDataset.mExtendedPanId.m8, extPanId, sizeof(aDataset.mExtendedPanId));
    aDataset.mComponents.mIsExtendedPanIdPresent = true;

    /* Set network key to 1234C0DE1AB51234C0DE1AB51234C0DE */
    uint8_t key[OT_NETWORK_KEY_SIZE] = {0x12, 0x34, 0xC0, 0xDE, 0x1A, 0xB5, 0x12, 0x34, 0xC0, 0xDE, 0x1A, 0xB5, 0x12, 0x34, 0xC0, 0xDE};
    memcpy(aDataset.mNetworkKey.m8, key, sizeof(aDataset.mNetworkKey));
    aDataset.mComponents.mIsNetworkKeyPresent = true;

    /* Set Network Name to OTCodelab */
    size_t length = strlen(aNetworkName);
    assert(length <= OT_NETWORK_NAME_MAX_SIZE);
    memcpy(aDataset.mNetworkName.m8, aNetworkName, length);
    aDataset.mComponents.mIsNetworkNamePresent = true;

    otDatasetSetActive(aInstance, &aDataset);
    /* Set the router selection jitter to override the 2 minute default.
       CLI cmd > routerselectionjitter 20
       Warning: For demo purposes only - not to be used in a real product */
    uint8_t jitterValue = 20;
    otThreadSetRouterSelectionJitter(aInstance, jitterValue);
}

함수에 관한 것처럼 이 애플리케이션에서 사용하는 스레드 네트워크 매개변수는 다음과 같습니다.

  • 채널 = 15
  • PAN ID = 0x2222
  • 확장된 PAN ID = C0DE1AB5C0DE1AB5
  • 네트워크 키 = 1234C0DE1AB51234C0DE1AB51234C0DE
  • 네트워크 이름 = OTCodelab

또한 여기서는 라우터 선택 지터를 줄이므로 데모를 위해 기기에서 역할을 더 빠르게 변경합니다. 이는 노드가 FTD (전체 스레드 기기)인 경우에만 실행됩니다. 이 내용은 다음 단계에서 자세히 알아봅니다.

9. API: 제한된 함수

일부 OpenThread의 API는 데모 또는 테스트 목적으로만 수정해야 하는 설정을 수정합니다. 이러한 API는 OpenThread를 사용하는 애플리케이션의 프로덕션 배포에서 사용해서는 안 됩니다.

예를 들어 otThreadSetRouterSelectionJitter 함수는 최종 기기가 라우터로 승격되는 데 걸리는 시간 (초)을 조정합니다. 이 값의 기본값은 스레드 사양에 따른 120입니다. 이 Codelab에서 쉽게 사용할 수 있도록 20으로 변경하므로 스레드 노드가 역할을 변경할 때까지 매우 오래 기다릴 필요가 없습니다.

참고: MTD 기기는 라우터가 되지 않으며 otThreadSetRouterSelectionJitter와 같은 함수 지원은 MTD 빌드에 포함되지 않습니다. 나중에 CMake 옵션 -DOT_MTD=OFF을 지정해야 합니다. 그러지 않으면 빌드 실패가 발생합니다.

이는 OPENTHREAD_FTD의 전처리기 지시문에 포함된 otThreadSetRouterSelectionJitter 함수 정의를 확인하여 확인할 수 있습니다.

./openthread/src/core/api/thread_ftd_api.cpp

#if OPENTHREAD_FTD

#include <openthread/thread_ftd.h>

...

void otThreadSetRouterSelectionJitter(otInstance *aInstance, uint8_t aRouterJitter)
{
    Instance &instance = *static_cast<Instance *>(aInstance);

    instance.GetThreadNetif().GetMle().SetRouterSelectionJitter(aRouterJitter);
}

...

#endif // OPENTHREAD_FTD

10. CMake 업데이트

애플리케이션을 빌드하기 전에 CMake 파일 3개에 몇 가지 소규모 업데이트가 필요합니다. 빌드 시스템에서 애플리케이션을 컴파일하고 연결하는 데 사용됩니다.

./third_party/NordicSemiconductor/CMakeLists.txt

이제 GPIO 함수가 애플리케이션에 정의되도록 NordicSemiconductor CMakeLists.txt에 몇 가지 플래그를 추가합니다.

조치:CMakeLists.txt 파일에 플래그를 추가합니다.

원하는 텍스트 편집기에서 ./third_party/NordicSemiconductor/CMakeLists.txt를 열고 COMMON_FLAG 섹션에 다음 줄을 추가합니다.

...
set(COMMON_FLAG
    -DSPIS_ENABLED=1
    -DSPIS0_ENABLED=1
    -DNRFX_SPIS_ENABLED=1
    -DNRFX_SPIS0_ENABLED=1
    ...

    # Defined in ./third_party/NordicSemiconductor/nrfx/templates/nRF52840/nrfx_config.h
    -DGPIOTE_ENABLED=1
    -DGPIOTE_CONFIG_IRQ_PRIORITY=7
    -DGPIOTE_CONFIG_NUM_OF_LOW_POWER_EVENTS=1
)

...

./src/CMakeLists.txt

./src/CMakeLists.txt 파일을 수정하여 새 gpio.c 소스 파일을 추가합니다.

작업:./src/CMakeLists.txt 파일에 gpio 소스를 추가합니다.

원하는 텍스트 편집기에서 ./src/CMakeLists.txt를 열고 NRF_COMM_SOURCES 섹션에 파일을 추가합니다.

...

set(NRF_COMM_SOURCES
  ...
  src/gpio.c
  ...
)

...

./third_party/NordicSemiconductor/CMakeLists.txt

마지막으로 nrfx_gpiote.c 드라이버 파일을 Nordic Semiconductor CMakeLists.txt 파일에 추가하여 Nordic 드라이버의 라이브러리 빌드에 포함합니다.

작업: gpio 드라이버를 NordicSemiconductorCMakeLists.txt 파일에 추가합니다.

원하는 텍스트 편집기에서 ./third_party/NordicSemiconductor/CMakeLists.txt를 열고 COMMON_SOURCES 섹션에 파일을 추가합니다.

...

set(COMMON_SOURCES
  ...
  nrfx/drivers/src/nrfx_gpiote.c
  ...
)
...

1일 기기 설정

코드 업데이트가 모두 완료되면 애플리케이션을 3개의 Nordic nRF52840 개발 보드에 모두 빌드하고 플래시할 수 있습니다. 각 기기는 전체 스레드 기기 (FTD)로 작동합니다.

OpenThread 빌드

nRF52840 플랫폼용 OpenThread FTD 바이너리를 빌드합니다.

$ cd ~/ot-nrf528xx
$ ./script/build nrf52840 UART_trans -DOT_MTD=OFF -DOT_APP_RCP=OFF -DOT_RCP=OFF

OpenThread FTD CLI 바이너리가 있는 디렉터리로 이동하여 ARM Embedded Toolchain을 사용하여 16진수 형식으로 변환합니다.

$ cd build/bin
$ arm-none-eabi-objcopy -O ihex ot-cli-ftd ot-cli-ftd.hex

보드 플래시

각 nRF52840 보드에 ot-cli-ftd.hex 파일을 플래시합니다.

nRF52840 보드의 외부 전원 핀 옆에 있는 마이크로 USB 디버그 포트에 USB 케이블을 연결한 다음 Linux 시스템에 연결합니다. 올바르게 설정하면 LED5가 켜집니다.

20a3b4b480356447.png

이전과 마찬가지로 nRF52840 보드의 일련번호를 기록합니다.

c00d519ebec7e5f0.jpeg

nRFx 명령줄 도구의 위치로 이동하여 보드 일련번호를 사용하여 OpenThread CLI FTD 16진수 파일을 nRF52840 보드에 플래시합니다.

$ cd ~/nrfjprog
$ ./nrfjprog -f nrf52 -s 683704924 --verify --chiperase --program \
       ~/openthread/output/nrf52840/bin/ot-cli-ftd.hex --reset

플래시하는 동안 LED5가 잠시 꺼집니다. 성공하면 다음과 같은 출력이 생성됩니다.

Parsing hex file.
Erasing user available code and UICR flash areas.
Applying system reset.
Checking that the area to write is not protected.
Programing device.
Applying system reset.
Run.

다른 두 보드에서 '보드 플래시' 단계를 반복합니다. 각 보드는 동일한 방식으로 Linux 시스템에 연결되어야 하며 플래시의 명령은 보드의 일련번호를 제외하고 동일합니다. 각 보드의 고유한 일련번호를 사용하여

nrfjprog 플래싱 명령어

성공하면 각 보드의 LED1, LED2 또는 LED3이 켜집니다. 플래시한 후 바로 기기 LED 변경 스위치가 3에서 2 (또는 2에서 1)로 표시될 수도 있습니다 (기기 역할 변경 기능).

12. 애플리케이션 기능

이제 세 개의 nRF52840 보드에 모두 전원이 공급되고 OpenThread 애플리케이션이 실행되고 있어야 합니다. 앞에서 자세히 설명했듯이 이 애플리케이션에는 두 가지 기본 기능이 있습니다.

기기 역할 표시기

각 보드의 조명 LED는 스레드 노드의 현재 역할을 반영합니다.

  • LED1 = 리더
  • LED2 = 라우터
  • LED3 = 최종 기기

역할이 바뀌면 LED 표시등도 바뀝니다. 각 기기의 전원이 켜진 후 20초 이내에 이러한 변경사항이 보드 한두 개에 이미 적용되었습니다.

UDP 멀티캐스트

Button1을 보드에서 누르면 UDP 메시지가 메시 네트워크의 멀티캐스트 주소로 전송되며 여기에는 스레드 네트워크의 다른 모든 노드가 포함됩니다. 이 메시지를 수신하면 다른 모든 보드의 LED4가 사용 설정 또는 사용 중지됩니다. LED4는 다른 UDP 메시지를 수신할 때까지 각 보드에서 계속 켜지거나 꺼진 상태로 유지됩니다.

203dd094acca1f97.png

9bbd96d9b1c63504.png

13. 데모: 기기 역할 변경사항 관찰

플래시된 기기는 라우터 종류 지원 최종 기기 (REED)라고 하는 특정 종류의 전체 스레드 기기 (FTD)입니다. 즉, 라우터 또는 최종 기기로 작동하고 최종 기기에서 라우터로 자신을 승격할 수 있습니다.

스레드는 최대 32개의 라우터를 지원할 수 있지만 라우터 수를 16개에서 23개로 유지하려고 합니다. REED가 최종 기기로 연결되고 라우터 수가 16개 미만이면 자동으로 라우터에 승격됩니다. 애플리케이션에서 otThreadSetRouterSelectionJitter 값을 설정한 시간(초) 내에 무작위로 변경사항이 적용됩니다(20초).

또한 모든 스레드 네트워크에는 스레드 네트워크의 라우터 집합을 관리하는 라우터인 리더가 있습니다. 모든 기기가 켜져 있는 상태에서 20초 후 중 하나는 리더 (LED1 사용)이고 다른 두 개는 라우터 (LED2 사용)여야 합니다.

4e1e885861a66570.png

최우수 대안 삭제

스레드 네트워크에서 리더가 삭제되면 다른 라우터가 자신을 리더로 승격하여 네트워크에 리더가 있는 것을 보장합니다.

전원 스위치를 사용하여 리더 보드 (LE1가 켜져 있는 보드)를 off니다. 20초 정도 기다립니다. 나머지 두 보드 중 하나에서 LED2 (라우터)가 꺼지고 LED1 (리더)이 켜집니다. 이 기기는 이제 스레드 네트워크의 선두 주자입니다.

4c57c87adb40e0e3.png

원래 리더 보드를 다시 사용 설정합니다. 스레드 네트워크에 최종 기기로 자동 다시 연결됩니다 (LED3가 켜져 있음). 20초 (라우터 선택 지터) 이내에 자신을 라우터로 업그레이드합니다 (LED2가 켜져 있음).

5f40afca2dcc4b5b.png

보드 재설정

보드 3개를 모두 Turn다가 다시 켜서 LED를 확인합니다. 전원을 The 첫 번째 보드는 리더 역할 (LED1이 켜져 있음)로 시작되어야 합니다. 스레드 네트워크의 첫 번째 라우터가 자동으로 리더가 됩니다.

다른 두 보드는 처음에는 최종 기기 (LED3가 켜져 있음)로 네트워크에 연결되지만 20초 이내에 라우터로 자체 승격되어야 합니다 (LED2가 켜져 있음).

네트워크 파티션

보드에 전원이 충분히 공급되지 않거나 보드 간 라디오 연결이 약한 경우 스레드 네트워크가 파티션으로 분할될 수 있으며 기기가 두 개 이상 리더로 표시될 수 있습니다.

스레드는 자가 복구되므로 파티션은 결국 하나의 리더가 있는 단일 파티션으로 다시 병합되어야 합니다.

14. 데모: UDP 멀티캐스트 전송

이전 연습을 진행하는 경우 어느 기기에서나 LED4가 켜져서는 안 됩니다.

보드를 선택하고 Button1을 누릅니다. 애플리케이션을 실행하는 스레드 네트워크의 다른 모든 보드의 LED4는 상태를 전환해야 합니다. 이전 연습에서 계속한다면 이러한 설정이 켜져 있어야 합니다.

f186a2618fdbe3fd.png

동일한 보드의 Button1을 다시 누릅니다. 다른 모든 보드의 LED4는 다시 전환되어야 합니다.

다른 보드에서 Button1을 누르고 다른 보드에서 LED4가 전환되는 방식을 관찰합니다. LED4가 현재 켜져 있는 보드 중 하나에서 Button1을 누릅니다. 해당 보드의 LED4가 켜진 상태로 유지되지만 다른 보드에서 켜집니다.

f5865ccb8ab7aa34.png

네트워크 파티션

보드가 파티션을 나누고 그중 두 개 이상의 리더가 있는 경우 멀티캐스트 메시지의 결과는 보드 간에 다릅니다. 파티션을 나눈 보드에서 Button1을 누르면 (따라서 파티션을 나눈 스레드 네트워크의 유일한 멤버인 경우) 다른 보드의 LED4가 켜지지 않습니다. 이 경우 보드를 재설정합니다. 보드가 단일 스레드 네트워크를 수정하고 UDP 메시징이 올바르게 작동하는 것이 좋습니다.

15. 축하합니다.

OpenThread API를 사용하는 애플리케이션을 만들었습니다.

학습 내용:

  • Nordic nRF52840 개발자 보드의 버튼 및 LED를 프로그래밍하는 방법
  • 일반적인 OpenThread API 및 otInstance 클래스를 사용하는 방법
  • OpenThread 상태 변경을 모니터링하고 이에 대응하는 방법
  • 스레드 네트워크의 모든 기기에 UDP 메시지를 보내는 방법
  • Makefile 수정 방법

다음 단계

이 Codelab을 기반으로 다음 연습을 시도해 보세요.

  • 온보드 LED 대신 GPIO 핀을 사용하도록 GPIO 모듈을 수정하고 라우터 역할에 따라 색상을 변경하는 외부 RGB LED를 연결합니다.
  • 다른 예시 플랫폼의 GPIO 지원 추가
  • 멀티캐스트를 사용하여 버튼 누르기로 모든 기기를 핑하는 대신 Router/Leader API를 사용하여 개별 기기를 찾아 핑합니다.
  • OpenThread Border Router를 사용하여 메시 네트워크를 인터넷에 연결하고 스레드 네트워크 외부에서 멀티캐스트하여 LED를 비춥니다.

추가 자료

Openthread.ioGitHub에서 다음을 포함한 다양한 OpenThread 리소스를 확인하세요.

참조: