Update README.md

Author: SequoiaSan

README.md

@@ -1,2 +1,101 @@
-# FlipperZero-WiFi-Scanner_Module-ESP8266
- WiFi Scanner Module for FlipperZero based on ESP8266
+# (WIP)
+
+# FlipperZero WiFi Scanner Module
+ WiFi Scanner Module for FlipperZero based on ESP8266.
+ 
+ This module will help you in finding specific access point physical location.  
+ 
+ [![IMAGE ALT TEXT HERE](https://img.youtube.com/vi/_sCst2Ud73Q/0.jpg)](https://www.youtube.com/watch?v=_sCst2Ud73Q)
+ 
+ # Controls
+ On scan page: 
+  * UP - move list up by one
+  * DOWN - move list down by one
+  * OK (short press) - enter monitor mode
+  * OK (long press) - scan again
+  * BACK - exit app
+  
+ In monitor mode:
+  * OK (long press) - scan again
+  * BACK (short press) - return to scan page and scan again
+  * BACK (long press) - exit app
+ 
+ # Help project
+ Feel free to contact me with your proposals and improvements to this projects.
+ 
+ Fork and improve!
+ 
+ Donate if you want to support author ![ua](https://icons.iconarchive.com/icons/wikipedia/flags/16/UA-Ukraine-Flag-icon.png)
+ 
+ [DeStream](https://destream.net/live/SequoiaSan/donate) or [Buy Me a Coffee](https://www.buymeacoffee.com/sequoiasan)
+ 
+ # What do you need
+
+ 1. Wemos D1 Mini (or Mini Pro) or analog
+ 2. FlipperZero
+
+# How to
+
+Flash [firmware](https://github.com/SequoiaSan/FlipperZero-WiFi-Scanner_Module-ESP8266/tree/main/FlipperZero-WiFi-Scanner_Module-ESP8266) on Wemos D1 Mini
+Install EPS8266 board version 2.7.4 for Arduino IDE. I had issues with higher versions.
+
+Compile firmware for FlipperZero with new [application](https://github.com/SequoiaSan/FlipperZero-WiFi-Scanner_Module-ESP8266/tree/main/applications/wifi_scanner)
+
+Use next schematics to solder the WiFi Scanner board for FlipperZero
+
+![image](https://raw.githubusercontent.com/SequoiaSan/FlipperZero-WiFi-Scanner_Module-ESP8266/main/images/Schematics_1.jpg?token=GHSAT0AAAAAABVRKNOAMPFZQFYGK5IMEJRGYWQS3EA)
+
+# How to add new application on FlipperZero
+
+1. Copy [wifi_scanner](https://github.com/SequoiaSan/FlipperZero-WiFi-Scanner_Module-ESP8266/tree/main/applications/wifi_scanner) into [applications](https://github.com/flipperdevices/flipperzero-firmware/tree/dev/applications) folder.
+2. Add new applications category in [/fbt_options.py](https://github.com/flipperdevices/flipperzero-firmware/blob/dev/fbt_options.py) my_apps for example
+<pre>
+FIRMWARE_APPS = {
+    "default": (
+        "crypto_start",
+        # Svc
+        "basic_services",
+        # Apps
+        "basic_apps",
+        "updater_app",
+        "archive",
+        
+        <b># My Apps</b>
+        <b>my_apps",</b>
+        
+        # Settings
+        "passport",
+        "system_settings",
+        "about",
+        # Plugins
+        "basic_plugins",
+        # Debug
+        "debug_apps",
+    ),
+    "unit_tests": (
+        "basic_services",
+        "unit_tests",
+    ),
+}
+</pre>
+3. Add new apps category and our app into [applications/meta/application.fam](https://github.com/flipperdevices/flipperzero-firmware/blob/dev/applications/meta/application.fam)
+```
+App(
+    appid="my_apps",
+    name="My applications for main menu",
+    apptype=FlipperAppType.METAPACKAGE,
+    provides=[
+        "wifi_scanner",
+    ],
+)
+```
+4. Compile with any [method](https://github.com/flipperdevices/flipperzero-firmware/blob/dev/ReadMe.md#compile-everything-1) provided by FlipperZero dev team
+
+# Issues
+
+I tested all the things on a test bench with Wemos D1 and all was good.
+When I soldered protoboard with Wemos D1 mini pro I started to receive exceptions. It seems for some reason Wemos D1 mini doesn't run well on FlipperZero 5V.
+To fast solve the issue I've added an AMS1117 voltage regulator on 5V to drop it to 3V3 and feed the module.
+
+![image](https://raw.githubusercontent.com/SequoiaSan/FlipperZero-WiFi-Scanner_Module-ESP8266/main/images/Schematics_2.jpg?token=GHSAT0AAAAAABVRKNOA5VOS6VEOM66IYFQSYWQS2GA)
+