智慧城市沙盘模型多系统协同控制系统设计：基于STM32与Modbus RTU的园区-城市-数字孪生联动方案

智慧城市沙盘模型与智慧园区沙盘模型涉及城市全景（功能分区、交通网络、公共设施、生态绿地）、智慧园区（研发办公、智能制造、仓储物流、商业配套、智能安防、智慧能源、智慧交通）、数字孪生（虚实双向映射、实时数据可视化、智能调度）等多个系统的协同控制与动态演示。一套完整的智慧城市沙盘控制系统，需要同时驱动多路灯带时序演示交通流、数据流、能源流、安防流等多条路径的协同运行，多路信号联动展示"日常运营""高峰管理""应急响应""节能模式"等多种工况，同时预留数据接口实现与数字孪生平台的双向通信。与工业生产线沙盘（聚焦物料路径的接力联动）不同，智慧城市沙盘控制系统的核心是"物理空间-数据流-智能决策"三层架构的协同------城市或园区的物理空间怎么呈现、数据怎么流动、智能系统怎么响应，每个环节的控制逻辑必须与实际智慧城市或智慧园区的运营逻辑一致。

本文结合筑城世纪模型在工业沙盘控制系统开发中的项目经验（2008年成立，2000㎡制作工厂，控制系统自主研发，已为华北电力大学、国机集团、巴斯夫、国家电网、清华大学等500+企事业单位提供服务），梳理智慧城市沙盘模型多系统协同控制系统的设计与实现方案，涵盖系统架构、硬件选型、多路径灯带时序控制、多工况切换逻辑、Modbus RTU寄存器映射、数字孪生数据对接及代码实现。

一、智慧城市沙盘控制系统的技术需求

智慧城市沙盘的控制系统需求与普通工业沙盘有显著差异：

功能模块 技术要求 实现难度

多路径协同时序演示 交通流、数据流、能源流、安防流等多条路径按城市运行逻辑时序流动 高

多工况模式切换 日常运营/高峰管理/应急响应/节能模式，一键切换 高

分区独立控制 行政办公区、商业区、居住区、工业区、生态区独立亮灯展示 中

数字孪生数据对接 支持Modbus RTU/MQTT协议，与数字孪生平台双向通信 中高

虚实双向映射 物理沙盘状态映射至数字孪生平台，平台指令驱动沙盘响应 中高

多色路径区分 不同颜色灯带区分数据流、交通流、能源流、安防流 中

筑城世纪模型的工业沙盘控制系统方案，基于上述需求，采用STM32+Modbus RTU架构，已在多套沙盘项目中完成部署验证。

二、为什么智慧城市沙盘必须用STM32+Modbus RTU方案

智慧城市沙盘的控制系统有几个特殊要求：

第一，多路径协同时序控制的复杂度高。 智慧城市沙盘需要同时呈现交通流、数据流、能源流、安防流等多条路径的协同运行，各路径之间的时序逻辑需与实际城市运行逻辑对应。STM32的中断响应精度可达1ms级，配合状态机编程可实现复杂的多路径时序调度。

第二，多工况模式切换灵活。 智慧城市沙盘需要支持"日常运营""高峰管理""应急响应""节能模式"等多种工况的一键切换。STM32方案通过寄存器在线切换工况，无需重编译代码。

第三，数字孪生数据对接是核心需求。 智慧城市沙盘通常需要与数字孪生平台或园区IBMS平台对接，实现物理沙盘与数字孪生体的双向同步。STM32方案支持Modbus RTU协议，可通过MQTT等协议与第三方平台对接。

STM32 vs PLC 选型对比

对比项 PLC方案 STM32方案

硬件成本 8000-15000元 800-1500元

时序控制精度 10-20ms扫描周期 1ms中断响应

多路径协同控制 梯形图实现困难 C语言状态机灵活可控

多段灯带控制 需专用通讯模块 GPIO直接驱动WS2812B

多工况切换 需复杂梯形图逻辑 寄存器在线切换

数字孪生对接 需额外网关模块 串口直接输出MQTT/Modbus

后期修改 需编程软件授权 寄存器在线修改

为什么用RS485/Modbus RTU？

