概要

　LoRaへのアクセスを例に手軽に実現できるIOT環境を構築します

背景

　気軽に検討できる環境としてのIOT開発環境を構築するのが目的です。特にIOTと言えども、Webなどを使用した見せ方が大事であるのは言うまでもありません。AWSを使って気軽に測定し、解析し、表示できる環境を目指します。

環境

ESPRESSIF:ESP32-WROOM-32
MacBook Air M1
Windows10 64bit PC
AWS環境
ES920LR3EB x 2（ES920LR3SDK1セットから）

　AWSについては、簡易的な構成管理環境などを用意し、ECSでのコンテナ管理やBeansTalkでの開発環境を用意します。右にあるIOTデバイスで取得した情報を直ちに処理しDBへの登録を行い、それを解析に用いたり、視覚的に表現できるようにします。参照系については、デモ用途も考えある程度拡張性を持たせています。
　今回、AWSにデータを送信するデバイスの１例にESP32側のペリフェラル環境として、EASEL製のES920LR3EBをUARTで制御します（ESP32からの制御対象は後に説明する親機になり、対向の子機からデータ取得することを想定しています。）。

ESP32
AWS環境
LoRa環境（ES920LR3EB x 2）

ステップ１　AWS S3←ESP32　

　ESP32で取得したデータをS3に保存することを検討し始めたのですが、、ほぼやりたいことが、@tsugunao さんのページ ESP32のデバイスから AWS IoTに接続してみると ESP32のカメラでドラえもんを撮影しAmazon Lookout for Visionで異常箇所を検知するに記載されており、ほぼそのまま試してみると、あっさりテキスト形式のデータを３０分程度でS3に保存できるようになりました。

　画像ではなく「Hello World」をテキストでS3に保存できた。

ステップ２　ターミナルモードでES920LR3EBに接続する

　まずは、Windows PCからTeratermを使用して、ES920LR3EBに接続する環境を作る。株式会社EASELの開発環境であるES920LR3SDK1セットを使用しており、以下の資料を用いている。

ES920LR3EB関連資料

Web公開されているもの（EASELのホームページで確認可能）

特定⼩電⼒無線モジュール ES920LR3 データシート Version 1.04
特定小電力無線モジュール ES920LR3 ソフトウエア開発環境説明書 Version 1.01
特定小電力無線モジュール ES920LR3 コマンド仕様ソフトウェア説明書 Version 1.04

Web公開されていないもの（SDKの納品物）

ES920LRx設定ツール取扱説明書及びツール
ES920LR3のソースコード一式（....太っ腹....）

WindowsからTeratermを使用したES920LR3EBの制御

　このステップでは１台のWindowsPC（ES920LR3Ex設定ツールがWindowsのみでしか使えない）で、２台のES920LR3を接続し、Teratermで制御する。このツールを利用した経緯は、以下のとおり。

ES920LR3EBがきちんと動作することを確認するため
ESP32での制御実装を検討するため
最低限制御必要なコマンドを理解するため

　そのため、以下の図のようにまずはES920LR3x設定ツールで制御し、そのあとにTeratermで制御する。

ES920LR3Ex設定ツールでの制御

基本的には、「ES920LRx設定ツール取扱説明書」を参照し、以下のとおり進めれば簡単にできる。

ES920LR3のドライバのインストール
ES920LRx設定ツールの起動

また、このツールを起動することで、ツールと同じフォルダにlogフォルダができるため、それを確認することで、Teratermで初期値以外に設定する値が以下だとわかる。

親機
通信設定bw:125kHz,sf:7,ch:1:panid:0001,ownid:0001,dstid:0000,ack:ON,power13
子機
通信設定bw:125kHz,sf:7,ch:1:panid:0001,ownid:0000,dstid:0001,ack:ON,power13

Teratermでの設定方法

下記は、親機の例ですが、子機も同じように設定すればOKです（ただし、子機のownidは0001、dstidは0000とする。）。

親機、子機設定後にともに、startコマンドを以下のように呼べば、通信が可能となる。
なお、途中パラメータのセーブ等をする場合は、saveコマンドを使用する。

上記の例でもわかるように接続後は、親機及び子機の両方から双方向通信ができる。

ステップ３　ESP32←ES920LR3EB←ES920LR3EB

　ESP32のUARTとES920LR3EBをジャンパーでクロスさせて飛ばす。そして、コントローラをPCからESP32に切り替えて、ES920LR3EB間の通信試験を実行する。通信試験としては、ステップ２で実施した内容をそのままESP32に実装する。

ベースのソースコードはステップ１で使用したもの
下記の中身はawsにアクセスして、指定の文字列（Hello World）を一定間隔で送信しているものだが、uart制御を入れてそのデータ送受信結果をAWSに送る変更をする。

awsアクセス

~/Work/esp32/esp-aws-iot/examples/mqtt/tls_mutual_auth

uart制御の参考になるサンプルは以下を使用する

uart

~/Work/esp32/v44/esp-idf/examples/peripherals/uart/uart_repl

サンプルコードをとりあえず動く形に修正したもの（プロセッサ側からの送信）
改行コード等はさることながら、タイマー値やレスポンス読み出し等の処理もないと動かないため改造時には注意が必要です。

~/Work/esp32/v44/esp-idf/examples/peripherals/uart/uart_repl/uart_repl_example_main.c

