360000183582
360000052341

IchigoSoda スタートガイド

対象サービス・プラン
 

ここでは、IchigoSodaとsakura.io通信モジュールを組み合わせて、データをプラットフォームに送信するためのチュートリアルを行います。

対象読者

本ドキュメントは、以下の方に向けて作成されています。

  • sakura.ioを利用し、最小限の機器で動作を確認したい方
  • IchigoJamでLTE通信の機能を利用したい方

ページの先頭へ

用意するもの

  • sakura.io通信モジュール(LTE)
  • IchigoSoda/IchigoJam for sakura.io
  • microUSBケーブル(ケーブル長1m以下)
  • USBコネクタで出力するタイプのACアダプタ(5V 1A以上)
  • コンポジット(RCA)ケーブル
  • NTSCビデオ信号入力対応のディスプレイ
  • PS/2対応のUSBキーボード(注意:キーボードはPS/2に対応している必要があります)

ページの先頭へ

コントロールパネルへのログイン

sakura.io コントロールパネルから、 プロジェクト の作成、 通信モジュール の登録、 連携サービス の設定を行います。

会員IDの取得

さくらインターネットのサービスで使用する「会員ID」が必要です。
さくらインターネットの会員IDをお持ちでない場合は、マニュアル>会員登録を参考に、会員IDを取得してください。

sakura.io コントロールパネル

会員登録が完了したら、sakura.io コントロールパネルを開き、コントロールパネルにログインします。
初めてコントロールパネルにログインした場合、各種約款への同意を求められます。

内容をご確認いただいたうえで、 同意するをクリックするとコントロールパネルにアクセスできます。

010.png

コントロールパネルにアクセスすると、プロジェクトの一覧が表示されます。
初回ログイン時には デフォルトプロジェクト という名前のプロジェクトが自動で作成されます。

020.png

このプロジェクトを使って進めることも可能ですが、この手順では新たにプロジェクトを作成し、
そちらを使用することにします。

ページの先頭へ

プロジェクト作成

プロジェクト一覧画面を開いたら、右上にある +プロジェクト追加 をクリックします。

030.png

新規プロジェクトの作成画面に遷移するので、 名称 欄に任意の名前を入力し、 追加 をクリックします。

040.png

プロジェクトが作成されると自動的にプロジェクト一覧画面に戻ります。名称欄に入力した名前でプロジェクトが作成されていることを確認できます。

050.png

ページの先頭へ

通信モジュール登録

次にモジュールの登録を行います。作成したプロジェクトの右上に表示されている 詳細 ボタンをクリックし、プロジェクトの詳細を表示します。

060.png

モジュール登録 のボタンをクリックします。

070.png

モジュールの追加画面に遷移します。 sakura.io モジュールのラベルに記載されている登録用IDと登録用パスワード情報を確認します。

登録フォームには、sakura.io モジュールに貼り付けられている下のラベルのうち ID:XXXXXXXXXX と PASS:XXXXXXXXXX の部分を入力します。

文字が小さくて読み取りづらい場合には、その下のQRコードを読み取ることで同様の情報を得ることができます。

080.png

指定したプロジェクトが選択されていることを確認のうえ、モジュール記載の登録用ID、登録用パスワード、および任意の名称を入力して、 追加 ボタンをクリックします。

090.png

登録に成功すると、このようなダイアログが表示されます。登録対象のモジュールが初めてsakura.ioコントロールパネルに追加された場合、初回登録ポイントがアカウントに付与されます。

100.png

ホームへ戻る ボタンをクリックすると、プロジェクト詳細ページでモジュールが追加されていることを確認できます。

110.png

ページの先頭へ

連携サービス作成

続けて、連携サービスを作成します。モジュールを登録したプロジェクトの 詳細 ボタンをクリックしてプロジェクト詳細画面を開きます。

120.png

プロジェクトの詳細ページ内の 連携サービス をクリックします。連携サービス一覧表示に切り替わるので、右端の 連携サービス追加 をクリックします。

130.png

連携サービスの選択画面に遷移します。ここではWebSocketを選択します。

WebSocket連携サービスを使うと、通信モジュールからのメッセージをブラウザ上でプレビューできるほか、外部のプログラムとの双方向通信の窓口として使用することができます。

140.png

名前の入力を求められるので、適当な連携サービス名を入力します。入力が済んだら 作成 ボタンをクリックします。

150.png

連携サービス一覧画面に戻ると、連携サービスが追加されたことが確認できます。

160.png

上記の図中赤枠で示した 設定 ボタン(歯車マーク)をクリックすると、 連携サービスの編集 画面に遷移します。 この画面では、sakura.io 通信モジュールから送信されてきたデータをブラウザ上で確認することができます。

