Metsää puilta

Metsävaramittaus kunnostamattomissa metsissä -projektin verkkoblogi

Jyväskylän ammattikorkeakoulun julkaisuja 180: Uusia menetelmiä metsävaratietojen hyödyntämiseen

Julkaisun esittely

Metsien inventoinnissa ollaan siirtymässä entistä vahvemmin kaukokartoituspohjaisiin menetelmiin, kuten laserkeilaukseen.

Kanagawa

Lataa ilmainen julkaisu tästä

Haasteellisia ja tärkeitä inventointikohteita ovat mm. tiheät ja kunnostamattomat nuoret metsät, joissa optisin menetelmin tuotettu puustotieto ei ole tarpeeksi tarkkaa.

Euroopan maaseuturahaston osarahoittaman ”Metsävaramittaus kunnostamattomissa metsissä 2011–2014”-projektin tarkoituksena on ollut metsävaratietojen mittaamisen ja hyödyntämisen kehittäminen erityisesti kunnostamattomissa metsissä energiapuun korjuun tarpeisiin siten, että koealamittauksilla ja lentokeilauksella kartoitetut metsävaratiedot täydentävät toisiaan kehittyneillä menetelmillä. Metsänhoitoyhdistysten sekä metsänomistajien näkökulmasta puolestaan keskeistä on ollut kehittää työkalu korjuutyön määrän ja työvaikeuden arvioimiseksi työlajeittain.

Tässä raportissa olemme koonneet projektin tulokset laseraineiston suoratulkintamenetelmän sekä JokaMies-mobiilisovelluksen kehitystyöstä.

Sarja: Jyväskylän ammattikorkeakoulun julkaisuja 180
Koulutusyksikkö: Teknologiayksikkö
ISSN-L: 1456-2332
ISBN: 978-951-830-335-3 (Painettu)
ISBN: 978-951-830-336-0 (PDF)
Julkaisuvuosi: 2014
Laajuus: 81 s.
Hinta: –

Kommentit pois päältä artikkelissa Jyväskylän ammattikorkeakoulun julkaisuja 180: Uusia menetelmiä metsävaratietojen hyödyntämiseen

Masser Sonar Caliperin suuntapoikkeamien jälkikorjaus

Kirjoittaja: Taisto Kuikka, 2014

Taustatietoa

Metsävaramittaus kunnostamattomissa metsissä -yhteisprojektin yhteydessä mitattiin hoitotarpeessa olevia nuoria metsäpalstoja. Projektin tarkoituksena oli kehittää ja tutkia uusia menetelmiä, joilla metsänomistajat ja metsäalan ammattilaiset voivat arvioida hoitotarvetta. Vertailukohdaksi otettiin Masser Sonar Caliper -mittalaitteella tehtävillä mittauksilla koostettavat puukartat. Masser Oy:n Sonar Caliper on monisensorinen inventointityökalu, jolla voidaan mitata läpimittasarjat, puiden pituuskäyrät, puukartat ja laadutukset. Sonar Caliperissa on sisäänrakennettu kompassi, joka voidaan kalibroida mittaajan ja hänen varusteiden vaikutusten eliminoimiseksi. Mittalaitteen ilmoittama suuntakulma ilmoitetaan kuitenkin ilman eranto- eli deklinaatiokorjausta. (Sonar – Masser).

Metsäpalstoilla mitattiin kaikkien yli 4 cm halkaisijaltaan olevien puiden läpimitta, kulma ja etäisyys koealan keskipisteestä, sekä merkittiin puulaji ja mitattiin otanta puiden pituuksista. Koska yksittäisen metsäpalstan sisälle muodostui useita koealoja, näiden tiedot yhdistettiin jälkikäteen. Koealojen yhteensovittamiseksi valittiin koealojen rajoilla olevista puista yhteisiä puita, jotka otettiin mukaan kahteen tai kolmeen koealaan. Koealojen sovittamisen yhteydessä havaittiin tarpeelliseksi korjata mittaustulosten kulmavirhe.

Koordinaatistot ja virhelähteet

Projektiot

