Fagstoff

Interaktivt innhold

Oppsett på nettsida

I Deploii setter du opp kort, datastrømmer, måleserier og kontrollpanel for å samle inn og styre data. Her viser vi steg for steg hvordan du registrerer kortet ditt, oppretter datastrømmer og bygger et kontrollpanel – med eksempelkode og bilder som støtte.

Kontrollpanel

I det interaktive bildet under kan du gå inn i de ulike modulene på kontrollpanelet og lese mer om dem.

Oppsett av nettsida

Gjennom de neste stega skal du sette opp alt det som er nødvendig for at Deploii skal fungere. Denne delen av brukerveiledninga er støtta av bilder og kodesnutter som tar deg gjennom de ulike stega.

Mine kort

Det første Deploii må vite for at nettsida skal kunne kommunisere med kortet ditt, er hvilket kort du vil kommunisere med, og hvordan.

Naviger til sida "Mine Kort" som vist i bildet under, og velg "Nytt kort".
Gå gjennom de forskjellige stega og legg inn all nødvendig informasjon.

I løpet av prosessen kan du møte på innstillinger som er skjult under en "Avansert"-knapp, disse kan du trygt velge å ignorere inntil videre.

Skjermbilde fra fanen Mine kort i programvaren Deploii med teksten Oi, du har ingen kort enda og en knapp for å legge til nytt kort. Skjermutklipp. — Hvis du ikke har registrert noen mikrokontrollerkort i systemet, vil du se dette skjermbildet. Velg "Nytt kort" for å registrere mikrokontrollerene dine.

På bildet under ser du hvordan det kan se ut etter at du har satt opp et kort. I dette tilfellet viser nettsida at vi har satt opp en Arduino UNO R4 Wi-Fi. Hvis du har et annet kort, må du velge det istedenfor.

Det er et par ting det er verdt å legge merke til i dette bildet.

Først står kortets tilkoplingsstatus. For deg vil det trolig stå "Frakoblet", som i eksempelet vårt. Du må laste opp en kode til kortet før kortet kan koples til. Denne koden finner du ved å trykke på "Koble til"-knappen på sida.
Hvis du har satt opp flere kort, kan du velge disse i nedtrekksmenyen i øvre venstre hjørne (der det står "Arduino Wi-Fi" i bildet). Du kan også se hvilke datastrømmer og kontrollpaneler som bruker kortet ditt, på kort-sida, når dette er ferdig programmert.

Skjermbilde av fanen Mine kort i programvaren Deploii. I en nedtrekksmeny er Arduino Wi-Fi valgt, og informasjon om dette kortet er vist på sida. For status er det det et rødt felt merket Frakoblet, og det er en knapp med teksten Koble til. Skjermutklipp. — Her ser du hvordan nettsida kan se ut når du har valgt kort. Ser du hvilket kort som er valgt her? Klarer du også å se om kortet er aktivt eller ikke?

Datainnsamling: datastrøm

Etter at du har satt opp et kort, må du fortelle Deploii hva slags data du ønsker å sende. Dette gjør du ved å opprette en datastrøm. Velg "Opprett ny datastrøm"-knappen under fanen for Datainnsamling.

Skjermbilde fra fanen Datainnsamling i programvaren Deploii som beskriver hvordan datastrømmer kan opprettes, enten som en datastrøm å sende dataene med eller som en måleserie for å lagre dataene. Under de to valgene er det en knapp for å opprette ny datastrøm. Skjermutklipp. — Slik vil datainnsamlingssida se ut hvis du ikke har oppretta noen datastrøm. Hva tror du knappen "Opprett ny datastrøm" kan brukes til?

Her er det bare obligatorisk å fylle inn ett felt, nemlig navnet på datastrømmen. Når du fyller inn navnet, vil det automatisk bli laga en datastrøm-ID, og denne må du legge i koden din.

ID-en finner du ved å velge "Avansert"-knappen, vist i bildet under. Datastrøm-ID-en genereres automatisk ved å konvertere alle store bokstaver til små, alle mellomrom til understreker og til slutt kvitte seg med spesialsymboler (og bokstavene æ, ø og å, siden disse ikke støttes i Arduino IDE når vi skal kode seinere).

Skjermbilde fra programvaren Deploii for oppretting av en datastrøm med navn og ID. Navn er Temperatur 1 med stor T og mellomrom mellom ord og tall, mens ID er samme tekst med liten forbokstav og liggende strek mellom ord og tall. Det er en nedtrekksmeny for valg av ikon og knappene Avbryt og Fullfør. Skjermutklipp. — Her kan du gi datastrømmen din et navn, så genererer programvaren en egen ID for datastrømmen.

