Introduction
CircuitPython driver for SD cards. This implements the basic reading and writing block functionality needed to mount an SD card using storage.VfsFat.
Dependencies
This driver depends on:
Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloading the Adafruit library and driver bundle.
Usage Example
Mounting a filesystem on an SD card so that its available through the normal Python ways is easy.
Below is an example for the Feather M0 Adalogger. Most of this will stay the same across different boards with the exception of the pins for the SPI and chip select (cs) connections.
import adafruit_sdcard
import busio
import digitalio
import board
import storage
# Connect to the card and mount the filesystem.
spi = busio.SPI(board.SCK, board.MOSI, board.MISO)
cs = digitalio.DigitalInOut(board.SD_CS)
sdcard = adafruit_sdcard.SDCard(spi, cs)
vfs = storage.VfsFat(sdcard)
storage.mount(vfs, "/sd")
# Use the filesystem as normal.
with open("/sd/test.txt", "w") as f:
f.write("Hello world\n")Sharing the SPI bus with other devices
Documentation
API documentation for this library can be found on Read the Docs.
For information on building library documentation, please check out this guide.
Contributing
Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.
1 maintainer
Metadata
1 maintainer
Release files for adafruit-circuitpython-sd 3.3.30
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| adafruit_circuitpython_sd-3.3.30.tar.gz | 26.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| adafruit_circuitpython_sd-3.3.30-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 35.7 kB
Release files / adafruit_circuitpython_sd-3.3.30.tar.gz
| Download URL | adafruit_circuitpython_sd-3.3.30.tar.gz |
|---|---|
| Size | 26.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bee3fd061b4be29d046924012f3be0e1d81be8265139dd7e5b390d02060ce7e0
|
|
BLAKE2b-256 checksum How to use checksums |
fa19fc6d83cbe1f385fdceb8d87559f86a70541f37ce3f3bdff47de03b5f7edb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
Release files / adafruit_circuitpython_sd-3.3.30-py3-none-any.whl
| Download URL | adafruit_circuitpython_sd-3.3.30-py3-none-any.whl |
|---|---|
| Size | 8.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3087647e875cf967b3bb2cd61e49d9202d315cbb44ff5c4ece070223610b56c5
|
|
BLAKE2b-256 checksum How to use checksums |
aa8cb698fde2dd8d43dd9fb0bccc7aed3ec599e8b304e365ef346aab09bcf381
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.15
|
