特定小電力無線モジュール
ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
Version 1.00

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書

著作権および商標
この文書には、株式会社EASELが所有権を持つ機密事項が含まれます。この資料のいかなる部分も許可無く複製、使用、公開することを固く禁じます。本書は株式会社EASELの従業員および許可された取引先だけに使用が認められています。
本書で提供されたデータは正確で信頼性の高いものですが、このデータの使用について株式会社
EASELは責任を負うものではありません。株式会社EASELは、いつでも無断で資料を変更する権利を有するものとします。

株式会社EASEL〒226-0018
神奈川県横浜市緑区長津田みなみ台5-7-8
https://easel5.com
mail support@easel5.com
tel045-988-1230

改訂履歴
版数

日付

1.00

2023.4.14

改訂内容
初版

p. 1

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書

目次
1. 概要 .......................................................................................................................................................... 4
2. 開発環境 .................................................................................................................................................. 5
3. 評価ボード ............................................................................................................................................... 6
4. 外部インターフェース............................................................................................................................. 8
5. ソフトウェア構成 .................................................................................................................................... 9
6. 動作モード ............................................................................................................................................. 10
7. コンフィグレーション項目 ................................................................................................................... 13
7.1. コンフィグレーション項目一覧 ..................................................................................................... 13
7.2. コマンド書式................................................................................................................................... 15
7.3. ホストマイコンからのコンフィグレーション手順 ........................................................................ 16
8. コンフィグレーション項目詳細 ............................................................................................................ 18
8.1. class コマンド .................................................................................................................................. 18
8.2. adr コマンド..................................................................................................................................... 19
8.3. activate コマンド ............................................................................................................................. 20
8.4. deveui コマンド ............................................................................................................................... 20
8.5. appeui コマンド ............................................................................................................................... 21
8.6. appkey コマンド .............................................................................................................................. 21
8.7. devaddr コマンド ............................................................................................................................. 228.8. nwkskey コマンド ............................................................................................................................ 228.9. appskey コマンド ............................................................................................................................. 23
8.10. ack コマンド................................................................................................................................... 23
8.11. retry コマンド ................................................................................................................................ 24
8.12. rssi コマンド .................................................................................................................................. 24
8.13. operation コマンド ........................................................................................................................ 25
8.14. baudrate コマンド .......................................................................................................................... 26
8.15. sleep コマンド ................................................................................................................................ 27
8.16. sleeptime コマンド ........................................................................................................................ 28
8.17. datarate コマンド ........................................................................................................................... 29
8.18. power コマンド .............................................................................................................................. 30
8.19. dtime コマンド............................................................................................................................... 31
8.20. duty コマンド................................................................................................................................. 32
8.21. version コマンド ............................................................................................................................ 33
8.22. save コマンド ................................................................................................................................. 33
8.23. load コマンド ................................................................................................................................. 34
p. 2

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.24. show コマンド................................................................................................................................ 34
8.25. start コマンド................................................................................................................................. 35
8.26. format コマンド ............................................................................................................................. 35
9. コンフィグレーション応答 ................................................................................................................... 36
9.1. レスポンス書式(ASCII フォーマット) ........................................................................................... 36
9.2. レスポンス書式(BINARY フォーマット) ....................................................................................... 36
9.3. レスポンスコード一覧 .................................................................................................................... 37
10. データフレーム.................................................................................................................................... 38
10.1. UART 入力データ(ASCII フォーマット) ...................................................................................... 38
10.2. UART 入力データ(BINARY フォーマット) ................................................................................. 39
10.3. UART 出力データ(ASCII フォーマット) ...................................................................................... 40
10.4. UART 出力データ(BINARY フォーマット) ................................................................................. 41
10.5. RF 入出力データ ............................................................................................................................ 42

p. 3

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
1. 概要
本書は、LoRaWAN 仕様 1.0.4 に準拠した、低消費電力無線モジュール ES920LR3 用に提供するコマ
ンド仕様ソフトウェアについて説明します。

p. 4

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
2. 開発環境① 統合開発環境※ソフトウェアをカスタマイズする場合に必要です。
下記いずれかから選択可能です。
(1) IARシステムズ社 IAR Embedded Workbench™ for Arm
動作確認済みバージョン 8.32.4※ 30日間期間限定版 (ユーザ登録要)https://www.iar.com/jp/iar-embedded-workbench/#!?currentTab=free-trials※ 30日間を超えて使用する場合は製品の購入が必要です。
(2) STMicroelectronics社 STM32CubeIDE
動作確認済みバージョン 1.5.1② デバッガ※ソフトウェアをカスタマイズする場合に必要です。
下記いずれかから選択可能です。
(1) IARシステムズ社 I-jet※I-jetとSTM32CubeIDEの組合せで使用することはできません。
(2) STMicroelectronics社 ST-LINK/V2③ 評価ボード
ES920LR3EB / ES920LR3A1EB④ USBケーブル(PCとの接続用)
micro-USB⑤ USBドライバ
https://www.silabs.com/documents/public/software/CP210x_Universal_Windows_Driver.zip⑥ ターミナルソフトウェア
Tera Term
http://www.forest.impress.co.jp/library/software/utf8teraterm/p. 5株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
3. 評価ボード
ES920LR3EB評価ボードについて説明します。