Suomessa Maanmittauslaitos otti käyttöön uuden koordinaattijärjestelmän ETRS89 ja sen kanssa käytettävät tasoprojektiot ETRS-TM35FIN ja ETRS-GKn vuonna 2010. Näistä ETRS-TM35FIN on valtakunnallinen projektio ja ETRS-GKn -projektioita voidaan käyttää paikallisesti esimerkiksi kaavoitus- ja rakentamistoimintaan. ETRS-TM35FIN käyttää yhtä levennettyä TM35-projektiokaistaa mikä eroaa eurooppalaisesta normista, mistä kertoo pääte FIN. ETRS-GKn ovat kapeakaistaisia projektioita, joissa n kertoo keskimeridiaanin asteluvun, ja on välillä 19–31. (JHS 154, 2008) Kuvattaessa maan ellipsoidipinta tasolle on pintaa venytettävä. Tällöin syntyy mittakaava- ja suuntavirhettä eli projektiovirheitä. Lisäksi kompassilla suuntaa mitattaessa suuntavirheeseen vaikuttaa deklinaatio. Kompassiin voivat vaikuttaa myös paikalliset magneettiset anomaliat eli häiriöt magneettikentässä.

Deklinaatio

Maantieteellinen pohjoissuunta eroaa magneettisesta pohjoissuunnasta, ja ero vaihtelee ajan myötä, kun magneettisten napojen sijainti muuttuu. Pohjoisen magneettinavan sijainti liikkuu vuosittain 30-40 km, eteläisen vähemmän. Suuntien välistä kulmaa kutsutaan erannoksi. Suomessa eranto eli magneettinen deklinaatio vaihtelee välillä 4°-14° maan eri osissa. Kuvassa 1 on vuoden 2013 deklinaatiokartta Ilmatieteen laitoksen sivuilta. (Magneettiset navat ja kentän hitaat muutokset)
deklinaatiokartta_iso

Kuva 1. Suomen eranto- eli deklinaatiokartta vuodelta 2013 (Magneettiset navat ja kentän hitaat muutokset)

Meridiaanikonvergenssi

Karttapohjoisen ja napapohjoisen välistä kulmaa kutsutaan meridiaanikonvergenssiksi. Se on positiivinen keskimeridiaanin itäpuolella ja negatiivinen länsipuolella. Siirryttäessä kauemmaksi keskimeridiaanista kulmavirhe kasvaa. ETRS-TM35FIN-projektiokaistalla virhe kasvaa suuremmaksi kuin kapeilla ETRS-GKn-kaistoilla. Myös maantieteelliset navat liikkuvat hieman, mutta ETRS89-koordinaattijärjestelmässä napojen sijainti on kiinnitetty. (JHS 154, 2008)

Suuntapoikkeamien korjaus

Karttapohjoisen, magneettisen pohjoissuunnan ja napapohjoisen välisten erojen aiheuttama virhe voidaan korjata lisäämällä tai vähentämällä suuntien välinen kulma riippuen siitä, korjataanko suuntaa kartalta maastoon vai päinvastoin. Neulalukukorjaus Nek eli eranto on napapohjoisen ja magneettisen pohjoissuunnan välinen kulma. Napalukukorjaus Nak on napapohjoisen ja karttapohjoisen välinen kulma, joka on itseisarvoltaan yhtä suuri kuin meridiaanikonvergenssi, mutta vastakkaismerkkinen. Kokonaiskorjaus Kok saadaan laskemalla Nak ja Nek yhteen.

Kanadan luonnonvaraministeriön sivuilla oleva laskin antaa Lapinmäen metsäpalstalle mittausajankohtana syksyllä 2012 deklinaatioksi 8° 19′ eli noin 8,3167° (Magnetic declination calculator). Napalukukorjaus voidaan laskea geodeettisten koordinaattien avulla kaavoilla 1-5 (JHS 154, 2008).

kaava_1

