TWENETstgs - twesettingsライブラリ

• 1: printfライブラリ
• 2: TWESTG_CMD_u32CmdOp() コマンド解説

1 - printfライブラリ

printf 相当関数

本 TWENETstgs ではオープンソースによるprintfライブラリを利用した fprintf, vfprintf, sprintf 相当関数を定義しています。

int TWE_fprintf(TWE_tsFILE *fp, const char *format, ...);
int TWE_vfprintf(TWE_tsFILE *fp, const char *format, va_list va);
#define TWE_snprintf(out,siz,fmt,...) snprintf_(out,siz,fmt,__VA_ARGS__)

参照するソースコードの記述

///////////////////////////////////////////////////////////////////////////////
// \author (c) Marco Paland (info@paland.com)
//             2014-2019, PALANDesign Hannover, Germany
//
// \license The MIT License (MIT)
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.
//
// \brief Tiny printf, sprintf and snprintf implementation, optimized for speed on
//        embedded systems with a very limited resources.
//        Use this instead of bloated standard/newlib printf.
//        These routines are thread safe and reentrant.
//
///////////////////////////////////////////////////////////////////////////////

2 - TWESTG_CMD_u32CmdOp() コマンド解説

TWESTG_CMD_u32CmdOp() コマンド解説（内部開発者向け）

概要

twesettings_cmd.[ch]の TWESTG_CMD_u32CmdOp() 関数は、0xdb コマンドの実行処理を行うことを想定している。この関数は、モジュールの諸情報の取得、設定情報の取得、設定情報の反映、リセットなどの処理が含まれる。多くの処理は設定関連の補助関数 TWEINTRCT_cbu32GenericHandler() を呼び出すようになっている。

データ型

• TWE_APIRETは、0x80000000 のビットの有で成功、なしで失敗。残りの31ビットをパラメータとする。
• TWE_tsBufferはバッファへのポインタ、系列長、バッファ最大長を格納した構造体。
• TWESTG_tsFinalは、設定関連の管理構造体。

TWESTG_CMD_u32CmdOp()

TWE_APIRET TWESTG_CMD_u32CmdOp(uint8 u8Op, TWE_tsBuffer *pBufIn, TWE_tsBuffer *pBufOut, TWESTG_tsFinal *psFinal)

処理内容u8Opに対応した処理を行う。処理によって入力データpBufIn、出力データpBufOutを用いる。最後のパラメータは設定管理構造体は psFinal を指定する。

u8Opの概要は以下である。

E_TWESTG_CMD_OP_ACK = 0xF0					ACK処理
E_TWESTG_CMD_OP_QUERY_MODULE_INFO = 0xF1	SIDなどの取得
E_TWESTG_CMD_OP_APPLY_SETTINGS = 0xF2		設定の反映（セーブはしない）
E_TWESTG_CMD_OP_QUERY_SETTINGS = 0xF3		設定の読出
E_TWESTG_CMD_OP_MODULE_CONTROL = 0xF8		設定関連の諸処理
E_TWESTG_CMD_OP_REVERT = 0xFD               設定を元に戻す
E_TWESTG_CMD_OP_SAVE = 0xFE					設定の保存
E_TWESTG_CMD_OP_DO_MDDULE_RESET = 0xFF,		モジュールリセット

戻り値は成功・失敗を戻す。処理によってはパラメータが設定されることがある。

処理

E_TWESTG_CMD_OP_ACK (F0)

ACK応答を行う。入力した系列をそのまま出力する。

例

(なし) -> 01        : 入力なしの場合は 01 が戻る
112233 -> 112233   : 112233の場合は、出力にそのまま戻る。

E_TWESTG_CMD_OP_QUERY_MODULE_INFO (F1)

モジュールの諸情報を取得する。

E_TWESTG_CMD_OP_APPLY_SETTINGS(F2)

設定情報を変更する。

• 設定情報はセーブ＆リセットされるまでは反映されません。
• 未反映の状態でのアプリケーションのふるまいは未定義です。
• 未定義の状態でインタラクティブモードに遷移すると変更したデータは破棄されます。
• 設定済みのデータと同じ内容に変更しようとしたときも、この処理は成功として戻り値を返します。ただしセーブ(E_TWESTG_CMD_OP_SAVE)を実行しても、実際のセーブは行われません。
• この処理は出力 (pBufOut) には書き込みません。

設定データ

例

01011234BEEF		アプリケーションID(0x01)に0x1234BEEF を設定する。
010212              チャネル(0x02)に0x12(18)を設定する。

E_TWESTG_CMD_OP_QUERY_SETTINGS(F3)

設定情報を取得する。

QTYP==1 の出力

例

0101 -> 051234BEEF    -> アプリケーションID(uint32_t 0x1234beef)
0102 -> 010D          -> チャネル(uint8_t 13)

E_TWESTG_CMD_OP_REVERT (0xFD)

このコマンドを実行直後に E_TWESTG_CMD_OP_SAVE を発効することで、設定情報を初期値に戻す。

• TWEINTRCT_cbu32GenericHandler(psIntr, E_TWEINRCT_OP_REVERT, TRUE, 0, NULL) を呼び出す。第３引数の TRUE 指定により、セーブされた設定情報はロードしない。アプリケーションの TWEINTRCT_cbu32GenericHandler() が正しく実装されていること。

入力データ、出力データは無し。

E_TWESTG_CMD_OP_SAVE (0xFE)

設定情報を変更した場合に、不揮発性メモリに保存する。

• 上書き、既に設定済みと同じ値に変更しようとした場合は、セーブは行わない。関数の戻り値としてTWE_APIRET_SUCCESS_W_VALUE(0x100 | E_TWESTG_CMD_OP_SAVE) を返す。
• セーブを行った場合は、速やかにリセットを行う（設定変更したままの動作は未定義）。

入力データ、出力データは無し。

E_TWESTG_CMD_OP_DO_MDDULE_RESET (0xFF)

モジュールをリセットする。

入力データ、出力データは無し。