# IoT Pi Pro 快速入门

感谢您选购了 IoT Pi Pro，本《快速入门》将带领您熟悉 IoT Pi Pro 的基本使用。

# IoT Pi Pro 介绍

IoT Pi Pro 是一块功能丰富、性能强劲的物联网开发板，开发者们通过 IoT Pi Pro 除了可以掌握 MS-RTOS 的开发技能外，还可以学习到最前瞻的物联网开发技术和 GUI 图形界面技术。

IoT Pi Pro 采用了主频高达 400MHz 的 Cortex-M7 处理器，拥有高达 128KB+8MB 的 FLASH 储存空间和 1MB 的 RAM 空间，有效保证流畅运行 MS-RTOS 和多个应用。IoT Pi Pro 板载了 EEPROM 和 SD 卡插座，可用于储存数据和与 PC 机交互文件。而板载的 Wi-Fi 模块，则能轻松实现 Wi-Fi 无线联网功能。与 IoT Pi 相比，IoT Pi Pro 增加了一块显示效果出色、触摸灵敏的显示屏，可满足高端智能设备的人机交互需求。此外，IoT Pi Pro 兼容树莓派的扩展接口，可以方便地与各种外围模块相连，大大提升了可玩性。

# IoT Pi Pro 开箱

拆开 IoT Pi Pro 的快递包装后，您将看到 IoT Pi Pro 的包装盒：

包装盒上的标签纸注明了 IoT Pi Pro 的工作温度和电源类型，为了硬件安全，请确保通过 USB 电源线或 5V 电源适配器为 IoT Pi Pro 供应 5V 电源，标签纸上还有一个二维码，该二维码指向了 IoT Pi Pro，可用手机扫一扫快速进入 IoT Pi Pro 产品详情页面和本快速入门指南。

打开包装盒后，您将看到有两个袋子：

其中，透明塑料袋子装的是 IoT Pi Pro 的配件，黑色防静电袋子装的是 IoT Pi Pro，将其全部取出，下面是全家福：

配件包括：四个塑料铜柱、一个两排 20PIN 的插针、一根 Micro USB 线、一根 USB 电源线、一根硬件调试器 SWD 接口 的 4PIN 连接线（其中黑线为 GND）。

以下是装好四个塑料铜柱的 IoT Pi Pro 效果：

# IoT Pi Pro 原理图

IoT Pi Pro 原理图存放在翼辉产品技术支持 QQ 群的共享文件夹，群号码：517107565，请加入翼辉产品技术支持 QQ 群获取。

# IoT Studio 软件使用

开发 MS-RTOS 需要安装专用的集成开发环境 IDE —— IoT Studio，MS-RTOS 开发工具包下载open in new window ，下面简述每款 MS-RTOS 开发工具的用途：

.zip 扩展名的软件为绿色软件，解压缩到合适的目录后就可以使用，.exe 扩展名的软件需要安装。

安装完成后，双击桌面的 IoT Studio 图标即可打开 IoT Studio，首次打开需要选择一个合适的文件夹作为工作空间 work space，后续新建的各类 MS-RTOS 工程都会存放在此文件夹中：

完成以上操作后，将进入 IoT Studio 的主界面：

# MS-RTOS 工程类型

通过点击 File > New > Project... 菜单项来新建 MS-RTOS 的各类工程：

以下是各类 MS-RTOS 工程的简介：

# MS-RTOS Base 工程构建

需要登录 MS-RTOS 云开发平台，进入 MS-RTOS 构建界面：

• 版本选择 选择需要构建的 MS-RTOS 版本
• 基础属性 选择 Toolchain、CPU Type、FPU Type 和 Float ABI Type
• 组件选择 选择需要加入的组件，MS-RTOS 和 lwip_net 为必选项，目前可以选择的组件如下：

IoT Pi Pro 的 CPU 为 STM32H750，是一个 Cortex-M7 的 MCU，所以 CPU Type 需要选择为 cortex-m7，FPU Type 可以选择 fpv5-d16 或 disable， Float ABI Type 可以选择 softfp 或 hard。

IoT Pi Pro 的 BSP 和 Demo 依赖于 libmsdriver、esp_at_net、fatfs、libsddc、mbedtls、cjson、st_touchgfx 这几个组件，所以需要手动勾选这几个组件。

点击开始构建按钮将开始 MS-RTOS 的构建，构建完成后，点击下载 SDK 按钮，浏览器将下载 msrtos_sdk.zip，下载完毕后请将该压缩包解压到工作空间文件夹内：

