Daikin Aircon Controller

Control Daikin air conditioners over WiFi. Use when the user wants to control their Daikin AC units - turn on/off, set temperature, mode, fan speed, swing, or query status. Supports multiple devices with custom names across multiple locations.

This skill controls Daikin air conditioners over local WiFi. It supports multiple devices, automatic discovery, full control, and multi-location setups.

Device Lookup

When user specifies a device, match in this order:

1. Exact match on id (case-insensitive, spaces→hyphens)
2. Exact match on name (case-insensitive)
3. Fuzzy match (ignore spaces/hyphens)

If multiple matches found: Ask user to specify location (e.g., "Which one? 'bedroom' at home or beach-house?")

Duplicate Devices (Same Name, Different Locations)

Same device ID/name is allowed in different locations:

• living-room @ home
• living-room @ beach-house

The unique key is locationId:id. When adding, error only if same location + same ID exists.

Adding Devices - Setup Flow

Follow this step-by-step when user wants to add a device:

Step 1: Required Info

Ask for:

• Device name: e.g., "Living Room", "Bedroom", "Master Bedroom"
• IP address: e.g., "192.168.1.100"

Step 2: Optional - Multiple Houses?

Ask: "Do you have multiple houses/locations? (e.g., home, beach-house, office)"

• If yes → Ask for location name (e.g., "Family Home", "Beach House")
• Auto-generate locationId from location name (lowercase, spaces→hyphens)

Step 3: Optional - Multiple ACs in Same Room?

Ask: "Do you have multiple ACs in the same room?"

• If yes → Append to device name (e.g., "Living Room - Ceiling", "Living Room - Floor")

Step 4: Optional - Device Type

Ask: "Do you know your device type?"

• Options: BRP069, BRP072C, BRP084, AirBase, SkyFi
• If BRP072C → Ask for API key (printed on adapter inside unit)
• If SkyFi → Ask for password

Step 5: Verify & Add

Show summary, confirm with user, then call daikin_add.

Device Management

Adding a Device

1. Discovery - Scan network: "discover daikin devices" → shows found devices
2. Manual - "add living room AC at 192.168.1.100"

Device Types

Type	Description	Authentication
brp069	Standard WiFi adapter	None
brp072C	WiFi adapter with HTTPS	API key required
brp084	Firmware 2.8.0+ adapters	None
airbase	Devices with zone support	None
skyfi	Legacy SkyFi devices	Password required

Finding the API Key (BRP072C)

For BRP072C devices, the API key is printed inside the unit:

1. Remove front grille from indoor unit
2. Find circuit board with WiFi adapter
3. API key is on a label

Available Tools

Discovery & Management

• daikin_discover: Scan network for Daikin devices (UDP broadcast). Returns IP, MAC, name.

• daikin_list: List all configured devices with names, IPs, locations, status.

• daikin_add: Add new device. Parameters:

  • name (required): Display name (e.g., "Living Room")
  • ip (required): IP address
  • locationId (optional): Location key (e.g., "home", "beach-house")
  • locationName (optional): Location display (e.g., "Family Home")
  • type (optional): Device type
  • key (optional): API key for BRP072C
  • password (optional): Password for SkyFi

• daikin_remove: Remove device. If duplicate names exist, use locationId to specify.

• daikin_update: Update device settings (IP, name, type, key, location).

• daikin_set_default: Set default device for commands.

Status & Control

All control tools accept optional device and locationId parameters. If only one device matches, use it automatically.

• daikin_status: Get status (power, mode, temp, fan, etc.)

• daikin_power: Turn on/off.

  • device: Device name
  • locationId: Location (if needed)
  • power: "on" or "off"

• daikin_mode: Set mode.

  • mode: "auto", "cool", "heat", "dry", "fan"

• daikin_temperature: Set target temp (10-32°C, use decimal like 22.5).

• daikin_fan: Set fan speed ("auto", "silence", "1"-"5").

• daikin_swing: Set swing ("off", "vertical", "horizontal", "3d").

• daikin_powerful: Toggle powerful mode.

• daikin_econo: Toggle econo mode.

• daikin_streamer: Toggle streamer air purifier.

• daikin_holiday: Toggle holiday/away mode.

Usage Examples

First Time Setup

text

User: Set up my Daikin AC
Agent: Let's add your AC! What's a name for it? (e.g., living-room, bedroom)
User: Living room
Agent: What's the IP address?
User: 192.168.1.101
Agent: Do you have multiple houses or locations?
User: Yes, at the beach
Agent: What's the location name? (e.g., Beach House)
User: Beach House
Agent: Adding "Living Room" at 192.168.1.101 (Beach House)... Done!

Multi-Location

text

User: Add bedroom at the beach house too
Agent: What's the IP for the beach house bedroom?
User: 192.168.1.201
Agent: Adding "Bedroom" at 192.168.1.201 (Beach House)... Done!

User: Turn off bedroom
Agent: You have "bedroom" at both "Family Home" and "Beach House". Which one?
User: Beach house
Agent: Turning off Bedroom at Beach House...

Controlling Devices

text

User: Set living room to 22 degrees
Agent: [Sets Living Room to 22°C]

User: Turn off
Agent: [Turns off default device]

User: What's the temperature in bedroom?
Agent: [Shows bedroom status - if multiple, asks which location]

Temperature Format

• ✅ Correct: "22.5", "23.0"
• ❌ May not work: "22"

Troubleshooting

• Device not found: Check IP, ensure same network subnet
• Connection timeout: Verify IP with ping
• Authentication failed: Check API key (BRP072C)
• Multiple matches: Specify location with locationId

State

Configuration stored in data/devices.json. Persists across sessions.