Merge pull request #70 from Legion2/arduino-ide-improvements

Added a step by step guide in Readme #62

Author: Legion2

README.md

@@ -1,4 +1,3 @@
-
 [![arduino-library-badge](https://www.ardu-badge.com/badge/Corsair%20Lighting%20Protocol.svg?)](https://www.ardu-badge.com/Corsair%20Lighting%20Protocol)
 ![Test Status](https://github.com/Legion2/CorsairLightingProtocol/workflows/Test/badge.svg)
 
@@ -13,14 +12,20 @@
 * Use multiple devices at the same time.
 * Repeat or scale LED channels to arbitrary size.
 
+### Supported Devices
+* Lighting Node PRO
+* Commander PRO
+* Lighting Node CORE
+* Smart Lighting Controller (LS100)
+
 ![Overview](docs/Overview.png)
 
 # Getting started
 
 - [Requirements](#requirements)
 - [Install the library](#install-the-library)
 - [Create a Lighting Node PRO](#create-a-lighting-node-pro)
-- [Use the library](#use-the-library)
+- [Use the Lighting Node PRO](#use-the-lighting-node-pro)
 
 ## Requirements
 The library is compatible with all boards using the MCU ATmega32U4.
@@ -29,24 +34,30 @@ It also supports the Arduino Uno and Arduino Mega, **but** this requires the [Ho
 It is **not** compatible with Arduino Nano.
 In the rest of the documentation "Arduino" is used as a synonym for all supported boards regardless of the manufacturer.
 
-As an IDE [Visual Studio](https://visualstudio.microsoft.com/downloads/) with the extension [Visual Micro](https://marketplace.visualstudio.com/items?itemName=VisualMicro.ArduinoIDEforVisualStudio) is recommended.
-Visual Micro provides the required functionality for free, but sometimes ask you to buy the full version.
-Using the Arduino IDE is difficult, but you can find a tutorial in the [wiki](https://github.com/Legion2/CorsairLightingProtocol/wiki/How-to-use-Arduino-IDE).
-
 You have problems with a board not listed here, please open an [Issue](https://github.com/Legion2/CorsairLightingProtocol/issues).
 
 ## Install the library
-Use the [Library-Manager](https://www.visualmicro.com/page/User-Guide.aspx?doc=Library-Manager.html#) to install this library (Corsair Lighting Protocol).
+Use the [Library-Manager](https://www.ardu-badge.com/Corsair%20Lighting%20Protocol/ide) to install this library (Corsair Lighting Protocol).
 Additionally, the [FastLED](http://fastled.io/) library must be installed.
 
 ## Create a Lighting Node PRO
-Open the example "LightingNodePRO", you can find it in the Visual Micro Explorer or the [examples directory](examples).
-The library [FastLED](http://fastled.io/) is used to control the LEDs. For more information on [how to wire the leds](https://github.com/FastLED/FastLED/wiki/Wiring-leds) and [how to set up the LEDs in the code](https://github.com/FastLED/FastLED/wiki/Basic-usage#setting-up-the-leds) see the links.
-After you have done the wiring or at least know which pin is the data pin, you can set this pin in the example sketch and upload it to the Arduino.
-In Visual Studio use the "Release" [configuration](https://github.com/MicrosoftDocs/visualstudio-docs/blob/master/docs/debugger/how-to-set-debug-and-release-configurations.md#change-the-build-configuration).
+This guide will teach you how to create a Lighting Node PRO with an Arduino Leonardo compatible board.
+If you have an Arduino Uno or Mega, see the [other guide](https://github.com/Legion2/CorsairLightingProtocol/wiki/How-to-use-on-Arduino-Uno-and-Arduino-Mega).
 
-To verify that the library works as expected, open the Windows settings -> devices -> connected devices. Somewhere in the list of devices, there should be a device called "Lighting Node PRO". (If not, please open an [Issue](https://github.com/Legion2/CorsairLightingProtocol/issues))
-Open [iCUE](https://www.corsair.com/icue) there should also be the "Lighting Node PRO".
+1. Open the example "LightingNodePRO", you can find it in Arduino IDE in the File menu->Examples->Corsair Lighting Protocol->LightingNodePRO or in the [examples directory](examples) if you download this project.
+
+   ![open example sketch](docs/open-example.png)
+1. Follow [these steps](https://github.com/Legion2/CorsairLightingProtocolBoards#how-to-use-these-boards-in-arduino) to install the CLP Boards and upload the sketch to your Arduino.
+1. Do the wiring.
+   For more information on [how to wire the leds](https://github.com/FastLED/FastLED/wiki/Wiring-leds) and [how to set up the LEDs in the code](https://github.com/FastLED/FastLED/wiki/Basic-usage#setting-up-the-leds) see the links.
+   
+   ![the wiring](docs/board-wiring.jpg)
+1. Verify that your device works as expected.
+   Open the Windows settings->devices->Other devices.
+   Somewhere in the list of devices, there should be a device called "Lighting Node PRO".
+1. Now open [iCUE](https://www.corsair.com/icue) there should be the "Lighting Node PRO".
+
+## Use the Lighting Node PRO
 
 ![iCUE RGB Strip example](docs/iCUE.jpg)
 
@@ -55,19 +66,12 @@ iCUE groups the LEDs into groups of ten.
 So if you have 20 LEDs, set the amount to 2.
 Now you can create lighting effects in the "Lighting Channel #" tabs.
 
-The example "SingleStripLightingNodePRO" only requires one LED strip connected to the Arduino.
-Because the "SingleStripLightingNodePRO" concatenate the two channels, a total of 120 LEDs can be controlled on a single LED Strip.
-
-## Use the library
-If you want to use this library in your own sketch don't forget to use Visual Studio as IDE and include the [board.txt](examples/LightingNodePRO/board.txt) in the root directory of your sketch.
-
 # Misc
 
 - [API Documentation](https://legion2.github.io/CorsairLightingProtocol/)
 - [How it works](#how-it-works)
 - [Use multiple Devices](#use-multiple-devices)
 - [Repeat or scale LED channel](#repeat-or-scale-led-channel)
-- [Debugging](#debugging)
 
 ## How it works
 This library uses the USB HID interface of the Arduino Micro or Leonardo.
@@ -76,6 +80,7 @@ After uploading a sketch with the library and these IDs, iCUE recognizes the Ard
 In iCUE you can then select the "Lighting Node PRO" and set some lighting effects.
 iCUE sends these via the CorsairLightingProtocol to the Arduino.
 These commands are understood by the library and converted into lighting effects on the RGB strips connected to the Arduino.
+The [FastLED](http://fastled.io/) library is used to control the LEDs.
 
 ## Use multiple Devices
 Each device has two unique IDs, that is, they should be unique.
@@ -93,7 +98,7 @@ The DeviceID can be set with the `setDeviceID` function of `CorsairLightingFirmw
 ```C++
 void setup() {
     byte deviceId[4] = { 0x9A, 0xDA, 0xA7, 0x8E };
-    firmware.setDeciceID(deviceId);
+    firmware.setDeviceID(deviceId);
     ...
 }
 ```
@@ -106,11 +111,10 @@ After that, you can upload another sketch.
 
 ## Repeat or scale LED channel
 You can repeat or scale LED channel controlled by iCUE onto physical LED strips.
-This is very useful if you have very long LED strips that are longer than 60/96 LEDs.
+This is very useful if you have very long LED strips that are longer than 60/96/135 LEDs.
 This is the maximum number iCUE supports.
 
 To repeat or scale a LED channel you must apply the `CLP::repeat` or the `CLP:scale` function in the update hook of the FastLEDController.
-The functions must be included from `FastLEDControllerUtils.h`.
 See the [RepeatAndScale](examples/RepeatAndScale/RepeatAndScale.ino) example for the complete code.
 Both functions take the FastLEDController pointer and the channel index as arguments.
 Additionally, the `repeat` function takes as an argument how often the LED channel should be repeated.
@@ -122,21 +126,6 @@ Then the third argument of the `scale` function is `144`.
 For both functions it's **important**, that the CRGB arrays have at least the length of the physical LED strip.
 This means if your LED channel from iCUE has 50 LEDs and you use the `repeat` function to control 100 physical LEDs you MUST declare the CRGB array at least with a length of 100.
 
-## Debugging
-> Note: Only works with Visual Studio
-
-For debugging don't use the integrated debugger of Visual Studio, as it will most likely break the USB communication.
-Use Serial Monitor and upload the sketch with the Debug mode enabled.
-To enable the Debug mode, add the following line to the `board.txt`:
-```
-build.extra_flags={build.usb_flags} -DDEBUG
-```
-If the `board.txt` file already contains `build.extra_flags` add ` -DDEBUG` to the end of the line and remove the `#` at the beginning of the line if there is one.
-
-For advanced debugging you can use the [DebugSketch](examples/DebugSketch/DebugSketch.ino).
-In the board.txt file, the default values for the debugging options can be set.
-After uploading the sketch open the serial monitor with baud rate 115200 and set the line ending to "Line Feed"/"Newline" (`\n`).
-
 # DISCLAIMERS
 This is a DO IT YOURSELF project, use at your own risk!
 
@@ -147,4 +136,5 @@ This is a DO IT YOURSELF project, use at your own risk!
 
 ## Related projects
 - [CorsairArduinoController](https://github.com/TylerSeiford/CorsairArduinoController)
+- [CorsairLightingProtocolBoards](https://github.com/Legion2/CorsairLightingProtocolBoards)
 - [OpenCorsairLighting](https://github.com/McHauge/OpenCorsairLighting)