scanfに対応するC++のクラスを作ってみる~

可変引数は「危険」なので、C++では「printf」を使わない文化がある。
それは、以前に説明した、しかしながら、printf のコンビニエンス性は捨てがたい、
そこで、boost::format に習って、組み込み向け utils::format クラスを提供した。


それでは、入力はどうしたものか・・・
一般的には、scanf を使って文字列中の数字を変換する。
しかし、scanf は C の API で、可変引数も使う、なので、format クラスに対応する
入力クラスも実装する必要性が大きい、そこで、input クラスを実装してみた。
※良くある、数字の変換に付き物の機能も追加した。

以下のように使う。

    int a;
    uint32_t b;

    int n = (utils::input("%d[, ]%x", "-99 100") % a % b).num();
    std::cout << a << ", " << b << std::endl;
    std::cout << "N: " << n << std::endl;

結果:

-99, 256
N: 2

上のサンプルでは、「%d」、「%x」の仕切りとして、「,」又は「 」(スペース)を
使う事ができる。
これは、正規表現に似た書式を簡略化したものだが、機能的には最低限の物しか無い。
※豊富な機能を盛り込むとコードが肥大化するし、たぶん実際には、それ程高機能で
無くても困らないと思えるからだ。

また、取り込んだ数は、「num()」を使って取得する事ができる。

input クラスの書式は以下のようになっている。

//-----------------------------------------------------------------//
/*!
    @brief  コンストラクター
    @param[in]  form    入力形式
    @param[in]  inp     変換文字列(nullptrの場合、sci_getch で取得)
*/
//-----------------------------------------------------------------//
basic_input(const char* form, const char* inp = nullptr);

basic_input クラス・テンプレートは、以下のように typedef されている。

typedef basic_input<def_chainp> input

ここで、「def_chainp」クラスは以下のようになっている。
自前の特殊クラスを作って食わせる事ができる。

//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
/*!
    @brief  標準入力ファンクタ
*/
//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
class def_chainp {
    const char* str_;
    char        last_;
    bool        unget_;
public:
    def_chainp(const char* str = nullptr) : str_(str), last_(0), unget_(false) { }

    void unget() {
        unget_ = true;
    }

    char operator() () {
        if(unget_) {
            unget_ = false;
        } else {
            if(str_ == nullptr) {
                last_ = sci_getch();
            } else {
                last_ = *str_;
                if(last_ != 0) { ++str_; }
            }
        }
        return last_;
    }
};

※「unget()」は、一文字を書き戻す。

input.hpp のプロジェクト

RXマイコン用、FatFsとシステムコール

データロガーの実装を進めるに中って、boost を使うようになった。
そうすると、どうしても「システムコール」を実装しなくてはならない状況にな
った。
これは、boost の動作で、ファイルを操作したり、標準出力を使っている為なの
だと思うが、リンク時一連のシステムコールがリンクできずににエラーを起こす。
※boost の内部設定を変更して、それらを使わないように「魔改造」する事も考
えられるが、それはそれで、大変と思うので、とりあえず、標準的な設定で何と
かなるよにしたい。

以前にSH2Aで、LCDの描画などを行った時にも、同じような事があり、実
装したので、どうすれば良いか、簡単に説明しておこうと思う。

まず、最低限必要なのが、標準入出力のしくみなどだ。

以下の関数を最低限実装する必要があるようだ、何か足りなければ、リンクエラ
ーが出るので、その都度追加すればよい。

int open(const char *path, int flags, ...);
int fstat(int file, struct stat *st);
int read(int file, void *ptr, int len);
int write(int file, const void *ptr, int len);
int lseek(int file, int offset, int dir);
int close(int file);
int isatty(int file);
void kill(int n, int m);
int getpid(int n);
void exit(int n);

また、固定のファイルディスクリプタとして以下がある:

stdin  : 0
stdout : 1
stderr : 2

これらは、オープンもクローズもできない、また、シークも必要ない。

