Timesys University. Complete software solutions for Vybrid

Transcription

1 Timesys University Complete software solutions for Vybrid

2 2 2 Timesys Staff Answering your questions today are: Maciej Halasz Product Management maciej.halasz@timesys.com Theresa Kisha Marketing theresa.kisha@timesys.com Marcin Bis Linux Engineer marcin.bis@timesys.com Pierre Gauvain EMEA Business Development Mgr pierre.gauvain@timesys.com

3 3 Freescale Vybrid

4 4 4 Vybrid A multicore platform for industrial applications ARM Cortex-A5 up to 500 MHz ARM Cortex-M4 up to 167 MHz VF6xx Dual heterogeneous core solution with XGA display, dual USB, dual Ethernet and L2 switch VF5xx Single-core solution with dual Ethernet and L2 switch VF3xx Single-core solution with dual XiP quad SPI, dual Ethernet and L2 switch

5 5 5

6 6 6

7 7 7 Vybrid Use-cases Hard Real-Time in Linux Cyclictest (standard Linux): cyclictest -l m -n -p99 -i200 -h400 -q

8 8 8 Vybrid Use-cases Typical results for i.mx6

9 9 About Timesys

10 10 10 About Timesys: Proven Linux Pedigree More than 1000 projects, 200+ customers First to develop and deliver an award-winning, automated, intelligent, embedded Linux build system (LinuxLink 3.0) Support for 8 architectures, 100+ processors & SoCs Customers targeting industrial automation, mil/aero, medical, telecom, consumer electronics, and automotive segments Support for multi-core environments First to register First to market carrier-grade Linux open source, distribution commercialreal-time First embeddedcustomized grade Linux Integrate Real-time Linux Eclipse-based Linux product with OS Community Versions Leadership Tools LinuxLink 2.0 LinuxLink Manual Customized Builds Automated Build/Test 2003 Hosted Build System 2004 Semis adapt Build system % Open Source LinuxLink Factory adds 100th supported board First to deliver an automated, intelligent build system LinuxLink 2008 Intelligent Build system Support for Multicore

11 11 11 Freescale Processors Supported

12 12 12 Timesys Embedded Linux Offerings LinuxLink For engineering teams looking to build embedded linux devices inhouse easily, reliably and fast with access to expert support Professional Services For engineering teams looking to outsource development work so their teams can focus on building differentiation Training For engineering teams requiring customized onsite training courses enabling them to immediately apply the lessons to actual development LinuxLink Professional Services Training Demos, BSPs/SDKs and Starting Points Kernel Drivers Intro to Embedded Linux Development Repository of Tested Linux BSPs and Packages Board Bring Up Developing Linux Device Drivers Factory Build System (Desktop and Cloud) HMI (Qt / Video / 3D) Yocto Tools: Cross compiler, TimeStorm IDE & Debugger Camera Developing Apps on Linux Expert, Unmetered Support System Optimization (Fast Boot, Power) Developing Rich HMI Apps on Qt Android Optimizing Your Design for Fast Boot

13 13 13 LinuxLink Major Vybrid Differentiator Web Edition Design, build and deploy custom Linux BSP Maximum ease-of-use for new embedded Linux developers Timesys LinuxLink PRO Edition (Desktop) PRO Edition Fully customizable build and configuration tools Local factory repository support TimeStorm tools Unmetered support Distribution market-friendly business model Future SaaS infrastructure Incremental config and build tools FREE Edition (Web) Local Factory and Repository Prototype Linux on a reference board TimeStorm Eclipse based IDE Unmetered technical support BSP/SDK customizations and build online More than 1400 packages For Vybrid, ALL customers purchasing Tower or PHYTEC kits can register to get PRO tools with unmetered support

14 14 14 Vybrid Linux Device Description Linux Kernel Framebuffer TWR-LCD YES Touchscreen Resistive YES UART Serial Console YES Ethernet Networking YES I2C BUS YES NAND Flash Device YES USB OTG, OTG Host YES Latest version is MQX Latest released version for Linux We will use version today MCC Latest version available Audio YES MMC/SD/SDIO Storage cards YES Watchdog Timer YES RTC Real-tim clock YES MCC Communication YES ADC YES DSPI Bus YES ASRC Async Sample Rate Converter YES CAN Bus NO GPIO YES Power Mgmt YES

