特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
Version. 1.10

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書

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

株式会社EASEL〒226-0018
神奈川県横浜市緑区⻑津⽥みなみ台5-7-8
https://easel5.com

改訂履歴
版数

⽇付

改訂内容

1.00

2016.2.6

初版

1.01

2017.3.7・channel コマンド削除
・datarate コマンド機能変更
・power コマンド機能変更
・DWellTime のデフォルト値変更
・duty コマンド追加
・データフレームのペイロード最⼤⻑を修正

1.10

2017.10.31

・データフレームのペイロード最⼤⻑を修正
・下記の機能を追加
8.27 format コマンド
10.2. UART ⼊⼒データ(BINARY フォーマット)
10.4. UART 出⼒データ(BINARY フォーマット)

p. 1株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書

⽬次
1.

概要 ....................................................................................................................................................... 4

2.

開発環境 ................................................................................................................................................ 5

3.

評価ボード ............................................................................................................................................ 64.

外部インターフェース .......................................................................................................................... 8

5.

ソフトウェア構成 ................................................................................................................................. 96.

動作モード .......................................................................................................................................... 10

7.

コンフィグレーション項⽬ ................................................................................................................. 13

8.

7.1.

コンフィグレーション項⽬⼀覧 .................................................................................................. 13

7.2.

コマンド書式 ............................................................................................................................... 15

7.3.

ホストマイコンからのコンフィグレーション⼿順 ..................................................................... 16

コンフィグレーション項⽬詳細 ......................................................................................................... 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 コマンド ......................................................................................................................... 22

8.8.

nwkskey コマンド ........................................................................................................................ 22

8.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特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
8.24.

show コマンド .......................................................................................................................... 34

8.25.

start コマンド ........................................................................................................................... 35

8.26.

help コマンド ........................................................................................................................... 35

8.27.

format コマンド ....................................................................................................................... 36

9.

コンフィグレーション応答 ................................................................................................................. 37
9.1.

レスポンス書式 ............................................................................................................................ 37

9.2.

レスポンス書式(BINARY フォーマット).................................................................................... 37

9.3.

レスポンスコード⼀覧 ................................................................................................................. 38

10.

データフレーム ............................................................................................................................... 39

10.1.

UART ⼊⼒データ(ASCII フォーマット) ................................................................................ 39

10.2.

UART ⼊⼒データ(BINARY フォーマット) ............................................................................ 40

10.3.

UART 出⼒データ(ASCII フォーマット) ................................................................................ 41

10.4.

UART 出⼒データ(BINARY フォーマット) ............................................................................ 42

10.5.

RF ⼊出⼒データ ...................................................................................................................... 43

p. 3

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
1. 概要
本書は、LoRaWAN 仕様 1.0.2 に準拠した 920MHz 帯無線通信⽤モジュールソフトウェアについて説
明します。

p. 4

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
2. 開発環境① 統合開発環境
IAR Embedded Workbench™ for Arm※ 30⽇間期間限定版 (ユーザ登録要)https://www.iar.com/jp/iar-embedded-workbench/#!?currentTab=free-trials※ 30⽇間を超えて使⽤する場合は製品の購⼊が必要です。
② デバッガIAR SYSTEM I-jet③ 920MHz帯無線モジュール
ES920LR④ 評価ボード
ES920EB⑤ USBケーブル⑥ USBドライバ
FTDI D2XX Driver
http://www.ftdichip.com/Drivers/D2XX.htm⑦ ターミナルソフトウェア
Tera Term
http://www.forest.impress.co.jp/library/software/utf8teraterm/p. 5株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
3. 評価ボード
ES920EB評価ボードについて説明します。

①
⑦

⑤
⑥

⑫
⑨

③

⑧

②
④

⑪

⑩
図. ES920EB 評価ボード
表. ES920EB 評価ボード説明

#

名称

説明

1

ES920LRMCU NXP 製 KL16Z128 (Cortex-M0+)
FlashROM 128kbyte, RAM 16kbyte
http://cache.nxp.com/files/microcontrollers/doc/ref_manual/KL16P80M48SF4RM.pdf

2

USB ミニコネクタ

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

