Host Operating System Support
The SD-form-factor modules enumerate as standard block-storage devices, so no drivers are required on any operating system that supports the SD protocol. What differs per OS is how you identify the device, whether the flashing toolkit is validated, and how a host application opens the raw block device.
Support matrix
| Capability | Linux | macOS | Windows | Embedded (MCU / PLC) |
|---|---|---|---|---|
| Device enumeration (no drivers) | Yes | Yes | Yes | Yes (SD or SD-over-SPI) |
| Identify the device | lsblk | diskutil list | diskpart | N/A |
Flash with C0_microSD_toolkit.py | Yes | Yes | Not supported | N/A |
| Host application (raw block I/O) | Yes | Yes | Untested | Yes (your firmware issues the block operations) |
Notes per platform
Linux and macOS
Raw block-device access requires root privileges: run the toolkit and host applications with
sudo. The device path is /dev/sdX on Linux and /dev/diskN on macOS. Host applications
must bypass the host page cache so that polling reads reach the module, using O_DIRECT on
Linux and the raw /dev/rdiskN counterpart of the device node on macOS. See
Host Interface and Protocol.
Windows
Identifying the device and raw-disk access via \\.\PhysicalDriveN are documented in
Identify your module;
administrator privileges are required.
Embedded hosts
Microcontrollers integrate over SD-over-SPI; single-board computers and PLCs use their SD slot. Tested hosts are listed in the C0-microSD host-compatibility table. For the Bosch Rexroth ctrlX OS, ready-made integrations exist; see Tools and Utilities.
Toolchain host support
Building applications for the modules is separate from talking to them:
- The RISC-V GNU toolchain build is documented for Linux and macOS; see Programming the C0-microSD.
- The Signaloid UxHw Toolchain and SDK supports Linux and bare-metal targets; see Tools and Utilities.
Next steps
- Compatibility, the SD host controllers and platforms tested with the module.
- Identify your module, finding the device path on your platform.
- Flash the C0-microSD, the toolkit reference, including the privileges each command needs.
- Stuck? See Troubleshooting and FAQ.