15 15 15 We Are Building a Accelerometer based demo Exercises do not involve jumping off a plane!

16 Linux-MCC-WebGL-Accelerometer Lab

17 17 17 Vybrid Demos You can access demo images from here: The images contain all necessary software to launch a demo at boot time Several options available - features, boards Timesys and Freescale will maintain the demos and produce additional ones over time

18 What We Need to setup/run demos A Host Machine Can be either Linux or Windows MicroSD card reader Tower System Elevators Vybrid CPU board SER2 board LCD display Cables MicroUSB-USB (2 plugs) Ethernet Ethernet USB 18 18

19 19 19 Demo flashing Download IMG file Win32DiskImager (Windows only) Windows Launch win32 utility as administrator Select the card and IMG file Flash Linux Identify your card: insert the card run the command ls -ltr /dev/ Execute the following command as root: sudo dd if=<img file> of=/dev/sdc Warning!!! Using wrong /dev/sdx device may destroy your host OS Demo IMG file MicroSD

20 20 20 Running the OOBE demo Reset Install MicroSD card Connect the microusb cable Board will boot and start OOBE Demo on LCD display Important Note! Even with both plugs connected to PC USB ports, processor may not get enough power The symptoms will be rebooting when video starts or even sooner Solution - use wall-wart that provides at least 1 AMP or use a powered USB hub

21 21 Exercise 1: Demo Setup and Deployment

22 22 22 Demo Details Accelerometers tilt the tower - observe accelerometer indicators (LINUX/MQX/MCC) RTOS controlled sensors Linux controlled UI Multi-core (OS) communication (MCC) LEDs watch 4 LEDs turn on/off (LINUX) GPIO controlled LEDs Video Start the video playback (LINUX) Linux controlled UI GStreamer based codec/decoder framework WEBGL Click on the WWW button and setup the WEBGL connection according to instructions (LINUX/MQX/MCC) RTOS controlled sensors Linux WebServer + CGI Connectivity Multi-core Communication ADC Rotate the knob, observe rotating widget on the screen. Multi-core Communicatio

23 23 23 WebGL demo setup Connect the ethernet cable Establish a TCP/IP connection To enable WebGL in the browser: Chrome In the address bar enter about:flags Find the flag Disable WebGL and disable it (this is confusing because it s a double negative disabling the flag enables the feature) Firefox In the address bar enter about:config Set webgl.force-enabled to true Enter the Vybrid target IP in the web browser URL field Now, rotate the tower and observe the web browser screen

24 24 24 Demo BSP and SDKs Can be downloaded from LinuxLink Register the kit to get access to Prebuilt Demos BSP/SDK Initial pre-set development environment GCC toolchains included See demo first -> use as a starting point for development Development tools Customize BSP/SDK easily Web based tools Desktop based tools (advanced) Develop Applications with an Eclipse based IDE DS5 Timesys Plugins

25 25 Demo is nice, but what s next? BSP/SDK Customizations

26 26 26 Building a 3D Motion Device with LinuxLink Agenda 1: Running Demo on Tower How to deploy the OOBE demo on the Freescale Tower. Demo overview 2: BSP & Dev Environment How to assemble and deploy an initial BSP and setup development environment with the matching SDK 3: RTOS & MCC How to monitor an accelerometer in RTOS and trigger 3D animations under Linux 4: Debugging & Optimizations How to debug, optimize, test and integrate the solution for fast boot and quick deployment

27 27 27 Your Workstation Setup Ethernet/Serial USB Development Environment Cross tools IDE Exercises

28 28 28 Embedded Linux

29 29 Memory Model 2013 Timesys Corp.

30 30 Memory Model 2013 Timesys Corp.

31 31 Memory Model 2013 Timesys Corp.

