XBee3 特性实验1——如何下载MicroPython代码到XBee3模块

（http://www.bitconn.com/form_1/注册后，购买XBee模块，送USB评估底板及相关中文资料，或者免费申请借用评估套件）

MicroPython是一种受Python 3.0启发的编程语言，适用于微控制器，例如XBee 3.MicroPython可以帮助减少项目的耗材量和整体体积，并使事情变得更加容易。但是，我发现当我使用MicroPython时，将代码上传和下载到设备上的过程令人困惑。所以这个教程旨在解释如何在XBee上下载代码的“简单”过程。

MicroPython是一种受Python 3.0启发的编程语言，适用于微控制器，例如XBee 3.MicroPython可以帮助减少项目的耗材量和整体体积，并使事情变得更加容易。但是，我发现当我使用MicroPython时，将代码上传和下载到设备上的过程对很多初学者来说还是比较陌生的。所以写了这个教程旨在解释如何在XBee上下载代码的“简单”过程。

如果您还没下载Digi MicroPython 编程指南，请查看 Digi MicroPython Programming Guide.。它有助于广泛了解MicroPython如何在XBees上运行，以及进行故障排除。

本教程无需您熟悉XCTU，但如果您想熟悉，可以阅读XCTU每个部分的标题，以获取有关如何安装和卸载MicroPython代码的更多基本步骤。但需要你已经编写了代码并将其保存为.py或.mpy文件。

我手头的XBee使用的是802.15.4协议，但与XBee其他协议的MicroPython差别不大。
在XBees上使用MicroPython时要遵守的一般规则：
- 保持波特率为115200或更高。这有助于防止数据丢失。
- 使代码快速运行传入的数据包。当你使用MicroPython时，XBee只能容纳4个数据包的队列 - 一旦队列满了，它就会丢到新的数据。
- 确保您的XBee是XBee3， MicroPython不适用于其他版本的XBee模块。

需要的实验工具：

XBee3模块；
XBee USB调试底板，可让将XBee插入计算机；
安装了XCTU的计算机；
要在XBee上安装的代码的.py或.mpy文件；

下面我来一步一步讲解如何操作：

第一步：连接XBee

插入要编程的XBee并打开XCTU。单击左上角的添加设备（看起来像带有+的XBee的图标），然后选择正确的COM端口。确保波特率正确（我们将XBees设置为9600），然后单击“完成”以连接XBee。注：XCTU需要一些时间才能加载很多参数。

步骤2：确保PS设置为0，AP设置为4

单击屏幕左侧的XBee图标以在右侧显示其设置。在屏幕的右侧，向下滚动到名为MicroPython Commands的部分，并确保PS设置为Disabled [0]。如果不是，请更改设置并点击最右侧设置旁边的铅笔图标，将更改写入XBee。在AP参数的UART接口部分中执行相同操作，并确保将其设置为MicroPython REPL [4]。

PS参数是确定当XBee打开时代码是否自动运行，并且AP参数基本上是XBee所处的“操作模式”。要使MicroPython工作，它必须处于它自己的“MicroPython模式”。“ 如果PS设置为Enabled [1]，它可能会导致其中一些步骤出现问题，因此我发现最好将其关闭，直到我完成更新XBee上的代码。

步骤3：打开文件系统管理器

导航到屏幕顶部栏中的“工具”部分，然后选择“文件系统管理器”。它会打开一个如上所示的窗口 - 计算机上的文件显示在左侧，右侧显示一个空窗口。

步骤4：配置正确的COM端口

点击配置。选择正确的COM端口，确保波特率正确，然后单击“确定”。您应该在之前说过“在使用文件系统之前配置端口”的位置看到所选COM端口的名称。

步骤5：打开与XBee的连接

点击“打开”。如果您收到错误，请重新拔出并重新插入XBee然后点击Open通常可以正常工作。您现在应该看到加载到窗口右侧的XBee上的文件。如果您的XBee是全新的，您可能只会看到两个文件夹，但如果您以前使用过XBee，您可能会在目录中看到其他文件（在我看来，有一个名为“main.py”）。

步骤6：删除文件系统管理器中的旧代码

