The example shows how to use FAT over SDSPI in theCore. Hardware in question is a regular SD card connected to the Catalex micro-SD adapter.

See theCore documentation for FATFS example for more information.

Connect SPI3 (SSI3) and power to the Catalex micro-SD adapter on the LaunchPad board using following pins:

1. Install and initialize theCore (if not done previously):

   pip3 install tcore
   tcore bootstrap
   

2. Download the example:

   tcore init --remote https://github.com/theCore-embedded/example_fatfs
   

3. Step into the project directory:

   cd example_fatfs
   

tcore compile --target tiva_tm4c_launchpad

1. Launch minicom (/dev/ttyACM0 used here as an example):

   # From new terminal
   tcore runenv "minicom -D /dev/ttyACM0"
   

   Or the same, but with superuser permissions:

   # From new terminal
   tcore runenv --sudo "minicom -D /dev/ttyACM0"
   

2. Flash to the board:

   tcore flash --sudo
   

1. In minicom you should be able to see contents of the SD card root directory. For example, it can look like this:

   Welcome to theCore
   the_core v0.3.287 5045e04-dirty
   Starting FATFS example...
   #. 0 type: dir  name : HOME
   #. 1 type: dir  name : VAR
   #. 2 type: file name : TEST_FILE.TXT
   #. 3 type: file name : ANOTHER_FILE.TXT
   Which file to open?
   

2. Select a file to print into the console. File contents then will appear on the screen.