V2.0: September 2018 (KN) added Windows 10 Driver information, New Display, and Status tab
V3.0: November 2019 (QR) added Catalina driver info
The purpose of this tutorial is to introduce users to the Pocket NC V2 user interface. The topics covered in this tutorial are interface navigation, machine controls, loading and running programs, editing the tool table, conducting tool length measurements using the tool probe feature, and changing the display units.
Software needed: web browser, Chrome, Firefox, Safari are recommended. No internet connection is required.
Hardware needed: computer/Chromebook, USB/mini USB cable
Section 1: Startup and Shutdown
Plug the power cord into the Pocket NC and plug it to a power outlet using the included C13 power cord.
Connect the Pocket NC to the computer using the mini USB/USB adapter cable included in the toolkit.
Instructions on downloading the appropriate driver and the drivers can be found here. Note: Do not flash a new image, scroll down in section 3 to the drivers (shown below) and download these drivers:
If you are using an Apple computer that is running Catalina and you are having driver issues, please see this article for the latest driver.
If you are having issues with Windows 10 drivers, please see this article, a recent (October 2019) Windows 10 update requires most users to use a generic driver.
The drivers for Windows 7, 8, and 8.1 should be preinstalled on the Beaglebone. If you need a different driver, follow this link to view the available Beagleboard drivers.
Download and install one of the following web browsers:
Section 1.1: Startup:
Turn on your machine.
Connect to your computer using the mini USB port.
Wait about 30 seconds for the machine to fully boot before attempting to connect to it. The red, E-stop button will blink when the machine is fully booted.
Open your web browser and type the Pocket NC’s IP address, “192.168.7.2” into the search bar.
The User Interface will open in the “Production” screen.
By default the power to the axes will be off, in order to enable the axes click on the “E-Stop” button in the upper right corner of the screen. You will note that the E-stop (red button) on the Pocket NC mill will blink until the motor power is enabled and will be solid after the motors are active. The E-Stop button turns to red to indicate it’s on.
Before running any programs the machine must be homed. Click the “Home All” button in order to send all axes to their home positions. The screenshot below shows the coordinates of the machine’s home position.
Section 1.2: Shutdown
When you are done operating the machine, click on the power button symbol in the upper right corner of the screen this shuts down the machine, but also safely shuts down the Beaglebone Board. A pop-up asks you if you would like to completely shut down the V2 machine.
Shut off the power button on the Pocket NC and unplug the machine from the computer.
The computer may generate an error message warning you to eject the BeagleBone before unplugging it. You may eject the BeagleBone from the computer if desired, but it is not necessary.
Section 2: Production Tab
For startup procedure and homing see section 1 of this document
Section 2.1: Jogging
There are a number of ways that the user can control the machine axes. The user can select the axis he would like to move by clicking on the axis buttons. The user can then jog that button using the plus (+) and minus (-) buttons.
The user can also jog the axes using the mouse wheel by turning enabling the “Jog With Mouse Wheel” button and selecting the desired axis of motion by clicking on the respective button.
Finally, the user may also use keyboard controls to move the axes. The arrow keys control the X and Y axes, the “Z” and “X” keys are used to control the Z axis, the “A” and “S” keys control the A axis, finally, the “B” and “N” keys are used to control the B axis. The settings for the keyboard controlled jogging are located in the “Jog” menu at the bottom of the page. Click on the “Jog” button to bring up a list of the available step sizes. The available step sizes can be adjusted in the machine configurations.
Section 2.1.1: Step Size
The step size can be changed by clicking on the step size readout and choosing the desired step size from the dropdown list. Note that the rotary axes have different step size options than the linear axes. The step size units are inches, centimeters, or millimeters for the linear axes and degrees for the rotary axes. The user can change the units of the linear axes in the “Configurations” tab. The units in the images below are inches.
Section 2.2: DRO Interface
The digital readout (DRO) allows the user to see the position of each of the machine axes. The user may also use the DRO to home axes individually.
Section 2.3: Loading a Program
Upload a machining file to the BeagleBone by clicking on the “Upload New File” button.
Select your .ngc file from the file directory on your computer or USB flash drive. Note that G-code files must be 2.5MB or less to transfer. This is also the maximum file size that the Pocket NCs’ processor can handle when it comes time to check the Gcode for errors before running it.
After the file has been successfully uploaded, the file name will appear in the in the file window on the left side of the screen as well as in the file display window at the bottom of the screen.
Once the file is loaded, the code will be displayed in the “File” display area at the bottom of the screen. The user can view the file before running it and while it runs using this interface.
Section 2.4: Running a Program
Run the program by clicking the green “Run From” button.
If you have a M0 or M1 command at the start of your code, the program will be paused. Click the blue Pause/Resume” button or push the green Pause/Go button on the machine in order to start the program. The user may pause the program at any point by clicking the “Pause” button or pushing the green button on the machine. The user can stop the program by clicking the “Stop” button or pushing the red, emergency stop button on the machine.
Section 2.4.1: Spindle Rate and Feed Rate Control
The user can change the feedrate and spindle speed while the program is running by toggling the Spindle Rate and Feed Rate controls. The arrows adjust the speed in 5% increments. The reset button resets the value of the spindle of feed rate to 100% of the program value.
Section 2.4.2: Optional Stop
The user can choose whether or not to have the program stop for optional stops in the program by toggling the optional stop button on or off. This allows the user to include optional stops for part checks and turn them off once the program is proved.
Section 2.5: Deleting a File
Click on the file button to access the files that have already been loaded. Click on the orange “X” to delete a file from the BeagleBones’ memory.
Section 2.6: MDI Interface
The MDI interface allows the user to give the Pocket NC commands directly by typing in lines of G code.
Recently used codes can be accessed by clicking on the arrow to the left of the MDI window.
Section 3: Tooling/Tool Table
The Tooling tab contains the tool table, work offset table, and a second digital readout screen.
Section 3.1: Tool Table
A screenshot of the tool table is shown below. By default, the Z Offset for all of the tools will be preset to 5.00 inches. This number will change when you measure the tool length offset for your tool. You may manually edit the “Diameter” and “Description” columns if desired.
Section 3.1.1: Tool Measurement
Do not run the probe cycle for any tool sticking out more than 1.5 inches from the end of the extended tool holder or for a tool larger than ¼ inch diameter. Doing so will cause a crash and may result in damage to your machine and/or a broken tool.
Install the tool that you wish to measure.
Click on the “Measure Tool xx” button for the tool for which you wish to set the tool length offset.
The following prompt will appear in the bottom right corner of the screen.
Double check that your tool is installed correctly then switch back over to the Production tab and click on the “Resume/Pause” button or click on the green button on the machine to run the probe cycle.
Section 4: Configurations
The configurations tab allows the user to make changes to the Pocket NC software settings.
Section 4.1: Network
The network settings displays the machine’s IP address, Host Port, Username and Password. The username and password are both set as “default.”
The Network tab is for configuring your Pocket NC to be on a network. By default, your Pocket NC is configured to connect to 192.168.7.2, the address that is automatically assigned when plugged in to your computer via USB. Advanced users can connect the Pocket NC to a network via ethernet. The IP address assigned to the Pocket NC can be changed in the Network tab so that it can be accessed by other computers on the network. Once on the network, there are serious safety and security considerations to account for. Setting up your machine this way is not recommended unless you fully understand the ramifications of doing so.
Note: changing the IP address in the network tab does not change the Pocket NC’s IP address, but rather indicates to the UI what address to connect to. If you’ve configured your Pocket NC to be on a network, set its IP address here.
Section 4.2: Display/Changing Unit System
The unit system of the interface may be changed using the “Display” tab. Select the unit system that you would like to use then click “save.” The numbers throughout the interface will update to reflect the new unit system.
Section 4.3: Jogging
The settings for the keyboard controlled jogging may be changed using this screen. Please note that these settings only apply to the keyboard controlled jogging they do not affect the jog settings for the mouse wheel jogging or the manual jog using the +/- buttons.
Section 4.4: Server
The “Server” tab contains links to the configuration and support pages for the LinuxCNC operating system running on the Pocket NC’s BeagleBone computer.
The Linux CNC Server Web Configuration link opens a new window that displays all of the settings that the Pocket NC uses to run its specific configuration of Linux CNC. These values are set during the manufacturing and calibration process. These are advanced settings, we recommend that only experienced users change them. Any changes made here are at your own risk and may result in adverse impacts on the Pocket NC’s functionality.
The “Server Help Website” link opens a new window with an extensive library of support documentation for the LinuxCNC operating system that the Pocket NC mill runs.
Section 4.5: Status
The Status tab allows the user to monitor how much memory and storage are left on the Beaglebone Board. The user can clear logs if the Beaglebone board looks close to being full and can clear the G Code files on the Beaglebone board as well.