Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

readme.md

CNCjs and Arduino Nano Shield V3 Setup Guide

This guide provides step-by-step instructions to set up CNCjs with an Arduino Nano Shield V3, including downloading the required software and uploading GRBL firmware for CNC milling.

Table of Contents

  1. Overview
  2. Download CNCjs
  3. Uploading GRBL to Arduino Nano Shield V3
  4. Connecting to CNCjs
  5. Resources

📢 Support the UniversalBit Project

Help us grow and continue innovating!


Overview

CNCjs is a full-featured, web-based interface for CNC controllers running Grbl, Marlin, Smoothieware, or TinyG. It enables users to upload G-code and simulate CNC milling operations efficiently.


Download CNCjs

To download the CNCjs Linux app image:

Using wget

Run the following command to download CNCjs version 1.10.3:

wget https://github.com/cncjs/cncjs/releases/download/v1.10.3/cncjs-app-1.10.3-linux-x86_64.AppImage

Direct Download

CNCjs Desktop App v1.10.3

For additional versions, visit the CNCjs Releases Page.


Uploading GRBL to Arduino Nano Shield V3

GRBL is a high-performance firmware for CNC milling. Below are the steps to upload GRBL to an Arduino Nano Shield V3.

Prerequisites

Ensure your system has the following packages installed:

sudo apt install arduino zip unzip wget

Download GRBL

Download and extract GRBL version 1.1:

cd ~/Downloads
wget https://github.com/gnea/grbl/archive/refs/tags/v1.1h.20190825.zip
unzip grbl-1.1h.20190825.zip
cd grbl-1.1h.20190825/
zip -r grbl.zip grbl

Prepare GRBL for Arduino IDE

  1. Rename the folder:
    cp -R ~/Downloads/grbl-1.1h.20190825 GRBL
  2. Copy the GRBL folder to the Arduino Libraries directory:
    cp -R GRBL /home/<your-username>/Arduino/libraries/

Upload GRBL Firmware

To deploy GRBL firmware to your Arduino Nano Shield V3 (which runs on an AVR ATmega328p microcontroller), you can choose between our quick automated script or the classic manual Arduino IDE process.


Method A: Automated CLI Flash (Recommended)

This repository includes a unified Master Flasher script (universalbit_grbl_flasher.sh) that auto-detects your connected Arduino Nano, downloads the verified GRBL v1.1h firmware, installs necessary flashing tools (avrdude), and deploys it automatically.

  1. Connect your Arduino Nano Shield V3 via USB.
  2. Open your terminal and run the following commands:
# Set execute permissions on the flasher script
chmod +x universalbit_grbl_flasher.sh

# Flash GRBL directly to your AVR board
sudo ./universalbit_grbl_flasher.sh --chip avr --yes

Connecting to CNCjs

Once GRBL is uploaded, connect your Arduino Nano Shield V3 to CNCjs. This allows you to upload G-code and start CNC milling simulations.

For more details, visit the CNC Router Machines Repository.


Resources

Explore the following resources for additional information and tools: