Changes between Initial Version and Version 1 of azure_iot_hub_peach

Timestamp:

Jun 17, 2019, 10:32:23 PM (5 years ago)

Author:

coas-nagasima

Comment:

--

azure_iot_hub_peach

@@ +1 @@
+= 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/peach.html GR-PEACH]で、Ethernet上のHTTPかMQTTで通信します。
+MQTTは、mbedTLS版でのみ確認できます。
+[http://gadget.renesas.com/ja/product/sakura.html GR-SAKURA]でも動作確認できています。[https://dev.toppers.jp/trac_user/contrib/wiki/azure_iot_hub こちら]を参照してください。
+
+サンプルを動作させるには、[#following1 下記]の手順でAzure側にデバイスを追加し、そのデバイスの接続文字列を取得し、ソースコード「app_iothub_client/src/client.c」の以下の個所を書き換える必要があります。
+
+{{{#!c
+static const char* connectionString = "[device connection string]";
+}}}
+
+=== ダウンロード ===
+
+GR-PEACHのソースコードはWolfSSL版が[https://dev.toppers.jp/trac_user/contrib/browser/azure_iot_hub_arm/trunk こちら]で、mbedTLS版が[https://dev.toppers.jp/trac_user/contrib/browser/azure_iot_hub_arm_mbedtls/trunk こちら]にあります。
+リストの下にある「Download in other formats:」の「Zip Archive」をクリックすると、zipファイルでダウンロードできます。
+
+=== 開発環境 ===
+
+ビルドはGCC+Makefileで行います。arm向けGCCは[https://gcc-renesas.com/ja/rz/rz-download-toolchains/ こちら]や[https://launchpad.net/gcc-arm-embedded こちら]から入手できます。
+IDEとして[https://www.renesas.com/ja-jp/products/software-tools/tools/ide/e2studio.html e² studio]V7.4.0を使用しました。
+デバッグするには[https://github.com/gnu-mcu-eclipse/openocd/releases OpenOCD]が必要です。
+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 (tag 2019-04-11)]||MIT License||
+||azure_iothub||deps||parson||[https://github.com/kgabis/parson parson] jsonパーサー ||MIT License||
+||azure_iothub||c-utility||adapters||TOPPERS向けの実装を追加||TOPPERS 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/商用||
+||||||mbedtls-2.16.1||SSL/TLS ライブラリ[https://tls.mbed.org/ mbedTLS]||Apache 2.0 License||
+||zlib-1.2.11||||||圧縮・伸張ライブラリ[https://www.zlib.net/ zlib]||zlib License||
+
+=== 標準Cライブラリ ===
+
+[[Image(composition.png)]]
+
+
+GCC付属の標準Cライブラリnewlibではなく、muslを使用しています。
+付属のnewlibでは、dirent.hやsocket.hがないので、curlやviのコンパイルに向いていません。
+Linux向けのmuslを使用することで、POSIX向けのソースコードのコンパイルが難無く行えます。
+ただし、未実装のAPIがあるとリンクエラーになります。
+このソフトでは、ntshell/srcにコードがありますが、サンプルを動作させる最小限の実装を行っています。
+
+== Azure IoT Hub について == #following1
+
+本サンプルの作成には以下のドキュメントを参考にしました。
+
+https://github.com/ms-iotkithol-jp/IoTKitHoLV4
+
+
+https://docs.microsoft.com/ja-jp/azure/iot-hub/quickstart-send-telemetry-c
+
+Azureの利用は「IoT Hub Free エディション」を使用しました。
+
+https://azure.microsoft.com/ja-jp/pricing/details/iot-hub/
+