前言
HaaS Studio 集 C / JS / Python 三种语言开发于一体,实现了一个插件完成三种应用开发的功能。这里我们重点介绍一下 Python 轻应用操作。
提前注意事项
如果开发者已经安装了 alios-studio 插件, 使用 HaaS-Studio 之前需要先卸载 alios-studio。
下面我们详细介绍一下插件的原理,操作方式及新增特色功能。
1、操作介绍
1.1 安装VS Code
开发者首先需要到微软的官方网站上下载 VS Code 安装包并进行安装,VS Code安装包要求不低于版本 1.57。
VS Code安装包下载网站为: https://code.visualstudio.com/
系统推荐
推荐 Windows 系统版本为 win10, MacOS 版本不低于 10.15。
1.2 安装插件
安装完 VS Code 之后,开发者按照下图的指示完成 haas-studio 插件的安装。
1.3 按钮介绍
插件安装完成后,如果你当前的 VS Code 未打开任何工作台,则 VS Code 左下角的状态栏只会显示 新建工程 的图标:
如果你已经打开了某个工作台,则会在 VS Code 底部的状态栏显示如下一排按钮:
将鼠标悬浮在相关按钮即可显示该按钮的具体功能,各个按钮的功能如下:
从左到右依次为:
- 切换工程
- 语法检测 (仅用于语法检测,编译产物不是最终运行文件)
- 推送运行(打包文件并上传到设备并运行Python文件)
- 串口监控
- 清除
- 创建工程
1.4 详细操作
1.4.1 创建工程
- 点击
创建工程
按键会弹出 HaaS Studio 的欢迎页面,开发者选择Python轻应用开发
创建工程。
- 根据创建工程向导,开发者输入/选择相关的信息即可。下面以创建 跑马灯 示例程序为例(python_gpio)演示工程创建:
注意事项
文件夹不要有中文,空格及其他异常字符。
- 工程创建完成后,插件会自动打开工作台文件夹,包含 python API接口文件,amp推送工具,solutions 示例工程等。
D)同时我们也可以看到右侧的示例代码 ( 示例代码是针对 HaaS100 硬件设计的,如果想在 HaaS EDU K1 使用该示例代码,需要修改第7行的内容如下 ):
leds=("led_r", "led_g", "led_b")
1.4.2 语法检测
点击 语法检测
按钮即可实现对工程的语法编译。 这里的编译仅实现对Python文件的语法检测,其生成的pyc文件也不是最终设备运行时候使用的文件。
开发者可以直接跳过这一步操作。
1.4.3 推送执行
Python支持文件解析执行,点击 推送并执行
按钮实行 Python 文件上传到设备端。目前支持两种推送方式:
- 串口本地更新
- 云端在线更新
开发者点击 推送执行
按钮后,会弹出如下的窗口让开发者选择,接下来我们分别介绍两种更新方式。
1.4.3.1 串口本地更新
之后会弹出如下所示的提示框及输出信息。 开发者 需要重启设备 完成更新及自动运行操作。
更新完成后,会在 .vscode
文件下生成 update.json 文件,文件记录了当前烧录模式及串口配置信息。后续更新操作会使用该文件里面的内容作为配置。
如果开发者的串口名称或波特率发生变化,可以直接修改内容;或者删除 update.json 文件,下次更新的时候会根据用户的输入重新生成该文件。
1.4.3.2 云端在线更新
开发者首先需要获取设备的 devicename, 并参考 3、申请token并绑定设备 申请token并绑定设备。
在获取kv值之前开发者需要连接网络。在命令行 CLI 模式下通过下面的命令连接 WiFi:
python /data/python-apps/wifi/main.py wifi_ssid wifi_password
联网成功后,输入下面的命令得到 devicename
kv get _amp_internal_devicename
命令执行后可以得到下面的输出:
value is haas_xxxxxxxxxxxxxxx
之后会弹出如下所示的提示框及输出信息,开发者 不需要需要重启设备,文件更新完成后会自动重启设备运行。
更新完成后,同样会在 .vscode
文件下生成 update.json 文件。开发者可以直接修改 mode 数值实现两种更新模式的切换:
- 1 表示串口本地更新
- 0 表示云端在线更新
2、文件推送
haas-studio可以推送任意格式的文件,文件会被推送到设备的 /data/pyamp 路径。开发者仅需要把需要推送的文件放置到当前工程下,重新点击 推送运行
即可。
下图是以 board.json 文件为例,目前使用的工程为 python_gpio 。开发者只需要把配置文件放到工程目录下即可实现推送。 board.json 文件将被推送到 data/pyamp 文件夹下。
提前注意事项
文件会被推送到设备的 /data/pyamp 路径下。
3、申请token并绑定设备
开发者按照下图所示的信息,发送邮件到 aliosthings@service.aliyun.com ,申请token并绑定设备。 具体操作流程请参考 在线热更新
4、其他
- 目前串口终端和本地文件上传使用相同的terminal页面,所以如果插件功能有任何异常,请先关闭当前terminal。关闭后请重新触发相关操作。
- 如果在update的过程中遇到下面的提示,请重新插拔 USB 数据线并重新起送更新。
3、如果用户遇到下面的提示信息,则表明当前已经有一个 Python 引擎在运行中。
Python is running, cannot start another engine
可以通过两种方式解决这个问题
- 在 CLI 模式下重命名 /data/pyamp/main.py 文件,譬如:
mv /data/pyamp/main.py /data/pyamp/main.py-bak
或者重新推送一个空的 main.py 文件到系统上,空的 main.py 文件中内容如下:
# -*- coding: UTF-8 -*-if__name__=='__main__': print('Hello Python')