Hardware

Introduction

Concept

　既存のコンピュータの機能上の制約を超え、日常生活環境に沿った人（身体）とコンピュータとの新しいインタラクションを探る、そうすることで身の回りの世界に新しい広がりが生まれるのではないか。 フィジカル・コンピューティングはこのような考えのもと、ニューヨーク大学 Dan O'Sullivan 教授により提案(※1)されました。

　フィジカル・コンピューティングの思想に沿ったインタフェースの開発を行う場合、ソフトウェアのみならずハードウェア、意匠デザインなどの幅広い要素を含めて考える必要があります。 つまり、それぞれの分野で一定のスキルが必要となるため、人とコンピュータとのインタラクションについて深く議論することは容易ではありませんでした。

　このような背景から、これまでフィジカル・コンピューティングのツールキットとして「GAINER」「FUNNEL」「Arduino」などが開発、提供されました。 これらはコンピュータの入出力機能を外部に拡張する小規模なコンピュータであり、エンジニア以外にもわかりやすいように説明や開発環境が工夫されています。 モジュール化された入出力機能とその扱いやすさから、フィジカル・コンピューティングを考えるためのツールとして、現在、多くのアーティスト、デザイナ、エンジニアの間で広く普及し、その相互連携に貢献しています。

　しかし現在、我々の日常生活環境における “コンピュータ” という存在は、これまでの「デスクトップ型」や「ノートブック型」の端末ではなく「スマートフォン型」や「タブレット型」の端末へと移行しているのではないでしょうか。

　このような考えから、弊社ではスマートフォンやタブレットで利用可能かつ、これらの開発環境で扱うことが可能なツールキットとして “konashi” の開発をおこないました。

(※1) Tom I. and Dan O., Physical Computing: Sensing and Controlling the Physical World with Computers, Thomson, (May, 2004).

Architecture

　konashiはiPhoneアプリから簡単にコントロールできるようになっています。

　独自にkonashiと同じような、無線接続で簡単にコントロールできるものを実現するためには、

• Bluetooh Low Energy(以下BLE) のしくみの理解
• BLEモジュールを搭載したMPUの調達とBLEの通信を含めたプログラミング
• 上記MPUとBLEで通信するiPhoneアプリの開発

を行う必要があります。また、iPhoneアプリでBLEを扱うためには、CoreBluetoothAPIのハンドリングやMPUとの複雑なデータのやり取りが必要となってきます。

そのため、konashiでは、

• konashi独自のBLEのServiceやCharacteristicsの開発
• BLEモジュール+MPUのプログラミング
• iPhoneでのCoreBluetoothAPIのハンドリングを konashi-ios-sdk でラッピング

を行なっているので、konashiとiPhoneアプリの通信のハンドリングを意識することやMPUのプログラミングをせずに、iPhoneアプリからkonashiを簡単にコントロールすることができるようになっています。

また、konashiを操作するためのAPIもシンプルなものがほとんどです。たとえば、konashiのデジタルポートPIO0の出力をHIGHにするには以下のコードだけで完結します。

[Konashi digitalWrite:PIO0 value:HIGH];

k.digitalWrite(k.PIO0, k.HIGH);

このコードにより、iPhoneアプリからkonashiに対して「PIO0の出力をHIGHに」という命令が送られ、konashiに内蔵されているMPUがそれを解釈しPIO0の出力をHIGHにするようになっています。 　

konashi.js

konashi-ios-sdk には、実機でのテストにiOSディベロッパー・ライセンスが必要であること、開発環境がMacに限定されること、そしてObjective-C言語そのものの習得が必要であること、以上の点で困難さが残っていました。

このような背景から konashi の制御の困難さを解消するため、Objective-Cではなく、webで一般的となったJavaSriptでの制御を可能にする konashi-js-sdk が開発されました。これにより、Webの技術からフィジカル・コンピューティングを始めることが可能となりました。

konashi.js は、konashi-js-sdk を用いてフィジカル・コンピューティングを行うiPhoneアプリです。 このアプリはAppStoreでいつでも無料でダウンロード可能です。

このアプリは、konashi用カスタムWebViewを内蔵しており、konashi-bridge.js を用いたHTML/JS/CSSのページを開けばすぐにkonashiを使用することができます。iPhoneアプリケーションの開発も必要ありません。

また、面白法人カヤックのjsdo.it とも連動しており、jsdo.it 内のコード検索、コード実行、ユーザ検索が簡単に行えます。HTMLやJavaScript, CSSをどのサーバに置くかを考える必要もなく、ブラウザだけですべてを開発することができます。

konashi.jsでkonashiをコントロールするためには、konashi-bridge.jsをHTMLに組み込む必要があります。konashi-bridge.jsは HTML/JSからkonashi用カスタムWebViewを通してネイティブのkonashi関数にアクセスするためのブリッジ役を果たします。

<script src="http://konashi.ux-xu.com/kjs/konashi-bridge.min.js"></script>

konashi-bridge.js は

• 圧縮済み版: http://konashi.ux-xu.com/kjs/konashi-bridge.min.js
• 圧縮されていない版: http://konashi.ux-xu.com/kjs/konashi-bridge.js
• バージョン付き版: http://konashi.ux-xu.com/kjs/konashi-bridge-1.0.0.min.js

があるので、お好きなものをお使いください。

konashi-bridge.js は konashi-js-sdk で開発されています。

Versions

2013年1月の konashi の発売以降、konashi 同様にふるまう konashi 互換ハードウェアが複数登場しています。ここではそれらを紹介し、特徴を示します。

表中の Revision は、konashi.js アプリを使用することで確認できるバージョン番号です。
konashi.js アプリは konashi.js - JavaScript/HTML/CSSとiPhoneでフィジカルコンピューティング [AppStore] からダウンロードしてください。

konashi.js アプリを使用した Revision 確認方法

1. konashi.js の Setting タブを開き、 OTAアップデート を選択してください。
   

2. konashi を iOSデバイスの近くにおき、 Connect を押すと、接続した konashi の Revision を表示します。
   以下は konashi の場合
   
   
   以下は koshian の場合
   
   
   以下は konashi 2 の場合
   

Specifications

Supported devices

Appearance

Schematic

Core functions

Digital

