DAVE DIVELK User manual

ARM Cortex-A8 CPU Module Family

DAVE Embedded Systems www.dave.eu [email protected]

Lite Line

Diva Embedded Linux Kit (DIVELK)

Quick Start Guide

D V E L K Q u i c k S t a r t G u i d e v . 1 . 0 . 6

July, 2015 2/52

D V E L K Q u i c k S t a r t G u i d e v . 1 . 0 . 6

Table of Contents

1 Preface...................................................................................................................................5

1.1 About this manual...........................................................................................................5

1.2 Copyrights/Tra emarks...................................................................................................5

1.3 Stan ar s........................................................................................................................5

1.4 Disclaimers.....................................................................................................................5

1.5 Warranty..........................................................................................................................6

1.6 Technical Support...........................................................................................................6

1.7 Relate ocuments.........................................................................................................7

1.8 Conventions, Abbreviations, Acronyms..........................................................................8

2 Intro uction..........................................................................................................................10

2.1 DIVA SOM.....................................................................................................................10

2.2 Embe e Linux...........................................................................................................11

2.3 DIVELK.........................................................................................................................12

2.3.1 Kit Contents...........................................................................................................14

2.3.2 DIVELK Release Notes.........................................................................................15

2.3.2.1Version 2.1.0.....................................................................................................15

2.3.2.2Version 2.0.0.....................................................................................................15

2.3.2.3Version 1.0.0.....................................................................................................16

2.3.2.4Releases history................................................................................................16

3 DIVELK Quick Start..............................................................................................................17

3.1 Unboxing.......................................................................................................................17

3.2 Har ware setup.............................................................................................................18

3.3 First boot.......................................................................................................................18

3.4 DVDK installation..........................................................................................................20

3.4.1 DVDK features.......................................................................................................20

3.4.2 MicroSD contents..................................................................................................21

3.4.3 Importing the virtual machine................................................................................21

3.4.4 Launching the virtual machine...............................................................................23

4 Developing Environment......................................................................................................26

4.1 Intro uction...................................................................................................................26

4.2 Software components...................................................................................................27

4.2.1 Toolchain................................................................................................................27

4.2.2 Bootloa er.............................................................................................................27

4.2.3 Kernel....................................................................................................................28

4.2.3.1Linux Device Tree.............................................................................................28

4.2.4 Target root file system...........................................................................................29

4.2.5 Yocto......................................................................................................................29

4.3 Working with DIVELK...................................................................................................30

4.3.1 The buil system...................................................................................................30

4.3.2 Overview of the installe components..................................................................30

4.3.3 Setting up the server environment........................................................................32

July, 2015 3/52

D V E L K Q u i c k S t a r t G u i d e v . 1 . 0 . 6

4.3.3.1TFTP Server......................................................................................................32

4.3.3.2NFS Server........................................................................................................33

4.3.3.3Pre-built toolchain.............................................................................................33

4.3.3.4Pre-built root file system....................................................................................34

4.4 Buil ing the software components with Yocto..............................................................35

4.4.1 Prerequisites..........................................................................................................35

4.4.2 Initializing the buil environment...........................................................................36

4.4.3 Buil the Yocto image............................................................................................36

4.5 Buil ing the software components outsi e Yocto.........................................................37

4.5.1 Buil /configure U-Boot..........................................................................................37

4.5.2 Buil /configure Linux kernel..................................................................................38

4.5.3 Buil a custom application.....................................................................................39

5 DIVELK use cases...............................................................................................................40

5.1 DIVA Frequency Scaling...............................................................................................40

5.2 Forcing the kernel to use a limite amount of RAM.....................................................41

6 Frequently Aske Questions................................................................................................42

6.1 Q: Where can I foun DIVA SOM information?............................................................42

6.2 Q: I've receive the DIVELK package. How am I suppose to start working with it?. .42

6.3 Q: How can I up ate the DIVELK version?..................................................................43

6.4 Q: How can I work with the XYZ peripheral/interface?.................................................43

6.5 How can I configure the DIVA system to boot from network?......................................43

6.6 Q: Where can I foun information regar ing the PRUs?..............................................44

6.7 Q: Can you suggest some gui elines for the carrier boar esign?............................45

6.8 Q: The system oesn't boot anymore. On the serial console I see just “CCCC”

characters... Is there a recovery proce ure?........................................................................45

