Stuffly is an IoT app built during the Andela IoT Hackathon. It basically gives real time updates on temperature, humidity and air-pressure for a particular room. Through this, we can determine if a room is stuffy or not — hence the name stuffly.
We've currently built a client Slack bot for Andela Slack Org, called @stuffly through which you can interact with the IoT app.
Simple digram explaining our setup:
Download and install Arduino IDE for mac here. This adds an Arduino directory (referred to as a sketchbook) into your Documents folder. Go into libraries folder and clone the BME280 libraries
Clone the BME280 repositories to your the sketchbook libraries directory.
cd Arduino/libraries
git clone [email protected]:adafruit/Adafruit_BME280_Library.git
git clone [email protected]:adafruit/Adafruit_Sensor.gitThe components required are as follows:
- Breadboard
- Arduino Microcontroller
- BME 280 Humidity Barometric Pressure Temperature Sensor Breakout
- Jumper cables
- Arduino to USB cable
- External DC Power Supply (for portability)
- Connect Vin to the power supply, 3-5V is fine. Use the same voltage that the microcontroller logic is based off of. For most Arduinos, that is 5V.
- Connect GND to common power/data ground.
- Connect the SCL pin to the I2C clock SCL pin on your Arduino. On an UNO & '328 based Arduino, this is also known as A5, on a Mega it is also known as digital 21 and on a Leonardo/Micro, digital 3.
- Connect the SDA pin to the I2C data SDA pin on your Arduino. On an UNO & '328 based Arduino, this is also known as A4, on a Mega it is also known as digital 20 and on a Leonardo/Micro, digital 2.
This is shown below:
![here] (/stuffly_breadboard.jpg)
The Arduino Uno, and Mega automatically draw power from either the USB connection to the computer or an external power supply. The power source is selected with a jumper, a small piece of plastic that fits onto two of the three pins between the USB and power jacks. Check that it's on the two pins closest to the USB port.
Connect the Arduino board to your computer using the USB cable. The green power LED (labelled PWR) should go on.
You'll need to select the entry in the Tools > Board menu that corresponds to your Arduino.
Select the serial device of the Arduino board from the Tools > Serial Port menu. On the Mac, this should be something with /dev/tty.usbmodem (for the Uno or Mega 2560) or /dev/tty.usbserial (for older boards) in it.
Run this to clone the stuffly repo
git clone https://github.com/andela-anandaa/stuffly.gitMake the read_arduino.sh bash file executable
chmod u+x stuffly/arduino/read_arduino.shOpen stuffly/arduino/arduino.ino on the arduino IDE and click upload to push it on to the board.
Run ./read_arduino.sh to read the temperature, humidity, air pressure levels to an sqlite database.
You can send the following messages to @stuffly bot to get the states of various rooms:
- Is [room] stuffy?
- What is the temperature at [room]?
- What is the humidity at [room]?
We are using the slackbot Python package.
slackbot_settings.py is excluded because of obscuring the API_TOKEN. However, this is the format:
API_TOKEN = "xoxb-xxxxxxxx"
PLUGINS = [
'slackbot.plugins',
'mybot.plugins'
]
To run the Slack bot:
$ cd stuffly
$ python -m bot.bot
- We're using the python-firebase package.
_firebase/config.pyfile is gitignored but this is the format of the content:
config = {
"firebase": "https://<your-firebase-url>.firebaseio.com/"
}- NB: should migrate to using pyfirebase, which is much cleaner.
Big shout-out to the HackHeads team: