Manuals / Compaq / Computer Equipment / Network Card

Compaq AA-RNG2A-TE manual Setting the IPL and Obtaining the Simple Lock

Models: AA-RNG2A-TE

1 159

Download 159 pages 42.56 Kb

Page 127

7

8

9

10

11

12

Casts the data argument to a data structure of type ifdevea for use with the SIOCRPHYSADDR ioctl command.

Casts the data argument to a data structure of type ctrreq for use with the SIOCRDCTRS and SIOCRDZCTRS ioctl commands.

Casts the data argument to a data structure of type ifchar for use with the SIOCIFSETCHAR ioctl command.

Declares a lock_on variable and sets it to the value 1 (true), which indicates that the simple lock is held. The el_ioctl( ) routine sets this variable to the value 0 (false) when the simple lock is no longer in effect.

Declares a status variable and sets it to the constant ESUCCESS.

Declares an ifmtu variable that stores the requested MTU value for the SIOCIPMTU command.

Declares a speed variable that stores the requested network speed for the SIOCMACSPEED command.

Declares an mclist_buf buffer, which holds a character string. This string is a list of all multicast addresses currently in use on the device.

12.2Determining Whether the User Has Removed the PCMCIA Card from the Slot

The following code shows how the el_ioctl( ) routine determines whether the user has removed the PCMCIA card from the slot:

if (sc->cardout) return(EIO);

1

1

Examines the value of the cardout member of the el_softc data structure for this device. If it is set to 1 (true), the user has removed the PCMCIA card from the slot, and the driver returns the EIO error constant to indicate an I/O error.

12.3 Setting the IPL and Obtaining the Simple Lock

The following code shows how the el_ioctl( ) routine sets the IPL and obtains the simple lock:

s = splimp(); 1

simple_lock(&sc->el_softc_lock);

2

1

2

Calls the splimp( ) routine to mask all LAN hardware interrupts. On successful completion, splimp( ) stores an integer value in the s variable that represents the CPU priority level that existed before the call to splimp( ).

Calls the simple_lock( ) routine to assert a lock with exclusive access for the resource that is associated with el_softc_lock. This means that no other kernel thread can gain access to the locked resource until

Implementing the ioctl Section 12–3

Image 127

Compaq AA-RNG2A-TE manual Setting the IPL and Obtaining the Simple Lock

Contents

