Skip to main content

CircuitPython library for SD cards.

Project description

Introduction

Documentation Status Discord Build Status Code Style: Black

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

adafruit-circuitpython-sd-3.3.21.tar.gz (30.2 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file adafruit-circuitpython-sd-3.3.21.tar.gz.

File metadata

File hashes

Hashes for adafruit-circuitpython-sd-3.3.21.tar.gz
Algorithm Hash digest
SHA256 d5da48408e2b6e06cd2decfebcdbe4616f4a52b1928bd0e53c0be4e5968a562f
MD5 18d9853781eba501380d6876e61ab28f
BLAKE2b-256 cfffa31a828fe773ccadc14f7eb6f0f8b37f9d8f9e95f18239cadb1450f628ae

See more details on using hashes here.

File details

Details for the file adafruit_circuitpython_sd-3.3.21-py3-none-any.whl.

File metadata

File hashes

Hashes for adafruit_circuitpython_sd-3.3.21-py3-none-any.whl
Algorithm Hash digest
SHA256 66b73787541e5841dd8606968f984817dc3618f64d4412eec8f58256ba696e4d
MD5 28f84eb435a743228213499d309c46aa
BLAKE2b-256 c5c2190e3f0497b799eb7fbfe8ac19c661d61ad945495eaab6f390c0d83f1cdc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page