怎么使用乐鑫云端服务器软件

雨点打透心脏的1/2处 2022-06-09 00:19 149阅读 0赞

# http://iot.espressif.cn/\#/help-zh-cn/    #

# 帮助 #

### 开始 这是采集数据的例子，反向控制（比如开关）的例子见 [智能开关][Link 1] ###

这是线上机器例子，每五分钟采集一次数据，[查看][Link 2]。你不需要写一行代码，就能做到同样的事情。

下面以 cpu usage 作为例子，来展示如何使用这个平台。因为这个不需要传感器，并且在本机就可以运行。

需要理解几个概念：device, product, key, datastream, datapoint.

device: 设备，可以理解一个具体的硬件设备，大部分拥有一些传感器，比如温度、湿度传感器。

product: 产品，所有的 device 集合，有出厂，激活，统计功能，在这个例子里暂时接触不多。

key: 密钥，每个 device 都拥有多个 key，用来 api 调用，其中 master key 唯一标识该设备。

datastream: 数据模型，用户自定义的，用来推送数据，具备名字，维度，单位等属性。

datapoint: 数据点，对 datastream 推送数据，形成每个数据点。

### 成为开发者 ###

首先您需要[注册][Link 3]成为开发者，注意用户名和邮箱都是唯一的。

![join][]

### 创建设备 ###

进入设备开发，点击右边的[创建][Link 4]按钮，因为是第一次创建，所以同时要创建产品。

请选择公开设备，有利于分享。

device name: my-computer, product: cpu-usage

![create device][]

### 设备详情 ###

从[设备开发][Link 5]里面可以看到刚才创建的设备，这里将列出所有处于开发模式的设备，点击之后进入设备详情。

![device detail][]

### 设置模型 ###

关于数据模型，可以查看[这里][Link 6]，简单说就是创建一定的命名空间来读写数据。

模型名字： cpu， 维度： 一维，单位： 百分比， 符号： %，标签： cpu usage， 描述： cpu us 的使用情况

![device datastream][]

### 密钥管理 ###

关于密钥，可以查看[这里][Link 7]，是对设备控制和读写数据的凭证。在这里我们只需要 master key（红色框里面）。

图中的 74ed1fa3... 就是 master key，已经自动生成。

![device key][]

### 推送数据 ###

创建设备单个数据点，可以查看[这里][Link 8]，推送一个数据点到服务器端。

调用 curl，用户也可以使用 [postman][] 工具。

curl -H "Authorization: token 74ed1fa388b71957a6438199790460bfa9e52644" -d '{"datapoint":{"x":1}}' https://iot.espressif.cn/v1/datastreams/cpu/datapoint/

返回结果：

{
      "status": 200,
      "datapoint": {
        "updated": "2014-05-30 10:51:22",
        "created": "2014-05-30 10:51:22",
        "visibly": 1,
        "datastream_id": 114,
        "at": "2014-05-30 10:51:22",
        "x": 1,
        "id": 583
      }
    }

### 数据展示 ###

多个数据点将形成图像，并且对于公开的设备，可以分享给他人查看。

![device chart][]

### 请求日志 ###

线上开发工具能及时的展示请求日志，为开发带来便捷。

![device request log][]

### 这样很简单的就做一个 IOT 的采集程序了， have fun! ###

[Link 1]: http://iot.espressif.cn/#/help/ioc-switch-demo/
[Link 2]: http://iot.espressif.cn/#/devices/132/view/?serial=86e903a6
[Link 3]: http://iot.espressif.cn/#/join/
[join]: /images/20220609/44f76075fa494870a9226df0cda18f16.png
[Link 4]: http://iot.espressif.cn/#/devices/create/
[create device]: /images/20220609/ffc4bb76417f4b9b85dd575da05a2c9e.png
[Link 5]: http://iot.espressif.cn/#/devices/
[device detail]: /images/20220609/a828cf9b5c1e446281393004c0909816.png
[Link 6]: http://iot.espressif.cn/#/api/#api-datastream-tmpl
[device datastream]: /images/20220609/e9f5a2f64c87494894b932b937464376.png
[Link 7]: http://iot.espressif.cn/#/api/#api-key
[device key]: /images/20220609/e863e3fefbd04927b054a0e27bc6ba2b.png
[Link 8]: http://iot.espressif.cn/#/api/#api-device-datapoints-single-create
[postman]: https://chrome.google.com/webstore/detail/postman-rest-client/fdmmgilgnpjigdojojpjoooidkmcomcm?hl=en
[device chart]: /images/20220609/40c716568c7443a5aec13785e4d837fc.png
[device request log]: /images/20220609/8500d0c651684c07b2483cd9919b610a.png