Jade IdeaBoxx. The quickstart kit to jumpstart development. Fujitsu Semiconductor America Inc.

Transcription

1 Jade IdeaBoxx The quickstart kit to jumpstart development Fujitsu Semiconductor America Inc.

2 Table of Contents Standards Used in This Guide...3 Glossary of Terms and Acronyms...3 IdeaBoxx Kit Contents...4 Hardware Module...4 Suite of Software Tools...4 Introduction...5 Hardware Setup...5 Serial Console...5 HDMI Output...5 Display Controller Outputs...5 Schematic Front of Board...6 Schematic Back of Board...6 Trying Out Other Demos...7 Software Development in a Linux Environment...7 Install the BSP...7 Building the Bootloader, Linux Kernel, and Root Filesystem...7 Bootloader...8 Linux Kernel...8 Root Filesystem...8 Building the Linux Kernel with the Default Configuration...9 Compiling User Code...9 Setup...9 Building the Kernel...9 Building a Root Filesystem Image...9 C/C++ Cross-Compilers...9 Important File Locations...9 Support References...10 Jade...10 Memory Layout...10 IdeaBoxx Product Manual

3 Standards Used in This Guide In this guide different fonts will be used to make these instructions clearer. Standard descriptive text will be in this font. Commands to be typed at the console prompt will be in this font. File and folder paths will be in this font. All paths are given in UNIX format. For example, /demo is a folder called demo in the root of the specified device. Glossary of Terms and Acronyms Jade Fujitsu MB86R0x family of processors SoC System on Chip SoM System on Module PCB Printed Circuit Board LCD Liquid Crystal Display USB Universal Serial Bus BSP Board Support Package HDMI High Definition Multimedia Interface TFTP Trivial File Transfer Protocol NFS Network File System GUI Graphical User Interface IdeaBoxx Product Manual

4 IdeaBoxx Kit Contents The Jade IdeaBoxx kit includes the following components: Hardware Module 1. PCB with Fujitsu s Jade SoM, processor, graphics memory (frame buffer), Flash memory and RAM memory 2. 7-inch backlit LCD with capacitive touch screen USB stick containing documentation, and preloaded touch and non-touch demos 4. SD card 5. Power supply 6. USB cable for console access Suite of Software Tools USB stick containing documentation, and preloaded touch and non-touch demos (some of which are selfrunning). Datasheets and application notes for Jade IdeaBoxx Board files to create reference design platforms Libraries and tools free of charge and royalties* Schematics and Altium Designer project files for all PCBs Linux BSP virtual appliance image U-boot bootloader Linux kernel version Functional root file system GCC-based cross-compiler A 30-day demo version of Crank Software s Storyboard Suite GUI design software Storyboard Suite is a trademark of Crank Software, Inc. VirtualBox is a trademark of Oracle Corporation. ARM is a trademark of ARM Limited. IdeaBoxx Product Manual

5 Introduction The Fujitsu IdeaBoxx is a fully self-contained, graphics-centric SDK with everything a user needs to create a complete graphical sub-system in minutes. The principal concept behind IdeaBoxx is to provide a fast, easy-to-use and reliable real-world embedded environment that simulates how graphics would appear on the finished product. IdeaBoxx reduces the development timeline by incorporating all necessary hardware and software in an optimized bundle so users don't need to source anything. Everything in the IdeaBoxx has been designed and tested to work in a plug and play method so that users can focus completely on the creative elements of the design right out of the box. Designed as a series of products, IdeaBoxx complements the far-reaching capabilities of Fujitsu s Graphics Display Controllers. IdeaBoxx Jade is the first of three product rollouts. Jade IdeaBoxx allows users to produce an innovative design environment that simplifies and streamlines the process for developing 3D graphics. To get started, simply install the development system and use the precompiled demos located on the enclosed USB drive. Run the compiled software and preview graphic files to compare the differences in performance between the BSP and a more powerful PC development environment. The capabilities of the embedded processor can be investigated and appropriate changes made to the resolution or size of images for quicker loading. A Linux BSP, including the Linux kernel sources used, is also provided to allow the adventurous to develop more complex applications. A complete set of documentation, schematics, gerber files, and source code is included to ensure users can fully realize their ideas. This document summarizes the features of the Jade IdeaBoxx and gives instructions for setting up and starting the BSP, running the software and viewing graphical files. Hardware Setup Unpack the IdeaBoxx kit. Ensure that the microsd card is fully seated in its slot on the bottom of the board. Plug the power supply into the IdeaBoxx board and then into the wall. Toggle the power switch to the ON position. The scale demo should startup automatically. Serial Console (13) The serial console is available via the mini-usb connector P7 on the bottom of the board. The USB device is an FTDI serial-to-usb converter. Most operating systems have the driver built in. However, if the driver is not included, users can download it from FTDI at The serial port is configured to operate at standard ,8,n,1 serial settings. Users can log in as root with no password. HDMI Output (4) The HDMI output at jack J400 can be enabled by setting switch S2-1 and switches S400-5 and S400-6 to the ON position. These are the default settings. The default resolution is factory set to 800x480 pixels to match the LCD panel. Note: HDMI output may not display correctly on all televisions and monitors. Display Controller Outputs (1 2) The included LCD panel is connected to the 50-pin header labeled LCD 0 header connected to display controller 0. Display controller 1 is also available via a second 50-pin header labeled LCD 1. The LCD panel assembly must be removed to access these headers. IdeaBoxx Product Manual

