MWXライブラリ改版履歴

更新方法

TWELITE STAGE の配布パッケージリリース後の修正・追加分などはGitHubレポジトリに格納しております。必要に応じて配布パッケージの位置を差し替えて利用いただくようお願いいたします。 MWSDKの他の更新が必要になる場合があります。更新時のリリース記述を参照してください。MWSDKの更新についてはこちらを参照ください。

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

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

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

以下のフォルダの内容を差し替えます。

.../MWSTAGE/              --- TWELITE STAGE 配布フォルダ
        .../MWSDK         --- MWSDKフォルダ
              .../TWENET/current/src/mwx <--　このフォルダを差し替える

リリース前の更新

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

https://github.com/monowireless/mwx/wiki

履歴

0.2.2 (MWSDK2025_08版)

• マルチアプリ対応(MULTINONE, 複数アプリコードを１本のバイナリにまとめ、起動時に選択する)を行った。
  • cbToCoNet_???関数にMWX_プレフィックスを追加。
    • mwx_appcore.cにてMWX_USE_ALIASマクロと追加した。定義されている場合、MWX_cbToCoNet???()コールバック関数を直接 cbToCoNet???()にエリアスし、冗長な関数呼び出しを抑制する。
  • modified packect queue size to ToCoNet_USE_MOD_TXRXQUEUE_MULTINONE.
  • インタラクティブモード用のアプリケーション定義コールバック関数の関数ポインタ化を行った (MWX_TWEINTRCT_***, etc.)
  • MWX ライブラリで用いられるコールバック関数群を関数ポインタにより呼び出すように変更した
    • mwx_pf_init_coldboot, mwx_pf_setup, mwx_pf_begin, mwx_pf_loop, mwx_pf_init_warmboot, mwx_pf_wakeup, mwx_pf_on_rx_packet, mwx_pf_on_tx_comp, mwx_pf_on_nwk_event
• setup()前後の処理に一貫性が無かったため、以下のように修正した。
  • introduced on_setup() method which is called just after ::setup() procedure.
  • changed on_begin() which is always called just before ::begin() procedure. The on_begin() used for board behavior was called the_twelite.begin() procedure in ::setup().
• mwx::G_BYTE(), mwx::G_WORD(), mwx::G_DWORD()の定義を改善し、右辺値でも利用できるようにした。
• Serial::println(T, fmt) の fmt が DEC, OCT 指定時に正しく出力されない問題を修正した
• WireオブジェクトでNAKが正しく送付されていなかった
• serioal_parser で 以下のように右辺値であっても Serial << で出力できるようにした
  • Serial << serparser_attach(PARSER::ASCII, buf.begin(), buf.size())
• operator bool()メソッドにexplicitを追加した
• mwx::S_OCTET()をmwx::S_BYTE()にリネームした
• intorduced predefined MACRO MWX_PF_CALLBACKS_PRESENT to check if (*mwx_pf_setup)(), (*mwx_pf_loop)(), … are supported, which should be used to ask library to use user defined funtion instead of setup(), loop(), …
• mwx::stream::vprintfmt()を追加し、va_listパラメータに対応した。
• 外部メモリ(FIFO用)を指定したシリアルポート初期化手続きを追加した
  • mwx::serial_jen::setup(uint16_t siz_buf_tx, uint8_t *pu8_buf_tx, uint16_t siz_buf_rx, uint8_t *pu8_buf_rx)
• mwx_debug.hに USE_IN_TWENET_Cマクロを追加した。(mwx ライブラリをリンクせずに NWK_SIMPLE クラスを利用しようとした実験的な試み)

0.2.1 (MWSDK2024_07G版)

• Call on_rx_packet() for packets without network information (NWK_SIMPLE or others, but just a plain packet).
• added energy sacn feature on MWX.
  • added on_nwk_event() call back on MWX (pass the completion event of Enery Scan).
