NetFusion LCD Demo App User Guide. V1.0 - January 2015

Transcription

1 NetFusion LCD Demo App User Guide 1

2 Table of Contents 1 INTRODUCTION AUTOMATIC LAUNCH LCD MENU STRUCTURE MAIN MENU ACI PORT VALUES TEMPERATURE SENSOR VOLTAGE RAIL SUPERVISOR OPTION JUMPER SWITCHES & ROTARY SWITCHES VOLTAGE ISOLATED/FREE RELAYS USER LED MORETHANIP 3-PORT & 5-PORT SWITCH PACKET TRACE MONITOR LINE-IN AUDIO (VIA SPI) AMPLITUDE MONITOR REAL-TIME CLOCK RS232 SERIAL PORT (/DEV/TTYS1) RS485 SERIAL PORT (COREUART) GENERAL PURPOSE EXPANSION I/O VALUES CONTACT DOCUMENT HISTORY

3 1 Introduction Every NetFusion variant and derivate is shipped with the uclinux software re-programmed to show an LCD Demo App. This is also the case with the software GZIP package that can be downloaded and installed onto your host PC environment. If you compiled and built the same code, uploaded to your NetFusion unit and rebooted you will find the Demo App running on boot-up as this is the same as what is factory programmed. The Demo App runs exclusively on the LCD screen which is ideal for all of the Development-Kit solutions as it has the LCD module fitted. The sole purpose of the utility is to allow the user/customer to be able to view and evaluate the hardware features and functionality without having to use shell terminals, Linux build systems and programmers. By having a demonstrable ability to explore the unit simplistically through the front-end LCD screen, the user can enjoy the product before having to explore deeper either using USB terminals or ultimately downloading all of the Linux packages and toolset to build the code. Using the LCD buttons just below the LCD screen, the menu system is user friendly and obviously intuitive. Moreover, the user has full confidence of the supporting software behind the hardware they see in front of them. The LCD Demo App operates perfectly no matter which variant of the NetFusion family is playing host. The LCD and the buttons just below it are the effective user interface for the whole application 3

4 2 Automatic Launch The LCD will automatically show the Demo app with the code that is shipped and also the state of the code with the downloadable software package from Nine Ways. In order to control the Demo Application launching that is defaulted to operate on boot, and then edit the /etc/rc configuration file on the host PC software development for NetFusion. Refer to the NetFusion uclinux User Guide PDF The contents are listed below: #!/bin/sh mount -t proc proc /proc # mount the /proc directory into the filesystem mount -t sysfs sysfs /sys # mount the /sysfs directory into the filesystem mount -t devpts none /dev/pts # mount the /pts directory into the filesystem mount -t jffs2 /dev/mtdblock2 /flash # mount the /flash directory into the filesystem - non-volatile area echo 1 >> /proc/sys/kernel/panic # set the Linux kernel panic time to 1 second. A panic will reboot ifconfig lo up # bring up the loopback netif /drivers/smartfusion2_init # launch all hardware relating to NetFusion /drivers/mtip_switchcore_init # launch MAC and Switch FIFOs insmod /lib/gengpio_uio.ko # launch general GPIO-UIO device driver insmod /lib/mtip_hwclock.ko # launch specific PTP-1588 MorethanIP hardware-clock device driver cat /lib/mtipsw_parms sed -e 's/#.*$//' -e '/^$/d' xargs insmod /lib/mtipsw_dma_sw.ko # launch DMA driver if [[ `lsmod grep mtipsw_dma_sw sed 's/mtipsw_dma_sw.*/found/g'` = "found" ]] ; then ifconfig mtip0 down hw ether $ethaddr # default bring down mtip0 high-priority netif and set mac address ifconfig mtip1 down hw ether $ethaddr # default bring down mtip1 lower-priority netif ifconfig mtip2 down hw ether $ethaddr # default bring down mtip2 netif used for PTP users ifconfig mtip3 down hw ether $ethaddr # mtip3 netif used exclusively and ONLY for the linuxptp application ifconfig mtip up # bring up the new DMA controller CH0 network interface [mtip0] ifconfig mtip up # bring up the new DMA controller CH1 network interface [mtip1] ifconfig mtip up # bring up the new DMA controller PTP user network interface [mtip2] ifconfig mtip up # bring up the new DMA controller linuxptp network interface [mtip3] else echo "DMA Controller not detected so leaving eth0 as the primary netdev..." fi busybox httpd -h /httpd/html/ /drivers/temp_sensor -file /httpd/html/ts.txt & /ptp/ptp4l -i mtip3 -q -p /dev/ptp0 -f /ptp/default.cfg > /dev/null & rm /flash/netf -f /sql/sqlite3 /flash/netf '.read /etc/create_test_db.txt' /sql/sqlite3 /flash/netf '.read /httpd/html/import_drivers.txt' > /httpd/html/drivers.txt /sql/sqlite3 /flash/netf '.read /httpd/html/import_process.txt' > /httpd/html/process.txt /factory/netf_demo_app #switch_demo #/iperf/iperf_testapp ifconfig # show on debug output the current network interfaces present If you wish to remove the LCD Demo App program when the board boots up then comment out the following line of code: #/factory/netf_demo_app Save then re-compile. Refer to the NetFusion uclinux User Guide PDF 4

