Install Digi Embedded Yocto

Follow these steps to install Digi Embedded Yocto:

  1. Set up your workstation
  2. Install Digi Embedded Yocto

If you already have a Digi Embedded Yocto version and want to update it, go to Update Digi Embedded Yocto.

Set up your workstation

You must first set up your PC workstation to use Digi Embedded Yocto. Follow the instructions corresponding to your operating system at Yocto online Quick Start Guide.

You also need to set up a TFTP server on your host so you can program your built images.

  1. Install a TFTP server.

For Debian-like distributions such as Ubuntu, you can execute the following command to install a TFTP server:

$ sudo apt-get install tftpd-hpa
  1. After completing installation, create a directory /tftpboot where exported files will be located (only root user can create this directory):
$ sudo mkdir /tftpboot
$ sudo chmod 1777 /tftpboot
  1. To make sure the TFTP server is using the /tftpboot directory, edit the daemon's configuration file /etc/default/tftpd-hpa and change the constant TFTP_DIRECTORY to point to your recently created /tftpboot folder:
/etc/default/tftpd-hpa 
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/tftpboot"
TFTP_ADDRESS="0.0.0.0:69"
TFTP_OPTIONS="--secure"
  1. Restart the daemon so that it uses the new TFTP folder:
$ sudo service tftpd-hpa restart
tftpd-hpa start/running, process 3297

Install Digi Embedded Yocto

To download Digi Embedded Yocto, you need the repo tool.

Follow these steps to install Digi Embedded Yocto:

  1. Download repo to a directory within your path and add execution permissions.
$ sudo curl -o /usr/local/bin/repo http://commondatastorage.googleapis.com/git-repo-downloads/repo
$ sudo chmod a+x /usr/local/bin/repo
  1. Create an installation folder with user write permissions; for example, /usr/local/dey-2.0. Navigate to that folder:
$ sudo install -o <your-user> -g <your-group> -d /usr/local/dey-2.0
$ cd /usr/local/dey-2.0

Note You can get your primary user and group using the id command.

  1. Use repo to download Digi Embedded Yocto. You have two installation options:

Digi and the Yocto community continually update stable branches with fixes. If you want to keep up to date with these changes, sync your installation with the head of the release branch as follows:

$ repo init -u https://github.com/digi-embedded/dey-manifest.git -b jethro
$ repo sync -j4 --no-repo-verify

Digi performs extensive validation testing on the Digi Embedded Yocto releases. If you want to use a stable release version, sync your installation with the head of the latest tag as follows:

$ repo init -u https://github.com/digi-embedded/dey-manifest.git -b refs/tags/2.0-r5
$ repo sync -j4 --no-repo-verify

Update Digi Embedded Yocto

The Digi Embedded Yocto update process is different depending on your current Digi Embedded Yocto version.

Update an existing dey-2.0 installation

If you are performing a minor release update, for example when updating from dey-2.0-r4 to dey-2.0-r5:

  1. Sync with the release branch or with the latest tag. See Use repo to download Digi Embedded Yocto.
  2. Add the meta-swupdate layer to your project's bblayers.conf:
<yocto_prj_path>/conf/bblayers.conf 
[...]
 
BBLAYERS ?= " \
  [...]
  /usr/local/dey-2.0/sources/meta-swupdate \
"
 
[...]

Update a DEY installation (older than DEY-2.0)

If you are updating from a previous major release like dey-1.6, you must:

  1. Install the new Digi Embedded Yocto release in a new directory.
  2. Recreate your projects.

Follow the steps in Install Digi Embedded Yocto to download the new version.