1. 目次 PixiModule ターミナルアプリ (ios 版 ) ソース説明 2. ios 版ご利用の前にソースファイル内の用語の説明... 4 サンプル 4. ソースファイルの構成 Main.storyboard の説明 ViewControlle

Size: px

Start display at page:

Download "1. 目次 PixiModule ターミナルアプリ (ios 版 ) ソース説明 2. ios 版ご利用の前にソースファイル内の用語の説明... 4 サンプル 4. ソースファイルの構成 Main.storyboard の説明 ViewControlle"

たみえやすこ
7 years ago
Views:

1 PixiModule サンプルターミナルアプリ (ios 版 ) ソース説明書発行 2016 年 6 月 1 日 1.0 株式会社ヌマタ R&D 1/9

2 1. 目次 PixiModule ターミナルアプリ (ios 版 ) ソース説明 2. ios 版ご利用の前にソースファイル内の用語の説明... 4 サンプル 4. ソースファイルの構成 Main.storyboard の説明 ViewController.h の説明 ViewController.m の説明その他... 2/9

3 2. ios 版ご利用の前に開発環境について PixiModule ターミナルアプリ (ios 版 ) のソースファイルの編集は Apple 社が無償で配布している Mac OS X 向けの統合開発環境 Xcode をご利用くださいサンプル Xcode ( 最新 ver7.3.1) Xcode は Mac OS X 向けの App Store からインストールできます Mac の App Store を開いて Xcode で検索もしくは Xcode の公式ページ ( から App Store へのリンクをクリックしてください 3/9

4 3. ソースファイル内の用語の説明タブレット ( スマホ ) で作動する PixiModule ターミナルアプリは Bluetooth Low Energy という無線通信規格を用いて PixiModule UART と通信しデータの送受信を行います Bluetooth Low Energy (Bluetooth LE) Bluetooth4.0 で追加された省電力性を重視した通信規格です iphone ipad Android 一部 PC 端末で利用できます Bluetooth デバイス Bluetooth LE に対応した機器という意で記述していますソースではアプリの通信対象 (PixiModule UART) を指しますデバイス名 ( デバイスネーム ) Bluetooth デバイス自身が持っている名前です (PixiModule は NMTRD_ ) アプリは周囲のデバイスを検索し見つかったデバイス名を見て接続するか判定していますサンプルただしそのこれはデバイス固有というわけではなく同一の物も製造時に作ることができますサービス Bluetooth LE の通信規定 GATT(Generic Attribute) で定められている Bluetooth デバイスの機能の総称です例えば心拍計データを提供するサービス Heart Rate やバッテリー残量を知らせるサービス Battery Service は標準のサービスとして定義されています PixiModule はデータの送受信をするための独自のサービスを定義していますサービスは UUID と呼ばれる16 進数で表現する数字が割り当てられます ( 一種の名前 ) PixiMoule UART には送受信するサービスがありその送受信サービスの UUID として FF00 を割り当てています 4/9

5 キャラクタリスティックサービスに紐づけされている属性 ( 値や手段 ) で複数以上のこともありますキャラクタリスティックは値と値の操作方法のプロパティで構成されます * 高級言語などでは操作方法をメソッドともいいますが BluetoothLE ではプロパティといいます PixiModule UART はデータの送受信をするサービスの中にデータの読み込み用のキャラクタリスティック (Read) 書き込み用のキャラクタリスティック (Write) を持っていますまたサービスと同じくキャラクタリスティックにも各々固有の UUID( 番号で書かれた名前 ) が割り付けられており PixiModule UART の場合データの読込 Read は FF01 データの送信サンプル Write は FF02 です ( サービスとキャラクタリスティックの関係 ) データの送受信用サービス (UUID : FF00) キャラクタリスティック (Read)(UUID:FF01) 読み込みデータを取得することができるキャラクタリスティック (Write)(UUID:FF02) 送信するデータを書き込むと送信されるキャラクタリスティック (Notify)(UUID:FF01) Read 値が更新された時にタブレットに通知するかどうかの設定初期は Notify Off( 通知しない ) 5/9

6 以上の PixiModule にあるサービスキャラクタリスティックに BluetoothLE を通してアクセスすることでアプリは PixiModule UART とデータの送受をします CoreBluetooth Framework ios で Bluetooth 通信をするアプリを作成するために Apple 社が提供しているフレームワークです本ターミナルアプリもこのフレームワークを利用して PixiModule と通信します Central( セントラル ) Peripheral ( ペリフェラル ) CoreBluetooth Framework に出てくる Bluetooth 通信の役割の名称です Central は接続する側 (iphone/ipad) Peripheral は接続される側 (PixiModule) のことですサンプルアドバタイズデータ (advertisement data) 接続前の Peripheral が発信する Peripheral 自身の情報です CoreBluetooth Framework ではアドバタイズデータから接続前の Peripheral のデバイス名やサービスの UUID 等を取得することができます RSSI (Received Signal Strength Indication) Bluetooth デバイスから受信した電波の強度 ( 単位 :dbm) のことです値が大きい ( プラスに近い ) 程受信した電波が強い= 近くにあることが分かりますなお CoreBluetooth Framework の仕様で有効な RSSI を取得できない時は値が 127 で通知されます 6/9

7 4. ソースファイルの構成 PixiModule ターミナルアプリ (ios 版 ) のソースファイルは以下のように構成されています本書はアプリ画面のレイアウトを定義するファイル (Main.storyboard) と機能を定義するクラスファイル (ViewController.h ViewController.m) について説明します PixiModule_iOSApp ( ソース全体のフォルダ ) PixiModuleTerminal.xcodeproj (Xcode のプロジェクトファイル ) PixiModuleTerminal ( メインクラスのフォルダ ) 1Main.storyboard サンプル 2ViewController.h 3ViewController.m その他ファイル 1 Main.storyboard アプリ画面のレイアウトを定義するファイルです IBOutlet と呼ばれるボタンやラベル等の UI を配置します 2 ViewController.h メイン処理のクラス (3ViewController.m) のヘッダーファイルですフレームワークやソースの変数を宣言します 3 ViewController.m 本ターミナルアプリのメイン処理のクラスファイルです Bluetooth の通信を含むターミナル操作の全ての処理を定義しています 7/9

8 ViewController.m は本ターミナルアプリのメイン処理のクラスファイルです Bluetooth の通信を含むターミナル操作の全ての処理を定義していますカスタム化することでさらに種々の作動表現が可能ですここではアプリ起動からの処理フローと該当するソース部分について説明しますフロー 1 アプリ起動 ~PixiModule の検索開始アプリ起動 CBCentralManager の起動 CBCentralManager を起動して Bluetooth 通信を実行する準備をします 027 行 manager = [[CBCentralManager alloc] initwithdelegate:self queue:nil]; NO CentralManager の状態判定サンプル CBCentralManager の状態通知関数 centralmanagerdidupdatestate が呼ばれるので状態が有効か判定します ( 状態が無効の時は有効になるまで待機します ) 097 行 -(void)centralmanagerdidupdatestate: (CBCentralManager *)central { YES central.state が CBCentralManager StatePoweredOn になれば有効状態 100 行 switch (central.state) { case CBCentralManagerStatePoweredOn: 次ページへ Bluetooth デバイスの検索開始 ( 次ページ ) break 8/9

9 * 続きは DVD に収められている正式版をご覧ください 9/9

Bluetooth MIDI 接続ガイド

Bluetooth MIDI 接続ガイド目次 iphone/ipad との接続...2 動作環境... 2 Bluetooth MIDI 対応アプリケーションの場合... 2 Bluetooth MIDI に対応していないアプリケーションの場合... 4 Mac との接続...5 動作環境... 5 OS X El Capitan 以降の場合... 5 OS X Yosemite の場合... 6

1. 目次 PixiModule ターミナルアプリ (ios 版 ) ソース説明 2. ios 版ご利用の前に ソースファイル内の用語の説明... 4 サンプル 4. ソースファイルの構成 Main.storyboard の説明 ViewControlle

1. 目次 PixiModule ターミナルアプリ (ios 版 ) ソース説明 2. ios 版ご利用の前にソースファイル内の用語の説明... 4 サンプル 4. ソースファイルの構成 Main.storyboard の説明 ViewControlle