①

⑩
⑬ ⑭

⑦
⑤
⑥

⑫
⑧
⑪

②

③
④

⑨
図. ES920LR3EB 評価ボード
表. ES920LR3EB 評価ボード説明
#

名称

説明

1

通信モジュール(ES920LR3)

STMicroelectronics 社製 STM32WLE5JC
FlashROM 256KB, RAM 64KB

2

USB マイクロコネクタ

PC(ターミナルソフトウェア)接続用

3

USB シリアル変換 IC

Silicon Labs 社 CP2102N

4

USB Tx/Rx LED

USB 送受信確認用 LED

5リセットスイッチ

リセットスイッチ

6

汎用スイッチ

汎用スイッチ7

汎用 LED

汎用 LED

8

ジャンパ BATT/USB

電源選択

9

BATT-,BATT+

バッテリで電源を供給する場合に使用

10

外部端子

下記ピンアサイン参照

11

SWD コネクタ

デバッガ接続用

12

ジャンパ PIN_1

SWD 電源選択

13

ジャンパ BOOT1

BOOT ローダー起動選択14

ジャンパ VDD_RF

VDD_RF への電源供給選択

p. 6

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
表. ES920LR3EB 外部端子ピンアサイン
ピン番号

ピン名称

基本機能

ソフトウェア設定可能な機能

1

GND

-

2

NRST

NRST

3

VCCRF

-

4

PB10

GPIO(OUT)

5

BOOT0

-

6

PA1

-

7

PB6

-

8

PA6

-

9

PB7

-

10

PA3

USART2_RX

11

PB12

-

12

PA2

USART2_TX

13

PB14

-

14

PC1

GPIO(OUT)

15

PA10

-

SPI2_MOSI

16

PB5

-

SPI1_MOSI

17

PB13

-

SPI2_SCK

18

PB4

-

SPI1_MISO

19

PA11

-

I2C2_SDA

20

PB3

-

SPI1_SCK

21

PA12

-

I2C2_SCL

22

PB2

-

SPI1_NSS

23

PA13

SWDIO

24

PB8

-

25

PA14

SWCLK

26

PB9

-

27

VDD

-

28

PA0

WKUP1

29

GND

-

30

PA15

-

USART1_TX
USART1_RX
SPI2_NSSSPI2_MISO

I2C1_SCL
I2C1_SDA※基本機能は、コマンド仕様ソフトウェアでの設定値になります。
基本機能が空白のピンは GPIO に割当てており、全てアナログピンとなっています。
各ピン機能は、ソフトウェアのカスタマイズにより変更することが可能です。

p. 7

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
4. 外部インターフェース
ES920LR3EB 評価ボードの外部インターフェースについて説明します。
表. ES920LR3EB 評価ボード外部インターフェース
#

名称

項目

説明

1

USB マイクロコネクタ

ボーレート

115200bps (※1)

2

データ長

8bit

3

パリティ

なし

4

ストップビット

1bit

5

フロー制御

なし

INT

コンフィグレーションモード

6

汎用スイッチ

未使用
オペレーションモード
Low : WakeUp
High : Sleep
7

汎用 LEDTEST_0(緑)コンフィグレーションモード
常時点滅
オペレーションモード
データ送信の度に反転表示

TEST_1(橙)コンフィグレーションモード
常時点滅
オペレーションモード
データ受信の度に反転表示

8ジャンパ PIN_1

9
10

ジャンパ BOOT1

11
12
13

ジャンパ VDD_RFVDD

VDDRF 電源供給有OPEN

VDDRF 電源供給無ON

ブートローダ―モード

OFF

通常モード

SHORT

SWD 電源供給有

OPEN

SWD 電源供給無※1. ボーレートはモジュールのコンフィグレーション設定で変更可能です。
(9600bps / 19200bps / 38400bps / 57600bps / 115200bps / 230400bps)

p. 8

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
5. ソフトウェア構成
コマンド仕様ソフトウェアのソフトウェア構成について説明します。

図. ソフトウェア構成図● Application
本書の適用範囲。920MHz 帯無線通信評価用アプリケーション。
● Framework / MAC / Driver
LoRaWAN 準拠プロトコルスタック・マイコン制御ドライバ等。
● STM32WLE5JC
制御対象 MCU。

p. 9

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
6. 動作モード
コマンド仕様ソフトウェアにはターミナルモードとプロセッサモードを用意しており、起動時にユー
ザによる選択が可能です。
表. ターミナルモードとプロセッサモード説明
ターミナルモード

TeraTerm などのターミナルソフトウェアから使用される事を想定しています。
対話形式で無線チャンネルなどの各種設定を行います。
使用例)
ES920LR2

PC

プロセッサモード

ホストマイコンとの通信で使用される事を想定しており、コマンド形
式で無線チャンネルなどの各種設定を行います。
また、コマンドに対して応答メッセージを出力します。
使用例)
ES920LR2

