$ curl -fsSL https://ia.sa/rpidriver/install | sudo bash

# 1. عدّل الإعدادات
$ sudo nano /etc/rpidriver/config.ini

# 2. شغّل الخدمة
$ sudo systemctl start rpidriver

# 3. راقب السجل
$ journalctl -u rpidriver -f

$ git clone https://github.com/ibrahimaljuhani/rpidriver.git
$ cd rpidriver
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install -e .
$ cp config/config.ini.tmpl /etc/rpidriver/config.ini
$ rpidriver

# ── الإعداد الرئيسي ──────────────────────────────
[rpidriver]
host    = 0.0.0.0          # استمع على كل الواجهات
port    = 8069
debug   = false
drivers = escpos_driver, scale_driver, display_driver

# ── طابعة ESC/POS ────────────────────────────────
[escpos_driver]
paper_width      = 576       # 576 = ورق 80mm, 384 = ورق 58mm
arabic_font_path = /usr/share/fonts/truetype/noto/NotoSansArabic-Regular.ttf

# ── الميزان التسلسلي ──────────────────────────────
[scale_driver]
port     = /dev/ttyUSB0
baudrate = 9600
protocol = toledo8217      # toledo8217 | adam
timeout  = 1.0

# ── شاشة العميل ──────────────────────────────────
[display_driver]
port     = /dev/ttyACM0
baudrate = 9600

# ── CUPS (طباعة عبر الشبكة) ───────────────────────
[cups_driver]
cups_host     = localhost
cups_port     = 631
printer_name  = Receipt_Printer

$ lsusb
Bus 001 Device 005: ID 04b8:0e15 Seiko Epson Corp. TM-T20

[scale_driver]
port     = /dev/ttyUSB0   # أو /dev/ttyS0 للمنفذ التسلسلي المدمج
baudrate = 9600
protocol = toledo8217     # toledo8217 | adam
timeout  = 1.0

$ curl -s -X POST http://localhost:8069/hw_proxy/scale_read \
    -H 'Content-Type: application/json' \
    -d '{"jsonrpc":"2.0","method":"call","id":1,"params":{}}'
{"jsonrpc":"2.0","id":1,"result":{"weight":1.234,"unit":"kg","status":"ok"}}

[cups_driver]
cups_host    = localhost       # أو IP خادم CUPS
cups_port    = 631
printer_name = Receipt_Printer # اسم الطابعة في CUPS

# افتح واجهة CUPS
$ http://localhost:631

# أو أضف الطابعة من سطر الأوامر
$ lpadmin -p Receipt_Printer -E -v usb://Epson/TM-T20 \
    -m everywhere

[escpos_driver]
arabic_font_path = /usr/share/fonts/truetype/noto/NotoSansArabic-Regular.ttf

# Pipeline: النص → reshape → bidi → PIL Image → ESC/POS bytes
arabic_reshaper.reshape(text)      # شكل الحروف السياقية
→ bidi.get_display(reshaped)        # الترتيب RTL
→ PIL.Image → GS v 0 bytes         # رندر وتحويل لبايتات ESC/POS

# حالة الخدمة
$ systemctl status rpidriver

# بدء / إيقاف / إعادة تشغيل
$ sudo systemctl start   rpidriver
$ sudo systemctl stop    rpidriver
$ sudo systemctl restart rpidriver

# السجل المباشر
$ journalctl -u rpidriver -f

# سجل آخر 100 سطر
$ journalctl -u rpidriver -n 100 --no-pager

# تعطيل التشغيل التلقائي
$ sudo systemctl disable rpidriver

# تحقق من USB
$ lsusb | grep -i epson

# تحقق من الصلاحيات
$ ls -la /dev/bus/usb/*/*

# أعد تحميل udev
$ sudo udevadm control --reload-rules && sudo udevadm trigger

# اكتشف المنفذ
$ ls /dev/ttyUSB* /dev/ttyACM* /dev/ttyS* 2>/dev/null

# اختبر الاستقبال مباشرة
$ python3 -c "import serial; s=serial.Serial('/dev/ttyUSB0',9600); print(s.readline())"

# تحقق من وجود الخط
$ ls /usr/share/fonts/truetype/noto/NotoSansArabic*

# ثبّت إذا غاب
$ sudo apt-get install -y fonts-noto-core fonts-noto-extra

# راجع السبب
$ journalctl -u rpidriver -n 50 --no-pager

# شغّل يدوياً لرؤية الخطأ
$ sudo -u rpidriver /opt/rpidriver/.venv/bin/rpidriver

# 1. تأكد أن الخدمة تعمل
$ systemctl status rpidriver

# 2. اختبر الاتصال من نفس الشبكة
$ curl http://[Pi-IP]:8069/hw_proxy/hello
ping

# 3. تحقق أن Port 8069 مفتوح
$ ss -tlnp | grep 8069

# 4. تحقق من جدار الحماية
$ sudo ufw status
$ sudo ufw allow 8069/tcp