Getting Started

Getting Started

Basic Setup

Below are the approximate steps for setting up a printer with a Prunt board:

  1. Connect the board to the various motors/thermistors/etc., noting the labels on the board where each is connected.
  2. Power on the board and run the server binary on the host machine (for Prunt Board 2 it can be downloaded from https://github.com/Prunt3D/prunt_board_2_software/releases). Note that a command line argument specifying a serial port is required for some boards (--serial-port=/dev/serial/by-id/usb-Prunt_3D_Prunt_Board_2_… for Prunt Board 2, where … is replaced with the path for your board).
  3. Navigate to <host_address>:8080 in a web browser.
  4. Navigate to “Config Editor” at the top of the page.
  5. Go through each tab and configure the board as desired using the built-in descriptions.
  6. Finally navigate to the Prunt tab in the config editor and tick the box to enable Prunt and save.
  7. Restart the server binary.

It is also heavily recommended to set up CPU isolation for a single CPU which is then passed to the --prunt-step-generator-cpu= command line argument. For Prunt Board 2 an additional CPU should be isolated and passed to --communications-cpu=.

CPU Isolation

CPU isolation prevents any tasks from running on a given CPU if they are not assigned to that specific CPU. This is useful for Prunt as it can prevent other tasks from taking away resources from the time-sensitive step generator task.

Example of parameters to isolate the third and fourth CPU: nohz=on nohz_full=2,3 rcu_nocbs=2,3 isolcpus=nohz,domain,managed_irq,2,3 rcu_nocb_poll

To add these parameters on OpenSUSE or SUSE: Run yast2, navigate to boot loader > kernel parameters, and append the parameters to the existing parameters.

To add these parameters on Raspberry Pi OS: Edit /boot/cmdline.txt and append the parameters to the existing parameters.

Note that CPUs in Prunt start from 1 whereas CPUs in Linux start from 0, therefore for the above parameters 3 or 4 should be passed to Prunt rather than 2 or 3.

Slicer Settings

Configuration steps for various slicers are shown below. Currently there are no slicers that support the more advanced Prunt g-code features.

Orca Slicer

The following options must be set in the process settings to use Prunt, You may need to turn on the advanced settings toggle in the top right corner to see these options:

Parameter Value
Quality > Arc fitting Off

Prunt contains built-in corner blending which should be used instead of g-code arcs.

The following options must be set in the printer settings to use Prunt, You may need to turn on the advanced settings toggle in the top right corner to see these options:

Parameter Value
Basic information > G-code flavor Marlin 2
Motion ability > Advanced > Emit limits to G-code Off
Machine G-code > Layer change G-code G4 S0

The final parameter is optional and causes Prunt to start a new planner segment at the start of a layer, which may lead to more consistent print results in some cases.

Uploading G-Code

There is currently no built-in mechanism for uploading g-code files. Files should be manually placed in a folder named upload in the same directory as the server binary.