Smart-IoT › Manual de utilizare

Manual de utilizare

Tot ce trebuie să știi ca să folosești Smart-IoT — de la primul boot până la operațiuni de zi-cu-zi.

📖 Versiune 1.0 · 2026

Înainte să începi

Smart-IoT e un sistem de automatizare a casei pre-configurat de CAI Technology, bazat pe Home Assistant. Vine ca un dispozitiv (Raspberry Pi 4/5 sau Intel NUC) gata să fie conectat la rețea — fără setup tehnic.

Ce primești în pachet

  • Dispozitivul Smart-IoT (Pi 4 / 5 sau NUC, în carcasă)
  • Sursă de alimentare
  • Cablu de rețea (1.5m)
  • Card de instrucțiuni cu codul de activare (sau primești codul pe email)

Ce trebuie să ai pregătit

  • Router Wi-Fi cu DHCP activ și port LAN liber
  • Telefon cu cameră (pentru scanat QR la activare) și deget/face/PIN configurat ca metodă de blocare
  • Calculator/laptop sau telefon cu browser, conectat la aceeași rețea
  • ~10 minute
💡 Important: Smart-IoT funcționează 100% local — datele tale nu pleacă în cloud străin. Singura conexiune externă e către smart-iot.caitech.ro (cluster CAI Technology, în România) pentru: activare inițială, update-uri, suport remote la cerere.

Activarea dispozitivului