p. 10

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
ターミナルモードとプロセッサモードのいずれもコンフィグレーションモードとオペレーションモードが存在し、初回電源投入後はコンフィグレーションモードで起動します。

コンフィグレーション

UART からコマンドを受け付け、無線チャンネルや PAN ID の設定

モードを行います。
コンフィグレーションモードで設定した内容は、内蔵 FlashROM に保存する事が可能で、電源再投入時は設定した内容に従い起動します。
また、コンフィグレーションモードからオペレーションモードへの変
更はコマンドで行います。

オペレーションモード

UART から入力したデータを送信先ノードに送信します。
また、他ノードから受信したデータを UART に出力します。
UART から config(CR+LF) を入力した場合、電源再投入時にコンフィグレーションモードに戻ります。
※ format コ マ ン ド で BINARY モ ー ド を 設 定 し て い る 場 合 は「config(CR+LF) 」を 500ms 以内で入力してください。

初回電源投入時は、ターミナルモードかプロセッサモードを選択した後、コンフィグレーションモード
で起動します。

初回電源投入ターミナルモード、プロセッサモード選択

コンフィグレーションモード

オペレーションモード

図. 初回電源投入時の動作モード

p. 11

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
前回起動時にコンフィグレーションモードを選択した場合(あるいは変更を行わなかった場合)、ターミナルモードかプロセッサモードを選択した後、コンフィグレーションモードで起動します。

電源投入(2 回目以降)

ターミナルモード、プロセッサモード選択

コンフィグレーションモード

オペレーションモード

図. 2 回目以降コンフィグレーションモードで起動
前回起動時にオペレーションモードを選択した場合、オペレーションモードを起動します。
※ オペレーションモードからコンフィグレーションモードに戻る場合は config(CR+LF)を入力して下さい。( format コマンドで BINARY モードを設定している場合は「config(CR+LF) 」を 500ms以内で入力してください)

電源投入(2 回目以降)

オペレーションモード

図. 2 回目以降オペレーションモードで起動

p. 12

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
7. コンフィグレーション項目
コマンド仕様ソフトウェアのコンフィグレーション項目について説明します。
7.1.コンフィグレーション項目一覧
表. コンフィグレーション項目一覧
コマンド

ショート

設定内容

デフォルト

設定範囲

備考

class A

class A

class B は将来のclass B

為の予約

コマンド
class

a

LoRaWAN クラス設定

class C
adrb

ADR 設定ON

ON
OFF

activatec

アクティベーション設定

OTAA

OTAA
ABP

deveuid

DevEUI 設定

0

appeuie

AppEUI 設定

0

appkeyf

AppKey 設定

0

devaddrg

DevAddr 設定

0

nwkskeyh

NwkSKye 設定0

appskeyi

AppSKey 設定

0

ack

j

Acknowledge 使用設定

ON

OFF
ON

retry

k

リトライ回数設定

rssil

受信電波強度(RSSI)付与設定

3

0～8

OFF

OFF

再送回数

ON
operationm

動作モード設定

Configuration

Configuration
Operation

baudraten

UART 転送速度設定

115200bps

9600bps

調歩同期モード

19200bps
38400bps
57600bps
115200bps
230400bps

p. 13

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
sleep

o

スリープモード設定

No Sleep

1. No Sleep
2. Timer Wakeup
3. INT Wakeup(Tx continue)
4. INT Wakeup(One Time Tx)
5. UART Wakeup

sleeptimep

スリープ時間設定

5秒

1～864000

100ms 単位
10 = 1 秒

datarateq

データレート設定

DR2

DR0
DR1
DR2
DR3
DR4
DR5

power

s

最大送信出力設定

13dBm

13dBm
11dBm
9dBm
7dBm

dtime

t

DwellTime 設定

No Limit

No Limit
400ms

duty

u

Duty Cycle 設定< 1%

No Limit< 1%

versionv

ソフトウェアバージョン取得

-

-

save

w

FlashROM への設定値書き込

-

-

み
load

x

デフォルト値の読み出し

-

-

show

y

設定値確認

-

-

start

z

データ通信状態に移行--

formatA

ペイロードデータフォーマッ

ASCII

ASCII

ト設定

BINARYp. 14

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
7.2.コマンド書式(1) ターミナルモードの場合● コマンド書式
コマンド
・コマンドにはショートコマンドを指定して実行することも可能です。
・コマンドオプションはコマンド実行後に表示されるプロンプトで設定して下さい。
・コマンドの終端には改行コード(CRLF)を付与して下さい。
・コマンドオプションについてはコンフィグレーション項目詳細を参照して下さい。
(2) プロセッサモードの場合● コマンド書式
コマンド [コマンドオプション]・コマンドにはショートコマンドを指定して実行することも可能です。
・コマンドとコマンドオプションの間には必ず半角スペースを挿入して下さい。
・コマンドの終端には改行コード(CRLF)を付与して下さい。
・コマンドオプションについてはコンフィグレーション項目詳細を参照して下さい。

p. 15

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
7.3.ホストマイコンからのコンフィグレーション手順
ES920LR3

ホストマイコンPower ON

