Explain the values of Serial ATA drives, memory cards, disc drives, and Bluetooth accessories - #14
Open
hideouts-io wants to merge 8 commits into
Open
hideouts-io wants to merge 8 commits into
hideouts-io wants to merge 8 commits into
Conversation
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
marked this pull request as ready for review
October 2, 2026 01:00
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Builds on
mainafter #13. The working plan was inPLAN.md, one commit per step; the last commit removes it again, as with #10.docs/value-inventory.mdcomes 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:
PCIas the interconnect is marked as an inference, with its reasons.AACPis marked as an inference because Apple doesn't document it. Short field explanations are added for the battery and service fields.docs/value-explanations.mdlists each value with its status, its source, and whether its spelling is confirmed. The spellings come from:resources/macos/system_profiler), XML output from older macOS releases whose keys and values match-jsonsystem_profiler SPBluetoothDataType -json, such as the Toothpick extension in raycast/extensions, and a published accessory in [Toothpick] Device Support Form - Logitech MX Master 3S raycast/extensions#5860The same samples confirm some storage spellings that were unconfirmed:
MS-DOS FAT32,Not Supported,master_boot_record_partition_map_type, and theEFI,Apple_HFS,Apple_Boot, andApple_CoreStoragepartition types.Docs fix. The list of values that need a scan lived in
PLAN.md, which was removed after #10, sodocs/value-explanations.mdpointed 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 thanAppleShipping, theUSB,FireWire, andSCSIconnections, and a drive with a disc inserted; Bluetooth service names other thanBLE, accessory types beyond the published ones, and whether current macOS still reportsTrackpad. 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 inValueCatalogTeststhat check every listed value has every part, andDriveAndAccessoryValueTestsfor the values that change the status or must not be guessed)Privacy review