Universal G-Code Sender 开源项目入门指南

一、项目介绍

Universal G-Code Sender 是一款基于Java构建的跨平台G-Code发送器，兼容GRBL, TinyG, g2core以及Smoothieware等控制系统。此工具不仅提供了G-Code的实时传输能力，还具备3D图形可视化功能，支持游戏手柄或操纵杆操作，及Web面板界面等多种特性。

• 技术栈: 使用了JSSC或JSerialComm进行串行通信，JogAmp用于OpenGL处理，NetBeans Platform作为主框架，JTS实现几何变换，Batik用于SVG文件读取。
• 社区与交流: 官方网页位于https://universalgcodesender.com/；讨论区可以在GitHub页面找到（https://github.com/winder/Universal-G-Code-Sender/discussions）；Discord聊天室提供即时通讯服务（https://discord.gg/h4HRmyYX），并设有翻译团队。
• 版本下载: 最新版本(如v2.1.8)可从其官网获取，旧版则在发布页查找。

二、项目快速启动

系统要求

确保您的电脑运行Windows, macOS, Linux之一，且已安装Java环境。

下载与安装

1. 访问GitHub仓库（https://github.com/winder/Universal-G-Code-Sender/releases）并下载最新版的压缩包。
2. 解压文件至您希望存放软件的位置。
3. 在解压后的目录中，双击bin/ugsplatform以运行程序。（对于Linux和MacOS用户，可能需要先给该文件添加执行权限）

运行代码示例

下面是一次简单的G-Code命令发送脚本，假设您已经连接了一个支持GRBL协议的设备：

import java.io.IOException;
import java.util.concurrent.TimeoutException;

// 导入相关库
import net.windsuzi ugscore ugscore;

public class SendGCode {
    public static void main(String[] args) throws IOException, TimeoutException {
        GCodeSender sender = new SerialGCodeSender("COM3", true); // 根据你的串口更改"COM3"
        String command = "G0 X10 Y10 Z0 F200";
        sender.sendCommand(command);
        sender.close();
    }
}

注意: 上述Java代码片段需加入所有必要的依赖库才能正确编译。

三、应用案例和最佳实践

应用案例

远程控制3D打印机 通过网络接口，可以使用智能手机或者远程桌面轻松控制3D打印任务，尤其适合多台机器共享管理的情况。

教学培训 UGS的直观界面和丰富的文档资源使其成为教育领域理想的教学辅助工具，无论是初级还是高级CNC控制概念的学习都十分适宜。

最佳实践

• 安全性检查: 每次运行前务必确认G-Code没有潜在的破坏性指令。
• 定期更新: 保持软件为最新版本，可以获得最新的功能和安全补丁。
• 备份习惯: 对于重要项目，养成保存和备份G-Code的习惯，以防数据丢失。

四、典型生态项目

GRBL Controller Integration GRBL是广泛采用的微控制器固件，专为CNC机械手臂设计。UGS正是与GRBL完美融合的例子，提供便捷的G-Code传输通道。

TinyG and G2Core Support 除了GRBL外，UGS同样支持TinyG和G2Core系统，这意味着更广泛的硬件兼容性和实验可能性。

上述生态项目展示了UGS的强大扩展能力和对多种底层控制系统的适应度，进一步提升了其在工业自动化领域的影响力和实用性。