智慧城市沙盘模型内部设备分布广泛（多分区、多系统），RS485总线支持多点通讯（理论32个节点），一线串接所有设备，布线简洁。Modbus RTU是工业标准协议，支持接入数字孪生平台、IBMS平台等第三方设备。

三、系统架构设计

3.1 总体架构

text

┌─────────────────────────────────────────────────────────────────┐

│ 数字孪生平台/IBMS（数据可视化 + 远程控制） │

│ 实时数据展示 智能调度 远程指令下发 │

└─────────────────────────┬───────────────────────────────────────┘

│ MQTT/Modbus RTU（4G/WiFi网关）

┌─────────────────────────▼───────────────────────────────────────┐

│ 触摸屏/中控平板（Modbus RTU 主站） │

│ 工况切换 速度调节 分区控制 模式切换 │

└─────────────────────────┬───────────────────────────────────────┘

│ RS485（9600,8N1,120Ω终端电阻）

┌─────────────────────────▼───────────────────────────────────────┐

│ STM32F103RCT6 从站（边缘计算网关） │

│ 指令解析 → 状态机调度 → GPIO/单总线输出 │

└───────┬─────────┬─────────┬─────────┬───────────────────────────┘

│ │ │ │

┌───▼───┐ ┌───▼───┐ ┌───▼───┐ ┌───▼───┐

│交通流 │ │数据流 │ │能源流 │ │安防流 │

│灯带 │ │灯带 │ │灯带 │ │灯带 │

│(绿色) │ │(蓝色) │ │(橙色) │ │(红色) │

└───────┘ └───────┘ └───────┘ └───────┘

3.2 硬件选型

组件 选型 数量 选型理由

主控MCU STM32F103RCT6 1 256KB Flash，51个GPIO，3个USART

通讯接口 MAX485ESA 1 RS485收发器，工业级抗干扰

灯带 WS2812B（60灯/米） 依路径数 单总线控制，每灯独立寻址

数据网关 ESP8266/4G模块 1 WiFi/4G上云，MQTT协议

电源 24V→5V隔离模块 1 隔离供电

中控屏 7寸串口屏 1 支持Modbus RTU主站协议

3.3 GPIO分配表（以典型智慧城市沙盘为例）

端口 功能 信号类型 说明

PA9/PA10 USART1 通讯 与中控屏RS485通讯

PA2/PA3 USART2 通讯 预留与4G/WiFi网关通讯

PB0 交通流路径灯带 单总线输出 WS2812B（绿色）

PB1 数据流路径灯带 单总线输出 WS2812B（蓝色）

PB2 能源流路径灯带 单总线输出 WS2812B（橙色）

PB3 安防流路径灯带 单总线输出 WS2812B（红色）

PB4 行政办公区灯带 单总线输出 WS2812B（分区标识）

PB5 商业区灯带 单总线输出 WS2812B（分区标识）

PB6 居住区灯带 单总线输出 WS2812B（分区标识）

PB7 生态区灯带 单总线输出 WS2812B（分区标识）

四、Modbus寄存器映射设计

以下为智慧城市沙盘控制系统的寄存器定义（共32个保持寄存器）：

4.1 系统控制寄存器（40001-40008）

寄存器地址 偏移地址 功能 数据类型 读写 取值范围 说明

40001 0x0000 系统启停 bit R/W 0/1 0=停止，1=启动

40002 0x0001 运行模式 uint16 R/W 1-4 1=日常运营，2=高峰管理，3=应急响应，4=节能模式

40003 0x0002 当前场景 uint16 R 0-4 0=待机，1=城市全景，2=智慧园区，3=数字孪生，4=全场景

40004 0x0003 速度档位 uint16 R/W 1-5 档位越高，演示节奏越快

40005 0x0004 循环模式 uint16 R/W 0/1 0=单次，1=无限循环

40006 0x0005 系统状态 uint16 R 0-3 0=停止，1=运行中，2=告警，3=故障

40007 0x0006 数字孪生对接开关 bit R/W 0/1 0=关闭，1=开启

40008 0x0007 固件版本 uint16 R --- 只读

4.2 路径控制寄存器（40009-40016）

