简介：这份资源是 Truetime 2.0 的中文使用说明文档，面向从事网络化运动控制仿真研究的 MATLAB 用户，尤其是需要解决资源调度问题的研究生与工程技术人员。Truetime 2.0 是基于 MATLAB 的网络化控制系统工具箱，可用于模拟和优化各类运动控制系统。文档围绕工具箱的下载安装、路径与环境变量配置、Kernel、Simulator、Controller 等模块说明展开，并涉及最大误差优先调度、优先级反馈控制等运动控制知识点，以及 mex 编译器设置等 MATLAB 操作要点。资源包内共 1 个 docx 文件，约 402KB，内容以图文步骤形式呈现，便于对照操作。目前已有 1586 人学习下载，适合刚接触 Truetime 仿真、需要快速完成环境搭建与模块理解的学习者参考。
1. 从一次编译失败说起：TrueTime 2.0 到底解决什么问题
如果你在 MATLAB 里跑过网络化控制系统的仿真，大概率遇到过这样的场景：控制器和被控对象明明都是对的，但一加入网络环节，时序就全乱了。传感器采样、控制器计算、执行器动作，这三者之间的延迟和丢包到底怎么建模，用 Simulink 自带的模块搭起来非常别扭。TrueTime 2.0 就是冲着这个问题来的——它是一套基于 MATLAB/Simulink 的实时控制与网络仿真工具箱，核心能力是把计算节点、网络链路、调度策略这些东西做成可配置的模块，让你在仿真层面复现真实网络化运动控制系统的行为。
这份《truetime2.0使用说明.docx》记录的是从零安装到跑通仿真的完整流程，包括工具箱下载、路径配置、环境变量设置、编译器对接、make_truetime 编译验证等关键步骤。适合两类人：一是做网络化控制系统研究、需要快速搭建仿真环境的研究生和工程师；二是已经在用 MATLAB 做运动控制仿真、但被网络延迟和调度问题卡住的从业者。下面我按实际操作的顺序，把这份说明里的关键步骤拆开讲，顺便补上原文没展开但实际会踩到的坑。
2. 安装与路径配置：从解压到 setpath 的完整链路
2.1 工具箱获取与目录结构
TrueTime 2.0 的官方发布渠道是隆德大学的控制系网站，原文给出的地址是http://www.control.lth.se/truetime/，上面可以免费申请下载，最新版本标注为 TrueTime 2.0 beta 1。下载下来是一个压缩包，解压后得到truetime-2.0文件夹。
这个文件夹里最核心的是kernel目录，里面包含四个关键文件：init_truetime.m、make_truetime.m、以及编译所需的源文件。原文特别强调了一点——在 MATLAB 的 setpath 里添加路径时，最好把 kernel 下的四个文件都包含进去，而不是只包含到 kernel 文件夹。这个建议是有道理的：TrueTime 的初始化脚本和编译脚本之间存在依赖关系，如果路径只加了一半，make_truetime执行时可能找不到某些依赖文件，报错信息又不直观，排查起来很费时间。
我一般会这样做：先把truetime-2.0整个文件夹复制到 MATLAB 安装目录的toolbox下，比如D:\Program Files\MATLAB\R2017b\toolbox\truetime-2.0。然后打开 MATLAB，在命令行执行：
% 添加 TrueTime 核心路径到 MATLAB 搜索路径 addpath('D:\Program Files\MATLAB\R2017b\toolbox\truetime-2.0\kernel'); % 保存路径设置，避免每次重启 MATLAB 后失效 savepath;这里addpath的作用是把 kernel 目录加入当前会话的搜索路径，savepath则把当前路径状态写入pathdef.m，下次启动 MATLAB 时自动生效。如果你只想临时用一次，可以不加savepath，但做项目的话建议加上。
2.2 环境变量与启动脚本的配合
原文在配置部分提到了设置环境变量，具体操作是在 Windows 系统属性里新建系统变量。这一步的目的是让 TrueTime 的编译脚本能找到 GCC 编译器的位置。原文作者用的是tdm64-gcc-5.1.0-2.exe，在 Win7 64 位系统上测试通过。
环境变量设置完之后需要重启电脑，这一步不能省。原因是 MATLAB 启动时会读取系统环境变量，如果不重启，新加的变量不会生效，后面mex -setup可能找不到编译器。
接下来是启动脚本的处理。原文提到了两个文件：startupsav.m和matlabrc.m。操作逻辑是这样的：
% 在 MATLAB 中打开 matlabrc.m（位于 toolbox/local 目录下） % 不做任何修改，直接另存为 matlab.mat，保存到同一目录 % 然后将 truetime-2.0/kernel 下的 init_truetime.m % 复制到 toolbox/local 文件夹中这里为什么要复制init_truetime.m到 local 目录？因为 MATLAB 启动时会自动执行matlabrc.m和startup.m中的内容，把init_truetime.m放到 local 目录下，可以确保 TrueTime 的初始化代码在 MATLAB 启动阶段就被加载。原文作者提到他是在startup.m中修改的，效果一样。两种方式都可以，关键是保证init_truetime在 MATLAB 启动时被调用。
注意：如果你之前已经有一个
startup.m文件，不要直接覆盖，先把原来的内容备份，再把init_truetime的调用加进去。
2.3 编译器对接与 make_truetime 验证
编译器这一步是整个安装过程中最容易翻车的地方。原文作者明确说了，他在网上找的编译器一直不成功，最后用了tdm64-gcc-5.1.0-2.exe才通过。这说明 TrueTime 2.0 对 GCC 版本是有要求的，太新或太旧的版本都可能导致编译失败。
安装完 GCC 之后，在 MATLAB 命令行执行：
% 设置 MATLAB 使用的编译器 mex -setup % 根据提示选择已安装的 GCC 编译器 % 然后执行 TrueTime 的编译脚本 make_truetimemex -setup会列出 MATLAB 检测到的所有可用编译器，你需要从中选择 GCC 对应的选项。如果列表里没有出现 GCC，说明环境变量没配好，或者 GCC 安装路径没加入系统 PATH。
make_truetime是 TrueTime 自带的编译脚本，它会调用 GCC 把 kernel 目录下的 C 源文件编译成 MATLAB 可调用的 mex 文件。执行过程中如果出现警告，原文说可以先不用管，只要最后出现successful字样就表示配置成功。这个判断标准是可靠的——TrueTime 的编译脚本在成功时会打印明确的成功信息，警告通常来自编译器版本差异或未使用的变量，不影响核心功能。
编译成功后，在命令行输入truetime，会弹出一个 TrueTime 的工作窗口。这个窗口是工具箱的入口，里面可以创建新的仿真项目、打开示例模型、查看模块库。到这里，安装和配置就算完成了。
3. 模块体系与仿真搭建：Kernel、Simulator、Controller 怎么配合
3.1 核心模块的功能划分
TrueTime 2.0 的模块体系围绕三个核心概念展开：Kernel、Simulator、Controller。原文在 1.3 节提到“这部分太长不说了”，但从实际使用角度看，理解这三个模块的分工是搭建仿真模型的前提。
Kernel 模块代表一个计算节点，它负责执行控制任务、管理任务队列、处理中断。你可以把它理解为一个“虚拟计算机”，里面可以配置 CPU 速度、调度策略、任务优先级等参数。Simulator 模块是仿真环境的核心，它负责推进仿真时间、协调各节点之间的通信、记录仿真数据。Controller 模块则是控制算法的载体，你可以在里面写 PID、状态反馈、模型预测控制等算法。
这三个模块的关系是：Controller 产生控制信号，Kernel 负责调度和执行，Simulator 负责在它们之间传递数据并推进时间。搭建一个最简单的网络化控制系统仿真，至少需要一个 Controller 节点、一个被控对象节点、以及连接它们的网络链路。
3.2 一个最小可跑通的仿真示例
下面这段代码展示了一个基本的 TrueTime 仿真初始化流程。注意，TrueTime 的仿真通常是在 Simulink 模型里搭建的，但初始化参数需要在 MATLAB 脚本里设置：
% 初始化 TrueTime 仿真环境 ttInitKernel('prioFP'); % 使用固定优先级调度 % 创建一个周期任务 period = 0.010; % 采样周期 10ms offset = 0.0; % 任务偏移 prio = 1; % 优先级 ttCreatePeriodicTask('ctrl_task', offset, period, prio, 'ctrl_code'); % 创建网络链路 ttCreateNetwork('CAN', 500000); % CAN 总线，500kbps % 启动仿真 ttSim;这段代码的逻辑是：先调用ttInitKernel初始化内核，参数'prioFP'表示使用固定优先级调度策略。然后创建一个周期任务，任务名为ctrl_task，周期 10ms，优先级为 1，任务体在ctrl_code函数中定义。接着创建一条 CAN 总线，波特率 500kbps。最后调用ttSim启动仿真。
参数说明：period决定了控制回路的采样频率，10ms 对应 100Hz，适合大多数运动控制场景。prio是任务优先级，数值越小优先级越高。ttCreateNetwork的第一个参数是网络类型，TrueTime 支持 CAN、以太网等多种网络模型，第二个参数是网络速率。
3.3 调度策略的选择与影响
TrueTime 2.0 支持多种调度策略，原文摘要里提到了“最大误差优先调度”和“优先级反馈控制”。这些策略的选择直接影响仿真结果的真实性。
固定优先级调度（prioFP）是最简单的一种，每个任务分配一个固定优先级，高优先级任务抢占低优先级任务。这种策略的优点是实现简单、分析方便，缺点是当任务集较大时，低优先级任务可能长时间得不到执行。
最大误差优先调度（MEF）是一种动态策略，它根据控制误差的大小来决定任务优先级。误差大的回路优先执行，误差小的回路可以延后。这种策略在网络化控制系统中比较常见，因为网络带宽有限，不可能所有回路都同时以最高频率运行。
在 TrueTime 里切换调度策略，只需要修改ttInitKernel的参数：
% 使用最大误差优先调度 ttInitKernel('MEF');但要注意，不同调度策略对任务参数的要求不同。比如 MEF 需要你为每个任务指定误差计算函数，否则调度器无法判断优先级。这些细节在原文里没有展开，但实际使用时必须处理。
4. 避坑与排查：安装和仿真中最容易翻车的五个点
4.1 编译报错找不到 GCC
现象：执行mex -setup时，列表里没有 GCC 选项，或者执行make_truetime时报错“未找到编译器”。
原因：GCC 安装后没有加入系统 PATH，或者环境变量设置后没有重启电脑。MATLAB 启动时读取的是系统环境变量，不重启的话新变量不生效。
解决：确认 GCC 安装目录下的bin文件夹已加入系统 PATH，然后重启电脑。重启后在命令行执行gcc --version，如果能输出版本号，说明 PATH 配置正确。再打开 MATLAB 执行mex -setup，应该就能看到 GCC 选项了。
4.2 make_truetime 编译到一半卡住
现象：执行make_truetime后，命令行输出一堆编译信息，然后停住不动，或者报错“无法打开某个 .c 文件”。
原因：TrueTime 的编译脚本依赖 kernel 目录下的源文件，如果 setpath 只添加了部分路径，或者 kernel 目录被移动过，编译脚本就找不到源文件。
解决：检查 setpath 里是否包含了 kernel 目录下的所有四个文件。最稳妥的做法是把truetime-2.0整个文件夹放在 toolbox 下，然后把 kernel 目录完整加入路径。如果之前移动过文件夹，重新执行addpath和savepath。
4.3 仿真运行时提示“未定义函数 ttInitKernel”
现象：在 MATLAB 脚本里调用ttInitKernel时，报错“未定义函数或变量”。
原因：TrueTime 的路径没有正确加载，或者init_truetime.m没有在启动时执行。
解决：在命令行手动执行init_truetime，看是否能正常加载。如果手动执行可以，但重启 MATLAB 后又不行，说明init_truetime.m没有放到toolbox/local目录下，或者startup.m里没有调用它。检查 local 目录下是否有init_truetime.m，以及startup.m里是否有一行init_truetime;。
4.4 仿真结果与预期不符
现象：仿真跑完了，但控制效果很差，或者任务执行顺序混乱。
原因：调度策略和任务参数不匹配。比如用了固定优先级调度，但任务优先级设置反了（数值大的反而先执行），或者采样周期设置得太长，导致控制回路响应迟钝。
解决：先检查ttInitKernel的调度策略参数，确认与任务优先级设置一致。然后检查每个任务的period和prio，确保高优先级任务的周期更短。如果用的是 MEF 调度，检查误差计算函数是否正确实现。
4.5 网络链路参数设置不合理
现象：仿真中网络延迟很大，或者数据包大量丢失。
原因：网络速率设置得太低，或者网络负载超过了带宽上限。
解决：根据实际系统的通信需求调整网络速率。CAN 总线常用 500kbps 或 1Mbps，以太网可以设到 100Mbps。如果仿真中丢包严重，说明网络负载过高，需要降低任务频率或增加网络带宽。TrueTime 的网络模块支持配置丢包率和延迟分布，这些参数需要根据实际网络环境来设定，不能随便填。
5. 进阶技巧：用 TrueTime 做网络化运动控制的参数扫描
安装和基本仿真跑通之后，TrueTime 真正有价值的地方在于它可以做参数扫描和对比实验。比如你想知道采样周期从 10ms 降到 5ms 对控制性能有多大提升，或者网络延迟从 1ms 增加到 5ms 时系统是否还能稳定，这些都可以用 TrueTime 批量跑仿真来回答。
我一般会写一个外层脚本，把关键参数做成变量，然后循环调用仿真：
% 参数扫描：采样周期从 5ms 到 20ms periods = [0.005, 0.010, 0.015, 0.020]; results = zeros(length(periods), 3); % 存储 [周期, 超调量, 调节时间] for i = 1:length(periods) % 设置当前采样周期 assignin('base', 'T_sample', periods(i)); % 运行 Simulink 模型 sim('networked_ctrl_model'); % 提取性能指标 results(i, 1) = periods(i); results(i, 2) = max(yout) - 1; % 超调量 results(i, 3) = compute_settling_time(yout, t); % 调节时间 end % 打印结果 disp('周期(s) 超调量 调节时间(s)'); disp(results);这段代码的逻辑是：定义一个采样周期数组，循环修改 Simulink 模型中的T_sample变量，每次运行仿真后提取超调量和调节时间，最后汇总打印。assignin的作用是把变量写入基础工作区，这样 Simulink 模型就能读到最新的参数值。
参数说明：periods数组里的值根据你的实际系统来定，一般从系统带宽的 10 倍到 50 倍之间选取。compute_settling_time是一个自定义函数，用来计算输出进入稳态误差带的时间，你可以根据具体需求实现。
跑完参数扫描后，把结果画成曲线，就能直观看到采样周期对控制性能的影响。这种分析在论文里很常见，也是 TrueTime 相比手写仿真代码的优势所在——它把网络和调度的细节封装好了，你只需要关注控制参数本身。
还有一个实用技巧：TrueTime 的仿真数据可以导出到 MATLAB 工作区，用ttGetLog命令获取。导出的数据包括任务执行时间、网络传输延迟、数据包丢失记录等，这些数据对于分析系统瓶颈非常有用。我通常会把日志数据保存成 mat 文件，方便后续用脚本批量处理。
从那以后我每次配置 TrueTime 环境，都会先把make_truetime的完整输出保存到日志文件里，万一编译失败，翻日志比凭记忆排查快得多。希望帮到你。
本文还有配套的精品资源，点击获取