Kaavoissa (φ, λ) ovat geodeettiset koordinaatit, λ0 on projektion keskimeridiaani ja f on ellipsoidin litistyssuhde 1/298,257223563. Apumuuttujina on lisäksi käytetty ensimmäisen epäkeskisyyden neliötä e2 ja toisen epäkeskisyyden neliötä e’2. Tuloksena on meridiaanikonvergenssi γ. Käyttäen koordinaatteja (62,409334°, 24,131680°) napaluvuksi saadaan

kaava_2

ja kokonaiskorjaukseksi saadaan Kok = Nak + Nek = –γ + δ = 4,0441° + 8,3167° ≈ 12,4°.

Tulokset

Kuvassa 2 on Keuruun Lapinmäessä sijaitsevan metsäpalstan puukartta ennen korjausta ja kuvassa 3 korjauksen jälkeen. Puukartat on luotu Gnuplot-ohjelmalla mittaustuloksia käyttäen. Koska mittalaite ei tallenna puiden koordinaatteja, vaan kulman ja etäisyyden suhteessa koealan keskipisteeseen, on puukarttaan laskettu koordinaatit käyttäen kaavoja 6 ja 7.

kaava_3

Edellä olevissa kaavoissa (Nk, Ek) ovat koealan keskipisteen koordinaatit, d on etäisyys koealan keskipisteestä senttimetreinä, α on mitattu kulma, δ on neulalukukorjaus ja γ on napalukukorjaus. Tuloksena on mitatun puun koordinaatit (Np, Ep). Metsäpalstan nurkat ja palstan sisällä olevien kahden koealan keskipisteiden koordinaatit määriteltiin tarkalla GPS-paikantimella.

lapinmaki_ennen_3

Kuva 2: Lapinmäen metsäpalstan puukartta ennen korjausta

lapinmaki_jalkeen_3

Kuva 3: Lapinmäen metsäpalstan puukartta korjauksen jälkeen

Johtopäätökset

Alkuperäisten mittaustulosten perusteella piirretyssä puukartassa eivät koealat sopineet yhteen. Ottamalla huomioon neulalukukorjaus sekä napalukukorjaus, Lapinmäen metsäpalstan koealat täsmäsivät hyvin toisiinsa ja muodostuneita puukarttoja käytettiin vertailupohjana laserkeilausaineistosta laskettavan mallin ja puusta-puuhun -menetelmän analysointiin. Virhemarginaalia puukartoissa kasvattivat Sonar Caliperin vain asteen tarkkuudella tallentama kulma, suurehkot koealakoot sekä siitä seurannut etäisyyden kasvaminen koealojen keskipisteistä.

Lähteet

JHS 154. 2008. ETRS89-järjestelmään liittyvät karttaprojektiot, tasokoordinaatistot ja karttalehtijako. Versio 6.6.2008. Viitattu 23.3.2014. http://www.jhs-suositukset.fi/suomi/jhs154.

Magneettiset navat ja kentän hitaat muutokset. Ilmatieteen laitos. Viitattu 20.3.2014. http://www.ilmatieteenlaitos.fi/maan-magneettikentan-synty.

Magnetic declination calculator. Natural Resources Canada. Viitattu 25.3.2014. http://geomag.nrcan.gc.ca/calc/mdcal-eng.php.

Sonar – Masser. Masser Oy. Viitattu 23.3.2014. http://www.masser.fi/fi/product-category/sonar/.

Kommentit pois päältä artikkelissa Masser Sonar Caliperin suuntapoikkeamien jälkikorjaus

JokaMies –mobiilisovellus omatoimiseen metsänmittaukseen

Metsät Suomessa

Suomen maapinta-alasta 75 prosenttia on metsää. Metsissä on noin 2300 kuutiometriä puuta ja puuston kasvu on 100 miljoonaa kuutiota vuodessa. Puustoa kaadetaan keskimäärin 68 miljoonaa kuutiota vuodessa, joka on alle 70 prosenttia vuotuisesta kasvusta. Hoitamatonta metsää on noin 5 miljoonaa hehtaaria, joka on noin 30% metsäalasta. 1,6 miljoonaa hehtaaria tästä alasta tarvitsee kiireellistä hoitoa.