「write」、「read」の中で、「file」が0、1、2の場合に、シリアル入出力へ
繋げば良いと思う。
「isatty」は、ファイルディスクリプターが端末を参照しているかをチェックす
る機能なので、これも実装しておく。
※そうすれば、「printf」は使えるようになる。(ただ、C++ ではあくまでも、
iostream が基本なのと、自分の実装では、format があるので必要無い、又、
iostream を使うようなコードを書くと、単純にメモリーが足りなくて、リンク
時にエラーを起こすだけではある)
※とりあえず、この程度なら、RL78やR8Cでも利用可能と思う。

//-----------------------------------------------------------------//
/*!
    @brief      ファイル記述子で指定されたファイルから指定バイトを読む
    @param[in]  file    ファイル記述子
    @param[in]  ptr     読み込み先
    @param[in]  len     読み込みバイト数
    @return     読み込みバイト数
*/
//-----------------------------------------------------------------//
int read(int file, void *ptr, int len)
{
    int l = 0;
    if(file >= 0 && file <= 2) {
        // stdin
        if(file == 0) {
            char *p = ptr;
            for(int i = 0; i < len; ++i) {
                *p++ = sci_getch();
            }
            errno = 0;
            l = len;
        }
    }
    return l;
}

//-----------------------------------------------------------------//
/*!
    @brief      ファイル記述子で指定されたファイルから指定バイトを書く
    @param[in]  file    ファイル記述子
    @param[in]  ptr     書き込み元
    @param[in]  len     書き込みバイト数
    @return     書き込みバイト数
*/
//-----------------------------------------------------------------//
int write(int file, const void *ptr, int len)
{
    int l = -1;
    if(file >= 0 && file <= 2) {
        if(file == 1 || file == 2) {
            const char *p = ptr;
            for(int i = 0; i < len; ++i) {
                char ch = *p++;
                sci_putch(ch);
            }
            l = len;
            errno = 0;
        }
    }
    return l;
}

//-----------------------------------------------------------------//
/*!
    @brief      ファイルディスクリプタが端末を参照しているかをチェックする
    @param[in]  file    ファイル記述子
    @return     端末を参照するオープンされたファイルディスクリプタ @n
                であれば 1 を返す。@n
                そうでなければ 0 を返し、 errno にエラーを示す値を設定する。
*/
//-----------------------------------------------------------------//
int isatty(int file)
{
    if(file >= 0 && file <= 2) {
        errno = 0;
        return 1;
    } else if(file < OPEN_MAX_) {
        errno = ENOTTY;
        return 0;
    }
    errno = EINVAL;
    return 0;
}

--------

FatFs を使って、SDカードにアクセスする場合は、GitHub の syscalls.cを参照してほしい。
RX24Tの場合、RAMは16Kしか無いので、記憶割り当てを実装するのは、
少しキビシイ、そこで、FatFsの設定では、「記憶割り当て」を使わない設
定にしている、そうすると、1個のファイルを開くのに必要なメモリーは、そこ
そこ大きく、最大オープン数を多く取るとスタテックにメモリーを消費する。
ファイルの先頭で、「OPEN_MAX_」を「4」と定義してある。
最大4つまでファイルを開く事ができる、通常これくらいあれば十分と思うが、
アプリにより最適な値を調整する必要があるかもしれない。
又、FatFSを使わない場合には、「FAT_FS」をコメントアウトして、
無効にする。

ファイルをオープンするパスは、UTF-8を使う、内部でShift_JIS
に変換されて、FatFSに渡される。

FatFsを使う場合、内部で「sdc_io」クラスと連携しているので、SDカード
の自動マウントなどを見守る必要がある。

RX24Tを使ったデータロガー(その1)

以前にATMegaを使ってデータロガーを作成したが、需要が無かったのと、
大きくて、使いかってが悪いなどで使わなくなっていた。
IMG_0904sIMG_0905sIMG_0906s