3

USB シリアル変換 IC

FTDI 社 FT232RL

4

USB Tx/Rx LED

USB 送受信確認⽤ LED

5リセットスイッチ

リセットスイッチ

6

汎⽤スイッチ

汎⽤スイッチ7

汎⽤ LED汎⽤ LED

8

ジャンパ BATT/USB_P

電源選択

9

ジャンパ P_SHORT/OPEN

SWD 電源選択

10

BATT-,BATT+

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

11

SWD コネクタ

デバッガ接続⽤12

外部端⼦

下記ピンアサイン参照

p. 6

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
表. ES920EB 外部端⼦ピンアサイン
ピン番号

ピン名称

基本機能

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

1

GND

2

GND

３

VCCRF

4

PTE0

5

-

NC

6

PTA20

RESETB

7

-

NC

8

-

NC

9

PTA0

SWCLK

10

PTE19

11

PTA3

12

PTE18

13

-

NC

14

PTE17

GPIO(OUT)

15

PTA2

UART_TX16

PTE16

GPIO(OUT)

17

PTA1

UART_RX

18

-

NC

19

PTB0

20

-

21

PTB1

22

PTC1

23

PTE30

DAC0_OUT/ADC0_SE23

24

PTA19

UART1_TX

25

VCC

26

PTA18

ADC0_DM2/ADC0_SE6a/SPI0_MISO/I2C0_SCL/SPI0_MOSI
SWDIO
ADC0_DP2/ADC0_SE2/SPI0_MOSI/I2C0_SDA/
SPI0_MISO
ADC0_DM1/ADC0_SE5a/SPI0_SCK/UART2_RX
ADC0_DP1/ADC0_SE1/SPI0_PCS0/UART2_TX

ADC0_SE8/I2C0_SCL
NC
ADC0_SE9/I2C0_SDA
GPIO(IN)

UART1_RX※基本機能は、本ソフトウェアでの設定値になります。
基本機能が空⽩のピンは GPIO に割当てており、全て出⼒ピンとなっています。
各ピン機能は、ソフトウェアの設定により変更することが可能です。

p. 7

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

名称

項⽬

説明

1

USB ミニコネクタ

ボーレート

115200bps

2

データ⻑

8bit

3

パリティ

なし

4

ストップビット

1bit

5

フロー制御

なし

INT

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

6

汎⽤スイッチ

未使⽤
オペレーションモード
Low : Wake-Up
High : Sleep
7

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

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

8ジャンパ BATT/USB_P

9
10
11

ジャンパ P_SHORT/OPEN

BATT

バッテリ電源供給

USB_P

USB 電源供給

PSHORT

SWD 電源供給

OPEN

バッテリ、USB 電源供給

p. 8株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
5. ソフトウェア構成
LoRaWAN 仕様ソフトウェアのソフトウェア構成について説明します。

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

p. 9

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

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

PC

プロセッサモード

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

p. 10

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

UART からコマンドを受け付け、LoRaWAN クラス設定や ADR 設

モード

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

オペレーションモード

UART から⼊⼒したデータを送信先ノードに送信します。
また、他ノードから受信したデータを UART に出⼒します。
UART から config を⼊⼒した場合、電源再投⼊時にコンフィグレー
ションモードに戻ります。

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

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

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

オペレーションモード

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

p. 11

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

電源投⼊(2 回⽬以降)

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

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

オペレーションモード

図. 2 回⽬以降コンフィグレーションモードで起動
前回起動時にオペレーションモードを選択した場合、オペレーションモードを起動します。
※オペレーションモードからコンフィグレーションモードに戻る場合は config を⼊⼒して下さい。

電源投⼊(2 回⽬以降)

オペレーションモード

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

p. 12

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

ショート

設定内容

デフォルト

設定範囲

備考

class A

class A

class B、C は将来の為の予class B

約

コマンド
class

a

LoRaWAN クラス設定

class C
adrb

ADR 設定ON

ON
OFF

activatec

アクティベーション設定

OTAA

Over The Air Activation
Activation by Personalization

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
Operationp. 13

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書

コマンド

ショート

設定内容

デフォルト

