hira のすべての投稿

RX72N Envision Kit でダブルバッファとTinyGLの実験

ダブルバッファ

RX72N では、内蔵メモリが 512K + 512K と増えたので、480x272 の 16 ビットカラーで、ダブルバッファを使う事が出来る。

ダブルバッファは、デジタルストレージオシロスコープで波形をレンダリングするのに都合が良いので、実験する必要性があった。

RX65N では、フレームバッファが1枚分しかなく、16 ビットカラーでは、ダブルバッファにする事が出来ない。
※ 8 ビットカラーなら可能かもしれないが、ラインアドレスは 64 バイトの倍数にする制約があり変則的な設定となる。

描画オブジェクトが GUI のような性質ならまだやりようもあるが、ダイナミックな描画をしようとすると、どうしても、ダブルバッファが必要となる。
※描画速度を気にしなければ、他にも方法はある・・

ダブルバッファの描画では、毎フレーム以下の手順で描画を行う。

  • 表示フレーム同期
  • B のバッファを表示用にする
  • A のバッファを全面クリア
  • A のバッファに全てのオブジェクトを描画
  • A、B を入れ替える

簡単には以上の手順を繰り返す。

通常、全面クリア+全てのオブジェクト描画が、1フレーム(16.6ミリ秒)以内に収まれば、フルフレーム(60Hz)で遅延なくスムーズに描画出来る。
描画オブジェクトが物理的に増えて、1フレームに収まらないと、フレームレートはどんどん落ちていく。
それでも、描画は裏で行っており、見えないので、チラツキは出ない。

glcdc_mgr は、フレームバッファの先頭アドレスを管理している。
GLCDC ハードウェアーは、水平ラインのアドレスは64の倍数でなければならない・・
ダブルバッファが有効な時、ページフリップに従ったアドレスを戻す。

        static const int16_t line_width =
            (((width * static_cast<int16_t>(PXT) / 8) + 63) & 0x7fc0) / (static_cast<int16_t>(PXT) / 8);
        static const uint32_t frame_size =
            line_width * (static_cast<uint32_t>(PXT) / 8) * height;

        void* get_fbp() const noexcept
        {
            uint32_t ofs = 0;
            if(enable_double_) {
                ofs = (flip_count_ & 1) != 0 ? 0 : frame_size;
            }
            if(layer2_org_ != nullptr) {
                uint32_t org = reinterpret_cast<uint32_t>(layer2_org_);
                return reinterpret_cast<void*>(org + ofs);
            } else if(layer1_org_ != nullptr) {
                uint32_t org = reinterpret_cast<uint32_t>(layer1_org_);
                return reinterpret_cast<void*>(org + ofs);
            }
            return nullptr;
        }

垂直同期のタイミングで先頭アドレス(GR2FLM2)がロードされる。
※「GR2VEN」を有効にしておかないと、レジスタを書き換える事が出来ない。

        void sync_vpos() const noexcept
        {
            if(enable_double_) {
                uint32_t ofs = (flip_count_ & 1) != 0 ? 0 : frame_size;
                uint32_t org = reinterpret_cast<uint32_t>(layer2_org_);
                GLC::GR2VEN = 1;
                GLC::GR2FLM2 = org + ofs;
            }
            volatile auto n = ctrl_blk_.vpos_count;
            while(n == ctrl_blk_.vpos_count) {
                asm("nop");
            }
        }

また、RX651/RX65N から搭載された描画エンジン DRW2D は、ソフトの描画に比べて、格段に高速なので、これを有効に活用するのに適している。


OpenGL 的なフレームワーク

「ダブルバッファ」と言えば、やはり3Dグラフィックスだろうと思う。
※スプライトと言う人もいるが・・・

昔から、リアルタイム 3D グラフィックスには、注力しているので、最も馴染みが深い OpenGL を縮小にした API を実装して実験してみた。

とりあえず、L チカに相当するキューブの回転w

RX マイコン内蔵の DRW2D 描画エンジンは、2D の描画用だが、基本的な構造が、3D にもマッチするように構成されている。

オブジェクトの座標をマトリックス演算して、透視変換、スクリーン座標変換まで行えば、2D 座標となり、そのまま描画出来る。
※テクスチャマッピングは多少難解かもしれないが、透視変換に適した API があるようだ。(これは今後の課題)

ポリゴンの描画では、裏と表の概念があり、親和性が良い。
※殆ど何もする事が無いと言いたいところだけど、立体ボリュームに対するクリッピング、ライティングなどを考えると、ちゃんと実装するのはかなり大変ではある。
端折ったテスト的なレンダリングなら簡単!

ほぼ OpenGL と同じような手順で描画出来るようにした、C++ なので、色々と便利機能を実装出来る。

    float ax = 0.0f;
    float ay = 0.0f;
    while(1) {
        render_.sync_frame();

        render_.clear(DEF_COLOR::Black);

        auto& m = tgl_.at_matrix();
        m.set_viewport(0, 0, LCD_X, LCD_Y);
        m.set_mode(gl::matrixf::mode::modelview);
        m.identity();
        m.translate(0.0f, 0.0f, -10.0f);
        m.rotate(ax, 1.0f, 0.0f, 0.0f);
        m.rotate(ay, 0.0f, 1.0f, 0.0f);

        ax += 1.0f;
        if(ax >= 360.0f) ax -= 360.0f;
        ay += 1.5f;
        if(ay >= 360.0f) ay -= 360.0f;

        m.set_mode(gl::matrixf::mode::projection);
        m.identity();
        m.perspective(45.0f, static_cast<float>(LCD_X) / static_cast<float>(LCD_Y), 1.0f, 50.0f);

//      draw_box_(2.0f, TGL::PTYPE::LINE_LOOP);
        draw_box_(2.0f, TGL::PTYPE::QUAD);

        tgl_.renderring();
    }

RX72N TFU を有効に!

RX72N は、三角関数演算器を持っているので、これを有効に利用するコードを追加。

回転行列の演算では、以下の API を利用しているので、その部分で、専用 API を呼ぶようにした。

    static inline void deg_sin_cos_(float deg, float& si, float& co) noexcept
    {
#ifdef SIG_RX72N
        __builtin_rx_sincosf(deg  * vtx::deg2rad_f_, &si, &co);
#else
        si = std::sin(deg * vtx::deg2rad_f_);
        co = std::cos(deg * vtx::deg2rad_f_);
#endif
    }

むすび

非常に初歩的ではあるが、3D オブジェクトの描画をテストした。
実用的に使うには、まだまだこれから色々入れないとならない・・・

とりあえず、ダブルバッファの実験から脱線したので、このプロジェクトはストールして、デジタルストレージオシロスコープの実装に戻る。

DRW2D エンジンは、今までほとんど使って来なかったので、良いきっかけになったと思う。

DRW2D エンジンは、アンチエリアスもサポートされており、このハードウェアーの情報は少ないが、かなり良く出来ていると思う。

RXマイコン、MTUテンプレートクラスを更新

MTU テンプレートクラスをクリーンアップ

RXマイコンの MTU は、非常に高機能で、シリーズが異なると微妙に仕様が異なっている場合もある。

以前に、RX24T で、MTU を使った時に、未完全な状態で実装したが、少し整理してみた。
これは、RX72N Envision Kit で、デジタルストレージオシロを作る場合に MTU の出力が必要な為だ。
※プローブのインピーダンスマッチングを行う場合など、基準波を出力する必要がある為だ。
Pmod2 コネクタに PD1 がアサインされており、PD1 は、MTIOC4B に設定可能となっている。
※この端子は、MTU4、コンペアマッチBに対応した出力として利用可能となっている。


テンプレートの複雑な型を回避

テンプレートクラスの場合、実装時の問題として、「にわとりの卵」問題が起こる場合がある。

これは、テンプレート内に、そのクラス特有の構造体や、enum class 型を定義している場合などで、起こる。

テンプレート内に定義すると、テンプレートの正確な型を知らないと、その定義にアクセス出来なくなる。

template <class A, class B, class C>
class asdfg {
public:

    enum class TYPE {
        AAA,
        BBB,
        CCC,
    };

    struct setting_t {

        ...
    };

};

上記のテンプレートクラスでは、asdfg クラスの「TYPE 型」や、「setting_t 構造体」にアクセスしたい場合、class A、B、C の正確な「型」を知らないと出来ない。

そこで、この回避策として、これら定義を分離してプレーンなクラスとして定義する。

class asdfg_base {
public:
    enum class TYPE {
        AAA,
        BBB,
        CCC,
    };