最近、需要が、少しではあるがありそうなので、最新のRX24Tで作り直す
事にした。
ソースは、ATMegaの物をなるべく利用するが、元はCで書かれているの
と、AVR用に特化している部分もあるので、C++で作り直す。

今度は利便性を第一に考えて、小型に作る。
とりあえず、タカチのケース(CS115N)に入るようにして、基板を起こす
予定でいる。
※最近は、基板を小ロット作成するのにかかるコストは凄く少なくなっている。
IMG_0907s

スペックや仕様は以下の通り:
・100Hzサンプリング
・ラップタイム入力
・G.P.S.入力
・加速度、ジャイロセンサー(MPU6050)
・速度(パルス)入力、2チャンネル
・回転(パルス)入力、1チャネル(エンジン回転用)
・アナログ4チャンネル
・SDカード対応
・128×64、液晶表示
・720mAリチウムポリマー電池と充電、3.3VDC/DC
・USB充電

RX24Tデータロガーリソース

RX24Tで内臓データフラッシュの読み書き

RX24Tの内臓データフラッシュの読み書きが出来たので、関係クラスと
サンプルを追加した。

RX24Tでは、内臓データフラッシュは8Kバイトあり、1Kバイト毎の
ブロックに分かれている。
※消去は、1Kバイト単位で行う。

以前、RL78では、内臓データフラッシュへのアクセスは、情報が公開さ
れておらず、使う事が出来なかった。
※操作ラブラリーだけが公開されており(gcc 版は無い)ソースコードや、
関係レジスターの説明等は未公開となっている為、実装をあきらめた。
※「公開できない」理由について、色々考えたりもしたが、それが、トリガー
となって、RL78からは疎遠になってしまった。

RXマイコンでは、アクセスが多少面倒ではあるものの、内蔵データフラッ
シュを使う事が出来る。(常識でもある)
また、ROMフラッシュ領域も、書き込みなどが行えるものの、操作が面倒
なのと、当面必要では無いので、実装していない。

データフラッシュは、消去が1バイト単位で出来ない(1Kバイト毎)ので、
汎用的なメモリーとして扱うようにするには、巧妙なマネージメントを必要
とする、これは、フラッシュの書き換え可能回数制限や、ブロック・イレー
スに、時間が多少必要など、フラッシュメモリーの特性が起因している。

データフラッシュの扱いは、RXマイコンで共通なら、問題は無いが、デバ
イスによって異なるようだ・・
今回、RX24T専用となったので、

RX24T/flash.hpp
RX24T/flash_io.hpp

専用のクラスを用意した。

ただ、データフラッシュに対する操作は同じ仕様とする。

//-----------------------------------------------------------------//
/*!
    @brief    開始
*/
//-----------------------------------------------------------------//
void start() const;

//-----------------------------------------------------------------//
/*!
    @brief  読み出し
    @param[in]   org   開始アドレス
    @return データ
*/
//-----------------------------------------------------------------//
uint8_t read(uint16_t org) const;

//-----------------------------------------------------------------//
/*!
    @brief  読み出し
    @param[in]  org     開始アドレス
    @param[in]  len     バイト数
    @param[out] dst     先
*/
//-----------------------------------------------------------------//
void read(uint16_t org, uint16_t len, void* dst) const;

//-----------------------------------------------------------------//
/*!
    @brief  消去チェック
    @param[in]  bank    バンク
    @return エラーがあれば「false」
*/
//-----------------------------------------------------------------//
bool erase_check(data_area bank) const;

//-----------------------------------------------------------------//
/*!
    @brief  消去
    @param[in]  bank     バンク
    @return エラーがあれば「false」
*/
//-----------------------------------------------------------------//
bool erase(data_area bank) const;

//-----------------------------------------------------------------//
/*!
    @brief  書き込み
    @param[in]  src     ソース
    @param[in]  org     開始オフセット
    @param[in]  len     バイト数
    @return エラーがあれば「false」
*/
//-----------------------------------------------------------------//
bool write(const void* src, uint16_t org, uint16_t len) const;

