2016 年年 5 ⽉月   VER	  1.0	  さくらの IoT プラットフォーム	  利利⽤用マニュアル	  1.   さくらの IoT プラットフォームとは	  「さくらの IoT	  Platform」とは、通信環境とデータの保存や処理理システムを⼀一体型で提供する IoT のプラットフォームです。「さくらの IoT 通信モジュール」（※以下   通信モジュール）と、キャリアネットワークを接続した閉域網によって、安全にデータベース、ルールエンジンを含むバックエンド、外部のクラウドやアプリケーションサービスと連携させることができます。また外部から簡単に操作できる API も提供する予定です。	  	  	  	  	  1.	   さくらの IoT プラットフォームとは	  ....................................................................	  1	  2.	   対象読者	  ........................................................................................................................	  4	  3.	   注意	  .................................................................................................................................	  4	  4.	   設置環境についての注意	  ..........................................................................................	  4	  A.	  

屋外での利利⽤用	  ....................................................................................................................	  4	  B.	  

コネクタについて	  ............................................................................................................	  4	  C.	  

想定しない環境について	  ...............................................................................................	  5	  5.	   警告	  .................................................................................................................................	  5	  6.	   禁則事項	  ........................................................................................................................	  5	  7.	   利利⽤用する URL	  ...............................................................................................................	  6	  8.	   利利⽤用概要	  ........................................................................................................................	  6	  A.	  

取り出し/確認	  ..................................................................................................................	  7	  B.	  

起動	  ......................................................................................................................................	  7	  C.	  

登録（モジュール/サービス）	  ....................................................................................	  8	  i.	  

コントロールパネルへのログオン	  ........................................................................................	  8	  ii.	  

モジュールの登録について	  ......................................................................................................	  9	  iii.	  

プロジェクト/サービスの作成	  ..........................................................................................	  9	  iv.	  

モジュールの登録	  ..................................................................................................................	  12	  v.	  

確認	  ....................................................................................................................................................	  13	  D.	  

通信確認	  ..........................................................................................................................	  15	  E.	  

マイコンとの接続	  .........................................................................................................	  14	  9.	   参考	  ..............................................................................................................................	  16	  A.	  

マイコンからさくらの通信モジュールを使うためのライブラリ	  ...................	  16	  B.	  

データシート（モデム）	  ............................................................................................	  16	  C.	  

データシート（さくらのデバイス）	  ......................................................................	  16	  2	  i.	  

⼊入出⼒力力インターフェイス	  ........................................................................................................	  18	  	  	  3	  	  2.   対象読者	  本マニュアルは、さくらの IoT プラットフォームを利利⽤用し、IoT 機器のプロトタイプ開発、およびシステムを構築、運⽤用管理理を検討されておられる⽅方向けに作成されています。このマニュアルは利利⽤用するためには、組み込むボード、通信等の⽤用語、クラウド、API の利利⽤用に関する知識識が必要になります。各社ボードの仕様および、それらの利利⽤用⽅方法については各社にお問い合わせください。	  

3.   注意	  さくらの IoT プラットフォームはα版であり、予告なくサービスの修正/変更更/機能の追加/終了了を⾏行行う可能性があります。また 2016 年年度度後半に予定されているβ版開始の際に、お客様側でのデータ移⾏行行/モジュールの変更更等が必要になる可能性がありますので、ご了了承ください。	  
通信モジュールには、通信キャリアの SIM が組み込まれています。このため、同梱以外のアンテナの取り付け、⾶飛⾏行行物体等上空での利利⽤用については法律律上の制限がありますので、ご注意ください。また今回の機材については貸与品となっており、利利⽤用後返品いただく可能性もございますのでご了了承ください。	  

4.   設置環境についての注意	  A.   屋外での利利⽤用	     屋外での使⽤用	  屋外で使⽤用される場合や、防⽔水性を要求されるような環境で使⽤用される場合	  は、適切切な防⽔水構造の採⽤用および結露露対策を実施してください。	  
B.   	  コネクタについて	  コネクタにケーブルを挿抜する際には、過度度の応⼒力力を加えないよう注意してください。設置時には、通信モジュールに対して応⼒力力が連続して加わらないよう注意してください。	  

4	  C.   	  想定しない環境について	  1.   液体の中、または腐⾷食

6.   ヒーターやエアコン等性雰囲気のある場所	   	  の⾵風を直接受ける場所	   	  2.   ⾼高湿が連続する場所	  7.   強い振動がある場所	   	  3.   潮⾵風を受ける場所	   	  8.   強い電磁波がある場所	  4.   直射⽇日光を受ける場所	  9.   帯電または静電気が発5.   急激な温度度変化がある場所	   	  ⽣生する場所	  10.  その他、これらに準じる条件下	     ※上記のような環境では、誤作動や、動作不不良良が予想されますので、利利⽤用を想定していません。	  