konashiには、8つのデジタルI/Oピンが搭載されています。 デジタルI/Oピンでは、HighとLowの2つの状態を入力/出力することができます。

konashiの場合、デジタルI/Oの基準電圧は3Vですので、3Vまたは0Vの電圧を入力/出力することができます。

なお、初期状態ではすべてのデジタルI/Oは 入力 として設定されています。

デジタルI/Oピンを入力に設定した場合、pinMode, pinModeAll 関数で内部プルアップを設定することも可能です。

pinModeAll, digitalReadAll での戻り値や、pinPullupAll, digitalWriteAll での引数は、PIO0〜PIO7を8bit(1byte)として表現しています。どのビットがどのピン番号に対応しているかを以下に示します。

PIO0が0bit目(LSB)に、PIO7が7bit目(MSB)です。

また、それぞれのビットの0/1がなにを表現するかはそれぞれの関数によって異なります。

例えば、PIO0(S1)を入力に、それ以外のPIOを出力に pinModeAll で設定する場合、入力=0、出力=1なので、以下のように11111110(254)と設定します。

[Konashi pinModeAll:0b11111110]

k.pinModeAll(254);

また、PIO0(S1)がHIGH、それ以外がLOWの状態だった時に digitalReadAll を実行すると、Objective-Cで1(00000001)は戻り値として返ってきます。また、JavaScriptでは、コールバック関数の第一引数dataにPIOの入力状態が格納されています。

int input = [Konashi digitalReadAll];
NSLog(@"input = %d", input);   // input = 1(00000001)

k.digitalReadAll(function(data){
    console.log("input = " + data);    // input = 1
});

Analog

konashi には、3つのアナログI/Oピンが搭載されています。 アナログI/Oピンは、mV単位で入力されている電圧の値を取得したり(ADC)、指定の電圧を出力することができます(DAC)。

konashiの場合、アナログI/Oの基準電圧は1.3Vですので、0Vから1.3Vまでの電圧をmV単位で入力/出力することができます。

なお、初期上ではすべてのアナログI/Oは ADC(入力) として設定されています。

注意点として、ADC と DAC を同時に使用することはできません。ADC として3ピンを使用するか、DAC を使用するかのどちらかとなります。

また、DAC は同時に1ピンしか使用できません。他のピンをDACすると他のピンは出力がリセットされます(ADCになる)。

PWM

