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

README.md

@@ -5,7 +5,7 @@ The source code is partly based on the [Deviation TX project](http://www.deviati
 
 ## 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 rcroups](http://www.rcgroups.com/forums/showthread.php?t=2165676)
+* [Forum on rcgroups](http://www.rcgroups.com/forums/showthread.php?t=2165676)
 * [Available Protocols list](Protocols_Details.md)
 * [The old documentation](docs/README-old.md)
 
@@ -38,10 +38,10 @@ A functioning MULTI-Module consists of (see image below):
   * MULTI-firmware loaded on to the microprocessor.  At a high level, this firmware performs a few different functions: 
      * It interfaces with signals from the host Tx and decodes these for transmission to the model, it manages the activation of the correct hardware RF module for each protocol
      * It implements the unique communication protocols for each receiver/model and manages the all-important binding process with a receiver/model
-     * In the case of some protocols (for example DSMX and FrSky) it receives and decodes the telemetry information and makes this available to the receiver.
+     * In the case of some protocols (for example DSMX and FrSky) it receives and decodes the telemetry information and makes this available to the radio.
 1. The physical 2.4GHz antenna (or in some cases multiple antennas) for the modules
 
-On of the most attractive features of the MULTI-module is the ability to send telemetry signals back to the transmitter. The MULTI-Module is fully telemetry capable for all protocols that support telemetry.  Your ability to use the telemetry information depends on the your transmitter hardware and your transmitter firmware.
+One of the most attractive features of the MULTI-module is the ability to send telemetry signals back to the transmitter. The MULTI-Module is fully telemetry capable for all protocols that support telemetry.  Your ability to use the telemetry information depends on  your radio hardware and firmware.
 
 In constructing a functioning MULTI-Module there are important choices to be made and tradeoffs to be aware of.  The most important are:
 
@@ -59,7 +59,7 @@ For more information on these options see the [hardware](docs/Hardware.md) page
 
 ##**Choice 2:** Which RF modules to include in the MULTI-Module
 
-This depends on your specific needs.  However, recent the availability of the 4-in-1 RF modules from Banggood for less than $35 makes it easy to “have it all”.  Most manufacturers of RC systems (Spektrum, FrSky, FlySky) and toys (Syma, Hubsan, Horizon Hobby, etc.) use one of these four RF chips to manage the RF link between the transmitter and the reciever/model.  Here is an incomplete list of the RF modules and some of the most popular toys that use them.  For the complete list see the [Protocol Details](Protocols_Details.md) page.
+This depends on your specific needs.  However, recent the availability of the 4-in-1 RF modules from Banggood for less than $35 makes it easy to “have it all”.  Most manufacturers of RC systems (Spektrum, FrSky, FlySky) and toys (Syma, Hubsan, etc.) use one of these four RF chips to manage the RF link between the transmitter and the reciever/model.  Here is an incomplete list of the RF modules and some of the most popular toys that use them.  For the complete list see the [Protocol Details](Protocols_Details.md) page.
 
 Manufacturer|RF Chip|Example Protocols
 :-----------|-------|:-------
@@ -80,14 +80,14 @@ For example, if you have no interest in binding your Tx to an model with and FrS
 
 ##**Choice 3:** Which protocols to upload to the MULTI-Module
 
-Of course there always a catch. In this case it is the 32K memory limit on the ATmega328 processor. Due to the amazing work done by devs on this project, the memory required by all the possible protocols exceeds this limit considerably. This means that you will need to make a choice of which protocols you will compile into your firmware.  Fortunately, the process of selecting and compiling is not too difficult and it is fully documented on the [Compiling and Programming](docs/Compiling.md) page.
+Of course there is always a catch. In this case it is the 32KB memory limit on the ATmega328 processor. Due to the amazing work done by devs on this project, the memory required by all the possible protocols exceeds this limit considerably. This means that you will need to make a choice of which protocols you will compile into your firmware.  Fortunately, the process of selecting and compiling is not too difficult and it is fully documented on the [Compiling and Programming](docs/Compiling.md) page.
 Also, the lead dev Pascal Langer (rcgroups:hpnuts) makes this process even easier for many users by making compiled binaries available for three popular combinations of RF modules.  These are always “fresh” (based on the latest stable firmware) and available on the [Releases](https://github.com/pascallanger/DIY-Multiprotocol-TX-Module/releases) page.
 
-Midelic has ported a version the firmware to an STM32 ARM microcontroller.  If you go the route of building this version of the DIY MULTI-Module then the memory limits do not apply.  
+Midelic has ported a version the firmware to an STM32 ARM microcontroller.  If you go the route of building this version of the DIY MULTI-Module then the memory limits do not apply anymore.
 
-##**Choice 4:** Choosing the type of interface between the MULTI-Module and your Tx (PPM or Serial)
+##**Choice 4:** Choosing the type of interface between the MULTI-Module and your radio (PPM or Serial)
 
-The all the MULTI-Module options supports industry standard PPM interface that works with all transmitters with either:  
+The MULTI-Module supports industry standard PPM interface that works with all transmitters with either:  
  - a module bay or
  - a trainer port or
  - any PPM signal that can be accessed inside the Tx.
@@ -95,7 +95,7 @@ The all the MULTI-Module options supports industry standard PPM interface that w
 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 and protocol selection and binding is done from the Model Settings menu on the Tx
+  - The model protocol selection 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?

docs/Module_BG_4-in-1.md

@@ -17,7 +17,7 @@ Plus a module case that fits your module like the one [here](https://www.xtremep
   or you can 3D print your own from a selection on Thingiverse ([Example 1](http://www.thingiverse.com/thing:1852868) [Example 2](http://www.thingiverse.com/thing:1661833)).  
  [<img src="http://thingiverse-production-new.s3.amazonaws.com/renders/55/1c/cb/0a/e4/5d2c2b06be7f3f6f8f0ab4638dd7c6fc_preview_featured.jpg" width="250" height="200" /> ](http://www.thingiverse.com/thing:1852868)
 
-For 9XR/9XR Pro, a new 3D printed module is available which makes use of the built in antenna in the handle. This means nothing is getting out of the radio back! You can find all details of this module case on [thingiverse](http://www.thingiverse.com/thing:2050717).
+For 9XR/9XR Pro, a new 3D printed module is available which makes use of the built in antenna in the handle. This means nothing is getting out of the radio back! You can find all details of this module case on [Thingiverse](http://www.thingiverse.com/thing:2050717).
 
 <img src="images/9XR_module.jpg" width="113" height="200" /> <img src="images/9XR_module_connector.jpg" width="274" height="200" /> 
 
@@ -30,9 +30,9 @@ If you are only planning on using the PPM interface with your transmitter, you n
 
 Some radios have an open collector output (Futaba, Graupner...), in this case you should add a 4.7K resistor between PPM and BATT.
 
-This is valid for any version of the module.
+The same plug is available on all versions of the module with the same signal locations.
 
-You are now ready to go over to [Compiling and Programming](Compiling.md).
+If you wish to add an external device reading the telemetry, you need to enable serial mode as explained in the next topics otherwise you are now ready to go over to [Compiling and Programming](Compiling.md).
 
 ###Serial mode
 If you have a transmitter that can support serial communication with the board then you need to wire up the board appropriately. There are three versions of the module and the steps are slightly different.

docs/Transmitters.md

@@ -1,17 +1,16 @@
 # Compatible Transmitters
 
 
-There are two different options for the interface between the MULTI-Module and the transmitter: PPM and Serial. The considerations are different for each.
+There are two different modes to interface the MULTI-Module and the transmitter: PPM and Serial. The considerations are different for each.
 - **PPM** is more generic, easy to implement and will work with most transmitters. 
 - **Serial** requires custom firmware on the transmitter but brings added functionality including protocol selection through the Tx interface and the option of telemetry (with the right transmitter firmware).
 
-Any Tx that provides a PPM output (like a trainer port, or a transmitter with a RF module bay) is compatible with the MULTI-module.  In practice, most of the documentation on this site is focused on building modules that slip into your transmitter’s module bay. 
+Any Tx providing a PPM output (like a trainer port, or a transmitter with a RF module bay) is compatible with the MULTI-module.
- 
 
 ##PPM
 The DIY Mulitprotocol module supports industry standard PPM interface that works with all transmitters with either a module bay, and/or a trainer port.  Even the older 72MHz FM radios support this standard.
 
-When using the standard PPM Tx output, the protocol selection is achieved through a 16 position rotary switch on the module. This enables 15 protocol/sub-protocol/options combinations to be selected.  Binding is achieved by pressing a bind button on the back of the module (see picture below) 
+When using the standard PPM Tx output, the protocol selection is achieved through a 16 position rotary switch on the module. This enables 15 (0=serial) protocol/sub-protocol/options combinations to be selected.  Binding is achieved by pressing a bind button on the back of the module (see picture below) 
 
 <img src="images/4-in-1_Module_PPM_Controls.jpg" width="150" height="180" /> 
 
@@ -36,10 +35,10 @@ This serial protocol does not require any hardware modifications, but **will** r
 
 Transmitter|Firmware Options|Telemetry Enabled
 :----------|:---------------|:----------------
-[FrSky Taranis/Plus/9XE](Tx-Taranis.md)| erSky9x, OpenTx 2.1.8 Multi|Yes - native
+[FrSky Taranis/Plus/9XE](Tx-Taranis.md)| erSky9x, OpenTx 2.1.9 Multi|Yes - native
-[Turnigy 9X/9xR](Tx-FlyskyTH9X.md)|er9x|[Mod required](#Telemetry_Mod), No DSM telem
+[Turnigy 9X/9xR](Tx-FlyskyTH9X.md)|er9x|[Mod required](#Telemetry_Mod)
 [Turnigy 9XR-Pro](Tx-erSky9X.md)|erSky9x|Yes - native
-[FrSky TH9x](Tx-FlyskyTH9X.md)|er9x|[Mod required](#Telemetry_Mod), No DSM telem
+[FlySky TH9x](Tx-FlyskyTH9X.md)|er9x|[Mod required](#Telemetry_Mod)
 [SKY board](Tx-erSky9X.md)|erSky9x|Yes - native
 [AR9X board](Tx-erSky9X.md)|erSky9x|Yes - native
 [9Xtreme board](Tx-erSky9X.md)|erSky9x|Yes - native
@@ -66,15 +65,10 @@ 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.  At time of writing it looks like that the next major release of OpenTx - OpenTx 2.2 - will have DIY Mulitprotocol support as a standard feature.  
+- 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. 
 
 - To enable telemetry on a Turnigy 9X or 9XR you need to modify your TX [read this.](#Telemetry_Mod).
 
-- DSM telemetry is not available on er9x due to a lack of flash space.
-
-- Enabling telemetry on a 9XR PRO and may be other TXs does not require any hardware modifications. The additional required serial pin is already available on the TX back module pins.
-
 - Once the TX is telemetry enabled, it just needs to be configured on the model (see er9x/ersky9x documentation).
-