Difference between revisions of "USB FPGA CODE"

From ElphelWiki
Jump to: navigation, search
m
m (I/O pins control)
Line 72: Line 72:
  
 
=== I/O pins control ===
 
=== I/O pins control ===
FPGA on the model 333 main board traditionally has 6 pins connected to the inter-board 16-pin connector. "Traditionally" because the same pins were used in earlier models 303 and 313. Previously these pins were designated for the particular functions, but it turned out that it is more convinient to have a uniform interface to control all of them. State (0/1) of each pin can be read by software as a 6-bit word at address 0x70, each pin can individually and dynamically be programmed as an output and output particular bit.
+
FPGA on the model 333 main board traditionally has 6 pins connected to the inter-board 16-pin connector J2. "Traditionally" because the same pins were used in earlier models 303 and 313. Previously these pins were designated for the particular functions, but it turned out that it is more convinient to have a uniform interface to control all of them. State (0/1) of each pin can be read by software as a 6-bit word at address 0x70, each pin can individually and dynamically be programmed as an output and output particular bit.
  
 
In addition to per-bit software control of the I/O pins the six_ios module also can delegate direct control to one of 3 possible FPGA additionlal modules, currently USB host interface is under development.
 
In addition to per-bit software control of the I/O pins the six_ios module also can delegate direct control to one of 3 possible FPGA additionlal modules, currently USB host interface is under development.

Revision as of 16:27, 14 December 2005

See discussion also

FPGA code to accomodate USB host module

The code of the JPEG branch of the model 333 camera is modified (in rev 333100e) to accomodate new USB host module currently under development. These modifications also provide vector interrupts (from up to 16 sources) and simplifies the use of 6 FPGA pins connected to the inter-baord connector J2 (and so available at the extension boards).

Vector Interrupts

Axis ETRAX100LX processor [1] supports two modes for external interrupts - with internally generated vector number and with externally generated. In the latter case CPU generates INTA pulse and the peripheral places an 8-bit vector code on the data bus. New (>=333100e) FPGA code supports both modes, for each of 16 intrerrupts individual vector code can be programmed. Four locations in the FPGA address space (CSP0,CSP4) are writable to control interrupts_vector333 module:

Reset Interrupt Requests

 #define   X313_WA_IRQ_RST   0x1c // reset selected interrupt bits

This register resets the selected bits (having ones in a word written to this location) of the source interrupt request register that is positive edge triggered from asynchronous signal in FPGA and reset by either of two reasons:

  • writing to the X313_WA_IRQ_RST (0x1c) register with ones in the bits to be reset and
  • servicing thisinterrupt with externally generated vector number. When the INTA is generated the interrupt request bit that caused the interrupt (or at least the one which had it's number placed on data bus in responce to INTA) is reset so software does not need to do it again.

Interrupt MAsk Register

 #define   X313_WA_IRQ_DIS   0x1d // disable selected interrupt bits (mask)
 #define   X313_WA_IRQ_ENA   0x1e // enable selected interrupt bits

These two locations control the interrupt mask register. Ones written to X313_WA_IRQ_DIS disable propagation of the interrupt(s) in the selected bit(s), ones written to X313_WA_IRQ_ENA enable them. After initial FPGA configuration all the interrupts are disabled. Enabling and disabling individual interrupt bits do not change the status of the interrupt requests, so if the interrupt causing event happened while this interrupt was disabled (masked out) and enabled later, the interrupt request to the CPU will be generated.

Programming Interrupt Vectors

#define   X313_WA_IRQ_WVECT 0x1f // write vector number (in bits [0:7], [11:8] - interrupt number (0..15)

In responce to the INTA pulse from the CPU (it will be generated if "extrernally generated vector number" is selected) one of the 16 pre-programmed 8-bit vectors will be placed on the data bus. You need to initialize the vectors before using them, initially all vectors are zeros. To program particular interrupt vector you need to combine the 8-bit vector for the selected interrupt and the interrupt bit number (0..15) by shifting the latter left by 8 and writing the 12-bit result to X313_WA_IRQ_WVECT.

If more than 1 interrupt are active (not reset and not masked) the one with the lower number will have higher priority.

When servicing one of the simultaneously active interrupts only one will be reset by INTA (the one that is being served), so immidiately after returning from servicing one request, CPU will generate INTA to serve the next remaining one.

Interrupt Map

Currently the following interrupts exist in the FPGA code of the Model 333 camera

bit vector FPGA Driver Used? Description
0 vacts VACT Y frame sync
1 trig_irq XINT N external trigger
2 xfer_over_irq XFEROVR N frame acquisition over
3 sr_sensortrig[2] DONE N level, reset by writing to sensor triggering command register (FPGA != driver!)
4 compressor_eot EOT N Frame Sync
5 dcc_rdy DCC N (Next 128 16-bit DC components (and HF too) are ready (or the partial block - last in frame).)
6 compressor_done_input DONE_INPUT N will go high after EOT and persist until DCT is enabled (source reset by compressor)
7 compressor_done_compress DONE_COMPRESS Y will go high after all data is sent out (source reset by compressor)
8 usb_irqs[0] --- N USB interrupt 0
9 usb_irqs[1] --- N USB interrupt 1
10 usb_irqs[2] --- N USB interrupt 2
11 usb_irqs[3] --- N USB interrupt 3
12 usb_irqs[4] --- N USB interrupt 4
13 usb_irqs[5] --- N USB interrupt 5
14 --- --- N ---
15 --- --- N ---

Reading Interrupt Status

It is possible to read the current state of all 16 possible interrupts throuhg the 32-bit register

#define X313__RA__IRQS  	0x11    // read interrupt register

The lower 16 bits are masked interrupt requests - those that OR-ed define the interrupt request to the CPU.

The 16 highest bits are the same interrupt bits before the mask, so they are set for all the same bits in the lower 16 and possiblyy some other interrupt bits that are triggered but masked out.

I/O pins control

FPGA on the model 333 main board traditionally has 6 pins connected to the inter-board 16-pin connector J2. "Traditionally" because the same pins were used in earlier models 303 and 313. Previously these pins were designated for the particular functions, but it turned out that it is more convinient to have a uniform interface to control all of them. State (0/1) of each pin can be read by software as a 6-bit word at address 0x70, each pin can individually and dynamically be programmed as an output and output particular bit.

In addition to per-bit software control of the I/O pins the six_ios module also can delegate direct control to one of 3 possible FPGA additionlal modules, currently USB host interface is under development.

bit FPGA name PCB name conector (J2) pin
0 SCL1 EXT_SCL 1
1 SDA1 EXT_SDA 2
2 XRST EXT_RST 3
3 AUXCLK EXT_CLK 4
4 EXPS EXT_EXPOS 5
5 TRIG EXT_TRIG 6


// those pins were controlled (in models 303, 313, 323 and earlier 333) by the control register, status was // read through the status register.

// Now each pin will be controlled by 2 bits (data+enable), total 12 bits that will come from one of 4 sources // selected by bits [13:12] of the new control word: // 0 - use bits [11:0] of the control word // 1 - use channel A (USB)? // 2 - use channel B (tbd) // 3 - use channel C (tbd)

// 1 - SDA1 // 2 - XRST // 3 - AUXCLK // 4 - EXPS // 5 - TRIG