Professional Documents
Culture Documents
V2.2.0 无
·· 1
深圳市启明云端科技有限公司 版本 V2.2.0
1 概述 ..................................................................................................................................... 4
1.1 编写目的.................................................................................................................... 4
1.2 术语和缩略语............................................................................................................. 4
1.2.1 术语 ................................................................................................................ 4
1.2.2 缩略语............................................................................................................. 4
1.3 参考文档.................................................................................................................... 4
2 软件概述 6
2.1 6
2.2 6
2.3 7
3 功能说明 7
3.1 8
3.2 工作区说明
3.3 工具栏
3.3.1 文件
保存
新建场景
删除选中场景
3.3.2 编辑
回退
重做
3.3.3 编译 ...............................................................................................................17
编译 ......................................................................................................................17
编译(在线预览)& 预览 .....................................................................................18
刷新 ......................................................................................................................18
下载源码 ...............................................................................................................18
下载 bin................................................................................................................19
3.3.4 布局 ...............................................................................................................19
设计器...................................................................................................................19
混合 ......................................................................................................................20
积木 ......................................................................................................................20
3.3.5 帮助 ...............................................................................................................21
4 控件(widgets)使用 ..........................................................................................................19
深圳市启明云端科技有限公司版权所有©2020 2
深圳市启明云端科技有限公司 版本 V2.2.0
4.1 页面布局...................................................................................................................22
4.1.1 页签切换 ........................................................................................................22
4.1.2 滑动面板 ........................................................................................................22
4.1.3 页面 .............................................................................................................23
4.2 简单显示...................................................................................................................24
4.2.1 文本 ...............................................................................................................24
4.2.2 图片 ...............................................................................................................25
4.2.3 圆环 ...............................................................................................................25
4.2.4 文本域............................................................................................................26
4.2.5 图表................................................................................................................26
4.3 动态显示....................................................................................................................27
4.3.1 滑块..............................................................................................................................27
4.3.2 复选框..........................................................................................................................28
4.3.3 开关..............................................................................................................................28
4.3.4 进度条 .........................................................................................................................29
4.3.5 下拉框..........................................................................................................................29
4.3.6 对话框 .........................................................................................................................30
4.3.7 预加载提示..................................................................................................................31
4.3.8 选择器..........................................................................................................................31
4.4 人机交互...................................................................................................................33
4.4.1 按钮 ...............................................................................................................33
4.4.2 列表 ...............................................................................................................34
4.4.3 折线 ...............................................................................................................36
4.5 功能控件...................................................................................................................36
4.5.1 日历 ...............................................................................................................36
4.5.2 仪表盘............................................................................................................37
4.5.3 LED.................................................................................................................38
4.5.4 时钟控件........................................................................................................38
5 烧录 ...................................................................................................................................40
5.1 ESP 32 烧录 ...................................................................................................40
5.2 Sigmastar SSD 201 烧录................................................................................42
6 实例 ...................................................................................................................................46
6.1 温控器......... .....................................................................................................47
6.2 磁能热水器 ........................................................................................................49
6.3 天气预报...........................................................................................................51
深圳市启明云端科技有限公司版权所有©2020 3
深圳市启明云端科技有限公司 版本 V2.2.0
1 概述
1.1
1.2
1.3
表 1 参考文档清单
名称 编号 作者 发布日期 备注
深圳市启明云端科技有限公司版权所有©2020 4
深圳市启明云端科技有限公司 版本 V2.2.0
2 软件概述
2.1
2.2
平台主要由如表 1 所示三部分组成。
GUI 编辑器
提供可视化的页面编辑功能,生成项目描述文件,包含页面(传统页面、Tab 子页
面、窗口页面),控件(暂支持 20 种控件),保存格式为 JSON 格式。
Blockly 逻辑编辑
2.3
访 问 网 站 :http://8ms.xyz/login。
深圳市启明云端科技有限公司 版本 V2.2.0
3 功能说明
3.1
说明:
访问本地址,首先确认是否有账号,如果没有,则请注册账号。
a) 单击“没有账号?去注册”。
公司及手机号。
c) 单击“注册”。
深圳市启明云端科技有限公司版权所有©2020 7
说明:
3. 单击右上角进入工作台,进入如图 4 所示 。
4. 单击“新建项目”,进入如图 5 所示。
深圳市启明云端科技有限公司版权所有©2020 8
a) 选择芯片项目。
b) 定义“项目名称”。
c) 选择“硬件”,硬件型号是根据项目类型匹配的。
d) 选择“主题”。
e) 描述项目内容。
f) 定义标签。
h ) 单击“确定”,项目创建成功。
如果需要编辑项目信息,则选择需要编辑的项目,单击项目右下角的“…”,单击“编辑
项目信息”即可。
如果需要添加权限成员,则选择需要编辑的项目,单击项目右下角的“…”,单击“权
限管理”即可。
如果需要删除项目,则选择需要删除的项目,单击项目右下角的“…”,单击“删除项目
”即可。
如果需要克隆项目,则选择需要克隆的项目,直接点击克隆或者单击项目右下角的
“…”,单击“克隆”即可。
深圳市启明云端科技有限公司 版本 V2.2.0
3.2
每个项目都包括八大工作区,如图
包括对文件、编辑、编译、布局 文件
与 帮助。
保存
保存并复制
新建场景
删除选中场景
导出项目
1 导入项目
上传自定义代码
资源
工具栏
版本
编辑
回退
重做
编译
编译
编译(在线预览)
预览
刷新
下载源码
深圳市启明云端科技有限公司版权所有©2020 10
深圳市启明云端科技有限公司 版本 V2.2.0
开发板运行
下载bin
布局
设计器
混合
积木
布局
文档中心
入门指南
视频案例
关于
2 对当前工程实现保存、回退、重做 对齐包括:
快捷按钮 、格式刷、对齐、编译、下载和对 左对齐
控制编辑区进行缩放。 水平居中对齐
右对齐
上对齐
垂直居中对齐
下对齐
3 默认是 main_screen,根据项目 新建场景的操作请参见 “新建场景”
场景 情 况还可以新建场景。 。
4 默认的主题有深色模式与浅色模
主题 式,根据项目情况还可以新建主
题。
6 画布尺寸对应屏幕尺寸,可以通 图片控件不支持设置大小,控件大小
控件编辑区 过拖动控件调整位置,以及拖动 与 图片大小一致。
边框调整大小。
7 选中控件或者页面右侧会有对应 部分控件支持事件逻辑
控件属性区 控件或者场景的基础属性。
8 提供发布、分享和评论功能。
项目发布分享区
深圳市启明云端科技有限公司版权所有©2020 11
深圳市启明云端科技有限公司 版本 V2.2.0
说明 :每个控件有不同的属性,以“label”控件为例展示控件的基本属性,下图所示。
说明:id 为该控件的唯一标识,在整个工程属于唯一。其他的属性可以调整控件的实际效果。
3.3
保存
保存设计的项目,既可以通过工具栏“文件 ”的“保存”,也可以通过快捷按
钮 实 现。当设计项目后没有执 行编译, 单 击“保存”时 , 会首先执 行一次项目
编译。
保存并复制
暂未开放。
新建场景
新建场景既可 以通过工具栏中“文件”的“新建场景”实现,也可以通过“场
景”区域的“新建场景 ”实现。实现操 作为,单击场景区域的“新建场景 ”,在如
图 8 所 示 输 入场景名称, 单击“确定 ”。
深圳市启明云端科技有限公司版权所有©2020 12
深圳市启明云端科技有限公司 版本 V2.2.0
1、场景类型:
场景。
对话框。
标签页。
容器。
2、创建方式:
静态建设
动态建设
3、背景颜色:
删除选中场景
深圳市启明云端科技有限公司版权所有©2020 13
深圳市启明云端科技有限公司 版本 V2.2.0
1、先将编译好的工程项目导出(导出的压缩包不可修改,否则会导致无法导入)。
2、新建一个工程项目,点击导入项目,选择导出的压缩包即可。
上传自定义代码
1、先创建好像加入的文件,如下图所示。
2、点击上传自定义代码,选择相应的文件(添加的文件可在“资源”查看)。
3、添加头文件和函数调用,如下图所示。
说明:sigmastar上传的自定义代码需存于custom目录中(例:#include “custom/test.h”)。
版本(此功能后续只对企业版开放)
1、点击版本跳出版本创建图框,如下图所示。
深圳市启明云端科技有限公司版权所有©2020 14
深圳市启明云端科技有限公司 版本 V2.2.0
2、给工程版本命名后点击创建版本即可(可对创建的版本工程删除和下载导入)。
回退
暂未开放。
重做
暂未开放。
深圳市启明云端科技有限公司版权所有©2020 15
深圳市启明云端科技有限公司 版本 V2.2.0
编译
深圳市启明云端科技有限公司版权所有©2020 16
编译(在线预览)& 预览
点击编译(在线预览),编译成功后即可预览
刷新
点击刷新。
下载源码
深圳市启明云端科技有限公司版权所有©2020 17
深圳市启明云端科技有限公司 版本 V2.2.0
下载 bin
设计器
深圳市启明云端科技有限公司版权所有©2020 18
深圳市启明云端科技有限公司 版本 V2.2.0
混合
积木
说明:
深圳市启明云端科技有限公司版权所有©2020 19
深圳市启明云端科技有限公司 版本 V2.2.0
点击任意选项可跳转到8ms文档。
深圳市启明云端科技有限公司版权所有©2020 20
深圳市启明云端科技有限公司 版本 V2.2.0
4.1
1.创建滑动面板
注:
一定要给滑动面板添加场景。
深圳市启明云端科技有限公司版权所有©2020 21
深圳市启明云端科技有限公司 版本 V2.2.0
单击控件属性区域下拉,接着创建 3 个场景,分别作为滑动面板的左中右场
景添 加 到滑动面 板的内容里。
页面,可添加容器,内部可滑动。
2、设置属性效果
创建好对应的场景,设置页面属性和添加容器。
4.2
文 本 主 要用于显 示开发者需要表达的内容。
1. 创建文本
从左侧控件栏 点击文本控件生成控件,就创建好 了一个默认的文本。如图 18
所示。
2. 设置文本
单击 控件属性区 域属性的内容 下拉按钮,可以设置文 本的内容及外 观。根据
工 程 需 要设置广本,其设置后的实际效果如 图19所示。
3. 设置行为
在积木界面中,可使用UI控件->基础 设置控件可点击积木使文本控件可点击,在
事件流程->UI中选择添加的事件即可。
深圳市启明云端科技有限公司 版本 V2.2.0
1. 创建&添加图片
注意:
a.选取的图片像素不大于当前屏幕。
b .建议设置图片的尺寸和实际大小一致,因为烧录到硬件里的图片尺寸和实际大小一致。
c.图片可在资源库进行增删选择操作。
从左侧控件栏 点击图片控件生成控件,然后单击右侧内容->文件,添加图片即 可。
2.设置行为
可在属性内容中启用点击行为,进入积木界面在事件流程->UI中选择添加的事件即
可。
1.创建圆环
从 控 件 栏点击圆 环控件生成控件, 即可创建如 图 21 所 示 的圆环。
深圳市启明云端科技有限公司版权所有©2020 24
深圳市启明云端科技有限公司 版本 V2.2.0
2.设置圆环
1.创建文本域创建
从 左 侧 控件栏点击文本域控件生成控件, 即可 创建好默认文本域。
2.设置文本域设置
4.2.5 图表
1.创建列表
从 控 件 栏点击列表控件生成控件, 即可创建列表。
深圳市启明云端科技有限公司版权所有©2020 25
深圳市启明云端科技有限公司 版本 V2.2.0
2. 设置列表
单击控件属性 区域内容下拉, 设置如下 图 所示列表的颜色大小,添加项和
行等。
3、预览效果:
说明:创建图表时,至少添加一项一行,不然会导致编译不过。
4.3
深圳市启明云端科技有限公司版权所有©2020 26
深圳市启明云端科技有限公司 版本 V2.2.0
1. 创建滑块
从左侧控件栏 点击滑块控件生成控件,就创建好 了一个默认的滑块。如图 23 所
示 为 一个默认 滑块。
2. 设置滑块
单 击 控 件属性区 域内容下拉, 设置滑块文案相关 的初始值和样式。
1. 创建复选框
从左侧控件栏 点击复选框控件生成控件 ,即可创建一个如 图 24 所示的复选 框
。
2. 设置复选框
单 击 控 件属性区 域内容下拉, 设置复选框文本相 关属性。
开 关 用 来打开或 关闭事物。
1. 开关的创建
从左侧控件栏 点击开关控件生成控件, 即可 创建一个如 图 25 所 示的开关。
深圳市启明云端科技有限公司版权所有©2020 27
深圳市启明云端科技有限公司 版本 V2.2.0
2. 开关设置
单 击 控 件属性区 域内容下拉, 设置开关的默认值 和实际样式。
2. 设置进度条
1.创建下拉框
从 左 侧 控件栏点击下拉控件生成控件, 创建如图 27 所 示 的下拉框 。
深圳市启明云端科技有限公司版权所有©2020 28
深圳市启明云端科技有限公司 版本 V2.2.0
2.设置下拉框
单击控件属性 区域内容下拉添加选项, 如 图 28 所示为添加了选项 的下拉框。
1.创建对话框
2.设置对话框效果
单 击 控 件属性区 域内容下拉, 设置对话框的文本 样式及对话框显示效果。
3.设置对话框单击行为
通 过 代 码块程序 实现对话框单击行为。
深圳市启明云端科技有限公司版权所有©2020 29
深圳市启明云端科技有限公司 版本 V2.2.0
1.创建预加载提示
2.设置预加载提示实际效果
单 击 控 件属性区 域内容下拉, 设置如 图30所示预加载提示的相关样式。
1.创建选器建
深圳市启明云端科技有限公司版权所有©2020 30
2.设置选择器基本属性
控件 属性的设置 选择器的初始 值、可见行 数、文本相 关和单击行为 , 单击行
为 通 过 编写代码 块实现。
3.选中主体样式
深圳市启明云端科技有限公司版权所有©2020 31
深圳市启明云端科技有限公司 版本 V2.2.0
4.4
深圳市启明云端科技有限公司版权所有©2020 32
深圳市启明云端科技有限公司 版本 V2.2.0
2. 设置按钮内容
注意:
添加的图片像素不大于当前屏幕。按钮设置了图片,文字就没用了。
单击控件属性区域内容下拉,可以修改按 钮的内容和内容的实际样式,以及 给
按钮添加图片 。
3. 设置行为
设置行为需添加积木块的实现,点击积木界面->流程事件->UI即可,可直接使用已搭
建好的积木或者使用自定义积木。也可使用UI控件->按钮中的积木操作控件。
4. 状态样式设置
按钮处于不同状 态,可以有不同的样式,通过单击右侧样式下拉,实现不同 按
钮的状态设置相应的样式。
1. 创建列表
从左 侧控件栏点击列表控件生成控件, 单击 控件属性区 域内容下拉, 添加一
个 如图35所示的列表。
深圳市启明云端科技有限公司版权所有©2020 33
深圳市启明云端科技有限公司 版本 V2.2.0
2.属性设置
可设置文字大小、颜色,背景颜色、不透明度等,根据需求添加行,每行可
添加文本和图片文件。
3. 单击事件
进入积木界面,在流程/事件->UI中添加 列表框被点击事件 实现,还可添
加UI控件->列表框中选择获取文本积木。
深圳市启明云端科技有限公司版权所有©2020 34
深圳市启明云端科技有限公司 版本 V2.2.0
1.创建折线
注意:
添加的坐标需要两个及以上,且添加的坐标点要在屏幕里,否则看不到线。
从左侧控件栏 点击折线控件生成控件 ,再给折线添加坐标点 ,如 图36所示。
2.设置折线实际样式
单 击 控 件属性区 域内容下拉, 设置线条的颜色和宽度。
1.创建日历
从 控 件 栏点击日 历控件生成控件, 即可创建如图 37 所 示 默认的日 历 。
深圳市启明云端科技有限公司版权所有©2020 35
2.设置日历当前日期
单 击 控 件属性区 域内容下拉, 设置年月日的值即 可。
1.创建仪表盘
从左侧控件栏点击仪表盘控件生成控件,即可就创建一个如图38所示的仪表盘。
2.设置仪表盘
深圳市启明云端科技有限公司版权所有©2020 36
深圳市启明云端科技有限公司 版本 V2.2.0
1. 创建 LED
从左侧控件栏点击LED 控 件 生成控件, 即 可 创 建 好 一 个如图 40 所示
LED 。
2.设置 LED
单击控件属性 区域基本下拉,设置
1、创建时钟控件
从控件栏点击时钟控件即可在编辑区生成时钟控件。
2.设置 时钟。
单击控件属性 区域基本下拉,设置时钟控件性相对应的属性,如下图所示。
说明: 1、添加时钟背景图和时针、分针和秒针。
2、根据图片尺寸大小可适当的对图片进行偏移。
3、可设置时钟初始时间和运动方式 (平滑和间断)。
深圳市启明云端科技有限公司 版本 V2.2.0
5 烧录
5.1
烧 录 固 件步骤:
1. 保存功能已完成的项目。
2. 编译项目。
下载固件,并按照编译地址烧录固件。
4. 解压下载的固件包 xxx.zip,其包含文件:
深圳市启明云端科技有限公司版权所有©2020 39
深圳市启明云端科技有限公司 版本 V2.2.0
4. 打开 esp_download_tool 烧录固件。
(说明:打开该工具时,需选择对应的芯片型号,c3的
bootloader.bin 烧 录地 址为0x00 )
深圳市启明云端科技有限公司 版本 V2.2.0
5.2
烧 录 固 件步骤:
1. 保存功能已完成的项目。
2. 编译项目。
3. 单击 “下载 bin”,下载如所示左下角固件。
45 bin
打开固件所在文件夹,如图
46
打开 固件保存路径,并复制 固件 DEMO 到烧录工具安装目录下 的 “ Tftp32”,
替 换 目 标中的文 件, 如图 47 所示。
47
6. 打开 Xshell,并新建会话,如创建“test”会话,同时为新建会话命名“名称”、
选择“连接协议”、选择“主机地址”,如“192.168.1.1”及端口号“22”,如图48所
示。
48
深圳市启明云端科技有限公司版权所有©2020 42
49 所示,选择已新建会话,进入 Xshell。
49 Xshell
8. 输入命令“ls”,查询文件。
9. 输入命令 “rm -f demo”,删除之前开板已有的 demo。
深圳市启明云端科技有限公司版权所有©2020 43
11. 输入命令 “chmod +x demo”、“./demo” ,确认是否烧录成功, 成功的标志
如 图 51 所示。
51
字体文件链接:http://res.8ms.xyz/8ms/8ms.ttf
深圳市启明云端科技有限公司 版本 V2.2.0
6 实例
6.1 温控器
52
1、设置创建工程,硬件类型选择的是esp32_480*320。
设置背景:
53
从左侧控件栏点击图片控件生成控件,点击内容-> 文 件,添加背景图片,将控件
位置设置为x = 0 ,y = 0。
注:是先创建的控件会垫底。
深圳市启明云端科技有限公司版权所有©2020 46
深圳市启明云端科技有限公司 版本 V2.2.0
2、创建文本控件并文本内容
54
3、添加图片控件并添加图片
55
4、效果展示
深圳市启明云端科技有限公司版权所有©2020 47
深圳市启明云端科技有限公司 版本 V2.2.0
6.2
1.设置当前屏幕的背景色为黑色。
2.创建图片控件并添加图片 。
深圳市启明云端科技有限公司版权所有©2020 48
说明:
建议图片的尺寸设置成和实际大小一致,因为烧录到硬件里的图片尺寸和实际大小一致。
创建文本控件并设置实际效果。
从左侧控件栏点击文本控件生成控件,单 击控件属性区域内容下拉 ,设置文 本
的 实 际效果。 其他文本控件, 重复步骤。
4.创建按钮控件并设置实际效果。
深圳市启明云端科技有限公司版权所有©2020 49
5.烧录到硬件里的效果展示。
6.3
新建项目,命名为:“天气预报”,单击确定后进入工作区。
2.拖放文本框在控件编辑区域,根据项目,创建了命名区,数据区和刷新按钮。具体可按需求修改。
设置完成如图 67 所示。
67
深圳市启明云端科技有限公司版权所有©2020 50
3.切换到积木编程环节,实现积木编程。
e) 单击“UI控件->文本框”,选择“以特定格式设置label”。
f) 设置label:单击左上角添加“函数输入”。
g) 单击“基本功能/编解码”。选择“从json中获取字符串数据”
h) 单击“流程/事件-通信/IOT”,选择“http 响应回调”。
j) 单击“基本功能/编解码”, 选择“按序号获取json对象”,填入“0”。
k) 单击“基本功能/编解码”,选择“获取json对象”,填入“date”。
e->k 步骤执行多两次。
l)
m) 单击“流程/事件-UI”,选择“当按钮发生”。
深圳市启明云端科技有限公司版权所有©2020 51
深圳市启 明云端科技有限公司 版本 V2.2.0
p) 设置 http 网页地址为:api.8ms.xyz,设置端口号为:80;设置路径为/weather/ 。
4.单击“保存”& “编译”。
5.单击“下载bin”。
6.烧录。
a) 选择乐鑫官方 Download Tool。
b) 选择相应的bin 文件及地址
c) 设置相应的参数:“COM 口”、“BAUD 率”。
d) 单击“ERASE”。
e) 单击“START”。
配置完成的界面如下图所示
深圳市启明云端科技有限公司版权所有©2020 52
效果展示: