Instruction/ maintenance manual of the product uClinux SLS Audio
Go to page of 62
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.
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.
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.
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.
System Level Solutions vi Table of Contents 1. Introduction ....................................................................................................... 1 1.1 Software ........................................................................
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 ........................................
.
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.
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 .
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.
.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 b.
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.
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 .
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.
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.
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 ---> [*].
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.
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.
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.
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.
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 .
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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 .
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.
System Level Solutions 45 8. Demonstrations & Quick Reference Download Demonstrations and Quick Reference from http://slscorp.com /pages/bspdownload.
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.
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.
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.
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 .
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.
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.
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.
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.
Demonstrations uClinux NEEK BSP Figure 29 : Framebuffer Console View 2 54 System Level Solutions.
An important point after buying a device SLS Audio uClinux (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought SLS Audio uClinux yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data SLS Audio uClinux - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, SLS Audio uClinux you will learn all the available features of the product, as well as information on its operation. The information that you get SLS Audio uClinux will certainly help you make a decision on the purchase.
If you already are a holder of SLS Audio uClinux, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime SLS Audio uClinux.
However, one of the most important roles played by the user manual is to help in solving problems with SLS Audio uClinux. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device SLS Audio uClinux along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
