Ce document décrit le plugin iOSCloud : configuration, authentification, équipements, présence et scénarios.
Accès rapide :
- Présentation
- Prérequis
- Installation
- Procédure d’authentification
- Types d’équipements
- Paramètres importants
- Utilisation en scénario
- Conseils pratiques
Présentation
Le plugin iOSCloud permet à Jeedom de se connecter à votre compte iCloud afin de :
- récupérer la localisation de vos appareils Apple (iPhone, iPad…)
- calculer automatiquement une présence (à la maison / absent)
- déclencher des actions comme faire sonner un appareil ou envoyer un message
Objectif : automatiser simplement votre présence et vos appareils Apple dans Jeedom.
Prérequis
Configuration minimum
- Jeedom 4.4 minimum
- Debian 11 minimum (Debian 11 recommandé)
- PHP 7.4 minimum
- Un compte Apple iCloud
- Un appareil Apple de confiance (pour recevoir le code de sécurité)
Installation
1️⃣ Installer le plugin
- Jeedom → Plugins
- Market
- Rechercher iOSCloud
- Installer puis activer
2️⃣ Installer les dépendances
Dans la page du plugin :
Cliquez sur (Ré)installer les dépendances
Le plugin utilise un module Python interne pour dialoguer avec iCloud.
Jeedom installe automatiquement ce qu’il faut.
Attendez que l’état passe à OK.
Procédure complète d’authentification (IMPORTANT)
La connexion à iCloud nécessite une double authentification (2FA).
Apple envoie un code de sécurité temporaire sur vos appareils Apple.
Étape 1 — Configurer le compte iCloud
Créer un équipement de type Compte iCloud (cloud).
Dans sa configuration :
- Adresse iCloud (email Apple)
- Mot de passe iCloud
Sauvegarder.
Étape 2 — Lancer l’authentification
Dans l’équipement :
Cliquer sur Authentification
Le plugin tente la connexion.
Étape 3 — Réception du code Apple
Si Apple demande un code :
- Vous recevez un code sur votre iPhone / iPad
- Un champ "code" apparaît dans le plugin
Entrer le code reçu.
Cliquer sur Envoyer code
Étape 4 — Validation
Le plugin affiche la progression :
- Connexion
- Code demandé
- Code envoyé
- Code validé
- Synchronisation des appareils
Quand la validation est terminée :
✅ Les appareils sont récupérés automatiquement
✅ Les équipements "devices" sont créés ou mis à jour
Nouvelle identification
- lors d'un reboot chez moi
- Si mot de passe incorrect → connexion refusée
Éviter de lancer l’authentification trop souvent.
Types d’équipements
Le plugin crée plusieurs types d’équipements :
☁️ Compte iCloud (cloud)
Équipement principal.
Contient :
- Identifiants iCloud
- Bouton Authentification
- Gestion du rafraîchissement
- Paramètres cron
📱 Appareil iCloud (devices)
Un équipement par appareil Apple.
Commandes disponibles :
- Localisation
- Batterie
- Timestamp
- State
- Play sound
- Message
📍 Position fixe (fixed)
Permet de définir un point GPS manuel (ex : Maison).
Format obligatoire :
latitude,longitude
📏 Distance / Présence (geofence_dist)
Calcule :
- Distance entre un point fixe et un appareil
- Présence (0 ou 1) selon un rayon défini
Paramètres :
- Position de référence
- Rayon (ex : 300 mètres)
- Appareils surveillés
Paramètres importants
Rafraîchissement
Ne pas mettre une fréquence trop courte.
Recommandé : toutes les 5 minutes.
Délai état
Temps avant que l’état repasse à 0 si aucune mise à jour.
Défaut : 1 heure.
Rayon de présence
- 100 m → très strict
- 300 m → bon compromis
- 500 m → plus stable
Utilisation en scénario
Exemple — Retour à la maison
Condition :
#[iOSCloud][Maison - Présence][Presence]# == 1
Actions possibles :
- Allumer lumières
- Désactiver alarme
- Envoyer notification
Exemple — Départ
#[iOSCloud][Maison - Présence][Presence]# == 0
Faire sonner un iPhone
#[iOSCloud][iPhone][Play sound]#
Envoyer un message
#[iOSCloud][iPhone][Message]#
Conseils pratiques
- Ne pas rafraîchir trop souvent
- Ajuster le rayon si la présence varie trop
- Relancer l’authentification si Apple redemande un code
- Pour éviter les faux départs, créer un scénario :
- Presence = 0
- Depuis plus de X minutes → Activer mode absent