Skip to main content

CircuitPython library for SD cards.

Project description

Introduction

Documentation Status Discord Build Status Code Style: Ruff

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.30.tar.gz (26.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

adafruit_circuitpython_sd-3.3.30-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file adafruit_circuitpython_sd-3.3.30.tar.gz.

File metadata

File hashes

Hashes for adafruit_circuitpython_sd-3.3.30.tar.gz
Algorithm Hash digest
SHA256 bee3fd061b4be29d046924012f3be0e1d81be8265139dd7e5b390d02060ce7e0
MD5 d604b235a0a12b4177e4e8ba036cf82f
BLAKE2b-256 fa19fc6d83cbe1f385fdceb8d87559f86a70541f37ce3f3bdff47de03b5f7edb

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for adafruit_circuitpython_sd-3.3.30-py3-none-any.whl
Algorithm Hash digest
SHA256 3087647e875cf967b3bb2cd61e49d9202d315cbb44ff5c4ece070223610b56c5
MD5 a41e6611c6abf2f18c816c77b86946de
BLAKE2b-256 aa8cb698fde2dd8d43dd9fb0bccc7aed3ec599e8b304e365ef346aab09bcf381

See more details on using hashes here.

Supported by

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