Cozify HAN

Cozify HAN
• Cozify HAN on suunniteltu sijoitettavaksi RJ12-liitännällä varustetun sähkömittarin
viereen. Laite voidaan kiinnittää sähkökaappiin sähkömittarin esimerkiksi
kaksipuolisella teipillä.
• Myyntipakkaus ei sisällä lisäantennia tai USB-C virtalähdettä. WiFi-lisäantennin voit hankkia esim. täältä.

Cozify HAN – Shelly
• Shelly osaa hyödyntää kaikkea Cozify HAN -laitteen
kautta saatavaa sähkömittarin P1/HAN-portin tietoa –
reaaliaikaisesti ja vaihekohtaisesti.
• Tämä tarkoittaa, että esimerkiksi pääsulakkeiden
ylikuormitusta voidaan ennaltaehkäistä automaattisesti:
Shelly voi katkaista virran, jos yksittäisen vaiheen haluttu
ampeeriraja uhkaa ylittyä.
• Tulos? Turvallisempi, tehokkaampi ja älykkäämpi
sähkönkäyttö – ilman manuaalista säätöä.

Esimerkkiskripti (Shelly Pro, Shelly gen3 tai uudempi), jolla Shelly voi lukea Cozify HAN tarjoaman informaation Shellyn rajapintaan. Muista päivittää oikea laitteen osoitetieto.

Skippaa tämä ja lue ns. virallinen ohjeistus täältä.

// ==================================================
// Cozify HAN -> Shelly PlugS Gen3 Virtual Components
// Updates:
// – Total Power every 10s
// – Total Energy every 10s
// – Electricity Price every 60s
// – Current L1, L2, L3 every 10s
// ==================================================

let CFG = {
HAN_URL: “http://<Your_Cozify_HAN_IP_address>/meter”,
PRICE_URL: “http://<Your_Cozify_HAN_IP_address>/data”,
HAN_INTERVAL: 10, // seconds
PRICE_INTERVAL: 60, // seconds
VC_POWER_ID: 200, // Create using Shelly Components “Total Power”, use components number here
VC_ENERGY_ID: 201, // Create using Shelly Components “Total Energy” use components number here
VC_PRICE_ID: 205, // Create using Shelly Components “Electricity Price” use components number here
VC_L1_ID: 203, // Create using Shelly Components “Current L1” use components number here
VC_L2_ID: 202, // Create using Shelly Components “Current L2” use components number here
VC_L3_ID: 204, // Create using Shelly Components “Current L3” use components number here
LOG_PREFIX: “[HAN]”
};

function log() {
var args = [CFG.LOG_PREFIX];
for (var i = 0; i < arguments.length; i++) args.push(arguments[i]);
print.apply(null, args);
}

// ———- Change tracking ———-
let lastVals = {};
let updateQueue = [];
let queueIndex = 0;
let queueBusy = false;

// ———- Queue processor ———-
function processQueue() {
if (queueBusy) return;
if (queueIndex >= updateQueue.length) {
// finished all items
updateQueue = [];
queueIndex = 0;
return;
}

queueBusy = true;
let item = updateQueue[queueIndex];

Shelly.call(“Number.Set”, { id: item.id, value: item.value }, function () {
queueBusy = false;
queueIndex++;
// schedule next item after 200ms
Timer.set(200, false, processQueue);
});
}

function enqueueUpdate(id, value) {
if (lastVals[id] !== value) {
lastVals[id] = value;
updateQueue[updateQueue.length] = { id: id, value: value }; // manual push
processQueue();
}
}

