Merge branch 'master' of https://github.com/pascallanger/DIY-Multiprotocol-TX-Module

Multiprotocol/Validate.h

@@ -90,6 +90,8 @@
 	#undef	GW008_NRF24L01_INO
 	#undef	DM002_NRF24L01_INO
 	#undef	CABELL_NRF24L01_INO
+	#undef	ESKY150_NRF24L01_INO
+	#undef	H8_3D_NRF24L01_INO
 #endif
 
 //Make sure telemetry is selected correctly
@@ -169,4 +171,4 @@
 #endif
 #if MAX_PPM_CHANNELS>16
 	#error MAX_PPM_CHANNELS must be below or equal to 16. The default for this value is 16.
-#endif
+#endif

Multiprotocol/_Config.h

@@ -23,7 +23,7 @@
 //If you know parameters you want for sure to be enabled or disabled which survives in future, you can use a file named "_MyConfig.h".
 //An example is given within the file named "_MyConfig.h.example" which needs to be renamed if you want to use it.
 //To enable this config file remove the // from the line below. It's automatically loaded if the file exists for the AVR platform but not STM32...
-//#define USE_MY_CONFIG
+#define USE_MY_CONFIG
 
 /*******************/
 /*** TX SETTINGS ***/
@@ -63,7 +63,7 @@
 //Allow flashing multimodule directly with TX(erky9x or opentx modified firmwares)
 //Instructions: https://github.com/pascallanger/DIY-Multiprotocol-TX-Module/tree/master/BootLoaders#compiling--uploading-firmware-with-the-flash-from-tx-bootloader
 //To enable this feature remove the "//" on the next line.  Requires a compatible bootloader or upload method to be selected when you use the Multi 4-in-1 Boards Manager definitions.
-//#define CHECK_FOR_BOOTLOADER
+#define CHECK_FOR_BOOTLOADER
 
 /****************/
 /*** RF CHIPS ***/
@@ -201,14 +201,14 @@
 //#define MULTI_TELEMETRY
 
 //Comment a line to disable a specific protocol telemetry
-#define DSM_TELEMETRY				// Forward received telemetry packet directly to TX to be decoded
+//#define DSM_TELEMETRY				// Forward received telemetry packet directly to TX to be decoded
 #define SPORT_TELEMETRY				// Use FrSkyX SPORT format to send telemetry to TX
-#define AFHDS2A_FW_TELEMETRY		// Forward received telemetry packet directly to TX to be decoded
+//#define AFHDS2A_FW_TELEMETRY		// Forward received telemetry packet directly to TX to be decoded
 #define HUB_TELEMETRY				// Use FrSkyD Hub format to send telemetry to TX
-#define AFHDS2A_HUB_TELEMETRY		// Use FrSkyD Hub format to send telemetry to TX
-#define BAYANG_HUB_TELEMETRY		// Use FrSkyD Hub format to send telemetry to TX
-#define HUBSAN_HUB_TELEMETRY		// Use FrSkyD Hub format to send telemetry to TX
-#define CABELL_HUB_TELEMETRY		// Use FrSkyD Hub format to send telemetry to TX
+//#define AFHDS2A_HUB_TELEMETRY		// Use FrSkyD Hub format to send telemetry to TX
+//#define BAYANG_HUB_TELEMETRY		// Use FrSkyD Hub format to send telemetry to TX
+//#define HUBSAN_HUB_TELEMETRY		// Use FrSkyD Hub format to send telemetry to TX
+//#define CABELL_HUB_TELEMETRY		// Use FrSkyD Hub format to send telemetry to TX
 
 //SPORT_POLLING is an implementation of the same polling routine as XJT module for sport telemetry bidirectional communication.
 //This is useful for passing sport control frames from Tx to rx(ex: changing Betaflight PID or VTX channels on the fly using LUA scripts with OpentX).