static void send_commands(void* arg) {
    static char data[READ_BUF_SIZE];
    char command0[] = "config\r\n";
    char command[]  = "processor\r\n";
    char command2[] = "bw 4\r\n";
    char command3[] = "sf 7\r\n";
    char command4[] = "channel 1\r\n";
    char command5[] = "panid 0001\r\n";
    char command6[] = "ownid 0000\r\n";
    char command7[] = "dstid 0001\r\n";
    char command9[] = "power -4\r\n";
    char command10[] = "start\r\n";
    char command11[] = "abcdefg\r\n";

    int len = 0;
    void* substring = NULL;

    printf("%s\n","test1\n");
    const TickType_t delay = 3000 / portTICK_PERIOD_MS;  // 3sec.
    const TickType_t delay2 = 5000 / portTICK_PERIOD_MS;  // 5sec.
    vTaskDelay(delay);

    /* Send the command `consoletest` to the console UART. */
    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command0, sizeof(command0));
    if ( len == -1 ) {
       goto end;
    }
    vTaskDelay(delay);

    do {
       len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    printf("%s\n",data);



    /* Send the command `consoletest` to the console UART. */
    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command, sizeof(command));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command2, sizeof(command2));
    if ( len == -1 ) {
       goto end;
    }
    vTaskDelay(delay);

    do {
       len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command3, sizeof(command3));
    if ( len == -1 ) {
       goto end;
    }
    vTaskDelay(delay);

    do {
       len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command4, sizeof(command4));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command5, sizeof(command5));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command6, sizeof(command6));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command7, sizeof(command7));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command9, sizeof(command9));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command10, sizeof(command10));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    vTaskDelay(delay2);

    printf("%s\n",data);

    while(1)
    {
        len = uart_write_bytes(DEFAULT_UART_CHANNEL, command11, sizeof(command11));
        if ( len == -1 ) {
            goto end;
        }
        vTaskDelay(delay);
    }

    /**
     * Check whether we can find test_message in the received message. Before
     * that, we need to add a NULL character to terminate the string.
     */
    data[len] = 0;
    substring = strcasestr(data, test_message);

end:
    /* This is a must to not send anything to the console anymore! */
    disconnect_uarts();
    printf("Result: %s\n", substring == NULL ? "Failure" : "Success");
    vTaskDelete(NULL);
}

サンプルコードをとりあえず動く形に修正したもの（host側からの送信）
改行コード等はさることながら、タイマー値やレスポンス読み出し等の処理もないと動かないため改造時には注意が必要です。

~/Work/esp32/v44/esp-idf/examples/peripherals/uart/uart_repl/uart_repl_example_main.c

static void send_commands(void* arg) {
    static char data[READ_BUF_SIZE];
    char command0[] = "config\r\n";
    char command[]  = "processor\r\n";
    char command2[] = "bw 4\r\n";
    char command3[] = "sf 7\r\n";
    char command4[] = "channel 1\r\n";
    char command5[] = "panid 0001\r\n";
    char command6[] = "ownid 0000\r\n";
    char command7[] = "dstid 0001\r\n";
    char command9[] = "power -4\r\n";
    char command10[] = "start\r\n";
    char command11[] = "abcdefg\r\n";

    int len = 0;
    void* substring = NULL;

    printf("%s\n","test1\n");
    const TickType_t delay = 3000 / portTICK_PERIOD_MS;  // 3sec.
    const TickType_t delay2 = 5000 / portTICK_PERIOD_MS;  // 5sec.
    vTaskDelay(delay);

    /* Send the command `consoletest` to the console UART. */
    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command0, sizeof(command0));
    if ( len == -1 ) {
       goto end;
    }
    vTaskDelay(delay);

    do {
       len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    printf("%s\n",data);



    /* Send the command `consoletest` to the console UART. */
    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command, sizeof(command));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command2, sizeof(command2));
    if ( len == -1 ) {
       goto end;
    }
    vTaskDelay(delay);

    do {
       len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command3, sizeof(command3));
    if ( len == -1 ) {
       goto end;
    }
    vTaskDelay(delay);

    do {
       len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command4, sizeof(command4));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command5, sizeof(command5));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command6, sizeof(command6));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command7, sizeof(command7));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command9, sizeof(command9));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);


    printf("%s\n",data);

    len = uart_write_bytes(DEFAULT_UART_CHANNEL, command10, sizeof(command10));
    if ( len == -1 ) {
        goto end;
    }
    vTaskDelay(delay);

    do {
        len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
    } while (len == 0);

    vTaskDelay(delay2);

    printf("%s\n",data);

    while(1)
    {
      int counter = 0;
      char dataBuff[50] = {}; /*max 50bytes*/
      len = 0;

      do {
          len = uart_read_bytes(DEFAULT_UART_CHANNEL, data, READ_BUF_SIZE - 1, 250 / portTICK_RATE_MS);
          vTaskDelay(delay);
      } while (len == 0);

      /*ascii mode only*/
      for(int i = 0; i < 50; i++)
      {
        counter++;
        dataBuff[i] = data[i];
        if(data[i] == '\n')
        {
          break;
        }
      }
      printf("%s\n",dataBuff);
    }

上記接続が成功した時のTeraterm側設定
端子設定は次のとおり

	es920lr3eb（図１）	esp32（図２）	備考
(N)RST	CN4:2	適当なgpio	現在は放置
uart	CN4:10	J3:4
uart	CN4:12	J3:5
GND	CN4:1, CN4:29	J2:14, J3:1, J3:7	esp32のGNDを１つでもつなぐとesp32がローダーモードにならない

図１
図２

ステップ４　AWS ← ESP32←ES920LR3EB←ES920LR3EB

　「ステップ３で作成した読み出しコード」を「ステップ１のAWSにアップするコード」とマージして、AWS IOTから連携されたデータを読み出せるようになりました。
　ソースコードは、githubにアップロードしました。