寄存器地址 偏移地址 功能 数据类型 读写 说明

40009 0x0008 交通流灯带 bit R/W 1=点亮（绿色）

40010 0x0009 数据流灯带 bit R/W 1=点亮（蓝色）

40011 0x000A 能源流灯带 bit R/W 1=点亮（橙色）

40012 0x000B 安防流灯带 bit R/W 1=点亮（红色）

40013 0x000C 行政办公区灯带 bit R/W 1=点亮

40014 0x000D 商业区灯带 bit R/W 1=点亮

40015 0x000E 居住区灯带 bit R/W 1=点亮

40016 0x000F 生态区灯带 bit R/W 1=点亮

4.3 参数寄存器（40017-40032）

寄存器地址 偏移地址 功能 数据类型 读写 说明

40017 0x0010 路径流速 uint16 R/W 1-100，灯带流动速度

40018 0x0011 交通流量模拟 uint16 R 0-100，模拟实时交通流量

40019 0x0012 数据吞吐量模拟 uint16 R 0-100，模拟实时数据流量

40020 0x0013 能耗指数模拟 uint16 R 0-100，模拟实时能耗水平

40021 0x0014 安防等级模拟 uint16 R 0-100，模拟实时安防状态

40022 0x0015 人流密度模拟 uint16 R 0-100，模拟实时人流密度

40023-40032 0x0016-0x001F 保留寄存器 --- --- 预留扩展

五、核心代码实现

5.1 Modbus从站初始化与多路径控制

cpp

#include "ModbusRTU.h"

#include "Adafruit_NeoPixel.h"

#define SLAVE_ID 1

#define BAUD_RATE 9600

// 灯带GPIO定义（WS2812B）

#define LED_TRAFFIC PB0 // 交通流灯带（绿色）

#define LED_DATA PB1 // 数据流灯带（蓝色）

#define LED_ENERGY PB2 // 能源流灯带（橙色）

#define LED_SECURITY PB3 // 安防流灯带（红色）

#define LED_ADMIN PB4 // 行政办公区灯带

#define LED_COMMERCIAL PB5 // 商业区灯带

#define LED_RESIDENTIAL PB6 // 居住区灯带

#define LED_ECO PB7 // 生态区灯带

#define PATH_NUM 4 // 4条路径：交通/数据/能源/安防

#define AREA_NUM 4 // 4个分区：行政/商业/居住/生态

ModbusRTU mb;

uint16_t holdingRegs32 = {0};

// 各工况演示时长（ms）

uint16_t modeDurations4 = {8000, 6000, 5000, 7000};

uint16_t baseDurations4 = {8000, 6000, 5000, 7000};

// 状态机变量

enum SystemState { STOPPED, RUNNING, PAUSED, FAULT };

SystemState currentState = STOPPED;

volatile uint8_t currentMode = 0;

volatile unsigned long modeStartTime = 0;

volatile uint16_t modeElapsedMs = 0;

// 灯带对象（8路）

Adafruit_NeoPixel strips8 = {

Adafruit_NeoPixel(LED_COUNT, LED_TRAFFIC, NEO_GRB + NEO_KHZ800),

Adafruit_NeoPixel(LED_COUNT, LED_DATA, NEO_GRB + NEO_KHZ800),

Adafruit_NeoPixel(LED_COUNT, LED_ENERGY, NEO_GRB + NEO_KHZ800),

Adafruit_NeoPixel(LED_COUNT, LED_SECURITY, NEO_GRB + NEO_KHZ800),

Adafruit_NeoPixel(LED_COUNT, LED_ADMIN, NEO_GRB + NEO_KHZ800),

Adafruit_NeoPixel(LED_COUNT, LED_COMMERCIAL, NEO_GRB + NEO_KHZ800),

Adafruit_NeoPixel(LED_COUNT, LED_RESIDENTIAL, NEO_GRB + NEO_KHZ800),

Adafruit_NeoPixel(LED_COUNT, LED_ECO, NEO_GRB + NEO_KHZ800)

};

