1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 3 * 4 * Copyright (c) 2006 Bernd Walter. All rights reserved. 5 * Copyright (c) 2006 M. Warner Losh. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 1. Redistributions of source code must retain the above copyright 11 * notice, this list of conditions and the following disclaimer. 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 17 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 18 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 19 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 21 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 22 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 23 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 25 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 26 * 27 * Portions of this software may have been developed with reference to 28 * the SD Simplified Specification. The following disclaimer may apply: 29 * 30 * The following conditions apply to the release of the simplified 31 * specification ("Simplified Specification") by the SD Card Association and 32 * the SD Group. The Simplified Specification is a subset of the complete SD 33 * Specification which is owned by the SD Card Association and the SD 34 * Group. This Simplified Specification is provided on a non-confidential 35 * basis subject to the disclaimers below. Any implementation of the 36 * Simplified Specification may require a license from the SD Card 37 * Association, SD Group, SD-3C LLC or other third parties. 38 * 39 * Disclaimers: 40 * 41 * The information contained in the Simplified Specification is presented only 42 * as a standard specification for SD Cards and SD Host/Ancillary products and 43 * is provided "AS-IS" without any representations or warranties of any 44 * kind. No responsibility is assumed by the SD Group, SD-3C LLC or the SD 45 * Card Association for any damages, any infringements of patents or other 46 * right of the SD Group, SD-3C LLC, the SD Card Association or any third 47 * parties, which may result from its use. No license is granted by 48 * implication, estoppel or otherwise under any patent or other rights of the 49 * SD Group, SD-3C LLC, the SD Card Association or any third party. Nothing 50 * herein shall be construed as an obligation by the SD Group, the SD-3C LLC 51 * or the SD Card Association to disclose or distribute any technical 52 * information, know-how or other confidential information to any third party. 53 * 54 * $FreeBSD$ 55 */ 56 57 #ifndef DEV_MMC_MMCBRVAR_H 58 #define DEV_MMC_MMCBRVAR_H 59 60 #include <dev/mmc/mmcreg.h> 61 62 #include "mmcbr_if.h" 63 64 enum mmcbr_device_ivars { 65 MMCBR_IVAR_BUS_MODE, 66 MMCBR_IVAR_BUS_WIDTH, 67 MMCBR_IVAR_CHIP_SELECT, 68 MMCBR_IVAR_CLOCK, 69 MMCBR_IVAR_F_MIN, 70 MMCBR_IVAR_F_MAX, 71 MMCBR_IVAR_HOST_OCR, 72 MMCBR_IVAR_MODE, 73 MMCBR_IVAR_OCR, 74 MMCBR_IVAR_POWER_MODE, 75 MMCBR_IVAR_RETUNE_REQ, 76 MMCBR_IVAR_VDD, 77 MMCBR_IVAR_VCCQ, 78 MMCBR_IVAR_CAPS, 79 MMCBR_IVAR_TIMING, 80 MMCBR_IVAR_MAX_DATA, 81 MMCBR_IVAR_MAX_BUSY_TIMEOUT 82 }; 83 84 /* 85 * Simplified accessors for bridge devices 86 */ 87 #define MMCBR_ACCESSOR(var, ivar, type) \ 88 __BUS_ACCESSOR(mmcbr, var, MMCBR, ivar, type) 89 90 MMCBR_ACCESSOR(bus_mode, BUS_MODE, int) 91 MMCBR_ACCESSOR(bus_width, BUS_WIDTH, int) 92 MMCBR_ACCESSOR(chip_select, CHIP_SELECT, int) 93 MMCBR_ACCESSOR(clock, CLOCK, int) 94 MMCBR_ACCESSOR(f_max, F_MAX, int) 95 MMCBR_ACCESSOR(f_min, F_MIN, int) 96 MMCBR_ACCESSOR(host_ocr, HOST_OCR, int) 97 MMCBR_ACCESSOR(mode, MODE, int) 98 MMCBR_ACCESSOR(ocr, OCR, int) 99 MMCBR_ACCESSOR(power_mode, POWER_MODE, int) 100 MMCBR_ACCESSOR(vdd, VDD, int) 101 MMCBR_ACCESSOR(vccq, VCCQ, int) 102 MMCBR_ACCESSOR(caps, CAPS, int) 103 MMCBR_ACCESSOR(timing, TIMING, int) 104 MMCBR_ACCESSOR(max_data, MAX_DATA, int) 105 MMCBR_ACCESSOR(max_busy_timeout, MAX_BUSY_TIMEOUT, u_int) 106 107 static int __inline 108 mmcbr_get_retune_req(device_t dev) 109 { 110 uintptr_t v; 111 112 if (__predict_false(BUS_READ_IVAR(device_get_parent(dev), dev, 113 MMCBR_IVAR_RETUNE_REQ, &v) != 0)) 114 return (retune_req_none); 115 return ((int)v); 116 } 117 118 /* 119 * Convenience wrappers for the mmcbr interface 120 */ 121 static int __inline 122 mmcbr_update_ios(device_t dev) 123 { 124 125 return (MMCBR_UPDATE_IOS(device_get_parent(dev), dev)); 126 } 127 128 static int __inline 129 mmcbr_tune(device_t dev, bool hs400) 130 { 131 132 return (MMCBR_TUNE(device_get_parent(dev), dev, hs400)); 133 } 134 135 static int __inline 136 mmcbr_retune(device_t dev, bool reset) 137 { 138 139 return (MMCBR_RETUNE(device_get_parent(dev), dev, reset)); 140 } 141 142 static int __inline 143 mmcbr_switch_vccq(device_t dev) 144 { 145 146 return (MMCBR_SWITCH_VCCQ(device_get_parent(dev), dev)); 147 } 148 149 static int __inline 150 mmcbr_get_ro(device_t dev) 151 { 152 153 return (MMCBR_GET_RO(device_get_parent(dev), dev)); 154 } 155 156 #endif /* DEV_MMC_MMCBRVAR_H */ 157