ahci: print the number of implemented ports
authorNiklas Cassel <cassel@kernel.org>
Mon, 19 Feb 2024 20:47:43 +0000 (21:47 +0100)
committerNiklas Cassel <cassel@kernel.org>
Wed, 21 Feb 2024 18:13:43 +0000 (19:13 +0100)
We are currently printing the CAP.NP field.
CAP.NP is a 0's based value indicating the maximum number of ports
supported by the HBA silicon. Note that the number of ports indicated
in this field may be more than the number of ports indicated in the
PI (ports implemented) register. (See AHCI 1.3.1, section 3.1.1 -
Offset 00h: CAP – HBA Capabilities.)

PI (ports implemented) register is a field that has a bit set to '1'
if that specific port is implemented. This register is allowed to have
zeroes mixed with ones, i.e. a port in the middle is allowed to be
unimplemented. (See AHCI 1.3.1, section 3.1.4 - Offset 0Ch: PI – Ports
Implemented.)

Since the number of ports implemented might be smaller than the maximum
number of ports supported by the HBA silicon, print the number of
implemented ports as well.

While at it, clarify the properties being printed, and add a separator
(,), as that is currently missing, making it very easy to get confused
if the number before or after <property> belongs to <property>.

before:
ahci 0000:00:03.0: masking port_map 0x3f -> 0x2f
ahci 0000:00:03.0: AHCI 0001.0000 32 slots 6 ports 1.5 Gbps 0x2f impl SATA mode
ahci 0000:00:03.0: flags: 64bit ncq only

after:
ahci 0000:00:03.0: masking port_map 0x3f -> 0x2f
ahci 0000:00:03.0: AHCI vers 0001.0000, 32 command slots, 1.5 Gbps, SATA mode
ahci 0000:00:03.0: 5/6 ports implemented (port mask 0x2f)
ahci 0000:00:03.0: flags: 64bit ncq only

Suggested-by: Damien Le Moal <dlemoal@kernel.org>
Reviewed-by: Damien Le Moal <dlemoal@kernel.org>
Signed-off-by: Niklas Cassel <cassel@kernel.org>
drivers/ata/libahci.c

index fca376f03c9e3795cf2b7bc1cb931bc7438de1e8..83431aae74d8b1648b59e2a7e4d3a61b82e642b4 100644 (file)
@@ -2620,8 +2620,8 @@ void ahci_print_info(struct ata_host *host, const char *scc_s)
                speed_s = "?";
 
        dev_info(host->dev,
-               "AHCI %02x%02x.%02x%02x "
-               "%u slots %u ports %s Gbps 0x%x impl %s mode\n"
+               "AHCI vers %02x%02x.%02x%02x, "
+               "%u command slots, %s Gbps, %s mode\n"
                ,
 
                (vers >> 24) & 0xff,
@@ -2630,11 +2630,17 @@ void ahci_print_info(struct ata_host *host, const char *scc_s)
                vers & 0xff,
 
                ((cap >> 8) & 0x1f) + 1,
-               (cap & 0x1f) + 1,
                speed_s,
-               impl,
                scc_s);
 
+       dev_info(host->dev,
+               "%u/%u ports implemented (port mask 0x%x)\n"
+               ,
+
+               hweight32(impl),
+               (cap & 0x1f) + 1,
+               impl);
+
        dev_info(host->dev,
                "flags: "
                "%s%s%s%s%s%s%s"