    struct setting_t {

        ...
    };
};

そして、そのクラスを継承する。

template <class A, class B, class C>
class asdfg : public asdfg_base {

    ...

};

こうすれば、クラス A、B、C の型を知らなくても、「asdfg_base::TYPE」、「asdfg_base::setting_t」として参照出来る。
※「asdfg_base」クラスは、メンバー変数などを置かない、「定義」だけのクラスにしておく、そうすれば、結びつきが緩和されて、全体的な構成がシンプルとなる。
※ C++ での「継承」は、クラスとの結びつきが強力で、なるべく使わない設計が好まれる。

タイマー関係のポート設定

現在のフレームワークでは、比較的簡単な定義で、ペリフェラル固有のポート設定を自動化している。
これは、外部プログラムの助けを借りて、設定を生成しなくても、簡単な指定で、ポートのアサインを自動で行う事が出来る仕組みとなっている。
また、ソースコードはオープンソースとしているので、足りない機能は、個々に追加できる事も大きい。

ポートのアサインは、非常に多義に渡り、複雑でボリュームが大きく、マイコン種別で異なる。
C++ では、コンパイラの最適化で、余分なコードは極限まで排除出来る為、最終的に必要無いコードは、実行バイナリーに含まれない。
※コンパイル時にパラメーターが決定されている必要がある。

arduino などでは、ポートは、決められた整数値を通して、普通の関数で行っている。
この場合、関数内では、switch 文などで、場合別けをして、それぞれの設定を行っている。
しかし、このような実装では、コンパイル時の最適化で余分なコードを排除する事は難しいし、速度が出ない場合がある。
テンプレートパラメーターの場合は、同じように場合別けで実装しても、コンパイル時に、決定された固定値以外のルートにあるコードは削除される。
これが、C++ テンプレートの強みであると思う。


ポートのアサインを行うクラスは、「port_map」で行っている、しかし、MTU 関係は、ポートの指定が複雑なので、専用のクラスを実装する事にした。
※「port_map_mtu.hpp」に移動した。

以下は、MTU 関係のポートを RX72N 176 ピンバージョンから、抜き出して、並べた。
※基本的に、144 ピンやそれ以下のバージョンでは、部分的にポートが無いだけで、対応は同じとなっている。

        ///< P34 ( 27)  MTIOC0A
        ///< PB3 ( 98)  MTIOC0A / MTIOC4A
        ///< P15 ( 50)  MTIOC0B / MTCLKB
        ///< P13 ( 52)  MTIOC0B
        ///< PA1 (114)  MTIOC0B / MTCLKC / MTIOC7B
        ///< P32 ( 29)  MTIOC0C
        ///< PB1 (100)  MTIOC0C / MTIOC4C
        ///< P33 ( 28)  MTIOC0D
        ///< PA3 (110)  MTIOC0D / MTCLKD

        ///< P20 ( 45)  MTIOC1A
        ///< P21 ( 44)  MTIOC1B / MTIOC4A

        ///< P26 ( 37)  MTIOC2A
        ///< PB5 ( 96)  MTIOC2A / MTIOC1B
        ///< P27 ( 36)  MTIOC2B

        ///< P17 ( 46)  MTIOC3A / MTIOC3B / MTIOC4B
        ///< P14 ( 51)  MTIOC3A / MTCLKA
        ///< PC7 ( 76)  MTIOC3A / MTCLKB
        ///< PC1 ( 89)  MTIOC3A
        ///< P22 ( 43)  MTIOC3B / MTCLKC
        ///< PC5 ( 78)  MTIOC3B / MTCLKD
        ///< P80 ( 81)  MTIOC3B
        ///< PB7 ( 94)  MTIOC3B
        ///< PJ3 ( 13)  MTIOC3C
        ///< P56 ( 64)  MTIOC3C
        ///< P16 ( 48)  MTIOC3C / MTIOC3D
        ///< PC6 ( 77)  MTIOC3C / MTCLKA
        ///< PC0 ( 91)  MTIOC3C
        ///< P23 ( 42)  MTIOC3D / MTCLKD
        ///< P81 ( 80)  MTIOC3D
        ///< PC4 ( 82)  MTIOC3D / MTCLKC
        ///< PB6 ( 95)  MTIOC3D
        ///< PE0 (135)  MTIOC3D

        ///< P24 ( 40)  MTIOC4A / MTCLKA
        ///< P82 ( 79)  MTIOC4A
        ///< PA0 (118)  MTIOC4A / MTIOC6D
        ///< PE2 (133)  MTIOC4A
        ///< P30 ( 33)  MTIOC4B
        ///< P54 ( 66)  MTIOC4B
        ///< PC2 ( 86)  MTIOC4B
        ///< PE3 (132)  MTIOC4B
        ///< PD1 (156)  MTIOC4B
        ///< P25 ( 38)  MTIOC4C / MTCLKB
        ///< P87 ( 47)  MTIOC4C
        ///< P83 ( 74)  MTIOC4C
        ///< PE5 (130)  MTIOC4C / MTIOC2B
        ///< PE1 (134)  MTIOC4C / MTIOC3B
        ///< P31 ( 32)  MTIOC4D
        ///< P86 ( 49)  MTIOC4D
        ///< P55 ( 65)  MTIOC4D
        ///< PC3 ( 83)  MTIOC4D
        ///< PE4 (131)  MTIOC4D/MTIOC1A
        ///< PD2 (154)  MTIOC4D

        ///< P12 ( 53)  MTIC5U
        ///< PA4 (109)  MTIC5U / MTCLKA
        ///< PD7 (143)  MTIC5U
        ///< P11 ( 67)  MTIC5V
        ///< PA6 (107)  MTIC5V / MTCLKB
        ///< PD6 (145)  MTIC5V / MTIOC8A
        ///< P10 ( 68)  MTIC5W
        ///< PB0 (104)  MTIC5W
        ///< PD5 (147)  MTIC5W  /MTIOC8C / MTCLKA

        ///< PJ1 ( 59)  MTIOC6A
        ///< PE7 (125)  MTIOC6A
        ///< PJ0 ( 60)  MTIOC6B
        ///< PA5 (108)  MTIOC6B
        ///< P85 ( 61)  MTIOC6C
        ///< PE6 (126)  MTIOC6C
        ///< P84 ( 62)  MTIOC6D

        ///< PA2 (112)  MTIOC7A
        ///< P67 (120)  MTIOC7C
        ///< P66 (122)  MTIOC7D

        ///< PD4 (148)  MTIOC8B
        ///< PD3 (150)  MTIOC8D

ピンのアサインで、痛いとこは、ピンの割り付けは自由に出来ない点だ・・
何故、自由に出来ないのか?、ノイズや、複雑度、回路設計上の事情など様々と思うが、内部の機能を全て有効に使う事は通常出来ない。

毎回、特定のボードで、色々な機能を割り振る場合に、ピンのアサインが可能かどうかを調べる作業が難航する。
使う機能が少ない場合は、難しくないのだが、色々な機能を使いたい場合に、いつも苦労する。
場合によっては、ピンのアサインが重複して、機能を使えない場合も多々起こる。
ボードが出来てから、機能を追加する場合などに、どう頑張ってもアサインが出来ずに、パターンを切って貼ってを行う場合も起こる・・
このような制約は、今後回避出来るようにしてもらいたいものだが・・

また、ハマリポイントとして、MTU3、MTU4 は、ポートが、他のチャネルと重複している為、特定のレジスタを有効にする必要がある。

TOERA レジスタは、出力端子の MTIOC4D、MTIOC4C、MTIOC3D、MTIOC4B、MTIOC4A、MTIOC3B
の出力設定の許可 / 禁止を行うレジスタです。
これらの端子は TOERA レジスタの各ビットの設定をしないと正しく出力されません。TOERA レジスタ
は MTU3、MTU4 の TIOR レジスタ設定の前に値をセットしてください。
MTU.TOERA レジスタは、MTU.TSTRA レジスタの CST3、CST4 ビットを “0” にした後で設定してくださ
い。

RX72N Envision Kit でのテスト

RX72N Envision Kit では、Pmod2 コネクタの 8 番ピンに、PD1 がアサインされている。
PD1 は、MTU4 の B チャネル出力として利用できる。

定義は以下のように行う:
※ポートの候補は「FIFTH」となっている。

    typedef device::MTU4 MTU;
    static const auto PSEL = device::port_map_mtu::option::FIFTH;
    typedef device::mtu_io<MTU, utils::null_task, utils::null_task, PSEL> MTU_IO;
    MTU_IO  mtu_io_;

