README

A powerful PHP library to control IKEA Tradfri smart lights via the Gateway.

🚀 Quick Start

1. Requirements

• PHP 8.4+
• coap-client (available via Docker)

2. Generate Security Key

Use the Docker Coap-Client to get your credentials:

docker run --rm webproject/coap-client 
  -m post -u "Client_identity" -k "<GATEWAY_SECRET>" 
  -e '{"9090":"php-api-user"}' 
  "coaps://<GATEWAY_IP>:5684/15011/9063"

💻 Usage

Initialize API

use IKEA\Tradfri\Dto\CoapGatewayAuthConfigDto;
use IKEA\Tradfri\Factory\GatewayServiceFactory;

$api = (new GatewayServiceFactory(
    new CoapGatewayAuthConfigDto(
        username: 'php-api-user',
        apiKey: 'GENERATED_API_KEY',
        gatewayIp: '192.168.1.10',
        gatewaySecret: 'GATEWAY_SECRET'
    )
))();

Control Devices

// Switch on all lights and dim to 80%
foreach ($api->getLights() as $light) {
    $light->switchOn()->dim(80);
}

// Switch off a specific group
$api->getGroups()->first()?->switchOff();

📖 Documentation

• Requirements
• Examples

🤝 Contributing

Feel free to submit Pull Requests.

📄 License

MIT License.