Adapter Details Dialog

The "DRO Adapter Details" dialog shows information about the connected TouchDRO adapter and gives you access to the per-input settings that are not part of day-to-day machining. From here you give the adapter its own Bluetooth name, set the scale protocol for each input, reset an input counter, run the reference-mark routine, and choose what each auxiliary input does. You will set most of these once, when you first connect a machine, and rarely touch them again.

Opening the Dialog

You can open the dialog from the main screen while TouchDRO is connected to an adapter. When you connect, the adapter and the application exchange a short handshake and the adapter authenticates itself, which usually takes 10 to 30 seconds. You can also open the same dialog for any adapter TouchDRO knows about, connected or not, from "Adapter Profiles" in the application menu. Offline, it shows the stored settings without the live values.

To open the dialog, tap the device-status button that appears next to the connect button at the top of the screen whenever an adapter is connected.

Mill profile main readout screen with the green device status info button lit next to the connect button
Fig. 1: The device-status button, next to the connection icon, opens the Adapter Details dialog
The DRO Adapter Details dialog for a stored TDA-420 adapter opened while disconnected, with the copy, export, import, and forget icons, the alias, model, and Bluetooth ID rows, and one gear button per input with no live values
Fig. 2: The same dialog opened from "Adapter Profiles" while disconnected: the stored settings, with no live values

The button's icon tells you how far TouchDRO has got with identifying the adapter. While the handshake is still running, the button pulses gently and can't be pressed. Once the handshake is done, you will see one of the following:

Button What it means Press Press and hold
No button No adapter is connected Not applicable Not applicable
Amber question mark, pulsing The handshake is still running. This normally takes 10 to 30 seconds Nothing until the handshake settles Nothing until the handshake settles
Green "i" A TouchDRO adapter whose signature has been verified Opens this dialog Nothing
Green question mark TouchDRO recognizes the adapter but could not verify it as a TouchDRO-branded one. Usual for legacy, home-built, and third-party adapters, and for any adapter connected over Bluetooth that isn't verified Opens this dialog Opens the adapter picker, on USB and Wi-Fi
Amber question mark, steady A USB or Wi-Fi adapter that TouchDRO can't identify on its own, so it needs to be picked by hand Opens the adapter picker Opens the adapter picker

"Adapter Profiles" opens the "Adapters" list, with one row per adapter profile TouchDRO has stored. Under the profile's name, each row shows whether the adapter has identified itself, the end of its Bluetooth address, and when it was last seen. The row of the adapter you are connected to reads "Connected" in green, and the row your machine profile is set to use carries "★ This machine profile". Using the "Sort by" drop-down, you can change the order of the list, newest first by default. To open a profile's details, tap its row.

The Adapters list sorted newest first, one row per adapter profile with export, copy, and forget buttons, the connected TDA-420 row in green, and the starred legacy Default profile used by this machine profile
Fig. 3: The "Adapters" list, opened from "Adapter Profiles" in the application menu

The three buttons on a row export the profile to a file, make a copy of it, and forget it. They are covered under "Exporting and Importing a Profile" and "Forgetting an Adapter". A row is missing a button when the action isn't available: you can't forget the adapter you are connected to, and a profile that never identified itself, such as the legacy "Default" profile or a home-built adapter on USB, can't be copied.

Adapter Information

The top of the dialog names the adapter profile and lists the adapter's identity and firmware. The alias and the Bluetooth name are the two rows you can edit.

The top of the DRO Adapter Details dialog, with the copy, export, and import icons in the header row, the Alias row and the Bluetooth Name row each with an edit button, the model, Bluetooth ID, and firmware rows, and the first two scale inputs below
Fig. 4: The header row, the alias, the adapter information, and the first two scale inputs

Renaming the Adapter

When you have several adapters in one shop, each of them shows up as "TouchDRO" in the tablet's Bluetooth list, and you have to tell them apart by their Bluetooth ID. Naming each adapter after its machine, for example "TouchDRO_Mill", puts a name you recognize in that list instead. The alias above it is a label this tablet keeps for the adapter profile, and changing it changes nothing on the adapter. The Bluetooth name is stored on the adapter itself, so every tablet that pairs with it sees the new name.

