Importer datapunkter med Excel

Andre måter å legge til datapunkter på

Denne artikkelen handler om import fra Excel. For noen protokoller finnes det også egne alternativer:

• KNX: import fra ETS XML

• BACnet: import fra EDE og BACnet-klienten

• OPC UA: OPC UA-klienten

Slik importerer du datapunkter

Oppdater eksisterende datapunkter

Du kan aktivere Oppdater eksisterende for å oppdatere datapunkter som allerede finnes. Evolo bruker unikt navn og grensesnitt for å finne riktige datapunkter og unngå duplikater.

Oppdater basert på ID

Når du skal oppdatere eksisterende datapunkter, kan du huke av denne for å matche på ID istedenfor navn, slik at datapunkter kan få nytt navn. Du må ha ID-kolonnen i Excel-arket som importeres.

Felles felt

Noen felter går igjen i alle protokoller.

Name

Påkrevd. Navnet på datapunktet. Dette er navnet som vises når datapunktet senere brukes i systemet, for eksempel i en komponent i en visning. Det anbefales å bruke et konsekvent merkesystem.

Description

Valgfritt. En ekstra beskrivelse av datapunktet.

Interface

Påkrevd. Identifikatoren for grensesnittet som datapunktet skal lese fra. Denne peker til riktig fysisk enhet og riktig grensesnitt. Du finner identifikatoren i tabellvisningen under Konfigurasjon for grensesnitt.

Unit

Benevnelse eller måleenhet, for eksempel %, ppm eller l/s.

Return statement

Valgfritt. JavaScript for behandling av innkommende melding.

Payload statement

Valgfritt. JavaScript for behandling av utgående melding.

Protokollspesifikke felt

KNX

Import fra ETS

Du kan også importere fra ETS ved å eksportere prosjektet til XML og laste opp filen i dialogen for KNX XML. Da får du et Excel-ark i Evolo-format der støttede DPT-er er validert. Etter at du har behandlet filen, kan du laste den opp igjen i KNX-importen.

Felt for KNX

• DPT: Dataformatet Evolo forventer fra KNX-systemet.

• Group Address: Gruppeadressen som brukes for å lese data fra KNX.

• Log-Type: Velg Standard eller Accumulating.

• Log-Interval: Påkrevd hvis du har valgt log-type. Mulige valg er OneMinute, FiveMinute og Event.

• Supports-Read: Gjør at Evolo kan sende en leseforespørsel til gruppeadressen hvis det ikke finnes oppdatert verdi på bussen. Dette bør bare brukes hvis funksjonen er støttet og aktivert i ETS.

Viktig å vite om logging for KNX

Log-Interval bør settes ut fra at KNX er en hendelsesbasert buss.

• Event er som regel riktig valg for KNX.

• OneMinute eller FiveMinute kan brukes hvis du har behov for fast intervall, men dette er vanligvis ikke nødvendig.

Modbus

For Modbus bruker du Excel-mal og fyller inn adresse og tekniske parametere for hvert datapunkt.

Støttede funksjonskoder er FC01, FC02, FC03 og FC04.
Skriveforespørsler for FC01 og FC03 velges automatisk av systemet.

Felt for Modbus

• Datatype: Forteller hvordan dataene skal dekodes, for eksempel INT16, BOOL eller FLOAT32.

• Function Code: Funksjonskoden som skal brukes i forespørselen.

• Address: Adressen til Modbus-registeret, 0-basert og uten prefiks. Står det for eksempel 1x0001 eller 40001 i dokumentasjonen til enheten, skriver du 0.

• Querysize: Brukes for bool med FC3 og FC4. Angir størrelse på minneområdet, 16, 32 eller 64.

• Bitnumber: Brukes for bool med FC3 og FC4.

• Weight: Skalerer mottatt verdi.

• Log-Type: Standard eller Accumulating.

• Log-Interval: Påkrevd hvis du har valgt log-type. OneMinute, FiveMinute eller Event

Viktig å vite om logging for Modbus

Log-Interval bør settes ut fra at Modbus normalt leses med faste intervaller.

• OneMinute eller FiveMinute er som regel riktig valg for Modbus.

• Event bør bare brukes ved behov.

Ved Event leser gatewayen datapunktet hvert andre sekund. Det kan gi høy oppløsning, men også mer trafikk og belastning.