5.   警告	  通信モジュールは、電⼦子精密機器になります。誤った利利⽤用⽅方法により感電、⽕火災等により、負傷/死亡などにつながる重⼤大な事故を引き起こす場合があります。
また、過度度な信頼性を伴うようには設計されておりませんので、原⼦子⼒力力関連機器、航空宇宙機器、海底機器、電⼒力力制御機器、医療療機器、輸送機器（⾃自動⾞車車、列列⾞車車、船舶等）、交通⽤用信号機器、燃焼制御機器、各種安全関連機器、⾦金金融関連機器、昇降降機器、その他これらの機器と同等の機器への利利⽤用について想定されておりませんが、お客様の判断による使⽤用を制限するものではございません。	  

6.   禁則事項	  分解、パーツ単位での利利⽤用、逆アセンブラ等リバースエンジニアリングに類する⾏行行為、接続⽅方法（ID/PASS）・接続経路路等の公開、その他さくらインターネットが適切切ではないと判断する⾏行行為。	  

5	  7.   利利⽤用する URL	  名称	  NO	  １	  URL	  さくらの IoT プラットフォーム	  ホーム	  https://iot.sakura.ad.jp/	  ２	  IoT	  PF コントロールパネル	  https://secure.sakura.ad.jp/iot-­‐‑alpha/	  ３	  Github	  	  	  8.   利利⽤用概要	     通信モジュールは、さくらの IoT プラットフォームαに接続／登録することによって、データ通信が可能になります。出荷時は未登録となっており、そのままでは利利⽤用することができません。未登録の状態でデータ通信をしても、データはすべて破棄されます。ここでは、通信モジュールの取り出しから、実際に利利⽤用ができるようになるまでについて説明をしています。今回送付させていただいたセットには、マイコン、センサーは同梱されていません。またマイコンとセンターの取り付け、設定⽅方法などについては、記載されていません。本書では、マイコンとして Arduino	  Uno を利利⽤用していますので、必要に応じて購⼊入してください。	  
・Arduino	  Uno	     https://www.switch-­‐‑science.com/catalog/list/?keyword=arduino	  🔳さくらの IoT プラットフォーム通信モジュールの利利⽤用順序	  	  	  	  	  	  6	  ⼿手順	  

STEP１	  STEP２	  STEP３	  STEP４	  STEP５	  作業等	  取出し/確認	  起動	  登録	  通信確認	  マイコン接続	  必要物品	  

プラスドライバ	  Arduino	  インターネットアクセス可能な PC	  さくらインターネット会員 ID／PASS	  Arduino	  A.   取り出し/確認	  通信モジュールは下記のような、状態でケースに⼊入って送付されています。
プラスネジで 4 箇所を留留められていますので、取り外してください。	  
※取り外しの際、⼿手などを傷つけないようご注意ください。	  	  	  	  	  	  	  
同梱品モジュール 2 つ                     さくらのクラウド２万円分チケット
棒形アンテナ×２                     板型アンテナ×１               シール
※Arduino シールドについては 6 ⽉月 10 ⽇日前後を⽬目処に別送されます。	  	  B.   起動	  通信モジュールは、接続されるマイコンから電源を取得しています。まずは、ご⽤用意いただいた Arduino をケーブルで通信モジュールをしっかりと接続し、Arduino の電源を投⼊入します。	  	  	  	  	  	  す。D3 の LED が点滅した場合は接続	  エラーですので電波状況の良良い場所に	  移動する等してください	  	  	  7	  続が完了了すると 1 回の明滅に変わりま	  	  	  接続中は D4 の LED が 2 回明滅し、接C.   登録（モジュール/サービス）	  i.  

コントロールパネルへのログオン	  	  以下の URL からコントロールパネルにアクセスします。	  
→   https://secure.sakura.ad.jp/iot-­‐‑alpha/	  	  注意：コントロールパネルへのログオンには、さくらインターネットの会員ID とパスワードが必要になります。お持ちでない⽅方やお忘れの⽅方は、取得をお願い致します。	  
→   https://secure.sakura.ad.jp/signup3/member-­‐‑register/input.html	  	  	  	  	  	  	  	  	  	  	  8	  ii.  

モジュールの登録について	  さくらの IoT プラットフォームは、『プロジェクト』、という管理理単位で通信モジュールを管理理しています。プロジェクトに通信モジュールを登録し、それぞれどのような連携をするのかを指定していくといった流流れになります。※	  2016 年年 5 ⽉月 31 ⽇日現在   特定のサーバーにデータを送信する OutgoinWebhook  特定のサーバーからデータを受信する IncomingWebhook   双⽅方向通信を実現す
る WebSocket   のサービスが選択可能となっており、今後も随時追加していく予定です。	  
※⼤大量量のモジュール（100 以上）を登録される場合はご相談ください。	  
iii.  

プロジェクト/サービスの作成	  新規プロジェクトボタンをクリックして、新しいプロジェクトを作成します。	  	  ここでは、TEST という名称のプロジェクトを作成します。	  	  	  9	  	     プロジェクトが追加されました。続いて、『＋サービス追加』をクリックして連携サービスを追加します。	  	     ここでは、データを通信モジュール側に送信する Incoming	  Webhook を選択します。	  	  	  	  	  10	  	  ※	  現在は作成後画⾯面遷移がされないため、『<キャンセル』を押して戻ってください。	  
続けて、Outgoing	  Webhook サービスも同様に作成します。	  	  	  11	  	  	  	  iv.  

