======================================================================
             TomuCore SensorSouce API 仕様 ver. 1.05
======================================================================

2010-2-1a ver1.05
大島, 岩井, 戸辺
変更履歴
2010-3-4 立体差分カメラのデータフォーマット訂正


0. メモ
関連ドキュメント
       TomuCore User API

 ※SensorSourceAPIへの変更
       照度センサを追加
       Illumination

1. はじめに
人流センサや温度センサなどの各種センサから情報を収集し
送信するランタイムをSensorSourceと呼ぶ。

2. 通信スタイル
 TomuCoreがGlobalIPを持つ場合
       TCP/IPのソケット通信を用いJava同士では
       ObjectOutputStreamが持つ。
 TomuCoreがGlobalIPを持たない場合
       XMPPlib等
 共通（将来）
       RF

3.各要素
 3.1 <Seq>シーケンシャル番号
 long型：
 任意の番号からインクメントする。
 最初に来たメッセージの番号を記憶する。
 SensorSouceは送信ごとに+1する。

 3.2 <SensedTimeStamp>
 Sensorが正確な時刻をもっていることを前提とする。
 センシングした時刻が重要である。
 受信時刻ではだめ。
 Unix Timeは仮定してはいけない。
 文字列YYYY-MM-DD HH:MM:SS(JST) 共通
 FFS:正確でないセンサ

 3.3 <Type>
        TomuCore User API参照のこと

 3.4 <Value>
   人流
    TomuCore User API参照のこと
   温度
    TScanのデータ44個
    時系列に並べ直す。<StaticSensorData>を重ねる。
    データを統合するかどうかはFFS

4. 開発の優先度
       tcp/ip
       xmpp

5. 詳細規定(XMLではないObject)
<!--ソースとなるセンサからTomuCoreへの返答 -->
<TomuMessage>
   <Head>
       <MsgType>SOURCE_RESPONSE</MsgType>
       <MsgId>201003251424001</MsgId>
       <MsgDest>srctomu@gmail.com</MsgDest>
       <MsgSrc>tomucore@gmail.com</MsgSrc>
   </Head>
   <Response>
       <Seq>1</Seq>
       <SensorSourceDataResponse>
           <StaticSensorData>
               <Type>PEDESTRIAN</Type>
               <SensedTime>2010-02-01 09:22:21(JST)</SensedTime>
               <StaticSensorID>201003221542235</StaticSensorID>
               <Value>
                   <StreetPedestrianFlowValue>
                       <MeasurementTimeSec>60</MeasurementTimeSec>
                       <ChiefAxis>
                           <Plus>
                               <Compass>0</Compass>
                               <Num>1</Num>
                               <AvgSpeed>2.1</AvgSpeed>
                           </Plus>
                           <Minus>
                               <Compass>0</Compass>
                               <Num>10</Num>
                               <AvgSpeed>1.1</AvgSpeed>
                           </Minus>
                       </ChiefAxis>
                       <Residence>6</Residence>
                   </StreetPedestrianFlowValue>
               </Value>
           </StaticSensorData>
       </SensorSourceDataResponse>
   </Response>
</TomuMessage>


5. FFS
なし
Dynamic Sensor Management Protcols
                                                                 以上