MQTT

For MQTT bruker du Excel-mal og fyller inn topic og eventuelle uttrykk for behandling av innkommende og utgående meldinger.

Felt for MQTT

• QOS: Tjenestekvalitet for MQTT, 0, 1 eller 2.

• Topic: Adressen til datapunktet.

• Bool: Valgfritt. Angir om datapunktet er boolsk.

• Retain: Valgfritt. Angir om retain-flagg skal settes på utgående meldinger.

• Decimals: Valgfritt. Antall desimaler som vises som standard.

• Log-Type: Valgfritt. Standard eller Accumulating.

• Log-Interval: Valgfritt. OneMinute, FiveMinute eller Event.

Viktig å vite om logging for MQTT

Log-Interval bør settes ut fra hvordan meldinger kommer inn på topicen.

• Event er riktig når datapunktet oppdateres ved innkommende meldinger fra et eksternt system.

• OneMinute eller FiveMinute kan brukes hvis du ønsker logging i faste intervaller i stedet.

Ved Event logges datapunktet når det kommer nye meldinger.

BACnet

Import fra EDE-fil

Velg BACnet .EDE fil under Excel Import og last opp EDE-filen. Evolo gjør den om til et Excel-ark i riktig format, med bare støttede objekter. Gå gjennom arket, og importer det med BACnet.

Felt for BACnet

• Object Name: Valgfritt. Navnet objektet har i BACnet-enheten. Konverteringen fra EDE fyller det inn.

• Object Type: Objekt-typen i BACnet-enheten.

• Instance Number: Adressen til datapunktet i BACnet-enheten.

• Property Type: Bruk Present value, også for tidsskjemaer (Schedule) og kalendere (Calendar). Rader med Exception schedule eller Effective period blir hoppet over.

• Log-Type: Valgfritt. Standard eller Accumulating.

• Log-Interval: Påkrevd hvis du har valgt log-type. OneMinute, FiveMinute eller Event.

• Priority: Valgfritt. Prioriteten Evolo skriver med: 3, 4 eller 7 til 16. Standard er 16.

• Trend object: Valgfritt. Trendobjektet Evolo fyller loggen fra etter et kommunikasjonsbrudd, for eksempel TL 12 (Trend Log 12) eller TLM 3:2 (kanal 2 i Trend Log Multiple 3). Tom celle fjerner koblingen.

• Trend interface: Valgfritt. Navnet på BACnet-grensesnittet trendobjektet ligger på. Tom celle betyr datapunktets eget grensesnitt.

Støttede objekt-typer i BACnet-import

Importen støtter Analog, Binary og Multistate (input, output og value), Accumulator, Pulse converter, Integer value, Large analog value, Positive integer value, Schedule (tidsskjema) og Calendar (kalender).

Viktig å vite om logging for BACnet

Bruk Event bare hvis enheten støtter subscribeCOV. Ellers velger du OneMinute eller FiveMinute. Se Optimaliser BACnet med subscribeCOV og polling.

OPC UA

Ark fra OPC UA-klienten

Last ned Excel i OPC UA-klienten gir et ferdig utfylt ark med variablene i en mappe eller på hele serveren. For en server i Evolo kan du importere det direkte med OPC UA.

Felt for OPC UA

• Node ID: Noden på serveren, på formen nsu=<namespace-URI>;s=<navn> eller ns=<indeks>;s=<navn> (også i=, g= eller b=). Bruk nsu= der du kan, fordi indeksen kan endre seg.

• Attribute ID: Alltid Value.

• Datatype: En av Boolean, SByte, Byte, Int16, Int32, Int64, Uint16, Uint32, Uint64, Float eller Double.

• State Texts: Valgfritt. Tilstandstekstene som JSON, for eksempel [{"value": 0, "display_name": "Av"}].

• Decimals: Valgfritt. Antall desimaler som vises som standard.

• Log-Type: Valgfritt. Standard eller Accumulating.

• Log-Interval: Påkrevd hvis du har valgt log-type. OneMinute, FiveMinute eller Event.

Viktig å vite om logging for OPC UA

Log-Interval bør settes ut fra hvordan datapunktet oppdateres på OPC UA-serveren.

• Bruk Event hvis serveren sender endringene selv.

• Bruk OneMinute eller FiveMinute hvis datapunktet bør leses med faste intervaller.