An example of writing a firmware solution to send data to Microsoft IoT Central and to receive events back from Microsoft IoT Central to be processed by the device. You are free to take this code and the concepts used, and use them as a basis for your own firmware for Microsoft IoT Central.
The aim of this firmware and code is two-fold:
- To provide a good "out of the box" experience for someone wanting to connect a device to Microsoft IoT Central and see real data sent to Microsoft IoT Central. The firmware was designed to simplify the onboarding experience via a web UX configuration and allow non-developer users to get a device onto Microsoft IoT Central very easily.
- To illustrate how to write a functioning firmware for a Raspberry Pi. The code pulls together many of the individual samples available in the Azure IoT device SDK into a cohesive story, using relatively simple code.
- Simple onboarding via a web UX (http://<ip-of-raspberry-pi>/start)
- Web page shows the current status of the device (http://<ip-of-raspberry-pi>/stats)
-
- Telemetry sent for all onboard sensors (configurable)
- State change telemetry sent when the joystick is pressed in a direction (NORMAL, CAUTION, DANGER, EXTREME-DANGER)
- Reported twin property die number is sent when shaking the device (uses accelerometer sensor data)
- Desired twin property to simulate turning on a fan (fan sound plays from onboard headphone jack)
- Desired twin properties of current and voltage of the device (trigger a bar graph animation)
- Desired twin property of IR blaster (compatible with the MXChip variant but with no IR blaster on the board it just does an animation on the LED matrix)
- Cloud to device messages (supports sending a message to display on the screen)
- Direct twin method calls (supports asking the device to play a rainbow sequence on the RGB LED)
- LED status of network, Azure IoT send events, Azure IoT error events, and current device state (NORMAL=green, CAUTION=amber, DANGER=red)
You will need the following hardware for the project:
- A Raspberry Pi 2/3 connected to the internet RaspberryPi.org
- A microSD card 8GB or larger
- A Pi Sense hat here
- Keyboard, mouse, HDMI monitor, micro USB cable, and USB power supply (you can use your computer to power the Rapberry Pi 3)
- An active internet connection (either via Ethernet cable or WiFi)
* if you don't have a Pi Sense Hat you can use the built in Sense Hat emulator built into the Raspberry Pi operating system
You should install the latest Raspian operationg system by following these instructions (https://www.raspberrypi.org/learning/software-guide/)
Please visit our general documentation site for a tutorial on how to connect the device to Microsoft IoT Central.
At any point you can reconfigure the device by going to the configuration web page at (http://<ip-of-raspberry-pi>/start) and changing any of the values. After making changes to the device it is necessary to stop and restart the python process to ensure the new configuration is picked up.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.