// ———- Poll HAN ———-
function pollHAN() {
Shelly.call(“HTTP.GET”, { url: CFG.HAN_URL }, function (res, err) {
if (!res || res.code !== 200 || typeof res.body !== “string”) {
log(“HAN HTTP error”);
return;
}
var data;
try { data = JSON.parse(res.body); } catch (_) { log(“HAN JSON parse error”); return; }

// Power
var w = (Array.isArray(data.p) && typeof data.p[0] === “number”) ? data.p[0] : null;
if (w !== null) {
let val = Math.round(w);
log(“Power:”, val, “W”);
enqueueUpdate(CFG.VC_POWER_ID, val);
}

// Energy
var e = (typeof data.ic === “number”) ? data.ic : null;
if (e !== null) {
let val = parseFloat(e.toFixed(3));
log(“Energy:”, val, “kWh”);
enqueueUpdate(CFG.VC_ENERGY_ID, val);
}

// Currents L1/L2/L3
if (Array.isArray(data.i)) {
if (typeof data.i[0] === “number”) {
let val = parseFloat(data.i[0].toFixed(3));
log(“L1 Current:”, val, “A”);
enqueueUpdate(CFG.VC_L1_ID, val);
}
if (typeof data.i[1] === “number”) {
let val = parseFloat(data.i[1].toFixed(3));
log(“L2 Current:”, val, “A”);
enqueueUpdate(CFG.VC_L2_ID, val);
}
if (typeof data.i[2] === “number”) {
let val = parseFloat(data.i[2].toFixed(3));
log(“L3 Current:”, val, “A”);
enqueueUpdate(CFG.VC_L3_ID, val);
}
}
});
}

// ———- Poll Price ———-
function pollPrice() {
Shelly.call(“HTTP.GET”, { url: CFG.PRICE_URL }, function (res, err) {
if (!res || res.code !== 200 || typeof res.body !== “string”) {
log(“Price HTTP error”);
return;
}
var data;
try { data = JSON.parse(res.body); } catch (_) { log(“Price JSON parse error”); return; }

if (typeof data.p === “number”) {
let val = parseFloat(data.p.toFixed(6));
log(“Price:”, val, “c/kWh”);
enqueueUpdate(CFG.VC_PRICE_ID, val);
}
});
}

// ———- Startup ———-
Timer.set(CFG.HAN_INTERVAL * 1000, true, pollHAN); // every 10s
Timer.set(CFG.PRICE_INTERVAL * 1000, true, pollPrice); // every 60s

// initial run
pollHAN();
pollPrice();

Lisäksi luonnollisesti pitää tehdä nuo arvojen tallennusta vastaavat virtuaalikomponentit oikean tyyppisinä ja oikeassa järjestyksessä, kuten kuvan komponentit:

Cozify HAN – Home Assistant – Open API
• Cozify HAN -laitteessa on sisäänrakennettu HTTP-palvelin, joka toimii portissa 80.
• Kaupalliseen käyttöön valtuutetut kumppanit voivat käyttää laitteen rajapintaa OpenAPI 3.1 -rajapinnan avulla.
• KOKEILE: http:/<deviceIP>/meter
• Rajapinnan käyttö on veloituksetonta epäkaupallisessa käytössä

Lue lisää valmistajan sivuilta tästä linkistä ja tästä linkistä!

Virallinen tuoteinfo STK tallennetun mukaisesti:

Cozify HAN on kotimainen, avainlipputuote, joka tuo sähkömittarin HAN/P1-rajapinnan tiedot reaaliaikaisesti paikallisverkkoon, pilveen ja älyjärjestelmiin. Se on suunniteltu erityisesti pohjoisiin olosuhteisiin, helppoon itseasennukseen ja laajaan integraatioon (RestAPI, MQTT ja Modbus) energiankäytön optimointia, kuormanhallintaa ja automaatiota varten.

