Yocto Start Here: Difference between revisions

From Variscite Wiki
No edit summary
(29 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<!-- Set release according to "release" parameter in URL and use MORTY_BETA_DART-6UL as default
<!-- Set release according to "release" parameter in URL and use MORTY_V1.0_DART-6UL as default
--> {{#vardefine:RELEASE_PARAM|{{#urlget:release}}}} <!--
--> {{#vardefine:RELEASE_PARAM|{{#urlget:release|RELEASE_MORTY_V1.0_DART-6UL}}}} <!--
--> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM|RELEASE_MORTY_BETA_DART-6UL}}}} <!--
--> {{#lst:Yocto_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
--> {{PageHeader|{{#var:HARDWARE_NAME}}-First Time? Start Here.}} {{DocImage|category1={{#var:HARDWARE_NAME}}|category2=Yocto}} __toc__
--> {{#lst:B2QT_Platform_Customization|{{#var:RELEASE_PARAM}}}} <!--
-->                                {{#vardefine:BUILD_PAGE|Yocto_Build_Release}}  {{#vardefine:PLATFORM_OS|Yocto}}  {{#vardefine:DEV_GUIDE|{{#var:HARDWARE_NAME}}_Yocto}}        <!-- Default to Yocto
--> {{#varexists:DEBIAN_NAME      | {{#vardefine:BUILD_PAGE|Debian_Build_Release}} {{#vardefine:PLATFORM_OS|Debian}}  {{#vardefine:DEV_GUIDE|{{#var:HARDWARE_NAME}}_Debian}}  | }} <!-- Debian
--> {{#varexists:B2QT_BSP_VERSION | {{#vardefine:BUILD_PAGE|B2QT_Build_Release}}  {{#vardefine:PLATFORM_OS|Boot2Qt}} {{#vardefine:DEV_GUIDE|{{#var:HARDWARE_NAME}}_B2QT}}    | }} <!-- B2Qt
--> {{PageHeader|{{#var:HARDWARE_NAME}} First Time? Start Here}} {{DocImage|category1={{#var:HARDWARE_NAME}}|category2=Yocto}} __toc__
[[File:Yocto.png|x300px]]
[[File:Yocto.png|x300px]]
= Step One: Read Documentations =
= Step One: Read Documentations =
Please download and read the development kit documentation on Variscite website
Please download and read the development kit documentation on Variscite website
{{note| NOTE:<br>Make sure you read the Quick Start Guide.|info}}
{{note| Note:<br>Make sure you read the Quick Start Guide|info}}


= Step Two: Setup Linux host PC Development Environment =
= Step Two: Setup Linux host PC Development Environment =
Line 13: Line 17:


= Step Three: Evaluation Kit Power Up =
= Step Three: Evaluation Kit Power Up =
Power up the board.
You should have the serial cable connected to the debug port, as describe in the quick start guide.<br>
</br>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.<br>
</br>When board boots, make sure you see the u-boot prints on your host PC hyper terminal. You will need to type-in commands in the command prompt late in the development stages
Under Windows PuTTY or Tera Term are recommended.<br>
{{note| IMPORTANT:<br>Don't continue without the serial console operating.|info}}
For example, to use picocom under Ubuntu:<br>
Open a terminal a run:
<pre>
$ 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)
</pre>


= Step Four: A quick test with recovery SD-Card=
And to use PuTTY under Windows:
Please follow the below guide to boot Evaluation Kit with a bootable SD-Card, and burn a complete Yocto into SOMs storage (NAND/eMMC)
<pre>
* {{Varlink|Yocto Recovery SD card|{{#var:RELEASE_LINK}}|'''Using the recovery SD card'''}}
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).


= Step Five: What next?=
Run PuTTY as an administrator.
Your next step can be one of :
* {{Varlink|Yocto_Build_Release|{{#var:RELEASE_LINK}}|Build a complete Yocto}}.<br> 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 SOM's storage NAND Flash or eMMC.
** [[Yocto Common Errors|Yocto common build errors]]


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".


* Use your pre-built rescue recovery SD-Card, as-is, to boot system, and start applications programming.
In the "Connection" -> "Serial" screen:
** [[VAR-SOM-MX6 Hello World|Hello World 'C' application]]
Make sure the "Data bits" are set to "8", "Stop bits" to "1", "Parity" to "None" and "Flow control" to "None".
** [[VAR-SOM-MX6 QT Hello World|Building A QT Hello World]]
** [[VAR-SOM-MX6 Yocto GS eclipse v3|Debugging with Eclipse]]
** [[VAR-SOM-MX6 Yocto Utilizing|TFTP & NFS]]


Click on "Open".
</pre>
Note:<br>
If you are using a virtual machine, make sure the USB device is used by the correct OS.<br>
<br>
Power up the board.<br>
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.<br>
The Linux login is root (no password).
{{note| IMPORTANT:<br>Don't continue without the serial console operating.|info}}


* Test various interfaces.
= Step Four: A quick test with recovery SD card =
** [[DART-6UL GPIO|GPIO]]
Please follow the below guide to boot the evaluation kit with a bootable SD card, and burn a complete {{#var:PLATFORM_OS}} image into the SOM's internal storage (NAND flash/eMMC)
** [[DART-6UL Ethernet|Ethernet]]
* {{Varlink|Yocto Recovery SD card|{{#var:RELEASE_LINK}}|Using the recovery SD card}}
** [[DART-6UL Audio record play|Audio record/play]]
 
** [[DART-6UL Can-bus|Can-bus]]
= Step Five: What next? =
** [[DART-6UL USB Host|USB Host]]
For your next steps you can either use the pre-built recovery SD card or you can build a complete {{#var:PLATFORM_OS}} image yourself:
** [[DART-6UL eMMC|eMMC]]
* {{Varlink|{{#var:BUILD_PAGE}}|{{#var:RELEASE_LINK}}|Build {{#var:PLATFORM_OS}} from source code}}
** [[DART-6UL RTC|RTC]]
** [[Yocto Common Errors|Yocto common build errors]]
** [[DART-6UL LVDS|LVDS]]
This guide will help you build a complete {{#var:PLATFORM_OS}} build, resulting in all required binaries to create a full bootable {{#var:PLATFORM_OS}} SD card, and all required binaries to burn to the SOM's internal storage (NAND flash or eMMC).<br>
** [[DART-6UL I2C|I2C]]
<br>
** [[DART-6UL Wireless LAN|Wireless LAN]]
* Start your application programming:
** [[DART-6UL Bluetooth|Bluetooth]]
** {{Varlink|Yocto Hello World|{{#var:RELEASE_LINK}}|Hello World 'C' application}}
** [[DART-6UL Backlight|Backlight]]
** {{Varlink|Yocto QT Hello World|{{#var:RELEASE_LINK}}|Building A Qt Hello World}}
** [[DART-6UL USB OTG host|USB OTG as host]]
** {{Varlink|Yocto Programming with Eclipse|{{#var:RELEASE_LINK}}|Debugging with Eclipse}}
** [[DART-6UL USB OTG as device|USB OTG as device]]
** {{Varlink|Yocto Setup TFTP/NFS|{{#var:RELEASE_LINK}}|TFTP & NFS}}
** [[DART-6UL SPI|SPI]]
<br>
** [[DART-6UL UART|External UART]]
* Test various interfaces: check the How-to column in the {{Varlink|{{#var:DEV_GUIDE}}|{{#var:RELEASE_LINK}} | Developer Guide}}
<br>
* Contact Support
* Contact Support
** [http://variscite.com/support-forum/index.php Support forum]
** [http://www.variscite.com/support/variscite-customer-portal '''Variscite Customer Portal'''] <br> Register at Variscite Customer Portal to get high quality engineering support for Variscite products
** support@variscite.com

Revision as of 16:46, 8 November 2022

DART-6UL First Time? Start Here

Yocto.png

Step One: Read Documentations

Please download and read the development kit documentation on Variscite website

Note:
Make sure you read the Quick Start Guide

Step Two: Setup Linux host PC Development Environment

Set up your development environment.

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".

Note:
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).

IMPORTANT:
Don't continue without the serial console operating.

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)

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).



  • Contact Support
    • Variscite Customer Portal
      Register at Variscite Customer Portal to get high quality engineering support for Variscite products