QR code linking to this page

Manual Pages — RTSX

NAME

rtsx – Realtek SD card reader

CONTENTS

SYNOPSIS
DESCRIPTION
HARDWARE
SEE ALSO
HISTORY
AUTHORS
CONTRIBUTORS
DEBUGGING INFORMATION
BUGS

SYNOPSIS

To compile this driver into the kernel, place the following lines in the kernel configuration file: device mmc device mmcsd device rtsx

Alternatively, to load the driver as a module at boot time, place the following lines in loader.conf(5):

mmc_load="YES"
mmcsd_load="YES"
rtsx_load="YES"

DESCRIPTION

The rtsx driver provides support for Realtek SD card reader. Driver attaches mmc bus on card insertion and detaches it on card removing.

HARDWARE

The rtsx driver supports different specification compatible chips. The following chips have been verified to work:

RTS5209
RTS5227
RTS5229
RTS522A
RTS525A
RTS5260
RTL8411B

It should also work for:

RTS5249
RTL8402
RTL8411

SEE ALSO

mmc(4), mmcsd(4)

SD Specifications, Part 2, SD Host Controller, Simplified Specification, SanDisk Secure Digital Card,

HISTORY

The rtsx driver was ported from OpenBSD with modifications found in Linux and NetBSD

AUTHORS

Henri Hennebert <Mt hlh@restart.be> Gary Jennejohn <Mt gj@freebsd.org> Jesper Schmitz Mouridsen <Mt jsm@FreeBSD.org>

CONTRIBUTORS

Lutz Bichler <Mt Lutz.Bichler@gmail.com>

DEBUGGING INFORMATION

dev.rtsx.0.debug_mask can be set with the following masks:

0x01 - to show the basic flow of the driver,
0x02 - to trace the SD commands,
0x04 - to trace the tuning phase.

BUGS

RTS522A on Lenovo T470p, card detection and read-only switch are reversed. This is solved by adding in loader.conf(5): dev.rtsx.0.inversion=1
The driver tries to automate those exceptions. If this automation is wrong, it can be avoided by adding in loader.conf(5): dev.rtsx.0.inversion=0
Mounting a filesystem with write access on a card write protected may involve a kernel crash.
Suspend/Resume do not work under MMCCAM.
For some chips (e.g. RTS5260) after devctl disable/enable or kldunload/kldload the driver can't detect a card correctly.

April 26, 2022

QR code linking to this page

Copyright: The copyright notice of this manual page is here (plain text).

Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

“	What is this horrible fascination with Unix? The operating system of the 1960s, still gaining in popularity in the 1990s.	”
— Donald A. Norman