Til slutt kan du velge en kategori for datastrømmen, gjerne basert på hvilke type data du planlegger å sende, for eksempel temperatur-data eller trykk-data. Dette vil gi datastrømmen et ikon som brukes på nettsida, slik at det er lettere å kjenne igjen det som måles.

Skjermbilde fra programvaren Deploii som viser en nedtrekksmeny med ulike ikoner som kan velges for ulike kategorier, som vanndråpe for fukt, termometer for temperatur og to piler mot hverandre med en strek imellom for trykk. Skjermutklipp. — Programvaren har noen ferdige ikoner som kan brukes, slik at du enklere kan gjenkjenne måleverdier og datastrømmer.

Etter du har satt opp et par datastrømmer, kan nettsida se ut som i det interaktive bildet under. Velger du tannhjul-knappen i øvre høyre hjørne av en datastrøm, vil du finne eksempelkode for å sende data fra kortet til den. Legg merke til at det ikke er noen tall i navnene på datastrømmene her, slikt det var i bildene over.

Gi datastrømmene egne navn

Du står fritt til å kalle datastrømmene det du vil, som bildene over viser. Generelt er det anbefalt å legge til tall i navna på datastrømmene hvis du har datastrømmer som har liknende navn / måler det samme, for eksempel tre forskjellige temperatursensorer på samme kort, hvis du vil sammenlikne data fra sensorene.

Datainnsamling: måleserie

Nå som datastrømmene er satt opp, kan de brukes på to forskjellige måter: enten i en måleserie eller på kontrollpanelet. Er du mest interessert i å lagre dataene for nedlasting, er dette delen for deg, mens hvis du er mest interessert i å observere data i sanntid, kan du hoppe rett til delen om kontrollpanel.

Måleserier kan bestå av en eller flere datastrømmer, alt avhengig av hva du ønsker å lagre, og når. Hvis du setter opp en måleserie med for eksempel tre separate datastrømmer, vil Deploii lagre all innkommende data fra disse tre datastrømmene.

Det er imidlertid viktig å presisere at siden Deploii ikke kan kontrollere når de forskjellige datastrømmene mottas (det gjør kortet ditt), kan ikke en måleserie lagre de tre datastrømmene synkront. Dette fører til at hver datastrøm vil lagres separat med et eget tidsstempel, slik at når du laster ned måleserien, får du tre forskjellige filer, en for hver datastrøm.

Hvis du vil at alle dataene skal havne i samme fil, med samme tidsstempel, må du sette opp måleserien med bare én datastrøm og sende en array (liste) med data til denne måleserien. Dette gjør at Deploii alltid vil motta alle dataene samtidig, siden arrayen regnes som én datastrøm som inneholder flere datapunkter.

Slik ser sida ut når den er tom for måleserier.

Skjermbilde fra fanen Datainnsamling i programvaren Deploii som viser at det ikke er registrert noen måleserier. Skjermutklipp. — Slik ser skjermbildet ut hvis du ikke har lagra noen måleserier. Velg "Ny måleserie" for å opprette en måleserie.

Opprette måleserie: tidsstyrt

Etter du har valgt "Ny måleserie", vil du først bli bedt om et navn på måleserien og å velge hvilke datastrømmer den skal hente data fra. I motsetning til for datastrømmer har ikke navnet på måleserier noe å si for hva som må skrives i koden, så du kan gi den et mer beskrivende navn, for eksempel med uketall eller måned, uten at dette må inn i koden.

Skjermbilde fra programvaren Deploii som viser registrering av en måleserie. Det er et felt for å skrive inn navn og et felt hvor man kan velge blant datastrømmene Temperatur, Fukt og Trykk. Skjermutklipp. — Når du skal opprette en måleserie, må du skrive hva måleserien skal hete, og velge hvilke datastrømmer det skal lagres data fra.

Deretter må du bestemme om varigheten av måleserien skal bestemmes ut fra tidsrom eller et bestemt antall målepunkter. Velger du tidsrom, blir du bedt om en start og en slutt, du må sette både dato og klokkeslett. Dette forteller Deploii at alle dataene innenfor start og slutt skal lagres.

Vær forsiktig, dette kan bli en stor datamengde ...