//-----------------------------------------------------------------//
/*!
    @brief  書き込み
    @param[in]	org	開始オフセット
    @param[in]	data	書き込みデータ
    @return エラーがあれば「false」
*/
//-----------------------------------------------------------------//
bool write(uint16_t org, uint8_t data) const;

データ・フラッシュ・サンプル

RX64M内臓RTCを使う

正月休みは風邪引いて本物の寝正月で、趣味の工作など、全く出来なかった。

去年の11月終わりに請けた仕事も、ようやく何とかなりそうで、やっとRXマイコン
を再開した。

RX64M、176ピンは、内臓RTCを持っており、バックアップ用別電源端子が用
意されている。
※ VBATT(15)
※バッテリーバックアップできないようなRTCは、ほとんど利用価値が無い為、外部
にさらにRTCを繋ぐ必要がある。

RX64M、RTCのもう一つのメリットは、バイナリーカウンターモードがある点で、
これは、やっとまともな仕様になったとも言える。
時間管理を普通にやる場合、シリアライズがどうしても必要だが、一般的なRTCのレ
ジスター構成は、二度手間になるだけで何のメリットも無いものになっている。
※レジスターは、秒、時間、日、月、年、曜日などに分かれており、扱いが容易では無
い、これは、30年前以前の処理能力が無かった時代の腐った仕様が現役になっている。
時間の設定や、時間管理を考えた場合、「うるう年」や「曜日」の管理を行うのが普通
なので、基点からの経過時間(秒)で管理するのが確実だ、従って、RTCは、単純な
秒単位のカウンターが一番適している。
ハードウェアーデバイスに着目すると、単なるバイナリーカウンターのRTCも流通し
てはいるが、腐った仕様のRTCよりコストが高い事に驚く。
DS1371などがバイナリー仕様のRTC
バイナリーカウンタRTC:
DS1371(単価341円)

年、月、日、時間RTC:
MCP79410(単価122円)
DS3231モジュール(単価110円)
※何でこんな値段でやれるのか、不思議でならない・・・

IMG_0902s
リチウムイオン電池には直列に逆流防止ダイオードを入れる。
ただ注意しなければならないのは、順方向電圧降下が少ないタイプ(ショットキー)は
逆方向電流が多い物が多い、今回は、RB751S-40を使った。

RX64M内臓のRTCは、バイナリーカウンターなので、非常に簡単に実装する事が
できた。

RTCの読み出しでは、注意する必要がある。

複数の非同期カウンターをどのように読むべきか?

何も考えずに読み出すと、カウントアップ時の非同期性の為、間違った値を読んでしま
う事がある。
全てのカウンターレジスター更新には、多少の時間的ズレがある為、確率的に全てのカ
ウント更新が終了していない中途半端な状態を読み出してしまう為で、以前に観た実装
では、RTCから1Hz出力を出して、それを割り込みを使って、そのタイミングで読
み出すとかしていた、しかもこの方法でも、正しい値を読み出せる保障は無く、多分、
「たまたま」うまく読み出せているだけで、RTCが違う場合には、うまくいかない場
合もあるかもしれない。

非同期で動作する複数のカウンターがある場合、以下のように、二度読み出して、両方
同じなら、「値を信用」し、違えば、二度同じ値になるように読み出すループを作れば
良い。
腐った仕様のRTCでは、利用するレジスター全てを比較する。

bool get_time(time_t& tp) const {
    auto a = get_();
    for(int i = 0; i < 5; ++i) {
        auto b = get_();
        if(a == b) {
            tp = static_cast(a);
            return true;
        }
        a = b;
    }
    return false;
}

そして、
以前に、R8C、RL78のRTC用に実装した、マネージメントを組み込んだ。

時間関数は、libc に含まれているが、巨大なので、必要最低限の実装を行った独自の
「common/time.c」を使っている。
※「うるう秒」の補正は行っていない。

