Perfect Serial Browser User Manual

• Introduction
• Getting Started
• User Interface
  • Port Discovery
  • Port Monitoring
  • Terminal Interface
  • Logging and Replay
• Troubleshooting
• Advanced Usage

Introduction

Perfect Serial Browser is a web-based serial port communication tool for developers, engineers, and technicians. It provides a clean interface for discovering, connecting to, and communicating with serial devices through your web browser.

Getting Started

Prerequisites

• Modern web browser (Chrome 60+, Firefox 60+, Safari 12+, Edge 79+).
• Serial devices or USB-to-Serial adapters.
• Appropriate device drivers installed for your serial hardware.

Installation and Startup

1. Launch Perfect Serial Browser. Run the Perfect Serial Browser executable.
2. Access the interface. Open your browser and go to http://localhost:3000.
3. Start exploring. The main interface shows all available serial ports.

First Connection

1. Connect your device. Plug in your serial device or USB-to-Serial adapter.
2. Refresh ports. Click the refresh button to discover new ports.
3. Select port. Click on the port you want to connect to.
4. Configure settings. Set baud rate, data bits, parity, and stop bits.
5. Connect. Click the connect button to establish the connection.

User Interface

The main interface is divided into several key areas, designed for both beginners and advanced users.

Port Discovery

The port discovery section displays all available serial ports on your system, including:

• Port name: the system identifier (e.g. COM1, /dev/ttyUSB0).
• Description: hardware description when available.
• Status: available, in use, or error states.
• Hardware info: vendor ID, product ID, and driver information.

Port Monitoring

When connected to a port, the monitoring interface provides:

• Real-time data: live display of incoming and outgoing data.
• Connection status: visual indicators of connection health.
• Data format: choose between ASCII, hex, or binary display.
• Send data: input field for sending commands to the device.

Terminal Interface

The terminal provides a traditional terminal-like interface with:

• Command history: navigate previous commands with up and down arrows.
• Auto-completion: context-aware command suggestions.
• Copy and paste: standard clipboard operations.
• Clear screen: reset the terminal display.

Logging and Replay

Perfect Serial Browser automatically logs all communications:

• Automatic logging: all data is timestamped and saved.
• Session management: start, stop, and manage logging sessions.
• Replay system: playback recorded sessions for analysis.
• Export options: save logs in various formats.

Troubleshooting

Port Not Appearing

• Ensure device drivers are properly installed.
• Check that the device is properly connected.
• Try disconnecting and reconnecting the device.
• Refresh the port list.

Connection Failed

• Verify the port is not in use by another application.
• Check connection parameters (baud rate, data bits, etc.).
• Ensure you have sufficient permissions.
• Try a different USB port or cable.

No Data Received

• Verify connection parameters match your device.
• Check device power and cable connections.
• Ensure the device is configured to send data.
• Try different data format displays (ASCII, hex, or binary).

Advanced Usage

API Integration

Perfect Serial Browser provides a REST API for programmatic access. See the API Documentation for complete reference.

Automation Scripts

Use the API to create automated testing scripts, data collection tools, and integration workflows.

Multi-Port Monitoring

Open multiple browser tabs or windows to monitor several serial ports at once.

Custom Configurations

Save and load custom port configurations for frequently used devices and settings.