This is a library is utilised by all of the sensors manufactured by Advanced Bot Works. As per the description on our website, we have open-sourced all of the code the runs on the sensors. The program that runs on the Sensors can be found in this library and may be edited to help with specific scenarios. The chips in all of the sensors emulate a Spike Prime Colour Sensor and send relevant data across the RED, Green and Blue (RGB) channels.
The code that runs on each sensor can be found in the "examples" folder.
Apologies for the lack of commenting - this will be rectified when I next have time.
This library is designed to work with Arduino IDE versions 2.3.x or later. Testing has not been done on older versions. The sensors are designed to work with LEGO Spike Prime platforms only.
Advanced Bot Works sensors can be purchased from the Advanced Bot Works website. Please read through product descriptions carefully before purchasing to ensure you are not disappointed.
A LEGO Spike Prime Hub will be required to connect to the sensor using the cable that is included in the package.
From there you can use the online version of Spike Prime to program the Spike. Start a new project, When the Spike Hub is connected to your computer, it will appear as a Colour Sensor. From there, you can click the drop down next to the Sensor to see the "Red", "Green" and "Blue" values. These values correspond to what is on the Advanced Bot Works website.
Alternatively, download the LEGO Education SPIKE™ App which will have the same interface.
If you are using version 2.3.4 or later of the Arduino software (IDE), you can use the Library Manager to install this library:
- Download the latest release archive from GitHub as a .ZIP file.
- In the Arduino IDE, open the "Sketch" menu, select "Include Library", then "Add .ZIP Library...".
- Navigate your file explorer to where the Advanced_Bot_Works_Sensors ZIP file is stored and select it.
- Follow any further prompts given.
If this does not work, you can manually install the library:
- Download the latest release archive from GitHub as a .ZIP file and decompress it.
- Rename the folder "Advanced_Bot_Works_Sensors-main" to "Advanced_Bot_Works_Sensors".
- Move the "Advanced_Bot_Works_Sensors" folder into the "libraries" directory inside your Arduino sketchbook directory. You can view your sketchbook location by opening the "File" menu and selecting "Preferences" in the Arduino IDE. If there is not already a "libraries" folder in that location, you should make the folder yourself.
- After installing the library, restart the Arduino IDE.
Several example sketches are available that show how to use the library. You can access them from the Arduino IDE by opening the "File" menu, selecting "Examples", and then selecting "Advanced_Bot_Works_Sensors". If you cannot find these examples, the library was probably installed incorrectly and you should retry the installation instructions above.
Each example corresponds to the actual code uploaded on all the relevant sensor before shipping. Feel free to read through the code to understand how the calculations are performed.
- 2.0.0 (2025-03-07): Added LRF Module to the library.
- 1.0.0 (2024-06-04): Original Release for IR Ring found here