• I2C デバイスの使用終了の手続き vSMBusDeInit()を追加した。
• [GOLD] BANK7メモリ領域の設定保存マクロ定義に対応した。
  • G_TWENET_FREE_RUNNING_WTIMER_ENABLED()
  • G_TWENET_CHIPSENSOR_ADC_TIMES_SCALER()
  • G_TWENET_CHIPSENSOR_AUTO_ON_BOOT()

0.2.1 2023-06-29

• app_core.c でのイベント処理の不具合対応と動作の統一化(以下0.2.2の修正も含めて記述)
  • cbToCoNet_vRxEvent() でネットワークビヘイビアでイベントを処理された場合はthe_vapp.cbToCoNet_vRxEvent()を呼び出し、そうでない場合は on_rx_packet() を呼び出す。
  • cbToCoNet_vTxEvent() でネットワークビヘイビアでイベントを処理された場合はthe_vapp.cbToCoNet_vTxEvent()を呼び出し、そうでない場合は on_tx_comp() を呼び出す。
  • cbToCoNet_vNwkEvent() でネットワークビヘイビアでイベントを処理された場合は .cbToCoNet_vNwkEvent()を呼び出し、そうでない場合は on_nwk_event() を呼び出す。
• TWELITE RED 用で ADC5,6 を利用できるようにした。
• TWELITE RED の ADC の電源電圧の mV 演算が間違えていたのを修正した。
• settings::do_command()を追加した。
• MWX_STGS_STD_DEF_APPID マクロを追加、インタラクティブモード settings のデフォルトAPP_IDを明示的に設定する。
• [GOLD] MC3630 センサードライバの TWELITE GOLD 対応を行った。
• added div100_128th() to convert 128th value into div100() style object.
• [GOLD] modified CPUCLK_XXX defines to fit TWELITE GOLD.
• [GOLD] added mac_temp_update() to temperature recal of MAC/RADIO when bigger change is seen.
• [GOLD] added get_on_boot_temperature() and get_on_boot_voltage() in div_result_i32 object.
• [GOLD] I2C関連のライブラリコード SMBus.[ch] を TWENETcmpt ライブラリに組み込んだ。
• [GOLD] MWX では g_twenet_chipsensor_auto_on_boot = 1;を設定し、チップ温度センサー取得を自動的に行う。このセンサーはRF部分の初期化パラメータに使用される。
• fixed that vAHI_DioWakeEdge() is not called properly when pinMode() is called for two or more ports. (storing bitmap state internally in mwx codes)
• fixed attachIntDio() detachIntDio() to consider behavior of vAHIDioInterruptEdge().
• fixed that repeat count of <NWK_SIMPLE> is not incremented when it’s repeating.

0.2.0 - 2022-03-01

主な改定内容

• ヒープ領域へのメモリ確保を行う Wire オブジェクトを変更した。
• utils.hでの名前の衝突を避けるため、関数名をG_OCTET()からG_BYTE()に変更した。
• attachIntDio()において、vAHI_DioInterruptEnable()の順番を変更した。
• ユニバーサルレシーバ (NWK_LAYERED, NWK_SIMPLE またはネットワークレスパケットを同一実行コードで受信する) をサポートするために the_twelite.network2 を追加した。
• NWK_LAYERED を追加 (現時点では親機受信のみ対応)
• MWXの初期化時にアプリケーションのバージョンを設定する MWX_Set_Usder_App_Ver() 関数を導入した。
• mwx::pnew() を追加し配置newの記述を簡素化した。
• EASTLのサポート追加
  • EASTL用のnew[]演算子の追加
• MWXのソースコードのほとんどをプリコンパイルし、コンパイルの高速化を図った。
• DIOイベントが無関係なポートに引き渡されていたのを修正。

0.1.9 - 2021-12-15

主な改定内容

• TWELITE ARIA向けのボードサポート BRD_ARIA とセンサー定義 SHT4x を追加
• インタラクティブモード中で Serialクラスオブジェクトを用いた出力を可能とする内部手続きを追加 (Serial._force_Serial_out_during_intaractive_mode())

0.1.8 - 2021-09-09

主な改定内容

