うたカモ技術ブログ

UBUS学習の参考サイト紹介
UBUSの学習に役立つサイトを紹介します。以下のサイトを読むことでコマンドの使用方法だけでなく、その実装方法についても理解できます。 私の記事と併用して読むとより理解に繋がると思います。

1. What is UBUS?
2. OpenWRT UBUS mechanism

【ラズパイ限定】このサイトからパッケージを入手してインストールする。

このサイトでは、ラズベリーパイ限定でパッケージを配布しています。 シリーズ別のパッケージを以下に掲載しますので、インストールしてみてください。

次のコマンドを実行すると、パッケージをインストールすることができます。（以下はRaspberry Pi3用パッケージのインストール例です。）

root@OpenWrt:~# wget https://utakamo.com/repo/openwrt/raspi3/ubus/ubus-sample03_1.0-1_aarch64_cortex-a53.ipk
root@OpenWrt:~# opkg install ubus-sample03_1.0-1_aarch64_cortex-a53.ipk

ubus-sample03の初期化スクリプト

このサイトで紹介している他のサンプルプログラムと同じ内容です。

ubus-sample03はprocdによってシステムブート時に優先順位99番目（START=99）に起動され、シャットダウン時に 優先順位10番目(STOP=10)で終了するように設定しています。

#!/bin/sh /etc/rc.common

USE_PROCD=1
START=99
STOP=10

start_service() {
    echo 'ubus-sample03 start'
    procd_open_instance 'ubus-sample03'
    procd_set_param command /usr/bin/ubus-sample03
    procd_close_instance
}

ubus-sample03

今回はubus-sample03と命名したサンプルプログラムにsendコマンドと同等な処理を実装しました。

UBUSの各コマンド実装は、libubus.hに記述されていますので、これを利用して以下のように sendコマンドの処理をする関数（send_event）を定義しました。

#include <libubus.h>

void send_event(struct ubus_context *ctx);

int main()
{
	struct ubus_context *ctx = ubus_connect(NULL);

	send_event(ctx);
    ubus_free(ctx);

	return 0;
}

// Ubus send method
// This event can be received by running "ubus listen sample03-event".
void send_event(struct ubus_context *ctx) {
	struct blob_buf blob;
	blob_buf_init(&blob, 0);
	blobmsg_add_string(&blob, "message", "This is a sample event.");
	ubus_send_event(ctx, "sample03-event", blob.head);
}

send_event関数では、発行するイベントに任意のJSONデータを持たせたいので、libubox.hで定義されたJSONデータ作成用関数の blob_buf_init、blobmsg_add_string関数を使用して、"message":"This is a sample event." というJSONを作成しています。

上記のJSONを含める形で、ubus_send_event関数を使用してイベントのsample03-eventを発行します。 （もちろん、sample03-eventも厳密にはJSONのkeyなので、イベント単体でもJSONです。）

発行したイベントは窓口であるubusdに送られた後、ubusdを通してイベントの受信待ちをしているプロセスに通知されます。 （※ただし、イベントの受信待ちプロセスが特定イベントのみを受け取るようにubusdに要求していた場合、そのイベント以外のものはubusdでブロックされます。 要するに、ubus listen sample03-eventもしくはubus listenを実行しているかの違いです。）