PWM(Pulse Width Modulation：パルス幅変調）は、ピンのON/OFFを繰り返すことでパスルを出力し、ONの時間(デューティ比)をコントロールする制御方式です。モータの回転速度やLEDの光の強さを制御するときによく使われる方式です。

konashi には、デジタルI/O(PIO)のすべてのピンをPWMモードに設定することが可能です。

konashi の PWM を使うににあたって、pwmMode, pwmPeriod, pwmDuty 関数でデューティ比や周期を決めるモード の他に、LEDの明るさを0〜100%で指定して簡単にドライブできるモード（ pwmLedDrive 関数を使用）があります。どの PWM モードにするかは、 pwmMode 関数で指定できます。

konashi の PWM はソフトウェアPWMで実装されているため、短い間隔でデューティ比を変更するなど、konashi側でBLE系の処理が連続して走る状態になると、一瞬だけ、指定したデューティー比を正確に出力できなくなる場合があります。つきましては、konashiに対するBLEのアクセスを連続して行わないようにするか、デューティ比がずれることがあっても影響を受けないものを制御の対象としてください。

また、設定できる PWM の周期の最低値は 1000 [us] です。

Communication

konashiには、他のデバイスとシリアル通信するための機能として、I²CとUARTの2種類に対応しています。

I²C

I²Cで利用する信号線は、シリアルデータ（SDA）とシリアルクロック（SCL）の2本のみです。

この通信規格は電子機器制御用のシンプルなバスシステムとして開発されたもので、規格の詳細はNXPセミコンダクター社のサイトから知ることができます。（詳細は以下の参考文献をご参照ください）

参考文献： I²Cバス仕様書 バージョン2.1 (NXPセミコンダクター社) （PDFファイル / 780KB）

konashi は、I²Cのマスタとして動作し、接続された周辺機器（スレーブ）と通信をおこないます。

2つの信号線SDA，SCLは、konashi ではそれぞれ PIO6 (SDA)、PIO7 (SCL) が対応し ています。 上記の図のように接続し、デバイスの通信プロトコルに応じてプログラムを作成することで、I²C対応のLCDやセンサなどのデバイスと通信することができます。

注意点として、SDA と SCL には必ずプルアップ抵抗を挿入してください。

konashiライブラリ のI²C用関数 を利用することで、効率よくI²C 通信のプログラミングが可能です。

UART

UARTは調歩同期方式によるシリアル通信を行う機能の総称であり、konashi ではこれをもちいて RS-232(ANSI/TIA/EIA-232-F-1997) に準拠したシリアル通信をおこなうことができます。

konashi は、送信データ線（TX）と受信データ線(RX)の2本の信号線を利用して、UARTでのシリアル通信を行います。 上記の図のように接続し、プログラムを作成することでPCなどの周辺機器と簡単に通信することができます。

信号の電圧は 3V です。

設定できる通信速度は Constants / UART をご覧ください。

データを送信する場合は uartWrite を実行してください。

データを受信する場合は、KONASHI_EVENT_UART_RX_COMPLETE イベントを addObserver でキャッチしてください。

- (void)viewDidLoad
{
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.
    
    [Konashi initialize];
    
    [Konashi addObserver:self selector:@selector(recvUartRx) name:KONASHI_EVENT_UART_RX_COMPLETE];
}

- (void) recvUartRx
{
    NSLog(@"UartRx %d", [Konashi uartRead]);
}

- (IBAction)find:(id)sender {
    [Konashi find];
}

k.completeUartRx(function(data){
    console.log("UART recv: " + data);
});

k.find();

Bluetooth Low Energy

Bluetooth Low Energy(以下、BLE)はBluetooth SIG によって策定された低消費電力版Bluetoothであり、iPhone や iPad，最新のMacBookにも搭載されるようになりました。

konashi は、このBLEを利用してiPhoneやiPadと接続されます。

konashi は 初めてのユーザにも簡単に使用していただけるように設計しているため、CPUがスリープに入っている時間が少ないなど、省電力設計になっておりません。普通のBLEデバイスよりも消費電力が大きくなっておりますのでご注意ください。

以下に、konashi のServiceやCharacteristicsのUUIDを示します。

Services

Characteristics

PIO

PWM

Analog

I²C

UART

Hardware control

Event-driven

konashiはiPhoneとは無線で接続されているため、konashiの状態を取得するにも数msほど通信時間を要します。取得できるまで待機する場合スレッドにロックが掛かってしまうため、基本的に非同期でデータを取得することになります。そのため、取得完了時にはイベントという形で、iPhoneアプリに対して通知されます。

konashiを使うにあたっての、基本的なイベントサイクルは以下のようになります。灰色の部分がアプリを起動してから、konashiの接続を切断するまでに発行されるイベントです。

また上記とは別に、Read系のAPI実行したあとに取得完了イベントも発行されます。これらのイベントを取得するためには、addObserver という関数を使用し、イベントがあったときに実行される関数(イベントオブザーバ)を登録します。イベントの種類は Constants - Events をご覧ください。

API Reference

iOS SDKに関するより詳しいドキュメントはこちらを参照ください。

Constants

Pin name

PIO

AIO

PWM

UART

I²C

Function return

Events

Base

initialize

Description

konashiの初期化を行います。

一番最初に表示されるViewControllerのviewDidLoadなど、konashiを使う前に必ず initialize をしてください。

Syntax

[Konashi initialize];

Parameters

なし

Returns

成功時: KonashiResultSuccess (0), 失敗時: KonashiResultFailure (-1)

find

Description

iPhone周辺のkonashiを探します。

この関数を実行した後、周りにあるkonashiのリストが出現します。リストに列挙されているkonashiのひとつをクリックすると、konashiに自動的に接続されます。その後、KonashiEventConnectedNotification と KonashiEventReadyToUseNotification のイベントが発火するので、事前にこれらのイベントを addObserver でキャッチできるようにしておいてください。

本来、KonashiEventCentralManagerPowerOnNotification のイベント以前に find を実行しても無効ですが、この場合に限り、KonashiEventCentralManagerPowerOnNotification のイベント後に自動的に find が遅延実行されるように調整されています。

Syntax

[Konashi find];

k.find();

Parameters

なし

Returns

成功時: KonashiResultSuccess (0), 失敗時: KonashiResultFailure (-1)

findWithName

Description

konashiの名前を指定して接続します。

find の場合はkonashiのリストが出現しますが、findWithName を実行した場合はリストが出ずに自動的に接続されます。

名前に関しては、find を実行することによって下から出現するリストでリストアップされる konashi#4-0452 などの文字列です。konashi#*-**** の*部分の数字は、konashiの緑色チップのシール上に記載されている番号と同じです。

もし、指定した名前が見つからない場合は KonashiEventPeripheralNotFoundNotification が発火されます。

本来、KonashiEventCentralManagerPowerOnNotification のイベント以前に findWithName を実行しても無効ですが、この場合に限り、KonashiEventCentralManagerPowerOnNotification のイベント後に自動的に findWithName が遅延実行されるように調整されています。

Syntax

[Konashi findWithName:(NSString *)name];

k.findWithName(name);

Parameters

Returns

成功時: KonashiResultSuccess (0), 失敗時: KonashiResultFailure (-1)

Example

konashi#4-0452 のkonashiを探して接続する

[Konashi findWithName:@"konashi#4-0452"];

k.findWithName("konashi#4-0452");

disconnect

Description

konashiとの接続を解除します。

Syntax

[Konashi disconnect];

k.disconnect();

Parameters

なし

Returns

成功時: KonashiResultSuccess (0), 失敗時: KonashiResultFailure (-1)

isConnected

Description

konashiと接続中かを返します。

KonashiEventConnectedNotification のイベントが発火するタイミングでTRUEとなります。それ以前はFALSEです。

Syntax

[Konashi isConnected];

k.isConnected(handler);

Parameters

Returns

BOOL

peripheralName

Description

接続中のkonashiの名前を返します。

konashiに接続していない状態で peripheralName を実行すると空文字 @"" が返ります。

Syntax

[Konashi peripheralName];

k.peripheralName(handler);

Parameters

Returns

NSString* (例: konashi#4-0452)

Example

NSString* name = [Konashi peripheralName];
NSLog(name);

k.peripheralName(function(name){
    console.log("Name: "+ name);
});

Events

addObserver(on)

Description

konashiに関するイベントをキャッチすることができます。

konashiとiPhoneは BLE で繋がっているため、konashiの状態やピンの状態は非同期で取得することになります。

たとえば、AIOピンの電圧を取得するには、 analogReadRequest でkonashiにリクエストを送り、KonashiEventAnalogIODidUpdateNotification という取得完了イベントを受信した後にAIOピンの電圧を参照できるようになります。

どのようなイベントがあるかは Constants / Events を参照してください。

Syntax

[Konashi addObserver:(id)notificationObserver selector:(SEL)notificationSelector name:(NSString*)notificationName];

k.addObserver(name, handler);
k.on(name, handler);

Parameters

Returns

成功時: KonashiResultSuccess (0), 失敗時: KonashiResultFailure (-1)

Example

konashiと接続したらCONNECTEDとコンソールに表示する

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    [Konashi initialize];
    [Konashi addObserver:self selector:@selector(konashiConnected) name:KonashiEventConnectedNotification];
}

- (void) konashiConnected
{
    NSLog(@"CONNECTED");
}

k.on(k.KONASHI_EVENT_CONNECTED, function(){
    console.log("CONNECTED");
});
k.find();

removeObserver

Description

addObserver で行ったkonashiイベントオブザーバを削除します。

Syntax

[Konashi removeObserver:(id)notificationObserver];

k.removeObserver(name, handler);
k.off(name, handler);

Parameters

Returns

成功時: KonashiResultSuccess (0), 失敗時: KonashiResultFailure (-1)

Example

konashiと接続したらCONNECTEDとコンソールに表示し、イベントハンドラを削除します。

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    [Konashi initialize];
    [Konashi addObserver:self selector:@selector(konashiConnected) name:KonashiEventConnectedNotification];
}