10000Hz、チャネル B、コンペアマッチでトグル出力としている。
※トグル出力の場合、内部では、倍の 20000Hz でカウンタが動作するように自動で設定される。

    {
        uint32_t freq = 10'000;
        if(!mtu_io_.start_normal(MTU::channel::B, MTU_IO::OUTPUT::TOGGLE, freq)) {
            utils::format("MTU4 not start...\n");
        } else {
            list_mtu_freq_();
        }
    }

内部のカウンタ誤差を表示する:
mtu_io クラスでは、MTU の分周器の機能を使い、なるべく設定値に近い周期を設定しようとする。
それでも、設定誤差が大きい場合はある。

    void list_mtu_freq_()
    {
        utils::format("MTU rate (set):  %d [Hz]\n") % mtu_io_.get_rate();
        auto rate = 1.0f - static_cast<float>(mtu_io_.get_rate()) / mtu_io_.get_rate(true);
        rate *= 100.0f;
        utils::format("MTU rate (real): %d [Hz] (%3.2f [%%])\n")
            % mtu_io_.get_rate(true) % rate;
    }

ターミナル出力:

Start test for 'RX72N' 240[MHz]
SCI Baud rate (set):  115200
SCI Baud rate (real): 115355 (0.13 [%])
CMT rate (set):  100 [Hz]
CMT rate (real): 100 [Hz] (0.00 [%])
MTU rate (set):  10000 [Hz]
MTU rate (real): 10000 [Hz] (0.00 [%])

※この全ソースコードは、Github の RX/test にある。
※RX/test は、プロジェクトに組み込む単機能のテストを行うもので、場合によりコードが残らない場合がある。

RXマイコン、デジタルストレージオシロスコープ(その2)

シュミレーター:

マイコン内蔵A/Dコンバーター

RXマイコンのメリットとして、内蔵A/DコンバーターのSNが高い事があると思う。
※最近の他社マイコン、ARM、ESP32、PIC32などの現実はあまり詳しく無い。
※かなり昔に比較した時に、確かに優位性があった。

RXマイコン内蔵、A/Dコンバーターも、豊富な変換モード、サンプルホールド、細かいチャネル設定など、非常に柔軟な設定が可能になっている。
広範囲の事柄が関係するので、理解して応用するのは大変だ・・
また、アナログ回路も絡むので、その部分で、デジタル回路には無い難しさがある。


RX72N の場合:

項目 内容
ユニット数 2ユニット(S12AD, S12AD1)
分解能 12ビット
変換時間 1チャネル当たり(0.48μs)(12ビット変換モード)
1チャネル当たり (0.45μs)(10ビット変換モード)
1チャネル当たり (0.42μs)(8ビット変換モード)
備考 (A/D変換クロック ADCLK = 60MHz動作時)

12 ビットの変換時、チャネル辺り、最大 0.48 マイクロ秒で変換出来る。
RX65N Envision Kit、RX72N Envision Kit では、同時に2チャネルが変換可能なアナログチャネルが、pmod コネクタなどにアサイン可能となっている。
※多少残念なのは、電圧リファレンス端子が、内蔵電源に接続されている点がある・・

2M サンプルで同時 2 チャンネルなら、まぁ仕様としては何とか実用性があると思える。

以上の仕様で、簡易なデジタルストレージオシロが作れると思っていた。
そこで、RX65N Envision Kit で簡単な実験を行い、実際にキャプチャーしたデータをLCDに表示して基本的な実験は成功していた。
ただ、RX65N ではCPUのクロックが 120MHz なので、2M サンプルだと、複雑なトリガー条件を作成すると、割り込み処理がオーバーフローするかもしれない・・
DMA 転送にすれば良いと思うかもしれないが、トリガー条件により、電圧の変化を検出する必要があるので、ソフトの介入がどうしても必要となる。

また、アナログのフロントエンド部のハードウェアーとして、どのようなものが適当なのか、検討していた。

最近、PC 上で API レベルシュミレーターを実装した事で、ようやくプロジェクトが動き始めた。

ソフトが重要

データをキャプチャーするのは簡単だが、問題は GUI 関係のソフトウェアーだと思う。

デジタルストレージオシロを実用的に使うには、ソフトの機能、基本的なデザイン(操作の考え方)が重要で、複雑で、大きなボリュームになる。

以前に、工場で使う検査装置として、デジタルストレージオシロの機能が入った物を作った事がある。
その時は、波形のキャプチャーだけ、外部のFPGAとマイコンを組み合わせた機器で行い、波形の表示などは、PCで行った。
その時は PC 上のソフトなので、効率やメモリ、速度などは気にする必要が無く、自由に作れた。
それでも、非常に面倒な作業で、時間や電圧の変換、操作性など、色々苦労した事が蘇る・・

RX65N Envision Kit や RX72N Envision Kit の場合、液晶の解像度も小さいので、操作性も考慮する必要がある。
また、タッチパネルの操作が基本なので、そのようなデザインを考える必要がある。
加えて、外部に接続するハードウェアーもあまり大掛かりにならないようにする事も考慮する必要がある。
最近では、数万円出せば、高性能なデジタルストレージオシロが買えるので、作っても、あまり利用頻度は大きいとは思えないが、ソフトの構成や、基本的な構成などは、一つのアプリケーションとして参考になると思う。
教材として考えれば、それなりに利用価値があるものと思って進めている。

また、オープンソースとする事で、誰でも、「欲しい機能」を追加する事も出来る。
※特殊なトリガー条件などを実装する事が出来ると思う。


PC 上の、API レベルシュミレーションは便利で、暇を見つけてコツコツ進めている。
GUI Widget フレームワークも完成度と機能が充実しつつあるので、GUI などの面でも実装が楽になってきた。

PC では、A/D コンバーターの部分をシュミレーションにより作成して、それを A/D の変換値12ビット整数データとして与え、ソフトを実装している。
キリの良いとこで、実機でも動かして確認する。

A/D の疑似波形を生成

疑似波形としては、サイン波、三角波、矩形波などをサポートして実験を行っている。
※実機では、ノイズなども考慮する必要があるので、最終段階では、ソフトでノイズを混ぜる事も考える必要がある。

        //-----------------------------------------------------------------//
        /*!
            @brief  SIN/COS 波形を生成
            @param[in]  freq    周波数
            @param[in]  ppv     電圧 (peak to peak)
            @param[in]  num     生成数
            @param[in]  ch0     CH0 波形型
            @param[in]  ch1     CH1 波形型
        */
        //-----------------------------------------------------------------//
        void make_wave(uint32_t freq, float ppv, uint32_t num, PWAVE_TYPE ch0, PWAVE_TYPE ch1)
        noexcept
        {
            static int32_t count = 0;
            auto smpl = get_samplerate();
            auto& task = at_cap_task();
            auto unit = static_cast<float>(smpl) / static_cast<float>(freq);
            auto vgain0 = voltage_to_value(0, ppv);
            auto vgain1 = voltage_to_value(1, ppv);
            for(uint32_t i = 0; i < num; ++i) {
                auto a = static_cast<float>(count % static_cast<int32_t>(unit)) / unit;
                task.adv_.x = -pwave_(ch0, a, vgain0);
                task.adv_.y = -pwave_(ch1, a, vgain1);
                if(task.adv_.x < -CAP_OFS) task.adv_.x = -CAP_OFS;
                else if(task.adv_.x > (CAP_OFS-1)) task.adv_.x = CAP_OFS-1;
                if(task.adv_.y < -CAP_OFS) task.adv_.y = -CAP_OFS;
                else if(task.adv_.y > (CAP_OFS-1)) task.adv_.y = CAP_OFS-1;
                task();
                ++count;
                if(count >= CAP_NUM) {
                    count = 0;
                }
            }
        }

