diff --git a/README.md b/README.md index bd53203..9eddf0e 100644 --- a/README.md +++ b/README.md @@ -11,33 +11,6 @@ your the mqtt control map for the given CONFIG everytime something changes. for the given config. 4. run `yarn build CONFIG` to generate all files for production use. -## Config +## Documentation -See `config/`. - -The Config format consists out of two sections. Topics and Controls. - -### Topics - -The topics section defines the mqtt interfaces. - -### Controls - -The Controls define the UI Controls. - -| Name | Type | Optional? | Default | Description | -|-----------------|-------------------|------------|-----------------|-------------| -| type | "toggle" \| "dropDown" \| "slider" | No | | The type of the UI element. | -| text | string | No | | The text displayed right next to the UI element. | -| topic | string | No | | The topic the UI element is supposed to change and/or receive its status from. | -| enableCondition | (key: string, value: *) => boolean | Yes | () => true | This option allows you to enable or disable UI elements, depending on the current state. The first parameter is the internal representation of the value. For example "off". The second parameter is the actual value that was received via MQTT. Return true to enable the element and false to disable it. | -| **Toggle Options** | -| on | string | Yes | "on" | If the state is equal to the value of this option the toggle will be toggled on (if the toggled function is not overriden). This is also the value that will be sent when the button is toggled on. | -| off | string | Yes | "off" | If the state is equal to the value of this option the toggle will be toggled off (if the toggled function is not overriden). This is also the value that will be sent when the button is toggled off. | -| toggled | (key: string, value: *) => boolean | Yes | Use the on and off options | This is the function that decides whether the button should be in a toggled state or not. The parameters are equivalent to those of `enableCondition`. Return true to set the button to a toggled state. Return false to set it to the untoggled state. | -| **DropDown Options** | -| options | Map| Yes | {} | This is an attribute set that will map all values defined in the topics section to a description text. For example `{ on: "Lights On", off: "Lights Off" }` will give the drop down element two options, one that is named `Lights On` and one that is named `Lights Off`. | -| **Slider Options** | -| min | number | Yes | 0 | The minimum value of that slider. | -| max | number | Yes | 1 | The maximum value of that slider. | -| step | number | Yes | 1 | The smallest step of the slider. | +The documentation can be found in our [mqtt-control-map wiki](https://github.com/uwap/mqtt-control-map/wiki).