Skip to content

Turning your ARM device into AngelBox

Jump to bottom
Ondřej Perutka edited this page Jul 31, 2017 · 22 revisions

Are you interested in our AngelBox? You can have one for free! We offer you a complete SD card image for Raspberry Pi 2/3 or you can also use our APT repository to install Arrow Client into an existing system.

Cloning SD card image

Before continuing, you will need at least 2 GB micro SD card and our AngelBox image. The image can be downloaded from here.

Windows

  1. Get Win32 Disk Imager.
  2. Install it.
  3. Unzip the AngelBox SD card image.
  4. Plug in your SD card.
  5. Open Win32 Disk Imager.
  6. Select the SD card image and the device with your SD card.
  7. Click on the "Write" button and wait until the image is written.
  8. Unplug the SD card.

OS X

  1. Unzip the AngelBox SD card image.

  2. Plug in your SD card.

  3. Open terminal.

  4. Identify the SD card device:

    diskutil list

  5. Unmount the SD card:

    diskutil unmountDisk /dev/{device}

  6. Write the SD card image into the SD card:

    sudo dd bs=1M if=angel-box-rpi-2016-03-10.img of=/dev/{device}

  7. Eject the SD card:

    sudo diskutil eject /dev/{device}

  8. Unplug the SD card.

Linux

  1. Plug in your SD card.

  2. Open terminal.

  3. Unzip the AngelBox SD card image:

    unzip angel-box-rpi-2016-03-10.img.zip

  4. Unmount the SD card (if mounted):

    sudo umount /dev/{device}

  5. Write the SD card image to the SD card:

    sudo dd bs=4M if=angel-box-rpi-2016-03-10.img of=/dev/{device}

  6. Empty the IO cache:

    sync

  7. Unplug the SD card.

Post installation setup

  1. Plug the SD card into your Raspberry Pi.

  2. Connect the RPi to your local network using an ethernet cable.

  3. Power on the RPi.

  4. Connect your workstation to the same local network.

  5. Change IP address of your network interface to 192.168.123.1 and mask to 255.255.255.0.

  6. Connect to the RPi using SSH (username: pi, password: arrow, address: 192.168.123.123).

    1. In Windows, you can use PuTTY.
    2. In OS X or Linux, open terminal and enter ssh pi@192.168.123.123.

  7. Get MAC address of your RPi and write it down somewhere:

    cat /sys/class/net/eth0/address

  8. Expand the root filesystem to the whole SD card:

    sudo raspi-config
    1. Select "Expand Filesystem".
    2. Confirm.
    3. Finish.
    4. Confirm device reboot.

Installation from our APT repository

For using the deb packages from our repository, you will need a running Debian Jessie based distribution on an ARM device, e.g. Raspbian Jessie on Raspberry Pi. Log in to your device (either directly or using SSH) and enter the following commands into the terminal:

sudo apt-key adv --keyserver hkp://keys.gnupg.net --recv-keys 3CB6723D
sudo sh -c 'echo "deb http://apt.angelcam.com/ stable main" > /etc/apt/sources.list.d/arrow.list
sudo apt-get update
sudo apt-get install arrow-box

The arrow-box service gets started automatically after installation of the package. If you need to start/stop it manually, you can use standard systemd commands:

sudo systemctl start arrow-box.service
sudo systemctl stop arrow-box.service

All logs go into syslog. If you need to modify the arrow-client startup parameters, you can modify them directly in the /usr/bin/arrow-box start script. To list all available parameters, run the following command:

/usr/local/arrow-box/arrow-client

Optionally you can also install the arrow-box-utils package. The package contains a cron job that will keep your client up to date and there is also a service that can use one of the RPi LEDs as an Arrow Client connection status indicator. To install the additional package, enter the following command:

sudo apt-get install arrow-box-utils

To enable the connection status indicator:

sudo systemctl enable arrow-box-led.service
sudo systemctl start arrow-box-led.service

Connecting to Angelcam

Congratulations! Your AngelBox is ready to roll! Now, the only thing you will need to connect to Angelcam is an IP camera with support of H.264 and RTSP. Connect the camera to the same local network as your RPi, go to angelcam.com/arrow and enter the MAC address of your RPi.

Clone this wiki locally