6 Schematic Front of Board LCD1 Output 2. LCD0 Output 3. 5-Way Joystick 4. HDMI Output 5. Reset Switch 6. Headphone Output 7. Line Level Output 7 8. Line Level Input 9. Ethernet USB Connector Power Switch Power connector 13. Mini USB 14. Micro SD slot Schematic Back of Board IdeaBoxx Product Manual

7 Trying Out Other Demos The demos are located in the folder /demos on the USB drive and on the microsd card. Use the directions below to run demos on the IdeaBoxx board. In the directions below 'device' refers to the USB drive or the microsd card, whichever is applicable. 1. Navigate to the device. 2. Open the 'startup.sg' file in an editor. 3. Locate the matching lines below: demo=home #demo=fitness #demo=health #demo=scale #demo=washer 4. Delete the hashtag symbol (#) from in front of the demo name you wish to run. Ensure that all other lines in the selection begin with a hashtag symbol. Software Development in a Linux Environment Install the BSP The BSP is provided as a standard Debian DEB package. You should be able to install it in Debian or any Debian-derived Linux distribution. The BSP was tested with Xubuntu LTS installed in a VirtualBox machine. The user doing the install will need sudo permission on the development system. To install the BSP: 1. If the Synaptic package manager is installed, double-click on the package in a file explorer. That should start Synaptic and install the package. 2. To install the package manually: Navigate to the folder containing the fujitsujadebsp_0.1-1_all.deb. Run sudo dpkg I-fujitsujadebsp_0.1-1_all.deb If any missing dependencies errors are reported, run sudo apt-get-f-install-y to install the missing dependencies. 3. Logout and login as user jade. The password will be jade as well. 4. The BSP will be installed at /opt/jade/bsp100 with the compilers installed at /home/jade/opt/crosstool/*. 5. The root filesystem for the Jade system can be found at /opt/jade/bsp100/nfsroot. When the kernel is rebuilt, the installable modules will be installed in this folder structure. 6. The kernel and rootfilesystem images can be built with the following commands: cd /opt/jade/bsp100./build.sh Building the Bootloader, Linux Kernel, and Root Filesystem The three major things an engineer might need to rebuild in Linux are the bootloader, Linux kernel and root filesystem. Each can be rebuilt using the build.sh script in its respective folder. IdeaBoxx Product Manual

8 Bootloader The bootloader source code is in /opt/jade/bsp101/sources/u-boot. To rebuild it, use the./build.sh shell script provided in the source code folder. The result will be multiple files in the top-level source code folder. The new binary bootloader file will be named /opt/jade/bsp100/sources/u-boot/u-boot.bin. To program the bootloader into the Jade board: 1. Turn on power to the IdeaBoxx board. 2. Press a button to stop the bootloader. 3. Type tftp u-boot.bin 4. Type erase FFFF 5. Type cp.b $filesize 6. Type reset and Jade will reset and execute the new bootloader. Linux Kernel The Linux kernel source tree is in /opt/jade/bsp100/sources/linux Before reconfiguring or building the kernel for the first time, the user must execute make jade-ideaboxx_defconfig. To reconfigure the Linux kernel (e.g., to add or remove drivers), execute make menuconfig. To rebuild it, change to the top-level directory of the kernel source tree and execute./build.sh. This will create a new kernel as /opt/jade/bsp100/sources/linux-3.0.3/arch/arm/boot/uimage. The new kernel will also be copied to / tftpboot/uimage303-$yyyymmdd-hhmm where the date and time are given as a four-digit year and two-digit month, day, hour (24-hour format) and minute. A symbolic link to that file is also created as /tftpboot/uimage. To program the new kernel into the Jade board: 1. Turn on power to the IdeaBoxx board. 2. Press a button to stop the bootloader. 3. Type tftp uimage 4. Type erase FFFFF 5. Type cp.b $filesize 6. Type reset and Jade will reset and execute the new Linux kernel. Root Filesystem The root filesystem is in /opt/jade/bsp100/nfsroot. To build a new root filesystem image suitable to be programmed into Flash, change to the root filesystem directory and execute./build.sh. This will create a new root filesystem binary image as /opt/jade/bsp100/sources/linux-3.0.3/arch/arm/boot/uimage. The image will also be copied to / tftpboot/rootfs303-$yyyymmdd-hhmm where the date and time are given as four-digit year and two-digit month, day, hour (24-hour format) and minute. A symbolic link to that file is also created as /tftpboot/rootfs.bin. To program the new image into the Jade board: Turn on power to the IdeaBoxx board. 1. Press a key in the serial terminal program to stop the bootloader. 2. Type tftp rootfs.bin 3. Type erase dfffff 4. Type cp.b $filesize IdeaBoxx Product Manual

