Ir al contenido

BACnet con Raspberry PLC

Lee, escribe y sirve objetos BACnet/IP desde un Raspberry PLC con la BAC0 asíncrona actual
8 de julio de 2024 por
BACnet con Raspberry PLC
Boot & Work Corp. S.L, Martí Schnabel

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.

  1. Paso 1RedPLC y equipos BACnet en la misma subred IP, UDP 47808
  2. Paso 2Instalar BAC0Python 3.10 o posterior, en un entorno virtual
  3. Paso 3Leer y escribirwho_is(), read(), readMultiple() y escritura a una prioridad
  4. 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.

ConceptoQué esEjemplo
DeviceCada controlador de la red. Tiene una instancia de dispositivo que debe ser única en toda la red BACnet (0 a 4194302)device 1001
ObjectUn punto del equipo, con un tipo y un número de instanciaanalogInput 1, analogValue 1, binaryOutput 3
PropertyUn campo de datos de un objetopresentValue, objectName, units, statusFlags
ServiceLa petición que un equipo envía a otroWho-Is e I-Am para descubrir, ReadProperty, ReadPropertyMultiple, WriteProperty, suscripciones COV
Priority array16 niveles en los objetos comandables. Gana el valor de la prioridad más alta. Escribir null libera un nivelLa 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. deviceId es 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, o red:MAC para 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. Escribir null en 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

PrioridadUso en la norma
1Seguridad de personas, manual
2Seguridad de personas, automática
5Control de equipos críticos
6Tiempos mínimos de marcha y paro
8Operador manual
3, 4, 7 y 9 a 16Libres 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() y binary_value() definen los objetos, con su nombre, instancia, valor inicial y unidades. is_commandable=True da 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() y set_fan() por la lectura de tu entrada y el control de tu salida.

Diagnóstico

Qué vesCausa probableQué hacer
InitializationError: IP Address provided ... invalidOtro programa usa el puerto UDP 47808, o la dirección IP no es del PLCPara 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íaLos equipos están en otra subred IP, o un cortafuegos bloquea UDP 47808Pregunta 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
NoResponseFromControllerEl equipo no responde a la lecturaRevisa 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 UnknownPropertyErrorEl objeto o la propiedad no existen en ese equipoLee primero la lista de objetos del equipo: read("192.168.1.50 device 1234 objectList")
La escritura no tiene efectoUna prioridad más alta retiene el valor, o el objeto no es comandableLee 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.

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.

Buscar en nuestro blog

BACnet con Raspberry PLC
Boot & Work Corp. S.L, Martí Schnabel 8 de julio de 2024
Compartir esta publicación
Etiquetas

¿Estás buscando tu Controlador Lógico Programable ideal?

Echa un vistazo a esta comparativa de producto de varios controladores industriales basados en Arduino.

Comparamos entradas, salidas, comunicaciones y otras especificaciones con las de los equipos de otras marcas destacadas.

Comparativa de PLCs