User Manual for the Gigabit Ethernet Adapter
Contents
1. 2 Applicable and Reference Documents 2 1 Applicable Documents 2 1 1 CCII GE 6 MAN 001 Hardware Reference Manual for the C2I Systems Gigabit Ethernet Adapter 2 2 Reference Documents None CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 2 of 11 3 Software Driver Distribution The software driver distribution consists of at least the following files ccGeEnd lt arch gt lt vxworks_version gt a Host architecture specific driver object file cc CCII Systems Pty Ltd GeEnd Enhanced Network Device END VxWorks software driver arch Host for which the binary is built e X86 e 18x Dy4 181 182 183 e Mv5100 Motorola MVME 5100 vxworks version VxWorks version e 62 VxWorks 6 2 e blank VxWorks 5 5 1 e g ccGeEnd18x 62 a for Gigabit Ethernet software driver built for a DY4 SVME DMV 181 PowerPC host for VxWorks 6 2 Readme txt General information and installation notes Release txt Release notes and revision history Please check this file for information on the latest updates sysCcGeEnd c PCI initialisation for X86 BSPs See Appendix A CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 3 of 11 4 1 4 1 1 4 2 4 3 Installation Procedure This paragraph describes the installation procedure for the GE VxWorks software driver The examples given are for a DY4 SVME DMV181 PowerPC host Large UDP packet support In order2. CT Systems CCII Systems Pty Ltd Registration No 1990 005058 07 Communications Computer Intelligence Integration g User Manual for the C Systems Gigabit Ethernet VxWorks Software Driver C Systems Document No CCII GE 6 MAN 002 Document Issue Issue Date 2007 10 18 Print Date 2007 10 18 File Name W GE TECH MAN CGEMANO2 WPD Distribution List No C4 Systems The copyright of this document is the property of C2l Systems The document is issued for the sole purpose for which it is supplied on the express terms that it may not be copied in whole or part used by or disclosed to others except as authorised in writing by C I Systems Document prepared by and for C I Systems Cape Town Signature Sheet Completed by Project Engineer C l Systems Accepted by Lo accom C Systems Accepted by MEN Y CA GAE Quality EE E WAGE TECH MAN CGEMANO2 WPD Amendment History Description Date ECP No oA First daft 2007 0228 0 2 Added command line parameter descriptions 2007 06 07 ooo et Procedure added describing the addition of larger Network 2007 10 18 CCII GE 6 ECP 008 Stack Memory Pool data clusters o CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Contents T CODE Ar 1 1 1 IdentifiCatlon 2 usa ae Dare m 1 1 2 EU CIBO Th MR cx 1 1 3 Document Overview lllsllseeeeseelle ehh she 1 2 Applicable a
3. This simplifies the configuration of both ports of an adapter card The different values of this variable reflect the most meaningful combinations of port parameters The following table shows the values of ConType and the corresponding combinations of the per port parameters ConType DupCap AutoNeg FlowCtrl Role Speed Auto Both On SymOrRem Auto Auto 1000FD Full Off None Auto ignored 1000 100FD Full Off None Auto ignored 100 100HD Half Off None Auto ignored 100 10FD Full Off None Auto ignored 10 10HD Half Off None Auto ignored 10 Stating any other port parameter together with this ConType variable will result in a merged configuration of those settings This due to the fact that the per port parameters e g Speed have a higher priority than the combined variable ConType NOTE This parameter is always used on both ports of the adapter card PrefPort This is used to force the preferred port to A or B on dual port A network adapters The preferred port is the one that is used if both are detected as fully functional RilmtMode RLMT monitors the status of the port If the link of the active port CheckLinkState DualNet fails RLMT switches immediately to the standby link The virtual CheckLocalPort link is maintained as long as at least one physical link is up CheckSeg DualNet CheckLinkState Check link state only RLMT uses the link state reported by the adapter hardware for each individual port to determine whethe
4. all lines marked OVS OVS undef NUM CL BLKS OVS define NUM CL BLKS NUM 64 NUM 128 NUM 256 NUM 512 NUM 1024 NUM 2048 NUM 4096 NUM 8192 NUM 16384 NUM 32768 NUM 655360 OVS undef NUM 64 OVS define NUM 64 100 OVS undef NUM 128 OVS define NUM 128 100 OVS undef NUM 256 OVS define NUM 256 40 OVS undef NUM 512 OVS define NUM 512 40 OVS undef NUM 1024 OVS define NUM_1024 25 OVS undef NUM 2048 OVS define NUM 2048 25 OVS define NUM 4096 10 OVS define NUM 8192 10 OVS define NUM 16384 10 OVS define NUM 32768 10 OVS define NUM 65536 10 OVS undef NUM_NET_MBLKS OVS define NUM NET MBLKS 2 NUM_CL_BLKS CL_DESC clDescTbl clusterSize num memArea memSize 64 NUM 64 NULL 0 128 NUM 128 NULL 0 256 NUM 256 NULL 0 512 NUM 512 NULL 0 1024 NUM 1024 NULL 0 2048 NUM 2048 NULL 0 OVS 4096 NUM_4096 NULL 0 OVS X 8192 NUM 8192 NULL 0 OVS 16384 NUM 16384 NULL 03 OVS 32768 NUM 32768 NULL 0 OVS 65536 NUM 65536 NULL 0 Es CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 11 of 1
5. any transmit packet as fast as possible NOTE 1 The system load increases if LowLatency is set to On and a lot of data packets are transmitted and received NOTE 2 This parameter is only used on adapters which are based on PCI Express compatible chipsets BroadcastPrio This parameter specifies whether received broadcast packets On Off have the highest priority for the port switch decision Off or not Off On RimtMinToVal Minimum timeout value for RLMT in us 30 000 CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 7 of 11 Parameter Description Permitted Default Value Values RimtDefToVal Minimum timeout value for RLMT in us RimtPortdownTimVal RLMT Port Down Timer in us E j 90 000 RImtPortstartTimVal RLMT Port Start Timer in us i 50 000 RimtPortupTimVal RLMT Port Up Timer in us 4 2 500 000 RimtSegToVal RLMT Network Segmentation Reporting Interval in us b cd 900 000 000 Note that if DualNet mode is used the parameters for both ports must be provided in the first call to muxDevLoad Parameters provided in the second call will be ignored CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 8 of 11 6 Contact Details 6 1 Contact Person Direct all correspondence and or support queries to the Project Manager HSS8 at C I Systems 6 2 Physical Address C212 Systems Pty Ltd Unit 3 Rosmead Place Rosmead Centr
6. as a single dual redundant channel RLMT mode In DualNet mode each channel is assigned is own IP address In RLMT mode the secondary port becomes a hot standby in the event of failure of the primary port Only one IP address is assigned as the hardware will determine over which physical channel the data is routed 5 2 Loading and Starting the Driver in DualNet Mode To start the driver in DualNet mode muxDevStart muxDevLoad 0 geLoad 0 0 muxDevStart muxDevLoad 1 geLoad 0 0 This will create two devices ccgeO and ccge1 5 3 Loading and Starting the Driver in RLMT Mode To start the driver in RLMT mode muxDevStart muxDevLoad 0 geLoad RlmtMode CheckLinkState 0 0 5 4 Command Line Parameters The general form of the GE driver load command is as follows muxDevLoad device geLoad parameter 1 parameter 2 parameter 3 0 0 where device is a unique instance number starting from 0 and parameter n is as described in the following table Parameter Description Permitted Default Value Values Speed_A This parameter is used to set the speed capabilities It is only Auto Speed_B valid for copper adapters Usually the speed is negotiated between the two ports during link establishment If this fails a port can be forced to a specific setting with this parameter AutoNeg_A The Sense mode automatically detects whether the link partner AutoNeg_B supports auto negotiation or not DupCap_
7. to transmit large UDP packets typically larger than 1992 bytes the VxWorks Network Stack Memory Pool Configuration has to be changed to add larger data clusters The procedure for doing this differs between VxWorks 5 5 and VxWorks 6 x Procedure for VxWorks 5 5 if building target images using Tornado This configuration change can t be performed from the Tornado Project GUI itself The file tornado target config comps src net usrNetLib c needs to be changed as shown in Appendix B The example in Appendix B adds 10 clusters each of 4096 8192 16384 32768 and 65536 bytes to the Network Stack Memory Pool This translates to an additional 1 21MB of system memory being allocated to the Network Stack Memory Pool Depending on the availability of free memory resources the number of clusters added can be adjusted A new VxWorks target image has to be built for these changes to take effect Procedure for VxWorks 5 5 if building target images using the command line If you are using the command line to build your VxWorks target images the relevant file to edit will be tornado target src config usrNetwork c not usrNetLib c The basic procedure and changes though are roughly the same as those indicated in Appendix B A new VxWorks target image has to be built for these changes to take effect Procedure for VxWorks 6 x if building target images using the Workbench IDE The Network Stack Memory Configuration can be reconfigured in the Work
8. 1
9. A This parameters is only relevant if auto negotiation for this port is DupCap_B not set to Sense If auto negotiation is set to On all three values are possible If it is set to Off only Full and Half are allowed This parameter is useful if your link partner does not support all possible combinations FlowCtrl_A This parameter can be used to set the flow control capabilities Sym SymOrRem FlowCtrl_B the port reports during auto negotiation It can be set for each SymOrRem port individually LocSend None Sym Symmetric both link partners are allowed to send PAUSE frames SymOrRem SymmetricOrRemote both or only remote partner are allowed to send PAUSE frames LocSend LocalSend only local link partner is allowed to send PAUSE frames None no link partner is allowed to send PAUSE frames CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 5 of 11 Parameter Description Permitted Default Value Values Role A This parameter is only valid for the copper adapters For two Auto Role B 1000Base T ports to communicate one must take the role of the master providing timing information while the other must be the slave Usually this is negotiated between the two ports during link establishment If this fails a port can be forced to a specific setting with this parameter ConType The parameter ConType is a combination of all five per port Auto parameters within one single parameter
10. bench IDE for your VxWorks 6 x target images Under the Project Navigator tab double click on Kernel Configuration for the current VXWorks image project In the Component configuration window expand and select the Network Components gt Network Core Components Network Stack Memory Pool Configuration branch and change the relevant Property Values to include additional larger than 2048 bytes clusters A new VxWorks target image has to be built for these changes to take effect To Build the GE Software Driver into the VxWorks Kernel Assume the BSP directory is given as BSP_DIR tornado target config dy4181 e Copy ccGeEnd18x a to your BSP DIR lib directory as ccGeEnd a e Inthe Builds section of the Project Workspace change the Kernel properties to include the ccGeEnd a library file in the Macros LIBs option e Rebuild all VxWorks images To Load the Software Driver Separately Note This step is not required if the software driver was built into the BSP If the software driver is not built into the BSP a user can load it separately e Copy ccGeEnd18x a to your present working directory as ccGeEnd a e From the VxWorks shell type e Id lt ccGeEnd a CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 4 of 11 5 Using the GE Software Driver 5 1 DualNet and RLMT Modes The two ports of the GE dual port adapter may be used either to provide two independent communication channels DualNet mode or
11. cal Address is utes oto poit edi er te deoa N tica Ri bonita nadia doe 10 6 3 Postal Address 3 2 aaa 10 6 4 Voice and Electronic Contacts lllliseeslseeseee rens 10 6 5 Product SUpport ETE Em 10 Di np d e 11 Making Changes to sysNet c for X86 1 2 2 0 cee hrs 11 Appendix B iuir MO COE aa h a mda Ae aa A daadaa de a a aldan aira a aa aa aai aa Oa aU aia adau aa oa a aa aN ii 12 Making changes to usrNetLib c for large UDP packets 0 II 12 CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Abbreviations and Acronyms API Application Program Interface BIT Built In Test bps bits per second BSP Board Support Package CD Carrier Detect CRC Cyclic Redundancy Check EEPROM Electrically Erasable Programable Read Only Memory FIFO First In First Out GE Gigabit Ethernet y o Input Output k Kilo LED Light Emitting Diode M Mega MHz Megahertz PC Personal Computer PCI Peripheral Component Interconnect PMC PCI Mezzanine Card POST Power On Self Test RAM Random Access Memory SBC Single Board Computer CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD CCII GE 6 MAN 002 2007 10 18 Scope Identification This document is the user manual for the VxWorks software driver for the C I Systems Dual Link Gigabit Ethernet Adapter hereinafter named the GE Adapter System Overview The C2l Systems Dual Gigabit Etherne
12. e 67 Rosmead Avenue Kenilworth Cape Town 7708 South Africa 6 3 Postal Address C212 Systems Pty Ltd P O Box 171 Rondebosch Cape Town 7701 South Africa 6 4 Voice and Electronic Contacts Tel 27 0 21 683 5490 Fax 27 0 21 683 5435 Email info ccii ccii co za Email support ccii co za URL http www ccii co za 6 5 Product Support Support on C l Systems products is available telephonically between Monday and Friday from 09 00 to 17 00 CAT Central African Time CAT GMT 2 Email support is available at support 2ccii co za CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 9 of 11 Appendix A Making Changes to sysNet c for X86 On X86 platforms the following amendment must be made to the BSP Copy the file sysCcGeEnd c to your BSP configuration directory target config BSPName Make the following two amendments to the file sysNet c in the same directory Amendment 1 ifdef INCLUDE END include sysDec21x40End c dec21x40End support routines include sysEl3c90xEnd c el3c90xEnd support routines include sysE1t3c509End c elt3c509End support routines include sysFei82557End c fei82557End support routines include sysGei82543End c gei82543End support routines include sysLn97xEnd c ln97xEnd support routines E include sysNe2000End c ne2000End support routines f
13. include sysUltraEnd c ultraEnd support routines Ay include sysCcGeEnd c CCII GE END driver support routines endif INCLUDE END Amendment 2 LOCAL VEND ID DESC vendorIdEnet if defined INCLUDE DEC21X40 END DEC PCI VENDOR ID sysDec21x40PciInit endif INCLUDE DEC21X40 END if defined INCL AMD PCI VENDOR endif INCLUD DE LN 97X END sysLan97xPcilInit NN 97X END E H Ci lw if defined INCLUDE EL 3C90X END U NDOR ID sys THREECOM PCI VE El3c90xPcilnit endif INCLUDE EL 3C90X END GEI8254X END defined INCLUDE GEI HEND if defined INCLUDE INTEL PCI VENDOR ID Sys543PciInit endif INCLUDE GEI8254X END if defined INCLUDE FEI END INTEL PCI VENDOR ID sys557PcilInit endif INCLUDE FE END He 0x1148 sysCcGePciInit Oxffffffff NULL last entry Now remake your VxWorks image CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 10 of 11 Appendix B Making changes to usrNetLib c for large UDP packets OVS Added these lines to add larger Network Data Pool clusters to the VxWorks image OVS To restore file to original config simply delete
14. nd Reference Documents 00000 ee 2 2 1 Applicable Documents ae a a a Oa eee hn 2 2 2 Reference Documents 0 00 cece ehh hr 2 3 Software Driver Distribution cos terunt ec bx on V ER E MERE Vx 3 4 Installation Procedure iennkesrhteRORRSRERORORASEORERORERDLERDEE EORR DELE EE 4 4 1 Large UDP packet SUPHO s e an en Ea A KER AEA k ER hh hh hh hh 4 4 1 1 Procedure for VxWorks 5 5 if building target images using Tornado cee eee eee 4 4 1 2 Procedure for VxWorks 5 5 if building target images using the command line 45 4 4 1 3 Procedure for VxWorks 6 x if building target images using the Workbench IDE 4 4 2 To Build the GE Software Driver into the VxWorks Kernel 00000 cece eee eese 5 4 3 To Load the Software Driver Separately 0 0 c cect teens 5 5 Using the GE Software Driver 0 000 eee 6 5 1 DualNet and RLMT Modes 0 cece ee hh hh mh 6 5 2 Loading and Starting the Driver in DualNet Mode 0 000 cece tenes 6 5 3 Loading and Starting the Driver in RLMT Mode 0 000 cece ett eee 6 5 4 Command Line Parameters 0 e a ea aee iaa a Da Ta oa e A aar Eta Da A aa Ea a e aia eens 6 6 Contact Details s s eret ver bor 6542 ESTEE Epi AOR Ahh br tici dpa he p ings 10 6 1 Contact Persom sender ets aenea Rane ean Asai hated aaah ath dus diss E a E ect AEEA 10 6 2 Physi
15. ng this IRE per parameter if no moderation is applied will lead to no action second performed This parameter determines the length of any interrupt moderation interval Assuming that static interrupt moderation is to be used an IntsPerSec parameter value of 2000 will lead to an interrupt moderation interval of 500 microseconds NOTE The duration of the moderation interval is to be chosen with care At first glance selecting a very long duration e g only 100 interrupts per second seems to be meaningful but the increase of packet processing delay is tremendous On the other hand selecting a very short moderation time might compensate the use of any moderation being applied Moderation Interrupt moderation is employed to limit the maximum number of None Dynamic interrupts the driver has to serve That is one or more interrupts Static which indicate any transmit or receive packet to be processed Dynamic are queued until the driver processes them When queued interrupts are to be served is determined by the IntsPerSec parameter which is explained later below None No interrupt moderation is applied on the adapter card Therefore each transmit or receive interrupt is served immediately as soon as it appears on the interrupt line of the adapter card Static Interrupt moderation is applied on the adapter card All transmit and receive interrupts are queued until a complete moderation interval ends If such a moderation in
16. r a port can be used for all network traffic or not CheckLocalPort In this mode RLMT monitors the network path between the two ports of an adapter by regularly exchanging packets between them This mode requires a network configuration in which the two ports are able to see each other i e there must not be any router between the ports CheckSeg Check local port and segmentation This mode supports the same functions as the CheckLocalPort mode and additionally checks network segmentation between the ports Therefore this mode is only to be used if Gigabit Ethernet switches are installed on the network that have been configured to use the Spanning Tree protocol DualNet In this mode ports A and B are used as separate devices If you have a dual port adapter port A will be configured as ethO and port B as eth1 Both ports can be used independently with distinct IP addresses The preferred port Setting is not used RLMT is turned off NOTE RLMT modes CLP and CLPSS are designed to operate in configurations where a network path between the ports on one adapter exists Moreover they are not designed to work where adapters are connected back to back CCII GE 6 MAN 002 2007 10 18 Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 6 of 11 Parameter Description Permitted Default Value Values IntsPerSec This parameter is only used if either static or dynamic interrupt 40 000 moderation is used on a network adapter card Usi
17. t GE adapters attach computers to 10 Mbps 100 Mbps and 1 Gbps Ethernet networks using Copper or Fibre cabling The GE Adapter is currently available in an Air Cooled PMC Conduction Cooled PMC and PCI 104 form factors Applicable Part Numbers are FP PMC CCII GNET PMC 2P RJ FP COM CCII GNET PMC 2P RJ FP IND CCII GNET PMC 2P SX FP COM CCII GNET PMC 2P SX FP IND CCII GNET PMC 2P LX FP COM CCII GNET PMC 2P LX FP IND Conduction Cooled PMC CCII GNET PMC 2P BP CC PCI 104 CCII GNET PC104 2P RJ COM CCII GNET PC104 2P RJ IND CCII GNET PC104 2P SX COM CCII GNET PC104 2P SX IND CCII GNET PC104 2P LX COM CCII GNET PC104 2P LX IND UTP Commercial Grade Adapter UTP Industrial Grade Adapter Multimode Fibre Commercial Grade Adapter Multimode Fibre Industrial Grade Adapter Single Mode Fibre Commercial Grade Adapter Single Mode Fibre Industrial Grade Adapter UTP Backplane I O Conduction Cooled Adapter UTP Commercial Grade Adapter UTP Industrial Grade Adapter Multimode Fibre Commercial Grade Adapter Multimode Fibre Industrial Grade Adapter Single Mode Fibre Commercial Grade Adapter Single Mode Fibre Industrial Grade Adapter The software driver binaries are provided with explicit installation instructions Document Overview This document gives an overview of the Gigabit Ethernet VxWorks software driver installation procedure and its Application Program Interface API Issue 1 0 W GE TECH MAN CGEMANO2 WPD Page 1 of 11
18. terval ends all queued interrupts are processed in one big bunch without any delay The term static reflects the fact that interrupt moderation is always enabled regardless how much network load is currently passing via a particular interface In addition the duration of the moderation interval has a fixed length that never changes while the driver is operational Dynamic Interrupt moderation might be applied on the adapter card depending on the load of the system If the driver detects that the system load is too high the driver tries to shield the system against too much network load by enabling interrupt moderation If at a later time the CPU utilizaton decreases again or if the network load is negligible the interrupt moderation will automatically be disabled Interrupt moderation should be used when the driver has to handle one or more interfaces with a high network load which as a consequence leads also to a high CPU utilization When moderation is applied in such high network load situations CPU load might be reduced by 20 30 NOTE The drawback of using interrupt moderation is an increase of the round trip time RTT due to the queueing and serving of interrupts at dedicated moderation times LowLatency This is used to reduce the packet latency time of the adapter On Off Setting the LowLatency parameter to On forces the adapter to Off pass any received packet immediately to upper network layers and to send out
Download Pdf Manuals
Related Search