Update readme

subghz/apps/genie-recorder/README.md

@@ -17,6 +17,12 @@ Document sections:
 - [Sub-GHz Read](#sub-ghz-read)
 - [Sub-GHz Saved](#sub-ghz-saved)
 - [Troubleshooting](#troubleshooting)
+- [Sub-GHz application](#sub-ghz-application)
+  - [Read](#read)
+  - [Details](#details)
+  - [No Keys](#no-keys)
+  - [Key Missing](#key-missing)
+- [.GNE file format](#gne-file-format)
 
 ## Description
 This program was written to allow the Flipper Zero to press buttons on a Genie garage door opened and record the rolling code. The goal is to capture all 65,536 signals (which hopefully repeats when it gets to the end).  Our click speed is current 2000ms per click + however long it takes to get the signal.  In practice, it typically takes 2 days to record all of your signals.
@@ -41,11 +47,15 @@ Once completed, the built-in Sub-GHz Read application will know how to playback
 - Step 7. If it is NOT detected, try 390000000.
 
 ## Connecting to remote
-<img src="wiring.png"><p/>
+<img src="wiring.png" width="45%"/>
-WARNING: Do this at your own risk.  You could damage your remote if done improperly or if your remote doesn't support capturing all of the signals.
+<img src="wiring-2.jpg" width="40%"/>
+<p/>
+
+WARNING: Do this **at your own risk**.  You could damage your remote if done improperly or if your remote doesn't support capturing all of the signals.
+
 - Step 1. Open the case off of your garage door remote.
-- Step 2. Connect GND from Flipper to GND pin on the remote.
+- Step 2. Connect GND from Flipper to GND pin on the remote (Shown in green traces).
-- Step 3. Connect A7 from Flipper to the signal pin on the remote.
+- Step 3. Connect A7 from Flipper to the signal pin on the remote (Shown in orange traces - top button, cyan - middle button).
 - Step 4. Put in a fresh battery.
   - Risky Option: Remove the battery and connect 3V3 from Flipper to the battery positive bar on the remote.  Be 100% sure that GND on the Flipper is going to GND on the remote (and not the signal pin) and that no wires are shorting.  If you are not 100% sure, then DON'T DO THIS!  You could damage the remote and the Flipper Zero.
 
@@ -87,3 +97,46 @@ WARNING: Do this at your own risk.  You could damage your remote if done imprope
   - NOTE: If the receiver is out of sync, but within the 16K window, you may need to press the OK button twice.  This will open the garage door and resync the counter on the receiver.
 
 ## Troubleshooting
+
+- If the LED on the remote is not blinking, be sure you have followed the steps in the [Connecting to remote](#connecting-to-remote) section.
+
+- If the application is not detecting the remote, but the LED on the remote is blinking, then perhaps you missed the step in [Installing](#installing) section or the frequency is incorrect.
+
+
+## Sub-GHz application
+### Read
+<img src="subghz/subghz-read.png" width="45%"/>
+<p/>
+
+If the frequency is correct, then you should see the "Genie" entry when you press a button on your remote.  If the frequency is correct (typically 315MHz or 390MHz) then perhaps you missed the step in [Installing](#installing) where you copy the files into the ``lib\subghz\protocols`` directory, or the step where you edit the ``protocol_items`` files?
+
+### Details
+<img src="subghz/subghz-read-details-good.png" width="45%"/>
+<p/>
+
+When a code and the next code is found in the .GNE file, you should see the KEY and the NEXT CODE.  Official firmware does not support the "Send" feature for rolling codes.
+
+### No Keys
+<img src="subghz/subghz-read-details-nokeys.png" width="45%"/>
+<p/>
+
+When the .GNE file does not exists, you will get the "No Keys" error message.  You need to make sure you run the Genie Recorder application to capture the codes first.
+
+### Key Missing
+<img src="subghz/subghz-read-details-keymissing.png" width="45%"/>
+<p/>
+
+When the .GNE file exists, but the key is not found (or the next code is not found), you will get the "Key Missing" error message.  You need to make sure you run the Genie Recorder application to capture the codes first.
+
+## .GNE file format
+The file format is as follows:
+- 2 bytes: "G*" (0x47 0x2A)
+- 1 byte: Major version (0x02)
+- 1 byte: Minor version (e.g. 0x05)
+- 4 bytes: Fix code from remote (matches filename.GNE)
+- 2 bytes: Last sent index
+- 2 bytes: Last saved index (0xFFFF and contents at 0xFFFF indicates full capture)
+- 4 bytes: Reserved for future use.
+- 4 bytes x 65536: The dynamic part of the code (0x00000000 if no code has been received)
+
+The file can be found in the ``SD Card\apps_data\genie`` folder on your Flipper Zero.  The name of the file will match the ending 8 characters of the fix code.