Cleanup RMDO documentation, clarify flash usage. Update list of

recommended boards for 2016.
cleanflight · Jan 8, 2016 · 9b45857 · 9b45857
1 parent 1b6d3b8
commit 9b45857
Show file tree

Hide file tree

Showing 4 changed files with 34 additions and 18 deletions.
diff --git a/docs/Board - ColibriRace.md b/docs/Board - ColibriRace.md
@@ -1,4 +1,4 @@
-# Board - Colibri RACE
+# Board - TBS Colibri RACE
 
 The Colibri RACE is a STM32F3 based flight control designed specifically to work with the TBS POWERCUBE multi rotor stack. 
 

diff --git a/docs/Board - Naze32.md b/docs/Board - Naze32.md
@@ -1,4 +1,4 @@
-# Board - Naze32
+# Board - AbuseMark Naze32
 
 The Naze32 target supports all Naze hardware revisions.  Revision 4 and 5 are used and
 frequently flown by the primary maintainer.  Previous Naze hardware revisions may have issues,

diff --git a/docs/Board - RMDO.md b/docs/Board - RMDO.md
@@ -1,19 +1,22 @@
-# Board - RMDO
+# Board - RMRC Dodo
 
-The RMRC Seriously Dodo board is made and sold by Ready Made RC. In terms of CPU pin mapping it is a clone of the SPRacingF3 board (also see the SPRacingF3 documentation). Currently there are three version with slightly different hardware available: Rev. 1, 2, and 3.
+The RMRC Dodo board is made and sold by Ready Made RC. In terms of CPU pin mapping it is a clone of the SPRacingF3 board (also see the SPRacingF3 documentation). Currently there are three versions with slightly different hardware available: Rev. 1, 2, and 3.
+
+The revision 3 board changed the CPU from one with 128KB to one with 256KB however, for compatibility reasons, Cleanflight only supports and uses 128KB of it.  The same binary can be used on all DODO boards.
 
 ## Hardware Features
 
-* STM32 F3 ARM Cortex-M processor with 256KB flash program memory (Rev. 1 and 2: 128KB flash)
-* 2MB external flash memory for storage
+* STM32 F3 ARM Cortex-M processor with 128KB or 256KB flash program memory (Rev. 1 and 2: 128KB flash, Rev 3 256K).
+* 2MB external flash memory for storage.
 * MPU6050 accelerometer/gyro (Rev. 2: MPU6000)
 * BMP280 Barometer
+* No compass sensor.
 * 3 hardware UARTs (+ 2 software) for GPS, telemetry, OSD, etc., 5V compatible
 * On-board 5V/0.5A BEC directly powered off 2-6S main battery pack. No external BEC/regulator necessary.
 * On-board 3.3V regulator to power peripherials like Spektrum satellite receiver.
-* No compass option available
 * 36x36mm board with 30.5mm mounting holes pattern (same as CC3D or Naze32, but different pin-out).
 
+Note: Earlier revisions had issues with the buzzer circuit. 
 
 ## Serial Ports
 
@@ -26,6 +29,7 @@ The RMRC Seriously Dodo board is made and sold by Ready Made RC. In terms of CPU
 ## Pinouts
 
 ### Starboard (Front to back)
+
 | Label                  | Notes                                   |
 |:----------------------:|:---------------------------------------:|
 | RC_IN_8/SOFTSERIAL2_TX | RC8 ppm input or soft-serial 2 transmit |
@@ -39,7 +43,8 @@ The RMRC Seriously Dodo board is made and sold by Ready Made RC. In terms of CPU
 | 5V                     | 5V bus                                  |
 | GND                    | Ground                                  |
 
-### Back (Port to starboard)
+### Back (Left to right)
+
 | Label              | Notes                                |
 |:------------------:|:------------------------------------:|
 | SPEKTRUM_VCC/3V3   | 3.3V output                          |
@@ -49,7 +54,8 @@ The RMRC Seriously Dodo board is made and sold by Ready Made RC. In terms of CPU
 | BAT+               | Main battery (2S - 6S) positive lead |
 | GND/BAT-           | Main battery negative lead           |
 
-### Front (Port to starboard)
+### Front (Left to right)
+
 | Label       | Notes                                                             |
 |:-----------:|:-----------------------------------------------------------------:|
 | BZ_5V/BZ+   | 5V, connect to positive (+) terminal of buzzer                    |
@@ -66,6 +72,7 @@ The RMRC Seriously Dodo board is made and sold by Ready Made RC. In terms of CPU
 | LED_GND/GND | Ground                                                            |
 
 ### Starboard (Front to back)
+
 | Label      | Column  | Notes                                                   |
 |:----------:|:-------:|:-------------------------------------------------------:|
 | GND        | Outside | Ground                                                  |
@@ -87,13 +94,15 @@ The RMRC Seriously Dodo board is made and sold by Ready Made RC. In terms of CPU
 2. Can be used to power external low-power devices like Spektrum satellite receiver.
 
 ### Top pads
+
 | Label | Notes                                                        |
 |:-----:|:------------------------------------------------------------:|
 | CURR  | Current sensor ADC input, unbuffered                         |
 | RSSI  | RSSI ADC input, unbuffered. Use PPM_RSSI for filtered input. |
 | BOOT  | BOOT jumper for recovering a bricked boot loader             |
 
 ### Bottom pads
+
 | Label | Notes                                                                   |
 |:-----:|:------------------------------------------------------------------------|
 | TRIG  | Trigger for sonar (on-board 1kOhm series resistor for 5V compatibility) |

diff --git a/docs/Boards.md b/docs/Boards.md
@@ -2,22 +2,29 @@
 
 The current focus is geared towards flight controller hardware that use the STM32F303 and legacy STM32F103 series processors.  The core logic is separated from the hardware drivers, porting to other processors is possible.
 
-The core set of supported flyable boards are:
+If you want a fully featured version of Cleanflight then the recommendation for new purchases is an STM32 F3 based board with 256KB of flash memory.  The F3 processor is faster, has built in USB support and supports more hardware without the need for additional adaptors and cables.
+
+The core set of recommended boards are:
+
+* Seriously Pro SPRacingF3
+* TBS Colibri Race
+* AlienWiiF3
+* TauLabs Sparky
+
+The core set of legacy boards are:
 
 * AlienWii32
-* CC3D
+* OpenPilot CC3D
 * CJMCU
 * Flip32+
-* Naze32
-* RMDO (RMRC Dodo)
-* Sparky
-* SPRacingF3
+* AbuseMark Naze32
+* RMRC Dodo
 
 Cleanflight also runs on the following developer boards:
 
-* STM32F3Discovery
-* Port103R
-* EUSTM32F103RB
+* STM32F3Discovery - Recommended for developers.
+* Port103R - Recommended for F1 developers.
+* EUSTM32F103RB - Legacy.
 
 There is also limited support for the following boards which may be removed due to lack of users or commercial availability.