SLS Audio uClinux manual

uClinux NEEK BSP User Guide NEEK BSP Version: 2.0.0.0 Document Version: 1.5 Date: September 2008 System Level Solutions, Inc, (USA) 14100 Murphy Avenue, San Martin, CA 95046 (408) 852 - 0067 System Level Solutions, (India) Pvt, Ltd. Plot # 32, Zone - D/4, Phase 1, G.I.D.C. Estate, V.U. Nagar - 388 121 Gujarat, In di a 91-2692-229280 http://www.slsc[...]

Copyright © 2008, System Level Solutions, Inc. (SLS) All rights reserved. SLS, an embedded s ystems company, the stylized SLS logo, specific device designations, and all other words and logos that are identified as trademarks and/or service marks are, unless noted otherwise, the trademarks and service marks of SLS in India and other countries. All[...]

About This Document uClinux NEEK BSP System Level Solutions iii About This Document This document describes the usage of the uClinux NEEK board support package. With the help of the bsp you can develop embedded applications using N EEK kit and uClinux. Table below shows the revision history of the document Version Date Description 1.0 July 2008 Fir[...]

Typographic Conventions uClinux NEEK BSP iv System Level Solutions[...]

uClinux NEEK BSP uClinux NEEK BSP Development Environment Typographic Conventions This document uses the typographic conventions shown as below. Visual Cue Meaning Bold type with initial capital letters All headings, subheadings titles in a document are displayed in bold type with initial capital letters. E.g. Configuring and Compiling. Bold Projec[...]

System Level Solutions vi Table of Contents 1. Introduction ....................................................................................................... 1 1.1 Software ................................................................................................................... .............. 1 1.2 Hardware..........................[...]

uClinux NEEK BSP uClinux NEEK BSP Development Environment 5.1.2 Accessing Flash a n d JFFS2 Ap plications .................................................................. 26 5.1.3 Configuring Flash Pa rtition ....................................................................................... 27 5.2 VGA, LC D and SD Card A pplication..........[...]

[...]

System Level Solutions 1 1. Introduction uClinux NEEK Board support package (BSP) provides developers with the easiest and fastest way to create embedded applic ations on the NEEK kit (target) using the uClinux operating system. This comb ination of hardware, firmware, and software form a complete package fo r building, downloading, and testing app[...]

Introduction uClinux NEEK BSP 16-Mbytes Intel P30/P33 flash and LCD multimedia card. To get the details of NEEK kit, please read NEEK user guide located at /DOCS . 1.3 Supported Devices The NEEK board devices that are currently supported in the uClinux kernel with the uClinux NEEK BSP include: • Flash • SD Card IP • 10/100 Ethernet IP • VGA[...]

uClinux NEEK BSP uClinux NEEK BSP Development Environment 4. Apply power to the NEEK board. 5. Connect VGA connector of the monito r to the VGA port of NEEK board if you want to see the images on both the VGA screen and LCD. System Level Solutions 3[...]

[...]

2. uClinux NEEK BSP De velopment Environment This chapter provides information to help setup the development environment for the NEEK board. 2.1 NEEK BSP SOPC System The Figure 1 below shows the block diagra m of NEEK BSP SOPC system. Figure 1 : NEEK BSP SOPC System VGA Contro ller LCD Controller UART DDR SDRAM 32MB SSRAM 1MB Flash 16MB 10/100 Ethe[...]

uClinux NEEK BSP Development Environment uClinux NEEK BSP Figure 2 : Development Environment uClinux BSP Applications RED HAT uClinux Nios II IP Cores NEEK BSP SOPC System Host Target NEEK Board Ethernet Serial 2.2.1 NEEK BSP Components Table below lists the components in cluded in the uClinux NEEK BSP. Component Description kernel v2.6.27 gcc v3.4[...]

uClinux NEEK BSP uClinux NEEK BSP Development Environment 2.2.2 IP Address Used The table below lists the IP address a nd port used throughout this document. It may be different for your system. Please check your network settings before applying any IP address. IP Address Description 192.168.0.14 Development Target IP address 192.168.0.26 Developme[...]

