📻 BC75XLT Web Programmer

🇧🇷 Versão em português · Portuguese version available

A static web page (for GitHub Pages) that programs the Uniden BC75XLT / UBC75XLT scanner radio directly from the browser using the Web Serial API — no software to install and no data sent to servers.

Features

• 🔌 Connect the radio via the serial port (Web Serial API) at 57600 bps.
• 📥 Read from radio: loads all settings + the 300 channels (10 banks × 30).
• 📤 Write to radio: sends settings and channels (with option to clear memory first).
• 📂 Import file: reads .bc75xlt_ss files from Uniden's original software.
• 💾 Save file: exports a .bc75xlt_ss compatible with the original software.
• ⚙️ Settings panel: Band Plan, Priority, Key Lock, Volume, Squelch, general/custom search, Close Call, banks (SCG), Service Search and global lockouts.
• 🗂️ Tabs with editable frequency lists for each bank.
• 📋 Paste frequencies from a spreadsheet (Excel column) directly into a bank.

How to use

1. Connect the radio to the computer via USB cable (driver Silicon Labs CP210x installed).
2. Open the page in Chrome or Edge (over HTTPS).
3. Click Connect radio and pick the serial port.
4. Read from radio or Import file to load the configuration.
5. Edit and click Write to radio.

The Web Serial API requires HTTPS (GitHub Pages provides it automatically) or localhost for local testing.

Running locally (tests)

python3 -m http.server 8000
# open http://localhost:8000

Round-trip test of the .bc75xlt_ss format (uses the sanitized fixture in test/fixtures/ — dummy data, no real content):

node test/roundtrip.test.js
# Regenerate the fixture (optional): node test/generate-fixture.js

Publishing to GitHub Pages + bcp.romildo.net domain

1. Create a GitHub repository from this folder and push it:

   git init
   git add .
   git commit -m "BC75XLT Web Programmer"
   git branch -M main
   git remote add origin git@github.com:YOUR_USER/YOUR_REPO.git
   git push -u origin main

2. In the repository: Settings → Pages → Source: Deploy from a branch → main / root. The CNAME file is already in the repository.

3. Settings → Pages → Custom domain: enter bcp.romildo.net and save (enables automatic SSL).

4. In your DNS provider, create the record pointing to GitHub Pages:

   Type	Name	Value
   CNAME	bcp	YOUR_USER.github.io

   (Or A records for GitHub Pages' current IP addresses — see the documentation.)

5. Wait for the SSL certificate and access https://bcp.romildo.net.

Technical notes

• Communication happens directly in the browser via the Web Serial API — no data leaves your computer. Protocol based on BC75XLT_Protocol.pdf (Uniden) and on the mateusza/bearcatctl project.
• Protocol: ASCII command line terminated with \r, response terminated with \r, 57600 bps 8N1 (documented in BC75XLT_Protocol.pdf).
• The frequency field in the radio (CIN/CSP) uses 100 Hz units (MHz × 10000); the .bc75xlt_ss file uses Hz.
• The .bc75xlt_ss file is text with TAB-separated fields and CRLF line endings, faithfully reproduced on export.
• Global lockouts are read from the radio (read-only for now).
• References: mateusza/bearcatctl and skriebel/bc75xlt.

Structure

├── index.html          # Main page
├── css/style.css       # Styles
├── js/
│   ├── protocol.js     # Web Serial + BC75XLT protocol commands
│   ├── configfile.js   # Parse/export of the .bc75xlt_ss file
│   └── app.js          # UI logic and read/write operations
├── CNAME               # bcp.romildo.net
└── referencias/        # Reference repositories (ignored by git)

⚠️ Disclaimer: program your radio responsibly and within your local amateur radio / band legislation.