如果您的XBee上没有旧代码，则可以跳过此步骤。
如果您要更新XBee上的旧代码文件，则必须先删除旧代码文件。 XBee不会自动删除旧版本的代码，并且存储空间非常有限，因此您必须手动删除旧代码文件。
XBee上的MicroPython代码必须位于名为“main.py”的文件中，以便XBee自动运行代码。您可以将多个文件加载到XBee上，但它在启动时运行的唯一文件是“main.py”，因此只要将它们导入“main.py”就可以使用多个模块。如果你'使用多个模块，您只需要删除重新上传到XBee的模块。
首先，右键单击要删除的文件，然后选择“删除”。片刻之后，它将从文件系统管理器中消失。该文件现已从XBee的主存储器中删除。但是，XBee还有一个工作内存，它存储了最后运行的代码，这也必须删除。点击右下角的“关闭”退出文件系统管理器。

步骤7：将AP更改为1

在屏幕右侧的XBee设置中，滚动到显示UART接口的部分。将AP参数更改为API Mode Mode Without Escapes [1]，然后单击铅笔图标将其写入XBee。这允许我们向XBee发送AT命令，我们必须这样做才能擦除XBee的工作内存。如果你正在使用新的XBee，你可能不需要在第一次下载代码时执行此步骤，但它不会影响确认工作内存被删除。

步骤8：切换到控制台工作模式并打开连接

按Alt-C或点击右上角看起来像电视监视器的按钮切换到控制台工作模式，然后按打开打开与XBee的通信线路。我们使用这种模式与我们的XBee模块交互。

步骤9：打开帧生成器

在屏幕的右侧，在“发送单个数据包”的位置下，单击+图标，然后在弹出窗口中使用“帧生成器”工具单击“创建帧”。这将打开帧生成器，如上所示。我们使用它来生成我们将发送给XBee的消息。

步骤10：配置帧生成器以生成AT命令

如果它显示帧类型，单击该框以打开下拉菜单并选择0x08 - AT命令。屏幕将更改为上面显示的格式。

步骤11：输入AT命令以清除工作存储器

在标有AT命令的红色突出显示的框中，键入PY。这是AT命令的第一部分，基本上是告诉XBee我们想要用MicroPython做些什么。在标记为参数值的框中，键入E.这是我们希望XBee执行的特定MicroPython命令，它正在擦除XBee的工作内存（我试着记住“E for Erase”）。键入时，数字将显示在屏幕底部的框中。

步骤12：添加帧

点击OK。现在你回到了你进入Frames Generator之前的窗口。框架名称对我们的目的并不特别重要，因此请忽略它。您应该在此窗口的框中看到最后一个窗口中的数字。如果是，请选择添加帧。

步骤13：发送AT命令

新的“frame_0”框出现在标有发送帧的框中。现在我们可以将AT命令发送给XBee。确保我们刚制作的框架突出显示，然后单击带有绿色箭头的按钮，该箭头显示发送选定的框架。蓝色和红色文本将出现在上面的“帧”日志中。

步骤14：解释回复

蓝色文本是您刚刚发送的命令，红色文本是XBee的回复。单击红色文本以阅读它。您可以看到一行十六进制，类似于我们在右侧窗口中发送给XBee的行。您可以将其复制并粘贴到Frames Interpreter工具中（通过单击上面工具图标旁边的箭头访问），但如果倒数第二对数字是双零，则表示它成功擦除了工作内存。

步骤15：将AP更改为4

单击左上角的“关闭”以退出与XBee的通信。
单击齿轮图标返回到XBee的设置，然后向下滚动到UART接口，并将AP参数更改回MicroPython REPL [4]。单击铅笔图标将新设置写入XBee。

步骤16：将你的代码拖到文件系统管理器中

返回“工具”>“文件系统管理器”，配置为正确的端口，然后单击“打开”。在窗口的左侧（计算机的文件），导航到要上传到XBee的代码，然后单击并将其拖动到右侧（XBee的文件）。您应该会看到文件显示在右侧。新代码现已下载到XBee上。

步骤17：打开MicroPython终端

点击关闭。是时候确保代码正常运行了。导航到工具> MicroPython终端。选择Configure，选择正确的COM端口，然后单击Open。窗口中应该有一个黑色闪烁的光标。按Enter键，您将看到MicroPython提示符：>>>

步骤18：测试您的代码

按Ctrl-R，“main.py”文件中的代码将运行。如果一切正常，你就完成了！如果您希望代码在XBee打开时自动运行，请关闭MicroPython终端，并在XBee的设置中，向下滚动到MicroPython命令，并将PS参数更改为Enabled [1]，然后点击铅笔图标进行编写它到XBee。