2 .\" Copyright (c) 2020 Henri Hennebert <hlh@restart.be>
3 .\" All rights reserved.
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that the following conditions
8 .\" 1. Redistributions of source code must retain the above copyright
9 .\" notice, this list of conditions and the following disclaimer.
10 .\" 2. The name of the author may not be used to endorse or promote products
11 .\" derived from this software without specific prior written permission.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .Nd Realtek SD card reader
34 To compile this driver into the kernel, place the following
35 lines in the kernel configuration file:
36 .Bd -ragged -offset indent
42 Alternatively, to load the driver as a module at boot time,
43 place the following lines in
45 .Bd -literal -offset indent
53 driver provides support for Realtek SD card reader.
54 Driver attaches mmc bus on card insertion and detaches it on card removing.
58 driver supports different specification compatible chips.
59 The following chips have been verified to work:
78 It should also work for:
92 .%T "SD Specifications, Part 2, SD Host Controller, Simplified Specification"
93 .%T "SanDisk Secure Digital Card"
98 driver was ported from
100 with modifications found in Linux and
103 .An Henri Hennebert Aq Mt hlh@restart.be
104 .An Gary Jennejohn Aq Mt gj@freebsd.org
105 .An Jesper Schmitz Mouridsen Aq Mt jsm@FreeBSD.org
107 .An Lutz Bichler Aq Mt Lutz.Bichler@gmail.com
108 .Sh DEBUGGING INFORMATION
109 .Em dev.rtsx.0.debug_mask
110 can be set with the following masks:
113 0x01 - to show the basic flow of the driver,
115 0x02 - to trace the SD commands,
117 0x04 - to trace the tuning phase.
122 RTS522A on Lenovo T470p, card detection and read-only switch are reversed.
123 This is solved by adding in
126 .Cd dev.rtsx.0.inversion=1
129 The driver tries to automate those exceptions.
130 If this automation is wrong, it can be avoided by adding in
133 .Cd dev.rtsx.0.inversion=0
136 Mounting a filesystem with write access on a card write protected may involve a kernel crash.
138 Suspend/Resume do not work under MMCCAM.
140 For some chips (e.g. RTS5260) after
141 .Cd devctl disable/enable
143 .Cd kldunload/kldload
144 the driver can't detect a card correctly.