void setup() {

SystemClock_Config(); // 72MHz

Serial1.begin(BAUD_RATE);

mb.begin(&Serial1);

mb.slave(SLAVE_ID);

mb.addHreg(0, holdingRegs, 32);

mb.onGet(handleRead);
mb.onSet(handleWrite);

for (int i = 0; i < 8; i++) {
    strips[i].begin();
    strips[i].show();
}

Timer1.initialize(1000);
Timer1.attachInterrupt(stateMachineTick);

}

void loop() {

mb.task(); // Modbus协议处理

}

5.2 多路径协同时序控制

cpp

void stateMachineTick() {

if (currentState != RUNNING) return;

modeElapsedMs++;

// 阶段切换逻辑（多路径协同演示）
if (modeElapsedMs >= modeDurations[currentMode]) {
    modeElapsedMs = 0;
    currentMode++;
    if (currentMode >= 4) {
        if (holdingRegs[4] == 1) currentMode = 0;
        else { currentState = STOPPED; return; }
    }
    switchMode(currentMode);
    holdingRegs[2] = currentMode + 1;
}

// 实时模拟数据更新（供数字孪生平台读取）
updateSimulationData();

}

// 工况切换（多路径协同演示）

void switchMode(uint8_t mode) {

allLightsOff();

// 各工况颜色与路径组合定义
uint32_t pathColors[4] = {
    0x00FF00,  // 交通流（绿色）
    0x0066FF,  // 数据流（蓝色）
    0xFF6600,  // 能源流（橙色）
    0xFF0000   // 安防流（红色）
};

switch(mode) {
    case 0:  // 日常运营模式：四路径协同运行
        for (int i = 0; i < 4; i++) {
            flowLight(strips[i], pathColors[i], 1500);
        }
        // 分区灯带全部点亮（低亮度）
        for (int i = 4; i < 8; i++) {
            dimLight(strips[i], 0xFFFFFF, 50);
        }
        break;
        
    case 1:  // 高峰管理模式：交通流+数据流强化
        flowLight(strips[0], 0x00FF00, 800);   // 交通流加速
        flowLight(strips[1], 0x0066FF, 800);   // 数据流加速
        // 商业区、居住区高亮
        flowLight(strips[5], 0xFFFFFF, 500);
        flowLight(strips[6], 0xFFFFFF, 500);
        break;
        
    case 2:  // 应急响应模式：安防流主导
        flowLight(strips[3], 0xFF0000, 300);   // 安防流快速闪烁
        // 所有分区红色指示
        for (int i = 4; i < 8; i++) {
            for (int p = 0; p < strips[i].numPixels(); p++) {
                strips[i].setPixelColor(p, 0xFF0000);
            }
            strips[i].show();
        }
        break;
        
    case 3:  // 节能模式：能源流优化
        flowLight(strips[2], 0xFF6600, 2000);  // 能源流缓慢流动
        // 仅行政办公区保持低亮度
        dimLight(strips[4], 0xFFFFFF, 30);
        break;
}

}

void flowLight(Adafruit_NeoPixel &strip, uint32_t color, int duration) {

int len = strip.numPixels();

int steps = 20;

for (int step = 0; step < steps; step++) {

strip.clear();

int pos = (len * step) / steps;

strip.setPixelColor(pos, color);

if (pos > 0) strip.setPixelColor(pos - 1, color);

strip.show();

delay(duration / steps);

}

}

void dimLight(Adafruit_NeoPixel &strip, uint32_t color, uint8_t brightness) {

uint8_t r = (color >> 16) & 0xFF;

uint8_t g = (color >> 8) & 0xFF;

uint8_t b = color & 0xFF;

r = (r * brightness) / 255;

g = (g * brightness) / 255;

b = (b * brightness) / 255;

uint32_t dimmed = (r << 16) | (g << 8) | b;

for (int p = 0; p < strip.numPixels(); p++) {

strip.setPixelColor(p, dimmed);

}

strip.show();

}

void allLightsOff() {

for (int i = 0; i < 8; i++) {

stripsi.clear();

stripsi.show();

}

}

// 模拟数据更新（供数字孪生平台读取）

