这是最新(主)开发分支的文档。如果您正在查找以前版本的文档,使用左侧的下拉菜单选择所需的版本。

快速入门

本文档旨在指导用户搭建硬件开发的软件环境,通过一个简单的示例展示如何使用 WM IoT SDK 配置菜单,并编译、下载固件至开发板等步骤。

概述

WM IoT SDK 对 SoC 芯片支持以下功能:

soc 采用 40 nm 工艺制程,具有最佳的功耗性能、射频性能、稳定性、通用性和可靠性,适用于各种应用场景和不同功耗需求。

WinnerMicro 为用户提供完整的软、硬件资源,进行硬件设备的开发。其中,WM IoT SDK 旨在协助用户快速开发物联网 (IoT) 应用,可满足用户对 Wi-Fi、蓝牙、低功耗等方面的要求。

准备工作

硬件

  • 一款开发板

  • USB 数据线

  • 电脑(Windows、Linux 或 macOS)

软件

如需使用 WM IoT SDK,请安装以下软件:

  • 设置 工具链,用于编译固件代码;

  • 编译构建 工具 —— CMake 和 Ninja 编译构建工具,用于编译用户 应用程序

  • 获取 WM IoT SDK 软件开发框架。

搭建编译环境

目前提供两种编译环境:

  • 命令行编译( SHELL 编译)

  • 集成工具编译( IDE 编译)

提示

由于不同用户使用的操作系统可能不同,于是我们针对市面上常用的几种操作系统(Windows 系统Linux 系统macOS 系统)分别提供了搭建环境的步骤,用户可以根据自己的实际情况任选其一即可。

搭建命令行编译环境

使用 IDE 搭建编译环境

编译第一个工程

开始创建工程

如果已经安装好 WM IoT SDK,且没有使用集成开发环境 (IDE),请在命令提示行中,开始编译工程。

cd examples
cd hello_world

wm.py build

烧录到设备

运行以下命令可以进行烧录,PORT 是当前开发板连接的串口。

wm.py flash -p PORT

其中的 PORT 需替换为系统中实际串口的名字(比如 Windows 下的 COM1,Linux 下的 /dev/ttyUSB0,或者 macOS 下的 /dev/cu.usbserial-1401)。 如果省略 -p 选项,wm.py flash 会尝试使用第一个可用的串口进行烧写。 如果想擦除整块 flash 然后重新烧写,请运行: wm.py flash -e -p PORT

观察串口运行结果

之后打开您常用的串口工具,选择开发板 UART0 口连接到的串口,按下复位键即可观察到运行结果。

卸载编译环境

如果您是 Windows 用户,并且使用的是 WM IoT SDK 集成包 搭建的编译环境,则可以直接运行卸载向导来卸载 WM IoT SDK 编译环境。

如果您使用的是 VS Code 搭建的编译环境,可以在 VS Code 左侧的插件列表里选择已安装的 WM IoT SDK 插件,在跳转的页面中就有卸载选项,点击卸载即可卸载已安装的编译环境。