Update README

README.md

@@ -1,40 +1,56 @@
 # GP2040 - Multi-platform Gamepad Firmware for RP2040 microcontrollers
 
-The goal of GP2040 is to provide multi-platform compatibility for RP2040-based game controllers. GP2040 currently support XInput on PC, Android, Raspberry Pi and others along with native Nintendo Switch compatibility. It also features such a 1ms response time, Left/Right stick emulation via D-pad and SOCD (Simultaneous Opposite Cardinal Direction) cleaning for the DIY fightstick crowd.
+The goal of GP2040 is to provide multi-platform compatibility for RP2040-based game controllers.
+
+## Features
+
+* XInput (PC, Android, Raspberry Pi, etc.) and Nintendo Switch support
+* Left and Right stick emulation via D-pad inputs
+* 3 SOCD cleaning modes - Neutral, Up Priority (a.k.a. Hitbox), Second Input Priority
+* Low input latency, with default 1000 Hz (1 ms) polling rate in all modes
+* Save options to internal memory
 
 ## Performance
 
-Input latency is tested using the methodology outlined at [WydD's outstanding inputlag.science website](https://inputlag.science/controller/methodology), using the default 1000Hz (1ms) polling rate in the firmware.
+One of the highest priorities of GP2040 is low input latency. Why bother building a custom controller if it's just a laggy, input-missing mess?
+
+Input latency is tested using the methodology outlined at [WydD's inputlag.science website](https://inputlag.science/controller/methodology), using the default 1000 Hz (1 ms) polling rate in the firmware.
+
+| Mode | Poll Rate | Min | Max | Avg | Stdev | % on time | %1f skip | %2f skip |
+| - | - | - | - | - | - | - | - | - |
+| XInput | 1 ms | 0.56 ms | 1.34 ms | 0.86 ms | 0.24 ms | 95.94% | 4.06% | 0% |
+| Switch | 1 ms | 0.56 ms | 1.34 ms | 0.86 ms | 0.24 ms | 95.89% | 4.11% | 0% |
 
-| Mode | Min | Max | Avg | Stdev | % on time | %1f skip | %2f skip |
-| - | - | - | - | - | - | - | - |
-| XInput (1ms polling) | 0.56 ms | 1.34 ms | 0.86 ms | 0.24 ms | 95.94% | 4.06% | 0% |
+## Development
 
-## Building/Customization
+The project is built using the PlatformIO VS Code plugin along with the [Wiz-IO Raspberry Pi Pico](https://github.com/Wiz-IO/wizio-pico) platform package, using the Wiz-IO baremetal (Pico SDK) configuration. Only the Pico SDK is utilized, so there are no external dependencies at this time.
 
-The project is built using the PlatformIO VS Code plugin along with the [Wiz-IO Raspberry Pi Pico](https://github.com/Wiz-IO/wizio-pico) platform package using the baremetal configuration. There are no external dependencies outside of the Pico SDK included in the Wiz-IO platform.
+There are two simple options for building GP2040 for your board. You can either edit an existing board definition, or create your own and configure PlatformIO to build it.
 
-### Edit Existing Definition
+### Edit Definition
 
-Once you have the project loaded into PlatformIO, edit the `include/definitions/RP2040Board.h` file to map your GPIO pins. Then from the PlatformIO environment selector, choose `env:raspberry-pi-pico`. From there you should be able to build or upload the project to you RP2040 board.
+Once you have the project loaded into PlatformIO, edit the `include/definitions/RP2040Board.h` file to map your GPIO pins. Then from the VS Code status bar, use the PlatformIO environment selector to choose `env:raspberry-pi-pico`.
 
-### Create New Definition
+### Create Definition
 
 You can also add a new board definition to `include/definitions`. If you do, perform the following:
 
-* Add `#define` for it in `include/definitions/BoardConfig.h`.
+* Create new board definition file in `include/definitions` with your pin configuration and options.
+* Add `#define` for your new board in `include/definitions/BoardConfig.h`.
 * Add option to `src/RP2040Gamepad.cpp` in the `BOARD_DEFINITION` selection logic.
 * Add a new environment to the `platformio.ini`
-  * Copy from existing env
+  * Copy from existing environment and rename
   * Replace `BOARD_DEFINITION=#` with the number in the `BoardConfig.h` file.
 
-You will now have a new build environment target for PlatformIO.
+You will now have a new build environment target for PlatformIO. Use the VS Code status bar to select your new environment target.
 
-## Usage
+### Building the Project
+
+You should now be able to build or upload the project to you RP2040 board from the Build and Upload status bar icons. You can also open the PlatformIO tab and select the actions to execute for a particular environment. Output folders are defined in the `platformio.ini` file, but they should all default to a path under `.pio/build/${env:NAME}`.
 
-### Layout
+## Usage
 
-The project uses a generic button labeling for gamepad state, which is then converted to the appropriate input type before sending. Here are the mappings of generic buttons to each supported platform/layout:
+GP2040 uses a generic button labeling for gamepad state, which is then converted to the appropriate input type before sending. Here are the mappings of generic buttons to each supported platform/layout:
 
 | Generic | XInput | Switch  | Arcade |
 | ------- | ------ | ------- | ------ |
@@ -57,7 +73,7 @@ Any references to these buttons will use the `XInput` labels in this documentati
 
 ### Home Button
 
-If you do not have a dedicated Home button, but you can activate it via the **`BACK + START + UP`** button combination.
+If you do not have a dedicated Home button, you can activate it via the **`BACK + START + UP`** button combination.
 
 ### Input Modes
 
@@ -90,6 +106,7 @@ SOCD mode is saved across power cycles.
 
 ## Acknowledgements
 
-* Ha Thach for the TinyUSB library and excellent examples.
-* fluffymadness for the [tinyusb-xinput](https://github.com/fluffymadness/tinyusb-xinput) example.
-* Kevin Boone for his [blog post on using RP2040 flash memory as emulated EEPROM](https://kevinboone.me/picoflash.html).
+* Ha Thach's excellent [TinyUSB library](https://github.com/hathach/tinyusb) examples
+* Thomas Fredericks' [Bounce2 Arduino library](https://github.com/thomasfredericks/Bounce2)
+* fluffymadness's [tinyusb-xinput](https://github.com/fluffymadness/tinyusb-xinput) sample
+* Kevin Boone's [blog post on using RP2040 flash memory as emulated EEPROM](https://kevinboone.me/picoflash.html)