Using a Raspberry PI

PreviousSTART HERE!NextInstalling the VSSL Agent

Last updated 6 years ago

Was this helpful?

Using a Raspberry PI

The Raspberry Pi is a low cost option for running the VSSL api. It is a stable platform with good documentation and a huge global community. We support the Raspberry PI 3.

You can purchase a good Raspberry Pi kit here:

Using the VSSL prepared RPi image

We have put together a Rasbian image with the VSSL agent that runs the REST API preloaded.

You can follow these instructions to configure your Raspberry Pi 3 with the preconfigured VSSL rpi image.

Download the VSSL configured image from:
Currently this image is for a 32Gb SD card
Load this image on a microSd card using the instructions at:
Insert this microSd card in the PI and power on the PI
The vsslagent will now be running on port 8000. You can test it from the terminal.
a. List the VSSL zones that the pi can see
```
curl localhost:8000/api/vssls
```

Remember that you will have to use the correct ip address (the address of the pi) when calling API functions from an entity outside the PI.

You can get the ip address of the pi using ifconfig. You will see an entry for enx<> that contains a field inet.

Configuring a Raspberry Pi 3 From Scratch

How to Configuring a Rapsberry Pi 3 using the latest image:

Insert this microSd card in the PI and launch it
Open a terminal and perform the following:
a. Update the image to latest tools:
```
sudo apt-get update && sudo apt-get dist-upgrade && sudo apt-get clean
```
b. install the ubuntu snap tool:
```
sudo apt-get install snapd
```
c. install the vssl agent:
```
sudo snap install vsslagent
```
The vsslagent will now be running on port 8000. You can test it from the terminal.
a. list the VSSL zones that the pi can see
```
curl localhost:8000/api/vssls
```

Remember that you will have to use the correct ip address (the address of the pi) when calling API functions from an entity outside the PI.

You can get the ip address of the pi using ifconfig. You will see an entry for enx<> that contains a field inet.

Flashing the Image

PreviousSTART HERE!NextInstalling the VSSL Agent

Last updated 6 years ago

Was this helpful?

The Raspberry Pi is a low cost option for running the VSSL api. It is a stable platform with good documentation and a huge global community. We support the Raspberry PI 3.

You can purchase a good Raspberry Pi kit here:

Using the VSSL prepared RPi image

We have put together a Rasbian image with the VSSL agent that runs the REST API preloaded.

You can follow these instructions to configure your Raspberry Pi 3 with the preconfigured VSSL rpi image.

Download the VSSL configured image from:
Currently this image is for a 32Gb SD card
Load this image on a microSd card using the instructions at:
Insert this microSd card in the PI and power on the PI
The vsslagent will now be running on port 8000. You can test it from the terminal.
a. List the VSSL zones that the pi can see
```
curl localhost:8000/api/vssls
```

Remember that you will have to use the correct ip address (the address of the pi) when calling API functions from an entity outside the PI.

You can get the ip address of the pi using ifconfig. You will see an entry for enx<> that contains a field inet.

Configuring a Raspberry Pi 3 From Scratch

How to Configuring a Rapsberry Pi 3 using the latest image:

Download the latest 'Rasbian Stretch with desktop' image from RaspberryPi.org:
Load this image on a microSd card using the instructions at RaspberryPi.org:
Insert this microSd card in the PI and launch it
Open a terminal and perform the following:
a. Update the image to latest tools:
```
sudo apt-get update && sudo apt-get dist-upgrade && sudo apt-get clean
```
b. install the ubuntu snap tool:
```
sudo apt-get install snapd
```
c. install the vssl agent:
```
sudo snap install vsslagent
```
The vsslagent will now be running on port 8000. You can test it from the terminal.
a. list the VSSL zones that the pi can see
```
curl localhost:8000/api/vssls
```

Remember that you will have to use the correct ip address (the address of the pi) when calling API functions from an entity outside the PI.

You can get the ip address of the pi using ifconfig. You will see an entry for enx<> that contains a field inet.

Flashing the Image

Use to flash the image to your SD card.