2 * @fileOverview PortOutクラスを定義します。
\r
10 * <a href="https://mbed.org/handbook/PortOut">mbed::PortOut</a>と同等の機能を持ちます。
\r
11 * @name mbedJS.PortOut
\r
13 * @param {mbedJS.Mcu} i_mcu
\r
14 * インスタンスをバインドするMCUオブジェクトです。
\r
15 * @param {HashMap|Array} i_params
\r
17 * HashNapの場合は以下のメンバを指定できます。
\r
19 * <li>{PortName} port -
\r
21 * <li>{uint32} mask -
\r
22 * ポートマスクを指定します。</li>
\r
25 * <p>配列の場合は次の順番でパラメータを指定します。
\r
26 * <pre>{port,mask}</pre>
\r
28 * @param {HashMap|Generator|function} i_handler
\r
29 * 非同期イベントハンドラの連想配列、Generator、コールバック関数の何れかを指定します。
\r
31 * 非同期イベントハンドラの場合、関数はイベントハンドラで結果を通知します。
\r
33 * <li>{function()} onNew -
\r
34 * インスタンスが使用可能になった時に呼び出されます。
\r
36 * <li>{function()} onWrite -
\r
37 * write関数のコールバック関数です。
\r
39 * <li>{function(v)} onRead -
\r
40 * read関数のコールバック関数です。
\r
42 * <li>{int} v - 現在のピンの値です。</li>
\r
47 * Generatorを指定した場合、コールバック関数の引数はyiledの戻り値として取得できます。
\r
50 * コールバック関数を指定した場合、RPCが完了したときに呼び出されます。メンバ関数のイベントハンドラは個別に設定する必要があります。
\r
52 * @return {mbedJS.PortOut}
\r
53 * @example //Callback
\r
54 * var mcu=new mbedJS.Mcu("192.168.128.39",
\r
57 * var pin=new mbedJS.PortOut(mcu,[mbedJS.PortName.Port0,0xffffffff],{
\r
61 * onWrite:function()
\r
65 * onRead:function(v)
\r
70 * onClose:function(){
\r
72 * onError:function(){
\r
75 * @example //Generator
\r
76 * var g=function*(){
\r
78 * var mcu=new mbedJS.Mcu("192.168.128.39",g);
\r
79 * yield mcu.waitForNew();
\r
80 * var port=new mbedJS.PortOut(mcu,{port:mbedJS.PortName.Port0,mask:0xffffffff},g);
\r
81 * yield port.waitForNew();
\r
82 * yield port.write(5678);
\r
83 * var v=yield port.read();
\r
84 * yield mcu.close();
\r
91 var CLASS=function PortOut(i_mcu,i_params,i_handler)
\r
97 var cb=MI._initHandler.call(_t,i_handler);
\r
100 if(MI.isHashArray(i_params)){
\r
101 pr=[i_params.port,i_params.mask];
\r
102 }else if(MI.isArray(i_params)){
\r
106 _t._mcu.rpc(_t.RPC_NS+":_new1",pr[0]+","+pr[1],
\r
109 _t._oid=j.result[0];
\r
111 if(_t._gen){_t._gen.next(_t);}
\r
116 throw new MI.MiMicException(e);
\r
122 RPC_NS:"mbedJS:PortOut",
\r
123 /** @private 最後にコールしたAPIです。*/
\r
125 /** @private Generatorモードの場合にGeneratorオブジェクトを保持します。*/
\r
127 /** @private コールバック関数の連想配列です。要素はコンストラクタを参照してください。*/
\r
129 /** @private リモートインスタンスのオブジェクトIDです。*/
\r
132 * Generatorモードのときに使用する関数です。
\r
133 * Generatorモードの時は、yieldと併用してnew PortOut()の完了を待ちます。
\r
134 * @name mbedJS.PortOut#waitForNew
\r
137 waitForNew:function DigitalOut_waitForNew()
\r
140 if(this._lc!=CLASS){throw new MI.MiMicException(MI.Error.NG_ILLEGAL_CALL);}
\r
141 this._lc=CLASS.waitForNew;
\r
143 throw new MI.MiMicException(e);
\r
148 * 関数の完了時にonWriteイベントが発生します。
\r
149 * Generatorモードの時は、yieldと併用して完了を待機できます。
\r
150 * @name mbedJS.PortOut#write
\r
152 * @param {int} i_value
\r
154 * Callbackモードの時はRPCメソッドのインデクスを返します。
\r
156 write:function PortOut_write(i_value)
\r
160 var cb=MI._getCb(arguments,_t._event.onWrite);
\r
161 MI._assertYield.call(_t);
\r
162 _t._lc=CLASS.write;
\r
163 MI.assertInt(i_value);
\r
164 return _t._mcu.rpc(_t.RPC_NS+":write",_t._oid+","+i_value,
\r
167 if(_t._gen){_t._gen.next();}
\r
172 throw new MI.MiMicException(e);
\r
177 * 関数の完了時にonReadイベントが発生します。
\r
178 * Generatorモードの時は、yieldと併用して完了を待機できます。
\r
179 * @name mbedJS.PortOut#read
\r
182 * Callbackモードの時はRPCメソッドのインデクスを返します。
\r
184 * Generatorモードの時はポートの値を返します。
\r
186 read:function PortOut_read()
\r
190 var cb=MI._getCb(arguments,_t._event.onRead);
\r
191 MI._assertYield.call(_t);
\r
193 return _t._mcu.rpc(_t.RPC_NS+":read",_t._oid,
\r
198 if(_t._gen){_t._gen.next(v);}
\r
203 throw new MI.MiMicException(e);
\r