uClinux NEEK BSP Development Environment uClinux NEEK BSP #cd Bintools #tar jxfv nios2gcc-20080203.tar.bz2 6. Return to uClinux #cd.. 7. Issue command #ls Here you will see nios2-linux Bintools System-files. 2.3.2 Directory Contents You have now successfully unpacked th e BSP package. You will see following directory structure: Directory Descriptio[...]

uClinux NEEK BSP uClinux NEEK BSP Development Environment 1. Open the Linux terminal. 2. On the terminal, change into the $home/uClinux/uClinux-dist directory and change the environment path. Use one of the four main kernel configuration methods to st art the configuration menu. #cd /home/uClinux/nios2-linux/uClinux-dist #PATH=$PATH:/home/uClinux/B[...]

uClinux NEEK BSP Development Environment uClinux NEEK BSP Figure 4 : Vendor/Product Configuration Windo w 2. Select the following options: • Vendor: Vendor (Altera) • Target Product: Altera Products (nios2) ----> 3. Select <Exit>. You will return to Kernel configuration menu Figure 3 . Configuring Kernel/Library/Defaults Settings 1. Se[...]

uClinux NEEK BSP uClinux NEEK BSP Development Environment Figure 6 Libc Version Settings 3. Press Enter to select None. 4. Select <Exit> 5. Select <Exit> 6. You will be asked to save the kernel configuration. See Figure 7 Figure 7 : Save Option 7. Select <Yes> and press Enter . You have now finished Kernel/Library/Defaults setting[...]

uClinux NEEK BSP Development Environment uClinux NEEK BSP Figure 8 : CPU Selection 2. Enter the choice (1 ). It will ask to select a devi ce to execu te kernel from: See Figure 9 Figure 9 : Select a Device to Execu te Kernel From 7. To select DDR SDRAM, enter: Selection:7 8. Now create romfs directory by issuing following command. #make romfs 12 Sy[...]

uClinux NEEK BSP uClinux NEEK BSP Development Environment You may get error. Ignore it. 2.4.3 Customization of Kernel Settings 1. To customize the Kernel Settings, type on the terminal: #make menuconfig Figure 10 : Linux Kernel Configuration Windo w 2. Select Kernel/Library/Defaults Selection and press Enter. You will see the more kernel configurat[...]

uClinux NEEK BSP Development Environment uClinux NEEK BSP 5. Select <exit> 6. Select <yes> for saving all changed settings. Save all the settings and exit. 2.4.4 Building uClinux zImage Once you configured the kernel, build uClinux Image by issuing following commands. #make Here you will get zIma ge (elf file) at /home/ uClinux/ nios2- [...]

System Level Solutions 15 3. Downloading and Running zImage zImage is one type of elf file which contains compress kernel image and rom f s image. Given below are the steps for dow nloading a running zIm age in to the NEEK hardware platform. 3.1 Running zImage on Linux 3.1.1 Using JTAG UART Console To run zImage on Linux, you should have Nios2 EDS [...]

Downloading and Running zI mage uClinux NEEK BSP Figure 12 Minicom Configuration Win dow1 2. Select the Serial Device, baud rate and other parameters as shown in Figure 13 . Here, we have selected Serial device as /dev/ttyS0 but it m ay differ as per your development machine. Figure 13 : Minicom Configuration Windo w 2 16 System Level Solutions[...]

uClinux NEEK BSP uClinux NEEK BSP Development Environment 3. Set the baud rate 115200, 8 bit, no parity and one stop bit. See the Figure 14 Figure 14 : Minicom Configuration Windo w3 4. You may set this configuration as default by selecting Save Setup as dfl option after all configurations. 5. Now, download .sof and zImage from other terminal and y[...]

