Skip to main content

LoRa 通信 - SenseCAP Indicator

note

この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues

SenseCAP Indicator - LoRa アプリケーション開発

はじめに

LoRa®は、少量のデータを遠距離に送信するために最適化された長距離無線通信技術です。この技術は、Chirp Spread Spectrum (CSS) と呼ばれる方法を使用してサブGHzスペクトラムの無線信号を変調します。

Seeed StudioのSenseCAP Indicator(バージョン D1L および D1Pro)には、LoRa トランシーバーモジュール(Semtech SX1262 LoRa® チップ)が内蔵されており、低消費電力の無線接続をプロジェクトに簡単に追加できます。この投稿では、2つのSenseCAP Indicatorボード間でLoRa通信を設定する方法を説明します。

概要

このデモでは、SenseCAP IndicatorとXIAOボード間で基本的なLoRa通信を確立する方法を紹介します。SenseCAP IndicatorはXIAOからセンサーデータを取得し、それをWio-E5を介して送信します。送信されたペイロードはその後SenseCAP Indicatorによって受信され、解読されて結果を出力し、データを画面に表示します。

LVGLコードなし: Code · GitHub

ハードウェア

SenseCAP Indicator

Dive_into_the_Hardwareのページから、LoRaトランシーバーがSPIインターフェースを介してESP32-S3 MCUに接続されていることがわかります。

主要なコンポーネントは以下の通りです:

  • Semtech SX1262 ラジオフロントエンド
  • ESP32-S3 MCU

LoRaトランシーバーは、LoRa信号の低レベルの変調と復調をすべて処理します。ESP32-S3からSPIインターフェースを使用して通信できます。

XIAO

このデモでは、XIAOはセンサーデータを収集し、それをWio-E5を介してSenseCAP Indicatorに送信する必要があります。XIAOはUARTインターフェースを介してWio-E5に接続されています。

  • XIAO
  • Wio-E5
  • SEN5x

ソフトウェア

SenseCAP_Indicator_ESP32 SDKはすでにLoRaライブラリを提供しているため、それを直接使用できます。LoRa®のページを簡単に確認して、LoRaライブラリの使用方法を確認してください。

始めるにあたって

このデモは、IoT接続のためのローカルLoRa®ハブを設定する方法を示しています。

前提条件

開発環境を設定するための指示に従ってください。

ステップ1: デモコードをダウンロードする

このリンクからデモコードをクローンまたはダウンロードしてください。このコードはLoRaアプリケーションの出発点として使用されます。

ステップ2: ペイロードエンコーダーを実装する (XIAO;Arduino)

ステップ2.1: ペイロード構造とエンコーダーを実装する

#ifndef _FRAME_H
#define _FRAME_H
#include <Arduino.h>
#include <vector>

/** ペイロードフォーマット
* | トピック | データ長 | データペイロード | CRC |
* | 1バイト | 1バイト | n バイト | 2バイト |
* 例:
* | 0x01 | 0x0E | 14 バイト | 2バイト | SEN54用
* | 0x01 | 0x10 | 16 バイト | 2バイト | SEN55用
*/

#pragma pack(1)
enum topics {
TOPICS_MIN = 0x00,
TOPICS_SEN5x = 0x01,
TOPIC_MAX,
};

#pragma pack(1)
/* ハイライト開始 */
typedef struct
{
enum topics topic; /*メッセージタイプ*/
uint8_t dataLength;
std::vector<uint8_t> data; /*ペイロードの実際のデータ*/
uint16_t crc;
} Frame_t;
/* ハイライト終了 */
String packFrame(Frame_t frame);
void deleteFrame(Frame_t *frame);
uint16_t crc16_ccitt(const uint8_t *data, size_t length);
#endif

ステップ2.2: センサーデータ構造を実装し、ペイロードエンコーダーに適応させる

#ifndef PAYLOAD_SEN5X_H
#define PAYLOAD_SEN5X_H
#include "Frame.h"
#include "SensorPayload.h"
#include <SensirionI2CSen5x.h>

#define DEVICE_SEN54

#if defined(DEVICE_SEN54)
#elif defined(DEVICE_SEN55)
#else
#error "コンパイラオプションでデバイスを定義してください。"
#endif

