pos_bluetooth_thermal_printer/QUICK_START_CHROME.md

Quick Start Guide: Connecting Bluetooth Thermal Printer in Chrome

Prerequisites

✅ Chrome browser version 56 or higher
✅ Bluetooth thermal printer (ESC/POS compatible)
✅ HTTPS connection (or localhost for testing)
✅ Bluetooth enabled on your device

Step-by-Step Connection Guide

Step 1: Prepare Your Printer

1. Turn on your Bluetooth thermal printer
2. Put it in pairing mode:
   • For RPP02: Press and hold the power button until LED blinks rapidly
   • For other printers: Check your printer manual
3. Keep the printer close (within 1-2 meters) during pairing

Step 2: Enable Bluetooth Printer in Odoo

1. Go to Point of Sale > Configuration > Point of Sale
2. Select your POS configuration
3. Check the "Enable Bluetooth Printer" option
4. Click Save

Step 3: Open POS and Scan for Printer

1. Open a POS session
2. Look for the Bluetooth icon in the top bar
3. Click the Bluetooth icon to open configuration
4. Click "Scan for Devices" button
5. Chrome will show a device selection dialog

Step 4: Select and Pair Your Printer

1. In the Chrome dialog, you should see your printer listed
   • Example names: "RPP02", "Printer-1234", "BT-Printer", etc.
2. Click on your printer to select it
3. Click the "Pair" button
4. Wait 5-10 seconds for connection

Step 5: Test the Connection

1. Once connected, the status indicator will turn green
2. Click the "Test Print" button
3. Your printer should print a test receipt
4. If successful, you're ready to use it!

Troubleshooting Quick Fixes

Printer Not Showing in Scan

Try this:

1. Make sure printer is in pairing mode (LED blinking)
2. Move printer closer to your device
3. If printer was previously paired, unpair it from device Bluetooth settings
4. Click "Scan for Devices" again

Connection Fails After Selecting Printer

Try this:

1. Turn printer OFF, wait 10 seconds, turn ON
2. Put printer in pairing mode again
3. Try connecting again
4. If still fails, restart your device's Bluetooth

Printer Connects But Doesn't Print

Try this:

1. Check if printer has paper loaded
2. Check for paper jams
3. Try the "Test Print" button again
4. Check printer battery level

Browser Shows "Bluetooth Not Available"

Try this:

1. Make sure you're using Chrome, Edge, or Opera
2. Check that you're accessing via HTTPS (or localhost)
3. Verify Bluetooth is enabled on your device
4. Try restarting Chrome

What's New in This Version

The module has been updated with major improvements:

✅ Better Compatibility: Now supports more printer models
✅ Smarter Connection: Automatically tries multiple connection methods
✅ Smaller Data Chunks: More reliable data transmission
✅ Better Error Messages: Clearer feedback when issues occur
✅ Debug Logging: Easier troubleshooting with console logs

Supported Printers

This module works with most ESC/POS Bluetooth thermal printers:

• ✅ RPP02
• ✅ Epson TM-P20, TM-P80
• ✅ Star Micronics SM-L200, SM-L300
• ✅ Most generic ESC/POS Bluetooth printers

Need More Help?

📖 Detailed Troubleshooting: See CHROME_BLUETOOTH_TROUBLESHOOTING.md
📖 Full Documentation: See README.md
📖 Technical Details: See FIXES_APPLIED.md

Console Debugging

If you're having issues, check the browser console:

1. Press F12 to open Developer Tools
2. Go to the Console tab
3. Look for messages starting with [BluetoothPrinter]
4. These logs show exactly what's happening during connection

Example logs you might see:

[BluetoothPrinter] Bluetooth API available: true
[BluetoothPrinter] Starting device scan...
[BluetoothPrinter] Device found via filtered scan {name: "RPP02", id: "..."}
[BluetoothPrinter] Attempting to connect to printer...
[BluetoothPrinter] GATT server connected successfully
[BluetoothPrinter] Found characteristic: 00002af1-0000-1000-8000-00805f9b34fb

Tips for Best Results

💡 Keep printer close during pairing (1-2 meters)
💡 Charge printer fully before first use
💡 Unpair old connections if re-pairing
💡 Use Chrome or Edge for best compatibility
💡 Enable auto-reconnect in settings

Common Questions

Q: Do I need to pair on each device?
A: Yes, each tablet/workstation needs its own pairing.

Q: Can multiple devices use the same printer?
A: No, Bluetooth printers can only connect to one device at a time.

Q: Will it work on iPad?
A: No, iOS doesn't support Web Bluetooth API.

Q: Do I need to install drivers?
A: No, everything works directly in the browser.

Q: What if printing fails?
A: The system automatically falls back to the browser print dialog. Your sale is never lost.

Success Checklist

Before contacting support, verify:

• Using Chrome 56+ or Edge (Chromium)
• Accessing via HTTPS (or localhost)
• Bluetooth enabled on device
• Printer powered on and in pairing mode
• Printer within 1-2 meters during pairing
• Printer has paper loaded
• Checked browser console for errors (F12)
• Tried unpairing and re-pairing
• Tried restarting printer and browser

---

Last Updated: December 7, 2025
Module Version: 18.0.1.0.0
Odoo Version: 18.0