設定範囲

備考

UART 転送速度設定

115200bps

9600bps

調歩同期モードコマンド
baudraten

19200bps
38400bps
57600bps
115200bps
230400bps
sleepo

スリープモード設定

No Sleep

No Sleep
Timer Wakeup
INT Wakeup

sleeptimep

スリープ時間設定

5秒

1〜864000

100ms 単位
10 = 1 秒

datarateq

データレート設定

DR2

DR0
DR1
DR2
DR3
DR4
DR5

power

s

最⼤送信出⼒設定

13dBm

13dBm
12dBm
10dBm
8dBm

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

設定

VER 0.6.0 以降

BINARYp. 14

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
7.2. コマンド書式● コマンド書式
コマンド [コマンドオプション]・コマンドとコマンドオプションの間には必ず半⾓スペースを挿⼊して下さい。
・コマンドの終端には改⾏コード(CRLF)を付与して下さい。
・コマンドオプションについてはコンフィグレーション項⽬詳細を参照して下さい。

p. 15

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

ホストマイコンPower ON

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

モード選択(processor CRLF)

受付プロンプト(OK CRLF)

LoRaWAN クラス設定(class 1 CRLF)

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

受付プロンプト(OK CRLF)

・DevEUI・AppEUI
・スリープモード設定

ADR 設定(adr 1 CRLF)など
受付プロンプト(OK CRLF)

設定値保存(save CRLF)

受付プロンプト(OK CRLF)

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

受付プロンプト(OK CRLF)

start コマンド以降は、ゲートウェイと無線通信を⾏います。

p. 16

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

p. 17

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

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

オプション

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特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
8.13.

operation コマンド説明

動作モードを設定します。
初回電源投⼊時は必ずコンフィグレーションモードで起動します。
コンフィグレーションモードは、無線通信で使⽤する各種パラメータの設定を⾏うモードです。
オペレーションモードは、ゲートウェイと無線通信を⾏うモードです。

オプション

1. Configuration
2. Operation

デフォルト値

Configuration

ターミナルモード

設定値を下記の⼀覧から番号で選択して下さい。
1. Configuration
2. Operation

select number >プロセッサモード例) オペレーションモードに設定する場合
operation 2(CRLF)

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

p. 25

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
8.14.

baudrate コマンド

説明

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

オプション

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特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
8.15.

sleep コマンド説明

スリープモードを使⽤するか否かを設定します。

タイマー起床の場合、ACK 受信が有効であれば ACK 受信後、ACK 受信が無効であればデータ送信後にスリープ状態となり、タイマー時間経過後に起床します。
割り込み起床の場合、PTC1 端⼦が High の場合はスリープ状態、Low の場合は起床状態となります。
割り込み起床を使⽤する場合は、必ずデータ送信後の OK 応答(あるいは NG 応答)
を待ってからスリープ状態として下さい。
オプション

1. No Sleep

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

2. Timer Wakeup

スリープモード遷移後、タイマー時間経過後に起床します

3. INT Wakeup

スリープモード遷移後、割り込み検出で起床します

デフォルト値No Sleepターミナルモード

設定値を下記の⼀覧から番号で選択して下さい。
1. No Sleep
2. Timer Wakeup
3. INT Wakeup

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

ショートコマンドsleep の代わりに o を⼊⼒して下さい。
例) タイマー起床に設定する場合
o 2(CRLF)

p. 27

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
8.16.

sleeptime コマンド説明

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

オプション

1〜864000

デフォルト値50 (5 秒)ターミナルモード

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

ショートコマンドsleeptime の代わりに p を⼊⼒して下さい。
例) 10 秒に設定する場合
p 100(CRLF)

p. 28

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
8.18.

power コマンド説明

最⼤送信出⼒を設定します。

オプション

1. 13dBm
2. 12dBm
3. 10dBm
4. 8dBm

デフォルト値

13dBm

ターミナルモード

設定値を下記の⼀覧から番号で選択して下さい。
1. 13dBm
2. 12dBm
3. 10dBm
4. 8dBm

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

ショートコマンドpower の代わりに s を⼊⼒して下さい。
例) 9dBm に設定する場合
s 3(CRLF)