# RX64M RTC sample
# help
date
date yyyy/mm/dd hh:mm[:ss]
# date
Sat Jan 14 23:13:56  2017

コマンドラインから、時間設定と、表示を行う事ができる。
時間管理は、「time_t」(基点からの経過秒数)で行っており、内部はグリニッジ標準
時間を使い、タイムゾーン(東京+9時間)はハードコートしてある。

RX64Mのバックアップ機能も問題無く動作しているようだ~

RX64M_RTC_sample

再び18650電池ボックス

以前に製作した、18650の電池ボックスはイマイチだった。

アマゾンを観てたら、凄く安い18650の充電器(248円)があるのを発見した。

多分、充電回路は駄目で使い物にならないけど、単純に電池ボックスとして使う分には
良さそうと思い、早速注文。
※船便なので10日くらいかかった。

早速、分解して、電池ボックスとして利用する。

IMG_0895s
IMG_0896s

以前に買ったリチウムイオン充電モジュールを使えば、1Aで充電出来るが、R8Cで、
充電回路を作ってみようと思う。

ロジックアナライザー購入

仕事で、どうしてもロジックアナライザが必要になり、色々調べて購入した。

img_0891s

ヤフオクで買ったテクトロニクスのデジタルストレージはあるにはあるのだが、どうも
最近調子が悪く、チャネルも少ない。

購入したのは、「LA2016」で、200Mサンプル、16チャネル、1Gビットのメモリー
姉妹機として、100Mサンプル(LA1016)、500Mサンプル(LA5016)
がある、LA5016は$168、LA1016は$75、LA2016は$88となっ
ており、手頃な値段でありながら、高性能となっている。
※LA5016を買っといた方が良かったかもしれない。

急いでいたのでDHLを使った為、$100を超えたが、それでも安い!

このロジックアナライザは中国製のようだが、品質は悪くない。
アプリは、Windowsで動作する、多少、トリガー条件がチープではあるが、工夫
すれば問題無い範囲だろうと思う。
アプリは安定しており、USBドライバーも問題が起こらなかった、ノートでも安定し
て動作する。(Windows7、Windows10 で試した)
※アプリには、オートアップデート機能があるが、正しく動作しなかった為、本家の
サイト(中国)からアーカイブをダウンロードしてアップグレードした。

また、本家には、SDKもあり、自分でキャプチャーを行うアプリを自作できるようだ。

ロジックアナライザの導入を考えている人がいるのなら、是非選択枠に加えたら良いと
思う。

-----
購入後に気がついた、DSLogic Proも良さそうだ!
こちらは、オープンソースで、Windows、OS-X、Linuxで動作する。

整数計算でサインテーブルを生成する

これは、アセンブラ時代に、サインテーブルを生成する方法を色々試して、ある程度
成果のあった方法です。
※浮動小数点の sin で求めた値と微妙に違うところもありますが、実用性は十分あり
ます。

現在の C++11 以降では、constexpr でコンパイル時に計算して、定数としてソースコ
ードにテーブルを埋め込む事ができるので、必要性は薄いのですが、知っていれば、
応用範囲は広いでしょう。
ハードウェアーに実装して、周波数シンセサイザや音源の波形ベースに使う事も考え
られます。

x' = x・cos(s) - y・sin(s)
y' = x・sin(s) + y・cos(s)

s が十分小さい場合、以下のように近似できる。
cos(s) ≒ 1
sin(s) ≒ s

x' = x - y・s
y' = x'・s + y

テーブル生成に使っていますが、連続性がある場合は、リアルタイムに計算する事も
できます。(こちらの方が応用性があります)

非常に古いですが、1979年に発売された、ナムコのギャラクシアンで、編隊が、
実機の手前で、回転したり、サインカーブ的な軌跡で攻撃してくる場面がありますが、
この原理が使われていました。
※この当時、安易にテーブルにする人が多い中で、真のエンジニアでした。