Yksityisten henkilöiden omistuksessa Suomen metsistä on yli puolet, 52 prosenttia. Suomessa on Verohallituksen tietojen mukaan 440 000 yksityistä metsälöä, joista noin kolmasosa on alle 20 hehtaarin kokoisia. Valtio omistaa metsistä 35 prosenttia, metsäteollisuus 8 prosenttia ja loput on jakautunut kuntien, seurakuntien ja muiden yhteisöjen kesken. Lähde: http://www.metla.fi/aikakauskirja/full/ff09/ff093181.pdf

Metsien maastoinventointia JokaMies -mobiilisovelluksella

Metsän inventointiin on olemassa monenlaisia maastotyökaluja. Perinteisen relaskoopin rinnalle on tullut sähköisiä työkaluja, kuten maastotietokoneet. Älypuhelimien yleistyessä on markkinoille ilmestynyt myös metsämittaukseen tarkoitettuja mobiilisovelluksia. Yksi näistä on JokaMies –sovelluksen prototyyppi, jota on kehitetty osana EU-osarahoitteista Metsävaramittaus kunnostamattomissa metsissä –projektia. Jokamies –sovellus on suunniteltu kustannustehokkaaksi työkaluksi nuorten kunnostamattomien metsien hoitoon, erityisesti metsänomistajan sekä metsurin käyttöön työvaikeusluokituksen arvioinnissa.

Mobiilisovelluksen etuna verrattuna maastotietokoneeseen on sen kustannustehokkuus. Maastotietokoneet voivat maksaa tuhansia euroja, kun taas monikäyttöinen, kuluttajakäyttöön soveltuva älypuhelin maksaa alimmillaan sadan euron luokkaa ja löytyy lähes jokaisen metsänomistajan taskusta. Perinteisiin inventointimenetelmiin verrattuna mobiilisovellus on nopeampi ja helpompi tapa inventoida metsää. Relaskoopilla mitatessa pitää tulokset pistää erikseen muistiin ja määritellä relaskooppitaulukosta runkotilavuus. Mobiilisovellus tekee mittausten kirjauksen ja tulosten analysoinnin automaattisesti ja graafisten tulosten avulla.

Käyttö

JokaMies -sovellus on monialusta-mobiilisovellus, eli se toimii useammalla kuin yhdellä käyttöjärjestelmällä. Sovellus on kehitetty HTML5 tekniikalla ja sovellus toimii tällä hetkellä nykyaikaisilla Android ja Windows Phone 8 älypuhelimilla. Sovellus on pyritty suunnittelemaan niin, että käyttöliittymä ja toiminnot pysyvät samanlaisina alustasta riippumatta, vaikka pieniä teknisiä eroja käyttöjärjestelmien väliltä löytyykin.

kotiruutu

Työvaikeusluokitus -työkalulla mitataan aluskasvustoa, alle 6 cm läpimittaisia ennakkoraivattavia puita ja risukkoja. Puita ei lasketa yksitellen, vaan sovellus luo kuviolle pieniä ympyrän muotoisia mikrokoealoja, jonka säteen käyttäjä voi itse valita kolmesta metsikkökuviosta riippuvasta vaihtoehdosta. Mikrokoealalta arvioidaan kaikki alle 6 cm puut ja syötetään luku sovellukseen. Sovellus laskee mikrokoealoilla syötettyjen arvojen perusteella kuinka paljon metsäkuviolla on aluskasvustoa ja määrittelee sen mukaan kuviolle ennakkoraivauksen työvaikeusluokituksen huomioiden maastovaikeustekijät. Arvion tarkkuus paranee suhteessa mittausten kattavuuteen. Sovelluksessa on eritelty puuston inventointi ja aluskasvuston mittaus erillisiksi toiminnoiksi. Puustomittaus keskittyy yli 6 cm läpimitaltaan olevien ainespuiden mittaamiseen. Puita mitataan yksitellen etenemällä kuviolla ennakkoon määrätyn reitin mukaisesti, jolloin  mittaustulosten avulla voidaan arvioida runkolukusarja ja pohjapinta-ala koko kuviolle. Puut voidaan mitata joko elektronisia mittasaksia käyttäen tai syöttäen käsin puustotiedot ohjelman käyttöliittymään. Elektroniset mittasakset yhdistetään sovellukseen Bluetoothin avulla, jolloin aina kun tehdään mittaus, mittasakset lähettävät puun tiedot sovellukseen, sovellus ottaa paikkatiedon puhelimen GPS:tä ja lisää tiedot tietokantaan.

