VIRTUTECH CONFIDENTIAL    Previous - Up - Next

DEC21041

Provided by
DEC21041
Class Hierarchy
conf-object → log-object → DEC21041
Interfaces Implemented
log_object, event_poster, ethernet_device, io_memory, pci_device
Description
The DEC21041 is a fast Ethernet LAN controller providing a direct interface to the PCI bus. The DEC21041 interfaces to the host processor by unsing onchip control and status registers (CSRs) and a shared host memory area, set up mainly during initialization.

Attributes

Attributes inherited from class conf-object
attributes, classname, component, iface, name, object_id, queue
Attributes inherited from class log-object
access_count, log_buffer, log_buffer_last, log_buffer_size, log_group_mask, log_groups, log_level, log_type_mask
Attribute List
add_crc_on_inject
Optional attribute; read/write access; type: Integer.

Frames injected using the 'inject_packet' will get a correctly calculated CRC added at the end when this attribute is set to 1 (default). When set to 0, the user has to supply a CRC field with the injected frame. Note that you must always provide room for the CRC field, even when this attribute is set to 1.

anar
Optional attribute; read/write access; type: unknown type.

Internal Register

aner
Optional attribute; read/write access; type: unknown type.

Internal Register

anlpar
Optional attribute; read/write access; type: unknown type.

Internal Register

bmcr
Optional attribute; read/write access; type: unknown type.

Internal Register

bmsr
Optional attribute; read/write access; type: unknown type.

Internal Register

config_register_info
Pseudo attribute; read-only access; type: [[isii]*].

Register info for all registered configuration registers. The format for each entry is (offset, name, size, write-mask).

config_registers
Optional attribute; read/write access; type: [i{64}]; integer indexed; indexed type: Integer.

The 64 PCI configuration registers, each 32 bits in size.

cs_conf
Optional attribute; read/write access; type: unknown type.

Internal Register

csrs
Optional attribute; read/write access; type: unknown type.

Control and status registers.

current_packet
Pseudo attribute; read/write access; type: d|n.

(Obsolete - see the "last-frame" attribute instead). The packet that is currently about to be sent or received. The format is a raw Ethernet frame. This attribute is only valid in Ethernet_Transmit and Ethernet_Receive hap callbacks. It is possible to override the packet by assigning this attribute. The device will drop the current packet if the attribute is set to Nil, or with data of zero length.

current_rx_descriptor
Optional attribute; read/write access; type: unknown type.

Receive address.

current_tx_descriptor
Optional attribute; read/write access; type: unknown type.

Transmit address.

ether
Pseudo attribute; write-only access; type: unknown type.

Ethernet (MAC) address.

expansion_rom
Optional attribute; read/write access; type: [oii].

ROM object, map size, and map function number for the Expansion ROM.

inject_packet
Pseudo attribute; write-only access; type: Data.

Attribute used to send a packet to the network device. Writing this attribute at any time injects a new packet into the device (without involving the network simulation). Injecting a packet copies the packet data, allowing the caller to reuse or dispose of the buffer used for creating the packet, after the attribute is written.

interrupt_pin
Optional attribute; read/write access; type: [iiii].

State of the interrupt pin.

last_frame
Pseudo attribute; read/write access; type: d|n.

The frame that is currently about to be sent or received. The format is a raw Ethernet frame. This attribute is only valid in Ethernet_Transmit and Ethernet_Receive hap callbacks. It is possible to override the packet by assigning this attribute. The device will drop the current packet if the attribute is set to Nil, or with data of zero length.

link
Optional attribute; read/write access; type: Object or Nil.

The Ethernet link that the network device is connected to.

mac_address
Optional attribute; read/write access; type: s|[i{6}]|n.

Ethernet (MAC) address of the network interface.

mappings
Optional attribute; read/write access; type: [[i{5:8}]|[iiiiiiiio|nii]*].

List of all current PCI IO and memory mappings.

mode
Optional attribute; read/write access; type: unknown type.

Internal Register

model_crc
Optional attribute; read/write access; type: Integer.

If set to 1, the device will calculate and include an Ethernet CRC on all transmitted frames, and check the CRC on received frames.

network
Pseudo attribute; read/write access; type: Object or Nil.

Obsolete attribute. Use link instead.

pci_bus
Optional attribute; read/write access; type: Object or Nil.

The PCI bus this device is connected to, implementing the pci-bus interface.

pending_irq
Optional attribute; read/write access; type: unknown type.

Whether and interrupt is pending or not.

poll_reg
Optional attribute; read/write access; type: unknown type.

Internal Register

recorder
Required attribute; read/write access; type: Object.

Recorder object that allows recording and later playback of network traffic to the interface.

reliability
Optional attribute; read/write access; type: Integer.

This value determined how reliable an established connection is. If set to N it means that with a probability of 1 out of N a package will be lost (not sent to the receiver). The default value is 0 which means that no packages will be lost.

reliability_seed
Optional attribute; read/write access; type: Integer.

The seed value for the randomization of packet loss. See the reliability attribute

send_delay
Optional attribute; read/write access; type: unknown type.

How often (in seconds) that packets are send out to the network.

serial_clock
Optional attribute; read/write access; type: Integer.

MII Management Interface serial communication state.

serial_data_in
Optional attribute; read/write access; type: Integer.

MII Management Interface serial communication state.

serial_data_out
Optional attribute; read/write access; type: Integer.

MII Management Interface serial communication state.

serial_num_cycles
Optional attribute; read/write access; type: Integer.

MII Management Interface serial communication state.

serial_port_status
Optional attribute; read/write access; type: Integer.

MII Management Interface serial communication state.

srom_address_width
Optional attribute; read/write access; type: Integer.

Number of address bits when communicating with the serial ROM.

srom_info
Optional attribute; read/write access; type: unknown type.

State information of the serial ROM.

tp10_conf
Optional attribute; read/write access; type: unknown type.

Internal Register

write_masks
Optional attribute; read/write access; type: [[ii]*].

Write masks for all registered configuration registers. The format for each entry is (offset, mask).

Command List

Commands defined by interface log_object
log, log-group, log-level, log-size, log-type
Commands
connectconnect to a simulated Ethernet link
disconnectdisconnect from simulated link
infoprint information about the device
pci-headerprint PCI device header
statusprint status of the device

Command Descriptions

<DEC21041>.connect
Synopsis
<DEC21041>.connect [-auto] (link|"link-name")
Description
Connect the device to a simulated Ethernet link. The flag '-auto' is deprecated and shouldn't be used.
See Also
<DEC21041>.disconnect
<DEC21041>.disconnect
Synopsis
<DEC21041>.disconnect
Description
Disconnect the device from a simulated Ethernet link.
See Also
<DEC21041>.connect
<DEC21041>.info
Synopsis
<DEC21041>.info
Description
Print detailed information about the configuration of the device.
<DEC21041>.pci-header
Synopsis
<DEC21041>.pci-header
Description
Print the PCI header, i.e the configuration registers.
<DEC21041>.status
Synopsis
<DEC21041>.status
Description
Print detailed information about the current status of the device.

VIRTUTECH CONFIDENTIAL    Previous - Up - Next