Koble til IWMAC

IWMAC er en skybasert SD-/SCADA-plattform for drift og overvåking av tekniske installasjoner i bygg. Når et bygg allerede bruker IWMAC, kan plattformen vår lese sanntidsverdier og skrive godkjente settpunkter via IWMAC Cloud API. Denne guiden viser hva du, eller IWMAC-kontakten din, må ha klart før du starter veiviseren for nytt bygg.

Hva du skal be IWMAC om

IWMAC tildeler API-tilgang per kundekonto. Ta kontakt med IWMAC-representanten din og be dem skaffe de fire punktene under for dette konkrete bygget.

1. API-legitimasjon (Client ID + Client Key)

To verdier som er knyttet til kundekontoen din hos IWMAC. Client ID er kort og identifiserer kontoen; Client Key er en lang hemmelig nøkkel som brukes til å hente et sesjonstoken. Det samme paret kan dekke flere bygg, så du trenger normalt ikke et nytt par per bygg med mindre IWMAC-kontakten din foretrekker det.

2. Plant ID for dette bygget

IWMAC identifiserer hvert fysiske bygg med en numerisk Plant ID (for eksempel 2117 eller 3653). Du trenger én Plant ID per bygg du skal sette opp. Be IWMAC om Plant ID-en som hører til adressen du konfigurerer.

3. API-tilgang til Plant ID og enheter

Legitimasjon er ikke nok alene. IWMAC må eksplisitt autorisere Client ID-en din for Plant ID-en og kontrollerenhetene i anlegget. Be dem aktivere API-tilgang for denne Plant ID-en, og få bekreftet hvilke enheter som er med, for eksempel ventilasjon, oppvarming eller kjøling. Hvis en enhet mangler her, vil kall mot enhetens datapunkter returnere "no access" selv om legitimasjonen er gyldig.

4. Eksport av adresseliste (rå IWMAC-CSV)

IWMAC kan eksportere en adresseliste med alle datapunktene for et anlegg: sensorer, settpunkter, statusverdier og tilsvarende signaler. Dette er råeksporten fra portalen deres. Plattformen tolker filen under opplasting, så du trenger ikke rydde i den eller gi noe nytt navn. Filen må minst inneholde disse kolonnene:

• unit_id — ID-en til kontrollerenheten (f.eks. VV_2515 eller 911).
• unit_name — lesbart navn på kontrollerenheten (f.eks. "Cylon PLS", "Hovedmåler EL").
• driver_id — den lange interne adressestrengen IWMAC bruker for punktet.
• driver_id_no — den korte numeriske ID-en API-et bruker for å referere til punktet.
• alias_text — kort beskrivelse av punktet, for eksempel "Communication status" eller "Supply temperature SP".
• eng_unit — målenhet når den er definert, for eksempel °C, % eller kW.
• att — lese-/skriveattributt, for eksempel r eller rw.

Hvor hver del legges inn i veiviseren

Når de fire punktene over er klare, leder veiviseren for nytt bygg deg gjennom resten. IWMAC-data brukes i fem av stegene. Bruk denne oversikten:

