include a link to older AltOS versions
[web/altusmetrum] / AltosDroid / index.mdwn
index ae95a24ee2ef3bcb12888ea560f70c286e19037c..c086a35a49913fdda2b22fb7d1a0af4ff6fcc5f2 100644 (file)
@@ -1,26 +1,75 @@
+[[!meta title="AltosDroid"]]
 # AltosDroid
 
-AltosDroid is the [Android](http://android.com) port of Altus Metrum's 
+AltosDroid is the [Android](http://www.android.com/) port of Altus Metrum's 
 ground station program, designed to work with the [TeleBT](../TeleBT)
-ground statiion hardware product.
+ground statiion hardware product.  The latest version targets Android 
+version 4.0 (ICS) or later.  An older version is still available that 
+works on Android 2.3.3 and later.
 
 ## Where to Get It ##
 
-AltosDroid is availaable from the [Google Play](https://play.google.com/store/apps/details?id=org.altusmetrum.AltosDroid) store.
+The latest released version of AltosDroid is available from
+[Google Play™](https://play.google.com/store/apps/details?id=org.altusmetrum.AltosDroid).
+
+There is also a comparable iOS application available for sale from our
+friends at [Iron Sheep Productions](http://altosui.ironsheep.biz/).
 
 ## What It Can Do ##
 
-Current features include telemetry logging to SD card, text to speech 
-announcements of flight state, and downlink frequency selection.
+Current features include:
+
+* Display of key telemetry values
+* Telemetry logging to SD card
+* Text-to-speech announcements of flight state
+* Downlink frequency selection.
+
+## Permissions ##
+
+AltosDroid requires the following permissions in order to be installed:
+
+ * NETWORK COMMUNICATION
+       * PAIR WITH BLUETOOTH DEVICES
+<br>
+               This permission is needed to access Bluetooth communications,
+               allowing the pairing of and connection to TeleBT units.
+ * STORAGE
+       * MODIFY OR DELETE THE CONTENTS OF YOUR USB STORAGE MODIFY OR DELETE THE CONTENTS OF YOUR SD CARD
+<br>
+               This permission is needed so that telemetry logs can be
+               written to the SD card.
+ * SYSTEM TOOLS
+       * ACCESS BLUETOOTH SETTINGS
+<br>
+               This permission is used to request the enabling of Bluetooth
+               at startup.
 
 ## Source Code ##
 
 The source to AltosDroid is part of the [AltOS](../AltOS) repository, 
 which is always available from [git.gag.com](http://git.gag.com) 
-in the project [fw/altos](http://git.gag.com/?p=fw/altos;a=summary).  
+in the project [fw/altos](http://git.gag.com/?p=fw/altos;a=summary).
+
+The source is in the `altosdroid/` subdirectory, and is currently
+targetted at Android 4.0 or later. You will need to have the Android SDK 
+installed to build AltosDroid.
 
 ## Future Plans ##
 
 Future features we plan to add include flight computer configuration support,
 Google Maps integration, and "take me to my rocket" navigation.
 
+
+
+<center>
+<a href="https://play.google.com/store/apps/details?id=org.altusmetrum.AltosDroid">
+  <img alt="Android app on Google Play"
+       src="https://developer.android.com/images/brand/en_app_rgb_wo_45.png" />
+</a>
+
+
+Android is a trademark of Google Inc.
+<br>
+Google Play is a trademark of Google Inc.
+</center>
+