This page contains instructions for setting up Afero Potenco, a secure Linux device that can also function as a hub for Afero enabled Bluetooth® low energy devices.
The instructions on this page explain how to download the software image, apply it to an SD card, install it on a BeagleBone Green Wireless board, and connect the Afero Hardware Security Module (HSM). The OS image can be provided by Afero, or you can build it yourself to include your own customizations, depending on your needs.
This page contains the following sections:
Afero Potenco devices run on a Yocto Linux platform; specifically:
You will need the following pieces of hardware:
You will need to download the firmware image for your development board from Afero. Follow the instructions below to get the correct image:
To install and boot a Potenco Operating System image on the BeagleBone Green Wireless development board, follow the instructions below.
arago-afero-image-am335x-evm.afimg
either from the Afero FTP site, or from the output of your Potenco build environment (see Build the Potenco OS Image)..afimg
file to use the extension “.img”. Write this .img file to the SD card, then eject the card from your PC. Etcher will unmount the SD card when it has successfully written.Do not remove the SD card until all the data has been written to it and the device has been unmounted!
$ sudo apt-get install build-essential python diffstat texinfo chrpath libc6:i386 gawk git repo
$ cd $ wget https://releases.linaro.org/components/toolchain/binaries/5.3-2016.02/arm-linux-gnueabihf/gcc-linaro-5.3-2016.02-x86_64_arm-linux-gnueabihf.tar.xz
ti-linaro-5.3
in your home directory. This path is required for the oe-layertool-setup
script to work properly.
$ tar xf gcc-linaro-5.3-2016.02-x86_64_arm-linux-gnueabihf.tar.xz $ mv gcc-linaro-5.3-2016.02-x86_64_arm-linux-gnueabihf ~/ti-linaro-5.3
$ git clone git@github.com:AferoCE/arago-afero-setup potenco $ cd potenco
$ git clone git@github.com:AferoCE/tisdk-linux $ git clone git@github.com:AferoCE/af-ipc $ git clone git@github.com:AferoCE/af-util $ git clone git@github.com:AferoCE/attrd $ git clone git@github.com:AferoCE/otamgr $ git clone git@github.com:AferoCE/af-conn
af-conn
directory, retrieve the various af-conn
management files in the repo, then cd
back up to the potenco directory:
$ cd af-conn $ git clone git@github.com:AferoCE/af-conn-files files $ cd ..
oe-layertool-setup.sh
script to retrieve the Yocto layers, including the meta-afero layer:
$ ./oe-layertool-setup.sh -f configs/aferoce/master.txt
ti-linaro-5.3
directory in your home directory.
$ cd build $ source conf/setenv
$ bitbake arago-afero-image
To flash the image, use the directions in Install and Boot the Potenco Operating System. The SD image file you want is in the following file location:
arago-tmp-external-linaro-toolchain/deploy/images/am335x-evm/arago-afero-image-am335x-evm.afimg
.
The BeagleBone Green Wireless board has a different I/O connector pinout than the Peaberry board, so it must be manually wired to connector P9 on the board.
In the first diagram below, the Peaberry board is shown with the connector facing up. Connect the four pins shown to connector J9 as follows:
Power VDD to J9 pin 3
GND to J9 pin 1
I2C_SDA to J9 pin 20
I2C_SCL to J9 pin 19
Cape Expansion Headers:
The Potenco SDK is a set of binary packages that you can supply to your customers to develop applications for the Potenco OS, without having access to all the repositories needed to build the entire OS image.
$ cd ~/potenco/build $ source conf/setenv
$ bitbake -c populate_sdk arago-afero-image
The SDK can be found at:
arago-tmp-external-linaro-toolchain/deploy/sdk/arago-2016.05-toolchain-2016.05.sh
Download the Afero mobile app, if you haven’t already, and sign in. The Peaberry board should have come with a couple of QR Code stickers, including one on the back of the board. Scan the QR Code in the Afero mobile app to add the Potenco hub to your account. Once online, any Afero BLE devices on your account will use the Potenco hub to connect to the Afero Cloud.
Potenco also acts as an Afero edge device and can communicate with the Afero Cloud as a connected device in addition to acting as a hub. You can create a Potenco profile in the Afero Profile Editor, and attributes that you define in that profile can be accessed via scripts running on the Potenco board.
If you have any questions or issues with Potenco please use the project's GitHub Project Issue Tracker.