Skjermbilde av et utfyllingsskjema for varighet i programvaren Deploii. Det er valgt tidsrom i stedet for punkter og deretter start- og sluttidspunkter fra kalender- og klokkefunksjoner. Skjermutklipp. — Her er det valgt å samle data i en måleserie definert av et tidsrom. Her samles data i ett døgn, fra 06.07.2025 kl. 18:59 til 07.07.2025 kl. 18:59.

Hvis du ønsker å ta en måleserie over et lengre tidsspenn, kan det i noen tilfeller være ønskelig å ikke lagre data hver dag. Derfor kan du sette opp en rutine / et filter som dropper visse ukedager.

Skjermbilde av et utfyllingsskjema for varighet i programvaren Deploii som viser valget Rutine med mulighet for å velge start- og sluttintervall og enkelte ukedager. Skjermutklipp. — I Deploii kan du også velge å samle data over spesifikke tidspunkt, for eksempel hver mandag og onsdag.

Opprette måleserie: datapunktstyrt

Hvis det ikke er viktig for deg akkurat når data lagres, men heller hvor mye data som lagres, kan du i stedet velge et maksimalt antall punkter. Da vil Deploii lagre måledata opptil antallet du skriver inn her. Det er en begrensing på 5 000 punkter for hver enkelt måleserie (både ved tidsrom og punkter).

Skjermbilde av et utfyllingsskjema for varighet i programvaren Deploii. Det er valgt punkter i stedet for tidsrom, og i et felt for hvor mange punkter som skal måles, er det angitt 1000. Skjermutklipp. — Du kan velge antall målepunkter som skal lagres, som et alternativ til tidsramme. Hvor lang periode dette samles inn over, kommer an på hvor ofte du har programmert mikrokontrolleren til å sende data.

Aktivering av måleserie

Trykker du "Fullfør", er måleserien satt opp. Når den begynner å motta data, vil statusen gå til aktiv som i bildet under, og de nyligste dataene blir oppsummert. "Se mer"-knappen viser mer info.

Skjermbilde fra programvaren Deploii som viser at det er opprettet en måleserie som heter Miljøstasjon, Adrian, uke 27. Status er vist med teksten Aktiv i en grønn knapp. Nederst er det en knapp merket Se mer. Skjermutklipp. — Når du har registrert en måleserie, vil denne vises på Deploiis kontrollpanel. Det vises også om måleserien er aktiv (henter data) eller er inaktiv.

Her kan du se grafen/dataene i større detalj og zoome inn og ut (førstnevnte er svært nyttig ved lagring av mange datapunkter). Hvis du bruker musa og flytter den over en av linjegrafene, vil du kunne se enkeltpunkter og tida dette punktet ble målt.

Trykker du på et av navna under grafen, for eksempel "Temperatur", kan du skjule denne ene grafen.

Skjermbilde fra programvaren Deploii som viser tre grafer, for temperatur, fukt og trykk. Til høyre for grafene er det annen informasjon, som status, målepunkter, tidsrom, en nedtrekksmeny for å laste ned målinger og en rød knapp merket Slett. Skjermutklipp. — Her ser du visning av en måleserie. Du ser om måleserien er aktiv, hvor mange punkter som er samla inn, og du kan laste ned måleserien.

Nedlasting av data

Når du ønsker å laste ned dataene, velger du "Last ned målinger". Her får du alternativer for filtrering av data, og du kan bestemme filtypen. Hver fil vil hete det samme som datastrømmen og være stempla med nedlastingstid.

OBS!

Merk at data bare blir oppbevart i 90 dager fra lagringstidspunktet.

Skjermbilde fra programvaren Deploii som viser tre grafer, for temperatur, fukt og trykk. Til høyre er menyen for å laste ned målinger utvida, og man kan velge hvilken av de tre målingene som skal lastes ned, om det skal være punkter, tidsrom eller intervaller, og hvilken filtype man vil ha. Det er en egen knapp som heter Last ned. Skjermutklipp. — Når måleserien er ferdig, kan du laste ned. Du kan velge hvilke datastrømmer som skal være med, og du kan velge hvilket format dataene skal lastes ned i.

Kontrollpanel

Nå som du har satt opp den tekniske strukturen, er det på tide å bygge et kontrollpanel der du kan visualisere data på ulike måter.

Gå til fanen "Kontrollpanel", og du vil finne sida som vist i bildene under. Sida består sannsynligvis av seks tomme bokser, siden du ikke har satt opp noe ennå.