170.png

このページは、この後の手順でデータが送信されてきたことを確認するために使用しますので、ブラウザで開いたままにしておくことをおすすめします。

ページの先頭へ

デバイスの組み立て

通信モジュールとIchigoSodaの組み立て

sakura.io 通信モジュールの取り付け

IchigoSodaにsakura.io 通信モジュールを取り付ける前に、sakura.io 通信モジュールにアンテナケーブルを取り付けます。

両面テープで固定した場合、後からアンテナケーブルを取り付けることができなくなります!!!!!

空中線用のアンテナケーブルと通信モジュール側のアンテナコネクタを合わせ、垂直にはめ込みます。

220.png
230.png

注意事項

  • 端子同士がズレている状態や斜めから強く押し込むとアンテナ端子が変形・破損する場合があります。

基板には2つアンテナの端子があるため、2つとも取り付けます。

240.png

アンテナケーブルのスクリュー溝部とアンテナを合わせて回すことで取り付けます。

250.png

sakura.io通信モジュールをIchigoSodaに取り付けます。コネクタ同士の位置が合っていることを確認し、垂直にはめ込みます。 この時、必要に応じて両面粘着テープを使用します。

260.png

注意事項

  • 両面粘着テープを使用すると強力に固定されるため、IchigoSodaから通信モジュールを取り外すことができなくなります。その他機器への取り付けを検討されている場合は両面粘着テープを使わないようにしてください。 なお、ホストインタフェースの挿抜保証回数は30回です。 コネクタ部は壊れやすいため、挿抜は注意して行ってください。

ページの先頭へ

IchigoSodaと周辺機器の接続

IchigoSodaと周辺機器の接続 IchigoSodaに、PS/2対応のUSBキーボード、ディスプレイ、microUSBケーブルと電源を接続します。

270.png

ページの先頭へ

手入力送信用プログラムの書き込み

sakura.io プラットフォームでデータが受信できたことを確認するために、まずsakura.ioコントロールパネルでWebSocket連携サービスを作り、ブラウザで表示しておきます。

電源を入れると、通信モジュールの点滅がはじまり、1分ほど待つと、1回点滅になります(3回は回線接続中、2回はサービス接続中)。

電源が入ったら、IchigoSodaに接続されているキーボードでプログラムを入力し、データを送信します。

以下のプログラムでは、数字の"12345"をプラットフォームに送信します。

1 'sakura.io TEST
10 N=12345
20 POKE#800,#21,10,1,#69,N,N>>8,(N>>15)*#FF,(N>>15)*#FF,0,0,0,0,N>>8^N^#43
30 ?I2CR(79,#800,13,#820,1)
40 IF PEEK(#820)=1 ?"SUCCESS ";PEEK(#820) ELSE ?"ERROR ";PEEK(#820)

入力が終わったら、 F5 キーを押してプログラムを実行します。 SUCCESS と表示されればプログラムが正しく実行できています。

280.png

それぞれの行の意味は以下の通りです。

  • 1行目:ファイル名になります。
  • 10行目:変数NにLTEモジュールで送信したい数値を代入します。ここでは12345を代入。
  • 20行目:#800番地にLTEモジュールに送信するデータ(13byte)を格納します。
  • 30行目:20行目で格納したデータを、I2Cバスインタフェース経由でLTEモジュールに送信します。送信後に1バイトリードして#820番地に格納します。
  • 40行目:30行目で#820番地に格納したリードデータから、送信に成功したかどうかを判定して表示します。

コマンド動作の詳細については以下の画像をご覧ください。画像をクリックすることで拡大して見ることができます。

290.png
300.png
320.png

連携サービス作成 の手順で開いた 連携サービスの編集 画面にデータが表示されれば成功です。 上記サンプルプログラムでは変数Nに12345を代入しているため、送信されてきたデータの値が12345となっています。

310.png

ページの先頭へ

最後に

以上でチュートリアルは完了です! これでIchigoSodaからsakura.io へデータを送信し、ブラウザ上で送信されたデータを確認することができました。

例えば、センサーからのデータをsakura.ioへ送信したい場合には、センサーをIchigoSodaに接続し、センサーからのデータをIchigoSodaで取得できれば、上記のコードと同様にして簡単にセンサーデータをsakura.io へ送信することができます。

お好きなセンサーモジュールを接続したり、別途販売しているブレイクアウトボードを使用して他のマイコンボードを組合せたり、実際の案件にお役立てください!

さくらのサポート情報

メニューを閉じる