Downloading and Running zI mage uClinux NEEK BSP 3.2.2 Using Serial UART Console You can build zImage on Linux and run it on windows. This is the description for serial UART console. Go to the "/home /uClinux/uClinux-dist/images" directory. Copy the file named "zImage" and past e it in to your windows PC (make sure your zImage a[...]

4. Configuring Device Drivers and File Systems If more functions need to be supported on kernel, then before the kernel rebuild, it needs to do the selected kernel configur ation, the following sessions describe the procedures to do configurations. To know more about peripherals and hard ware available on the NEEK kit, refer the NEEK Kit Getting St[...]

Configuring Device Drivers and File Systems uClinux NEEK BSP 4.2 Flash Memory (MTD) Driver To include the Flash Memory (Mem ory Technology Device) driver in compilation, the following options should be enabled: Device Drivers ---> Memory Technology Devices (MTD) ---> [*] Memory Technology Device (MTD) support [*] MTD partitioning support [*] [...]

uClinux NEEK BSP Configuring Devi ce Drivers and File Systems File systems ---> Miscellaneous File systems ---> [*] Journaling Flash File System v2 (JFFS2) support (0) JFFS2 debugging verbosity (0 = quiet, 2 = noisy) [*] JFFS2 write-buffering support 4.3 SLS SD Card IP Driver To include the SD Card Driver in co mpilation, the following option[...]

Configuring Device Drivers and File Systems uClinux NEEK BSP --- Base native language support (iso8859-1) Default NLS Option [*] Codepage 437 (United States, Canada) [*] Codepage 850 (Europe) [*] NLS ISO 8859-1 (Latin 1; Western European Languages) [*] NLS UTF-8 File systems ---> DOS/FAT/NT File systems ---> [*] MSDOS fs support [*] VFAT (Win[...]

uClinux NEEK BSP Configuring Devi ce Drivers and File Systems 4.4.1 NFS NFS is a network file system protocol or iginally developed by Sun Microsystems in 1984, allowing a user on a client comput er to access files o ver a network as easily as if the network devices we re attached to its local d isks. If you want to use NFS file system on Ethernet [...]

Configuring Device Drivers and File Systems uClinux NEEK BSP 4.7 SLS T ouch Panel Controller (TPC) IP Driver To include the SLS TPC IP Driver in compilation, the following options should be enabled: Device Drivers ---> Character devices ---> [*] SLS TPC support 4.8 SLS I 2 S IP Driver To include the SLS I 2 S IP driver in compilation, the fol[...]

uClinux NEEK BSP Configuring Devi ce Drivers and File Systems 4.10 JT AG UART Driver To include the JTAG UART Driver in compilation, the following options should be enabled: Serial support ---> [*] Altera UART support (4) Maximum number of Altera uart ports (115200) Default baudrate for Altera UART ports Device Drivers ---> Character devices [...]

5. User Applications Using the User Applications you can access the drivers, file systems and peripherals available on the board. This chapter describ es the following user applications. 5.1 Flash and JFFS2 Application To access Flash and JFFS2 application, incl ude its driver and file system as described in the section Flash Memory (MTD) Driver an[...]

uClinux NEEK BSP Network Utility flash_erase device offset number_of_blocks Erases number of blocks of a device starting from the given address. e.g. : flash_erase /dev/mtd0 0x00000 5 .This command would erase 5 bloc ks of mtdblock0 starting from the offset address 0x00000. flash_eraseall /dev/mtdx Erases all the contents of mtd device. e.g. : flas[...]

Network Utilities uClinux NEEK BSP Before going further, copy .jpg images from your PC in the SD Card and make the following selection. Miscellaneous Applications ---> ---video tools [*] jpegview 5.2.1 Viewing the SD Card Images on the VGA and LCD 1. To mount the SD Card on mnt dire ctory, Issue the following command on the target when the syste[...]

uClinux NEEK BSP Network Utility 10176026.jpg dho13v.jpg 4. View the images contained in the SD card on VGA monitor connected to VGA port of NEEK board and NEEK board LCD screen by issuing the following command. /mnt>jpegview -S1 –f 10036828.jpg 10176026.jpg  The console displays: SLS_VGA Driver is opened 800 480 800 480 0 0 16 0 -1 -1 fram[...]

Network Utilities uClinux NEEK BSP miscellenieous application --> --- Audio tools [*] mp3play Build the zImage with these options. To te st this application, copy the MP3 songs in SD card and run the zImage, when it is up and running. Mount the SD card as explained in Viewing the SD Card Images on the VGA and LCD . Issue following command: />[...]

uClinux NEEK BSP Network Utility [*] No Keyboard --- Install These Applications [*] Nano-X [*] NanoWM [*] NXclock [*] Have JPEG Support [*] Have PNG Support --- Display Config [*] Frame Buffer Display --- Mouse/Touch Screen [*] SLS TPC support --- Keyboard [*] Have File IO [*] Have BMP Support [*] Have GIF Support [*] Have PNM Support --- Applicati[...]

Network Utilities uClinux NEEK BSP 5.6 Adding New User Application This section explains you of adding a user application named hello in uClinux. Follow the steps below to add a new user application. 1. Create hello directory in the /home/uClinux/uClinux-dis t/user directory. 2. Copy source file (C file) to the hello directory 3. Add the configurat[...]

uClinux NEEK BSP Network Utility 5.7 Build New User Application Using SLS IP Drivers To build a new user application using SLS IP drivers refer DRIVERSAPI.txt located at / Docs . 5.8 Shell Commands Using Shell commands you can perform operations on the uC linux on the NEEK board. Shell is the basic application on th e Linux system, default shell pr[...]

Network Utilities uClinux NEEK BSP In ln –s file1 file2 Creates a link to the specified TARGET Is ls [options] List information about the FILES mkdir mkdir dirname Creates the DIRECTORY mknod mknod type major minor Creates device file more more filename File perusal filter mount mount –t type device dir Mount file system mv mv source dest Renam[...]

6. Configuring Network utilities and NFS (Client) This chapter introduces you about the ne twork utilities ftp, dhcpcd, telnet, boa, and inetd. First of all follow all steps for Ethernet driv er m entioned in the section SLS Ethernet IP Driver . 6.1 Configuring DHCP Client 1. Select Customize Application/Library Settings. Do the following settings [...]

Root File Systems uClinux NEEK BSP 6.2 S tatic IP Allocation To configure the Static IP, do the following settings: BusyBox ----> [*] ifconfig [*] Enable status reporting output (+7k) To allocate static IP to the boar d, issue following command on the target. />ifconfig eth0 192.168.0.14  6.3 Mounting NFS on NEEK Before mounting NFS on NEE[...]

uClinux NEEK BSP Root File Systems 3. Edit the file named exports under /etc directory and add the following line: /home/nfs 192.168.0.0/255.255.255.0(s ync,no_root_squash,rw) This setting may differ as per your network 5. Restart NFS server. #service nfs restart 6. Verify it by issuing the following command. #showmount –e 6.3.2 NFS Client (NEEK)[...]

Root File Systems uClinux NEEK BSP #ftp 192.168.0.14  You will see following on the host term inal. Enter the ftp user name and password Connected to 192.168.0.14 220- Welcome to the uClinux ftpd! 220 uClinux FTP server (GNU inetutils 1.4.1)ready User (192.168.0.14 :( none)): ftp 331 Guest login ok, type your name as password. Password:  230 [...]

7. Debugging Kernel and User Application To debug the user application you will re quire following software and hardware: • Cross/Straight Network cable • JTAG cable • Eclipse IDE for C/C++ developers. You can download Eclipse IDE from the http://www.eclipse.org/downloads/d ownload.php?file=/technology/epp/do wnloads/release/20071103/eclipse-[...]

Debugging Kernel and User Application uClinux NEEK BSP break *main to break *start_kernel 5. Issue the command: #nios2-debug home/uClinux/uClinux-dist/linux 2.6.x/vmlinux.elf  Wait for few seconds and following window will get opened. Figure 17 : main.C Now you can debug easily with aid of GUI. You can set the break point, check the content of r[...]

uClinux NEEK BSP Debugging Ker nel and User Applications 7.2 Debugging User Application using gdbserver over Ethernet Insight is the GUI of gd b debugger. Often it’s not eas y to remember the debug Command. Therefore insight provides the graphical in terface so user can debug easily. The aim of the document is to explain how to debug user space a[...]

Debugging Kernel and User Application uClinux NEEK BSP #nios2-linux-uclibc-insight Helloworld.gdb  9. A source window will open and display the source Helloworld.c. 10. The open a gdb console, with View> Console , enter gdb command in this window. gdb>target remote 192.168.0.14:9999  (board_ip:9999) 11. Then it will report the target ad[...]

uClinux NEEK BSP Debugging Ker nel and User Applications 8. Project types, executable, Hello worl d ANSI C Project, (or empty project and add your source).Finish. 9. Now, setup for nios2 tool chain in Eclipse IDE on the host by following the steps below: a) Select the project Hellow orld under Project Explorer . b) Right click on Helloworld and sel[...]