モード選択要求(Select Mode [1.terminal or 2.processor] CRLF)
Power ON

モード選択(processor CRLF)

受付プロンプト(OK CRLF)

LoRaWAN クラス設定(class 1 CRLF)

コンフィグレーション操作
左記の要領で以下の項目も設定を行います。

受付プロンプト(OK CRLF)

・DevEUI・AppEUIADR 設定(adr 1 CRLF)

・スリープモード設定など

受付プロンプト(OK CRLF)

設定値保存(save CRLF)

受付プロンプト(OK CRLF)

オペレーションモード(start CRLF)

受付プロンプト(OK CRLF)

start コマンド以降は、対向ノード間と無線通信を行います。

p. 16

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
上図は、ホストマイコンと ES920LR3 間のコンフィグレーション手順を示しています。
ES920LR3 を先に起動した場合を想定しており、ES920LR3 からホストマイコン向けに、「モード選択
要求(Select Mode [1.terminal or 2.processor])」を送信していますが、ホストマイコンがまだ起動していないため、無視されています。
ホストマイコンは、起動後、モード選択の応答があるまで ES920LR3 に送信し、ES920LR3 の起動確認を行います。
ホストマイコンは、「モード選択要求」に対し、モード選択を行う事でコンフィグレーション操作を開始します。
ES920LR3 には、予めデフォルト値が設定されており、コンフィグレーションでは、デフォルト値に対して変更したい部分のみを変更します。
上図は、LoRaWAN クラスと、ADR 設定を行う例です。
コンフィグレーションの最後に、save コマンドを発行して、変更した内容を内蔵 FlashROM に保存します。
次回起動時は最後の設定値を内蔵 FlashROM から読み込み、電源 OFF 前と同じ設定で起動します。

p. 17

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8. コンフィグレーション項目詳細
コマンド仕様ソフトウェアのコンフィグレーション項目の詳細について説明します。
8.1.class コマンド
説明

LoRaWAN クラスを設定します。
※Class B は将来の為の予約です。本バージョンでは使用できません。

オプション

1. Class A
2. Class B
3. Class C

デフォルト値Class A

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. Class A
2. Class B
3. Class C

select number >プロセッサモード例) Class B に設定する場合
class 2(CRLF)

ショートコマンドclass の代わりに a を入力して下さい。
例) Class B に設定する場合(プロセッサモード)
a 2(CRLF)

p. 18

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.2.adr コマンド
説明

ADR(Adaptive Data Rate)機能を使用するかどうかを設定します。

オプション

1. ON

ADR を使用する

2. OFF

ADR を使用しない

デフォルト値ON

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. ON
2. OFF

select number >プロセッサモード例) ADR OFF に設定する場合
adr 2(CRLF)

ショートコマンドadr の代わりに b を入力して下さい。
例) ADR OFF に設定する場合(プロセッサモード)
b 2(CRLF)

p. 19

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.3.activate コマンド説明

Activation プロセスを選択します。

オプション

1. Over The Air Activation
2. Activation by Personalization

デフォルト値Over The Air Activation

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. Over The Air Activation
2. Activation by Personalization

select number >プロセッサモード例) Personalization に設定する場合
activate 2(CRLF)

ショートコマンドactivate の代わりに c を入力して下さい。
例) Personalization に設定する場合(プロセッサモード)
c 2(CRLF)

8.4.deveui コマンド
説明

Over The Air Activation で使用する任意の DevEUI 値を設定します。
DevEUI は、エンドデバイスを識別するエンドデバイス ID です。
※ モジュール出荷時には固有の DevEUI を設定してあります。

オプション

0000000000000000 ～ FFFFFFFFFFFFFFFF

デフォルト値

0000000000000000

ターミナルモード

設定値を 16 進数で入力して下さい。
please set DevEUI (8byte) >プロセッサモード例) 1234567890ABCDEF に設定する場合
deveui 1234567890ABCDEF(CRLF)

ショートコマンドdeveui の代わりに d を入力して下さい。
例) 1234567890ABCDEF に設定する場合(プロセッサモード)
d 1234567890ABCDEF(CRLF)

p. 20

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.5.appeui コマンド
説明

Over The Air Activation で使用する任意の AppEUI 値を設定します。
AppEUI は、サーバーアプリケーションを識別するアプリケーション ID です。

オプション

0000000000000000 ～ FFFFFFFFFFFFFFFF

デフォルト値

0000000000000000

ターミナルモード

設定値を 16 進数で入力して下さい。
please set AppEUI (8byte) >プロセッサモード例) 1234567890ABCDEF に設定する場合
appeui 1234567890abcdef(CRLF)

ショートコマンドappeui の代わりに e を入力して下さい。
例) 1234567890ABCDEF に設定する場合(プロセッサモード)
e 1234567890ABCDEF(CRLF)

8.6.appkey コマンド
説明

Over The Air Activation で使用する任意の AppKey 値を設定します。

オプション

00000000000000000000000000000000 ～FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF

デフォルト値

00000000000000000000000000000000

ターミナルモード

