Configuration

• Configuring the Controller
  • Firmware settings
  • Setup Wizard
• UGS Platform
  • Configuration files
  • Log files
  • Toolbar
  • Panels and windows
  • Visualizer colors
  • Macros
  • Using dark theme
  • Gamepad and joystick
• UGS Classic
  • Configuration files

Configuring the Controller

Firmware settings

The firmware settings is available for GRBL, TinyG and g2core

Your controller firmware settings is available in a configuration dialog and will let you tweak the inner workings of your hardware. It is available in both the UGS Classic and UGS Platform edition:

• UGS Classic - Open the menu Settings → Firmware Settings
• UGS Platform - Open the menu Machine → Firmware Settings

Setup Wizard

The setup wizard is currently only available in the UGS Platform edition and GRBL.

Setting up your controller firmware configuration by hand can be challenging and may require a lot of documentation reading. The Setup Wizard will help you set up your controller without the need to know how to create bitmasks and what features are dependent on another.

• To start the wizard open the menu Machine -> Setup wizard...
  
  
• If you aren't connected to your controller a connection dialog will be presented:
  
• The version of the controller will be shown after connecting and the available setup steps will be loaded for your controller:
  
• If you have a settings file from your machine manufacturer or if you have a backup of your settings you may import it here:
  
• On the motor wiring configuration page you can test the direction of your motors and change its direction if needed.
  
• On the step calibration page you can move the machine and measure the actual distance. It will then recommend a step setting for your machine:
  
• If you have limit switches you may enable them on this page and test if they are firing correctly:
  
• If limit switches are enabled you may enable homing as well. This page helps you figuring out in which direction the homing should be made:
  
• If homing is enabled you may also configure soft limits so that the controller knows if it can process a command without triggering limit switches:
  

Configuring UGS Platform

Configuration files

The configuration for UGS Platform is divided into two types; the UGS specific settings and one for the user interface (ex. describing how the different windows should be placed and so on).

The UGS specific settings (which is also common with the UGS Classic edition) is located in your home directory. It contains UniversalGcodeSender.json which holds the settings such as: jog feed rates, your macros, your file history and so on. There is also the directory firmware_config which contains several configurations for different types firmwares.

• Windows: c:/users/[your username]/.ugs
• Mac: ~/Library/Preferences/ugs
• Linux: ~/.ugs

The UGS platform settings is located in your home directory. These settings contains the positions of the windows, and which modules you have loaded:

• Windows: C:/users/[your username>]/.ugsplatform
• Mac: ~/Library/Application Support/ugsplatform
• Linux: ~/.ugsplatform

Log files

When creating an issue it is often helpful for us to trace the error in your log file. These are located here:

• Windows 7 and higher: C:/Users/[your username>]/.ugsplatform/2.X/var/log/messages.log
• Windows XP: C:/Documents and Settings/[your username>]/.ugsplatform/2.X/var/log/messages.log
• Mac: ~/Library/Application Support/ugsplatform/2.X/dev/var/log/messages.log
• Linux: ~/.ugsplatform/2.X/var/log/messages.log

Configuring the toolbar

The toolbar can be configured by right clicking in the toolbar and choose Customize. From there new icons can be added and removed. New toolbars can be added or hidden.

Configuring panels and windows

All panels and windows can be resized and moved to different locations by dragging and dropping them:

Configuring the visualizer colors

TBD

Configuring Macros

TBD

Using dark theme

There is a dark theme (Look and Feel) in UGS that can be enabled through the settings:

• Open the preferences:
  
• Go to Apperance -> Look and feel and choose FlatLaf Dark:
  
• Restart and the dark themed UGS is used:
  

Gamepad and joystick

See Usage / Gamepad and joystick

Configuring UGS Classic

Configuration files

The UGS settings (which is also common with the UGS Platform edition) is located in your home directory. It contains UniversalGcodeSender.json which holds the settings such as: jog feed rates, your macros, your file history and so on. There is also the directory firmware_config which contains several configurations for different types firmwares.

• Windows: c:/users/[your username]/.ugs
• Mac: ~/Library/Preferences/ugs
• Linux: ~/.ugs