MWSDK(TWELITE SDK)
MONO WIRELESS INC.
MWSDK
MWSDK
  • TWELITE SDK (MWSDK) マニュアル
  • はじめに
    • TWELITE SDK 利用規定
    • サポート、対応
    • モノワイヤレスソフトウェア使用許諾書
    • TWELITE SDKの構成
  • 最新版の取得
    • TWELITE SDK 改版履歴
  • TWELITE SDKの使用法
    • TWELITE SDKのインストール
    • VSCode での利用
    • フォルダ構成
    • コマンドラインでのビルド方法
    • ビルド定義について
      • Makefile について
      • Version.mk について
      • binファイル命名則
    • ファームウェア書換
      • ファームウェア書換用配線
      • tweterm.py
  • TWELIET NET API 解説
    • 用語
    • TWELITE NET ライブラリ構造
    • TWENET 動作フロー
      • 始動フロー
      • メインループフロー
      • 無線関連フロー
      • ハードウェアフロー
      • ユーザ定義イベント処理関数フロー
    • ソースコードの構造
    • モジュール
    • 無線パケット
      • パケットの最大長
      • アドレスの指定
      • アプリケーションID
    • ネットワークについて
      • 単純ネット
        • 送信
        • 受信
      • 中継ネット
        • 親機の実装
        • 中継器の実装
        • 子機の実装 (MININODES)
        • NBビーコン方式の接続
        • 中継ネットのアドレス
        • 上位アドレスを固定した静的中継
  • TWELITE NET API リファレンス
    • コールバック関数
      • cbAppColdStart()
      • cbAppWarmStart()
      • cbToCoNet_vMain()
      • cbToCoNet_vRxEvent()
      • cbToCoNet_vTxEvent()
      • cbToCoNet_vNwkEvent()
      • cbToCoNet_vHwEvent()
      • cbToCoNet_u8HwInt()
    • TWELITE NET関数
      • ToCoNet_vMacStart()
      • ToCoNet_bMacTxReq()
      • ToCoNet_u32GetSerial()
      • ToCoNet_u32GetRand()
      • ToCoNet_vSleep()
      • ToCoNet_vDebugInit()
      • ToCoNet_vDebugLevel()
      • ToCoNet_u32GetVersion()
      • ToCoNet_bRegisterAesKey()
      • ToCoNet_vRfConfig()
      • ToCoNet_vChConfig()
      • ToCoNet_Tx_vProcessEventQueue()
      • ToCoNet_u16RcCalib()
    • 中継ネット API
      • functions
        • ToCoNet_Nwk_bInit()
        • ToCoNet_Nwk_bStart()
        • ToCoNet_Nwk_bPause()
        • ToCoNet_Nwk_bResume()
        • ToCoNet_Nwk_bTx()
      • Structure
        • tsTxDataApp (中継ネット)
        • tsRxDataApp (中継ネット)
        • tsToCoNet_Nwk_Context
      • LayerTree ネット
        • ToCoNet_NwkLyTr_psConfig()
        • ToCoNet_NwkLyTr_psConfig_MiniNodes()
        • tsToCoNet_NwkLyTr_Context
    • 型 typedef, よく使うマクロ
    • 構造体
      • sToCoNet_AppContext
      • tsRxDataApp
      • tsTxDataApp
    • TWELITE NET マクロ
      • ToCoNet_REG_MOD_ALL()
      • utils.h
    • ユーザ定義イベント処理関数
      • ステート(状態)
      • イベント
      • ToCoNet_Event API
        • ToCoNet_Event_Register_State_Machine()
        • ToCoNet_Event_Process()
        • ToCoNet_Event_SetState()
        • ToCoNet_Event_vKeepStateOnRamHoldSleep()
        • ToCoNet_Event_u32TickFrNewState()
    • モジュール ライブラリ
      • ENERGY SCAN
      • NB SCAN
    • PRSEV ライブラリ
    • グローバル変数
      • uint32 u32TickCount_ms
      • sToCoNet_AppContext (静的変数)
    • PANIC
  • HW API リファレンス
    • ペリフェラル
      • ADC
        • adc.c
      • DIO
      • TickTimer
      • UART
        • SERIAL ライブラリ
          • SERIAL_vInit()
          • SERIAL_vInitEx()
          • SERIAL_bRxQueueEmpty()
          • SERIAL_i16RxChar()
          • SERIAL_vFlush()
          • tsSerialPortSetup
          • tsUartOpt
        • fprintf ライブラリ
          • vfPrintf()
          • vPutChar()
          • tsFILE
      • Timer
        • Timerライブラリ
          • vTimerConfig()
          • vTimerStart()
          • vTimerStop()
          • vTimerDisable()
          • tsTimerContext
      • WakeTimer
      • I2C
      • SPI
    • Flash, EEPROM
      • EEPROM
      • Flash
  • Utils リファレンス、他
    • ByteQueue
    • u8CCITT8()
    • SPRINTFライブラリ
    • BTMライブラリ(連照式 DIO 入力 )