JokaMies -sovellus tekee jokaiselle metsikkökuviolle tuloskortin, jota voi tarkastella sovelluksen “Tulokset” painikkeen takaa. Sovellus antaa jokaiselle kuviolle tiedot puustotulkinnan ja alikasvoslaskennan osalta. Puustotulkinta kohdasta löytyy tiedot kuvion pinta-alasta, puupinta-alasta, arvioitu runkoluku sekä keskimääräinen puun halkaisija. Sovellus antaa myös arvion siitä, millainen on puuston poistumatyyppi ja kuinka monta puuta hehtaaria kohden tulisi poistaa.

liikala_tuloskortti_v3

Mittaustulokset

Alikasvoslaskennan osuus keskittyy kuvion ennakkoraivauksen työvaikeusluokitukseen. Kun sovellukseen on syötetty alle 6cm läpimittaisen alikasvoksen ja risujen arvioitu määrä sekä keskiläpimittaluokat, voidaan laskea kuviolle työvaikeusluokitus. Kuvion työvaikeusluokituksen ja koon ollessa tiedossa, saadaan laskettua kuvion ennakkoraivaukseen tarvittavien tuntien määrä (tavoitetuotosluku) ja tästä edelleen ennakkoraivauksen työn hinta.

JokaMies -sovellus käyttää mittausten (ts. puiden) paikantamiseen puhelimen omaa GPS-anturia. Paikannuksen tarkkuus maastotesteissä on ollut keskimäärin 3-4 metriä. Laajin testimittaus suoritettiin Liikalassa, Toivakassa, jossa kuviolle rajatulta koealalta mitattiin JokaMies -sovelluksella kaikki puut (Kuva alla). Mittaustuloksia verrattiin aiemmin Masser Sonar Caliper mittalaitteella mitattuihin tuloksiin. Kun tulokset havainnollistetaan kartalla, voi nähdä että JokaMies -sovelluksella tehdyt mittaukset ovat hieman siirtyneet verrattuna Sonar Caliperilla tehtyihin mittauksiin. Siirtymä on ollut kuitenkin yhtä suuri kaikissa mittauksissa, joten suurta vaikutusta lopputulokseen ei pitäisi olla.

Puukartta_HakkuunJalkeen

Puukartta Masser Sonar Caliperilla mitattuna

Puukartta_JokaMies

Puukartta JokaMies-sovelluksella mitattuna

Yhteenveto

Metsävaramittaus kunnostamattomissa metsissä -projektissa kehitetyn JokaMies -mobiilsovelluksen avulla helpotetaan metsänhoidon suunnittelua metsäalan palveluyritttäjille sekä omatoimisille metsänomistajille. Sovelluksen avulla perinteisen relaskooppimittauksen tehostamiseksi on kehitetty käyttöliittymä nykyaikaisella älypuhelimella, jonka avulla tiedonsiirto metsävaratietojärjestelmiin nopeutuu huomattavasti. Tiedonsiirron avulla mittaaja saa käyttöönsä karttanäkymän, jonka avulla oikean metsikkökuvion paikantaminen sekä mittaaminen on helppoa. Mitatut puut lähetetään metsävaratietojärjestelmään, josta käyttäjä saa tuloksena runkolukusarjan sisältävän tuloskortin harvennustarpeineen. Metsäpalveluyrittäjälle JokaMies -sovellus tarjoaa menetelmän taimikoiden ja nuorten, kunnostamattomien metsien ennakkoraivauksen työvaikeusluokituksen arviointiin ja laskentaan. Sovelluksen prototyyppi julkaistiin projektin tuotoksena ja sen jatkokehittämistä sekä kaupallistamista tutkitaan projektin jälkeen.