設定値を 16 進数で入力して下さい。
please set AppKey (16byte) >プロセッサモード例) 1234567890ABCDEF1234567890ABCDEF に設定する場合
appkey 1234567890ABCDEF1234567890ABCDEF(CRLF)

ショートコマンドappkey の代わりに f を入力して下さい。
例) 1234567890ABCDEF1234567890ABCDEF に設定する場合(プロセッサモード)
f 1234567890ABCDEF1234567890ABCDEF(CRLF)

p. 21

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.7.devaddr コマンド説明

Personalization で使用する任意の DevAddr 値を設定します。
DevAddr は、デバイスを識別する ID です。

オプション

00000000 ～ FFFFFFFF

デフォルト値

00000000

ターミナルモード

設定値を 16 進数で入力して下さい。
please set DevAddr (00000000 - FFFFFFFF) >プロセッサモード例) 12345678 に設定する場合
devaddr 12345678(CRLF)

ショートコマンドdevaddr の代わりに g を入力して下さい。
例) 12345678 に設定する場合(プロセッサモード)
g 12345678(CRLF)

8.8.nwkskey コマンド説明

Personalization で使用する任意の NwkSKey 値を設定します。

オプション

00000000000000000000000000000000 ～FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF

デフォルト値

00000000000000000000000000000000

ターミナルモード

設定値を 16 進数で入力して下さい。
please set NwkSKey (16byte) >プロセッサモード例) 1234567890ABCDEF1234567890ABCDEF に設定する場合
nwkskey 1234567890ABCDEF1234567890ABCDEF(CRLF)

ショートコマンドnwkskey の代わりに h を入力して下さい。
例) 1234567890ABCDEF1234567890ABCDEF に設定する場合(プロセッサモード)
h 1234567890ABCDEF1234567890ABCDEF(CRLF)

p. 22

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.9.appskey コマンド説明

Personalization で使用する任意の AppSKey 値を設定します。

オプション

00000000000000000000000000000000 ～FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF

デフォルト値

00000000000000000000000000000000

ターミナルモード

設定値を 16 進数で入力して下さい。
please set AppSKey (16byte) >プロセッサモード例) 1234567890ABCDEF1234567890ABCDEF に設定する場合
appskey 1234567890ABCDEF1234567890ABCDEF(CRLF)

ショートコマンドappskey の代わりに i を入力して下さい。
例) 1234567890ABCDEF1234567890ABCDEF に設定する場合(プロセッサモード)
i 1234567890ABCDEF1234567890ABCDEF(CRLF)

8.10.ack コマンド説明

対向ノードにデータを送信する際、ACK 受信を行うか否かを設定します。
スリープモードを使用する場合は ACK 受信の後にスリープモードに入ります。

オプション

1. ON

ACK 受信を行う

2. OFF

ACK 受信を行なわない

デフォルト値ON

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. ON
2. OFF

select number >プロセッサモード例) ACK を使用する場合
ack 1(CRLF)

ショートコマンドack の代わりに j を入力して下さい。
例) ACK を使用する場合(プロセッサモード)
j 1(CRLF)

p. 23

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.11.retry コマンド説明

Ack 受信が行えない場合のリトライ送信回数を設定します。
Ack 受信が OFF の場合は、リトライ送信を行いません。

オプション

0～8

デフォルト値

3

ターミナルモード

設定値を 10 進数で入力して下さい。
please set retry count (0 - 8) >プロセッサモード例) 5 回に設定する場合
retry 5(CRLF)

ショートコマンドretry の代わりに k を入力して下さい。
例) 5 回に設定する場合
k 5(CRLF)

8.12.rssi コマンド説明

データ受信時、受信データの先頭に受信電波強度を付与するか否かを設定します。
送信元ネットワークアドレスの付与が有効の場合、送信元ネットワークアドレスの前に付与します。

オプション

1. ON

RSSI を付与する

2. OFFRSSI を付与しない

デフォルト値

OFF

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. ON
2. OFF

select number >プロセッサモード例) RSSI を付与する場合
rssi 1(CRLF)

ショートコマンドrssi の代わりに l を入力して下さい。
例) RSSI を付与する場合(プロセッサモード)
l 1(CRLF)

p. 24

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.13.operation コマンド説明

動作モードを設定します。
初回電源投入時は必ずコンフィグレーションモードで起動します。
コンフィグレーションモードは、無線通信で使用する各種パラメータの設定を行うモードです。
オペレーションモードは、対向ノードと無線通信を行うモードです。

オプション

1. Configuration Mode
2. Operation Mode

デフォルト値

Configuration Mode

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. Config Mode
2. Operation Modeselect number >プロセッサモード例) オペレーションモードに設定する場合
operation 2(CRLF)

ショートコマンドoperation の代わりに m を入力して下さい。
例) オペレーションモードに設定する場合(プロセッサモード)
m 2(CRLF)

p. 25

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.14.baudrate コマンド
説明

UART 転送速度を設定します。

スリープモード(sleep コマンド)で UART 起床モードを使用する場合、UART 通信速度に次の制限があります。
・MCU 省電力モード(mculpmode コマンド)が STOP Mode の場合は、UART 通信
速度を 38400bps 以下に設定してください。
オプション

