head.jpg

Hello, World!

Hello World是一个最著名的程序。对每一位程序员来说，这个程序几乎是每一门编程语言中的第一个示例程序。实际上，这个程序的功能只是告知计算机显示Hello World这句话。传统意义上，程序员一般用这个程序测试一种新的系统或编程语言。对程序员来说，看到这两个单词显示在电脑屏幕上，往往表示他们的代码已经能够编译、装载以及正常运行了，这个输出结果就是为了证明这一点，因此以下说明以此为例。

1. 使用 MpfShell 编程

• 温馨提示，往下使用之前，请先烧写 MicroPython 固件。
• 所需材料，Windows 请到此处Tools 下载 Windows-Mpfshell.exe， 由于软件版本可能会升级变动，所以需要手动选取所需版本下载。

如果你已经安装了 Python ，直接使用 pip install mpfshell-lite 后输入 mpfshell-lite 即可。

1. 通过 repl 运行程序

program.png

• （以 Windows 为例）双击运行 Windows-Mpfshell.exe。

index.png

• 依次出现的颜色	解释其说明
  白色	显示所有支持的命令操作，上排命令表示有帮助说明，下排命令反之。
  黄色	以上为全部支持的命令，如果想知道ls的用法，输入help ls即可得知。
  蓝色	显示当前插入的板子的串口名，如图所示为 com5，可以输入open com5连接设备。

• 尝试连接设备，输入 open com5（可以简写为 o com5），如果没有反应，使用CTRL + C或右上角点红叉。

opendev.png

• 现在的提示：首次启动板子，若是使用了联网功能，如果灯还在滚动的时候连接了板子，可能会停止联网操作，所以当发现联网功能被停止了，需要手动在repl执行wifi.start()，或使用 exec 执行该语句即可。

• 过去的提示：首次启动板子，第一次会连接失败，根据提示 try again 重试即可，因此要注意红色的提示信息。

connected.png

• 当显示 Connected to esp32 时，就可以确认板子已成功连接。

• 此时再次输入 repl，进入基础编程环境，并写下你的第一段程序，例如：print('Hello, World!')。

• 提示：最新的固件在开机时的 REPL 可能会出现 no found AP，想要停止它可以输入wifi.close()，这不影响板子的外部操作，只是会影响 REPL 的输出位置，固件设定板子上电就会自动执行联网，其联网配置文件在内部的wifi_cfg.py，由于每个人的环境不一样，所以默认的是连接webduino.io/webduino，它输出的讯息只会影响显示，不影响功能。

print_helloworld.png

• 回显 Hello, World!，即说明你成功的运行了你的第一段程序，你也可以继续输入代码来测试。

2. 通过 main.py 运行程序

• 新建一个 main.py 文件，并写入以下内容。

  print('Hello, World!')
  

• 若是想使用 MpfShell 执行该文件，请将文件放到与 MpfShell 同一目录下。

main.png

• 接着再切换到 MpfShell 的程序区域，输入runfile main.py，或输入rf main.py，runfile 简写成 rf。

main_result.png

• 可以看到回显了hello world，说明你成功运行了程序。

• 可能有用的提示：最新的 mpfshell 指令多了 lexecfile，如果需要进行python 的 input 输入交互的时候，请使用该指令， 因为 runfile 只能接收板子输出而不能输入。

以下为进一步深入的内容，可以自行了解。

4. 详解开发环境和工具

1. 什么是 repl？

REPL(Read-eval-print-loop)：交互式解析器

在 repl 环境下，可以定义和运行变量、函数、对象。

repl 的常用命令：

• 启动 MicroPython，即进入了 REPL 环境。
• 退出：按 Ctrl + C中断 或 按CTRL + D 软复位。
• 点击 tab 可以打印出 Python 中的所有模块，或补全不完整的命令（输入过的历史命令）。
• 使用键盘方向键的 向上 或 向下 可以查看 历史命令，向左 或 向右 配合 backspace 可以修改还没确认输入（Enter）的内容。

常见使用场景：

• 在 repl 中想要输入 import 命令，只需要 输入 i + 按下 tab 键即可补全成 import，其他同理，使用的前提是此前输入过，因此不是所有命令都可以被补全。

• 在运行 python 代码时，希望能让它停下来，按下 CTRL + C 即可向解释器发送一个 KeyboardInterrupt 异常，此时解释器运行过程中如果未使用异常捕获处理该异常，则程序将会停止。

2. 如何选择开发工具？

个人推荐 MpfShell + PyCharm ，理由是编写简单的代码用 MpfShell ，编写复杂的代码用 PyCharm ，无需额外配置任何东西，运行流畅，简单快捷。