class PayloadSEN5x : public SensorPayload<SensirionI2CSen5x> {
public:
PayloadSEN5x(SensirionI2CSen5x handler);
uint16_t init() override;
String toPayloadString() override;

private:
uint16_t massConcentrationPm1p0;
uint16_t massConcentrationPm2p5;
uint16_t massConcentrationPm4p0;
uint16_t massConcentrationPm10p0;
int16_t ambientHumidity;
int16_t ambientTemperature;
int16_t vocIndex;
#ifdef DEVICE_SEN55
// int16_t noxIndex; // センサー SEN54 は NOx をサポートしていません
#endif
SensirionI2CSen5x _sen5x;
};
#endif // PAYLOAD_SEN5X_H

関数 toPayloadString はデータを文字列にシリアライズし、その文字列を SenseCAP Indicator 経由で Wio-E5 に送信します。

ステップ 2.3: コードをコンパイルして XIAO にアップロード

#include "sensor_sen5x.h"
#include "wio_e5_at.h"
#include <Arduino.h>
#include <SensirionI2CSen5x.h>
#include <Wire.h>
SoftwareSerial serial_lora( D2, D3 );
Radio radio( serial_lora, RF_FREQUENCY, LORA_SF12, LORA_BW_125, 15, 15, 14, LORA_CRC_ON, LORA_IQ_NORMAL, LORA_PUBLIC_OFF );

SensirionI2CSen5x sen5x;
PayloadSEN5x payloadSEN5x( sen5x );

void setup() {
delay( 2000 );
wait_serial();
Serial.println( "開始中..." );

radio.begin();

Wire.begin();
payloadSEN5x.init();

Serial.println( "アプリケーション開始" );
}

void loop() {
static int count = 0;
static unsigned long task_time = 0;
static String test_string;

if ( millis() - task_time > 10000 ) {
task_time = millis();

radio.sendPayload( payloadSEN5x.toPayloadString() );

Serial.printf( "データ送信 %d\r\n", count++ );
}
}

ペイロードを完成させたので、次は SenseCAP Indicator におけるペイロードデコーダーのプログラミングに進みます。

ステップ 3: ペイロードデコーダーの実装 (SenseCAP Indicator;ESP-IDF)

ペイロードデコーダは、LoRaトランシーバーから受信したバイナリペイロードを人間が読みやすい形式に変換する機能です。ペイロードデコーダはアプリケーションに特化しており、ユーザー自身で実装する必要があります。このデモ用のペイロードデコーダはデモコード内で提供されています。

ステップ 3.1: ペイロードデコーダを実装する

  #ifndef __SIMPLE_FRAME_H
#define __SIMPLE_FRAME_H
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>

/** ペイロード形式
* | トピック | データ長 | データペイロード | CRC |
* | 1バイト | 1バイト | n バイト | 2バイト |
* 例:
* | 0x01 | 0x0E | 14 バイト | 2バイト | SEN54の場合
* | 0x01 | 0x10 | 16 バイト | 2バイト | SEN55の場合
*/

#pragma pack(1)
enum topics {
TOPICS_MIN = 0x00,
TOPICS_SEN5x = 0x01,
TOPIC_MAX,
};
typedef struct
{
enum topics topic; /*メッセージタイプまたはDataId*/
uint8_t dataLength;
uint8_t *data; /*ペイロードの実際のデータ*/
uint16_t crc;
} Frame_t;
Frame_t *parsePayload( uint8_t *payload, uint8_t length );
void deleteFrame( Frame_t *frame );
uint16_t crc16_ccitt( const uint8_t *data, size_t length );
#endif

ステップ 3.2: センサーデータ構造を実装する

  #ifndef PAYLOAD_SEN5X_H
#define PAYLOAD_SEN5X_H
#include "SensorPayload.h"

#define DEVICE_SEN54

#if defined( DEVICE_SEN54 )
#elif defined( DEVICE_SEN55 )
#else
#error "コンパイラオプションでデバイスを定義してください。"
#endif
#pragma pack(push, 1)
typedef union {
struct
{
uint16_t massConcentrationPm1p0;
uint16_t massConcentrationPm2p5;
uint16_t massConcentrationPm4p0;
uint16_t massConcentrationPm10p0;
int16_t ambientHumidity;
int16_t ambientTemperature;
int16_t vocIndex;
#ifdef DEVICE_SEN55
int16_t noxIndex;
#endif
};

#ifdef DEVICE_SEN55
int16_t data[8];
#else
int16_t data[7];
#endif
} SEN5xData_t;
#pragma pack(pop)
void phraseSEN5xData( uint8_t *data_arry, SEN5xData_t *SEN5x );
void prinSEN5xData( const SEN5xData_t *SEN5x );
#endif // PAYLOAD_SEN5X_H

ステップ 3.3: LoRaを設定する