Pașii detaliați (5 minute) sunt în ghidul de start. Recap rapid:

  1. Conectează cablul de rețea și sursa.
  2. Așteaptă 1-2 minute până dispozitivul se conectează la rețea (LED-ul devine constant).
  3. Deschide pe browser adresa primită pe email (ex. http://192.168.1.x:8123).
  4. Login cu user-ul și parola din emailul de livrare.
  5. Deschide din meniu „Pair Device" — wizard-ul te ghidează prin 3 pași:
    1. Tastezi codul de activare (forma ABCD-EFGH-JKLM)
    2. Scanezi cu telefonul un QR și aprobi cu deget/face/PIN
    3. Confirmare „Gata!" + buton spre Home Assistant
Pasul 3 al wizard-ului — confirmarea 'Gata! Dispozitivul e activ'
Ecranul final al wizard-ului — pairing complet

Adăugare dispozitive

Home Assistant gestionează două categorii de dispozitive: cele descoperite automat și cele care trebuie adăugate manual.

Dispozitive descoperite automat

După activare, accesezi Settings → Devices & Services (sau apesi „Vezi în HA →" din wizard). În secțiunea Discovered apar lucrurile pe care HA le-a găsit pe rețea fără ajutorul tău:

Settings → Devices & Services din HA cu lista Discovered (TV LG, imprimantă Canon, router ASUS, LG ThinQ)
Lista Discovered — TV-uri smart, imprimante, routere, ThinQ etc.

Pentru fiecare apare un buton Add (îl integrezi în HA) sau Ignore (nu vrei să-l vezi). Pentru Add urmează niște pași simpli (de obicei: confirmare nume + camera/categorie).

💡 De știut: HA descoperă automat dispozitive care folosesc mDNS (Bonjour/Apple), SSDP (UPnP) sau Zeroconf. Multe device-uri smart NU folosesc aceste protocoale — pentru ele trebuie integrare manuală.

Adăugare manuală — invertor solar / prize / camere

Pentru dispozitive care nu apar în Discovered:

  1. Apasă + Add integration (jos-dreapta în Settings → Devices & Services)
  2. Caută numele producătorului în lista de integrări
  3. Urmează pașii din fereastră — de obicei se cere IP-ul dispozitivului din rețea + parola contului tău (dacă cere)

Cele mai comune integrări la utilizatorii noștri

Producător / TipIntegrare HANote
Sunsynk / Deye invertorSunsynk SolarmanCere IP + serial; HA generează automat dashboard solar (Power Flow Card)
Shelly priză/releuShellyAuto-discovered de obicei; dacă nu, IP manual
Tuya / Smart LifeTuyaCere cont Tuya cloud + 2FA
Hikvision / Dahua camerăONVIF sau Generic CameraStream RTSP + credentiale camera
Sonoff WiFiSonoffLAN sau TasmotaDepinde de firmware
Termostat smartvariabilCaută brand-ul în Add integration
Aspirator robotRoborock / Xiaomi MiCere token (vezi docs producător)
⚠ Atenție: NU folosi integrarea „WiFi only" pentru dispozitive importante (priza care alimentează frigiderul, lumina principală). Dacă WiFi-ul cade, HA pierde controlul. Pentru critic, alege Zigbee sau Z-Wave (cu coordinator USB).

Dashboard și vizualizare

HA livrează un dashboard Overview generat automat cu toate dispozitivele tale. Îl găsești în meniu pe prima poziție.

Personalizare rapidă

Din colțul dreapta-sus al dashboard-ului, apasă cele 3 punctulețe → Edit dashboard. Acolo:

  • Adaugi/ștergi card-uri (entitate, grafic, hartă, vremea, glisor)
  • Reordonezi prin drag-and-drop
  • Schimbi numele și icon-ul fiecărui dispozitiv (Settings → Devices → click pe device)

Card-uri specifice CAI Technology

Pentru anumite producători, Smart-IoT generează automat card-uri optimizate la prima activare a integrării:

  • Sunsynk Power Flow Card — diagramă animată producție solar / consum / baterie / rețea, cu fluxuri de putere live (1-fazic, 3-fazic, micro/grid-tied — auto-detectat)
  • Energy Dashboard — agregat zilnic/lunar al producției și consumului
💡 Sfat: Pentru dashboard-uri mai avansate (multi-secțiune, condiționate, mobile-only), recomandăm documentația oficială Home Assistant — e la fel de aplicabilă pe Smart-IoT.

Asistent AI (BYOK — Bring Your Own Key)

Smart-IoT integrează asistenți AI prin protocolul standard MCP (Model Context Protocol). Înseamnă că dispozitivul nu e legat de un anume LLM — poți folosi orice model (Claude, ChatGPT, Gemini, Llama local etc.) care respectă MCP.

BYOK = îți aduci propria cheie API. Plătești direct la providerul ales (sau zero, dacă rulezi local), CAI nu se interpune între tine și abonamentul tău.

⚠ Privacy alert: Smart-IoT funcționează 100% local. Când conectezi un AI cloud, datele despre casa ta (nume dispozitive, comenzi vocale, istoric) trec prin serverele providerului ales — citește politica lor înainte. Pentru intimitate maximă, folosește o opțiune on-prem (Ollama + Llama / Qwen / Mistral pe un PC din casă).

Două căi de integrare

CaleProContraRecomandat pentru
Cloud (API key) Setup în 2 minute. Modele de top. Cost pe token. Date pleacă la provider. User-i care au deja cont (ChatGPT Plus / Anthropic / etc.).
On-prem (URL local) Gratis. Privacy 100%. Funcționează fără internet. Cere hardware (PC cu 16GB+ RAM sau GPU). Modele puțin mai slabe ca Claude/GPT. Cei care țin la privacy sau au deja un PC capabil.

12 provideri suportați

Fiecare provider are propriul integration HA (built-in sau HACS). Tabel de referință:

ProviderModHA IntegrationCost (~)
Anthropic ClaudeCloudHA Core$3-15 / M tokens
OpenAI (GPT)CloudHA Core$2.5-10 / M tokens
Google GeminiCloudHA Core$1-7 / M tokens
MistralCloudHACS$2-8 / M tokens
xAI GrokCloudHACS$3-12 / M tokens
DeepSeekCloudHACS$0.14-0.28 / M tokens (ieftin!)
CohereCloudHACS$2.5-10 / M tokens
Groq (Llama hostat rapid)CloudHACS$0.5-2 / M tokens
OpenRouter (gateway multi)CloudHACSvariabil
Together AI / Fireworks (Llama hostat)CloudOpenAI-compatible HACS$0.2-1 / M tokens
Ollama (Llama, Qwen, Mistral local)On-premHA CoreGratis (hardware-cost)
LM Studio / vLLM / llama.cppOn-premOpenAI-compatible HACSGratis (hardware-cost)

Setup detaliat — pas cu pas

🟣 Anthropic Claude (Cloud)
  1. Creează cont la console.anthropic.com și generează API key (Settings → API Keys → Create).
  2. În HA: Settings → Devices & Services → + Add Integration → "Anthropic Conversation".
  3. Lipește API key. Selectează model (recomandat: claude-haiku pentru rapid, claude-sonnet pentru calitate).
  4. Activează din Settings → Voice Assistants ca agent default.
🟢 OpenAI (GPT-4 / GPT-5)
  1. Cont la platform.openai.com, API Keys → Create new secret key.
  2. În HA: + Add Integration → "OpenAI Conversation". Lipește key, alege model.
  3. Setează ca voice assistant default dacă vrei să-l folosești cu microfonul.
🔵 Google Gemini
  1. API key la aistudio.google.com.
  2. În HA: + Add Integration → "Google Generative AI Conversation".
  3. Recomandat: gemini-2.5-flash — rapid și ieftin.
🟠 Mistral (HACS)
  1. API key la console.mistral.ai.
  2. Instalează HACS dacă nu ai deja (Settings → Add-ons → HACS).
  3. HACS → Integrations → caută "Mistral AI Conversation" → Download → restart HA.
  4. HA: + Add Integration → "Mistral AI Conversation" → key.
⚫ xAI Grok (HACS)
  1. API key la x.ai (cont X / Twitter premium necesar).
  2. HACS → caută "xAI Grok" sau "Extended OpenAI Conversation" (compatibil cu Grok via OpenAI-compatible endpoint).
  3. HA: integration nouă, lipește key + endpoint https://api.x.ai/v1.
🔵 DeepSeek (cel mai ieftin)
  1. API key la platform.deepseek.com.
  2. HACS → "Extended OpenAI Conversation" (DeepSeek e OpenAI-compatible).
  3. HA: lipește key, endpoint https://api.deepseek.com/v1, model deepseek-chat sau deepseek-reasoner.

Cost ~20× mai mic decât Claude pentru calitate similară pe sarcini de smart home.

🔷 Cohere (HACS)
  1. API key la dashboard.cohere.com.
  2. HACS → "Cohere Conversation" (sau "Extended OpenAI" cu endpoint Cohere).
⚡ Groq (Llama 3 super-rapid)
  1. API key la console.groq.com.
  2. HACS → "Extended OpenAI Conversation".
  3. Endpoint: https://api.groq.com/openai/v1. Model: llama-3.3-70b-versatile (recomandat) sau mixtral-8x7b-32768.

Avantaj Groq: latență extrem de mică (sub 1s), perfect pentru voice assistant.

🌐 OpenRouter (un key, toate modelele)
  1. API key la openrouter.ai.
  2. HACS → "Extended OpenAI Conversation".
  3. Endpoint https://openrouter.ai/api/v1, model = oricare din lista lor (ex: anthropic/claude-3.5-sonnet, google/gemini-pro-1.5).

Util dacă vrei să schimbi rapid modele fără să creezi cont la fiecare provider.

🔥 Together AI / Fireworks (Llama cloud-hostat)
  1. Cont la api.together.ai sau fireworks.ai.
  2. HACS → "Extended OpenAI Conversation".
  3. Endpoint provider + model ales (ex: meta-llama/Llama-3.3-70B-Instruct).
🦙 Ollama (on-prem, recomandat pentru privacy)
  1. Pe un PC din casă (Linux / Mac / Windows) instalează Ollama.
  2. Pull un model: ollama pull llama3.3 (sau qwen2.5:14b, mistral-nemo etc.).
  3. Asigură-te că Ollama acceptă conexiuni din rețea: OLLAMA_HOST=0.0.0.0 ollama serve.
  4. În HA: + Add Integration → "Ollama" (built-in).
  5. URL: http://<ip-pc-din-casa>:11434. Selectează model.
💡 Hardware recomandat pentru Llama 3.3 70B: 64GB RAM (CPU-only, lent), SAU GPU NVIDIA cu 40GB+ VRAM (rapid). Pentru Pi 5 sau hardware modest, folosește un model mai mic — llama3.2:3b sau qwen2.5:7b rulează decent pe Pi 5 16GB.
🖥 LM Studio / vLLM / llama.cpp (alternative on-prem)
  1. Pornește server-ul local: LM Studio Server, vLLM, sau llama-server.
  2. HACS → "Extended OpenAI Conversation".
  3. Endpoint: URL-ul server-ului local (ex: http://192.168.1.50:1234/v1).
  4. Model: numele exact afișat de server.

LM Studio e cel mai prietenos (GUI), vLLM e cel mai rapid (production-grade), llama.cpp e cel mai light.

Avansat: server MCP unificat (`ha-mcp`)

Pentru utilizatori avansați care vor un singur server care expune 87 de tools HA către orice client MCP (Claude Desktop, Cursor, Cline, etc.), există ha-mcp — un addon HA open-source (MIT). Util mai ales pentru control fin (creare automatizări, editare YAML, backup-uri etc.) prin AI, nu doar conversație.

Instalare: HACS → caută "ha-mcp" → Download → conectează clientul MCP cu un long-lived token HA.

Sfaturi de alegere rapide

  • Ai deja cont la un provider? Folosește-l cu BYOK — nu plătești dublu.
  • Vrei privacy maximă? Ollama + Llama 3.3 / Qwen 2.5 pe un PC din casă.
  • Vrei voice assistant rapid? Groq (latență sub 1s) sau Gemini Flash.
  • Vrei buget mic și calitate bună? DeepSeek (~20× mai ieftin decât Claude).
  • Vrei flexibilitate să schimbi modele? OpenRouter — un singur key, toate modelele.
🚀 Vine în v1.5: cai_ai_panel — un panel CAI integrat care îți permite să adaugi orice provider de mai sus printr-un singur click + API key, fără să mai treci prin HACS și fără să cauți integrarea potrivită. BYOK rămâne mecanismul principal.

Actualizări

Smart-IoT are 3 niveluri de update-uri, gestionate separat:

ComponentaFrecvențăCum actualizezi
CAI Bootstrap (addon-ul nostru)~lunarSettings → Add-ons → CAI Bootstrap → Update
Home Assistant Core~lunar (zi de marți)Settings → System → Updates → Install
HA Operating System~trimestrialSettings → System → Updates → Install
⚠ Înainte de orice update: Fă un backup. Dacă update-ul aduce o problemă, restaurarea revine la starea anterioară.

Update automat sau manual?

Pentru v1.0 alegem manual — vezi notificarea, apesi „Update" când vrei tu. Avantaj: nu te trezești cu un device în mijlocul actualizării când ai musafiri. Dezavantaj: trebuie să fii atent la notificările HA.

În viitor, oferim și opțiunea auto-update opt-in pentru cei care preferă „set și uită".

Backup

Backup-urile salvează toată configurația ta (dashboards, automatizări, integrări, istoric) într-un fișier. Dacă ceva merge prost — restore în ~5 minute.

Backup local

  1. Settings → System → Backups
  2. Apasă + Create backup
  3. Alege „Full backup" (recomandat) sau „Partial" (doar anumite addon-uri)
  4. Așteaptă 1-3 minute. Backup-ul rămâne pe disk-ul dispozitivului.

Backup pe cloud

Pentru protecție împotriva disk failure, conectează un cloud storage:

  • Google Drive — addon disponibil din HA Add-on Store
  • Nextcloud — dacă ai server propriu
  • Sync local către un NAS din casă (Synology, QNAP)
💡 Recomandare: Programează un backup automat zilnic (Settings → System → Backups → Schedule). Păstrează ultimele 7 zile + 4 săptămâni + 12 luni.

Securitate

Smart-IoT folosește WebAuthn + RFC 8628 (același standard ca Apple/Google) pentru autentificare la activare. Asta înseamnă fără parole de furat — autorizezi fizic, cu telefonul tău.

Ce trebuie să ții minte

  • Codul de activare (ABCD-EFGH-JKLM) e single-use. După ce l-ai consumat, nu mai e valid pentru niciun alt dispozitiv.
  • Parola HA (de admin/login) trebuie schimbată din valoarea default la prima logare — Settings → People → Profile.
  • Telefonul care a aprobat pairing-ul devine un device de încredere. Dacă îl pierzi, conectează-te la dashboard-ul de operator (sau scrie-ne la support) ca să-l revoci.

Ce să nu faci

  • NU expune HA-ul direct pe internet (port forward 8123). Folosește Nabu Casa Cloud sau VPN (WireGuard, Tailscale).
  • NU instala addon-uri din repository-uri necunoscute. HA Add-on Store oficial + repo-ul Smart-IoT sunt singurele de încredere.
  • NU împărți userul tău cu alți membri ai familiei — fiecare să aibă cont separat (Settings → People → + Add Person).

Probleme frecvente

Dispozitivul nu se conectează la rețea
  • Verifică LED-ul de pe dispozitiv — trebuie să fie verde constant (nu galben/roșu)
  • Asigură-te că router-ul are DHCP activ (verifică din interfața router-ului)
  • Reboot dispozitiv (scoate sursa, așteaptă 30 sec, rebagă)
  • Dacă persistă, scrie-ne la support@caitech.ro cu modelul router-ului
Am pierdut adresa IP a dispozitivului

Verifică în interfața router-ului (de obicei http://192.168.1.1) lista de DHCP clients — caută hostname-ul „smart-iot" sau „homeassistant".

Sau: scoate cablul HDMI într-un monitor (dacă e Pi) — la pornire afișează adresa IP local.

Codul de activare îmi spune „cod invalid"
  • Verifică toate cele 12 caractere (poți copia direct din email)
  • Codul nu conține O/0 sau I/1 — doar caractere clare
  • Codul e single-use — verifică dacă nu l-ai folosit deja pe alt dispozitiv
  • Dacă persistă, scrie-ne la support@caitech.ro
Nu apare invertorul solar / camera / frigiderul în Discovered

HA descoperă automat doar device-uri cu mDNS/SSDP. Pentru restul, mergi la Settings → Devices & Services → + Add integration și caută producătorul.

Pentru ghid pe cele mai comune, vezi tabelul de la Adăugare dispozitive.

Dispozitivul a devenit lent / nu mai răspunde
  1. Settings → System → Hardware — verifică CPU și RAM. Dacă RAM > 90%, probabil un addon a leak-uit.
  2. Settings → Add-ons — verifică log-urile fiecărui addon recent instalat. Oprește-le pe rând.
  3. Reboot HA: Settings → System → Restart Home Assistant
  4. Dacă persistă, restore la ultimul backup care funcționa
Cum revoc accesul telefonului meu (l-am pierdut)?

Scrie-ne urgent la support@caitech.ro cu numele de pe contractul de cumpărare — operatorul nostru revocă pairing-ul în < 30 minute (în program de lucru).

În viitor, dashboard-ul tău va avea un buton „Revocă device-uri pierdute" — feature-ul e pe roadmap pentru v1.5.

Pot folosi Smart-IoT fără internet?

După activare, da. Toate automatizările locale, dashboard-ul, controlul dispozitivelor merg fără internet. Pierzi:

  • Update-urile automate
  • Vremea (necesită API extern)
  • Suportul remote la cerere
  • Backup-urile pe cloud

Glosar

Home Assistant (HA)
Software-ul open-source de automatizare a casei pe care e construit Smart-IoT. Smart-IoT adaugă pe deasupra: pre-configurare, suport remote, integrări proprii, identitate WebAuthn.
Addon
Aplicație care rulează în paralel cu HA pentru a extinde funcționalitatea (ex: SSH, file editor, MQTT broker, CAI Bootstrap).
Integration
Conector pentru un dispozitiv sau serviciu specific (ex: integrarea Sunsynk, integrarea Tuya). Diferă de „addon" — integration e parte a HA Core.
Discovered
Lista de dispozitive găsite automat în rețea de HA. Tu apesi Add sau Ignore.
Ingress
Mecanismul prin care HA îți arată UI-ul unui addon direct în meniul lateral, fără să deschizi un port separat.
Pairing
Procesul prin care un dispozitiv Smart-IoT e legat de identitatea ta CAI-Auth (folosind RFC 8628 + WebAuthn).
Cluster
Sistemul central CAI Technology de la smart-iot.caitech.ro — răspunde la activări, ține audit log, livrează update-uri, oferă suport remote la cerere.
Backup
Snapshot complet al configurației HA + addon-uri + istoric. Restore = revenire instant la starea anterioară.
Automation
Regulă „dacă X atunci Y" (ex: „dacă apusul → aprinde lumina exterior"). Le creezi vizual în Settings → Automations.
Entity
O „proprietate" a unui dispozitiv (ex: lumina are entitățile: stare on/off, intensitate, culoare). HA tratează totul ca entități.

N-ai găsit ce căutai?

Răspundem la fiecare email în 24 ore (zile lucrătoare).

support@caitech.ro

Sau citește ghidul de start (5 min) dacă ești la prima utilizare.

← Înapoi la Smart-IoT