Home Assistant All pages

Home Assistant

Your station shows up in Home Assistant as a device with wind, rain, temperature and pressure entities, and notices you can trigger automations on.

What you need

  • An MQTT broker on your home network. MQTT is a small message system that Home Assistant uses; the broker is the server that passes its messages. In Home Assistant, the Mosquitto broker add-on does the job; any other MQTT broker works too.
  • Home Assistant's MQTT integration, set up to use that broker.
  • Home Assistant 2025.10 or later. Older versions are not tested.
Note

MQTT is optional. Without it the dashboard works as usual and nothing is published.

Connect the broker

  1. Open Settings (http://fauxcloud.local/admin) and sign in.

  2. Under Home Assistant and online services, open the MQTT tile.

  3. Fill in Broker address (for example 192.168.1.10 or homeassistant.local, without http://), Port (usually 1883), User name and Password. Use a Home Assistant user, or the user you made for the broker.

  4. Press Test connection, then save.

    You should see "Connected. Save to keep these settings." After saving, the tile says Connected.

The station appears in Home Assistant after its first upload. If nothing shows up, check Troubleshooting.

No encryption to the broker

fauxcloud sends to your broker without encryption, with your user name and password. Keep the broker on your home network. fauxcloud only publishes; it subscribes to nothing, so Home Assistant cannot send it commands.

What appears

Home Assistant finds everything by itself (this is called MQTT discovery). fauxcloud uses the default discovery prefix, homeassistant. You get two kinds of device:

  • One device per station. A station is fauxcloud's record of one console (your weather station's display unit). The device is named after the station (by default fauxcloud <station id>) and holds the measurement entities below.
  • One bridge device, fauxcloud bridge <XXXX>, with the board's own state.

Values are published as plain text under fauxcloud/<XXXX>/<station id>/<entity key>. XXXX is the last four characters of the board's hardware (MAC) address, as in the Wi-Fi name fauxcloud-XXXX.

fauxcloud does not ask the broker to keep measurements (they are not retained). This is on purpose: a reading that fauxcloud rejected is simply not updated, and old values cannot outlive a broker restart.

Station entities

Pressure, wind speed and wind gust are as the console reports them.

EntityUnitWhat it is
Temperature°COutdoor air temperature
Dew point°COutdoor dew point
Humidity%Outdoor relative humidity
PressurehPaAir pressure. It follows REL, the console's relative pressure setting (set to sea-level pressure)
Wind speedkm/hWind speed
Wind gustkm/hGust
Wind direction°Direction the wind comes from
Rain (last hour)mmRain over the last 60 minutes, worked out by fauxcloud
Rain todaymmRain since midnight
UV indexnoneUV index
Solar radiationW/m²Solar radiation
Wind speed, 2-min averagekm/hMean wind over the last 2 minutes, worked out by fauxcloud
Wind direction, 2-min average°Mean direction over the last 2 minutes
Wind gust, 10 minkm/hStrongest gust of the last 10 minutes
Wind speed, 10-min averagekm/hMean wind over the last 10 minutes
Last seentimeWhen the last reading arrived
Outdoor sensor linkon / offOn means the outdoor sensor is not updating
Battery lowon / offOn means the console reports a low battery
NoticestextWhat needs a look, in plain words
Local outlooktextThe Local outlook sentences

The wind averages and the 10-minute gust are what you want for an awning rule that should ignore single spikes. The 2-minute average direction skips readings under 1 km/h.

  • Some entities appear only when the console has sent the value.
  • Entities for other values the console may send are added the same way: indoor temperature and humidity, wind chill, heat index, absolute pressure, rain this week, month and year, rain rate, gust direction, visibility.
  • Entities you hide in a station's settings are removed from Home Assistant. They come back when you un-hide them.
  • A station's Diagnostic group also holds seven counters named Rejected .... They count readings that the filters dropped.

fauxcloud suggests entity IDs made from the station ID and the entity key, for example sensor.fauxcloud_st1_temp_c and binary_sensor.fauxcloud_st1_sensor_stale. Home Assistant uses the suggestion only when it first creates the entity.

Bridge entities

All of these are in the diagnostic group of the bridge device.

EntityWhat it is
IP addressThe board's address on your home network
Wi-Fi signalSignal strength in dBm
AP clientsHow many devices are on the fauxcloud Wi-Fi
Free heapFree memory in bytes
Last restartWhen the board last started
Last reset reasonWhy it last restarted
RestartsHow many times it has restarted
FirmwareThe firmware version
Time sourceWhere the board's clock comes from
NoticesNotices about the board itself

Unavailable stations

A station shows as unavailable when it stops uploading. The default is 4 minutes without an upload. To change it, open the station in Settings and pick a time under Show as offline after: 2, 4, 10 or 30 minutes. The console uploads about once a minute.

If fauxcloud stops, loses power or drops off the network, the broker marks the whole bridge offline and every entity becomes unavailable with it.

Three more settings sit in the Publishing tile and in each station's settings:

  • Send to Home Assistant (per station): switch it off to keep a station on the dashboard only.
  • Send new stations to Home Assistant automatically: switch it off to keep new stations on the dashboard until you turn them on one by one.
  • "Last seen" update in Home Assistant: how often the last-seen time moves while a station is quiet (every minute, 5 minutes or 15 minutes). Readings are always sent as they arrive.

Notices

The Notices entity says what needs a look: for example "Outdoor sensor not updating since 03:40." When all is well it says OK. Its attributes carry a list called items with one entry per notice.

Trigger automations on the notice id, never on its text. The ids stay the same; the wording can change between versions.

Notice idWhereWhat it means
sensor_stalestationThe outdoor sensor has not updated for a while. A calm night can do this; a long gap means its battery or radio
sensor_absentstationThe outdoor sensor is missing: check its batteries
baro_uncalibratedstationThe console's pressure is at its factory value; set REL in its SET menu
key_mismatchstationAn upload arrived with another key for this station. Accept it in Settings if you re-paired the console
console_clockstationThe console's clock is off by more than 10 minutes
profile_changedstationThe station's Console model setting changed (shown for 24 hours)
baro_refstationThe pressure reads noticeably above or below nearby airports; see Airport weather
baro_checkstationThe pressure has been off from the usual for this place for days
time_approximatebridgeThe time is estimated since the last restart
time_nonebridgefauxcloud is still waiting for the real time
heap_lowbridgeMemory is low; readings still arrive
store_failbridgeHistory could not be saved; readings still arrive
heap_frag_restartbridgefauxcloud restarted itself to free memory (shown for 24 hours)
store_layoutbridgeThe board's storage needs one USB flash before history can be saved
clock_behindbridgeThe clock is behind the saved history, so history is paused until the time is confirmed

Each item has id, and where it applies since (when it began, in UTC), n (a count) or skew_s (the clock difference in seconds).

Example automations

Both examples use a station with the ID st1. Replace it with yours.

Close the awning when the 10-minute average wind is strong
automation:
  - alias: Awning in
    trigger:
      - trigger: numeric_state
        entity_id: sensor.fauxcloud_st1_wind_avg10m_kmh
        above: 35
    action:
      - action: cover.close_cover
        target:
          entity_id: cover.awning
An automation that triggers on a notice id
automation:
  - alias: Outdoor sensor needs a look
    trigger:
      - trigger: template
        value_template: >
          {{ state_attr('sensor.fauxcloud_st1_notices', 'items')
             | selectattr('id', 'eq', 'sensor_stale') | list | count > 0 }}
    action:
      - action: notify.notify
        data:
          message: The outdoor sensor has stopped updating. Check its batteries.
Note

cover.awning and notify.notify are placeholders for your own devices.

Limits

  • Verified on one console (the YT60234). Another console model can send other values; see Compatibility.
  • The Weather Underground forecast line is not published to Home Assistant.
  • MQTT goes without encryption to a broker you run; see Security for what that means.