Debugging Kernel and User Application uClinux NEEK BSP • Select workspace>Helloworld>Debug>Helloworld and copy the file into /uclinux-dist/romfs/bin. e) Build the zImage as explained in early section. f) Click OK . 10. Now, select Project-->Build project to compile your project. 11. Copy from your workspace/Helloworld/Debug/Helloworld[...]

System Level Solutions 45 8. Demonstrations & Quick Reference Download Demonstrations and Quick Reference from http://slscorp.com /pages/bspdownload.php . This demo package contains two types of applications: • Applications supported to N EEK Application Selector o SLS uClinux demo o SLS_Player These demonstrations are not the final product b[...]

Demonstrations uClinux NEEK BSP Figure 18 : Application Selector 2. In the application selec tor main menu , touch the S LS_Player to select it. 3. Touch the Load button located on the botto m left corner of the Touch Screen to load the SLS Player application. You will see Figure 19 Figure 19 : Loading SLS Player 4. The SLS Player information dialo[...]

uClinux NEEK BSP Debugging Ker nel and User Applications Figure 20 : Running the SLS Player - Main Menu 5. Change the SD Card mode as mentioned in dialog box and click OK . The SLS Player main menu displays. 6. Select MPEG to play MPEG clips. See Figure 21 below. Figure 21 : SLS Player Main Menu System Level Solutions 47[...]