void updateSimulationData() {

static int cycle = 0;

cycle = (cycle + 1) % 100;

// 模拟交通流量（根据工况变化）
uint16_t trafficBase = (holdingRegs[1] == 2) ? 80 : 40;
holdingRegs[17] = trafficBase + (cycle % 30);

// 模拟数据吞吐量
holdingRegs[18] = 50 + (cycle % 40);

// 模拟能耗指数（节能模式下降）
if (holdingRegs[1] == 4) {
    holdingRegs[19] = 20 + (cycle % 15);
} else {
    holdingRegs[19] = 50 + (cycle % 30);
}

// 模拟安防等级（应急模式升高）
if (holdingRegs[1] == 3) {
    holdingRegs[20] = 80 + (cycle % 20);
} else {
    holdingRegs[20] = 20 + (cycle % 20);
}

// 模拟人流密度
holdingRegs[21] = 30 + (cycle % 50);

}

5.3 数字孪生数据对接

cpp

// 数字孪生数据上报（通过串口以JSON格式输出）

void reportToDigitalTwin() {

if (holdingRegs6 != 1) return; // 数字孪生对接开关关闭

String json = "{";
json += "\"mode\":" + String(holdingRegs[1]) + ",";
json += "\"traffic\":" + String(holdingRegs[17]) + ",";
json += "\"data_flow\":" + String(holdingRegs[18]) + ",";
json += "\"energy\":" + String(holdingRegs[19]) + ",";
json += "\"security\":" + String(holdingRegs[20]) + ",";
json += "\"crowd\":" + String(holdingRegs[21]);
json += "}";

Serial2.println(json);  // 通过USART2发送至网关

}

// 寄存器读写回调

uint16_t handleRead(uint16_t offset, uint8_t index) {

// 数字孪生平台读取时，触发数据上报

if (offset >= 17 && offset <= 21 && holdingRegs6 == 1) {

reportToDigitalTwin();

}

return holdingRegsoffset;

}

void handleWrite(uint16_t offset, uint8_t index, uint16_t value) {

switch(offset) {

case 0: // 系统启停

if (value == 1 && currentState != RUNNING) {

currentState = RUNNING;

currentMode = 0;

modeElapsedMs = 0;

switchMode(0);

holdingRegs5 = 1;

} else if (value == 0) {

currentState = STOPPED;

allLightsOff();

holdingRegs2 = 0;

holdingRegs5 = 0;

}

break;

    case 1:  // 运行模式切换
        holdingRegs[1] = value;
        if (holdingRegs[0] == 1) {
            currentMode = value - 1;
            modeElapsedMs = 0;
            switchMode(currentMode);
        }
        break;
        
    case 3:  // 速度档位
        if (value >= 1 && value <= 5) {
            for (int i = 0; i < 4; i++) {
                modeDurations[i] = baseDurations[i] / value;
            }
        }
        break;
        
    case 6:  // 数字孪生对接开关
        holdingRegs[6] = value;
        if (value == 1) {
            // 首次开启时上报当前状态
            reportToDigitalTwin();
        }
        break;
        
    case 8: case 9: case 10: case 11:  // 路径独立控制
        int idx = offset - 8;
        if (value == 1) {
            flowLight(strips[idx], pathColors[idx], 1000);
        } else {
            strips[idx].clear();
            strips[idx].show();
        }
        break;
        
    default:
        holdingRegs[offset] = value;
        break;
}
holdingRegs[offset] = value;

}

六、关键技术细节

6.1 多路径协同时序控制

智慧城市沙盘的核心价值在于"城市运行逻辑讲得清楚"------交通怎么走、数据怎么流、能源怎么配、安防怎么响应。将四条路径映射到不同颜色的灯带，通过状态机依次或协同触发，模拟城市各系统的实时运行状态。

6.2 多工况模式切换设计

智慧城市沙盘需要支持四种工况模式：

模式 寄存器值 功能

日常运营 1 四路径协同运行，分区灯带低亮度

高峰管理 2 交通流+数据流加速，商业区/居住区高亮

应急响应 3 安防流主导，所有分区红色指示

节能模式 4 能源流优化，仅行政办公区低亮度

工况切换时需同步控制路径灯带和分区灯带的状态。

6.3 数字孪生数据对接

