creating index page Documents/SlimJimAntenna

[web/altusmetrum] / ChaosKey / index.mdwn

diff --git a/ChaosKey/index.mdwn b/ChaosKey/index.mdwn
index 40bb1cd6a34fff9eeac94b730b3a6d36dd2914bc..9a5278cd6d19f8ad4a3dfd46df410b9b0144be83 100644 (file)
--- a/ChaosKey/index.mdwn
+++ b/ChaosKey/index.mdwn
@@ -1,3 +1,4 @@
+[[!meta title="ChaosKey"]]
 # ChaosKey
 
 This is a hardware True Random Number Generator that attaches via USB.
@@ -5,18 +6,43 @@ This is a hardware True Random Number Generator that attaches via USB.
 The Linux Kernel, starting with version 4.1, includes source for this
 driver. It should be built by default in your distribution. If your
 using Linux + KVM to host other Linux instances, read the
-[VirtualMachine] page to see how you can configure the guests to share
+[VirtualMachine](VirtualMachine.html) page to see how you can configure the guests to share
 the host entropy source.
 
 ## Version 1.0 ##
 
-1.0 is the first production version of ChaosKey. The first run of 1000
-units is expected sometime around August, 2016.
+1.0 is the first production version of ChaosKey, now available for sale 
+in single units and packs of 10 and 25 units at
+[Garbee and Garbee](http://shop.gag.com/random.html) and
+[vikings](https://store.vikings.net/chaoskey).
 
 <a href="v1.0/chaoskey-bare.jpg"><img src="v1.0/chaoskey-bare-thumb.jpg"></a>
 
 <a href="v1.0/chaoskey-boxed.jpg"><img src="v1.0/chaoskey-boxed-thumb.jpg"></a>
 
+### Reflashing Firmware ###
+
+To reflash the system firmware on ChaosKey, you first need to get the
+device into 'bootloader mode'. To do this, you must power-up ChaosKey
+with a jumper between GND and the Boot Loader Select pin.
+
+Open up ChaosKey by prying the case apart. There's no glue or screws,
+so a thin tool or fingernail should suffice to split the case into two
+pieces. Once you've opened it up, you'll find the inside that looks
+much like this:
+
+<img src="chaoskey-connector.svg">
+
+Connect a wire between the two red holes in the debug connector and
+then plug it in to your computer. It will appear as a USB modem device
+called AltosFlash with USB ID fffe:000a.
+
+Use the 'ao-usbload' program, which is part of the
+[AltOS repository](https://altusmetrum.org/AltOS/)
+and is packaged for Debian in the 'altos' package:
+
+    $ ao-usbload chaoskey-v1.0-*.elf
+
 ### Version 1.0 Hardware ###
 
  * [STM32F042](http://www.st.com/web/catalog/mmc/FM141/SC1169/SS1574/LN1823?icmp=stm32f0x2-line_pron_pr_jan2014&sc=stm32f0x2-pr) System-on-Chip
@@ -42,11 +68,16 @@ bits from the noise source are available here:
 
 [AltOS Git Repository](http://git.gag.com/?p=fw/altos;a=summary)
 
+[ChaosKey Firmware version 1.6.7](v1.0/chaoskey-v1.0-1.6.7.elf)
+
+[ChaosKey Boot Loader version 1.6.7](v1.0/chaoskey-v1.0-altos-flash-1.6.7.elf)
+
 Hardware designs using [gEDA](http://www.geda-project.org/) are
 available here:
 
 [ChaosKey Hardware Design Files](http://git.gag.com/?p=hw/chaoskey;a=summary)
 
+
 ## Version 0.3 ##
 
 This one uses the better noise source coupled with an op amp that