HabAlertApp - Revision history

Bertrik Sikken at 06:51, 18 April 2018

2018-04-18T06:51:40Z

← Older revision		Revision as of 06:51, 18 April 2018
Line 1:		Line 1:
	{{Project		{{Project
	\|Name=HAB alert app		\|Name=HAB alert app
	\|Status=~~Initializing~~		\|Status=Abandoned
	\|Contact=bertrik		\|Contact=bertrik
	}}		}}

Bertrik Sikken at 15:50, 30 July 2015

2015-07-30T15:50:25Z

← Older revision		Revision as of 15:50, 30 July 2015
Line 67:		Line 67:
	=== Sub-systems ===		=== Sub-systems ===
	==== HAB alert server ====		==== HAB alert server ====
	The plan is to use Jersey ~~(JAX~~-~~RS)~~ to handle incoming HTTP requests.		The plan is to use Jetty-Jersey-Jackson to handle incoming HTTP requests.
	Jersey works by annotating classes/methods that handle requests.		Jersey works by annotating classes/methods that handle requests.

	Message serialization is done using the ~~GSON~~ library.		Message serialization is done using the Jackson library.
	~~GSON can handle serialization from/to JSON using POJO's without even needing annotations.~~
	~~GSON is used for serialization on the android app too~~.

	==== HAB alert android app ====		==== HAB alert android app ====

Bertrik Sikken at 10:05, 15 August 2014

2014-08-15T10:05:53Z

← Older revision		Revision as of 10:05, 15 August 2014
Line 56:		Line 56:

	Responsibilities of the android app are:		Responsibilities of the android app are:
			* registering with GCM and registering with the hab alert server
	* interaction with the user:		* interaction with the user:
	** alerting the user, e.g. by beeping/vibrating and showing an icon in the status bar		** alerting the user, e.g. by beeping/vibrating and showing an icon in the status bar

Bertrik Sikken: Add project goals

2014-08-15T07:54:12Z

Add project goals