Compaq Computer Corporation Houston, Texas December Product VersionPage Contents Implementing the Autoconfiguration Support Section probe Implementing the Configure SectionImplementing the unattach Routine Implementing the Autoconfiguration Support Section attachImplementing the Start Section Implementing the Initialization SectionImplementing a Watchdog Section Implementing the Reset SectionImplementing the ioctl Section Implementing the Interrupt Section Network Device Driver Configuration IndexTables Page Audience About This ManualScope of this Manual Organization New and Changed FeaturesExamples Related DocumentationReference Pages Reader’s CommentsConventions That are used in driver configuration, these brackets Page Network Device Driver Environment Network Device Driver Include Files Section for a Network Driver Declarations Section for a Network Driver External and Forward Declarations Declaring softc and controller Data Structure Arrays Defining Driver-Specific Macros Declaring and Initializing the driver Data Structure8Network Device Driver Environment MacroDescription Driver-Specific MacrosStart Section for a Network Driver Configure Section for a Network DriverAutoconfiguration Support Section for a Network Driver Initialization Section for a Network DriverInterrupt Section for a Network Driver Reset Section for a Network DriverWatchdog Section for a Network Driver Ioctl Section for a Network Driver12Network Device Driver Environment Interrupt and Status Register Offset Definitions Defining Device Register OffsetsCommand Port Register Offset Definitions Defining Device Register Offsets Window 0 Configuration Register Offset Definitions W0CCR Register ConstantDefines the offset for the resource configuration register Window 3 Configuration Register Offset Definitions Window 3 Configuration Registers Window 1 Operational Registers Window 1 Operational Register Offset Definitions10Defining Device Register Offsets Mdncrc Window 4 Diagnostic Register Offset Definitions12Defining Device Register Offsets Eeprom Data Structure Definition Page Shows a typical softc data structure Defining the softc Data Structure2Defining the softc Data Structure Defining Common InformationDefining the softc Data Structure Defining Media State Information Enabling Support for Enhanced Hardware ManagementMedia state has been determined Defining CSR Pointer Information Defining the Base RegisterDefining Multicast Table Information Defining the Interrupt Handler IDDefining Bus-Specific Information Defining Fifo Maintenance InformationDefining the Broadcast Flag Defining Interrupt and Timeout StatisticsDefining the Debug Flag Defining the Polling Context Flag Defining Autosense Kernel Thread Context InformationDeclaring the Simple Lock Data Structure Defining a Copy of the w3eeprom Data StructureImplementing the Configure Section Etc/sysconfigtab database Following code shows how to set up the elconfigure routine Setting Up the elconfigure Routine4Implementing the Configure Section Implementing the elprobe Routine Implementing the Autoconfiguration Support Section probeFollowing code shows how to set up the elprobe routine Setting Up the elprobe RoutineImplementing the Autoconfiguration Support Section probe Performing Bus-Specific Tasks 4Implementing the Autoconfiguration Support Section probeImplementing the Autoconfiguration Support Section probe Allocating Memory for the softc Data Structure 6Implementing the Autoconfiguration Support Section probeAllocating the etherdriver Data Structure Computing the CSR Addresses Setting Bus-Specific Data Structure MembersImplementing the Autoconfiguration Support Section probe Handling First-Time Probe Operations 10Implementing the Autoconfiguration Support Section probeImplementing the Autoconfiguration Support Section probe Handling Subsequent Probe Operations 12Implementing the Autoconfiguration Support Section probeImplementing the Autoconfiguration Support Section probe Registering the Interrupt Handler Implementing the Autoconfiguration Support Section probe Trying to Allocate Another controller Data Structure Saving the controller and softc Data Structure PointersImplementing the elautosensethread Routine Implementing the elshutdown RoutineRegistering the shutdown Routine 18Implementing the Autoconfiguration Support Section probe Blocking Until Awakened Setting Up the elautosensethread RoutineStarting Up Statistics Testing for the Termination FlagEntering the Packet Transmit Loop Saving Counters Prior to the Transmit Operation Using the Default from the ROMAllocating Memory for a Test Packet Building the Test Packet Setting the Media in the HardwareTransmitting the Test Packet Testing for Loss of Carrier Setting a Timer for the Current Kernel ThreadDetermining Whether Packets Were Transmitted Successfully Setting Up New MediaPrinting Debug Information Establishing the Media 26Implementing the Autoconfiguration Support Section probe Setting Up the elattach Routine Implementing the Autoconfiguration Support Section attachInitializing the Media Address and Media Header Lengths Setting Up the Media 4Implementing the Autoconfiguration Support Section attach Initializing Simple Lock Information Specifying the Network Driver Interfaces Printing a Success MessageSignifies that the network interface supports Attaching to the Packet Filter and the Network Layer Setting the Baud RateHandling the Reinsert Operation Setting Network Attributes and Registering the AdapterStarting the Polling Process Enabling the Interrupt HandlerImplementing the unattach Routine Setting Up the elunattach RoutineObtaining the Simple Lock and Shutting Down the Device Verifying That the Interface Has Shut DownTerminating the Autosense Kernel Thread Disabling the Interrupt HandlerTerminating the Simple Lock Unregistering the Pcmcia Event Callback RoutineStopping the Polling Process Unregistering the Shutdown RoutineFreeing Resources Unregistering the Card from the Hardware Management DatabasePage Implementing the Initialization Section Setting Up the elinit RoutineImplementing the elinit Routine Determining Whether the Pcmcia Card Is Present Setting the IPL and Obtaining the Simple LockReturning the Status from the elinitlocked Routine Releasing the Simple Lock and Resetting the IPLImplementing the elinitlocked Routine Calling the elinitlocked RoutineClearing Interrupts Resetting the Transmitter and ReceiverEnsuring That the 10Base2 Transceiver Is Off Starting the DeviceSetting the LAN Media Resetting the Transmitter and Receiver Again Setting a LAN AttributeSelecting Memory Mapping Processing Special Flags Setting the LAN AddressEnabling TX and RX Setting the Debug FlagEnabling Interrupts Setting the Operational WindowMarking the Device as Running Starting the Transmit of Pending Packets Starting the Autosense Kernel ThreadPage Implementing the elstart Routine Implementing the Start SectionCalling the elstartlocked Routine Implementing the elstartlocked Routine 4Implementing the Start Section Implementing the Start Section Handlelongword Transmitting the BufferAccounting for Outgoing Bytes Indicating When to Start the Watchdog Routine Implementing a Watchdog Section Setting the IPL and Obtaining the Simple LockReleasing the Simple Lock and Resetting the IPL Implementing the elreset Routine Implementing the Reset SectionImplementing the elresetlocked Routine Implementing the ioctl Section Ioctl Command Required Description For More InformationFollowing code shows how to set up the elioctl routine Setting Up the elioctl RoutineSetting the IPL and Obtaining the Simple Lock Disabling Loopback Mode Siocdisablback ioctl Command Enabling Loopback Mode Siocenablback ioctl CommandSetting the Local MAC Address Siocsphysaddr ioctl Command 12-6Implementing the ioctl Section Implementing the ioctl Section Determines whether the cmd argument is Siocrdctrs or Network Interface Counter Types Bringing Up the Device Siocsifaddr ioctl CommandSetting the IP MTU Siocsipmtu ioctl Command Using Currently Set Flags Siocsifflags ioctl CommandSetting the Media Speed Siocsmacspeed ioctl Command Setting Device Characteristics Siocifsetchar ioctl Command Resetting the Device Siocifreset ioctl Command12-12Implementing the ioctl Section If lockon 1 simpleunlock&sc-elsoftclock splxs Return status Page Implementing the elintr Routine Implementing the Interrupt SectionRearming the Next Timeout Processing Completed Receive and Transmit Operations Reading the Interrupt StatusTransmitting Pending Frames Acknowledging the InterruptImplementing the elrint Routine Indicating That the Interrupt Was ServicedPulling the Packets from the Fifo Buffer Examining the First Part of the Packet 13-8Implementing the Interrupt Section Copying the Received Packet into the mbufDiscarding a Packet Counting the Transmit Interrupt Implementing the eltint RoutineWriting to the Status Register to Obtain the Next Value Managing Excessive Data CollisionsQueuing Other Transmits Implementing the elerror RoutineNetwork Device Driver Configuration Page Index-1 IndexIndex-2 Declarations section, 1-4devdriver.h header file, 1-4deviceIndex-3 InterruptIndex-4 Interrupt handlerIndex-5 PacketIndex-6 ROMIndex-7 Transmit