Intel 80310 I/O Processor Chipset AAU Coding Techniques

More documents

Recommendations

Info

Intel ® 80310 I/O Processor Chipset AAU Coding TechniquesLow-Level Design DocumentWhen an AAU interrupt is asserted, the interrupt handler function aau_irq_handler() iscalled. Clearing an interrupt requires clearing it at the source. In this case the source is theAccelerator Status Register. When the Accelerator Status Resister has been cleared in the interrupthandler, the interrupt assert bit shall be cleared by the hardware as a consequence. As long as theAAU interrupt is asserted due to new AAU interrupts, the interrupt handler continues to remove thedescriptors from the channel process queue and put the descriptors in the channel holding queueuntil the ADAR value equals to the address of the descriptor or the queue is empty. When theADAR equals the descriptor address and the ASR indicates that the channel is active then thatdescriptor is not removed. Once the interrupt handler no longer sees an AAU interrupt beingasserted it schedules a bottom half handler in the immediate task queue to process the holdingqueue and notify the application of the progress of the AAU operation.The application calls the function aau_free() when it no longer needs the AAU and wants torelease it. Depending on the reference count, the IRQ requested for the AAU may be freed. Whenthere are any errors for the AAU unit, the AAU registers are cleared, all resources are returned, andthe reference count shall be reset to 0.Figure 2 shows the state trace diagram for a normal operation of the AAU. The diagramdemonstrates all the necessary function calls that are performed during a normal, simple AAUexecution path. The section explaining the APIs in detail follows.Figure 2.AAU State Trace DiagramUser AAU INTC Systemaau_get_buffer()aau_init()aau_queue_buffer()aau_start()AAU Completeaau_irq_handler()Sleep on wait queue or Proceed oncallbackaau_process()aau_buffer_return()Callback or Wake if Sleepingaau_free()aau_task()16 White Paper
Intel ® 80310 I/O Processor Chipset AAU Coding TechniquesLow-Level Design Document3.1.6 API FunctionsThe following functions shall be implemented to support the AAU API for Intel ® XScale microarchitecture embedded Linux.3.1.6.1 API Listing3.1.6.1.1 AAU Publicintintintintintaau_sgl_t*voidintaau_request(u32 *aau_context);aau_suspend(u32 aau_context);aau_resume(u32 aau_context);aau_queue_buffer(u32_context, aau_sgl_t *sgl);aau_free(u32 aau_context);aau_get_buffer(u32 aau_context, u32 num_buff);aau_return_buffer(u32 aau_context, sgl_list_t *list);aau_memcpy(void *, void *, u32);3.1.6.1.2 AAU Private (Static)static int __initstatic intstatic intstatic voidstatic voidstatic voidaau_init(void);\aau_start(iop310_aau_t *aau_chain);aau_flush_all(u32 aau_context);aau_irq_handler(int irq, void *dev_id, struct pt_regs *regs);aau_process(iop310_aau_t *aau);aau_result_handler(void *aau);White Paper 17
Page 1: Intel ® 80310 I/O ProcessorChipset
Page 6 and 7: Revision HistoryRevision HistoryDat
Page 8 and 9: Intel ® 80310 I/O Processor Chipse
Page 15: Intel ® 80310 I/O Processor Chipse
Page 67 and 68:
Intel ® 80310 I/O Processor Chipse
Page 69 and 70:
Page 71 and 72:
Page 73 and 74:
Page 75 and 76:
Page 77 and 78:
Page 79 and 80:
Page 81 and 82:
Page 83 and 84:
Page 85 and 86:
Page 87 and 88:
Page 89 and 90:
Page 91 and 92:
Page 93 and 94:
Page 95 and 96:
Page 97 and 98:
show all

Intel 80310 I/O Processor Chipset AAU Coding Techniques

Create successful ePaper yourself

Delete template?

Save as template?