Passa al contenuto

← Comunicazione I2C | Indice | Avanti: Uso avanzato →

Computer a scheda singola

Collegamento di DimmerLink a Raspberry Pi, Orange Pi, Banana Pi e altri SBC.



Panoramica

Tutti i computer a scheda singola operano con logica a 3,3V — collegamento diretto a DimmerLink senza convertitori di livello.

SBC I2C UART OS
Raspberry Pi 3/4/5 ✓ ✓ Raspberry Pi OS
Orange Pi ✓ ✓ Armbian
Banana Pi ✓ ✓ Armbian



Raspberry Pi


Cablaggio

Raspberry Pi DimmerLink Funzione
Pin 1 (3.3V) VCC Alimentazione
Pin 6 (GND) GND Massa
Pin 3 (GPIO2) SDA I2C Data
Pin 5 (GPIO3) SCL I2C Clock

Per UART:

Raspberry Pi DimmerLink Funzione
Pin 1 (3.3V) VCC Alimentazione
Pin 6 (GND) GND Massa
Pin 8 (GPIO14) RX UART TX → RX
Pin 10 (GPIO15) TX UART RX ← TX


Abilitazione delle interfacce

bash
sudo raspi-config
  • I2C: Interface Options → I2C → Enable
  • UART: Interface Options → Serial Port → Enable

Riavvio dopo le modifiche:

bash
sudo reboot


Verifica dell'I2C

bash
# Install utilities (if not installed)
sudo apt install i2c-tools

# Scan I2C bus for devices
i2cdetect -y 1

Output previsto — indirizzo 50 nella tabella:

python
     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
00:          -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: 50 -- -- -- -- -- -- -- -- -- -- -- -- -- -- --


Controllo tramite CLI

I2C:

bash
# Set brightness to 50%
i2cset -y 1 0x50 0x10 0x32

# 💡 Tip: 0x32 in HEX = 50 in decimal. You can use decimal numbers: i2cset -y 1 0x50 0x10 50

# Read current brightness
i2cget -y 1 0x50 0x10

# Read mains frequency
i2cget -y 1 0x50 0x20

UART:

bash
# Configure port
stty -F /dev/serial0 115200 cs8 -cstopb -parenb

# Set brightness to 50% (requires xxd or printf)
printf '\x02\x53\x00\x32' > /dev/serial0

# Or using a Python one-liner
python3 -c "import serial; s=serial.Serial('/dev/serial0', 115200); s.write(bytes([0x02,0x53,0x00,50])); print(s.read(1).hex())"


Python + I2C (smbus2)

bash
# Install library
pip install smbus2
python
from smbus2 import SMBus
import time

DIMMER_ADDR = 0x50
REG_LEVEL = 0x10
REG_CURVE = 0x11
REG_FREQ = 0x20

bus = SMBus(1)

# Read mains frequency
freq = bus.read_byte_data(DIMMER_ADDR, REG_FREQ)
print(f"Mains frequency: {freq} Hz")

# Set brightness to 50%
bus.write_byte_data(DIMMER_ADDR, REG_LEVEL, 50)
print("Brightness set: 50%")

# Read current brightness
level = bus.read_byte_data(DIMMER_ADDR, REG_LEVEL)
print(f"Current brightness: {level}%")

bus.close()


Python + UART (pyserial)

bash
# Install library
pip install pyserial
python
import serial
import time

ser = serial.Serial('/dev/serial0', 115200, timeout=0.1)

# Set brightness to 50%
ser.write(bytes([0x02, 0x53, 0x00, 50]))
resp = ser.read(1)
if resp and resp[0] == 0x00:
    print("Brightness set: 50%")

# Get mains frequency
ser.write(bytes([0x02, 0x52]))
resp = ser.read(2)
if len(resp) == 2 and resp[0] == 0x00:
    print(f"Mains frequency: {resp[1]} Hz")

ser.close()


Script di avvio automatico (systemd)

Creare il file /etc/systemd/system/dimmer.service:

ini
[Unit]
Description=Dimmer Controller Service
After=multi-user.target

[Service]
Type=simple
ExecStart=/usr/bin/python3 /home/pi/dimmer_control.py
Restart=on-failure
User=pi

[Install]
WantedBy=multi-user.target

⚠️ Importante: Sostituire /home/pi/dimmer_control.py con il percorso del proprio script.

Attivazione:

bash
sudo systemctl daemon-reload
sudo systemctl enable dimmer.service
sudo systemctl start dimmer.service



Orange Pi


Caratteristiche

  • La maggior parte dei modelli è compatibile con i GPIO di Raspberry Pi
  • OS: Armbian (consigliato)
  • Le utilità I2C/UART sono simili a quelle di Raspberry Pi


Abilitazione dell'I2C

In Armbian:

bash
sudo armbian-config
# System → Hardware → enable i2c

Oppure tramite overlay in /boot/armbianEnv.txt:

python
overlays=i2c0

📘 Orange Pi di solito utilizza Armbian. Istruzioni per l'installazione di Armbian


Cablaggio (Orange Pi Zero)

Orange Pi Zero DimmerLink
Pin 1 (3.3V) VCC
Pin 6 (GND) GND
Pin 3 (PA12/SDA) SDA
Pin 5 (PA11/SCL) SCL


Verifica

bash
# Scan for devices
i2cdetect -y 0   # May be i2c-0 instead of i2c-1


Codice Python

Il codice è simile a quello di Raspberry Pi, ma il numero del bus può differire:

python
from smbus2 import SMBus

# Orange Pi may use bus 0
bus = SMBus(0)  # or SMBus(1) — depends on model



Banana Pi


Caratteristiche

  • Piedinatura GPIO compatibile con Raspberry Pi
  • OS: Armbian, BPI-WiringPi


Cablaggio (Banana Pi M2)

Banana Pi M2 DimmerLink
Pin 1 (3.3V) VCC
Pin 6 (GND) GND
Pin 3 (GPIO2) SDA
Pin 5 (GPIO3) SCL


Abilitazione dell'I2C

bash
sudo armbian-config
# System → Hardware → enable i2c



Raccomandazioni generali


Resistenze di pull-up per I2C

Scheda Pull-up integrato Raccomandazione
Raspberry Pi 1,8kΩ Generalmente sufficiente
Orange Pi Varia in base al modello Verificare, aggiungere 4,7kΩ
Banana Pi Varia in base al modello Verificare, aggiungere 4,7kΩ
Pico Nessuno Aggiungere 4,7kΩ


Lunghezza dei cavi

  • I2C: fino a 30 cm senza problemi
  • UART: fino a 1–2 metri


Alimentazione

  • DimmerLink assorbe una corrente minima
  • L'alimentazione dal pin 3,3V del SBC è generalmente sufficiente
  • In caso di funzionamento instabile, utilizzare un alimentatore separato


Risoluzione dei problemi

  1. I2C non funziona:
  2. Verificare i2cdetect — l'indirizzo 0x50 è visibile?
  3. Verificare le resistenze di pull-up

  4. Assicurarsi che I2C sia abilitato nel sistema

  5. UART non funziona:

  6. Verificare TX↔RX (cablaggio incrociato)
  7. Assicurarsi che UART sia abilitato

  8. Verificare i permessi di accesso a /dev/serial0

  9. Permission denied error:
    bash sudo usermod -a -G i2c,dialout $USER # Log out and back in after this



What's Next?

← Comunicazione I2C | Indice | Avanti: Uso avanzato →

Panoramica Raspberry Pi Orange Pi Banana Pi Raccomandazioni generali What's Next?