CNCjs 安装与配置指南

CNCjs 安装与配置指南

cncjs A web-based interface for CNC milling controller running Grbl, Marlin, Smoothieware, or TinyG. 项目地址: https://gitcode.com/gh_mirrors/cn/cncjs

1. 项目基础介绍

CNCjs 是一个功能完整的基于 Web 的 CNC 控制器界面，支持 Grbl、Marlin、Smoothieware 或 TinyG 等控制器。它提供了一个用户友好的界面，用于控制数控机床，具有6轴数字读数器（DRO）、工具路径3D可视化等功能。

主要编程语言：JavaScript、HTML、CSS

2. 关键技术和框架

• JavaScript: 用于开发 Web 界面和服务器端逻辑。
• HTML/CSS: 用于构建用户界面。
• Node.js: 服务器端运行环境，用于运行 JavaScript 代码。
• Express: 基于 Node.js 的 Web 应用框架，用于创建 HTTP 服务器。
• WebSocket: 用于实现客户端与服务器之间的实时通信。

3. 安装与配置

准备工作

在开始安装之前，请确保您的系统已经安装了以下软件：

• Node.js（推荐版本 14 或更高）
• npm（Node.js 包管理器）

安装步骤

1. 安装 Node.js

   如果您的系统尚未安装 Node.js，请从官方网站下载并安装。或者，您可以使用 Node Version Manager（nvm）来安装 Node.js 的特定版本。

   # 使用 nvm 安装 Node.js
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
   nvm install 14
   nvm use 14
   

2. 全局安装 CNCjs

   打开命令行界面，执行以下命令来全局安装 CNCjs：

   npm install -g cncjs
   

   如果您需要以 root 权限安装（不推荐），可以使用以下命令：

   sudo npm install --unsafe-perm -g cncjs
   

3. 启动 CNCjs 服务器

   安装完成后，运行以下命令来启动 CNCjs 服务器：

   cncjs
   

   如果您需要自定义监听端口或地址，可以使用 -p 和 -H 参数：

   cncjs -p 8001 -H 127.0.0.1
   

4. 访问 Web 界面

   打开浏览器，输入以下地址访问 CNCjs 的 Web 界面：

   http://yourhostname:8000/
   

   请将 yourhostname 替换为您的主机名或 IP 地址。

注意事项

• 请确保 CNCjs 以非 root 用户身份安装，否则在某些平台（如 Raspberry Pi）上 serialport 模块可能无法正确安装。
• 使用 cncjs -h 命令可以查看更多的启动选项。

以上就是 CNCjs 的详细安装和配置指南。按照以上步骤操作，您可以轻松地在自己的系统上安装并使用 CNCjs。

cncjs A web-based interface for CNC milling controller running Grbl, Marlin, Smoothieware, or TinyG. 项目地址: https://gitcode.com/gh_mirrors/cn/cncjs