Project

raspberry_pi_iot

0.0
No commit activity in last 3 years
No release in over 3 years
raspberry_pi_iotmike-shock/ruby-raspberry_pi_iotHomepageDocumentationSource CodeBug TrackerWiki
A set of classes for IoT (Internet of Things) / physical computing with Raspberry Pi
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Popularity
Downloads
13,628
Stars
5
Forks
0
Watchers
2
 Releases
Current version
0.1.4
Total releases
9
First release
2018-12-13
Latest release
2020-06-04
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2019-09-22
Reverse Dependencies
0

 Dependencies

Development

bundler
~> 1.17
minitest
~> 5.0
rake
~> 10.0
yard
~> 0.9.16

Runtime

dht-sensor-ffi
~> 0.2.0, >= 0.2.0
i2c
~> 0.4.2, >= 0.4.2
i2c-bme280
~> 0.1.2, >= 0.1.2
i2c-devices
~> 0.0.6, >= 0.0.6
rpi_gpio
~> 0.3.3, >= 0.3.3
 Project Readme

Raspberry_Pi_IoT

A Ruby library for IoT (physical computing) projects with Raspberry Pi.

Why I made it.

I'm a software developer and a maker. And I do love Raspberry Pi - it's such a fun to do physical programming! But I love to program in Ruby. So I tried to make a pragmatic set of useful IoT libraries for the Ruby language for all who want to program for Raspberry Pi in Ruby.

This gem is an interfacing library for other Ruby gems that work with different devices on SBCs of Raspberry Pi family.

I taught sachoolchildren in a Raspberry Pi Code Club to write OO-programs that interact with physical devices. And I found Ruby to be a very effective tool in teaching IoT programming.

Installation

To use this library you should do:

  1. Install the Ruby development version (to compile the extensions):
   sudo apt-get install ruby-dev
  1. Download and install the bcm2835-1.xx.tar.gz library, e. g.:
   wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.58.tar.gz

   tar zxvf bcm2835-1.58.tar.gz
   cd bcm2835-1.58
   ./configure
   make
   sudo make check
   sudo make install

  1. For some external gems additional libraries should be installed.

    a) to use output on a SSD1306 display with the help of the 'SSD1306' gem you'll need to

   sudo apt-get install libmagickwand-dev
  1. Install the latest version of gem:
   gem install raspberry_pi_iot

Usage

Main classes with examples of usage are described here. Samples of usage can be run in the demo/ sub-directory.

Plans:

  • Support for more devices (I2C, SPI, LED strip & matrix), SenseHAT, Official Display (brightness, orientation).

  • Better functionality for existing classes (Button, LED, etc.)

  • More tests and demos.

Contributing

Bug reports are welcome on GitHub at https://github.com/mike-shock/Ruby-Raspberry_Pi_IoT.

License

The gem is available as open source under the terms of the [MIT License] (https://opensource.org/licenses/MIT).