- (void) konashiConnected
{
    NSLog(@"CONNECTED");
   [Konashi removeObserver:self];
}

k.on(k.KONASHI_EVENT_CONNECTED, function(){
    console.log("CONNECTED");
    k.off(k.KONASHI_EVENT_CONNECTED);
});
k.find();

Digital I/O (PIO)

pinMode

Description

PIOのピンを入力として使うか、出力として使うかの設定を行います。詳細は Core functions / Digital をご覧ください。

Syntax

[Konashi pinMode:(int)pin mode:(int)mode];

k.pinMode(pin, mode);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

LED2をOUTPUTにする

[Konashi pinMode:LED2 mode:OUTPUT];

k.pinMode(k.LED2, k.OUTPUT);

pinModeAll

Description

PIOのピンを入力として使うか、出力として使うかの設定を行います。

この関数での引数は、PIO0〜PIO7の入出力設定を8bit(1byte)で表現します。bitとピンの対応は以下です。

それぞれのビットでは、入力設定を0、出力設定を1として表現します。

例えばこの関数で、PIO0(S1)を入力に、それ以外のPIOを出力に設定する場合、入力=0、出力=1なので、以下のように11111110(254)と設定します。

[Konashi pinModeAll:0b11111110];

k.pinModeAll(254);

詳細は Core functions / Digital をご覧ください。

Syntax

[Konashi pinModeAll:(int)mode];

k.pinModeAll(mode);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

PIOすべてのピンをOUTPUTにする

[Konashi pinModeAll:0xFF];

k.pinModeAll(0xFF);

pinPullup

Description

PIOのピンをプルアップするかの設定を行います。

初期状態では、PIOはプルアップされていません。詳細は Core Functions / Digital の項をご覧ください。

Syntax

[Konashi pinPullup:(int)pin mode:(int)mode];

k.pinPullup(pin, mode);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

PIO7をプルアップする

[Konashi pinPullup:PIO7 mode:PULLUP];

k.pinPullup(k.PIO7, k.PULLUP);

pinPullupAll

Description

PIOのピンをプルアップするかの設定を行います。

この関数での引数は、PIO0〜PIO7のプルアップ設定を8bit(1byte)で表現します。bitとピンの対応は以下です。

それぞれのビットでは、プルアップ無効を0、プルアップ有効を1として表現します。

例えばこの関数で、PIO0(S1)をプルアップし、それ以外はプルアップ無効にする場合、以下のように00000001(1)と設定します。

[Konashi pinPullupAll:0b00000001];

k.pinPullupAll(1);

詳細は Core Functions / Digital の項をご覧ください。

Syntax

[Konashi pinPullupAll:(int)mode];

k.pinPullupAll(mode);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

PIOのすべてのピンをプルアップする

[Konashi pinPullupAll:0xFF];  // 0b11111111, 255

k.pinPullupAll(0xFF);

digitalRead

Description

PIOの特定のピンの入力状態を取得します。

ピンの入力状態を取得する前に、必ず pinMode, pinModeAll でピンのモードを入力にしておいてください。出力モードの場合は正しい入力状態を取得することはできません。

詳細は Core functions / Digital をご覧ください。

Syntax

[Konashi digitalRead:(int)pin];

k.digitalRead(pin, handler);

Parameters

Returns

Example

S1の入力の状態を取得する

[Konashi digitalRead:S1];

k.digitalRead(k.S1, function(data){
    console.log("S1 INPUT = " + data);
});

digitalReadAll

Description

PIOのすべてのピンの状態を取得します。

この関数での戻り値は、PIO0〜PIO7の入力状態が8bit(1byte)で表現されます。bitとピンの対応は以下です。

それぞれのビットで、0はLOW(0V)を、1はHIGH(3V)を表現しています。

例えば、PIO0(S1)がHIGH、それ以外がLOWの状態だった時にこの関数を実行すると、00000001(1)が戻り値として返ってきます。

int input = [Konashi digitalReadAll];
NSLog(@"input = %d", input);   // input = 1

k.digitalReadAll(function(data){
    console.log("input = " + data);   // input = 1
});

詳細は Core functions / Digital をご覧ください。

Syntax

[Konashi digitalReadAll];

k.digitalReadAll(handler);

Parameters

Returns

PIOの8ピンの入力情報(0x00〜0xFF)

Example

PIOのすべてのピンの入力状態を取得する。

[Konashi digitalReadAll];

k.digitalReadAll(function(data){
    console.log("PIO input = " + data.input);
});

digitalWrite

Description

PIOの特定のピンの出力状態を設定します。

詳細は Core functions / Digital をご覧ください。

Syntax

[Konashi digitalWrite:(int)pin value:(int)value];

k.digitalWrite(pin, value);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

LED2をHIGHにする

[Konashi digitalWrite:LED2 value:HIGH];

k.digitalWrite(k.LED2, k.HIGH);

digitalWriteAll

Description

PIOの特定のピンの出力状態を設定します。

この関数での引数は、PIO0〜PIO7の出力状態が8bit(1byte)で表現されます。bitとピンの対応は以下です。

それぞれのビットで、0はLOW(0V)を、1はHIGH(3V)を表現しています。

例えば、この関数でPIO3(LED4)をHIGH、それ以外をLOWの状態にする場合、00001000(8)を引数に設定します。

[Konashi digitalWriteAll:0b00001000];

k.digitalWriteAll(8);

詳細は Core functions / Digital をご覧ください。

Syntax

[Konashi digitalWriteAll:(int)value];

k.digitalWriteAll(value);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

PIOのすべてのピンをHIGHにする

[Konashi digitalWriteAll:0xFF];

k.digitalWriteAll(0xFF);

Analog I/O (AIO)

analogReference

Description

アナログ入出力の基準電圧を返します。

Syntax

[Konashi analogReference];

k.analogReference();

Parameters

なし

Returns

1300 が返ります(mV)。

analogReadRequest

Description

AIO の指定のピンの入力電圧を取得するリクエストを konashi に送ります。

この関数は konashi にリクエストを送るものなので、実際に値を取得するには、KonashiEventAnalogIODidUpdateNotification もしくは Constants / Events に定義されている入力電圧取得完了イベントを addObserver でキャッチした後、analogRead で値を取得できます。