回到 IoT studio 里，点击 File > Import... 菜单项，打开工程导入对话框，选择 MS-RTOS Projects 工程类型， 勾选 msrtos_base_sdk 工程，点击 Finish 按钮完成导入：

IoT Studio 会先从 MS-RTOS 的 gitee 站点open in new window 或 github 站点open in new window 下载组件。

待下载完毕后，选中 msrtos_base_sdk 工程，点击鼠标右键，点击弹出的快捷菜单中的 Poperties 菜单项，将弹出 msrtos_base_sdk 工程属性配置对话框，选择 MS-RTOS Setting 类，将 Debug Level 修改为 debug，最后点击 OK 按钮：

点击 Build Project 按钮开始 MS-RTOS 的构建：

# MS-RTOS helloworld 工程构建

点击 File > New > MS-RTOS App 菜单项，打开新建 APP 向导对话框，输入工程名 helloworld：

点击 Next 按钮，选择 msrtos_base_sdk 工程作为 helloworld 工程的 MS-RTOS Base Project，Debug Level 选择 debug，最后点击 Finish 按钮：

新建完毕后，就可以选中 helloworld 工程，点击 Build Project 按钮开始 helloworld 工程的构建：

# IoT Pi Pro BSP 工程构建

进入工作空间所在的文件夹，使用 git 工具下载 https://github.com/ms-rtos/bspstm32h7xx.git

git clone https://github.com/ms-rtos/bspstm32h7xx.git

下载完毕后，回到 IoT Studio 里，点击 File > Import... 菜单项，打开工程导入对话框，选择 MS-RTOS Projects 工程类型， 勾选 bspstm32h7xx 工程，点击 Finish 按钮完成导入：

选中 bspstm32h7xx 工程，点击鼠标右键，点击弹出的快捷菜单中的 Poperties 菜单项，将弹出 bspstm32h7xx 工程属性配置对话框，选择 MS-RTOS Setting 类，选择 workspace 的 msrtos_base_sdk 工程作为 bspstm32h7xx 工程的 MS-RTOS Base Project，Debug Level 选择 debug，最后点击 OK 按钮：

选中 bspstm32h7xx 工程，点击 Build Project 按钮开始 bspstm32h7xx 工程的构建：

# IoT Pi Pro bootloader 工程构建

进入工作空间所在的文件夹，使用 git 工具下载 https://github.com/ms-rtos/bootstm32h7xx.git

git clone https://github.com/ms-rtos/bootstm32h7xx.git

下载完毕后，回到 IoT Studio 里，点击 File > Import... 菜单项，打开工程导入对话框，选择 MS-RTOS Projects 工程类型， 勾选 bootstm32h7xx 工程，点击 Finish 按钮完成导入：

选中 bootstm32h7xx 工程，点击鼠标右键，点击弹出的快捷菜单中的 Poperties 菜单项，将弹出 bootstm32h7xx 工程属性配置对话框，选择 MS-RTOS Setting 类，选择 workspace 的 msrtos_base_sdk 工程作为 bootstm32h7xx 工程的 MS-RTOS Base Project，Debug Level 选择 debug，最后点击 OK 按钮：

选中 bootstm32h7xx 工程，点击 Build Project 按钮开始 bootstm32h7xx 工程的构建：

# IoT Pi Pro BSP 镜像和 helloworld 镜像烧写

使用 USB 电源线连接 IoT Pi Pro 到计算机的 USB 插口，使用 SWD 连接线（其中黑线为 GND）连接 IoT Pi Pro 到 J-LINK 调试器，同时将 J-LINK 调试器连接到计算机，如下所示：

打开 MS-RTOS Auto Tester 工具，Device 选择 STM32H753VI，然后点击 Connect 按钮，调试器将连接 IoT Pi Pro：

点击 Erase 按钮擦除芯片 FLASH。

点击 Image 右边的 Select 按钮选择 bootstm32h7xx 工程编译生成的 bootstm32h7xx.bin 镜像，Flash Address 设置为 0x08000000，然后点击 Download 按钮烧写 BSP 镜像到 FLASH 0x08000000 地址处。

点击 Image 右边的 Select 按钮选择 bspstm32h7xx 工程编译生成的 bspiotpipro.bin 镜像，Flash Address 设置为 0x90000000，然后点击 Download 按钮烧写 BSP 镜像到 FLASH 0x90000000 地址处。

点击 Image 右边的 Select 按钮选择 helloworld 工程编译生成的 helloworld.bin 镜像，Flash Address 设置为 0x90100000，然后点击 Download 按钮 helloworld 镜像到 FLASH 0x90100000 地址处。

