Loa Ting / Tài liệu
Tự thiết lập loa theo cách của bạn
Loa dùng được ngay với máy chủ cộng đồng. Trang này dành cho ai muốn tự cài máy chủ nhạc và khung ảnh, hoặc nối loa với nguồn báo biến động số dư của mình.
Máy chủ nhạc và khung ảnh
Mạch ESP32 không tự lấy được nhạc YouTube hay dựng ảnh từ Google Photos. Một chương trình nhỏ tên xzmusic làm việc đó rồi gửi về loa. Bạn chọn dùng máy chủ cộng đồng, hoặc tự chạy xzmusic.
1Máy chủ nhạc làm những gì
Nhạc theo yêu cầuTìm bài trên YouTube (và Zing MP3 khi Zing cho phép), chuyển thành Opus (≈6 KB/s) rồi phát trên loa. Nhớ thói quen để tự chọn bài kế.
Đài FMVOV, VOH phát trực tiếp qua Internet.
Ảnh bìaHình bài hát cắt tròn trên màn Nhạc.
Khung ảnh Google PhotosDựng sẵn từng khung 320×240 từ album bạn chia sẻ.
Giá cảGiá vàng, xăng, tỷ giá cho ứng dụng Giá cả.
Không cần cho trò chuyệnTrợ lý AI dùng máy chủ trò chuyện riêng (xiaozhi.me hoặc của bạn), không liên quan tới xzmusic.
2Chọn một trong ba cách
Cả ba nằm ở /setup → Nhạc (xzmusic) trên loa. Đổi qua lại lúc nào cũng được; mỗi máy chủ giữ lịch sử nghe riêng của nó.
Máy chủ cộng đồng
Loa tự đăng ký với music-server.tinggg.app. Không phải cài gì.
- Chạy ngay, ở đâu có Internet là có nhạc
- Lịch sử nghe riêng cho từng loa
- Giờ đông người có thể báo "bận"
Máy tính cùng Wi-Fi
Chạy xzmusic trên máy Mac hoặc Linux luôn bật ở nhà. Loa tự dò ra.
- Không giới hạn, dữ liệu ở máy bạn
- Đài trong nước chặn IP nước ngoài vẫn nghe được
- Ra khỏi nhà là không có nhạc
VPS của bạn
Chạy xzmusic sau nginx, có khoá bí mật trong địa chỉ.
- Dùng được mọi nơi, cả trên ô tô
- Mở cho bạn bè dùng chung được
- Cần VPS 2–4 GB RAM và tên miền
3Dùng máy chủ cộng đồng
- Không làm gì cả.
Loa mới (chưa có địa chỉ nhạc) tự đăng ký khoảng 20 giây sau khi có Wi-Fi. Loa cũ: mở /setup → Nhạc (xzmusic) → chọn Máy chủ cộng đồng → Lưu.
- Kiểm tra trạng thái.
Thẻ Nhạc trên /setup hiện "Đã đăng ký · …4 ký tự cuối của khoá". Nói "mở nhạc đi" để thử.
- Đăng ký lại khi cần.
Nút Đăng ký lại cấp một khoá mới; lịch sử nghe bắt đầu lại từ đầu. Nạp firmware mới không mất khoá, chỉ xoá trắng flash mới mất.
Giới hạn để chia đều cho mọi loa
- Cả máy chủ tìm tối đa 3 bài cùng lúc; đến lượt trong 20 giây, không thì loa báo "Máy chủ nhạc đang bận".
- Mỗi loa phát một luồng; mở bài mới thì bài cũ tự dừng.
- Mỗi loa gọi liên tiếp tối đa 30 bài, sau đó một bài mỗi phút. Khung ảnh tối đa một ảnh mỗi 10 giây.
Máy chủ lưu gì
- Một khoá ngẫu nhiên cho mỗi loa (chỉ lưu dạng băm), phiên bản firmware, lần cuối thấy loa.
- Lịch sử nghe của riêng loa đó, để chọn bài theo thói quen. Không ai khác xem được tên bài bạn nghe.
- Không lưu địa chỉ IP, không nhận MAC. Loa không dùng trong 30 ngày (chưa phát bài nào) hoặc 180 ngày (đã dùng) thì bị xoá.
4Tự cài trên máy tính trong nhà
Máy Mac hoặc Linux luôn bật, cùng mạng Wi-Fi với loa. xzmusic là một file chạy, cần thêm yt-dlp, ffmpeg và deno (yt-dlp dùng deno để đọc YouTube).
- Tải xzmusic cùng thư mục
bin/có sẵn yt-dlp, ffmpeg, deno.Gói cho macOS và Linux có trong bản phát hành (sắp có). Tự chuẩn bị:
brew install yt-dlp ffmpeg denotrên Mac, hoặc tải từ trang của từng dự án rồi đặt cạnh file xzmusic. - Chạy.
./xzmusic # nghe cổng 8099 trên mọi địa chỉ của máy ./xzmusic -addr :8099 -bin ./bin # chỉ rõ thư mục chứa yt-dlp, ffmpeg, denoTrên Mac có script
cai-dich-vu-nhac.commandđi kèm: nhấp đúp để xzmusic chạy nền và tự bật lại khi khởi động máy. - Trên loa: /setup → Nhạc (xzmusic) → Tìm trong mạng LAN.
Loa tự dò máy có cổng 8099 trong mạng. Hoặc chọn Máy chủ tự cài và nhập thẳng
http://192.168.1.5:8099(thay bằng IP máy tính; nên đặt IP tĩnh trong router). - Thử: mở
http://192.168.1.5:8099/api/pingtrên trình duyệt, phải thấy{"service":"xzmusic", …}.
5Tự cài trên VPS
Một lượt tìm bài tốn khoảng 500 MB RAM trong vài giây, nên chọn VPS 2–4 vCPU, 4 GB RAM. VPS ở nước ngoài thì không nghe được đài VOH (chặn IP nước ngoài); YouTube đôi khi đòi xác minh IP máy chủ (xem cookies).
- Chạy xzmusic sau nginx, chỉ nghe ở máy, có khoá trong đường dẫn.
# khoá đọc từ biến môi trường, không lộ trong danh sách tiến trình export XZ_KEY=$(openssl rand -hex 16) ./xzmusic -addr 127.0.0.1:8099 -bin /opt/xzmusic/binChạy lâu dài bằng systemd; lịch sử nghe lưu ở
$STATE_DIRECTORY(systemd đặt) hoặc thư mục cấu hình của user. - nginx: đưa
/k/sang xzmusic, không đệm luồng nhạc.location /k/ { proxy_pass http://127.0.0.1:8099; proxy_buffering off; # luồng nhạc dài, gửi ngay từng gói proxy_request_buffering off; proxy_read_timeout 900s; access_log off; # query có link album Google Photos } - Trên loa: /setup → Nhạc (xzmusic) → Máy chủ tự cài →
https://ten-mien-cua-ban/k/<XZ_KEY>→ Lưu.Ai biết địa chỉ có khoá là dùng được máy chủ của bạn, nên đừng chia sẻ nó.
Muốn cho nhiều loa dùng chung như máy chủ cộng đồng? Chạy với XZ_PUBLIC=1 (không cần XZ_KEY): mỗi loa có khoá, lịch sử và giới hạn riêng. Chế độ Cộng đồng trên loa chỉ đăng ký với music-server.tinggg.app, nên mỗi loa lấy khoá bằng một lệnh curl -X POST https://ten-mien-cua-ban/api/register -d '{"device":"<64 ký tự hex bất kỳ>"}' rồi nhập https://ten-mien-cua-ban/k/<key> vào Máy chủ tự cài.
6Khung ảnh Google Photos
Dùng được với cả ba cách trên. Không cần đăng nhập Google trên loa: xzmusic đọc album đã chia sẻ bằng link.
- Google Photos → mở album → Chia sẻ → Tạo đường liên kết → Sao chép.
Link có dạng
https://photos.app.goo.gl/…. Muốn đổi ảnh chỉ cần thêm, bớt ảnh trong album; loa thấy ảnh mới sau khoảng 30 phút. - /setup → Khung ảnh (Google Photos): bật, dán link, chọn đổi ảnh sau 15 giây đến 5 phút → Lưu.
- Loa rảnh 1 phút là tự trình chiếu, kèm giờ, ngày âm lịch, thời tiết. Chạm màn hình để thoát.
Ảnh được dựng thế nào
- Ảnh ngang: cắt vừa màn hình, Google tự chọn phần đáng giữ.
- Ảnh dọc: ghép đôi cạnh nhau; ảnh lẻ đặt trên nền mờ của chính nó.
- Thứ tự trộn lại mỗi ngày. Mỗi khung chỉ dựng một lần mỗi ngày rồi giữ sẵn.
Nên biết
- Ai có link album là xem được ảnh: chỉ đưa vào album những ảnh bạn chấp nhận như vậy.
- Mỗi khung khoảng 150 KB. Đổi ảnh 30 giây một lần, cả ngày, là ≈ 0,4 GB/ngày qua mạng nhà.
- xzmusic chỉ nhận link
photos.app.goo.glvàphotos.google.com/share, không mở địa chỉ nào khác.
7Khi YouTube đòi xác minh (cookies)
Đôi khi YouTube trả "Sign in to confirm you're not a bot" cho IP máy chủ. Lúc đó yt-dlp cần cookies của một tài khoản Google. Chỉ áp dụng khi bạn tự cài; máy chủ cộng đồng do người quản trị lo.
- Dùng một tài khoản Google phụ.
Google có thể khoá tài khoản bị dùng tự động; đừng dùng tài khoản chính.
- Xuất cookies từ cửa sổ ẩn danh.
Mở cửa sổ ẩn danh, đăng nhập YouTube, mở
youtube.com/robots.txt, xuất bằng extension "Get cookies.txt LOCALLY" (bật cho phép ở chế độ ẩn danh), rồi đóng cửa sổ ngay. Dùng tiếp phiên đó thì Google đổi cookies và file vừa xuất hết hiệu lực. - Đặt file
cookies.txtvào thư mục dữ liệu của xzmusic rồi khởi động lại.Cùng chỗ với
history.json. xzmusic chỉ giữ dòng của youtube.com và google.com, mặc định chỉ dùng khi YouTube đòi xác minh, mỗi lần chạy yt-dlp dùng một bản sao tạm rồi xoá.
8Khi loa báo lỗi
| Loa báo | Nghĩa là | Làm gì |
|---|---|---|
| Máy chủ nhạc đang bận, thử lại sau | Máy chủ đang tìm đủ số bài cùng lúc, hoặc loa gọi quá nhiều trong thời gian ngắn. | Đợi vài chục giây rồi gọi lại. |
| Khoá máy chủ nhạc không còn đúng | Khoá đã bị xoá (lâu không dùng) hoặc gõ sai địa chỉ. | Chế độ cộng đồng: loa tự đăng ký lại một lần. Tự cài: kiểm tra lại /k/<khoá>. |
| Loa đã bị chặn khỏi máy chủ nhạc cộng đồng | Quản trị máy chủ cộng đồng đã chặn loa này. | Liên hệ qua GitHub, hoặc tự cài máy chủ. |
| Máy chủ nhạc cộng đồng đã đầy / đang đóng đăng ký | Đủ số loa tối đa, hoặc tạm ngừng nhận loa mới. | Loa tự thử lại sau 6 giờ. Muốn dùng ngay thì tự cài. |
| Không tìm được bài | Không có bài nào dài 1–20 phút khớp lời gọi, hoặc YouTube đang chặn IP máy chủ. | Gọi rõ tên bài và ca sĩ. Tự cài thì xem cookies. |
| Máy chủ nhạc không phản hồi | Không kết nối được tới địa chỉ đã lưu. | Mở <địa chỉ>/api/ping để thử; máy tính trong nhà phải đang bật. |
Gặp lỗi khác, hoặc làm theo vẫn không được? Hỏi trong nhóm Zalo Loa Ting - ESP32 Custom →
Báo biến động số dư
Loa không tự đọc tài khoản ngân hàng. Một nguồn nào đó (điện thoại, máy tính, máy chủ của bạn) báo giao dịch cho loa; loa kêu "ting", đọc số tiền và hiện chi tiết. Có hai cách báo.
1Hai cách báo cho loa
| Gửi qua LAN | Máy chủ riêng | |
|---|---|---|
| Cách làm | Nguồn gọi thẳng vào loa: POST http://<ip-loa>:8080/api/notify | Loa tự hỏi máy chủ của bạn: GET …/api/v1/speaker/poll, giữ kết nối chờ tin |
| Nguồn ở đâu | Phải cùng mạng Wi-Fi với loa | Ở đâu cũng được; loa chỉ cần có Internet |
| Cần gì | Token của loa, một app tự động trên điện thoại hoặc một script | Một máy chủ HTTPS nhỏ (có mẫu Python) và một khoá loa |
| Loa mất mạng | Tin gửi lúc đó bị mất | Loa bù tin trong 15 phút gần nhất khi có mạng lại |
| Hợp với | Một cửa hàng, một điện thoại nhận thông báo, loa đặt cạnh | Nhiều loa, loa trên ô tô, hoặc nguồn chạy trên máy chủ (email, webhook ngân hàng) |
Chỉ chọn một cách cho mỗi tài khoản. Loa không lọc trùng giữa LAN và máy chủ: cùng một giao dịch gửi cả hai đường thì nghe hai lần.
2Gửi qua LAN
- Lấy địa chỉ và token của loa.
Trên loa: Menu → Cài đặt hiện IP và token (bước 3). Token 6–32 ký tự, đổi ở /setup → Token API. Nên đặt IP tĩnh cho loa trong router.
- Gửi thử một giao dịch (
test: true= hiện và đọc nhưng không lưu vào lịch sử).curl -X POST http://192.168.1.18:8080/api/notify \ -H "X-Token: token-cua-loa" -H "Content-Type: application/json" \ -d '{"type":"in","amount":150000,"bank":"VCB","counterparty":"NGUYEN VAN A", "content":"tien an","balance":12500000,"test":true}' # → {"ok":true,"speech":"Vietcombank nhận một trăm năm mươi nghìn đồng"} - Nối với nguồn thật: app tự động trên điện thoại (mục 4), hoặc script trên máy tính trong nhà gọi đúng lệnh trên mỗi khi có giao dịch.
Loa đọc gì
Chỉ hai kiểu câu: "<ngân hàng> nhận <số tiền> đồng" và "<ngân hàng> chuyển khoản <số tiền> đồng". Người gửi, nội dung, số dư, mã xác nhận chỉ hiện trên màn hình, không bao giờ đọc to.
Bảo vệ
Thiếu hoặc sai token: 401. Một máy gửi sai 10 lần trong một phút thì bị từ chối (429) 10 giây. API chỉ mở trong mạng nhà; đừng mở cổng 8080 ra Internet.
3Các trường của một giao dịch
Chỉ amount là bắt buộc. Thiếu trường nào khác thì loa vẫn đọc, vẫn lưu; trên màn hình chỗ đó để trống hoặc hiện "—".
| Trường | Ý nghĩa |
|---|---|
amountbắt buộc | Số tiền, khác 0. Số (150000) hoặc chuỗi ("+150,000 VND"). Không có type thì dấu quyết định: dương là nhận, âm là chuyển đi. Thiếu hoặc bằng 0: 400 amount required. |
typetuỳ chọn | "in" nhận tiền, "out" chuyển đi (cũng nhận credit/debit, thu/chi…). |
banktuỳ chọn | Mã ngân hàng: VCB, TCB, MB, ACB, BIDV, VTB, AGR, TPB, VPB, STB, VIB, MOMO, ZALOPAY… để loa đọc đúng tên và tô đúng màu. |
accounttuỳ chọn | Vài số cuối tài khoản, hiện "TK *6789". |
counterpartytuỳ chọn | Người gửi (tiền vào). Cũng nhận tên sender. |
contenttuỳ chọn | Nội dung chuyển khoản hoặc cả thông báo ngân hàng. Chỉ hiện với tiền vào. |
balancetuỳ chọn | Số dư sau giao dịch. Thiếu thì thẻ giao dịch không có dòng "SD", chi tiết hiện "—". |
confirm_codetuỳ chọn | Mã đơn hàng bạn tự bóc từ nội dung (≤ 64 ký tự), hiện thành chip trên thẻ để đối chiếu nhanh. Chỉ tiền vào. |
speaktuỳ chọn | false = chỉ "ting" và hiện, không đọc. |
testtuỳ chọn | true = hiện và đọc nhưng không lưu vào lịch sử. |
Mọi giao dịch thật được lưu vào lịch sử (thẻ microSD, không có thẻ thì trong flash) và tải được file CSV theo tháng ở /setup. Tiền ra không hiện người nhận và nội dung.
4Từ điện thoại nhận thông báo ngân hàng
Điện thoại phải cùng Wi-Fi với loa. Ý tưởng chung: khi app ngân hàng hiện thông báo, một app tự động đọc số tiền rồi gọi /api/notify.
iPhone · Phím tắt (Shortcuts)
Từ iOS 27, Phím tắt chạy được khi một app gửi thông báo, nên dùng thẳng thông báo của app ngân hàng. iOS cũ hơn: dùng SMS biến động số dư (Tự động hoá → Tin nhắn, người gửi là tên ngân hàng).
- Phím tắt → Tự động hoá → + → Thông báo → chọn app ngân hàng (lọc thêm theo tiêu đề hoặc nội dung nếu cần) → chạy ngay, không cần hỏi.
- Lấy số tiền từ nội dung thông báo bằng Khớp văn bản (ví dụ biểu thức
[+-][\d,.]+). - Thêm Nhận nội dung của URL: phương thức POST, header
X-Token, thân JSONamount,bank,content.
Android · MacroDroid hoặc Tasker
- Kích hoạt: Nhận thông báo từ app ngân hàng (cấp quyền đọc thông báo).
- Lấy số tiền và nội dung từ tiêu đề, thân thông báo vào biến.
- Hành động: HTTP Request POST tới
http://<ip-loa>:8080/api/notify, headerX-Token, thân JSON như mục 2.
Mỗi ngân hàng viết thông báo một kiểu. Thử với "test": true vài lần trước khi bật thật, và kiểm số tiền loa đọc khớp với app ngân hàng. Trên iOS 27.0 có báo cáo tự động hoá theo thông báo thỉnh thoảng không chạy, nên dùng thử vài ngày trước khi dựa hẳn vào nó.
5Máy chủ riêng: loa tự hỏi tin mới
Loa giữ một kết nối HTTPS tới máy chủ của bạn và hỏi liên tục; có tin là máy chủ trả ngay. Bạn viết máy chủ bằng ngôn ngữ nào cũng được, miễn đúng giao thức dưới đây (hoặc dùng mẫu Python).
- Tạo một khoá loa 32–128 ký tự (chữ, số,
- _ . ~ + / =), ví dụopenssl rand -hex 24. - Chạy máy chủ sau HTTPS (Caddy, nginx hoặc Cloudflare Tunnel).
- Trên loa: /setup → Máy chủ báo giao dịch → địa chỉ (ví dụ
https://bank.ten-mien.vn, không có/api/…) và khoá → Lưu.Nối được lần đầu loa kêu "ting". Trang Biến động số dư trên loa hiện nguồn: LAN + Máy chủ, Mất máy chủ hoặc Sai khóa loa.
Yêu cầu loa gửi
GET /api/v1/speaker/poll?boot=<boot>&after=<seq>
X-Speaker-Key: <khoá loa>
Accept: application/json
# lần đầu (loa chưa biết boot) thì không có ?boot=…&after=…Máy chủ trả lời
{
"boot": "5f5b76ca55b9a1d6", // mã lần chạy của máy chủ: hex, ≤ 32 ký tự
"seq": 2, // con trỏ: tin mới nhất đã trả
"items": [
{ "id": 2, "seq": 2, "type": "in", "amount": 150000, "bank": "VCB", "account": "6789",
"sender_name": "NGUYEN VAN A", "confirm_code": null,
"content": "Biến động số dư\n+150,000 VND tien an", "balance": 12500000, "age_s": 3 }
]
}| Giữ yêu cầu | Chưa có tin thì giữ tối đa 25 giây rồi trả items: []. Loa chờ tối đa 35 giây. |
|---|---|
| Lần đầu | Không có boot: trả ngay boot, seq hiện tại và items: [], để loa không đọc lại tin cũ. |
| Bù tin | boot khớp: trả các tin có seq lớn hơn after. boot khác (máy chủ đã chạy lại): trả lại cả bộ đệm. Nên giữ tin 15 phút. |
| Mỗi tin | id số dương, không lặp (loa bỏ tin trùng id). amount dương; chiều nằm ở type "in"/"out". age_s: tin đã xảy ra bao nhiêu giây; cũ hơn 300 giây thì loa chỉ hiện và lưu, không đọc. |
| Mỗi lần trả | Tối đa 20 tin, content ≤ 600 ký tự, cả câu trả lời dưới 64 KB. Trả ít hơn số đang có thì đặt seq bằng tin cuối đã trả. |
| Lỗi | 401/403: loa hiện "Sai khóa loa" và ngừng hỏi tới khi đổi khoá. Lỗi khác: thử lại sau 1, 2, 4… tối đa 60 giây. |
6Máy chủ mẫu (Python, không cần cài thêm gì)
Một file, chỉ dùng thư viện chuẩn của Python 3.8+. Nguồn của bạn gửi giao dịch vào POST /ingest; loa lấy ra qua /api/v1/speaker/poll. Đã chạy thử đủ các trường hợp ở mục 5.
loa_push.py#!/usr/bin/env python3
"""Máy chủ mẫu báo biến động số dư cho Loa Ting. Chỉ dùng thư viện chuẩn, Python 3.8+.
POST /ingest app hoặc script của bạn gửi giao dịch vào (header X-Token)
GET /api/v1/speaker/poll loa hỏi tin mới (header X-Speaker-Key), chờ tối đa 25 s
Chạy: SPEAKER_KEY=<32+ ký tự> INGEST_TOKEN=<bí mật> python3 loa_push.py
Nghe cổng 8787; đặt sau HTTPS (Caddy, nginx, Cloudflare Tunnel) rồi nhập địa chỉ vào loa.
"""
import hmac, json, os, secrets, threading, time
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from urllib.parse import parse_qs, urlsplit
SPEAKER_KEY = os.environ["SPEAKER_KEY"] # nhập vào loa: /setup → Máy chủ báo giao dịch
INGEST_TOKEN = os.environ["INGEST_TOKEN"]
PORT = int(os.environ.get("PORT", "8787"))
BOOT = secrets.token_hex(8) # mỗi lần chạy một mã mới: loa biết máy chủ đã khởi động lại
KEEP_S, HOLD_S, BATCH = 15 * 60, 25, 20 # giữ tin 15 phút, giữ yêu cầu 25 s, tối đa 20 tin/lần
items, last_seq, cond = [], 0, threading.Condition()
def add(tx):
global last_seq
with cond:
last_seq += 1
items.append(dict(tx, id=last_seq, seq=last_seq, at=time.time()))
cutoff = time.time() - KEEP_S
items[:] = [i for i in items if i["at"] >= cutoff]
cond.notify_all()
return last_seq
def newer(after):
now = time.time()
out = []
for i in items:
if i["seq"] > after:
o = dict(i, age_s=int(now - i["at"]))
del o["at"]
out.append(o)
return out
class Handler(BaseHTTPRequestHandler):
def reply(self, code, obj):
body = json.dumps(obj, ensure_ascii=False).encode()
self.send_response(code)
self.send_header("Content-Type", "application/json; charset=utf-8")
self.send_header("Content-Length", str(len(body)))
self.end_headers()
self.wfile.write(body)
def do_GET(self):
url = urlsplit(self.path)
if url.path != "/api/v1/speaker/poll":
return self.reply(404, {"error": "not found"})
if not hmac.compare_digest(self.headers.get("X-Speaker-Key", ""), SPEAKER_KEY):
return self.reply(401, {"error": "bad key"})
q = parse_qs(url.query)
with cond:
if "boot" not in q: # lần đầu: chỉ trả con trỏ, không đọc lại tin cũ
return self.reply(200, {"boot": BOOT, "seq": last_seq, "items": []})
same = q["boot"][0] == BOOT
after = int(q.get("after", ["0"])[0] or 0) if same else 0
deadline = time.time() + HOLD_S
while not newer(after) and time.time() < deadline:
cond.wait(deadline - time.time())
out = newer(after)
batch = out[:BATCH]
seq = batch[-1]["seq"] if len(out) > BATCH else last_seq
self.reply(200, {"boot": BOOT, "seq": seq, "items": batch})
def do_POST(self):
if urlsplit(self.path).path != "/ingest":
return self.reply(404, {"error": "not found"})
if not hmac.compare_digest(self.headers.get("X-Token", ""), INGEST_TOKEN):
return self.reply(401, {"error": "bad token"})
try:
tx = json.loads(self.rfile.read(min(int(self.headers.get("Content-Length", 0)), 8192)))
amount = float(tx["amount"])
kind = tx.get("type") or ("in" if amount > 0 else "out")
assert kind in ("in", "out") and amount != 0
except Exception:
return self.reply(400, {"error": "need amount (and type in|out)"})
item = {"type": kind, "amount": abs(amount), "bank": str(tx.get("bank", "")),
"account": str(tx.get("account", "")), "balance": tx.get("balance")}
if kind == "in": # tiền ra: loa không hiện người nhận, nội dung
item.update(sender_name=tx.get("sender_name"), confirm_code=tx.get("confirm_code"),
content=(tx.get("content") or "")[:600] or None)
self.reply(200, {"ok": True, "id": add(item)})
def log_message(self, fmt, *args):
print("%s %s" % (self.address_string(), fmt % args))
if __name__ == "__main__":
print("Loa Ting push server on :%d (boot %s)" % (PORT, BOOT))
srv = ThreadingHTTPServer(("0.0.0.0", PORT), Handler)
srv.daemon_threads = True
srv.serve_forever()- Chạy:
SPEAKER_KEY=$(openssl rand -hex 24) INGEST_TOKEN=$(openssl rand -hex 16) python3 loa_push.pyIn hai giá trị đó ra và giữ lại:
SPEAKER_KEYnhập vào loa,INGEST_TOKENdùng cho nguồn gửi tin. - Đặt sau HTTPS, ví dụ với Caddy:
bank.ten-mien.vn { reverse_proxy 127.0.0.1:8787 }. - Gửi giao dịch vào từ app chuyển tiếp thông báo, webhook ngân hàng hay script đọc email:
curl -X POST https://bank.ten-mien.vn/ingest -H "X-Token: $INGEST_TOKEN" \ -d '{"type":"in","amount":150000,"bank":"VCB","sender_name":"NGUYEN VAN A","content":"tien an"}'
Mẫu giữ tin trong RAM: chạy lại là mất bộ đệm (loa vẫn chạy tiếp bình thường). Một máy chủ này phục vụ được nhiều loa dùng chung một khoá; muốn mỗi loa một khoá thì thêm danh sách khoá.
7Lưu ý chung
Nhiều tin một lúcLoa đọc riêng từng tin, mỗi tin một tiếng "ting", từ cũ tới mới.
Đang phát nhạcNhạc dừng để đọc; đang nghe đài thì đài tạm dừng rồi nối lại.
Tiền raThẻ viền đỏ, cộng vào tổng chi hôm nay; không hiện người nhận và nội dung.
Thiếu số dư hay nội dungKhông lỗi. Thẻ giao dịch gọn lại, chi tiết hiện "—".
QR nhận tiềnỨng dụng QR Bank hiện VietQR có số tiền; giao dịch khớp số tiền thì hiện "Đã nhận".
Giữ bí mậtToken LAN và khoá loa như mật khẩu. /setup chỉ hiện 4 ký tự cuối của khoá loa.
Bản HUD ô tô
Loa trong vỏ HUD chạy bản firmware HUD ô tô: chọn ở trang Nạp firmware. Bản này có Dẫn đường, OBD II và TPMS, bỏ Hẹn giờ, Pomodoro, Giá cả, QR Wi-Fi, Ban đêm, Thông báo. Đổi qua lại bằng chế độ Cập nhật vẫn giữ Wi-Fi và cài đặt.
1Dẫn đường bằng Waze Mod
- Mở Dẫn đường trên loa.
Màn chờ hiện địa chỉ Wi-Fi của loa và tên Bluetooth của nó.
- Nối từ Waze Mod.
Waze Mod → Cài đặt Mod → Thiết bị → HUD Link: chọn BLE rồi chọn Loa Ting HUD, hoặc Wi-Fi WebSocket rồi nhập địa chỉ trên màn loa (điện thoại và loa cùng mạng, ví dụ điểm phát Wi-Fi của điện thoại).
- Lật hình cho kính.
Đang dẫn đường: giữ 1 giây trên màn để mở Cài đặt nhanh rồi chạm Phản chiếu (cũng tắt bíp, bật giọng đọc, Chỉ tốc độ ở đó). Màn chờ: nút Phản chiếu. Vỏ cổng sạc trái thì bật thêm Xoay 180° ở bảng Điều khiển.
- Bíp, giọng đọc, bù tốc độ.
Nút trên màn Dẫn đường bật tắt tiếng bíp và giọng đọc cảnh báo (giọng mặc định tắt). Đồng hồ xe lệch với tốc độ GPS thì chỉnh ở /setup → Dẫn đường → Bù tốc độ so với app.
2OBD II: số liệu và lỗi xe
Cần một đầu đọc ELM327 Bluetooth LE (BLE): Vgate, Vlink, Veepeak, Konnwei, LELink, Carista… Loại chỉ có Bluetooth thường (cổng nối tiếp SPP, hay ghép đôi bằng mã 1234) loa không đọc được.
- Cắm đầu đọc vào cổng OBD II
dưới vô lăng, bật chìa khoá hoặc nổ máy.
- Mở OBD II trên loa.
Loa tìm đầu đọc trong 40 giây, thấy là tự nối và nhớ lại cho các lần sau. Không thấy thì kiểm đèn đầu đọc, đưa loa lại gần, bấm Tìm lại.
- Xem các tab.
Xe: tốc độ, vòng tua, nước mát, nhiên liệu, ắc quy. Chuyến: quãng đường, thời gian, xăng tiêu thụ. Mã lỗi: mã kèm nghĩa, xoá mã. Đăng kiểm: hệ thống nào chưa tự kiểm xong.
Cảnh báo trên mọi màn
- Đèn check engine sáng, kèm mã lỗi.
- Nước làm mát quá nóng: dừng xe an toàn.
- Vòng tua quá cao, nổ máy đứng yên quá lâu.
Đổi đầu đọc
- Trong OBD II bấm Quên đầu đọc, rồi Tìm đầu đọc để nối cái mới.
- Xe không báo xăng tiêu thụ thì ô Xăng để trống.
3TPMS: áp suất lốp
Dùng loại cảm biến gắn van Bluetooth LE bán kèm app "TPMS" trên điện thoại (tên TPMS1_…, TPMS2_…). Cảm biến không cần ghép với điện thoại; loa nghe tín hiệu của chúng.
- Gắn bốn cảm biến
đúng lốp ghi trên cảm biến (1 trước trái, 2 trước phải, 3 sau trái, 4 sau phải).
- Mở TPMS, bấm Ghép cảm biến.
Vặn lại từng cảm biến hoặc lăn xe vài mét; loa nhận cảm biến gần nhất cho từng lốp nên xe bên cạnh không lẫn vào.
- Chọn đơn vị và kiểu xe
bằng nút bánh răng: PSI, bar hay kPa; Mini, Sedan, SUV, Bán tải. Lắp nhầm lốp thì dùng Đổi vị trí cảm biến.
- Đặt ngưỡng trên /setup → Áp suất lốp.
Ngưỡng non và căng riêng cho lốp trước, lốp sau; nhiệt độ nóng. Lốp xì hơi, non, căng hay nóng thì loa cảnh báo trên mọi màn.
Loa Ting Lite cho mạch vàng CYD
Bản rút gọn cho mạch vàng ESP32-2432S028 (2,8″) và ESP32-3248S035R / C (3,5″): ESP32 thường, không mic, loa qua DAC 8-bit. Sắp có: chưa phát hành, chưa thử trên mạch thật. Nạp ở trang Nạp firmware khi có bản.
1Lần đầu bật
- Hiệu chỉnh cảm ứng
(mạch cảm ứng điện trở): chạm lần lượt 3 dấu +. Làm lại: giữ BOOT lúc cắm điện, hoặc /setup → Màn hình.
- Chọn ngôn ngữ.
Tiếng Việt hoặc English.
- Nối Wi-Fi.
Quét mã QR trên màn hoặc vào Wi-Fi LoaTingLite-xxxx (bản HUD: LoaTingLiteHUD-xxxx), trang cài đặt tự mở (hoặc mở
192.168.4.1), chọn mạng nhà. Bản HUD chỉ mở điểm phát khi chưa lưu Wi-Fi nào: giữ BOOT 2 giây để mở lại. - Mở /setup.
Vuốt sang trang Cài đặt (trang cuối), quét mã để mở
http://<ip>:8080/setup: máy chủ báo giao dịch, âm lượng, độ sáng, báo thức, màn hình.
2Có và không có
Có
- Báo chuyển khoản "ting" + giọng đọc, cùng cách nối như Báo số dư; 10 giao dịch gần nhất.
- Nhạc (máy chủ cộng đồng hoặc riêng) và FM.
- Để bàn: đồng hồ, âm lịch, thời tiết, QR nhận tiền, 5 báo thức, đếm ngược.
- HUD: Waze Mod (Bluetooth Loa Ting Lite HUD hoặc
ws://<ip>:8765/hlp), OBD II, áp suất lốp, như bản HUD.
Không có
- Trợ lý giọng nói (mạch không có mic), podcast.
- Thông báo điện thoại, khung ảnh, lịch sử trên thẻ nhớ.
- Tự cập nhật: bản mới thì nạp lại ở trang Nạp firmware, chế độ Cập nhật vẫn giữ Wi-Fi và cài đặt.
- Báo thức chỉ đặt được trên /setup.
3Màn hình, âm thanh
Màu sai, hình ngược
- Mạch 2,8″ có hai loại màn (ILI9341, ST7789), loa tự nhận.
- Vẫn sai: /setup → Màn hình để đổi driver, đảo màu, thứ tự màu, xoay 180°.
- Mạch 3,5″: giao diện còn vẽ khổ 320 × 240 ở góc màn, cho tới khi xong phần co giãn.
Nhạc giật, nhỏ
- Không có PSRAM nên chỉ đệm được khoảng 5 giây (HUD 2,5 giây): máy chủ nhạc trong nhà mượt hơn qua Internet.
- Loa qua DAC 8-bit: giọng đọc rõ, nhạc nhỏ và rè hơn loa ES3C28P.
- Đang đọc giao dịch hay đổ chuông thì nhạc tạm dừng; bản HUD bật OBD II / TPMS mà thiếu bộ nhớ thì Nhạc nhắc tắt bớt.
Sắp có trong bản phát hành
Firmware 1.9, bản Loa để bàn và HUD ô tô, đã nạp được ngay trên trình duyệt ở trang Nạp firmware. Các gói cài dưới đây sẽ có khi phát hành; trước đó, máy chủ cộng đồng và mọi API trên trang này đã dùng được với loa chạy firmware hiện tại.
- xzmusic cho macOS, Linux
- Script cài chạy nền trên Mac
- File cài đặt VPS
