Updated User Interface Concepts (markdown)

User-Interface-Concepts.md

@@ -230,6 +230,45 @@ This option only appears if the type is Blind.
 This option only appears when the motor type is Blind and the tilt type is either Integrated or Tilt Motor.  The tilt time is the amount of time it takes for the tilt mechanism to go from fully open to fully closed.  Unlike the up and down (lift) movement the timing is typically the same for open and closed given the way the mechanisms are constructed.
 
 ## Radio Section
-In this section you can configure the settings your CC1101 transceiver and review the communication logs.
+In this section you can configure the settings your CC1101 transceiver and review the communication logs.  There is quite a bit of available tuning that can be done for your transceiver.  These options have evolved over time to accommodate frequency differences and expand the capabilities of the software.
 
 ![image](https://github.com/rstrouse/ESPSomfy-RTS/assets/47839015/0a5c1224-1f9c-4c4a-a04d-9b9f89767368)
+
+### Transceiver Tab
+You can set the communication and configuration parameters for your transceiver from this tab.  Initially you will need to enable the radio in this tab before ESPSomfy RTS can communicate with your motors.
+
+![image](https://github.com/rstrouse/ESPSomfy-RTS/assets/47839015/59aea1a9-ec9d-464f-931c-ae2fdc4d0ba2)
+
+#### 1 - Protocol
+By setting a protocol here ESPSomfy RTS will select this protocol as the default when adding new motors.  See the protocol descriptions from the previous section.  Please note that setting this value here is only the default value that is selected when adding motors to your device.  It will not change the selected protocol for existing motors.
+
+#### 2 - Radio
+This defines the default bit length when adding new motors.  This does not change the communications for existing motors in ESPSomfy RTS.
+
+#### 3 - Enable Radio
+This checkbox enables or disables the transceiver on ESPSomfy RTS. When first installed, the transceiver is disabled so you can ensure the pins are set properly for your device configuration.  For Ethernet connected ESP32 modules it is important that you do not share any pins with the Ethernet module as it can damage it.  Often there are no protections on the Ethernet PHY pins.
+
+#### 4 - SPI Pin Settings
+The CC1101 transceiver is configured using a Serial Peripheral Interface (SPI) communication channel.  These settings must match the pins used on the ESP32 for the corresponding pins on the transceiver module.  Review the documentation for the transceiver you purchased or the hardware section of ESPSomfy RTS wiki to verify these values.  If you cannot get the Radio not Initialized message to go away you most likely have these settings incorrect.
+
+#### 5 - RX/TX Pin Settings
+These settings correspond with the GPIO pins on the ESP32 that are connected to the pins used for GDO0 and GDO2 on the transceiver module.  The important bit to note about the CC1101 settings for this is that the transceiver can only transmit (TX) using the pin labeled GDO0 but it can receive on either GDO0 or GDO2.  So if you are receiving frames from your remote as indicated by the RSSI values changing you have these settings reversed.
+
+ESPSomfy RTS will also allow you to share the transmit (TX) and receive (RX) functions using a single pin connected to GDO0.  Simply set the dropdowns for RX and TX to the same pin connected to GDO0.  ESPSomfy RTS will multiplex (switch the function back and forth) on this single pin when transmitting or receiving.  There is no fundamental advantage to using two pins because the transceiver antenna can only transmit or receive at any given time.
+
+#### 6 - Base Frequency
+Check your motor manual.  In most cases this will be 433.42Mhz but there have been motors out there that use 433.92Mhz.  Match this to the specified frequency.  Also, if you are one of those folks that have a Software Defined Radio (SDR) and want to tune to a different center frequency move the slider left or right to the desired frequency.
+
+#### 7 - RX Bandwidth
+When the transceiver is listening for your remotes, ESPSomfy RTS will tune the radio to narrow in on what is valid signal and what is noise.  Frequencies on the left of the slider are more narrow and frequencies on the right are wider.  Think of the transceiver having smaller ears on the narrower setting and larger ones on the wider section.  Find a sweet spot here by using your remote to determine where it best receives the signal.
+
+#### 8 - Frequency Deviation
+Somfy RTS protocols are transmitted using Amplitude Shift Keying (ASK) meaning the power of the signal passes through a maximum displacement of the signal from low to high to signify a data bit.  This value determines how far it needs to move to determine what is signal and what is simply noise.
+
+#### 9 - TX Power
+In most instances you should set this to the highest transmission level supported by your transceiver.  For most transceivers this is 10dBm.  There are some out there that go as high as 12dBm.  If you are in a jurisdiction that limits your power output reduce it to remain in compliance.  At 10dBm you will be transmitting at a much greater output than the typical Somfy remote.
+
+#### 10 - RSSI Status
+ESPSomfy RTS will display the Radio Signal Strength Indicator (RSSI) for incoming frames.  So when testing your remote and adjusting the radio settings you will see how strong the signal you are receiving is on each button press.  The number next to the RSSI label indicates how many frames it has received and will increment each time it receives a frame.  The large RSSI number will indicate how strong the signal was when the frame was received.
+
+The strongest RSSI value will be closest to 0.  So an RSSI of -20dBm is stronger than a -40dBm signal.  Most antennas will stop picking up signals at around -110dBm and become less reliable around -90dBm.