Implementation of APIs in Building Automation Systems

Abstract

This Bachelor’s thesis was commissioned by ATN Automation in Vaasa, Finland. The thesis comprises instructions and a script program for retrieving and implementing weather data from APIs, supporting XML documents, in building automation system. The script can easily be programmed to retrieve various weather data information from the past, the real-time weather and future forecasts. The software that is used for this is Schneider Electrics StruxureWare Building Operation Workstation. The purpose with the thesis is to create a Real World Input for implementing information from the Internet to building automation system. The main fields of information the company wanted me to research in was information concerning weather data and power consumption. The real world information should then be available, e.g. in a table, for employees to use for programming. The result is a script program that easily can be improved and further developed to retrieve more information from similar and other sources. The script was merged into SBO on the company’s local server and a table of real-world inputs is available for use in building automation system programming.

Detta examensarbete var gjort åt ATN Automation i Vasa, Finland. Examensarbetet omfattar instruktioner och ett skriptprogram för att hämta och implementera väderdata från API:er, som stöder XML dokument, i fastighetsautomationssystem. Programmet kan lätt omprogrammeras till att hämta olika sorters information om väderdata som har varit, i realtid och framtida väderprognoser. Mjukvaran jag har använt mig av är StruxureWare Building Operation Workstation av Schneider Electric. Syftet med detta examensarbete var att skapa en Real World Input för implementering av information från Internet i fastighetsautomationssystem. De områden som företaget ville att jag skulle forska i var information beträffande väderdata, och elpriser och energiförbrukning. Real World informationen skall sedan vara tillgängliga, t.ex. i en tabell, för de anställda att använda i sin programmering. Resultatet är ett skriptprogram som enkelt kan användas, förbättras och vidareutvecklas för att hämta mera information från liknande eller andra källor. Programmet implementerades i SBO mjukvaran i företagets lokala server och en tabell bestående av de i detta skede tillgängliga real world data finns nu att användas i programmeringen för automationssystem.

Tämä opinnäytetyö on tehty ATN Automaatiolle, joka sijaitsee Vaasassa. Opinnäytetyö sisältää käyttöohjeet ja script ohjelman, jolla on haettu ja toteutettu säätietoja API:stä, jotka tukevat XML dokumentteja, kiinteistöautomaatiohjelmoinnissa. Ohjelma voidaan helposti ohjelmoida uudestaan saadakseen erilaisia tietoja: historiallisia säätietoja, reaaliaikaisia säätietoja sekä tulevaisuuden ennusteita. Ohjelmistona olen käyttänyt StruxureWare Building Operation Workstationia, joka on Schneider Electricin tekemä. Opinnäytetyön tarkoituksena oli muodostaa Real World Input Internet tietojen toteutusta varten kiinteistöautomaatiojärjestelmässä. Säädata, sähköhinnat ja energiankulutus olivat tutkimuksen aiheena. Real World informaation pitää olla työntekijälle saatavilla ohjelmoinnissa, esim. taulukoiden muodossa. Tulos on script ohjelma, jota voi helposti käyttää, parantaa ja jatkuvasti kehittää, jotta saataisiin lisää informaatiota vastaavanlaisista lähteistä. Ohjelma toteutettiin SBO ohjelmistossa yrityksen paikallisilla servereillä. Lisäksi laadittiin taulukko, jossa historialliset, nykyaikaiset sekä ennustetut arvot näkyvät.