Academic Company Events NI Developer Zone Support Solutions Products & Services Contact NI MyNI
This Document is not yet Rated  Rate this Document

How Do I Add LabVIEW Real-Time Support For an Intel® i8254x Ethernet Chipset?

Primary Software: LabVIEW Modules>>Real-Time Module
Primary Software Version: 8.6
Primary Software Fixed Version: N/A
Secondary Software: N/A
Hardware: Instrument Connectivity Other>>Ethernet, Multifunction DAQ (MIO)>>Real-Time

Problem:
I have an Intel® 8254x Ethernet adapter with a chipset ID that is not listed as a Supported Ethernet Chipset in KnowledgeBase 39NDI8PK: Requirements for a Desktop PC as a Real-Time Target.  How do I add support for my adapter for use within LabVIEW Real-Time?

Solution:
This functionality is provided by the Ethernet whitelist, which was introduced in LabVIEW Real-Time 8.6. The Ethernet whitelist allows the real-time operating system to use unsupported1 Intel® i8254x Ethernet adapters.

You can enable the Ethernet whitelist by creating a properly formatted enetwhitelist.ini file in the real-time target's c:/ni-rt/system/Ethernet directory or in the root directory of the safe-mode USB stick2. A properly formatted example enetwhitelist.ini is shown below:

[GENERAL]
Drivers=i8254x.dll
VerboseLoading=TRUE

[i8254x.dll]
Adapters=82541PI, 82541GX
LoadPredefinedChipsets=TRUE

[82541PI]
ChipID=1077
EEPROM=Marvel
FAMILY=8254x
Description="My Intel® 8254x Ethernet Chipset"

[82541GX]
ChipID=107A
EEPROM=Legacy
FAMILY=8254x

In the above example, the whitelist feature is enabled for Intel® i82541PI and 82541GX chipsets. The configurable parameters are detailed below:

  • VerboseLoading
    Valid values: TRUE, FALSE
    Description: Controls whether debugging messages are printed to the real-time target's terminal

  • Adapters
    Valid values: 82541PI, 82541GX, etc...
    Description: Intel® chipset that will be enabled by the whitelist (any value within the 8254x family)

  • ChipID
    Valid values: 107A, 1077, etc...
    Description: Chipset ID of a specific 8254x chipset

  • EEPROM
    Valid values: Legacy, Marvel
    Description: Legacy is the default, but if the driver cannot control the network adapter, set this field to Marvel

  • Description
    Valid values: Anything
    Description: Allows you to organize the whitelist and is displayed if VerboseLoading is enabled

1 The whitelist feature exists to allow untested Intel® i8254x chipsets a chance to work with LabVIEW Real-Time. Our development team does not guarantee that your particular Intel® i8254x chipset will work with the whitelist enabled.

2 To enable the Ethernet whitelist on a safe-mode USB stick, the USB stick must be the only USB device on the real-time target at boot time.

Related Links:
KnowledgeBase 39NDI8PK: Requirements for a Desktop PC as a Real-Time Target

Attachments:





Report Date: 10/22/2008
Last Updated: 11/14/2008
Document ID: 4QLGBRYP

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
  1 2 3 4 5
Please Contact NI for all product and support inquiries.submit