diff --git a/source/_integrations/systemnexa2.markdown b/source/_integrations/systemnexa2.markdown new file mode 100644 index 000000000000..6125c3c66e97 --- /dev/null +++ b/source/_integrations/systemnexa2.markdown @@ -0,0 +1,190 @@ +--- +title: System Nexa 2 +description: How to integrate System Nexa 2 devices within Home Assistant. +ha_category: + - Light + - Switch +ha_config_flow: true +ha_platforms: + - light + - switch +ha_release: 2026.1 +ha_iot_class: Local Push +ha_codeowners: + - '@konsulten' +ha_domain: nexa +ha_dhcp: true +ha_zeroconf: true +ha_quality_scale: bronze +integration_type: device +--- + +The **System Nexa 2** {% term integration %} allows you to integrate with the **System Nexa 2** devices from [Nexa](https://nexa.se/smarta-hem/system-nexa-2). + +## Use cases + +The System Nexa 2 integration brings your lights, switches, and smart plugs into Home Assistant, enabling you to create a truly smart home. Here are some ways you can benefit from this integration: + +- Automate your lighting and appliances + - Create automations to turn lights on at sunset, turn off devices when you leave home, or control your car heater based on outdoor temperature and your calendar to ensure a warm car before your morning commute. +- Enhance privacy and security + - Disable cloud access to keep all communication local, ensuring your devices work without internet connectivity. +- Reduce light pollution + - Turn off indicator LEDs on devices in your bedroom at night to create a better sleeping environment. +- Child-proof your smart home + - Disable physical buttons on specific devices to prevent children from turning critical equipment on or off. +- Integrate with existing remotes + - Enable 433 MHz communication to continue using your existing remote controls alongside Home Assistant automation. + +## Supported devices + +The following devices are known to be supported by the integration: + +- WBD-01 In-Wall Dimmer +- WBR-01 In-Wall Switch/Relay +- WPO-01 Outdoor Smart Plug +- WPR-01 Indoor Smart Plug +- WPD-01 Indoor Dimmer Plug + +## Prerequisites + +1. Open the app store and install the **Nexa Hem** app. +2. Create an account. +3. Add the device by onboarding it to your Wi-Fi, making sure it's on a network reachable from Home Assistant. + +{% include integrations/config_flow.md %} + +{% configuration_basic %} +Host: + description: "The IP Address/hostname of your device. You can find it in your **Nexa Hem** app by selecting your device > **Network** > **IP**." +{% endconfiguration_basic %} + +## Supported functionality + +### Switches + +- **Relay** + - **Description**: Turn on or off switch relay + - **Available for devices**: WBR-01, WPO-01, WPR-01 +- **433Mhz** + - **Description**: Controls whether device should use 433Mhz communication + - **Available for devices**: all +- **Cloud Access** + - **Description**: Controls whether to allow cloud access for device + - **Available for devices**: all +- **Physical Button** + - **Description**: Controls whether the onboard button should have any effect on the device + - **Available for devices**: all +- **LED** + - **Description**: Controls whether the onboard LED should be lit at any time + - **Available for devices**: all + +## Known limitations + +Currently this integration does not support the following functionality: + +- Dimming (state, lowest/highest level, dimming method and more) +- Device local scheduling/timers (can however be done via Home Assistant) +- Adding remote control transmitters to control devices +- Setting mode after power loss +- Updating Wi-Fi settings +- Firmware upgrade +- Local authentication + +## Data updates + +**System Nexa 2** devices push data directly to Home Assistant, enabling immediate updates for device state changes such as relay state and settings (433MHz, cloud access, physical button, and LED). + +## Examples + +### Turn off LEDs at night + +Automatically turn off device indicator LEDs during nighttime to reduce light pollution in bedrooms. + +```yaml +automation: + - alias: "Turn off bedroom device LEDs at night" + triggers: + - trigger: time + at: "22:00:00" + actions: + - action: switch.turn_off + target: + entity_id: + - switch.bedroom_switch_led + - switch.bedroom_dimmer_led + + - alias: "Turn on bedroom device LEDs in morning" + triggers: + - trigger: time + at: "07:00:00" + actions: + - action: switch.turn_on + target: + entity_id: + - switch.bedroom_switch_led + - switch.bedroom_dimmer_led +``` + +### Car heater automation based on temperature + +Start the car heater automatically before your morning commute when outdoor temperature is low. + +```yaml +automation: + - alias: "Preheat car on cold mornings" + triggers: + - trigger: time + at: "06:30:00" + conditions: + - condition: numeric_state + entity_id: sensor.outdoor_temperature + below: 5 + - condition: time + weekday: + - mon + - tue + - wed + - thu + - fri + actions: + - action: switch.turn_on + target: + entity_id: switch.garage_car_heater + - delay: + minutes: 30 + - action: switch.turn_off + target: + entity_id: switch.garage_car_heater +``` + +## Troubleshooting + +### Cannot add device + +#### Symptom: Device is not discovered + +When trying to set up the integration, the device is not automatically discovered. + +##### Description + +The device may not be discoverable due to network issues or because automatic discovery is not working properly on your network. + +##### Resolution + +To resolve this issue, try the following steps: + +1. Open the **Nexa Hem** app and verify that your device is connected and working properly. +2. If the device appears in the app: + - Open the device details in the **Nexa Hem** app. + - Go to **Network** > **IP** to find the IP address of your device. +3. In Home Assistant, manually add the integration: + - Go to {% my integrations title="**Settings** > **Devices & services**" %}. + - Select **Add integration** and search for **System Nexa 2**. + - Enter the IP address you found in the **Nexa Hem** app. + +## Removing the integration + +This integration follows standard integration removal. No extra steps are required. + +{% include integrations/remove_device_service.md %}