7 Appen ices...........................................................................................................................46

7.1 A: boot messages.........................................................................................................46

July, 2015 4/52

D V E L K Q u i c k S t a r t G u i d e v . 1 . 0 . 6

1 Preface

1.1 About this manual

This manual describes the DIVA Embedded Linux Kit (DIVELK)

and serves as a quick guide f r start w rking with the

devel pment kit.

1.2 Copyrights/Trademarks

Ethernet® is a registered trademark f XEROX C rp rati n.

All ther pr ducts and trademarks menti ned in this manual

are pr perty f their respective wners.

n tiﬁcati n.

1.3 Standards

DAVE Embedded Systems is certiﬁed t ISO 9001 standards.

1. Disclaimers

DAVE Embedded Systems d es n t assume any resp nsibility

f r availability, supply and supp rt related t all pr ducts

menti ned in this manual that are n t strictly part f the DIVA

CPU m dule, the DIVAEVB-Lite carrier b ard and the DACU

carrier b ard.

DIVA CPU M dules are n t designed f r use in life supp rt

appliances, devices, r systems where malfuncti ning f these

pr ducts can reas nably be expected t result in pers nal

injury. DAVE Embedded Systems cust mers wh are using r

selling these pr ducts f r use in such applicati ns d s at their

wn risk and agree t fully indemnify DAVE Embedded

Systems f r any damage resulting fr m such impr per use r

sale.

July, 2015 5/52

D V E L K Q u i c k S t a r t G u i d e v . 1 . 0 . 6

1.5 Warranty

DIVA SOM, DIVAEVB-Lite and DACU are guaranteed against

defects in material and w rkmanship f r the warranty peri d

fr m the shipment date. During the warranty peri d, DAVE

Embedded Systems will at its discreti n decide t repair r

replace defective pr ducts. Within the warranty peri d, the

repair f pr ducts is free f charge pr vided that warranty

c nditi ns are bserved.

The warranty d es n t apply t defects resulting fr m impr per

r inadequate maintenance r handling by the cust mer,

unauth rized m diﬁcati n r misuse, perati n utside f the

pr duct’s speciﬁcati ns r impr per installati n r

maintenance.

DAVE Embedded Systems will n t be resp nsible f r any

defects r damages t ther pr ducts n t supplied by DAVE

Embedded Systems that are caused by a faulty DIVA m dule,

DIVAEVB-Lite r DACU.

1.6 Technical Support

We are c mmitted t making ur pr ducts easy t use and will

help cust mers use ur CPU m dules in their systems.

Technical supp rt is delivered thr ugh email f r registered kits

wners. Supp rt requests can be sent t supp [email protected].

S ftware upgrades are available f r d wnl ad in the restricted

d wnl ad area f DAVE Embedded Systems web site:

http://www.dave.eu/reserved-area. An acc unt is required t

access this area.

Please refer t ur Web site at

http://www.dave.eu/dave-cpu-m dule-am335x-diva.html f r the

latest pr duct d cuments, utilities, drivers, Pr duct Change

N tices, B ard Supp rt Packages, Applicati n N tes,

mechanical drawings and additi nal t ls and s ftware.

July, 2015 6/52

D V E L K Q u i c k S t a r t G u i d e v . 1 . 0 . 6

1.7 Related documents

Document Location

DAVE

Embedded

Systems

Developers Wiki

http://wiki.dave.eu/index.php/Main_Page

AM335x

Te hni al

Referen e Manual

http://www.ti. om/lit/ug/spruh73k/spruh7

3k.pdf

DIVA main page

on DAVE

Embedded

Systems

Developers Wiki

http://wiki.dave.eu/index.php/Category:D

iva

DIVA Hardware

Manual

http://www.dave.eu/sites/default/ﬁles/ﬁle

s/diva-hm.pdf

DIVA Software

Manual

http://wiki.dave.eu/index.php/Software_

Manual_(Diva)

AM335x Portal

(on TI Embedded

Pro essors Wiki )

http://pro essors.wiki.ti. om/index.php/Si

tara_AM335x_Portal

DIVAEVB-Lite

page on DAVE

Embedded

Systems

Developers Wiki

http://wiki.dave.eu/index.php/DivaEVB-Li

DACU User's

Guide

Provided with kit do umentation

Building

Embedded Linux

