BAC-Studio（VS Code Extension） / BAC-Studio (VS Code Extension)

中文

BAC-Studio 是面向 BACnet DDC 与 Modbus RTU → BACnet/IP 网关 的编程与配置工具（VS Code / Cursor 扩展）。支持 Lua / Blockly 应用逻辑、网关点位配置、设备发现与文件下发、脚本编译，以及内置 BACnet 调试（含多路 PID 在线整定、BBMD、时间同步等）。

本扩展不会在安装后自动弹出窗口。请通过下方任一方式打开功能。

功能概览

工程管理：.luaproj 工程树，活动工程 / 多工程打开
Blockly 图形化编程：生成 Lua 并写入 main.lua
Lua 编译：调用 luac 编译活动工程
Modbus 转 BACnet/IP 网关：编辑 mdb_map.json（串口与点位映射）
设备管理：UDP 发现、网络参数、TFTP 上传固件/配置
串口调试助手
BACnet 调试：Who-Is、对象/属性浏览、读写、订阅轮询、趋势曲线、BBMD、时间同步
PID 在线整定：规则整定与 AI 辅助整定（支持多路并行/串行）

如何使用

1. 左侧活动栏（推荐）

点击活动栏 BAC-Studio 图标，打开侧边栏：

快捷入口：新建/打开工程、Blockly、编译、BACnet 调试、设备管理、网关配置、串口调试等
工程：管理 .luaproj 工程树

2. 命令面板

按 Ctrl+Shift+P（macOS：Cmd+Shift+P），输入 BacStudio：

命令	说明
打开工程 (.luaproj)	选择并登记工程
新建工程	新建 `.luaproj` 与模板 `main.lua`
图形化编程 (Blockly)	打开 Blockly 面板
编译活动工程	编译当前活动工程中的 `.lua`
BACnet 调试	设备发现、属性读写、PID 整定
设备管理	UDP 搜设备、TFTP 上传
Modbus 转 BACnet/IP 网关配置	编辑 `mdb_map.json`
串口调试助手	串口收发调试

依赖与设置

编译：扩展内置 bundled/tool/luac.exe，或通过设置 bacstudio.luacPath 指定
Blockly：扩展内置 media/blockly
在设置中搜索 bacstudio 可配置 luac 路径、UDP 发现端口、TFTP 端口等

更新日志

见扩展包内 CHANGELOG.md。

许可

见扩展包内 LICENSE.zh-CN.md（中文）或 LICENSE.md（英文，Marketplace 展示用）。

English

BAC-Studio is a VS Code / Cursor extension for programming and configuring BACnet DDC controllers and Modbus RTU → BACnet/IP gateways. It provides Lua / Blockly application logic, gateway point mapping, device discovery, file upload, script compilation, and a built-in BACnet Explorer (multi-loop PID tuning, BBMD, time sync, and more).

The extension does not open any window automatically after installation. Use one of the entry points below.

Features

Project management: .luaproj tree, active project / multiple open projects
Blockly visual programming: generates Lua into main.lua
Lua compile: compiles the active project via luac
Modbus RTU → BACnet/IP gateway: edit mdb_map.json (serial port & tag mappings)
Device management: UDP discovery, network setup, TFTP upload (.luac / .json / .bin)
Serial debug assistant
BACnet Explorer: Who-Is, object/property browse, read/write, COV-style polling, trend chart, BBMD, time synchronization
PID online tuning: rule-based and AI-assisted tuning (parallel or sequential multi-loop)

Getting started

1. Activity bar (recommended)

Click the BAC-Studio icon in the activity bar:

Launcher: new/open project, Blockly, compile, BACnet Explorer, devices, gateway config, serial debug
Projects: .luaproj project tree

2. Command Palette

Press Ctrl+Shift+P (macOS: Cmd+Shift+P), type BacStudio:

Command	Description
Open project (.luaproj)	Register an existing project
New project	Create `.luaproj` and template `main.lua`
Blockly	Open visual programming panel
Compile active project	Compile `.lua` files in the active project
BACnet Explorer	Discovery, read/write, PID tuning
Device management	UDP search, TFTP upload
Modbus → BACnet/IP gateway	Edit `mdb_map.json`
Serial debug	Serial port terminal

Requirements & settings

Compile: bundled luac.exe, or set bacstudio.luacPath
Blockly: bundled under media/blockly
Search bacstudio in Settings for luac path, UDP discovery ports, TFTP port, etc.

Changelog

See CHANGELOG.md in the extension package.

License

See LICENSE.md (English, used on Marketplace) or LICENSE.zh-CN.md (Chinese) in the extension package.

联系 / Contact

西安松源达智能科技有限公司 / Xi'an Songyuanda Intelligent Technology Co., Ltd.

技术支持 / Support: 18509204218（杨工 / Mr. Yang）
Email: 441816977@qq.com