All projects

Hereworks · now

Smart buildings at Hereworks

I lead the data engineering team and I’m the cybersecurity lead. The work is building data from end to end: from the devices in a building to the cloud.

  • Data engineering lead
  • Cybersecurity lead

Device to cloud

  1. 01

    Design

    Building systems

    • HVAC / BMS
    • Energy metering
    • Lighting
    • Occupancy / IAQ
  2. 02

    Connect

    Protocols

    • BACnet
    • Modbus
    • MQTT
    • REST / HTTP APIs
  3. 03

    Normalise

    One model

    • DBO point names
    • Units
    • Equipment
  4. 04

    Validate

    Checked data

    • Complete
    • In range
    • On time
  5. 05

    Deliver

    Cloud

    • UDMI
    • Stored
    • Ready to use

Cybersecurity at every stage: devices, networks, cloud and access

Many names in, one name out

From the site

AHU1_SAT SupplyAirTemp sa-t (°F)

In the model · DBO

supply_air_temperature_sensor degrees_celsiusAHU-1

Then checked

  • Every expected point is there
  • Units and values make sense
  • It keeps reporting
  • It matches the design

One air handler in UDMI

Site model

  • SiteZZ-ABC-DEMO
    • GatewayCGW-1 · BACnet
      • DeviceAHU-1 · air handlerHVAC/AHU_CHWSC_HWSC_SFSS_SFVSC_SSPC
        • supply_air_temperature_sensorAI1degrees_celsius
        • supply_air_temperature_setpointAV2degrees_celsiuswritable
        • supply_air_static_pressure_sensorAI3pascals
        • supply_air_static_pressure_setpointAV4pascals
        • supply_fan_run_commandBO5ON / OFF
        • supply_fan_run_statusBI6ON / OFF
        • supply_fan_speed_percentage_commandAO7percent
        • chilled_water_valve_percentage_commandAO8percent
        • heating_water_valve_percentage_commandAO9percent

Messages

  1. config what the cloud wants
  2. state what the device has applied
  3. events/pointset what it measured
metadata.jsonUDMI site model
{
  "version": "1.5.2",
  "timestamp": "2026-11-22T09:00:00Z",
  "system": {
    "location": { "site": "ZZ-ABC-DEMO", "section": "PLANT-ROOM" },
    "physical_tag": {
      "asset": { "guid": "uuid://5f1c2a0e-7d3b-4c6e-9a21-0b8e4d7c3f10", "site": "ZZ-ABC-DEMO", "name": "AHU-1" }
    }
  },
  "gateway": {
    "gateway_id": "CGW-1"
  },
  "localnet": {
    "families": {
      "bacnet": { "addr": "2001" }
    }
  },
  "pointset": {
    "points": {
      "supply_air_temperature_sensor": { "units": "Degrees-Celsius", "ref": "AI1" },
      "supply_air_temperature_setpoint": { "units": "Degrees-Celsius", "ref": "AV2", "writable": true },
      "supply_air_static_pressure_sensor": { "units": "Pascals", "ref": "AI3" },
      "supply_air_static_pressure_setpoint": { "units": "Pascals", "ref": "AV4" },
      "supply_fan_run_command": { "ref": "BO5" },
      "supply_fan_run_status": { "ref": "BI6" },
      "supply_fan_speed_percentage_command": { "units": "Percent", "ref": "AO7" },
      "chilled_water_valve_percentage_command": { "units": "Percent", "ref": "AO8" },
      "heating_water_valve_percentage_command": { "units": "Percent", "ref": "AO9" }
    }
  }
}

What AHU-1 is, where it sits, which gateway reaches it, and the BACnet object behind each DBO point.

building_config.yamlDBO
CONFIG_METADATA:
  operation: INITIALIZE

