29. Inter-processor communication controller (IPCC)

29.1 Introduction

The inter-processor communication controller (IPCC) is used for communicating data between two processors.

The IPCC block provides a nonblocking signaling mechanism to post and retrieve communication data in an atomic way. It provides the signaling for twelve channels:

• • six channels in the direction from processor 1 to processor 2
• • six channels in the opposite direction

It is then possible to have two different communication types in each direction.

The IPCC communication data must be located in a common memory, which is not part of the IPCC block.

29.2 IPCC main features

• • Status signaling for the twelve channels
  • – Channel occupied/free flag, also used as lock
• • Two interrupt lines per processor
  • – One for RX channel occupied (communication data posted by sending processor)
  • – One for TX channel free (communication data retrieved by receiving processor)
• • Interrupt masking per channel
  • – Channel occupied mask
  • – Channel free mask
• • Two channel operation modes
  • – Simplex (each channel has its own communication data memory location)
  • – Half duplex (a single channel associated to a bidirectional communication data information memory location)

29.3 IPCC functional description

The IPCC communication data is located in a common memory, which is not part of the IPCC block. The address location of the communication data must be known or located in a known common area that, as already stated, is not part of the IPCC block.

For each communication, the IPCC block provides a channel status flag CHnF.

• • When 0, the channel status flag CHnF indicates that the associated IPCC channel is free (the receiving processor has retrieved communication data), and can be accessed by the sending processor.
• • When 1, the channel status flag CHnF indicates that the associated IPCC channel is occupied (the sending processor has posted communication data) and can be accessed by the receiving processor.

The channel operation mode must be known to both processors. A common parameter can be used to indicate the channel transfer mode and must also be located in a known common area. This parameter is not available from the IPCC.

29.3.1 IPCC block diagram

The IPCC (see Figure 284) consists of the following subblocks:

• • Status block, containing the channel status
• • IPCC interface block, providing AHB access to the channel status registers
• • Interrupt interface block, providing control for the interrupts

Figure 284. IPCC block diagram

Table 179. IPCC interface signals

29.3.2 IPCC Simplex channel mode

In Simplex channel mode, a dedicated memory location (used to transfer data in a single direction) is assigned to the communication data. The associated channel N control bits (see Table 180) are used to manage the transfer from the sending to the receiving processor.

Table 180. Bits used for the communication

Once the sending processor has posted the communication data in the memory, it sets the channel status flag CHnF to occupied with CHnS.

Once the receiving processor has retrieved the communication data from the memory, it clears the channel status flag CHnF back to free with CHnC.

Figure 285. IPCC Simplex channel mode transfer timing

MS42430V1

Figure 286. IPCC Simplex - Send procedure state diagram

graph TD; Start(( )) -- "Send Communication data" --> ReadCHnF{Read CHnF}; ReadCHnF -- "CHnF = 0" --> WriteData[Write Communication data to memory]; ReadCHnF -- "CHnF = 1" --> UNMASK[UNMASK Channel N free interrupt]; UNMASK --> WriteCHnFM0[Write CHnFM = 0]; WriteCHnFM0 --> WaitTX[Wait for TX free interrupt]; WaitTX --> TXFree[TX free interrupt]; TXFree --> ReadCHnF0[Read CHnF = 0]; ReadCHnF0 --> MASK[MASK Channel N free interrupt]; MASK --> WriteCHnFM1[Write CHnFM = 1]; WriteCHnFM1 --> WriteData; WriteData --> Complete[Complete communication posted]; Complete --> SetOccupied[Set Channel N occupied]; SetOccupied --> WriteCHnS[Write CHnS (set CHnF = 1)]; WriteCHnS --> End([End])

To send communication data:

• • The sending processor checks the channel status flag CHnF:
  • – When CHnF = 0, the channel is free (last communication data retrieved by the receiving processor), and the new communication data can be written.
  • – When CHnF = 1, the channel is occupied (last communication data not retrieved by the receiving processor), and the sending processor unmasks the channel free interrupt (CHnFM = 0).
  • – On a TX free interrupt, the sending processor checks which channel became free and masks the channel free interrupt (CHnFM = 1). Then the new communication can take place.
