Prepare v2023.10
[platform/kernel/u-boot.git] / drivers / mmc / mmc_private.h
1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3  * Copyright 2008,2010 Freescale Semiconductor, Inc
4  * Copyright 2020 NXP
5  * Andy Fleming
6  *
7  * Based (loosely) on the Linux code
8  */
9
10 #ifndef _MMC_PRIVATE_H_
11 #define _MMC_PRIVATE_H_
12
13 #include <mmc.h>
14
15 int mmc_send_status(struct mmc *mmc, unsigned int *status);
16 int mmc_poll_for_busy(struct mmc *mmc, int timeout);
17
18 int mmc_set_blocklen(struct mmc *mmc, int len);
19
20 #if CONFIG_IS_ENABLED(BLK)
21 ulong mmc_bread(struct udevice *dev, lbaint_t start, lbaint_t blkcnt,
22                 void *dst);
23 #else
24 ulong mmc_bread(struct blk_desc *block_dev, lbaint_t start, lbaint_t blkcnt,
25                 void *dst);
26 #endif
27
28 #if CONFIG_IS_ENABLED(MMC_WRITE)
29
30 #if CONFIG_IS_ENABLED(BLK)
31 ulong mmc_bwrite(struct udevice *dev, lbaint_t start, lbaint_t blkcnt,
32                  const void *src);
33 ulong mmc_berase(struct udevice *dev, lbaint_t start, lbaint_t blkcnt);
34 #else
35 ulong mmc_bwrite(struct blk_desc *block_dev, lbaint_t start, lbaint_t blkcnt,
36                  const void *src);
37 ulong mmc_berase(struct blk_desc *block_dev, lbaint_t start, lbaint_t blkcnt);
38 #endif
39
40 #else /* CONFIG_SPL_MMC_WRITE is not defined */
41
42 /* declare dummies to reduce code size. */
43
44 #if CONFIG_IS_ENABLED(BLK)
45 static inline unsigned long mmc_berase(struct udevice *dev,
46                                        lbaint_t start, lbaint_t blkcnt)
47 {
48         return 0;
49 }
50
51 static inline ulong mmc_bwrite(struct udevice *dev, lbaint_t start,
52                                lbaint_t blkcnt, const void *src)
53 {
54         return 0;
55 }
56 #else
57 static inline unsigned long mmc_berase(struct blk_desc *block_dev,
58                                        lbaint_t start, lbaint_t blkcnt)
59 {
60         return 0;
61 }
62
63 static inline ulong mmc_bwrite(struct blk_desc *block_dev, lbaint_t start,
64                                lbaint_t blkcnt, const void *src)
65 {
66         return 0;
67 }
68 #endif
69
70 #endif /* CONFIG_SPL_BUILD */
71
72 #ifdef CONFIG_MMC_TRACE
73 void mmmc_trace_before_send(struct mmc *mmc, struct mmc_cmd *cmd);
74 void mmmc_trace_after_send(struct mmc *mmc, struct mmc_cmd *cmd, int ret);
75 void mmc_trace_state(struct mmc *mmc, struct mmc_cmd *cmd);
76 #else
77 static inline void mmmc_trace_before_send(struct mmc *mmc, struct mmc_cmd *cmd)
78 {
79 }
80
81 static inline void mmmc_trace_after_send(struct mmc *mmc, struct mmc_cmd *cmd,
82                                          int ret)
83 {
84 }
85
86 static inline void mmc_trace_state(struct mmc *mmc, struct mmc_cmd *cmd)
87 {
88 }
89 #endif
90
91 /**
92  * mmc_get_next_devnum() - Get the next available MMC device number
93  *
94  * Return: next available device number (0 = first), or -ve on error
95  */
96 int mmc_get_next_devnum(void);
97
98 /**
99  * mmc_do_preinit() - Get an MMC device ready for use
100  */
101 void mmc_do_preinit(void);
102
103 /**
104  * mmc_list_init() - Set up the list of MMC devices
105  */
106 void mmc_list_init(void);
107
108 /**
109  * mmc_list_add() - Add a new MMC device to the list of devices
110  *
111  * @mmc:        Device to add
112  */
113 void mmc_list_add(struct mmc *mmc);
114
115 /**
116  * mmc_switch_part() - Switch to a new MMC hardware partition
117  *
118  * @mmc:        MMC device
119  * @part_num:   Hardware partition number
120  * Return: 0 if OK, -ve on error
121  */
122 int mmc_switch_part(struct mmc *mmc, unsigned int part_num);
123
124 /**
125  * mmc_switch() - Issue and MMC switch mode command
126  *
127  * @mmc:        MMC device
128  * @set:        Unused
129  * @index:      Cmdarg index
130  * @value:      Cmdarg value
131  * Return: 0 if OK, -ve on error
132  */
133 int mmc_switch(struct mmc *mmc, u8 set, u8 index, u8 value);
134
135 #endif /* _MMC_PRIVATE_H_ */