BACnet (Building Automation and Control Networks, norma ASHRAE 135 e ISO 16484-5) es el protocolo que usan los sistemas de gestión de edificios para leer y mandar equipos de climatización, iluminación y energía. En un Raspberry PLC se usa BACnet/IP con BAC0, una librería de Python basada en BACpypes3: instálala en un entorno virtual, abre la conexión con async with BAC0.start(ip="IP/máscara"), busca equipos con who_is(), lee con read() y manda valores con una escritura a una prioridad. El PLC también puede publicar sus propios valores como objetos BACnet, para que el sistema de gestión del edificio lo lea como a cualquier otro controlador.
Esta guía explica los conceptos de BACnet que necesitas, cómo instalar la versión actual de BAC0 en un Raspberry PLC y dos scripts: un cliente que lee y escribe otro equipo BACnet, y un servidor que convierte el Raspberry PLC en un equipo BACnet. Los dos scripts se probaron el 27/10/2026 con BAC0 2026.7.25 y BACpypes3 0.0.110, entre dos instancias de BAC0 en un PC con Linux.
- Paso 1RedPLC y equipos BACnet en la misma subred IP, UDP 47808
- Paso 2Instalar BAC0Python 3.10 o posterior, en un entorno virtual
- Paso 3Leer y escribirwho_is(), read(), readMultiple() y escritura a una prioridad
- Paso 4Servir objetosEl PLC como equipo BACnet para el BMS
BACnet en cinco conceptos
Todos los equipos BACnet se ven igual, sea cual sea el fabricante. Un sistema de gestión de edificios (BMS) no lee registros, como en Modbus: lee objetos con nombre y propiedades con tipo.
| Concepto | Qué es | Ejemplo |
|---|---|---|
| Device | Cada controlador de la red. Tiene una instancia de dispositivo que debe ser única en toda la red BACnet (0 a 4194302) | device 1001 |
| Object | Un punto del equipo, con un tipo y un número de instancia | analogInput 1, analogValue 1, binaryOutput 3 |
| Property | Un campo de datos de un objeto | presentValue, objectName, units, statusFlags |
| Service | La petición que un equipo envía a otro | Who-Is e I-Am para descubrir, ReadProperty, ReadPropertyMultiple, WriteProperty, suscripciones COV |
| Priority array | 16 niveles en los objetos comandables. Gana el valor de la prioridad más alta. Escribir null libera un nivel | La prioridad 8 es la de operador manual. La 16 es la más baja |
BACnet/IP y BACnet MS/TP
BACnet funciona sobre varias redes. Las dos habituales en edificios son BACnet/IP, por Ethernet o Wi-Fi en el puerto UDP 47808, y BACnet MS/TP, por RS-485. BAC0 solo trabaja con BACnet/IP. Para llegar a equipos MS/TP desde un Raspberry PLC, pon un router BACnet entre la red IP y el bus MS/TP: el PLC los lee entonces con una dirección como 2:5 (red 2, dirección MAC 5).
Qué necesitas
- Un Raspberry PLC conectado por Ethernet a la red del edificio, o directamente al PC para una prueba.
- Otro equipo BACnet/IP para leer: un controlador, un segundo Raspberry PLC con el script servidor de abajo o un explorador BACnet en tu PC.
- Todos en la misma subred IP, con el puerto UDP 47808 abierto. Who-Is es un broadcast, y los broadcasts no cruzan los routers IP.
- Python 3.10 o posterior en el PLC. Compruébalo con
python3 --version.
Instalar BAC0 en el Raspberry PLC
Las versiones recientes de Raspberry Pi OS no dejan que pip instale paquetes en el Python del sistema, así que crea un entorno virtual e instala BAC0 dentro. pip instala BACpypes3 con él.
python3 -m venv ~/bacnet
~/bacnet/bin/pip install BAC0
~/bacnet/bin/python -c "import BAC0; print(BAC0.version)"
Ejecuta tus scripts con el Python del entorno: ~/bacnet/bin/python bacnet_client.py. Busca la dirección IP y la máscara del PLC con ip a: para 192.168.1.20 con máscara 255.255.255.0, escribe 192.168.1.20/24.
BAC0 cambió en 2024. Desde las versiones de 2024, BAC0 es asíncrona y se basa en BACpypes3. Los scripts escritos para versiones anteriores, como bacnet = BAC0.lite(ip=...) seguido de bacnet.whois() sin await, no funcionan con la versión actual. Los ejemplos de esta página usan la sintaxis actual. BAC0.start(), BAC0.lite() y BAC0.connect() son la misma función.
Ejemplo 1: leer y escribir un equipo BACnet
El script descubre los equipos de la red, lee una propiedad, lee tres propiedades en una sola petición y manda un valor binario durante 5 segundos. Cambia PLC_IP y DEVICE según tu red.
import asyncio
import BAC0
PLC_IP = "192.168.1.20/24" # IP address and mask of this Raspberry PLC
DEVICE = "192.168.1.50" # IP address of the BACnet device to read
async def main():
async with BAC0.start(ip=PLC_IP, deviceId=1002) as bacnet:
# 1. Find the BACnet devices on the network (Who-Is / I-Am)
devices = await bacnet.who_is()
for iam in devices:
print("Found", iam.iAmDeviceIdentifier, "at", iam.pduSource)
# 2. Read one property (ReadProperty)
value = await bacnet.read(f"{DEVICE} analogValue 1 presentValue")
print("AV1 presentValue:", value)
# 3. Read several properties in one request (ReadPropertyMultiple)
print(await bacnet.readMultiple(
f"{DEVICE} analogValue 1 objectName presentValue units"))
# 4. Command a value at priority 8, then release it (WriteProperty)
await bacnet._write(f"{DEVICE} binaryValue 1 presentValue active - 8")
await asyncio.sleep(5)
await bacnet._write(f"{DEVICE} binaryValue 1 presentValue null - 8")
asyncio.run(main())
Cómo funciona:
BAC0.start()abre BACnet/IP en el puerto 47808 de la dirección IP que le das.deviceIdes la instancia de dispositivo del PLC: elige una que no use ningún otro equipo.who_is()envía un Who-Is por broadcast y devuelve las respuestas I-Am. Pásale una dirección,who_is(address="192.168.1.50"), para preguntar a un solo equipo.read()recibe un texto con la dirección, el tipo de objeto, la instancia y la propiedad. La dirección puede ser una IP, una IP con puerto, ored:MACpara un equipo detrás de un router BACnet.readMultiple()lee varias propiedades de un objeto en una sola petición ReadPropertyMultiple: menos tráfico cuando sondeas muchos puntos.- El texto de escritura acaba en
- 8: el valor va a la prioridad 8 del priority array. Escribirnullen la misma prioridad la libera, y el objeto vuelve al valor de la siguiente prioridad o a su valor por defecto (relinquish default).
En la versión actual de BAC0, la escritura que puedes esperar con await es _write(). write() lanza la misma escritura como tarea en segundo plano y no devuelve el resultado.
BACnet envía los valores analógicos como REAL, un número de coma flotante de 32 bits. Un valor de 22,7 puede llegar como 22.700000762939453: redondéalo antes de mostrarlo o guardarlo.
Qué prioridad escribir
| Prioridad | Uso en la norma |
|---|---|
| 1 | Seguridad de personas, manual |
| 2 | Seguridad de personas, automática |
| 5 | Control de equipos críticos |
| 6 | Tiempos mínimos de marcha y paro |
| 8 | Operador manual |
| 3, 4, 7 y 9 a 16 | Libres para la aplicación. La 16 es la más baja |
Acuerda la prioridad con el integrador del edificio. Un valor escrito a una prioridad alta y nunca liberado mantiene el equipo en ese estado, mande lo que mande el BMS a una prioridad más baja.
Ejemplo 2: el Raspberry PLC como equipo BACnet
Un BMS a menudo necesita leer valores que el PLC mide o calcula. Con BAC0, el PLC puede servir sus propios objetos: aquí un valor analógico con la temperatura de una sala y un valor binario comandable que el BMS escribe para arrancar un ventilador.
import asyncio
import random
import BAC0
from BAC0.core.devices.local.factory import analog_value, binary_value
PLC_IP = "192.168.1.20/24" # IP address and mask of this Raspberry PLC
def read_temperature():
# Replace with the reading of your sensor (analog input, Modbus...)
return round(random.uniform(20.0, 24.0), 1)
def set_fan(on):
# Replace with the code that switches your output
print("Fan", "ON" if on else "OFF")
async def main():
async with BAC0.start(ip=PLC_IP, deviceId=1001,
localObjName="RaspberryPLC-1") as bacnet:
analog_value(instance=1, name="Room_Temperature", presentValue=21.5,
properties={"units": "degreesCelsius"},
description="Room temperature")
objects = binary_value(instance=1, name="Fan_Command",
presentValue=False, is_commandable=True)
objects.add_objects_to_application(bacnet)
app = bacnet.this_application.app
temperature = app.get_object_name("Room_Temperature")
fan = app.get_object_name("Fan_Command")
while True:
temperature.presentValue = read_temperature()
set_fan(str(fan.presentValue) == "active")
await asyncio.sleep(1)
asyncio.run(main())
Cómo funciona:
analog_value()ybinary_value()definen los objetos, con su nombre, instancia, valor inicial y unidades.is_commandable=Trueda al objeto un priority array, para que otros equipos lo puedan escribir a una prioridad.add_objects_to_application()publica los objetos. El BMS encuentra el PLC con Who-Is como device 1001 y lee su lista de objetos.- El bucle actualiza la temperatura cada segundo y aplica la orden del ventilador a la salida. Sustituye
read_temperature()yset_fan()por la lectura de tu entrada y el control de tu salida.
Diagnóstico
| Qué ves | Causa probable | Qué hacer |
|---|---|---|
InitializationError: IP Address provided ... invalid | Otro programa usa el puerto UDP 47808, o la dirección IP no es del PLC | Para el otro programa BACnet o usa otro puerto con ip="192.168.1.20/24:47809". Comprueba la dirección con ip a |
who_is() devuelve una lista vacía | Los equipos están en otra subred IP, o un cortafuegos bloquea UDP 47808 | Pregunta al equipo por su dirección. Entre subredes, BACnet/IP necesita un BBMD: BAC0 se registra en uno con los parámetros bbmdAddress y bbmdTTL |
NoResponseFromController | El equipo no responde a la lectura | Revisa la dirección, el número de red si hay un router y la instancia del dispositivo |
El log muestra unknown-object, o la lectura lanza UnknownPropertyError | El objeto o la propiedad no existen en ese equipo | Lee primero la lista de objetos del equipo: read("192.168.1.50 device 1234 objectList") |
| La escritura no tiene efecto | Una prioridad más alta retiene el valor, o el objeto no es comandable | Lee la propiedad priorityArray del objeto y pregunta qué nivel usa el BMS |
BACnet o Modbus TCP en un edificio
Muchas unidades de climatización y contadores hablan Modbus, mientras que el BMS del edificio pide BACnet. Hay dos diseños habituales. El PLC sirve un mapa Modbus TCP fijo y una pasarela a su lado traduce el mapa a BACnet, como en el caso de la unidad de tratamiento de aire de abajo. O el propio Raspberry PLC lee los equipos Modbus y publica los valores como objetos BACnet, con el script servidor de esta página. Para Modbus en el Raspberry PLC, consulta la guía de Modbus TCP y RTU para Raspberry PLC.
Llévalo a la práctica
BACnet vive en los edificios. Mira un Raspberry PLC que gestiona la climatización de un centro comercial, un simulador de zonas de un edificio y un controlador de unidad que habla con el BMS.
Caso de éxito
Un PLC para la climatización del centro comercial. Vigilado a distancia.
Un Raspberry PLC controla, registra e informa al SCADA de la unidad de climatización de un centro comercial de 5.000 m².
Lee el caso de éxito
Simulador
Gestiona las zonas de un edificio: personas, luz, clima y alarmas
Un Raspberry PLC 57R gestiona cuatro zonas de una planta de oficinas. Cambia las reglas, abre una ventana y mira la energía, el confort y las alertas.
Abre el simulador
Caso de estudio
Un diseño de controlador. Todas las unidades de la serie.
Un M-Duino 58 controla una unidad de tratamiento de aire y da al BMS un mapa Modbus TCP. Una pasarela añade BACnet cuando el edificio lo pide.
Lee el caso de estudio
Preguntas frecuentes sobre BACnet en el Raspberry PLC
¿Qué puerto usa BACnet/IP?
El puerto UDP 47808 (0xBAC0 en hexadecimal, que da nombre a BAC0). Ábrelo en el cortafuegos del PLC y de la red.
¿Puede el Raspberry PLC hablar BACnet MS/TP por RS-485?
No con BAC0, que solo admite BACnet/IP. Usa un router BACnet entre la red IP y el bus MS/TP, y lee los equipos MS/TP a través de él.
¿Por qué ha dejado de funcionar mi script antiguo de BAC0?
Desde las versiones de 2024, BAC0 es asíncrona. Arráncala con async with BAC0.start(...) dentro de una función async y espera cada llamada con await. El método whois() ahora es who_is().
¿Puede un sistema de gestión de edificios leer el Raspberry PLC?
Sí. Con el script servidor de esta página, el PLC responde a Who-Is y sirve sus objetos. El BMS los lee y escribe los comandables como los de cualquier otro controlador BACnet.
¿BACnet es de uso libre?
Sí. BACnet es una norma abierta de ASHRAE, publicada también como ISO 16484-5. Puedes usarla sin licencia. BAC0 es software libre, con licencia LGPLv3.
Más protocolos en el Raspberry PLC
- Guía de Modbus TCP y RTU para PLC Raspberry Pi con Python y Node-RED
- Modbus RTU, Modbus TCP u OPC UA: cuál usar
- Cómo elegir un controlador industrial
Referencias: documentación de BAC0 y BAC0 en PyPI.