(Using GNU/Linux):
git clone https://github.com/fquinto/bticinoClasse300x.git
cd bticinoClasse300x
sudo python3 -m pip install --upgrade pip
sudo python3 -m pip install -r requirements.txt
sudo python3 main.py(Using Docker):
git clone https://github.com/fquinto/bticinoClasse300x.git
cd bticinoClasse300x
docker compose run bticino-
Download and install "My Home Suite" configuration software (Windows only) from the official page
-
Unmount the intercom from the wall and, while still connected to the SCS 2-wire bus, connect to the intercom via the Mini-USB port located on the back. See the following technical sheets for USB port location: C100X - C300X
-
Follow the steps shown in the following animation to select your specific device model and flash it with firmware generated by the script in step 1
NOTE: <intercom_ip> is the IP address of the video intercom door entry unit.
To better understand MQTT implementation, have a look here
Once you flashed the new firmware, establish a connection with your intercom via SSH
ssh root2@<intercom_ip>If you're using a mac (OSx)
# First create a RSA key if you never done before
ssh-keygen -t rsa
# Do the connection
ssh -oHostKeyAlgorithms=+ssh-rsa root2@<intercom_ip>Proceed with all the following
# Move to the folder
cd /etc/tcpdump2mqtt
# Make the filesystem writable.
mount -oremount, rw /
# Modify the config file with your MQTT parameters (server, user and password)
vi TcpDump2Mqtt.conf
# Make the filesystem read-only again.
mount -oremount, ro /
# Restart the video door entry unit.
reboot Our intercom is now sending / receiving any commands to the MQTT broker.
NOTE: In order to manage MQTT topics in Homeassistant it is necessary to have the MQTT integration installed and have followed the instructions in the previous step
-
Basic configuration
In the Homeassistant configuration.yaml file, in the mqtt: block it is necessary to insert the following lines to instruct MQTT to receive / transmit on the topics we have defined in the firmware creation script:
mqtt: sensor: - unique_id: '14532784978700' name: "Video intercom TX" state_topic: "Bticino/tx" availability_topic: "Bticino/LastWillT" icon: mdi:phone-outgoing - unique_id: '13454564689485' name: "Video intercom RX" state_topic: "Bticino/rx" availability_topic: "Bticino/LastWillT" icon: mdi:phone-incoming
-
Automations
We need to create automations that allow us to interact with the video door entry unit.
-
Open the door
The following automation creates a button that allows the gate to be opened and creates a notification in the Homeassistant notification area.
- id: '1656918057723' alias: Apertura Cancelletto Pedonale description: '' trigger: - platform: state entity_id: - input_button.cancelletto_pedonale condition: [] action: - service: notify.persistent_notification data: message: Il cancello pedonale è aperto - service: mqtt.publish data: topic: Bticino/rx payload: '*8*19*20##' - delay: hours: 0 minutes: 0 seconds: 1 milliseconds: 0 - service: mqtt.publish data: payload: '*8*20*20##' topic: Bticino/rx mode: single
-
Recognize the commands
The following automation recognizes some commands received from the video door entry unit and notifies the event. Obviously the notification scripts shown in the automation will have to be replaced with the one you want.
- id: '1657896199804' alias: Notifiche dal citofono description: '' trigger: - platform: state entity_id: - sensor.video_intercom_tx action: - choose: - conditions: - condition: state entity_id: sensor.video_intercom_tx state: '*8*21*10##' sequence: - service: script.notifica_voce_evento data: notification_message: "La luce scala è stata attivata" - service: script.notifica_testo_evento data: notification_message: "La luce scala è stata attivata" - conditions: - condition: state entity_id: sensor.video_intercom_tx state: '*8*19*20##' sequence: - service: script.notifica_voce_evento data: notification_message: "Il cancelletto è stato aperto" - service: script.notifica_testo_evento data: notification_message: "Il cancelletto è stato aperto" default: [] mode: single
-
-
Example one:
#!/usr/bin/expect -f spawn ssh <intercom_ip> expect "assword:" send "pwned123\r" expect "root@C3X-00-03-50-xx-xx-xx-yyyyyyy:~#" send "echo *8*19*20## |nc 0 30006\r" send "sleep 1\r" send "echo *8*20*20##|nc 0 30006\r" send "exit\r" interact
-
Example two:
#!/bin/bash sshpass -p pwned123 ssh -o StrictHostKeyChecking=no <intercom_ip> "echo *8*19*20## |nc 0 30006; sleep 1; echo *8*20*20##|nc 0 30006"
-
Example 3 (direct test):
ssh <intercom_ip> 'echo *8*19*20## | nc 0 30006; sleep 1; echo *8*20*20## | nc 0 30006'
Depending on your configuration, you may need to create a script to write commands in HA.
In next example are both. You can use only one (you don't need both if one it's running ok).
-
Add your script in
shell_componentsfolder -
Configure in HA:
shell_command: openbuildingdoor: "/home/homeassistant/.homeassistant/shell_commands/openbuildingdoor.sh" openbuildingdoor2: "ssh bticino 'echo *8*19*20## |nc 0 30006; sleep 1; echo *8*20*20##|nc 0 30006'"
-
In your
ui-lovelace.yaml:cards: - type: button name: Open building door CMD1 show_state: false show_name: true show_icon: true tap_action: action: call-service service: shell_command.openbuildingdoor - type: button name: Open building door CMD2 show_state: false show_name: true show_icon: true tap_action: action: call-service service: shell_command.openbuildingdoor2
| Command | Description |
|---|---|
| *8*19*20## | main door opening button pressed |
| *8*20*20## | main door opening button released |
| *8*19*21## | secondary door opening button pressed |
| *8*20*21## | secondary door opening button released |
| *8*21*10## | stairs light activated |
| *8*1#5#4#20*10## | intercom camera on |
| *8*3#5#4*420## | intercom camera off |
| *8*1#1#4#21*10## | incoming external call |
| *7*59#12#0#0*## | incoming internal call |
You can discover new command in the following ways
-
Via MQTT sniffing: use any MQTT listening app / HA integrated MQTT topic listener
-
Via TCP sniffing:
- Go to your home:
cd ~ - On your Linux computer type:
ssh root2@192.168.1.97 '/usr/sbin/tcpdump -i lo -U -w - "not port 22"' > recordingsFILE - Use the App on your mobile and open the door or whatever you want to "learn"
- Stop data recording with CTRL+C
- Open recordingsFILE:
wireshark ~/recordingsFILE
- Go to your home: