Vivanco PCI GIGABIT ETHERNET CARD - PROGRAMMING User manual

ABN-182 PCI-X Gigabit Ethernet controllers User’s Guide Portwell Inc. 3F, No. 92, Sec. 1, Nei-Hu Rd., Taipei 114, Taiwan, R.O.C. Headquarter: +886-2-2799-2020 FAX: +886-2-2799-1010 http://www.portwell.com.tw Email: [email protected] About This Guide Purpose This manual provides information on ABN-182 PCI-X Gigabit Ethernet card, including software installation Manual Contents Chapter 1 Overview of ABN-182 Ethernet controllers. Chapter 2 ABN-182 Ethernet product detail. Chapter 3 ABN-182 Ethernet product programming setup detail. Chapter 4 Driver installation detail of ABN-182. ABN-182 User’s Guide 1 Introduction This user manual is used for ABN -182 standard universal PCI -X Ethernet controllers. The basic design of both Ethernet controller cards is identically. ABN-182 has Dual Ethernet ports and universal 64 -bit standard PCI-X To enhance Ethernet performance. It designed with Intel 82546GB Gigabit Ethernet Controllers to provide two Gigabit Ethernet port. The further detail of both products will be covered in the following chapters. Dual 64-bit Gigabit Ethernet ports base on Intel ® 82546GB controller. Supports 133MHz PCI-X bus and backwards compatible with 64/32 -bit Built-in Watchdog Timer (WDT) to switch Ethernet ports to bypass mode by system hang and power failure . Easy configuration of Normal / Bypass mode and WDT time-out per software programming Built with both on-board LED for LAN status and bypass mode. 1.1 Features Gigabit Ethernet card with 2 nd generation By-Pass function. Dual 64-bit Gigabit Ethernet ports base on Intel® 82546GB controller. 64bit 133MHz PCI-X interface. Built-in Watchdog Timer (WDT) function. Easy configuration for by-pass mode via software prog ramming. Built with both on-board LED for LAN status and bypass mode, ABN-182 User’s Guide 2 1.2 Bypass Block Diagram Universal PCI -X golden finger PCI -X U6, Intel 82546GB SDP OR Local CPU Normal Mode Bypass Mode LC Figure 1: ABN-182 Block Diagram ABN-182 User’s Guide 3 ABN-182 PCI-X Ethernet card 2.1 Product Specification Gigabit Ethernet card with 2 nd generation By-Pass function. Dual 64-bit Gigabit Ethernet ports base on Intel® 82546 GB controller. 64bit 133MHz PCI-X interface. Built-in Watchdog Timer (WDT) function. Easy configuration for by-pass mode via software programming. Built with both on-board LED for LAN status and bypass mode, ABN-182 User’s Guide 4 2.2 Installation Please check the included items in the box before installation. If there is any missing part, please contact the local deale r. Including items: 1. ABN-182 PCI-X Ethernet controller card 2. Driver CD 3. User’s Guide You can follow the step to install the Ethernet controller card to the system. Read this Manual Setup the configuration from software. Install the card on the avail able PCI-X slot. Prepare driver for the card, which can be found in the Driver CD or download update driver form Intel website. Connect the Ethernet cable to check the board function. CAUTION: Make sure the card is PROPERLY installed on a PCI -X slot; reverse or shifted installation can cause serious damage on the Ethernet controller or your system. ABN-182 User’s Guide 5 Programming Setup 3.1 Programming Support The bypass test program for ABN-182 supports Linux operating system: Fedora core/Red Hat 9.0. Test programs base on gcc version 4.1.0 20060304 (Fedora Core 5). And gcc version 3.2.2 20030222(red -hat 9) The following sections will cover Linux program installation and function on OS, for other supported, please contact Portwell . 3.2 Programming Configuration The following steps are manual setup for Linux 2.4.X/2.6.X kernel: Copy ABN-182 bypass program to Linux OS Select OS kernel version (kernel 2.4 or 2.6) and go into path. Go into ap path to make test program: [root ﹫host]# cd ap [root ﹫host ap]# ./complie.sh Run test program and go into main test screen. [root ﹫host ap]# ./test_all Portwell ABN182 Bypass program version:1.00 Author: Angus Yang function select: [1] set to normal mode [3] set bypass enable function [2] set to bypass mode [4] set Next boot enable function [5] watch dog timer setting [ESC] exit program Select function:1 1. [1]set to normal mode: set bypass mode disable. 2. [2]set to bypass mode: set bypass mode enable. 3. [3]set bypass enable function: set bypass mode when the system power off ABN-182 User’s Guide 6 bypass enable function function select: [1] set to bypass enable [2] set to bypass disable [ESC] return main window Select function:1 4. [4] set next boot enable function: set bypass mode disable /enable when system boot next time. Next boot enable fucntion function select: [1] set next boot enable [2] set next boot disable [ESC] return main window Select function:1 5. [5] watch dog timer setting: bypass function enabled and disable base on watch do g setting. ‧ Select [1] to clear watch dog timer old setting. Reset the system to normal mode. ‧ Select the watch dog timer you want to test: [4]~[e] ‧ Select [3] to start watch dog timer function. The bypass mode will enabled when time is up. watch dog timer setting function select: [1] clear watch dog timer and set it to normal mode [2] disable bypass&watch dog timer [3] refresh bypass&watch dog timer [4] set wdt cycle:264.528 ms [5] set wdt cycle:528.516 ms [6] set wdt cycle:1057.032 ms [7] set wdt cycle:2214.065 ms [8] set wdt cycle:4228.129 ms [9] set wdt cycle:8456.258 ms [a] set wdt cycle:16912.52 ms [b] set wdt cyc le:33825.03 ms [c] set wdt cycle:67550.06 ms [d] set wdt cycle:135300.1 ms [e] set wdt cycle:270600.3 ms [ESC] return main window Select function: *Note: all functions are for single card test, it does not support more cards test at the same time this moment. ABN-182 User’s Guide 7 3.3 Programming Guide Following is API description. 1 dev_found Function name dev_found Description To find the NIC device Format: int dev_found(unsigned char prod_num) //v1.04 Input: prod_num 1-1. PROD_ABN182: bypass card of abn182 Return: 0: device was found successfully -1:can not find device. 2. set_to_normal Function name set_to_normal Description Set Ethernet segment to normal mode Format: int set_to_normal (unsigned char seg, unsigned char proc_dev) //v1.04 Input: 1. seg:It assign which card in structure of card type to do set to normal function. 2. proc_dev: 2-1. PROD_ABN182: bypass card of abn182 Return: 0: return ok. -1:return fail. ABN-182 User’s Guide 8 3. set_to_nonormal Function name set_to_nonormal Description Set Ethernet segment to non -normal mode Format: int set_to_nonormal(unsigned char seg,unsigned char proc_dev) //v1.04 Input: 1. seg:It assign which card in structure of card type to do set_to_nonormal function. 2. proc_dev: 2-1. PROD_ABN182 :bypass card o f abn182 Return: 0: return ok. -1:return fail. ABN-182 User’s Guide 9 4. set_nextboot Function name set_nextboot Description 1. Set Ethernet segment to normal mode or non -normal mode when boot up next time Format: int set_nextboot (unsigned char mo de,unsigned char seg,unsigned char proc_dev)//v1.04 Input: 1. mode: 1-1. SET_NB_NORMAL: set Ethernet segment to normal mode 1-2. SET_NB_NO_NORMAL: set Ethernet segment to non-normal mode. 2. seg:It assign which card in structure of card type to do set_nextboot function. 3. proc_dev: 3-1. PROD_ABN182 :bypass card of abn182 Return: 0: return ok. -1:return fail. ABN-182 User’s Guide 10 5. set_bpe Function name set_bpe Description 1. Set Ethernet segment to open mode or bypass mode when power fails or watch dog t imer expires Format: int set_bpe (unsigned char mode,unsigned char seg,unsigned char proc_dev)//v1.04 Input: 1. mode: SET_BPE_OPEN: set Ethernet port to open mode. SET_BPE_BYPASS: set Ethernet port to bypass mode. 2. seg:It assign which card in structure o f card type to do set_bpe function. 3. proc_dev: 3-1. PROD_ABN182 :bypass card of abn182 Return: 0: return ok. -1:return fail. ABN-182 User’s Guide 11 6 set_period_wdt Function name set_period_wdt Description Set watch dog timer period Format: int set_period_wdt (unsigned char pd,unsigned char seg,unsigned char proc_dev)//v1.04 Input: 1. pd SET_WDT_PERIOD_264258 :set watch dog timer period as 264.258ms SET_WDT_PERIOD_528516 :set watch dog timer period as 528.516ms SET_WDT_PERIOD_1057032 :set watch dog timer period as 1057.032ms SET_WDT_PERIOD_2114065 :set watch dog timer period as 2114.065ms SET_WDT_PERIOD_4228129 :set watch dog timer period as 4228.129ms SET_WDT_PERIOD_8456258 :set watch dog timer period as 8456.258ms SET_WDT_PERIOD_1691252 :set watch dog timer period as 16912.52ms SET_WDT_PERIOD_3382503 :set watch dog timer period as 33825.03ms SET_WDT_PERIOD_6755006 :set watch dog timer period as 67550.06ms SET_WDT_PERIOD_1353001 :set watch dog timer period as 135300.1ms SET_WDT_PERIOD_2706003 :set watch dog timer period as 270600.3ms 2.seg:It assign which card in structure of card type to do set_period_wdt function. 3.proc_dev: 3-1. PROD_ABN182: bypass card of abn182 Return: 0: return ok. -1:return fail. ABN-182 User’s Guide 12 7. arm_wd Function name arm_wdt Description Test mode changing rate by watchdog timer, and its period is set by set_period_wdt function ( 6-6). Its mode will be changed to bypass-mode when watchdog timer time out. Format: int arm_wd (unsigned char seg,unsigned char proc_dev) //v1.04 Input: 1. seg:It assign which card in structure of card type to do arm _wdt function. 2. proc_dev: 2-1. PROD_ABN182 :bypass card of abn182 Return: 0: return ok. -1:return fail. ABN-182 User’s Guide 13 8. dis_arm_wdt_to_sts Function name Dis_arm_wdt_to_sts Description Clear the set of watchdog timer. Format: int dis_arm_wdt_to_sts(unsigned char seg,unsigned char proc_dev) //v1.04 Input: 1. seg:It assign which card in structure of card type to do arm _wdt function. 2. proc_dev: 2-1. PROD_ABN182 :bypass card of ab n182 Return: 0: return ok. -1:return fail. 9. dis_bp_wdt Function name dis_bp_wdt Description Disable watch dog timer and keep status as current state Format: 1. If Ethernet is on bypass mode, when user does this command, it will be disable watch dog and keep it in bypass mode. If normal mode, after doing this command, it will be kept in normal mode. int dis_bp_wdt(unsigned char seg,unsigned char proc_dev) //v1.04 Input: 1. seg:It assign which card in structure of card type to do arm _wdt function. 2. proc_dev: 2-1. PROD_ABN182 :bypass card of abn182 Return: 0: return ok. -1:return fail. ABN-182 User’s Guide 14 10 read_status_now Function name read_status_now Description Read bypass status Format: unsigned char read_status_now(unsigned char seg,unsi gned char proc_dev) //v1.04 Input: 1. seg:It assign which card in structure of card type to do read_status_now function. 2. proc_dev: 2-1. PROD_ABN182 :bypass card of abn182 Return: 0: normal mode 1: open mode 2: bypass mode 11 read_settint_wdt Function name read_setting_wdt Description Read watch dog timer setting Format: unsigned char read_setting_wdt(unsigned char seg,unsigned char proc_dev) //v1.04 Input: 1. seg:It assign which card in structure of card type to do read_setting_wdt function. 2. proc_dev: 2-1. PROD_ABN182 :bypass card of abn182 Return: Bit1=0: watch dog timer dis-armed. Bit1=1: watch dog timer armed. Bit0=0: watch dog timer did not expire Bit0=1: watch dog timer expire ABN-182 User’s Guide 15 12 read_mode_nb Function name read_mode_nb Description Read next boot status Format: unsigned char read_mode_nb(unsigned char seg,unsigned char proc_dev) //v1.04 Input: 1. seg:It assign which card in structure of card type to do read_mode_nb function. 2. proc_dev: 2-1. PROD_ABN182 :bypass card of abn182 Return: 0: next boot=normal mode. 1: next boot=non-normal mode & BPE=open mode. 2: next boot=non -normal mode & BPE=bypass mode. 13 read_mode_pfwdte Function name read_mode_pfwdte Description Read power fails & watch dog timer expire status Format: unsigned char read_mode_pfwdte (unsigned char seg,unsigned char proc_dev) //v1.04 Input: 1. seg:It assign which card in structure of card type to do read_mode_pfwdte function. 2. proc_dev: 2-1. PROD_ABN182 :bypas s card of abn182 Return: 1: pfwdte to open mode. 2: pfwdte to bypass mode. ABN-182 User’s Guide 16 Driver Installation 4.1 Driver Support The drivers for ABN-182 support the following OS Windows 2000, XP, NT, 98/98SE, ME, 95, Linux Kernel 2.2.x/2.4.x. The follow ing sections will cover driver installation on some OS, for other supported drivers, please contact Portwell or refer to Intel 4.2 Driver Setup for Windows 2000 The following steps are manual installation for Windows 2000 ‧ Boot Windows 2000 then insert Driver CD to CD-ROM. ‧ Double-click pro2kxp.exe in \Pro1000\Win\Win2KXP\, and then An Wizard window will pop up click Next>. ‧ Click NEXT> button, the Wizard summary window will appear. ‧ Click Finish button, then click CLOSE button. 4.3 Driver Setup for Windows NT The following steps are manual installation for Windows ‧ Boot Windows NT then insert Driver CD to CD -ROM. NT ‧ Double-click pront4.exe in \Pro1000\Win\Winnt4\ , and then An Wizard window will pop up click Next>. ‧ Click NEXT> button, the Wizard summary window w ill appear. ‧ Click Finish button, then click CLOSE button. ‧ Reboot the system. ABN-182 User’s Guide 17 4.4 Driver Installation for Linux Some of the kernel has the driver for ABN-182, and it will automatically add the new hardware when booting up. If the driver is not included in the kernel, please following the step to install. ‧ Get the driver from CD or download from Intel website. NOTE: For ABN-182, the driver is e1000-Driver_Version.tar.gz ‧ Make the file and install to the machine Example: Installation of e1000 -7.1.19.tar.gz on Fedora core 4. [root ﹫host~]# tar zxvpf e1000 -7.1.19.tar.gz [root ﹫host~]# cd e1000-7.1.19/src/ [root ﹫host src]# make install [root ﹫host src]# modprobe e1000 NOTE: Please consult with your vender or read the reference document about compiling driver for different version of kernel. ‧ Reboot the system if necessary. ABN-182 User’s Guide 18
* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project
Download PDF
advertisement