From f0a961c623fb804034ce12b8901214d5fbbd98a9 Mon Sep 17 00:00:00 2001
From: Gunar Schorcht <gunar@schorcht.net>
Date: Wed, 4 Mar 2020 13:28:22 +0100
Subject: [PATCH] boards/remote-pa: fix broken links

---
 boards/remote-pa/README.md |  8 +++-
 boards/remote-pa/doc.txt   | 88 +++++++++++++++++++++++++++++++++++++-
 2 files changed, 92 insertions(+), 4 deletions(-)

diff --git a/boards/remote-pa/README.md b/boards/remote-pa/README.md
index 264320f831..61dc333eba 100644
--- a/boards/remote-pa/README.md
+++ b/boards/remote-pa/README.md
@@ -110,8 +110,12 @@ On Linux:
 
 More Reading
 ============
-2. [CC2538 System-on-Chip Solution for 2.4-GHz IEEE 802.15.4 and ZigBee applications (SWRU319B)][cc2538]
-3. [CC1120 sub-1GHz RF transceiver][cc1120]
+1. [Zolertia RE-Mote website][remote-site]
+2. [Zolertia Wiki page][zolertia-wiki]
+3. [CC2538 System-on-Chip Solution for 2.4-GHz IEEE 802.15.4 and ZigBee applications (SWRU319B)][cc2538]
+4. [CC1120 sub-1GHz RF transceiver][cc1120]
 
+[remote-site]: https://zolertia.io/product/re-mote/ "Zolertia RE-Mote"
+[zolertia-wiki]: https://github.com/Zolertia/Resources/wiki
 [cc1120]: http://www.ti.com/cc1120 "CC1120"
 [cc2538]: http://www.ti.com/product/cc2538     "CC2538"
diff --git a/boards/remote-pa/doc.txt b/boards/remote-pa/doc.txt
index d899bd2afd..ae79fb0b96 100644
--- a/boards/remote-pa/doc.txt
+++ b/boards/remote-pa/doc.txt
@@ -1,5 +1,89 @@
 /**
-@defgroup    boards_remote-pa Re-Mote Prototype A
+@defgroup    boards_remote-pa RE-Mote Prototype A
 @ingroup     boards
-@brief       Support for the Re-Mote board prototype A
+@brief       Support for the RE-Mote board prototype A
+
+The `RE-Mote` has three versions, a first prototype A (`remote-pa`) only
+distributed to beta testers, its following revision A (`remote-reva`), and the
+latest revision B (`remote-revb`) which are commercially available. The
+following section focuses on the revision A.
+
+The official RE-Mote wiki page is maintained by Zolertia at:
+
+https://github.com/Zolertia/Resources/wiki
+
+# Components
+
+| MCU   | [CC2538 (ARM Cortex-M3 with on-board 2.4GHz radio)](http://www.ti.com/product/CC2538) |
+|-------|-----------------------------------------------------------------------------------------------------|
+| Radio | Two radio interfaces (IEEE 802.15.4): [2.4GHz](http://www.ti.com/product/CC2538) and [863-950MHz](http://www.ti.com/product/CC1200) |
+|  | RP-SMA connector for external antenna (with a RF switch to select either 2.4GHz/Sub-GHz radio)           |
+| USB-to-Serial | [CP2104](https://www.silabs.com/products/interface/Pages/cp2104-mini.aspx) |
+| Peripherals | RTCC, built-in battery charger for LiPo batteries, External WDT (optional), Micro-SD |
+| Others | RGB LED, power management block (150nA when the mote is shutdown)|
+
+# Porting status
+
+In terms of hardware support, the following drivers have been implemented
+for CC2538 System-on-Chip:
+
+- UART
+- Random number generator
+- Low Power Modes
+- General-Purpose Timers
+- I2C/SPI library
+- LEDs
+- Buttons
+- RF 2.4GHz built-in in CC2538
+- RF switch to programmatically drive either 2.4GHz or sub-1GHz to a single
+  RP-SMA
+
+And under work or pending at CC2538 base CPU:
+
+- Built-in core temperature and battery sensor.
+- CC1200 sub-1GHz radio interface.
+- Micro-SD external storage.
+- ADC
+- USB (in CDC-ACM).
+- uDMA Controller.
+
+# Layout
+
+![layout](http://i.imgur.com/4bV6lyYl.png)
+
+# Flashing
+
+The RE-Mote has built-in support to flash over USB using the BSL.  Previous
+versions required to unlock the bootloader by manually pressing the `user
+button` and `reset button`, but the current version handles the sequence with an
+on-board PIC, so automatically unlocks the bootloader upon flashing.
+
+e.g.
+```
+Bash
+$ make BOARD=remote-reva flash
+```
+
+The RE-Mote in its current Revision A has the following pin-out:
+
+![RE-Mote pin-out (front)](https://raw.githubusercontent.com/contiki-os/contiki/master/platform/zoul/images/remote-reva-pinout-front.png)
+![RE-Mote pin-out (back)](https://raw.githubusercontent.com/contiki-os/contiki/master/platform/zoul/images/remote-reva-pinout-back.png)
+
+# Pin out and connectors
+
+## RE-Mote ports and connectors
+
+![](http://i.imgur.com/TF21Hin.png)
+
+![](http://i.imgur.com/J7aisKJ.png)
+
+## RE-Mote on-board connectors pin-out
+
+The RE-Mote uses the [Molex 5-pin WM4903-ND male header connector](http://datasheets.globalspec.com/ds/5843/DigiKey/6D12815C-098E-40A3-86A0-22A3C50B75BA) to
+connect digital sensors based on I2C and SPI protocols, as well as other sensors
+or actuators you may need to connect.  The pins are 2.54 mm spaced and the
+connector has the following pin-out:
+
+![](http://i.imgur.com/2DZ17PV.png)
+![](http://i.imgur.com/q7Hb7Y8.png)
  */