32 32 32 Embedded Linux Reference Model Web GL demo User Interface, Buttons, Stream sel, etc 3 Auto-launch Web Pages Network control interface Accelerometer Data Middleware openssh Qt Embedded setup scripts shell LCD calibration 2 Linux kernel 1 U-Boot bootloader Vybrid Driver LCD Splash Screen Driver Driver setup script Web Server Wireless tools Driver Driver Driver Shared Memory Driver Touch Screen Ethernet Serial MCC API networking XIP USB SDIO Memory

33 33 33 MQX Reference Model Application (s) Network control interface 2 Accelerometers Functional Blocks setup scripts setup script MCC API networking File system MQX kernel 1 Driver Bootloader Vybrid Driver Driver LCD Driver Services Shared Memory Driver Touch Screen Button Serial Driver Driver XIP Ethernet USB SDIO Memory

34 34 Exercise 2: Assemble a Custom BSP Using the LinuxLink FREE Edition Web Interface

35 35 35 LinuxLink Architecture

36 36 36 LinuxLink Architecture

37 37 37 Requirements Helper Feature What I need Where to select Linux kernel Latest, 3.x kernel Linux kernel Cross-Toolchain GCC, Binutils, GDB Toolchains C Library glibc Toolchains GStreamer gst-plugins-good Packages Font freetype Packages Qt qt-embedded-linux Packages Networking openssh Packages System initialization busybox Packages

38 38 38 Account Login info We have accounts setup specifically for Timesys University Login with the following credentials: U: labuserx where X is 1-20 P: lab123 You can register for a free personal account

39 39 39 Development Environment Setup BSP/SDK Summary Software Development Kit (SDK) Install on your host PC Desktop Factory tools Install on your host PC Can find instructions on how to setup the board

40 40 40 Exercise 3: Setup Your Command Line Application Development Environment

41 41 41 Exercise Details Install an SDK from a build output Installation command sh <SDK name.sh> For your convenience the BSP/SDK may have been downloaded for you and preinstalled under: /home/tsu-lab/lab/bsp Look at a directory structure Verify toolchain with command: <fully qualified path to toolchain s gcc> -###

42 42 Desktop Build Environment

43 43 43 Desktop build environment At least two options for host based build engines Both options are FREE to Vybrid users and are based on Open Source

44 44 44 Key Features Advanced Customization (all aspects of your Linux platform) Factory Only easy to use, innovative Build System with: Advice engine recommends software based on your hardware and application requirements Update engine automatic updates for your custom configuration Build up vs. strip down to small distribution Build Repeatability Easy Extensibility It is easy to prototype and to develop Desktop Factory

45 Desktop Factory

46 46 Factory: High-Level Flow 1. Fetch Sources, Patches, Additional files 2. Build Host Tools and Libraries (toolchain) 3. Build Target Binaries (Root File System) 4. Package binaries At a high level, the Factory flows through these five stages. However, due to dependencies that require components to be built out of order, the Factory operates in a recursive manner. 1.All sources, patches, and other files (e.g., startup scripts) are fetched from the designated source (typically Timesys Repository). 2.The host tools are built including ccache, and the gcc cross compiler suite (glibc or uclibc, binutils, etc.). Any additional host utilities are built as well. Simply stated, everything that will execute on the x86 host are built here. 3.All target software is built. The kernel image and RFS image are created here as well. 4.As 5. Create Installers requested (e.g., RPM, deb), binaries are packaged. 5.Installers (e.g. SDK) are created.

47 47 make Targets Make Targets Functionality checksystem, checktool-oprofile, checktool-ltp, checktool-mpatrol, checktool-gdb System requirements and compatibility checks. advice, showpackages, showoutput Information commands checkupdates, update, updatenoprompt, oldconfig Updating Clean, download-clean, distclean, rfs- Clean commands distclean, packages-distclean, software-distclean, reset-toolchain -clean, -distclean, -fetch, -unpack, -patch, -configure, -build, -package, -rfs-install, -host-install, -show Per-application targets (all preceded by application name without version e.g. busybox-clean) menuconfig, config workorder (.config) editors

