Skip to contentSkip to conversation

virtio-sdhci: add the device specification

PATCH New Mikhail Krasheninnikov 1 participant 1 message Jul 15, 2024

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 virtio-sdhci: add the device specification

virtio-sdhci is a virtual SDHCI (Secure Digital Host Controller Interface) device. It allows the guest to work with virtualized SD/MMC cards.

This patch adds the specification for virtio-sdhci.

---
 conformance.tex                           |  12 +-
 content.tex                               |   3 +
 device-types/sdhci/description.tex        | 216 ++++++++++++++++++++++
 device-types/sdhci/device-conformance.tex |   8 +
 device-types/sdhci/driver-conformance.tex |   8 +
 5 files changed, 243 insertions(+), 4 deletions(-)
 create mode 100644 device-types/sdhci/description.tex
 create mode 100644 device-types/sdhci/device-conformance.tex
 create mode 100644 device-types/sdhci/driver-conformance.tex
conformance.tex +8 -4
index 183c059..a268dda 100644
@@ -34,8 +34,9 @@ \section{Conformance Targets}\label{sec:Conformance / Conformance Targets}
 \ref{sec:Conformance / Driver Conformance / SCMI Driver Conformance},
 \ref{sec:Conformance / Driver Conformance / GPIO Driver Conformance},
 \ref{sec:Conformance / Driver Conformance / PMEM Driver Conformance},
-\ref{sec:Conformance / Driver Conformance / CAN Driver Conformance} or
-\ref{sec:Conformance / Driver Conformance / SPI Controller Driver Conformance}.
+\ref{sec:Conformance / Driver Conformance / CAN Driver Conformance},
+\ref{sec:Conformance / Driver Conformance / SPI Controller Driver Conformance} or
+\ref{sec:Conformance / Driver Conformance / SDHCI Driver Conformance}.
 
     \item Clause \ref{sec:Conformance / Legacy Interface: Transitional Device and Transitional Driver Conformance}.
   \end{itemize}
@@ -63,8 +64,9 @@ \section{Conformance Targets}\label{sec:Conformance / Conformance Targets}
 \ref{sec:Conformance / Device Conformance / SCMI Device Conformance},
 \ref{sec:Conformance / Device Conformance / GPIO Device Conformance},
 \ref{sec:Conformance / Device Conformance / PMEM Device Conformance},
-\ref{sec:Conformance / Device Conformance / CAN Device Conformance} or
-\ref{sec:Conformance / Device Conformance / SPI Controller Device Conformance}.
+\ref{sec:Conformance / Device Conformance / CAN Device Conformance},
+\ref{sec:Conformance / Device Conformance / SPI Controller Device Conformance} or
+\ref{sec:Conformance / Device Conformance / SDHCI Driver Conformance}.
 
     \item Clause \ref{sec:Conformance / Legacy Interface: Transitional Device and Transitional Driver Conformance}.
   \end{itemize}
@@ -159,6 +161,7 @@ \section{Conformance Targets}\label{sec:Conformance / Conformance Targets}
 \input{device-types/pmem/driver-conformance.tex}
 \input{device-types/can/driver-conformance.tex}
 \input{device-types/spi/driver-conformance.tex}
+\input{device-types/sdhci/driver-conformance.tex}
 
 \conformance{\section}{Device Conformance}\label{sec:Conformance / Device Conformance}
 
@@ -248,6 +251,7 @@ \section{Conformance Targets}\label{sec:Conformance / Conformance Targets}
 \input{device-types/pmem/device-conformance.tex}
 \input{device-types/can/device-conformance.tex}
 \input{device-types/spi/device-conformance.tex}
+\input{device-types/sdhci/device-conformance.tex}
 
 \conformance{\section}{Legacy Interface: Transitional Device and Transitional Driver Conformance}\label{sec:Conformance / Legacy Interface: Transitional Device and Transitional Driver Conformance}
 A conformant implementation MUST be either transitional or
content.tex +3 -0
index d7d544e..56d5c0c 100644
@@ -743,6 +743,8 @@ \chapter{Device Types}\label{sec:Device Types}
 \hline
 47         &   CPU balloon device \\
 \hline
+48         &   SDHCI device \\
+\hline
 \end{longtable}
 
 Some of the devices above are unspecified by this document,
@@ -773,6 +775,7 @@ \chapter{Device Types}\label{sec:Device Types}
 \input{device-types/pmem/description.tex}
 \input{device-types/can/description.tex}
 \input{device-types/spi/description.tex}
+\input{device-types/sdhci/description.tex}
 
 \chapter{Reserved Feature Bits}\label{sec:Reserved Feature Bits}
 
device-types/sdhci/description.tex new file +216 -0

217 lines not on this page · raw message

device-types/sdhci/device-conformance.tex new file +8 -0
new file mode 100644
index 0000000..cc12806
@@ -0,0 +1,8 @@
+\conformance{\subsection}{SDHCI Device Conformance}\label{sec:Conformance / Device Conformance / SDHCI Device Conformance}
+
+A SDHCI device MUST conform to the following normative statements:
+
+\begin{itemize}
+\item \ref{devicenormative:Device Types / SDHCI Device / Device Initialization}
+\item \ref{devicenormative:Device Types / SDHCI Device / Device Operation}
+\end{itemize}
device-types/sdhci/driver-conformance.tex new file +8 -0
new file mode 100644
index 0000000..47cd855
@@ -0,0 +1,8 @@
+\conformance{\subsection}{SDHCI Driver Conformance}\label{sec:Conformance / Driver Conformance / SDHCI Driver Conformance}
+
+A SDHCI driver MUST conform to the following normative statements:
+
+\begin{itemize}
+\item \ref{drivernormative:Device Types / SDHCI Device / Device Initialization}
+\item \ref{drivernormative:Device Types / SDHCI Device / Device Operation}
+\end{itemize}
Signature · 1 line
2.39.3 (Apple Git-146)