summaryrefslogtreecommitdiff
path: root/static/freebsd/man4/rtsx.4 3.html
diff options
context:
space:
mode:
Diffstat (limited to 'static/freebsd/man4/rtsx.4 3.html')
-rw-r--r--static/freebsd/man4/rtsx.4 3.html125
1 files changed, 125 insertions, 0 deletions
diff --git a/static/freebsd/man4/rtsx.4 3.html b/static/freebsd/man4/rtsx.4 3.html
new file mode 100644
index 00000000..37a6ef48
--- /dev/null
+++ b/static/freebsd/man4/rtsx.4 3.html
@@ -0,0 +1,125 @@
+<table class="head">
+ <tr>
+ <td class="head-ltitle">RTSX(4)</td>
+ <td class="head-vol">Device Drivers Manual</td>
+ <td class="head-rtitle">RTSX(4)</td>
+ </tr>
+</table>
+<div class="manual-text">
+<section class="Sh">
+<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
+<p class="Pp"><code class="Nm">rtsx</code> &#x2014; <span class="Nd">Realtek SD
+ card reader</span></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
+<p class="Pp">To compile this driver into the kernel, place the following lines
+ in the kernel configuration file:</p>
+<div class="Bd Pp Bd-indent"><code class="Cd">device mmc</code>
+<br/>
+<code class="Cd">device mmcsd</code>
+<br/>
+<code class="Cd">device rtsx</code></div>
+<p class="Pp">Alternatively, to load the driver as a module at boot time, place
+ the following lines in <a class="Xr">loader.conf(5)</a>:</p>
+<div class="Bd Pp Bd-indent Li">
+<pre><code class="Cd">mmc_load=&quot;YES&quot;</code>
+<br/>
+<code class="Cd">mmcsd_load=&quot;YES&quot;</code>
+<br/>
+<code class="Cd">rtsx_load=&quot;YES&quot;</code></pre>
+</div>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
+<p class="Pp">The <code class="Nm">rtsx</code> driver provides support for
+ Realtek SD card reader. Driver attaches mmc bus on card insertion and
+ detaches it on card removing.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HARDWARE"><a class="permalink" href="#HARDWARE">HARDWARE</a></h1>
+<p class="Pp">The <code class="Nm">rtsx</code> driver supports the following
+ Realtek SD card readers:</p>
+<p class="Pp"></p>
+<ul class="Bl-bullet Bl-compact">
+ <li>RTS5209</li>
+ <li>RTS5227</li>
+ <li>RTS5229</li>
+ <li>RTS522A</li>
+ <li>RTS525A</li>
+ <li>RTS5260</li>
+ <li>RTL8411B</li>
+ <li>RTS5249 (unverified)</li>
+ <li>RTL8402 (unverified)</li>
+ <li>RTL8411 (unverified)</li>
+</ul>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
+ ALSO</a></h1>
+<p class="Pp"><a class="Xr">mmc(4)</a>, <a class="Xr">mmcsd(4)</a></p>
+<p class="Pp"><cite class="Rs"><span class="RsT">SD Specifications, Part 2, SD
+ Host Controller, Simplified Specification</span>, <span class="RsT">SanDisk
+ Secure Digital Card</span>.</cite></p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
+<p class="Pp">The <code class="Nm">rtsx</code> driver appeared in
+ <span class="Ux">FreeBSD 13.0</span> and was ported from
+ <span class="Ux">OpenBSD</span> with modifications found in Linux and
+ <span class="Ux">NetBSD</span>.</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1>
+<p class="Pp"><span class="An">Henri Hennebert</span>
+ &lt;<a class="Mt" href="mailto:hlh@restart.be">hlh@restart.be</a>&gt;
+ <br/>
+ <span class="An">Gary Jennejohn</span>
+ &lt;<a class="Mt" href="mailto:gj@freebsd.org">gj@freebsd.org</a>&gt;
+ <br/>
+ <span class="An">Jesper Schmitz Mouridsen</span>
+ &lt;<a class="Mt" href="mailto:jsm@FreeBSD.org">jsm@FreeBSD.org</a>&gt;</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="CONTRIBUTORS"><a class="permalink" href="#CONTRIBUTORS">CONTRIBUTORS</a></h1>
+<br/>
+<p class="Pp"><span class="An">Lutz Bichler</span>
+ &lt;<a class="Mt" href="mailto:Lutz.Bichler@gmail.com">Lutz.Bichler@gmail.com</a>&gt;</p>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="DEBUGGING_INFORMATION"><a class="permalink" href="#DEBUGGING_INFORMATION">DEBUGGING
+ INFORMATION</a></h1>
+<p class="Pp"><a class="permalink" href="#dev.rtsx.0.debug_mask"><i class="Em" id="dev.rtsx.0.debug_mask">dev.rtsx.0.debug_mask</i></a>
+ can be set with the following masks:</p>
+<ul class="Bl-bullet">
+ <li>0x01 - to show the basic flow of the driver,</li>
+ <li>0x02 - to trace the SD commands,</li>
+ <li>0x04 - to trace the tuning phase.</li>
+</ul>
+</section>
+<section class="Sh">
+<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1>
+<ul class="Bl-bullet">
+ <li>RTS522A on Lenovo T470p, card detection and read-only switch are reversed.
+ This is solved by adding in <i class="Em">loader.conf(5)</i>:
+ <div class="Bd Pp"><code class="Cd">dev.rtsx.0.inversion=1</code></div>
+ <p class="Pp">The driver tries to automate those exceptions. If this
+ automation is wrong, it can be avoided by adding in
+ <i class="Em">loader.conf(5)</i>:</p>
+ <div class="Bd Pp"><code class="Cd">dev.rtsx.0.inversion=0</code></div>
+ </li>
+ <li>Mounting a filesystem with write access on a card write protected may
+ involve a kernel crash.</li>
+ <li>Suspend/Resume do not work under MMCCAM.</li>
+ <li>For some chips (e.g. RTS5260) after <code class="Cd">devctl
+ disable/enable</code> or <code class="Cd">kldunload/kldload</code> the
+ driver can't detect a card correctly.</li>
+</ul>
+</section>
+</div>
+<table class="foot">
+ <tr>
+ <td class="foot-date">May 26, 2025</td>
+ <td class="foot-os">FreeBSD 15.0</td>
+ </tr>
+</table>