= 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も含んでいますが、現在のバージョンでは接続できていません。

== ダウンロード ==

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

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