The edit button beside "Bluetooth Name" appears while a TouchDRO adapter running firmware 3.5 or later is connected and has identified itself. Legacy, home-built, and third-party adapters have no edit button on this row, and neither does an adapter opened offline from "Adapter Profiles".

To rename the adapter, tap the edit button. The name turns into a text field, with a Save and a Cancel button beside it.

The DRO Adapter Details dialog with the Bluetooth Name row turned into a text field reading TouchDRO_Mill, with the save and cancel buttons beside it
Fig. 5: The "Bluetooth Name" row open for editing

The adapter accepts names that follow three rules:

If the name breaks one of these rules, a red banner at the top of the dialog says what is wrong, the row's label turns red, and nothing is sent to the adapter until the name is valid.

Tap Save, and the name is sent to the adapter right away. Once the adapter reports the new name back, the field closes, and the orange banner described under Applying Changes appears with its "Restart Now" button. The adapter keeps advertising its old name until it restarts, so other devices see the new name only after the restart. Saving the name unchanged just closes the field.

The DRO Adapter Details dialog after a rename, with the Bluetooth Name row reading TouchDRO_Mill and the orange banner saying changes will not take effect until the adapter is restarted
Fig. 6: After the adapter confirms the new name, the restart banner appears

If the adapter does not confirm the name, the banner reads "The adapter did not confirm the new name. Check the Bluetooth name after restarting the adapter." Restart the adapter, reconnect, and look at the "Bluetooth Name" row. If it still shows the old name, rename it again.

Exporting and Importing a Profile

An adapter profile is the one thing in TouchDRO you can't recreate from memory. The resolutions come from a calibration session, and an error map from an afternoon with a reference scale. Using the three icons in the header row of the dialog, you can save that work to a file, load it back, and duplicate the profile. All three work offline, from "Adapter Profiles", as well as on the connected adapter.

Exporting

To save the profile, tap the export icon. Android will ask where to put the file, with a name such as "touchdro-adapter_profile-TDA_420_28_56_2F_91_BC_62-20261108_175328.tdap" filled in, and TouchDRO will confirm with "Adapter profile exported" once it is written. TouchDRO writes what is stored for each input into the file: the encoder type and resolution, the calibration and its date, the error correction and backlash maps, the tachometer's pulses per revolution, and the contact type and debounce of the probe inputs. It leaves out the adapter's identity, and anything that belongs to a machine profile, such as the sub-datums, the tools, and the axis settings. Those have their own backup, described under "Backing Up and Restoring Settings". Export after every calibration and keep the file with the machine's other records.

Importing

To load a file, tap the import icon and pick it. TouchDRO won't write anything yet. The "Import adapter profile" dialog will open, naming the profile the file came from and when it was exported, the profile it will write to, and a table with one row per input, split between a "Changed" tab and an "Unchanged" tab. On the "Changed" tab, you see the inputs whose stored settings differ from the file, with the value on the adapter and the value in the file side by side, and the button says what pressing it will do: "Replace 1 setting", or "Nothing to change" when the file matches what is stored.

The Import adapter profile dialog with the Changed tab selected, one row showing that input X will be replaced from 5080 to 25400 counts, and a Replace 1 setting button
Fig. 7: The "Import adapter profile" dialog. One input differs from the file, and the button names what it will replace

Import replaces whole inputs. Every setting of an input in the file replaces what is stored for that input, an input the file doesn't mention is left as it is, and nothing is merged within one input. The write is all or nothing: when it succeeds, "Adapter profile imported" tells you how many settings were replaced and how many were left alone, and when it fails, "Adapter profile not imported" means nothing on this adapter was changed.

The file goes into whichever profile you opened the dialog from, so you can import a calibration into a different adapter's profile. That is how you move the calibration to a replacement board on the same machine, with the same scales plugged into the same inputs. TouchDRO will warn you when the models differ, but will let you go ahead. The target keeps its own alias and identity, since the file never writes those.

Making a Copy

To duplicate a profile, tap the copy icon, or the copy button on its row in the "Adapters" list. The "Create Adapter Profile" dialog will open with the name filled in as the original's name followed by "(copy)". The copy starts with the same calibration and answers to the same adapter, so the next time that adapter connects to a machine profile, TouchDRO will ask which of the two to use, as described under "One Adapter, Several Profiles". This is the setup for one adapter that moves between two machines: copy the profile, calibrate the copy on the second machine, and pick the right one when TouchDRO asks. Copying is only offered for an adapter that has identified itself, so a legacy adapter or a home-built one on USB has no copy button.

