Updated Sonoff iFan03 (markdown)

Sonoff-iFan03.md

@@ -1,55 +1,49 @@
 (For information on the iFan02 please see here - [iFan02](https://github.com/arendst/Sonoff-Tasmota/wiki/Sonoff-iFan02))
 
 ## Serial Flashing
-
 Please see the [Hardware Preparation](https://github.com/arendst/Sonoff-Tasmota/wiki/Hardware-Preparation) page for general instructions.
 
 Next, please see the [Flashing](https://github.com/arendst/Sonoff-Tasmota/wiki/Flashing) page for general information on the flashing process.
 
-To flash the latest sonoff.bin file to the iFan03:
+To flash the latest `sonoff.bin` file to the iFan03:
-
-1. Connect your serial flashing device to your computer and open the desired flashing software. 
-
-2. If using NodeMCU Pyflasher (recommended) - select the desired sonoff.bin file that you want to flash, the COM port for your serial flasher device and ensure that flash mode "Dual Output (DOUT)" and that a baud rate of "115200" is selected. If you are flashing Tasmota firmware for the first time then also select "yes, wipes all data".
-
-3. Once you are ready to flash your device then hold down the large white tipped button on the iFan03 device and connect the serial flashing device to the iFan03 flashing pins (for connection locations see the pin out on the left hand side of the first picture below). **Do not release the button on the iFan03 until flashing is completed in step 5.**
 
+1. Connect your serial flashing device pins to the iFan03 (for connection locations see the pin out on the left hand side of the picture below).
+   ![](https://github.com/tim-dcl/BRUH3-Home-Assistant-Configuration/blob/master/IMG_20190817_155847511_HDR.jpg)
+2. Once you are ready to flash your device then hold down the large white tipped button on the iFan03 while connecting the serial adapter flashing device to your computer. This will power the adapter and the iFan03. **Do not release the button on the iFan03 until flashing is completed in step 5.**
+3. Open your flashing software window. If using NodeMCU Pyflasher (recommended):
+  - Select the firmware file that you want to flash
+  - Set the COM port for your serial programming adapter
+  - Ensure that flash mode `Dual Output (DOUT)`, and baud rate of `115200` is selected
+  - If you are flashing Tasmota for the first time, also select "yes, wipes all data".
 4. While continuing to hold the button on the iFan03, click on the "Flash NodeMCU" button.
-
+5. Wait until the flashing process is complete and then release the button on the iFan03. Unplug & Re-plug the serial adapter. Wait for the iFan03 to reboot.
-5. Wait until the flashing process is complete and then release the button on the iFan03. Unplug & Re-plug the serial flashing device to the PC. Wait for the iFan03 to reboot.
+6. If this is the first time you have flashed Tasmota on the device, connect to the iFan03 `sonoff-xxxx` Wi-Fi access point and configure your Wi-Fi credentials by opening `192.168.4.1` in a browser. Wait for the iFan03 to reboot.
-
+7. Find the IP address of the iFan03 and navigate to that IP address in any browser. Select "Configure Module" from the "Configuration" menu and select `Sonoff iFan03 (71)` from the drop down list.
-6. Connect to the newly created iFan03 Wifi Access Point and continue the configuration by entering your usual wifi credentials into the correct location. Wait for the iFan03 to reboot.
-
-7. Find the IP address of the iFan03. Navigate to that IP address in any browser, select "Configure Module" from the "Configuration" menu and select "Sonoff iFan03 (71)" from the drop down list.
-
 8. Wait for the iFan03 to restart and then continue any other required or desired configuration.
 
-## Pictures
+## US Ceiling Fans
 
-![](https://github.com/tim-dcl/BRUH3-Home-Assistant-Configuration/blob/master/IMG_20190817_155847511_HDR.jpg)
+The capacitors in the iFan03 do not set the speed of US fans correctly. To correct the speeds for US ceiling fans, you need to remove the existing capacitors from the iFan03 and replace them with equivalently electrically rated 5uF (microfarad) capacitors. **Do NOT do this if you are not comfortable using a soldering iron as improperly performing this action could increase the risk of bodily injury or property damage.**
-![](https://github.com/tim-dcl/BRUH3-Home-Assistant-Configuration/blob/master/IMG_20190817_155853950_HDR.jpg)
 ![](https://github.com/tim-dcl/BRUH3-Home-Assistant-Configuration/blob/master/IMG_20190817_155903267.jpg)
 ![](https://github.com/tim-dcl/BRUH3-Home-Assistant-Configuration/blob/master/IMG_20190817_155910936_HDR.jpg)
+![](https://github.com/tim-dcl/BRUH3-Home-Assistant-Configuration/blob/master/IMG_20190817_155853950_HDR.jpg)
 
-## Remote Pairing
+## RF Remote Control Pairing
 
-To pair the remote after the device has been flashed with the new firmware the device needs to be powered from Mains voltage (not from the USB serial flashing device) **Be careful dealing with Mains Voltages. Ensure that all connections are correctly made and that the iFan03 covers are properly re-assembled**
+To pair the remote control after the device has been flashed with the new firmware, the device needs to be powered from _**mains**_ voltage (not from the USB serial flashing device). **Be careful dealing with mains voltages. Ensure that all connections are correctly made and that the iFan03 covers are properly re-assembled.**
 
-To pair the remote hold down any button on the remote and apply power to the iFan03. Once the device boots up you should hears a series of clicks as the internal relays operate. Once completed you can test the remote and it should all be operational.
+To pair the remote control, hold down any button on the remote control and apply power to the iFan03. Once the device boots up you should hear a series of clicks as the internal relays operate. Once completed you can test the remote and it should all be operational.
 
-## Incorrect Fan Speed for US based Ceiling Fans
+## Home Assistant Configuration
-
-To correct the fan speeds for US based ceiling fans you need to remove the existing capacitors from the iFan03 (see picture 3 above) and replace them with equivalently electrically rated 5uF (microfarad) capacitors. **Do NOT do this if you are not comfortable using a soldering iron as improperly performing this action could increase the risk of bodily injury or property damage**
-
-### HomeAssistant MQTT Fan config
 
+### Fan Speed
 Credit to [finity](https://community.home-assistant.io/t/sonoff-ifan02-tasmota-mqtt-fan/64083/13)
 
 There are two different configurations that need to be used depending on the method of use in Home Assistant.
 
 To use the iFan03 along with the [Fan Control Entity Row](https://github.com/finity69x2/fan-control-entity-row) then use the configuration below:
 
-```
+```yaml
   - platform: mqtt  
     name: "iFan03-2 Test Fan"
     command_topic: "cmnd/iFan03-2/FanSpeed"
@@ -78,9 +72,9 @@ To use the iFan03 along with the [Fan Control Entity Row](https://github.com/fin
       - high
 ```
 
-If you will not be using the Fan Control Row and will be using the regular toggle to control off & on and using the pop up "more info" window to control the speeds then use this configuration:
+If you will be using the regular toggle to control off & on and using the pop up "more info" window to control the speeds then use this configuration:
 
-```
+```yaml
   - platform: mqtt  
     name: "iFan03-2 Test Fan Popup"
     command_topic: "cmnd/iFan03-2/FanSpeed"
@@ -109,9 +103,9 @@ If you will not be using the Fan Control Row and will be using the regular toggl
       - high
 ```
 
-### HomeAssistant MQTT switch config for fan light
+### Fan Light
 
-```
+```yaml
   - platform: mqtt
     name: "iFan03-2 Light"
     command_topic: "cmnd/iFan03-2/power1"