また、単振動を使って、サインテーブルを計算する方法もあるかと思いますが、周期
を決定する定数を求めるのは、整数計算だけでは、簡単では無いと思えます。

テーブル生成では、テーブルのサイズは、2のN乗の方が、扱いやすいので、sの定
数を求める場合は、全円周(2・π)を、テーブル長で割る必要があります。

template <uint16_t shi, uint16_t len>
class sin_cos {

    static const uint32_t pai_ = 0xC90FDAA2;    ///< 円周率(3.141592654 * 2^30)
    static const uint32_t pai_shift_ = 30;      ///< 円周率、小数点位置

    uint16_t tbl_[(1 << shi) + 1];

    void build_()
    {
        int16_t gain = 16;  // 精度を確保する為の下駄
        int64_t x = len << gain;  // cos(0) の値
        int64_t y = 0;    // sin(0) の値
        for(uint16_t i = 0; i < ((1 << shi) + 1); ++i) {
            tbl_[i] = y >> gain;   // pai_ のビット位置補正
	    // 全周は、2・πなので+1
	    x -= (static_cast(pai_) * y) >> (pai_shift_ + shi + 1);
	    y += (static_cast(pai_) * x) >> (pai_shift_ + shi + 1);
        }
    }
    public:
        sin_cos() { build_(); }
};

整数演算で平方根

最近、整数演算だけで色々する話があったので、過去に作成したものを見直してみた。

・平方根
これは、ファミコン時代から使っていた方法をC++(C)で表現したもので。
※アルゴリズムは、コンピューターが出現する以前から知られていた数学的手法を元に
しているようで、初期のデジタルコンピューターが出現する、数十年前に既に知られて
いた方法のようである。

過去には、色々なマイコン用(6502、6809、68000、Z80)アセンブラ
で書いた記憶がある。
Cなどの高級言語では、キャーリーの扱いが無い為、シフトや、ビット操作を行う場合
無駄が多い。
アセンブラで書けば、より一層の高速化ができるけど、互換性を考えて、Cで実装して
ある。
ハードウェアーにも実装しやすく、割り算よりリソースを使わないと思われる。
※整数計算なので、「余り」がある。

ゲームにおいて平方根は、必ず必要な「道具」で、シューティングゲームの誘導ミサイ
ル、正規化、ほぼありとあらゆる場面で使うと思われる。

template <typename T>
struct sqrt_t {
    typedef T value_type;

    T   val;    ///< 答え
    T   mod;	///< 余り

    sqrt_t(T v = 0, T m = 0) : val(v), mod(m) { }
};

static sqrt_t<uint16_t> sqrt16(uint16_t in)
{
    uint32_t a = in;
    uint32_t b = 0x4000;
    for(int i = 0; i < 8; ++i) {
        if(a >= b) {
            a -= b;
            b = ((b + b) & 0xfffe0000) + 0x10000 + (b & 0xffff);
        } else {
            b = ((b + b) & 0xfffe0000) + (b & 0xffff);
        }
        a <<= 2;
    }
    sqrt_t<uint16_t> ans(b >> 16, a >> 16);
    return ans;
}

・32ビット版

static sqrt_t<uint32_t> sqrt32(uint32_t al)
{
    uint32_t ah, bh, bl;

    ah = bh = 0;
    bl = 0x40000000;
    for(int i = 0; i < 16; ++i) {
        if(al >= bl) {
            if(ah >= bh) {
                ah -= bh;
                al -= bl;
                bh += bh + 1;
            } else {
                bh += bh;
            }
        } else {
            if(ah >= (bh + 1)) {
                ah -= bh + 1;
                al -= bl;
                bh += bh + 1;
            } else {
                bh += bh;
            }
        }
        ah <<= 2;
        ah += al >> 30;
        al <<= 2;
    }

    sqrt_t ans(bh, ah);
    return ans;
}

intmath.hpp