Serial logs provide real-time diagnostic output from your Maus-Tec device and are useful for troubleshooting unexpected behavior, verifying firmware operation, or sharing information with support.
This guide walks through connecting to your device's serial console using a web-based terminal.
Prerequisites
- Google Chrome, Microsoft Edge, or Opera (version 89 or later; required for USB serial access)
- USB cable compatible with your device (must be a data cable, not a power-only cable)
- Device connected to your computer via USB
Recommended Tool
Google Chrome Labs Serial Terminal URL: https://googlechromelabs.github.io/serial-terminal/
This is an official demo application from the Chromium team for the Web Serial API. It is actively maintained, privacy-respecting (no analytics; all communication is local), and works as a Progressive Web App, meaning it can function even without an active internet connection after first load.
Note: We previously recommended serialterminal.com, but that tool has proven unreliable for some customers and is no longer actively maintained. We recommend the Chrome Labs terminal instead.
Procedure
Step 1: Connect Your Device
Connect your device to your computer using a USB cable. Wait 2–3 seconds for the operating system to recognize it before proceeding.
Step 2: Open the Serial Terminal
Navigate to https://googlechromelabs.github.io/serial-terminal/ in Chrome, Edge, or Opera.
Step 3: Configure the Connection Settings
Before connecting, verify the following settings in the terminal interface. These should match the default output settings for your Maus-Tec device:
| Setting | Value |
|---|---|
| Baud Rate | 115200 |
| Data Bits | 8 |
| Parity | None |
| Stop Bits | 1 |
Step 4: Connect to Your Device
- Click "Connect"
- When the browser dialog appears, select your device's USB serial port:
-
macOS: Look for a port named
/dev/cu.SLAB_USBtoUARTor similar -
Windows: Look for a COM port (e.g.,
COM3) -
Linux: Look for
/dev/ttyUSB0or/dev/ttyACM0
-
macOS: Look for a port named
- Click "Connect" to confirm
Step 5: View Logs
Once connected, log output from your device will appear in the terminal window. You may need to restart or interact with your device to trigger new log output.
To save the output for sharing with support, use the "Download output" button if available, or copy and paste the terminal text directly.
Troubleshooting
No Ports Appear in the Browser Dialog
- Confirm you are using Chrome, Edge, or Opera (Firefox and Safari do not support the Web Serial API)
- Try a different USB cable, as some cables without data lines will not show a serial port
- Try a different USB port on your computer
- Disconnect and reconnect the USB cable, then click "Connect" again
Connected but No Output Appears
- Verify the Baud Rate is set to 115200; a mismatch will produce garbled output or silence
- Restart or power-cycle your device; some log output only occurs at startup
- Confirm the USB cable is fully seated on both ends
Output is Garbled or Unreadable
- Check all four settings match the values in the table above, especially baud rate
- Disconnect, verify the settings, and reconnect
Sharing Logs with Support
When contacting Maus-Tec support with a log capture, please include:
- The full text of the log output, copied from the terminal window
- Your device model and firmware version (if known) and serial number
- A brief description of the behavior you observed
This information helps us diagnose issues quickly and accurately.
Comments
0 comments
Article is closed for comments.