First of all, welcome to the Raspberry Pi channel. The OLE Raspberry Pi image is a modified Raspbian image, with additional software pertaining to the open learning exchange program, which you can put onto the microsd card for the Raspberry Pi.
To get started, there are two main repositories to work with: treehouse-builder and ole--vagrant-treehouses.
Basically, they both do the same thing - create an image compatible with the Raspberry Pi. The difference between the two is that the ole--vagrant-treehouses creates a virtual machine to create the image whereas the treehouse-builder is for debian-based linux distributions such as Debian or Ubuntu.
Since ole--vagrant-treehouses creates a virtual machine, it works on all platforms such as Mac OSX, Windows, and Linux, but requires that the system supports virtualization. This also means that it will use extra resources in terms of memory, hdd space, and CPU cycles. Including this option meant that anyone can create an image for the Raspberry Pi.
Testing the custom treehouse-builder image:
- Any RPI for testing the microSD card
- A class10 microSD card (minimum 8 Gb)
- microSD card reader/writer for writing the new image to the class10 microSD card
Building the image with treehouse-builder:
- Ubuntu or Debian based Linux distribution (Other distros are untested)
- An Internet connection
Building the treehouse-builder image with ole--vagrant-treehouses:
- A virtualization enabled computer with Vagrant & Virtualbox (If you could run the vagrant tutorial without problems, then this is fine.)
- 8 Gb of harddrive space
- 4 Gb of memory
- An Internet connection
We meet on Wednesdays at 4:30 PM EST online on talk.ole.org. Just sign in with your Google account and you're good to go. If nobody is in the hangouts room, someone will be there eventually usually a few minutes after 4:30PM, unless of course the meeting is cancelled but that will be stated in the #raspberrypi chat channel on gitter.
So far we are working on creating a seamless experience for the image, meaning we want the user to have many connectivity options without having to tinker too much with the Raspberry Pi. So our main concerns at the moment is getting the RPI to connect to different connectivity options such as wifi/bluetooth/ethernet automatically. This allows more people to contribute and debug unexpected problems. Once we have those bases covered, we can move onwards to the software part.
There is always something to be done. Check the GitHub issues for treehouse-builder to see what needs to be done or waffle.io. Once you've chosen an issue and fixed the problem, create a PR using the same guidelines as the ones used when you had to go through the intern orientation. If you have any questions, just ask! You can find us on the #raspberrypi channel on gitter.
Below we have a short step-by-step rundown of how the treehouse-builder works:
- Download Raspbian image
- Validate the downloaded image
- Modify Raspbian image into an OLE image by executing a few shell scripts a. Disable autoresize b. Add ssh-keys c. Purge unnecessary packages d. Install packages needed for OLE such as docker and matchbox-keyboard e. Run autorun script
- Enter chroot if user needs to perform additional commands
- Write the .img file with a program such as Etcher to the MicroSD card.
ole--vagrant-treehouses - Creates a vagrant virtual machine that runs treehouse-builder.
treehouse-builder - Treehouse-builder will create a custom raspian image for the raspberry pi.
pirate-sh/ip - Ip script used in treehouse-builder image that will let you manually connect to a network and change its' network settings.
mobile-bluetooth-rpi - Android app that lets you send/receive commands to the rpi.
mobile-piiper - Usb-tethering with an Android device to the rpi.
Intro to Raspberry Pi - A old Google Doc with Raspberry Pi instructions.