文件列表:

.mvn (0, 2023-08-04)
.mvn\wrapper (0, 2023-08-04)
.mvn\wrapper\maven-wrapper.jar (58727, 2023-08-04)
.mvn\wrapper\maven-wrapper.properties (233, 2023-08-04)
LICENSE (1067, 2023-08-04)
dirigera-client-api (0, 2023-08-04)
dirigera-client-api\.mvn (0, 2023-08-04)
dirigera-client-api\.mvn\wrapper (0, 2023-08-04)
dirigera-client-api\.mvn\wrapper\maven-wrapper.jar (58727, 2023-08-04)
dirigera-client-api\.mvn\wrapper\maven-wrapper.properties (233, 2023-08-04)
dirigera-client-api\mvnw (10284, 2023-08-04)
dirigera-client-api\mvnw.cmd (6734, 2023-08-04)
dirigera-client-api\pom.xml (2079, 2023-08-04)
dirigera-client-api\src (0, 2023-08-04)
dirigera-client-api\src\main (0, 2023-08-04)
dirigera-client-api\src\main\java (0, 2023-08-04)
dirigera-client-api\src\main\java\de (0, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler (0, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot (0, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera (0, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client (0, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api (0, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api\AirPurifierDeviceApi.java (3516, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api\BlindsControllerDeviceApi.java (1147, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api\BlindsDeviceApi.java (1642, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api\ControllerDeviceApi.java (4058, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api\DefaultDeviceApi.java (2792, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api\DeviceApi.java (6157, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api\DeviceSetApi.java (2196, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api\DirigeraApi.java (8173, 2023-08-04)
dirigera-client-api\src\main\java\de\dvdgeisler\iot\dirigera\client\api\EnvironmentSensorDeviceApi.java (1161, 2023-08-04)
... ...

# DIRIGERA Client API

Unofficial client API for IKEA's new Smarthome Hub [DIRIGERA](https://github.com/wjtje/DIRIGERA). The client API uses DIRIGERA's REST interface at port 8443. The vast majority of interfaces have been implemented. However, most are barely tested, and some are known as inoperable. ## What is known to work * Pair API with DIRIGERA * Dump DIRIGERA's data model * Fetch and edit devices * (Un-)Link devices (e.g., light controller with light bulb) * List and play music playlists and favorites * Create, manipulate, and delete rooms, device-sets, and scenes * Manipulate, and delete users ### Supported devices | Device Type | API | Home-Assistant Integration | Tested Devices | |---------------------|-----------------------------------------------|-----------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Gateway | **✓** | **X** |

• DIRIGERA Hub for smart products

| | Repeater | **✓** | **X** |

• TRADFRI signal repeater

| | Light | **✓** | **✓** |

• STOFTMOLN ceiling/wall lamp WW24
• FLOALT panel WS 60x60
• TRADFRI bulb E27 CWS 806lm
• TRADFRI bulb E27 CWS opal 600lm
• TRADFRI bulb E27 WS opal ***0lm
• TRADFRI bulb E27 WS opal 1000lm
• TRADFRI bulb E27 WS globe opal 1055lm
• TRADFRI bulb T120 E27 WS opal 470lm
• TRADFRI bulb E14 WS opal 400lm
• TRADFRI bulb GU10 WS 400lm
• TRADFRI bulb GU10 WS 345lm
• TRADFRI Driver 10W
• TRADFRI Driver 30W
• GUNNARP panel round
• LWA017 (Signify Netherlands B.V.)

| | Outlet | **✓** | **✓** |

• ASKVADER on/off switch
• TRADFRI control outlet
• Aqara Smart Plug (lumi.plug.maeu01)

| | Air Purifier | **?** | **X** |

• STARKVIND Air purifier

| | Blinds | **✓** | **?** |

• PRAKTLYSING cellular blind
• FYRTUR black-out roller blind

| | Light-Controller | **✓** | **X** |

• Remote Control N2
• TRADFRI on/off switch
• TRADFRI remote control
• LEPTITER Recessed spot light
• TRADFRI wireless dimmer

| | Blinds-Controller | **✓** | **X** |

• TRADFRI open/close remote

| | Sound-Controller | **?** | **X** |

• SYMFONISK Sound Controller

| | Shortcut-Controller | **✓** | **X** |

• TRADFRI SHORTCUT Button

| | Motion-Sensor | **✓** | **X** |

• TRADFRI motion sensor

| | Speaker | **?** | **X** |

• SYMFONISK Bookshelf S21

| Legend:
**✓** fully functional
**?** implemented but not tested
**X** not implemented ### Example Code The package `dirigera-client-examples` provides several example applications, which essentially cover the aforementioned points. However, to give you a glimpse of the look and feel of the library, here's an example: ```java @SpringBootApplication @ComponentScan(basePackageClasses = {DirigeraClientApi.class}) public class MyApplication { @Bean public CommandLineRunner run(final DirigeraApi api) { return (String... args) -> { api.device.light.all() // fetch all light devices from hub .flatMapMany(Flux::fromIterable) .flatMap(d -> api.device.light.turnOn(d)) // turn on lights .flatMap(d -> api.device.light.setLevel(d, 100)) // set light level to 100% .flatMap(d -> api.device.light.setTemperature(d, d.attributes.state.color.temperatureMax)) // set color temperature .blockLast(); }; } public static void main(String[] args) { SpringApplication.run(MyApplication.class, args).close(); } } ``` ## Limitations: The API cannot catch any button presses from controllers or status changes from motion detectors to process them programmatically. However, both device types may be paired with actuators (e.g., lights or outlets) that will process the inputs directly (see example [LinkDevices](dirigera-client-examples/src/main/java/de/dvdgeisler/iot/dirigera/client/examples/linkdevices/LinkDevices.java)). As a workaround, controllers can be used to some extent as triggers for scenes whose status change can be intercepted as an event from the WebSocket stream [SceneTriggers](dirigera-client-examples/src/main/java/de/dvdgeisler/iot/dirigera/client/examples/scenetriggers/SceneTriggers.java)). ## How to contribute 1) The most significant pain point is the limitation of the API data model. You can help us to improve it, and to support progressively more devices.

To do so, run the [Dump Application](dirigera-client-dump/src/main/java/de/dvdgeisler/iot/dirigera/client/dump/DumpApplication.java). This application reads the data model of your DIRIGERA and outputs it as JSON. Based on the dump, we can determine at which points the API data model deviates or is incomplete. You may submit the generated dump as an issue to GitHub.

2) Try it out and share your experience. Many functionalities are _blind_ implemented. This means that the endpoints have been reverse-engineered, and the transmitted data was derived from shared dumps. However, only testing with real devices can verify whether the interface is implemented correctly.

3) Tell us how you plan to use the API and what features are lacking or need to be improved. #### Run the Dump Application Prerequisites: * Java 17 (or higher) has to be installed * Download Java the latest OpenJDK for your operating system [here](https://openjdk.org) * Unpack the zip file to a location of your choosing * Add `JAVA_HOME` to your environment variables with the following path `` * Add `%JAVA_HOME%\bin` to your path variable * Reboot your pc * Execute `java -version` * This should output something like: ```txt openjdk version "17.0.2" 2022-01-18 OpenJDK Runtime Environment (build 17.0.2+8-86) OpenJDK ***-Bit Server VM (build 17.0.2+8-86, mixed mode, sharing) ``` * DIRIGERA Gateway is connected to the internet * Find the IP address of your DIRIGERA Gateway in your router. ##### Instructions 1) Download the latest [dirigera-client-dump.jar](https://github.com/dvdgeisler/DirigeraClient/releases) 2) Run `java -jar dirigera-client-dump.jar`
If the autodiscovery fails and no DIRIGERA is found in your Network, you may pass the DIRIGERA's connection details by the parameters `--dirigera.hostname=` and `--dirigera.port=8443`. ## Integration to Home Assistant Lights and sockets can be integrated into Home Assistant via MQTT (more devices will follow). Home Assistant will create entities for supported devices, based on its MQTT auto discovery approach. Add `https://github.com/TheMrBooyah/hassio-repository` to your home assistant. Update the configuration to your setup. In order to get your 'Token', run the [Dump Application](dirigera-client-dump/src/main/java/de/dvdgeisler/iot/dirigera/client/dump/DumpApplication.java). This will ask you to pair your gateway. After successfully pairing the gateway a file 'dirigera_access_token' will be created. Open the file with your favourite text editor and copy everything into the 'Token' field. Start the addon, watch the logs for any errors and if everything went as expected, home assistant should have some new devices/entities from your IKEA Smart Hub. ## Other repos to dig in * [TheMrBooyah/hassio-dirigera-client](https://github.com/TheMrBooyah/hassio-dirigera-client) * [wjtje/DIRIGERA](https://github.com/wjtje/DIRIGERA) * [mattias73andersson/dirigera-client-poc](https://github.com/mattias73andersson/dirigera-client-poc)

近期下载者：

相关文件：

评论：[我要评论] [举报此文件]

收藏者：