9 5. Type reset to reset Jade and boot the new filesystem. Building the Linux Kernel with the Default Configuration To rebuild the Linux kernel with the default configuration, execute the following commands. Note that this will delete any existing local kernel configuration, so users should copy it to another directory before proceeding if they want to save the kernel. cd /opt/jade/bsp100/sources/linux make distclean make jade-ideaboxx_defconfig &&./build.sh Compiling User Code A C and C++ compiler are included in the BSP. They are /home/jade/opt/crosstool/gcc glibc-2.7/arm-unknown-linux-gnueabi/bin/arm-unknownlinux-gnueabi-gcc and /home/jade/opt/crosstool/gcc glibc-2.7/arm-unknown-linux-gnueabi/bin/arm-unknownlinux-gnueabi-g++ respectively. This path is included in the system path variable. These are cross-compilers built from GCC sources and use the same command-line arguments. To compile a single-source-code program, arm-unknown-linuxgnueabi-gcc hello.c -o hello will generate a binary file hello that will run on Jade. Setup The Jade IdeaBoxx board can boot from Flash (the default) or from TFTP + NFS via Ethernet. The default IP address of the board is U-boot is configured to look for TFTP and NFS servers at address The VirtualBox appliance has these servers configured and active out of the box. To boot via Ethernet, press any key on the serial console immediately after power on to stop u-boot. Then execute run netboot from the u-boot prompt. Building the Kernel To rebuild the Kernel, navigate to /opt/jade/bsp100/sources/linux in the development filesystem. The kernel can be rebuilt with make jade-ideaboxx_defconfig then./build.sh. Note: make jade-ideaboxx_defconfig only needs to be run once or after running make distclean. The resulting image will be /tftpboot/uimage. Building a Root Filesystem Image To build a root filesystem image suitable for flashing into the Jade SOM, navigate to /opt/jade/bsp100 in the development filesystem. The filesystem image can be built with./build.sh. The resulting image will be. C/C++ Cross-Compilers The C compiler provided is a GCC-based cross-compiler. It can be executed with arm-unknown-linux-gnueabi-gcc. Likewise, the C++ compiler provided is a GCC-based cross-compiler. It can be executed with arm-unknown-linux-gnueabi-g++. Important File Locations u-boot source: /opt/jade/bsp100/sources/u-boot Linux kernel source: /opt/jade/bsp100/sources/linux Root filesystem top-level directory: /opt/jade/bsp100/nfsroot TFTP boot file location: /tftpboot IdeaBoxx Product Manual

10 Support References Jade The Jade GDC at the hub of the first IdeaBoxx is Fujitsu's most cost-effective, SOC-based display controller. Based on an ARM 926EJES processor running at 333MHz, Jade has a fixed-pipeline, 3D graphics engine powerful enough to produce sharp, crisp graphics on screen sizes up to 1024 x 768. Fabricated in Fujitsu s standard 90nm process, this graphics display controller is designed to provide the optimal balance of power, via low leakage current, and performance. Jade can support two screens independently, along with dual-capture ports, and can apply video images to 3D meshes via texture mapping. This combination of features makes Jade ideal for many industrial and medical applications where screen sizes of 4 to 10 inches are common. A hierarchical bus system isolates high-performance functions (e.g., 3D graphics processing) from routine operations (e.g., lowspeed I/O). Fujitsu has designed the ARM processor to run at twice the rate of the graphics core to reduce memory bus contention between these two primary functions. Memory Layout Jade s memory layout, both RAM and Flash, is described below. RAM: 0x x x43FFFFFF System RAM 0x x47FFFFFF Video RAM NOR Flash: 0x x x1002FFFF u-boot 0x x1005FFFF u-boot arguments 0x x102FFFFF Linux kernel 0x x11DFFFFF Root filesystem 0x11E x11FFFFFF Optional u-boot splash screen (.BMP file) FUJITSU SEMICONDUCTOR AMERICA, INC E. Arques Avenue, M/S 333, Sunnyvale, CA Tel: (800) Fax: (408) FSA_inquiry@us.fujitsu.com Follow Connect With Us: View Us: Fujitsu Semiconductor America, Inc. All company and product names are trademarks or registered trademarks of their respective owners. Printed in the U.S.A. GDC-DKJ-UM /2014