1SDHC API Test
2##################
3
4This test is designed to verify the functionality of a device implementing the
5SD host controller API. It requires that an SD card be present on the SD bus
6to pass. The test has the following phases:
7
8* Reset test: Verify the SDHC can successfully reset the host controller state.
9  This primarily tests that the driver returns zero for this call, although if
10  the reset left the SDHC in a bad state subsequent tests may fail.
11
12* Host props: Get host properties structure from SDHC. This verifies that
13  the API returns a valid host property structure (at a minimum, the driver
14  must initialize all fields of the structure to zero.)
15
16* Set_IO test: Verify that the SDHC will reject clock frequencies outside of
17  the frequency range it claims to support via sdhc_get_host_props.
18
19* Card presence test. Verify that the SDHC detects card presence.
20
21* Request test: Make a request to read the card interface condition,
22  and verify that valid data is returned.
23
24Note that this test does not verify the tuning or card busy api, as the SD
25specification is state based, and testing these portions of the SDHC would
26require implementing a large portion of the SD subsystem in this test.
27