|Installing and Activating Cross Development Environment|
The Linux Vybrid development software is distributed as a linux-<mcu>-<release>.tgz file available for download from the Emcraft site. That file can be installed to an arbitrary directory on your Linux development host, as follows:
[psl@ocean SF]$ mkdir release
You do not need to be the superuser (root) in order to install the Linux Vybrid distribution. The installation can be performed from an arbitrary unprivileged user account.
As a next step in the installation procedure, you need to download and install the Emcraft Yocto toolchain and packages collection. The Linux Vybrid software development environment makes use of a modified software distribution developed by the Yocto project. This is a software distribution and development environment that includes the GNU cross development tools as well as a large number of pre-built target tools and libraries ready for immediate use with Linux running on Cortex-A5. Yocto is provided for free with full source code, including all patches, extensions, programs and scripts used to build the tools.
Basically, the idea is that the Emcraft provided part of the Vybrid software development environment includes U-Boot, the Linux kernel, and some other Vybrid software components, all highly optimized for the VF6 System-On-Module (SOM). The Yocto is used as a second component of theVybrid software development environment and provides the Cortex-A5 GNU toolchain as well as a Yocto-based management of various Linux user-space components ready for the CortexA5 processor core.
The Emcraft Yocto release used in the Vybrid software development environment is based on Yocto 1.8.1 (Fido). The Vybrid development software requires the following Yocto 1.8.1 capabilities be installed on the development host:
The following commands must be issued in an arbitrary writable directory to install the specified Yocto capabilities on the Linux development host:
$ mkdir download
The activation script needs to be run any time you start a development session. The script resides at the top of the installation directory:
[psl@ocean release]$ cd linux-cortexm-2.2.0
An alternative way to run the script is to perform the following command:
[psl@ocean linux-cortexm-2.2.0]$ source ACTIVATE.sh
Whichever way you run the script, it sets a number of environment variables that are required for the cross development environment to function correctly. One of those variables is called MCU. The easy way to test if the cross development environment is active is to run the following command:
[psl@ocean linux-cortexm-2.2.0]$ echo $MCU
If MCU is empty or set to something other than VF6, this means that you have forgotten to run the activation script or somehow run it incorrectly.
Some of our customers ask if the cross development environment can be run on a Windows host. We don't support Windows, however some of our customers have been successfully running the development environment on a virtual Linux machine under Windows. Again, we don't support that explicitly so if you want to try that, you are on your own.