常见错误与解决办法 基础教程
本章汇总了安装、编译、连接、运行与波形观测等环节的常见错误与解决办法。遇到报错时，建议先按分类在本章中查找，大部分错误都能找到现成的排查步骤；操作类疑问请查阅《常见问题解答》章节。
安装错误
安装时找不到 MATLAB
解决方法
重新安装 MATLAB，并重启电脑。
编译(Build)按钮为灰色无法点击
安装路径选择不当导致插件安装不完整
若将 InsRealm 安装到 MATLAB 根目录等受系统权限保护的目录，安装过程中部分文件可能无法正常写入，导致插件安装不完整、Build 按钮无法点击。
解决方法卸载后重新安装到独立的普通目录（路径不含中文与空格，如 D:\InsRealm），并确保安装过程顺利完成。
缺少必要的 MATLAB 工具箱
Build 按钮为灰色，一般是由于没有安装 InsRealm 依赖的必要工具箱导致的。请确认以下工具箱均已安装：
- Simulink、Simulink Coder
- MATLAB Coder、Embedded Coder
- HDL Coder
- Simscape、Simscape Electrical
解决方法在 MATLAB 中补装缺少的工具箱后重试；重新安装 InsRealm 插件时，安装程序也会自动检测依赖是否齐全。
使用了 Simulink 自带模板
原因
Simulink 自带的模板无法直接编译，需要配置若干参数后才能使用。建议直接使用 My Templates 中的 “RTScale CPU model template” 模板新建模型。
解决方法
在 MATLAB 主界面点击 Simulink 按钮，在 My Templates 中选择 “RTScale CPU model template” 模板创建模型即可。
常见编译报错
本节汇总各环节的常见报错与异常现象。每个小节对应一种问题，按提示查找对应的原因与解决方法。
工作目录位于插件安装路径下，无法编译
报错内容Model cannot be built inside InsRealm path. Please change path.
原因
当 MATLAB 的当前工作目录位于 INSREALM 插件的安装路径下时，模型会编译失败。
解决方法
将模型放到插件安装路径以外的其他目录下，然后重新编译。
缺少 System 模块导致编译报错
报错内容There must be a System block in the model when firmware blocks are used.
原因
模型中缺少 System 模块时无法编译。
解决方法
在模型中添加 System 模块即可。
插入了其他产品库的同名模块
报错内容：Firmware blocks for other targets should not exist in this model for RTScale target. Please remove them.
原因
RTPI 与 RTScale 两款产品的 Simulink 库中都包含 PWM 等同名功能模块。如果通过在模型空白处双击并直接搜索 “PWM” 的方式插入模块，可能因库路径优先级或模块来源不同，插入与当前目标平台不匹配的模块，从而引发配置错误或运行异常。
因此，建议始终从对应产品的专用库目录中选择并拖入 PWM 模块，确保模块版本与目标硬件平台一致，避免后续编译或运行问题。
解决方法
检查模块来源，确保插入的所有模块均来自 RTScale 库。
编译时提示“上传比特流失败”
可能是设备处于异常状态。重启 RTScale 后重试即可。
模型步长设置不正确
1. 报错内容为：Step time of this model is too small or it is not correct, please check. \nIf you are using variable as step time, please make sure this variable is defined.
2. 报错内容为：Step time of this model cannot be assigned as auto, please check..
原因
当模型步长被设为 auto 时会报错。在 RCP 模式下运行模型须同时满足两个条件：一是采用固定步长（Fixed-step）模式，二是步长不小于 2 微秒。
解决方法
在 Model Settings 中将 Fixed-step size (fundamental sample time) 设置为合适的值。
实际输出的DAC频率与设定值不一致
原因
若运行中 DAC 实际输出频率与设定值存在偏差，应首先确认界面右下角的时间显示是否处于实时运行状态，并检查 System 模块的输出值是否为负。输出为负通常意味着系统未满足实时性要求，可能存在计算超时。
解决方法
适当增大模型步长。
PWM interrupt 模式下的报错
报错内容The adc trigger is selected as PWM1, but there is no that block in this model. Please check the adc trigger in system block.
报错内容In PWM interrupt mode, the trigger of adc should be selected as PWM.
报错内容In the current configuration of adc trigger, the period of PWM1 must be the same with model step time.
原因
当 Tick Trigger 选择为 PWM Interrupt 模式时，ADC 的采样由 PWM 模块触发并与之同步，因此模型中必须包含 PWM 模块；同时需将模型步长设置为与 PWM 开关周期相等的值，以保证系统时序与开关频率一致。
设备异常
无法连接到设备
可按以下步骤逐项排查：
确认电脑与 RTScale 之间已用网线连接，且网线必须接在 RTScale 的 HOST 网口上；
查看 RTScale 的 HOST 网口指示灯是否点亮；若不亮，请检查电脑网口是否正常，或更换电脑重试；
确认电脑 IP 与 RTScale IP 处于同一网段，且电脑的IP不能和仿真机的IP相同；设置完成后，点击 INSREALM 插件栏中的 Check Target 进行通讯测试；
检查模型的 IP 设置：打开 INSREALM 插件栏的 Model Settings，确认 Interface 页 MEX-file arguments 中的 IP，以及 InsRealm 页中的 IP Address，是否与 RTScale 处于同一网段。
模型IP设置
运行模型后 PWM 无输出
原因
- 未使能 System 模块；
- 实际测量的 PWM 通道与模块中配置的通道不一致；
- System 模块的 GPIO Direction Setting 被配置为 Input（输入）。
解决方法
- 将 System 模块的 en 输入置为 1（使能）；
- 确认实际测量的 PWM 通道与配置一致；
- 将相关 GPIO 的方向修改为输出，设置方法参考《常见问题解答 · 如何设置 GPIO 的方向》。
其他
模型运行中无法实时修改 Constant 等模块的参数
原因
Model Settings 中的 Default parameter behavior 被设置为了 Inlined。
解决方法
将其改为 Tunable 即可。
SCOPE 波形断连
原因
- 使用了百兆网线，上传带宽不足；
- USB 转网口速率不足，或被插在了电脑的 USB 2.0 接口上；
- 经过的网络交换机为百兆；
- 实时模型中放置了过多示波器。
解决方法
- 将网线、交换机等设备全部更换为千兆规格；若使用 USB 转网口，请插在 USB 3.0 接口上；
- 在实时模型中注释掉不常用或无用的示波器；若仍然断波，可在 System 模块中将上传频率由默认的 10 K 降为 5 K。
