twe::stream に改行コードを出力する
mwx::stream
の <<
演算子に対して改行コード (CR LF) を出力するためのヘルパークラスのインスタンスです。
twe::stream へのバッファ出力をフラッシュする。
mwx::stream
の出力バッファをフラッシュする。flush()
メソッドを呼び出すヘルパークラスへのインスタンス。
シリアルポートの場合は出力完了までポーリング待ちを行う
mwx::simpbuf
バッファの場合は 0x00
を末尾に出力する(サイズは変更しない)
mwx::stream に printf の書式を入力
mwx::stream
の << 演算子に対してフォーマット書式を書き出すヘルパークラスです。ライブラリ内では Using format=mwx::mwx_format;
として別名定義しています。
可変数引数リストに登録できる引数は最大8つです。doubleやuint64_t型など64bitのパラメータが含まれる場合は引数の数が制限されます。制限を超えた場合はstatic_assertによるコンパイルエラーになります。
コンストラクタで受け取った引数リストを、パラメータパックの展開機能を用いてクラス内部変数に格納する
operator <<
が呼び出された時点で、fctprintf()
を呼び出し、ストリームにデータを書き出す
コンストラクタでは、書式のポインタとパラメータを保存します。続く <<
演算子による呼び出しでフォーマットを解釈して出力処理を行います。
fmt
は本オブジェクトが破棄されるまで、アクセス可能であることが必要です。
入出力ストリーム
入出力ストリームを処理する上位クラスです。
CRTP (Curiously Recurring Template Pattern) 手法を用いたポリモーフィズムにより、いくつかのクラス(Serial, Wire, SPI, smplbuf
) にインタフェースを提供します。
CRTP では下位クラスは template class Derived : public stream<Derived>;
のように定義し、上位クラスからも下位クラスのメソッドを参照します。
本クラスでは print
メソッド、<<
演算子などの共通処理の定義を行い、下位クラスで実装した write()
メソッドなどを呼び出すことで、仮想関数を用いるのと近い実装を行っています。
下位クラスでは、以下に列挙する関数を実装します。
入力が存在する場合は 1、存在しない場合は 0 を返します。
本実装の戻り値はバッファ長ではありません。
出力をフラッシュ(出力完了まで待つ)します。
ストリームより1バイトデータを入力します。データが存在しない場合は -1
を戻します。
ストリームに1バイト出力します。
1バイト出力を行うスタティック関数です。クラスメソッドではないため、メンバー変数等の情報は利用できません。替わりにパラメータとして渡される vp にクラスインスタンスへのポインタを渡します。
このスタティック関数は内部的に利用されfctprintf()
の1バイト出力関数として関数ポインタが渡ります。これを用いてprint
メソッドなどを実装しています。
1バイト出力します。
各種整形出力を行います。
printf 形式での出力を行います。
TWESDK/TWENET/current/src/printf/README.md 参照
バイト列として出力する際は、uint8_t, uint16_t, uint32_t
型にキャストします。また文字列として数値出力する場合は明示的にint
形にキャストするようにしてください。
>>
演算子を用いた入力タイムアウトとエラーを管理します。
set_timeout()
によりタイムアウト時間を指定し、>>
演算子により入力処理を行います。所定時間内までに入力が得られない場合は get_error_status()
によりエラー値を読み出せます。clear_error_status()
によりエラー状況をクリアします。
入力処理を行います。
setup()
内では実行できません。
ポーリング待ちを行うため、タイムアウトの時間設定(タイムアウト無しなど)によっては、ウォッチドッグタイマーが発動してリセットする場合があります。
通常はloop()
中で以下のような読み出しを行います。
以下に読み出し格納できる型を列挙します。
パラメータ
解説
v
uint16_t
または uint32_t
の型の値
パラメータ
解説
fmt
フォーマット書式。
TWESDK/TWENET/current/src/printf/README.md 参照
...
フォーマット書式に応じたパラメータ。 ※ 最大数は4で、5つ以上のパラメータではコンパイルエラーとなる。
※ 書式との整合性はチェックしないため、不整合な入力に対しては安全ではない。
パラメータ | 解説 |
戻り値 | 0: データなし 1:データあり |
パラメータ | 解説 |
| 出力したい文字。 |
戻り値 | 出力が成功すれば 1、失敗すれば 0。 |
パラメータ | 解説 |
| 出力したい文字 |
| クラスインスタンスへのポインタ 通常は、元のクラスにキャストして write() メソッドを呼び出す |
パラメータ | 解説 |
| 整形出力したい数値型 |
| 出力形式 BIN 二進数 / OCT 8進数 / DEC 10進数 / HEX 16進数 |
| 小数点以下の桁数 |
戻り値 | 書き出したバイト数 |
引数型 | 解説 |
| 1/10秒単位でタイムアウト時間を設定します。 0xffを指定した場合は、タイムアウトを無効とします。 |
値 | 意味 |
0 | エラーなし |
1 | エラー状況 |
引数型 | 解説 |
| 1バイト入力 |
| 2バイト入力(ビッグエンディアン順) |
| 4バイト入力(ビッグエンディアン順) |
|
|
引数型 | 解説 |
| 1バイト出力 (数値としてフォーマットはしない) |
| 整数出力 (printf の "%d") |
| 数値出力 (printf の "%.2f") |
| 1バイト出力する(char型と同様) |
| 2バイト出力する(ビッグエンディアン順) |
| 4バイト出力する(ビッグエンディアン順) |
| printf 形式での出力 |
| 改行 CRLF の出力 |
| 出力のフラッシュ |
| 数値型をビッグエンディアン順で出力する。(右辺値) |
| バイト型の |
|
|
|
|
|
ALC
は。
smplbuf<T>
のデータを出力する
T
は uint8_t
型、AL
は。