アナログの機能に関しては、 Core functions / Analog をご覧ください。

Syntax

[Konashi analogReadRequest:(int)pin];

k.analogReadRequest(pin);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

AIO0の入力電圧を取得する

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    [Konashi initialize];
    
    [Konashi addObserver:self selector:@selector(konashiReady) name:KONASHI_EVENT_READY];
    [Konashi addObserver:self selector:@selector(readAio0) name:KONASHI_EVENT_UPDATE_ANALOG_VALUE_AIO0];
}

// konashiを探すボタンタップのアクション
- (IBAction)findKonashi:(id)sender {
    [Konashi find];
}

// AIO0電圧取得ボタンタップのアクション
- (IBAction)requestReadAio0:(id)sender {
    [Konashi analogReadRequest:AIO0];
}

- (void) readAio0
{
    NSLog(@"READ_AIO0: %d", [Konashi analogRead:AIO0]);
}

k.ready(function(){
    k.analogReadRequest(k.AIO0);
});

k.updateAnalogValueAio0(function(data){
    console.log("READ_AIO0: " + data.value);
});

k.find();

analogRead

Description

AIO の指定のピンの入力電圧を取得します。この関数で取得できる値は前回の analogReadRequest 時に取得した電圧です。

konashiのAIOピンの電圧を取得したい場合は、まず analogReadRequest で konashi に取得リクエストを送り、 KonashiEventAnalogIODidUpdateNotification もしくは Constants / Events に定義されている入力電圧取得完了イベントを addObserver でキャッチした後、 この関数で値を取得できます。

アナログの機能に関しては、 Core functions / Analog をご覧ください。

Syntax

[Konashi analogRead:(int)pin];

k.analogRead(pin, handler);

Parameters

Returns

0 〜 1300 までの、mV単位の値が返ります。

Example

AIO0の入力電圧を取得する

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    [Konashi initialize];
    
    [Konashi addObserver:self selector:@selector(konashiReady) name:KONASHI_EVENT_READY];
    [Konashi addObserver:self selector:@selector(readAio0) name:KONASHI_EVENT_UPDATE_ANALOG_VALUE_AIO0];
}

// konashiを探すボタンタップのアクション
- (IBAction)findKonashi:(id)sender {
    [Konashi find];
}

// AIO0電圧取得ボタンタップのアクション
- (IBAction)requestReadAio0:(id)sender {
    [Konashi analogReadRequest:AIO0];
}

- (void) readAio0
{
    NSLog(@"READ_AIO0: %d", [Konashi analogRead:AIO0]);
}

k.ready(function(){
    k.analogReadRequest(k.AIO0);
});

k.updateAnalogValueAio0(function(data){
    k.analogRead(k.AIO0, function(data){
        console.log("READ_AIO0: " + data));
    });
    
    // k.updateAnalogValueAio0 のコールバックの第一引数dataにもAIO0のアナログ値が入っています
    //console.log("READ_AIO0: " + data);
});

k.find();

analogWrite

Description

AIO の指定のピンに任意の電圧を出力します。

指定できる最大の電圧は 1300 [mV] です。

アナログの機能に関しては、 Core functions / Analog をご覧ください。

Syntax

[Konashi analogWrite:(int)pin milliVolt:(int)milliVolt];

k.analogWrite(pin, milliVolt);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

AIO0に1.0Vを出力させる

[Konashi analogWrite:AIO0 milliVolt:1000];

k.analogWrite(k.AIO0, 1000);

PWM

pwmMode

Description

PIO の指定のピンを PWM として使用する/しないかを設定します。

PIO のいずれのピンも PWMモード に設定できます。

KonashiPWMModeEnable モードを指定する場合は、事前に pwmPeriod, pwmDuty で周期とONになる時間を指定してください。

PWM の詳細は Core functions / PWM をご覧ください。

Syntax

[Konashi pwmMode:(int)pin mode:(int)mode];

k.pwmMode(pin, mode);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

LED2を周期10ms、デューティ5msのPWMにする。

[Konashi pwmMode:LED2 mode:KONASHI_PWM_ENABLE];
[Konashi pwmPeriod:LED2 period:10000];
[Konashi pwmDuty:LED2 duty:5000];

k.pwmMode(k.LED2, k.KONASHI_PWM_ENABLE);
k.pwmPeriod(k.LED2, 10000);
k.pwmDuty(k.LED2, 5000);

pwmPeriod

Description

指定のピンのPWM周期を設定します。

周期の単位はマイクロ秒(us)で指定してください。

PWM の詳細は Core functions / PWM をご覧ください。

Syntax

[Konashi pwmPeriod:(int)pin period:(unsigned int)period];

k.pwmPeriod(pin, period);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

LED2の周期を10msにセットする

[Konashi pwmPeriod:LED2 period:10000];

k.pwmPeriod(k.LED2, 10000);

pwmDuty

Description

指定のピンのPWMのデューティ(ONになっている時間)を設定します。

単位はマイクロ秒(us)で指定してください。

PWM の詳細は Core functions / PWM をご覧ください。

Syntax

[Konashi pwmDuty:(int)pin duty:(unsigned int)duty];

k.pwmDuty(pin, duty);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

LED2のデューティを5msにセットする

[Konashi pwmDuty:LED2 duty:5000];

k.pwmDuty(k.LED2, 5000);

pwmLedDrive

Description

指定のピンのLEDの明るさを0%〜100%で指定します。

pwmLedDrive 関数を使うには pwmMode で KonashiPWMModeEnableLED を指定してください。

PWM の詳細は Core functions / PWM をご覧ください。

Syntax

[Konashi pwmLedDrive:(int)pin dutyRatio:(int)ratio];

k.pwmLedDrive(pin, ratio);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

LED2の明るさを30%にする

[Konashi pwmMode:LED2 mode:KONASHI_PWM_ENABLE_LED_MODE];
[Konashi pwmLedDrive:LED2 dutyRatio:30];

k.pwmMode(k.LED2, k.KONASHI_PWM_ENABLE_LED_MODE);
k.pwmLedDrive(k.LED2, 30);

UART

uartMode

Description

UART の有効/無効を設定します。

有効にする前に、uartBaudrate でボーレートを設定しておいてください。

