https://github.com/adafruit/adafruit_circuitpython_sd

SD card drivers for Adafruit CircuitPython
https://github.com/adafruit/adafruit_circuitpython_sd

circuitpython hacktoberfest

Last synced: about 8 hours ago
JSON representation

SD card drivers for Adafruit CircuitPython

• Host: GitHub
• URL: https://github.com/adafruit/adafruit_circuitpython_sd
• Owner: adafruit
• License: mit
• Created: 2017-01-19T22:50:58.000Z (almost 8 years ago)
• Default Branch: main
• Last Pushed: 2024-10-07T22:19:55.000Z (3 months ago)
• Last Synced: 2024-12-16T17:51:28.387Z (6 days ago)
• Topics: circuitpython, hacktoberfest
• Language: Python
• Size: 144 KB
• Stars: 37
• Watchers: 23
• Forks: 17
• Open Issues: 3
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        

Introduction

============

.. image:: https://readthedocs.org/projects/adafruit-circuitpython-sd/badge/?version=latest

    :target: https://docs.circuitpython.org/projects/sd/en/latest/

    :alt: Documentation Status

.. image:: https://raw.githubusercontent.com/adafruit/Adafruit_CircuitPython_Bundle/main/badges/adafruit_discord.svg

    :target: https://adafru.it/discord

    :alt: Discord

.. image:: https://github.com/adafruit/Adafruit_CircuitPython_SD/workflows/Build%20CI/badge.svg

    :target: https://github.com/adafruit/Adafruit_CircuitPython_SD/actions/

    :alt: Build Status

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg

    :target: https://github.com/psf/black

    :alt: 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:

* `Adafruit CircuitPython 2.0.0+ `_

* `Bus Device `_

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.

.. code-block:: python

    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

======================================

.. important::

    If the same SPI bus is shared with other peripherals, it is important that

    the SD card be initialized before accessing any other peripheral on the bus.

    Failure to do so can prevent the SD card from being recognized until it is

    powered off or re-inserted.

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.