• Integrasjoner og kartlegging: choose IWMAC, paste the Client ID and Client Key into a new credential, and enter the Plant ID for this site as a credential override. Click Verify — the platform requests a token from IWMAC and confirms the credentials and the Plant ID work. When the card shows "Tilkoblet" in green, you can move on.
• Last opp dokumenter: upload any technical documentation (P&IDs, schematics). The raw IWMAC address list CSV is uploaded on the IWMAC card in Integrasjoner og kartlegging; the platform parses it during upload, so you do not need to clean it first.
• Gjennomgå funn: godkjenn systemene og komponentene plattformen har hentet ut fra adresselisten og dokumentene. Ingen nye IWMAC-data her.
• Driftsanalyse: plattformen bruker IWMAC-legitimasjonen fra steg 2 til å lese et øyeblikksbilde fra Plant ID-en — gjeldende settpunkter, temperaturer og viftemoduser — og bruker det til å sette standardverdier basert på anleggsdata i stedet for generiske verdier. Øyeblikksbildet danner også grunnlaget for Watchdog-reserveverdiene i "Watchdog-oppsett". Hvis du hoppet over IWMAC i steg 2, kan du hoppe over dette steget også.
• Konfigurasjonseditor: gå gjennom den genererte konfigurasjonen; ingen nye IWMAC-data.
• Watchdog-oppsett: se neste seksjon. Steget bruker IWMAC-legitimasjonen til å registrere Watchdog-endepunktene når IWMAC har returnert Endpoints-CSV-en.
• Utrulling og test: "Upload to CMS" sender konfigurasjonen; "Deploy Secrets" skriver IWMAC-legitimasjonen inn i klyngen slik at poden som kjører for bygget kan autentisere seg; "Deploy Site" ruller ut tjenesten for bygget. Endepunkttestpanelet lar deg deretter bekrefte at lesing, og skriving hvis dere styrer settpunkter, fungerer ende til ende.

Watchdog-funksjonen (trygg skriving av settpunkter)

Når plattformen skriver et settpunkt til IWMAC, kontrollerer IWMACs Watchdog-funksjon at vi fortsetter å oppdatere det. Hvis skrivingen stopper på grunn av en feil, et nettverksproblem eller avvikling, setter Watchdog-funksjonen settpunktet tilbake til en trygg reserveverdi. Det hindrer at bygget blir stående på den siste verdien vi skrev. Watchdog er obligatorisk for bygg der vi styrer settpunkter, og settes opp én gang i to deler:

1. Del A, i "Watchdog-oppsett": veiviseren genererer en Watchdog Request-CSV basert på settpunktene den nye konfigurasjonen skal skrive til. For hvert settpunkt bekrefter du reserveverdien, ofte gjeldende verdi i SD-anlegget, og legger til eventuelle notater IWMAC trenger.
2. Send Watchdog Request-CSV-en til IWMAC-kontakten din. De setter opp Watchdog-reglene på sin side.
3. IWMAC sender tilbake en Watchdog Endpoints-CSV. Den er vanligvis semikolonseparert og inneholder kolonner som driver_id_no;unit_id;alias_text;eng_unit. Dette knytter hvert settpunktalias til driver-ID-en for Watchdog-adressen IWMAC har opprettet.
4. Del B, tilbake i "Watchdog-oppsett": last opp endepunkts-CSV-en akkurat slik IWMAC sendte den. Veiviseren lagrer koblingen, slik at den kjørende integrasjonen vet hvilke adresser den skal oppdatere.

En kort melding du kan sende IWMAC-kontakten din

Bruk linjene under som utgangspunkt. Bytt ut det som står i hakeparentes før du sender.

1. Vi kobler [byggnavn / adresse] til en tredjeparts plattform for styring av varme-, ventilasjons- og klimaanlegg via IWMAC Cloud API.
2. Kan dere utstede Client ID og Client Key for kontoen vår?
3. Kan dere bekrefte Plant ID for dette bygget og aktivere API-tilgang for denne Plant ID-en og alle kontrollerenhetene vi skal lese fra og skrive til?
4. Send gjerne standard adresseliste-CSV for denne Plant ID-en, den som inneholder unit_id, unit_name, driver_id, driver_id_no, alias_text, eng_unit og att. Ta med alle enheter; vi filtrerer på vår side.
5. Vi følger opp med en Watchdog Request-CSV. Fint om dere kan registrere Watchdog-reglene og returnere den tilhørende Watchdog Endpoints-CSV-en.

Står du fast?

Hvis IWMAC trenger tekniske detaljer du ikke har, for eksempel tokenformat, API-endepunkter eller feilkoder, åpne assistenten, så hjelper vi deg med å formulere svaret.