Forgetting an Adapter

To remove a profile TouchDRO no longer needs, tap the forget button on its row in the "Adapters" list, or the forget icon in the header of its details dialog when you opened it offline. The "Forget Adapter?" dialog will spell out what goes with it: the encoder setup for every input, with its resolutions, error correction maps, and backlash maps, which can't be recovered without a file you exported earlier. Type "delete" into the field to enable the "Delete" button, then press it. If a machine profile still uses the adapter, the dialog names it, and that profile will create a new, uncalibrated adapter profile the next time it is activated.

The Forget Adapter? confirmation over the Adapters list, warning that the encoder setup for every axis will be deleted, with delete typed into the confirmation field
Fig. 8: The "Forget Adapter?" confirmation. The "Delete" button stays disabled until you type "delete"

You can't forget the adapter you are connected to. Its row has no forget button, and the online details dialog has no forget icon. Disconnect first.

Scale Inputs

Below the adapter information, each scale input has its own block. Depending on the adapter, that is typically inputs X, Y, Z, and W. Each block shows the input mode, the raw value, the refresh rate, and a row of action buttons.

Raw Value is the unscaled count coming from the scale, and Refresh Rate is how often that input reports. You can use both to confirm that a newly wired scale is alive and counting before you calibrate it: move the axis by hand and watch the raw value change.

The buttons you see on an input depend on its mode. A quadrature input has all three. A serial input, or an aux input, has only the gear button, since resetting the counter and finding a reference mark only apply to quadrature scales.

Input Mode

The Input Mode dropdown sets the protocol the adapter uses to read that input's scale. TouchDRO supports several protocols, including Quadrature A/B, BIN6, iGaging 21-bit, and Mitutoyo SPC. The mode you pick has to match the scale wired to that input. Setting an input to Disabled stops the adapter from polling it. After the restart, the adapter leaves that input out of the data it sends, and the input's block shows "N/A" for the raw value and the refresh rate. In the dropdown, you will see the modes that the adapter reports for that input, so the list depends on the adapter model and the input. If the adapter is using a mode that your version of TouchDRO doesn't recognize, the dropdown will show "Unknown". To change it, pick one of the listed modes and save.

Annotated DRO Adapter Details dialog with arrows labeling the mode dropdown, save, cancel, reset, and reference mark controls
Fig. 9: Input mode dropdown and the per-input action buttons
Adapter details on the Rockwell Lathe profile, workspace list visible at right, Aux 1 dropdown mid-edit with disabled gear icon
Fig. 10: A pending mode change on Aux 1. Save and Cancel sit beside the dropdown, and that input's gear is disabled

Changing the dropdown does not take effect right away. As soon as you pick a different mode, a Save button and a Cancel button appear beside it, and that input's gear button is disabled until you save or cancel the change. Save records the new mode, and Cancel discards it and leaves the input as it was. A saved mode change still needs an adapter restart before it is active, covered in Applying Changes below.

Resetting the Input Counter

The reset button, marked with a circle and a line through it, sets the input's raw counter to zero. This works at the adapter level rather than the display level, so it clears the raw value shown in this dialog. It is mainly useful when you are setting up or troubleshooting a scale and want a known starting count.

On scales without reference marks, the reset button can also re-establish machine zero after a power loss: move the machine to a repeatable home position, such as a hard stop or an indicated block, and reset the counters there. The result is only as repeatable as the physical stop, but it lets you use features that rely on a durable machine zero, such as "Machine Datums", without reference-mark scales.

Encoder Settings

The gear button opens that input's "Encoder Settings (Input X)" dialog, where you set the encoder type, the resolution, the counting direction, and the backlash and error correction for the scale on that input.

DRO Adapter Details dialog with an alias field and edit icons above, Input X and Input Y each showing disable, reference mark, and gear buttons
Fig. 11: The gear button on each input block opens that input's encoder settings

Reference-Mark Routine

The reference-mark button starts the reference routine for scales that have one or more reference marks. A reference mark gives the scale a repeatable absolute position, so the adapter can re-establish the same zero after a power cycle.