サイン波や、三角波、矩形波は、以下のような関数で生成する。

        static float ftri_(float in) noexcept
        {
            auto a = fmod(in, 1.0f);
            if(a >= 0.5f) {
                a = 1.0f - a;
            }
            a -= 0.25f;
            return a * 4.0f;
        }

        static float fsqu_(float in) noexcept
        {
            auto a = fmod(in, 1.0f);
            if(a < 0.5f) {
                return 1.0f;
            } else {
                return -1.0f;
            }
        }

        static float fsquf_(float in, float& back) noexcept
        {
            auto a = fsqu_(in);
            auto d = (a - back) * 0.707f;
            auto ans = back + d;
            back = a; 
            return ans;
        }

        static int16_t pwave_(PWAVE_TYPE pw, float phase, float gain) noexcept
        {
            static float fsqu_s_ = 0;
            static float fsqu_c_ = 0;
            int16_t ret = 0;
            switch(pw) {
            case PWAVE_TYPE::SIN:
                ret = static_cast<int16_t>(sinf(phase * vtx::radian_f_) * gain);
                break;
            case PWAVE_TYPE::COS:
                ret = static_cast<int16_t>(cosf(phase * vtx::radian_f_) * gain);
                break;
            case PWAVE_TYPE::TRI_C:
                ret = static_cast<int16_t>(ftri_(phase) * gain);
                break;
            case PWAVE_TYPE::TRI_S:
                ret = static_cast<int16_t>(ftri_(phase + 0.25f) * gain);
                break;
            case PWAVE_TYPE::SQU_C:
                ret = static_cast<int16_t>(fsqu_(phase) * gain);
                break;
            case PWAVE_TYPE::SQU_S:
                ret = static_cast<int16_t>(fsqu_(phase + 0.25f) * gain);
                break;
            case PWAVE_TYPE::FSQU_C:
                ret = static_cast<int16_t>(fsquf_(phase, fsqu_c_) * gain);
                break;
            case PWAVE_TYPE::FSQU_S:
                ret = static_cast<int16_t>(fsquf_(phase + 0.25f, fsqu_s_) * gain);
                break;
            default:
                break;
            }
            return ret;
        }

現在の実装は「capture.hpp」に含めている。
※これは、見直すべきかもしれないが・・

SIN、COS は、同じ物で、位相が 45度異なるだけとも言える。


A/D コンバーターのプリアンプ

サンプリングが 2MHz だと、実用的に扱える周期は 1/10 の 200KHz くらいだろうか・・
その場合でも、1 周期、10 サンプルしか無い・・

オシロスコープとしては、かなり低機能なものなので、あまり高性能なフロントエンドを考える必要は無いものの、経験が無いので、どのような構成にすべきなのか良く判らない。
一番良いのは、実際のオシロスコープを分解して、リバースエンジニアリングを行うのが手っ取り速い気がする・・
最初から最高の物を目指すと、完成しないので、改修していけばいいだろうと思う。

1X、プローブを接続する場合、入力インピーダンスは 1000K オーム程?
※10X プローブでは、9000K オームの入力抵抗が直列に入っているものと思う。

最初、1X、10X プローブを両方使えるようにしようと思ったが、回路が大掛かりになりそうなので、1X のみにしようと思う。
※10Xでは、既に1/10になるので、分圧は必要無いが、それを直でオペアンプに入れると、1X を接続した場合に、過電圧からの保護が難しい。
※アナログスイッチで、過電圧保護機能が充実しているデバイスを使えば良さそうだが、値段が高い。

何となく、機械式リレーを使うのが嫌なので、フォトモスリレーを使って、DC、AC を切り替えている。

オペアンプは、オーディオ用の物だが、以前にオーディオ用 DAC に使った部品が沢山余っている。

この回路には、過大な電圧を制限して、A/D の入力を制限する回路が含まれていない・・


まだ、実際の回路で試していないので、この回路では、駄目かもしれないが・・

レンジ切り替えや、AC、DC 切り替えは、機械式スイッチにすれば良いのかもしれないが、スマートでは無くなる気がする・・・

全体の機能

現在シュミレーターを使い、以下の機能を大体実装した。

チャネル電圧切り替え:

  • AC, GND, DC, OFF
  • 10V,5V,2V,1V,500mV,200mV,100mV,50mV,10mV

サンプリング切り替え:

  • 1us,2us,5us
  • 10us,20us,50us
  • 100us,200us,500us
  • 1ms,2ms,5ms
  • 10ms,20ms,50ms
  • 100ms,200ms,500ms

トリガー切り替え:

  • None,One,Run,CH0-Pos,CH1-Pos,CH0-Neg,CH1-Neg

計測:

  • Time Sub,CH0 Sub,CH1 Sub,Time Abs,CH0 Abs,CH1 Abs

まとめ

シュミレーターのおかげで、ソフト部はかなり進んだが、やはりハード部は、進捗が遅い・・・

現状のコードは、シュミレーター「glfw_app/rx_gui_emu」から、定期的に「RX/DSOS_sample」にマージしている。

デジタル制御ハンダごて

TS100 について

かなり前から一部の人達の間で話題になっていた「デジタル制御」のハンダごてを購入した。

非常に小さく、軽いが、かなりパワフルで、温度制御が素早く、安定しているのが「売り」となっている。

マイコン内蔵で、かなり厳密な温度制御を行っている。

小さなLCDが本体にあり、温度を設定する事やモニターする事が出来る。

電源

電源は、DC12V~DC24Vくらいまで使えて、電圧が高い程、温度上昇が素早くでき、熱容量も大きい。
※当然、消費電力に見合った電流を流せる電源が必要となる。

DC24Vで、300度まで10秒となっている。

コテは、先端部(ヒーター内蔵)と本体に分かれており、一般的なハンダごてとは構造が異なる。
※専用のコテ先が必要で、ヒーター内蔵なので割高だが、入手性は良いようだ。

最近は、USB-C を電源とするタイプがあるが、まだ割高なので、旧タイプ(TS100)を選んだ。
自分の買ったパッケージは、19VのACアダプタが付属しているが、コードの柔軟性がイマイチなので、柔らかくて細いコードと交換しようと思う。

まとめ

本体とコテ先を固定するのに、1.5mmのスクリューキャップレンチが付属していたが、粗悪品で、使えなかったので、自前の工具を使った。

自分は、大陸から買ったので商品が届くまで2週間強くらいかかったが、国内で買うより安かった。(6000円くらい)
※本体だけならもっと安い。

まだあまり使っていないので、詳細なレビューは、後々しようと思う。

RXマイコンオーディオプレイヤー関係を更新

MP3, WAV の全体時間を表示

色々さぼっていた部分を更新した。
ただ、イマイチとなってしまった事もある・・

WAV ファイルで RAW の場合、圧縮は無いので、全体の時間を取得する事は、割と簡単に出来る。

これが、MP3 の場合は、結構面倒な処理を通す必要がある。

可変ビットレートの場合は、特に面倒だ・・

今まで全体時間は表示していなかったので、サウンド関係クラスを全体的に、細かく色々修正をした。

ただ、問題もある、3分程度の MP3 ファイルの全体時間を取得するのに2秒くらいかかる・・・
余分な処理は通していないハズだが、240MHz の RX72N でもそのくらいかかる・・・

何がネックになっているのか解析していないが・・
詳しく読んだ訳では無いが、MP3 のフレームのヘッダー情報をパースするだけなのだが・・・

mad ライブラリは、あまり詳しく理解している訳では無いので、API の使い方が悪いのかもしれない・・・

とりあえず、これは、今後の課題とする・・

ID3 タグ関係を更新

MP3 のタグ関係も細かく更新した。

ここでの問題は、APIC 情報で、プログレッシブ方式で格納された画像をデコード出来ない問題だ。
picojpeg では、プログレッシブ方式はサポートしていない。
※サポートしようとすると、メモリを消費するので仕方無いと思うが、余分なメモリを使わないで強引にパースする事は出来そうに思う。
ただ、メモリ使用量の制約では、ソフトは、もの凄く面倒になるのは間違いない・・・
なので、これは保留とする。
※それでなくとも、デコードしながら、リアルタイムに画像をスケールして、直でフレームバッファに書き込むようにして、メモリを節約している。

プログレスバー表示

全体時間が取得できるようになったので、プログレスバー表示を追加した。

その過程で、widget 関係の管理を少しだけ見直した。
以前の電卓アプリでも、色々拡張したが、まだまだ足りない機能がある。

色々やりたい事はあるが

既にバイナリーは860キロを超えており、フラッシュの書き換えに時間がかかる・・・
このアプリでは、シュミレータで実験するには、色々とサポートしなければならない機能があるので、それも面倒。
※やろうとすると、実装に時間がかかりそう・・
それに、速度のシュミレーションは現状では出来ないし・・

ID3 タグのパースも色々問題があるかもしれない・・

ID3 タグのパースは、自前のコードを使っている。
一応、ちゃんと説明を理解して実装してはいるが、MP3 タグの場合、それだけでは、パース出来ない場合がある。