Demonstrations uClinux NEEK BSP 7. Select Welcome.mpg and click Play . The MPEG clip will get played on the screen. 8. Repeat steps 6 to 7 to play JPEG and MP3 files SLS uClinux Demo The SLS uClinux demo is designed to run multiple applicatio ns on uClinux platform. The application uses SLS GUI library and various SLS IP cores including Ethernet Ma[...]

uClinux NEEK BSP Debugging Ker nel and User Applications Figure 23 : Running the SLS uClinux Demo - Main Menu 5. Select Start Experiment option. You will see a blank graph window as shown in Figure 24 . System Level Solutions 49[...]

Demonstrations uClinux NEEK BSP Figure 24 : SLS Player Main Menu 6. Select Start button to start logging the dummy data. The graph will be drawn as shown in Figure 25 below. Figure 25 : Data Logger - Graph Display 7. To view the logged data in table view, select Table option. See Figure 26 below. 50 System Level Solutions[...]

uClinux NEEK BSP Debugging Ker nel and User Applications Figure 26 : Logged Data in Table View 8. To change sampling frequency click on Setting s button. Enter the desired frequency. See Figure 27 below. Figure 27 : Data Logger Setting s System Level Solutions 51[...]

Demonstrations uClinux NEEK BSP 8.2 Quick Reference Quick Reference gives you quick overview of the applications explained in chapter 5 and 6. When you extract Qu ick Reference, you will find following directories: • Prebuilt_zImage • Framebuffer_console 8.2.1 Prebuilt_zImage Prebuilt_zImage directory contains files to format the SD Card and ot[...]

uClinux NEEK BSP Debugging Ker nel and User Applications Booting uClinux on NEEK LCD Download .sof and zImgae, you will s ee booting uClinux on N EEK LCD. When the zImage is already up and running, plug PS/2 keyboard in PS/2 port. Now execute the shell command as usual. Y ou can execute all shell commands offered by shell and can run various progra[...]

Demonstrations uClinux NEEK BSP Figure 29 : Framebuffer Console View 2 54 System Level Solutions[...]