UART の詳細は Core functions / Communication - UART をご覧ください。

Syntax

[Konashi uartMode:(int)mode];

k.uartMode(mode);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

UARTを有効にする

[Konashi uartMode:KONASHI_UART_ENABLE];

k.uartMode(k.KONASHI_UART_ENABLE);

uartBaudrate

Description

UART の通信速度を設定します。

UART の詳細は Core functions / Communication - UART をご覧ください。

Syntax

[Konashi uartBaudrate:(int)baudrate];

k.uartBaudrate(baudrate);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

UARTの通信速度を9600bpsにする

[Konashi uartBaudrate:KONASHI_UART_RATE_9K6];

k.uartBaudrate(k.KONASHI_UART_RATE_9K6);

uartWrite

Description

UART でデータを1バイト送信します。

UART の詳細は Core functions / Communication - UART をご覧ください。

Syntax

[Konashi uartWrite:(unsigned char)data];

k.uartWrite(data);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

'A'という文字をUARTで送る

[Konashi uartWrite:'A'];

k.uartWrite('A');

I2C

i2cMode

Description

I²C を有効/無効を設定します。

I²C で通信できる速度として 100kbps と 400kbps がありmode引数で指定します。

I²C の詳細は Core functions / Communication - I²C をご覧ください。

Syntax

[Konashi i2cMode:(int)mode];

k.i2cMode(mode);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

I²C を100kbps(デフォルト)の通信速度で有効にする。

[Konashi i2cMode:KONASHI_I2C_ENABLE];

k.i2cMode(k.KONASHI_I2C_ENABLE);

i2cStartCondition

Description

I²C のスタートコンディションを発行します。

事前に i2cMode で I²C を有効にしておいてください。

I²C の詳細は Core functions / Communication - I²C をご覧ください。

Syntax

[Konashi i2cStartCondition];

k.i2cStartCondition();

Parameters

なし

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

i2cRestartCondition

Description

I²C のリスタートコンディションを発行します。

事前に i2cMode で I²C を有効にしておいてください。

I²C の詳細は Core functions / Communication - I²C をご覧ください。

Syntax

[Konashi i2cRestartCondition];

k.i2cRestartCondition();

Parameters

なし

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

i2cStopCondition

Description

I²C のストップコンディションを発行します。

事前に i2cMode で I²C を有効にしておいてください。

I²C の詳細は Core functions / Communication - I²C をご覧ください。

Syntax

[Konashi i2cStopCondition];

k.i2cStopCondition();

Parameters

なし

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

i2cWrite

Description

I²C で指定したアドレスにデータを書き込みます。

事前に i2cMode で I²C を有効にしておいてください。

I²C の詳細は Core functions / Communication - I²C をご覧ください。

Syntax

[Konashi i2cWrite:(int)length data:(unsigned char*)data address:(unsigned char)address];

k.i2cWrite(length, data, address);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

アドレス0x45に'A'というデータを書き込む

unsigned char data[] = {'A'};
[Konashi i2cWrite:1 data:data address:0x45];

k.i2cWrite(1, 'A', 0x45);

i2cReadRequest

Description

I²C で指定したアドレスからデータを読み込むリクエストを行います。

この関数はリクエストを行うだけでデータは取得できません。実際に値を取得するには、KonashiEventI2CReadCompleteNotification を addObserver でキャッチした後、i2cRead で値を取得できます。

Syntax

[Konashi i2cReadRequest:(int)length address:(unsigned char)address];

k.i2cReadRequest(length, address);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

i2cRead

Description

konashi が I²C から読み込んだデータを取得します。この関数で取得できる値は前回の i2cReadRequest 時に取得したデータです。

Syntax

[Konashi i2cRead:(int)length data:(unsigned char*)data];

k.i2cRead(length, handler);

Parameters

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Hardware Control

reset

Description

konashi を再起動します。

konashi が再起動すると、自動的にBLEのコネクションは切断されてしまいます。

Syntax

[Konashi reset];

k.reset();

Parameters

なし

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

konashi を再起動する

[Konashi reset];

k.reset();

batteryLevelReadRequest

Description

konashi のバッテリ残量を取得するリクエストを konashi に送ります。

この関数は konashi にリクエストを送るものなので、実際に値を取得するには、KonashiEventBatteryLevelDidUpdateNotification (バッテリ残量取得完了イベント)を addObserver でキャッチした後、batteryLevelRead で値を取得できます。

Syntax

[Konashi batteryLevelReadRequest];

k.batteryLevelReadRequest();

Parameters

なし

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

konashi のバッテリ残量を取得する

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    [Konashi initialize];
    
    [Konashi addObserver:self selector:@selector(konashiReady) name:KONASHI_EVENT_READY];
    [Konashi addObserver:self selector:@selector(battery) KONASHI_EVENT_UPDATE_BATTERY_LEVEL];
}

// konashiを探すボタンタップのアクション
- (IBAction)findKonashi:(id)sender {
    [Konashi find];
}

// バッテリ残量取得ボタンタップのアクション
- (IBAction)batteryLevelReadRequest:(id)sender {
    [Konashi batteryLevelReadRequest];
}

- (void) battery
{
    NSLog(@"READ_BATTERY: %d", [Konashi batteryLevelRead]);
}

k.ready(function(){
    // konashiと接続したら電池の残量を取得する
    k.batteryLevelReadRequest();
});
      
k.updateBatteryLevel(function(data){
    // 電池残量読み込み完了したら実行される
    console.log("#Battery Level: " + data);
});

k.find();

batteryLevelRead

Description

konashi のバッテリ残量を取得します。この関数で取得できる値は前回の batteryLevelReadRequest 時に取得した残量です。

konashiの現在のバッテリ残量を取得したい場合は、まず batteryLevelReadRequest で konashi に取得リクエストを送り、 KonashiEventBatteryLevelDidUpdateNotification を addObserver でキャッチした後、 この関数で値を取得できます。

Syntax

[Konashi batteryLevelRead];

k.batteryLevelRead(handler);

Parameters

Returns

0 〜 100 のパーセント単位でバッテリ残量が返ります。

Example

