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 | Experimental, untested | N/A |
| Host application (raw block I/O) | Yes | Yes | Experimental, untested | Yes (your firmware issues the block operations) |
Signaloid has tested Windows hosts with the C0-microSD+ only. See Windows.
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
Windows hosts are experimental. Signaloid has tested them with the C0-microSD+ only, so the
notes in C0-microSD+ Host OS Support apply
to the C0-microSD without testing. Find the module with Get-Disk or diskpart, as shown in
Identify your module,
use the device path //./PhysicalDriveN, and run the toolkit and host applications from a
Git Bash window that you open with Run as administrator.
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 wiring of a microcontroller host, see Connecting to a Microcontroller over SD-over-SPI. For a CircuitPython host application, see Using a Microcontroller Host. 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.