• • Once the complete communication data is posted, the channel status is set to occupied with CHnS. This gives memory access to the receiving processor and generates the RX occupied interrupt.

Figure 287. IPCC Simplex - Receive procedure state diagram

graph TD
    Start(( )) -.-> RX_occupied[RX occupied interrupt]
    RX_occupied -- "Read CHnF = 1" --> MASK[MASK
Channel N
occupied interrupt]
    MASK -- "Write CHnOM = 1" --> Read_Memory[Read
Communication
data from Memory]
    Read_Memory -- "Complete communication retrieved" --> Set_Free[Set Channel N free]
    Set_Free -- "Write CHnC (set CHnF = 0)" --> UNMASK[UNMASK
Channel N
occupied interrupt]
    UNMASK -- "Write CHnOM = 0" --> End([End])
  

To receive a communication, the channel occupied interrupt is unmasked ( CHnOM = 0):

• • On an RX occupied interrupt, the receiving processor checks which channel became occupied, masks the associated channel occupied interrupt ( CHnOM ) and reads the communication data from memory.
• • Once the complete communication data is retrieved, the channel status is cleared to free with CHnC . This gives memory access back to the sending processor and may generate the TX free interrupt.
• • Once the channel status is cleared, the channel occupied interrupt is unmasked ( CHnOM = 0).

29.3.3 IPCC Half-duplex channel mode

The Half-duplex channel mode is used when one processor sends a communication and the other processor sends a response to each communication (ping-pong).

In Half-duplex channel mode, a single dedicated memory location is assigned to communication data and response, and is used to transfer data in both directions. The sending processor channel status flag CHnF is assigned to the channel and used by both processors (see Table 180 ).

Once the processor A posts communication data into memory, it sets the processor A channel status flag CHnF to occupied with CHnS (giving memory access to processor B).

Once the processor B retrieves communication data from memory, it does not change the channel status flags. The memory access is kept by processor B for the response.

Once the processor B posts the response into memory, it clears the channel status flag CHnF to free with CHnC (giving memory access back to processor A).

Once the processor A retrieves the response from the memory, it does not change the channel status flags. The memory location access is kept by processor A for the next communication data.

Figure 288. IPCC Half-duplex channel mode transfer timing

MS42435V1

Figure 289. IPCC Half-duplex - Send procedure state diagram

MS42433V1

To send communication data:

• • The sending processor waits for its response pending software variable to get 0.
  • – Once the response pending software variable is 0 the communication data is posted.
• • Once the complete communication data has been posted, the channel status flag CHnF is set to occupied with CHnS, and the response pending software variable is set to 1 (this gives memory access and generates the RX occupied interrupt to the receiving processor).
• • Once the channel status flag CHnF is set, the channel free interrupt is unmasked (CHnFM = 0).

To send a response:

• • The receiving processor waits for its response pending software variable to get 1.
  • – Once the response pending software variable is 1, the response is posted.
• • Once the complete response is posted, the channel status flag CHnF is cleared to free with CHnC, and the response pending software variable is set to 0 (this gives memory access and generates the TX free interrupt to the sending processor).
• • Once the channel status flag CHnF is cleared, the channel occupied interrupt is unmasked (CHnOM = 0).

Figure 290. IPCC Half-duplex - Receive procedure state diagram

stateDiagram-v2
    state "Response processor A" as A
    state "Communication processor B" as B

    state A {
        [*] --> TX_free_interrupt_A: TX free interrupt
        TX_free_interrupt_A --> Read_CHnF_0_A: Read CHnF = 0
        Read_CHnF_0_A --> MASK_Channel_N_free_interrupt_A: MASK Channel N free interrupt
        MASK_Channel_N_free_interrupt_A --> Write_CHnFM_1_A: Write CHnFM = 1
        Write_CHnFM_1_A --> Read_Response_from_Memory_A: Read Response from Memory
        Read_Response_from_Memory_A --> Write_Response_pending_0_A: Write Response pending = 0
        Write_Response_pending_0_A --> Allow_Communication_data_to_be_sent_A: Allow Communication data to be sent
    }

    state B {
        [*] --> RX_occupied_interrupt_B: RX occupied interrupt
        RX_occupied_interrupt_B --> Read_CHnF_1_B: Read CHnF = 1
        Read_CHnF_1_B --> MASK_Channel_N_occupied_interrupt_B: MASK Channel N occupied interrupt
        MASK_Channel_N_occupied_interrupt_B --> Write_CHnOM_1_B: Write CHnOM = 1
        Write_CHnOM_1_B --> Read_Communication_data_from_Memory_B: Read Communication data from Memory
        Read_Communication_data_from_Memory_B --> Complete_communication_retrieved_B: Complete communication retrieved
        Complete_communication_retrieved_B --> Write_Response_pending_1_B: Write Response pending = 1
        Write_Response_pending_1_B --> Allow_Response_to_be_sent_B: Allow Response to be sent
    }

    Complete_communication_retrieved_B --> Read_Response_from_Memory_A
  

