设备端对接（C语言）

1 整体架构

2 业务流程

3 对接LinkVisual SDK

3.1 C语言SDK对接

车行设备由多功能停车摄像头、LED显示屏、道闸等设备组成，其中多功能停车摄像头负责车牌识别、车辆权限判定、云端通信，以及LED和道闸控制。多功能停车摄像头在标准摄像头功能基础上，扩展了与车行相关的服务与能力，是车行设备端对接的主要部件。

对接C语言SDK参见：概述

3.2 创建车行产品

1）访问地址：

https://iot.console.aliyun.com/product，

在物联网平台上创建产品，所属品类选择“智能园区/多功能停车摄像头”：

2）在产品详情页面，选择“功能定义-编辑草稿”：

3）然后在编辑草稿页面，选择“添加标准功能”：

4）在弹出的对话框中选择所需要的属性、服务、事件。例如：选择服务“下发LED数据”，事件“异常抬杆”：

5）选择完成后将物模型发布上线：

3.3 创建车行设备

1）在产品列表中选择“设备管理”：

2）为产品添加设备，然后在设备列表中选择“查看”：

3）获得设备证书（ProductKey、DeviceName、DeviceSecret）信息：

3.4 设备连接物联网平台

复制车行设备证书（ProductKey、DeviceName、DeviceSecret），将设备连入物联网平台。

3.5 设备物模型开发

根据物模型定义的属性、事件、服务，完成设备端开发。

4 多功能停车摄像头物模型

与标准的“摄像头”物模型相比，多功能停车摄像头增加（或复用）了以下属性、事件、服务：

4.1 属性

4.2 服务

4.2.1 下发车辆权限

入参：

出参：

车辆权限通过JSON文件下发、上报。JSON文件中字段定义如下：

下发车辆权限文件示例：

{
    "total": 100,
    "permList": [
    {
        "type": 1,
        "plateNumber": "京N1***45"，
        "effectiveDate": "时间戳",
        "expiryDate": "时间戳",
        "permissionType": 1
    },
    {
        "type": 2,
        "plateNumber": "京N***67"，
        "effectiveDate": "",
        "expiryDate": "",
        "permissionType": 2
    }
    ]
}

设备端下载并解析JSON权限文件，按照指定操作类型更新本地车辆权限数据库。

4.2.2 获取车辆权限

请求参数：无

出参：

设备端按约定格式导出权限文件，使用OSS STS Token将文件上传到指定位置，并返回文件URL。

4.2.3 查询车辆权限下发状态

请求参数：无

出参：

4.2.4 下发OSS STS Token

入参：

出参：

设备端通过解密STS Token证书，获取上传文件所需的权限。当证书过期后，设备端上报OSS STS Token请求事件，云端重新下发有效的STS Token证书。

4.2.5 下发LED显示数据

根据设备属性LedNoticeMode定义的模式，下发屏幕提示数据。以分离模式下发需要实现以下服务：

• NoticeBroadcast：下发提示语音

• NoticeDisplay：下发提示显示

• DefaultDisplay：下发默认显示

以混合模式下发需要实现以下服务：

• AddLedData：提示语音、提示显示同时下发

1）下发提示语音

入参：

返回参数：无

2）下发提示显示

入参：

返回参数：无

3）下发默认显示

入参：

返回参数：无

4）混合下发LED提示数据

入参：

出参：

云端通过JSON字符串下发LED显示数据，JSON字符串内容定义如下：

以支持四行文字，红、绿两种颜色的LED显示器为例，下发“固定场景-空闲”时显示的内容：

{
      "Type": 0,
      "Situation": 0,
      "PlateNumber": "",
      "ShowTime": ,
      "AudioContextInfo": "",
      "ScreenLineNum": 4,
      "ContextList":[
          {
              "RunType": 0,
              "ColorType": 1,
              "CustomContext":"智慧停车",
              "Audio": 0
          },
          {
              "RunType": 0,
              "ColorType": 1,
              "CustomContext":"智能识别",
              "Audio": 0
          },
          {
              "RunType": 0,
              "ColorType": 1,
              "CustomContext":"一车一杆",
              "Audio": 0
          },
          {
              "RunType": 0,
              "ColorType": 2,
              "CustomContext":"#T",
              "Audio": 0
          }
      ]
}

4.2.6 下发二维码

入参：

返回参数：无

4.2.7 手动触发车牌识别

请求参数：无，或者返回参数：无

设备端抓拍车辆图片，并通过智能告警事件上报图片和相关信息。

4.3 事件

4.3.1 智能告警事件

与其他事件不同，设备端需要调用LV SDK提供的“

lv_post_intelligent_alarm”接口上报智能告警事件，相关参数和接口定义以LV SDK为准：

/* 智能事件参数集 */
typedef struct {
    lv_intelligent_event_type_e type; //智能事件类型，车辆识别为10005
    lv_media_format format;           //智能事件的媒体数据类型，图片类型为0
    struct {
        char *p;
        uint32_t len;
    } media;                          //智能事件的媒体数据,不大于1MB
    struct {
        char *p;
        uint32_t len;
    } addition_string;                //智能事件的附加字符串信息，不大于2048B
} lv_intelligent_alarm_param_s;

/* 上报智能告警事件图片、告警信息 */
int lv_post_intelligent_alarm(const lv_intelligent_alarm_param_s *param);

参数说明：

4.3.2 OSS STS Token请求事件

上报参数：

4.3.3 异常抬杆事件

上报参数：

5 通过OSS STS Token上传文件

设备端集成OSS SDK参见：安装

设备端使用签名URL上传文件示例参考：授权访问