QuecPython 快速上手 ①：开箱之后先做什么？软硬件准备与首次上电
系列导读：这是「QuecPython 快速上手」系列的第 1 篇。整个系列共 7 篇，从拆快递到跑通第一个脚本，按顺序读一遍就能独立完成开发环境搭建。
本篇关键词：开发板选型 / USB 线材 / SIM 卡 / 上电顺序
一、先明确：QuecPython 是什么
QuecPython 是移远在蜂窝模组上跑的 Python 运行环境。你不需要写 C、不需要搭交叉编译链，用 Python 语法就能直接调用模组的 4G 通信、GPIO、串口、ADC 等能力，写完往模组里一放就能跑。
对开发者来说最直接的好处是：一套代码逻辑，改几行就能换模组型号，特别适合 POS、POC、ETC、共享设备、数据卡、能源控制、工业 PDA 这类蜂窝联网终端的原型验证。
但前提是——模组出厂烧的是标准 AT 固件，不是 QuecPython 固件。这一条请先记住，第 4 篇会专门讲怎么烧。
二、硬件清单
开箱前对照下表点一遍，缺一样都容易卡在第一步：
| 类别 | 物品 | 说明 |
|---|---|---|
| 主控 | QuecPython_EC2X_EVB 开发板 | 本系列以该型号为例；用其他型号同样适用，只是驱动和固件不同，见「开发板与硬件」页面 |
| 线材 | USB 数据线（USB-A to USB-C） | 必须是数据线，纯充电线只能供电、不识别串口，是新手最常见的坑 |
| 主机 | PC（Windows 10） | 本系列以 Win10 演示 |
| 外设 | 天线 | 蜂窝天线接 MAIN 口；有 GNSS/DIV 需求的按板子丝印接 |
| 外设 | SIM 卡 | 标准卡 / Micro / Nano 视卡座而定，注意缺口方向 |
关于 SIM 卡：如果要跑联网 Demo，卡必须已激活且有流量；如果只是点亮 REPL、跑本地脚本，不插卡也能工作。
三、软件清单
| 软件 | 作用 | 获取方式 |
|---|---|---|
| USB 驱动 | 让 PC 识别模组的串口（AT 口 / REPL 口 / 下载口） | 官网「QuecPython 资源下载 → 驱动」板块 |
| QPYcom | QuecPython 全栈调试工具：交互、文件传输、固件烧录、日志 | 官网资源下载，解压即用 |
| QuecPython 固件 | 让模组具备 Python 运行能力 | 官网「固件下载」页，按型号筛选 |
| 文本编辑器 | 写 .py 脚本 | 推荐 VSCode（另有官方 QuecPython 插件） |
提醒：驱动和固件都是按型号精确匹配的，不能混用。EC200U 的固件烧不进 EC600M，这不是玄学，是硬性限制。
四、首次上电：四步开机
按下面顺序操作，可以避免"上电没反应"的排查地狱：
- 装天线 —— 先把蜂窝天线拧到 MAIN 口。不要在没有天线的情况下发射，既影响信号也可能损伤射频前端。
- 插 SIM 卡 —— 断电状态下插入，注意卡槽缺口方向，插到底有轻微"咔"声。
- 接 USB —— 用数据线连接开发板与 PC。此时板载电源灯应点亮。
- 按键开机 —— 部分 EVB 需要长按 PWRKEY 约 1~2 秒才能开机，不是插上 USB 就自动开机。
怎么判断真的开机了？ 看板上的网络指示灯：开机后快闪（搜网）→ 慢闪（已注册网络）→ 常亮（已建立数据连接）。如果灯一直不亮，先回去检查第 3、4 步。
五、这一篇的自检清单
读完先别急着往下走，确认这几点都成立：
- 手上有数据线，不是充电线
- 天线已接到 MAIN 口
- SIM 卡已插入且方向正确
- 板子已按 PWRKEY 开机，指示灯有反应
- 已确认自己的模组型号（后面选驱动、选固件全靠它）
模组型号在哪看？三个地方任选：板子丝印、模组屏蔽罩上的激光刻字、或者用 AT 命令 ATI 查询。
六、常见问题
Q1：插上 USB，电脑完全没反应，设备管理器也没有新设备。
A：90% 是线材问题。换一根确定能传数据的线；其次确认板子是否真的开机（需要按 PWRKEY）。
Q2：板子上的灯一直快闪，不进入慢闪。
A：没搜到网。检查天线是否接好、SIM 卡是否激活、所在位置信号是否正常。
Q3：可以用别的开发板吗？
A：可以。QuecPython 支持多款 EVB，流程完全一致，只是「驱动型号」和「固件型号」要跟着换。
下一篇
第 2 篇：驱动安装——让电脑认出你的开发板
会讲清楚驱动去哪下、怎么装、装完怎么验证，以及"设备管理器出现黄色感叹号"到底该怎么办。
#QuecPython #快速上手 #开发板 #物联网开发 #新手入门