5f1c2a0e-7d3b-4c6e-9a21-0b8e4d7c3f10:
  code: AHU-1
  type: HVAC/AHU_CHWSC_HWSC_SFSS_SFVSC_SSPC
  cloud_device_id: "2582332477650079"
  translation:
    supply_air_temperature_sensor:
      present_value: "points.supply_air_temperature_sensor.present_value"
      units:
        key: "pointset.points.supply_air_temperature_sensor.units"
        values:
          degrees_celsius: "Degrees-Celsius"
    supply_air_temperature_setpoint:
      present_value: "points.supply_air_temperature_setpoint.present_value"
      units:
        key: "pointset.points.supply_air_temperature_setpoint.units"
        values:
          degrees_celsius: "Degrees-Celsius"
    supply_air_static_pressure_sensor:
      present_value: "points.supply_air_static_pressure_sensor.present_value"
      units:
        key: "pointset.points.supply_air_static_pressure_sensor.units"
        values:
          pascals: "Pascals"
    supply_air_static_pressure_setpoint:
      present_value: "points.supply_air_static_pressure_setpoint.present_value"
      units:
        key: "pointset.points.supply_air_static_pressure_setpoint.units"
        values:
          pascals: "Pascals"
    supply_fan_run_command:
      present_value: "points.supply_fan_run_command.present_value"
      states:
        ON: "active"
        OFF: "inactive"
    supply_fan_run_status:
      present_value: "points.supply_fan_run_status.present_value"
      states:
        ON: "active"
        OFF: "inactive"
    supply_fan_speed_percentage_command:
      present_value: "points.supply_fan_speed_percentage_command.present_value"
      units:
        key: "pointset.points.supply_fan_speed_percentage_command.units"
        values:
          percent: "Percent"
    chilled_water_valve_percentage_command:
      present_value: "points.chilled_water_valve_percentage_command.present_value"
      units:
        key: "pointset.points.chilled_water_valve_percentage_command.units"
        values:
          percent: "Percent"
    heating_water_valve_percentage_command:
      present_value: "points.heating_water_valve_percentage_command.present_value"
      units:
        key: "pointset.points.heating_water_valve_percentage_command.units"
        values:
          percent: "Percent"

AHU-1 as a canonical DBO type. Each field maps to its UDMI point, raw units to DBO units, and active / inactive to ON / OFF.

events/pointsetdevice → cloud
{
  "version": "1.5.2",
  "timestamp": "2026-11-22T09:30:00Z",
  "points": {
    "supply_air_temperature_sensor": { "present_value": 18.4 },
    "supply_air_temperature_setpoint": { "present_value": 18.0 },
    "supply_air_static_pressure_sensor": { "present_value": 248.6 },
    "supply_air_static_pressure_setpoint": { "present_value": 250.0 },
    "supply_fan_run_command": { "present_value": "active" },
    "supply_fan_run_status": { "present_value": "active" },
    "supply_fan_speed_percentage_command": { "present_value": 62.0 },
    "chilled_water_valve_percentage_command": { "present_value": 35.0 },
    "heating_water_valve_percentage_command": { "present_value": 0.0 }
  }
}

The readings, keyed by DBO name.

configcloud → device
{
  "version": "1.5.2",
  "timestamp": "2026-11-22T09:31:00Z",
  "pointset": {
    "points": {
      "supply_air_temperature_setpoint": { "set_value": 19.0 }
    }
  }
}

A request to change the setpoint.

statedevice → cloud
{
  "version": "1.5.2",
  "timestamp": "2026-11-22T09:31:02Z",
  "system": {
    "serial_no": "EX-00042",
    "last_config": "2026-11-22T09:31:00Z",
    "hardware": { "make": "Example", "model": "AHU controller" },
    "software": { "firmware": "4.2.1" },
    "operation": { "operational": true }
  },
  "pointset": {
    "points": {
      "supply_air_temperature_setpoint": { "value_state": "applied" }
    }
  }
}

The device says the change was applied.

Made-up names and IDs. The UDMI messages validate against the UDMI 1.5.2 schemas, the point names, units and states come from DBO, and the device and gateway names follow BDNS. Nothing on this page comes from a client site or from Hereworks systems.

The same path, at home

My smart home IoT project follows the same path on a smaller scale: homemade sensors, AWS IoT Core and a room-by-room dashboard.