2 * @fileOverview SPIクラスを定義します。
\r
10 * <a href="https://mbed.org/handbook/SPI">mbed::SPI</a>と同等の機能を持ちます。
\r
13 * @param {mbedJS.Mcu} i_mcu
\r
14 * インスタンスをバインドするMCUオブジェクトです。
\r
15 * @param {[PinName,PinName,PinName]} i_params
\r
16 * SPIを構成する3つのPinNameを格納する配列です。mosi,miso,sclkの順番です。
\r
17 * @param {HashMap|Generator|function} i_handler
\r
18 * 非同期イベントハンドラの連想配列、Generator、コールバック関数の何れかを指定します。
\r
20 * 非同期イベントハンドラの場合、関数はイベントハンドラで結果を通知します。
\r
22 * <li>{function()} onNew -
\r
23 * インスタンスが使用可能になった時に呼び出されます。
\r
25 * <li>{function(v)} onWrite -
\r
26 * write関数のコールバック関数です。
\r
28 * <li>{int} v - 受信した8BIT値です。</li>
\r
31 * <li>{function(v)} onFrequency -
\r
32 * frequency関数のコールバック関数です。
\r
34 * <li>{function(v)} onFormat -
\r
35 * format関数のコールバック関数です。
\r
39 * Generatorを指定した場合、コールバック関数の引数はyiledの戻り値として取得できます。
\r
42 * コールバック関数を指定した場合、RPCが完了したときに呼び出されます。メンバ関数のイベントハンドラは個別に設定する必要があります。
\r
44 * @return {mbedJS.SPI}
\r
45 * @example //Callback
\r
46 * var mcu=new mbedJS.Mcu("192.168.128.39",
\r
49 * var pin=new mbedJS.SPI(mcu,[mbedJS.PinName.p5,mbedJS.PinName.p6,mbedJS.PinName.p7],{
\r
51 * pin.frequency(1000000);
\r
53 * onFrequency:function()
\r
57 * onFormat:function()
\r
61 * onWrite:function(v){
\r
65 * onClose:function(){
\r
67 * onError:function(){
\r
70 * @example //Generator
\r
71 * var g=function*(){
\r
73 * var mcu=new mbedJS.Mcu("192.168.128.39",g);
\r
74 * yield mcu.waitForNew();
\r
75 * var pin=new mbedJS.SPI(mcu,[mbedJS.PinName.p5,mbedJS.PinName.p6,mbedJS.PinName.p7],g);
\r
76 * yield pin.waitForNew();
\r
77 * yield pin.frequency(1000000);
\r
78 * yield pin.format(8,3);
\r
79 * v=yield pin.write(39);
\r
80 * yield mcu.close();
\r
87 var CLASS=function SPI(i_mcu,i_params,i_handler)
\r
93 var cb=MI._initHandler.call(_t,i_handler);
\r
94 MI.assertInt(i_params);
\r
95 _t._mcu.rpc(_t.RPC_NS+":_new1",i_params[0]+","+i_params[1]+","+i_params[2]+","+NS.PinName.NC,
\r
98 _t._oid=j.result[0];
\r
100 if(_t._gen){_t._gen.next(_t);}
\r
105 throw new MI.MiMicException(e);
\r
112 RPC_NS:"mbedJS:SPI",
\r
113 /** @private 最後にコールしたAPIです。*/
\r
115 /** @private Generatorモードの場合にGeneratorオブジェクトを保持します。*/
\r
117 /** @private コールバック関数の連想配列です。要素はコンストラクタを参照してください。*/
\r
119 /** @private リモートインスタンスのオブジェクトIDです。*/
\r
122 * Generatorモードのときに使用する関数です。
\r
123 * Generatorモードの時は、yieldと併用してnew SPI()の完了を待ちます。
\r
124 * @name mbedJS.SPI#waitForNew
\r
127 waitForNew:function SPI_waitForNew()
\r
130 if(this._lc!=CLASS){throw new MI.MiMicException(MI.Error.NG_ILLEGAL_CALL);}
\r
131 this._lc=CLASS.waitForNew;
\r
133 throw new MI.MiMicException(e);
\r
137 * SPI Slaveに値を書き込み、戻り値を返します。
\r
138 * 関数の完了時にonWriteイベントが発生します。
\r
139 * Generatorモードの時は、yieldと併用して完了を待機できます。
\r
140 * @name mbedJS.SPI#write
\r
142 * @param {int} i_value
\r
144 * Callbackモードの時はRPCメソッドのインデクスを返します。
\r
146 write:function SPI_write(i_value)
\r
150 MI._assertYield.call(_t);
\r
151 var cb=MI._getCb(arguments,_t._event.onWrite);
\r
152 _t._lc=CLASS.write;
\r
153 MI.assertInt(i_value);
\r
154 return _t._mcu.rpc(_t.RPC_NS+":write",_t._oid+","+i_value,
\r
158 if(_t._gen){_t._gen.next(v);}
\r
163 throw new MI.MiMicException(e);
\r
167 * frequencyに値を設定します。
\r
168 * 関数の完了時にonFrequencyイベントが発生します。
\r
169 * Generatorモードの時は、yieldと併用して完了を待機できます。
\r
170 * @name mbedJS.SPI#frequency
\r
172 * @param {int} i_value
\r
173 * frequencyに設定する値です。
\r
175 * Callbackモードの時はRPCメソッドのインデクスを返します。
\r
177 frequency:function SPI_frequency(i_value)
\r
181 MI._assertYield.call(_t);
\r
182 var cb=MI._getCb(arguments,_t._event.onFrequency);
\r
183 _t._lc=CLASS.frequency;
\r
184 MI.assertInt(i_value);
\r
185 return _t._mcu.rpc(_t.RPC_NS+":frequency",_t._oid+","+i_value,
\r
188 if(_t._gen){_t._gen.next();}
\r
193 throw new MI.MiMicException(e);
\r
198 * 関数の完了時にonFormatイベントが発生します。
\r
199 * Generatorモードの時は、yieldと併用して完了を待機できます。
\r
200 * @name mbedJS.SPI#format
\r
202 * @param {int} i_bits
\r
203 * @param {int} i_mode
\r
204 * 省略可能です。省略時は0になります。
\r
206 * Callbackモードの時はRPCメソッドのインデクスを返します。
\r
208 format:function SPI_format(i_bits,i_mode)
\r
212 MI._assertYield.call(_t);
\r
213 var cb=MI._getCb(arguments,_t._event.onFormat);
\r
214 _t._lc=CLASS.format;
\r
215 var mode=i_mode?i_mode:0;
\r
216 MI.assertInt([i_bits,mode]);
\r
217 return _t._mcu.rpc(_t.RPC_NS+":format",_t._oid+","+i_bits+","+mode,
\r
220 if(_t._gen){_t._gen.next();}
\r
225 throw new MI.MiMicException(e);
\r
229 * MCUに生成されているオブジェクトを破棄します。
\r
230 * @name mbedJS.SPI#dispose
\r
233 dispose:function SPI_dispose()
\r
235 return this._mcu._dispose.apply(this,arguments);
\r