Daikin Aircon Controller

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

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

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

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

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.