@@ -231,7 +231,7 @@
 /*************************/
 //In this section you can configure all details about PPM.
 //If you do not plan to use the PPM mode comment this line using "//" to save Flash space, you don't need to configure anything below in this case
-#define ENABLE_PPM
+//#define ENABLE_PPM
 
 /*** TX END POINTS ***/
 //It is important for the module to know the endpoints of your radio.

Multiprotocol/_MyConfig.h

@@ -0,0 +1,35 @@
+//#define FORCE_GLOBAL_ID	0x12345678
+
+#if not defined STM32_BOARD
+	#undef HUBSAN_A7105_INO
+	#undef AFHDS2A_A7105_INO
+
+	#undef DEVO_CYRF6936_INO
+	#undef DSM_CYRF6936_INO
+	#undef J6PRO_CYRF6936_INO
+	#undef WK2x01_CYRF6936_INO
+
+	#undef FRSKYV_CC2500_INO
+
+	#undef CG023_NRF24L01_INO
+	#undef CX10_NRF24L01_INO		// Include Q2X2 protocol
+	#undef ESKY_NRF24L01_INO
+	#undef HISKY_NRF24L01_INO
+	#undef KN_NRF24L01_INO
+	#undef SLT_NRF24L01_INO
+	#undef SYMAX_NRF24L01_INO
+	#undef V2X2_NRF24L01_INO
+	#undef YD717_NRF24L01_INO
+	#undef MT99XX_NRF24L01_INO
+	#undef SHENQI_NRF24L01_INO
+	#undef FY326_NRF24L01_INO
+	#undef FQ777_NRF24L01_INO
+	#undef ASSAN_NRF24L01_INO
+	#undef HONTAI_NRF24L01_INO
+	#undef Q303_NRF24L01_INO
+	#undef GW008_NRF24L01_INO
+	#undef DM002_NRF24L01_INO
+	#undef CABELL_NRF24L01_INO
+	#undef ESKY150_NRF24L01_INO
+#endif
+	

README.md

@@ -1,10 +1,22 @@
-If you like this project and want to support further development [<img style="float:right" src="https://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" title="PayPal - The safer, easier way to pay online!" alt="Donate" />](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted)EUR [<img style="float:right" src="https://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" title="PayPal - The safer, easier way to pay online!" alt="Donate" />](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=FR&item_name=DIY%20Multiprotocol&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted)USD
+# Multiprotocol TX Module
+<img align="right" width=300 src="docs/images/multi.png" />
 
