VIRTUTECH CONFIDENTIAL Previous - Up - Next
AM79C960
- Provided by
-
AM79C960
- Class Hierarchy
-
conf-object → log-object → AM79C960
- Interfaces Implemented
-
log_object, ethernet_device, event_poster, io_memory
- Description
-
The AM79C960 device is a 10Mbit/s Ethernet controller, also known as LANCE, or le on Sun machines. The AM79C960 can be connected to a real network using Simics central. Limitations: The device does not support ethernet frames that are larger than the memory buffer size, and internal loopback is not implemented.
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.
- csr0
- Optional attribute; read/write access; type: Integer.
Control and status register 0.
- csr1
- Optional attribute; read/write access; type: Integer.
Control and status register 1.
- csr2
- Optional attribute; read/write access; type: Integer.
Control and status register 2.
- csr3
- Optional attribute; read/write access; type: Integer.
Control and status register 3.
- 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.
- initialized
- Optional attribute; read/write access; type: Integer.
Set to non-zero when the device instance is initialized (boolean).
- 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.
- irq_dev
- Required attribute; read/write access; type: Object.
Interrupt device implementing the simple-interrupt interface.
- irq_issued
- Optional attribute; read/write access; type: b.
Keeps track of whether an interrupt is currently issued or not.
- irq_level
- Required attribute; read/write access; type: Integer.
Interrupt level.
- 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.
- last_rx
- Optional attribute; read/write access; type: Integer.
Last receive descriptor.
- last_tx
- Optional attribute; read/write access; type: Integer.
Last transmit descriptor.
- link
- Optional attribute; read/write access; type: Object or Nil.
The Ethernet link that the network device is connected to.
- log_addr
- Optional attribute; read/write access; type: i|d.
64-bit logical address mask.
- mac_address
- Optional attribute; read/write access; type: s|[i{6}]|n.
Ethernet (MAC) address of the network interface.
- mac_read_only
- Optional attribute; read/write access; type: Integer.
If set to 1, the mac address cannot be changed by the target software, i.e. it is set in the ROM.
- memory
- Required attribute; read/write access; type: Object.
Memory space object used for DMA memory access.
- mode
- Optional attribute; read/write access; type: Integer.
Mode 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.
- pkt_rec
- Session attribute; read/write access; type: Integer.
Number of received packets.
- pkt_snt
- Session attribute; read/write access; type: Integer.
Number of sent packets.
- poll_delay
- Optional attribute; read/write access; type: Float.
Specifies how often (in seconds) that the device polls for new packets from the host to send out on the network.
- rap
- Optional attribute; read/write access; type: Integer.
Register address port (RAP), selecting one of the control and status registers.
- 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
- rx_len
- Optional attribute; read/write access; type: Integer.
Receive descriptor ring length.
- rx_ptr
- Optional attribute; read/write access; type: Integer.
Receive descriptor ring address.
- send_delay
- Optional attribute; read/write access; type: Float.
The time (in seconds) between a packet is sent from the device until the processor is notified with an interrupt.
- tx_len
- Optional attribute; read/write access; type: Integer.
Transmit descriptor ring length.
- tx_ptr
- Optional attribute; read/write access; type: Integer.
Transmit descriptor ring address.
Command List
- Commands defined by interface log_object
-
log, log-group, log-level, log-size, log-type
- Commands
-
| connect | connect to a simulated Ethernet link |
| disconnect | disconnect from simulated link |
| info | print information about the device |
| status | print status of the device |
Command Descriptions
-
<AM79C960>.connect
- Synopsis
-
<AM79C960>.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
-
<AM79C960>.disconnect
-
<AM79C960>.disconnect
- Synopsis
-
<AM79C960>.disconnect
- Description
-
Disconnect the device from a simulated Ethernet link.
- See Also
-
<AM79C960>.connect
-
<AM79C960>.info
- Synopsis
-
<AM79C960>.info
- Description
-
Print detailed information about the configuration of the device.
-
<AM79C960>.status
- Synopsis
-
<AM79C960>.status
- Description
-
Print detailed information about the current status of the device.
VIRTUTECH CONFIDENTIAL Previous - Up - Next