123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429 |
- #ifndef ASMARM_DMA_MAPPING_H
- #define ASMARM_DMA_MAPPING_H
- #ifdef __KERNEL__
- #include <linux/mm_types.h>
- #include <linux/scatterlist.h>
- #include <linux/dma-attrs.h>
- #include <linux/dma-debug.h>
- #include <asm-generic/dma-coherent.h>
- #include <asm/memory.h>
- #define DMA_ERROR_CODE (~0)
- extern struct dma_map_ops arm_dma_ops;
- static inline struct dma_map_ops *get_dma_ops(struct device *dev)
- {
- if (dev && dev->archdata.dma_ops)
- return dev->archdata.dma_ops;
- return &arm_dma_ops;
- }
- static inline void set_dma_ops(struct device *dev, struct dma_map_ops *ops)
- {
- BUG_ON(!dev);
- dev->archdata.dma_ops = ops;
- }
- #include <asm-generic/dma-mapping-common.h>
- static inline int dma_set_mask(struct device *dev, u64 mask)
- {
- return get_dma_ops(dev)->set_dma_mask(dev, mask);
- }
- #ifdef __arch_page_to_dma
- #error Please update to __arch_pfn_to_dma
- #endif
- /*
- * dma_to_pfn/pfn_to_dma/dma_to_virt/virt_to_dma are architecture private
- * functions used internally by the DMA-mapping API to provide DMA
- * addresses. They must not be used by drivers.
- */
- #ifndef __arch_pfn_to_dma
- static inline dma_addr_t pfn_to_dma(struct device *dev, unsigned long pfn)
- {
- return (dma_addr_t)__pfn_to_bus(pfn);
- }
- static inline unsigned long dma_to_pfn(struct device *dev, dma_addr_t addr)
- {
- return __bus_to_pfn(addr);
- }
- static inline void *dma_to_virt(struct device *dev, dma_addr_t addr)
- {
- return (void *)__bus_to_virt((unsigned long)addr);
- }
- static inline dma_addr_t virt_to_dma(struct device *dev, void *addr)
- {
- return (dma_addr_t)__virt_to_bus((unsigned long)(addr));
- }
- #else
- static inline dma_addr_t pfn_to_dma(struct device *dev, unsigned long pfn)
- {
- return __arch_pfn_to_dma(dev, pfn);
- }
- static inline unsigned long dma_to_pfn(struct device *dev, dma_addr_t addr)
- {
- return __arch_dma_to_pfn(dev, addr);
- }
- static inline void *dma_to_virt(struct device *dev, dma_addr_t addr)
- {
- return __arch_dma_to_virt(dev, addr);
- }
- static inline dma_addr_t virt_to_dma(struct device *dev, void *addr)
- {
- return __arch_virt_to_dma(dev, addr);
- }
- #endif
- /*
- * DMA errors are defined by all-bits-set in the DMA address.
- */
- static inline int dma_mapping_error(struct device *dev, dma_addr_t dma_addr)
- {
- return dma_addr == DMA_ERROR_CODE;
- }
- /*
- * Dummy noncoherent implementation. We don't provide a dma_cache_sync
- * function so drivers using this API are highlighted with build warnings.
- */
- static inline void *dma_alloc_noncoherent(struct device *dev, size_t size,
- dma_addr_t *handle, gfp_t gfp)
- {
- return NULL;
- }
- static inline void dma_free_noncoherent(struct device *dev, size_t size,
- void *cpu_addr, dma_addr_t handle)
- {
- }
- /*
- * dma_coherent_pre_ops - barrier functions for coherent memory before DMA.
- * A barrier is required to ensure memory operations are complete before the
- * initiation of a DMA xfer.
- * If the coherent memory is Strongly Ordered
- * - pre ARMv7 and 8x50 guarantees ordering wrt other mem accesses
- * - ARMv7 guarantees ordering only within a 1KB block, so we need a barrier
- * If coherent memory is normal then we need a barrier to prevent
- * reordering
- */
- static inline void dma_coherent_pre_ops(void)
- {
- #if COHERENT_IS_NORMAL == 1
- dmb();
- #else
- if (arch_is_coherent())
- dmb();
- else
- barrier();
- #endif
- }
- /*
- * dma_post_coherent_ops - barrier functions for coherent memory after DMA.
- * If the coherent memory is Strongly Ordered we dont need a barrier since
- * there are no speculative fetches to Strongly Ordered memory.
- * If coherent memory is normal then we need a barrier to prevent reordering
- */
- static inline void dma_coherent_post_ops(void)
- {
- #if COHERENT_IS_NORMAL == 1
- dmb();
- #else
- if (arch_is_coherent())
- dmb();
- else
- barrier();
- #endif
- }
- extern int dma_supported(struct device *dev, u64 mask);
- /**
- * arm_dma_alloc - allocate consistent memory for DMA
- * @dev: valid struct device pointer, or NULL for ISA and EISA-like devices
- * @size: required memory size
- * @handle: bus-specific DMA address
- * @attrs: optinal attributes that specific mapping properties
- *
- * Allocate some memory for a device for performing DMA. This function
- * allocates pages, and will return the CPU-viewed address, and sets @handle
- * to be the device-viewed address.
- */
- extern void *arm_dma_alloc(struct device *dev, size_t size, dma_addr_t *handle,
- gfp_t gfp, struct dma_attrs *attrs);
- #define dma_alloc_coherent(d, s, h, f) dma_alloc_attrs(d, s, h, f, NULL)
- static inline void *dma_alloc_attrs(struct device *dev, size_t size,
- dma_addr_t *dma_handle, gfp_t flag,
- struct dma_attrs *attrs)
- {
- struct dma_map_ops *ops = get_dma_ops(dev);
- void *cpu_addr;
- BUG_ON(!ops);
- cpu_addr = ops->alloc(dev, size, dma_handle, flag, attrs);
- debug_dma_alloc_coherent(dev, size, *dma_handle, cpu_addr);
- return cpu_addr;
- }
- /**
- * arm_dma_free - free memory allocated by arm_dma_alloc
- * @dev: valid struct device pointer, or NULL for ISA and EISA-like devices
- * @size: size of memory originally requested in dma_alloc_coherent
- * @cpu_addr: CPU-view address returned from dma_alloc_coherent
- * @handle: device-view address returned from dma_alloc_coherent
- * @attrs: optinal attributes that specific mapping properties
- *
- * Free (and unmap) a DMA buffer previously allocated by
- * arm_dma_alloc().
- *
- * References to memory and mappings associated with cpu_addr/handle
- * during and after this call executing are illegal.
- */
- extern void arm_dma_free(struct device *dev, size_t size, void *cpu_addr,
- dma_addr_t handle, struct dma_attrs *attrs);
- #define dma_free_coherent(d, s, c, h) dma_free_attrs(d, s, c, h, NULL)
- static inline void dma_free_attrs(struct device *dev, size_t size,
- void *cpu_addr, dma_addr_t dma_handle,
- struct dma_attrs *attrs)
- {
- struct dma_map_ops *ops = get_dma_ops(dev);
- BUG_ON(!ops);
- debug_dma_free_coherent(dev, size, cpu_addr, dma_handle);
- ops->free(dev, size, cpu_addr, dma_handle, attrs);
- }
- /**
- * arm_dma_mmap - map a coherent DMA allocation into user space
- * @dev: valid struct device pointer, or NULL for ISA and EISA-like devices
- * @vma: vm_area_struct describing requested user mapping
- * @cpu_addr: kernel CPU-view address returned from dma_alloc_coherent
- * @handle: device-view address returned from dma_alloc_coherent
- * @size: size of memory originally requested in dma_alloc_coherent
- * @attrs: optinal attributes that specific mapping properties
- *
- * Map a coherent DMA buffer previously allocated by dma_alloc_coherent
- * into user space. The coherent DMA buffer must not be freed by the
- * driver until the user space mapping has been released.
- */
- extern int arm_dma_mmap(struct device *dev, struct vm_area_struct *vma,
- void *cpu_addr, dma_addr_t dma_addr, size_t size,
- struct dma_attrs *attrs);
- #define dma_mmap_coherent(d, v, c, h, s) dma_mmap_attrs(d, v, c, h, s, NULL)
- static inline int dma_mmap_attrs(struct device *dev, struct vm_area_struct *vma,
- void *cpu_addr, dma_addr_t dma_addr,
- size_t size, struct dma_attrs *attrs)
- {
- struct dma_map_ops *ops = get_dma_ops(dev);
- BUG_ON(!ops);
- return ops->mmap(dev, vma, cpu_addr, dma_addr, size, attrs);
- }
- static inline void *dma_alloc_writecombine(struct device *dev, size_t size,
- dma_addr_t *dma_handle, gfp_t flag)
- {
- DEFINE_DMA_ATTRS(attrs);
- dma_set_attr(DMA_ATTR_WRITE_COMBINE, &attrs);
- return dma_alloc_attrs(dev, size, dma_handle, flag, &attrs);
- }
- static inline void dma_free_writecombine(struct device *dev, size_t size,
- void *cpu_addr, dma_addr_t dma_handle)
- {
- DEFINE_DMA_ATTRS(attrs);
- dma_set_attr(DMA_ATTR_WRITE_COMBINE, &attrs);
- return dma_free_attrs(dev, size, cpu_addr, dma_handle, &attrs);
- }
- static inline int dma_mmap_writecombine(struct device *dev, struct vm_area_struct *vma,
- void *cpu_addr, dma_addr_t dma_addr, size_t size)
- {
- DEFINE_DMA_ATTRS(attrs);
- dma_set_attr(DMA_ATTR_WRITE_COMBINE, &attrs);
- return dma_mmap_attrs(dev, vma, cpu_addr, dma_addr, size, &attrs);
- }
- static inline void *dma_alloc_stronglyordered(struct device *dev, size_t size,
- dma_addr_t *dma_handle, gfp_t flag)
- {
- DEFINE_DMA_ATTRS(attrs);
- dma_set_attr(DMA_ATTR_STRONGLY_ORDERED, &attrs);
- return dma_alloc_attrs(dev, size, dma_handle, flag, &attrs);
- }
- static inline void dma_free_stronglyordered(struct device *dev, size_t size,
- void *cpu_addr, dma_addr_t dma_handle)
- {
- DEFINE_DMA_ATTRS(attrs);
- dma_set_attr(DMA_ATTR_STRONGLY_ORDERED, &attrs);
- return dma_free_attrs(dev, size, cpu_addr, dma_handle, &attrs);
- }
- static inline int dma_mmap_stronglyordered(struct device *dev,
- struct vm_area_struct *vma, void *cpu_addr,
- dma_addr_t dma_addr, size_t size)
- {
- DEFINE_DMA_ATTRS(attrs);
- dma_set_attr(DMA_ATTR_STRONGLY_ORDERED, &attrs);
- return dma_mmap_attrs(dev, vma, cpu_addr, dma_addr, size, &attrs);
- }
- static inline void *dma_alloc_nonconsistent(struct device *dev, size_t size,
- dma_addr_t *dma_handle, gfp_t flag)
- {
- DEFINE_DMA_ATTRS(attrs);
- dma_set_attr(DMA_ATTR_NON_CONSISTENT, &attrs);
- return dma_alloc_attrs(dev, size, dma_handle, flag, &attrs);
- }
- static inline void dma_free_nonconsistent(struct device *dev, size_t size,
- void *cpu_addr, dma_addr_t dma_handle)
- {
- DEFINE_DMA_ATTRS(attrs);
- dma_set_attr(DMA_ATTR_NON_CONSISTENT, &attrs);
- return dma_free_attrs(dev, size, cpu_addr, dma_handle, &attrs);
- }
- static inline int dma_mmap_nonconsistent(struct device *dev,
- struct vm_area_struct *vma, void *cpu_addr,
- dma_addr_t dma_addr, size_t size)
- {
- DEFINE_DMA_ATTRS(attrs);
- dma_set_attr(DMA_ATTR_NON_CONSISTENT, &attrs);
- return dma_mmap_attrs(dev, vma, cpu_addr, dma_addr, size, &attrs);
- }
- /*
- * This can be called during boot to increase the size of the consistent
- * DMA region above it's default value of 2MB. It must be called before the
- * memory allocator is initialised, i.e. before any core_initcall.
- */
- static inline void init_consistent_dma_size(unsigned long size) { }
- /*
- * For SA-1111, IXP425, and ADI systems the dma-mapping functions are "magic"
- * and utilize bounce buffers as needed to work around limited DMA windows.
- *
- * On the SA-1111, a bug limits DMA to only certain regions of RAM.
- * On the IXP425, the PCI inbound window is 64MB (256MB total RAM)
- * On some ADI engineering systems, PCI inbound window is 32MB (12MB total RAM)
- *
- * The following are helper functions used by the dmabounce subystem
- *
- */
- /**
- * dmabounce_register_dev
- *
- * @dev: valid struct device pointer
- * @small_buf_size: size of buffers to use with small buffer pool
- * @large_buf_size: size of buffers to use with large buffer pool (can be 0)
- * @needs_bounce_fn: called to determine whether buffer needs bouncing
- *
- * This function should be called by low-level platform code to register
- * a device as requireing DMA buffer bouncing. The function will allocate
- * appropriate DMA pools for the device.
- */
- extern int dmabounce_register_dev(struct device *, unsigned long,
- unsigned long, int (*)(struct device *, dma_addr_t, size_t));
- /**
- * dmabounce_unregister_dev
- *
- * @dev: valid struct device pointer
- *
- * This function should be called by low-level platform code when device
- * that was previously registered with dmabounce_register_dev is removed
- * from the system.
- *
- */
- extern void dmabounce_unregister_dev(struct device *);
- /**
- * dma_cache_pre_ops - clean or invalidate cache before dma transfer is
- * initiated and perform a barrier operation.
- * @virtual_addr: A kernel logical or kernel virtual address
- * @size: size of buffer to map
- * @dir: DMA transfer direction
- *
- * Ensure that any data held in the cache is appropriately discarded
- * or written back.
- *
- */
- static inline void dma_cache_pre_ops(void *virtual_addr,
- size_t size, enum dma_data_direction dir)
- {
- extern void ___dma_single_cpu_to_dev(const void *, size_t,
- enum dma_data_direction);
- BUG_ON(!valid_dma_direction(dir));
- if (!arch_is_coherent())
- ___dma_single_cpu_to_dev(virtual_addr, size, dir);
- }
- /**
- * dma_cache_post_ops - clean or invalidate cache after dma transfer is
- * initiated and perform a barrier operation.
- * @virtual_addr: A kernel logical or kernel virtual address
- * @size: size of buffer to map
- * @dir: DMA transfer direction
- *
- * Ensure that any data held in the cache is appropriately discarded
- * or written back.
- *
- */
- static inline void dma_cache_post_ops(void *virtual_addr,
- size_t size, enum dma_data_direction dir)
- {
- extern void ___dma_single_cpu_to_dev(const void *, size_t,
- enum dma_data_direction);
- BUG_ON(!valid_dma_direction(dir));
- if (arch_has_speculative_dfetch() && !arch_is_coherent()
- && dir != DMA_TO_DEVICE)
- /*
- * Treat DMA_BIDIRECTIONAL and DMA_FROM_DEVICE
- * identically: invalidate
- */
- ___dma_single_cpu_to_dev(virtual_addr,
- size, DMA_FROM_DEVICE);
- }
- /*
- * The scatter list versions of the above methods.
- */
- extern int arm_dma_map_sg(struct device *, struct scatterlist *, int,
- enum dma_data_direction, struct dma_attrs *attrs);
- extern void arm_dma_unmap_sg(struct device *, struct scatterlist *, int,
- enum dma_data_direction, struct dma_attrs *attrs);
- extern void arm_dma_sync_sg_for_cpu(struct device *, struct scatterlist *, int,
- enum dma_data_direction);
- extern void arm_dma_sync_sg_for_device(struct device *, struct scatterlist *, int,
- enum dma_data_direction);
- #endif /* __KERNEL__ */
- #endif
|