モジュールの登録	  ⼿手元に、さくらの通信モジュールを⽤用意し、モジュール登録ボタンを押します。	  	  12	  	  モジュールに記載されている ID/PASS を⼊入⼒力力します。2 次元バーコードにも ID と PASS が記録されていますので、⾒見見えにくい場合などにご利利⽤用ください。また取り扱いにはご注意ください。	  
v.  

確認	  正常に登録されるかどうかを確認します。	  
下記のように画⾯面が表⽰示されると、さくらの IoT 通信モジュールが利利⽤用可能な状態となります。	  	  13	  D.   マイコンとの接続	  マイコンとの接続⽅方法には以下の 3 種類があります。	  
l   Arduino シールド（図中左側）を使う	  l   付属のケーブル（図中右側）を使う	  l   ケーブルを⾃自作する	  	  それぞれの接続⽅方法について以下で説明します。	  
i.  

Arduino	  シールドを利利⽤用する場合	  Arduino やその互換機などと接続したい場合に最適です。ボードに積み重ねるように接続するだけで配線が完了了します。	  
電源は Arduino 側、もしくは外部電源⽤用 DC ジャックから 5V を供給します。	  
Arduino 側からの電源供給が⼗十分でない場合、モジュールは起動するがリンクアップしないなどの症状が発⽣生しますので外部電源⽤用 DC ジャックからの電源供給を強く推奨します。	  

ii.  

付属のケーブル（図中右側）を使う	  ブレッドボードにモジュールを接続したい場合に最適です。	  
さくらの IoT 通信モジュールは動作に外部からの 5V 電源の供給が必要です。12 ピンには 5V	  400mA 程度度を供給できる電源を接続してください。	  
詳しいピンアサインについては 9 章	  ⼊入出⼒力力インターフェイスの項⽬目を参照してください。	  

iii.  

ケーブルを⾃自作する	  ⾃自作のデバイス専⽤用のケーブルを作りたい場合に最適です。	  

14	  モジュール側コネクタには 12 ピンの ZH コネクタを使⽤用しています。	  
詳しい型番、ピンアサイン等については 9 章	  ⼊入出⼒力力インターフェイスの項⽬目を参照してください。	  
E.   通信確認	  Arduino を⽤用いて動作確認する場合	  https://github.com/sakura-­‐‑internet/SakuraAlphaArduino	  を clone し、Arduino	  IDE で example/SakuraAlpha_I2C を開きます。これらのプログラムをコンパイルして Arduino に書き込むと、さくらの通信モジュールを利利⽤用するためのサンプルプログラムが起動します。サンプルプログラムでは I2C を⽤用いて⼀一定間隔毎に通信モジュールにカウンターの値を送信しています。	  
IoT プラットフォームのコントロールパネルにログインし、連携サービスとして WebSocket サービスを追加すると、連携サービス画⾯面から受信したデータをリアルタイムに確認することができます。	  	  15	  	  9.   参考	  A.   マイコンからさくらの通信モジュールを使うためのライブラリ	  SAKURA	  Internet	  IoT	  Alpha	  Communication	  Module	  Library	  for	  Arduino	  https://github.com/sakura-­‐‑internet/SakuraAlphaArduino	  	  B.   データシート（モデム）	  	  	  C.   データシート（さくらのデバイス）	  16	  ※	  J3 は未実装です。BLE モジュールは接続されていますが、α版では利利⽤用することができません。	  	  	  17	  	  i.  

⼊入出⼒力力インターフェイス	  1.   コネクタ 	     電源供給および制御信号の⼊入出⼒力力を⾏行行うためのインターフェイスと	  して、コネクタが基板上に実装されています。この製品で使⽤用しているコネクタ	  の製造者および型番は，以下のとおりです。	  	 	 	  	  2.   信号定義	  コネクタに配線されている信号は、下表のとおりです。	  
a.   J1	  	  	  18	  3.   定格	  a.   電源電圧	  最⼩小	  標準	  最⼤大	  4.75［V］	  5.0［V］	  5.25［V］	  最⼩小	  標準	  最⼤大	  -­‐‑-­‐‑	  	  ［m	  A］	  TBD［m	  A］	  TBD［m	  A］	  最⼩小	  標準	  最⼤大	  -­‐‑10［℃］	  -­‐‑-­‐‑［℃］	  50［℃］	  最⼩小	  標準	  最⼤大	  -­‐‑20［℃］	  -­‐‑-­‐‑［℃］	  80［℃］	  	  b.   消費電流流	  	  4.   使⽤用温度度範囲	  	  5.   保存温度度範囲	  	  6.   I/O	   電 圧（すべての⼊入出⼒力力について特記無き場合）	  最⼩小	  標準	  最⼤大	  -­‐‑0.3［V］	  -­‐‑-­‐‑［V］	  3.6［V］	  	  7.   I/O	   電 流流（すべての⼊入出⼒力力について特記無き場合）	  最⼩小	  標準	  最⼤大	  -­‐‑-­‐‑［mA］	  -­‐‑-­‐‑［mA］	  ±10［mA］	  	  	  	  19