Get Started: Useful Packages and Modules (UPM)

Get Started

Get the Software

Useful Packages & Modules (UPM) is an open-source sensor library, and MIT licensed. It is available for download on GitHub* and on most major Linux* distributions. Follow the installations instructions below.

Download on GitHub

What's Included

• UPM library
• MRAA library
• Code samples for over 400 sensors and actuators

Supported Platforms

X86

• UP Squared* with the Celeron® processor
• IEI TANK* AIoT Development Kit with the Intel® Core™ processor
• Minnowboard with the Intel Atom processor
• UP Board with the Intel Atom processor

FPGA

• Terasic DE10-Nano Kit

ARM

• Raspberry Pi*
• Banana Pi
• Beaglebone Black*
• phyBOARD-Wega*
• 96 Boards*

MIPS

• LinkIt Smart* 7688
• Onion Omega2

Supported Operating Systems

• Ubuntu* 16.04 LTS
• Arch Linux*
• openSUSE
• Poky Linux
• Wind River Pulsar* Linux*
• Android Things*

Release Notes

Installation

UPM packages are provided for some of the major supported distributions, making it possible to install UPM and its dependencies without having to go through a full build.

Ubuntu Desktop or Server

MRAA and UPM are available through a Personal Package Archive (PPA) on Ubuntu.

Download | Installation Guide

To install the latest stable UPM version:

1. Before running UPM applications on Ubuntu*, ensure that you have the run with sudo permission.
2. Enter sudo add-apt-repository ppa:mraa/mraa
3. Enter sudo apt-get update
4. Enter sudo apt-get install libupm-dev libupm-java python-upm python3-upm node-upm upm-examples

Poky Linux

This Poky Linux build for Minnowboard is based on Yocto Project. 

Download Official Images 

To install the latest stable UPM version:

1. Enter echo "src intel-iotdk https://iotdk.intel.com/repos/3.5/intelgalactic/opkg/i586/" > /etc/opkg/intel-iotdk.conf
2. Enter opkg update
3. Enter opkg upgrade mraa upm

To install the development UPM version:

1. Enter echo "src intelgalactic-dev https://iotdk.intel.com/repos/3.5/intelgalactic/opkg/i586/" > /etc/opkg/intelgalactic-dev.conf
2. Enter opkg update
3. Enter opkg upgrade mraa upm

Wind River Pulsar* Linux*

Wind River Pulsar Linux now uses SmartPM* for software updates instead of the apt-get tool.

To install the latest stable UPM version:

1. Enter smart channel -y --add upm_mraa_channel type=rpm-md name="MRAA/UPM" baseurl=http://iotdk.intel.com/repos/pulsar/8/x64

   Note For Pulsar 7, replace the baseurl with: baseurl=http://iotdk.intel.com/repos/pulsar/7/x64

2. Enter smart update
3. Enter smart install -y mraa upm

Wind River* Linux* 7 uses 01.org repositories and has a default update channel that includes MRAA and UPM. To install it, you only need to perform steps 2 and 3 in the previous instructions.