Daikin Airbase BRP15B61 Edge Handler for SmartThings

Device Discovery	Main Unit	Temperature Sensor

Disclaimer

This software is provided "AS IS", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.

Safety Warning: This driver is a proof of concept for educational purposes. It is not intended for use in mission-critical environments, such as server rooms, medical storage, or primary residential heating/cooling where equipment failure could lead to property damage or personal injury. Users should always maintain the ability to control their HVAC system through official Daikin hardware or apps.

Trademark and API Notice:

• Daikin is a registered trademark of Daikin Industries, Ltd.
• SmartThings is a trademark of SmartThings Inc. / Samsung Electronics.
• This project is an independent, community-driven effort and is not affiliated with, endorsed by, or associated with Daikin Industries or Samsung Electronics.
• The API endpoints and communication protocols used in this driver were implemented based on publicly available community documentation (see Resources). No proprietary Daikin software was reverse-engineered by the author for this project.

This project is licensed under the Apache License 2.0.

Resources

• Daikin Control (Node.js)
• Daikin Controller (Node.js)
• SmartThings Edge Device Drivers
• Edge Architecture
• First Lua Driver Tutorial
• Capabilities Reference
• Custom Capabilities

Dependencies

• SmartThings CLI
• SmartThings Edge Drivers SDK

Installation

Uploading Your Driver to SmartThings

For a simplified setup, use the provided Makefile:

make setup

Or manually follow these steps:

1. Create a Channel:

   smartthings edge:channels:create

2. Enroll Your Hub:

   smartthings edge:channels:enroll

3. Assign the Driver to the Channel:

   smartthings edge:channels:assign

4. Install the Driver on Your Hub:

   smartthings edge:drivers:install

Accessing Live Logs

To see what the driver is doing in real-time:

make logcat

Or manually:

smartthings edge:drivers:logcat

Development

A Makefile is provided for common development tasks:

• make setup: Run the full onboarding flow (First time).
• make test: Run Lua unit tests.
• make package: Package the driver.
• make create-channel: Create a new channel (interactive).
• make enroll-channel: Enroll hub in channel (interactive).
• make assign-driver: Assign driver to channel (interactive).
• make install: Install the driver to the hub.
• make logcat: Access live logs.

Running Tests

make test

Onboarding Your New Device

Once the driver is installed on your hub:

1. Open the SmartThings App.
2. Go to the Location where the Hub is installed.
3. Select Add (+) and then Device.
4. Tap on "Scan nearby".
5. Check the logs in your logcat session to verify discovery.
6. The device should appear in your SmartThings app.

Frequently Asked Questions (FAQ)

1. What are the essential verification steps before installing?

• Network: Ensure your SmartThings Hub and Daikin Airbase are on the same network (preferably 2.4GHz).
• Official App: Verify the unit works correctly with the official Daikin Airbase app.
• Connectivity Test: Find your unit's IP address and run this command from a computer on the same network:

  curl "http://<YOUR_UNIT_IP>/skyfi/common/basic_info"

  A successful response confirms the unit is reachable and compatible with the skyfi API.

2. I get a "no driver found" error during CLI installation. What's wrong?

• Directory Context: Ensure you are running commands from the root directory of this project, not a system folder.
• Missing Package: You must package the driver before assigning it. Run make package or:

  smartthings edge:drivers:package .

3. I assigned the driver but it still won't install.

The CLI might be using a different default channel. Force the correct channel by setting the default:

1. Set the default channel:

   smartthings config:default channel <your-channel-uuid>

2. Re-assign the driver:

   smartthings edge:channels:assign

4. Why are the temperature readings confusing?

The Daikin Airbase reports several temperatures:

• Set Temperature: What you see on the thermostat display.
• Indoor/Outdoor Sensors: These are internal to the Daikin hardware and can be slow to update or less accurate than dedicated SmartThings sensors. For precise automation, we recommend using a separate temperature sensor.