5 3 LCD Menu Structure Upon first boot, you will be presented with the LCD menu system. 3.1 Main Menu This screen indicates the first option available on the menu. The whole top tree menu structure always displays the bottom row with the same button options. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. Note: the [ACI Port Values] option is the first option shown after boot-up. 3.2 ACI Port Values The [ACI Port Values] option menu screen allows the user to ENTER the ACI monitor. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. 5

6 In order to EXIT this screen back to the main menu hierarchy, press the RIGHT EXT button. Use the LEFT and MIDDLE buttons (indicated by the arrows) to scroll through P1 to P8 ACI inputs. After the colon, it displays OPEN, CLOSED or the 8-bit ADC value of the analogue input. 6

7 3.3 Temperature Sensor The [Temp Sensor] option menu screen allows the user to ENTER the temperature sensor monitor. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. If the ERROR screen is shown (above), then you have observed the temperature reading before an actual sample was taken after boot-up. The first sample is normally about 60 seconds after boot-up. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT button. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT EXT button. The temperature is updated every 60 seconds from average readings. The sensor is under the SOM which indicates the FPGA board temperature. 7

8 3.4 Voltage Rail Supervisor The [Volt Supervisor] option menu screen allows the user to ENTER the screen to view all of the baseboard and SOM voltage rails. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT EXT button. Use the LEFT and MIDDLE buttons (indicated by the arrows) to scroll through the different voltage rails. Before the colon, it displays the name of the intended voltage supply, and after the colon is the exact current reading of that respective voltage on the baseboard. 8

9 3.5 Option Jumper Switches & Rotary Switches The [Opts Jps & Sels] option menu screen allows the user to ENTER the general configuration dials screen. The jumper switches and the rotary dials can be viewed and displayed. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT EXT button. 9

10 Use the LEFT and MIDDLE buttons (indicated by the arrows) to scroll through the different input components on the baseboard. It scrolls through and displays ROT S2, ROT S3, Jump Swt 1, Jump Swt 2, Jump Swt 3, Jump Swt 4, Jump Swt 5, Jump Swt 6. ROT S2 shows the number setting of the left rotary selector CONFIG 1 on the baseboard, the right rotary CONFIG 2 is next, then the 6 configuration DIP selector switches 1 6. All values are real-time and live the moment that PCB values are changed. 10

11 3.6 Voltage Isolated/Free Relays The [Volt Iso Relays] option menu screen allows the user to ENTER the voltage free output relay control screen. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT EXT button. Use the LEFT and MIDDLE buttons (indicated by the arrows) to toggle the condition each of the two voltage free output relays on the PCB baseboard. The LEFT button toggles RL1 between ON and OFF. The MIDDLE button toggles RL2 between ON and OFF. The instantaneous change on the display is reflected with the change of state of the mechanical relays and you will be able to audibly hear the clicking sound. Use the RELAY POLARITY SWITCHES to convert ON/OFF into OPEN/CLOSED If you cannot hear the relays change, then check the relay enable switches. Move to the RL1 and RL2 positions. 11

12 3.7 User LED 1 The [User LED 1] option menu screen allows the user to ENTER the control screen of the GREEN user led on the PCB baseboard. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT EXT button. Use the LEFT and MIDDLE buttons (indicated by the arrows) to toggle the condition each of the two voltage free output relays on the PCB baseboard. The LEFT button toggles RL1 between ON and OFF. The MIDDLE button toggles RL2 between ON and OFF. 12

