This manual is being updated for TouchDRO V3.0, which is currently available for closed Beta testing. Some information in the "User Manual" section might differ from your current TouchDRO V2.5 setup.

User Interface

TouchDRO is an Android application that uses standard Android user interface elements. To familiarize yourself with them please refer to the section about TouchDRO User Interface Concepts.

TouchDRO's user interface consists of three different activities (screens):

Common Elements

The three TouchDRO screens share a few common elements that stay more or less unchanged.

Action Bar

TouchDRO Action Bar contains the main application menu, TouchDRO logo, Connection toggle button, and view toggle button
Fig. 1: Application Action Bar

The action bar is a narrow strip at the top of the screen that stays constant between various TouchDRO activities. It includes the following UI elements:

Application Menu Drawer

TouchDRO Application Menu Drawer contains TouchDRO build information and application menu items
Fig. 2: Application Menu Drawer

The menu drawer is hidden by default and can be displayed by either pressing the Application Menu button or swiping from the right edge of the screen. It contains:

Main Activity

When TouchDRO starts, it displays the Main Activity, which is designed to resemble a traditional digital readout display.

TouchDRO Main Activity includes Action Bar, Readout Display, Function Strip and Sub-Datum Panel
Fig. 3: TouchDRO Main Activity

Numeric Readout Display

The numeric readout display takes up most of the screen space and consists of one or more axis position readouts as configured in the Application Settings. This includes up to three linear axis displays for X, Y, and Z axes, Angular axis display, and RPM display.

TouchDRO numeric position readout resemble the display of a traditional digital readout display
Fig. 4: Numeric Position Readouts

RPM display lacks the latter three buttons but behaves similarly

Sub-Datum Panel

TouchDRO's Sub-Datum panel is packed with advanced functionality
Fig. 5: Sub-Datum Panel

The collapsible saved sub-datum panel contains the following elements in the expanded state:

In a collapsed state, only the collapse/expand button and "Add Sub-Datum" buttons are visible and active.

Function Strip

DRO function strip includes global functions common on a digital readout
Fig. 6: Application Action Bar

The function strip appears right below the Axis Readout Display and contains a set of buttons that activate machine-specific global DRO functions:

Please note: if function strip is too large to fit on screen, you will be able to scroll it left-to-right

Graphical View Display

Graphical View Display provides 2D represntation of the current workdspace for streamlining repetetive operations with subdatums
Fig. 7: Graphical View Display

The Graphical View Activity displays a 2-dimensional graphical representation of the current workspace. Its goal is to simplify working with saved sub-datums when performing repetitive operations.

The view consists of three areas:

Projection View

DRO Projection View displays location of subdatums and the position of the cutter
Fig. 8: 2D Projection Display

The Projection View displays a live 2D projection of the current workspace onto either YZ or XZ plane (depending on the selected machine type). Most of the view's area is taken up by the Sub-Datum locations and the crosshairs that represent the current spindle or cutter position. Additionally, around the view's periphery, there are several icon buttons for quickly setting display scale and toggling virus display functions.

Digital Readouts

DRO Position Readouts display shows simplified view of the three linear axis positions
Fig. 9: Readouts Display

Digital Readouts Display takes up the top half of the right panel. It includes position readouts for the three linear axes, global "Zero Set" button, Units toggle button, and Absolute/Incremental mode toggle button.

The readout text is clickable and has two functions:

The buttons behave similarly to the main DRO display.

Sub-Datum List

Below the Digital Readouts display is the compact version of the Saved Sub-Datum list, similar to the one shown on the main DRO display. The only difference is the lack of Sub-Datum Action Buttons.

Application Settings Activity

Many aspects of TouchDRO can be configured to suit a particular DIY DRO setup
Fig. 10: Applicaton Settings Activity

Many aspects of TouchDRO can be configured using the Application Settings Activity that can be accessed from the Application Menu.

The activity screen consists of a scrollable list that contains settings organized into groups. To make the list more concise, some setting groups are collapsed. The titles of such groups are links that can be clicked to bring up a Settings Subscreen.

Screen Title

The Screen Title appears right under the application Action Bar. Its contents change depending on the currently selected settings group:

Settings Group

As mentioned earlier, the settings are organized into logical groups. An expanded group includes a group title and one or more individual settings.

TouchDRO uses three main types of settings:

Clicking on a setting row will either bring up a relevant dialog or toggle the selector switch. Please note, there is no need to explicitly save the changes - as you make the changes, they are applied immediately.

Collapsed Settings Group

Collapsed setting groups can be distinguished by the fact that they don't display individual settings and have a small icon to the right of the group title. Furthermore, some of the current values are displayed as a short summary under the group title.

Clicking anywhere on the collapsed group row opens a new settings sub-screen that looks very similar to the main settings screen and contains the same type of elements.