これはつまり、厳密には間違った仕様で作られたMP3ファイルでも、それを出来るだけ回避してパースする工夫を盛り込む必要がある。
厳密に間違った仕様を弾いていると、よの中に流通しているMP3のタグをパース出来ない場合がかなり出現する。
かなり知名度があったアプリでも、間違った TAG を吐くアプリも存在する為、既成事実的にそれで作成した物をパースする必要がある。

また、文字コードに起因する解釈の違いもある、これはかなり厄介だ、UTF-8 や UTF-16 ならほぼ問題無いが、OEM コードの場合、国別で意味が異なるので、日本語圏以外で作られた物を日本語圏でデコードすると化ける。

また OEM コードなのに UTF-8 であったり、UTF-8 のハズなのに OEM コードだったり・・

APIC のプログレッシブの件は別としても、色々問題は多く、全てに対応する事は不可能なので、最悪「死ぬ」事を防いで、スルーするしかない。

picojpeg の問題

JPEG のデコーダーは、フルセット版を利用出来ない。
これは、殆どの場合、メモリ不足になる為で、picojpeg を利用している。

ベースラインでエンコードされた画像であっても、picojpeg ではサポートしていない機能があるようだ。

その場合、タグの画像を張り替えるしかない・・・

現在判明している、サポート出来ないマーカー:

ID3v2: Ver: 0400, Flag: 80 (153579)
V2.3: 'image/jpeg'
Album:   'sasakure.UK - プロトタイプ ナナクジャク'
Title:   'トゥイー・ボックスの人形劇場'
Artist:  'sasakure.UK'
Artist2: 'sasakure.UK'
Year:
Disc:     1/1
Track:    3/11

Audio file: '03 トゥイー・ボックスの人形劇場.mp3'
JPEG status: 20

picojpeg.c

      case M_SOF1:  /* extended sequential DCT */
      default:
      {
         return PJPG_UNSUPPORTED_MARKER;
      }

文字列が長い場合に対応

アルバム名、曲名、アーティスト名などが、長い場合がある。
以前は、気にせず描画していたので、ジャケット画像に重ねて表示されていた。

これを、正確にクリッピングして、表示しきれない場合は、スクロールをして全体を表示させるようにした。

この機能は、widget text クラスで行っているので、オーディオプレイヤーの機能ではなく一般化した GUI の機能となる。

描画は、オフラインで行っていない為、多少ちらつくが、まぁ「良し」としている。
かなり細かい描画を組み合わせているので、色々と問題が起こるかもしれないが・・

どんな感じに表示されるのかは、動画じゃないとわかりづらい。

レベルメーター表示

オーディオ出力時のレベルをサンプリングして、レベルメーター的な物を追加した。
ピークホールド表示も追加。

CD をリッピングして MP3 を作成するには?

ところで、CD をリッピングして MP3 を作成する場合、どんなアプリを使うべきか?

自分の知見では、SONY の「Music Center for PC」が一番良いのではと思っている。
※SONY の Music プレイヤーを持っていなくても利用できる。

全ソースコードなど

このプロジェクトは、RX72N Envision Kit 専用では無い、RX65N Envision Kit でも動作する。
※オーディオ出力は、12 ビットの D/A アナログ出力となるが・・

AUDIO_sample (Github)

FreeRTOS を更新

FreeRTOS カーネルを最新版に更新

ようやく、FreeRTOS で TCP、WiFi などを扱うので、この機会にカーネルを最新版にアップデートした。

以前は、バージョン番号で管理されていたが、最近は、更新日がバージョンとなっているようだ。

今回は「FreeRTOS V202011.00」となっている。

RX700v3 コア用のポートが追加された

RX72N などで、DFPU がサポートされた為、「RX700v3_DPFPU」のポートが追加された。

ただ、ソースコードを見ると・・・

#warning Testing for DFPU support in this port is not yet complete

とあるので、まだ、テストが完了していないようだ・・・
※現状のコードでは、コンパイルが通らない・・・

これは、つまり、「-dfpu」を有効にして、double の演算を行った場合は問題が起こると言う事なのか・・・
多分、double の演算を、一つのタスクで行い、他のタスクで利用しなければ問題無いと思うが・・・

FreeRTOSConfig.h の設定に関するメモ

  • このヘッダーは、基本、自分がサポートする RXマイコンで共有出来るようにしている。
  • メモリーモデルで「FreeRTOS/Source/portable/MemMang/heap_1.c」を利用する場合。(RX24T)
  • Makefile で「RTOS_HEAP_SIZE=10」などのようにサイズ(KB)を設定する。(RX24T)
  • メモリーモデルで「FreeRTOS/Source/portable/MemMang/heap_3.c」を使う場合は、内部で「malloc, free」を呼ぶ為、必要無い。
  • Plus TCP を使う場合、heap_4.c、heap_5.c を使う必要があるようなので、RTOS_HEAP_SIZE は設定する必要がある。
  • 独自のメモリアロケータを使うのには抵抗があるが、仕方無い・・・(以前に、微妙なバグで酷い目にあった事がある・・)

RX72N 用を追加

既に、オーディオプレイヤーなどで、FreeRTOS を利用していたが、サンプルのプロジェクトが無かったので追加した。

ソースコードなどを整理

合わせて、コードの整理、README.md、READMEja.md などを追加修正した。


次は、イーサーネットドライバーなどを整理して、ネットワーク関係に本格着手したい・・
※今まで、ルネサス社のネットスタックを使っていたが、FreeRTOS を使うようになると、より汎用的なネットスタックに移行する方が全ての面で恩恵が大きいものと思う。
シングルタスクで、ネット関係を運用するのは、かなり面倒で難しい問題が発生し、パフォーマンスを最適化するのも困難になる。

RX72N Envision Kit での開発(その5)関数電卓を作る

関数電卓をでデザインする

何か、実用的なアプリを作りたくて、今回「関数電卓」を選んでみました。

グラフ表示付きの関数電卓が、それなりの値段で売られているので、それなら、自分で作ればいいのでは?
と言う、不憫な動機も少しはありますw

実際、作ってみると、けっこう奥が深く、C++ の学習にも良い教材と思います。

  • 実際のコードは、それなりに巨大で、サンプルと言うには無理があるかもしれないです。
  • GUI 関係の挙動をプログラムすると、物理的にコード量が多くなります。
  • 通常、演算には double を使えば、それなりの精度なので実用上十分かもしれませんが面白味に欠けると思います。
  • 240MHz で動く RX72N で動かすのならと思い、「多倍長」のライブラリを利用してみました。
  • メモリが許す限り大きな桁が可能なのですが、とりあえず250桁にしています。(簡単に増やせますが、表示方法を工夫する必要があります)
  • 将来的には、WiFi を有効にして、ブラウザ経由で操作する事も行う予定です。
  • また、プログラム電卓としての機能やグラフ表示、数式処理も付けたいと思っています。
  • まだ及第点と言う訳ではなく、とりあえず、最低限の機能を使える状態です。

API レベルシュミレータの導入

組み込みマイコンで開発を行う場合、フラッシュメモリへの書き込みを行い、ターゲットを起動して動作確認をする流れになります。
しかし、実行バイナリーサイズが大きくなると、フラッシュへの書き込み時間が増え、「修正」→「確認」のサイクルが長くなります。
GUI 系プログラムでは、「良い見た目と」、「良い操作性」を実現するには、細かい調整や修正がどうしても必要になるので、「試す」サイクルが長いのは、かなりの問題で、開発効率が悪いです。

  • 漢字のビットマップフォントだけでも260Kあります。
  • 実機では、UTF-8 を OEM(S-JIS)のコードに変換する為、FatFs を利用しています。

前もって、PC 上で「見た目」や「操作の挙動」を確認できるだけでも、開発効率が格段に上がります。

今回、PC で動作するシュミレータを作り、その助けを借りて、このアプリを作成しました。
電卓の機能もシュミレータ上で確認出来るよう、RX マイコンのソースコードを共有しています。


RX マイコンの GUI フレームワークでは、描画は全てソフトで行っており、DRW2D エンジンをまだ有効に利用していません。
これは、DRW2D エンジンが内蔵されていない環境でも動作させる事と、現在、ソフトで描画している部分を DRW2D で置き換える事が可能な構造になるようにする意味もあります。
※ DRW2D エンジンによる描画クラスは現在研究、開発中です。

シュミレータは、以前から開発を続けている「glfw3_app」フレームワークを利用しています。

このフレームワークは、OpenGL、GLFW3、OpenAL などオープンソースを組み合わせた、リアルタイム描画に適したものです。
glfw3_app は、マルチプラットホームで、OS-X でも同じように動作します。
自分で開発しているので、Unity や VS の C# 環境より扱い易く、思った事が短時間で実現出来ます。

