172 lines
5.2 KiB
Markdown
172 lines
5.2 KiB
Markdown
# 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
|