1. 9600
2. 19200
3. 38400
4. 57600
5. 115200
6. 230400

デフォルト値

115200ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. 9600
2. 19200
3. 38400
4. 57600
5. 115200
6. 230400

select number >プロセッサモード例) 9600bps に設定する場合
baudrate 1(CRLF)

ショートコマンドbaudrate の代わりに n を入力して下さい。
例) 9600bps に設定する場合(プロセッサモード)
n 1(CRLF)

p. 26

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.15.sleep コマンド説明

スリープモードを使用するか否かを設定します。
スリープモードは、class コマンドの設定が class A のときのみ有効です。

タイマー起床(Timer Wakeup)の場合、ACK 受信が有効であれば ACK 受信後、ACK受信が無効であればデータ送信後にスリープ状態となり、タイマー時間経過後に起床します。

割り込み起床(INT Wakeup)の場合、PA0 端子が High の場合はスリープ状態、Lowの場合は起床状態となります。
※

One time Tx の場合は PA0 端子が Low であっても無線データ送信完了時(ACK
ON の場合は ACK 受信完了時)に自動的にスリープ状態に遷移します。
(消費電流低減のために効果的です)

割り込み起床(INT Wakeup)を使用する場合は、必ずデータ送信後の OK 応答(あるいは NG 応答)を待ってからスリープ状態(PA0 端子を High)にして下さい。
※

送信途中で PA0 端子を High にした場合は送信を強制的に中断してスリープ状態に遷移します。

UART 起床(UART Wakeup)を STOP Mode(mculpmode 1)で使用する場合は、
UART 通信速度(baudrate)を 38400bps 以下に設定してください。

ES920LR3EB では、割り込み起床用に INT Switch を使用します。
オプション

1. No Sleep

スリープモードを使用しません

2. Timer Wakeup

スリープモード遷移後、タイマー時間経過後に起床します(送信完了時にスリープモード遷移)

3. INT Wakeup (Tx continue)
スリープモード遷移後、割り込み検出(Hi→Lo)で起床します(割り込み検出(Lo→Hi)でスリープモード遷移)
4. INT Wakeup (One time Tx)
スリープモード遷移後、割り込み検出(Hi→Lo)で起床します(割り込み検出(Lo→Hi)または送信完了時にスリープモード遷移)
5. UART Wakeup スリープモード遷移後、UART からの送信データ入力完了時に起床しますデフォルト値No Sleepターミナルモード

p. 27

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
設定値を下記の一覧から番号で選択して下さい。
1. No Sleep
2. Timer Wakeup
3. INT Wakeup (Tx continue)
4. INT Wakeup (One time Tx)
5. UART Wakeup

select number >プロセッサモード例) タイマー起床に設定する場合
sleep 2(CRLF)

ショートコマンドsleep の代わりに o を入力して下さい。
例) タイマー起床に設定する場合(プロセッサモード)o 2(CRLF)

8.16.sleeptime コマンド説明

タイマー起床設定でスリープ状態遷移後の起床時間を 100ms 単位で設定します。

オプション

1～864000

デフォルト値

50

ターミナルモード

設定値を 10 進数で入力して下さい。
please set sleep time (1 - 86400) >プロセッサモード例) 10 秒に設定する場合
sleeptime 100(CRLF)

ショートコマンドsleeptime の代わりに p を入力して下さい。
例) 10 秒に設定する場合(プロセッサモード)
p 100(CRLF)

p. 28

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.17.datarate コマンド
説明

Over the Air Activation の場合の Join-Accept 後のアップリンクデータレート、Personalization の場合のアップリンクデータレートを設定します。

プション

1. DR0

帯域幅 125kHz 拡散率 12

2. DR1

帯域幅 125kHz 拡散率 11

3. DR2

帯域幅 125kHz 拡散率 10

4. DR3

帯域幅 125kHz 拡散率 9

5. DR4

帯域幅 125kHz 拡散率 8

6. DR5

帯域幅 125kHz 拡散率 7

デフォルト値

DR2

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. DR02. DR1
3. DR2
4. DR3
5. DR4
6. DR5select number >プロセッサモード例) DR3 に設定する場合
datarate 4(CRLF)

ショートコマンドdatarate の代わりに q を入力して下さい。
例) DR2 に設定する場合(プロセッサモード)
q 3(CRLF)

p. 29

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.18.power コマンド説明

最大送信出力を設定します。

オプション

1. 13dBm
2. 11dBm
3. 9dBm
4. 7dBm

デフォルト値

13dBm

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. 13dBm
2. 11dBm
3. 9dBm
4. 7dBm

select number >プロセッサモード例) 9dBm に設定する場合
power 3(CRLF)

ショートコマンドpower の代わりに s を入力して下さい。
例) 9dBm に設定する場合(プロセッサモード)
s 3(CRLF)

p. 30

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.19.dtime コマンド
説明

DWellTime を設定します。
DWellTime が No Limit の場合は最大ペイロード長が 4 秒以内に送信可能なサイズ、
400ms の場合は最大ペイロード長が 400 ミリ秒以内に送信可能なサイズとなります。
※ DWellTime が No Limit の場合、ARIB STD-T108 の規定により 923.4MHz 以下のチャンネルを使用して下さい。