To receive communication data the channel occupied interrupt is unmasked (CHnOM = 0):

• • On an RX occupied interrupt, the receiving processor checks which channel became occupied, masks the associated channel occupied interrupt (CHnOM) and reads the communication data from the memory.
• • Once the complete communication data is retrieved, the response pending software variable is set. The channel status is not changed, access to the memory is kept to post the subsequent response.

To receive the response the channel free interrupt is unmasked ( \( CHnFM = 0 \) ):

• • On a TX free interrupt, the sending processor checks which channel became free, masks the associated channel free interrupt ( \( CHnFM \) ) and reads the response from the memory.
• • Once the complete response is retrieved, the response pending software variable is cleared. The channel status is not changed, access to the memory is kept to post the subsequent communication data.

29.3.4 IPCC interrupts

There are four interrupt lines :

• • two RX channel occupied interrupts, one for each processor:
  • – Interrupt enable \( RXOIE \) per processor
  • – Individual mask \( CHnOM \) per channel
• • two TX channel free interrupts, one for each processor
  • – Interrupt enable \( TXFIE \) per processor
  • – Individual mask \( CHnFM \) per channel

The RX occupied interrupt is used by the receiving processor and indicates when an unmasked channel status indicates occupied ( \( CHnF = 1 \) ).

The TX free interrupt is used by the sending processor, and indicates when an unmasked channel status indicates free ( \( CHnF = 0 \) ).

A secure channel only generates a secure interrupt, and only in the case when the channel is secure unmasked and global secure enabled.

A non-secure channel only generates a non-secure interrupt, and only in the case when the channel is non-secure unmasked and global non-secure enabled.

29.4 IPCC registers

The peripheral registers must be accessed by words (32-bit). Byte (8-bit) and half-word (16-bit) accesses are not permitted and do not generate a bus error.

29.4.1 IPCC processor 1 control register (IPCC_C1CR)

Address offset: 0x000

Reset value: 0x0000 0000

Bits 31:17 Reserved, must be kept at reset value.

Bit 16 TXFIE : Processor 1 transmit channel free interrupt enable

Associated with IPCC_C1TOC2SR.

1: Enable an unmasked processor 1 transmit channel free to generate a TX free interrupt.

0: Processor 1 TX free interrupt disabled

Bits 15:1 Reserved, must be kept at reset value.

Bit 0 RXOIE : Processor 1 receive channel occupied interrupt enable

Associated with IPCC_C2TOC1SR.

1: Enable an unmasked processor 1 receive channel occupied to generate an RX occupied interrupt.

0: Processor 1 RX occupied interrupt disabled

29.4.2 IPCC processor 1 mask register (IPCC_C1MR)

Address offset: 0x004

Reset value: 0xFFFF FFFF

Bits 31:22 Reserved, must be kept at reset value.

Bits 21:16 CHnFM : Processor 1 transmit channel n status set, (n = 6 to 1).

Associated with IPCC_C1TOC2SR.CHnF

1: Transmit channel n free interrupt masked.

0: Transmit channel n free interrupt not masked.

Bits 15:6 Reserved, must be kept at reset value.

Bits 5:0 CHnOM : Processor 1 receive channel n status clear (n = 6 to 1).

Associated with IPCC_C2TOC1SR.CHnF

1: Receive channel n occupied interrupt masked.

0: Receive channel n occupied interrupt not masked.

29.4.3 IPCC processor 1 status set clear register (IPCC_C1SCR)

Address offset: 0x008

Reset value: 0x0000 0000