Systems By Karim

Yaghmour.

This book overs all matters involved in

developing software for embedded

systems. It is not a referen e guide, but

it provides a omplete and exhaustive

overview that helps the developer save

a lot of time in sear hing for su h

information on the Internet

July, 2015 7/52

D V E L K Q u i c k S t a r t G u i d e v . 1 . 0 . 6

Document Location

Training and Do s

se tions of Free

Ele trons website.

Brief but still exhaustive overview of the

Linux and Embedded Linux world.

Tab. 1: Related do uments

1.8 Conventions, Abbreviations, Acronyms

Abbreviation Deﬁnition

BTN Button

DIVELK DIVA Embedded Linux Kit

EMAC Ethernet Media A ess Controller

GPI General purpose input

GPIO General purpose input and output

GPO General purpose output

PCB Printed ir uit board

PMIC Power Management Integrated Cir uit

PRU Programmable Real-Time Unit

PSU Power supply unit

RTC Real time lo k

SOC System-on- hip

SO-DIMM Small Outline Dual In-line Memory

Module

SOM System-on-module

WDT Wat hdog

Tab. 2: Abbreviations and a ronyms used in this manual

July, 2015 8/52

D V E L K Q u i c k S t a r t G u i d e v . 1 . 0 . 6

Revision History

Version Date Notes

1.0.0 June 2013 First ofﬁ ial release

1.0.1 June 2013 Added pi tures

Minor ﬁxes

1.0.2 January 2014 Minor ﬁxes

1.0.3 O tober 2014 Updated for DIVELK 2.0.0 release

1.0.4 November 2014 Minor ﬁxes

1.0.5 June 2015 Updated for DIVELK 2.1.0 release

1.0.6 July 2015 Minor ﬁxes

July, 2015 9/52

D V E L K Q u i c k S t a r t G u i d e v . 1 . 0 . 6

2 Introduction

2.1 DIVA SOM

DIVA is a family f

system- n-m dules (SOM) that

bel ngs t DAVE Embedded

Systems Lite Line pr duct

class. DIVA is based n Texas

Instruments "Sitara" AM335x

C rtex-A8 applicati n pr cess r

and is built with SO-DIMM 204

pin f rm fact r.

DIVA ffers l ts f graphics,

pr cessing, peripherals and industrial interface pti ns,

all wing cust mers t implement c st-effective design. The

Pr grammable Real-Time Unit and Industrial C mmunicati n

Subsystem (PRU-ICSS) adds further ﬂexibility and enables

additi nal peripheral interfaces and real-time pr t c ls such as

EtherCAT, PROFINET, EtherNet/IP, PROFIBUS, Ethernet

P werlink.

Typical applicati ns f r DIVA are:

●Industrial sens rs and I/O units

●Industrial drives with integrated

c mmunicati ns and multi-axis

m t r c ntr l

●Pr grammable l gic/aut mati n

c ntr llers (PLC/PAC) with

integrated industrial

c mmunicati ns such as

PROFIBUS, CAN and Ethernet

●H me and Building Aut mati n

F r further inf rmati n, please refer

t DIVA Hardware Manual.

July, 2015 10/52

Fig. 2: DIVA plugged on

DIVAEVB-Lite

Fig. 1: DIVA CPU module

Table of contents

Popular Microcontroller manuals by other brands

AMS

AMS AS7261 Demo Kit user guide

Novatek

Novatek NT6861 manual

Espressif Systems

Espressif Systems ESP8266 SDK AT Instruction Set

Nuvoton

Nuvoton ISD61S00 ChipCorder Design guide

STMicrolectronics

STMicrolectronics ST7 Assembler Linker user manual

Texas Instruments

Texas Instruments Chipcon CC2420DK user manual

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM user guide

NEC

NEC 78GK0S/K 1+ Series Application note

Mikroe

Mikroe SEMITECH N-PLC Click Application note

Intel

Intel Agilex user guide

Cypress

Cypress CY4607 HX2VL quick start guide

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE manual

Texas Instruments

Texas Instruments TMS320F2837 D Series Workshop Guide and Lab Manual

CYPRES

CYPRES CY14NVSRAMKIT-001 user guide

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM user guide

Espressif Systems

Espressif Systems ESP8266EX Programming guide

Abov

Abov AC33M8128L user manual

Laird

Laird BL654PA user guide