这个页面的 最新开发版本 可能比这个发布的 0.4.0 版本新。

快速入门

本文档旨在指导用户搭建硬件开发的软件环境,通过一个简单的示例展示如何使用 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 编译环境。

如果您使用的是 Eclipse 搭建的编译环境,可以在 Eclipse 中点击 Help,找到 Install New Software 选项,选择 already installed 选项,选中已经安装的插件,再点击卸载,即可卸载安装的编译环境。

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