xref: /linux-6.15/include/linux/swiotlb.h (revision 0443fa00)
11648993fSJoerg Roedel #ifndef __LINUX_SWIOTLB_H
21648993fSJoerg Roedel #define __LINUX_SWIOTLB_H
31648993fSJoerg Roedel 
438674442SThierry Reding #include <linux/dma-direction.h>
538674442SThierry Reding #include <linux/init.h>
61648993fSJoerg Roedel #include <linux/types.h>
71648993fSJoerg Roedel 
81648993fSJoerg Roedel struct device;
938674442SThierry Reding struct page;
101648993fSJoerg Roedel struct scatterlist;
111648993fSJoerg Roedel 
126959450eSFUJITA Tomonori extern int swiotlb_force;
136959450eSFUJITA Tomonori 
140016fdeeSIan Campbell /*
150016fdeeSIan Campbell  * Maximum allowable number of contiguous slabs to map,
160016fdeeSIan Campbell  * must be a power of 2.  What is the appropriate value ?
170016fdeeSIan Campbell  * The complexity of {map,unmap}_single is linearly dependent on this value.
180016fdeeSIan Campbell  */
190016fdeeSIan Campbell #define IO_TLB_SEGSIZE	128
200016fdeeSIan Campbell 
210016fdeeSIan Campbell /*
220016fdeeSIan Campbell  * log of the size of each IO TLB slab.  The number of slabs is command line
230016fdeeSIan Campbell  * controllable.
240016fdeeSIan Campbell  */
250016fdeeSIan Campbell #define IO_TLB_SHIFT 11
260016fdeeSIan Campbell 
27ad32e8cbSFUJITA Tomonori extern void swiotlb_init(int verbose);
28ac2cbab2SYinghai Lu int swiotlb_init_with_tbl(char *tlb, unsigned long nslabs, int verbose);
29f21ffe9fSKonrad Rzeszutek Wilk extern unsigned long swiotlb_nr_tbl(void);
30c729de8fSYinghai Lu unsigned long swiotlb_size_or_default(void);
3174838b75SKonrad Rzeszutek Wilk extern int swiotlb_late_init_with_tbl(char *tlb, unsigned long nslabs);
321648993fSJoerg Roedel 
33d7ef1533SKonrad Rzeszutek Wilk /*
34d7ef1533SKonrad Rzeszutek Wilk  * Enumeration for sync targets
35d7ef1533SKonrad Rzeszutek Wilk  */
36d7ef1533SKonrad Rzeszutek Wilk enum dma_sync_target {
37d7ef1533SKonrad Rzeszutek Wilk 	SYNC_FOR_CPU = 0,
38d7ef1533SKonrad Rzeszutek Wilk 	SYNC_FOR_DEVICE = 1,
39d7ef1533SKonrad Rzeszutek Wilk };
40e05ed4d1SAlexander Duyck 
41e05ed4d1SAlexander Duyck /* define the last possible byte of physical address space as a mapping error */
42e05ed4d1SAlexander Duyck #define SWIOTLB_MAP_ERROR (~(phys_addr_t)0x0)
43e05ed4d1SAlexander Duyck 
44e05ed4d1SAlexander Duyck extern phys_addr_t swiotlb_tbl_map_single(struct device *hwdev,
45e05ed4d1SAlexander Duyck 					  dma_addr_t tbl_dma_addr,
46d7ef1533SKonrad Rzeszutek Wilk 					  phys_addr_t phys, size_t size,
47*0443fa00SAlexander Duyck 					  enum dma_data_direction dir,
48*0443fa00SAlexander Duyck 					  unsigned long attrs);
49d7ef1533SKonrad Rzeszutek Wilk 
5061ca08c3SAlexander Duyck extern void swiotlb_tbl_unmap_single(struct device *hwdev,
5161ca08c3SAlexander Duyck 				     phys_addr_t tlb_addr,
52*0443fa00SAlexander Duyck 				     size_t size, enum dma_data_direction dir,
53*0443fa00SAlexander Duyck 				     unsigned long attrs);
54d7ef1533SKonrad Rzeszutek Wilk 
55fbfda893SAlexander Duyck extern void swiotlb_tbl_sync_single(struct device *hwdev,
56fbfda893SAlexander Duyck 				    phys_addr_t tlb_addr,
57d7ef1533SKonrad Rzeszutek Wilk 				    size_t size, enum dma_data_direction dir,
58d7ef1533SKonrad Rzeszutek Wilk 				    enum dma_sync_target target);
59d7ef1533SKonrad Rzeszutek Wilk 
60d7ef1533SKonrad Rzeszutek Wilk /* Accessory functions. */
611648993fSJoerg Roedel extern void
621648993fSJoerg Roedel *swiotlb_alloc_coherent(struct device *hwdev, size_t size,
631648993fSJoerg Roedel 			dma_addr_t *dma_handle, gfp_t flags);
641648993fSJoerg Roedel 
651648993fSJoerg Roedel extern void
661648993fSJoerg Roedel swiotlb_free_coherent(struct device *hwdev, size_t size,
671648993fSJoerg Roedel 		      void *vaddr, dma_addr_t dma_handle);
681648993fSJoerg Roedel 
69f98eee8eSFUJITA Tomonori extern dma_addr_t swiotlb_map_page(struct device *dev, struct page *page,
70f98eee8eSFUJITA Tomonori 				   unsigned long offset, size_t size,
71f98eee8eSFUJITA Tomonori 				   enum dma_data_direction dir,
7200085f1eSKrzysztof Kozlowski 				   unsigned long attrs);
73f98eee8eSFUJITA Tomonori extern void swiotlb_unmap_page(struct device *hwdev, dma_addr_t dev_addr,
74f98eee8eSFUJITA Tomonori 			       size_t size, enum dma_data_direction dir,
7500085f1eSKrzysztof Kozlowski 			       unsigned long attrs);
761648993fSJoerg Roedel 
771648993fSJoerg Roedel extern int
781648993fSJoerg Roedel swiotlb_map_sg_attrs(struct device *hwdev, struct scatterlist *sgl, int nelems,
7900085f1eSKrzysztof Kozlowski 		     enum dma_data_direction dir,
8000085f1eSKrzysztof Kozlowski 		     unsigned long attrs);
811648993fSJoerg Roedel 
821648993fSJoerg Roedel extern void
831648993fSJoerg Roedel swiotlb_unmap_sg_attrs(struct device *hwdev, struct scatterlist *sgl,
84160c1d8eSFUJITA Tomonori 		       int nelems, enum dma_data_direction dir,
8500085f1eSKrzysztof Kozlowski 		       unsigned long attrs);
861648993fSJoerg Roedel 
871648993fSJoerg Roedel extern void
881648993fSJoerg Roedel swiotlb_sync_single_for_cpu(struct device *hwdev, dma_addr_t dev_addr,
89160c1d8eSFUJITA Tomonori 			    size_t size, enum dma_data_direction dir);
901648993fSJoerg Roedel 
911648993fSJoerg Roedel extern void
921648993fSJoerg Roedel swiotlb_sync_sg_for_cpu(struct device *hwdev, struct scatterlist *sg,
93160c1d8eSFUJITA Tomonori 			int nelems, enum dma_data_direction dir);
941648993fSJoerg Roedel 
951648993fSJoerg Roedel extern void
961648993fSJoerg Roedel swiotlb_sync_single_for_device(struct device *hwdev, dma_addr_t dev_addr,
97160c1d8eSFUJITA Tomonori 			       size_t size, enum dma_data_direction dir);
981648993fSJoerg Roedel 
991648993fSJoerg Roedel extern void
1001648993fSJoerg Roedel swiotlb_sync_sg_for_device(struct device *hwdev, struct scatterlist *sg,
101160c1d8eSFUJITA Tomonori 			   int nelems, enum dma_data_direction dir);
1021648993fSJoerg Roedel 
1031648993fSJoerg Roedel extern int
1041648993fSJoerg Roedel swiotlb_dma_mapping_error(struct device *hwdev, dma_addr_t dma_addr);
1051648993fSJoerg Roedel 
1061648993fSJoerg Roedel extern int
1071648993fSJoerg Roedel swiotlb_dma_supported(struct device *hwdev, u64 mask);
1081648993fSJoerg Roedel 
1095740afdbSFUJITA Tomonori #ifdef CONFIG_SWIOTLB
1105740afdbSFUJITA Tomonori extern void __init swiotlb_free(void);
1115740afdbSFUJITA Tomonori #else
1125740afdbSFUJITA Tomonori static inline void swiotlb_free(void) { }
1135740afdbSFUJITA Tomonori #endif
1145740afdbSFUJITA Tomonori 
115ad32e8cbSFUJITA Tomonori extern void swiotlb_print_info(void);
1169c5a3621SAkinobu Mita extern int is_swiotlb_buffer(phys_addr_t paddr);
1179c5a3621SAkinobu Mita 
1181648993fSJoerg Roedel #endif /* __LINUX_SWIOTLB_H */
119