mirror of
https://github.com/m5stack/m5-docs.git
synced 2026-05-20 10:23:01 -07:00
112 lines
4.5 KiB
Markdown
112 lines
4.5 KiB
Markdown
# LORA モジュール(433MHz) {docsify-ignore-all}
|
|
|
|
<img src="assets/img/product_pics/module/module_lora_01.png" width="30%" height="30%"> <img src="assets/img/product_pics/module/module_lora_02.png" width="30%" height="30%"> <img src="assets/img/product_pics/module/module_lora_03.png" width="30%" height="30%">
|
|
|
|
***
|
|
|
|
:memo:**[概要](#概要)** :octocat:**[サンプルコード](#サンプルコード)** :electric_plug:**[回路図](#回路図)** 🛒**[購入リンク](https://www.aliexpress.com/store/product/M5Stack-Official-Stock-Offer-LoRa-Module-for-ESP32-DIY-Development-Kit-Wireless-433MHz-Built-in-Antenna/3226069_32839736315.html?spm=2114.12010615.8148356.22.25e96be7xE1y22.html)**
|
|
|
|
## 概要
|
|
|
|
**<mark>LORA</mark>**モジュールはRa-02と呼ばれる小型のLoRa™モジュールを採用しています。
|
|
|
|
LoRa™は少ない消費電力で広いエリア(1~2km)をカバーする無線通信方式の一つです。Wi-FiやBluetoothなどとは補完の関係にあります。
|
|
|
|
## 特徴
|
|
|
|
- Ai-Thinker製Ra-02採用
|
|
- FSK, GFSK, MSK, GMSK, LoRa™, OOK 変調モードをサポート
|
|
- 受信感度 -141 dBm
|
|
- ビットレート可変 up to 300Kbps
|
|
- アンテナ内蔵
|
|
|
|
## パッケージ内容
|
|
|
|
- 1x LORA モジュール
|
|
|
|
## アプリケーション
|
|
|
|
- 自動検針器
|
|
- スマートホーム
|
|
- リモート灌漑システム
|
|
|
|
## 関連リンク
|
|
|
|
- **[公式ビデオ](https://www.youtube.com/channel/UCozgFVglWYQXbvTmGyS739w)**
|
|
|
|
- **[フォーラム](http://forum.m5stack.com/)**
|
|
|
|
- **データシート** - [LoRa](http://wiki.ai-thinker.com/lora)
|
|
|
|
- **[LoRaWAN 地域パラメータ](https://lora-alliance.org/sites/default/files/2018-04/lorawantm_regional_parameters_v1.1rb_-_final.pdf)**
|
|
|
|
<!-- ?> **メモ** もしあなたのLCD画面が表示されない場合は、以下のソースのように``m5.begin()``の前にGPIO5をプルアップする２行を追加してみてください。GPIO5がLoRaモジュールのNSSピンに接続されている為、GPIO５をプルアップする必要があります。
|
|
|
|
```arduino
|
|
pinMode(5,OUTPUT);
|
|
digitalWrite(5,HIGH);
|
|
m5.begin();
|
|
``` -->
|
|
|
|
## サンプルコード
|
|
|
|
### Arduino IDE
|
|
|
|
２台以上のLoRaモジュールを用い、長距離通信を行うサンプルコードです。
|
|
- メッセージの送信に成功したら、青い文字列が表示されます。
|
|
- メッセージの受信に成功したら、黄色い文字列が表示されます。
|
|
- 初期化に失敗したら、赤い文字列が表示されます。
|
|
|
|
*完全なソースコードは[こちら](https://github.com/m5stack/M5-ProductExampleCodes/tree/master/Module/LORA/Arduino)*
|
|
|
|
```arduino
|
|
#include <M5Stack.h>
|
|
#include <M5LoRa.h>
|
|
|
|
// 宣言
|
|
String outgoing; // 送信メッセージ
|
|
byte msgCount = 0; // 送信メッセージ数
|
|
byte localAddress = 0xBB; // このデバイスのアドレス
|
|
byte destination = 0xFF; // 送信先
|
|
|
|
// 初期化
|
|
M5.begin();
|
|
LoRa.setPins(); // CS, reset, IRQピンの設定
|
|
LoRa.begin(433E6); // 915 MHzで初期化
|
|
|
|
// メッセージ送信
|
|
void sendMessage(String outgoing) {
|
|
LoRa.beginPacket(); // パケット開始
|
|
LoRa.write(destination); // 送信先アドレスの追加
|
|
LoRa.write(localAddress); // 送信者アドレスの追加
|
|
LoRa.write(msgCount); // メッセージIDの追加
|
|
LoRa.write(outgoing.length()); // ペイロード長の追加
|
|
LoRa.print(outgoing); // ペイロードの追加
|
|
LoRa.endPacket(); // パケット送信
|
|
msgCount++; // メッセージIDインクリメント
|
|
}
|
|
|
|
// メッセージ受信
|
|
void onReceive(int packetSize) {
|
|
if (packetSize == 0) return; // パケットが無い場合リターン
|
|
int recipient = LoRa.read(); // 受信者アドレス
|
|
byte sender = LoRa.read(); // 送信者アドレス
|
|
byte incomingMsgId = LoRa.read(); // 受信メッセージID
|
|
byte incomingLength = LoRa.read(); // 受信メッセージ長
|
|
|
|
String incoming = "";
|
|
|
|
while (LoRa.available()) {
|
|
incoming += (char)LoRa.read(); // メッセージ取得
|
|
}
|
|
}
|
|
|
|
onReceive(LoRa.parsePacket());
|
|
```
|
|
|
|
<img src="assets/img/product_pics/module/module_example/LORA/example_module_lora_02.png">
|
|
|
|
## 回路図
|
|
|
|
<img src="assets/img/product_pics/module/lora_sch.png">
|