4 * Copyright (c) 2014 John Snow <jsnow@redhat.com>
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
25 #include "qemu/osdep.h"
29 #include "libqos/libqos-pc.h"
30 #include "libqos/ahci.h"
31 #include "libqos/pci-pc.h"
33 #include "qapi/qmp/qdict.h"
34 #include "qemu/host-utils.h"
36 #include "hw/pci/pci_ids.h"
37 #include "hw/pci/pci_regs.h"
39 /* Test images sizes in MB */
40 #define TEST_IMAGE_SIZE_MB_LARGE (200 * 1024)
41 #define TEST_IMAGE_SIZE_MB_SMALL 64
44 static char *tmp_path
;
45 static char *debug_path
;
46 static char *mig_socket
;
47 static bool ahci_pedantic
;
48 static const char *imgfmt
;
49 static unsigned test_image_size_mb
;
51 /*** Function Declarations ***/
52 static void ahci_test_port_spec(AHCIQState
*ahci
, uint8_t port
);
53 static void ahci_test_pci_spec(AHCIQState
*ahci
);
54 static void ahci_test_pci_caps(AHCIQState
*ahci
, uint16_t header
,
56 static void ahci_test_satacap(AHCIQState
*ahci
, uint8_t offset
);
57 static void ahci_test_msicap(AHCIQState
*ahci
, uint8_t offset
);
58 static void ahci_test_pmcap(AHCIQState
*ahci
, uint8_t offset
);
62 static uint64_t mb_to_sectors(uint64_t image_size_mb
)
64 return (image_size_mb
* 1024 * 1024) / AHCI_SECTOR_SIZE
;
67 static void string_bswap16(uint16_t *s
, size_t bytes
)
69 g_assert_cmphex((bytes
& 1), ==, 0);
79 * Verify that the transfer did not corrupt our state at all.
81 static void verify_state(AHCIQState
*ahci
, uint64_t hba_old
)
84 uint32_t ahci_fingerprint
;
86 AHCICommandHeader cmd
;
88 ahci_fingerprint
= qpci_config_readl(ahci
->dev
, PCI_VENDOR_ID
);
89 g_assert_cmphex(ahci_fingerprint
, ==, ahci
->fingerprint
);
91 /* If we haven't initialized, this is as much as can be validated. */
96 hba_base
= (uint64_t)qpci_config_readl(ahci
->dev
, PCI_BASE_ADDRESS_5
);
97 g_assert_cmphex(hba_base
, ==, hba_old
);
99 g_assert_cmphex(ahci_rreg(ahci
, AHCI_CAP
), ==, ahci
->cap
);
100 g_assert_cmphex(ahci_rreg(ahci
, AHCI_CAP2
), ==, ahci
->cap2
);
102 for (i
= 0; i
< 32; i
++) {
103 g_assert_cmphex(ahci_px_rreg(ahci
, i
, AHCI_PX_FB
), ==,
105 g_assert_cmphex(ahci_px_rreg(ahci
, i
, AHCI_PX_CLB
), ==,
107 for (j
= 0; j
< 32; j
++) {
108 ahci_get_command_header(ahci
, i
, j
, &cmd
);
109 g_assert_cmphex(cmd
.prdtl
, ==, ahci
->port
[i
].prdtl
[j
]);
110 g_assert_cmphex(cmd
.ctba
, ==, ahci
->port
[i
].ctba
[j
]);
115 static void ahci_migrate(AHCIQState
*from
, AHCIQState
*to
, const char *uri
)
117 QOSState
*tmp
= to
->parent
;
118 QPCIDevice
*dev
= to
->dev
;
119 char *uri_local
= NULL
;
123 uri_local
= g_strdup_printf("%s%s", "unix:", mig_socket
);
127 hba_old
= (uint64_t)qpci_config_readl(from
->dev
, PCI_BASE_ADDRESS_5
);
129 /* context will be 'to' after completion. */
130 migrate(from
->parent
, to
->parent
, uri
);
132 /* We'd like for the AHCIState objects to still point
133 * to information specific to its specific parent
134 * instance, but otherwise just inherit the new data. */
135 memcpy(to
, from
, sizeof(AHCIQState
));
141 memset(from
, 0x00, sizeof(AHCIQState
));
145 verify_state(to
, hba_old
);
149 /*** Test Setup & Teardown ***/
152 * Start a Q35 machine and bookmark a handle to the AHCI device.
155 static AHCIQState
*ahci_vboot(const char *cli
, va_list ap
)
159 s
= g_new0(AHCIQState
, 1);
160 s
->parent
= qtest_pc_vboot(cli
, ap
);
161 alloc_set_flags(&s
->parent
->alloc
, ALLOC_LEAK_ASSERT
);
163 /* Verify that we have an AHCI device present. */
164 s
->dev
= get_ahci_device(s
->parent
->qts
, &s
->fingerprint
);
170 * Start a Q35 machine and bookmark a handle to the AHCI device.
173 static AHCIQState
*ahci_boot(const char *cli
, ...)
180 s
= ahci_vboot(cli
, ap
);
183 cli
= "-drive if=none,id=drive0,file=%s,cache=writeback,format=%s"
185 "-device ide-hd,drive=drive0 "
186 "-global ide-hd.serial=%s "
187 "-global ide-hd.ver=%s";
188 s
= ahci_boot(cli
, tmp_path
, imgfmt
, "testdisk", "version");
195 * Clean up the PCI device, then terminate the QEMU instance.
197 static void ahci_shutdown(AHCIQState
*ahci
)
199 QOSState
*qs
= ahci
->parent
;
201 ahci_clean_mem(ahci
);
202 free_ahci_device(ahci
->dev
);
208 * Boot and fully enable the HBA device.
209 * @see ahci_boot, ahci_pci_enable and ahci_hba_enable.
212 static AHCIQState
*ahci_boot_and_enable(const char *cli
, ...)
222 ahci
= ahci_vboot(cli
, ap
);
225 ahci
= ahci_boot(NULL
);
228 ahci_pci_enable(ahci
);
229 ahci_hba_enable(ahci
);
230 /* Initialize test device */
231 port
= ahci_port_select(ahci
);
232 ahci_port_clear(ahci
, port
);
233 if (is_atapi(ahci
, port
)) {
234 hello
= CMD_PACKET_ID
;
236 hello
= CMD_IDENTIFY
;
238 ahci_io(ahci
, port
, hello
, &buff
, sizeof(buff
), 0);
243 /*** Specification Adherence Tests ***/
246 * Implementation for test_pci_spec. Ensures PCI configuration space is sane.
248 static void ahci_test_pci_spec(AHCIQState
*ahci
)
254 /* Most of these bits should start cleared until we turn them on. */
255 data
= qpci_config_readw(ahci
->dev
, PCI_COMMAND
);
256 ASSERT_BIT_CLEAR(data
, PCI_COMMAND_MEMORY
);
257 ASSERT_BIT_CLEAR(data
, PCI_COMMAND_MASTER
);
258 ASSERT_BIT_CLEAR(data
, PCI_COMMAND_SPECIAL
); /* Reserved */
259 ASSERT_BIT_CLEAR(data
, PCI_COMMAND_VGA_PALETTE
); /* Reserved */
260 ASSERT_BIT_CLEAR(data
, PCI_COMMAND_PARITY
);
261 ASSERT_BIT_CLEAR(data
, PCI_COMMAND_WAIT
); /* Reserved */
262 ASSERT_BIT_CLEAR(data
, PCI_COMMAND_SERR
);
263 ASSERT_BIT_CLEAR(data
, PCI_COMMAND_FAST_BACK
);
264 ASSERT_BIT_CLEAR(data
, PCI_COMMAND_INTX_DISABLE
);
265 ASSERT_BIT_CLEAR(data
, 0xF800); /* Reserved */
267 data
= qpci_config_readw(ahci
->dev
, PCI_STATUS
);
268 ASSERT_BIT_CLEAR(data
, 0x01 | 0x02 | 0x04); /* Reserved */
269 ASSERT_BIT_CLEAR(data
, PCI_STATUS_INTERRUPT
);
270 ASSERT_BIT_SET(data
, PCI_STATUS_CAP_LIST
); /* must be set */
271 ASSERT_BIT_CLEAR(data
, PCI_STATUS_UDF
); /* Reserved */
272 ASSERT_BIT_CLEAR(data
, PCI_STATUS_PARITY
);
273 ASSERT_BIT_CLEAR(data
, PCI_STATUS_SIG_TARGET_ABORT
);
274 ASSERT_BIT_CLEAR(data
, PCI_STATUS_REC_TARGET_ABORT
);
275 ASSERT_BIT_CLEAR(data
, PCI_STATUS_REC_MASTER_ABORT
);
276 ASSERT_BIT_CLEAR(data
, PCI_STATUS_SIG_SYSTEM_ERROR
);
277 ASSERT_BIT_CLEAR(data
, PCI_STATUS_DETECTED_PARITY
);
279 /* RID occupies the low byte, CCs occupy the high three. */
280 datal
= qpci_config_readl(ahci
->dev
, PCI_CLASS_REVISION
);
282 /* AHCI 1.3 specifies that at-boot, the RID should reset to 0x00,
283 * Though in practice this is likely seldom true. */
284 ASSERT_BIT_CLEAR(datal
, 0xFF);
287 /* BCC *must* equal 0x01. */
288 g_assert_cmphex(PCI_BCC(datal
), ==, 0x01);
289 if (PCI_SCC(datal
) == 0x01) {
291 ASSERT_BIT_SET(0x80000000, datal
);
292 ASSERT_BIT_CLEAR(0x60000000, datal
);
293 } else if (PCI_SCC(datal
) == 0x04) {
295 g_assert_cmphex(PCI_PI(datal
), ==, 0);
296 } else if (PCI_SCC(datal
) == 0x06) {
298 g_assert_cmphex(PCI_PI(datal
), ==, 0x01);
300 g_assert_not_reached();
303 datab
= qpci_config_readb(ahci
->dev
, PCI_CACHE_LINE_SIZE
);
304 g_assert_cmphex(datab
, ==, 0);
306 datab
= qpci_config_readb(ahci
->dev
, PCI_LATENCY_TIMER
);
307 g_assert_cmphex(datab
, ==, 0);
309 /* Only the bottom 7 bits must be off. */
310 datab
= qpci_config_readb(ahci
->dev
, PCI_HEADER_TYPE
);
311 ASSERT_BIT_CLEAR(datab
, 0x7F);
313 /* BIST is optional, but the low 7 bits must always start off regardless. */
314 datab
= qpci_config_readb(ahci
->dev
, PCI_BIST
);
315 ASSERT_BIT_CLEAR(datab
, 0x7F);
317 /* BARS 0-4 do not have a boot spec, but ABAR/BAR5 must be clean. */
318 datal
= qpci_config_readl(ahci
->dev
, PCI_BASE_ADDRESS_5
);
319 g_assert_cmphex(datal
, ==, 0);
321 qpci_config_writel(ahci
->dev
, PCI_BASE_ADDRESS_5
, 0xFFFFFFFF);
322 datal
= qpci_config_readl(ahci
->dev
, PCI_BASE_ADDRESS_5
);
323 /* ABAR must be 32-bit, memory mapped, non-prefetchable and
324 * must be >= 512 bytes. To that end, bits 0-8 must be off. */
325 ASSERT_BIT_CLEAR(datal
, 0xFF);
327 /* Capability list MUST be present, */
328 datal
= qpci_config_readl(ahci
->dev
, PCI_CAPABILITY_LIST
);
329 /* But these bits are reserved. */
330 ASSERT_BIT_CLEAR(datal
, ~0xFF);
331 g_assert_cmphex(datal
, !=, 0);
333 /* Check specification adherence for capability extensions. */
334 data
= qpci_config_readw(ahci
->dev
, datal
);
336 switch (ahci
->fingerprint
) {
337 case AHCI_INTEL_ICH9
:
338 /* Intel ICH9 Family Datasheet 14.1.19 p.550 */
339 g_assert_cmphex((data
& 0xFF), ==, PCI_CAP_ID_MSI
);
342 /* AHCI 1.3, Section 2.1.14 -- CAP must point to PMCAP. */
343 g_assert_cmphex((data
& 0xFF), ==, PCI_CAP_ID_PM
);
346 ahci_test_pci_caps(ahci
, data
, (uint8_t)datal
);
349 datal
= qpci_config_readl(ahci
->dev
, PCI_CAPABILITY_LIST
+ 4);
350 g_assert_cmphex(datal
, ==, 0);
352 /* IPIN might vary, but ILINE must be off. */
353 datab
= qpci_config_readb(ahci
->dev
, PCI_INTERRUPT_LINE
);
354 g_assert_cmphex(datab
, ==, 0);
358 * Test PCI capabilities for AHCI specification adherence.
360 static void ahci_test_pci_caps(AHCIQState
*ahci
, uint16_t header
,
363 uint8_t cid
= header
& 0xFF;
364 uint8_t next
= header
>> 8;
366 g_test_message("CID: %02x; next: %02x", cid
, next
);
370 ahci_test_pmcap(ahci
, offset
);
373 ahci_test_msicap(ahci
, offset
);
375 case PCI_CAP_ID_SATA
:
376 ahci_test_satacap(ahci
, offset
);
380 g_test_message("Unknown CAP 0x%02x", cid
);
384 ahci_test_pci_caps(ahci
, qpci_config_readw(ahci
->dev
, next
), next
);
389 * Test SATA PCI capabilitity for AHCI specification adherence.
391 static void ahci_test_satacap(AHCIQState
*ahci
, uint8_t offset
)
396 g_test_message("Verifying SATACAP");
398 /* Assert that the SATACAP version is 1.0, And reserved bits are empty. */
399 dataw
= qpci_config_readw(ahci
->dev
, offset
+ 2);
400 g_assert_cmphex(dataw
, ==, 0x10);
402 /* Grab the SATACR1 register. */
403 datal
= qpci_config_readw(ahci
->dev
, offset
+ 4);
405 switch (datal
& 0x0F) {
406 case 0x04: /* BAR0 */
407 case 0x05: /* BAR1 */
411 case 0x09: /* BAR5 */
412 case 0x0F: /* Immediately following SATACR1 in PCI config space. */
415 /* Invalid BARLOC for the Index Data Pair. */
416 g_assert_not_reached();
420 g_assert_cmphex((datal
>> 24), ==, 0x00);
424 * Test MSI PCI capability for AHCI specification adherence.
426 static void ahci_test_msicap(AHCIQState
*ahci
, uint8_t offset
)
431 g_test_message("Verifying MSICAP");
433 dataw
= qpci_config_readw(ahci
->dev
, offset
+ PCI_MSI_FLAGS
);
434 ASSERT_BIT_CLEAR(dataw
, PCI_MSI_FLAGS_ENABLE
);
435 ASSERT_BIT_CLEAR(dataw
, PCI_MSI_FLAGS_QSIZE
);
436 ASSERT_BIT_CLEAR(dataw
, PCI_MSI_FLAGS_RESERVED
);
438 datal
= qpci_config_readl(ahci
->dev
, offset
+ PCI_MSI_ADDRESS_LO
);
439 g_assert_cmphex(datal
, ==, 0);
441 if (dataw
& PCI_MSI_FLAGS_64BIT
) {
442 g_test_message("MSICAP is 64bit");
443 datal
= qpci_config_readl(ahci
->dev
, offset
+ PCI_MSI_ADDRESS_HI
);
444 g_assert_cmphex(datal
, ==, 0);
445 dataw
= qpci_config_readw(ahci
->dev
, offset
+ PCI_MSI_DATA_64
);
446 g_assert_cmphex(dataw
, ==, 0);
448 g_test_message("MSICAP is 32bit");
449 dataw
= qpci_config_readw(ahci
->dev
, offset
+ PCI_MSI_DATA_32
);
450 g_assert_cmphex(dataw
, ==, 0);
455 * Test Power Management PCI capability for AHCI specification adherence.
457 static void ahci_test_pmcap(AHCIQState
*ahci
, uint8_t offset
)
461 g_test_message("Verifying PMCAP");
463 dataw
= qpci_config_readw(ahci
->dev
, offset
+ PCI_PM_PMC
);
464 ASSERT_BIT_CLEAR(dataw
, PCI_PM_CAP_PME_CLOCK
);
465 ASSERT_BIT_CLEAR(dataw
, PCI_PM_CAP_RESERVED
);
466 ASSERT_BIT_CLEAR(dataw
, PCI_PM_CAP_D1
);
467 ASSERT_BIT_CLEAR(dataw
, PCI_PM_CAP_D2
);
469 dataw
= qpci_config_readw(ahci
->dev
, offset
+ PCI_PM_CTRL
);
470 ASSERT_BIT_CLEAR(dataw
, PCI_PM_CTRL_STATE_MASK
);
471 ASSERT_BIT_CLEAR(dataw
, PCI_PM_CTRL_RESERVED
);
472 ASSERT_BIT_CLEAR(dataw
, PCI_PM_CTRL_DATA_SEL_MASK
);
473 ASSERT_BIT_CLEAR(dataw
, PCI_PM_CTRL_DATA_SCALE_MASK
);
476 static void ahci_test_hba_spec(AHCIQState
*ahci
)
484 g_assert(ahci
!= NULL
);
487 * Note that the AHCI spec does expect the BIOS to set up a few things:
488 * CAP.SSS - Support for staggered spin-up (t/f)
489 * CAP.SMPS - Support for mechanical presence switches (t/f)
490 * PI - Ports Implemented (1-32)
491 * PxCMD.HPCP - Hot Plug Capable Port
492 * PxCMD.MPSP - Mechanical Presence Switch Present
493 * PxCMD.CPD - Cold Presence Detection support
495 * Additional items are touched if CAP.SSS is on, see AHCI 10.1.1 p.97:
496 * Foreach Port Implemented:
497 * -PxCMD.ST, PxCMD.CR, PxCMD.FRE, PxCMD.FR, PxSCTL.DET are 0
498 * -PxCLB/U and PxFB/U are set to valid regions in memory
499 * -PxSUD is set to 1.
500 * -PxSSTS.DET is polled for presence; if detected, we continue:
501 * -PxSERR is cleared with 1's.
502 * -If PxTFD.STS.BSY, PxTFD.STS.DRQ, and PxTFD.STS.ERR are all zero,
503 * the device is ready.
506 /* 1 CAP - Capabilities Register */
507 ahci
->cap
= ahci_rreg(ahci
, AHCI_CAP
);
508 ASSERT_BIT_CLEAR(ahci
->cap
, AHCI_CAP_RESERVED
);
510 /* 2 GHC - Global Host Control */
511 reg
= ahci_rreg(ahci
, AHCI_GHC
);
512 ASSERT_BIT_CLEAR(reg
, AHCI_GHC_HR
);
513 ASSERT_BIT_CLEAR(reg
, AHCI_GHC_IE
);
514 ASSERT_BIT_CLEAR(reg
, AHCI_GHC_MRSM
);
515 if (BITSET(ahci
->cap
, AHCI_CAP_SAM
)) {
516 g_test_message("Supports AHCI-Only Mode: GHC_AE is Read-Only.");
517 ASSERT_BIT_SET(reg
, AHCI_GHC_AE
);
519 g_test_message("Supports AHCI/Legacy mix.");
520 ASSERT_BIT_CLEAR(reg
, AHCI_GHC_AE
);
523 /* 3 IS - Interrupt Status */
524 reg
= ahci_rreg(ahci
, AHCI_IS
);
525 g_assert_cmphex(reg
, ==, 0);
527 /* 4 PI - Ports Implemented */
528 ports
= ahci_rreg(ahci
, AHCI_PI
);
529 /* Ports Implemented must be non-zero. */
530 g_assert_cmphex(ports
, !=, 0);
531 /* Ports Implemented must be <= Number of Ports. */
532 nports_impl
= ctpopl(ports
);
533 g_assert_cmpuint(((AHCI_CAP_NP
& ahci
->cap
) + 1), >=, nports_impl
);
535 /* Ports must be within the proper range. Given a mapping of SIZE,
536 * 256 bytes are used for global HBA control, and the rest is used
537 * for ports data, at 0x80 bytes each. */
538 g_assert_cmphex(ahci
->barsize
, >, 0);
539 maxports
= (ahci
->barsize
- HBA_DATA_REGION_SIZE
) / HBA_PORT_DATA_SIZE
;
540 /* e.g, 30 ports for 4K of memory. (4096 - 256) / 128 = 30 */
541 g_assert_cmphex((reg
>> maxports
), ==, 0);
544 reg
= ahci_rreg(ahci
, AHCI_VS
);
546 case AHCI_VERSION_0_95
:
547 case AHCI_VERSION_1_0
:
548 case AHCI_VERSION_1_1
:
549 case AHCI_VERSION_1_2
:
550 case AHCI_VERSION_1_3
:
553 g_assert_not_reached();
556 /* 6 Command Completion Coalescing Control: depends on CAP.CCCS. */
557 reg
= ahci_rreg(ahci
, AHCI_CCCCTL
);
558 if (BITSET(ahci
->cap
, AHCI_CAP_CCCS
)) {
559 ASSERT_BIT_CLEAR(reg
, AHCI_CCCCTL_EN
);
560 ASSERT_BIT_CLEAR(reg
, AHCI_CCCCTL_RESERVED
);
561 ASSERT_BIT_SET(reg
, AHCI_CCCCTL_CC
);
562 ASSERT_BIT_SET(reg
, AHCI_CCCCTL_TV
);
564 g_assert_cmphex(reg
, ==, 0);
568 reg
= ahci_rreg(ahci
, AHCI_CCCPORTS
);
569 /* Must be zeroes initially regardless of CAP.CCCS */
570 g_assert_cmphex(reg
, ==, 0);
573 reg
= ahci_rreg(ahci
, AHCI_EMLOC
);
574 if (BITCLR(ahci
->cap
, AHCI_CAP_EMS
)) {
575 g_assert_cmphex(reg
, ==, 0);
579 reg
= ahci_rreg(ahci
, AHCI_EMCTL
);
580 if (BITSET(ahci
->cap
, AHCI_CAP_EMS
)) {
581 ASSERT_BIT_CLEAR(reg
, AHCI_EMCTL_STSMR
);
582 ASSERT_BIT_CLEAR(reg
, AHCI_EMCTL_CTLTM
);
583 ASSERT_BIT_CLEAR(reg
, AHCI_EMCTL_CTLRST
);
584 ASSERT_BIT_CLEAR(reg
, AHCI_EMCTL_RESERVED
);
586 g_assert_cmphex(reg
, ==, 0);
589 /* 10 CAP2 -- Capabilities Extended */
590 ahci
->cap2
= ahci_rreg(ahci
, AHCI_CAP2
);
591 ASSERT_BIT_CLEAR(ahci
->cap2
, AHCI_CAP2_RESERVED
);
593 /* 11 BOHC -- Bios/OS Handoff Control */
594 reg
= ahci_rreg(ahci
, AHCI_BOHC
);
595 g_assert_cmphex(reg
, ==, 0);
597 /* 12 -- 23: Reserved */
598 g_test_message("Verifying HBA reserved area is empty.");
599 for (i
= AHCI_RESERVED
; i
< AHCI_NVMHCI
; ++i
) {
600 reg
= ahci_rreg(ahci
, i
);
601 g_assert_cmphex(reg
, ==, 0);
604 /* 24 -- 39: NVMHCI */
605 if (BITCLR(ahci
->cap2
, AHCI_CAP2_NVMP
)) {
606 g_test_message("Verifying HBA/NVMHCI area is empty.");
607 for (i
= AHCI_NVMHCI
; i
< AHCI_VENDOR
; ++i
) {
608 reg
= ahci_rreg(ahci
, i
);
609 g_assert_cmphex(reg
, ==, 0);
613 /* 40 -- 63: Vendor */
614 g_test_message("Verifying HBA/Vendor area is empty.");
615 for (i
= AHCI_VENDOR
; i
< AHCI_PORTS
; ++i
) {
616 reg
= ahci_rreg(ahci
, i
);
617 g_assert_cmphex(reg
, ==, 0);
620 /* 64 -- XX: Port Space */
621 for (i
= 0; ports
|| (i
< maxports
); ports
>>= 1, ++i
) {
622 if (BITSET(ports
, 0x1)) {
623 g_test_message("Testing port %u for spec", i
);
624 ahci_test_port_spec(ahci
, i
);
627 uint16_t low
= AHCI_PORTS
+ (32 * i
);
628 uint16_t high
= AHCI_PORTS
+ (32 * (i
+ 1));
629 g_test_message("Asserting unimplemented port %u "
630 "(reg [%u-%u]) is empty.",
632 for (j
= low
; j
< high
; ++j
) {
633 reg
= ahci_rreg(ahci
, j
);
634 g_assert_cmphex(reg
, ==, 0);
641 * Test the memory space for one port for specification adherence.
643 static void ahci_test_port_spec(AHCIQState
*ahci
, uint8_t port
)
649 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_CLB
);
650 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CLB_RESERVED
);
653 if (BITCLR(ahci
->cap
, AHCI_CAP_S64A
)) {
654 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_CLBU
);
655 g_assert_cmphex(reg
, ==, 0);
659 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_FB
);
660 ASSERT_BIT_CLEAR(reg
, AHCI_PX_FB_RESERVED
);
663 if (BITCLR(ahci
->cap
, AHCI_CAP_S64A
)) {
664 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_FBU
);
665 g_assert_cmphex(reg
, ==, 0);
669 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_IS
);
670 g_assert_cmphex(reg
, ==, 0);
673 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_IE
);
674 g_assert_cmphex(reg
, ==, 0);
677 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_CMD
);
678 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_FRE
);
679 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_RESERVED
);
680 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_CCS
);
681 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_FR
);
682 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_CR
);
683 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_PMA
); /* And RW only if CAP.SPM */
684 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_APSTE
); /* RW only if CAP2.APST */
685 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_ATAPI
);
686 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_DLAE
);
687 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_ALPE
); /* RW only if CAP.SALP */
688 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_ASP
); /* RW only if CAP.SALP */
689 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_ICC
);
690 /* If CPDetect support does not exist, CPState must be off. */
691 if (BITCLR(reg
, AHCI_PX_CMD_CPD
)) {
692 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_CPS
);
694 /* If MPSPresence is not set, MPSState must be off. */
695 if (BITCLR(reg
, AHCI_PX_CMD_MPSP
)) {
696 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_MPSS
);
698 /* If we do not support MPS, MPSS and MPSP must be off. */
699 if (BITCLR(ahci
->cap
, AHCI_CAP_SMPS
)) {
700 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_MPSS
);
701 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_MPSP
);
703 /* If, via CPD or MPSP we detect a drive, HPCP must be on. */
704 if (BITANY(reg
, AHCI_PX_CMD_CPD
| AHCI_PX_CMD_MPSP
)) {
705 ASSERT_BIT_SET(reg
, AHCI_PX_CMD_HPCP
);
707 /* HPCP and ESP cannot both be active. */
708 g_assert(!BITSET(reg
, AHCI_PX_CMD_HPCP
| AHCI_PX_CMD_ESP
));
709 /* If CAP.FBSS is not set, FBSCP must not be set. */
710 if (BITCLR(ahci
->cap
, AHCI_CAP_FBSS
)) {
711 ASSERT_BIT_CLEAR(reg
, AHCI_PX_CMD_FBSCP
);
715 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_RES1
);
716 g_assert_cmphex(reg
, ==, 0);
719 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_TFD
);
720 /* At boot, prior to an FIS being received, the TFD register should be 0x7F,
721 * which breaks down as follows, as seen in AHCI 1.3 sec 3.3.8, p. 27. */
722 ASSERT_BIT_SET(reg
, AHCI_PX_TFD_STS_ERR
);
723 ASSERT_BIT_SET(reg
, AHCI_PX_TFD_STS_CS1
);
724 ASSERT_BIT_SET(reg
, AHCI_PX_TFD_STS_DRQ
);
725 ASSERT_BIT_SET(reg
, AHCI_PX_TFD_STS_CS2
);
726 ASSERT_BIT_CLEAR(reg
, AHCI_PX_TFD_STS_BSY
);
727 ASSERT_BIT_CLEAR(reg
, AHCI_PX_TFD_ERR
);
728 ASSERT_BIT_CLEAR(reg
, AHCI_PX_TFD_RESERVED
);
731 /* Though AHCI specifies the boot value should be 0xFFFFFFFF,
732 * Even when GHC.ST is zero, the AHCI HBA may receive the initial
733 * D2H register FIS and update the signature asynchronously,
734 * so we cannot expect a value here. AHCI 1.3, sec 3.3.9, pp 27-28 */
736 /* (10) SSTS / SCR0: SStatus */
737 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_SSTS
);
738 ASSERT_BIT_CLEAR(reg
, AHCI_PX_SSTS_RESERVED
);
739 /* Even though the register should be 0 at boot, it is asynchronous and
740 * prone to change, so we cannot test any well known value. */
742 /* (11) SCTL / SCR2: SControl */
743 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_SCTL
);
744 g_assert_cmphex(reg
, ==, 0);
746 /* (12) SERR / SCR1: SError */
747 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_SERR
);
748 g_assert_cmphex(reg
, ==, 0);
750 /* (13) SACT / SCR3: SActive */
751 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_SACT
);
752 g_assert_cmphex(reg
, ==, 0);
755 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_CI
);
756 g_assert_cmphex(reg
, ==, 0);
759 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_SNTF
);
760 g_assert_cmphex(reg
, ==, 0);
763 reg
= ahci_px_rreg(ahci
, port
, AHCI_PX_FBS
);
764 ASSERT_BIT_CLEAR(reg
, AHCI_PX_FBS_EN
);
765 ASSERT_BIT_CLEAR(reg
, AHCI_PX_FBS_DEC
);
766 ASSERT_BIT_CLEAR(reg
, AHCI_PX_FBS_SDE
);
767 ASSERT_BIT_CLEAR(reg
, AHCI_PX_FBS_DEV
);
768 ASSERT_BIT_CLEAR(reg
, AHCI_PX_FBS_DWE
);
769 ASSERT_BIT_CLEAR(reg
, AHCI_PX_FBS_RESERVED
);
770 if (BITSET(ahci
->cap
, AHCI_CAP_FBSS
)) {
771 /* if Port-Multiplier FIS-based switching avail, ADO must >= 2 */
772 g_assert((reg
& AHCI_PX_FBS_ADO
) >> ctzl(AHCI_PX_FBS_ADO
) >= 2);
775 /* [17 -- 27] RESERVED */
776 for (i
= AHCI_PX_RES2
; i
< AHCI_PX_VS
; ++i
) {
777 reg
= ahci_px_rreg(ahci
, port
, i
);
778 g_assert_cmphex(reg
, ==, 0);
781 /* [28 -- 31] Vendor-Specific */
782 for (i
= AHCI_PX_VS
; i
< 32; ++i
) {
783 reg
= ahci_px_rreg(ahci
, port
, i
);
785 g_test_message("INFO: Vendor register %u non-empty", i
);
791 * Utilizing an initialized AHCI HBA, issue an IDENTIFY command to the first
792 * device we see, then read and check the response.
794 static void ahci_test_identify(AHCIQState
*ahci
)
800 const size_t buffsize
= 512;
802 g_assert(ahci
!= NULL
);
805 * This serves as a bit of a tutorial on AHCI device programming:
807 * (1) Create a data buffer for the IDENTIFY response to be sent to
808 * (2) Create a Command Table buffer, where we will store the
809 * command and PRDT (Physical Region Descriptor Table)
810 * (3) Construct an FIS host-to-device command structure, and write it to
811 * the top of the Command Table buffer.
812 * (4) Create one or more Physical Region Descriptors (PRDs) that describe
813 * a location in memory where data may be stored/retrieved.
814 * (5) Write these PRDTs to the bottom (offset 0x80) of the Command Table.
815 * (6) Each AHCI port has up to 32 command slots. Each slot contains a
816 * header that points to a Command Table buffer. Pick an unused slot
817 * and update it to point to the Command Table we have built.
818 * (7) Now: Command #n points to our Command Table, and our Command Table
819 * contains the FIS (that describes our command) and the PRDTL, which
820 * describes our buffer.
821 * (8) We inform the HBA via PxCI (Command Issue) that the command in slot
822 * #n is ready for processing.
825 /* Pick the first implemented and running port */
826 px
= ahci_port_select(ahci
);
827 g_test_message("Selected port %u for test", px
);
829 /* Clear out the FIS Receive area and any pending interrupts. */
830 ahci_port_clear(ahci
, px
);
832 /* "Read" 512 bytes using CMD_IDENTIFY into the host buffer. */
833 ahci_io(ahci
, px
, CMD_IDENTIFY
, &buff
, buffsize
, 0);
835 /* Check serial number/version in the buffer */
836 /* NB: IDENTIFY strings are packed in 16bit little endian chunks.
837 * Since we copy byte-for-byte in ahci-test, on both LE and BE, we need to
838 * unchunk this data. By contrast, ide-test copies 2 bytes at a time, and
839 * as a consequence, only needs to unchunk the data on LE machines. */
840 string_bswap16(&buff
[10], 20);
841 rc
= memcmp(&buff
[10], "testdisk ", 20);
842 g_assert_cmphex(rc
, ==, 0);
844 string_bswap16(&buff
[23], 8);
845 rc
= memcmp(&buff
[23], "version ", 8);
846 g_assert_cmphex(rc
, ==, 0);
848 sect_size
= le16_to_cpu(*((uint16_t *)(&buff
[5])));
849 g_assert_cmphex(sect_size
, ==, AHCI_SECTOR_SIZE
);
852 static void ahci_test_io_rw_simple(AHCIQState
*ahci
, unsigned bufsize
,
853 uint64_t sector
, uint8_t read_cmd
,
858 unsigned char *tx
= g_malloc(bufsize
);
859 unsigned char *rx
= g_malloc0(bufsize
);
861 g_assert(ahci
!= NULL
);
863 /* Pick the first running port and clear it. */
864 port
= ahci_port_select(ahci
);
865 ahci_port_clear(ahci
, port
);
867 /*** Create pattern and transfer to guest ***/
868 /* Data buffer in the guest */
869 ptr
= ahci_alloc(ahci
, bufsize
);
872 /* Write some indicative pattern to our buffer. */
873 generate_pattern(tx
, bufsize
, AHCI_SECTOR_SIZE
);
874 qtest_bufwrite(ahci
->parent
->qts
, ptr
, tx
, bufsize
);
876 /* Write this buffer to disk, then read it back to the DMA buffer. */
877 ahci_guest_io(ahci
, port
, write_cmd
, ptr
, bufsize
, sector
);
878 qtest_memset(ahci
->parent
->qts
, ptr
, 0x00, bufsize
);
879 ahci_guest_io(ahci
, port
, read_cmd
, ptr
, bufsize
, sector
);
881 /*** Read back the Data ***/
882 qtest_bufread(ahci
->parent
->qts
, ptr
, rx
, bufsize
);
883 g_assert_cmphex(memcmp(tx
, rx
, bufsize
), ==, 0);
885 ahci_free(ahci
, ptr
);
890 static uint8_t ahci_test_nondata(AHCIQState
*ahci
, uint8_t ide_cmd
)
895 port
= ahci_port_select(ahci
);
896 ahci_port_clear(ahci
, port
);
898 ahci_io(ahci
, port
, ide_cmd
, NULL
, 0, 0);
903 static void ahci_test_flush(AHCIQState
*ahci
)
905 ahci_test_nondata(ahci
, CMD_FLUSH_CACHE
);
908 static void ahci_test_max(AHCIQState
*ahci
)
910 RegD2HFIS
*d2h
= g_malloc0(0x20);
914 uint64_t config_sect
= mb_to_sectors(test_image_size_mb
) - 1;
916 if (config_sect
> 0xFFFFFF) {
917 cmd
= CMD_READ_MAX_EXT
;
922 port
= ahci_test_nondata(ahci
, cmd
);
923 qtest_memread(ahci
->parent
->qts
, ahci
->port
[port
].fb
+ 0x40, d2h
, 0x20);
924 nsect
= (uint64_t)d2h
->lba_hi
[2] << 40 |
925 (uint64_t)d2h
->lba_hi
[1] << 32 |
926 (uint64_t)d2h
->lba_hi
[0] << 24 |
927 (uint64_t)d2h
->lba_lo
[2] << 16 |
928 (uint64_t)d2h
->lba_lo
[1] << 8 |
929 (uint64_t)d2h
->lba_lo
[0];
931 g_assert_cmphex(nsect
, ==, config_sect
);
936 /******************************************************************************/
937 /* Test Interfaces */
938 /******************************************************************************/
941 * Basic sanity test to boot a machine, find an AHCI device, and shutdown.
943 static void test_sanity(void)
946 ahci
= ahci_boot(NULL
);
951 * Ensure that the PCI configuration space for the AHCI device is in-line with
952 * the AHCI 1.3 specification for initial values.
954 static void test_pci_spec(void)
957 ahci
= ahci_boot(NULL
);
958 ahci_test_pci_spec(ahci
);
963 * Engage the PCI AHCI device and sanity check the response.
964 * Perform additional PCI config space bringup for the HBA.
966 static void test_pci_enable(void)
969 ahci
= ahci_boot(NULL
);
970 ahci_pci_enable(ahci
);
975 * Investigate the memory mapped regions of the HBA,
976 * and test them for AHCI specification adherence.
978 static void test_hba_spec(void)
982 ahci
= ahci_boot(NULL
);
983 ahci_pci_enable(ahci
);
984 ahci_test_hba_spec(ahci
);
989 * Engage the HBA functionality of the AHCI PCI device,
990 * and bring it into a functional idle state.
992 static void test_hba_enable(void)
996 ahci
= ahci_boot(NULL
);
997 ahci_pci_enable(ahci
);
998 ahci_hba_enable(ahci
);
1003 * Bring up the device and issue an IDENTIFY command.
1004 * Inspect the state of the HBA device and the data returned.
1006 static void test_identify(void)
1010 ahci
= ahci_boot_and_enable(NULL
);
1011 ahci_test_identify(ahci
);
1012 ahci_shutdown(ahci
);
1016 * Fragmented DMA test: Perform a standard 4K DMA read/write
1017 * test, but make sure the physical regions are fragmented to
1018 * be very small, each just 32 bytes, to see how AHCI performs
1019 * with chunks defined to be much less than a sector.
1021 static void test_dma_fragmented(void)
1026 size_t bufsize
= 4096;
1027 unsigned char *tx
= g_malloc(bufsize
);
1028 unsigned char *rx
= g_malloc0(bufsize
);
1031 ahci
= ahci_boot_and_enable(NULL
);
1032 px
= ahci_port_select(ahci
);
1033 ahci_port_clear(ahci
, px
);
1035 /* create pattern */
1036 generate_pattern(tx
, bufsize
, AHCI_SECTOR_SIZE
);
1038 /* Create a DMA buffer in guest memory, and write our pattern to it. */
1039 ptr
= guest_alloc(&ahci
->parent
->alloc
, bufsize
);
1041 qtest_bufwrite(ahci
->parent
->qts
, ptr
, tx
, bufsize
);
1043 cmd
= ahci_command_create(CMD_WRITE_DMA
);
1044 ahci_command_adjust(cmd
, 0, ptr
, bufsize
, 32);
1045 ahci_command_commit(ahci
, cmd
, px
);
1046 ahci_command_issue(ahci
, cmd
);
1047 ahci_command_verify(ahci
, cmd
);
1048 ahci_command_free(cmd
);
1050 cmd
= ahci_command_create(CMD_READ_DMA
);
1051 ahci_command_adjust(cmd
, 0, ptr
, bufsize
, 32);
1052 ahci_command_commit(ahci
, cmd
, px
);
1053 ahci_command_issue(ahci
, cmd
);
1054 ahci_command_verify(ahci
, cmd
);
1055 ahci_command_free(cmd
);
1057 /* Read back the guest's receive buffer into local memory */
1058 qtest_bufread(ahci
->parent
->qts
, ptr
, rx
, bufsize
);
1059 guest_free(&ahci
->parent
->alloc
, ptr
);
1061 g_assert_cmphex(memcmp(tx
, rx
, bufsize
), ==, 0);
1063 ahci_shutdown(ahci
);
1070 * Write sector 1 with random data to make AHCI storage dirty
1071 * Needed for flush tests so that flushes actually go though the block layer
1073 static void make_dirty(AHCIQState
* ahci
, uint8_t port
)
1076 unsigned bufsize
= 512;
1078 ptr
= ahci_alloc(ahci
, bufsize
);
1081 ahci_guest_io(ahci
, port
, CMD_WRITE_DMA
, ptr
, bufsize
, 1);
1082 ahci_free(ahci
, ptr
);
1085 static void test_flush(void)
1090 ahci
= ahci_boot_and_enable(NULL
);
1092 port
= ahci_port_select(ahci
);
1093 ahci_port_clear(ahci
, port
);
1095 make_dirty(ahci
, port
);
1097 ahci_test_flush(ahci
);
1098 ahci_shutdown(ahci
);
1101 static void test_flush_retry(void)
1107 prepare_blkdebug_script(debug_path
, "flush_to_disk");
1108 ahci
= ahci_boot_and_enable("-drive file=blkdebug:%s:%s,if=none,id=drive0,"
1109 "format=%s,cache=writeback,"
1110 "rerror=stop,werror=stop "
1112 "-device ide-hd,drive=drive0 ",
1116 port
= ahci_port_select(ahci
);
1117 ahci_port_clear(ahci
, port
);
1119 /* Issue write so that flush actually goes to disk */
1120 make_dirty(ahci
, port
);
1122 /* Issue Flush Command and wait for error */
1123 cmd
= ahci_guest_io_halt(ahci
, port
, CMD_FLUSH_CACHE
, 0, 0, 0);
1124 ahci_guest_io_resume(ahci
, cmd
);
1126 ahci_shutdown(ahci
);
1130 * Basic sanity test to boot a machine, find an AHCI device, and shutdown.
1132 static void test_migrate_sanity(void)
1134 AHCIQState
*src
, *dst
;
1135 char *uri
= g_strdup_printf("unix:%s", mig_socket
);
1137 src
= ahci_boot("-m 384 -M q35 "
1138 "-drive if=ide,file=%s,format=%s ", tmp_path
, imgfmt
);
1139 dst
= ahci_boot("-m 384 -M q35 "
1140 "-drive if=ide,file=%s,format=%s "
1141 "-incoming %s", tmp_path
, imgfmt
, uri
);
1143 ahci_migrate(src
, dst
, uri
);
1151 * Simple migration test: Write a pattern, migrate, then read.
1153 static void ahci_migrate_simple(uint8_t cmd_read
, uint8_t cmd_write
)
1155 AHCIQState
*src
, *dst
;
1157 size_t bufsize
= 4096;
1158 unsigned char *tx
= g_malloc(bufsize
);
1159 unsigned char *rx
= g_malloc0(bufsize
);
1160 char *uri
= g_strdup_printf("unix:%s", mig_socket
);
1162 src
= ahci_boot_and_enable("-m 384 -M q35 "
1163 "-drive if=ide,format=%s,file=%s ",
1165 dst
= ahci_boot("-m 384 -M q35 "
1166 "-drive if=ide,format=%s,file=%s "
1167 "-incoming %s", imgfmt
, tmp_path
, uri
);
1170 px
= ahci_port_select(src
);
1171 ahci_port_clear(src
, px
);
1173 /* create pattern */
1174 generate_pattern(tx
, bufsize
, AHCI_SECTOR_SIZE
);
1176 /* Write, migrate, then read. */
1177 ahci_io(src
, px
, cmd_write
, tx
, bufsize
, 0);
1178 ahci_migrate(src
, dst
, uri
);
1179 ahci_io(dst
, px
, cmd_read
, rx
, bufsize
, 0);
1181 /* Verify pattern */
1182 g_assert_cmphex(memcmp(tx
, rx
, bufsize
), ==, 0);
1191 static void test_migrate_dma(void)
1193 ahci_migrate_simple(CMD_READ_DMA
, CMD_WRITE_DMA
);
1196 static void test_migrate_ncq(void)
1198 ahci_migrate_simple(READ_FPDMA_QUEUED
, WRITE_FPDMA_QUEUED
);
1202 * Halted IO Error Test
1204 * Simulate an error on first write, Try to write a pattern,
1205 * Confirm the VM has stopped, resume the VM, verify command
1206 * has completed, then read back the data and verify.
1208 static void ahci_halted_io_test(uint8_t cmd_read
, uint8_t cmd_write
)
1212 size_t bufsize
= 4096;
1213 unsigned char *tx
= g_malloc(bufsize
);
1214 unsigned char *rx
= g_malloc0(bufsize
);
1218 prepare_blkdebug_script(debug_path
, "write_aio");
1220 ahci
= ahci_boot_and_enable("-drive file=blkdebug:%s:%s,if=none,id=drive0,"
1221 "format=%s,cache=writeback,"
1222 "rerror=stop,werror=stop "
1224 "-device ide-hd,drive=drive0 ",
1228 /* Initialize and prepare */
1229 port
= ahci_port_select(ahci
);
1230 ahci_port_clear(ahci
, port
);
1232 /* create DMA source buffer and write pattern */
1233 generate_pattern(tx
, bufsize
, AHCI_SECTOR_SIZE
);
1234 ptr
= ahci_alloc(ahci
, bufsize
);
1236 qtest_memwrite(ahci
->parent
->qts
, ptr
, tx
, bufsize
);
1238 /* Attempt to write (and fail) */
1239 cmd
= ahci_guest_io_halt(ahci
, port
, cmd_write
,
1242 /* Attempt to resume the command */
1243 ahci_guest_io_resume(ahci
, cmd
);
1244 ahci_free(ahci
, ptr
);
1246 /* Read back and verify */
1247 ahci_io(ahci
, port
, cmd_read
, rx
, bufsize
, 0);
1248 g_assert_cmphex(memcmp(tx
, rx
, bufsize
), ==, 0);
1250 /* Cleanup and go home */
1251 ahci_shutdown(ahci
);
1256 static void test_halted_dma(void)
1258 ahci_halted_io_test(CMD_READ_DMA
, CMD_WRITE_DMA
);
1261 static void test_halted_ncq(void)
1263 ahci_halted_io_test(READ_FPDMA_QUEUED
, WRITE_FPDMA_QUEUED
);
1267 * IO Error Migration Test
1269 * Simulate an error on first write, Try to write a pattern,
1270 * Confirm the VM has stopped, migrate, resume the VM,
1271 * verify command has completed, then read back the data and verify.
1273 static void ahci_migrate_halted_io(uint8_t cmd_read
, uint8_t cmd_write
)
1275 AHCIQState
*src
, *dst
;
1277 size_t bufsize
= 4096;
1278 unsigned char *tx
= g_malloc(bufsize
);
1279 unsigned char *rx
= g_malloc0(bufsize
);
1282 char *uri
= g_strdup_printf("unix:%s", mig_socket
);
1284 prepare_blkdebug_script(debug_path
, "write_aio");
1286 src
= ahci_boot_and_enable("-drive file=blkdebug:%s:%s,if=none,id=drive0,"
1287 "format=%s,cache=writeback,"
1288 "rerror=stop,werror=stop "
1290 "-device ide-hd,drive=drive0 ",
1294 dst
= ahci_boot("-drive file=%s,if=none,id=drive0,"
1295 "format=%s,cache=writeback,"
1296 "rerror=stop,werror=stop "
1298 "-device ide-hd,drive=drive0 "
1300 tmp_path
, imgfmt
, uri
);
1302 /* Initialize and prepare */
1303 port
= ahci_port_select(src
);
1304 ahci_port_clear(src
, port
);
1305 generate_pattern(tx
, bufsize
, AHCI_SECTOR_SIZE
);
1307 /* create DMA source buffer and write pattern */
1308 ptr
= ahci_alloc(src
, bufsize
);
1310 qtest_memwrite(src
->parent
->qts
, ptr
, tx
, bufsize
);
1312 /* Write, trigger the VM to stop, migrate, then resume. */
1313 cmd
= ahci_guest_io_halt(src
, port
, cmd_write
,
1315 ahci_migrate(src
, dst
, uri
);
1316 ahci_guest_io_resume(dst
, cmd
);
1317 ahci_free(dst
, ptr
);
1320 ahci_io(dst
, port
, cmd_read
, rx
, bufsize
, 0);
1322 /* Verify TX and RX are identical */
1323 g_assert_cmphex(memcmp(tx
, rx
, bufsize
), ==, 0);
1325 /* Cleanup and go home. */
1333 static void test_migrate_halted_dma(void)
1335 ahci_migrate_halted_io(CMD_READ_DMA
, CMD_WRITE_DMA
);
1338 static void test_migrate_halted_ncq(void)
1340 ahci_migrate_halted_io(READ_FPDMA_QUEUED
, WRITE_FPDMA_QUEUED
);
1344 * Migration test: Try to flush, migrate, then resume.
1346 static void test_flush_migrate(void)
1348 AHCIQState
*src
, *dst
;
1351 char *uri
= g_strdup_printf("unix:%s", mig_socket
);
1353 prepare_blkdebug_script(debug_path
, "flush_to_disk");
1355 src
= ahci_boot_and_enable("-drive file=blkdebug:%s:%s,if=none,id=drive0,"
1356 "cache=writeback,rerror=stop,werror=stop,"
1359 "-device ide-hd,drive=drive0 ",
1360 debug_path
, tmp_path
, imgfmt
);
1361 dst
= ahci_boot("-drive file=%s,if=none,id=drive0,"
1362 "cache=writeback,rerror=stop,werror=stop,"
1365 "-device ide-hd,drive=drive0 "
1366 "-incoming %s", tmp_path
, imgfmt
, uri
);
1368 px
= ahci_port_select(src
);
1369 ahci_port_clear(src
, px
);
1371 /* Dirty device so that flush reaches disk */
1372 make_dirty(src
, px
);
1374 /* Issue Flush Command */
1375 cmd
= ahci_command_create(CMD_FLUSH_CACHE
);
1376 ahci_command_commit(src
, cmd
, px
);
1377 ahci_command_issue_async(src
, cmd
);
1378 qtest_qmp_eventwait(src
->parent
->qts
, "STOP");
1381 ahci_migrate(src
, dst
, uri
);
1383 /* Complete the command */
1384 qtest_qmp_send(dst
->parent
->qts
, "{'execute':'cont' }");
1385 qtest_qmp_eventwait(dst
->parent
->qts
, "RESUME");
1386 ahci_command_wait(dst
, cmd
);
1387 ahci_command_verify(dst
, cmd
);
1389 ahci_command_free(cmd
);
1395 static void test_max(void)
1399 ahci
= ahci_boot_and_enable(NULL
);
1400 ahci_test_max(ahci
);
1401 ahci_shutdown(ahci
);
1404 static void test_reset(void)
1409 ahci
= ahci_boot(NULL
);
1410 ahci_test_pci_spec(ahci
);
1411 ahci_pci_enable(ahci
);
1413 for (i
= 0; i
< 2; i
++) {
1414 ahci_test_hba_spec(ahci
);
1415 ahci_hba_enable(ahci
);
1416 ahci_test_identify(ahci
);
1417 ahci_test_io_rw_simple(ahci
, 4096, 0,
1420 ahci_set(ahci
, AHCI_GHC
, AHCI_GHC_HR
);
1421 ahci_clean_mem(ahci
);
1424 ahci_shutdown(ahci
);
1427 static void test_ncq_simple(void)
1431 ahci
= ahci_boot_and_enable(NULL
);
1432 ahci_test_io_rw_simple(ahci
, 4096, 0,
1434 WRITE_FPDMA_QUEUED
);
1435 ahci_shutdown(ahci
);
1438 static int prepare_iso(size_t size
, unsigned char **buf
, char **name
)
1440 g_autofree
char *cdrom_path
= NULL
;
1441 unsigned char *patt
;
1443 int fd
= g_file_open_tmp("qtest.iso.XXXXXX", &cdrom_path
, NULL
);
1448 patt
= g_malloc(size
);
1450 /* Generate a pattern and build a CDROM image to read from */
1451 generate_pattern(patt
, size
, ATAPI_SECTOR_SIZE
);
1452 ret
= write(fd
, patt
, size
);
1453 g_assert(ret
== size
);
1455 *name
= g_strdup(cdrom_path
);
1460 static void remove_iso(int fd
, char *name
)
1467 static int ahci_cb_cmp_buff(AHCIQState
*ahci
, AHCICommand
*cmd
,
1468 const AHCIOpts
*opts
)
1470 unsigned char *tx
= opts
->opaque
;
1477 rx
= g_malloc0(opts
->size
);
1478 qtest_bufread(ahci
->parent
->qts
, opts
->buffer
, rx
, opts
->size
);
1479 g_assert_cmphex(memcmp(tx
, rx
, opts
->size
), ==, 0);
1485 static void ahci_test_cdrom(int nsectors
, bool dma
, uint8_t cmd
,
1486 bool override_bcl
, uint16_t bcl
)
1493 .size
= ((uint64_t)ATAPI_SECTOR_SIZE
* nsectors
),
1496 .post_cb
= ahci_cb_cmp_buff
,
1497 .set_bcl
= override_bcl
,
1500 uint64_t iso_size
= (uint64_t)ATAPI_SECTOR_SIZE
* (nsectors
+ 1);
1502 /* Prepare ISO and fill 'tx' buffer */
1503 fd
= prepare_iso(iso_size
, &tx
, &iso
);
1506 /* Standard startup wonkery, but use ide-cd and our special iso file */
1507 ahci
= ahci_boot_and_enable("-drive if=none,id=drive0,file=%s,format=raw "
1509 "-device ide-cd,drive=drive0 ", iso
);
1511 /* Build & Send AHCI command */
1512 ahci_exec(ahci
, ahci_port_select(ahci
), cmd
, &opts
);
1516 ahci_shutdown(ahci
);
1517 remove_iso(fd
, iso
);
1520 static void ahci_test_cdrom_read10(int nsectors
, bool dma
)
1522 ahci_test_cdrom(nsectors
, dma
, CMD_ATAPI_READ_10
, false, 0);
1525 static void test_cdrom_dma(void)
1527 ahci_test_cdrom_read10(1, true);
1530 static void test_cdrom_dma_multi(void)
1532 ahci_test_cdrom_read10(3, true);
1535 static void test_cdrom_pio(void)
1537 ahci_test_cdrom_read10(1, false);
1540 static void test_cdrom_pio_multi(void)
1542 ahci_test_cdrom_read10(3, false);
1545 /* Regression test: Test that a READ_CD command with a BCL of 0 but a size of 0
1546 * completes as a NOP instead of erroring out. */
1547 static void test_atapi_bcl(void)
1549 ahci_test_cdrom(0, false, CMD_ATAPI_READ_CD
, true, 0);
1553 static void atapi_wait_tray(AHCIQState
*ahci
, bool open
)
1555 QDict
*rsp
= qtest_qmp_eventwait_ref(ahci
->parent
->qts
,
1556 "DEVICE_TRAY_MOVED");
1557 QDict
*data
= qdict_get_qdict(rsp
, "data");
1559 g_assert(qdict_get_bool(data
, "tray-open"));
1561 g_assert(!qdict_get_bool(data
, "tray-open"));
1566 static void test_atapi_tray(void)
1572 uint8_t port
, sense
, asc
;
1573 uint64_t iso_size
= ATAPI_SECTOR_SIZE
;
1576 fd
= prepare_iso(iso_size
, &tx
, &iso
);
1577 ahci
= ahci_boot_and_enable("-blockdev node-name=drive0,driver=file,filename=%s "
1579 "-device ide-cd,id=cd0,drive=drive0 ", iso
);
1580 port
= ahci_port_select(ahci
);
1582 ahci_atapi_eject(ahci
, port
);
1583 atapi_wait_tray(ahci
, true);
1585 ahci_atapi_load(ahci
, port
);
1586 atapi_wait_tray(ahci
, false);
1589 qtest_qmp_send(ahci
->parent
->qts
, "{'execute': 'blockdev-open-tray', "
1590 "'arguments': {'id': 'cd0'}}");
1591 atapi_wait_tray(ahci
, true);
1592 rsp
= qtest_qmp_receive(ahci
->parent
->qts
);
1595 qtest_qmp_assert_success(ahci
->parent
->qts
,
1596 "{'execute': 'blockdev-remove-medium', "
1597 "'arguments': {'id': 'cd0'}}");
1599 /* Test the tray without a medium */
1600 ahci_atapi_load(ahci
, port
);
1601 atapi_wait_tray(ahci
, false);
1603 ahci_atapi_eject(ahci
, port
);
1604 atapi_wait_tray(ahci
, true);
1606 /* Re-insert media */
1607 qtest_qmp_assert_success(
1609 "{'execute': 'blockdev-add', "
1610 "'arguments': {'node-name': 'node0', "
1612 "'file': { 'driver': 'file', "
1613 "'filename': %s }}}", iso
);
1614 qtest_qmp_assert_success(
1616 "{'execute': 'blockdev-insert-medium',"
1617 "'arguments': { 'id': 'cd0', "
1618 "'node-name': 'node0' }}");
1620 /* Again, the event shows up first */
1621 qtest_qmp_send(ahci
->parent
->qts
, "{'execute': 'blockdev-close-tray', "
1622 "'arguments': {'id': 'cd0'}}");
1623 atapi_wait_tray(ahci
, false);
1624 rsp
= qtest_qmp_receive(ahci
->parent
->qts
);
1627 /* Now, to convince ATAPI we understand the media has changed... */
1628 ahci_atapi_test_ready(ahci
, port
, false, SENSE_NOT_READY
);
1629 ahci_atapi_get_sense(ahci
, port
, &sense
, &asc
);
1630 g_assert_cmpuint(sense
, ==, SENSE_NOT_READY
);
1631 g_assert_cmpuint(asc
, ==, ASC_MEDIUM_NOT_PRESENT
);
1633 ahci_atapi_test_ready(ahci
, port
, false, SENSE_UNIT_ATTENTION
);
1634 ahci_atapi_get_sense(ahci
, port
, &sense
, &asc
);
1635 g_assert_cmpuint(sense
, ==, SENSE_UNIT_ATTENTION
);
1636 g_assert_cmpuint(asc
, ==, ASC_MEDIUM_MAY_HAVE_CHANGED
);
1638 ahci_atapi_test_ready(ahci
, port
, true, SENSE_NO_SENSE
);
1639 ahci_atapi_get_sense(ahci
, port
, &sense
, &asc
);
1640 g_assert_cmpuint(sense
, ==, SENSE_NO_SENSE
);
1642 /* Final tray test. */
1643 ahci_atapi_eject(ahci
, port
);
1644 atapi_wait_tray(ahci
, true);
1646 ahci_atapi_load(ahci
, port
);
1647 atapi_wait_tray(ahci
, false);
1651 ahci_shutdown(ahci
);
1652 remove_iso(fd
, iso
);
1655 /******************************************************************************/
1656 /* AHCI I/O Test Matrix Definitions */
1660 LEN_SIMPLE
= LEN_BEGIN
,
1667 static const char *buff_len_str
[NUM_LENGTHS
] = { "simple", "double",
1671 ADDR_MODE_BEGIN
= 0,
1672 ADDR_MODE_LBA28
= ADDR_MODE_BEGIN
,
1677 static const char *addr_mode_str
[NUM_ADDR_MODES
] = { "lba28", "lba48" };
1681 MODE_PIO
= MODE_BEGIN
,
1686 static const char *io_mode_str
[NUM_MODES
] = { "pio", "dma" };
1697 OFFSET_ZERO
= OFFSET_BEGIN
,
1703 static const char *offset_str
[NUM_OFFSETS
] = { "zero", "low", "high" };
1705 typedef struct AHCIIOTestOptions
{
1706 enum BuffLen length
;
1707 enum AddrMode address_type
;
1708 enum IOMode io_type
;
1709 enum OffsetType offset
;
1710 } AHCIIOTestOptions
;
1712 static uint64_t offset_sector(enum OffsetType ofst
,
1713 enum AddrMode addr_type
,
1725 ceil
= (addr_type
== ADDR_MODE_LBA28
) ? 0xfffffff : 0xffffffffffff;
1726 ceil
= MIN(ceil
, mb_to_sectors(test_image_size_mb
) - 1);
1727 nsectors
= buffsize
/ AHCI_SECTOR_SIZE
;
1728 return ceil
- nsectors
+ 1;
1730 g_assert_not_reached();
1735 * Table of possible I/O ATA commands given a set of enumerations.
1737 static const uint8_t io_cmds
[NUM_MODES
][NUM_ADDR_MODES
][NUM_IO_OPS
] = {
1739 [ADDR_MODE_LBA28
] = {
1740 [IO_READ
] = CMD_READ_PIO
,
1741 [IO_WRITE
] = CMD_WRITE_PIO
},
1742 [ADDR_MODE_LBA48
] = {
1743 [IO_READ
] = CMD_READ_PIO_EXT
,
1744 [IO_WRITE
] = CMD_WRITE_PIO_EXT
}
1747 [ADDR_MODE_LBA28
] = {
1748 [IO_READ
] = CMD_READ_DMA
,
1749 [IO_WRITE
] = CMD_WRITE_DMA
},
1750 [ADDR_MODE_LBA48
] = {
1751 [IO_READ
] = CMD_READ_DMA_EXT
,
1752 [IO_WRITE
] = CMD_WRITE_DMA_EXT
}
1757 * Test a Read/Write pattern using various commands, addressing modes,
1758 * transfer modes, and buffer sizes.
1760 static void test_io_rw_interface(enum AddrMode lba48
, enum IOMode dma
,
1761 unsigned bufsize
, uint64_t sector
)
1765 ahci
= ahci_boot_and_enable(NULL
);
1766 ahci_test_io_rw_simple(ahci
, bufsize
, sector
,
1767 io_cmds
[dma
][lba48
][IO_READ
],
1768 io_cmds
[dma
][lba48
][IO_WRITE
]);
1769 ahci_shutdown(ahci
);
1773 * Demultiplex the test data and invoke the actual test routine.
1775 static void test_io_interface(gconstpointer opaque
)
1777 AHCIIOTestOptions
*opts
= (AHCIIOTestOptions
*)opaque
;
1781 switch (opts
->length
) {
1789 bufsize
= 4096 * 64;
1795 g_assert_not_reached();
1798 sector
= offset_sector(opts
->offset
, opts
->address_type
, bufsize
);
1799 test_io_rw_interface(opts
->address_type
, opts
->io_type
, bufsize
, sector
);
1804 static void create_ahci_io_test(enum IOMode type
, enum AddrMode addr
,
1805 enum BuffLen len
, enum OffsetType offset
)
1808 AHCIIOTestOptions
*opts
;
1810 opts
= g_new(AHCIIOTestOptions
, 1);
1812 opts
->address_type
= addr
;
1813 opts
->io_type
= type
;
1814 opts
->offset
= offset
;
1816 name
= g_strdup_printf("ahci/io/%s/%s/%s/%s",
1818 addr_mode_str
[addr
],
1820 offset_str
[offset
]);
1822 if ((addr
== ADDR_MODE_LBA48
) && (offset
== OFFSET_HIGH
) &&
1823 (mb_to_sectors(test_image_size_mb
) <= 0xFFFFFFF)) {
1824 g_test_message("%s: skipped; test image too small", name
);
1830 qtest_add_data_func(name
, opts
, test_io_interface
);
1834 /******************************************************************************/
1836 int main(int argc
, char **argv
)
1838 const char *arch
, *base
;
1844 static struct option long_options
[] = {
1845 {"pedantic", no_argument
, 0, 'p' },
1849 /* Should be first to utilize g_test functionality, So we can see errors. */
1850 g_test_init(&argc
, &argv
, NULL
);
1853 c
= getopt_long(argc
, argv
, "", long_options
, NULL
);
1864 fprintf(stderr
, "Unrecognized ahci_test option.\n");
1865 g_assert_not_reached();
1869 /* Check architecture */
1870 arch
= qtest_get_arch();
1871 if (strcmp(arch
, "i386") && strcmp(arch
, "x86_64")) {
1872 g_test_message("Skipping test for non-x86");
1877 * "base" stores the starting point where we create temporary files.
1879 * On Windows, this is set to the relative path of current working
1880 * directory, because the absolute path causes the blkdebug filename
1881 * parser fail to parse "blkdebug:path/to/config:path/to/image".
1884 base
= g_get_tmp_dir();
1889 /* Create a temporary image */
1890 tmp_path
= g_strdup_printf("%s/qtest.XXXXXX", base
);
1891 fd
= g_mkstemp(tmp_path
);
1893 if (have_qemu_img()) {
1895 test_image_size_mb
= TEST_IMAGE_SIZE_MB_LARGE
;
1896 mkqcow2(tmp_path
, TEST_IMAGE_SIZE_MB_LARGE
);
1898 g_test_message("QTEST_QEMU_IMG not set or qemu-img missing; "
1899 "skipping LBA48 high-sector tests");
1901 test_image_size_mb
= TEST_IMAGE_SIZE_MB_SMALL
;
1902 ret
= ftruncate(fd
, test_image_size_mb
* 1024 * 1024);
1907 /* Create temporary blkdebug instructions */
1908 debug_path
= g_strdup_printf("%s/qtest-blkdebug.XXXXXX", base
);
1909 fd
= g_mkstemp(debug_path
);
1913 /* Reserve a hollow file to use as a socket for migration tests */
1914 fd
= g_file_open_tmp("qtest-migration.XXXXXX", &mig_socket
, NULL
);
1919 qtest_add_func("/ahci/sanity", test_sanity
);
1920 qtest_add_func("/ahci/pci_spec", test_pci_spec
);
1921 qtest_add_func("/ahci/pci_enable", test_pci_enable
);
1922 qtest_add_func("/ahci/hba_spec", test_hba_spec
);
1923 qtest_add_func("/ahci/hba_enable", test_hba_enable
);
1924 qtest_add_func("/ahci/identify", test_identify
);
1926 for (i
= MODE_BEGIN
; i
< NUM_MODES
; i
++) {
1927 for (j
= ADDR_MODE_BEGIN
; j
< NUM_ADDR_MODES
; j
++) {
1928 for (k
= LEN_BEGIN
; k
< NUM_LENGTHS
; k
++) {
1929 for (m
= OFFSET_BEGIN
; m
< NUM_OFFSETS
; m
++) {
1930 create_ahci_io_test(i
, j
, k
, m
);
1936 qtest_add_func("/ahci/io/dma/lba28/fragmented", test_dma_fragmented
);
1938 qtest_add_func("/ahci/flush/simple", test_flush
);
1939 qtest_add_func("/ahci/flush/retry", test_flush_retry
);
1940 qtest_add_func("/ahci/flush/migrate", test_flush_migrate
);
1942 qtest_add_func("/ahci/migrate/sanity", test_migrate_sanity
);
1943 qtest_add_func("/ahci/migrate/dma/simple", test_migrate_dma
);
1944 qtest_add_func("/ahci/io/dma/lba28/retry", test_halted_dma
);
1945 qtest_add_func("/ahci/migrate/dma/halted", test_migrate_halted_dma
);
1947 qtest_add_func("/ahci/max", test_max
);
1948 qtest_add_func("/ahci/reset", test_reset
);
1950 qtest_add_func("/ahci/io/ncq/simple", test_ncq_simple
);
1951 qtest_add_func("/ahci/migrate/ncq/simple", test_migrate_ncq
);
1952 qtest_add_func("/ahci/io/ncq/retry", test_halted_ncq
);
1953 qtest_add_func("/ahci/migrate/ncq/halted", test_migrate_halted_ncq
);
1955 qtest_add_func("/ahci/cdrom/dma/single", test_cdrom_dma
);
1956 qtest_add_func("/ahci/cdrom/dma/multi", test_cdrom_dma_multi
);
1957 qtest_add_func("/ahci/cdrom/pio/single", test_cdrom_pio
);
1958 qtest_add_func("/ahci/cdrom/pio/multi", test_cdrom_pio_multi
);
1960 qtest_add_func("/ahci/cdrom/pio/bcl", test_atapi_bcl
);
1961 qtest_add_func("/ahci/cdrom/eject", test_atapi_tray
);