Intel(R) IQ80315 I/O Processor DMA and XOR Library APIs and ...

More documents

Recommendations

Info

Intel ® GW80314 I/O Processor DMA and XOR LibraryLibrary Function PrototypesE.2.3void lib_init(XorDma_80314_Type * mgrt,void * desc_baseaddr)ItemDescriptionPrototype void lib_init(XorDma_80314_Type * mgrt, void * desc_baseaddr);InputOutputPurposeOperationmgrt - pointer to XorDma_80314_Type allocated by lib_new_mgr().desc_baseaddr - Base address of memory region to be used by DMA/XOR descriptorsNoneTo take memory address allocated for DMA/XOR buffers and initialize stack and queues.After this function call DMA/XOR stacks and queues are initialized and DMA/XOR Section ofthe Library is read for use.• Initialize DMA/XOR free stacks• Initialize channel 0, 1, 3 and 4 post queues• Execute dummy descriptors for four channels to enable appends. The initializechainHeadDMAXOR[channel] and chainTailDMAXOR[channel] to allow append/resume.E.2.4void lib_free_mgr(XorDma_80314_Type * mgr)ItemDescriptionPrototype void lib_free_mgr(XorDma_80314_Type * mgr);InputOutputPurposeOperationPointer to XorDma_80314_Type data structure to freeNoneFrees all memory associated with XorDma_80314_Type and sets to NULL.Frees all memory associated with XorDma_80314_Type and sets to NULL.E.2.5void * lib_stack_pop(XorDma_80314_Type * mgr,enum CHANNEL channel)ItemDescriptionPrototype void * lib_stack_pop(XorDma_80314_Type * mgr, enum CHANNEL channel)InputOutputPurposeOperationXorDma_80314_Type being used)Engine: either Channel 0, 1, 2 or 3Pointer to Frame when successful or NULL when stack emptyTo provide a DMA or XOR frame from a free stack. When a cacheable memory regions isused for descriptors, using stack increases the likelihood that stack is still in cache.Gets DMA/XOR frame from the top of the channel specific Free stack and changes stackstate to reflect removal.72 APIs and Testbench White Paper
Intel ® GW80314 I/O Processor DMA and XOR LibraryLibrary Function PrototypesE.2.6Bool lib_stack_push(XorDma_80314_Type * mgr,void * frame, enum CHANNEL channel)ItemPrototypeInputOutputPurposeOperationBoolchannel)Descriptionlib_stack_push(XorDma_80314_Type * mgr, void * frame, enum CHANNELmgr: XorDma_80314_Type pointer to data structure being accessed.frame: pointer to frame being returned to the stackchannel: either Channel 0, 1, 2, or 3Success == 0Fail == non-zeroPlace frame on stack for future reuse.Place Channel 0, 1, 2 or 3 frame on top of free stack and change stack state to show a newtop of stack.E.2.7void * lib_top_of_stack(XorDma_80314_Type * mgr,enum CHANNEL channel)ItemDescriptionPrototype void * lib_top_of_stack(XorDma_80314_Type * mgr, enum CHANNEL channel)InputOutputPurposeOperationPointer to XorDma_80314_Type being used.Engine: either Channel 0, 1, 2 or 3Pointer to TOS frame or NULL when stack is emptyGet a pointer to top frame on the stack (Either channel 0, 1, 2 and 3). This function does notchange the state of the stack. Could be used for preload.See purposeAPIs and Testbench White Paper 73
Page 1 and 2:
Intel ® GW80314 I/O ProcessorDMA a
Page 3 and 4:
ContentsContents1.0 Introduction...
Page 5 and 6:
ContentsE.2.10 void * lib_q_get(Xor
Page 7 and 8:
Revision HistoryRevision HistoryDat
Page 9 and 10:
Intel ® GW80314 I/O Processor DMA
Page 11 and 12:
Page 13 and 14:
Page 15 and 16:
Page 17 and 18:
Page 19 and 20:
Page 21 and 22: Intel ® GW80314 I/O Processor DMA
Page 71: Intel ® GW80314 I/O Processor DMA
show all

Intel(R) IQ80315 I/O Processor DMA and XOR Library APIs and ...

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?