amanharitsh123 / sugarizer-school-box

Sugarizer School Box GSoC '18
Apache License 2.0
2 stars 6 forks source link
cross-compiler linux rpi3

Sugarizer School Box

Sugarizer School Box is a packaged image of Sugarizer Server for the Raspberry Pi.

If you're not an experimented user and just want to download and play with it now, just go to next paragraph. If you want to create yourself the image, go the following paragraph.

Download it now

You could download a ready to launch image here. This image include Sugarizer v1.0.1 and Sugarizer Server v1.0.1.

Depending of your internet connection, downloading the file could take some time because it's a very huge file (about 7.4Gb).

The downloaded file is an img file, i.e. the image of a drive. Once downloaded you need to flash it into an SD card (at least 8Gb). To do that:

On Windows and MacOS, install the Etcher tool and flash the downloaded file into your SD card.

On Linux just launch:

bmaptool copy ./*.img /dev/mmcblk0

(where "mmcblk0" is your sdcard's mount point).

The flashing process will take few minutes.

Using the image

Once flashed, put the SD card in your Raspberry PI then plug the power to boot it.

After few minutes, you can connect with your computer or tablet to the WiFi named SugarizerSchoolBox, password sugarizer.

Once connected to this WiFi, Sugarizer will be accessible from your browser on URLs http://10.0.0.1, http://try.sugarizer.org, http://server.sugarizer.org or http://sugarizer.org.

Sugarizer app on tablets will automatically detect the server once connected to this WiFi. The Sugarizer Server Dashboard is accessible on http://10.0.0.1/dashboard (or others URL mentioned before) with login admin and password password.

Build your own image

The script in this repo allow to create a bootable image of Raspbian with a ready to use Sugarizer Server installed.

Introduction

This script is a fork of rpi23-gen-image script. We have customized it accordingly to make a Sugarizer Client and Sugarizer Server ready raspbian image for Raspberry Pi 3 (should work too on Raspberry Pi 2).

This script should be launched on a Debian Linux Jessie or Stretch. First ensure that nodejs is installed on your machine. If not, follow instruction here to install it.

If you've not the time/knowledge to package yourself the image, you could download a ready to flash image below.

Creating the image

git clone https://github.com/amanharitsh123/sugarizer-school-box.git
cd sugarizer-school-box
sudo sh run.sh

At the of end of the script - depending of your network and your CPU, the script could take about 45mn to run - this message should be displayed:

<fullpath-of-image> (<size-of-image>M) : successfully created

Flashing the image

The resulting of the script should be a file named:

xxxx-xx-xx-arm64-rpi-4.11.y-rpi3-stretch-arm64.img

located into images/stretch directory.

Once the image is generated you could flash it on a SD card that you will insert directly into your Raspberry PI.

To do that, on Debian just launch:

bmaptool copy ./images/stretch/*.img /dev/mmcblk0

Note: You have to find your sdcard's mount point and replace it with "mmcblk0" while flashing.

On Windows and MacOS users, retrieve the img file on your drive and use Etcher to flash the file into a SD card.

Using the image

At first boot, the server will proceed to settings. It will take 30-35mins approx for the setting server up. During this time, make sure that your Raspberry Pi has a working ethernet connection. Docker images will be loaded and containers will be made, followed by network setup.

Raspberry Pi will reboot as soon as the setup is done, now you can connect to the WiFi. Default ssid for the WiFi is "SugarizerSchoolBox" and password is "sugarizer". These can be changed in image_scripts/hotspot.sh by changing $ssid and $pass variables.

After connected to the WiFi, sugarizer will be accessible at 10.0.0.1, try.sugarizer.org, server.sugarizer.org, sugarizer.org.

Download latest image

Download latest image here. This image include Sugarizer v1.0.1 and Sugarizer Server v1.0.1.

If you are using bmaptool to flash the image, download .bmap file as well here.

More information

For more information, see Amanharitsh123 page on SugarLabs wiki.