智慧城市沙盘通常需要与数字孪生平台对接，实现"物理沙盘→虚拟孪生体"的双向同步。通过USART2以JSON格式输出实时模拟数据（交通流量、数据吞吐量、能耗指数、安防等级、人流密度），经4G/WiFi网关上报至数字孪生平台。寄存器40007（数字孪生对接开关）控制是否上报云端。

6.4 通讯异常处理

策略 实现方式 适用场景

保持当前状态 不改变输出，等待通讯恢复 展厅演示

自动切换安全模式 切换至停止状态 安全要求较高

状态上报 向上位机发送故障码 远程监控

七、现场调试要点

7.1 灯带异常排查

现象 排查方向 解决方案

灯带全亮白光 数据线虚接 重新焊接，确认GPIO输出电平

颜色偏色 电源电压不足 测量末端电压，<4.8V需增加供电点

首灯正常后续不亮 MCU主频配置不当 确认系统时钟72MHz，WS2812B时序正确

多路灯带颜色串扰 GPIO/电源 确认各灯带独立GPIO，电源分开走线

7.2 数字孪生对接异常排查

现象 排查方向 解决方案

数据不上报 串口配置 确认USART2波特率与网关一致

JSON解析失败 数据格式 检查JSON格式是否正确

上报延迟 网关通信 检查4G/WiFi信号强度

7.3 调试工具推荐

调试阶段推荐使用Modbus Poll（Windows）作为主站调试工具，配合USB转RS485转换器连接目标板。数字孪生对接调试可使用串口调试助手查看JSON数据输出格式。

八、工程实践能力

基于STM32平台的多系统协同控制方案，已在筑城世纪多个工业模型项目中完成部署验证：

国机集团柬埔寨燃机联合循环电站沙盘：6级灯光联动、65米灯带，多节点时序控制

华北电力大学火电原理教学沙盘：多路温度、压力传感器采集与多设备联动控制

工业沙盘模型控制系统方案：L1-L3三级配置，覆盖工业模型全谱系

上述项目验证的核心能力（多路灯带独立控制、多路径协同时序、多工况模式切换、Modbus RTU数据对接），与智慧城市沙盘的控制需求一致。

筑城世纪模型在智慧城市沙盘方向具备以下三项核心交付能力：

1. 城市规划图纸理解能力

技术团队具备读懂城市规划图纸和园区设计图纸的能力，能够按图纸精确还原建筑形态、路网结构、功能分区和智能化系统部署逻辑。建筑形态、路网结构、功能分区按图施工。

2. 多路径协同控制能力

控制系统基于STM32平台自主研发，支持多路灯带时序联动、多工况切换（日常运营/高峰管理/应急响应/节能模式）、Modbus RTU数据对接。后期可根据客户需求随时修改控制逻辑和工况模式，无需依赖第三方。

3. 数字孪生数据对接能力

控制系统预留Modbus RTU和MQTT数据接口，支持与数字孪生平台或园区IBMS平台对接，实现物理沙盘与数字孪生体的双向同步。后期可根据需求对接第三方平台。

九、总结

智慧城市沙盘模型多系统协同控制系统的设计，核心在于三个层面：

1. 多路径协同时序控制是核心。 智慧城市沙盘的价值在于"城市运行逻辑讲得清楚"------交通、数据、能源、安防四条路径的协同运行，每一段灯光的时序流动都在讲述城市各系统的实时运行状态。采用状态机编程，将各工况定义为独立状态，各状态之间通过时序计数器触发切换。

2. 多工况模式切换是价值延伸。 日常运营、高峰管理、应急响应、节能模式四种工况覆盖了城市展厅、智慧园区管控、数字孪生展示三种典型场景。

3. 数字孪生数据对接是智能化体现。 通过Modbus RTU寄存器实时上报模拟数据，实现物理沙盘与数字孪生平台的双向同步，让智慧城市沙盘从"静态展示"升级为"动态决策工具"。

筑城世纪模型的智慧城市沙盘控制系统方案，基于STM32平台自主研发，支持Modbus RTU协议，已在多套工业模型项目中完成部署验证。控制系统支持多路灯带独立控制、多路径协同时序、多工况模式切换、数字孪生数据对接，后期可根据需求随时修改控制逻辑。