48 48 48 Application Development Tools IDE - Installation/Setup

49 49 49 Integrated Development Environment DS-5 with Timesys Plugins ARM toolchain - MQX development GCC toolchain - Linux development Installation DS5 can be downloaded from ARM Download TimeStorm (including Qt plugins) from LinuxLink Preinstalled in your UBUNTU Run Desktop icon for ARM DS5

50 50 50 IDE and Cross-Environment Host PC/Linux DS5 Recognizes Automatically LinuxLink Desktop Interface

51 51 51 Projects in DS5 MQX Project Linux Project GCC code size -> Unlimited ARM Ltd Compiler code size -> 256K or 1 MB Based on which Vybrid Tower Kit is purchased

52 52 52 WebGL application setup MQX project 1. ~/MQX/FSLMQXOS_4_0_1-linux/mqx/build/ds5/bsp_twrvf65gs10_m ~/MQX/FSLMQXOS_4_0_1-linux/mqx/build/ds5/psp_twrvf65gs10_m4 ~/MQX/FSLMQXOS_4_0_1-linux/mcc/build/ds5/mcc_twrvf65gs10_m4 4. ~/MQX/FSLMQXOS_4_0_1-linux/mcc/examples/accelerometer Linux project accelerometer-cgi All projects have been setup for you and will show up when you open your DS5-Workspace. If your MQX sources can not be found by DS5, you will need to reimport projects from scratch

53 53 53 Building your WebGL software Right mouse click to bring up context menu Select Project Settings - make sure the right toolchain is selected Right mouse click again -> Build Execute this process for both MQX and Linux applications Watch Build Console at the bottom of the screen If build successful you will see binaries in the project Ready for deployment? We will cover that in the next exercise

54 54 LAB 5: DS5 - Application Launch DS5 Open DS5-Workspace (default) Expand all projects Inspect Accelerometer projects Which one is MQX? Use context menus Look at Project Properties Compile each project 2013 Timesys Corp.

55 55 55 Fast-Integrated Development Environment Design your application WYSIWYG Compile locally Cross-compile for your Vybrid target Use SDK integrated APIs e.g. GStreamer OpenGL ES Web Server Execute and Debug on your target with a single mouse click Never leave your IDE environment Qt Plugins HW assisted JTAG debugging if/when you need it (DS5+DStream) DS5 SDK Toolchain Gstreamer API Qt API Eclipse

56 56 56 Building a 3D Motion Device with LinuxLink Agenda 1: Running Demo on Tower How to deploy the OOBE demo on the Freescale Tower. Demo overview 2: BSP & Dev Environment How to assemble and deploy an initial BSP and setup development environment with the matching SDK 3: RTOS & MCC How to monitor an accelerometer in RTOS and trigger 3D animations under Linux 4: Debugging & Optimizations How to debug, optimize, test and integrate the solution for fast boot and quick deployment

57 57 MQX & MCC Overview

58 58 OS Comparison (for the purpose of training) MQX O/S components are libraries linked with your application to create a single bare-metal execution image. Source distributed as DS-5 (Eclipse) projects in a single source tree. Built with ARM bare-metal compiler. (advanced) Linux Kernel is a bare-metal executable, but isn t enough. Your application (except possibly device drivers) is built separately and runs (launched) from a file system. Therefore a root file system (RFS) is a required component of Linux. Timesys Factory (on web or desktop) builds the RFS. It will build the Kernel and your Application, but they can be also built outside as well. Built with (Timesys) gcc compiler. A single address space no memory protection, mapping, (advanced) or transformations between hardware I/O, O/S components, Linux utilizes the memory management unit application. (MMU) of the A5 core. All processes are Programs are tasks each in their hardware protected from stepping on each own thread. other s memory. Programs run as a process which can have many threads.

