Software and guides for learning about and building sensors for smart city / smart community applications.
Materials are organized in two areas:
- Wiki - FAQ, getting started guides, component lists, reference books
- Software Programs - source code for runnable programs written in Python, Node.js and bash scripts
The Wiki section holds documentation files such as step-by-step guides for assembling and running your sensors and programs. There are also documents on suggested electronic components, types of sensors, reference books, and other information.
See the Frequently Asked Questions (FAQ) for answers to common questions and What's New to see what's new.
The source code section holds application software programs that operate your sensors and actuators. It's organized in three sub-folders:
- rpi - contains programs for Raspberry Pi
- bbb - contains programs for BeagleBone Black
- gal - contains programs for Galileo
The entire code repository can be downloaded by clicking on this link:
If you're logged onto a device running Linux, such as a Raspberry Pi or BeagleBone Black, you can use the following command line program to download the software programs to your device:
wget https://github.com/IoTDevLabs/iot-educ/archive/master.zip
If you're using Git on the Raspberry Pi or on your laptop, you can clone this repository using the following command. Cloning is optional and is only needed if you want to create your own stand-alone git repository to more thoroughly track your own changes to the source code.
git clone https://github.com/IoTDevLabs/iot-educ.git
These instructions assume you're running the latest version of the Raspbian operating system on your Raspberry Pi and that you have your Pi connected to the Internet.
For a more detailed getting started guide, see the Step by Step: Raspberry Pi document in the Wiki section.
- Log into the Pi.
- Verify you have Internet connectivity:
- ping www.google.com
- If you have Internet connectivity you should see a response that shows a time= value on the right side of each line. If you get a message saying something like 'Destination Host Unreachable' or 'Timeout' or 'No Response' then you don't have a working Internet connection for the Pi. Work on getting your Pi connected to the Internet either through a LAN cable or by using WiFi.
- Download and apply latest operating system updates:
sudo apt-get updatesudo apt-get upgrade1. If upgrades are available, they will be displayed and you will be asked whether to continue. Press Enter to select the default option of Y for yes.- Clone the git repository containing the template code:
git clone https://github.com/IoTDevLabs/iot-educ.git- Install Python packages used by the template code:
cd iot-educ/rpi./install-python-packages.sh- Run the template program to read and print the Pi's CPU temperature:
python read-cpu-temp.py- Each time you run this program you should see the Pi's CPU temperature printed out in both Celsius and Fahrenheit
- Run the template program to continously read and print the CPU temperature and write it to Pi Land room 404:
python cpu-temp-piland.py- When this program runs you should see a URL printed out every 2 seconds and the temperature data value should be appearing in Pi Land room 404 in data slot 1 towards the top left. If you heat or cool the Pi board you should see the temperature change.
From here you can modify the cpu-temp-piland.py program to use your own Pi Land room number, and if you wish, you can modify the device name string and/or data slot number being used.
Once you get this first program working and learn how to modify it for your own room, you can move on to some of the other programs.