konashi のバッテリ残量を取得する

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    [Konashi initialize];
    
    [Konashi addObserver:self selector:@selector(konashiReady) name:KONASHI_EVENT_READY];
    [Konashi addObserver:self selector:@selector(battery) KONASHI_EVENT_UPDATE_BATTERY_LEVEL];
}

// konashiを探すボタンタップのアクション
- (IBAction)findKonashi:(id)sender {
    [Konashi find];
}

// バッテリ残量取得ボタンタップのアクション
- (IBAction)batteryLevelReadRequest:(id)sender {
    [Konashi batteryLevelReadRequest];
}

- (void) battery
{
    NSLog(@"READ_BATTERY: %d", [Konashi batteryLevelRead]);
}

k.ready(function(){
    // konashiと接続したら電池の残量を取得する
    k.batteryLevelReadRequest();
});
      
k.updateBatteryLevel(function(data){
    // 電池残量読み込み完了したら実行される
    k.batteryLevelRead(function(data){
        console.log("#Battery Level: " + data);
    });
    
    // k.updateBatteryLevel のコールバックの第一引数dataに電池残量が格納されています
    // console.log("#Battery Level: " + data);
});

k.find();

signalStrengthReadRequest

Description

konashi の電波強度を取得するリクエストを行います。

この関数はリクエストを行うだけでデータは取得できません。実際に値を取得するには、KonashiEventSignalStrengthDidUpdateNotification (電波強度取得完了イベント)を addObserver でキャッチした後、signalStrengthRead で値を取得できます。

Syntax

[Konashi signalStrengthReadRequest];

k.signalStrengthReadRequest();

Parameters

なし

Returns

成功時: KonashiResultSuccess, 失敗時: KonashiResultFailure

Example

konashi の電波強度を取得する

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    [Konashi initialize];
    
    [Konashi addObserver:self selector:@selector(konashiReady) name:KONASHI_EVENT_READY];
    [Konashi addObserver:self selector:@selector(strength) KONASHI_EVENT_UPDATE_SIGNAL_STRENGTH];
}

// konashiを探すボタンタップのアクション
- (IBAction)findKonashi:(id)sender {
    [Konashi find];
}

// 電波強度取得ボタンタップのアクション
- (IBAction)signalStrengthReadRequest:(id)sender {
    [Konashi signalStrengthReadRequest];
}

- (void) strength
{
    NSLog(@"READ_STRENGTH: %d", [Konashi signalStrengthRead]);
}

k.ready(function(){
    // konashiと接続したら電波強度を取得する
    k.batteryLevelReadRequest();
});

k.updateSignalStrength(function(data){
    // 電波強度取得完了したら実行される
    console.log("#Signal Strength: " + data);
});

k.find();

signalStrengthRead

Description

konashi の電波強度を取得します。この関数で取得できる値は前回の signalStrengthReadRequest 時に取得した強度(db)です。距離が近いと-40db, 距離が遠いと-90db程度になります。

konashiの現在の電波強度を取得したい場合は、まず signalStrengthReadRequest で konashi に取得リクエストを送り、 KonashiEventSignalStrengthDidUpdateNotification を addObserver でキャッチした後、 この関数で値を取得できます。

Syntax

[Konashi signalStrengthRead];

k.signalStrengthRead(handler);

Parameters

Returns

電波強度がdbで返ります。

Example

konashi の電波強度を取得する

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    [Konashi initialize];
    
    [Konashi addObserver:self selector:@selector(konashiReady) name:KONASHI_EVENT_READY];
    [Konashi addObserver:self selector:@selector(strength) KONASHI_EVENT_UPDATE_SIGNAL_STRENGTH];
}

// konashiを探すボタンタップのアクション
- (IBAction)findKonashi:(id)sender {
    [Konashi find];
}

// 電波強度取得ボタンタップのアクション
- (IBAction)signalStrengthReadRequest:(id)sender {
    [Konashi signalStrengthReadRequest];
}

- (void) strength
{
    NSLog(@"READ_STRENGTH: %d", [Konashi signalStrengthRead]);
}

k.ready(function(){
    // konashiと接続したら電波強度を取得する
    k.batteryLevelReadRequest();
});

k.updateSignalStrength(function(data){
    // 電波強度取得完了したら実行される
    k.signalStrengthRead(function(data){
        console.log("#Signal Strength: " + data);
    });
    
    // k.updateSignalStrength のコールバックの第一引数に電波強度が格納されています
    // console.log("#Signal Strength: " + data);
});

k.find();

JavaScript Event API

JavaScript Event API について

Events で挙げられているイベントをキャッチするためには、addObserver(on)でイベントハンドラを登録する必要があります。

k.on(k.KONASHI_EVENT_READY, function(){
    console.log("#konashiの準備が整ったようです！さあ使っていこう");
});

k.find();

これをよりシンプルに記述できるのが JavaScript Event API です。

k.ready(function(){
    console.log("#konashiの準備が整ったようです！さあ使っていこう");
});

k.find();

jQueryでいうところの、$("#hoge").on("click", function(e){}) を $("#hoge").click(function(e){}) と記述できるのと同じ要領です。

centralManagerPoweredOn

Description

KONASHI_EVENT_CENTRAL_MANAGER_POWERED_ON イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.centralManagerPoweredOn(handler);

Parameters

Returns

なし

peripheralNotFound

Description

KONASHI_EVENT_PERIPHERAL_NOT_FOUND イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.peripheralNotFound(handler);

Parameters

Returns

なし

connected

Description

KONASHI_EVENT_CONNECTED イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.connected(handler);

Parameters

Returns

なし

disconnected

Description

KONASHI_EVENT_DISCONNECTED イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.disconnected(handler);

Parameters

Returns

なし

ready

Description

KONASHI_EVENT_READY イベント(Events参照)のイベントハンドラを登録します。

k.find()を実行したあと、k.ready で KONASHI_EVENT_READY イベントを受け取った後から、koanshiと通信ができるようになります。jQueryでいうところの$(function(){})や$.ready(function(){}) と同じ要領です。

Syntax

k.ready(handler);

Parameters

Returns

なし

Example

k.ready(function(){
   k.pinMode(k.LED2, k.OUTOUT);
   k.digitalWrite(k.LED2, k.HIGH);  // LED2 on
});

// konashiを探す
k.find();

updatePioInput

Description