13 3.8 MorethanIP 3-Port & 5-Port SWITCH Packet Trace Monitor The [5P/3P Data Test] option menu screen allows the user to ENTER the embedded MorethanIP SWITCH test app. It can detect the 3-Port and 5-Port IP cores. If no SWITCH is detected, you will be presented with an ERROR screen showing that no SWITCH was found in the FPGA fabric. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. The SWITCH test application as a sub-menu detects either the 3-Port or the 5-Port MorethanIP Ethernet core in the FPGA fabric. It is indicated in the bottom left by either 3P or 5P. If no core exists, usually if the NetFusion variant is an EXP, or if the user has a standard Starter pack project without a SWITCH, then a message will display indicating that no switch exists. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT EXT button. Whilst the screen is being displayed, the number of overall SWITCHed packets is updated and incremented on the top left of the LCD screen and individual port activity is highlighted by an asterisk above the numbers 1 2 or 3 (bottom right). 13

14 3.9 Line-IN Audio (via SPI) Amplitude Monitor The [SPI Audio Test] option menu screen allows the user to ENTER the Line-IN audio amplitude analyzer. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT button. Amplitude bars will appear from the bottom row center outwards. As there are two channels of stereo audio (left and right) the bars spread out from the center each way left and right independently. 14

15 3.10 Real-Time Clock The [RTC Settings] option menu screen allows the user to ENTER the Real-Time clock set and read screen. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT EXT button. Press the LEFT button W to write/set the RTC date/time and press the MIDDLE R to read the clock and display on the LCD real-time. If the read facility is used, the date and time will be displayed continuously until the RIGHT button is pressed and the system will revert back to this screen (shown above). However, if (on the above screen), you press the LEFT button, then you get the following screen. This screen allows the user to set the time and date fields. Follow the on screen instructions. Each entry is un-abortable so once you are in process you must complete. For each field entry, you must press the RIGHT ENT button to accept the entry. Once completed, you will revert back to the W R Date/Time screen (top of this page). In order to EXIT that screen back to the main menu hierarchy, press the RIGHT EXT button. 15

16 3.11 RS232 Serial Port (/dev/ttys1) The [RS232 Data Test] option menu screen allows the user to ENTER the observation screen for seeing all characters received from the second serial port [/dev/ttys1]. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT button. Received characters at N1 BAUD from the RX of the second serial port /dev/ttys1 will be shown and scrolled across the bottom row of the LCD screen. 16

17 3.12 RS485 Serial Port (coreuart) The [RS485 Data Test] option menu screen allows the user to ENTER the observation screen for seeing all characters received from the IP coreuart RS485. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT button. Received characters at N1 BAUD from the RX of the coreuart RS485 will be shown and scrolled across the bottom row of the LCD screen. 17

18 3.13 General Purpose Expansion I/O Values The [GPIOs 8-14 Conf] option menu screen allows the user to ENTER the screen to check on the logical input status of the unused I/Os on the GPIO expander header. It configures all signals for input and observes them. The LEFT button scrolls backwards through the menu hierarchy, the MIDDLE scrolls forwards through the options and the RIGHT button ENT allows you to enter this particular menu category. In order to EXIT this screen back to the main menu hierarchy, press the RIGHT button. Use the LEFT and MIDDLE buttons to scroll through forwards and backwards between PT8 and PT14. These are the GPIO input pins on the expansion header on the PCB baseboard. For each input, you will see on the top right of the screen ie ASSERTED or DE-ASSERTED. Leaving the inputs floating keeps them ASSERTED and if you pull them to GND (0V), they will change state. 18

19 4 Contact Nine Ways Research & Development Ltd pbates@nineways.co.uk Internet : UK Unit A.3, idcentre, Lathkill House, rtc Business Park London Road, Derby. DE24 8UP United Kingdom Tel : +44 (0) FAX : +44 (0)

20 5 Document History Document Change Notices (DCO) Version Description Created/Changed By Date Version 1.0 Initial Release according to Version 1.0 Paul Bates: Nine Ways 30th January 2015 Copyright Nine Ways R&D Ltd All Rights Reserved 20