From 1b1ee66c35f8966891241c911faa5ecc99942231 Mon Sep 17 00:00:00 2001
From: Scott Penrose <scottp@dd.com.au>
Date: Thu, 14 May 2026 10:36:00 +1000
Subject: [PATCH] first release update

---
 PKA_SUMMARY.md | 22 ++++++++++++++++++++++
 README.md      |  3 +++
 2 files changed, 25 insertions(+)
 create mode 100644 PKA_SUMMARY.md

diff --git a/PKA_SUMMARY.md b/PKA_SUMMARY.md
new file mode 100644
index 0000000..a9ac737
--- /dev/null
+++ b/PKA_SUMMARY.md
@@ -0,0 +1,22 @@
+---
+title: "WII5Firmware"
+source: pka-assess
+---
+
+# WII5Firmware
+
+## Purpose
+
+Firmware for an autonomous WII5 wave-measurement buoy on a custom ATmega2560 v2 board. Reads wave motion from a Sparton AHRS, samples GPS and battery, and reports over Iridium SBD. Runs a mode dispatcher (Capture, Position, Sleep, Manual/Self Test, Low Battery) coordinated by `WII5Controller`.
+
+## Type
+
+C++ Arduino sketch for AVR (arduino-cli, not PlatformIO). `#embedded` `#firmware` `#iot`
+
+## Dependencies
+
+- **External:** Sparton AHRS-M1/M2, Iridium 9602/9603 SBD, u-blox NEO-6M/7M, DS18B20, TinyGPSPlus, IridiumSBD, RTClib, TimeLib, OneWire, DallasTemperature, SDBlock, RadioHead, LowPower, AvgStd, CRC32, MemoryFree, PushButton, elapsedMillis
+
+## Notable
+
+Apache-2.0 licensed. Lineage explicitly described as "WII5 = WII3 WDT + WII1 Buoy Combined". Build scripts in `tools/` are env-var parameterised; copy to `*.local.sh` for local defaults. LED blink-pattern table in README is field-diagnostic protocol — preserve meanings. Field deployments tracked in `DEPLOYMENTS.md`.
diff --git a/README.md b/README.md
index 5076734..e7dddbc 100644
--- a/README.md
+++ b/README.md
@@ -8,6 +8,9 @@ SBD satellite telemetry. Targets the ATmega2560 on a custom WII5 v2 board.
 > WII3 watchdog/maths-CPU lineage with the WII1 buoy I/O lineage. Design
 > notes and lineage live in `doc/`.
 
+First written in 2011 and first deployed in Antarctica with NIWA in 2012;
+data collected was published in Nature.
+
 ## Overview
 
 The buoy runs in one of several modes: