TWELITE の公式資料

TWELITE とは mono-wiress.com の 802.15.4 専用モジュール。

製品は素晴らしいのだが、資料はどこ？ あるにはあるのだが、一覧性に乏しく大変わかりづらい。

以下ばらけた公式資料のまとめ。


# ハードウェア

## 製品

### TWELITE

13.97mm x 13.97mm の SMDタイプのモジュール。出力の違い、アンテナコネクタの違いで合計4種類（2020/3/22現在）。

https://mono-wireless.com/jp/products/TWE-LITE/index.html
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/139524/210ae291-3bfb-78c3-389d-fa5b180eb2d3.png)

中身は NXP JN5164 (TWE-LITE) JN5148 ( TWE-Regular, Strong ・・・旧製品？) ぽい
https://mono-wireless.com/download/SDK/TWESDK_201404/ToCoNet_SDK_manual_20140404.pdf

### TWELITE DIP

SMD の TWELITE モジュールをDIP化したもの。
出力の違い、アンテナコネクタの違いで合計4種類（2020/3/22現在）。
https://mono-wireless.com/jp/products/TWE-Lite-DIP/index.html
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/139524/7ac0e4f7-91c9-5a60-0b5b-2cf02480f7fe.png)

### TWELITE PAL

DIP形式のモジュールにCR2032の電池ケース搭載。PALアプリがインストールされている。


### TWE-LITE-2525A

25mm角のモジュールにアンテナ、CR2032の電池ケース、加速度センサ搭載。
無線タグアプリがインストールされている。
https://mono-wireless.com/jp/products/TWE-Lite-2525A/index.html


### TWELITE R2

USB接続するためのアダプター

https://mono-wireless.com/jp/products/TWE-LITE-R/index.html

### 他

https://mono-wireless.com/jp/products/index.html

## データシート

TWELITE データシート
https://mono-wireless.com/jp/products/TWE-LITE/MW-PDS-TWELITE-JP.pdf

TWELITE DIP データシート
https://mono-wireless.com/jp/products/TWE-Lite-DIP/MW-PDS-TWELITEDIP-JP.pdf

TWELITE PAL データシート
https://mono-wireless.com/jp/products/twelite-pal/BnR/MW-PDS-BRPAL-JP.pdf

USB アダプター TWELITE R2 データシート
https://mono-wireless.com/jp/products/TWE-LITE-R/MW-PDS-MWR2-JP.pdf

NXP JN5164
https://www.nxp.com/part/JN5164#/

JN5164Aのデータシート
https://www.nxp.com/docs/en/data-sheet/JN516X.pdf

## アンテナの種類と電波の方向

https://mono-wireless.com/jp/products/TWE-ANTENNAS/omni/wire-ant.html

### 自作アンテナ

https://mono-wireless.com/jp/products/TWE-ANTENNAS/design/Antenna_Whip_Variation.pdf
https://mono-wireless.com/jp/products/TWE-ANTENNAS/omni/wire-ant.html の「ワイヤアンテナの自作」

### アンテナ設置

「設置ガイド - 良好な通信をさせるために」
フレネルゾーンの説明はここにある
https://mono-wireless.com/jp/products/TWE-ANTENNAS/design/range.html

## 基板のアンテナ開口部

データシート参照
https://mono-wireless.com/jp/products/TWE-LITE/MW-PDS-TWELITE-JP.pdf


# ソフトウェア

## アプリケーションソフト

いくつかの用途用にそのままま使えるアプリが用意されている。
使用許諾条件を満たせば変更も含め、無償で利用可能。


- 超簡単！標準アプリ
- 無線タグアプリ
- リモコンアプリ
- シリアル通信アプリ
- パルアプリ
- 親機・中継機用アプリ
- RC専用アプリ
- オーディオ・アナログ信号通信アプリ


https://mono-wireless.com/jp/products/TWE-APPS/index.html


### 超簡単！標準アプリ

TWELITE、TWELITE DIP の 製品出荷時に書きこまれているアプリケーション。
１つの親機と複数の子機の間でデジタル信号、アナログ信号、UARTの双方向通信などができる。