59 59 Overview of MCC Multi-Core Communication Communication layer between MQX and Linux Lightweight, fast API calls are simple send / receive between endpoints Endpoints are [core, node, port] triplets Sort of IP host, address, port but not really. Core is fixed (A5=0, M4=1] Linux can have multiple nodes, MQX only 1 Each can have multiple endpoints, arbitrary numbering Uses shared SRAM and interrupts Received data can be passed by pointer or copied Variable timeouts Configurable: Buffer sizes # of buffers Max # of endpoints

60 60 MCC Architecture A5 - Linux M4 - MQX User App process(es) API shared library Kernel Module Driver Endpoint 0,0,1 Endpoint 0,2,3 User App (tasks) Interrupts API library Hardware Semaphore Endpoint 1,0,1 Endpoint 1,0,2 Free buffer pool Shared SRAM

61 61 Simple Example A5 - Linux 1. I will receive on endpoint [0,0,1] 2. mcc_initialize(0) 3. mcc_create_endpoint([0,0,1], 1) 4. mcc_send([1,0,2], hello, 5, 5000) // <= 5 secs for buffer 5. mcc_recv_copy([0,0,1], &buf, sizeof(buf), length, 0xffffffff) M4- MQX 1. I will receive on endpoint [1,0,2] mcc_initialize(0) 1. mcc_create_endpoint([1,0,2], 2) 2. mcc_recv_nocopy([1,0,2], &buf_p, length, 0xffffffff) 3. mcc_send([0,0,1], hello, 5, 5000) // <= 5 secs for buffer

62 62 Resource Sharing A5 Linux M4 MQX accelerometer example MCC boa webserver accelerometer-cgi HTML 5pages Images theater-vybrid Network Vybrid SOC I2C Bus Z X Y MMA8451 Accelerometer TWR-LCD-RGB Touchscreen WebGL capable browser

63 63 Protecting I2C Sequences MQX Application 1. Open the I2C driver a) Disable and clear I2C b) Clear out all I2C events c) Set the station address d) Set the frequency e) Enable I2C 2. Set master mode Set the device address 1. Do read/write sequence a) Send out stop b) Close the driver. Must be protected in application. Hardware semaphore protection. Linux Driver 1. Enable I2C controller 2. Set master mode, Interrupts 3. Set the device address 4. Wait for interrupt 5. Do read/write sequence including wait for interrupt 6. Send out stop 7. Disable I2C controller Protected in driver. Transparent to application.

64 64 GPIO Output (e.g. LED) MQX 1. lwgpio_init(&led1, gpio_pin_num, LWGPIO_DIR_OUTPUT, initial_setting) 2. lwgpio_set_functionality(&led1, BSP_LED1_MUX_GPIO) 3. lwgpio_set_value(&led1, value); Linux command line or file operations open() write() read() Each line is controlled close() individually (not a bus) 1. echo pin_num> /sys/class/gpio/export therefore, no 2. echo out > /sys/class/gpip/gpiopin_num/direction semaphores required. 3. echo value > /sys/class/gpip/gpiopin_num/value The system design Input (without interrupts) defines usage. MQX 1. lwgpio_init(&pb1, gpio_pin_num, LWGPIO_DIR_INPUT, initial_setting) 2. lwgpio_set_functionality(&pb1, BSP_LED1_MUX_GPIO) 3. lwgpio_get_value(&pb1); 1. Linux command line or file operations open() write() read() close() echo pin_num> /sys/class/gpio/export 1. echo in> /sys/class/gpip/gpiopin_num/direction 2013 Timesys Corp. 2. cat /sys/class/gpip/gpiopin_num/value

65 65 65 Building a 3D Motion Device with LinuxLink Agenda 1: Running Demo on Tower How to deploy the OOBE demo on the Freescale Tower. Demo overview 2: BSP & Dev Environment How to assemble and deploy an initial BSP and setup development environment with the matching SDK 3: RTOS & MCC How to monitor an accelerometer in RTOS and trigger 3D animations under Linux 4: Debugging & Optimizations How to debug, optimize, test and integrate the solution for fast boot and quick deployment

66 66 66 Debugging With DS5 you can simultaneously debug both Linux and MQX applications Accelerometer example You can Debug MCC communication No additional hardware required You can collect traces and do additional code analysis and code optimizations when using DStream