GitBook提供
このページ内
  • TWELITE STAGE
  • リリース版
  • 正式リリース
  • リリース間の更新
  • MWSDK_COMMON_SNAP レポジトリ
  • MWSDK_COMMON レポジトリ
  • TWELITE MWX ライブラリ SDK (2019/12)
  • TWELITE NET 1.2.0 (2018/05) 以前

最新版の取得

前へTWELITE SDKの構成次へTWELITE SDK 改版履歴

最終更新 2 年前

TWELITE STAGE

TWELITE NET 1.3.0 (2020/04) 以降は TWELITE STAGE として配布されます。

*** TWELITE STAGE フォルダ構成 ***
{STAGE TO FOLDER}/
  TWELITE_Stage.exe            -- STAGE 実行形式(Windowsの場合)
  dll/                         -- STAGE 実行用(Windowsの場合)
  TWELITE_Stage/               -- STAGE 関連ファイル
  BIN/                         -- .binファイル格納フォルダ
  
  MWSDK/                       -- TWELITE SDK(MWSDK)トップ

リリース版

リリース版は、以下よりダウンロードしてください。MWSDK はTWELITE STAGEの配布物の一部となります。

正式リリース

正式リリースには名前が付きます。名前の書式は MWSTAGE2020_05 のように MWSTAGEに続いて {年}_{月} を表記します。また TWELITE Stage ツールを含まない TWELITE SDK (MWSDK) のバージョンは、同様に MWSDK2020_05 のように MWSDK に続いて {年}_{月} です。

リリース名に UNOFFICIAL が付随する場合は「リリース間の更新」に対しての命名です。

以下より配布します。

リリース間の更新

リリース後に発見された問題や、サンプル等の更新などは、以下のGitHubリポジトリ(ソースコードやファイルを履歴を含めて格納したデータベース)に反映されます。

これらの修正は中間的な内容、所定の動作確認などが省略されたものも含まれます。確認されていない副作用があったり、構成間の整合性が取れていない場合もあります。利用の可否はお客様のほうで判断いただくようお願い申し上げます。

原則としてリリース後の修正に対してのサポート対応は行っておりません。技術サポートは、リリース版をもとに依頼いただくようお願いいたします。

また、リリース後の修正に対して、お客様のほうで不都合など発見された場合は、お手数ですが技術サポートにご連絡頂けますと幸いです。

当サポートでは Git ならびに GitHub の利用方法についてのご質問はお受けできません。一般の解説などを参考いただくようお願い申し上げます。また、GitHubのサービスに対しては当社では対応できない場合もございます。

MWSDK_COMMON_SNAP レポジトリ

リリースごとのMWSDKファイル(共通部分)を一括格納しています。MWSDKの更新方法は、このリポジトリから zip ファイルをダウンロードして、フォルダやファイルを更新前のものと差し替えます。

リンク先には各リリース(暫定版はUNOFFICIAL)でのファイル一式へのリンクが含まれます。

レポジトリには以下のフォルダが含まれます。

  • ChipLib

  • LICENSE

  • MkFiles

  • TWENET

この4つのフォルダをTWELITE STAGEの配布フォルダ内で差し替えます。

