xref: /linux-6.15/include/linux/swiotlb.h (revision d7ef1533)
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 
106959450eSFUJITA Tomonori extern int swiotlb_force;
116959450eSFUJITA Tomonori 
120016fdeeSIan Campbell /*
130016fdeeSIan Campbell  * Maximum allowable number of contiguous slabs to map,
140016fdeeSIan Campbell  * must be a power of 2.  What is the appropriate value ?
150016fdeeSIan Campbell  * The complexity of {map,unmap}_single is linearly dependent on this value.
160016fdeeSIan Campbell  */
170016fdeeSIan Campbell #define IO_TLB_SEGSIZE	128
180016fdeeSIan Campbell 
190016fdeeSIan Campbell /*
200016fdeeSIan Campbell  * log of the size of each IO TLB slab.  The number of slabs is command line
210016fdeeSIan Campbell  * controllable.
220016fdeeSIan Campbell  */
230016fdeeSIan Campbell #define IO_TLB_SHIFT 11
240016fdeeSIan Campbell 
25ad32e8cbSFUJITA Tomonori extern void swiotlb_init(int verbose);
26abbceff7SFUJITA Tomonori extern void swiotlb_init_with_tbl(char *tlb, unsigned long nslabs, int verbose);
271648993fSJoerg Roedel 
28*d7ef1533SKonrad Rzeszutek Wilk /*
29*d7ef1533SKonrad Rzeszutek Wilk  * Enumeration for sync targets
30*d7ef1533SKonrad Rzeszutek Wilk  */
31*d7ef1533SKonrad Rzeszutek Wilk enum dma_sync_target {
32*d7ef1533SKonrad Rzeszutek Wilk 	SYNC_FOR_CPU = 0,
33*d7ef1533SKonrad Rzeszutek Wilk 	SYNC_FOR_DEVICE = 1,
34*d7ef1533SKonrad Rzeszutek Wilk };
35*d7ef1533SKonrad Rzeszutek Wilk extern void *swiotlb_tbl_map_single(struct device *hwdev, dma_addr_t tbl_dma_addr,
36*d7ef1533SKonrad Rzeszutek Wilk 				    phys_addr_t phys, size_t size,
37*d7ef1533SKonrad Rzeszutek Wilk 				    enum dma_data_direction dir);
38*d7ef1533SKonrad Rzeszutek Wilk 
39*d7ef1533SKonrad Rzeszutek Wilk extern void swiotlb_tbl_unmap_single(struct device *hwdev, char *dma_addr,
40*d7ef1533SKonrad Rzeszutek Wilk 				     size_t size, enum dma_data_direction dir);
41*d7ef1533SKonrad Rzeszutek Wilk 
42*d7ef1533SKonrad Rzeszutek Wilk extern void swiotlb_tbl_sync_single(struct device *hwdev, char *dma_addr,
43*d7ef1533SKonrad Rzeszutek Wilk 				    size_t size, enum dma_data_direction dir,
44*d7ef1533SKonrad Rzeszutek Wilk 				    enum dma_sync_target target);
45*d7ef1533SKonrad Rzeszutek Wilk 
46*d7ef1533SKonrad Rzeszutek Wilk /* Accessory functions. */
47*d7ef1533SKonrad Rzeszutek Wilk extern void swiotlb_bounce(phys_addr_t phys, char *dma_addr, size_t size,
48*d7ef1533SKonrad Rzeszutek Wilk 			   enum dma_data_direction dir);
49*d7ef1533SKonrad Rzeszutek Wilk 
501648993fSJoerg Roedel extern void
511648993fSJoerg Roedel *swiotlb_alloc_coherent(struct device *hwdev, size_t size,
521648993fSJoerg Roedel 			dma_addr_t *dma_handle, gfp_t flags);
531648993fSJoerg Roedel 
541648993fSJoerg Roedel extern void
551648993fSJoerg Roedel swiotlb_free_coherent(struct device *hwdev, size_t size,
561648993fSJoerg Roedel 		      void *vaddr, dma_addr_t dma_handle);
571648993fSJoerg Roedel 
58f98eee8eSFUJITA Tomonori extern dma_addr_t swiotlb_map_page(struct device *dev, struct page *page,
59f98eee8eSFUJITA Tomonori 				   unsigned long offset, size_t size,
60f98eee8eSFUJITA Tomonori 				   enum dma_data_direction dir,
61f98eee8eSFUJITA Tomonori 				   struct dma_attrs *attrs);
62f98eee8eSFUJITA Tomonori extern void swiotlb_unmap_page(struct device *hwdev, dma_addr_t dev_addr,
63f98eee8eSFUJITA Tomonori 			       size_t size, enum dma_data_direction dir,
64f98eee8eSFUJITA Tomonori 			       struct dma_attrs *attrs);
651648993fSJoerg Roedel 
661648993fSJoerg Roedel extern int
671648993fSJoerg Roedel swiotlb_map_sg(struct device *hwdev, struct scatterlist *sg, int nents,
6822d48269SKonrad Rzeszutek Wilk 	       enum dma_data_direction dir);
691648993fSJoerg Roedel 
701648993fSJoerg Roedel extern void
711648993fSJoerg Roedel swiotlb_unmap_sg(struct device *hwdev, struct scatterlist *sg, int nents,
7222d48269SKonrad Rzeszutek Wilk 		 enum dma_data_direction dir);
731648993fSJoerg Roedel 
741648993fSJoerg Roedel extern int
751648993fSJoerg Roedel swiotlb_map_sg_attrs(struct device *hwdev, struct scatterlist *sgl, int nelems,
76160c1d8eSFUJITA Tomonori 		     enum dma_data_direction dir, struct dma_attrs *attrs);
771648993fSJoerg Roedel 
781648993fSJoerg Roedel extern void
791648993fSJoerg Roedel swiotlb_unmap_sg_attrs(struct device *hwdev, struct scatterlist *sgl,
80160c1d8eSFUJITA Tomonori 		       int nelems, enum dma_data_direction dir,
81160c1d8eSFUJITA Tomonori 		       struct dma_attrs *attrs);
821648993fSJoerg Roedel 
831648993fSJoerg Roedel extern void
841648993fSJoerg Roedel swiotlb_sync_single_for_cpu(struct device *hwdev, dma_addr_t dev_addr,
85160c1d8eSFUJITA Tomonori 			    size_t size, enum dma_data_direction dir);
861648993fSJoerg Roedel 
871648993fSJoerg Roedel extern void
881648993fSJoerg Roedel swiotlb_sync_sg_for_cpu(struct device *hwdev, struct scatterlist *sg,
89160c1d8eSFUJITA Tomonori 			int nelems, enum dma_data_direction dir);
901648993fSJoerg Roedel 
911648993fSJoerg Roedel extern void
921648993fSJoerg Roedel swiotlb_sync_single_for_device(struct device *hwdev, dma_addr_t dev_addr,
93160c1d8eSFUJITA Tomonori 			       size_t size, enum dma_data_direction dir);
941648993fSJoerg Roedel 
951648993fSJoerg Roedel extern void
961648993fSJoerg Roedel swiotlb_sync_sg_for_device(struct device *hwdev, struct scatterlist *sg,
97160c1d8eSFUJITA Tomonori 			   int nelems, enum dma_data_direction 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 
1055740afdbSFUJITA Tomonori #ifdef CONFIG_SWIOTLB
1065740afdbSFUJITA Tomonori extern void __init swiotlb_free(void);
1075740afdbSFUJITA Tomonori #else
1085740afdbSFUJITA Tomonori static inline void swiotlb_free(void) { }
1095740afdbSFUJITA Tomonori #endif
1105740afdbSFUJITA Tomonori 
111ad32e8cbSFUJITA Tomonori extern void swiotlb_print_info(void);
1121648993fSJoerg Roedel #endif /* __LINUX_SWIOTLB_H */
113