KONASHI_EVENT_UPDATE_PIO_INPUT イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.updatePioInput(handler);

Parameters

Returns

なし

Example

k.updatePioInput(function(data){
   // PIOの入力の状態が変化したら実行されます
   console.log("#PIO Input: " + data);
});

// konashiを探す
k.find();

updateAnalogValue

Description

KONASHI_EVENT_UPDATE_ANALOG_VALUE イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.updateAnalogValue(handler);

Parameters

Returns

なし

updateAnalogValueAio0

Description

KONASHI_EVENT_UPDATE_ANALOG_VALUE_AIO0 イベント(Events参照)のイベントハンドラを登録します。

analogReadRequest でAIO0のアナログ値を読むリクエストを送った後、konashiがアナログ値を取得しJavaScript側にデータを送ってきた時に KONASHI_EVENT_UPDATE_ANALOG_VALUE_AIO0 インベントが発行されます。analogReadRequest を実行する前に、 updateAnalogValueAio0 でイベントハンドラを設定してください。

Syntax

k.updateAnalogValueAio0(handler);

Parameters

Returns

なし

Example

k.updateAnalogValueAio0(function(data){
    // AIO0のアナログ値が取得できたら実行されます
    console.log("#AIO0 Value: " + data);
});

k.ready(function(){
    // konashiとの接続し使用する準備が整った時に実行されます
    k.analogReadRequest(k.AIO0);  // AIO0のアナログ値をReadするリクエストを送る
});

// konashiを探す
k.find();

updateAnalogValueAio1

Description

KONASHI_EVENT_UPDATE_ANALOG_VALUE_AIO1 イベント(Events参照)のイベントハンドラを登録します。

analogReadRequest でAIO1のアナログ値を読むリクエストを送った後、konashiがアナログ値を取得しJavaScript側にデータを送ってきた時に KONASHI_EVENT_UPDATE_ANALOG_VALUE_AIO1 インベントが発行されます。analogReadRequest を実行する前に、 updateAnalogValueAio1 でイベントハンドラを設定してください。

Syntax

k.updateAnalogValueAio1(handler);

Parameters

Returns

なし

Example

k.updateAnalogValueAio1(function(data){
    // AIO1のアナログ値が取得できたら実行されます
    console.log("#AIO Value: " + data);
});

k.ready(function(){
    // konashiとの接続し使用する準備が整った時に実行されます
    k.analogReadRequest(k.AIO1);  // AIO1のアナログ値をReadするリクエストを送る
});

// konashiを探す
k.find();

updateAnalogValueAio2

Description

KONASHI_EVENT_UPDATE_ANALOG_VALUE_AIO2 イベント(Events参照)のイベントハンドラを登録します。

analogReadRequest でAIO2のアナログ値を読むリクエストを送った後、konashiがアナログ値を取得しJavaScript側にデータを送ってきた時に KONASHI_EVENT_UPDATE_ANALOG_VALUE_AIO2 インベントが発行されます。analogReadRequest を実行する前に、 updateAnalogValueAio2 でイベントハンドラを設定してください。

Syntax

k.updateAnalogValueAio2(handler);

Parameters

Returns

なし

Example

k.updateAnalogValueAio2(function(data){
    // AIO0のアナログ値が取得できたら実行されます
    console.log("#AIO2 Value: " + data);
});

k.ready(function(){
    // konashiとの接続し使用する準備が整った時に実行されます
    k.analogReadRequest(k.AIO2);  // AIO2のアナログ値をReadするリクエストを送る
});

// konashiを探す
k.find();

completeReadI2c

Description

KONASHI_EVENT_I2C_READ_COMPLETE イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.completeReadI2c(handler);

Parameters

Returns

なし

completeUartRx

Description

KONASHI_EVENT_UART_RX_COMPLETE イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.completeUartRx(handler);

Parameters

Returns

なし

Example

k.completeUartRx(function(data){
   // UARTでデータを受信した時に実行されます
   console.log("#UART Recv: " + data);
});

k.ready(function(){
    // konashiとの接続が確立し、konashi側の準備が整った時に実行されます
    k.uartMode(k.KONASHI_UART_ENABLE); // UARTを有効に
    k.uartBaudrate(k.KONASHI_UART_RATE_9K6);  // 9600bpsに
});

// konashiを探す
k.find();

updateBatteryLevel

Description

KONASHI_EVENT_UPDATE_BATTERY_LEVEL イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.updateBatteryLevel(handler);

Parameters

Returns

なし

Example

k.updateBatteryLevel(function(data){
   // 電池残量が取得できたら実行されます
   console.log("#Battery: " + data + "%");
});

k.ready(function(){
    k.batteryLevelRead();   // 電池残量取得リクエスト
});

// konashiを探す
k.find();

updateSignalStrength

Description

KONASHI_EVENT_UPDATE_BATTERY_LEVEL イベント(Events参照)のイベントハンドラを登録します。

Syntax

k.updateSignalStrength(handler);

Parameters

Returns

なし

Example

k.updateSignalStrength(function(data){
   // 電波強度が取得できたら実行されます
   console.log("#Battery: " + data + "%");
});

k.ready(function(){
    k.signalStrengthReadRequest();   // 電波強度取得リクエスト
});

// konashiを探す
k.find();

Extension Boards

AD変換拡張ボード

AC調光拡張ボード

Grove拡張ボード

konashi AD変換拡張ボード(YE-EX001)

konashi AD変換拡張ボードは、フィジカル・コンピューティング・ツールキットkonashiのアナログ入力を、I²Cを用いて拡張するためのインタフェース基板です。 Groveセンサモジュールをそのまま接続して使用することができます。

initADC / init

Description

AD変換基板の初期化を行います。AD変換基板のアドレスを指定し、アナログの電圧値をI²C経由で読み取ることができるように設定を行います。

k.adc.init(k.adc.ADDR_00, function(value){
    alert(value);
});

Syntax

[Konashi initADC:address];

k.adc.init(address,handler);

Parameters

Returns

なし

Example

スイッチS1がそれぞれOFF,OFF(アドレス 0x48)のときの初期化

[Konashi initADC:ADDR_00];

k.adc.init(k.adc.ADDR_00, function(value){
    alert(value);
});