MWX Library
v0.1.7
v0.1.7
  • The MWX Library
  • 改版履歴
  • MWXライブラリについて
    • License
    • 用語
    • 設計情報
  • インストール・ビルド
    • 環境 (OSなど)
    • TWELITE SDK のインストール
    • VS Codeのインストール
    • TWELITE STAGE によるアクトの実行
    • アクトのビルド
      • ディレクトリ構成
      • コマンドラインによるビルド
      • VS Codeでのビルド
      • WSLでのビルド
    • アクトの書換・実行
      • TWE-Programmer
      • tweterm.py
    • 新しいプロジェクトの作成
    • ビルド定義 Makefile
    • 他のプラットフォーム
  • サンプルアクト
    • act0 .. 4
    • BRD_APPTWELITE
    • PingPong
    • Parent_MONOSTICK
    • PAL_AMB
    • PAL_AMB-usenap
    • PAL_AMB-behavior
    • PAL_MAG
    • PAL_MOT
    • PAL_MOT-oneshot
    • PulseCounter
    • Slp_Wk_and_Tx
    • WirelessUART
    • Scratch
    • Unit_???
  • API
    • 定義
    • クラスオブジェクト
      • the_twelite
      • Analogue
      • Buttons
      • EEPROM
      • PulseCounter
      • Serial
      • SerialParser
      • SPI
        • SPI (メンバ関数版)
        • SPI (ヘルパークラス版)
      • TickTimer
      • Timer0 .. 4
      • Wire
        • Wire (メンバ関数版)
        • Wire (ヘルパークラス版)
    • クラス
      • MWX_APIRET
      • alloc
      • axis_xyzt
      • packet_rx
      • packet_tx
      • serparser
      • pktparser
        • E_PKT
        • idenify_packet_type()
        • TwePacket
          • TwePacketTwelite
          • TwePacketIO
          • TwePacketUART
          • TwePacketPAL
      • smplbuf
        • .get_stream_helper()
        • smplbuf_strm_u8
      • smplque
      • mwx::stream
        • format (mwx::mwx_format)
        • mwx::bigendian
        • mwx::crlf
        • mwx::flush
        • stream_helper
    • コールバック関数
      • setup()
      • begin()
      • loop()
      • wakeup()
      • init_coldboot()
      • init_warmboot()
    • ビヘイビア
      • PAL_AMB-behavior
    • 関数
      • システム関数
        • millis()
        • delay()
        • delayMicroseconds()
        • random()
      • DIO 汎用ディジタルIO
        • pinMode()
        • digitalWrite()
        • digitalRead()
        • attachIntDio()
        • detachIntDio()
        • digitalReadBitmap()
      • ユーティリティ関数
        • Printf utils
        • pack_bits()
        • collect_bits()
        • Byte array utils
        • pack_bytes()
        • expand_bytes()
        • CRC8, XOR, LRC
        • div100()
        • Scale utils
  • ボード (BRD)
    • <BRD_APPTWELITE>
    • <MONOSTICK>
    • PAL
      • <PAL_AMB>
      • <PAL_MAG>
      • <PAL_MOT>
      • <PAL_NOTICE>
    • <CUE>
  • センサー・デバイス (SNS)
    • SHTC3 - 温湿度センサー
    • SHT3x - 温湿度センサー
    • LTR-308ALS - 照度センサー
    • MC3630 - 加速度センサー
    • BMx280 - 環境センサー
    • PCA9632 - LEDドライバ
  • ネットワーク (NWK)
    • シンプル中継ネット <NWK_SIMPLE>
  • 設定 (STG) - インタラクティブモード
    • <STG_STD>
GitBook提供
このページ内
  • 更新方法
  • MWXライブラリコードの更新方法
  • リリース前の更新
  • 0.1.7 - 2020-12-03
  • 0.1.6 - 2020-10-09
  • 0.1.5 - 2020-08-05
  • 0.1.4 - 2020-07-29 (MWSDK2020_07_UNOFFICIAL)
  • 0.1.3 - 2020-05-29
  • 0.1.2 - 2020-04-24
  • 0.1.1 - 2020-02-28
  • 0.1.0 - 2019-12-23
PDFとしてエクスポート

改版履歴

前へThe MWX Library次へMWXライブラリについて

最終更新 4 年前

軽微な修正にあたるものは、本改版履歴には記載を行わずGitHub上の改版のみとなります。必要に応じて修正を引用ください。

更新方法

