Serial Port Debugger

Both Fusion (Fusion Client and Fusion Truck) and Fusion Installer come with a tool which can be used to debug serial communications and figure out the prepend and termination string settings for tag readers, remote displays, temperature probes, and other serial devices if you cannot find the appropriate documentation for them.

From within Fusion Installer the Serial Port Debugger window can be opened from the Advanced menu. From within Fusion, use the big Options button in the main menu window.

Connecting To the Device

When the window is first opened you will be asked to choose a port and set the other connection information. Check the user manual for the device if you are unsure about these settings. Once the settings are accepted you will see a window where you can either receive or send to the device. At the bottom right of this window is an Open Port button which you must click for the debugger to actually attempt to connect to the device.

If you receive an error message you may have some settings incorrect or you may have chosen the wrong port. Click the Port Setup button to go back and review these settings.

Once the port is open you can either receive data from the device or send data to the device. You determine which mode the debugger is in by selecting the appropriate tab at the top of the window.

Receiving

Once in receiving mode you can ask the device to send information and it will appear in the window. For example, with an tag reader you would need to scan a tag and when you do so it should appear in the window. (It is very important that you make sure the reader isn’t in a mode where it doesn’t send duplicate tags. If you are unsure about this, make sure you use a set of tags that you know haven’t been scanned with the device before.)

As the device sends information you will see it appear in the text box. If the device sends a character that cannot be directly displayed, the ASCII equivalent will be shown enclosed in less than/greater than signs like this: <13>. To continue with our example, to set up an tag reader correctly you must know the termination string. If you use this utility to receive a few tags you will see some hidden characters between each tag.

If you saw “124000123456789<13><10>1240005648943 26<13><10>” then you would know that the termination string setting needs to be “13,10”.

Below the box where received characters are placed are several buttons:

• Clear. This simply clears the above text box which is helpful when it becomes too cluttered.
• Copy. This copies the above text box into the clipboard so you can paste it into another application.
• Email SSG. This will email the contents to our support team. You can use this option when you need help interpreting the characters. Make sure you have an internet connection first.
• Save. Allows you to save the characters just as you see them (with the “<x>”s) to a file.
• Save Raw. Allows you to save the actual stream of characters with no interpretation to a file.

Sending

You can use the sending tab to send characters to a device like a remote display. This part of the tool is probably a less useful way to test remote displays as it is usually easier to just use the scale system. However, in some situations it might be useful. There are four ways to send characters to the device:

• Use Send button to send text. This allows you to enter any characters in the text box, but nothing happens until you click the Send button. Then everything in the text box will be sent at once.
• Send after hitting Return/Enter key. If you are using a keyboard you can use this mode. It will automatically send whatever you have typed every time you hit the Enter (Return on Mac) key.
• Send after each keystroke. Again you must be using a keyboard. It will send each keystroke immediately after you type it.
• Send File. You can also select a file and have the debugger send the whole file to the device at once.

You can also specify the end of line string (termination string). Whatever you enter here will be sent to the device in the place of each line return.