67 67 67 Board setup - development/debugging Tower Network USB (power& console) Linux Workstation (or virtual) Serial (Console)

68 68 Yocto

69 69 69 Yocto Yoctoproject is a framework for creating Linux distributions for embedded devices. It's not an embedded Linux distribution - it cr eates a custom one for you!

70 70 70 Yocto Consists of several separate projects: Bitbake: parses metadata and runs tasks OpenEmbedded Core: core metadata and build information to build baseline embedded systems Poky: Yocto example distribution which integrates all the required pieces and makes an official release hob: GUI tool to select packages to build and easily create custom image

71 71 71 Metadata Metadata.bb and.bbappend files: recipes - structured collections of instructions which tell BitBake what to build.conf files : configuration files.bbclass files : classes

72 72 72 Yocto Project Development Environment

73 73 73 PC Linux Setup: The following list shows the required packages by function given a supported Ubuntu Linux distribution: Essentials: Packages needed to build an image on a headless system: $ sudo apt-get install gawk wget git-core \ diffstat unzip texinfo build-essential chrpath Graphical Extras: Packages recommended if the host system has graphics support: $ sudo apt-get install install \ libsdl1.2-dev xterm Documentation: Packages needed if you are going to build out the Yocto Project documentation manuals: $ sudo apt-get install make xsltproc \ docbook-utils fop dblatex xmlto ADT Installer Extras: Packages needed if you are going to be using the Application Development Toolkit (ADT) Installer: $ sudo apt-get install autoconf automake \ libtool libglib2.0-dev

74 74 74 Yocto Source First, tell the local git installation who you are: $ git config -global user. jdoe@ex.com $ git config -global user.name John Doe Install the community source using repo $ mkdir ~/work/yocto $ cd work/yocto $ wget git-repo-downloads/repo $ chmod a+x repo $./repo init -u fsl-community-bsp-platform -b dora $./repo sync... Fetching projects: 100% (6/6), done.

75 75 75 Yocto Source Result: setup-environment sources base meta-fsl-arm meta-fsl-arm-extra meta-fsl-demos meta-openembedded poky Any time you want to update your local release Just do./repo sync again.

76 76 76 Setup build environment Include script $ export MACHINE=twr-vf65gs10 $. setup-environment build Configuring for twr-vf65gs10 [EULA] Welcome to Freescale Community BSP The Yocto Project has extensive documentation about OE including a reference manual which can be found at: For more information about OpenEmbedded see their website: You can now run 'bitbake <target>' Common targets are: core-image-minimal meta-toolchain meta-toolchain-sdk adt-installer meta-ide-support Your build environemnt has been configured with:...

77 77 77 Yocto Source Listing available: machines $ ls sources/*/conf/machine/*conf targets $ bitbake-layers show-recipes "*-image-*" packages $ bitbake-layers show recipes

78 78 78 Configuration conf/local.conf: MACHINE??= 'twr-vf65gs10' DISTRO?= 'poky' PACKAGE_CLASSES?= "package_rpm" EXTRA_IMAGE_FEATURES = "debug-tweaks" USER_CLASSES?= "buildstats image-mklibs image-prelink" PATCHRESOLVE = "noop" BB_DISKMON_DIRS = "\ STOPTASKS,${TMPDIR},1G,100K \ STOPTASKS,${DL_DIR},1G,100K \ STOPTASKS,${SSTATE_DIR},1G,100K \ ABORT,${TMPDIR},100M,1K \ ABORT,${DL_DIR},100M,1K \ ABORT,${SSTATE_DIR},100M,1K" CONF_VERSION = "1" BB_NUMBER_THREADS = '2' PARALLEL_MAKE = '-j 2' DL_DIR?= "${BSPDIR}/downloads/" ACCEPT_FSL_EULA = "1"

79 79 BitBaking

80 80 80 Yocto Hands-on: adding packages packaging own software image customization hob deploying

81 81 81 Hob

82 82 82 Hob

83 83 83 Hob

84 84 Q&A Thanks for attending!