Rustタスクを追加する

Rustで定義した関数は適切な属性を付加することでC言語から呼び出せるようになります。ここではこれを利用してRustの関数を静的RTOSタスクのエントリポイントとして登録する方法を説明します。

  1. 次の関数をRustプロジェクトのソースファイルに追加します。

    #[no_mangle]
    extern "C" fn root_task(_: isize) {
        println!("Hello, world!");
    }
    

    Note

    #[no_mangle] 属性 (Rustリファレンス) はシンボル名のマングリングを無効化し、関数名をそのままシンボル名として使うようにします。

    extern "C" (Rustリファレンス) を指定することでこの関数がC言語と互換なABIでコード生成されるようにします。

    引数の _ はパターンの一種であるワイルドカードパターン (Rustリファレンス) で、引数の値を捨てることを意味します。

    println! (Rustリファレンス) は標準出力にフォーマット済み文字列を出力する手続き型マクロです。


  1. この関数をエントリポイントとして、タスクの定義をカーネル設定ファイルに追加します。

    kernel_cfg.c
    extern void root_task(intptr_t exinf);
    
    const TINIB _kernel_tinib_table[] = {
        /* ... */
        { TA_ACT, 0, root_task, INT_PRIORITY(5), ROUND_STK_T(65536), NULL},
        /* ... */
    };
    
    const ID _kernel_torder_table[] = {
        /* ... */
        ROOT_TASK,
        /* ... */
    };
    
    kernel_cfg.h
    enum {
        /* ... */
        ROOT_TASK,
        /* ... */
    };
    

  1. 実行すると、タスクが出力したメッセージがログ出力先で見えるはずです。

../../_images/task-output.png