以太网
=======================================

适用产品
---------------

拥有有线网口的摄像头：

- SingTown AI Vision Module SC（no）
- SingTown AI Vision Module EC（yes）

介绍
---------------
SingTown AI Vision Module 和电脑组成局域网后，SingTown AI Vision Module会被分配一个ip地址，电脑可以通过HTTP API获得识别结果。

- 电脑
- 树莓派
- 其他有网口，可以使用HTTP的设备

前提条件
----------------------
模型已上传到摄像头


连接电路
----------------------

- SingTown AI Vision Module 的网口连接到路由器的Lan。
- 电脑的网口连接到路由器的Lan。


HTTP获取识别结果
----------------------
- 请求地址：`http://172.16.110.6/api/json`
  （将172.16.110.6改为SingTown AI Vision Module的以太网ip地址。）

- 对于目标检测，结果是一个json列表：

.. code :: json

    [[score1, idx1, left1, top1, right1, bottom1],[score2, idx2, left2, top2, right2, bottom2], ...]

结果的意义：

1. score代表对应的识别对象的准确度，范围0到255。score值越大，越像目标。识别到多个目标时，按照得分从高到低顺序发送。
2. idx是用户自己设置的标签的编号，如果标签是猫和狗，0就代表猫，1就代表狗。标签列表是在星瞳AI云服务中设置的，每个项目都有不同的标签。
3. left， top， right， bottom，是目标的位置坐标。原点在画面左上角。

.. image:: ../media/coordinate_od.jpg
   :align: center
   :width: 600


- 对于分类，结果是一个json列表：

.. code :: json

    [score1, score2... ]

结果的意义：

1. score是每一个分类的得分（score）。score代表对应的识别对象的准确度，范围0到255。score值越大，越像目标。
比如[200, 10]代表猫的得分是200，狗的得分是10。

2. score对应的标签列表是在星瞳AI云服务中设置的，每个项目都有不同的标签。

HTTP获取jpeg图像
----------------------

- 请求地址：`http://172.16.110.6/api/jpeg`
  （将172.16.110.6改为SingTown AI Vision Module的以太网ip地址。）
- 响应是一个jpeg图片。