= Azure IoT Hub 接続サンプル =

Azure IoT Hub へ接続する[https://github.com/Azure/azure-iot-sdk-c Azure IoT Hub Device C SDK]を使ったサンプルです。
ターゲットデバイスは、[http://gadget.renesas.com/ja/product/sakura.html GR-SAKURA]で、EthernetでHTTP通信します。
MQTTも含んでいますが、現在のバージョンでは接続できていません。

サンプルを動作させるには、[=#following1 下記]の手順でAzure側にデバイスを追加し、そのデバイスの接続文字列を取得し、ソースコード「proto4_azure_iothub/src/client.c」の以下の個所を書き換える必要があります。

{{{#!c
static const char* connectionString = "[device connection string]";
}}}

== ダウンロード ==

GR-SAKURAのソースコードは[https://dev.toppers.jp/trac_user/contrib/browser/azure_iot_hub/trunk こちら]にあります。
リストの下にある「Download in other formats:」の「Zip Archive」をクリックすると、zipファイルでダウンロードできます。

== 開発環境 ==

ビルドはGCC+Makefileで行います。RX向けGCCは[https://gcc-renesas.com/ja/rx-download-toolchains/ こちら]から入手できます。arm向けGCCはe2studioのインストーラで入れた「GNU Tools ARM Embedded 5.4 2016q3」を使用しました。
IDEとして[https://www.renesas.com/ja-jp/products/software-tools/tools/ide/e2studio.html e² studio]V7.4.0を使用しました。
Rubyの実行環境が必要なので、​[https://www.ruby-lang.org/ja/downloads/ こちら]からダウンロードして、コマンドプロントから実行できるよう、環境変数でパスを通してください。
e² studio V7.4.0のプロジェクトファイルも含まれているので、展開したフォルダをワークスペースとして開き、プロジェクトのインポートをこのフォルダに対して行うことで、取り込むことができます。

== フォルダ構成 ==

||||||app_iothub_client||サンプルプログラム||TOPPERS License||
||||||asp3_dcre||RTOS [http://www.toppers.jp/asp3-kernel.html TOPPERS/ASP3]||TOPPERS License||
||asp3_dcre||||tinet||[http://www.toppers.jp/tinet.html TINET 1.7]をRuby版CFG対応し、IGMPを追加したもの||TOPPERS License||
||asp3_dcre||syssvc||tlsf||メモリアロケータ[https://github.com/mattconte/tlsf tlsf]||BSD License||
||||||azure_iothub||[https://github.com/Azure/azure-iot-sdk-c Azure IoT Hub Device C SDK]||MIT License||
||azure_iothub||deps||parson||[https://github.com/kgabis/parson parson] jsonパーサー ||MIT License||
||||||curl-7.57.0||HTTPクライアント[https://curl.haxx.se/ cURL]||Curl License||
||||||musl-1.1.18||標準Cライブラリ[http://www.musl-libc.org/ musl]||MIT License||
||ntshell||||fatfs||FATファイルシステム [http://elm-chan.org/fsw/ff/00index_e.html FatFs]||!FatFs License||
||ntshell||||ntshell||仮想ターミナル[https://www.cubeatsystems.com/ntshell/ NT-Shell]||MIT  License etc.||
||ntshell||||src||Socket API、標準入出力、ファイルディスクリプタ||TOPPERS License||
||||||wolfssl-3.15.7||SSL/TLS ライブラリ[https://www.wolfssl.com/ wolfSSL]||GPL/商用||
||||||zlib-1.2.11||圧縮・伸張ライブラリ[https://www.zlib.net/ zlib]||zlib License||

== 標準Cライブラリ ==

GCC付属の標準Cライブラリnewlibではなく、muslを使用しています。
付属のnewlibでは、dirent.hやsocket.hがないので、curlやwolfsslのコンパイルに向いていません。
Linux向けのmuslを使用することで、POSIX向けのソースコードのコンパイルが難無く行えます。
ただし、未実装のAPIがあってもリンクが通ってしまいます。
このソフトでは、ntshell/srcに実装がありますが、サンプルを動作させる最小限の実装を行っています。

= Azure IoT Hub について = #following1

本サンプルの作成には以下のドキュメントを参考にしました。

https://github.com/ms-iotkithol-jp/IoTKitHoLV4
[[br]]
https://docs.microsoft.com/ja-jp/azure/iot-hub/quickstart-send-telemetry-c

Azure側の確認には、上記サイトの「[https://docs.microsoft.com/ja-jp/azure/iot-hub/quickstart-send-telemetry-c#read-the-telemetry-from-your-hub ハブから利用統計情報を読み取る]」の手順で行いました。

Azureの利用は「IoT Hub Free エディション」を使用しました。

https://azure.microsoft.com/ja-jp/pricing/details/iot-hub/