Lähdekoodi sivulle Java ME APRS MIDlet

<div class="floatright">__TOC__</div>
== Java ME APRS MIDlet ==

''Java ME APRS MIDlet is a small Java Mobile Phone (J2ME) [[APRS]] application, which sends user's location with GPRS, 3G or WLAN connection to [[APRS-IS]] server. <br>It works in most new mobile phones in which GPS (and J2ME) are supported.''

Java ME APRS MIDlet on matkapuhelimessa toimiva pieni Java Mobile Edition (J2ME) [[APRS]]-sovellus, joka lähettää käyttäjän sijainnin GPRS-, 3G- tai WLAN-yhteyden välityksellä [[APRS-IS]] palvelimelle.

Sovellus toimii useimmissa uusimmissa GPS-ominaisuuksilla varustetuissa matkapuhelimissa (testattu mm. Nokia 5230, 5800, N81, N95, E51, E71, E85, E90 puhelimissa). 

Softa toimii myös ulkoisen Nokia LD-3W Bluetooth vastaanottimen kanssa puhelimissa, jotka tukevat [https://secure.wikimedia.org/wikipedia/en/wiki/Location_API_for_Java_ME  JSR-179 API:a (Location API for Java ME)]. 
----


[[Tiedosto:Main.png]] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
[[Tiedosto:J2ME_APRS.png]]

== Asennus - Download ==

Sovelluksen voit ladata matkapuhelimeesi tästä, joko suoraan matkapuhelimesi selaimella tai kopioimalla sen ensin tietokoneelle ja sieltä puhelimeesi.

''You can install the application to your mobile phone directly by pointing your mobile browser to this link or copy it first to the computer and then to your mobile.''

[[http://www.fileden.com/files/2011/1/16/3060557/APRS_for_J2ME.jar APRS_for_J2ME.jar]] 
<!--[[http://www.fileden.com/files/2011/1/16/3060557/APRS_for_J2ME.jar APRS_for_J2ME.jar]]-->

----

== Asennusohjeet - Installation instructions ==

===Lataaminen ja asennus===

Lataa APRS for J2ME versio 0.5pre jostakin puhelimen selaimella. Sovelluksen koko on 44 kt, joten sen lataaminen kuluttaa vain nimellisesti mahdollista kuukausittaista latauskiintiötä.

[[Tiedosto:J2ME_Asenna1.png|Thumb|120px]]
[[Tiedosto:J2ME_Asenna2.png|Thumb|120px]]

Asenna sovellus hyväksymällä suojausvaroitukset. Javan ominaisuuksista johtuen puhelin käsittelee ohjelmaa tunnistamattomana ja epäluotettavana.

[[Tiedosto:J2ME_Asenna4Muisti.png|Thumb|120px]]

Valitse käytettävä muisti. Sovelluksen vaatima koko on alle 50 kt, joten uudenaikaisissa puhelimissa se kannattaa tallentaa puhelimen muistiin.

===Sovelluksen asetukset===

-- Control Panel - Settings -

[[Tiedosto:J2ME_SovellusAsetukset1.png|Thumb|120px]]

Avaa puhelimesta Sovellusten hallinta. Tämä löytyy yleensä samasta valikosta kuin asennetut sovelluksetkin. Valitse listasta APRS ja avaa valinnat.

[[Tiedosto:J2ME_SovellusAsetukset2.png|Thumb|120px]]
[[Tiedosto:J2ME_SovellusAsetukset3.png|Thumb|120px]]

Valitse käytettävä Yhteysosoite. Tämä on atkapuhelinoperaattorisi osoite, jota käytetään Internet-yhteyksissä.

Valitse Verkkokäyttö -valintaan Kysy 1. kerralla. Tämä mahdollistaa automaattisen paikkatiedon lähettämisen ohjelman käynnistyksen jälkeen.

Valitse Paikannus -valintaan Kysy 1. kerralla. Tämä mahdollistaa automaattisen paikkatiedon lähettämisen sovelluksen käynnistämisen jälkeen.

===APRS for J2ME asetukset ja käyttö===

[[Tiedosto:J2ME_Paavalikko.png|Thumb|120px]]

Käynnistä APRS for J2ME ja valitse päävalikosta Configuration.

[[Tiedosto:J2ME_Asetukset1.png|Thumb|120px]]
[[Tiedosto:J2ME_Asetukset2.png|Thumb|120px]]

Syötä tarvittavat tiedot valikkoihin:

Callsign: amatöörikutsusi ja mahdollinen lisämerkki (yleisimmat 7=liikkuva asema, 9=ajoneuvo)

APRS passcode: kutsuasi vastaava tunnus palvelimelle (lisätietoa ...)

APRS-IS server: käytettävä APRS-palvelin ja portti, suomessa finland.aprs2.net:14580

Name / comment text: vapaamuotoinen (ja lyhyt) infoteksti, esim. nimi tai email-osoite

Polling interval: kuinka usein paikkatieto lähetetään

APRS map symbol: millaisella symbolilla paikka näkyy APRS-kartoilla

[[Tiedosto:J2ME_AloitusVerkko1.png|Thumb|120px]]
[[Tiedosto:J2ME_KyselyVerkko.png|Thumb|120px]]

Asetusten jälkeen valitse päävalikosta Start.

Alussa sovellus tarkistaa verkon ja palvelimen toimivuuden. Kyselyyn, saako sovellus käyttää verkkoyhteyttä vastaa Kyllä.

[[Tiedosto:J2ME_AloitusGPS1.png|Thumb|120px]]
[[Tiedosto:J2ME_KyselyPaikannus.png|Thumb|120px]]

Verkkoyhteyden tarkistamisen jälkeen sovelus aloittaa paikantamisen.
Kyselyyn, saako sovellus käyttää paikannusta vastaa Kyllä.

[[Tiedosto:J2ME_AloitusGPS2.png|Thumb|120px]]
[[Tiedosto:J2ME_AloitusGPS3.png|Thumb|120px]]

GPS-sijainnin löytymisen jälkeen nätöllä on näkyvissä sijainti ja mahdollinen nopeus ja suunta. Tämän jälkeen voit vaihtaa sovelluksen taustalle.

Mikäli käynnistät sovelluksen sisätiloissa ja paikkatietoa ei löydy, voit silti laittaa sovelluksen taustalle kun olet vastannut myöntävästi sekä verkon käyttö että paikannuksen sallimiseen.

Myöhemmin palatessasi sovellukseen voit katsoa viimeisimmän lähetetyn paikkatiedon ajankohdan pääruudusta.

'''Tärkeää!''' Jos poistut pääruudusta valinnalla Back paikkatiedon lähettäminen lakkaa! Lukitse siis näppäimet vaihtamalla sovellusta puhelimen omalla sovelluksenvaihtonapilla!

----

== Muutokset - v0.5 ==
*JSR-179 Location API event listener 
*Nopeus, suunta ja korkeustieto lisätty
*Uusi isompi fontti 
*Logikirjoituksen bugi flash-muistin käsittelyssä korjattu

== Muutokset - v0.4 ==
*Pieni tapahtumaloki lisätty (GPS, verkkoyht., ongelmat, ohjelman tila)
*Max timeout aika GPS-yhteydelle on nyt 40s (aikaisemmin 60s)
*Verkkoyhteys muodostetaan ennen GPS yhteyttä (yht. hyväksymistä ei tarvitse enää odotella pollauksen loppuun)
*Pollausintervallin ajoitus on hiukan tarkempi
*GPS tilasta pääsee pois poistumatta koko ohjelmasta
*Asetusparametrien tyyppien tarkistuksia on parannettu
*"Phone" lisätty APRS-karttasymboleihin
----

== Bugit ja puutteet ==
*[http://wiki.forum.nokia.com/index.php/KIJ000852_-_Repeating_socket_connections_with_default_access_point_result_in_Out_of_Memory_exception_in_the_Nokia_N95  Nokia J2ME S60 3rd Ed, FP1 socket handling / Out of Memory bug (N95)]
*Virheiden ja poikkeusten käsittely 


== Lähdekoodi - Source Code ==

Suurin osa UI-koodista on generoitu NetBeans IDE editorin koodigeneraattorilla. Ohjelmistopaketti sisältää kaikki kääntämiseen tarvittavat NetBeans 6.8 projektitiedostot.


<!--*[ Link to Source Code]-->
*[http://www.fileden.com/files/2011/1/16/3060557/new1/APRS_v05_src.zip Link to source code files in Zip package]



''Kari OH1KO''

''mailto:oh1ko@sral.fi''

--[[Käyttäjä:OH1KO|OH1KO]] 16. tammikuuta 2011 kello 22.16 (UTC)

[[Category:APRS]]
[[Category:Ohjelmat]]