1. 项目概述当传统收音机遇上脚本语言如果你手头有一台基于Si4732芯片的ATS Mini Radio那么它可能远不止是一台“收音机”。这台小巧的设备凭借其内置的ESP32微控制器本身就具备强大的计算和联网能力。而RadioScript项目的出现则彻底释放了这种潜力。它本质上是一个运行在MiniRadio ESP32固件上的脚本语言解释器其核心思想是为这台硬件赋予一个灵魂让它能理解并执行你用类MicroPython语法编写的无线电控制脚本。这意味着什么意味着你不再需要为了调整一个接收参数而去编译、烧录整个固件意味着你可以通过浏览器像编辑一个网页一样实时编写、调试并永久保存一个控制收音机扫描频段、绘制信号频谱或自动录音的“小程序”更意味着你可以为这台设备创建专属的、交互式的Web控制界面用手机或平板就能进行所有复杂操作。RadioScript将这台几十美元的硬件从一个封闭的消费电子产品转变为了一个开放的、可编程的射频实验平台。无论是业余无线电爱好者想监测特定频段的信号强度变化还是教育工作者想演示无线电原理亦或是开发者想快速原型一个物联网射频应用它都提供了一个极其便捷的入口。接下来我将结合自己的实操经验带你从零开始深入探索RadioScript的玩法。2. 环境准备与固件刷写在开始编写脚本之前我们首先需要让手中的ATS Mini Radio运行RadioScript固件。这个过程类似于给路由器刷入第三方固件需要一些基础的硬件连接和软件操作。2.1 所需工具与材料清单工欲善其事必先利其器。以下是整个项目过程中你会用到的所有东西硬件核心ATS Mini Radio基于Si4732和ESP32。请确认你的版本大多数通用版本均可。USB数据线用于供电和串口通信。建议使用质量好的数据线劣质线可能导致供电不稳或通信失败。电脑Windows, macOS 或 Linux 均可。需要安装串口驱动如CH340、CP2102等根据MiniRadio上的USB转串口芯片型号而定。网络环境一个2.4GHz Wi-Fi网络供Radio连接以启用Web IDE功能。固件刷写工具我们使用esptool.py这是一个由乐鑫官方提供的命令行工具稳定可靠。RadioScript固件文件从项目官网http://www.hjberndt.de/soft/espbasic/espRadioScript.html下载最新的.bin文件。注意在操作前请确保MiniRadio有足够电量或通过USB稳定供电。刷机过程中断电可能导致设备变砖虽然ESP32通常可以通过强制进入下载模式来救回但过程会麻烦许多。2.2 固件刷写详细步骤刷写固件是第一步也是最为关键的一步。这里以Windows系统为例使用esptool.py进行说明。第一步安装Python与esptool如果你的电脑没有Python请先安装Python 3.x版本并确保将Python和pip添加到系统环境变量。安装完成后打开命令提示符CMD或PowerShell执行以下命令安装esptoolpip install esptool第二步连接设备并确认端口用USB线将ATS Mini Radio连接到电脑。打开设备管理器在Windows搜索框输入“设备管理器”查看“端口COM和LPT”一项。你会看到一个新增的串行端口例如COM3或COM4。记下这个端口号。第三步擦除原有固件为了确保新固件干净地写入我们首先擦除整个Flash。在命令提示符中运行以下命令请将COM3替换为你实际的端口号esptool.py --chip esp32 --port COM3 erase_flash执行后工具会提示你让设备进入下载模式。对于大多数ATS Mini Radio你需要同时按住设备上的“VOL”和“PLAY”按钮然后按一下“RST”复位键再松开“RST”最后松开两个按钮。此时设备应进入下载模式工具开始擦除完成后会显示“Hard resetting...”。第四步写入RadioScript固件擦除完成后开始写入新固件。确保你已下载好固件文件例如espRadioScript.bin并知道其存放路径。esptool.py --chip esp32 --port COM3 --baud 921600 write_flash -z 0x1000 路径\to\espRadioScript.bin这里的--baud 921600设置了较高的烧录波特率以提升速度-z参数表示在烧录前先擦除相应扇区0x1000是ESP32应用程序固件的标准起始地址。烧录过程会有进度条显示请耐心等待直至完成。第五步首次启动与Wi-Fi配置烧录成功后设备会自动重启。此时打开电脑的Wi-Fi列表你应该能搜索到一个新的热点名称类似于“RadioScript-XXXXXX”。用电脑或手机连接这个热点通常无需密码。连接成功后打开浏览器访问http://192.168.4.1。 你会看到一个简单的配置页面在这里选择你的家庭Wi-Fi网络SSID并输入密码。提交后设备会尝试连接。连接成功后页面会显示设备获取到的IP地址例如192.168.1.105。请务必记下这个IP地址以后我们将通过这个IP在浏览器中访问RadioScript的Web集成开发环境Web IDE。3. RadioScript语言核心解析RadioScript的语法大量借鉴了MicroPython和BASIC对于有过任何编程经验的人来说都非常容易上手。它的强大之处在于将硬件操作如控制收音机芯片、绘制屏幕、读取编码器封装成了简单的语句和函数。3.1 基础语法与数据结构RadioScript是一种解释型语言代码从上到下顺序执行。让我们从最基础的要素开始变量与数据类型变量无需声明类型直接赋值即可。它支持数字整数、浮点数、字符串和数组。freq 98.5 ‘ 浮点数表示频率 station “Music FM” ‘ 字符串 volume 15 ‘ 整数 rssi_list [45, 67, 23, 89] ‘ 数组字符串连接使用运算符数字转字符串使用STR()函数。控制流语句支持标准的IF...THEN...ELSE...ENDIF条件判断和FOR...NEXT、WHILE...WEND循环。‘ 条件判断示例 rssi RX.RSSI() if rssi 60 then TTY “信号很强” elseif rssi 30 then TTY “信号一般。” else TTY “信号较弱。” endif ‘ 循环示例 for i 1 to 10 TTY “计数: ” STR(i) delay(500) ‘ 延迟500毫秒 next i子程序与事件驱动使用GOSUB [标签名]来调用子程序用RETURN返回。这是组织代码的基础。 更重要的是RadioScript支持事件驱动编程这是实现交互功能的核心。你可以通过timerCB设置定时器回调或者通过onButton、onEncoder等函数响应硬件输入事件。‘ 设置一个每1000毫秒执行一次的定时器 timerCB 1000, [updateDisplay] [updateDisplay] ‘ 在这里更新屏幕显示 TTY “时间: ” TIME$ RETURN3.2 硬件控制API详解RadioScript的真正威力在于其丰富的硬件控制函数。它们主要分为三大类射频控制、显示控制和输入控制。1. 射频控制 (SI4732芯片)这是核心功能所有函数都以RX.或直接命令形式提供。RX 频段: 初始化接收机模式。例如RX 100.0设置为FM接收100.0代表FM模式。FREQUENCY 频率值: 设置接收频率单位MHz。FREQUENCY 101.7。RX.RSSI(): 读取当前频率的信号强度指示返回值通常需要乘以2得到以dBμV为单位的近似值。这是最常用的函数之一。RX.SNR(): 读取信噪比。RX.SEEK(方向): 执行自动搜台方向为1向上或-1向下。VOLUME 值: 设置音量范围0-63。 你甚至可以深入底层通过RX.WRITE(寄存器地址, 值)和RX.READ(寄存器地址)直接操作SI4732的所有寄存器这为高级应用和调试提供了无限可能。2. 显示控制 (TFT屏幕)ATS Mini Radio配备了一块小尺寸TFT彩屏RadioScript提供了完整的绘图功能。TFT.cls(): 清屏。TFT.fill(颜色): 用指定颜色填充整个屏幕。颜色使用TFT.rgb(红, 绿, 蓝)函数生成每个分量0-255。TFT.line(x1, y1, x2, y2, 颜色): 画线。TFT.circle(x, y, 半径, 颜色): 画圆。TTY 文本: 在屏幕的文本区域如果启用或指定位置打印文本。TTY.size可以设置文本大小和区域。3. 输入控制 (旋转编码器与按钮)设备上的旋转编码器通常用于调谐频率和音量和按钮都可以被脚本捕获。ENCODER: 返回编码器自上次读取以来的增量值正数或负数。BUTTON(按钮编号): 读取指定按钮的状态0为释放1为按下。onEncoder [标签]: 设置编码器转动时触发的事件子程序。onButton 按钮编号, [标签]: 设置按钮按下时触发的事件子程序。4. 从零构建一个信号强度扫描仪现在让我们结合一个实际项目将上述知识融会贯通。我们将创建一个增强版的信号强度扫描仪它不仅绘制RSSI曲线还能自动扫描频段并标记出信号最强的几个点。4.1 项目需求与设计思路我们的目标是制作一个工具能够可视化地展示整个FM波段例如87.5MHz - 108.0MHz的信号分布情况。它应该能自动以一定步进如100kHz扫描指定频段。实时在屏幕上绘制每个频率点的信号强度RSSI形成一幅频谱图。在扫描过程中动态标记出当前检测到的、信号最强的N个频率点。提供简单的用户交互比如按按钮开始/停止扫描用编码器调整扫描步进。设计上我们将采用状态机模型。主循环负责控制扫描流程定时器中断用于在每一个频率点稳定后读取RSSI并更新图表事件回调函数负责处理用户的按键和编码器操作。4.2 代码实现与逐行解析以下是完整的脚本代码我将穿插在代码注释中进行详细解析。‘ FM波段频谱扫描仪 - 增强版 ‘ 作者基于DB9JG示例扩展 ‘ 功能自动扫描FM波段绘制RSSI频谱图并标记最强信号点 GUIOFF ‘ 关闭默认的Web GUI我们完全用TFT屏幕和本地逻辑控制 ‘ 用户可配置参数 band_start 87.5 ‘ 扫描起始频率 (MHz) band_end 108.0 ‘ 扫描结束频率 (MHz) step_khz 100 ‘ 扫描步进 (kHz) max_peaks 5 ‘ 记录的最大峰值数量 ‘ ‘ 全局变量初始化 W 319 ‘ 屏幕宽度像素 H 169 ‘ 屏幕高度像素 current_freq band_start scanning 0 ‘ 0停止1扫描中 peaks_x [] ‘ 用于存储峰值频率对应的X坐标 peaks_rssi [] ‘ 用于存储峰值RSSI值 scan_data [] ‘ 存储所有频率点的RSSI数据 ‘ 初始化收音机为FM模式 RX 100.0 VOLUME 0 ‘ 扫描时静音避免噪音 ‘ 设置文本显示区域 TTY.size 1, 10, 0, 320, 20 ‘ 绘制初始坐标网格 gosub [DRAW_GRID] ‘ 设置用户交互事件 onButton 0, [TOGGLE_SCAN] ‘ 假设按钮0用于开始/停止 onEncoder [ADJUST_STEP] ‘ 编码器用于调整步进 ‘ 主循环 - 等待事件发生 WAIT ‘ ############################################ ‘ 子程序[TOGGLE_SCAN] - 切换扫描状态 ‘ ############################################ [TOGGLE_SCAN] scanning 1 - scanning ‘ 在0和1之间切换 if scanning 1 then TTY “扫描开始... 步进:” STR(step_khz) “kHz” current_freq band_start scan_data [] ‘ 清空旧数据 gosub [DRAW_GRID] ‘ 重绘网格 ‘ 启动扫描定时器每300ms执行一次[NEXT_FREQ] timerCB 300, [NEXT_FREQ] else timerCB 0 ‘ 取消定时器 TTY “扫描已停止.” endif RETURN ‘ ############################################ ‘ 子程序[NEXT_FREQ] - 步进到下一个频率点并采样 ‘ ############################################ [NEXT_FREQ] if scanning 0 then RETURN ‘ 如果已停止则退出 ‘ 1. 设置当前频率并等待稳定 FREQUENCY current_freq delay(50) ‘ 给SI4732芯片50ms时间稳定 ‘ 2. 读取RSSI raw_rssi RX.RSSI() ‘ SI4732的RSSI寄存器值需要转换经验公式是乘以2得到近似dBuV current_rssi raw_rssi * 2 ‘ 将数据存入数组用于后续分析 scan_data scan_data [current_freq, current_rssi] ‘ 3. 在屏幕上绘制这个点 ‘ 将频率映射到屏幕X坐标 x INT((current_freq - band_start) / (band_end - band_start) * W) ‘ 将RSSI映射到屏幕Y坐标假设RSSI范围0-120 dBuV y H - INT(current_rssi / 120 * H) ‘ 限制y值在屏幕范围内 if y 0 then y 0 if y H then y H ‘ 用绿色点绘制当前信号强度 TFT.circle x, y, 1, TFT.rgb(0, 255, 0) ‘ 4. 更新峰值列表 gosub [UPDATE_PEAKS] ‘ 5. 在文本区显示当前信息 TTY “Freq:” STR(current_freq, 1) “MHz RSSI:” STR(current_rssi) “dBuV” ‘ 6. 步进到下一个频率点 current_freq current_freq (step_khz / 1000.0) ‘ 转换为MHz if current_freq band_end then ‘ 扫描完成 scanning 0 timerCB 0 TTY “扫描完成找到” STR(LEN(peaks_rssi)) “个强信号.” gosub [MARK_PEAKS_ON_GRID] ‘ 在网格上标记出峰值点 endif RETURN ‘ ############################################ ‘ 子程序[UPDATE_PEAKS] - 更新并维护最强信号列表 ‘ ############################################ [UPDATE_PEAKS] ‘ 这是一个简单的算法维护一个最多包含max_peaks个元素的峰值列表 ‘ 如果列表未满直接加入 if LEN(peaks_rssi) max_peaks then peaks_x peaks_x [x] peaks_rssi peaks_rssi [current_rssi] else ‘ 列表已满找到列表中最弱的信号 min_index 0 min_value peaks_rssi[0] for i 1 to LEN(peaks_rssi)-1 if peaks_rssi[i] min_value then min_value peaks_rssi[i] min_index i endif next i ‘ 如果当前信号比最弱的强则替换它 if current_rssi min_value then peaks_x[min_index] x peaks_rssi[min_index] current_rssi endif endif RETURN ‘ ############################################ ‘ 子程序[MARK_PEAKS_ON_GRID] - 在频谱图上标记峰值点 ‘ ############################################ [MARK_PEAKS_ON_GRID] for i 0 to LEN(peaks_x)-1 ‘ 在峰值点画一个红色的‘X’ cross_size 3 x_pos peaks_x[i] y_pos H - INT(peaks_rssi[i] / 120 * H) TFT.line x_pos-cross_size, y_pos-cross_size, x_poscross_size, y_poscross_size, TFT.rgb(255, 50, 50) TFT.line x_poscross_size, y_pos-cross_size, x_pos-cross_size, y_poscross_size, TFT.rgb(255, 50, 50) next i RETURN ‘ ############################################ ‘ 子程序[ADJUST_STEP] - 用编码器调整扫描步进 ‘ ############################################ [ADJUST_STEP] enc ENCODER ‘ 获取编码器增量 if scanning 0 then ‘ 仅当停止时允许调整 step_khz step_khz enc * 10 ‘ 每次调整10kHz ‘ 限制步进在合理范围10kHz - 500kHz if step_khz 10 then step_khz 10 if step_khz 500 then step_khz 500 TTY “步进调整为:” STR(step_khz) “kHz” endif RETURN ‘ ############################################ ‘ 子程序[DRAW_GRID] - 绘制背景网格和坐标轴 ‘ ############################################ [DRAW_GRID] TFT.cls() TFT.fill(TFT.rgb(20, 20, 20)) ‘ 深灰色背景 ‘ 绘制坐标轴 axis_color TFT.rgb(180, 180, 180) TFT.line(0, 0, 0, H, axis_color) ‘ Y轴 TFT.line(0, H, W, H, axis_color) ‘ X轴 ‘ 绘制水平网格线每10dBuV一条 grid_color TFT.rgb(50, 50, 50) for db 10 to 110 step 10 y H - INT(db / 120 * H) TFT.line(0, y, W, y, grid_color) ‘ 在Y轴标注dBuV值 TFT.text 5, y-5, STR(db), TFT.rgb(120, 120, 120) next db ‘ 绘制垂直网格线每5MHz一条并标注频率 for mhz INT(band_start)5 to INT(band_end) step 5 x INT((mhz - band_start) / (band_end - band_start) * W) TFT.line(x, 0, x, H, grid_color) TFT.text x-10, H2, STR(mhz), TFT.rgb(120, 120, 120) next mhz RETURN4.3 脚本部署与运行效果代码编写完成后我们需要将其部署到MiniRadio上并运行。访问Web IDE在浏览器中输入你的MiniRadio的IP地址例如http://192.168.1.105。你会看到一个简洁的代码编辑器界面。创建新脚本在编辑器中清空默认内容将上面的完整代码粘贴进去。保存脚本点击编辑器上方的“Save”按钮为脚本命名例如FM_Scanner.bas。脚本会被保存到设备的Flash存储中断电不会丢失。运行脚本点击“Run”按钮。此时MiniRadio的屏幕会清空然后绘制出坐标网格。文本区会显示“步进调整为:100kHz”。开始扫描按下设备上的按钮0通常是编码器按下功能。文本区会显示“扫描开始...”随后你会看到屏幕上的绿色点从左至右逐渐出现形成一条信号强度曲线。文本区实时显示当前频率和RSSI值。交互操作在扫描过程中或停止后旋转编码器可以调整扫描步进值文本区有提示。步进越小扫描越精细但耗时越长步进越大扫描越快但可能漏掉窄带信号。再次按下按钮0可以随时停止扫描。扫描完成后屏幕会在信号最强的几个位置用红色的“X”进行标记文本区会提示找到了几个强信号。实操心得在编写此类图形化脚本时屏幕坐标映射是关键。务必清楚你的数据范围如频率87.5-108.0RSSI 0-120如何映射到有限的像素点如319x169。不恰当的映射会导致图形扭曲或超出屏幕。建议在关键计算后用TTY语句打印出中间变量如x, y的值进行调试这是在没有传统调试器的环境下最有效的排错方法。5. 进阶应用构建交互式Web控制面板RadioScript不仅能在设备本地运行更能通过其内置的Web服务器让你创建功能丰富的远程控制界面。这意味着你可以用手机、平板或电脑通过浏览器优雅地控制收音机而无需盯着那块小屏幕。5.1 Web界面开发基础RadioScript的Web界面基于HTML、CSS和JavaScript并通过其特有的#id语法实现前后端通信。当你在脚本中输出一个HTML字符串时浏览器会将其渲染为页面。基本框架一个最简单的Web界面脚本如下‘ 启用Web GUI GUION ‘ 输出HTML到浏览器 PRINT “h1我的收音机控制台/h1” PRINT “button onclick’#btn1’切换FM/AM/button” WAIT ‘ 处理来自前端的按钮点击事件 [btn1] ‘ 这里可以写切换模式的代码 PRINT “p模式已切换/p” RETURN当用户点击网页上的按钮时浏览器会向设备发送一个#btn1的请求从而触发脚本中[btn1]标签下的子程序执行。使用AJAX实现动态更新为了在不刷新整个页面的情况下更新部分内容如实时信号强度我们需要使用AJAX。RadioScript简化了这个过程。PRINT “{ajax:rssi}” ‘ 定义一个名为“rssi”的AJAX更新区域 PRINT “div id’rssi’信号强度--/div” ‘ 设置一个定时器每秒更新一次AJAX区域 timerCB 1000, [UPDATE_RSSI] [UPDATE_RSSI] rssi_val RX.RSSI() * 2 ‘ 更新id为“rssi”的div内容 AJAX “rssi”, “信号强度” STR(rssi_val) “ dBuV” RETURN5.2 实战创建全功能远程控制台让我们设计一个包含频率调谐、模式切换、音量控制、信号仪表和预设电台功能的完整Web控制台。‘ 全功能Web收音机控制台 GUION ‘ 设置页面标题和样式 PRINT “!DOCTYPE htmlhtmlheadtitleRadioScript Remote/title” PRINT “meta name’viewport’ content’widthdevice-width, initial-scale1’” PRINT “style” PRINT “body {font-family: sans-serif; background: #f0f0f0; padding:20px;} PRINT “.control {background: white; padding:15px; margin:10px; border-radius:10px; box-shadow:2px 2px 5px #ccc;} PRINT “button {padding:10px 20px; margin:5px; font-size:16px; border-radius:5px; border:none;} PRINT “.tune-btn {background:#4CAF50; color:white;} PRINT “.preset-btn {background:#2196F3; color:white;} PRINT “.meter {height:20px; background:linear-gradient(to right, red, yellow, green); border-radius:3px; margin-top:5px;} PRINT “/style/headbody” PRINT “h1 RadioScript 远程控制台/h1” ‘ —————— 模式与频率控制 —————— PRINT “div class’control’h2调谐/h2” PRINT “模式button onclick’#setmodefm’FM/buttonbutton onclick’#setmodeam’AM/buttonbr” PRINT “频率input type’number’ id’freq’ step’0.1’ value’98.5’ MHz “ PRINT “button class’tune-btn’ onclick’#setfreq’设置/button” PRINT “button class’tune-btn’ onclick’#seekup’向上搜台/button” PRINT “button class’tune-btn’ onclick’#seekdown’向下搜台/button” PRINT “/div” ‘ —————— 音量控制 —————— PRINT “div class’control’h2音量/h2” PRINT “input type’range’ id’vol’ min’0’ max’63’ value’20’ onchange’#setvol’” PRINT “span id’voltext’20/span” PRINT “/div” ‘ —————— 信号仪表 (AJAX实时更新) —————— PRINT “div class’control’h2信号状态/h2” PRINT “div强度span id’rssival’--/span dBuV/div” PRINT “div class’meter’div id’rssibar’ style’width:0%; height:100%; background:darkblue;’/div/div” PRINT “div信噪比span id’snrval’--/span dB/div” PRINT “{ajax:meters}” ‘ 定义AJAX更新区域 PRINT “/div” ‘ —————— 预设电台 —————— PRINT “div class’control’h2预设电台/h2” presets [[“新闻台”, 103.9], [“音乐台”, 96.8], [“交通台”, 106.1], [“体育台”, 94.5]] for i 0 to LEN(presets)-1 PRINT “button class’preset-btn’ onclick’#preset” STR(i) “‘” presets[i][0] “ (” STR(presets[i][1]) “MHz)/button ” next i PRINT “/div” PRINT “/body/html” ‘ 初始化收音机 RX 100.0 FREQUENCY 98.5 VOLUME 20 ‘ 启动仪表更新定时器 timerCB 500, [UPDATE_METERS] WAIT ‘ ############################################ ‘ 事件处理子程序 ‘ ############################################ [setmodefm] RX 100.0 PRINT “scriptalert(‘已切换至FM模式’);/script” RETURN [setmodeam] RX 10 ‘ AM模式 PRINT “scriptalert(‘已切换至AM模式’);/script” RETURN [setfreq] freq VAL(GET(“freq”)) ‘ 获取网页输入框的值 FREQUENCY freq PRINT “scriptalert(‘频率已设为’ ” STR(freq) “ ‘MHz’);/script” RETURN [seekup] RX.SEEK(1) delay(1000) ‘ 等待搜台完成 PRINT “scriptalert(‘搜台完成’);/script” RETURN [seekdown] RX.SEEK(-1) delay(1000) PRINT “scriptalert(‘搜台完成’);/script” RETURN [setvol] vol VAL(GET(“vol”)) VOLUME vol AJAX “voltext”, STR(vol) ‘ 更新网页上的音量文本 RETURN [UPDATE_METERS] rssi RX.RSSI() * 2 snr RX.SNR() ‘ 计算信号强度条宽度 (0-100%) bar_width rssi if bar_width 100 then bar_width 100 if bar_width 0 then bar_width 0 ‘ 更新AJAX区域 AJAX “rssival”, STR(rssi) AJAX “snrval”, STR(snr) AJAX “rssibar”, “div style’width:” STR(bar_width) “%; height:100%; background:darkblue;’/div” RETURN ‘ 处理预设按钮 [preset0] FREQUENCY presets[0][1] RETURN [preset1] FREQUENCY presets[1][1] RETURN ‘ … 其他预设类似 …将这个脚本保存为Web_Remote.bas并运行。然后在同一网络下的任何设备浏览器中访问你的MiniRadio IP地址一个功能完整、界面美观的收音机远程控制台就出现了。你可以用手机切换电台、调整音量并实时查看信号质量。注意事项Web界面会占用一定的ESP32资源。如果脚本同时处理复杂的本地图形绘制和频繁的Web请求可能会导致设备响应变慢。在设计中应将耗时的操作如精细扫描和实时性要求高的Web控制分开考虑用不同的脚本实现或者优化Web端的AJAX更新频率。6. 常见问题与深度优化技巧在实际使用RadioScript的过程中你可能会遇到一些典型问题。以下是我在多次项目中总结出的排查清单和进阶技巧。6.1 问题排查速查表问题现象可能原因解决方案无法连接Wi-Fi1. SSID或密码错误。2. 路由器仅支持5GHz。3. 信号太弱。1. 重新配置注意大小写和特殊字符。2. 确保路由器开启了2.4GHz频段。3. 将设备靠近路由器。Web IDE无法访问1. IP地址错误或已变更。2. 设备未成功连接Wi-Fi。3. 浏览器缓存。1. 重新连接设备AP热点查看分配的新IP。2. 检查设备指示灯或重启。3. 尝试浏览器无痕模式或清除缓存。脚本运行无反应1. 语法错误。2. 死循环或WAIT语句位置不当。3. 内存耗尽。1. 检查Web IDE下方的控制台输出常有错误提示。2. 确保主逻辑后有WAIT避免脚本瞬间结束。3. 优化代码避免创建过大的数组或字符串。TFT屏幕显示异常1. 坐标超出屏幕范围。2. 颜色值错误。3. 未调用TFT.cls()清屏。1. 打印坐标值调试确保在0-W和0-H之间。2.TFT.rgb(R,G,B)每个参数应在0-255之间。3. 在绘制新帧前先清屏。收音机无声音或收不到台1. 模式设置错误FM/AM。2. 频率范围不对。3. 天线接触不良。1. 用RX 100.0设FMRX 10设AM。2. FM广播通常在87.5-108MHz。3. 检查天线是否插好或外接一段导线作为天线。编码器/按钮响应不灵1. 事件处理子程序未正确定义。2. 主循环被阻塞。1. 确认onEncoder [标签]中的[标签]子程序存在。2. 避免在子程序中使用长延时delay()改用状态机和定时器。6.2 性能优化与高级技巧当你的脚本变得越来越复杂时以下技巧能帮助你提升稳定性和效率。1. 内存管理ESP32的内存有限。避免在循环中无限增长数组。定期使用变量 []来清空不再需要的大数组。对于字符串拼接如果非常频繁可以考虑分批处理。2. 非阻塞式编程这是事件驱动系统的核心原则。永远不要在事件子程序如[按钮]、[定时器]中使用长时间的delay()。这会阻塞整个系统导致其他事件无法响应。正确的做法是使用状态机‘ 错误示范在事件中延时 [myButton] doSomething() delay(3000) ‘ 阻塞3秒 doSomethingElse() RETURN ‘ 正确示范使用状态机和定时器 state 0 [myButton] state 1 doSomething() timerCB 3000, [nextStep] ‘ 3秒后触发下一步 RETURN [nextStep] if state 1 then doSomethingElse() state 0 endif RETURN3. 利用SI4732高级功能RadioScript允许直接读写寄存器这打开了高级功能的大门。例如你可以通过读取0x0A和0x0B寄存器来获取详细的接收状态字或者通过写0x02寄存器来调整AGC自动增益控制的启动点。深入研究SI4732的数据手册结合RX.READ()和RX.WRITE()你可以实现噪声消除、立体声分离度调整等专业接收机才有的功能。4. 数据持久化RadioScript可以将数据保存到Flash中。使用SAVE “key”, value来保存一个变量使用value LOAD(“key”)来读取。你可以用它来保存用户最后的收听频率、音量设置或自定义的预设电台列表实现断电记忆功能。5. 多脚本管理与调度设备可以存储多个脚本。你可以在一个“主菜单”脚本中通过RUN “另一个脚本名.bas”语句来跳转到其他脚本。这允许你构建一个模块化的应用系统例如一个脚本专门用于频谱扫描另一个用于网络流媒体播放再一个用于硬件测试。
