AliGenie Studio README

AliGenie 开发 官方 IDE 插件

1. 主要特性

支持 Windows + wsl2 下芯片解决方案

• 工程向导
  1. 支持直接使用公版发布分支代码
  2. 支持使用自有repo仓库
• 代码更新
• 一键编译
• 一键烧录
• 串口通信

2. 环境依赖

IDE在Windows环境下工作，是依托wsl2虚拟机和python环境。所以在正式使用之前，需要先安装好相关工具。

• wsl2

参考官方说明文档进行安装：https://learn.microsoft.com/zh-cn/windows/wsl/install-manual

注意步骤6，选择安装Ubuntu 18.04 LTS。wsl2环境安装成功后，可以使用wsl -l -v命令确认是否安装成功，如下所示：可以看到，我们已经安装了Ubuntu 18.04，且wsl版本为wsl2

>wsl -l -v
  NAME            STATE           VERSION
* Ubuntu-18.04       Stopped          2

• python

串口工具功能依赖python和python的pyserial软件包，python2和python3均可，使用串口功能前请先手动下载安装好。可以使用pip list命令查看python软件包列表。如下所示，可以看到，我们已经安装了pyserial的3.4版本

> pip list
Package           Version
--------------      ---------
 backports-abc       0.5
 bitstring          3.1.9
 certifi           2021.10.8
 cffi             1.15.0
 pyserial          3.4

• ssh key

1. 查看是否配置了用户名和邮箱

    git config --global --list

2. 如果没有配置则

    git config --global user.name "你的用户名"
    git config --global user.email "你的邮箱" 

3. 生成ssh key (wsl user环境下)

    ssh-keygen

执行后所有二次询问保持默认，一路回车执行完即可。

4. 阿里云配置ssh key

wsl用户目录下 ~/.ssh/id_rsa.pub 公钥录入阿里云代码平台。点击右上角个人头像，选择个人设置-SSH公钥，添加公钥。

3. 操作说明

3.1 自动安装依赖工具

首次打开插件，需要安装一些依赖工具(包含wsl环境下的git repo python gcc等必要工具)

• 首次打开右下角会提示“需要安装基础工具”,

点击“是”后开始自动安装

• 等待几分钟后，终端会提示“安装成功，可以使用了”。

• 安装插件后请重启下vscode让插件生效。

3.2 创建工程向导

创建工程会自动拉取TG6000A/TG6210A代码，并配置好相关编译选项。

3.2.1 创建项目

• 点击“快速开始”后点击“创建项目”

3.2.2 填写相关信息后点击“立即创建”

• 项目名字 给这个项目起个名字
• 工作区路径 工作区路径即为源码路径(注：此目录名称必须为连续的英文字符)
• 芯片类型 目前支持TG6000A和TG6210A
• release版本 选择芯片类型后自动同步云端现有版本信息，也可以选择“自有工程”以输入自己的仓库地址
• 自有repo仓库地址 当release版本选择自有工程，会出现该选项用户输入自有工程的地址

3.2.3 同步代码

• 确认好工程信息后点击确认开始自动同步代码

• 等待一段时间后会提示代码已经同步成功

3.3 开发及调试

3.3.1 编译

点击“编译”按钮后，开始编译固件，一段时间后生成产物

3.3.2 同步代码

点击“同步代码”从服务端更新代码，和本地代码如有冲突，请手动解决

3.3.3 一键烧录 (目前仅支持TG6000A)

点击“烧录”后选择串口号开始烧录,（设备需要重新上电一下进入烧录模式）

3.3.4 串口

可打印硬件串口输出的log，支持双向，点击“串口”后选择串口号和波特率后开始通信

1. 选择端口

2. 选择波特率

3. 成功通信