[wiki:Component SocLib Components General Index] 

= !VciIopic =

== 1) Functional Description ==

This component is a multi-channels, programmable, Hardware Interrupt  to Software Interrupt translator. It can be used to translate a variable number of hardware interrupt lines (HWI) to the same number of write triggered interrupt (SWI) that can be handled by a !VciXicu component. It acts as a VCI initiator, to send a single flit VCI packet to the target !VciXicu interrupt controller, when a rising/falling edge is detected on a given HWI input. It acts also as a memory mapped VCI target, as the addresses of the WTI associated to a given HWI must be configured by the software.

For each HWI channel, there is three 32 bits addressable registers:

'''IOPIC_ADDRESS''' This READ/WRITE register contains the 32 LSB bits of the physical WTI address associated to the HWI channel.

'''IOPIC_EXTEND''' This READ/WRITE register contains the 32 MSB bits of the physical WTI address associated to the HWI channel.

'''IOPIC_STATUS''' This READ-ONLY register register contains the HWI channel status. Only the two LSB bits are significant:
 * Bit 0 : HWI line current value.
 * Bit 1 : ERROR reported in a WTI transaction when this bit is set.
Any read access to the IOPIC status register reset the ERROR bit.

== 2) Component definition & usage

source:trunk/soclib/module/infrastructure_component/interrupt_infrastructure/vci_iopic/caba/metadata/vci_iopic.sd

{{{
Uses( 'vci_iopic' )
}}}

== 3) CABA  Implementation ==

=== CABA sources ===

 * interface : source:trunk/soclib/soclib/module/infrastructure_component/interrupt_infrastructure/vci_iopic/caba/source/include/vci_iopic.h
 * implementation : source:trunk/soclib/soclib/module/infrastructure_component/interrupt_infrastructure/vci_iopic/caba/source/src/vci_iopic.cpp

=== CABA Constructor parameters ===
{{{ 
VciIopic(
     sc_module_name name,  // Component Name
     const soclib::common::MappingTable &mt,  // Mapping Table
     const soclib::common::IntTab &srcid, // Initiator index
     const soclib::common::IntTab &tgtid, // Target index
     const size_t channels );   // Number of HWI channels (inputs)
}}}

=== CABA Ports ===

 * sc_in<bool> '''p_clk''' : Global system clock
 * sc_in<bool> '''p_resetn'''  : Global system reset
 * soclib::caba::!VciInitiator<vci_param> '''p_vci_initiator''' : VCI initiator port
 * soclib::caba::!VciTarget<vci_param> '''p_vci_target''' : VCI target port
 * sc_in<bool> *'''p_hwi''' : Input interrupts ports array