TWELITE STAGE の配布パッケージリリース後の修正・追加分などはGitHubレポジトリに格納しております。必要に応じて配布パッケージの位置を差し替えて利用いただくようお願いいたします。

MWSDKの他の更新が必要になる場合があります。更新時のリリース記述を参照してください。MWSDKの更新についてはを参照ください。

MWXライブラリコードの更新方法

ライブラリのソースコードは GitHub ()にて公開しています。ライブラリのソースコードの差し替えは、以下の手順で行ってください。

  1. 各リリースのリンクよりGitのクローンを行うか zip 形式でソースコードをダウンロードします。

  2. 以下のディレクトリの内容を差し替えます。

.../MWSTAGE/              --- TWELITE STAGE 配布ディレクトリ
        .../MWSDK         --- MWSDKディレクトリ
              .../TWENET/current/src/mwx <-- このディレクトリを差し替える

リリース前の更新

リリース前の更新については上記に掲載する場合があります。

0.1.7 - 2020-12-03

ライブラリ名

依存バージョン

mwx

twesettings

TWENET C

1.3.4

主な改定内容

  • NWK_SIMPLE 利用時に NWK_SIMPLE 形式でない他のパケット(ネットワーク利用無し)を受信する方法を追加。NWK_SIMPLE::receive_nwkless_pkt()を追加してNWK_SIMPLEを初期化する。 このパケット情報を用いる場合は .get_psRxDataApp() による TWENET C ライブラリ層の構造体、および .get_payload() により得られるデータ配列のみを利用してください。受信パケット(auto&& rx = the_twelite.receiver.read())の他のメソッドから得られる情報は不定です。

  • get_stream_helper() コードのリファインと読み書き位置のAPIの整備。

  • smplbuf::get_stream_helper()の不具合修正

  • modified twenet_instance_manager to pass a parameter when constructing an object.

  • added EncodeVolt(), DecodeVolt() to compress 16bit voltage value into 8bit.

  • modified CRC_u8Calc() or others to be passed const uint8_t*.

  • modified smplbuf which copy constructor/assigin operator is supported with alloc_local() allocator.

  • added build support for serparser/pktparser to build at standard io based platform at `stdio' folder. (tested only on macOS)

0.1.6 - 2020-10-09

ライブラリ名

依存バージョン

mwx

twesettings

TWENET C

1.3.4

主な改定内容

  • 商・余を計算する div100() をSerial等へ出力できるようにした

  • smplbuf<> 配列クラスの実装変更。消費メモリの削減などを目的としてmwx::streamの継承をやめ、別途継承クラスとヘルパークラス定義した

  • mwx_printf() mwx_snprintf() の関数を追加した

  • the_twelite.stop_watchdog(), the_twelite.restart_watchdog() を追加した

  • mwx::stream のメンテナンス: operator bool() の廃止。読み出しタイムアウトの設定で 0xff を指定した場合(.set_timeout(0xff))タイムアウトを無効に。その他 << 演算子の定義を追加。

  • 除算を行わない 8bit と 0..1000 間のスケール関数を追加。

  • 10,100,1000による除算(商と余を同時に計算) div10(), div100(), div1000() を追加。値域を制限し乗算とビットシフトを中心に構成。

  • 暗号化パケットの対応メソッドを追加

    • packet_rx::is_secure_pkt() : 受信パケットが暗号化されているかどうかの判定

    • STG_STD::u8encmode() : インタラクティブモードでの暗号化設定を取得

    • STG_STD::pu8enckeystr() : インタラクティブモードでの暗号化鍵バイト列の取得

  • Serial1: デフォルトのポートは半導体の仕様では I2C と重複する DIO14,15 だが、通常 I2C に割り当てられるため DIO11(TxD), DIO9(RxD) とした。

  • Serial: ボーレートの指定で /100 が発生するが、主要なボーレートについてこの計算を省略するようにした。

  • Serial: available(), read() を外部で実施するための代理関数の保持を void* のみとし、仕様メモリを 8bytes 削減。

  • typedef boolean の追加

  • ネットワーク: 暗号化の対応を追加。

    • 暗号化を有効にするには NWK_SIMPLE::secure_pkt(const uint8_t*, bool = false) を設定追加する。1番目のパラメータは暗号キー、2番目を true にすると、平文のパケットも受信する。

      auto&& nwk = the_twelite.network.use<NWK_SIMPLE>();
      nwk << NWK_SIMPLE::logical_id(0xFE) // set Logical ID. (0xFE means a child device with no ID)
          << NWK_SIMPLE::secure_pkt((const uint8_t*)"0123456789ABCDEF");
          ;
  • SHT3xとBME280のセンサーサポート追加

  • センサー: レガシーコード(Cライブラリのラッパクラス)で、設定パラメータや状態をやり取りするための仕掛けを追加した。

  • センサー: SHT3x, BME280では I2C アドレスを指定可能とした。

  • 設定: hide_items() を追加。不要な設定項目を削除可能。

  • 設定: H/W UTIL メニューを追加。DIの状態表示、I2Cのプローブ、PAL EEPROM内容の表示。

  • 設定: 暗号化関連のメニューの追加

  • I2C関連の修正(TwoWireクラスを用いて実装されたコードとの親和性を向上するための修正)

    • requestFrom(false) の処理時に NO_STOP メッセージの送信コードが無かったため処理が正常に行われなかった。

    • TwoWire のクラス名エリアスを追加した。

    • begin() 処理で、多重初期化しないようにした。

    • setClock() メソッドを追加(ただしダミー関数で何もしない)

    • WIRE_CONF::WIRE_???KHZ を追加。バスクロックの主要な設定値を追加した。

0.1.5 - 2020-08-05

ライブラリ名

依存バージョン

mwx

twesettings

TWENET C

1.3.4

一括ダウンロード

主な改定内容

0.1.4 - 2020-07-29 (MWSDK2020_07_UNOFFICIAL)

ライブラリ名

依存バージョン

mwx

twesettings

TWENET C

1.3.3

一括ダウンロード

主な改定内容

  • delayMilliseconds() の追加

  • digitalReadBitmap() の追加

  • delay() の精度向上

  • Serial1 インスタンスが定義されていない問題を修正

  • Analogueの割り込みハンドラが呼び出されない問題を修正

0.1.3 - 2020-05-29

MWSDK2020_05 に対応

  • 重複チェッカ duplicate_checker の初期化等に不備があり期待通りの除去を行っていなかった

  • format() の実装を機種依存の少ないものとした。また、引数を最大8までとした。64bit引数が含まれる場合は引数の数は制限される。

修正は MWSDK2020_05 を前提としています。

本修正については、更新を推奨します。

0.1.2 - 2020-04-24

MWSDK2020_04 に対応

  • Timer0..4の初期化の問題を修正

  • mwx::format() の内部処理を変更

  • インタラクティブモード対応のための実験的なコードの追加

本修正は MWSDK2020_04 を前提としています。

本修正については、更新を推奨します。

0.1.1 - 2020-02-28

パケット内の中継フラグの扱いについての問題を修正

本修正については、更新を推奨します。

0.1.0 - 2019-12-23

初版リリース (SDL 2019/12月号収録)

TWELITE CUE のボードビヘイビア()を追加。

EEPROMクラスオブジェクトを追加 ()

サンプル ()

pktparserクラスを追加しました ()

サンプル ()

serparser/pktparser を他のプラットフォームでビルドできるようサンプルを用意しました ()

NOTICE PAL / PCA9632 のサポートを追加 (解説 , サンプル )

()

を追加

チャネルマネージャ の実装

()

こちら
https://github.com/monowireless/mwx
https://github.com/monowireless/mwx/wiki
https://mwx.twelite.info/v/v0.1.7/boards/cue
https://mwx.twelite.info/v/v0.1.7/api-reference/predefined_objs/eeprom
https://github.com/monowireless/Act_samples/tree/master/Unit_EEPROM
https://mwx.twelite.info/v/v0.1.7/api-reference/classes/pktparser
https://github.com/monowireless/Act_samples/tree/master/Unit_PktParser
https://github.com/monowireless/mwx/tree/master/stdio
https://mwx.twelite.info/v/latest/boards/pal/pal_notice
https://github.com/monowireless/Act_samples/tree/master/Unit_using_PAL_NOTICE
MWSDK2020_08_UNOFFICIAL
README.md
設定ビヘイビア(インタラクティブモード機能)
MWSDK2020_07_UNOFFICIAL
README.md
https://github.com/monowireless/mwx/releases/tag/0.1.3
https://github.com/monowireless/mwx/releases/tag/0.1.2
https://github.com/monowireless/mwx/releases/tag/0.1.1
https://github.com/monowireless/mwx/releases/tag/0.1.0
0.1.7
0.2.5
0.1.6
0.2.5
0.1.5
0.2.5
0.1.4
0.2.4
chmgr