LoRaパラメータを設定する

周波数、拡散率、帯域幅などの必要なLoRaパラメータを設定します。これらの設定は、通信を成功させるために2つのLoRaチャネル間で一致している必要があります。

#define RF_FREQUENCY               868000000 // Hz
#define LORA_BANDWIDTH 0 // [0: 125 kHz, 1: 250 kHz, 2: 500 kHz, 3: Reserved]
#define LORA_SPREADING_FACTOR 12 // [SF7..SF12]
#define LORA_CODINGRATE 1 // [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8]
#define LORA_PREAMBLE_LENGTH 15 // TxとRxで同じ
#define LORA_SYMBOL_TIMEOUT 5 // シンボル
#define LORA_FIX_LENGTH_PAYLOAD_ON false
#define LORA_IQ_INVERSION_ON false
LoRaトランシーバー受信機の設定
void OnRxDone( uint8_t *payload, uint16_t size, int16_t rssi, int8_t snr )
{
SEN5xData_t sen5x_data;
// ハイライト開始
Frame_t *frame = parsePayload( payload, size );
// ハイライト終了
if ( frame == NULL ) {
ESP_LOGE( TAG, "parsePayloadエラー" );
return;
}
ESP_LOGI( TAG, "frame->type: %s", dataIDToString( frame->topic ) );

// ハイライト開始
switch ( frame->topic ) {
case TOPICS_SEN5x:
phraseSEN5xData( frame->data, &sen5x_data );
break;
default:
break;
}
// ハイライト終了
deleteFrame( frame );
}
LoRaトランシーバーの初期化
RadioEvents.RxDone = OnRxDone;
Radio.Init( &RadioEvents );

Radio.SetChannel( RF_FREQUENCY );

Radio.SetRxConfig( MODEM_LORA, LORA_BANDWIDTH, LORA_SPREADING_FACTOR,
LORA_CODINGRATE, 0, LORA_PREAMBLE_LENGTH,
LORA_SYMBOL_TIMEOUT, LORA_FIX_LENGTH_PAYLOAD_ON,
0, true, 0, 0, LORA_IQ_INVERSION_ON, true );
Radio.SetMaxPayloadLength( MODEM_LORA, 255 );

Radio.Rx( 0 ); // 連続受信

ステップ 3.4: コードをSenseCAPインジケーターにコンパイルしてフラッシュする

/**
* @source: https://github.com/Seeed-Solution/indicator_lora_commu/blob/29624d10643a41ae5e1e24124b81e93b5e3cd3bb/Indicator/main/main.c
*/
#include "bsp_board.h"
#include "esp_log.h"
#include "frame.h"
#include "radio.h"
#include "sen5x.h"

static const char *TAG = "app_main";

#define VERSION "v0.0.1"

#define SENSECAP "\n\
_____ _________ ____ \n\
/ ___/___ ____ ________ / ____/ | / __ \\ \n\
\\__ \\/ _ \\/ __ \\/ ___/ _ \\/ / / /| | / /_/ / \n\
___/ / __/ / / (__ ) __/ /___/ ___ |/ ____/ \n\
/____/\\___/_/ /_/____/\\___/\\____/_/ |_/_/ \n\
--------------------------------------------------------\n\
Version: %s %s %s\n\
--------------------------------------------------------\n\
"

#define RF_FREQUENCY 868000000 // Hz
#define LORA_BANDWIDTH 0 // [0: 125 kHz, 1: 250 kHz, 2: 500 kHz, 3: Reserved]
#define LORA_SPREADING_FACTOR 12 // [SF7..SF12]
#define LORA_CODINGRATE 1 // [1: 4/5, 2: 4/6, 3: 4/7, 4: 4/8]
#define LORA_PREAMBLE_LENGTH 15 // TxとRxで同じ
#define LORA_SYMBOL_TIMEOUT 5 // シンボル
#define LORA_FIX_LENGTH_PAYLOAD_ON false
#define LORA_IQ_INVERSION_ON false

static RadioEvents_t RadioEvents;

SEN5xData_t sen5x_data;

void OnRxDone( uint8_t *payload, uint16_t size, int16_t rssi, int8_t snr ) {
int i = 0;
ESP_LOGI( TAG, "rssi:%d dBm, snr:%d dB, len:%d, payload:", rssi, snr, size );
for ( i = 0; i < size; i++ ) {
printf( "0x%x ", payload[i] );
}
printf( "\n" );

Frame_t *frame = parsePayload( payload, size );
if ( frame == NULL ) {
ESP_LOGE( TAG, "parsePayloadエラー" );
return;
}
ESP_LOGI( TAG, "frame->type: %s", dataIDToString( frame->topic ) );

switch ( frame->topic ) {
case TOPICS_SEN5x:
phraseSEN5xData( frame->data, &sen5x_data );
prinSEN5xData( &sen5x_data );
break;

default:
break;
}

deleteFrame( frame );
}