-# Overview of the MULTI-Module
-The **Multiprotocol Tx Module** (or **MULTI-Module**) is a 2.4GHz transmitter module which enables almost any TX to control lot of different models available on the market.  
+The **Multiprotocol Tx Module** (or **MULTI-Module**) is a 2.4GHz transmitter module which enables almost any transmitter to control many different receivers and models, including many popular helicopters, planes, quadcopters, and miniquads.
 
 The source code is partly based on the [Deviation TX project](http://www.deviationtx.com), thanks to all the developers for their great job on protocols.
 
+If you like this project and want to support further development please consider making a [donation](docs/Donations.md).  
+
+<table cellspacing=0>
+  <tr>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&amount=5&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="docs/images/donate_button.png" border="0" name="submit" title="PayPal - Donate €5" alt="Donate €5"/></a><br><b>€5</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&amount=10&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="docs/images/donate_button.png" border="0" name="submit" title="PayPal - Donate €10" alt="Donate €10"/></a><br><b>€10</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&amount=15&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="docs/images/donate_button.png" border="0" name="submit" title="PayPal - Donate €15" alt="Donate €10"/></a><br><b>€15</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&amount=25&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="docs/images/donate_button.png" border="0" name="submit" title="PayPal - Donate €25" alt="Donate €25"/></a><br><b>€25</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="docs/images/donate_button.png" border="0" name="submit" title="PayPal - Donate" alt="Donate"/></a><br><b>Other</b></td>
+  </tr>
+</table>
+
 ## Quicklinks
 * [Download latest releases of the firmware](https://github.com/pascallanger/DIY-Multiprotocol-TX-Module/releases) and [instructions to upload .hex files](docs/Advanced_Manually_Setting_ATmega328_Fuses.md)
 * [Forum on rcgroups](http://www.rcgroups.com/forums/showthread.php?t=2165676)
@@ -93,7 +105,7 @@ The MULTI-Module supports industry standard PPM interface that works with all tr
 Most of the older FM radios support the PPM interface.
 
 If you are the owner of a transmitter that supports the er9X/erSky9X or OpenTX firmwares (Frsky Taranis, Horus or the FlySky TH9X or the Turnigy 9X family) you have the additional option to use a serial protocol to communicate between your Tx and the MULTI-Module. (Owners of Walkera Devo transmitters should look at the [Deviation Tx](http://www.deviationtx.com) project for how to achieve the same end goal). This serial protocol does not require any hardware modifications, but will likely require updating the firmware on your radio. For those willing to do this, there are some nice advantages:
-  - The model protocol selection and binding is done from the Model Settings menu on the Tx
+  - The model protocol selection, associated parameters, failsafe and binding is done from the Model Settings menu on the Tx
   - For telemetry capable transmitters, the telemetry integration is done seamlessly with the Tx firmware. (Note that FrSky TH9X/Turnigy 9X/R transmitters require a telemetry mod to be done before telemetry can work).  Click on the link corressponding to your Tx on the [Transmitters](docs/Transmitters.md) page for more details.
 
 # How to get started?
@@ -104,7 +116,7 @@ If you are the owner of a transmitter that supports the er9X/erSky9X or OpenTX f
 1. Finally, you should visit the setup page for your transmitter by clicking on the link corressponding to your Tx on the [Transmitters](docs/Transmitters.md) page to configure the last few settings before you can fly to your heart’s content!!!!!
 
 # Troubleshooting
-Visit the [Troubleshooting](docs/Troubleshooting.md) page.  Please bear in mind that the MULTI-Module is a complex system of hardware and software and it make take some patience to get it up and running.  Also remember that the developers of the system are actual users of the system.  This means that at any moment in time the system is working perfectly for them.  A corollary to this is that if you are struggling there are likely two scenarios.  First, that the problem is with your hardware or with your configuration, second, and much more unlikely but not impossible scenario, is that you are struggling with a new undiscovered bug.  (The author of this documentation speaks from experience ;-)   Please check the RC Groups forum and search for keywords relating to your problem before posting a reply.  When you do post a reply please so humbly and respectfully – you will find many helpful people there.  In your reply please include as much relevant information as possible and attach compilation output and ```_Config.h``` files as text attachments to keep the forum clean.
+Visit the [Troubleshooting](docs/Troubleshooting.md) page.  Please bear in mind that the MULTI-Module is a complex system of hardware and software and it may take some patience to get it up and running.  Also remember that the developers of the system are actual users of the system.  This means that at any moment in time the system is working perfectly for them.  A corollary to this is that if you are struggling there are likely two scenarios.  First, that the problem is with your hardware or with your configuration, second, and much more unlikely but not impossible scenario, is that you are struggling with a new undiscovered bug.  (The author of this documentation speaks from experience ;-)   Please check the RC Groups forum and search for keywords relating to your problem before posting a reply.  When you do post a reply please so humbly and respectfully – you will find many helpful people there.  In your reply please include as much relevant information as possible and attach compilation output and ```_Config.h``` files as text attachments to keep the forum clean.
 # A final word
 A very big thanks to all the people who have shared their time so graciously to create this great project.  If you come across them on RC Groups, please be kind and show appreciation.  In no particular order:
 * Pascal Langer (rcgroups: hpnuts)
@@ -117,4 +129,4 @@ A very big thanks to all the people who have shared their time so graciously to
 
 Your help would be greatly appreciated.  If protocol reverse-engineering and dev is not your thing then any help with testing and contributing to the documentation would be amazing.  Given the number of different Tx/module hardware/RF module/protocol/model combinations the process of testing and documenting is a major bottleneck for the developers.  Anything you can do to help will free them up to do even greater things. 
 
-If you like this project and want to support further development [<img style="float:right" src="https://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" title="PayPal - The safer, easier way to pay online!" alt="Donate" />](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted)EUR [<img style="float:right" src="https://www.paypal.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" title="PayPal - The safer, easier way to pay online!" alt="Donate" />](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=FR&item_name=DIY%20Multiprotocol&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted)USD
+If you like this project and want to support further development please consider making a [donation](docs/Donations.md).

docs/Compiling.md

@@ -1,7 +1,9 @@
-# Compiling and Programming (ATmega 328P)
+# Compiling and Programming (ATmega328p)
 
 Multiprotocol firmware is compiled using the Arduino IDE.  The guide below will walk you through all the steps to compile and upload your customized firmware.
 
+**These instructions are for the Atmega328p version of the Multiprotocol module.**  If you are compling for the STM32 version please go to the dedicated [STM32](Compiling_STM32.md) page.
+
 ## Index
 1. [Tools Required](#tools-required)
 1. [Preparation](#preparation)

docs/Donations.md

@@ -0,0 +1,56 @@
+# Donations
+<img align="right" width=300 src="images/multi.png" />
+
+The Multiprotocol firmware is provided for free under the [GNU General Public License v3.0](https://github.com/pascallanger/DIY-Multiprotocol-TX-Module/blob/master/LICENSE).  The developers do not receive any payment from any of the manufacturers of Mulitprotocol Modules which use this firmware.
+
+If you like this project and enjoy using it, please consider making a donation.  Donations are used to fund test hardware to develop and integrate more models.
+
+Donations to the Multiprotocol project can be made via PayPal.  Just click on a value, or click 'Other' to set your own amount.
+
+Every donation helps and is greatly appreciated, no matter the amount!
+
+<div align=center>
+<table cellspacing=0>
+  <tr>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&amount=5&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate €5" alt="Donate €5"/></a><br><b>€5</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&amount=10&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate €10" alt="Donate €10"/></a><br><b>€10</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&amount=15&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate €15" alt="Donate €10"/></a><br><b>€15</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&amount=25&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate €25" alt="Donate €25"/></a><br><b>€25</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate" alt="Donate"/></a><br><b>Other</b></td>
+  </tr>
+</table>
+</div>
+
+### Donate in other currencies
+<details>
+  <summary><b>US Dollars</b></summary>
+<div align=center>
+<br>
+<table cellspacing=0 cellpadding=0>
+  <tr>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=USD&amount=5&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate $5" alt="Donate $5"/></a><br><b>$5</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=USD&amount=10&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate $10" alt="Donate $10"/></a><br><b>$10</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=USD&amount=15&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate $15" alt="Donate $15"/></a><br><b>$15</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%25Multiprotocol&currency_code=USD&amount=25&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate $25" alt="Donate $25"/></a><br><b>$25</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate" alt="Donate"/></a><br><b>Other</b></td>
+  </tr>
+</table>
+</div>
+</details>
+<details>
+  <summary><b>GB Pounds</b></summary>
+<div align=center>
+  <br>
+<table cellspacing=0>
+  <tr>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=GBP&amount=5&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate £5" alt="Donate £5"/></a><br><b>£5</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=GBP&amount=10&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate £10" alt="Donate £10"/></a><br><b>£10</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=GBP&amount=15&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate £15" alt="Donate £10"/></a><br><b>£15</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%25Multiprotocol&currency_code=GBP&amount=25&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate £25" alt="Donate £25"/></a><br><b>£25</b></td>
+    <td align=center width=200><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=VF2K9T23DRY56&lc=US&item_name=DIY%20Multiprotocol&currency_code=GBP&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHosted"><img src="images/donate_button.png" border="0" name="submit" title="PayPal - Donate" alt="Donate"/></a><br><b>Other</b></td>
+  </tr>
+</table>
+</div>
+</details>
+<br>
+Thank you for your support!

docs/Hardware.md

@@ -1,23 +1,86 @@
-# Hardware Options for your MULTI-Module
+# Multiprotocol Module Hardware Options
 
-The choice of **Multiprotocol Transmitter Module (MULTI-Module)** hardware is the single biggest choice you will make.  Due to the growing popularity of this project the number of hardware choices is growing almost monthly.  
+This project started as a DIY effort, with all hardware being scratch-built.  While building your own hardware is still an option (and all the details for doing it are here in the documentation) there are now multiple ready-made modules available to purchase for around US$30-40.
 
-There are currently four common hardware options.  They are (`click on the pictures for more info`):
+**Note:** This project is not affiliated or associated with any manufacturer of Multiprotocol modules.  They are typically produced by Chinese manufacturers who took the intellectual property from this project and produced the modules for profit, with no consideration given to the original inventors.  While this is beneficial to hobbyists and consumers as it makes the modules easy to obtain, it is frustrating for the original developers.  Please bear that in mind if asking for help or support.
 
-1. A ready-made 4-in-1 MULTI-Module which integrates the microcontroller with all four supported RF modules and a hardware antenna switcher.  
-[<img src="images/4-in-1_Module_BG.jpeg" width="200" height="200" />](Module_BG_4-in-1.md)
-1. A DIY MULTI-Module made using one of the PCBs that are available and soldering on your own components. The picture below shows an example of one before RF modules have been soldered on.  
-[<img src="images/Multiprotocol_3.2.jpeg" width="150" height="200" />](Module_Build_yourself_PCB.md)
-1. A MULTI-Module based on the OrangeRx DSM transmitter module that natively supports the built in CYRF6936 RF module. This module can be improved with Mulitprotocol firmware in serial mode only:  
-   - Now works with most (all) DSM bind-and-fly models  
-   - Supports the Devo protocols
-   - Supports the J6Pro protocols   
-   - Supports the Walkera protocols   
-[<img src="images/OrangeRx_Module.jpg" width="250" height="200" />](Module_OrangeRx.md)
-1. A scratchbuilt MULTI-Module using perfboard, an Arduino Pro-Mini and the desired RF modules.
-Unless you are handy with a soldering iron and you have access to electronic test equipment (like an oscilloscope) you should consider only Option 1.  For a price of about $44 you can get everything you need, neatly assembled 
+## Hardware
+The Multiprotocol hardware essentially consists of a PCB, a microprocessor, and a 4-in-1 RF module.  
 
-[<img src="images/Module_perfboard1.jpeg" width="150" height="200" />  <img src="images/Module_perfboard2.jpeg" width="150" height="200" />](Module_Build_From_Scratch.md)
+Original scratch-built modules were based on an Arduino Pro-Mini, which shares the same Atmega328p 8-bit microprocessor, with 32KB of flash, as the later Atmega328p PCB modules.  With only 32KB of flash the original modules could not support all of the available protocols and builders had to choose to enable and disable protocols when building the firmware.
 
-Click on any of the images above to understand more about each option.
+The current state-of-the-art module is based on a 32-bit ARM Cortex-M3 microcontroller, with 128KB of flash and 20KB of RAM. The STM32 modules are only just over half full with all protocols enabled.  For this reason an STM32 module is highly recommended.
 
+## DIY Modules
+The details for the DIY projects can be found [here](Module_Build_yourself_PCB.md). You should be competent and confident with a soldering iron to attempt this, and have the tools to troubleshoot it if there are problems.
+
+| **Scratch-built Atmega328p** | **DIY Atmega328p PCB Module** | **DIY STM32 PCB Module** |
+| :---: | :---: | :---: |
+| <img src="images/Module_perfboard2.jpeg" width="150" /> | <img src="images/MPTM_PCB_3.2d.png" width="150" /> | <img src="images/Board_PCB_STM32.jpeg" width="150" /> |
+
+For most people, purchasing a ready-made module is the best option.
+
+## Ready-made Modules
+These are examples of the well-known ready-made Multiprotocol modules.  Inclusion in this list is not an endorsement or recommendation.  The list is in no particular order
+
+| **Module** | **Image** | **MCU** | **Approx. Cost** | **Notes** | **Link** |
+| :---: | :---: | :---: | :---: | :--- | :--- |
+| **'Banggood' 4-in-1 Atmega328p** | <img src="images/4-in-1_Module_BG.jpeg" width="200"/> | [Atmega328p](Compiling.md "Firmware compiling and uploading instructions for Atmega328p") | US$32 | <ul><li>Limited flash space</li><li>No case included</li><li>Serial and PPM</li></ul> | [Banggood](https://www.banggood.com/2_4G-CC2500-A7105-Flysky-Frsky-Devo-DSM2-Multiprotocol-TX-Module-With-Antenna-p-1048377.html) |
+| **'Banggood' 4-in-1 STM32** | <img src="images/bg-stm32-module.jpg" width="200"/> | [STM32F103C](Compiling_STM32.md "Firmware compiling and uploading instructions for STM32") | US$37 | <ul><li>No case included</li><li>Serial and PPM</li></ul> | [Banggood](https://www.banggood.com/2_4G-CC2500-NRF24L01-A7105-CTRF6936-4-IN-1-Multi-protocol-STM32-TX-Module-With-Antenna-p-1153902.html) |
+| **iRangeX IRX4 STM32** | <img src="images/irx4.jpg" width="200"/> | [STM32F103C](Compiling_STM32.md "Firmware compiling and uploading instructions for STM32") | US$39 | <ul><li>Includes case</li><li>Serial mode only</li></ul> | [Banggood](https://www.banggood.com/IRangeX-IRX4-2_4G-CC2500-NRF24L01-A7105-CTRF6936-4-IN-1-Multiprotocol-STM32-TX-Module-With-Case-p-1197130.html) |
+| **iRangeX IRX4 Plus STM32** | <img src="images/irx4-plus.jpg" width="200"/> | [STM32F103C](Compiling_STM32.md "Firmware compiling and uploading instructions for STM32") | US$37 | <ul><li>Includes case</li><li>Has USB port and LED</li><li>Serial and PPM</li></ul> | [Banggood](https://www.banggood.com/IRangeX-IRX4-Plus-2_4G-CC2500-NRF24L01-A7105-CYRF6936-4-IN-1-Multiprotocol-STM32-TX-Module-With-Case-p-1225080.html) |
+
+*Table last updated November 29th, 2017*
+
+#### OrangeRx Module
+It is also possible to upload the Multiprotocol firmware to an STM32-based OrangeRx DSM module, with support only for the built in CYRF6936 RF module.
+
+When flashed with with Mulitprotocol firmware, the OrangeRx:
+* Operates in serial mode only
+* Works with all DSM bind-and-fly models
+* Supports the Devo protocols
+* Supports the J6Pro protocols
+* Supports the Walkera protocols
+
+**Note:** With the availability of better equipped ready-made 4-in-1 modules the OrangeRx is not a recommended option, and is included here for completeness.
+
+## Module Cases
+Whether DIY or ready-made, your module will need a case.  You may buy a module which comes with a case, a module and a separate case, or you can 3D-print your own case.
+
+**Note:** Make sure you select a case which is compatible with your module PCB - the Atmega328p and STM32 boards have the screws in different positions.
+
+### Ready-made Cases
+You can buy a ready-made case from Banggod for a few dollars:  
+<a href="https://www.banggood.com/Multi-Protocol-TX-Transmitter-Module-Case-for-FrSky-FlySky-Transmitter-p-1085320.html"><img src="images/bg-case.jpg" width="200"/>
+
+### DIY 3D Printed Cases
+Some examples of the Multiprotocol module cases which are available on Thingiverse:
+<div align=center>
+  
+| <a href="https://www.thingiverse.com/thing:1992057"><img src="images/multi-case-1.jpg" width="200"/></a> | <a href="https://www.thingiverse.com/thing:2446111"><img src="images/multi-case-2.jpg" width="200"/> | <a href="https://www.thingiverse.com/thing:1852868"><img src="images/multi-case-3.jpg" width="200"/></a>| 
+|:---:|:---:|:---:|
+  
+</div>
+
+More are available if you [search Thingiverse](https://www.thingiverse.com/search?q=multi+protocol+case).  
+
+#### Turnigy 9XR Internal Antenna Case
+For Turnigy 9XR and 9XR Pro owners, there is a case which allows the Multiprotocol module to connect to the internal antenna, which means nothing is sticking out of the radio back.
+
+<div align=center>
+  
+ | <a href=http://www.thingiverse.com/thing:2050717><img src="images/9xr-case-1.jpg" width="200" /></a> | <a href=http://www.thingiverse.com/thing:2050717><img src="images/9xr-case-2.jpg" width="200" /></a>  | <a href=http://www.thingiverse.com/thing:2050717><img src="images/9xr-case-3.jpg" width="200" /></a> |
+| :---: | :---: | :---: |
+
+</div>
+
+You can also find this case on [Thingiverse](http://www.thingiverse.com/thing:2050717).
+
+---
+#### Multiprotocol Support
+The main support forum for the Multiprotocol Module is [this](https://www.rcgroups.com/forums/showthread.php?2165676-DIY-Multiprotocol-TX-Module/) RCGroups forum thread.  Support is provided for DIY hardware, firmware configuration, compilation and uploading, and using the RF protocols.  Support is *not* provided for hardware problems with ready-made modules (you should contact the vendor/manufacturer).
+
+#### Donations
+The Multiprotocol firmware is provided for free under the [GNU General Public License v3.0](https://github.com/pascallanger/DIY-Multiprotocol-TX-Module/blob/master/LICENSE).  The developers do not receive any payment from any of the manufacturers of Multiprotocol Modules which use this firmware.
+
+If you like this project and enjoy using it, please consider [making a donation](Donations.md).  Donations are used to fund test hardware to develop and integrate more models.

docs/Transmitters.md

@@ -38,7 +38,7 @@ This serial protocol does not require any hardware modifications, but **will** r
 Transmitter|Firmware Options|Telemetry Enabled
 :----------|:---------------|:----------------
 [FrSky Taranis X9D/X9D+/9XE](Tx-Taranis.md)| erSky9x, OpenTx 2.1.9 Multi, OpenTX 2.2 (multimodule option)|Yes - native
-[Frsky Taranis Q X7/Horus](Tx-Taranis.md)| OpenTX 2.2 (multimodule option)| Yes - native
+[Frsky Taranis Q X7/Horus](Tx-Taranis.md)| ersky9x, OpenTX 2.2 (multimodule option)| Yes - native
 [Turnigy 9X/9xR](Tx-FlyskyTH9X.md)|er9x|[Mod required](#Telemetry_Mod)
 [Turnigy 9XR-Pro](Tx-erSky9X.md)|erSky9x|Yes - native
 [FlySky TH9x](Tx-FlyskyTH9X.md)|er9x|[Mod required](#Telemetry_Mod)
@@ -68,7 +68,6 @@ You can see Midelic's original instructions [here](http://www.rcgroups.com/forum
 
 
 ## Other Notes:  
-- er9X and erSky9X firmware already supports Multiprotocol Module as a standard feature.  The next major release of OpenTx - OpenTx 2.2 - will have DIY Mulitprotocol support as a standard feature.  
 
 - Owners of Walkera Devo transmitters should look at the [Deviation-Tx](http://www.deviationtx.com) project for how to achieve the same end goal with your transmitters.