<STG_STD>

<STG_STD> は、最小限の設定項目を有した設定ビヘイビアです。

　　　　　　　　　　　　　　　設定画面例
[CONFIG/MY_APP:0/SID=8102ECE3]
a: (0x1234ABCD) Application ID [HEX:32bit]
i: (         1) Device ID [1-100,etc]
c: (        13) Channel [11-26]
o: (0x00000000) Option Bits [HEX:32bit]

 [ESC]:Back [!]:Reset System [M]:Extr Menu                      

使用法

登録

// use twelite mwx c++ template library
#include <TWELITE>
#include <NWK_SIMPLE>
#include <STG_STD> // interactive mode

上記のように #include <STG_STD>を追加します。

setup() での読み出し

uint32_t APP_ID;
uint8_t CHANNEL;
uint8_t LID;

void setup() {
   ...
   auto&& set = the_twelite.settings.use<STG_STD>();

   // call reload() before reading values.   
   set.reload();
   
   // read value
   APP_ID = set.u32appid();
   CHANNEL = set.u8ch();
   LID = set.u8devid();
   
   // apply them
     the_twelite
        << TWENET::appid(APP_ID)
        << TWENET::channel(CHANNEL);
        
   auto&& nwk = the_twelite.network.use<NWK_SIMPLE>();
   nwk  << NWK_SIMPLE::logical_id(LID);
}

多くの場合、設定の読み出しはsetup() 中の早い段階で行います。

上記の例はでは、まずthe_twelite.settings.use<STG_STD>()により設定ビヘイビアを登録します。

つぎにset.reload()を呼び出し、実際にEEPROMからデータを読み出し、これを解釈します。自動で読み出さないことに注意してください。

set.u32appid(), set.u8ch(), set.u8devid()は各々アプリケーションIDの設定値、チャネルの設定値、論理デバイスIDの設定値を取得しています。ここでは変数に各設定値を格納しています。

あとは、設定値を利用してアプリケーションIDやチャネルなどの値を反映します。

設定一覧

以下が設定IDの一覧(enum class E_STGSTD_SETID)定義です。

<STG_STD>では、代表的な設定と自由に使える32bit値を４つ定義されています。これらは、ユーザが自由に利用できます。

設定ビヘイビアのカスタマイズ

設定ビヘイビアのカスタマイズは.reload()を行う前に全項目を行っておきます。

アプリケーション名

    auto&& set = the_twelite.settings.use<STG_STD>();
    set << SETTINGS::appname("MY_APP");
    ...
    set.reload();

アプリケーション名はインタラクティブモードの先頭行に表示されます。

[CONFIG/MY_APP:0/SID=8102ECE3]

文字列ポインタを指定してください。内部でコピーを作らないようにしているため、ローカル変数を指定できません。

デフォルト値

    auto&& set = the_twelite.settings.use<STG_STD>();
    set << SETTINGS::appid_default(0x13579be);
    set << SETTINGS::ch_default(18);
    set << SETTINGS::lid_default(7);
        ...
    set.reload();

アプリケーションID、チャネル、論理ID(LID)については、デフォルト値を変更できます。

複数チャネル設定メニュー

    auto&& set = the_twelite.settings.use<STG_STD>();
    set << SETTINGS::ch_multi();
    ...
    set.reload();

SETTINGS::ch_multi()を指定すると、チャネル設定が複数指定になります。複数設定を行う場合、設定値の読み出しは.u32chmask()を用います。

すぐに設定画面を表示する

auto&& set = the_twelite.settings.use<STG_STD>();
    set << SETTINGS::open_at_start();
    ...
    set.reload();

アプリケーションID、チャネル、論理IDについては、デフォルト値を変更できます。

項目名、詳細の記述内容の変更

const TWESTG_tsMsgReplace SET_MSGS[] = {
    { int(E_STGSTD_SETID::OPTBITS),    "オプション1", 
            "オプション１を設定してください" },
    { int(E_STGSTD_SETID::OPT_DWORD2), "オプション2",
            "オプション２を設定してください\r\nオプション２は云々" },
    { 0xFF } // terminator
};

setup() {
  auto&& set = the_twelite.settings.use<STG_STD>();
    set.replace_item_name_desc(SET_MSGS);
    ...

項目名を別のモノに変更することが出来ます。上記の例ではUTF-8による日本語にしていますが、ターミナルの表示など条件がそろわないと適切には表示されません。

この配列は最後に { 0xFF } で終端します。

１番目のエントリは設定ID、２番目が項目名、３番目が設定入力時に表示される解説になります。\r\nにより改行できます。

現在設定画面かどうか判定

        auto&& set = the_twelite.settings.use<STG_STD>();
        if (!set.is_screen_opened()) {
           // 設定画面が出ていないときの処理
        }

設定画面出力中にシリアルへの出力を行うと画面が崩れたりする原因になります。設定画面でないことを確認するには.is_screen_opened()で確認します。

項目の削除

auto&& set = the_twelite.settings.use<STG_STD>();
set.hide_items(E_STGSTD_SETID::OPT_DWORD3, E_STGSTD_SETID::OPT_DWORD4);

...
if(set.is_hidden(E_STGSTD_SETID::OPT_DWORD3) {
  ; // OPT_DWORD3は非表示
}

不要な項目の削除を行います。.hide_itemsは項目IDをパラメータとして（可変引数で複数指定可能）不要な項目を非表示にします。非表示項目かどうかは.is_hidden()により確認できます。

メソッド

reload()

    auto&& set = the_twelite.settings.use<STG_STD>();
    set << SETTINGS::appname(APP_NAME)
          << SETTINGS::appid_default(DEF_APP_ID)
        << SETTINGS::open_at_start();
   
    set.reload();

設定を読み込みます。すべてのカスタマイズが終わってから実行します。

メソッド （データ読み出し）

データの読み出しは以下のメソッドを呼び出します。

設定の反映

the_tweliteや<NWK_SIMPLE>オブジェクトに対して、本オブジェクトを用いて直接設定を反映できます。

auto&& set = the_twelite.settings.use<STG_STD>();
...
set.reload(); //ここで実際に設定がEEPROMより読み出される

the_twelite << set; // 設定値の反映 (APPIDなど)

auto&& nwk = the_twelite.network.use<NWK_SIMPLE>();

nwk << set; // 設定値の反映 (LIDなど)

反映される設定値は以下となります。.hide_items()により非表示になっている項目は反映しません。

項目ID

.hide_items()などで項目IDを指定する場合があります。この項目IDはenum class E_STGSTD_SETIDで定義されてます。

Extra Menu

[ROOT MENU/BAT1/SID=810B645E]
0: CONFIG
1: EEPROM UTIL
2: H/W UTIL

 [ESC]:Back [!]:Reset System                                    

Mキーを入力すると追加メニューにアクセスできます。

• CONFIG : 設定画面に戻ります
• EEPROM UTIL : EEPROMのメンテナンスを行うためのメニューです
• H/W UTIL : ハードウェアの状態を調べるためのメニューです

EEPROM UTIL

[EEPROM UTIL/BAT1/SID=810B645E]
r: Read sector.
R: Read ALL sectors.
e: Erase sector.
E: Erase ALL sectors.

 [ESC]:Back [!]:Reset System [M]:Extr Menu

セクターの読み出し、削除を行います。全読み出し、全消去を行うときは大文字で “YES” の３文字を入力します。

H/W UTIL

[H/W UTIL/BAT1/SID=810B645E]                   

現バージョンでは機能は提供されません。