From 4228f03294d86d1d05cc9ddda8c47b234332c977 Mon Sep 17 00:00:00 2001
From: dequis <dx@dxzone.com.ar>
Date: Wed, 14 Jun 2023 00:28:17 +0200
Subject: [PATCH] docs: add sdcard docs

---
 docs/badge/sdcard.rst | 18 ++++++++++++++++++
 docs/index.rst        |  1 +
 2 files changed, 19 insertions(+)
 create mode 100644 docs/badge/sdcard.rst

diff --git a/docs/badge/sdcard.rst b/docs/badge/sdcard.rst
new file mode 100644
index 0000000000..6161139ac1
--- /dev/null
+++ b/docs/badge/sdcard.rst
@@ -0,0 +1,18 @@
+SD Card
+-------
+
+There's a microSD card slot on the inner side of the badge.
+
+There's no first-class firmware support for it yet, but you can mount it in the
+micropython VFS with:
+
+.. code-block:: python
+
+   import machine, os
+   sdcard = machine.SDCard(clk=47, cmd=48, d0=21)
+   os.mount(sdcard, "/sd")
+
+Filesystem support is provided by `FatFs
+<http://elm-chan.org/fsw/ff/00index_e.html>` which claims to support
+FAT16/32/exFAT. TODO: test
+
diff --git a/docs/index.rst b/docs/index.rst
index fd39b42695..92eeede974 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -12,6 +12,7 @@ Welcome to flow3r's documentation!
 
    badge/hardware_specs.rst
    badge/badge_link.rst
+   badge/sdcard.rst
 
 .. toctree::
    :maxdepth: 1
-- 
GitLab