Python 轻应用开发工具 HaaS-Studio

提前注意事项

如果开发者已经安装了 alios-studio 插件, 使用 HaaS-Studio 之前需要先卸载 alios-studio。

前言

HaaS Studio 集 C / JS / Python 三种语言开发于一体,实现了一个插件完成三种应用开发的功能。这里我们重点介绍一下 Python 轻应用操作。


下面我们详细介绍一下插件的原理,操作方式及新增特色功能。


haas-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 插件的安装。

haas-studio安装

1.3 按钮介绍

插件安装完成后,如果你当前的 VS Code 未打开任何工作台,则 VS Code 左下角的状态栏只会显示 新建工程 的图标:

haas-studio新建工程

如果你已经打开了某个工作台,则会在 VS Code 底部的状态栏显示如下一排按钮:

haas-studio状态栏

将鼠标悬浮在相关按钮即可显示该按钮的具体功能,各个按钮的功能如下:

haas-studio功能

从左到右依次为:

  1. 切换工程

  2. 语法检测 (仅用于语法检测,编译产物不是最终运行文件)

  3. 推送运行(打包文件并上传到设备并运行Python文件)

  4. 串口监控

  5. 清除

  6. 创建工程

1.4 详细操作

1.4.1 创建工程

  1. 点击 创建工程 按键会弹出 HaaS Studio 的欢迎页面,开发者选择 Python 轻应用开发 创建工程。

haas-studio 创建工程
  1. 根据创建工程向导,开发者输入/选择相关的信息即可。下面以创建 跑马灯 示例程序为例(python_gpio)演示工程创建:

注意事项

文件夹不要有中文,空格及其他异常字符。

haas-studio工程创建1 haas-studio工程创建2 haas-studio工程创建3 haas-studio工程创建4
  1. 工程创建完成后,插件会自动打开工作台文件夹,包含 python API接口文件,amp推送工具,solutions 示例工程等。

haas-studio API能力

D)同时我们也可以看到右侧的示例代码 ( 示例代码是针对 HaaS100 硬件设计的,如果想在 HaaS EDU K1 使用该示例代码,需要修改第7行的内容如下 ):

leds=("led_r", "led_g", "led_b")
haas-studio 示例工程代码
1.4.2 语法检测

点击 语法检测 按钮即可实现对工程的语法编译。 这里的编译仅实现对Python文件的语法检测,其生成的pyc文件也不是最终设备运行时候使用的文件


开发者可以直接跳过这一步操作。


1.4.3 推送执行

Python支持文件解析执行,点击 推送并执行 按钮实行 Python 文件上传到设备端。目前支持两种推送方式:

  • 串口本地更新

  • 云端在线更新


开发者点击 推送执行 按钮后,会弹出如下的窗口让开发者选择,接下来我们分别介绍两种更新方式。

haas-studio 更新选择

1.4.3.1 串口本地更新
haas-studio选择串口1 haas-studio 选择串口2

之后会弹出如下所示的提示框及输出信息。 开发者 需要重启设备 完成更新及自动运行操作。

haas-studio 弹窗提示1

更新完成后,会在 .vscode 文件下生成 update.json 文件,文件记录了当前烧录模式及串口配置信息。后续更新操作会使用该文件里面的内容作为配置。


如果开发者的串口名称或波特率发生变化,可以直接修改内容;或者删除 update.json 文件,下次更新的时候会根据用户的输入重新生成该文件。

haas-studio 更新配置文件
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

haas-studio在线更新1 haas-studio在线更新2dou

之后会弹出如下所示的提示框及输出信息,开发者 不需要需要重启设备,文件更新完成后会自动重启设备运行。

haas-studio 弹窗提示1

更新完成后,同样会在 .vscode 文件下生成 update.json 文件。开发者可以直接修改 mode 数值实现两种更新模式的切换:

  • 1 表示串口本地更新

  • 0 表示云端在线更新

2、文件推送

haas-studio可以推送任意格式的文件,文件会被推送到设备的 /data/pyamp 路径。开发者仅需要把需要推送的文件放置到当前工程下,重新点击 推送运行 即可。


下图是以 board.json 文件为例,目前使用的工程为 python_gpio 。开发者只需要把配置文件放到工程目录下即可实现推送。 board.json 文件将被推送到 data/pyamp 文件夹下。

haas-studio 文件推送

提前注意事项

文件会被推送到设备的 /data/pyamp 路径下。

3、申请token并绑定设备

开发者按照下图所示的信息,发送邮件到 aliosthings@service.aliyun.com ,申请token并绑定设备。 具体操作流程请参考 在线热更新

haas-studio token申请

4、其他

1、目前串口终端和本地文件上传使用相同的terminal页面,所以如果插件功能有任何异常,请先关闭当前terminal。关闭后请重新触发相关操作。

amp-python 终端关闭

2、如果在update的过程中遇到下面的提示,请重新插拔 USB 数据线并重新起送更新。

amp-python 更新异常

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')