命令行工具

运行在Mac或Windows电脑上的命令行工具主要是用来推送设备应用脚本到设备端，拥有一套完整的命令，可以完成如设备应用脚本更新、运维服务、日志服务等。

工具包介绍

命令行工具文件目录如下：

 amp-clitools
 ├── dist
 │   ├── amp            # 命令行工具
 │   ├── app            # 应用脚本
 │   │   ├── app.json
 │   └── app.js
 │   └── bindings.node  # 本地更新库
 └── engines            # 引擎
     ├── quickjs

打开app.js，这里就运行了我们的业务代码，默认定时打印系统信息。

命令介绍

名称

$ amp

IoT轻应用命令行工具可以对设备进行热更新操作，支持本地热更新和远程热更新。

命令列表

命令		说明	示例
login		命令行登录	amp login <your-token>
device list		列出绑定的设备	amp device list
put		推送应用代码到设备端
（在线热更新）	amp put <app-dir> [device-name] -m <mode> -e <encode>
seriallist		列出电脑的所有串口	amp seriallist
serialput		推送应用代码到设备端
（本地热更新）	amp serialput <app-dir> <port> -m <mode> -e <encode> -b <baudrate>
version		版本号	amp --version
help		帮助	amp --help

命令详解

login - 登录

命令参数
amp login <your-token>
说明
使用远程热更新时，需要使用该命令绑定用户token，第一次使用远程热更新时需要绑定token，之后使用不再需要输入token。远程热更新详细说明见 热更新说明 。
使用本地热更新时，无需绑定用户token。

token请发送邮件至aliosthings@service.aliyun.com（点击创建邮件模板）。

命令示例

// macos
$ amp login b8805cfefe8b2dd2f069e638a0162d0e

// windows
c:\tooldir> .\amp.exe login b8805cfefe8b2dd2f069e638a0162d0e

device list - 列出已绑定设备

命令参数
amp device list
说明
列出您的账号绑定的设备。
命令示例

// macos
$ amp device list

// windows
c:\tooldir> .\amp.exe device list

put - 在线热更新

命令参数
amp put <app-dir> <device-name> -m <mode> -e <encode>
说明
远程推送轻应用到设备。

• mode：模式，可选项 [quickjs | duktape]，默认duktape
• encode：编译，可选项 [0 | 1]，默认0不编译

该命令会消耗网络流量，推送应用到蜂窝模组时请按需使用。

命令示例

// macos
$ amp put ./app 8675*******3456 -m duktape -e 0

// windows
c:\tooldir> .\amp.exe put c:\Users\app 8675*******3456 -m duktape -e 0

seriallist - 列出电脑串口

命令参数
amp seriallist
说明
列出电脑上的所有串口。

命令示例

// macos
$ amp seriallist

// windows
c:\tooldir> .\amp.exe seriallist

serialput - 本地热更新

命令参数
amp serialput <app-dir> <port> -m <mode> -e <encode> -b <baudrate>
说明
通过串口推送轻应用到设备（本地更新）。

• mode：模式，可选项 [quickjs | duktape]，默认duktape
• encode：编译，可选项 [0 | 1]，默认0不编译
• baudrate：波特率，默认115200

命令示例

// macos
$ amp serialput ./app /dev/tty.usb*

// windows
c:\tooldir> .\amp.exe serialput c:\Users\app COMX

version - 查看版本号

// macos
$ ./amp --version

// windows
c:\tooldir> .\amp.exe --version

// output:
1.0.3

help - 帮助

// macos
$ ./amp --help

// windows
c:\tooldir> .\amp.exe --help

Usage: amp [options]
AliOS Things Mini Program PC CLI tool
Options:
 -V, --version                          output the version number
 -h, --help                             output usage information
Commands:
 login <token>                          login
 device list                            list bind devices
 put [options] <filepath> <deviceName>  upload file to device
 seriallist                             list serial port
 serialput [options] <filepath> <port>  put file to device via serial port