void app_main( void ) {
ESP_LOGI( "", SENSECAP, VERSION, __DATE__, __TIME__ );

ESP_ERROR_CHECK( bsp_board_init() );

ESP_LOGI( TAG, "APP MAIN START" );

RadioEvents.RxDone = OnRxDone;
Radio.Init( &RadioEvents );

Radio.SetChannel( RF_FREQUENCY );

Radio.SetRxConfig( MODEM_LORA, LORA_BANDWIDTH, LORA_SPREADING_FACTOR,
LORA_CODINGRATE, 0, LORA_PREAMBLE_LENGTH,
LORA_SYMBOL_TIMEOUT, LORA_FIX_LENGTH_PAYLOAD_ON,
0, true, 0, 0, LORA_IQ_INVERSION_ON, true );
Radio.SetMaxPayloadLength( MODEM_LORA, 255 );

Radio.Rx( 0 ); // 連続受信

while ( 1 ) {
vTaskDelay( pdMS_TO_TICKS( 10000 ) );
}
}

ステップ 4: 通信のテスト

両方のSenseCAPインジケーターボードの電源を入れ、シリアルモニターを開きます。ボード間でメッセージが送受信されるのが確認できるはずです。おめでとうございます!SenseCAPインジケーターを使用してLoRa通信を正常に設定しました。

XIAOのシリアルモニター
String: 76,80,81,81,5389,5990,980
0 4C 0 50 0 51 0 51 15 D 17 66 3 D4
CRC: 629
<<<AT+TEST=TXLRPKT,"010E004C005000510051150D176603D40629"
>>>+TEST: TX DONE
+TEST: TXLRPKT

ペイロードを正常に送信しました
データ1を送信
SenseCAPインジケーターのシリアルモニター
I (95490) app_main: rssi:-22 dBm, snr:5 dB, len:18, payload:
0x1 0xe 0x0 0x4c 0x0 0x50 0x0 0x51 0x0 0x51 0x15 0xd 0x17 0x66 0x3 0xd4 0x6 0x29
W (95541) parsePayload: topic: 1
W (95541) parsePayload: dataLength: 14
W (95545) parsePayload: payload[0]: 00
W (95549) parsePayload: payload[1]: 4C
W (95554) parsePayload: payload[2]: 00
W (95558) parsePayload: payload[3]: 50
W (95563) parsePayload: payload[4]: 00
W (95567) parsePayload: payload[5]: 51
W (95572) parsePayload: payload[6]: 00
W (95576) parsePayload: payload[7]: 51
W (95580) parsePayload: payload[8]: 15
W (95585) parsePayload: payload[9]: 0D
W (95589) parsePayload: payload[10]: 17
W (95594) parsePayload: payload[11]: 66
W (95598) parsePayload: payload[12]: 03
W (95603) parsePayload: payload[13]: D4
I (95607) app_main: frame->type: SEN5X
I (95612) sen5x_: massConcentrationPm1p0: 76
I (95617) sen5x_: massConcentrationPm2p5: 80
I (95622) sen5x_: massConcentrationPm4p0: 81
I (95627) sen5x_: massConcentrationPm10p0: 81
I (95632) sen5x_: ambientHumidity: 5389
I (95636) sen5x_: ambientTemperature: 5990
I (95641) sen5x_: vocIndex: 980

リソース

名前 機能
ビープ音制御 文字列 "ON" または "OFF" を受信し、対応する機能を実行します。
ピンポン通信 マスターとスレーブデバイス間でピンポン通信パターンを確立します。
マルチセンサーデータアップロード XIAOS3 がデータを収集し、Wio-E5(LoRaモジュールとATコマンドを使用)を利用してセンサーデータをインジケーターにアップロードします。

詳細については、README ファイルをご覧ください。

技術サポート

SenseCAP インジケーターに関するサポートが必要ですか?私たちがサポートします!

このチュートリアルを進める中で問題が発生したり質問がある場合は、ぜひ技術サポートにお問い合わせください。いつでもお手伝いします!

Seeed公式Discordチャンネルを訪れて質問するか、GitHubディスカッションで自由に共有してください!

Loading Comments...