Du kan nå legge til et nytt kontrollpanel og gi det det navnet du ønsker.

Skjermbilde fra programvaren Deploii som viser en knapp for å opprette et kontrollpanel. Skjermutklipp. — Du kan selv velge hvordan kontrollpanelet i Deploii skal være utforma. Når du velger "Nytt kontrollpanel", vil det åpnes ei ny nettside med seks tomme modulplasser.

Skjermbilde fra programvaren Deploii som viser seks tomme felt. I en nedtrekksmeny er det valgt Adrians miljøstasjon, i et gult felt ved siden av står det 0 kort tilkoblet. Ved siden av de tomme feltene er det en knapp med pluss-symbol. Skjermutklipp. — På denne nettsida kan du legge til ulike moduler for å vise datastrømmene. Dette gjør du ved å velge pluss-knappen.

For å vise måledataene dine må du sette opp en eller flere moduler i kontrollpanelet.

Først lager du en graf ved å velge pluss-knappen nederst til høyre. Gi modulen et navn, og velg "Fortsett". Velg så hvilke datastrømmer grafen skal vise (maks tre). Disse kan være fra ulike kort, hvis du ønsker det.

Skjermbilde fra programvaren Deploii som viser et skrivefelt for Modulnavn, hvor det er skrevet Miljøstasjon graf. Skjermutklipp. — Du må gi de elementene du skal legge på kontrollpanelet, et navn. Her er det valgt et element i form av en graf, som får navnet "Miljøstasjon graf".

Skjermbilde fra programvaren Deploii som viser ei liste med elementer som kan vises i en graf. Tre av disse er haket av i bokser ved navnet på datastrømmene. Skjermutklipp. — Når du oppretter et element, kan du velge hvilke datastrømmer som skal vises. Her er det valgt å vise Temperatur, Fukt og Trykk i grafen, altså tre grafer i samme bilde.

Det siste du må bestemme, er hvor på kontrollpanelet modulen skal plasseres. I dette tilfellet velges plass 2, som er i midten øverst. Som du kan se fra bildet, kan det bare være seks moduler per kontrollpanel. Du kan imidlertid lage flere kontrollpaneler.

Skjermbilde fra programvaren Deploii som viser seks firkanter nummerert fra en til seks. Plass 2, midt på øverste linje, er markert. Skjermutklipp. — Alle moduler du legger til, må få en definert plass på kontrollpanelet. Her kan du velge plassering.

Du kan nå legge til flere moduler på kontrollpanelet, bare prøv deg litt fram med de ulike modultypene.

Når du har bestemt deg for hvilke datastrømmer du vil presentere i kontrollpanelet, hvordan de skal presenteres, og hvor de skal plasseres, kan kontrollpanelet bli seende ut som i dette eksempelet:

Skjermbilde av kontrollpanel i programvaren Deploii. Øverst til venstre Miljøstasjon styring med tastaturnavigasjon, øverst i midten Miljøstasjon graf med tre grafer, øverst til høyre Miljøstasjon logg med ei liste målinger, nederst til venstre Temperatur med gradestokkikon og temperaturmåling 19 grader, nederst i midten Fukt med vanndråpeikon og fuktmåling 40 % RH, nederst til høyre Trykk med trykkikon og trykkmåling 98 kPA. Skjermutklipp. — Her ser du hvordan et kontrollpanel kan se ut, med grafer, tallvisning, listevisning og knapper for å styre mikrokontrolleren.

Tastaturstyring av mikrokontroller

Ved å bruke tastaturmodulen kan du bruke Deploii til å styre kortet ditt fra kontrollpanelet. Dette fungerer ved at hver modul som kan sende data til kortet, får en modul-ID (du kan se på dette som en datastrøm i motsatt retning, selv om datastrømmer er mer tiltenkt måledata enn instrukser).

Hver gang du for eksempel trykker på en knapp på kontrollpanelet, sendes denne ID-en sammen med en instruks til kortet ditt. Slik kan du samtidig sette opp flere moduler som tilbyr ulik funksjonalitet. Tastaturmodulen er en av modulene som (bare) kan brukes til styring, og den er vist øverst til venstre i bildet over.

Opprette tastaturmodul

Når du setter opp denne modulen, som i bildet under, gir du den først et navn. Basert på dette navnet blir det laga en modul-ID. Dette foregår på akkurat samme måte som når det lages en datastrøm-ID (alt blir til små bokstaver, mellomrom erstattes av understreker, og spesielle symboler og æ, ø og å erstattes/fjernes).