シュミレータの構成

RX マイコンの GUI 描画では、表示ハードウェアーとして GLCDC を利用します。
ソフトレンダラーは、GLCDC のフレームバッファに対して描画を行う構造なので、これを真似たクラスを作ります。
シュミレータは、このクラスのフレームバッファを PC のフレームにコピーしています。
コピーは毎フレーム行っているので、リアルタイムな動作が出来ます。

    template <uint32_t LCDX, uint32_t LCDY>
    class glcdc_emu {
    public:
        static const uint32_t   width  = LCDX;
        static const uint32_t   height = LCDY;

    private:
        uint16_t fb_[LCDX * LCDY];

    public:
        void sync_vpos() { }

        void* get_fbp() { return fb_; }
    };
    typedef glcdc_emu<LCD_X, LCD_Y> GLCDC;

タッチパネルインターフェースとして I2C 接続された、FT5206 デバイスの代わりに、マウスの移動と、クリックをタッチパネル操作に模倣するようにします。

    class touch_emu {
    public:

        struct touch_t {
            vtx::spos   pos;
        };

    private:
        touch_t touch_[4];
        uint32_t    num_;

    public:
        touch_emu() : num_(0) { }

        uint32_t get_touch_num() const { return num_; }

        const auto& get_touch_pos(uint32_t idx) const {
            if(idx >= 4) idx = 0;
                return touch_[idx];
            }

        void update() { }

        void set_pos(const vtx::spos& pos)
        {
            touch_[0].pos = pos;
            num_ = 1;
        }

        void reset() { num_ = 0; }
    };
    typedef touch_emu TOUCH;

RX マイコンフレームワークで利用しているクラスを、シュミレータ側に持ってきて、利用します。
RX マイコンのフレームワークは、別のプラットホームでもコンパイル可能なように、依存関係をなるべく排除した実装なので、無改造で利用出来ます。

#ifndef EMU
#include "common/renesas.hpp"

#include "common/fixed_fifo.hpp"
#include "common/sci_i2c_io.hpp"
#include "chip/FT5206.hpp"
#endif

#include "graphics/font8x16.hpp"
#include "graphics/kfont.hpp"
#include "graphics/graphics.hpp"
#include "graphics/simple_dialog.hpp"
#include "graphics/widget_director.hpp"
#include "graphics/scaling.hpp"

詳しくは、プロジェクトのコードを参照して下さい。

このシュミレータのおかげて、細かい調整が効率よく出来ました、今後他のプロジェクトでも利用したいと思います。


多倍長ライブラリの選択

最初、boost の 多倍長浮動小数点ライブラリ Boost Multiprecision Library を利用していましたが、RX マイコンの環境では、コンパイルが出来ない事が判りました。
これは主に、マルチスレッド時における、オブジェクトのロックに起因する API が、RX マイコン側の環境で見つからない為のようでした。

本来、boost のソースコードは、RX マイコン用に対応させる必要がありますが、多くのクラスでは、それを行わなくても動作するので、mingw64 環境用の boost を利用していました。
boost を RX マイコンに対応させるのは、今後の課題です。

RX マイコンでは、スレッド関係のモデルは、FreeRTOS を利用する事になるので、対応する部分を修正する必要があると思います。
これが、どのくらいのハードルなのかも未定だったので別の選択枠を考えました。

boost はライセンスが緩いので、なるべく使いたいのですが仕方ありません。

そこで、見つけたのは、GNU gmp、mpfr ライブラリです。

これらは、古いプロジェクトで、C 言語ベースです、多分 RX マイコン用にビルド出来るものと思いました。

gmp、mpfr の RX マイコンへのポート(コンパイル)

最近、RX マイコンの開発環境として、Renesas GNU RX gcc-8.3.0 を利用しています。
これらのツールチェインは、mingw 環境で独自にコンパイルされたパッケージで提供されています。

パスを通せば、MSYS2 のシェルから動かせるのですが、「./configure」を動かす場合、パス中にスペースが含まれていたり、マルチバイト文字があると、configure が正しく動作しません。
そこで、MSYS2 上の「/usr/local」に、ツールチェインをコピーしました。

cp -r /c/Users/hira/AppData/Roaming/GCC\ for\ Renesas\ RX\ 8.3.0.202004-GNURX-ELF/rx-elf /usr/local/.

※現在、アップデートされたパッケージをインストールしている為、上記パスとなっています。


gmp のソースコードを取得して展開、コンパイル

.lz 形式のファイルを展開する為、lzip を扱えるようにインストールする必要があります。

% pacman -S lzip
% tar --lzip -xvf gmp-6.2.1.tar.lz
% cd gmp-6.2.1
% ./configure --host=rx-elf --prefix=/usr/local/rxlib --disable-shared
% make
% make install

RXマイコン用多倍長ライブラリ (gmp) のコンパイル


mpfr のソースコードを取得して展開、コンパイル

% ./configure --host=rx-elf --prefix=/usr/local/rxlib --with-gmp=/usr/local/rxlib
% make
% make install

RXマイコン用多倍長ライブラリ (mpfr) のコンパイル


mpfr のラッパー

mpfr を C++ から扱うラッパーは色々な選択肢があります。

しかし、組み込みマイコンで使うとなると色々制約があります。

組み込みマイコンでは、iostream は巨大になるので利用する事が出来ない。

殆ど全てのラッパーは、結果出力として、iostream を使ったものが主流です。(C++ なので当然そうなります・・)
RX マイコンでも、iostream を利用する事は出来るのですが、巨大で、RAM も沢山消費する為、できれば利用したくありません。

結局、自分のシステムにマッチする mpfr ラッパーを実装しました。

basic_arith テンプレートクラスが利用する範囲に限られるので、シンプルなものです。

common/mpfr.hpp にあります。

mpfr では、数値を扱うのは「mpfr_t」構造体です。

ラッパーでは、この構造体をクラスで包んで、クラスオブジェクトとして扱い、このオブジェクトに対する「操作」として、オペレータをオーバーロードするだけです。

名前空間を mpfr として、value クラスとしています。

#include <cmath>
#include <mpfr.h>

namespace mpfr {

    //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
    /*!
        @brief  mpfr オブジェクト
        @param[in]  num     有効桁数
    */
    //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
    template <uint32_t num>
    class value {

        mpfr_t      t_;
        mpfr_rnd_t  rnd_;

オペレータのオーバーロード関係:

        bool operator == (int v) const noexcept { return mpfr_cmp_si(t_, v) == 0; }
        bool operator != (int v) const noexcept { return mpfr_cmp_si(t_, v) != 0; }
        bool operator == (long v) const noexcept { return mpfr_cmp_si(t_, v) == 0; }
        bool operator != (long v) const noexcept { return mpfr_cmp_si(t_, v) != 0; }
        bool operator == (double v) const noexcept { return mpfr_cmp_d(t_, v) == 0; }
        bool operator != (double v) const noexcept { return mpfr_cmp_d(t_, v) != 0; }

        value& operator = (const value& th) noexcept {
            mpfr_set(t_, th.t_, rnd_);
            return *this;
        }
        value& operator = (long v) noexcept {
            mpfr_set_si(t_, v, rnd_);
            return *this;
        }
        value& operator = (double v) noexcept {
            mpfr_set_d(t_, v, rnd_);
            return *this;
        }

        const value operator - () noexcept
        {
            value tmp(*this);
            mpfr_neg(tmp.t_, tmp.t_, rnd_);
            return tmp;
        }

        value& operator += (const value& th) noexcept
        {
            mpfr_add(t_, t_, th.t_, rnd_);
            return *this;
        }

        value& operator -= (const value& th) noexcept
        {
            mpfr_sub(t_, t_, th.t_, rnd_);
            return *this;
        }

        value& operator *= (const value& th) noexcept
        {
            mpfr_mul(t_, t_, th.t_, rnd_);
            return *this;
        }

        value& operator /= (const value& th) noexcept
        {
            mpfr_div(t_, t_, th.t_, rnd_);
            return *this;
        }

        value operator + (const value& th) const noexcept { return value(*this) += th; }
        value operator - (const value& th) const noexcept { return value(*this) -= th; }
        value operator * (const value& th) const noexcept { return value(*this) *= th; }
        value operator / (const value& th) const noexcept { return value(*this) /= th; }

mpfr.hpp


basic_arith クラス

四則演算などの記号や括弧、シンボル名、関数名を含んだ文字列をパースして、実際の演算を行うクラスです。
このクラスは、数値オブジェクト、シンボル名、関数名、クラスをパラメータとするテンプレートです。

basic_arith.hpp