To run the routine:

  1. Move the scale to a position between two reference marks.
  2. Tap the reference-mark button. The button shows a spinner while the adapter waits for a mark.
  3. While the spinner is active, move the scale toward a reference mark.
  4. When the adapter detects the mark, it sets the counter to zero and the DRO emits a beep.

If the routine does not find a mark before it times out, the application plays an "Err" tone. Move the scale closer to a mark and run the routine again.

Auxiliary Inputs

Below the scale inputs, the adapter's auxiliary inputs have their own Input Mode dropdown. The aux inputs are general-purpose, so you choose what each one does by setting its mode. Changing an aux mode uses the same Save and Cancel buttons as the scale inputs, so the change takes effect when you Save it.

Adapter details showing Aux 1 in Digital Probe mode with its Input P and Input Q lines, each with a live level and a contact-type drop-down reading Auto, and Aux 2 in Tachometer mode
Fig. 12: Two auxiliary inputs, one set to Digital Probe and one to Tachometer

The available aux modes are:

Aux 2 input mode dropdown open on the Rockwell Lathe profile listing Quadrature A/B, Tachometer, Limit, and Binary Switch options
Fig. 13: The aux input mode dropdown

Probe Inputs

An aux input in Digital Probe mode shows two lines in place of the raw value, "Input P" and "Input Q", one for each probe port on that input. Each line shows the live level on its port: 0 or 1, or "No data" if nothing has come in yet. You can use these lines the same way you use the raw value on a scale input. Press the probe's stylus by hand and watch its line flip, which confirms the wiring before you set up a probe profile.

On an adapter running firmware 3.6 or later, each line also has a drop-down that sets how the adapter treats that port when nothing is touching the probe:

Auto reads the port once, at power-up. A probe that is pressed against something while the adapter boots, an unplugged probe, or a noisy input can be detected the wrong way round, and the probe then triggers when it is released instead of when it touches. Setting the contact type outright removes the guess, and the probe no longer has to be plugged in and at rest when the adapter powers up.

The contact-type drop-down on the Input P line of Aux 1 open, listing Auto (NC), Normally closed, and Normally open
Fig. 14: The contact-type drop-down on a probe input

Changing the drop-down shows a Save and a Cancel button beside it, the same as the Input Mode dropdown. Save applies the setting right away, with no adapter restart, and Cancel puts the drop-down back. Save is unavailable while an Input Mode change on the same aux input is still unsaved. If the adapter does not confirm the setting, the dialog reports "The adapter did not confirm the probe setting." On firmware older than 3.6, the two lines show only the live levels.

The gear button on an aux input opens the settings for whatever mode that input is in. An input in Digital Probe mode opens "Probe Input Settings"; one set to Tachometer opens "Set Pulses per Revolution", where you tell TouchDRO how many pulses the sensor produces per turn of the spindle.

Probe Input Settings dialog over the Rockwell Lathe DRO screen, probe type set to Auto and debounce period at 0 milliseconds
Fig. 15: "Probe Input Settings", reached from the gear on an input in Digital Probe mode

"Probe Input Settings" has two controls: the probe type, and a debounce period in milliseconds that ignores contact bounce after the probe triggers.

Applying Changes

When you save an input or aux mode change, or rename the adapter, TouchDRO records it, but the adapter keeps running its previous configuration until it restarts. While a saved change is waiting, you will see an orange banner at the top of the dialog with a "Restart Now" button. The contact type of a probe input is the one setting that does not wait: it takes effect as soon as you save it.

Orange restart-required banner with a Restart Now button above the Input Z, Input W, and Aux input rows in adapter details
Fig. 16: The banner shown when saved changes are waiting for an adapter restart

Tap "Restart Now" to reboot the adapter. The application loses its connection while the adapter restarts, then reconnects on its own after 20 to 30 seconds. Once it reconnects, your changes are active and you can close the dialog.

Closing the Dialog

The Done button closes the dialog. Saved mode changes and a saved name are kept and take effect on the next adapter restart. Any change you did not save is discarded.

Note that the raw values and refresh rates are also useful as a quick health check later on. If a readout stops responding, you can open this dialog and see whether that input is still counting.