Du må også velge hvilket kort instruksene skal sendes til. I bildet under er det valgt samme Arduino som i tidligere deler av denne veiledninga.

Skjermbilde fra programvaren Deploii som viser oppretting av et kontrolltastatur. Det er en tekstboks for å skrive modulnavn i, der står det Miljøstasjon styring, og en nedtrekksmeny for å velge kort du vil sende kommandoer til. Under er det en boks med modul-ID hvor modulnavnet er gjentatt, men skrevet med små bokstaver og med liggende strek i stedet for mellomrom. Der er det valgt Arduino Wi-Fi. Skjermutklipp. — Du kan opprette styringsknapper for å styre en mikrokontroller, for eksempel til å slå et lys av eller på. Du må gi tastaturmodulen et navn og velge hvilken mikrokontroller du skal sende dataene til.

Etter du har satt opp en modul for styring, må du legge inn kode på kortet ditt for å motta, lese av og reagere på disse instruksene. Som ved datastrømmer tilbyr Deploii eksempelkode integrert rett inn i nettsida. Bare velg "Mer"-knappen i modulen, så vil du finne et alternativ for å se eksempelkoden for modulen din.

Bruker du ulike moduler, vil du se at hva slags instrukser du kan sende, varierer. Noen moduler vil ha forhåndsinnstilte instrukser, som "w_down" og "w_up", mens ved andre moduler kan du lage dine egne instrukser. Det finnes moduler som kan både ta inn datastrømmer og sende ut instrukser samtidig.

Modultyper

I denne brukerveiledninga har vi ikke gått gjennom alle ulike modultyper, men lagt opp til at du skal kunne prøve deg fram litt på egen hånd. Det er med vilje, for dette skal være en overordna introduksjon.

Kodegenerator (eksempelkode)

Deploii er sikkert noe helt nytt for mange, og det kan være mye å lære på en gang. I tillegg er det ikke slik at alle som har bruk for Deploii, nødvendigvis trenger å lære mye om koding. Noen ganger holder det å redigere litt kode for å få nødvendig forståelse.

Derfor kommer Deploii med en innebygget kodegenerator som lager eksempelkode for deg, basert på det du forteller nettsida underveis i oppsettet. Koden du får, er fullstendig fra Deploiis side, det betyr at du ikke trenger mer enn dette for at Deploii skal ta imot/sende data.

Deploii kan (foreløpig) ikke gi deg kode for dine spesifikke sensorer eller annet elektronisk utstyr, som en servomotor.

Kodegeneratoren finner du på alle hovedsider, altså "Mine kort", "Datainnsamling" og "Kontrollpanel".

Eksempelkoder

Hver side vil gi deg litt forskjellig eksempelkode. Under "Mine kort" vil du foreløpig finne kode for å kople kortet til Deploii. Denne er bare ment for å teste at du har gjort alt riktig i installasjon og oppsett. Hvis du har gjort det, vil kortet stå som "Tilkoblet" på samme side etter du har lasta opp koden.

Under "Datainnsamling", på sida med datastrømmer, vil du finne eksempelkode for å sende data til en datastrøm. Denne koden er ment som et generelt eksempel på sending av data. Hver modul på kontrollpanelet vil kunne bruke disse dataene.

Likevel er det nok best å hente eksempelkoden direkte fra kontrollpanelsida hvis du vil bruke kortet her. Da får du kode spesifikk for hver modul. Hvis du for eksempel har lagt inn tre datastrømmer i en graf-modul, vil du få kode som bruker alle tre datastrømmene, og ikke bare en. Kontrollpanelsida vil også gi deg eksempelkode for hvordan du sender data til kortet fra Deploii, slik kan du styre for eksempel et lys.

Skjermbilde fra programvaren Deploii som viser en programmeringskode som er hentet ved å velge tannhjul-knappen på modulen Miljøstasjon logg. Skjermutklipp. — Deploii kan gi deg ferdige koder for kommunikasjon med mikrokontrollere. Du kan bruke disse kodene som et utgangspunkt for programmering av mikrokontrolleren din.

Over kan du se eksempelkode generert for Terminal-/Logg-modulen. Denne kan både ta imot data fra kortet og sende data til kortet, noe som er vist i eksempelkoden. Du finner kodegeneratoren på kontrollpanelsida ved å velge tannhjul-knappen i øvre høyre hjørne på enhver modul.