Reading this register always returns 0x0000 0000.

Bits 31:22 Reserved, must be kept at reset value.

Bits 21:16 CHnS : Processor 1 transmit channel n status set (n = 6 to 1).

Associated with IPCC_C1TOC2SR.CHnF

1: Processor 1 transmit channel n status bit set.

0: No action.

Bits 15:6 Reserved, must be kept at reset value.

Bits 5:0 CHnC : Processor 1 receive channel n status clear (n = 6 to 1).

Associated with IPCC_C2TOC1SR.CHnF

1: Processor 1 receive channel n status bit clear.

0: No action.

29.4.4 IPCC processor 1 to processor 2 status register (IPCC_C1TOC2SR)

Address offset: 0x00C

Reset value: 0x0000 0000

Bits 31:6 Reserved, must be kept at reset value.

Bits 5:0 CHnF : Processor 1 transmit to processor 2 receive channel n status flag before masking (n = 6 to 1).

1: Channel occupied, data can be read by the receiving processor 2.

Generates a channel RX occupied interrupt to processor 2, when unmasked.

0: Channel free, data can be written by the sending processor 1.

Generates a channel TX free interrupt to processor 1, when unmasked.

29.4.5 IPCC processor 2 control register (IPCC_C2CR)

Address offset: 0x010

Reset value: 0x0000 0000

Bits 31:17 Reserved, must be kept at reset value.

Bit 16 TXFIE : Processor 2 transmit channel free interrupt enable

Associated with IPCC_C2TOC1SR.

1: Enable an unmasked processor 2 transmit channel free to generate a TX free interrupt.

0: Processor 2 TX free interrupt disabled

Bits 15:1 Reserved, must be kept at reset value.

Bit 0 RXOIE : Processor 2 receive channel occupied interrupt enable

Associated with IPCC_C1TOC2SR.

1: Enable an unmasked processor 2 receive channel occupied to generate an RX occupied interrupt.

0: Processor 2 RX occupied interrupt disabled

29.4.6 IPCC processor 2 mask register (IPCC_C2MR)

Address offset: 0x014

Reset value: 0xFFFF FFFF

Bits 31:22 Reserved, must be kept at reset value.

Bits 21:16 CHnFM : Processor 2 transmit channel n free interrupt mask (n = 6 to 1).

Associated with IPCC_C2TOC1SR.CHnF

1: Transmit channel n free interrupt masked.

0: Transmit channel n free interrupt not masked.

Bits 15:6 Reserved, must be kept at reset value.

Bits 5:0 CHnOM : Processor 2 receive channel n occupied interrupt mask (n = 6 to 1).

Associated with IPCC_C1TOC2SR.CHnF

1: Receive channel n occupied interrupt masked.

0: Receive channel n occupied interrupt not masked.

29.4.7 IPCC processor 2 status set clear register (IPCC_C2SCR)

Address offset: 0x018

Reset value: 0x0000 0000

Reading this register always returns 0x0000 0000.

Bits 31:22 Reserved, must be kept at reset value.

Bits 21:16 CHnS : Processor 2 transmit channel n status set (n = 6 to 1).

Associated with IPCC_C2TOC1SR.CHnF

1: Processor 2 transmit channel n status bit set.

0: No action.

Bits 15:6 Reserved, must be kept at reset value.

Bits 5:0 CHnC : Processor 2 receive channel n status clear (n = 6 to 1).

Associated with IPCC_C1TOC2SR.CHnF

1: Processor 2 receive channel n status bit clear.

0: No action.

29.4.8 IPCC processor 2 to processor 1 status register (IPCC_C2TOC1SR)

Address offset: 0x01C

Reset value: 0x0000 0000

Bits 31:6 Reserved, must be kept at reset value.

Bits 5:0 CHnF : Processor 2 transmit to processor 1 receive channel n status flag before masking (n = 6 to 1)

1: Channel occupied, data can be read by the receiving processor 1.

Generates a channel RX occupied interrupt to processor 1, when unmasked.

0: Channel free, data can be written by the sending processor 2.

Generates a channel TX free interrupt to processor 2, when unmasked.

29.4.9 IPCC register map

Table 181. IPCC register map and reset values

Refer to Section 2.2 on page 54 for the register boundary addresses.