オプション

1. No Limit
2. 400ms

デフォルト値No Limit

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. No Limit
2. 400ms

select number >プロセッサモード例) 400ms に設定する場合
dtime 2(CRLF)

ショートコマンドdtime の代わりに t を入力して下さい。
例) No Limit に設定する場合
t 1(CRLF)

p. 31

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.20.duty コマンド説明

Duty Cycle を設定します。
Duty Cycle が No Limit の場合、送信完了後、次送信開始の待ち時間が発生しません。
Duty Cycle が< 1%の場合、送信完了後、次送信開始まで送信時間×100 の待ち時間が発生します。

※ 通常は< 1%を使用して下さい。
オプション

1. No Limit
2. < 1%

デフォルト値< 1%

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. No Limit
2. < 1%

select number >プロセッサモード例) No Limit に設定する場合
duty 1(CRLF)

ショートコマンドdtime の代わりに u を入力して下さい。
例) No Limit に設定する場合
u 1(CRLF)

p. 32

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.21.version コマンド説明

本ソフトウェアのバージョンを取得します。

オプション

なし

デフォルト値なし

ターミナルモード-

プロセッサモード例) バージョンを取得する場合
version(CRLF)※応答としてバージョン番号を BCD 値で返却します。
VER 1.00(CRLF)

ショートコマンドversion の代わりに v を入力して下さい。
例) バージョンを取得する場合(プロセッサモード)v(CRLF)※応答としてバージョン番号を BCD 値で返却します。
VER 1.00(CRLF)

8.22.save コマンド説明

内蔵 FlashROM にコンフィグレーション設定を保存します。

オプション

なし

デフォルト値なし

ターミナルモード-

プロセッサモード例) コンフィグレーション値を保存する場合
save(CRLF)

ショートコマンドsave の代わりに w を入力して下さい。
例) コンフィグレーション値を保存する場合(プロセッサモード)
w(CRLF)

p. 33

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.23.load コマンド説明

全てのコンフィグレーション設定にデフォルト値を適用します。
デフォルト値を保存する場合は、save コマンドを実行して下さい。

オプション

なし

デフォルト値なし

ターミナルモード-

プロセッサモード例) デフォルト値を適用する場合
load(CRLF)

ショートコマンドload の代わりに x を入力して下さい。
例) デフォルト値を適用する場合(プロセッサモード)
x(CRLF)8.24.show コマンド説明

現在の設定値を表示します。
本コマンドは、ターミナルモードでのみ使用可能です。

オプション

なし

デフォルト値なし

ターミナルモード-

プロセッサモード-

ショートコマンドshow の代わりに y を入力して下さい。

p. 34

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
8.25.start コマンド説明

コンフィグレーションモードを終了し、オペレーションモードに遷移します。

オプション

なし

デフォルト値なし

ターミナルモード-

プロセッサモード例) オペレーションモードに遷移する場合
start(CRLF)

ショートコマンドstart の代わりに z を入力して下さい。

8.26.format コマンド説明

ペイロードのデータフォーマットを設定します。

オプション

1. ASCII

ペイロードに ASCII データを含みます。

2. BINARY

ペイロードに BINARY データを含みます。

デフォルト値ASCII

ターミナルモード

設定値を下記の一覧から番号で選択して下さい。
1. ASCII
2. BINARY

select number >プロセッサモード例) BINARY に設定する場合
format 2(CRLF)

ショートコマンドformat の代わりに A を入力して下さい。
例) BINARY に設定する場合(プロセッサモード)
A 2(CRLF)

p. 35

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
9. コンフィグレーション応答
コマンド仕様ソフトウェアのコンフィグレーション時の応答について説明します。
9.1.レスポンス書式(ASCII フォーマット)
レスポンス [レスポンスコード]・レスポンスとレスポンスコードの間には必ず半角スペースを挿入します。
・レスポンスの終端には改行コード(CRLF)を付与します。
・レスポンスコードについては 9.3 レスポンスコード一覧を参照して下さい。
9.2.レスポンス書式(BINARY フォーマット)

・出力長にはレスポンス部とレスポンスコード部を合わせたデータ長を出力します。
・レスポンス部には OK あるいは NG をアスキーコードで出力します。
・レスポンス部が NG の場合、半角スペースとレスポンスコードをアスキーコードで出力します。
・レスポンスコードについては 9.3 レスポンスコード一覧を参照して下さい。

p. 36

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
9.3.レスポンスコード一覧

レスポンス

レスポンスコード

説明

OK

-

正常応答にはレスポンスコードを付与しません。

NG

001

未定義コマンド

002

オプション値異常

003

FlashROM 消去異常

004

FlashROM 書込異常

005FlashROM 読込異常006

FlashROM ベリファイ異常

007

予備

008

予備

009

予備

100

送信データ長異常

101

送信異常(Join プロセス中)

102

送信異常(次送信可能時間待ち)

103

送信異常(キャリアセンス検出)

104

ACK 未受信105

