include a link to older AltOS versions
[web/altusmetrum] / AltOS / index.mdwn
index 3fdb7e9e1d31f6a37f9f7b615e9df7a1bfc543d3..ebc8913639011056b23c80ba1b23a9be4a33e028 100644 (file)
@@ -1,10 +1,12 @@
+[[!meta title="AltOS"]]
 # AltOS
 
 AltOS is the name of Keith's firmware "operating system" for 
-[TeleMetrum](../TeleMetrum/) and [TeleDongle](../TeleDongle/).
+Altus Metrum products.
 
-In addition to the firmware for [TeleMetrum](../TeleMetrum) and
-[TeleDongle](../TeleDongle) boards, the AltOS source tree also
+In addition to the firmware for hardware products like
+[TeleMetrum](../TeleMetrum), [TeleMini](../TeleMini), and
+[TeleDongle](../TeleDongle), the AltOS source tree also
 includes AltosUI, which provides for flight monitoring, post-flight
 analysis, device configuration and firmware updating. AltosUI runs on
 Linux, Mac OS X and Windows. It's written in [Java](http://java.com)
@@ -20,7 +22,7 @@ your favorite launch site isn't included, please let us know!
 
 ## Available Versions ##
 
-There is a single manual for all Altus Metrum products, which is available 
+There is a single manual for most Altus Metrum products, which is available 
 in [html](doc/altusmetrum.html) and [pdf](doc/altusmetrum.pdf) formats.
 
 We also have an AltOS internals document for programmers 
@@ -28,7 +30,21 @@ in [html](doc/altos.html) and [pdf](doc/altos.pdf) formats, and a
 document describing the AltOS over the radio protocol 
 in [html](doc/telemetry.html) and [pdf](doc/telemetry.pdf) formats.
 
-[[!inline pages="./releases/* and !*/Discussion and !*.html and !*.bz2 and !*.zip and !*.exe" show="10" rss="no" raw="yes" ]]
+If you're running Windows 8, you should take a look at [Installing AltosUI on
+Windows 8](Win8) which will help you install the operating system
+drivers needed to communicate with the USB hardware.
+
+If you're running a recent version of Mac OS X, you'll probably need
+to read [Installing AltosUI on Mac OS X](MacOSX). This describes how
+to get rid of the the 'App is damaged' messages and run the program.
+
+Each available download includes AltosUI, documentation, and firmware updates
+for all current products.
+
+[[!inline pages="./releases/* and !*/Discussion and !*.ihx and !*.sh and !*.html and !*.bz2 and !*.zip and !*.exe and !*.dmg" show="10" rss="no" raw="yes" ]]
+
+Note that [older versions](releases/) are still available if you really need 
+them for some reason.
 
 ## Source Code ##
 
@@ -36,11 +52,7 @@ The latest source, which may include unreleased work in progress, 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).  
 
-If you need to debug code on an Altus Metrum product, you may want our special
-version of SDCC containing a highly modified sdcdb with support for the cc1111
-debugging interface, which you can find on [git.gag.com](http://git.gag.com) 
-in the project [fw/sdcc](http://git.gag.com/?p=fw/sdcc;a=summary).  This is
-not necessary if you just want to rebuild AltOS and use it.
+We've gathered a few notes on [buidling AltOS](building).
 
 ## Future Plans ##
 
@@ -80,10 +92,6 @@ package from any Debian mirror, like so:
                apt-get update
                apt-get install altos
 
-If you use [Ubuntu](http://ubuntulinux.org), pre-built packages are available
-from [this PPA](https://launchpad.net/~sconklin/+archive/altos/) 
-maintained by Steve Conklin and friends.
-
 If you use some other distribution of Linux, then 
 a Linux package of our second-generation Java bits that 
 should run on any distribution with a modern Java version is also