PiBox » Iron Man

h1. Users Guide

table{border-collapse;width:100%}.

|={font-size:140%;margin-bottom:15px;background-color:#fdd}. This document is under development and is likely not accurate at this time. |

{{>toc}}

In this document the term _host system_ refers to a Linux desktop or laptop that will be used to download and install software

onto an SD card.

h2. The Ironman Monitor

The Ironman Monitor runs on a Raspberry Pi 2 or 3 and provides a central hub for management of home automation devices.

h3. Installation Prerequisites

* The Pi 2/3 requires a 5V / 2A power supply.  For best results, use a power supply rated to at least 5.25V to avoid under voltage conditions.

* The Pi 2/3 requires a microSD card that is at least 4GB.  A mechanism for using the SD card on your host system is needed, such as an SD card USB adapter or an SD port on your laptop.

* A switch should be connected to the Pi GPIOs to allow for pairing the Monitor with IoT Sensors and Jarvis.  The ASCII diagram below describes the setup. The LED is lit in normal mode and off in Pair Mode until something tries to pair with the Pi.

<pre>

                    ___

           Normal  |---|  Pair Mode

                 --------- 

                |         |

                 --------- 

        pins -->  |  |  |  

       RPi GPIO   4  G  27

        RPi pin   7  9  13     

                     |  |

                     |  +---LED---+

                     |            |

                     +---330 R----+

</pre>

* You will need to have sudo access for your Linux user id.

h3. Generating the SD Card for the Pi

* Download the RPi 2 Development Platform 

** _wget <url>_

** Unpack the archive to a directory called *image*.

* Download the Ironman Package Collection

** _wget <url>_

** Unpack the archive to a directory called *package*.

In a terminal window run: _dmesg -w_

Insert the microSD card and look for the device name for the newly added card.  It should be something like /dev/sdb or /dev/sde.

Kill the _dmesg -w_ command with Ctrl-C.

From the *image* directory

* Format the SD card

** _sudo ./mksd.sh -d <device name>_

** where <device name> is the name you noted from the output of dmesg -w.

* Mount the boot partition from the sd card: 

** _sudo mkdir -p /mnt/boot_

** _sudo mount <device name>1 /mnt/boot_

** where <device name> is the name you noted from the output of dmesg -w.

* Install the Development Platform to the SD card

** _sudo ./mkinstall.sh -b /mnt/boot -d <device name>2_ 

** where <device name> is the name you noted from the output of dmesg -w.

From the *package* directory

* Mount the root partition from the sd card: 

** _sudo mkdir -p /mnt/root_

** _sudo mount <device name>1 /mnt/root_

* Copy the Ironman Package Collection files to /root of the root partition on the SD card

** _sudo cp *.opk /mnt/root/root_

Make sure all writes to the SD card have completed

* _sync;sync;sync_

Unmount the SD card partitions

* _sudo umount /mnt/boot_

* _sudo umount /mnt/root_

Remove the SD card from the host system and insert it into the Raspberry Pi 2.

h3. First time boot

h3. Network configuration

h3. Pairing with IoT Sensors

h3. Pairing with Jarvis

h2. IoT Sensor

h3. Sensor Types

h4. Light Switch

h3. Flashing the firmware

h3. Power On

h3. Pairing with a Monitor

h2. Jarvis

h3. Prerequisites

h3. Pairing with a Monitor

h3. Supported Commands