送信異常(送信未完了)

106

予備

107

予備

108

予備

109

予備

VER

Major.Minor

バージョン番号を BCD 値で付与します。
Major 1 桁、Minor 2 桁です。
例 ) VER 1.00

JOIN

-

WAKE

-

Over The Air Activation で Join-Accept を受信した際に出力します。
sleep モードから起床した際に出力します。

p. 37

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
10. データフレーム
本章は、UART、RF データのデータフレームついて説明します。
10.1.UART 入力データ(ASCII フォーマット)
オペレーションモード時、ターミナルソフトウェアあるいはホストマイコンから RF 送信データを入力します。
入力データは以下のフォーマットで入力して下さい。

入力データ：任意の文字(ASCII コード)を入力して下さい。

※ 入力データ最大長は、データレートと DWellTime の設定値に応じて変動します。

データレートDWellTime が No Limit の場合

DWellTime が 400ms の場合(送信時間が 4 秒以内)

(送信時間が 400ms 以内)

DR0

51

0

DR1

51

0

DR2

51

11

DR3

115

53

DR4

242

125

DR5

242

242

※ CR+LF は無線データとして送信しません。
※ RF データ送信後、応答を返却します。詳細は 9.3.レスポンスコード一覧を参照して下さい。

p. 38

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
10.2.UART 入力データ(BINARY フォーマット)
オペレーションモード時、ターミナルソフトウェアあるいはホストマイコンから RF 送信データを入力します。
入力データは以下のフォーマットで入力して下さい。

入力長：入力データ部のデータ長を入力して下さい。

入力データ：任意の値(バイナリ)を入力して下さい。

※ 入力データ最大長は、データレートと DWellTime の設定値に応じて変動します。
※ CR+LF は不要です。
※ RF 送信データの入力後、応答を返却します。詳細は 9.3.レスポンスコード一覧を参照して下さい。

p. 39

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
10.3.UART 出力データ(ASCII フォーマット)
オペレーションモード時、RF 受信データをターミナルソフトウェアあるいはホストマイコンに出力します。
受信電波強度(RSSI)付与設定が OFF の場合、RF 受信データは以下のフォーマットで出力します。

出力データ：任意の文字(ASCII コード)を出力します。

※ 出力データ最大長は、サーバーからの送信データ長に依存します。
※ 受信データの末尾に CR+LF を付与します。
受信電波強度(RSSI)付与設定が ON の場合、RF 受信データは以下のフォーマットで出力します。

RSSI：RSSI 値をアスキーコードで出力します。符号付数字として扱って下さい。
(受信電波強度(RSSI)付与設定を ON にしている場合のみ出力します。)

出力データ：任意の文字(ASCII コード)を出力します。

※ 出力データ最大長は、サーバーからの送信データ長に依存します。
※ 受信データの末尾に CR+LF を付与します。

p. 40

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
10.4.UART 出力データ(BINARY フォーマット)
オペレーションモード時、RF 受信データをターミナルソフトウェアあるいはホストマイコンに出力します。
受信電波強度(RSSI)付与設定が OFF の場合、RF 受信データは以下のフォーマットで出力します。

出力長：出力データ部のデータ長を出力します。

出力データ：任意の値(バイナリ)を出力します。

※ 出力データ最大長は、サーバーからの送信データ長に依存します。
※ 受信データの末尾に CR+LF は付与しません。
受信電波強度(RSSI)付与設定が ON の場合、RF 受信データは以下のフォーマットで出力します。

出力長：RSSI＋出力データ部のデータ長を出力します。

RSSI：RSSI 値をアスキーコードで出力します。符号付数字として扱って下さい。
(受信電波強度(RSSI)付与設定を ON にしている場合のみ出力します。)

出力データ：任意の値(バイナリ)を出力します。

※ 出力データ最大長は、サーバーからの送信データ長に依存します。
※ 受信データの末尾に CR+LF は付与しません。

p. 41

株式会社 EASEL特定小電力無線モジュール ES920LR3 LoRaWAN
コマンド仕様ソフトウェア説明書
10.5.RF 入出力データ
オペレーションモード時、UART 入力データから RF 送信データを生成します。
また、RF 受信データから UART 出力データを生成します。
RF 送受信のパケットフォーマットは、LoRaWAN 仕様で規定されるフォーマットに従います。

MHDR：LoRaWAN 仕様で規定される MAC ヘッダです。

FHDR：LoRaWAN 仕様で規定されるフレームヘッダです。

FPort：LoRaWAN 仕様で規定されるポートフィールドです。
本ソフトウェアでは、常に 2 として扱います。

FRMPayload：LoRaWAN 仕様で規定されるフレームペイロードです。
UART から入力されたデータを格納します。

※ FRMPayload 長は、データレートと DWellTime の設定値に応じて変動します。

データレートDWellTime が No Limit の場合

DWellTime が 400ms の場合(送信時間が 4 秒以内)

(送信時間が 400ms 以内)

DR0

51

0

DR1

51

0

DR2

51

11

DR3

115

53

DR4

242

125

DR5

242

242

p. 42

株式会社 EASEL