.../MWSTAGE/              --- TWELITE STAGE 配布フォルダ
        .../MWSDK         --- MWSDKフォルダ
              .../ChipLib <-- 以下の4フォルダを差し替える
              .../LICENSE
              .../MkFiles
              .../TWENET

MWSDK_COMMON レポジトリ

このリポジトリにはMWSDKの共通部分のファイルを管理していますが、上述の MWSDK_COMMON_SNAP ではリリースごとのファイル差分のみに注目しているのに対して、各ライブラリやサンプルなどのレポジトリをサブモジュールとして、個別に更新履歴が参照できるようになっています。

zip ファイルによるダウンロードを行った場合、サブモジュールに対尾するフォルダにはファイルが格納されません。 (GitHubの仕様です)

リポジトリ利用について

  • GITのsubmoduleを用いています。GitHubのサイトから.zip形式などでアーカイブをダウンロードした場合、submoduleの含まれるファイルは含まれません。(submodule付きのクローンを行うgitコマンド例は後述)

  • MWSDK_COMMON リポジトリは、配布の MWSDK フォルダから Tools フォルダと一部ファイル(Windows版の環境変数登録用の cmd ファイル)を除外したものです。Tools フォルダは配布済みのものを利用してください。

リポジトリからクローンする方法 (MWSDK 2020/04 以降)

ここでは、コマンドラインにて MWSDK の内容を GitHub からクローンする方法を記述します。あらかじめ git コマンドが利用できる環境を用意しておいてください。Windowsを利用の場合は bash を用いて作業することを想定します。

まず最初に配布のMWSDK(TWELITE STAGE)を展開しておきます。以下のような構成になっていると思います。

=== フォルダ構成 ===
.../MWSTAGE +- MWSDK +- TWENET
                      - ChipLib
                      - ...
                      - Tools               

配布時の MWSDK フォルダを別の名前に変更します。

$ cd .../MWSTAGE    ...はお客さまのインストールフォルダ
$ mv MWSDK MWSDK.orig

=== フォルダ構成 ===
.../MWSTAGE +- MWSDK.ORIG
                  +- TWENET
                   - ...
                   - Tools 

MWSTAGE フォルダ上で GitHubより MWSDK_COMMON をクローンします。submodulesのファイルを取得するため--recurse-submodulesオプションを追加します。

$ pwd
.../MWSTAGE
$ git clone --recurse-submodules https://github.com/monowireless/MWSDK_COMMON MWSDK
...(少し時間がかかります)

=== フォルダ構成 ===
.../MWSTAGE +- MWSDK
                  +- TWENET
                   - ... (Tools は含まれない)
             - MWSDK.ORIG
                  +- TWENET
                   - ...
                   - Tools 

最後に MWSDK.ORIG/Tools フォルダを MWSDK に移植します。

$ mv MWSDK.ORIG/Tools MWSDK/

=== フォルダ構成 ===
.../MWSTAGE +- MWSDK
                  +- TWENET
                   - ...
                   - Tools 
             - MWSDK.ORIG
                  +- TWENET
                   - ... (mv したのでTools は含まれない)

TWELITE MWX ライブラリ SDK (2019/12)

MWXライブラリ専用の初版SDKです。

MWXによる開発は、最新版の TWELITE STAGE を利用ください。

TWELITE NET 1.2.0 (2018/05) 以前

以下のリンクを参照ください。

- MWSDK の共通部をまとめたレポジトリ。サブモジュールを用いているためGitの取り扱いに習熟している必要があります。

- MWSDK の共通部を一括ダウンロードできるようにしたレポジトリ。zip形式でダウンロードできます。

https://mono-wireless.com/stage
MWSDK_COMMON
MWSDK_COMMON_SNAP
https://github.com/monowireless/MWSDK_COMMON_SNAP/releases
https://github.com/monowireless/MWSDK_COMMON
Logo旧ソフトウエア開発環境 - MONO-WIRELESS.COM
LogoTWELITE STAGE-トワイライトステージ - MONO-WIRELESS.COM
GitHub画面例