Kirjoittaja työskenteli Metsävaramittaus kunnostamattomissa metsissä -projektissa projektityöntekijänä 2013-2014. Mobilisovelluksen Windows Phone 8  -alustan toteutus on julkaistu opinnäytetyösssä:  Tiihonen, S., 2014. Windows Phone 8 Jokamies metsänmittaussovellus, Jyväskylä, JAMK/IT

 

 

Kommentit pois päältä artikkelissa JokaMies –mobiilisovellus omatoimiseen metsänmittaukseen

Kunnostamattomien metsien hoidon suunnittelu helpottuu

Jyväskylän ammattikorkeakoulun koordinoimassa Metsävaramittaus kunnostamattomissa metsissä -projektissa on etsitty keinoja metsävaratietojen mittaamisen ja hyödyntämiseen.

– Olemme kehittäneet muun muassa teknistä mittaussovellusta, jolla helpotetaan puustotunnusten laskentaa ja kunnostustyön määrän arviointia maastossa, projektipäällikkö Petteri Weckström kertoo.

Kehitetyn laseraineiston suoratulkintamenetelmän tuottamaa aineistoa voidaan hyödyntää esimerkiksi nuoren metsän kunnostustarpeen sekä taimikonhoitotyökohteiden määrittämisessä laajoillakin alueilla ilman erillisiä maastokäyntejä.

– Metsien inventointia pyritään jatkuvasti tehostamaan uusilla menetelmillä, projektissa kehitetty suoratulkintamenetelmä mahdollistaa kustannussäästöjä taimikoiden ja nuorten metsien maastotarkastusten vähentyessä, Suomen Metsäkeskuksen Raito Paananen toteaa.

Tervetuloa seuraamaan tiedonkeruuta ja kuulemaan samalla projektin tuloksista keskiviikkona 23.4.2014 klo 9-11 Keuruun Katajamäkeen, osoitteeseen Pyörkkiläntie 212.

Tilaisuudessa on mahdollisuus tutustua laserkeilauksella saadun metsävaratiedon hyödyntämismahdollisuuksiin metsän hoidon suunnittelussa. Lisäksi esitellään puuston mittaukseen metsänomistajille sekä metsureille kehitetty, Weckströmin mainitsema Jokamies-sovellus. Sovellusta voidaan käyttää suoraan älypuhelimesta mm. poistettavan puuston määrän arviointiin nuoren metsän kunnostuskohteissa sekä ennakkoraivaustyön vaikeusluokituksen määrittämiseen.

– Jokamiehen mittausmenetelmällä voi kerätä puustotietoja helposti ja nopeasti metsiköistä. Mukana ei tarvitse raahata kynää ja paperia vaan puhelimeen syötetyt tiedot tallentuvat pilvipalveluun, josta ne ovat haettavissa analysoitavaksi omalle tietokoneelle tai maastossa älypuhelimen näytölle. Työ helpottuu ja myös uusien metsäomistajien on helppo innostua seuraamaan ja kehittämään metsiensä kuntoa, sovellusta testannut MHY Keski-Suomen Riitta Pellinen kertoo.

EU:n Manner-Suomen maaseudun kehittämisohjelman rahoittamassa projektissa on ollut mukana asiantuntijoita JAMKin lisäksi Suomen Metsäkeskuksesta, Hämeen ammattikorkeakoulusta ja Metsänhoitoyhdistys Keski-Suomesta.

Tervetuloa seuraamaan mittauksia ja haastattelemaan alan asiantuntijoita!

Lisätietoja:
Petteri Weckström, projektipäällikkö, 040 531 3239, etunimi.sukunimi@jamk.fi, Jyväskylän ammattikorkeakoulu, teknologiayksikkö, Metsävaramittaus kunnostamattomissa metsissä -projekti

Kommentit pois päältä artikkelissa Kunnostamattomien metsien hoidon suunnittelu helpottuu

Bluetooth for PhoneGap

BluetoothPlugin for PhoneGap

