边缘计算网关二次开发指南
边缘计算网关二次开发指南
文档版本
01
发布日期
2018-06-01
华为技术有限公司
版权所有 © 华为技术有限公司 2018。 保留一切权利。
非经本公司书面许可,任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部,并不得以任何形式传
播。
商标声明
和其他华为商标均为华为技术有限公司的商标。
本文档提及的其他所有商标或注册商标,由各自的所有人拥有。
注意
您购买的产品、服务或特性等应受华为公司商业合同和条款的约束,本文档中描述的全部或部分产品、服务
或特性可能不在您的购买或使用范围之内。除非合同另有约定,华为公司对本文档内容不做任何明示或默示
的声明或保证。
由于产品版本升级或其他原因,本文档内容会不定期进行更新。除非另有约定,本文档仅作为使用指导,本
文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。
华为技术有限公司
地址:
网址:
深圳市龙岗区坂田华为总部办公楼 邮编:518129
http://www.huawei.com
客户服务邮箱:
support@huawei.com
客户服务电话: 4008302118
文档版本 01 (2018-06-01)
华为专有和保密信息
版权所有 © 华为技术有限公司
i
边缘计算网关二次开发指南
边缘计算网关二次开发指南
目 录
目 录
1 前 言 .............................................................................................................................................. 1
2 阅读指引 .......................................................................................................................................... 3
3 概述 .................................................................................................................................................. 4
3.1 边缘计算 ..................................................................................................................................................................... 4
3.2 边缘计算网关开放能力 ............................................................................................................................................. 5
3.3 端到端整体方案架构 ................................................................................................................................................. 6
4 边缘计算网关二次开发指南 ......................................................................................................... 7
4.1 二次开发须知 ............................................................................................................................................................. 7
4.2 开放平台概述 ............................................................................................................................................................. 7
4.2.1 边缘计算网关 .......................................................................................................................................................... 7
4.2.1.1 概述 ....................................................................................................................................................................... 7
4.2.1.2 架构 ....................................................................................................................................................................... 8
4.2.2 网络角度 .................................................................................................................................................................. 8
4.2.3 二次开发角度 .......................................................................................................................................................... 9
4.2.3.1 容器内物理接口访问 ......................................................................................................................................... 10
4.2.3.2 容器内 Json over Mqtt 接口说明(适用于 AR502E 系列) ............................................................................ 10
4.2.3.2.1 网关静态状态信息 .......................................................................................................................................... 10
4.2.3.2.2 网关动态状态信息 .......................................................................................................................................... 12
4.2.3.2.3 参数配置消息接口 .......................................................................................................................................... 15
4.2.3.2.4 事件消息接口 .................................................................................................................................................. 17
4.2.3.3 容器内 Json over Mqtt 接口说明(适用于 Hi-Grid T1 系列) ........................................................................ 18
4.2.3.3.1 接口方案 .......................................................................................................................................................... 18
4.2.3.3.2 数据访问 .......................................................................................................................................................... 22
4.2.3.3.3 事件通知 .......................................................................................................................................................... 40
4.2.3.3.4 开发指南 .......................................................................................................................................................... 45
4.2.4 容器环境介绍 ........................................................................................................................................................ 50
4.2.5 容器部署 ................................................................................................................................................................ 50
4.2.5.1 华为网络 OS 命令行方式(适用于 AR502E 系列) ....................................................................................... 51
4.2.5.1.1 创建容器 .......................................................................................................................................................... 51
4.2.5.1.2 启动容器 .......................................................................................................................................................... 51
文档版本 01 (2018-06-01)
华为专有和保密信息
版权所有 © 华为技术有限公司
ii
边缘计算网关二次开发指南
边缘计算网关二次开发指南
目 录
4.2.5.1.3 停止与卸载容器 .............................................................................................................................................. 51
4.2.5.1.4 查看容器状态 .................................................................................................................................................. 51
4.2.5.1.5 查看容器信息 .................................................................................................................................................. 51
4.2.5.1.6 查看容器配置 .................................................................................................................................................. 51
4.2.5.1.7 连接容器 .......................................................................................................................................................... 52
4.2.5.1.8 重定向到容器 .................................................................................................................................................. 52
4.2.5.2 Linux 命令行方式(适用于 Hi-Grid T1 系列) ................................................................................................ 52
4.2.5.2.1 配置 LXC 容器的自定义存储区 ..................................................................................................................... 52
4.2.5.2.2 配置通过 SSH 登录 LXC 容器 ....................................................................................................................... 53
4.2.5.2.3 配置 LXC 容器的基本功能 ............................................................................................................................. 54
4.2.5.2.4 配置容器内 APP 的基本功能 ......................................................................................................................... 54
4.2.5.2.5 检查配置结果 .................................................................................................................................................. 54
4.2.5.2.6 维护 LXC 容器 ................................................................................................................................................ 55
4.2.6 APP 环境搭建 ......................................................................................................................................................... 55
4.2.6.1 APP 编译环境 ...................................................................................................................................................... 55
4.2.6.1.1 Ubuntu 安装 ...................................................................................................................................................... 55
4.2.6.1.2 环境准备 .......................................................................................................................................................... 57
4.2.6.1.3 安装 docker ...................................................................................................................................................... 60
4.2.6.1.4 启动 docker ...................................................................................................................................................... 60
4.2.6.1.5 编译调测 .......................................................................................................................................................... 61
4.2.6.1.6 (可选)Samba 服务 ....................................................................................................................................... 62
4.2.6.2 APP 制作 .............................................................................................................................................................. 63
4.3 设备及容器的网络配置指导(适用于 AR502E 系列) ........................................................................................ 65
4.3.1 组网需求 ................................................................................................................................................................ 65
4.3.2 配置思路 ................................................................................................................................................................ 65
4.3.3 操作步骤 ................................................................................................................................................................ 65
4.3.3.1 创建容器并启动 ................................................................................................................................................. 65
4.3.3.2 配置设备为 Linux 容器系统分配 IP 地址 ......................................................................................................... 65
4.3.3.3 使用 SSH 方式登录到容器 ................................................................................................................................ 66
4.3.3.4 配置设备 3G/LTE 链路,使私网用户通过 3G/LTE 业务接入 Internet ........................................................... 67
4.3.3.5 (可选)配置 Linux 容器与私网用户 PC 互访 ............................................................................................... 68
4.3.4 容器资源查看 ........................................................................................................................................................ 68
4.3.5 容器内使用 RS232/RS485 接口 ............................................................................................................................ 70
4.4 设备及容器的网络配置指导(适用于 Hi-Grid T1 系列) .................................................................................... 71
4.4.1 组网需求 ................................................................................................................................................................ 71
4.4.2 配置思路 ................................................................................................................................................................ 71
4.4.3 操作步骤 ................................................................................................................................................................ 71
4.4.3.1 创建容器并启动 ................................................................................................................................................. 71
4.4.3.2 配置设备为 Linux 容器系统分配 IP 地址 ......................................................................................................... 71
文档版本 01 (2018-06-01)
华为专有和保密信息
版权所有 © 华为技术有限公司
iii
边缘计算网关二次开发指南
边缘计算网关二次开发指南
目 录
4.4.3.3 使用 SSH 方式登录到容器 ................................................................................................................................ 72
4.4.3.4 配置设备 3G/LTE 链路,使私网用户通过 3G/LTE 业务接入 Internet ........................................................... 73
4.4.4 容器资源查看 ........................................................................................................................................................ 74
4.5 开发指导 ................................................................................................................................................................... 75
4.5.1 开发步骤 ................................................................................................................................................................ 76
4.5.2 环境准备 ................................................................................................................................................................ 76
4.5.2.1 边缘计算网关路由器 ......................................................................................................................................... 76
4.5.2.1.1 边缘计算网关环境 .......................................................................................................................................... 76
4.5.2.1.2 连接配置线缆 .................................................................................................................................................. 76
4.5.2.1.3 产品手册 .......................................................................................................................................................... 77
4.5.2.2 交叉编译环境 ..................................................................................................................................................... 77
4.5.2.2.1 安装 Ubuntu ..................................................................................................................................................... 77
4.5.2.2.2 安装并启动 Docker .......................................................................................................................................... 79
4.5.2.2.3 在 Docker 中访问 Ubuntu 用户的资源 ........................................................................................................... 80
4.5.3 Hello world (example) ............................................................................................................................................. 80
4.5.3.1 二进制程序开发 ................................................................................................................................................. 80
4.5.3.2 程序编译 ............................................................................................................................................................. 81
4.5.3.3 程序安装与运行 ................................................................................................................................................. 82
4.5.4 Linux socket (example) ........................................................................................................................................... 82
4.5.4.1 二进制程序开发 ................................................................................................................................................. 82
4.5.4.2 程序编译 ............................................................................................................................................................. 86
4.5.4.3 程序安装 ............................................................................................................................................................. 87
文档版本 01 (2018-06-01)
华为专有和保密信息
版权所有 © 华为技术有限公司
iv
边缘计算网关二次开发指南
边缘计算网关二次开发指南
1 前 言
1 前 言
概述
读者对象
符号约定
手册目的是描述边缘计算网关架构以及如何在边缘计算网关上进行开发,指导客户完
成在边缘计算网关上的应用开发与运行。
第二章节为边缘计算网关系统架构介绍。
第三章节为边缘计算网关组网配置指导,交叉编译环境搭建指导与开发。
第四章节为边缘计算网关实际应用案例参考。
本文档(本指南)主要适用于以下工程师:
数据配置工程师
调测工程师
网络监控工程师
系统维护工程师
软件开发工程师
在本文中可能出现下列标志,它们所代表的含义如下。
符号
说明
用于警示紧急的危险情形,若不避免,将会导致人员死亡
或严重的人身伤害。
用于警示潜在的危险情形,若不避免,可能会导致人员死
亡或严重的人身伤害。
用于警示潜在的危险情形,若不避免,可能会导致中度或
轻微的人身伤害。
文档版本 01 (2018-06-01)
华为专有和保密信息
版权所有 © 华为技术有限公司
1
边缘计算网关二次开发指南
边缘计算网关二次开发指南
符号
说明
1 前 言
用于传递设备或环境安全警示信息,若不避免,可能会导
致设备损坏、数据丢失、设备性能降低或其它不可预知的
结果。
“注意”不涉及人身伤害。
用于突出重要/关键信息、最佳实践和小窍门等。
“说明”不是安全警示信息,不涉及人身、设备及环境伤
害信息。
修改记录
修改记录累积了每次文档更新的说明。最新版本的文档包含以前所有文档版本的更新
内容。
文档版本 01 (2018-01-31)
第一次正式发布。
文档版本 01 (2018-06-01)
华为专有和保密信息
版权所有 © 华为技术有限公司
2
边缘计算网关二次开发指南
边缘计算网关二次开发指南
2 阅读指引
2 阅读指引
本文阅读内容主要分为以下几类:
原理类
3.1 边缘计算
3.2 边缘计算网关开放能力
开放平台网络配置指导类
4.3 设备及容器的网络配置指导(适用于 AR502E 系列)
4.4 设备及容器的网络配置指导(适用于 Hi-Grid T1 系列)
指导开发人员进行二次开发指导操作类
4.2.3 二次开发角度
4.5 开发指导
文档版本 01 (2018-06-01)
华为专有和保密信息
版权所有 © 华为技术有限公司
3