VxWorks 5.4 LEON BSP 1.0.1

Transcription

1 Gaisler Research VxWorks 5.4 LEON BSP Copyright Gaisler Research, Septem ber 2006.

2 VxWorks- 5.4 LEON BSP 1. Contents This CD contains a board support package (BSP) for LEON2 and LEON3 processors to be used with Wind River VxWorks- 5.4 operating system. The BSP includes drivers for the following functions: Interrupt controller UART 1 & 2 Timer unit GRETH 10/100 Mbit Ethernet MAC (LEON3 only) The BSP is intended to be used with the Windows version of Tornado- 2.0 workbench. The final executable will run on both LEON2 and LEON3/GRLIB processors without requiring any specific configuration. 2. Installation The BSP is installed by unpacking the BSP file (tornado leon_sparcv8.zip) inside the Tornado- 2.0 top- level directory, e.g. C:/Tornado. WinZip or the Windows XP unzip utility should be used to unpack the file. 3. Project creation A LEON2/3 kernel is made by creating a new project in the Tornado workbench, complete step one by entering workspace and project name, in step two select 'Create from BSP', and the click on 'leon_sparcv8':

3 The project is configured as any other VxWorks target. 4. Component selection and configuration Select what kind of components you want and configure them using the vxworks view from the project window: First, select board type under 'Gaisler Board Select'. At the time of writing two boards are supported, GR- XC3S and GR- CPCI- AT697. The GR- XC3S has an integrated GRETH Ethernet MAC, while the GR- CPCI- AT697 has a LAN91C111 (MAC+PHY) chip mounted onto the PCB. Including support for LAN91C111 on a GR- XC3S makes no sens. Each software driver has it's own configuration options. Software drivers can be excluded from the project to save space. Default for a GR- XC3S board is to include the Ethernet driver, but it is also possible to exclude it, see picture below.

4 To be able to use the Ethernet interface one must configure the Ethernet hardware address of the MAC, this is done by providing input to the MAC's driver. Enter the properties page of the GRETH component by double clicking the GRETH component, select the 'Params' tab and finally enter your unique 6 byte MAC address: RXBDNUM and TXBDNUM defines the number of descriptors(buffers) to use in the receiving and transmitting parts to the driver. Each descriptor adds about 3k of RAM usage to the driver. The GRETH MAC supports a minimum of one descriptor and a maximu m of 128 descriptors in both directions. To take advantage of the Tornado debugging tools maximally make sure to enable 'WDB END driver connection', see right figure. Tornado tools can access the target via the Ethernet interface if properly setup. One way to set up the network interface is to call ipattach() and ifaddradd() as done in the simple network example described later on.

5 5. Selecting build rule Choose build rule from the properties page for respective build target. It is up to the rule to decide where in memory the image will be run from. Select rule depending on how you intend to run vxworks, from PROM or RAM etc. When running from RAM using grmon select vxworks. It is now possible to build the project's binary file default/vxwork: The user application is called from usrappinit.c, as with any other VxWorks- 5.4 project. See network example below.

6 6. LEON2/3 peripherals The LEON2 on- chip peripherals are assumed to reside in the default address as defined in the LEON2 VHDL model. Also the interrupt assignment of UART and Timer are assumed to retain there default values. For LEON3 systems, the address and interrup t is read from the on- chip plug&play information, and assigned at run- time. 7. Support For support, contact the Gaisler Research support team at support@gaisler.com.

7 8. Examples The examples are written for GR- XC3S but are easily modified to run on other boards. For example, when using a GR- CPCI- AT697 the greth network interface name must be substituted with lnc Simple network example, using ping utility A simple network test application can be made by editing the usrappinit.c as follows: The example sets up the Ethernet interface to and adds itself and a host to the host name table by calling hostadd(). IfShow() is called to produce a UNIX ifconfig similar output for the greth0 interface. Later it pings the host to verify that the connection to host1 is working. For the example to work at least ICMPv4 and GRETH Ethernet driver component must be included. Also a valid Ethernet Hardware Address must be set in the GRETH driver. Download to GR- XC3S using grmon over usb: $ grmon -usb grlib> load project1/default/vxworks section:.text at 0x , size bytes section:.data at 0x , size bytes section:.bss at 0x40088b60, size bytes

8 Connect terminal software (hyperterminal, minicom, kermit) to GR- XC3S Serial J1 connector with settings 38400baud, 8 data bits, no parity, 1 stop bit ( n1). grlib> run Terminal software output: Could not find 0 Attaching interface lo0...done VxWorks Copyright Wind River Systems, Inc. CPU: Leon-board (LEON) VxWorks: 5.4 BSP version: 1.2/1 Creation date: Sep WDB: Ready. Adding Hostnames to lookup table Setting up Network Params for greth0 greth (unit number 0): Flags: (0x63) UP BROADCAST ARP RUNNING Type: ETHERNET_CSMACD Internet address: Broadcast address: Netmask 0xffffff00 Subnetmask 0xffffff00 Ethernet address is 00:00:7a:cc:00:12 Metric is 0 Maximum Transfer Unit size is packets received; 1 packets sent 0 multicast packets received 0 multicast packets sent 0 input errors; 0 output errors 0 collisions; 0 dropped host1 is Alive After extracting the leon sparc distribution a similar example can be found in '<Tornado top- level directory> \ target \ proj \ simple_network_example\usrappinit.c'.

9 8.2. Connecting to GR- XC3S with WindView using WBD over Ethernet Continue from previous example by adding WindView support to the project: Rebuild the project, download it and start the application. This can be achieved by using grmon as in the simple network example above. Start a target server and specifying the IP address you have given greth0 interface during the call to ifaddradd(). In our simple network example we passed Give your server a name, we call it Board in this example.

10 Start the target server by pressing 'Launch' when the configuration is done. The target server and the target GR- XC3S is now running, we connect to it by selecting target server using the drop down list as in the figure to the right. Verify the connection by pressing the info button. A dialog windows that display some general information appears. From the dialog you can also get other information, for example task stack sizes. Start WindView by clicking the WindView taskbar icon. Select TaskLib to log task activity, press OK. By pressing properties the log buffer size can be configured.

11 Press GO to start logging task switching. Press STOP after a while to stop the logging. Upload the result to the graph view by clicking the Upload icon. The following window should now appear: This graph represents the task activity during the interval from GO until STOP.