    static const uint32_t CALC_NUM = 250;  ///< 250 桁

    typedef mpfr::value<CALC_NUM> NVAL;

    typedef utils::calc_symbol<NVAL> SYMBOL;
    SYMBOL  symbol_;

    typedef utils::calc_func<NVAL> FUNC;
    FUNC    func_;

    typedef utils::basic_arith<NVAL, SYMBOL, FUNC> ARITH;
    ARITH   arith_;

まとめ

CALC_sample

今回、シュミレータの導入で、GUI を含んだアプリを効率良く開発する事が出来ました。
また、gmp、mpfr などのライブラリを扱う事で、これらの学習もある程度出来ました。

アプリは、タッチパネル付き LCD のガジェットにも適当なものと思います。

ライセンス

基本は、MIT ライセンスですが、gmp、mpfr ライブラリは注意が必要です。

libgmp: GNU LGPL v3 and GNU GPL v2
libfrmp: GNU LGPL v3

RXマイコン用多倍長ライブラリ (mpfr) のコンパイル

mpfr について

gmp をコンパイルして動かす事は出来たので、今度は mpfr をコンパイルする。

mpfr は gmp を使い、初等関数などをサポートしたライブラリで、ルート、ログ、三角関数など色々な関数を使えるようになる。

  • 電卓には必須のライブラリだ
  • gmp は基本的に四則演算のみを行う

mpfr をコンパイルする

まず、mpfr のソースコードを取って来る。

GNU MPFR Library

展開してコンパイル、ここでのキモは、gmp ライブラリが置いてある場所を指定する事。
※指定しないと、gmp がシェアードライブラリじゃないとリンク出来ないと思う。(前回、gmp はスタテックライブラリを作成した)

% ./configure --host=rx-elf --prefix=/usr/local/rxlib --with-gmp=/usr/local/rxlib
% make
% make install

mpfr を使ってみる

    void test_mpfr_()
    {
        mpfr_t a, c;

        mpfr_init2 (c, 50);
        mpfr_set_d (c, 2.0, MPFR_RNDD);
        mpfr_init2 (a, 50);

        mpfr_sqrt(a, c, MPFR_RNDD);

        mpfr_printf("sqrt(2): %.50RNf\n", a);

        mpfr_clear (c);
        mpfr_clear (a);
    }
Start SCI (UART) sample for 'RX64M' 120[MHz]
SCI Baud rate (set):  115200
SCI Baud rate (real): 115355 (0.13 [%])
CMT rate (set):  100 [Hz]
CMT rate (real): 100 [Hz] (0.00 [%])
    7612058254738945
*
    9263591128439081
--------------------
70514995317761165008628990709545
sqrt(2): 1.41421356237309403525159723358228802680969238281250

なるほど、簡単だー

mpfr C++ ラッパーを試す

mpfr を使う C++ ラッパーは色々ある、boost もその一つだが、RX マイコン用にカスタマイズしないと、コンパイルが通らない。

他のラッパーも試してはみたものの、基本、どれも iostream に依存していて、組み込みマイコンとは相性が悪い・・・
※非常に巨大になる・・・

つまり、これは、またしても車輪の再発名か・・・

まぁ、でも、機能を絞るのでそんなに大変じゃないのかなと思って、実験的に作ってみた。

とりあえず、四則演算が出来れば、俺俺 Arith クラス(数式解析クラス)に組み込める。

  • 数式解析は、数学的な数式を入力して、それを計算する。
  • 掛け算、割り算が優先されるとか、括弧が優先されるとか、意外と面倒だ。
  • シンボル(変数)の展開
  • 関数の展開
  • べき乗の展開
    basic_arith クラス

とりあえず、最低限必要な部分を作ってみた

オブジェクトに対してのオペレーターをそれなりに作れば、正しく動くと思う。

mpfr.hpp を実装、最低限必要そうな部分のみ実装してある。

実装では、mpfr 名前空間を作り、「value」クラスを定義した。

value クラス内に、mpfr_t 構造体を置いて、それに対する操作を列挙した。

重要なのは、四則演算などのオペレータをオーバーロードする事だ。

        bool operator == (int v) const noexcept
        {
            return mpfr_cmp_si(t_, v) == 0;
        }
        bool operator == (long v) const noexcept
        {
            return mpfr_cmp_si(t_, v) == 0;
        }
        bool operator == (double v) const noexcept
        {
            return mpfr_cmp_d(t_, v) == 0;
        }

        value& operator = (const value& th) noexcept {
            mpfr_set(t_, th.t_, rnd_);
            return *this;
        }
        value& operator = (long v) noexcept {
            mpfr_set_si(t_, v, rnd_);
            return *this;
        }
        value& operator = (double v) noexcept {
            mpfr_set_d(t_, v, rnd_);
            return *this;
        }

        const value operator - () noexcept
        {
            value tmp(*this);
            mpfr_neg(tmp.t_, tmp.t_, rnd_);
            return tmp;
        }

        value& operator += (const value& th) noexcept
        {
            mpfr_add(t_, t_, th.t_, rnd_);
            return *this;
        }

        value& operator -= (const value& th) noexcept
        {
            mpfr_sub(t_, t_, th.t_, rnd_);
            return *this;
        }

        value& operator *= (const value& th) noexcept
        {
            mpfr_mul(t_, t_, th.t_, rnd_);
            return *this;
        }

        value& operator /= (const value& th) noexcept
        {
            mpfr_div(t_, t_, th.t_, rnd_);
            return *this;
        }

        value operator + (const value& th) const noexcept { return value(*this) += th; }
        value operator - (const value& th) const noexcept { return value(*this) -= th; }
        value operator * (const value& th) const noexcept { return value(*this) *= th; }
        value operator / (const value& th) const noexcept { return value(*this) /= th; }

このくらいで、とりあえず、basic_arith で扱えるようになった。

早速、RX72N Envision Kit で動かしてみた、問題なく計算出来るようになったー

~~ 表示関係とかが、イマイチなので、整理したら、git のマスターブランチにプッシュする。~~
電卓アプリは、引き続き、機能追加などを行っていく予定。

関数電卓サンプル

RXマイコン用多倍長ライブラリ (gmp) のコンパイル

多倍長浮動小数点数

前回、電卓アプリを実験的に作ってみた。

ただ、「240MHz で動く32ビットマイコンなのに精度が64ビットの浮動小数点」なの?

これは、かなり痛い・・・

そこで、多倍長浮動小数点数などを扱えるライブラリを利用する事にした、最初、boost にある「Boost Multiprecision Library」を利用してみた。
何の問題もなく、簡単に数十桁の演算が出来る事を確認した。
しかし、RX マイコンの環境(Renesas GNU RX gcc compiler 8.3.0)では、これらのライブラリを含んだコードをコンパイル出来ない。
これは、mingw64 用の boost ソースコードを使っている為で、本来なら、boost のソースコードを RX マイコン用にカスタマイズしなければならない。

  • 多くのライブラリは、専用の物を作らなくても、対応可能な事から、この問題を避けてきた。
  • コンパイルで失敗する主な理由は、スレッド関係のようだ・・

しかし、boost を RX マイコン用にカスタマイズするのは、それはそれで大変そうだと思い、少し発想を変えてみようと思った。
また、boost のライブラリは、速度的には、古くからある、gmp、mpfr ライブラリより劣ると言われている。
※しかしながら、gmp や mpfr はライセンスが GNU なので、あえて boost を使う理由があると思える。

  • boost には、これら(gmp mpfr)のライブラリをラップしたクラスもあるが、これは完全に環境依存となっている。
  • Multiprecision のコード関係を RX マイコンに対応させるのはそれなりの労力だと思える。

とりあえず、gmp ライブラリをコンパイルしてみる。

操作は、MSYS2 上のコンソールで行う。

gmp.org

ソースコードを取ってくる。

見慣れない「lz」拡張子に対応する為、lzip をインストールしておく。

