Skip to content

Explain the values of Serial ATA drives, memory cards, disc drives, and Bluetooth accessories - #14

Open
hideouts-io wants to merge 8 commits into
mainfrom
explain-drive-and-accessory-values
Open

hideouts-io wants to merge 8 commits into
mainfrom
explain-drive-and-accessory-values

Conversation

@hideouts-io

@hideouts-io hideouts-io commented Oct 2, 2026 •

Copy link
Copy Markdown
Owner

Summary

Builds on main after #13. The working plan was in PLAN.md, one commit per step; the last commit removes it again, as with #10.

docs/value-inventory.md comes from one Apple silicon Mac with no connected Bluetooth accessories, no Serial ATA drive, no disc drive, and no card in its card reader. Every limited-set field that Mac reported already has a value rule, but these sections are common on other Macs and only got the general section text. This branch explains their values, with spellings from published output.

Drives and cards. Serial ATA drives and cards in a card reader report the same drive and volume fields as NVMe drives and the Storage section. SMART status, partition map, removable and detachable media, and each volume's file system, writable state, and partition content are now explained there too. Windows_FAT_32, the partition type of a FAT32 memory card, is new. Free space stays on the Storage section, which lists the same volumes, so a shortage isn't reported twice.

Values. Every new value has a summary, what it means on this Mac, why it matters, what to check, a status, and a source. The areas covered are:

  • Serial ATA: medium type, physical interconnect, port and negotiated link speed (a link slower than its port is Info, with what that means for an SSD), Native Command Queuing, and the PCI Express link speed and width of Apple's SSD controller. PCI as the interconnect is marked as an inference, with its reasons.
  • Disc burning: how fully macOS supports burning with the drive, an empty drive, DVD reading, the connection, the CD and DVD formats it writes, and its burn strategies. Format and strategy lists are spelled out, and a list with an entry the app doesn't know is shown as not yet explained rather than partly explained.
  • Bluetooth accessories: the accessory type; the battery of the accessory, each earbud, and the charging case (10% or less is Worth a look, 11–20% Info); and the services an accessory or this Mac's Bluetooth supports. A service the app doesn't know is named as such, and AACP is marked as an inference because Apple doesn't document it. Short field explanations are added for the battery and service fields.

docs/value-explanations.md lists each value with its status, its source, and whether its spelling is confirmed. The spellings come from:

The same samples confirm some storage spellings that were unconfirmed: MS-DOS FAT32, Not Supported, master_boot_record_partition_map_type, and the EFI, Apple_HFS, Apple_Boot, and Apple_CoreStorage partition types.

Docs fix. The list of values that need a scan lived in PLAN.md, which was removed after #10, so docs/value-explanations.md pointed at a missing file. The list is now the last section of that file, updated with this branch's unconfirmed values.

Needs a scan on a real Mac: SATA link speeds other than 3 Gigabit; disc support levels other than AppleShipping, the USB, FireWire, and SCSI connections, and a drive with a disc inserted; Bluetooth service names other than BLE, accessory types beyond the published ones, and whether current macOS still reports Trackpad. A different spelling is shown as not yet explained until it's added.

Validation

  • ./scripts/check-publication-boundary.sh (before every commit)
  • xcodebuild -project SystemProfilerExplorer.xcodeproj -scheme SystemProfilerExplorer -destination 'platform=macOS' build test (CI build-and-test, including 112 new value cases in ValueCatalogTests that check every listed value has every part, and DriveAndAccessoryValueTests for the values that change the status or must not be guessed)
  • Relevant live macOS flow checked when the change affects collection or UI behavior (no Mac available here; the change adds rules only and doesn't touch collection or the UI)

Privacy review

  • No raw or full profiler report is included
  • No serial number, UUID, UDID, address, user path, installed-software list, or other host fingerprint is included
  • Test data is synthetic and screenshots are sanitized
  • New profiler interpretations state their limitations and do not label normal output as compromise without evidence

Serial ATA drives and cards in a card reader report the same drive and
volume fields as NVMe drives and the Storage section, but only got the
general section text. SMART status, partition map, file system,
writable, partition content, and removable and detachable media are now
explained there too, and Windows_FAT_32, the partition type of a FAT32
memory card, is new. The spellings come from the published macOS
samples in glpi-agent.

Free space stays on the Storage section, so a shortage isn't reported
twice for the same volume.
Covers the drive's medium type, the controller's physical interconnect,
the port and negotiated SATA link speeds, Native Command Queuing, and
the PCI Express link speed and width Apple's SSD controller reports. A
link slower than its port is explained as information, with what it
means for an SSD. PCI as the interconnect is marked as an inference,
with its reasons.
Covers how fully macOS supports burning with the drive, an empty drive,
DVD reading, the drive's connection, the CD and DVD formats it can
write, and its burn strategies. Format and strategy lists are spelled
out, and a list with an unfamiliar entry is shown as not yet explained
rather than partly explained. The support levels and connections other
than the published ones are Disc Recording constants whose spelling in
system_profiler output is unconfirmed.

Adds englishList so lists in explanations read the same in every
system language.
Most Macs have a paired keyboard, mouse, trackpad, or headphones, but
the inventory Mac had none connected, so these values had no
explanation. Covers the accessory type, the battery level of the
accessory, each earbud, and the charging case (nearly empty is worth a
look, low is information), and the services an accessory or this Mac's
Bluetooth supports. A service the app doesn't know is named as such,
and AACP is marked as an inference because Apple doesn't document it.

Adds short field explanations for the battery and service fields.
docs/value-explanations.md now lists the Serial ATA, disc burning, and
Bluetooth accessory values with their sources and spellings, and marks
the storage spellings the published samples confirm (MS-DOS FAT32, Not
Supported, the MBR partition map, and the EFI, Apple_HFS, Apple_Boot,
and Apple_CoreStorage partition types).

The list of values that need a scan on a real Mac lived in PLAN.md,
which was removed, so the docs pointed at a missing file. The list is
now the last section of docs/value-explanations.md, updated with this
branch's unconfirmed values.
The plan tracked this branch's steps and doesn't belong in the project.
The list of values that need a scan now lives in
docs/value-explanations.md.
@hideouts-io
hideouts-io marked this pull request as ready for review October 2, 2026 01:00
@hideouts-io hideouts-io self-assigned this Oct 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant