Install Digi Embedded Yocto
Follow these steps to 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.
- 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
- 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
- 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-hpaTFTP_USERNAME="tftp" TFTP_DIRECTORY="/tftpboot" TFTP_ADDRESS="0.0.0.0:69" TFTP_OPTIONS="--secure"
- 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:
- 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
- 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.
- Use the latest version
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
- Use a stable release version.
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:
- Sync with the release branch or with the latest tag. See Use repo to download Digi Embedded Yocto.
- 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:
- Install the new Digi Embedded Yocto release in a new directory.
- Recreate your projects.
Follow the steps in Install Digi Embedded Yocto to download the new version.