• Serial1のポート、代替ポートの定義が適切でなかった
• Serial(UART0)のボーレートを変更できるようにした
• 受信パケット(on_rx_packet())、送信完了(on_tx_comp())を知らせるイベントコールバックを追加
  • コールバック関数の定義をしなければ従前の手続きも利用可能
• <STG_STD>インタラクティブモード設定の定義ID間違いや一部デフォルト値の変更など
• <STG_STD>インタラクティブモード設定でAppIDに加えて、チャネルと論理デバイスIDのデフォルト値を変更できるようにした
• the_twelite と <NWK_SIMPLE> オブジェクトの設定を、一部の設定についてインタラクティブモード<STG_STD> オブジェクトで行えるようにした
• <NWK_SIMPLE>で再送回数のデフォルト値を設定できるようにした
• <STG_STD> インタラクティブモードの画面が出ている間はアプリケーションからのSerial(UART0)の入出力を行わないようにした
• CUE::PIN_SET, PAL???"":PIN_SETを追加 (PIN_BTNはボタンのないCUEでPIN_BTNを用いるのは不自然であるため)
• random()の名前空間をmwx::に移動 (グローバル名にエリアス)
• MONOSTICKのウォッチドッグ設定を32ms単位で行うようにした
• BRD_TWELITEを用いスリープを行うと、復帰時にピンが正しく初期化されなかった

0.1.7 - 2020-12-03

主な改定内容

• TWELITE CUE のボードビヘイビア(https://mwx.twelite.info/v/v0.1.7/boards/cue)を追加。
• 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の整備。
• EEPROMクラスオブジェクトを追加 (https://mwx.twelite.info/v/v0.1.7/api-reference/predefined_objs/eeprom)
• サンプル (https://github.com/monowireless/Act_samples/tree/master/Unit_EEPROM)
• smplbuf::get_stream_helper()の不具合修正
• pktparserクラスを追加しました (https://mwx.twelite.info/v/v0.1.7/api-reference/classes/pktparser)
• サンプル (https://github.com/monowireless/Act_samples/tree/master/Unit_PktParser)
• serparser/pktparser を他のプラットフォームでビルドできるようサンプルを用意しました (https://github.com/monowireless/mwx/tree/master/stdio)

0.1.6 - 2020-10-09

主な改定内容

• 商・余を計算する 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))タイムアウトを無効に。その他 << 演算子の定義を追加。
• NOTICE PAL / PCA9632 のサポートを追加 (解説 https://mwx.twelite.info/v/latest/boards/pal/pal_notice, サンプル https://github.com/monowireless/Act_samples/tree/master/Unit_using_PAL_NOTICE)
• 除算を行わない 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) を設定追加する。１番目のパラメータは暗号キー、２番目を 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

主な改定内容

• 設定ビヘイビア（インタラクティブモード機能）を追加
• チャネルマネージャ chmgr の実装

0.1.4 - 2020-07-29

一括ダウンロード

MWSDK2020_07_UNOFFICIAL (ReadMe)

主な改定内容

• delayMilliseconds() の追加
• digitalReadBitmap() の追加
• delay() の精度向上
• Serial1 インスタンスが定義されていない問題を修正
• Analogueの割り込みハンドラが呼び出されない問題を修正

0.1.3 - 2020-05-29

MWSDK2020_05 に対応

主な改定内容

• 重複チェッカ duplicate_checker の初期化等に不備があり期待通りの除去を行っていなかった
• format() の実装を機種依存の少ないものとした。また、引数を最大8までとした。64bit引数が含まれる場合は引数の数は制限される。

https://github.com/monowireless/mwx/releases/tag/0.1.3

0.1.2 - 2020-04-24

MWSDK2020_04 に対応

主な改定内容

• Timer0..4の初期化の問題を修正
• mwx::format() の内部処理を変更
• インタラクティブモード対応のための実験的なコードの追加

https://github.com/monowireless/mwx/releases/tag/0.1.2

0.1.1 - 2020-02-28

主な改定内容

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

https://github.com/monowireless/mwx/releases/tag/0.1.1

0.1.0 - 2019-12-23

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

https://github.com/monowireless/mwx/releases/tag/0.1.0