Yocto Start Here

From Variscite Wiki
VAR-SOM-MX8X-First Time? Start Here.


1 Step One: Read Documentations

Please download and read the development kit documentation on Variscite website

Make sure you read the Quick Start Guide.

2 Step Two: Setup Linux host PC Development Environment

Set up your development environment.

3 Step Three: Evaluation Kit Power Up

You should have the serial cable connected to the debug port, as describe in the quick start guide.
Under Ubuntu (or other Linux based OS) minicom or picocom are recommended.
Under Windows PuTTY or Tera Term are recommended.
For example, to use picocom under Ubuntu:
Open a terminal a run:

$ dmesg
One of the last lines should be something like: "FTDI USB Serial Device converter now attached to ttyUSBX" (the X should be a number)
$ sudo apt-get install picocom
$ sudo picocom -b 115200 /dev/ttyUSBX (replace the X with the number from the dmesg output).
(If you want to exit picocom press Ctrl+A+X)

And to use PuTTY under Windows:

Click the "Windows key"+"R" to open the "Run" window, type "devmgmt.msc" and hit "Enter" to open the Device Manager.

In Device Manager, expend the "Ports (COM & LTP)" entry.
You should have a "USB Serial Port (COMXX)" entry there after you connect the Debug cable (the XX should be a number).

Run PuTTY as an administrator.

In the Putty "Session" screen:
Choose "Serial" under "Connection type".
in the "Serial line" field, put in COMXX (replace the XX with the number seen in your Device Manager).
Under "Speed" put in "115200".

In the "Connection" -> "Serial" screen:
Make sure the "Data bits" are set to "8", "Stop bits" to "1", "Parity" to "None" and "Flow control" to "None".

Click on "Open".

If you are using a virtual machine, make sure the USB device is used by the correct OS.

Power up the board.
When board boots, make sure you see the U-Boot and kernel prints on your host PC terminal. You will need to type-in commands in the command prompt late in the development stages.
The Linux login is root (no password).

Don't continue without the serial console operating.

4 Step Four: A quick test with recovery SD card

Please follow the below guide to boot the evaluation kit with a bootable SD card, and burn a complete Yocto image into the SOM's internal storage (NAND flash/eMMC)

5 Step Five: What next?

For your next steps you can either use the pre-built recovery SD card or you can build a complete Yocto image yourself:

This guide will help you build a complete Yocto build, resulting in all required binaries to create a full bootable Yocto SD card, and all required binaries to burn to the SOM's internal storage (NAND flash or eMMC).