FD2 Test Utility
Use this utility to act like a POS, send test commands to FD2, and inspect the exact response.
Main feedback: the utility shows what it sent, what FD2 returned, and whether the controller acknowledged the command.
1. Connect
Choose the protocol FD2 expects. For most dispenser testing, use PCC. Use FD Socket only when testing the FD socket text interface.
When in doubt, start with PCC. The main price and authorization examples are PCC-shaped.
- Ethernet: enter the controller IP and TCP port.
- Serial: enter the COM port and serial settings.
For Ethernet, enter the FD2/controller IP and port. The common test port is 9200.
For Serial, enter the COM port and matching baud/parity/data/stop settings.
After a successful connection, the utility shows CONNECTED. If it does not, check protocol, address, port, cabling, and whether FD2 is listening.
Set Price, Amount, and Volume decimals to match the controller or dispenser setup. Common values are price 3, amount 2, and volume 3.
2. Pick a Dispenser
Most actions target one fueling position. Select it before sending price, authorize, stop, resume, totals, or transaction commands.
Pick the dispenser number, such as 01 or 02. The Selected: XX label confirms the active target.
3. Send a Price
Use this to verify that FD2 accepts a price write for the selected dispenser and hose.
Choose Selected Hose in the price bar.
Click Send Price. The utility builds the command from the selected protocol, dispenser, hose, and decimal settings.
Click Custom Price when you need to enter specific credit and cash prices instead of using the utility's generated test prices. The dialog validates the values before sending.
Click All Hoses to send prices for the hose range up to the selected hose.
If FD2 NAKs the command, check that the hose exists and that the price decimal format matches the controller setup.
Click Remove/Disable to send the utility's price-clear style command for the selected hose.
4. Authorize Fueling
Authorization tells FD2 to allow fueling for the selected dispenser, usually with a money preset, volume preset, or fillup.
Click Authorize. The dialog opens with the current dispenser already selected.
- Dollar preset: enter a money amount.
- Volume preset: enter a volume amount.
- Fillup: authorize without a normal preset limit.
Select Credit (1) or Cash (2). The utility uses that choice when building the PCC authorization flag.
Use Hose to allow one hose. Use Multi to allow a selected group of hoses. Leave it on None for no hose lock.
Click OK. The utility sends the command and updates the TX/RX panel. While the command is in progress, the Authorize button is disabled to prevent duplicate sends.
A dollar preset in PCC normally builds an A command with a money flag and a scaled money value.
When Fillup is selected, choose the fillup type that matches the test:
- Legacy (4): legacy fillup authorization.
- Cash (5): cash fillup authorization.
- Credit (6): credit fillup authorization.
5. Read TX/RX Feedback
The TX/RX panel is the main source of truth for what the utility sent and what FD2 returned.
Shows the command payload sent by the utility. For PCC, the utility frames it internally, but this box shows the command in a readable form.
Shows the controller response with control bytes expanded:
ACKmeans FD2 accepted the command.NAKmeans FD2 rejected the command.STXandETXmark framed PCC payload boundaries.
[no response] means the utility did not receive data before the receive timeout. Check the connection, command format, and whether the remote side closed the socket.
Action Reference
This list covers the visible action buttons on the main window. If a button is currently a placeholder, the help says so directly.
| Button | What it does |
|---|---|
| Authorize | Opens the Authorize dialog and sends a PCC or FD socket authorization. The button is disabled while the send is in progress. |
| Deauthorize | Removes authorization for the selected dispenser. PCC sends an N command; FD socket sends DEAUTHORIZE. |
| Stop | Sends a stop command for the selected dispenser. PCC sends C; FD socket sends STOP. |
| Resume | Sends a resume command for the selected dispenser. PCC sends D; FD socket sends RESUME. |
| Payout | Requests payout behavior. PCC sends a B payout-style command; FD socket currently sends a fillup-style authorization request. |
| Get Totals | Requests totals/meters for the selected dispenser and selected hose. |
| Get Trans. Data | Requests current sale/transaction data for the selected dispenser. |
| Assign Grade Map | Placeholder in this utility. It currently reports that the feature is not implemented. |
| Release Reservation | Placeholder in this utility. It currently reports that the feature is not implemented. |
| Reserve | Placeholder in this utility. It currently reports that the feature is not implemented. |
| Reader Commands | Placeholder in this utility. It currently reports that the feature is not implemented. |
| Other Devices | Placeholder in this utility. It currently reports that the feature is not implemented. |
| Read Tank Configuration | Placeholder in this utility. It currently reports that the feature is not implemented. |
| Write Tank Configuration | Placeholder in this utility. It currently reports that the feature is not implemented. |
| Read Grade Unit Price | Placeholder in this utility. It currently reports that the feature is not implemented. |
The utility serializes command sends through the shared transport so two commands do not write/read over the same socket at the same time. Reconnects close the previous socket before opening a new one.
6. Read FD2 Files
Use Read Files to request configuration, logs, JSON, database, reader, license, or PIE data files.
Click Read Files.
Choose where downloaded files should be saved. If no folder is selected, the utility may prompt later.
- Read config.xml (*CR): request controller configuration.
- Logs dir (*VL): request logs.
- JSON dir (*VJ): request JSON files.
- DB dir (*VD): request database files.
- Reader dir (*VR): request reader files.
- License dir (*VC): request license files.
- PIE data dir (*VP): request PIE data files.
The window shows the response, and Copy to main TX/RX can copy the result into the main panel.
Clear empties the response box in the Read Files window. Close closes the window without changing the main connection.
7. Send a Custom Command
Use Custom Command when no dedicated button exists for the test you need.
Select a message template and click Apply, or type a command manually.
A010000100000000- PCC-style authorization example.*VL- log-file request example.
Use Show raw when you need visible control bytes. Use Copy to main TX/RX when you want the main window to show the same exchange.
Click Send and read the response before sending another command.
Close closes the Custom Command window. It does not disconnect the main utility.