クイックマニュアル(PDF)
https://mono-wireless.com/jp/products/TWE-APPS/App_Twelite/app_twelite.pdf

「超簡単！標準アプリ」
https://mono-wireless.com/jp/products/TWE-APPS/App_Twelite/index.html

「超簡単！標準アプリ使用方法（目次）」
https://mono-wireless.com/jp/products/TWE-APPS/App_Twelite/step0.html

シリアルで受信できる相手からの状態通知データフォーマット
https://mono-wireless.com/jp/products/TWE-APPS/App_Twelite/step3-81.html

シリアルでの通信条件
https://mono-wireless.com/jp/products/TWE-APPS/App_Twelite/step3.html#1

インタラクティブモード
https://mono-wireless.com/jp/products/TWE-APPS/interactive.html


## 書き込み方法

### TWELITE R2を使う方法

https://mono-wireless.com/jp/products/TWE-LITE-R/index.html

### TTL-UART(一般的なUSBシリアルモジュールなど)を使う書き込み方法

https://mono-wireless.com/jp/tech/Hardware_guide/UART-USB-WR.html

ただし、jenprog ユーティリティはリンク切れ

TWELITEプログラマ ないし tweterm.py を使用。

(2020/4/1追加 上記ページは改められ、接続図だけになっている。tweterm.pyについては↓)

https://sdk.twelite.info/twelite-sdkno/fumuua/tweterm.py

Windows 用 TWELITEプログラマ
https://mono-wireless.com/jp/products/TWE-APPS/LiteProg/index.html

## 詳細マニュアル

SDK Webマニュアル
https://sdk.twelite.info/twelite-sdkno/twelite-sdknoinsutru


昔のマニュアル？
ToCoNet SDK マニュアル(2014-04)
https://mono-wireless.com/download/SDK/TWESDK_201404/ToCoNet_SDK_manual_20140404.pdf


## SDK

TWELITE STAGE として配布
開発形態は TWELITE NET と MWXの2つがある。

過去は TWELITE NET のための開発環境は 「Cライブラリ SDK」、MWX のための開発環境は 「MWXライブラリ SDK」と呼称され、別々に配布されていたが、TWELITE NET 1.3.0 (2020/04) 以降は TWELITE STAGE として配布されている。


## 開発ツールの入手先

### TWELITE STAGE

「最新版の取得 - TWENET_JP」
https://sdk.twelite.info/latest

### 過去の C ライブラリ、 MWXライブラリのリンク

「TWELITE SDK ソフトウエア開発環境 カスタムアプリを作成する。」
https://mono-wireless.com/jp/products/TWE-NET/index.html

## MWX ライブラリ

マニュアル
https://mwx.twelite.info/

## C ライブラリ

マニュアル
https://sdk.twelite.info/


### VSCode でのビルド

https://sdk.twelite.info/twelite-sdkno/vscode-deno

### pdf

ToCoNet SDK マニュアル - モノワイヤレス株式会社


## 動作フロー


https://sdk.twelite.info/tweliet-net-api-jie-shuo/twenet-fur


## ToCoNet

ToCoNet については、言葉の定義が見つからない。
しかしながら、 802.15.4上に構築された mono-wiress 独自プロトコルと考えると、言葉の利便性が良い。


cf.,
ToCoNet SDK マニュアル
https://mono-wireless.com/download/SDK/TWESDK_201404/ToCoNet_SDK_manual_20140404.pdf
71ページ
「ToCoNet の通信方式」



# 非公式情報

以下はサンプルプログラムの詳解。
非公式だが、「＊＊が本当に必要だったもの」。
http://www.gyabinet.com/app_twelite_docref/html/index.html


Takashi Matsuoka さんの「TOCOS TWE-Liteをつかってみた」
今はなくなってしまった資料に対するリンクなども含まれる。
https://www.slideshare.net/TakashiMatsuoka2/tocos-twelite

「TWELITE DIP のピン配置」
https://qiita.com/nanbuwks/items/704f8c820e6eb8498c3d