 % pacman -S lzip

続いて解凍する。

tar --lzip -xvf gmp-6.2.1.tar.lz

.configure するには、少し問題がある、gmp の configure は、Renesas GNU rx-elf 関係があるパスを正しく認識しない。
これは、パスにスペースが含まれる為で、configure を直すのも大変そうなので、とりあえず、rx-elf 関係を、mingw の「/usr/local」以下にコピーして対応した。

% cd /usr/local
% cp -r /c/Users/hira/AppData/Roaming/GCC\ for\ Renesas\ RX\ 8.3.0.202004-GNURX-ELF/rx-elf .

rx-elf 関係のパスを変更して、bash を再起動 (.bash_profile)

# rx-elf path
# PATH=$PATH:/usr/local/rx-elf/bin
# PATH=$PATH:/C/'Program Files (x86)'/'GCC for Renesas RX 8.3.0.202002-GNURX-ELF'/rx-elf/rx-elf/bin
# PATH=$PATH:/C/Users/hira/AppData/Roaming/'GCC for Renesas RX 8.3.0.202004-GNURX-ELF'/rx-elf/rx-elf/bin
PATH=$PATH:/usr/local/rx-elf/rx-elf/bin

configure を実行:

% rx-elf-gcc --version
rx-elf-gcc.exe (GCC_Build_20201001) 8.3.0.202004-GNURX 20190222
Copyright (C) 2018 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
% cd /d/Git/RX/gmp/gmp-6.2.1
% ./configure --host=rx-elf --prefix=/usr/local/rxlib --disable-shared

...

  Version:           GNU MP 6.2.1
  Host type:         rx-unknown-elf
  ABI:               standard
  Install prefix:    /usr/local/rxlib
  Compiler:          rx-elf-gcc
  Static libraries:  yes
  Shared libraries:  no

% make
% make install

本来、RX コア別の最適化オプションを指定した方が良いが、v1, v2, v3 で利用出来るように、「素」の状態でコンパイルした。

実際に使ってみる

とりあえず、RX64M で実験した。

/usr/local/rxlib 以下に gmp 関係のライブラリがあるので、その設定を追加する。

実験コードを(WEB からコピペ)

    void test_gmp_()
    {
        mpz_t x, y, result;

        mpz_init_set_str(x, "7612058254738945", 10);
        mpz_init_set_str(y, "9263591128439081", 10);
        mpz_init(result);

        mpz_mul(result, x, y);
        gmp_printf("    %Zd\n"
             "*\n"
             "    %Zd\n"
             "--------------------\n"
             "%Zd\n", x, y, result);

        /* free used memory */
        mpz_clear(x);
        mpz_clear(y);
        mpz_clear(result);
    }
Start SCI (UART) sample for 'RX64M' 120[MHz]
SCI Baud rate (set):  115200
SCI Baud rate (real): 115355 (0.13 [%])
CMT rate (set):  100 [Hz]
CMT rate (real): 100 [Hz] (0.00 [%])
    7612058254738945
*
    9263591128439081
--------------------
70514995317761165008628990709545
#

とりあえず問題無さそうだ。

RX マイコンに最適化するには、アセンブラのコードを gmp に追加する必要がありそうだが、今後の課題とする。

今回はここまで。

RX マイコン GUI フレームワークのエミュレーション

フラッシュROMの書き換えに時間がかかる・・

RX65N、RX72N Envision Kit で、GUI アプリケーションを作成する場合、オブジェクトがそこそこ大きくなる。
それを、マイコンにロードして動作を確認していると、一度のターンで、それなりに時間がかかり、開発効率が悪い。
GUI 系のアプリでは、現状、細かい調整や見た目重視になるので、さらにターン数は多くなり、完成度を上げるハードルが高くなる。
そこで、Windows のアプリ上で、動作を確認出来るように、エミュレーター的なアプリを作成した。

RX72N Envision Kit では、マイコン内蔵のフラッシュメモリ書き込みは、1本の端子で J-TAG をシリアライズして接続している。
※FINED 端子
その制約で、書き込み速度が RX65N Envision Kit に比べてさらに遅くなっている。(RX65N Envision Kit は J-TAG 接続)


エミュレーターと言っても、RXマイコンのバイナリーレベルで動かすのではなく、単純なAPIレベルでの動作に限定している。

俺俺フレームワークの「glfw_app」を利用し、RXマイコンから必要なソースコードを持っていき、
関係する部分をコンパイル出来るようにする。
そして、描画したフレームバッファを表示するだけとなっている。
また、マウスでクリックした状態を、タッチパネルでの操作に似せて、情報をフレームワークに送る。
※残念ながら、マルチタッチはエミュレーション出来ない。

RX マイコンの GUI フレームワークは、テンプレートで実装している部分が多く、描画部と、タッチ入力部は分離している。
なので、非常に簡単なパスを作るだけで実現できる。

実際のパス接続

GUIフレームワークで要求されるクラスは主に二つとなっている。

  • レンダリングクラス
  • タッチ入力クラス

上記二つのクラスをテンプレートパラメーターとして widget_director に参照で渡す構造となっている。

    //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
    /*!
        @brief  Widget ディレクター
        @param[in]  RDR     レンダークラス
        @param[in]  TOUCH   タッチクラス
        @param[in]  WNUM    widget の最大管理数
    */
    //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
    template <class RDR, class TOUCH, uint32_t WNUM>
    struct widget_director {

また、ソフトウェアーレンダリングクラスは、描画ハードウェアーのインスタンスを参照で渡している。
描画クラスには、フォントのインスタンスが含まれる。

    //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
    /*!
        @brief  レンダリング
        @param[in]  GLC     グラフィックス・コントローラー・クラス
        @param[in]  AFONT   ASCII フォント・クラス
        @param[in]  KFONT   漢字フォントクラス
    */
    //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++//
    template <class GLC, class FONT = font_null>
    class render {

描画ハードウェアーは、フレームバッファを管理している。
中身は、描画スクリーンのサイズと、先頭アドレスだけとなっている。

そこで、以下のようなクラスを用意した。

    static const int16_t LCD_X = 480;
    static const int16_t LCD_Y = 272;

    template <uint32_t LCDX, uint32_t LCDY>
    class glcdc_emu {
    public:
        static const uint32_t   width  = LCDX;
        static const uint32_t   height = LCDY;

    private:
        uint16_t fb_[LCDX * LCDY];

    public:

        void sync_vpos() { }

        void* get_fbp() { return fb_; }
    };
    typedef glcdc_emu<LCD_X, LCD_Y> GLCDC;

また、タッチクラスは、マウス入力をそのまま使うので、以下のようなクラスとした。

    class touch_emu {
    public:

        struct touch_t {
            vtx::spos   pos;
        };

    private:
        touch_t touch_[4];
        uint32_t    num_;

    public:
        touch_emu() : num_(0) { }

        uint32_t get_touch_num() const { return num_; }

        const auto& get_touch_pos(uint32_t idx) const {
            if(idx >= 4) idx = 0;
            return touch_[idx];
        }

        void update()
        {
        }

        void set_pos(const vtx::spos& pos)
        {
            touch_[0].pos = pos;
            num_ = 1;
        }

        void reset() { num_ = 0; }
    };

RX マイコンのサンプル「GUI_sample」を使って実験

※アプリケーションが出力する文字列を受け取り、ターミナルフレームに出力している。

これで、アプリの動作を細かく調整出来る。

GUI ビルダーも作る事が出来ると思うが、それはそれで、別の問題もある。
自分のフレームワークでは、widget の部品は、全てソースコードレベルで行っているので、ビルダーでソースコードを生成するのは簡単だが、その逆は、結構大変そうだ・・・
※一方通行で「ヨシ」とするなら簡単だが、ソースコードの管理が、それはそれで面倒・・
とりあえず、大がかかりになりそうなので、後で考える事にする・・・

何か作ってみる

とりあえず、簡単なところで、「電卓」を作ってみた、実用性もあるし、そこそこの難易度なので、それなりに有益かと思う。
もう少し、リッチなボタンが欲しいとこだが、それは、次の課題とする。
※現在の実装では、ボタンのコーナーのラウンドは、アンチエイリアスしていない。
また、プログラム電卓的な機能や、グラフ表示、など、拡張性がかなりあると思うので、今後機能を追加していこうと思う。

  • グラフ表示が出来る電卓は、購入するとなると、それなりの値段がするので、自分で作るには面白いガジェットかもしれない。
  • スマホで動く高機能な電卓が色々あるのだけど自分で作るのは、それだけで楽しい。

RX72N Envision Kit で動かした場合。


右の空きスペースは、関数電卓用のボタンを配置する予定。

とりあえず、PC で動作確認を行い、実際にターゲットでも同じように動作する事を確認できた。
今まで複雑な描画を含むアプリ作成は、効率が悪かったが、これからは、かなり効率良く開発出来ると思う。

CALC_sample