p. 30

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
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特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
8.23.

load コマンド説明

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

オプション

なし

デフォルト値なし

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

ショートコマンドload の代わりに x を⼊⼒して下さい。
例) デフォルト値を適⽤する場合
x(CRLF)

8.24.

show コマンド説明

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

オプション

なし

デフォルト値なし

ターミナルモードープロセッサモードーショートコマンドshow の代わりに y を⼊⼒して下さい。

p. 34

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
8.25.

start コマンド説明

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

オプション

なし

デフォルト値なし

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

ショートコマンド8.26.

start の代わりに z を⼊⼒して下さい。

help コマンド説明

コマンド⼀覧を表⽰します。
本コマンドは、ターミナルモードでのみ使⽤可能です。

オプション

なし

デフォルト値なし

ターミナルモードープロセッサモードーショートコマンドhelp の代わりに ? を⼊⼒して下さい。

p. 35

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
8.27.

format コマンド説明

ペイロードのデータフォーマットを設定します。
本コマンドは、ファームウェアバージョン 0.6.0 以降で対応します。

オプション

1. ASCII

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

2. BINARY

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

デフォルト値ASCII

ターミナルモード

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

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

ショートコマンドformat の代わりに A を⼊⼒して下さい。
例) BINARY に設定する場合
A 2(CRLF)

p. 36

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
9. コンフィグレーション応答
LoRaWAN 仕様ソフトウェアのコンフィグレーション時、オペレーション時の応答について説明します。
9.1. レスポンス書式
レスポンス [レスポンスコード]・レスポンスとレスポンスコードの間には必ず半⾓スペースを挿⼊します。
・レスポンスの終端には改⾏コード(CRLF)を付与します。
・レスポンスコードについてはレスポンスコード⼀覧を参照して下さい。
9.2. レスポンス書式(BINARY フォーマット)・出⼒⻑にはレスポンス部とレスポンスコード部を合わせたデータ⻑を出⼒します。
・レスポンス部には OK あるいは NG をアスキーコードで出⼒します。
・レスポンス部が NG の場合、半⾓スペースとレスポンスコードをアスキーコードで出⼒します。
・レスポンスコードについてはレスポンスコード⼀覧を参照して下さい。

p. 37

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

レスポンスコード

説明

OK

-

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

NG

001

未定義コマンド

002

オプション値異常

003

FlashROM 消去異常

004

FlashROM 書込異常

005FlashROM 読込異常

006

予備

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.0.0

JOIN

-

WAKE

-

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

p. 38

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
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.2.レスポンスコード⼀覧を参照して下さい。

p. 39

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
10.2.

UART ⼊⼒データ(BINARY フォーマット)

オペレーションモード時、ターミナルソフトウェアあるいはホストマイコンから RF 送信データを⼊⼒します。
⼊⼒データは以下のフォーマットで⼊⼒して下さい。

⼊⼒⻑：⼊⼒データ部のデータ⻑を⼊⼒して下さい。

⼊⼒データ：最⼤ 50byte の任意の値(バイナリ)を⼊⼒して下さい。

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

p. 40

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
10.3.

UART 出⼒データ(ASCII フォーマット)

オペレーションモード時、RF 受信データをターミナルソフトウェアあるいはホストマイコンに出⼒します。
受信電波強度(RSSI)付与設定が OFF の場合、RF 受信データは以下のフォーマットで出⼒します。

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

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

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

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

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

p. 41

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
LoRaWAN 仕様ソフトウェア説明書
10.4.

UART 出⼒データ(BINARY フォーマット)

オペレーションモード時、RF 受信データをターミナルソフトウェアあるいはホストマイコンに出⼒します。
受信電波強度(RSSI)付与設定が OFF の場合、RF 受信データは以下のフォーマットで出⼒します。

出⼒⻑：出⼒データ部のデータ⻑を出⼒します。

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

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

出⼒⻑

：RSSI＋出⼒データ部のデータ⻑を出⼒します。

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

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

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

p. 42

株式会社 EASEL特定⼩電⼒無線モジュール ES920LR
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. 43

株式会社 EASEL