点击 Go 按钮，IoT Pi Pro 的 CPU 将开始运行，MS-RTOS Auto Tester 的 shell 终端将通过调试器连接到 MS-RTOS 的 shell 服务：

MS-RTOS 启动后，会自动运行 FLASH 0x90100000 地址处的 helloworld 应用程序。

您可以在两个 Input 输入框输入 shell 命令，输入回车将发送命令并清除 Input 输入框，点击右边的 Send 按钮也会发送命令，但 Input 输入框内容会予以保留。

# IoT Pi Pro BSP 调试

使用 USB 电源线连接 IoT Pi Pro 到计算机的 USB 插口，使用 SWD 连接线（其中黑线为 GND）连接 IoT Pi Pro 到 J-LINK 调试器，同时将 J-LINK 调试器连接到计算机，如下所示：

# 新建 BSP 调试实例

选中需要调试的 BSP 工程，点击鼠标右键，在弹出的快捷菜单中，选择 Debug As > Debug Configurations... 菜单项，打开调试配置对话框，双击 GDB SEGGER J-Link Debugging.. ，新建一个 BSP 调试实例：

# 配置 BSP 调试实例

在 Main 选项卡页面，配置如下内容：

• 点击 Project 右侧的 Browse... 按钮选择需要调试的工程。
• 点击 C/C++ Application 右侧的 Browse... 按钮选择需要调试的 ELF 文件，如 Debug/bspiotpipro.elf。

在 Debugger 选项卡页面，配置如下内容：

• 点击 Executable path 右侧的 Browse... 按钮选择 JLinkGDBServerCL.exe 的文件路径，如 D:\Work\MS-RTOS\JLink\JLinkGDBServerCL.exe。
• 在 Device name 输入被调试的芯片名称，如 STM32H753VI。

其它配置项保持默认设置即可，点击 Apply 按钮保存配置，然后点击 Debug 按钮开始调试。

当 BSP 镜像下载完毕后，会在 bsp_init 函数停下。IoT Studio 内建的 Terminal 终端将会自动连接到 MS-RTOS 的 shell，接下来就可以正式开始调试。

# helloworld 调试

# 新建 APP 调试实例

选中需要调试的 APP 工程，点击鼠标右键，在弹出的快捷菜单中，选择 Debug As > Debug Configurations... 菜单项，打开调试配置对话框，双击 GDB MS-RTOS Application Debugging..，新建一个 APP 调试实例：

# 配置 APP 调试实例

在 Main 选项卡页面，配置如下内容：

• 点击 Project 右侧的 Browse... 按钮选择需要调试的工程，如 helloworld 工程。
• 点击 C/C++ Application 右侧的 Browse... 按钮选择需要调试的 ELF 文件，如 Debug/helloworld。

在 Debugger 选项卡页面，配置如下内容：

• 点击 Executable path 右侧的 Browse... 按钮选择 JLinkGDBServerCL.exe 的文件路径，如 D:\Work\MS-RTOS\JLink\JLinkGDBServerCL.exe。
• 在 Device name 输入被调试的芯片名称，如 STM32H753VI。

在 Startup 选项卡页面，配置如下内容：

• 在 Application address（hex）输出框输入烧写应用程序镜像的 FLASH 地址，如 90100000。

其它配置项保持默认设置或根据实际需求进行调整，如将 Memory size（KB）修改成 128，将 Stack size 修改成 8192 等等，最后点击 Apply 按钮进行保存，然后点击 Debug 按钮开始调试。

当 APP 镜像下载完毕后，会在 main 函数停下来。IoT Studio 内建的 Terminal 终端将会自动连接到 MS-RTOS 的 shell 服务，接下来就可以正式开始调试。

# IoT Pi Pro 例程下载和构建

进入工作空间所在的文件夹，使用 git 工具下载 https://github.com/ms-rtos/iotpipro_demos.git

git clone https://github.com/ms-rtos/iotpipro_demos.git

下载完毕后，回到 IoT Studio 里，点击 File > Import... 菜单项，打开工程导入对话框，选择 MS-RTOS Projects 工程类型， 勾选所有 demo 工程，点击 Finish 按钮完成导入：

选中任意一个 demo 工程，点击 Build Project 按钮开始该 demo 工程的构建：

编译完成后，可以使用 MS-RTOS Auto Tester 工具烧录生成的 demo 镜像到 FLASH 0x90100000 地址处，点击 Go 按钮或对 IoT Pi Pro 进行复位，IoT Pi Pro 的 CPU 将开始运行，MS-RTOS 启动后，会自动运行 FLASH 0x90100000 地址处的 demo 应用程序。