Keskeiset ominaisuudet
• Reaaliaikainen mittausdata: hetkellinen teho (W/kW), jännite (V), virta (A) ja kumulatiiviset kulutusluvut (kWh) vaihekohtaisesti, kaikki data mitä HAN/P1 väylästä tulee
• Tukee Ethernet (RJ45)‑yhteyttä ja WiFi‑yhteyttä; mahdollisuus vaihtaa alkuperäinen antenni RP‑SMA‑ulkoinen antenniin parempaa kantamaa varten
• Sisäänrakennettu HTTP palvelin (/ui -paikallinen käyttöliittymä), RestAPI,  MQTT ja Modbus (TCP)‑rajapinnat B2B‑integraatioihin
• Toimii Android- ja iOS‑sovelluksen kanssa, OTA‑firmware‑päivitykset takaavat jatkokehityksen ja tietoturvan
• Suunniteltu toimimaan pohjoismaisissa olosuhteissa –40 °C … +60 °C ja samalla IP‑luokituksella kuin sähkömittari
• Mahdollisuus brändättyihin laite-eriin yhteistyökumppaneille

Mitä laite tarjoaa käyttäjälle
• Täsmällinen reaaliaikainen näkyvyys sähkönkulutukseen ja tuotantoon
• Käyttökohteiden ja laitteiden kustannusseuranta (esim. sauna, pesukone, auton lataus, mutta myös sähkön tuotto, eli myynti)
• Vaihekohtaisten kuormitusnäkymien avulla helppo tunnistaa ylikuormitusriskit ja tasata kuormia
• Parempi mahdollisuus hyödyntää tunti- ja varttihintaa sekä reaaliaikaista ohjausta älykkäässä latauksessa ja lämmityksessä
• Toimi erinomaisesti myös Shelly laitteiden tai Home Assistant (HACS-Integraatio) järjestelmän kanssa
• Integroituu olemassa oleviin kotiautomaatioalustoihin (esim. Home Assistant) ja energianhallintajärjestelmiin (EVCC.io jne.). Rajapintojen Modbus (TCP), MQTT ja RestAPI ( https://cozify.github.io/docs/files/han-1.0.html ) kautta integrointimmahdollisuudet ovat rajattomat. Lisää rajapintoja tulevaisuudessa.

Tekniset tiedot
• Liitännät: RJ12 (HAN/P1), RJ45 (Ethernet), WiFi , USB‑C (lisävirta),  RP-SMA (WiFi lisäantenni)
• Rajapinnat: RestAPI, MQTT, Modbus TCP
• Käyttöympäristö: −40 °C … +60 °C; kotelo ja liitännät sähkömittariluokan mukaiset
• https://cozify.github.io/docs/files/han-1.0.html

Asennus ja käyttöönotto
• Itseasennettava; sijoitetaan sähkömittarin viereen ja kiinnitetään esim. kaksipuolisella teipillä
• Jos mittari on metallisessa kaapissa, suositellaan Ethernet‑yhteyttä tai ulkoista RP‑SMA‑antennia luotettavan yhteyden varmistamiseksi
• Cozify‑mobiilisovellus opastaa käyttöönoton ja mahdollistaa laitekonfiguraation. Ammattilaisille myös mahdollisuus konfiguroida laite skriptien avulla. Käyttönotto myös paikalliset käyttöliittymän kautta http://<HAN-IP>/ui

Kenelle sopii
• Kotitaloudet, jotka haluavat reaaliaikaista läpinäkyvyyttä sähkönkulutukseen
• Asunto‑ ja kiinteistöyhtiöt, isännöinti ja talotekniikka, jotka tarvitsevat vaihekohtaista kuormaseurantaa tai etävalvontaa
• Sähköyhtiöt ja jakeluverkkoyhtiöt asiakasintegraatioihin ja nopeaan vikatilanteiden tunnistukseen
• Integraattorit ja yritysasiakkaat, jotka haluavat kaupallisia rajapintoja ja brändättyjä laiteratkaisuja Integraatioesimerkkejä ja automaatio
• EV‑latauksen optimointi yhteensopivien latausjärjestelmien kanssa (Modbus, RestAPI, MQTT, EVCC.io)
• MQTT‑broker‑pohjaiset palvelut yritysintegraatioihin: reaaliaikaiset push‑viestit