← Older revision		Revision as of 07:54, 15 August 2014
Line 20:		Line 20:
	The problem that the Android app aims to solve is that sometimes a HAB is launched and you're not aware that it's coming into range of the RevSpace HAB tracker, missing the opportunity to track it.		The problem that the Android app aims to solve is that sometimes a HAB is launched and you're not aware that it's coming into range of the RevSpace HAB tracker, missing the opportunity to track it.
	The HABAlertApp is an application you can install on your Android OS phone that alerts you as soon as a HAB comes in range of your radio receiver.		The HABAlertApp is an application you can install on your Android OS phone that alerts you as soon as a HAB comes in range of your radio receiver.

			My goals for this project are:
			* learn even more about android, possibly using [http://androidannotations.org/ android annotions]
			* learn about effective use of REST interfaces, on both the android app and on the server (JAX-RS/Jersey)
			* get experience with the Google Cloud Message (GCM) framework
			* finally, have a useful app that alerts me of incoming HABs

	== Design ==		== Design ==

Bertrik Sikken at 11:29, 13 August 2014

2014-08-13T11:29:45Z

← Older revision		Revision as of 11:29, 13 August 2014
Line 60:		Line 60:
	=== Sub-systems ===		=== Sub-systems ===
	==== HAB alert server ====		==== HAB alert server ====
			The plan is to use Jersey (JAX-RS) to handle incoming HTTP requests.
			Jersey works by annotating classes/methods that handle requests.

			Message serialization is done using the GSON library.
			GSON can handle serialization from/to JSON using POJO's without even needing annotations.
			GSON is used for serialization on the android app too.

	==== HAB alert android app ====		==== HAB alert android app ====
Line 66:		Line 71:
	=== Interfaces ===		=== Interfaces ===
	==== spacenear.us / habhub.org interface ====		==== spacenear.us / habhub.org interface ====
			The interface is HTTP.
			The messaging format is JSON.

	==== google cloud messaging ====		==== google cloud messaging ====
	[http://developer.android.com/google/gcm/index.html Google cloud messaging] (GCM) provides a way to 'tickle' (send-to-sync) the app to make it check for any updates.		[http://developer.android.com/google/gcm/index.html Google cloud messaging] (GCM) provides a way to 'tickle' (send-to-sync) the app to make it check for any updates.

Bertrik Sikken: update google cloud messaging part

2014-08-12T09:04:16Z

update google cloud messaging part

@@ Line 67: / Line 67: @@
 ==== spacenear.us / habhub.org interface ====
 ==== google cloud messaging ====
 ==== android app interface ====
 ==== android user interface ====

Bertrik Sikken at 07:57, 11 August 2014

2014-08-11T07:57:22Z

← Older revision		Revision as of 07:57, 11 August 2014
Line 24:		Line 24:
	=== System overview ===		=== System overview ===
	The application relies on some additional infrastructure.		The application relies on some additional infrastructure.


	In total, the following parts are relevant:		In total, the following parts are relevant:
Line 30:		Line 31:
	* google cloud messaging, provides 'push' notifications between the hab alert server and the android app		* google cloud messaging, provides 'push' notifications between the hab alert server and the android app
	* the android app (called 'client'), which interacts with the user		* the android app (called 'client'), which interacts with the user


	Responsibilities of the hab alert server:		Responsibilities of the hab alert server:
Line 45:		Line 47:
	** register/unregister radio receivers		** register/unregister radio receivers
	** list active balloons with their call-sign, altitude, location, visibility		** list active balloons with their call-sign, altitude, location, visibility


	Responsibilities of the android app are:		Responsibilities of the android app are:

Bertrik Sikken: Initial page

2014-08-10T13:07:45Z

Initial page

New page

{{Project
|Name=HAB alert app
|Status=Initializing
|Contact=bertrik
}}

This project is about creating an Android app to alert you of high-altitude balloons coming near so you can start tracking them.

See also:
* [[HAB Tracker Station]]
* [[HAB launch]]
* [[HAB launch 2]]

== Introduction ==
Regularly, high-altitude balloons (HABs) are released ("launched") in the UK and many other places around the world.
These balloons are usually equipped with a GPS receiver, a small micro-controller and an UHF transmitter broadcasting the balloon's callsign/location/altitude/etc.
It's a fun hobby to help track these balloons by receiving the coordinates and submitting them to a central web site.
RevSpace has a radio reception setup specifically for this, see [[HAB Tracker Station]].

The problem that the Android app aims to solve is that sometimes a HAB is launched and you're not aware that it's coming into range of the RevSpace HAB tracker, missing the opportunity to track it.
The HABAlertApp is an application you can install on your Android OS phone that alerts you as soon as a HAB comes in range of your radio receiver.

== Design ==
=== System overview ===
The application relies on some additional infrastructure.

In total, the following parts are relevant:
* the spacenear.us / habhub.org web sites, source of up-to-date balloon data
* the hab alert server (called 'server'), keeps track of balloons and receivers and sends out alerts
* google cloud messaging, provides 'push' notifications between the hab alert server and the android app
* the android app (called 'client'), which interacts with the user

Responsibilities of the hab alert server:
* communication with the spacenear.us / habhub.org web sites
** connect and scrape balloon location data
** interpret the data format and extract the current balloon data
* business logic
** keep a list of active balloons
** keep a list of active radio receivers
** keep a list of subscribed clients
** at regular intervals, calculate visibility between balloons and radio receivers and send out notifications to subscribed clients
* communication with google cloud messaging
* serving requests from clients
** add/remove alert subscriptions from clients
** register/unregister radio receivers
** list active balloons with their call-sign, altitude, location, visibility

Responsibilities of the android app are:
* interaction with the user:
** alerting the user, e.g. by beeping/vibrating and showing an icon in the status bar
** showing current balloon info, e.g. a list of balloons with their call-signs / radio settings, sorted by visibility
** setting preferences for alerts:
*** location of the radio receiver
*** alert criteria, e.g. degrees above horizon
*** (optional) back-off time, preventing multiple alerts

=== Sub-systems ===
==== HAB alert server ====

==== HAB alert android app ====

=== Interfaces ===
==== spacenear.us / habhub.org interface ====
==== google cloud messaging ====
==== android app interface ====
==== android user interface ====