https://github.com/tanelih/phonegap-bluetooth-plugin

Earlier this year we [1] worked on an application that needed to communicate with a simple measurement device over Bluetooth. We took a look at some of the currently available plugins [2][3] for Bluetooth but decided to roll our own. We were developing the app for Android at the time and so the plugin only targeted this platform.

The plugin was developed initially using the 2.6.0 version of PhoneGap, but was later changed to conform to the plugman-centric specification of 3.0.0.

The required functionality for the application in development defined many of the features of the plugin. For example you can search for devices, connect to them and have some basic I/O with the connected devices.

In our case we had to establish connection to a fairly low-level measurement device, which then transmitted the measured data via Bluetooth to our mobile device. Our mobile device would then return either ACK or NAK to the measurement device depending on the validity of the data. The data was in NMEA format and often split into multiple small bursts, so we had to also make sure to validate the check-sums of the messages.

Example Application

Creating the project

Make sure you have phonegap 3.0.0 installed on your system.

Create a new Phonegap project using the CLI, then follow the instructions at here to add BluetoothPlugin to your project. After adding the plugin to your project, remember to build it for Android using the Phonegap CLI. Due to limitations in this blog-environment the code is hosted in pastebin, however the code is fairly well commented so there shouldn’t be any issues.

First let’s list the libraries used to develop this example application. If you are not familiar with how these libraries function, check them out!

The source code for this example is hosted on github.

Basic UI

We start by creating a basic UI for our app, using the basic components provided by Bootstrap. Note that we don’t need that much of HTML to create a fairly clean UI thanks to Bootstrap components. The grid system makes sure the UI scales well and doesn’t break when the device orientation changes.

We create ’on’, ’off’ and ’discover’-buttons, of which ’discover’ uses a special ’data-loading-text’-attribute from Bootstrap to signify a ’loading’-state. For displaying the devices, we create a simple ’device’-template in ’templates.js’ file that uses the underscore.js templating.

Adding functionality

We wire up the basic ’deviceready’ cycle that we usually do with Phonegap applications. Then we rig up some code to connect our flashy ’on’, ’off’ and ’discover’-buttons to their respective implementations.

We also have a BluetoothState model, which we change over the course of the application to represent what the app is currently up to. Changing the state using the ’set’-method triggers a ’change’-event, which we listen to and then change to UI accordingly to represent the current state of the application.

Handling found devices

We create two Backbone Views for our app: DeviceView, and DeviceListView. DeviceListView will act as the host to multiple DeviceViews, of which each has a reference to a single BluetoothDevice. DeviceView handles the click events for the ’connect’ and ’disconnect’ buttons in relation to the model it references.

DeviceView compiles the ’device’-template from ’devices.js’ using the data from its model, it then attaches this compiled template to its ’el’. DeviceListView then renders each DeviceView ’el’ into the DOM-structure.

Connecting and disconnecting

When the user taps ’connect’, we first invoke the ’getUUIDs’-method to retrieve the device’s UUIDs. After retrieving the UUIDs we can actually ’connect’. Once connection is established, we can ’startConnectionManager’ which listens to incoming messages as the first callback. Once a Device is implied to be connected, using the ’isConnected’ attribute of the Device-model, the device is rendered with the Disconnect-button. Tapping the ’disconnect’-button will cancel any ongoing connections.

Hopefully this helps getting started using the BluetoothPlugin for Phonegap.

Sample UI for BluetoothDemo

[1] Forest Resource Measurement in Untreated Forests -project summary
[2] http://simonmacdonald.blogspot.fi/2013/03/phonegap-bluetooth-plugin-updated.html
[3] https://github.com/huseyinkozan/phonegap-bluetooth

Kommentit pois päältä artikkelissa Bluetooth for PhoneGap

Moikka maailma!

Tervetuloa käyttämään JAMK Blogipalvelu blogipalvelua. Tämä on ensimmäinen merkintä blogissasi. Muokkaa tai poista se, ja aloita bloggaaminen!

Kommentit pois päältä artikkelissa Moikka maailma!

css.php