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

Uploaded Source

Built Distribution

File details

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

File metadata

File hashes

Hashes for adafruit_circuitpython_sd-3.3.23.tar.gz
Algorithm Hash digest
SHA256 31ceecdbe6eaf1af6c0e5010d6a48e034b7c8141ce58d14c0e41af76046180ae
MD5 71d3344667cf6e517eff4119598fb46d
BLAKE2b-256 77cc15b65f38ea1304eaa3a7e83957a90c8aa6a608c0081921706726a413ed50

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for adafruit_circuitpython_sd-3.3.23-py3-none-any.whl
Algorithm Hash digest
SHA256 d150fac2b8ea1baf5f428609a1e58830398090d11c497320da67571b8f673a51
MD5 f8538be818dbaeabe2107a20d383fcc2
BLAKE2b-256 fb969b543e8a6e5db9e095deb812323ea223bb92764b6361841ec5e6a9738d9d

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