xref: /linux-6.15/include/linux/swiotlb.h (revision b81ea27b)
11648993fSJoerg Roedel #ifndef __LINUX_SWIOTLB_H
21648993fSJoerg Roedel #define __LINUX_SWIOTLB_H
31648993fSJoerg Roedel 
41648993fSJoerg Roedel #include <linux/types.h>
51648993fSJoerg Roedel 
61648993fSJoerg Roedel struct device;
71648993fSJoerg Roedel struct dma_attrs;
81648993fSJoerg Roedel struct scatterlist;
91648993fSJoerg Roedel 
100016fdeeSIan Campbell /*
110016fdeeSIan Campbell  * Maximum allowable number of contiguous slabs to map,
120016fdeeSIan Campbell  * must be a power of 2.  What is the appropriate value ?
130016fdeeSIan Campbell  * The complexity of {map,unmap}_single is linearly dependent on this value.
140016fdeeSIan Campbell  */
150016fdeeSIan Campbell #define IO_TLB_SEGSIZE	128
160016fdeeSIan Campbell 
170016fdeeSIan Campbell 
180016fdeeSIan Campbell /*
190016fdeeSIan Campbell  * log of the size of each IO TLB slab.  The number of slabs is command line
200016fdeeSIan Campbell  * controllable.
210016fdeeSIan Campbell  */
220016fdeeSIan Campbell #define IO_TLB_SHIFT 11
230016fdeeSIan Campbell 
241648993fSJoerg Roedel extern void
251648993fSJoerg Roedel swiotlb_init(void);
261648993fSJoerg Roedel 
278c5df16bSJeremy Fitzhardinge extern void *swiotlb_alloc_boot(size_t bytes, unsigned long nslabs);
288c5df16bSJeremy Fitzhardinge extern void *swiotlb_alloc(unsigned order, unsigned long nslabs);
298c5df16bSJeremy Fitzhardinge 
30e08e1f7aSIan Campbell extern dma_addr_t swiotlb_phys_to_bus(phys_addr_t address);
31e08e1f7aSIan Campbell extern phys_addr_t swiotlb_bus_to_phys(dma_addr_t address);
32e08e1f7aSIan Campbell 
33*b81ea27bSIan Campbell extern int swiotlb_arch_range_needs_mapping(void *ptr, size_t size);
34*b81ea27bSIan Campbell 
351648993fSJoerg Roedel extern void
361648993fSJoerg Roedel *swiotlb_alloc_coherent(struct device *hwdev, size_t size,
371648993fSJoerg Roedel 			dma_addr_t *dma_handle, gfp_t flags);
381648993fSJoerg Roedel 
391648993fSJoerg Roedel extern void
401648993fSJoerg Roedel swiotlb_free_coherent(struct device *hwdev, size_t size,
411648993fSJoerg Roedel 		      void *vaddr, dma_addr_t dma_handle);
421648993fSJoerg Roedel 
431648993fSJoerg Roedel extern dma_addr_t
441648993fSJoerg Roedel swiotlb_map_single(struct device *hwdev, void *ptr, size_t size, int dir);
451648993fSJoerg Roedel 
461648993fSJoerg Roedel extern void
471648993fSJoerg Roedel swiotlb_unmap_single(struct device *hwdev, dma_addr_t dev_addr,
481648993fSJoerg Roedel 		     size_t size, int dir);
491648993fSJoerg Roedel 
501648993fSJoerg Roedel extern dma_addr_t
511648993fSJoerg Roedel swiotlb_map_single_attrs(struct device *hwdev, void *ptr, size_t size,
521648993fSJoerg Roedel 			 int dir, struct dma_attrs *attrs);
531648993fSJoerg Roedel 
541648993fSJoerg Roedel extern void
551648993fSJoerg Roedel swiotlb_unmap_single_attrs(struct device *hwdev, dma_addr_t dev_addr,
561648993fSJoerg Roedel 			   size_t size, int dir, struct dma_attrs *attrs);
571648993fSJoerg Roedel 
581648993fSJoerg Roedel extern int
591648993fSJoerg Roedel swiotlb_map_sg(struct device *hwdev, struct scatterlist *sg, int nents,
601648993fSJoerg Roedel 	       int direction);
611648993fSJoerg Roedel 
621648993fSJoerg Roedel extern void
631648993fSJoerg Roedel swiotlb_unmap_sg(struct device *hwdev, struct scatterlist *sg, int nents,
641648993fSJoerg Roedel 		 int direction);
651648993fSJoerg Roedel 
661648993fSJoerg Roedel extern int
671648993fSJoerg Roedel swiotlb_map_sg_attrs(struct device *hwdev, struct scatterlist *sgl, int nelems,
681648993fSJoerg Roedel 		     int dir, struct dma_attrs *attrs);
691648993fSJoerg Roedel 
701648993fSJoerg Roedel extern void
711648993fSJoerg Roedel swiotlb_unmap_sg_attrs(struct device *hwdev, struct scatterlist *sgl,
721648993fSJoerg Roedel 		       int nelems, int dir, struct dma_attrs *attrs);
731648993fSJoerg Roedel 
741648993fSJoerg Roedel extern void
751648993fSJoerg Roedel swiotlb_sync_single_for_cpu(struct device *hwdev, dma_addr_t dev_addr,
761648993fSJoerg Roedel 			    size_t size, int dir);
771648993fSJoerg Roedel 
781648993fSJoerg Roedel extern void
791648993fSJoerg Roedel swiotlb_sync_sg_for_cpu(struct device *hwdev, struct scatterlist *sg,
801648993fSJoerg Roedel 			int nelems, int dir);
811648993fSJoerg Roedel 
821648993fSJoerg Roedel extern void
831648993fSJoerg Roedel swiotlb_sync_single_for_device(struct device *hwdev, dma_addr_t dev_addr,
841648993fSJoerg Roedel 			       size_t size, int dir);
851648993fSJoerg Roedel 
861648993fSJoerg Roedel extern void
871648993fSJoerg Roedel swiotlb_sync_sg_for_device(struct device *hwdev, struct scatterlist *sg,
881648993fSJoerg Roedel 			   int nelems, int dir);
891648993fSJoerg Roedel 
901648993fSJoerg Roedel extern void
911648993fSJoerg Roedel swiotlb_sync_single_range_for_cpu(struct device *hwdev, dma_addr_t dev_addr,
921648993fSJoerg Roedel 				  unsigned long offset, size_t size, int dir);
931648993fSJoerg Roedel 
941648993fSJoerg Roedel extern void
951648993fSJoerg Roedel swiotlb_sync_single_range_for_device(struct device *hwdev, dma_addr_t dev_addr,
961648993fSJoerg Roedel 				     unsigned long offset, size_t size,
971648993fSJoerg Roedel 				     int dir);
981648993fSJoerg Roedel 
991648993fSJoerg Roedel extern int
1001648993fSJoerg Roedel swiotlb_dma_mapping_error(struct device *hwdev, dma_addr_t dma_addr);
1011648993fSJoerg Roedel 
1021648993fSJoerg Roedel extern int
1031648993fSJoerg Roedel swiotlb_dma_supported(struct device *hwdev, u64 mask);
1041648993fSJoerg Roedel 
1051648993fSJoerg Roedel #endif /* __LINUX_SWIOTLB_H */
106