> For the complete documentation index, see [llms.txt](https://documentation.nomos-system.com/nomos-system/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.nomos-system.com/nomos-system/integrator-en/devices/general.md).

# General

The **"General"** tab shows the master data of the device and provides the most important management functions.

## Device header

The top section shows the device icon and name:

* **Icon** – Click the icon to change it. A selection window opens with all available symbols. Choose a symbol that best represents the device. For some devices (e.g. OpenWeather) the icon is fixed and cannot be changed.
* **Name** – Click the name to edit it. The name is used in all lists, in the app, and in automations.
* **Last updated / Created** – Shows when the device last changed a value and when it was created.

## Device information

Depending on the device type, the following fields are shown:

* **Zone** – Shows the zone (floor) the device belongs to via its room.
* **Room** – Use the selection list to assign the device to a different room. Rooms are grouped by zones. Devices without a room end up in the **Default Room**.
* **Controller** – In management setups, shows which controller the device is registered on.
* **Platform** – The underlying skill platform (e.g. KNX, ZigBee, Z-Wave, Matter, MQTT).
* **Category / Type** – The device category (Lighting, Thermostats, …) and the specific type. For some devices (e.g. Switch ↔ Lightbulb) you can change the type via the selection list.
* **Direction** – Only for window coverings: defines whether the cover works horizontally or vertically.
* **Manufacturer / Model / Serial number / Version / Firmware** – Hardware information, if provided by the skill.
* **Link Quality** – For wireless devices (ZigBee, Z-Wave), the current connection quality in percent.
* **Battery** – For battery-powered devices, the current charge level.
* **Status** – Shows **OK**, **"Device is not reachable"**, or **"Poor connection"**. For unreachable devices, the time of the last successful communication is also shown.
* **Compatibility / Certified by nomos system** – Shown for devices from the online library.

## Actions

The buttons at the bottom of the information section:

* **Open in nomos system App** – Opens the device directly in the embedded app view.
* **Log** – Jumps to the system log and filters by this device.
* **Help / Support** – Opens (if available) the manufacturer- or skill-specific help page.
* **Edit / Configuration** – For KNX, Z-Wave, ZigBee, and Wiser devices: opens the skill-specific configuration page.
* **Delete Device** – Removes the device from the system. Existing dependencies (automations, scenes) are shown beforehand.

## Configuration (Addons only)

If the device was added via an **Addon skill**, a block with addon-specific parameters appears here (e.g. Server IP, Port, Username, Password, Active, Debug). Apply changes with **"Save"**.

## Webhooks (only for supported devices)

Some devices can be updated by external systems via HTTP request. This section shows the webhook URLs (HTTP and HTTPS) that can be entered into the external system. The supported properties are listed below. The clipboard icon copies the URLs.

## Settings

Depending on device type, additional options can be enabled here:

* **Device enabled in central functions** – Only for Lighting, Window Coverings, Thermostats, and Music Players. Determines whether the device responds to central functions.
* **Share with Management** – If the system is part of a management setup, the device can be passed to the management.

## Associations

Shows all objects in the system that use this device:

* **Devices** – Other devices linked to this one.
* **Quick Config** – Quick configs that use this device as trigger or action.
* **Automations** – Automation rules that use this device.
* **Scenes** – Scenes the device appears in.
* **Schedules** – Schedules that control this device.
* **Cameras** – Cameras linked to this device.

The links navigate directly to the respective object. Check this list before deleting a device to avoid accidentally breaking automations or scenes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.nomos-system.com/nomos-system/integrator-en/devices/general.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
