SORACOM Orbit で IoT SIM のタグの書き込みと削除に対応しました - Soracom

SORACOM Orbit (以下、Orbit) は、デバイスから Unified Endpoint に送信されたデータを、SORACOM Beam / Funnel / Funk / Harvest Data / Flux に送信する前に、任意のデータフォーマットに変換するサービスです。データ変換のアルゴリズムは、AssemblyScript、Rust、C/C++、TinyGo を使って独自に開発できます。

これまで Orbit で実行するデータ変換のアルゴリズムでは、IoT SIM のタグの「読み出し」は可能でしたが「書き込み」と「削除」はできませんでした。

今回新しく配布する SDK では、タグの「書き込み」と「削除」にも対応しました。

また、C/C++ SDK では、確保されたメモリを開放する関数が変更されました。

以下は、AssemblyScript、Rust、C/C++、TinyGo それぞれの SDK における更新の一覧です。

AssemblyScript SDK

追加

setTagValue(name: string, value: string): void: データ送信元 (IoT SIM) のタグを作成、または更新します。
deleteTag(name: string): void: データ送信元 (IoT SIM) のタグを削除します。
getOriginalRequest(): string: デバイスから SORACOM に送信したデータを取得します。uplink() で getInputBufferAsString() を呼び出したときと同じデータを取得できます。

Rust SDK

追加

set_tag_value(name: &str, value: &str): データ送信元 (IoT SIM) のタグを作成、または更新します。
delete_tag(name: &str): データ送信元 (IoT SIM) のタグを削除します。
get_original_request() -> String: デバイスから SORACOM に送信したデータを取得します。uplink() で get_input_buffer() を呼び出したときと同じデータを取得できます。

C/C++ SDK

追加

void soracom_set_tag_value(const char* name, const char* value): データ送信元 (IoT SIM) のタグを作成、または更新します。
void soracom_delete_tag(const char* name): データ送信元 (IoT SIM) のタグを削除します。
int32_t soracom_get_original_request_as_string(const char** buf, size_t* siz): デバイスから SORACOM に送信したデータを取得します。uplink() で soracom_get_input_buffer_as_string() を呼び出したときと同じデータを取得できます。
void soracom_release_buffer(const char* buf): 確保されたメモリを解放します。

非推奨化

void soracom_release_input_buffer(const char* buf): 代わりに soracom_release_buffer() を使用してください。
void soracom_release_userdata(const char* buf): 代わりに soracom_release_buffer() を使用してください。

TinyGo SDK

追加

func SetTagValue(name string, value string): データ送信元 (IoT SIM) のタグを作成、または更新します。
func DeleteTag(name string): データ送信元 (IoT SIM) のタグを削除します。
func GetUserdata() ([]byte, error): メタデータサービスのユーザーデータを取得します。
func GetOriginalRequest() ([]byte, error): デバイスから SORACOM に送信したデータを取得します。uplink() で GetInputBuffer() を呼び出したときと同じデータを取得できます。