Remove GD32

dist.sh

@@ -1,14 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-set -x
-
-DATE=$(date +%Y%m%d)
-VERSION="v1.1-$DATE"
-mkdir -p dist
-rm -f dist/*.bin
-
-for f in $(ls .pio/build/*/firmware.bin); do
-    NAME="BlueSCSI-$VERSION-$(echo $f | cut -d\/ -f3).bin"
-    cp $f dist/$NAME
-done

greenpak/README.md

@@ -1,8 +0,0 @@
-GreenPAK design files
-=====================
-
-This folder contains design files for `SLG46824` programmable logic device.
-It is optionally used on BlueSCSI V1.1 to speed up access to SCSI bus. This applies to asynchronous transfers only
-
-What this logic does is implement the `REQ` / `ACK` handshake in hardware.
-The CPU only has to write new data to the GPIO, and the external logic will toggle `REQ` signal quickly.

greenpak/SCSI_Accelerator_SLG46824.gp6

@@ -1,647 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<GPDProject version="22" oldestCompatibleVersion="22" GPDVersion="6.27.001" lastChange="11.4.2022 12.26">
-    <generalProjectSettings/>
-    <chip family="04" type="06" friendlyName="GreenPAK 6" partNumber="40" package="16">
-        <nvmData registerLenght="2048">C4 9 0 0 0 0 0 0 38 C2 0 0 0 0 0 0 0 0 0 0 0 0 D0 8 13 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 E7 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 30 70 0 30 20 30 30 0 0 30 30 30 0 30 30 30 30 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 14 22 30 C 0 0 0 0 0 0 0 6 0 0 0 0 0 0 0 0 0 40 0 0 0 0 0 0 D7 14 20 0 1 0 0 0 2 1 0 0 2 0 1 0 0 2 1 0 0 2 0 1 0 0 2 1 0 0 2 0 1 0 0 2 0 1 0 0 0 1 1 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 A5</nvmData>
-        <checksum crc32="0xB44E9FD4" version="5"/>
-        <VDDItem id="0">
-            <item id="0" caption="VDD (PIN 20)">
-                <graphics pos="(-590.00,30.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-            </item>
-        </VDDItem>
-        <IOPad id="1" useCaseMode="0">
-            <item id="1" caption="PIN 19 (IO0)">
-                <graphics pos="(-590.00,100.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-19.10,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">PLD_IO0 / CLK</textLabel>
-            </item>
-        </IOPad>
-        <IOPad id="2" useCaseMode="1">
-            <item id="2" caption="PIN 18 (IO1)">
-                <graphics pos="(-248.00,278.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-45.56,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">PLD_IO1 / DATA_TOGGLE</textLabel>
-            </item>
-        </IOPad>
-        <IOPad id="3" useCaseMode="1">
-            <item id="3" caption="PIN 17 (IO2)">
-                <graphics pos="(-251.00,504.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-29.23,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">PLD_IO2 / ENABLE</textLabel>
-            </item>
-        </IOPad>
-        <IOPad id="4" useCaseMode="1">
-            <item id="4" caption="PIN 16 (IO3)">
-                <graphics pos="(-249.00,197.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-25.28,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">PLD_IO3 / RDWR</textLabel>
-            </item>
-        </IOPad>
-        <IOPad id="5" useCaseMode="0">
-            <item id="5" caption="PIN 15 (IO4)">
-                <graphics pos="(-590.00,380.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-4.71,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">PLD_IO4</textLabel>
-            </item>
-        </IOPad>
-        <IOPad id="6" useCaseMode="0">
-            <item id="6" caption="PIN 14 (IO5)">
-                <graphics pos="(-595.00,464.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-4.71,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">PLD_IO5</textLabel>
-            </item>
-        </IOPad>
-        <IOPad id="7" useCaseMode="1">
-            <item id="7" caption="PIN 13 (SCL)">
-                <graphics pos="(-764.00,671.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-            </item>
-        </IOPad>
-        <IOPad id="8" useCaseMode="1">
-            <item id="8" caption="PIN 12 (SDA)">
-                <graphics pos="(-764.00,701.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-            </item>
-        </IOPad>
-        <IOPad id="9" useCaseMode="0">
-            <item id="9" caption="PIN 11 (IO6)">
-                <graphics pos="(149.00,672.00)" angle="270" flipping="2" hidden="0" tOrigin="(20.00,10.00)"/>
-            </item>
-        </IOPad>
-        <item id="10" caption="GND (PIN 10)">
-            <graphics pos="(770.00,380.00)" angle="0" flipping="1" hidden="0" tOrigin="(20.00,10.00)"/>
-        </item>
-        <IOPad id="11" useCaseMode="0">
-            <item id="11" caption="PIN 9 (IO7)">
-                <graphics pos="(758.00,300.00)" angle="0" flipping="1" hidden="0" tOrigin="(20.00,10.00)"/>
-            </item>
-        </IOPad>
-        <IOPad id="12" useCaseMode="0">
-            <item id="12" caption="PIN 8 (IO8)">
-                <graphics pos="(692.00,505.00)" angle="0" flipping="1" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-4.71,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">PLD_IO8</textLabel>
-            </item>
-        </IOPad>
-        <VDDItem id="13">
-            <item id="13" caption="VDD2 (PIN 7)">
-                <graphics pos="(770.00,170.00)" angle="0" flipping="1" hidden="0" tOrigin="(20.00,10.00)"/>
-            </item>
-        </VDDItem>
-        <IOPad id="14" useCaseMode="0">
-            <item id="14" caption="PIN 6 (IO9)">
-                <graphics pos="(636.00,631.00)" angle="0" flipping="1" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-4.71,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">PLD_IO9</textLabel>
-            </item>
-        </IOPad>
-        <IOPad id="15" useCaseMode="0">
-            <item id="15" caption="PIN 5 (IO10)">
-                <graphics pos="(770.00,30.00)" angle="0" flipping="1" hidden="0" tOrigin="(20.00,10.00)"/>
-            </item>
-        </IOPad>
-        <IOPad id="16" useCaseMode="0">
-            <item id="16" caption="PIN 4 (IO11)">
-                <graphics pos="(300.00,-90.00)" angle="270" flipping="1" hidden="0" tOrigin="(20.00,10.00)"/>
-            </item>
-        </IOPad>
-        <IOPad id="17" useCaseMode="0">
-            <item id="17" caption="PIN 3 (IO12)">
-                <graphics pos="(150.00,-90.00)" angle="270" flipping="1" hidden="0" tOrigin="(20.00,10.00)"/>
-            </item>
-        </IOPad>
-        <IOPad id="18" useCaseMode="4">
-            <item id="18" caption="PIN 2 (IO13)">
-                <graphics pos="(411.00,320.00)" angle="0" flipping="1" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-7.69,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">OUT_REQ</textLabel>
-            </item>
-        </IOPad>
-        <IOPad id="19" useCaseMode="1">
-            <item id="19" caption="PIN 1 (IO14)">
-                <graphics pos="(-250.00,387.00)" angle="0" flipping="0" hidden="0" tOrigin="(20.00,10.00)"/>
-                <textLabel pos="(-6.55,-27.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">ACK_BUF</textLabel>
-            </item>
-        </IOPad>
-        <item id="22" caption="A CMP0L">
-            <graphics pos="(50.00,130.00)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,28.00)"/>
-        </item>
-        <item id="23" caption="A CMP1L">
-            <graphics pos="(150.00,130.00)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,28.00)"/>
-        </item>
-        <item id="24" caption="P DLY">
-            <graphics pos="(320.00,320.00)" angle="0" flipping="0" hidden="1" tOrigin="(17.50,10.00)"/>
-        </item>
-        <item id="26" caption="VREF">
-            <graphics pos="(320.00,190.00)" angle="0" flipping="0" hidden="1" tOrigin="(17.50,10.00)"/>
-        </item>
-        <item id="27" caption="POR">
-            <graphics pos="(320.00,260.00)" angle="0" flipping="0" hidden="1" tOrigin="(17.50,10.00)"/>
-        </item>
-        <item id="28" caption="OSC0">
-            <graphics pos="(-70.00,100.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,40.00)"/>
-        </item>
-        <item id="29" caption="OSC1">
-            <graphics pos="(-70.00,200.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,25.00)"/>
-        </item>
-        <item id="30" caption="OSC2">
-            <graphics pos="(-70.00,270.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,20.00)"/>
-        </item>
-        <item id="31" caption="I2C">
-            <graphics pos="(-674.00,652.00)" angle="0" flipping="0" hidden="0" tOrigin="(25.00,45.00)"/>
-        </item>
-        <item id="33" caption="FILTER/EDGE DET">
-            <graphics pos="(320.00,440.00)" angle="0" flipping="0" hidden="1" tOrigin="(27.50,15.00)"/>
-        </item>
-        <item id="34" caption="BG">
-            <graphics pos="(320.00,30.00)" angle="0" flipping="0" hidden="1" tOrigin="(17.50,10.00)"/>
-        </item>
-        <LUT id="35" regularShape="0" mode="0">
-            <item id="35" caption="2-bit LUT0/DFF/LATCH0">
-                <graphics pos="(-88.00,177.00)" angle="90" flipping="0" hidden="0" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <LUT id="36" regularShape="0" mode="0">
-            <item id="36" caption="2-bit LUT1/DFF/LATCH1">
-                <graphics pos="(40.00,370.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <LUT id="37" regularShape="0" mode="0">
-            <item id="37" caption="2-bit LUT2/DFF/LATCH2">
-                <graphics pos="(40.00,430.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <LUT id="38" regularShape="0" mode="0">
-            <item id="38" caption="2-bit LUT3/PGEN">
-                <graphics pos="(130.00,250.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <LUT id="39" regularShape="0" mode="0">
-            <item id="39" caption="3-bit LUT0/DFF/LATCH3">
-                <graphics pos="(130.00,310.00)" angle="90" flipping="1" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <item id="40" caption="3-bit LUT1/DFF/LATCH4">
-            <graphics pos="(19.00,176.00)" angle="0" flipping="0" hidden="0" tOrigin="(25.00,10.00)"/>
-            <textLabel pos="(-15.00,-40.00)" angle="0.00" textColor="#ffff00ff" backgroundColor="#14141464">Previous
-DATA_TOGGLE</textLabel>
-        </item>
-        <LUT id="41" regularShape="0" mode="0">
-            <item id="41" caption="3-bit LUT2/DFF/LATCH5">
-                <graphics pos="(130.00,430.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <LUT id="42" regularShape="0" mode="0">
-            <item id="42" caption="3-bit LUT3/DFF/LATCH6">
-                <graphics pos="(210.00,250.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <LUT id="43" regularShape="0" mode="0">
-            <item id="43" caption="3-bit LUT4/DFF/LATCH7">
-                <graphics pos="(210.00,310.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <LUT id="44" regularShape="0" mode="0">
-            <item id="44" caption="3-bit LUT5/DFF/LATCH8">
-                <graphics pos="(210.00,370.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <LUT id="45" regularShape="0" mode="0">
-            <item id="45" caption="3-bit LUT6/Pipe Delay/Ripple Counter">
-                <graphics pos="(210.00,430.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <item id="46" caption="MF0 (4-bit LUT0, DFF/LATCH9, 16-bit CNT0/DLY0/FSM0)">
-            <graphics pos="(-399.00,35.00)" angle="0" flipping="0" hidden="1" tOrigin="(155.00,60.00)"/>
-        </item>
-        <item id="47" caption="MF1 (3-bit LUT7, DFF/LATCH10, 8-bit CNT1/DLY1)">
-            <graphics pos="(-500.00,140.00)" angle="0" flipping="0" hidden="1" tOrigin="(155.00,60.00)"/>
-        </item>
-        <item id="48" caption="MF2 (3-bit LUT8, DFF/LATCH11, 8-bit CNT2/DLY2)">
-            <graphics pos="(-500.00,300.00)" angle="0" flipping="0" hidden="1" tOrigin="(155.00,60.00)"/>
-        </item>
-        <item id="49" caption="MF3 (3-bit LUT9, DFF/LATCH12, 8-bit CNT3/DLY3)">
-            <graphics pos="(-500.00,460.00)" angle="0" flipping="0" hidden="1" tOrigin="(155.00,60.00)"/>
-        </item>
-        <item id="50" caption="MF4 (3-bit LUT10, DFF/LATCH13, 8-bit CNT4/DLY4)">
-            <graphics pos="(430.00,-30.00)" angle="0" flipping="0" hidden="1" tOrigin="(155.00,60.00)"/>
-        </item>
-        <item id="51" caption="MF5 (3-bit LUT11, DFF/LATCH14, 8-bit CNT5/DLY5)">
-            <graphics pos="(430.00,130.00)" angle="0" flipping="0" hidden="1" tOrigin="(155.00,60.00)"/>
-        </item>
-        <item id="52" caption="MF6 (3-bit LUT12, DFF/LATCH15, 8-bit CNT6/DLY6)">
-            <graphics pos="(430.00,290.00)" angle="0" flipping="0" hidden="1" tOrigin="(155.00,60.00)"/>
-        </item>
-        <item id="53" caption="MF7 (3-bit LUT13, DFF/LATCH16, 8-bit CNT7/DLY7)">
-            <graphics pos="(430.00,450.00)" angle="0" flipping="0" hidden="1" tOrigin="(155.00,60.00)"/>
-        </item>
-        <LUT id="54" regularShape="0" mode="0">
-            <item id="54" caption="4-bit LUT0 (MF0)">
-                <graphics pos="(136.00,310.00)" angle="90" flipping="0" hidden="0" tOrigin="(20.00,15.00)"/>
-                <textLabel pos="(46.00,52.19)" angle="-90.00" textColor="#ffff00ff" backgroundColor="#14141464">IN3 = 0 (Write to SCSI bus): !(IN0 &amp; (IN1 ^ IN2))
-IN3 = 1 (Read from SCSI bus): (!IN0) &amp; (IN1 ^ IN2)</textLabel>
-            </item>
-        </LUT>
-        <item id="55" caption="DFF/LATCH9 (MF0)">
-            <graphics pos="(-357.50,94.50)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,10.00)"/>
-        </item>
-        <CNTDLY id="56" externalClockFrequence="0" externalClockFreqUnit="kHz">
-            <item id="56" caption="16-bit CNT0/DLY0/FSM0 (MF0)">
-                <graphics pos="(-208.50,87.50)" angle="0" flipping="0" hidden="1" tOrigin="(35.00,16.00)"/>
-            </item>
-        </CNTDLY>
-        <LUT id="57" regularShape="0" mode="0">
-            <item id="57" caption="3-bit LUT7 (MF1)">
-                <graphics pos="(-365.00,185.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <item id="58" caption="DFF/LATCH10 (MF1)">
-            <graphics pos="(-450.00,130.00)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,10.00)"/>
-        </item>
-        <CNTDLY id="59" externalClockFrequence="0" externalClockFreqUnit="kHz">
-            <item id="59" caption="8-bit CNT1/DLY1 (MF1)">
-                <graphics pos="(-450.00,130.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,16.00)"/>
-            </item>
-        </CNTDLY>
-        <LUT id="60" regularShape="0" mode="0">
-            <item id="60" caption="3-bit LUT8 (MF2)">
-                <graphics pos="(-365.00,345.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <item id="61" caption="DFF/LATCH11 (MF2)">
-            <graphics pos="(-550.00,300.00)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,10.00)"/>
-        </item>
-        <CNTDLY id="62" externalClockFrequence="0" externalClockFreqUnit="kHz">
-            <item id="62" caption="8-bit CNT2/DLY2 (MF2)">
-                <graphics pos="(-550.00,300.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,16.00)"/>
-            </item>
-        </CNTDLY>
-        <LUT id="63" regularShape="0" mode="0">
-            <item id="63" caption="3-bit LUT9 (MF3)">
-                <graphics pos="(-365.00,505.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <item id="64" caption="DFF/LATCH12 (MF3)">
-            <graphics pos="(-730.00,460.00)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,10.00)"/>
-        </item>
-        <CNTDLY id="65" externalClockFrequence="0" externalClockFreqUnit="kHz">
-            <item id="65" caption="8-bit CNT3/DLY3 (MF3)">
-                <graphics pos="(-730.00,460.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,16.00)"/>
-            </item>
-        </CNTDLY>
-        <LUT id="66" regularShape="0" mode="0">
-            <item id="66" caption="3-bit LUT10 (MF4)">
-                <graphics pos="(565.00,15.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <item id="67" caption="DFF/LATCH13 (MF4)">
-            <graphics pos="(660.00,-210.00)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,10.00)"/>
-        </item>
-        <CNTDLY id="68" externalClockFrequence="0" externalClockFreqUnit="kHz">
-            <item id="68" caption="8-bit CNT4/DLY4 (MF4)">
-                <graphics pos="(660.00,-210.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,16.00)"/>
-            </item>
-        </CNTDLY>
-        <LUT id="69" regularShape="0" mode="0">
-            <item id="69" caption="3-bit LUT11 (MF5)">
-                <graphics pos="(565.00,175.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <item id="70" caption="DFF/LATCH14 (MF5)">
-            <graphics pos="(500.00,-50.00)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,10.00)"/>
-        </item>
-        <CNTDLY id="71" externalClockFrequence="0" externalClockFreqUnit="kHz">
-            <item id="71" caption="8-bit CNT5/DLY5 (MF5)">
-                <graphics pos="(500.00,-50.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,16.00)"/>
-            </item>
-        </CNTDLY>
-        <LUT id="72" regularShape="0" mode="0">
-            <item id="72" caption="3-bit LUT12 (MF6)">
-                <graphics pos="(565.00,335.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <item id="73" caption="DFF/LATCH15 (MF6)">
-            <graphics pos="(330.00,110.00)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,10.00)"/>
-        </item>
-        <CNTDLY id="74" externalClockFrequence="0" externalClockFreqUnit="kHz">
-            <item id="74" caption="8-bit CNT6/DLY6 (MF6)">
-                <graphics pos="(330.00,110.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,16.00)"/>
-            </item>
-        </CNTDLY>
-        <LUT id="75" regularShape="0" mode="0">
-            <item id="75" caption="3-bit LUT13 (MF7)">
-                <graphics pos="(565.00,495.00)" angle="90" flipping="0" hidden="1" tOrigin="(20.00,15.00)"/>
-            </item>
-        </LUT>
-        <item id="76" caption="DFF/LATCH16 (MF7)">
-            <graphics pos="(170.00,270.00)" angle="0" flipping="0" hidden="1" tOrigin="(25.00,10.00)"/>
-        </item>
-        <CNTDLY id="77" externalClockFrequence="0" externalClockFreqUnit="kHz">
-            <item id="77" caption="8-bit CNT7/DLY7 (MF7)">
-                <graphics pos="(170.00,270.00)" angle="0" flipping="0" hidden="1" tOrigin="(30.00,16.00)"/>
-            </item>
-        </CNTDLY>
-        <wire output="147" input="111" autoRouting="1" pen="#ff8000ff;1.00;1;32;128" lineType="2" protected="1" CWLid="0" wireText="NET0" wireState="0">
-            <points>(-702.00,682.00); (-695.00,682.00)</points>
-        </wire>
-        <wire output="148" input="112" autoRouting="1" pen="#ff8000ff;1.00;1;32;128" lineType="2" protected="1" CWLid="1" wireText="NET1" wireState="0">
-            <points>(-702.00,712.00); (-695.00,712.00)</points>
-        </wire>
-        <wire output="143" input="537" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="10" wireText="NET10" wireState="0">
-            <points>(-189.00,520.00); (432.00,520.00); (432.00,360.00)</points>
-        </wire>
-        <wire output="143" input="553" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="10" wireText="NET10" wireState="0">
-            <points>(-189.00,520.00); (45.00,520.00); (45.00,216.00)</points>
-        </wire>
-        <wire output="142" input="552" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="8" wireText="NET8" wireState="0">
-            <points>(-186.00,294.00); (-13.00,294.00); (-13.00,182.00); (-2.00,182.00)</points>
-        </wire>
-        <wire output="157" input="621" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="7" wireText="NET7" wireState="0">
-            <points>(-188.00,403.00); (105.00,403.00); (105.00,341.00); (120.00,341.00)</points>
-        </wire>
-        <wire output="142" input="622" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="8" wireText="NET8" wireState="0">
-            <points>(-186.00,294.00); (105.00,294.00); (105.00,331.00); (120.00,331.00)</points>
-        </wire>
-        <wire output="162" input="623" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="11" wireText="NET11" wireState="0">
-            <points>(89.00,186.00); (114.00,186.00); (114.00,321.00); (120.00,321.00)</points>
-        </wire>
-        <wire output="191" input="536" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="9" wireText="NET9" wireState="0">
-            <points>(191.00,326.00); (388.00,326.00)</points>
-        </wire>
-        <wire output="144" input="624" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="12" wireText="NET12" wireState="0">
-            <points>(-187.00,213.00); (-127.00,213.00); (-127.00,311.00); (120.00,311.00)</points>
-        </wire>
-        <wire output="84" input="551" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="13" wireText="NET13" wireState="0">
-            <points>(-30.00,192.00); (-2.00,192.00)</points>
-        </wire>
-        <wire output="191" input="262" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="9" wireText="NET9" wireState="0">
-            <points>(191.00,326.00); (213.00,326.00); (213.00,113.00); (-123.00,113.00); (-123.00,184.00); (-107.00,184.00)</points>
-        </wire>
-        <wire output="144" input="261" autoRouting="1" pen="#00ff00ff;1.00;1;32;128" lineType="1" protected="0" CWLid="12" wireText="NET12" wireState="0">
-            <points>(-187.00,213.00); (-126.00,213.00); (-126.00,200.00); (-107.00,200.00)</points>
-        </wire>
-    </chip>
-    <emulatorConfiguration version="1">
-        <settings>
-            <autoApply value="0"/>
-            <platformSelector id="3"/>
-        </settings>
-        <platform id="0" friendlyName="GreenPAK DIP Development Platform">
-            <lastConfiguration modified="0">
-                <SaveEmulator Name="Default">
-                    <PowerOptions synced="0"/>
-                    <PowerSwitch internalPower="1" externalPower="0"/>
-                    <ExpansionConnector></ExpansionConnector>
-                    <TestPoints/>
-                    <I2C slaveAddress="-1"/>
-                </SaveEmulator>
-            </lastConfiguration>
-            <savedConfigurations/>
-        </platform>
-        <platform id="1" friendlyName="GreenPAK Advanced Development Platform">
-            <lastConfiguration modified="0">
-                <SaveEmulator Name="Default">
-                    <PowerOptions synced="0"/>
-                    <PowerSwitch internalPower="1" externalPower="0"/>
-                    <ExpansionConnector></ExpansionConnector>
-                    <TestPoints/>
-                    <I2C slaveAddress="-1"/>
-                </SaveEmulator>
-            </lastConfiguration>
-            <savedConfigurations/>
-        </platform>
-        <platform id="2" friendlyName="GreenPAK Pro Development Platform">
-            <lastConfiguration modified="0">
-                <SaveEmulator Name="Default">
-                    <PowerOptions synced="0"/>
-                    <PowerSwitch internalPower="1" externalPower="0"/>
-                    <ExpansionConnector></ExpansionConnector>
-                    <TestPoints/>
-                    <I2C slaveAddress="-1"/>
-                </SaveEmulator>
-            </lastConfiguration>
-            <savedConfigurations/>
-        </platform>
-        <platform id="4" friendlyName="GreenPAK Serial Debugger">
-            <lastConfiguration modified="0">
-                <SaveEmulator Name="Default">
-                    <PowerOptions synced="0"/>
-                    <PowerSwitch internalPower="1" externalPower="0"/>
-                    <ExpansionConnector></ExpansionConnector>
-                    <TestPoints/>
-                    <I2C slaveAddress="-1"/>
-                </SaveEmulator>
-            </lastConfiguration>
-            <savedConfigurations/>
-        </platform>
-        <platform id="5" friendlyName="GreenPAK Advanced Development Platform w/ Logic Level Adapter #1">
-            <lastConfiguration modified="0">
-                <SaveEmulator Name="Default">
-                    <PowerOptions synced="0"/>
-                    <PowerSwitch internalPower="1" externalPower="0"/>
-                    <ExpansionConnector></ExpansionConnector>
-                    <TestPoints/>
-                    <I2C slaveAddress="-1"/>
-                </SaveEmulator>
-            </lastConfiguration>
-            <savedConfigurations/>
-        </platform>
-        <platform id="6" friendlyName="ForgeFPGA Development Platform">
-            <lastConfiguration modified="0">
-                <SaveEmulator Name="Default">
-                    <PowerOptions synced="0"/>
-                    <PowerSwitch internalPower="1" externalPower="0"/>
-                    <ExpansionConnector></ExpansionConnector>
-                    <TestPoints/>
-                    <I2C slaveAddress="-1"/>
-                </SaveEmulator>
-            </lastConfiguration>
-            <savedConfigurations/>
-        </platform>
-    </emulatorConfiguration>
-    <simulationConfiguration version="13" compatibleVersion="13" activePreset="-1">
-        <draftPreset>
-            <simulationPreset index="-1" name="Default" customGroupLayout="false" customParametricDcGroupLayout="false">
-                <transientAnalyses>
-                    <transientAnalysis stopTime="12m" maxTimeStep="20u" startTime="0" stepTime="20u" temperature="25" useInitialConditions="false" vdd="3.3"/>
-                </transientAnalyses>
-                <parametricDcAnalyses/>
-                <pinProbes>
-                    <pinProbe instrumentId="0" measurementFlags="1">
-                        <IdDto category="5" componentType="43" componentNumber="1" pinNumber="0"/>
-                    </pinProbe>
-                    <pinProbe instrumentId="1" measurementFlags="1">
-                        <IdDto category="5" componentType="43" componentNumber="2" pinNumber="0"/>
-                    </pinProbe>
-                </pinProbes>
-                <groups/>
-                <parametricDcGroups/>
-                <waveforms/>
-                <components>
-                    <component simulationModel="">
-                        <componentId category="5" componentType="0" componentNumber="1"/>
-                        <componentSpec manufacturer="" partNumber=""/>
-                        <componentUiSettings isFlippedHorizontally="false" isFlippedVertically="false" visible="true" position="(-818.116;93.379)" rotationState="0" sceneIndex="0"/>
-                        <schematicProps>
-                            <param id="name" affinity="4" value="GND"/>
-                        </schematicProps>
-                        <instanceProps/>
-                    </component>
-                    <component simulationModel="">
-                        <componentId category="5" componentType="0" componentNumber="2"/>
-                        <componentSpec manufacturer="" partNumber=""/>
-                        <componentUiSettings isFlippedHorizontally="false" isFlippedVertically="false" visible="true" position="(1005.89;233.679)" rotationState="0" sceneIndex="0"/>
-                        <schematicProps>
-                            <param id="name" affinity="4" value="GND"/>
-                        </schematicProps>
-                        <instanceProps/>
-                    </component>
-                    <component simulationModel="">
-                        <componentId category="5" componentType="0" componentNumber="3"/>
-                        <componentSpec manufacturer="" partNumber=""/>
-                        <componentUiSettings isFlippedHorizontally="false" isFlippedVertically="false" visible="true" position="(848.494;443.262)" rotationState="0" sceneIndex="0"/>
-                        <schematicProps>
-                            <param id="name" affinity="4" value="GND"/>
-                        </schematicProps>
-                        <instanceProps/>
-                    </component>
-                    <component simulationModel="">
-                        <componentId category="5" componentType="43" componentNumber="1"/>
-                        <componentSpec manufacturer="" partNumber=""/>
-                        <componentUiSettings isFlippedHorizontally="false" isFlippedVertically="false" visible="true" position="(-749.099;19.6022)" rotationState="0" sceneIndex="0"/>
-                        <schematicProps>
-                            <param id="name" affinity="4" value="V1"/>
-                            <param id="has_rc" affinity="1" value="1"/>
-                            <param id="int_r" affinity="3" value="10"/>
-                            <param id="int_c" affinity="3" value="100n"/>
-                            <param id="show_one_period" affinity="1" value="0"/>
-                            <param id="has_limited_voltage" affinity="1" value="0"/>
-                            <param id="dc_analysis_voltage" affinity="3" value="3.3"/>
-                            <param id="signal_type" affinity="1" value="1"/>
-                            <param id="prestart_delay" affinity="3" value="0"/>
-                            <param id="ramp_voltage" affinity="3" value="3.3"/>
-                            <param id="ramp_rise_time" affinity="3" value="1m"/>
-                        </schematicProps>
-                        <instanceProps/>
-                    </component>
-                    <component simulationModel="">
-                        <componentId category="5" componentType="43" componentNumber="2"/>
-                        <componentSpec manufacturer="" partNumber=""/>
-                        <componentUiSettings isFlippedHorizontally="true" isFlippedVertically="false" visible="true" position="(926.958;159.848)" rotationState="0" sceneIndex="0"/>
-                        <schematicProps>
-                            <param id="name" affinity="4" value="V2"/>
-                            <param id="has_rc" affinity="1" value="1"/>
-                            <param id="int_r" affinity="3" value="10"/>
-                            <param id="int_c" affinity="3" value="100n"/>
-                            <param id="show_one_period" affinity="1" value="0"/>
-                            <param id="has_limited_voltage" affinity="1" value="1"/>
-                            <param id="dc_analysis_voltage" affinity="3" value="3.3"/>
-                            <param id="signal_type" affinity="1" value="1"/>
-                            <param id="prestart_delay" affinity="3" value="0"/>
-                            <param id="ramp_voltage" affinity="3" value="3.3"/>
-                            <param id="ramp_rise_time" affinity="3" value="1m"/>
-                        </schematicProps>
-                        <instanceProps/>
-                    </component>
-                </components>
-                <networks>
-                    <network networkId="6" name="NET6">
-                        <connections>
-                            <connection connectionType="0" routingType="0" sceneIndex="0">
-                                <from>
-                                    <IdDto category="5" componentType="43" componentNumber="1" pinNumber="1"/>
-                                </from>
-                                <to>
-                                    <IdDto category="5" componentType="0" componentNumber="1" pinNumber="0"/>
-                                </to>
-                                <path>
-                                    <point value="(-771;41)"/>
-                                    <point value="(-802;41)"/>
-                                    <point value="(-802;71)"/>
-                                </path>
-                            </connection>
-                        </connections>
-                    </network>
-                    <network networkId="5" name="NET5">
-                        <connections>
-                            <connection connectionType="0" routingType="0" sceneIndex="0">
-                                <from>
-                                    <IdDto category="5" componentType="0" componentNumber="3" pinNumber="0"/>
-                                </from>
-                                <to>
-                                    <IdDto category="100" componentType="45" componentNumber="0" pinNumber="10"/>
-                                </to>
-                                <path>
-                                    <point value="(864;421)"/>
-                                    <point value="(864;391)"/>
-                                    <point value="(832;391)"/>
-                                </path>
-                            </connection>
-                        </connections>
-                    </network>
-                    <network networkId="4" name="NET4">
-                        <connections>
-                            <connection connectionType="0" routingType="0" sceneIndex="0">
-                                <from>
-                                    <IdDto category="5" componentType="43" componentNumber="2" pinNumber="0"/>
-                                </from>
-                                <to>
-                                    <IdDto category="100" componentType="45" componentNumber="0" pinNumber="7"/>
-                                </to>
-                                <path>
-                                    <point value="(905;181)"/>
-                                    <point value="(832;181)"/>
-                                </path>
-                            </connection>
-                        </connections>
-                    </network>
-                    <network networkId="3" name="NET3">
-                        <connections>
-                            <connection connectionType="0" routingType="0" sceneIndex="0">
-                                <from>
-                                    <IdDto category="5" componentType="0" componentNumber="2" pinNumber="0"/>
-                                </from>
-                                <to>
-                                    <IdDto category="5" componentType="43" componentNumber="2" pinNumber="1"/>
-                                </to>
-                                <path>
-                                    <point value="(1022;212)"/>
-                                    <point value="(1022;181)"/>
-                                    <point value="(990;181)"/>
-                                </path>
-                            </connection>
-                        </connections>
-                    </network>
-                    <network networkId="2" name="NET2">
-                        <connections>
-                            <connection connectionType="0" routingType="0" sceneIndex="0">
-                                <from>
-                                    <IdDto category="5" componentType="43" componentNumber="1" pinNumber="0"/>
-                                </from>
-                                <to>
-                                    <IdDto category="100" componentType="45" componentNumber="0" pinNumber="20"/>
-                                </to>
-                                <path>
-                                    <point value="(-686;41)"/>
-                                    <point value="(-613;41)"/>
-                                </path>
-                            </connection>
-                        </connections>
-                    </network>
-                </networks>
-            </simulationPreset>
-        </draftPreset>
-        <simulationPresets/>
-    </simulationConfiguration>
-    <projectData>
-        <specs>
-            <lastModify lastModifyValue="01.02.2022 7:10:58"/>
-            <vddSpecs vddMin="2.8" vddTyp="3" vddMax="3.2"/>
-            <vdd2Specs vdd2Min="2.8" vdd2Typ="3" vdd2Max="3.2"/>
-            <tempSpecs tempMin="0" tempTyp="25" tempMax="40"/>
-        </specs>
-        <projectDataFields>
-            <textLineDataField name="Customer&#10;Name:" id="2" text=""/>
-            <textLineDataField name="Customer&#10;Project Name:" id="3" text=""/>
-            <textLineDataField name="Customer&#10;Project Number:" id="4" text=""/>
-            <textLineDataField name="Customer&#10;Version Number:" id="5" text=""/>
-            <multiTextLineDataField>
-                <textLineDataField name="Notes:" id="6" text=""/>
-            </multiTextLineDataField>
-        </projectDataFields>
-    </projectData>
-    <i2cTool>
-        <i2cDebugger version="1"/>
-        <i2cStepper version="1" rowCount="0"/>
-        <i2cRegsTable version="1" tabCount="0"/>
-    </i2cTool>
-</GPDProject>

greenpak/SCSI_Accelerator_SLG46824.hex

@@ -1,17 +0,0 @@
-:10000000C40900000000000038C200000000000029
-:10001000000000000000D0081301000000000000F4
-:1000200000000000000000000000000000000000D0
-:1000300000000000000000000000000000000000C0
-:100040000000E700000000000000000000000000C9
-:1000500000000000000000000000000000000000A0
-:100060000030700030203030000030303000303050
-:100070003030000000000000000000000000000020
-:1000800000000000001422300C00000000000000FE
-:10009000060000000000000000004000000000001A
-:1000A00000D714200001000000020100000200013E
-:1000B0000000020100000200010000020100000235
-:1000C0000001000002000100000001010100000029
-:1000D0000000000000000000000000000000000020
-:1000E0000000000000000000000000000000000010
-:1000F000000000000000000000000000000000A55B
-:00000001FF

lib/BlueSCSI_platform_GD32F205/BlueSCSI_platform.cpp

@@ -1,525 +0,0 @@
-#include "BlueSCSI_platform.h"
-#include "gd32f20x_sdio.h"
-#include "gd32f20x_fmc.h"
-#include "BlueSCSI_log.h"
-#include "BlueSCSI_config.h"
-#include "greenpak.h"
-#include <SdFat.h>
-#include <scsi.h>
-#include <assert.h>
-
-extern "C" {
-
-const char *g_bluescsiplatform_name = PLATFORM_NAME;
-static bool g_enable_apple_quirks = false;
-
-/*************************/
-/* Timing functions      */
-/*************************/
-
-static volatile uint32_t g_millisecond_counter;
-static volatile uint32_t g_watchdog_timeout;
-static uint32_t g_ns_to_cycles; // Q0.32 fixed point format
-
-static void watchdog_handler(uint32_t *sp);
-
-unsigned long millis()
-{
-    return g_millisecond_counter;
-}
-
-void delay(unsigned long ms)
-{
-    uint32_t start = g_millisecond_counter;
-    while ((uint32_t)(g_millisecond_counter - start) < ms);
-}
-
-void delay_ns(unsigned long ns)
-{
-    uint32_t CNT_start = DWT->CYCCNT;
-    if (ns <= 100) return; // Approximate call overhead
-    ns -= 100;
-
-    uint32_t cycles = ((uint64_t)ns * g_ns_to_cycles) >> 32;
-    while ((uint32_t)(DWT->CYCCNT - CNT_start) < cycles);
-}
-
-void SysTick_Handler_inner(uint32_t *sp)
-{
-    g_millisecond_counter++;
-
-    if (g_watchdog_timeout > 0)
-    {
-        g_watchdog_timeout--;
-
-        const uint32_t busreset_time = WATCHDOG_CRASH_TIMEOUT - WATCHDOG_BUS_RESET_TIMEOUT;
-        if (g_watchdog_timeout <= busreset_time)
-        {
-            if (!scsiDev.resetFlag)
-            {
-                bluelog("WATCHDOG TIMEOUT at PC ", sp[6], " LR ", sp[5], " attempting bus reset");
-                scsiDev.resetFlag = 1;
-            }
-
-            if (g_watchdog_timeout == 0)
-            {
-                watchdog_handler(sp);
-            }
-        }
-    }
-}
-
-__attribute__((interrupt, naked))
-void SysTick_Handler(void)
-{
-    // Take note of stack pointer so that we can print debug
-    // info in watchdog handler.
-    asm("mrs r0, msp\n"
-        "b SysTick_Handler_inner": : : "r0");
-}
-
-// This function is called by scsiPhy.cpp.
-// It resets the systick counter to give 1 millisecond of uninterrupted transfer time.
-// The total number of skips is kept track of to keep the correct time on average.
-void SysTick_Handle_PreEmptively()
-{
-    static int skipped_clocks = 0;
-
-    __disable_irq();
-    uint32_t loadval = SysTick->LOAD;
-    skipped_clocks += loadval - SysTick->VAL;
-    SysTick->VAL = 0;
-
-    if (skipped_clocks > loadval)
-    {
-        // We have skipped enough ticks that it is time to fake a call
-        // to SysTick interrupt handler.
-        skipped_clocks -= loadval;
-        uint32_t stack_frame[8] = {0};
-        stack_frame[6] = (uint32_t)__builtin_return_address(0);
-        SysTick_Handler_inner(stack_frame);
-    }
-    __enable_irq();
-}
-
-/***************/
-/* GPIO init   */
-/***************/
-
-// Initialize SPI and GPIO configuration
-// Clock has already been initialized by system_gd32f20x.c
-void bluescsiplatform_init()
-{
-    SystemCoreClockUpdate();
-
-    // Enable SysTick to drive millis()
-    g_millisecond_counter = 0;
-    SysTick_Config(SystemCoreClock / 1000U);
-    NVIC_SetPriority(SysTick_IRQn, 0x00U);
-
-    // Enable DWT counter to drive delay_ns()
-    g_ns_to_cycles = ((uint64_t)SystemCoreClock << 32) / 1000000000;
-    CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;
-    DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk;
-
-    // Enable debug output on SWO pin
-    DBG_CTL |= DBG_CTL_TRACE_IOEN;
-    if (TPI->ACPR == 0)
-    {
-        CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk;
-        TPI->ACPR = SystemCoreClock / 2000000 - 1; // 2 Mbps baudrate for SWO
-        // TPI->ACPR = SystemCoreClock / 30000000 - 1; // 30 Mbps baudrate for SWO
-        TPI->SPPR = 2;
-        TPI->FFCR = 0x100; // TPIU packet framing disabled
-        // DWT->CTRL |= (1 << DWT_CTRL_EXCTRCENA_Pos);
-        // DWT->CTRL |= (1 << DWT_CTRL_CYCTAP_Pos)
-        //             | (15 << DWT_CTRL_POSTPRESET_Pos)
-        //             | (1 << DWT_CTRL_PCSAMPLENA_Pos)
-        //             | (3 << DWT_CTRL_SYNCTAP_Pos)
-        //             | (1 << DWT_CTRL_CYCCNTENA_Pos);
-        ITM->LAR = 0xC5ACCE55;
-        ITM->TCR = (1 << ITM_TCR_DWTENA_Pos)
-                    | (1 << ITM_TCR_SYNCENA_Pos)
-                    | (1 << ITM_TCR_ITMENA_Pos);
-        ITM->TER = 0xFFFFFFFF; // Enable all stimulus ports
-    }
-
-    // Enable needed clocks for GPIO
-    rcu_periph_clock_enable(RCU_AF);
-    rcu_periph_clock_enable(RCU_GPIOA);
-    rcu_periph_clock_enable(RCU_GPIOB);
-    rcu_periph_clock_enable(RCU_GPIOC);
-    rcu_periph_clock_enable(RCU_GPIOD);
-    rcu_periph_clock_enable(RCU_GPIOE);
-
-    // Switch to SWD debug port (disable JTAG) to release PB4 as GPIO
-    gpio_pin_remap_config(GPIO_SWJ_SWDPENABLE_REMAP, ENABLE);
-
-    // SCSI pins.
-    // Initialize open drain outputs to high.
-    SCSI_RELEASE_OUTPUTS();
-    gpio_init(SCSI_OUT_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_DATA_MASK | SCSI_OUT_REQ);
-    gpio_init(SCSI_OUT_IO_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_IO_PIN);
-    gpio_init(SCSI_OUT_CD_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_CD_PIN);
-    gpio_init(SCSI_OUT_SEL_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_SEL_PIN);
-    gpio_init(SCSI_OUT_MSG_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_MSG_PIN);
-    gpio_init(SCSI_OUT_RST_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_RST_PIN);
-    gpio_init(SCSI_OUT_BSY_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_BSY_PIN);
-
-    gpio_init(SCSI_IN_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_IN_MASK);
-    gpio_init(SCSI_ATN_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_ATN_PIN);
-    gpio_init(SCSI_BSY_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_BSY_PIN);
-    gpio_init(SCSI_SEL_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_SEL_PIN);
-    gpio_init(SCSI_ACK_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_ACK_PIN);
-    gpio_init(SCSI_RST_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_RST_PIN);
-
-    // Terminator enable
-    gpio_bit_set(SCSI_TERM_EN_PORT, SCSI_TERM_EN_PIN);
-    gpio_init(SCSI_TERM_EN_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_2MHZ, SCSI_TERM_EN_PIN);
-
-#ifndef SD_USE_SDIO
-    // SD card pins using SPI
-    gpio_init(SD_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SD_CS_PIN);
-    gpio_init(SD_PORT, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, SD_CLK_PIN);
-    gpio_init(SD_PORT, GPIO_MODE_IPU, 0, SD_MISO_PIN);
-    gpio_init(SD_PORT, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, SD_MOSI_PIN);
-#else
-    // SD card pins using SDIO
-    gpio_init(SD_SDIO_DATA_PORT, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, SD_SDIO_D0 | SD_SDIO_D1 | SD_SDIO_D2 | SD_SDIO_D3);
-    gpio_init(SD_SDIO_CLK_PORT, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, SD_SDIO_CLK);
-    gpio_init(SD_SDIO_CMD_PORT, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, SD_SDIO_CMD);
-#endif
-
-    // DIP switches
-    gpio_init(DIP_PORT, GPIO_MODE_IPD, 0, DIPSW1_PIN | DIPSW2_PIN | DIPSW3_PIN);
-
-    // LED pins
-    gpio_bit_set(LED_PORT, LED_PINS);
-    gpio_init(LED_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_2MHZ, LED_PINS);
-
-    // SWO trace pin on PB3
-    gpio_init(GPIOB, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_3);
-}
-
-void bluescsiplatform_late_init()
-{
-    if (gpio_input_bit_get(DIP_PORT, DIPSW3_PIN))
-    {
-        bluelog("DIPSW3 is ON: Enabling SCSI termination");
-        gpio_bit_reset(SCSI_TERM_EN_PORT, SCSI_TERM_EN_PIN);
-    }
-    else
-    {
-        bluelog("DIPSW3 is OFF: SCSI termination disabled");
-    }
-
-    if (gpio_input_bit_get(DIP_PORT, DIPSW2_PIN))
-    {
-        bluelog("DIPSW2 is ON: enabling debug messages");
-        g_bluelog_debug = true;
-    }
-    else
-    {
-        g_bluelog_debug = false;
-    }
-
-    if (gpio_input_bit_get(DIP_PORT, DIPSW1_PIN))
-    {
-        bluelog("DIPSW1 is ON: enabling Apple quirks by default");
-        g_enable_apple_quirks = true;
-    }
-
-    greenpak_load_firmware();
-}
-
-/*****************************************/
-/* Crash handlers                        */
-/*****************************************/
-
-extern SdFs SD;
-
-// Writes log data to the PB3 SWO pin
-void bluescsiplatform_log(const char *s)
-{
-    while (*s)
-    {
-        // Write to SWO pin
-        while (ITM->PORT[0].u32 == 0);
-        ITM->PORT[0].u8 = *s++;
-    }
-}
-
-void bluescsiplatform_emergency_log_save()
-{
-    bluescsiplatform_set_sd_callback(NULL, NULL);
-
-    SD.begin(SD_CONFIG_CRASH);
-    FsFile crashfile = SD.open(CRASHFILE, O_WRONLY | O_CREAT | O_TRUNC);
-
-    if (!crashfile.isOpen())
-    {
-        // Try to reinitialize
-        int max_retry = 10;
-        while (max_retry-- > 0 && !SD.begin(SD_CONFIG_CRASH));
-
-        crashfile = SD.open(CRASHFILE, O_WRONLY | O_CREAT | O_TRUNC);
-    }
-
-    uint32_t startpos = 0;
-    crashfile.write(bluelog_get_buffer(&startpos));
-    crashfile.write(bluelog_get_buffer(&startpos));
-    crashfile.flush();
-    crashfile.close();
-}
-
-extern uint32_t _estack;
-
-__attribute__((noinline))
-void show_hardfault(uint32_t *sp)
-{
-    uint32_t pc = sp[6];
-    uint32_t lr = sp[5];
-    uint32_t cfsr = SCB->CFSR;
-
-    bluelog("--------------");
-    bluelog("CRASH!");
-    bluelog("Platform: ", g_bluescsiplatform_name);
-    bluelog("FW Version: ", g_bluelog_firmwareversion);
-    bluelog("CFSR: ", cfsr);
-    bluelog("SP: ", (uint32_t)sp);
-    bluelog("PC: ", pc);
-    bluelog("LR: ", lr);
-    bluelog("R0: ", sp[0]);
-    bluelog("R1: ", sp[1]);
-    bluelog("R2: ", sp[2]);
-    bluelog("R3: ", sp[3]);
-
-    uint32_t *p = (uint32_t*)((uint32_t)sp & ~3);
-    for (int i = 0; i < 8; i++)
-    {
-        if (p == &_estack) break; // End of stack
-
-        bluelog("STACK ", (uint32_t)p, ":    ", p[0], " ", p[1], " ", p[2], " ", p[3]);
-        p += 4;
-    }
-
-    bluescsiplatform_emergency_log_save();
-
-    while (1)
-    {
-        // Flash the crash address on the LED
-        // Short pulse means 0, long pulse means 1
-        int base_delay = 1000;
-        for (int i = 31; i >= 0; i--)
-        {
-            LED_OFF();
-            for (int j = 0; j < base_delay; j++) delay_ns(100000);
-
-            int delay = (pc & (1 << i)) ? (3 * base_delay) : base_delay;
-            LED_ON();
-            for (int j = 0; j < delay; j++) delay_ns(100000);
-            LED_OFF();
-        }
-
-        for (int j = 0; j < base_delay * 10; j++) delay_ns(100000);
-    }
-}
-
-__attribute__((naked, interrupt))
-void HardFault_Handler(void)
-{
-    // Copies stack pointer into first argument
-    asm("mrs r0, msp\n"
-        "b show_hardfault": : : "r0");
-}
-
-__attribute__((naked, interrupt))
-void MemManage_Handler(void)
-{
-    asm("mrs r0, msp\n"
-        "b show_hardfault": : : "r0");
-}
-
-__attribute__((naked, interrupt))
-void BusFault_Handler(void)
-{
-    asm("mrs r0, msp\n"
-        "b show_hardfault": : : "r0");
-}
-
-__attribute__((naked, interrupt))
-void UsageFault_Handler(void)
-{
-    asm("mrs r0, msp\n"
-        "b show_hardfault": : : "r0");
-}
-
-void __assert_func(const char *file, int line, const char *func, const char *expr)
-{
-    uint32_t dummy = 0;
-
-    bluelog("--------------");
-    bluelog("ASSERT FAILED!");
-    bluelog("Platform: ", g_bluescsiplatform_name);
-    bluelog("FW Version: ", g_bluelog_firmwareversion);
-    bluelog("Assert failed: ", file , ":", line, " in ", func, ":", expr);
-
-    uint32_t *p = (uint32_t*)((uint32_t)&dummy & ~3);
-    for (int i = 0; i < 8; i++)
-    {
-        if (p == &_estack) break; // End of stack
-
-        bluelog("STACK ", (uint32_t)p, ":    ", p[0], " ", p[1], " ", p[2], " ", p[3]);
-        p += 4;
-    }
-
-    bluescsiplatform_emergency_log_save();
-
-    while(1)
-    {
-        LED_OFF();
-        for (int j = 0; j < 1000; j++) delay_ns(100000);
-        LED_ON();
-        for (int j = 0; j < 1000; j++) delay_ns(100000);
-    }
-}
-
-} /* extern "C" */
-
-static void watchdog_handler(uint32_t *sp)
-{
-    bluelog("-------------- WATCHDOG TIMEOUT");
-    show_hardfault(sp);
-}
-
-void bluescsiplatform_reset_watchdog()
-{
-    // This uses a software watchdog based on systick timer interrupt.
-    // It gives us opportunity to collect better debug info than the
-    // full hardware reset that would be caused by hardware watchdog.
-    g_watchdog_timeout = WATCHDOG_CRASH_TIMEOUT;
-}
-
-/***********************/
-/* Flash reprogramming */
-/***********************/
-
-bool bluescsiplatform_rewrite_flash_page(uint32_t offset, uint8_t buffer[BLUESCSIPLATFORM_FLASH_PAGE_SIZE])
-{
-    if (offset == 0)
-    {
-        if (buffer[3] != 0x20 || buffer[7] != 0x08)
-        {
-            bluelog("Invalid firmware file, starts with: ", bytearray(buffer, 16));
-            return false;
-        }
-    }
-
-    bluedbg("Writing flash at offset ", offset, " data ", bytearray(buffer, 4));
-    assert(offset % BLUESCSIPLATFORM_FLASH_PAGE_SIZE == 0);
-    assert(offset >= BLUESCSIPLATFORM_BOOTLOADER_SIZE);
-
-    fmc_unlock();
-    fmc_bank0_unlock();
-
-    fmc_state_enum status;
-    status = fmc_page_erase(FLASH_BASE + offset);
-    if (status != FMC_READY)
-    {
-        bluelog("Erase failed: ", (int)status);
-        return false;
-    }
-
-    uint32_t *buf32 = (uint32_t*)buffer;
-    uint32_t num_words = BLUESCSIPLATFORM_FLASH_PAGE_SIZE / 4;
-    for (int i = 0; i < num_words; i++)
-    {
-        status = fmc_word_program(FLASH_BASE + offset + i * 4, buf32[i]);
-        if (status != FMC_READY)
-        {
-            bluelog("Flash write failed: ", (int)status);
-            return false;
-        }
-    }
-
-    fmc_lock();
-
-    for (int i = 0; i < num_words; i++)
-    {
-        uint32_t expected = buf32[i];
-        uint32_t actual = *(volatile uint32_t*)(FLASH_BASE + offset + i * 4);
-        if (actual != expected)
-        {
-            bluelog("Flash verify failed at offset ", offset + i * 4, " got ", actual, " expected ", expected);
-            return false;
-        }
-    }
-    return true;
-}
-
-void bluescsiplatform_boot_to_main_firmware()
-{
-    uint32_t *mainprogram_start = (uint32_t*)(0x08000000 + BLUESCSIPLATFORM_BOOTLOADER_SIZE);
-    SCB->VTOR = (uint32_t)mainprogram_start;
-
-    __asm__(
-        "msr msp, %0\n\t"
-        "bx %1" : : "r" (mainprogram_start[0]),
-                    "r" (mainprogram_start[1]) : "memory");
-}
-
-/**************************************/
-/* SCSI configuration based on DIPSW1 */
-/**************************************/
-
-void bluescsiplatform_config_hook(S2S_TargetCfg *config)
-{
-    // Enable Apple quirks by dip switch
-    if (g_enable_apple_quirks)
-    {
-        if (config->quirks == S2S_CFG_QUIRKS_NONE)
-        {
-            config->quirks = S2S_CFG_QUIRKS_APPLE;
-        }
-    }
-}
-
-/**********************************************/
-/* Mapping from data bytes to GPIO BOP values */
-/**********************************************/
-
-#define PARITY(n) ((1 ^ (n) ^ ((n)>>1) ^ ((n)>>2) ^ ((n)>>3) ^ ((n)>>4) ^ ((n)>>5) ^ ((n)>>6) ^ ((n)>>7)) & 1)
-#define X(n) (\
-    ((n & 0x01) ? (SCSI_OUT_DB0 << 16) : SCSI_OUT_DB0) | \
-    ((n & 0x02) ? (SCSI_OUT_DB1 << 16) : SCSI_OUT_DB1) | \
-    ((n & 0x04) ? (SCSI_OUT_DB2 << 16) : SCSI_OUT_DB2) | \
-    ((n & 0x08) ? (SCSI_OUT_DB3 << 16) : SCSI_OUT_DB3) | \
-    ((n & 0x10) ? (SCSI_OUT_DB4 << 16) : SCSI_OUT_DB4) | \
-    ((n & 0x20) ? (SCSI_OUT_DB5 << 16) : SCSI_OUT_DB5) | \
-    ((n & 0x40) ? (SCSI_OUT_DB6 << 16) : SCSI_OUT_DB6) | \
-    ((n & 0x80) ? (SCSI_OUT_DB7 << 16) : SCSI_OUT_DB7) | \
-    (PARITY(n)  ? (SCSI_OUT_DBP << 16) : SCSI_OUT_DBP) | \
-    (SCSI_OUT_REQ) \
-)
-
-const uint32_t g_scsi_out_byte_to_bop[256] =
-{
-    X(0x00), X(0x01), X(0x02), X(0x03), X(0x04), X(0x05), X(0x06), X(0x07), X(0x08), X(0x09), X(0x0a), X(0x0b), X(0x0c), X(0x0d), X(0x0e), X(0x0f),
-    X(0x10), X(0x11), X(0x12), X(0x13), X(0x14), X(0x15), X(0x16), X(0x17), X(0x18), X(0x19), X(0x1a), X(0x1b), X(0x1c), X(0x1d), X(0x1e), X(0x1f),
-    X(0x20), X(0x21), X(0x22), X(0x23), X(0x24), X(0x25), X(0x26), X(0x27), X(0x28), X(0x29), X(0x2a), X(0x2b), X(0x2c), X(0x2d), X(0x2e), X(0x2f),
-    X(0x30), X(0x31), X(0x32), X(0x33), X(0x34), X(0x35), X(0x36), X(0x37), X(0x38), X(0x39), X(0x3a), X(0x3b), X(0x3c), X(0x3d), X(0x3e), X(0x3f),
-    X(0x40), X(0x41), X(0x42), X(0x43), X(0x44), X(0x45), X(0x46), X(0x47), X(0x48), X(0x49), X(0x4a), X(0x4b), X(0x4c), X(0x4d), X(0x4e), X(0x4f),
-    X(0x50), X(0x51), X(0x52), X(0x53), X(0x54), X(0x55), X(0x56), X(0x57), X(0x58), X(0x59), X(0x5a), X(0x5b), X(0x5c), X(0x5d), X(0x5e), X(0x5f),
-    X(0x60), X(0x61), X(0x62), X(0x63), X(0x64), X(0x65), X(0x66), X(0x67), X(0x68), X(0x69), X(0x6a), X(0x6b), X(0x6c), X(0x6d), X(0x6e), X(0x6f),
-    X(0x70), X(0x71), X(0x72), X(0x73), X(0x74), X(0x75), X(0x76), X(0x77), X(0x78), X(0x79), X(0x7a), X(0x7b), X(0x7c), X(0x7d), X(0x7e), X(0x7f),
-    X(0x80), X(0x81), X(0x82), X(0x83), X(0x84), X(0x85), X(0x86), X(0x87), X(0x88), X(0x89), X(0x8a), X(0x8b), X(0x8c), X(0x8d), X(0x8e), X(0x8f),
-    X(0x90), X(0x91), X(0x92), X(0x93), X(0x94), X(0x95), X(0x96), X(0x97), X(0x98), X(0x99), X(0x9a), X(0x9b), X(0x9c), X(0x9d), X(0x9e), X(0x9f),
-    X(0xa0), X(0xa1), X(0xa2), X(0xa3), X(0xa4), X(0xa5), X(0xa6), X(0xa7), X(0xa8), X(0xa9), X(0xaa), X(0xab), X(0xac), X(0xad), X(0xae), X(0xaf),
-    X(0xb0), X(0xb1), X(0xb2), X(0xb3), X(0xb4), X(0xb5), X(0xb6), X(0xb7), X(0xb8), X(0xb9), X(0xba), X(0xbb), X(0xbc), X(0xbd), X(0xbe), X(0xbf),
-    X(0xc0), X(0xc1), X(0xc2), X(0xc3), X(0xc4), X(0xc5), X(0xc6), X(0xc7), X(0xc8), X(0xc9), X(0xca), X(0xcb), X(0xcc), X(0xcd), X(0xce), X(0xcf),
-    X(0xd0), X(0xd1), X(0xd2), X(0xd3), X(0xd4), X(0xd5), X(0xd6), X(0xd7), X(0xd8), X(0xd9), X(0xda), X(0xdb), X(0xdc), X(0xdd), X(0xde), X(0xdf),
-    X(0xe0), X(0xe1), X(0xe2), X(0xe3), X(0xe4), X(0xe5), X(0xe6), X(0xe7), X(0xe8), X(0xe9), X(0xea), X(0xeb), X(0xec), X(0xed), X(0xee), X(0xef),
-    X(0xf0), X(0xf1), X(0xf2), X(0xf3), X(0xf4), X(0xf5), X(0xf6), X(0xf7), X(0xf8), X(0xf9), X(0xfa), X(0xfb), X(0xfc), X(0xfd), X(0xfe), X(0xff)
-};
-
-#undef X

lib/BlueSCSI_platform_GD32F205/BlueSCSI_platform.h

@@ -1,151 +0,0 @@
-// Platform-specific definitions for BlueSCSI.
-// Can be customized for different microcontrollers, this file is for GD32F205VCT6.
-
-#pragma once
-
-#include <gd32f20x.h>
-#include <gd32f20x_gpio.h>
-#include <scsi2sd.h>
-#include "BlueSCSI_config.h"
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-extern const char *g_bluescsiplatform_name;
-
-#if defined(BlueSCSI_V1_0)
-#   define PLATFORM_NAME "BlueSCSI v1.0"
-#   define PLATFORM_REVISION "1.0"
-#   define PLATFORM_MAX_SCSI_SPEED S2S_CFG_SPEED_ASYNC_50
-#   include "BlueSCSI_v1_0_gpio.h"
-#elif defined(BlueSCSI_V1_1)
-#   define PLATFORM_NAME "BlueSCSI v1.1"
-#   define PLATFORM_REVISION "1.1"
-#   define PLATFORM_MAX_SCSI_SPEED S2S_CFG_SPEED_SYNC_10
-#   define PLATFORM_OPTIMAL_MIN_SD_WRITE_SIZE 4096
-#   define PLATFORM_OPTIMAL_MAX_SD_WRITE_SIZE 65536
-#   define PLATFORM_OPTIMAL_LAST_SD_WRITE_SIZE 8192
-#   include "BlueSCSI_v1_1_gpio.h"
-#endif
-
-// Debug logging functions
-void bluescsiplatform_log(const char *s);
-
-// Minimal millis() implementation as GD32F205 does not
-// have an Arduino core yet.
-unsigned long millis(void);
-void delay(unsigned long ms);
-
-// Precise nanosecond delays
-// Works in interrupt context also, max delay 500 000 ns, min delay about 500 ns
-void delay_ns(unsigned long ns);
-
-static inline void delay_us(unsigned long us)
-{
-    if (us > 0)
-    {
-        delay_ns(us * 1000);
-    }
-}
-
-// Approximate fast delay
-static inline void delay_100ns()
-{
-    asm volatile ("nop \n nop \n nop \n nop \n nop");
-}
-
-// Initialize SPI and GPIO configuration
-void bluescsiplatform_init();
-
-// Initialization for main application, not used for bootloader
-void bluescsiplatform_late_init();
-
-// Setup soft watchdog
-void bluescsiplatform_reset_watchdog();
-
-// Reinitialize SD card connection and save log from interrupt context.
-// This can be used in crash handlers.
-void bluescsiplatform_emergency_log_save();
-
-// Set callback that will be called during data transfer to/from SD card.
-// This can be used to implement simultaneous transfer to SCSI bus.
-typedef void (*sd_callback_t)(uint32_t bytes_complete);
-void bluescsiplatform_set_sd_callback(sd_callback_t func, const uint8_t *buffer);
-
-// This function is called by scsiPhy.cpp.
-// It resets the systick counter to give 1 millisecond of uninterrupted transfer time.
-// The total number of skips is kept track of to keep the correct time on average.
-void SysTick_Handle_PreEmptively();
-
-// Reprogram firmware in main program area.
-#define BLUESCSIPLATFORM_BOOTLOADER_SIZE 32768
-#define BLUESCSIPLATFORM_FLASH_TOTAL_SIZE (256 * 1024)
-#define BLUESCSIPLATFORM_FLASH_PAGE_SIZE 2048
-bool bluescsiplatform_rewrite_flash_page(uint32_t offset, uint8_t buffer[BLUESCSIPLATFORM_FLASH_PAGE_SIZE]);
-void bluescsiplatform_boot_to_main_firmware();
-
-// Configuration customizations based on DIP switch settings
-// When DIPSW1 is on, Apple quirks are enabled by default.
-void bluescsiplatform_config_hook(S2S_TargetCfg *config);
-#define BLUESCSIPLATFORM_CONFIG_HOOK(cfg) bluescsiplatform_config_hook(cfg)
-
-// Write a single SCSI pin.
-// Example use: SCSI_OUT(ATN, 1) sets SCSI_ATN to low (active) state.
-#define SCSI_OUT(pin, state) \
-    GPIO_BOP(SCSI_OUT_ ## pin ## _PORT) = (SCSI_OUT_ ## pin ## _PIN) << (state ? 16 : 0)
-
-// Read a single SCSI pin.
-// Example use: SCSI_IN(ATN), returns 1 for active low state.
-#define SCSI_IN(pin) \
-    ((GPIO_ISTAT(SCSI_ ## pin ## _PORT) & (SCSI_ ## pin ## _PIN)) ? 0 : 1)
-
-// Write SCSI data bus, also sets REQ to inactive.
-extern const uint32_t g_scsi_out_byte_to_bop[256];
-#define SCSI_OUT_DATA(data) \
-    GPIO_BOP(SCSI_OUT_PORT) = g_scsi_out_byte_to_bop[(uint8_t)(data)]
-
-// Release SCSI data bus and REQ signal
-#define SCSI_RELEASE_DATA_REQ() \
-    GPIO_BOP(SCSI_OUT_PORT) = SCSI_OUT_DATA_MASK | SCSI_OUT_REQ
-
-// Release all SCSI outputs
-#define SCSI_RELEASE_OUTPUTS() \
-    GPIO_BOP(SCSI_OUT_PORT) = SCSI_OUT_DATA_MASK | SCSI_OUT_REQ, \
-    GPIO_BOP(SCSI_OUT_IO_PORT)  = SCSI_OUT_IO_PIN, \
-    GPIO_BOP(SCSI_OUT_CD_PORT)  = SCSI_OUT_CD_PIN, \
-    GPIO_BOP(SCSI_OUT_SEL_PORT) = SCSI_OUT_SEL_PIN, \
-    GPIO_BOP(SCSI_OUT_MSG_PORT) = SCSI_OUT_MSG_PIN, \
-    GPIO_BOP(SCSI_OUT_RST_PORT) = SCSI_OUT_RST_PIN, \
-    GPIO_BOP(SCSI_OUT_BSY_PORT) = SCSI_OUT_BSY_PIN
-
-// Read SCSI data bus
-#define SCSI_IN_DATA(data) \
-    (((~GPIO_ISTAT(SCSI_IN_PORT)) & SCSI_IN_MASK) >> SCSI_IN_SHIFT)
-
-#ifdef __cplusplus
-}
-
-// SD card driver for SdFat
-#ifndef SD_USE_SDIO
-// SPI interface, BlueSCSI v1.0
-class SdSpiConfig;
-extern SdSpiConfig g_sd_spi_config;
-#define SD_CONFIG g_sd_spi_config
-#define SD_CONFIG_CRASH g_sd_spi_config
-
-#else
-// SDIO interface, BlueSCSI v1.1
-class SdioConfig;
-extern SdioConfig g_sd_sdio_config;
-extern SdioConfig g_sd_sdio_config_crash;
-#define SD_CONFIG g_sd_sdio_config
-#define SD_CONFIG_CRASH g_sd_sdio_config_crash
-
-#endif
-
-// Check if a DMA request for SD card read has completed.
-// This is used to optimize the timing of data transfers on SCSI bus.
-bool check_sd_read_done();
-
-#endif

lib/BlueSCSI_platform_GD32F205/BlueSCSI_v1_0_gpio.h

@@ -1,119 +0,0 @@
-// GPIO definitions for BlueSCSI v1.0
-
-#pragma once
-
-// SCSI data output port.
-// The output data is written using BSRR mechanism, so all data pins must be on same GPIO port.
-// The output pins are open-drain in hardware, using separate buffer chips for driving.
-#define SCSI_OUT_PORT GPIOD
-#define SCSI_OUT_DB7  GPIO_PIN_0
-#define SCSI_OUT_DB6  GPIO_PIN_1
-#define SCSI_OUT_DB5  GPIO_PIN_2
-#define SCSI_OUT_DB4  GPIO_PIN_3
-#define SCSI_OUT_DB3  GPIO_PIN_4
-#define SCSI_OUT_DB2  GPIO_PIN_5
-#define SCSI_OUT_DB1  GPIO_PIN_6
-#define SCSI_OUT_DB0  GPIO_PIN_7
-#define SCSI_OUT_DBP  GPIO_PIN_15
-#define SCSI_OUT_REQ  GPIO_PIN_9
-#define SCSI_OUT_DATA_MASK (SCSI_OUT_DB0 | SCSI_OUT_DB1 | SCSI_OUT_DB2 | SCSI_OUT_DB3 | SCSI_OUT_DB4 | SCSI_OUT_DB5 | SCSI_OUT_DB6 | SCSI_OUT_DB7 | SCSI_OUT_DBP)
-#define SCSI_OUT_REQ_IDX 9
-
-// SCSI input data port
-#define SCSI_IN_PORT  GPIOE
-#define SCSI_IN_DB7   GPIO_PIN_15
-#define SCSI_IN_DB6   GPIO_PIN_14
-#define SCSI_IN_DB5   GPIO_PIN_13
-#define SCSI_IN_DB4   GPIO_PIN_12
-#define SCSI_IN_DB3   GPIO_PIN_11
-#define SCSI_IN_DB2   GPIO_PIN_10
-#define SCSI_IN_DB1   GPIO_PIN_9
-#define SCSI_IN_DB0   GPIO_PIN_8
-#define SCSI_IN_DBP   GPIO_PIN_7
-#define SCSI_IN_MASK  (SCSI_IN_DB7|SCSI_IN_DB6|SCSI_IN_DB5|SCSI_IN_DB4|SCSI_IN_DB3|SCSI_IN_DB2|SCSI_IN_DB1|SCSI_IN_DB0|SCSI_IN_DBP)
-#define SCSI_IN_SHIFT 8
-
-// SCSI output status lines
-#define SCSI_OUT_IO_PORT  GPIOD
-#define SCSI_OUT_IO_PIN   GPIO_PIN_8
-#define SCSI_OUT_CD_PORT  GPIOD
-#define SCSI_OUT_CD_PIN   GPIO_PIN_10
-#define SCSI_OUT_SEL_PORT GPIOD
-#define SCSI_OUT_SEL_PIN  GPIO_PIN_11
-#define SCSI_OUT_MSG_PORT GPIOD
-#define SCSI_OUT_MSG_PIN  GPIO_PIN_12
-#define SCSI_OUT_RST_PORT GPIOD
-#define SCSI_OUT_RST_PIN  GPIO_PIN_13
-#define SCSI_OUT_BSY_PORT GPIOD
-#define SCSI_OUT_BSY_PIN  GPIO_PIN_14
-#define SCSI_OUT_REQ_PORT SCSI_OUT_PORT
-#define SCSI_OUT_REQ_PIN  SCSI_OUT_REQ
-
-// SCSI input status signals
-#define SCSI_ACK_PORT GPIOB
-#define SCSI_ACK_PIN  GPIO_PIN_12
-#define SCSI_IN_ACK_IDX 12
-
-// The SCSI_ATN pin was PB0 in prototype 2022a, but was moved to PC6 for 5V-tolerance
-#ifdef BlueSCSI_2022A_REVISION
-#define SCSI_ATN_PORT GPIOB
-#define SCSI_ATN_PIN  GPIO_PIN_0
-#else
-#define SCSI_ATN_PORT GPIOC
-#define SCSI_ATN_PIN  GPIO_PIN_6
-#endif
-
-// SEL pin uses EXTI interrupt
-#define SCSI_SEL_PORT GPIOB
-#define SCSI_SEL_PIN  GPIO_PIN_11
-#define SCSI_SEL_EXTI EXTI_11
-#define SCSI_SEL_EXTI_SOURCE_PORT GPIO_PORT_SOURCE_GPIOB
-#define SCSI_SEL_EXTI_SOURCE_PIN GPIO_PIN_SOURCE_11
-#define SCSI_SEL_IRQ EXTI10_15_IRQHandler
-#define SCSI_SEL_IRQn EXTI10_15_IRQn
-
-// BSY pin uses EXTI interrupt
-#define SCSI_BSY_PORT GPIOB
-#define SCSI_BSY_PIN  GPIO_PIN_10
-#define SCSI_BSY_EXTI EXTI_10
-#define SCSI_BSY_EXTI_SOURCE_PORT GPIO_PORT_SOURCE_GPIOB
-#define SCSI_BSY_EXTI_SOURCE_PIN  GPIO_PIN_SOURCE_10
-#define SCSI_BSY_IRQ  EXTI10_15_IRQHandler
-#define SCSI_BSY_IRQn EXTI10_15_IRQn
-
-// RST pin uses EXTI interrupt
-#define SCSI_RST_PORT GPIOB
-#define SCSI_RST_PIN  GPIO_PIN_13
-#define SCSI_RST_EXTI EXTI_13
-#define SCSI_RST_EXTI_SOURCE_PORT GPIO_PORT_SOURCE_GPIOB
-#define SCSI_RST_EXTI_SOURCE_PIN GPIO_PIN_SOURCE_13
-#define SCSI_RST_IRQ  EXTI10_15_IRQHandler
-#define SCSI_RST_IRQn EXTI10_15_IRQn
-
-// Terminator enable/disable config, active low
-#define SCSI_TERM_EN_PORT GPIOC
-#define SCSI_TERM_EN_PIN  GPIO_PIN_8
-
-// SD card pins
-#define SD_PORT      GPIOA
-#define SD_CS_PIN    GPIO_PIN_4
-#define SD_CLK_PIN   GPIO_PIN_5
-#define SD_MISO_PIN  GPIO_PIN_6
-#define SD_MOSI_PIN  GPIO_PIN_7
-#define SD_SPI       SPI0
-#define SD_SPI_RX_DMA_CHANNEL DMA_CH1
-#define SD_SPI_TX_DMA_CHANNEL DMA_CH2
-
-// DIP switches
-#define DIP_PORT     GPIOB
-#define DIPSW1_PIN   GPIO_PIN_4
-#define DIPSW2_PIN   GPIO_PIN_5
-#define DIPSW3_PIN   GPIO_PIN_6
-
-// Status LED pins
-#define LED_PORT     GPIOC
-#define LED_I_PIN    GPIO_PIN_4
-#define LED_E_PIN    GPIO_PIN_5
-#define LED_PINS     (LED_I_PIN | LED_E_PIN)
-#define LED_ON()     gpio_bit_reset(LED_PORT, LED_PINS)
-#define LED_OFF()    gpio_bit_set(LED_PORT, LED_PINS)

lib/BlueSCSI_platform_GD32F205/BlueSCSI_v1_1_gpio.h

@@ -1,164 +0,0 @@
-// GPIO definitions for BlueSCSI v1.1
-
-#pragma once
-
-// SCSI data output port.
-// The output data is written using BSRR mechanism, so all data pins must be on same GPIO port.
-// The output pins are open-drain in hardware, using separate buffer chips for driving.
-#define SCSI_OUT_PORT GPIOD
-#define SCSI_OUT_DB7  GPIO_PIN_9
-#define SCSI_OUT_DB6  GPIO_PIN_10
-#define SCSI_OUT_DB5  GPIO_PIN_11
-#define SCSI_OUT_DB4  GPIO_PIN_12
-#define SCSI_OUT_DB3  GPIO_PIN_13
-#define SCSI_OUT_DB2  GPIO_PIN_14
-#define SCSI_OUT_DB1  GPIO_PIN_0
-#define SCSI_OUT_DB0  GPIO_PIN_1
-#define SCSI_OUT_DBP  GPIO_PIN_8
-#define SCSI_OUT_REQ  GPIO_PIN_4
-#define SCSI_OUT_DATA_MASK (SCSI_OUT_DB0 | SCSI_OUT_DB1 | SCSI_OUT_DB2 | SCSI_OUT_DB3 | SCSI_OUT_DB4 | SCSI_OUT_DB5 | SCSI_OUT_DB6 | SCSI_OUT_DB7 | SCSI_OUT_DBP)
-#define SCSI_OUT_REQ_IDX 4
-
-// Control signals to optional PLD device
-#define SCSI_OUT_PLD1 GPIO_PIN_15
-#define SCSI_OUT_PLD2 GPIO_PIN_3
-#define SCSI_OUT_PLD3 GPIO_PIN_5
-#define SCSI_OUT_PLD4 GPIO_PIN_7
-
-// Control signals for timer based DMA acceleration
-#define SCSI_TIMER TIMER7
-#define SCSI_TIMER_RCU RCU_TIMER7
-#define SCSI_TIMER_OUT_PORT GPIOB
-#define SCSI_TIMER_OUT_PIN GPIO_PIN_1
-#define SCSI_TIMER_IN_PORT GPIOC
-#define SCSI_TIMER_IN_PIN GPIO_PIN_6
-#define SCSI_TIMER_DMA DMA1
-#define SCSI_TIMER_DMA_RCU RCU_DMA1
-#define SCSI_TIMER_DMACHA DMA_CH4
-#define SCSI_TIMER_DMACHB DMA_CH1
-#define SCSI_TIMER_DMACHA_IRQ DMA1_Channel4_IRQHandler
-#define SCSI_TIMER_DMACHA_IRQn DMA1_Channel4_IRQn
-#define SCSI_TIMER_DMACHB_IRQ DMA1_Channel1_IRQHandler
-#define SCSI_TIMER_DMACHB_IRQn DMA1_Channel1_IRQn
-
-// GreenPAK logic chip pins
-#define GREENPAK_I2C_ADDR 0x10
-#define GREENPAK_I2C_PORT GPIOB
-#define GREENPAK_I2C_SCL GPIO_PIN_8
-#define GREENPAK_I2C_SDA GPIO_PIN_9
-#define GREENPAK_PLD_IO1 GPIO_PIN_15
-#define GREENPAK_PLD_IO2 GPIO_PIN_3
-#define GREENPAK_PLD_IO3 GPIO_PIN_5
-#define GREENPAK_PLD_IO4 GPIO_PIN_7
-#define GREENPAK_PLD_IO2_EXTI EXTI_3
-#define GREENPAK_PLD_IO2_EXTI_SOURCE_PORT GPIO_PORT_SOURCE_GPIOD
-#define GREENPAK_PLD_IO2_EXTI_SOURCE_PIN  GPIO_PIN_SOURCE_3
-#define GREENPAK_IRQ  EXTI3_IRQHandler
-#define GREENPAK_IRQn EXTI3_IRQn
-
-// SCSI input data port
-#define SCSI_IN_PORT  GPIOE
-#define SCSI_IN_DB7   GPIO_PIN_15
-#define SCSI_IN_DB6   GPIO_PIN_14
-#define SCSI_IN_DB5   GPIO_PIN_13
-#define SCSI_IN_DB4   GPIO_PIN_12
-#define SCSI_IN_DB3   GPIO_PIN_11
-#define SCSI_IN_DB2   GPIO_PIN_10
-#define SCSI_IN_DB1   GPIO_PIN_9
-#define SCSI_IN_DB0   GPIO_PIN_8
-#define SCSI_IN_DBP   GPIO_PIN_7
-#define SCSI_IN_MASK  (SCSI_IN_DB7|SCSI_IN_DB6|SCSI_IN_DB5|SCSI_IN_DB4|SCSI_IN_DB3|SCSI_IN_DB2|SCSI_IN_DB1|SCSI_IN_DB0|SCSI_IN_DBP)
-#define SCSI_IN_SHIFT 8
-
-// SCSI output status lines
-#define SCSI_OUT_IO_PORT  GPIOA
-#define SCSI_OUT_IO_PIN   GPIO_PIN_4
-#define SCSI_OUT_CD_PORT  GPIOA
-#define SCSI_OUT_CD_PIN   GPIO_PIN_5
-#define SCSI_OUT_SEL_PORT GPIOA
-#define SCSI_OUT_SEL_PIN  GPIO_PIN_6
-#define SCSI_OUT_MSG_PORT GPIOA
-#define SCSI_OUT_MSG_PIN  GPIO_PIN_7
-#define SCSI_OUT_RST_PORT GPIOB
-#define SCSI_OUT_RST_PIN  GPIO_PIN_14
-#define SCSI_OUT_BSY_PORT GPIOB
-#define SCSI_OUT_BSY_PIN  GPIO_PIN_15
-#define SCSI_OUT_REQ_PORT SCSI_OUT_PORT
-#define SCSI_OUT_REQ_PIN  SCSI_OUT_REQ
-
-// SCSI input status signals
-#define SCSI_ACK_PORT GPIOA
-#define SCSI_ACK_PIN  GPIO_PIN_0
-#define SCSI_ATN_PORT GPIOB
-#define SCSI_ATN_PIN  GPIO_PIN_12
-#define SCSI_IN_ACK_IDX 0
-
-// Extra signals used with EXMC for synchronous mode
-#define SCSI_IN_ACK_EXMC_NWAIT_PORT GPIOD
-#define SCSI_IN_ACK_EXMC_NWAIT_PIN  GPIO_PIN_6
-#define SCSI_OUT_REQ_EXMC_NOE_PORT  GPIOD
-#define SCSI_OUT_REQ_EXMC_NOE_PIN   GPIO_PIN_4
-#define SCSI_OUT_REQ_EXMC_NOE_IDX   4
-#define SCSI_EXMC_DATA_SHIFT 5
-#define SCSI_EXMC_DMA DMA0
-#define SCSI_EXMC_DMA_RCU RCU_DMA0
-#define SCSI_EXMC_DMACH DMA_CH0
-#define SCSI_SYNC_TIMER TIMER1
-#define SCSI_SYNC_TIMER_RCU RCU_TIMER1
-
-// SEL pin uses EXTI interrupt
-#define SCSI_SEL_PORT GPIOB
-#define SCSI_SEL_PIN  GPIO_PIN_11
-#define SCSI_SEL_EXTI EXTI_11
-#define SCSI_SEL_EXTI_SOURCE_PORT GPIO_PORT_SOURCE_GPIOB
-#define SCSI_SEL_EXTI_SOURCE_PIN GPIO_PIN_SOURCE_11
-#define SCSI_SEL_IRQ EXTI10_15_IRQHandler
-#define SCSI_SEL_IRQn EXTI10_15_IRQn
-
-// BSY pin uses EXTI interrupt
-#define SCSI_BSY_PORT GPIOB
-#define SCSI_BSY_PIN  GPIO_PIN_10
-#define SCSI_BSY_EXTI EXTI_10
-#define SCSI_BSY_EXTI_SOURCE_PORT GPIO_PORT_SOURCE_GPIOB
-#define SCSI_BSY_EXTI_SOURCE_PIN  GPIO_PIN_SOURCE_10
-#define SCSI_BSY_IRQ  EXTI10_15_IRQHandler
-#define SCSI_BSY_IRQn EXTI10_15_IRQn
-
-// RST pin uses EXTI interrupt
-#define SCSI_RST_PORT GPIOB
-#define SCSI_RST_PIN  GPIO_PIN_13
-#define SCSI_RST_EXTI EXTI_13
-#define SCSI_RST_EXTI_SOURCE_PORT GPIO_PORT_SOURCE_GPIOB
-#define SCSI_RST_EXTI_SOURCE_PIN GPIO_PIN_SOURCE_13
-#define SCSI_RST_IRQ  EXTI10_15_IRQHandler
-#define SCSI_RST_IRQn EXTI10_15_IRQn
-
-// Terminator enable/disable config, active low
-#define SCSI_TERM_EN_PORT GPIOB
-#define SCSI_TERM_EN_PIN  GPIO_PIN_0
-
-// SD card pins
-#define SD_USE_SDIO 1
-#define SD_SDIO_DATA_PORT GPIOC
-#define SD_SDIO_D0        GPIO_PIN_8
-#define SD_SDIO_D1        GPIO_PIN_9
-#define SD_SDIO_D2        GPIO_PIN_10
-#define SD_SDIO_D3        GPIO_PIN_11
-#define SD_SDIO_CLK_PORT  GPIOC
-#define SD_SDIO_CLK       GPIO_PIN_12
-#define SD_SDIO_CMD_PORT  GPIOD
-#define SD_SDIO_CMD       GPIO_PIN_2
-
-// DIP switches
-#define DIP_PORT     GPIOB
-#define DIPSW1_PIN   GPIO_PIN_4
-#define DIPSW2_PIN   GPIO_PIN_5
-#define DIPSW3_PIN   GPIO_PIN_6
-
-// Status LED pins
-#define LED_PORT     GPIOC
-#define LED_I_PIN    GPIO_PIN_4
-#define LED_E_PIN    GPIO_PIN_5
-#define LED_PINS     (LED_I_PIN | LED_E_PIN)
-#define LED_ON()     gpio_bit_reset(LED_PORT, LED_PINS)
-#define LED_OFF()    gpio_bit_set(LED_PORT, LED_PINS)

lib/BlueSCSI_platform_GD32F205/bluescsi_gd32f205.ld

@@ -1,175 +0,0 @@
-/*
- *
- * Customized linker script for combining bootloader & main program
- * PlatformIO default linker script template for STM32 F1/F2/F3/F4/F7/L0/L1/L4
- *
- */
-
-/* Entry Point */
-ENTRY(Reset_Handler)
-
-/* Highest address of the user mode stack */ 
-_estack = 0x20020000;    /* end of RAM */
-/* Generate a link error if heap and stack don't fit into RAM */
-_Min_Heap_Size = 0x200;      /* required amount of heap  */
-_Min_Stack_Size = 0x400;     /* required amount of stack */
-
-/* Specify the memory areas */
-MEMORY
-{
-    RAM (xrw)      : ORIGIN = 0x20000000, LENGTH = 128K
-    CCRAM (xrw)    : ORIGIN = 0x10000000, LENGTH = 0K
-    FLASH (rx)     : ORIGIN = 0x08000000, LENGTH = 256K
-}
-
-/* Define output sections */
-SECTIONS
-{
-  /* If bootloader is included, it goes in first 32 kB */
-  .text.bootloader : ALIGN(16) SUBALIGN(16)
-  {
-    KEEP(*(.text.btldr*))
-    . = ALIGN(32768);
-    CHECK_BOOTLOADER_SIZE = 1 / (. <= 32768);
-  } >FLASH
-  
-  /* The startup code goes first into FLASH */
-  .isr_vector :
-  {
-    . = ALIGN(4);
-    KEEP(*(.isr_vector)) /* Startup code */
-    . = ALIGN(4);
-  } >FLASH
-
-  /* The program code and other data goes into FLASH */
-  .text :
-  {
-    . = ALIGN(4);
-    *(.text)           /* .text sections (code) */
-    *(.text*)          /* .text* sections (code) */
-    *(.glue_7)         /* glue arm to thumb code */
-    *(.glue_7t)        /* glue thumb to arm code */
-    *(.eh_frame)
-
-    KEEP (*(.init))
-    KEEP (*(.fini))
-
-    . = ALIGN(4);
-    _etext = .;        /* define a global symbols at end of code */
-  } >FLASH
-
-  /* Constant data goes into FLASH */
-  .rodata :
-  {
-    . = ALIGN(4);
-    *(.rodata)         /* .rodata sections (constants, strings, etc.) */
-    *(.rodata*)        /* .rodata* sections (constants, strings, etc.) */
-    . = ALIGN(4);
-  } >FLASH
-
-  .ARM.extab   : { *(.ARM.extab* .gnu.linkonce.armextab.*) } >FLASH
-  .ARM : {
-    __exidx_start = .;
-    *(.ARM.exidx*)
-    __exidx_end = .;
-  } >FLASH
-
-  .preinit_array     :
-  {
-    PROVIDE_HIDDEN (__preinit_array_start = .);
-    KEEP (*(.preinit_array*))
-    PROVIDE_HIDDEN (__preinit_array_end = .);
-  } >FLASH
-  .init_array :
-  {
-    PROVIDE_HIDDEN (__init_array_start = .);
-    KEEP (*(SORT(.init_array.*)))
-    KEEP (*(.init_array*))
-    PROVIDE_HIDDEN (__init_array_end = .);
-  } >FLASH
-  .fini_array :
-  {
-    PROVIDE_HIDDEN (__fini_array_start = .);
-    KEEP (*(SORT(.fini_array.*)))
-    KEEP (*(.fini_array*))
-    PROVIDE_HIDDEN (__fini_array_end = .);
-  } >FLASH
-
-  /* used by the startup to initialize data */
-  _sidata = LOADADDR(.data);
-
-  /* Initialized data sections goes into RAM, load LMA copy after code */
-  .data : 
-  {
-    . = ALIGN(4);
-    _sdata = .;        /* create a global symbol at data start */
-    *(.data)           /* .data sections */
-    *(.data*)          /* .data* sections */
-
-    . = ALIGN(4);
-    _edata = .;        /* define a global symbol at data end */
-  } >RAM AT> FLASH
-  
-  /* Uninitialized data section */
-  . = ALIGN(4);
-  .bss :
-  {
-    /* This is used by the startup in order to initialize the .bss secion */
-    _sbss = .;         /* define a global symbol at bss start */
-    __bss_start__ = _sbss;
-    *(.bss)
-    *(.bss*)
-    *(COMMON)
-
-    . = ALIGN(4);
-    _ebss = .;         /* define a global symbol at bss end */
-    __bss_end__ = _ebss;
-  } >RAM
-
-  /* User_heap_stack section, used to check that there is enough RAM left */
-  ._user_heap_stack :
-  {
-    . = ALIGN(4);
-    PROVIDE ( end = . );
-    PROVIDE ( _end = . );
-    . = . + _Min_Heap_Size;
-    . = . + _Min_Stack_Size;
-    . = ALIGN(4);
-  } >RAM
-
-  /* uninitialized CCRAM objects (like, buffers) */
-  .ccram_bss :
-  {
-    __ccram_start_bss__ = .; /* define a global symbol at ccram start */
-    KEEP(*(.ccram_bss))
-    KEEP(*(.ccram_bss*))
-    . = ALIGN(4);
-    __ccram_end_bss__ = .; /* define a global symbol at end of *used* CCRAM (BSS) */
-  } >CCRAM
-
-  /* initialized CCRAM objects (like, initialized variables) */
-  _si_ccram_data = LOADADDR(.ccram_data);
-  .ccram_data :
-  {
-    . = ALIGN(4);
-    _ccram_start_data = .;    /* create a global symbol at data start */
-    *(.ccram_bss)             /* .data sections */
-    *(.ccram_bss*)            /* .data* sections */
-
-    . = ALIGN(4);
-    _ccram_end_data = .;      /* define a global symbol at data end */
-  } >CCRAM AT> FLASH
-  
-
-  /* Remove information from the standard libraries */
-  /DISCARD/ :
-  {
-    libc.a ( * )
-    libm.a ( * )
-    libgcc.a ( * )
-  }
-
-  .ARM.attributes 0 : { *(.ARM.attributes) }
-}
-
-

lib/BlueSCSI_platform_GD32F205/bluescsi_gd32f205_btldr.ld

@@ -1,182 +0,0 @@
-/*
- *
- * Customized linker script for building bootloader
- *
- */
-
-/* Entry Point */
-ENTRY(Reset_Handler)
-
-/* Highest address of the user mode stack */ 
-_estack = 0x20020000;    /* end of RAM */
-/* Generate a link error if heap and stack don't fit into RAM */
-_Min_Heap_Size = 0x200;      /* required amount of heap  */
-_Min_Stack_Size = 0x400;     /* required amount of stack */
-
-/* Specify the memory areas */
-MEMORY
-{
-    RAM (xrw)      : ORIGIN = 0x20000000, LENGTH = 128K
-    CCRAM (xrw)    : ORIGIN = 0x10000000, LENGTH = 0K
-    FLASH (rx)     : ORIGIN = 0x08000000, LENGTH = 32K
-}
-
-/* Define output sections */
-SECTIONS
-{
-  /* Discard interrupt vectors that are not needed for bootloader.
-   * This way unnecessary code doesn't get pulled in.
-   */
-  /DISCARD/ :
-  {
-    *(*DMA1_Channel4_IRQHandler*)
-    *(*DMA1_Channel1_IRQHandler*)
-    *(*EXTI3_IRQHandler*)
-    *(*EXTI10_15_IRQHandler*)
-  }
-
-  DMA1_Channel1_IRQHandler = 0;
-  DMA1_Channel4_IRQHandler = 0;
-  EXTI10_15_IRQHandler = 0;
-  EXTI3_IRQHandler = 0;
-
-  /* The startup code goes first into FLASH */
-  .isr_vector :
-  {
-    . = ALIGN(4);
-    KEEP(*(.isr_vector)) /* Startup code */
-    . = ALIGN(4);
-  } >FLASH
-
-  /* The program code and other data goes into FLASH */
-  .text :
-  {
-    . = ALIGN(4);
-    *(.text)           /* .text sections (code) */
-    *(.text*)          /* .text* sections (code) */
-    *(.glue_7)         /* glue arm to thumb code */
-    *(.glue_7t)        /* glue thumb to arm code */
-    *(.eh_frame)
-
-    KEEP (*(.init))
-    KEEP (*(.fini))
-
-    . = ALIGN(4);
-    _etext = .;        /* define a global symbols at end of code */
-  } >FLASH
-
-  /* Constant data goes into FLASH */
-  .rodata :
-  {
-    . = ALIGN(4);
-    *(.rodata)         /* .rodata sections (constants, strings, etc.) */
-    *(.rodata*)        /* .rodata* sections (constants, strings, etc.) */
-    . = ALIGN(4);
-  } >FLASH
-
-  .ARM.extab   : { *(.ARM.extab* .gnu.linkonce.armextab.*) } >FLASH
-  .ARM : {
-    __exidx_start = .;
-    *(.ARM.exidx*)
-    __exidx_end = .;
-  } >FLASH
-
-  .preinit_array     :
-  {
-    PROVIDE_HIDDEN (__preinit_array_start = .);
-    KEEP (*(.preinit_array*))
-    PROVIDE_HIDDEN (__preinit_array_end = .);
-  } >FLASH
-  .init_array :
-  {
-    PROVIDE_HIDDEN (__init_array_start = .);
-    KEEP (*(SORT(.init_array.*)))
-    KEEP (*(.init_array*))
-    PROVIDE_HIDDEN (__init_array_end = .);
-  } >FLASH
-  .fini_array :
-  {
-    PROVIDE_HIDDEN (__fini_array_start = .);
-    KEEP (*(SORT(.fini_array.*)))
-    KEEP (*(.fini_array*))
-    PROVIDE_HIDDEN (__fini_array_end = .);
-  } >FLASH
-
-  /* used by the startup to initialize data */
-  _sidata = LOADADDR(.data);
-
-  /* Initialized data sections goes into RAM, load LMA copy after code */
-  .data : 
-  {
-    . = ALIGN(4);
-    _sdata = .;        /* create a global symbol at data start */
-    *(.data)           /* .data sections */
-    *(.data*)          /* .data* sections */
-
-    . = ALIGN(4);
-    _edata = .;        /* define a global symbol at data end */
-  } >RAM AT> FLASH
-  
-  /* Uninitialized data section */
-  . = ALIGN(4);
-  .bss :
-  {
-    /* This is used by the startup in order to initialize the .bss secion */
-    _sbss = .;         /* define a global symbol at bss start */
-    __bss_start__ = _sbss;
-    *(.bss)
-    *(.bss*)
-    *(COMMON)
-
-    . = ALIGN(4);
-    _ebss = .;         /* define a global symbol at bss end */
-    __bss_end__ = _ebss;
-  } >RAM
-
-  /* User_heap_stack section, used to check that there is enough RAM left */
-  ._user_heap_stack :
-  {
-    . = ALIGN(4);
-    PROVIDE ( end = . );
-    PROVIDE ( _end = . );
-    . = . + _Min_Heap_Size;
-    . = . + _Min_Stack_Size;
-    . = ALIGN(4);
-  } >RAM
-
-  /* uninitialized CCRAM objects (like, buffers) */
-  .ccram_bss :
-  {
-    __ccram_start_bss__ = .; /* define a global symbol at ccram start */
-    KEEP(*(.ccram_bss))
-    KEEP(*(.ccram_bss*))
-    . = ALIGN(4);
-    __ccram_end_bss__ = .; /* define a global symbol at end of *used* CCRAM (BSS) */
-  } >CCRAM
-
-  /* initialized CCRAM objects (like, initialized variables) */
-  _si_ccram_data = LOADADDR(.ccram_data);
-  .ccram_data :
-  {
-    . = ALIGN(4);
-    _ccram_start_data = .;    /* create a global symbol at data start */
-    *(.ccram_bss)             /* .data sections */
-    *(.ccram_bss*)            /* .data* sections */
-
-    . = ALIGN(4);
-    _ccram_end_data = .;      /* define a global symbol at data end */
-  } >CCRAM AT> FLASH
-  
-
-  /* Remove information from the standard libraries */
-  /DISCARD/ :
-  {
-    libc.a ( * )
-    libm.a ( * )
-    libgcc.a ( * )
-  }
-
-  .ARM.attributes 0 : { *(.ARM.attributes) }
-}
-
-

lib/BlueSCSI_platform_GD32F205/bsp.h

@@ -1,5 +0,0 @@
-// Dummy file for SCSI2SD.
-
-#pragma once
-
-#define S2S_DMA_ALIGN

lib/BlueSCSI_platform_GD32F205/gd32_sdio_sdcard.c

@@ -1,2520 +0,0 @@
-/*!
-    \file    sdcard.c
-    \brief   SD card driver
-
-    \version 2015-07-15, V1.0.0, firmware for GD32F20x
-    \version 2017-06-05, V2.0.0, firmware for GD32F20x
-    \version 2018-10-31, V2.1.0, firmware for GD32F20x
-    \version 2020-09-30, V2.2.0, firmware for GD32F20x
-    \version 2021-07-30, V2.3.0, firmware for GD32F20x
-*/
-
-/*
-    Copyright (c) 2021, GigaDevice Semiconductor Inc.
-
-    Redistribution and use in source and binary forms, with or without modification,
-are permitted provided that the following conditions are met:
-
-    1. Redistributions of source code must retain the above copyright notice, this
-       list of conditions and the following disclaimer.
-    2. Redistributions in binary form must reproduce the above copyright notice,
-       this list of conditions and the following disclaimer in the documentation
-       and/or other materials provided with the distribution.
-    3. Neither the name of the copyright holder nor the names of its contributors
-       may be used to endorse or promote products derived from this software without
-       specific prior written permission.
-
-    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
-IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
-INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
-NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
-PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
-WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
-OF SUCH DAMAGE.
-*/
-
-#include "gd32_sdio_sdcard.h"
-#include "gd32f20x_sdio.h"
-#include <stddef.h>
-
-/* card status of R1 definitions */
-#define SD_R1_OUT_OF_RANGE                  BIT(31)                   /* command's argument was out of the allowed range */
-#define SD_R1_ADDRESS_ERROR                 BIT(30)                   /* misaligned address which did not match the block length */
-#define SD_R1_BLOCK_LEN_ERROR               BIT(29)                   /* transferred block length is not allowed */
-#define SD_R1_ERASE_SEQ_ERROR               BIT(28)                   /* an error in the sequence of erase commands occurred */
-#define SD_R1_ERASE_PARAM                   BIT(27)                   /* an invalid selection of write-blocks for erase occurred */
-#define SD_R1_WP_VIOLATION                  BIT(26)                   /* the host attempts to write to a protected block or to the temporary or permanent write protected card */
-#define SD_R1_CARD_IS_LOCKED                BIT(25)                   /* the card is locked by the host */
-#define SD_R1_LOCK_UNLOCK_FAILED            BIT(24)                   /* a sequence or password error has been detected in lock/unlock card command */
-#define SD_R1_COM_CRC_ERROR                 BIT(23)                   /* CRC check of the previous command failed */
-#define SD_R1_ILLEGAL_COMMAND               BIT(22)                   /* command not legal for the card state */
-#define SD_R1_CARD_ECC_FAILED               BIT(21)                   /* card internal ECC was applied but failed to correct the data */
-#define SD_R1_CC_ERROR                      BIT(20)                   /* internal card controller error */
-#define SD_R1_GENERAL_UNKNOWN_ERROR         BIT(19)                   /* a general or an unknown error occurred during the operation */
-#define SD_R1_CSD_OVERWRITE                 BIT(16)                   /* read only section of the CSD does not match or attempt to reverse the copy or permanent WP bits */
-#define SD_R1_WP_ERASE_SKIP                 BIT(15)                   /* partial address space was erased */
-#define SD_R1_CARD_ECC_DISABLED             BIT(14)                   /* command has been executed without using the internal ECC */
-#define SD_R1_ERASE_RESET                   BIT(13)                   /* an erase sequence was cleared before executing */
-#define SD_R1_READY_FOR_DATA                BIT(8)                    /* correspond to buffer empty signaling on the bus */
-#define SD_R1_APP_CMD                       BIT(5)                    /* card will expect ACMD */
-#define SD_R1_AKE_SEQ_ERROR                 BIT(3)                    /* error in the sequence of the authentication process */
-#define SD_R1_ERROR_BITS                    (uint32_t)0xFDF9E008      /* all the R1 error bits */
-
-/* card status of R6 definitions */
-#define SD_R6_COM_CRC_ERROR                 BIT(15)                   /* CRC check of the previous command failed */
-#define SD_R6_ILLEGAL_COMMAND               BIT(14)                   /* command not legal for the card state */
-#define SD_R6_GENERAL_UNKNOWN_ERROR         BIT(13)                   /* a general or an unknown error occurred during the operation */
-
-/* card state */
-#define SD_CARDSTATE_IDLE                   ((uint8_t)0x00)           /* card is in idle state */
-#define SD_CARDSTATE_READY                  ((uint8_t)0x01)           /* card is in ready state */
-#define SD_CARDSTATE_IDENTIFICAT            ((uint8_t)0x02)           /* card is in identificat state */
-#define SD_CARDSTATE_STANDBY                ((uint8_t)0x03)           /* card is in standby state */
-#define SD_CARDSTATE_TRANSFER               ((uint8_t)0x04)           /* card is in transfer state */
-#define SD_CARDSTATE_DATA                   ((uint8_t)0x05)           /* card is in data sending state */
-#define SD_CARDSTATE_RECEIVING              ((uint8_t)0x06)           /* card is in receiving state */
-#define SD_CARDSTATE_PROGRAMMING            ((uint8_t)0x07)           /* card is in programming state */
-#define SD_CARDSTATE_DISCONNECT             ((uint8_t)0x08)           /* card is in disconnect state */
-#define SD_CARDSTATE_LOCKED                 ((uint32_t)0x02000000)    /* card is in locked state */
-
-#define SD_CHECK_PATTERN                    ((uint32_t)0x000001AA)    /* check pattern for CMD8 */
-#define SD_VOLTAGE_WINDOW                   ((uint32_t)0x80100000)    /* host 3.3V request in ACMD41 */
-
-/* parameters for ACMD41(voltage validation) */
-#define SD_HIGH_CAPACITY                    ((uint32_t)0x40000000)    /* high capacity SD memory card */
-#define SD_STD_CAPACITY                     ((uint32_t)0x00000000)    /* standard capacity SD memory card */
-
-/* SD bus width, check SCR register */
-#define SD_BUS_WIDTH_4BIT                   ((uint32_t)0x00040000)    /* 4-bit width bus mode */
-#define SD_BUS_WIDTH_1BIT                   ((uint32_t)0x00010000)    /* 1-bit width bus mode */
-
-/* masks for SCR register */
-#define SD_MASK_0_7BITS                     ((uint32_t)0x000000FF)    /* mask [7:0] bits */
-#define SD_MASK_8_15BITS                    ((uint32_t)0x0000FF00)    /* mask [15:8] bits */
-#define SD_MASK_16_23BITS                   ((uint32_t)0x00FF0000)    /* mask [23:16] bits */
-#define SD_MASK_24_31BITS                   ((uint32_t)0xFF000000)    /* mask [31:24] bits */
-
-#define SDIO_FIFO_ADDR                      ((uint32_t)SDIO + 0x80U)  /* address of SDIO_FIFO */
-#define SD_FIFOHALF_WORDS                   ((uint32_t)0x00000008)    /* words of FIFO half full/empty */
-#define SD_FIFOHALF_BYTES                   ((uint32_t)0x00000020)    /* bytes of FIFO half full/empty */
-
-#define SD_DATATIMEOUT                      ((uint32_t)0xFFFFFFFF)    /* DSM data timeout */
-#define SD_MAX_VOLT_VALIDATION              ((uint32_t)0x0000FFFF)    /* the maximum times of voltage validation */
-#define SD_MAX_DATA_LENGTH                  ((uint32_t)0x01FFFFFF)    /* the maximum length of data */
-#define SD_ALLZERO                          ((uint32_t)0x00000000)    /* all zero */
-#define SD_RCA_SHIFT                        ((uint8_t)0x10)           /* RCA shift bits */
-#define SD_CLK_DIV_INIT                     ((uint16_t)0x0076)        /* SD clock division in initilization phase */
-#define SD_CLK_DIV_TRANS                    ((uint16_t)0x0002)        /* SD clock division in transmission phase */
-
-#define SDIO_MASK_INTC_FLAGS                ((uint32_t)0x00C007FF)    /* mask flags of SDIO_INTC */
-
-uint32_t sd_scr[2] = {0, 0};                                          /* content of SCR register */
-
-static sdio_card_type_enum cardtype = SDIO_STD_CAPACITY_SD_CARD_V1_1; /* SD card type */
-static uint32_t sd_csd[4] = {0, 0, 0, 0};                             /* content of CSD register */
-static uint32_t sd_cid[4] = {0, 0, 0, 0};                             /* content of CID register */
-static uint16_t sd_rca = 0;                                           /* RCA of SD card */
-static uint32_t transmode = SD_POLLING_MODE;
-static uint32_t totalnumber_bytes = 0, stopcondition = 0;
-static __IO sd_error_enum transerror = SD_OK;
-static __IO uint32_t transend = 0, number_bytes = 0;
-
-/* check if the command sent error occurs */
-static sd_error_enum cmdsent_error_check(void);
-/* check if error occurs for R1 response */
-static sd_error_enum r1_error_check(uint8_t cmdindex);
-/* check if error type for R1 response */
-static sd_error_enum r1_error_type_check(uint32_t resp);
-/* check if error occurs for R2 response */
-static sd_error_enum r2_error_check(void);
-/* check if error occurs for R3 response */
-static sd_error_enum r3_error_check(void);
-/* check if error occurs for R6 response */
-static sd_error_enum r6_error_check(uint8_t cmdindex, uint16_t *prca);
-/* check if error occurs for R7 response */
-static sd_error_enum r7_error_check(void);
-
-/* get the state which the card is in */
-static sd_error_enum sd_card_state_get(uint8_t *pcardstate);
-/* configure the bus width mode */
-static sd_error_enum sd_bus_width_config(uint32_t buswidth);
-/* get the SCR of corresponding card */
-static sd_error_enum sd_scr_get(uint16_t rca, uint32_t *pscr);
-/* get the data block size */
-static uint32_t sd_datablocksize_get(uint16_t bytesnumber);
-
-/* configure the DMA for SDIO transfer request */
-static void dma_transfer_config(uint32_t *srcbuf, uint32_t bufsize);
-/* configure the DMA for SDIO receive request */
-static void dma_receive_config(uint32_t *dstbuf, uint32_t bufsize);
-
-unsigned long millis(void);
-
-/*!
-    \brief      initialize the SD card and make it in standby state
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_init(void)
-{
-    sd_error_enum status = SD_OK;
-    /* configure the RCU and GPIO, deinitialize the SDIO */
-    sdio_deinit();
-
-    /* configure the clock and work voltage */
-    status = sd_power_on();
-    if(SD_OK != status) {
-        return status;
-    }
-
-    /* initialize the card and get CID and CSD of the card */
-    status = sd_card_init();
-    if(SD_OK != status) {
-        return status;
-    }
-
-    /* configure the SDIO peripheral */
-    sdio_clock_config(SDIO_SDIOCLKEDGE_RISING, SDIO_CLOCKBYPASS_DISABLE, SDIO_CLOCKPWRSAVE_DISABLE, SD_CLK_DIV_TRANS);
-    sdio_bus_mode_set(SDIO_BUSMODE_1BIT);
-    sdio_hardware_clock_disable();
-
-    return status;
-}
-
-/*!
-    \brief      initialize the card and get CID and CSD of the card
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_card_init(void)
-{
-    sd_error_enum status = SD_OK;
-    uint16_t temp_rca = 0x01;
-
-    if(SDIO_POWER_OFF == sdio_power_state_get()) {
-        status = SD_OPERATION_IMPROPER;
-        return status;
-    }
-
-    /* the card is not I/O only card */
-    if(SDIO_SECURE_DIGITAL_IO_CARD != cardtype) {
-        /* send CMD2(SD_CMD_ALL_SEND_CID) to get the CID numbers */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_ALL_SEND_CID, (uint32_t)0x0, SDIO_RESPONSETYPE_LONG);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-        status = r2_error_check();
-        if(SD_OK != status) {
-            return status;
-        }
-
-        /* store the CID numbers */
-        sd_cid[0] = sdio_response_get(SDIO_RESPONSE0);
-        sd_cid[1] = sdio_response_get(SDIO_RESPONSE1);
-        sd_cid[2] = sdio_response_get(SDIO_RESPONSE2);
-        sd_cid[3] = sdio_response_get(SDIO_RESPONSE3);
-    }
-
-    /* the card is SD memory card or the I/O card has the memory portion */
-    if((SDIO_STD_CAPACITY_SD_CARD_V1_1 == cardtype) || (SDIO_STD_CAPACITY_SD_CARD_V2_0 == cardtype) ||
-            (SDIO_HIGH_CAPACITY_SD_CARD == cardtype) || (SDIO_SECURE_DIGITAL_IO_COMBO_CARD == cardtype)) {
-        /* send CMD3(SEND_RELATIVE_ADDR) to ask the card to publish a new relative address (RCA) */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_SEND_RELATIVE_ADDR, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-        status = r6_error_check(SD_CMD_SEND_RELATIVE_ADDR, &temp_rca);
-        if(SD_OK != status) {
-            return status;
-        }
-    }
-
-    if(SDIO_SECURE_DIGITAL_IO_CARD != cardtype) {
-        /* the card is not I/O only card */
-        sd_rca = temp_rca;
-
-        /* send CMD9(SEND_CSD) to get the addressed card's card-specific data (CSD) */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_SEND_CSD, (uint32_t)(temp_rca << SD_RCA_SHIFT), SDIO_RESPONSETYPE_LONG);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-        status = r2_error_check();
-        if(SD_OK != status) {
-            return status;
-        }
-
-        /* store the card-specific data (CSD) */
-        sd_csd[0] = sdio_response_get(SDIO_RESPONSE0);
-        sd_csd[1] = sdio_response_get(SDIO_RESPONSE1);
-        sd_csd[2] = sdio_response_get(SDIO_RESPONSE2);
-        sd_csd[3] = sdio_response_get(SDIO_RESPONSE3);
-    }
-    return status;
-}
-
-/*!
-    \brief      configure the clock and the work voltage, and get the card type
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_power_on(void)
-{
-    sd_error_enum status = SD_OK;
-    uint32_t sdcardtype = SD_STD_CAPACITY, response = 0, count = 0;
-    uint8_t busyflag = 0;
-
-    /* configure the SDIO peripheral */
-    sdio_clock_config(SDIO_SDIOCLKEDGE_RISING, SDIO_CLOCKBYPASS_DISABLE, SDIO_CLOCKPWRSAVE_DISABLE, SD_CLK_DIV_INIT);
-    sdio_bus_mode_set(SDIO_BUSMODE_1BIT);
-    sdio_hardware_clock_disable();
-    sdio_power_state_set(SDIO_POWER_ON);
-    /* enable SDIO_CLK clock output */
-    sdio_clock_enable();
-
-    /* send CMD0(GO_IDLE_STATE) to reset the card */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_GO_IDLE_STATE, (uint32_t)0x0, SDIO_RESPONSETYPE_NO);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    /* enable the CSM */
-    sdio_csm_enable();
-
-    /* check if command sent error occurs */
-    status = cmdsent_error_check();
-    if(SD_OK != status) {
-        return status;
-    }
-
-    /* send CMD8(SEND_IF_COND) to get SD memory card interface condition */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SEND_IF_COND, SD_CHECK_PATTERN, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-
-    if(SD_OK == r7_error_check()) {
-        /* SD Card 2.0 */
-        cardtype = SDIO_STD_CAPACITY_SD_CARD_V2_0;
-        sdcardtype = SD_HIGH_CAPACITY;
-    }
-
-    while((!busyflag) && (count < SD_MAX_VOLT_VALIDATION)) {
-        /* send CMD55(APP_CMD) to indicate next command is application specific command */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_APP_CMD, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-
-        
-        /* check if some error occurs */
-        /* ignoring return value, SD_ILLEGAL_COMMAND, for v1.x spec SD cards */
-        status = r1_error_check(SD_CMD_APP_CMD);
-        if(SD_OK != status && SD_ILLEGAL_COMMAND != status) {
-            return status;
-        }
-        
-        /* send ACMD41(SD_SEND_OP_COND) to get host capacity support information (HCS) and OCR content */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_APPCMD_SD_SEND_OP_COND, (SD_VOLTAGE_WINDOW | sdcardtype), SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-
-        status = r3_error_check();
-        if(SD_OK != status) {
-            return status;
-        }
-        /* get the response and check card power up status bit(busy) */
-        response = sdio_response_get(SDIO_RESPONSE0);
-        busyflag = (uint8_t)((response >> 31) & (uint32_t)0x01);
-        ++count;
-    }
-    if(count >= SD_MAX_VOLT_VALIDATION) {
-        status = SD_VOLTRANGE_INVALID;
-        return status;
-    }
-    if(response &= SD_HIGH_CAPACITY) {
-        /* SDHC card */
-        cardtype = SDIO_HIGH_CAPACITY_SD_CARD;
-    }
-
-    return status;
-}
-
-/*!
-    \brief      close the power of SDIO
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_power_off(void)
-{
-    sd_error_enum status = SD_OK;
-    sdio_power_state_set(SDIO_POWER_OFF);
-    return status;
-}
-
-/*!
-    \brief      configure the bus mode
-    \param[in]  busmode: the bus mode
-      \arg        SDIO_BUSMODE_1BIT: 1-bit SDIO card bus mode
-      \arg        SDIO_BUSMODE_4BIT: 4-bit SDIO card bus mode
-      \arg        SDIO_BUSMODE_8BIT: 8-bit SDIO card bus mode (MMC only)
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_bus_mode_config(uint32_t busmode)
-{
-    sd_error_enum status = SD_OK;
-    if(SDIO_MULTIMEDIA_CARD == cardtype) {
-        /* MMC card doesn't support this function */
-        status = SD_FUNCTION_UNSUPPORTED;
-        return status;
-    } else if((SDIO_STD_CAPACITY_SD_CARD_V1_1 == cardtype) || (SDIO_STD_CAPACITY_SD_CARD_V2_0 == cardtype) ||
-              (SDIO_HIGH_CAPACITY_SD_CARD == cardtype)) {
-        if(SDIO_BUSMODE_8BIT == busmode) {
-            /* 8 bit bus mode doesn't support */
-            status = SD_FUNCTION_UNSUPPORTED;
-            return status;
-        } else if(SDIO_BUSMODE_4BIT == busmode) {
-            /* configure SD bus width and the SDIO */
-            status = sd_bus_width_config(SD_BUS_WIDTH_4BIT);
-            if(SD_OK == status) {
-                sdio_clock_config(SDIO_SDIOCLKEDGE_RISING, SDIO_CLOCKBYPASS_DISABLE,
-                                  SDIO_CLOCKPWRSAVE_DISABLE, SD_CLK_DIV_TRANS);
-                sdio_bus_mode_set(busmode);
-                sdio_hardware_clock_disable();
-            }
-        } else if(SDIO_BUSMODE_1BIT == busmode) {
-            /* configure SD bus width and the SDIO */
-            status = sd_bus_width_config(SD_BUS_WIDTH_1BIT);
-            if(SD_OK == status) {
-                sdio_clock_config(SDIO_SDIOCLKEDGE_RISING, SDIO_CLOCKBYPASS_DISABLE,
-                                  SDIO_CLOCKPWRSAVE_DISABLE, SD_CLK_DIV_TRANS);
-                sdio_bus_mode_set(busmode);
-                sdio_hardware_clock_disable();
-            }
-        } else {
-            status = SD_PARAMETER_INVALID;
-        }
-    }
-    return status;
-}
-
-/*!
-    \brief      configure the mode of transmission
-    \param[in]  txmode: transfer mode
-      \arg        SD_DMA_MODE: DMA mode
-      \arg        SD_POLLING_MODE: polling mode
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_transfer_mode_config(uint32_t txmode)
-{
-    sd_error_enum status = SD_OK;
-    /* set the transfer mode */
-    if((SD_DMA_MODE == txmode) || (SD_POLLING_MODE == txmode)) {
-        transmode = txmode;
-    } else {
-        status = SD_PARAMETER_INVALID;
-    }
-    return status;
-}
-
-/*!
-    \brief      read a block data into a buffer from the specified address of a card
-    \param[out] preadbuffer: a pointer that store a block read data
-    \param[in]  readaddr: the read data address
-    \param[in]  blocksize: the data block size
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_block_read(uint32_t *preadbuffer, uint64_t readaddr, uint16_t blocksize, sdio_callback_t callback)
-{
-    /* initialize the variables */
-    sd_error_enum status = SD_OK;
-    uint32_t count = 0, align = 0, datablksize = SDIO_DATABLOCKSIZE_1BYTE, *ptempbuff = preadbuffer;
-
-    if(NULL == preadbuffer) {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    transerror = SD_OK;
-    transend = 0;
-    totalnumber_bytes = 0;
-    /* clear all DSM configuration */
-    sdio_data_config(0, 0, SDIO_DATABLOCKSIZE_1BYTE);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOCARD);
-    sdio_dsm_disable();
-    sdio_dma_disable();
-
-    /* check whether the card is locked */
-    if(sdio_response_get(SDIO_RESPONSE0) & SD_CARDSTATE_LOCKED) {
-        status = SD_LOCK_UNLOCK_FAILED;
-        return status;
-    }
-
-    /* blocksize is fixed in 512B for SDHC card */
-    if(SDIO_HIGH_CAPACITY_SD_CARD == cardtype) {
-        blocksize = 512;
-        readaddr /= 512;
-    }
-
-    align = blocksize & (blocksize - 1);
-    if((blocksize > 0) && (blocksize <= 2048) && (0 == align)) {
-        datablksize = sd_datablocksize_get(blocksize);
-        /* send CMD16(SET_BLOCKLEN) to set the block length */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_SET_BLOCKLEN, (uint32_t)blocksize, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_SET_BLOCKLEN);
-        if(SD_OK != status) {
-            return status;
-        }
-    } else {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    stopcondition = 0;
-    totalnumber_bytes = blocksize;
-
-    /* configure SDIO data transmission */
-    sdio_data_config(SD_DATATIMEOUT, totalnumber_bytes, datablksize);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOSDIO);
-    sdio_dsm_enable();
-
-    /* send CMD17(READ_SINGLE_BLOCK) to read a block */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_READ_SINGLE_BLOCK, (uint32_t)readaddr, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_READ_SINGLE_BLOCK);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    if(SD_POLLING_MODE == transmode) {
-        /* polling mode */
-        while(!sdio_flag_get(SDIO_FLAG_DTCRCERR | SDIO_FLAG_DTTMOUT | SDIO_FLAG_RXORE | SDIO_FLAG_DTBLKEND | SDIO_FLAG_STBITE)) {
-            if(RESET != sdio_flag_get(SDIO_FLAG_RFH)) {
-                /* at least 8 words can be read in the FIFO */
-                for(count = 0; count < SD_FIFOHALF_WORDS; count++) {
-                    *(ptempbuff + count) = sdio_data_read();
-                }
-                ptempbuff += SD_FIFOHALF_WORDS;
-            }
-        }
-
-        /* whether some error occurs and return it */
-        if(RESET != sdio_flag_get(SDIO_FLAG_DTCRCERR)) {
-            status = SD_DATA_CRC_ERROR;
-            sdio_flag_clear(SDIO_FLAG_DTCRCERR);
-            return status;
-        } else if(RESET != sdio_flag_get(SDIO_FLAG_DTTMOUT)) {
-            status = SD_DATA_TIMEOUT;
-            sdio_flag_clear(SDIO_FLAG_DTTMOUT);
-            return status;
-        } else if(RESET != sdio_flag_get(SDIO_FLAG_RXORE)) {
-            status = SD_RX_OVERRUN_ERROR;
-            sdio_flag_clear(SDIO_FLAG_RXORE);
-            return status;
-        } else if(RESET != sdio_flag_get(SDIO_FLAG_STBITE)) {
-            status = SD_START_BIT_ERROR;
-            sdio_flag_clear(SDIO_FLAG_STBITE);
-            return status;
-        }
-        while(RESET != sdio_flag_get(SDIO_FLAG_RXDTVAL)) {
-            *ptempbuff = sdio_data_read();
-            ++ptempbuff;
-        }
-        /* clear the SDIO_INTC flags */
-        sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    } else if(SD_DMA_MODE == transmode) {
-        /* DMA mode */
-        /* enable the SDIO corresponding interrupts and DMA function */
-        sdio_interrupt_enable(SDIO_INT_CCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_RXORE | SDIO_INT_DTEND | SDIO_INT_STBITE);
-        sdio_dma_enable();
-        dma_receive_config(preadbuffer, blocksize);
-        uint32_t start = millis();
-        while((RESET == dma_flag_get(DMA1, DMA_CH3, DMA_FLAG_FTF))) {
-            if((uint32_t)(millis() - start) > 1000) {
-                return SD_ERROR;
-            }
-            if (callback)
-            {
-                uint32_t complete = (blocksize - DMA_CHCNT(DMA1, DMA_CH3) * 4);
-                callback(complete);
-            }
-        }
-    } else {
-        status = SD_PARAMETER_INVALID;
-    }
-    return status;
-}
-
-/*!
-    \brief      read multiple blocks data into a buffer from the specified address of a card
-    \param[out] preadbuffer: a pointer that store multiple blocks read data
-    \param[in]  readaddr: the read data address
-    \param[in]  blocksize: the data block size
-    \param[in]  blocksnumber: number of blocks that will be read
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_multiblocks_read(uint32_t *preadbuffer, uint64_t readaddr, uint16_t blocksize, uint32_t blocksnumber, sdio_callback_t callback)
-{
-    /* initialize the variables */
-    sd_error_enum status = SD_OK;
-    uint32_t count = 0, align = 0, datablksize = SDIO_DATABLOCKSIZE_1BYTE, *ptempbuff = preadbuffer;
-    
-    if(NULL == preadbuffer) {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    transerror = SD_OK;
-    transend = 0;
-    totalnumber_bytes = 0;
-    /* clear all DSM configuration */
-    sdio_data_config(0, 0, SDIO_DATABLOCKSIZE_1BYTE);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOCARD);
-    sdio_dsm_disable();
-    sdio_dma_disable();
-
-    /* check whether the card is locked */
-    if(sdio_response_get(SDIO_RESPONSE0) & SD_CARDSTATE_LOCKED) {
-        status = SD_LOCK_UNLOCK_FAILED;
-        return status;
-    }
-
-    /* blocksize is fixed in 512B for SDHC card */
-    if(SDIO_HIGH_CAPACITY_SD_CARD == cardtype) {
-        blocksize = 512;
-        readaddr /= 512;
-    }
-
-    align = blocksize & (blocksize - 1);
-    if((blocksize > 0) && (blocksize <= 2048) && (0 == align)) {
-        datablksize = sd_datablocksize_get(blocksize);
-        /* send CMD16(SET_BLOCKLEN) to set the block length */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_SET_BLOCKLEN, (uint32_t)blocksize, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_SET_BLOCKLEN);
-        if(SD_OK != status) {
-            return status;
-        }
-    } else {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    if(blocksnumber >= 1) {
-        if(blocksnumber * blocksize > SD_MAX_DATA_LENGTH) {
-            /* exceeds the maximum length */
-            status = SD_PARAMETER_INVALID;
-            return status;
-        }
-
-        stopcondition = 1;
-        totalnumber_bytes = blocksnumber * blocksize;
-
-        /* configure the SDIO data transmission */
-        sdio_data_config(SD_DATATIMEOUT, totalnumber_bytes, datablksize);
-        sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOSDIO);
-        sdio_dsm_enable();
-
-        /* send CMD18(READ_MULTIPLE_BLOCK) to read multiple blocks */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_READ_MULTIPLE_BLOCK, readaddr, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_READ_MULTIPLE_BLOCK);
-        if(SD_OK != status) {
-            return status;
-        }
-
-        if(SD_POLLING_MODE == transmode) {
-            /* polling mode */
-            while(!sdio_flag_get(SDIO_FLAG_DTCRCERR | SDIO_FLAG_DTTMOUT | SDIO_FLAG_RXORE | SDIO_FLAG_DTEND | SDIO_FLAG_STBITE)) {
-                if(RESET != sdio_flag_get(SDIO_FLAG_RFH)) {
-                    /* at least 8 words can be read in the FIFO */
-                    for(count = 0; count < SD_FIFOHALF_WORDS; count++) {
-                        *(ptempbuff + count) = sdio_data_read();
-                    }
-                    ptempbuff += SD_FIFOHALF_WORDS;
-                }
-            }
-
-            /* whether some error occurs and return it */
-            if(RESET != sdio_flag_get(SDIO_FLAG_DTCRCERR)) {
-                status = SD_DATA_CRC_ERROR;
-                sdio_flag_clear(SDIO_FLAG_DTCRCERR);
-                return status;
-            } else if(RESET != sdio_flag_get(SDIO_FLAG_DTTMOUT)) {
-                status = SD_DATA_TIMEOUT;
-                sdio_flag_clear(SDIO_FLAG_DTTMOUT);
-                return status;
-            } else if(RESET != sdio_flag_get(SDIO_FLAG_RXORE)) {
-                status = SD_RX_OVERRUN_ERROR;
-                sdio_flag_clear(SDIO_FLAG_RXORE);
-                return status;
-            } else if(RESET != sdio_flag_get(SDIO_FLAG_STBITE)) {
-                status = SD_START_BIT_ERROR;
-                sdio_flag_clear(SDIO_FLAG_STBITE);
-                return status;
-            }
-            while(RESET != sdio_flag_get(SDIO_FLAG_RXDTVAL)) {
-                *ptempbuff = sdio_data_read();
-                ++ptempbuff;
-            }
-
-            if(RESET != sdio_flag_get(SDIO_FLAG_DTEND)) {
-                if((SDIO_STD_CAPACITY_SD_CARD_V1_1 == cardtype) || (SDIO_STD_CAPACITY_SD_CARD_V2_0 == cardtype) ||
-                        (SDIO_HIGH_CAPACITY_SD_CARD == cardtype)) {
-                    /* send CMD12(STOP_TRANSMISSION) to stop transmission */
-                    sdio_csm_disable();
-                    sdio_command_response_config(SD_CMD_STOP_TRANSMISSION, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-                    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-                    sdio_csm_enable();
-                    /* check if some error occurs */
-                    status = r1_error_check(SD_CMD_STOP_TRANSMISSION);
-                    if(SD_OK != status) {
-                        return status;
-                    }
-                }
-            }
-            sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-        } else if(SD_DMA_MODE == transmode) {
-            /* DMA mode */
-            /* enable the SDIO corresponding interrupts and DMA function */
-            sdio_interrupt_enable(SDIO_INT_DTCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_RXORE | SDIO_INT_DTEND | SDIO_INT_STBITE);
-            sdio_dma_enable();
-            dma_receive_config(preadbuffer, totalnumber_bytes);
-
-            uint32_t start = millis();
-            while((RESET == dma_flag_get(DMA1, DMA_CH3, DMA_FLAG_FTF))) {
-                if((uint32_t)(millis() - start) > 1000) {
-                    return SD_ERROR;
-                }
-                if (callback)
-                {
-                    uint32_t complete = (totalnumber_bytes - DMA_CHCNT(DMA1, DMA_CH3) * 4);
-                    callback(complete);
-                }
-            }
-            while((0 == transend) && (SD_OK == transerror)) {
-                if (callback)
-                {
-                    callback(totalnumber_bytes);
-                }
-            }
-            if(SD_OK != transerror) {
-                return transerror;
-            }
-        } else {
-            status = SD_PARAMETER_INVALID;
-        }
-    }
-    return status;
-}
-
-/*!
-    \brief      write a block data to the specified address of a card
-    \param[in]  pwritebuffer: a pointer that store a block data to be transferred
-    \param[in]  writeaddr: the read data address
-    \param[in]  blocksize: the data block size
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_block_write(uint32_t *pwritebuffer, uint64_t writeaddr, uint16_t blocksize, sdio_callback_t callback)
-{
-    /* initialize the variables */
-    sd_error_enum status = SD_OK;
-    uint8_t cardstate = 0;
-    uint32_t count = 0, align = 0, datablksize = SDIO_DATABLOCKSIZE_1BYTE, *ptempbuff = pwritebuffer;
-    uint32_t transbytes = 0, restwords = 0, response = 0;
-    
-    if(NULL == pwritebuffer) {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    transerror = SD_OK;
-    transend = 0;
-    totalnumber_bytes = 0;
-    /* clear all DSM configuration */
-    sdio_data_config(0, 0, SDIO_DATABLOCKSIZE_1BYTE);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOCARD);
-    sdio_dsm_disable();
-    sdio_dma_disable();
-
-    /* check whether the card is locked */
-    if(sdio_response_get(SDIO_RESPONSE0) & SD_CARDSTATE_LOCKED) {
-        status = SD_LOCK_UNLOCK_FAILED;
-        return status;
-    }
-
-    /* blocksize is fixed in 512B for SDHC card */
-    if(SDIO_HIGH_CAPACITY_SD_CARD == cardtype) {
-        blocksize = 512;
-        writeaddr /= 512;
-    }
-
-    align = blocksize & (blocksize - 1);
-    if((blocksize > 0) && (blocksize <= 2048) && (0 == align)) {
-        datablksize = sd_datablocksize_get(blocksize);
-        /* send CMD16(SET_BLOCKLEN) to set the block length */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_SET_BLOCKLEN, (uint32_t)blocksize, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_SET_BLOCKLEN);
-        if(SD_OK != status) {
-            return status;
-        }
-    } else {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    /* send CMD13(SEND_STATUS), addressed card sends its status registers */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SEND_STATUS, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_SEND_STATUS);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    response = sdio_response_get(SDIO_RESPONSE0);
-    
-    uint32_t start = millis();
-    while((0 == (response & SD_R1_READY_FOR_DATA))) {
-        /* continue to send CMD13 to polling the state of card until buffer empty or timeout */
-        if((uint32_t)(millis() - start) > 1000) {
-            return SD_ERROR;
-        }
-
-        if (callback)
-        {
-            callback(0);
-        }
-
-        /* send CMD13(SEND_STATUS), addressed card sends its status registers */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_SEND_STATUS, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_SEND_STATUS);
-        if(SD_OK != status) {
-            return status;
-        }
-        response = sdio_response_get(SDIO_RESPONSE0);
-    }
-
-    /* send CMD24(WRITE_BLOCK) to write a block */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_WRITE_BLOCK, writeaddr, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_WRITE_BLOCK);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    stopcondition = 0;
-    totalnumber_bytes = blocksize;
-
-    /* configure the SDIO data transmission */
-    sdio_data_config(SD_DATATIMEOUT, totalnumber_bytes, datablksize);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOCARD);
-    sdio_dsm_enable();
-
-    if(SD_POLLING_MODE == transmode) {
-        /* polling mode */
-        while(!sdio_flag_get(SDIO_FLAG_DTCRCERR | SDIO_FLAG_DTTMOUT | SDIO_FLAG_TXURE | SDIO_FLAG_DTBLKEND | SDIO_FLAG_STBITE)) {
-            if(RESET != sdio_flag_get(SDIO_FLAG_TFH)) {
-                /* at least 8 words can be written into the FIFO */
-                if((totalnumber_bytes - transbytes) < SD_FIFOHALF_BYTES) {
-                    restwords = (totalnumber_bytes - transbytes) / 4 + (((totalnumber_bytes - transbytes) % 4 == 0) ? 0 : 1);
-                    for(count = 0; count < restwords; count++) {
-                        sdio_data_write(*ptempbuff);
-                        ++ptempbuff;
-                        transbytes += 4;
-                    }
-                } else {
-                    for(count = 0; count < SD_FIFOHALF_WORDS; count++) {
-                        sdio_data_write(*(ptempbuff + count));
-                    }
-                    /* 8 words(32 bytes) has been transferred */
-                    ptempbuff += SD_FIFOHALF_WORDS;
-                    transbytes += SD_FIFOHALF_BYTES;
-                }
-            }
-        }
-
-        /* whether some error occurs and return it */
-        if(RESET != sdio_flag_get(SDIO_FLAG_DTCRCERR)) {
-            status = SD_DATA_CRC_ERROR;
-            sdio_flag_clear(SDIO_FLAG_DTCRCERR);
-            return status;
-        } else if(RESET != sdio_flag_get(SDIO_FLAG_DTTMOUT)) {
-            status = SD_DATA_TIMEOUT;
-            sdio_flag_clear(SDIO_FLAG_DTTMOUT);
-            return status;
-        } else if(RESET != sdio_flag_get(SDIO_FLAG_TXURE)) {
-            status = SD_TX_UNDERRUN_ERROR;
-            sdio_flag_clear(SDIO_FLAG_TXURE);
-            return status;
-        } else if(RESET != sdio_flag_get(SDIO_FLAG_STBITE)) {
-            status = SD_START_BIT_ERROR;
-            sdio_flag_clear(SDIO_FLAG_STBITE);
-            return status;
-        }
-    } else if(SD_DMA_MODE == transmode) {
-        /* DMA mode */
-        /* enable the SDIO corresponding interrupts and DMA */
-        sdio_interrupt_enable(SDIO_INT_DTCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_TXURE | SDIO_INT_DTEND | SDIO_INT_STBITE);
-        dma_transfer_config(pwritebuffer, blocksize);
-        sdio_dma_enable();
-
-        uint32_t start = millis();
-        while((RESET == dma_flag_get(DMA1, DMA_CH3, DMA_FLAG_FTF))) {
-            if((uint32_t)(millis() - start) > 1000) {
-                return SD_ERROR;
-            }
-            if (callback)
-            {
-                uint32_t complete = (blocksize - DMA_CHCNT(DMA1, DMA_CH3) * 4);
-                callback(complete);
-            }
-        }
-        while((0 == transend) && (SD_OK == transerror)) {
-            if (callback)
-            {
-                callback(blocksize);
-            }
-        }
-
-        if(SD_OK != transerror) {
-            return transerror;
-        }
-    } else {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    /* clear the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    /* get the card state and wait the card is out of programming and receiving state */
-    status = sd_card_state_get(&cardstate);
-    while((SD_OK == status) && ((SD_CARDSTATE_PROGRAMMING == cardstate) || (SD_CARDSTATE_RECEIVING == cardstate))) {
-        if (callback)
-        {
-            callback(blocksize);
-        }
-        status = sd_card_state_get(&cardstate);
-    }
-    return status;
-}
-
-/*!
-    \brief      write multiple blocks data to the specified address of a card
-    \param[in]  pwritebuffer: a pointer that store multiple blocks data to be transferred
-    \param[in]  writeaddr: the read data address
-    \param[in]  blocksize: the data block size
-    \param[in]  blocksnumber: number of blocks that will be written
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_multiblocks_write(uint32_t *pwritebuffer, uint64_t writeaddr, uint16_t blocksize, uint32_t blocksnumber, sdio_callback_t callback)
-{
-    /* initialize the variables */
-    sd_error_enum status = SD_OK;
-    uint8_t cardstate = 0;
-    uint32_t count = 0, align = 0, datablksize = SDIO_DATABLOCKSIZE_1BYTE, *ptempbuff = pwritebuffer;
-    uint32_t transbytes = 0, restwords = 0;
-    
-    if(NULL == pwritebuffer) {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    transerror = SD_OK;
-    transend = 0;
-    totalnumber_bytes = 0;
-    /* clear all DSM configuration */
-    sdio_data_config(0, 0, SDIO_DATABLOCKSIZE_1BYTE);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOCARD);
-    sdio_dsm_disable();
-    sdio_dma_disable();
-
-    /* check whether the card is locked */
-    if(sdio_response_get(SDIO_RESPONSE0) & SD_CARDSTATE_LOCKED) {
-        status = SD_LOCK_UNLOCK_FAILED;
-        return status;
-    }
-
-    /* blocksize is fixed in 512B for SDHC card */
-    if(SDIO_HIGH_CAPACITY_SD_CARD == cardtype) {
-        blocksize = 512;
-        writeaddr /= 512;
-    }
-
-    align = blocksize & (blocksize - 1);
-    if((blocksize > 0) && (blocksize <= 2048) && (0 == align)) {
-        datablksize = sd_datablocksize_get(blocksize);
-        /* send CMD16(SET_BLOCKLEN) to set the block length */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_SET_BLOCKLEN, (uint32_t)blocksize, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_SET_BLOCKLEN);
-        if(SD_OK != status) {
-            return status;
-        }
-    } else {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    /* send CMD13(SEND_STATUS), addressed card sends its status registers */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SEND_STATUS, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_SEND_STATUS);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    if(blocksnumber >= 1) {
-        if(blocksnumber * blocksize > SD_MAX_DATA_LENGTH) {
-            status = SD_PARAMETER_INVALID;
-            return status;
-        }
-
-        if((SDIO_STD_CAPACITY_SD_CARD_V1_1 == cardtype) || (SDIO_STD_CAPACITY_SD_CARD_V2_0 == cardtype) ||
-                (SDIO_HIGH_CAPACITY_SD_CARD == cardtype)) {
-            /* send CMD55(APP_CMD) to indicate next command is application specific command */
-            sdio_csm_disable();
-            sdio_command_response_config(SD_CMD_APP_CMD, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-            sdio_wait_type_set(SDIO_WAITTYPE_NO);
-            sdio_csm_enable();
-            /* check if some error occurs */
-            status = r1_error_check(SD_CMD_APP_CMD);
-            if(SD_OK != status) {
-                return status;
-            }
-
-            /* send ACMD23(SET_WR_BLK_ERASE_COUNT) to set the number of write blocks to be preerased before writing */
-            sdio_csm_disable();
-            sdio_command_response_config(SD_APPCMD_SET_WR_BLK_ERASE_COUNT, blocksnumber, SDIO_RESPONSETYPE_SHORT);
-            sdio_wait_type_set(SDIO_WAITTYPE_NO);
-            sdio_csm_enable();
-            /* check if some error occurs */
-            status = r1_error_check(SD_APPCMD_SET_WR_BLK_ERASE_COUNT);
-            if(SD_OK != status) {
-                return status;
-            }
-        }
-        /* send CMD25(WRITE_MULTIPLE_BLOCK) to continuously write blocks of data */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_WRITE_MULTIPLE_BLOCK, writeaddr, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_WRITE_MULTIPLE_BLOCK);
-        if(SD_OK != status) {
-            return status;
-        }
-
-        stopcondition = 1;
-        totalnumber_bytes = blocksnumber * blocksize;
-
-        /* configure the SDIO data transmission */
-        sdio_data_config(SD_DATATIMEOUT, totalnumber_bytes, datablksize);
-        sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOCARD);
-        sdio_dsm_enable();
-
-        if(SD_POLLING_MODE == transmode) {
-            /* polling mode */
-            while(!sdio_flag_get(SDIO_FLAG_DTCRCERR | SDIO_FLAG_DTTMOUT | SDIO_FLAG_TXURE | SDIO_FLAG_DTEND | SDIO_FLAG_STBITE)) {
-                if(RESET != sdio_flag_get(SDIO_FLAG_TFH)) {
-                    /* at least 8 words can be written into the FIFO */
-                    if(!((totalnumber_bytes - transbytes) < SD_FIFOHALF_BYTES)) {
-                        for(count = 0; count < SD_FIFOHALF_WORDS; count++) {
-                            sdio_data_write(*(ptempbuff + count));
-                        }
-                        /* 8 words(32 bytes) has been transferred */
-                        ptempbuff += SD_FIFOHALF_WORDS;
-                        transbytes += SD_FIFOHALF_BYTES;
-                    } else {
-                        restwords = (totalnumber_bytes - transbytes) / 4 + (((totalnumber_bytes - transbytes) % 4 == 0) ? 0 : 1);
-                        for(count = 0; count < restwords; count++) {
-                            sdio_data_write(*ptempbuff);
-                            ++ptempbuff;
-                            transbytes += 4;
-                        }
-                    }
-                }
-            }
-
-            /* whether some error occurs and return it */
-            if(RESET != sdio_flag_get(SDIO_FLAG_DTCRCERR)) {
-                status = SD_DATA_CRC_ERROR;
-                sdio_flag_clear(SDIO_FLAG_DTCRCERR);
-                return status;
-            } else if(RESET != sdio_flag_get(SDIO_FLAG_DTTMOUT)) {
-                status = SD_DATA_TIMEOUT;
-                sdio_flag_clear(SDIO_FLAG_DTTMOUT);
-                return status;
-            } else if(RESET != sdio_flag_get(SDIO_FLAG_TXURE)) {
-                status = SD_TX_UNDERRUN_ERROR;
-                sdio_flag_clear(SDIO_FLAG_TXURE);
-                return status;
-            } else if(RESET != sdio_flag_get(SDIO_FLAG_STBITE)) {
-                status = SD_START_BIT_ERROR;
-                sdio_flag_clear(SDIO_FLAG_STBITE);
-                return status;
-            }
-
-            if(RESET != sdio_flag_get(SDIO_FLAG_DTEND)) {
-                if((SDIO_STD_CAPACITY_SD_CARD_V1_1 == cardtype) || (SDIO_STD_CAPACITY_SD_CARD_V2_0 == cardtype) ||
-                        (SDIO_HIGH_CAPACITY_SD_CARD == cardtype)) {
-                    /* send CMD12(STOP_TRANSMISSION) to stop transmission */
-                    sdio_csm_disable();
-                    sdio_command_response_config(SD_CMD_STOP_TRANSMISSION, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-                    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-                    sdio_csm_enable();
-                    /* check if some error occurs */
-                    status = r1_error_check(SD_CMD_STOP_TRANSMISSION);
-                    if(SD_OK != status) {
-                        return status;
-                    }
-                }
-            }
-            sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-        } else if(SD_DMA_MODE == transmode) {
-            /* DMA mode */
-            /* enable SDIO corresponding interrupts and DMA */
-            sdio_interrupt_enable(SDIO_INT_DTCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_TXURE | SDIO_INT_DTEND | SDIO_INT_STBITE);
-            sdio_dma_enable();
-            dma_transfer_config(pwritebuffer, totalnumber_bytes);
-
-            uint32_t start = millis();
-            while((RESET == dma_flag_get(DMA1, DMA_CH3, DMA_FLAG_FTF))) {
-                if((uint32_t)(millis() - start) > 1000) {
-                    return SD_ERROR;
-                }
-                if (callback)
-                {
-                    uint32_t complete = (totalnumber_bytes - DMA_CHCNT(DMA1, DMA_CH3) * 4);
-                    callback(complete);
-                }
-            }
-            while((0 == transend) && (SD_OK == transerror)) {
-                if (callback)
-                {
-                    callback(totalnumber_bytes);
-                }
-            }
-            if(SD_OK != transerror) {
-                return transerror;
-            }
-        } else {
-            status = SD_PARAMETER_INVALID;
-            return status;
-        }
-    }
-
-    /* clear the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    /* get the card state and wait the card is out of programming and receiving state */
-    status = sd_card_state_get(&cardstate);
-    while((SD_OK == status) && ((SD_CARDSTATE_PROGRAMMING == cardstate) || (SD_CARDSTATE_RECEIVING == cardstate))) {
-        if (callback)
-        {
-            callback(totalnumber_bytes);
-        }
-        status = sd_card_state_get(&cardstate);
-    }
-    return status;
-}
-
-/*!
-    \brief      erase a continuous area of a card
-    \param[in]  startaddr: the start address
-    \param[in]  endaddr: the end address
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_erase(uint64_t startaddr, uint64_t endaddr)
-{
-    /* initialize the variables */
-    sd_error_enum status = SD_OK;
-    uint32_t count = 0, clkdiv = 0;
-    __IO uint32_t delay = 0;
-    uint8_t cardstate = 0, tempbyte = 0;
-    uint16_t tempccc = 0;
-
-    /* get the card command classes from CSD */
-    tempbyte = (uint8_t)((sd_csd[1] & SD_MASK_24_31BITS) >> 24);
-    tempccc = (uint16_t)((uint16_t)tempbyte << 4);
-    tempbyte = (uint8_t)((sd_csd[1] & SD_MASK_16_23BITS) >> 16);
-    tempccc |= (uint16_t)((uint16_t)(tempbyte & 0xF0) >> 4);
-    if(0 == (tempccc & SD_CCC_ERASE)) {
-        /* don't support the erase command */
-        status = SD_FUNCTION_UNSUPPORTED;
-        return status;
-    }
-    clkdiv = (SDIO_CLKCTL & SDIO_CLKCTL_DIV);
-    clkdiv += ((SDIO_CLKCTL & SDIO_CLKCTL_DIV8) >> 31) * 256;
-    clkdiv += 2;
-    delay = 120000 / clkdiv;
-
-    /* check whether the card is locked */
-    if(sdio_response_get(SDIO_RESPONSE0) & SD_CARDSTATE_LOCKED) {
-        status = SD_LOCK_UNLOCK_FAILED;
-        return(status);
-    }
-
-    /* blocksize is fixed in 512B for SDHC card */
-    if(SDIO_HIGH_CAPACITY_SD_CARD == cardtype) {
-        startaddr /= 512;
-        endaddr /= 512;
-    }
-
-    if((SDIO_STD_CAPACITY_SD_CARD_V1_1 == cardtype) || (SDIO_STD_CAPACITY_SD_CARD_V2_0 == cardtype) ||
-            (SDIO_HIGH_CAPACITY_SD_CARD == cardtype)) {
-        /* send CMD32(ERASE_WR_BLK_START) to set the address of the first write block to be erased */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_ERASE_WR_BLK_START, startaddr, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_ERASE_WR_BLK_START);
-        if(SD_OK != status) {
-            return status;
-        }
-
-        /* send CMD33(ERASE_WR_BLK_END) to set the address of the last write block of the continuous range to be erased */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_ERASE_WR_BLK_END, endaddr, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_ERASE_WR_BLK_END);
-        if(SD_OK != status) {
-            return status;
-        }
-    }
-
-    /* send CMD38(ERASE) to set the address of the first write block to be erased */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_ERASE, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_ERASE);
-    if(SD_OK != status) {
-        return status;
-    }
-    /* loop until the counter is reach to the calculated time */
-    for(count = 0; count < delay; count++) {
-    }
-    /* get the card state and wait the card is out of programming and receiving state */
-    status = sd_card_state_get(&cardstate);
-    while((SD_OK == status) && ((SD_CARDSTATE_PROGRAMMING == cardstate) || (SD_CARDSTATE_RECEIVING == cardstate))) {
-        status = sd_card_state_get(&cardstate);
-    }
-    return status;
-}
-
-/*!
-    \brief      process all the interrupts which the corresponding flags are set
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_interrupts_process(void)
-{
-    transerror = SD_OK;
-    if(RESET != sdio_interrupt_flag_get(SDIO_INT_FLAG_DTEND)) {
-        /* send CMD12 to stop data transfer in multiple blocks operation */
-        if(1 == stopcondition) {
-            transerror = sd_transfer_stop();
-        } else {
-            transerror = SD_OK;
-        }
-        sdio_interrupt_flag_clear(SDIO_INT_DTEND);
-        /* disable all the interrupts */
-        sdio_interrupt_disable(SDIO_INT_DTCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_DTEND | SDIO_INT_STBITE |
-                               SDIO_INT_TFH | SDIO_INT_RFH | SDIO_INT_TXURE | SDIO_INT_RXORE);
-        transend = 1;
-        number_bytes = 0;
-        return transerror;
-    }
-
-    if(RESET != sdio_interrupt_flag_get(SDIO_INT_FLAG_DTCRCERR)) {
-        sdio_interrupt_flag_clear(SDIO_INT_DTCRCERR);
-        /* disable all the interrupts */
-        sdio_interrupt_disable(SDIO_INT_DTCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_DTEND | SDIO_INT_STBITE |
-                               SDIO_INT_TFH | SDIO_INT_RFH | SDIO_INT_TXURE | SDIO_INT_RXORE);
-        number_bytes = 0;
-        transerror = SD_DATA_CRC_ERROR;
-        return transerror;
-    }
-
-    if(RESET != sdio_interrupt_flag_get(SDIO_INT_FLAG_DTTMOUT)) {
-        sdio_interrupt_flag_clear(SDIO_INT_DTTMOUT);
-        /* disable all the interrupts */
-        sdio_interrupt_disable(SDIO_INT_DTCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_DTEND | SDIO_INT_STBITE |
-                               SDIO_INT_TFH | SDIO_INT_RFH | SDIO_INT_TXURE | SDIO_INT_RXORE);
-        number_bytes = 0;
-        transerror = SD_DATA_TIMEOUT;
-        return transerror;
-    }
-
-    if(RESET != sdio_interrupt_flag_get(SDIO_INT_FLAG_STBITE)) {
-        sdio_interrupt_flag_clear(SDIO_INT_STBITE);
-        /* disable all the interrupts */
-        sdio_interrupt_disable(SDIO_INT_DTCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_DTEND | SDIO_INT_STBITE |
-                               SDIO_INT_TFH | SDIO_INT_RFH | SDIO_INT_TXURE | SDIO_INT_RXORE);
-        number_bytes = 0;
-        transerror = SD_START_BIT_ERROR;
-        return transerror;
-    }
-
-    if(RESET != sdio_interrupt_flag_get(SDIO_INT_FLAG_TXURE)) {
-        sdio_interrupt_flag_clear(SDIO_INT_TXURE);
-        /* disable all the interrupts */
-        sdio_interrupt_disable(SDIO_INT_DTCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_DTEND | SDIO_INT_STBITE |
-                               SDIO_INT_TFH | SDIO_INT_RFH | SDIO_INT_TXURE | SDIO_INT_RXORE);
-        number_bytes = 0;
-        transerror = SD_TX_UNDERRUN_ERROR;
-        return transerror;
-    }
-
-    if(RESET != sdio_interrupt_flag_get(SDIO_INT_FLAG_RXORE)) {
-        sdio_interrupt_flag_clear(SDIO_INT_RXORE);
-        /* disable all the interrupts */
-        sdio_interrupt_disable(SDIO_INT_DTCRCERR | SDIO_INT_DTTMOUT | SDIO_INT_DTEND | SDIO_INT_STBITE |
-                               SDIO_INT_TFH | SDIO_INT_RFH | SDIO_INT_TXURE | SDIO_INT_RXORE);
-        number_bytes = 0;
-        transerror = SD_RX_OVERRUN_ERROR;
-        return transerror;
-    }
-    return transerror;
-}
-
-/*!
-    \brief      select or deselect a card
-    \param[in]  cardrca: the RCA of a card
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_card_select_deselect(uint16_t cardrca)
-{
-    sd_error_enum status = SD_OK;
-    /* send CMD7(SELECT/DESELECT_CARD) to select or deselect the card */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SELECT_DESELECT_CARD, (uint32_t)(cardrca << SD_RCA_SHIFT), SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-
-    status = r1_error_check(SD_CMD_SELECT_DESELECT_CARD);
-    return status;
-}
-
-/*!
-    \brief      get the card status
-    \param[in]  none
-    \param[out] pcardstatus: a pointer that store card status
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_cardstatus_get(uint32_t *pcardstatus)
-{
-    sd_error_enum status = SD_OK;
-    if(NULL == pcardstatus) {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    /* send CMD13(SEND_STATUS), addressed card sends its status register */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SEND_STATUS, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_SEND_STATUS);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    *pcardstatus = sdio_response_get(SDIO_RESPONSE0);
-    return status;
-}
-
-/*!
-    \brief      get the SD card status
-    \param[in]  none
-    \param[out] psdstatus: a pointer that store SD card status
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_sdstatus_get(uint32_t *psdstatus)
-{
-    sd_error_enum status = SD_OK;
-    uint32_t count = 0;
-
-    /* check whether the card is locked */
-    if(sdio_response_get(SDIO_RESPONSE0) & SD_CARDSTATE_LOCKED) {
-        status = SD_LOCK_UNLOCK_FAILED;
-        return(status);
-    }
-
-    /* send CMD16(SET_BLOCKLEN) to set the block length */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SET_BLOCKLEN, (uint32_t)64, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_SET_BLOCKLEN);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    /* send CMD55(APP_CMD) to indicate next command is application specific command */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_APP_CMD, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_APP_CMD);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    /* configure the SDIO data transmission */
-    sdio_data_config(SD_DATATIMEOUT, (uint32_t)64, SDIO_DATABLOCKSIZE_64BYTES);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOSDIO);
-    sdio_dsm_enable();
-
-    /* send ACMD13(SD_STATUS) to get the SD status */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_APPCMD_SD_STATUS, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_APPCMD_SD_STATUS);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    while(!sdio_flag_get(SDIO_FLAG_DTCRCERR | SDIO_FLAG_DTTMOUT | SDIO_FLAG_RXORE | SDIO_FLAG_DTBLKEND | SDIO_FLAG_STBITE)) {
-        if(RESET != sdio_flag_get(SDIO_FLAG_RFH)) {
-            for(count = 0; count < SD_FIFOHALF_WORDS; count++) {
-                *(psdstatus + count) = sdio_data_read();
-            }
-            psdstatus += SD_FIFOHALF_WORDS;
-        }
-    }
-
-    /* whether some error occurs and return it */
-    if(RESET != sdio_flag_get(SDIO_FLAG_DTCRCERR)) {
-        status = SD_DATA_CRC_ERROR;
-        sdio_flag_clear(SDIO_FLAG_DTCRCERR);
-        return status;
-    } else if(RESET != sdio_flag_get(SDIO_FLAG_DTTMOUT)) {
-        status = SD_DATA_TIMEOUT;
-        sdio_flag_clear(SDIO_FLAG_DTTMOUT);
-        return status;
-    } else if(RESET != sdio_flag_get(SDIO_FLAG_RXORE)) {
-        status = SD_RX_OVERRUN_ERROR;
-        sdio_flag_clear(SDIO_FLAG_RXORE);
-        return status;
-    } else if(RESET != sdio_flag_get(SDIO_FLAG_STBITE)) {
-        status = SD_START_BIT_ERROR;
-        sdio_flag_clear(SDIO_FLAG_STBITE);
-        return status;
-    }
-    while(RESET != sdio_flag_get(SDIO_FLAG_RXDTVAL)) {
-        *psdstatus = sdio_data_read();
-        ++psdstatus;
-    }
-
-    /* clear the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    psdstatus -= 16;
-    for(count = 0; count < 16; count++) {
-        psdstatus[count] = ((psdstatus[count] & SD_MASK_0_7BITS) << 24) | ((psdstatus[count] & SD_MASK_8_15BITS) << 8) |
-                           ((psdstatus[count] & SD_MASK_16_23BITS) >> 8) | ((psdstatus[count] & SD_MASK_24_31BITS) >> 24);
-    }
-    return status;
-}
-
-/*!
-    \brief      stop an ongoing data transfer
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_transfer_stop(void)
-{
-    sd_error_enum status = SD_OK;
-    /* send CMD12(STOP_TRANSMISSION) to stop transmission */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_STOP_TRANSMISSION, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_STOP_TRANSMISSION);
-    return status;
-}
-
-/*!
-    \brief      lock or unlock a card
-    \param[in]  lockstate: the lock state
-      \arg        SD_LOCK: lock the SD card
-      \arg        SD_UNLOCK: unlock the SD card
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_lock_unlock(uint8_t lockstate)
-{
-    sd_error_enum status = SD_OK;
-    uint8_t cardstate = 0, tempbyte = 0;
-    uint32_t pwd1 = 0, pwd2 = 0, response = 0;
-    __IO uint32_t timeout = 0;
-    uint16_t tempccc = 0;
-
-    /* get the card command classes from CSD */
-    tempbyte = (uint8_t)((sd_csd[1] & SD_MASK_24_31BITS) >> 24);
-    tempccc = (uint16_t)((uint16_t)tempbyte << 4);
-    tempbyte = (uint8_t)((sd_csd[1] & SD_MASK_16_23BITS) >> 16);
-    tempccc |= (uint16_t)((uint16_t)(tempbyte & 0xF0) >> 4);
-
-    if(0 == (tempccc & SD_CCC_LOCK_CARD)) {
-        /* don't support the lock command */
-        status = SD_FUNCTION_UNSUPPORTED;
-        return status;
-    }
-    /* password pattern */
-    pwd1 = (0x01020600 | lockstate);
-    pwd2 = 0x03040506;
-
-    /* clear all DSM configuration */
-    sdio_data_config(0, 0, SDIO_DATABLOCKSIZE_1BYTE);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOCARD);
-    sdio_dsm_disable();
-    sdio_dma_disable();
-
-    /* send CMD16(SET_BLOCKLEN) to set the block length */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SET_BLOCKLEN, (uint32_t)8, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_SET_BLOCKLEN);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    /* send CMD13(SEND_STATUS), addressed card sends its status register */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SEND_STATUS, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_SEND_STATUS);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    response = sdio_response_get(SDIO_RESPONSE0);
-    timeout = 100000;
-    while((0 == (response & SD_R1_READY_FOR_DATA)) && (timeout > 0)) {
-        /* continue to send CMD13 to polling the state of card until buffer empty or timeout */
-        --timeout;
-        /* send CMD13(SEND_STATUS), addressed card sends its status registers */
-        sdio_csm_disable();
-        sdio_command_response_config(SD_CMD_SEND_STATUS, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-        sdio_wait_type_set(SDIO_WAITTYPE_NO);
-        sdio_csm_enable();
-        /* check if some error occurs */
-        status = r1_error_check(SD_CMD_SEND_STATUS);
-        if(SD_OK != status) {
-            return status;
-        }
-        response = sdio_response_get(SDIO_RESPONSE0);
-    }
-    if(0 == timeout) {
-        return SD_ERROR;
-    }
-
-    /* send CMD42(LOCK_UNLOCK) to set/reset the password or lock/unlock the card */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_LOCK_UNLOCK, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_LOCK_UNLOCK);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    response = sdio_response_get(SDIO_RESPONSE0);
-
-    /* configure the SDIO data transmission */
-    sdio_data_config(SD_DATATIMEOUT, (uint32_t)8, SDIO_DATABLOCKSIZE_8BYTES);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOCARD);
-    sdio_dsm_enable();
-
-    /* write password pattern */
-    sdio_data_write(pwd1);
-    sdio_data_write(pwd2);
-
-    /* whether some error occurs and return it */
-    if(RESET != sdio_flag_get(SDIO_FLAG_DTCRCERR)) {
-        status = SD_DATA_CRC_ERROR;
-        sdio_flag_clear(SDIO_FLAG_DTCRCERR);
-        return status;
-    } else if(RESET != sdio_flag_get(SDIO_FLAG_DTTMOUT)) {
-        status = SD_DATA_TIMEOUT;
-        sdio_flag_clear(SDIO_FLAG_DTTMOUT);
-        return status;
-    } else if(RESET != sdio_flag_get(SDIO_FLAG_TXURE)) {
-        status = SD_TX_UNDERRUN_ERROR;
-        sdio_flag_clear(SDIO_FLAG_TXURE);
-        return status;
-    } else if(RESET != sdio_flag_get(SDIO_FLAG_STBITE)) {
-        status = SD_START_BIT_ERROR;
-        sdio_flag_clear(SDIO_FLAG_STBITE);
-        return status;
-    }
-
-    /* clear the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    /* get the card state and wait the card is out of programming and receiving state */
-    status = sd_card_state_get(&cardstate);
-    while((SD_OK == status) && ((SD_CARDSTATE_PROGRAMMING == cardstate) || (SD_CARDSTATE_RECEIVING == cardstate))) {
-        status = sd_card_state_get(&cardstate);
-    }
-    return status;
-}
-
-/*!
-    \brief      get the data transfer state
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-sd_transfer_state_enum sd_transfer_state_get(void)
-{
-    sd_transfer_state_enum transtate = SD_NO_TRANSFER;
-    if(RESET != sdio_flag_get(SDIO_FLAG_TXRUN | SDIO_FLAG_RXRUN)) {
-        transtate = SD_TRANSFER_IN_PROGRESS;
-    }
-    return transtate;
-}
-
-/*!
-    \brief      get SD card capacity
-    \param[in]  none
-    \param[out] none
-    \retval     capacity of the card(KB)
-*/
-uint32_t sd_card_capacity_get(void)
-{
-    uint8_t tempbyte = 0, devicesize_mult = 0, readblklen = 0;
-    uint32_t capacity = 0, devicesize = 0;
-    if((SDIO_STD_CAPACITY_SD_CARD_V1_1 == cardtype) || (SDIO_STD_CAPACITY_SD_CARD_V2_0 == cardtype)) {
-        /* calculate the c_size(device size) */
-        tempbyte = (uint8_t)((sd_csd[1] & SD_MASK_8_15BITS) >> 8);
-        devicesize = (uint32_t)((uint32_t)(tempbyte & 0x03) << 10);
-        tempbyte = (uint8_t)(sd_csd[1] & SD_MASK_0_7BITS);
-        devicesize |= (uint32_t)((uint32_t)tempbyte << 2);
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_24_31BITS) >> 24);
-        devicesize |= (uint32_t)((uint32_t)(tempbyte & 0xC0) >> 6);
-
-        /* calculate the c_size_mult(device size multiplier) */
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_16_23BITS) >> 16);
-        devicesize_mult = (tempbyte & 0x03) << 1;
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_8_15BITS) >> 8);
-        devicesize_mult |= (tempbyte & 0x80) >> 7;
-
-        /* calculate the read_bl_len */
-        tempbyte = (uint8_t)((sd_csd[1] & SD_MASK_16_23BITS) >> 16);
-        readblklen = tempbyte & 0x0F;
-
-        /* capacity = BLOCKNR*BLOCK_LEN, BLOCKNR = (C_SIZE+1)*MULT, MULT = 2^(C_SIZE_MULT+2), BLOCK_LEN = 2^READ_BL_LEN */
-        capacity = (devicesize + 1) * (1 << (devicesize_mult + 2));
-        capacity *= (1 << readblklen);
-
-        /* change the unit of capacity to KByte */
-        capacity /= 1024;
-    } else if(SDIO_HIGH_CAPACITY_SD_CARD == cardtype) {
-        /* calculate the c_size */
-        tempbyte = (uint8_t)(sd_csd[1] & SD_MASK_0_7BITS);
-        devicesize = (uint32_t)((uint32_t)(tempbyte & 0x3F) << 16);
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_24_31BITS) >> 24);
-        devicesize |= (uint32_t)((uint32_t)tempbyte << 8);
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_16_23BITS) >> 16);
-        devicesize |= (uint32_t)tempbyte;
-
-        /* capacity = (c_size+1)*512KByte */
-        capacity = (devicesize + 1) * 512;
-    }
-    return capacity;
-}
-
-sd_error_enum sd_card_information_get_short(sdio_card_type_enum *card_type, uint16_t *card_rca)
-{
-    *card_type = cardtype;
-    *card_rca = sd_rca;
-    return SD_OK;
-}
-
-/*!
-    \brief      get the detailed information of the SD card based on received CID and CSD
-    \param[in]  none
-    \param[out] pcardinfo: a pointer that store the detailed card information
-    \retval     sd_error_enum
-*/
-sd_error_enum sd_card_information_get(sd_card_info_struct *pcardinfo)
-{
-    sd_error_enum status = SD_OK;
-    uint8_t tempbyte = 0;
-
-    if(NULL == pcardinfo) {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-
-    /* store the card type and RCA */
-    pcardinfo->card_type = cardtype;
-    pcardinfo->card_rca = sd_rca;
-
-    /* CID byte 0 */
-    tempbyte = (uint8_t)((sd_cid[0] & SD_MASK_24_31BITS) >> 24);
-    pcardinfo->card_cid.mid = tempbyte;
-
-    /* CID byte 1 */
-    tempbyte = (uint8_t)((sd_cid[0] & SD_MASK_16_23BITS) >> 16);
-    pcardinfo->card_cid.oid = (uint16_t)((uint16_t)tempbyte << 8);
-
-    /* CID byte 2 */
-    tempbyte = (uint8_t)((sd_cid[0] & SD_MASK_8_15BITS) >> 8);
-    pcardinfo->card_cid.oid |= (uint16_t)tempbyte;
-
-    /* CID byte 3 */
-    tempbyte = (uint8_t)(sd_cid[0] & SD_MASK_0_7BITS);
-    pcardinfo->card_cid.pnm0 = (uint32_t)((uint32_t)tempbyte << 24);
-
-    /* CID byte 4 */
-    tempbyte = (uint8_t)((sd_cid[1] & SD_MASK_24_31BITS) >> 24);
-    pcardinfo->card_cid.pnm0 |= (uint32_t)((uint32_t)tempbyte << 16);
-
-    /* CID byte 5 */
-    tempbyte = (uint8_t)((sd_cid[1] & SD_MASK_16_23BITS) >> 16);
-    pcardinfo->card_cid.pnm0 |= (uint32_t)((uint32_t)tempbyte << 8);
-
-    /* CID byte 6 */
-    tempbyte = (uint8_t)((sd_cid[1] & SD_MASK_8_15BITS) >> 8);
-    pcardinfo->card_cid.pnm0 |= (uint32_t)(tempbyte);
-
-    /* CID byte 7 */
-    tempbyte = (uint8_t)(sd_cid[1] & SD_MASK_0_7BITS);
-    pcardinfo->card_cid.pnm1 = tempbyte;
-
-    /* CID byte 8 */
-    tempbyte = (uint8_t)((sd_cid[2] & SD_MASK_24_31BITS) >> 24);
-    pcardinfo->card_cid.prv = tempbyte;
-
-    /* CID byte 9 */
-    tempbyte = (uint8_t)((sd_cid[2] & SD_MASK_16_23BITS) >> 16);
-    pcardinfo->card_cid.psn = (uint32_t)((uint32_t)tempbyte << 24);
-
-    /* CID byte 10 */
-    tempbyte = (uint8_t)((sd_cid[2] & SD_MASK_8_15BITS) >> 8);
-    pcardinfo->card_cid.psn |= (uint32_t)((uint32_t)tempbyte << 16);
-
-    /* CID byte 11 */
-    tempbyte = (uint8_t)(sd_cid[2] & SD_MASK_0_7BITS);
-    pcardinfo->card_cid.psn |= (uint32_t)tempbyte;
-
-    /* CID byte 12 */
-    tempbyte = (uint8_t)((sd_cid[3] & SD_MASK_24_31BITS) >> 24);
-    pcardinfo->card_cid.psn |= (uint32_t)tempbyte;
-
-    /* CID byte 13 */
-    tempbyte = (uint8_t)((sd_cid[3] & SD_MASK_16_23BITS) >> 16);
-    pcardinfo->card_cid.mdt = (uint16_t)((uint16_t)(tempbyte & 0x0F) << 8);
-
-    /* CID byte 14 */
-    tempbyte = (uint8_t)((sd_cid[3] & SD_MASK_8_15BITS) >> 8);
-    pcardinfo->card_cid.mdt |= (uint16_t)tempbyte;
-
-    /* CID byte 15 */
-    tempbyte = (uint8_t)(sd_cid[3] & SD_MASK_0_7BITS);
-    pcardinfo->card_cid.cid_crc = (tempbyte & 0xFE) >> 1;
-
-    /* CSD byte 0 */
-    tempbyte = (uint8_t)((sd_csd[0] & SD_MASK_24_31BITS) >> 24);
-    pcardinfo->card_csd.csd_struct = (tempbyte & 0xC0) >> 6;
-
-    /* CSD byte 1 */
-    tempbyte = (uint8_t)((sd_csd[0] & SD_MASK_16_23BITS) >> 16);
-    pcardinfo->card_csd.taac = tempbyte;
-
-    /* CSD byte 2 */
-    tempbyte = (uint8_t)((sd_csd[0] & SD_MASK_8_15BITS) >> 8);
-    pcardinfo->card_csd.nsac = tempbyte;
-
-    /* CSD byte 3 */
-    tempbyte = (uint8_t)(sd_csd[0] & SD_MASK_0_7BITS);
-    pcardinfo->card_csd.tran_speed = tempbyte;
-
-    /* CSD byte 4 */
-    tempbyte = (uint8_t)((sd_csd[1] & SD_MASK_24_31BITS) >> 24);
-    pcardinfo->card_csd.ccc = (uint16_t)((uint16_t)tempbyte << 4);
-
-    /* CSD byte 5 */
-    tempbyte = (uint8_t)((sd_csd[1] & SD_MASK_16_23BITS) >> 16);
-    pcardinfo->card_csd.ccc |= (uint16_t)((uint16_t)(tempbyte & 0xF0) >> 4);
-    pcardinfo->card_csd.read_bl_len = tempbyte & 0x0F;
-
-    /* CSD byte 6 */
-    tempbyte = (uint8_t)((sd_csd[1] & SD_MASK_8_15BITS) >> 8);
-    pcardinfo->card_csd.read_bl_partial = (tempbyte & 0x80) >> 7;
-    pcardinfo->card_csd.write_blk_misalign = (tempbyte & 0x40) >> 6;
-    pcardinfo->card_csd.read_blk_misalign = (tempbyte & 0x20) >> 5;
-    pcardinfo->card_csd.dsp_imp = (tempbyte & 0x10) >> 4;
-
-    if((SDIO_STD_CAPACITY_SD_CARD_V1_1 == cardtype) || (SDIO_STD_CAPACITY_SD_CARD_V2_0 == cardtype)) {
-        /* card is SDSC card, CSD version 1.0 */
-        pcardinfo->card_csd.c_size = (uint32_t)((uint32_t)(tempbyte & 0x03) << 10);
-
-        /* CSD byte 7 */
-        tempbyte = (uint8_t)(sd_csd[1] & SD_MASK_0_7BITS);
-        pcardinfo->card_csd.c_size |= (uint32_t)((uint32_t)tempbyte << 2);
-
-        /* CSD byte 8 */
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_24_31BITS) >> 24);
-        pcardinfo->card_csd.c_size |= (uint32_t)((uint32_t)(tempbyte & 0xC0) >> 6);
-        pcardinfo->card_csd.vdd_r_curr_min = (tempbyte & 0x38) >> 3;
-        pcardinfo->card_csd.vdd_r_curr_max = tempbyte & 0x07;
-
-        /* CSD byte 9 */
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_16_23BITS) >> 16);
-        pcardinfo->card_csd.vdd_w_curr_min = (tempbyte & 0xE0) >> 5;
-        pcardinfo->card_csd.vdd_w_curr_max = (tempbyte & 0x1C) >> 2;
-        pcardinfo->card_csd.c_size_mult = (tempbyte & 0x03) << 1;
-
-        /* CSD byte 10 */
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_8_15BITS) >> 8);
-        pcardinfo->card_csd.c_size_mult |= (tempbyte & 0x80) >> 7;
-
-        /* calculate the card block size and capacity */
-        pcardinfo->card_blocksize = 1 << (pcardinfo->card_csd.read_bl_len);
-        pcardinfo->card_capacity = pcardinfo->card_csd.c_size + 1;
-        pcardinfo->card_capacity *= (1 << (pcardinfo->card_csd.c_size_mult + 2));
-        pcardinfo->card_capacity *= pcardinfo->card_blocksize;
-    } else if(SDIO_HIGH_CAPACITY_SD_CARD == cardtype) {
-        /* card is SDHC card, CSD version 2.0 */
-        /* CSD byte 7 */
-        tempbyte = (uint8_t)(sd_csd[1] & SD_MASK_0_7BITS);
-        pcardinfo->card_csd.c_size = (uint32_t)((uint32_t)(tempbyte & 0x3F) << 16);
-
-        /* CSD byte 8 */
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_24_31BITS) >> 24);
-        pcardinfo->card_csd.c_size |= (uint32_t)((uint32_t)tempbyte << 8);
-
-        /* CSD byte 9 */
-        tempbyte = (uint8_t)((sd_csd[2] & SD_MASK_16_23BITS) >> 16);
-        pcardinfo->card_csd.c_size |= (uint32_t)tempbyte;
-
-        /* calculate the card block size and capacity */
-        pcardinfo->card_blocksize = 512;
-        pcardinfo->card_capacity = (pcardinfo->card_csd.c_size + 1) * 512 * 1024;
-    }
-
-    pcardinfo->card_csd.erase_blk_en = (tempbyte & 0x40) >> 6;
-    pcardinfo->card_csd.sector_size = (tempbyte & 0x3F) << 1;
-
-    /* CSD byte 11 */
-    tempbyte = (uint8_t)(sd_csd[2] & SD_MASK_0_7BITS);
-    pcardinfo->card_csd.sector_size |= (tempbyte & 0x80) >> 7;
-    pcardinfo->card_csd.wp_grp_size = (tempbyte & 0x7F);
-
-    /* CSD byte 12 */
-    tempbyte = (uint8_t)((sd_csd[3] & SD_MASK_24_31BITS) >> 24);
-    pcardinfo->card_csd.wp_grp_enable = (tempbyte & 0x80) >> 7;
-    pcardinfo->card_csd.r2w_factor = (tempbyte & 0x1C) >> 2;
-    pcardinfo->card_csd.write_bl_len = (tempbyte & 0x03) << 2;
-
-    /* CSD byte 13 */
-    tempbyte = (uint8_t)((sd_csd[3] & SD_MASK_16_23BITS) >> 16);
-    pcardinfo->card_csd.write_bl_len |= (tempbyte & 0xC0) >> 6;
-    pcardinfo->card_csd.write_bl_partial = (tempbyte & 0x20) >> 5;
-
-    /* CSD byte 14 */
-    tempbyte = (uint8_t)((sd_csd[3] & SD_MASK_8_15BITS) >> 8);
-    pcardinfo->card_csd.file_format_grp = (tempbyte & 0x80) >> 7;
-    pcardinfo->card_csd.copy_flag = (tempbyte & 0x40) >> 6;
-    pcardinfo->card_csd.perm_write_protect = (tempbyte & 0x20) >> 5;
-    pcardinfo->card_csd.tmp_write_protect = (tempbyte & 0x10) >> 4;
-    pcardinfo->card_csd.file_format = (tempbyte & 0x0C) >> 2;
-
-    /* CSD byte 15 */
-    tempbyte = (uint8_t)(sd_csd[3] & SD_MASK_0_7BITS);
-    pcardinfo->card_csd.csd_crc = (tempbyte & 0xFE) >> 1;
-
-    return status;
-}
-
-void sd_cid_get(uint8_t *cid)
-{
-    // SdFat expects the data in big endian format.
-    for (int i = 0; i < 16; i++)
-    {
-        cid[i] = (sd_cid[i / 4] >> (24 - (i % 4) * 8)) & 0xFF;
-    }
-}
-
-void sd_csd_get(uint8_t *csd)
-{
-    for (int i = 0; i < 16; i++)
-    {
-        csd[i] = (sd_csd[i / 4] >> (24 - (i % 4) * 8)) & 0xFF;
-    }
-}
-
-/*!
-    \brief      check if the command sent error occurs
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-static sd_error_enum cmdsent_error_check(void)
-{
-    sd_error_enum status = SD_OK;
-    __IO uint32_t timeout = 100000;
-    /* check command sent flag */
-    while((RESET == sdio_flag_get(SDIO_FLAG_CMDSEND)) && (timeout > 0)) {
-        --timeout;
-    }
-    /* command response is timeout */
-    if(0 == timeout) {
-        status = SD_CMD_RESP_TIMEOUT;
-        return status;
-    }
-    /* if the command is sent, clear the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    return status;
-}
-
-/*!
-    \brief      check if error type for R1 response
-    \param[in]  resp: content of response
-    \param[out] none
-    \retval     sd_error_enum
-*/
-static sd_error_enum r1_error_type_check(uint32_t resp)
-{
-    sd_error_enum status = SD_ERROR;
-    /* check which error occurs */
-    if(resp & SD_R1_OUT_OF_RANGE) {
-        status = SD_OUT_OF_RANGE;
-    } else if(resp & SD_R1_ADDRESS_ERROR) {
-        status = SD_ADDRESS_ERROR;
-    } else if(resp & SD_R1_BLOCK_LEN_ERROR) {
-        status = SD_BLOCK_LEN_ERROR;
-    } else if(resp & SD_R1_ERASE_SEQ_ERROR) {
-        status = SD_ERASE_SEQ_ERROR;
-    } else if(resp & SD_R1_ERASE_PARAM) {
-        status = SD_ERASE_PARAM;
-    } else if(resp & SD_R1_WP_VIOLATION) {
-        status = SD_WP_VIOLATION;
-    } else if(resp & SD_R1_LOCK_UNLOCK_FAILED) {
-        status = SD_LOCK_UNLOCK_FAILED;
-    } else if(resp & SD_R1_COM_CRC_ERROR) {
-        status = SD_COM_CRC_ERROR;
-    } else if(resp & SD_R1_ILLEGAL_COMMAND) {
-        status = SD_ILLEGAL_COMMAND;
-    } else if(resp & SD_R1_CARD_ECC_FAILED) {
-        status = SD_CARD_ECC_FAILED;
-    } else if(resp & SD_R1_CC_ERROR) {
-        status = SD_CC_ERROR;
-    } else if(resp & SD_R1_GENERAL_UNKNOWN_ERROR) {
-        status = SD_GENERAL_UNKNOWN_ERROR;
-    } else if(resp & SD_R1_CSD_OVERWRITE) {
-        status = SD_CSD_OVERWRITE;
-    } else if(resp & SD_R1_WP_ERASE_SKIP) {
-        status = SD_WP_ERASE_SKIP;
-    } else if(resp & SD_R1_CARD_ECC_DISABLED) {
-        status = SD_CARD_ECC_DISABLED;
-    } else if(resp & SD_R1_ERASE_RESET) {
-        status = SD_ERASE_RESET;
-    } else if(resp & SD_R1_AKE_SEQ_ERROR) {
-        status = SD_AKE_SEQ_ERROR;
-    }
-    return status;
-}
-
-/*!
-    \brief      check if error occurs for R1 response
-    \param[in]  cmdindex: the index of command
-    \param[out] none
-    \retval     sd_error_enum
-*/
-static sd_error_enum r1_error_check(uint8_t cmdindex)
-{
-    sd_error_enum status = SD_OK;
-    uint32_t reg_status = 0, resp_r1 = 0;
-    __IO uint32_t timeout = 100000;
-
-    /* store the content of SDIO_STAT */
-    reg_status = SDIO_STAT;
-    while(!(reg_status & (SDIO_FLAG_CCRCERR | SDIO_FLAG_CMDTMOUT | SDIO_FLAG_CMDRECV)) && (timeout > 0)) {
-        reg_status = SDIO_STAT;
-        --timeout;
-    }
-    /* check whether an error or timeout occurs or command response received */
-    if(reg_status & SDIO_FLAG_CCRCERR) {
-        status = SD_CMD_CRC_ERROR;
-        sdio_flag_clear(SDIO_FLAG_CCRCERR);
-        return status;
-    } else if((reg_status & SDIO_FLAG_CMDTMOUT) || (0 == timeout)) {
-        status = SD_CMD_RESP_TIMEOUT;
-        sdio_flag_clear(SDIO_FLAG_CMDTMOUT);
-        return status;
-    }
-
-    /* check whether the last response command index is the desired one */
-    if(sdio_command_index_get() != cmdindex) {
-        status = SD_ILLEGAL_COMMAND;
-        return status;
-    }
-    /* clear all the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    /* get the SDIO response register 0 for checking */
-    resp_r1 = sdio_response_get(SDIO_RESPONSE0);
-    if(SD_ALLZERO == (resp_r1 & SD_R1_ERROR_BITS)) {
-        /* no error occurs, return SD_OK */
-        status = SD_OK;
-        return status;
-    }
-
-    /* if some error occurs, return the error type */
-    status = r1_error_type_check(resp_r1);
-    return status;
-}
-
-/*!
-    \brief      check if error occurs for R2 response
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-static sd_error_enum r2_error_check(void)
-{
-    sd_error_enum status = SD_OK;
-    uint32_t reg_status = 0;
-    __IO uint32_t timeout = 100000;
-
-    /* store the content of SDIO_STAT */
-    reg_status = SDIO_STAT;
-    while(!(reg_status & (SDIO_FLAG_CCRCERR | SDIO_FLAG_CMDTMOUT | SDIO_FLAG_CMDRECV)) && (timeout > 0)) {
-        reg_status = SDIO_STAT;
-        --timeout;
-    }
-    /* check whether an error or timeout occurs or command response received */
-    if(reg_status & SDIO_FLAG_CCRCERR) {
-        status = SD_CMD_CRC_ERROR;
-        sdio_flag_clear(SDIO_FLAG_CCRCERR);
-        return status;
-    } else if((reg_status & SDIO_FLAG_CMDTMOUT) || (0 == timeout)) {
-        status = SD_CMD_RESP_TIMEOUT;
-        sdio_flag_clear(SDIO_FLAG_CMDTMOUT);
-        return status;
-    }
-    /* clear all the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    return status;
-}
-
-/*!
-    \brief      check if error occurs for R3 response
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-static sd_error_enum r3_error_check(void)
-{
-    sd_error_enum status = SD_OK;
-    uint32_t reg_status = 0;
-    __IO uint32_t timeout = 100000;
-
-    /* store the content of SDIO_STAT */
-    reg_status = SDIO_STAT;
-    while(!(reg_status & (SDIO_FLAG_CCRCERR | SDIO_FLAG_CMDTMOUT | SDIO_FLAG_CMDRECV)) && (timeout > 0)) {
-        reg_status = SDIO_STAT;
-        --timeout;
-    }
-    if((reg_status & SDIO_FLAG_CMDTMOUT) || (0 == timeout)) {
-        status = SD_CMD_RESP_TIMEOUT;
-        sdio_flag_clear(SDIO_FLAG_CMDTMOUT);
-        return status;
-    }
-    /* clear all the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    return status;
-}
-
-/*!
-    \brief      check if error occurs for R6 response
-    \param[in]  cmdindex: the index of command
-    \param[out] prca: a pointer that store the RCA of card
-    \retval     sd_error_enum
-*/
-static sd_error_enum r6_error_check(uint8_t cmdindex, uint16_t *prca)
-{
-    sd_error_enum status = SD_OK;
-    uint32_t reg_status = 0, response = 0;
-    __IO uint32_t timeout = 100000;
-
-    /* store the content of SDIO_STAT */
-    reg_status = SDIO_STAT;
-    while(!(reg_status & (SDIO_FLAG_CCRCERR | SDIO_FLAG_CMDTMOUT | SDIO_FLAG_CMDRECV)) && (timeout > 0)) {
-        reg_status = SDIO_STAT;
-        --timeout;
-    }
-    /* check whether an error or timeout occurs or command response received */
-    if(reg_status & SDIO_FLAG_CCRCERR) {
-        status = SD_CMD_CRC_ERROR;
-        sdio_flag_clear(SDIO_FLAG_CCRCERR);
-        return status;
-    } else if((reg_status & SDIO_FLAG_CMDTMOUT) || (0 == timeout)) {
-        status = SD_CMD_RESP_TIMEOUT;
-        sdio_flag_clear(SDIO_FLAG_CMDTMOUT);
-        return status;
-    }
-
-    /* check whether the last response command index is the desired one */
-    if(sdio_command_index_get() != cmdindex) {
-        status = SD_ILLEGAL_COMMAND;
-        return status;
-    }
-    /* clear all the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    /* get the SDIO response register 0 for checking */
-    response = sdio_response_get(SDIO_RESPONSE0);
-
-    if(SD_ALLZERO == (response & (SD_R6_COM_CRC_ERROR | SD_R6_ILLEGAL_COMMAND | SD_R6_GENERAL_UNKNOWN_ERROR))) {
-        *prca = (uint16_t)(response >> 16);
-        return status;
-    }
-    /* if some error occurs, return the error type */
-    if(response & SD_R6_COM_CRC_ERROR) {
-        status = SD_COM_CRC_ERROR;
-    } else if(response & SD_R6_ILLEGAL_COMMAND) {
-        status = SD_ILLEGAL_COMMAND;
-    } else if(response & SD_R6_GENERAL_UNKNOWN_ERROR) {
-        status = SD_GENERAL_UNKNOWN_ERROR;
-    }
-    return status;
-}
-
-/*!
-    \brief      check if error occurs for R7 response
-    \param[in]  none
-    \param[out] none
-    \retval     sd_error_enum
-*/
-static sd_error_enum r7_error_check(void)
-{
-    sd_error_enum status = SD_ERROR;
-    uint32_t reg_status = 0;
-    __IO uint32_t timeout = 100000;
-
-    /* store the content of SDIO_STAT */
-    reg_status = SDIO_STAT;
-    while(!(reg_status & (SDIO_FLAG_CCRCERR | SDIO_FLAG_CMDTMOUT | SDIO_FLAG_CMDRECV)) && (timeout > 0)) {
-        reg_status = SDIO_STAT;
-        --timeout;
-    }
-
-    /* check the flags */
-    if((reg_status & SDIO_FLAG_CMDTMOUT) || (0 == timeout)) {
-        status = SD_CMD_RESP_TIMEOUT;
-        sdio_flag_clear(SDIO_FLAG_CMDTMOUT);
-        return status;
-    }
-    if(reg_status & SDIO_FLAG_CMDRECV) {
-        status = SD_OK;
-        sdio_flag_clear(SDIO_FLAG_CMDRECV);
-        return status;
-    }
-    return status;
-}
-
-/*!
-    \brief      get the state which the card is in
-    \param[in]  none
-    \param[out] pcardstate: a pointer that store the card state
-      \arg        SD_CARDSTATE_IDLE: card is in idle state
-      \arg        SD_CARDSTATE_READY: card is in ready state
-      \arg        SD_CARDSTATE_IDENTIFICAT: card is in identification state
-      \arg        SD_CARDSTATE_STANDBY: card is in standby state
-      \arg        SD_CARDSTATE_TRANSFER: card is in transfer state
-      \arg        SD_CARDSTATE_DATA: card is in data state
-      \arg        SD_CARDSTATE_RECEIVING: card is in receiving state
-      \arg        SD_CARDSTATE_PROGRAMMING: card is in programming state
-      \arg        SD_CARDSTATE_DISCONNECT: card is in disconnect state
-      \arg        SD_CARDSTATE_LOCKED: card is in locked state
-    \retval     sd_error_enum
-*/
-static sd_error_enum sd_card_state_get(uint8_t *pcardstate)
-{
-    sd_error_enum status = SD_OK;
-    __IO uint32_t reg_status = 0, response = 0;
-    __IO uint32_t timeout = 100000;
-
-    /* send CMD13(SEND_STATUS), addressed card sends its status register */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SEND_STATUS, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-
-    /* store the content of SDIO_STAT */
-    reg_status = SDIO_STAT;
-    while(!(reg_status & (SDIO_FLAG_CCRCERR | SDIO_FLAG_CMDTMOUT | SDIO_FLAG_CMDRECV)) && (timeout > 0)) {
-        reg_status = SDIO_STAT;
-        --timeout;
-    }
-    /* check whether an error or timeout occurs or command response received */
-    if(reg_status & SDIO_FLAG_CCRCERR) {
-        status = SD_CMD_CRC_ERROR;
-        sdio_flag_clear(SDIO_FLAG_CCRCERR);
-        return status;
-    } else if((reg_status & SDIO_FLAG_CMDTMOUT) || (0 == timeout)) {
-        status = SD_CMD_RESP_TIMEOUT;
-        sdio_flag_clear(SDIO_FLAG_CMDTMOUT);
-        return status;
-    }
-
-    /* command response received, store the response command index */
-    reg_status = (uint32_t)sdio_command_index_get();
-    if(reg_status != (uint32_t)SD_CMD_SEND_STATUS) {
-        status = SD_ILLEGAL_COMMAND;
-        return status;
-    }
-    /* clear all the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    /* get the SDIO response register 0 for checking */
-    response = sdio_response_get(SDIO_RESPONSE0);
-    *pcardstate = (uint8_t)((response >> 9) & 0x0000000F);
-
-    if(SD_ALLZERO == (response & SD_R1_ERROR_BITS)) {
-        /* no error occurs, return SD_OK */
-        status = SD_OK;
-        return status;
-    }
-
-    /* if some error occurs, return the error type */
-    status = r1_error_type_check(response);
-    return status;
-}
-
-/*!
-    \brief      configure the bus width mode
-    \param[in]  buswidth: the bus width
-      \arg        SD_BUS_WIDTH_1BIT: 1-bit bus width
-      \arg        SD_BUS_WIDTH_4BIT: 4-bit bus width
-    \param[out] none
-    \retval     sd_error_enum
-*/
-static sd_error_enum sd_bus_width_config(uint32_t buswidth)
-{
-    sd_error_enum status = SD_OK;
-    /* check whether the card is locked */
-    if(sdio_response_get(SDIO_RESPONSE0) & SD_CARDSTATE_LOCKED) {
-        status = SD_LOCK_UNLOCK_FAILED;
-        return status;
-    }
-    /* get the SCR register */
-    status = sd_scr_get(sd_rca, sd_scr);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    if(SD_BUS_WIDTH_1BIT == buswidth) {
-        if(SD_ALLZERO != (sd_scr[1] & buswidth)) {
-            /* send CMD55(APP_CMD) to indicate next command is application specific command */
-            sdio_csm_disable();
-            sdio_command_response_config(SD_CMD_APP_CMD, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-            sdio_wait_type_set(SDIO_WAITTYPE_NO);
-            sdio_csm_enable();
-            /* check if some error occurs */
-            status = r1_error_check(SD_CMD_APP_CMD);
-            if(SD_OK != status) {
-                return status;
-            }
-
-            /* send ACMD6(SET_BUS_WIDTH) to define the data bus width */
-            sdio_csm_disable();
-            sdio_command_response_config(SD_APPCMD_SET_BUS_WIDTH, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-            sdio_wait_type_set(SDIO_WAITTYPE_NO);
-            sdio_csm_enable();
-            /* check if some error occurs */
-            status = r1_error_check(SD_APPCMD_SET_BUS_WIDTH);
-            if(SD_OK != status) {
-                return status;
-            }
-        } else {
-            status = SD_OPERATION_IMPROPER;
-        }
-        return status;
-    } else if(SD_BUS_WIDTH_4BIT == buswidth) {
-        if(SD_ALLZERO != (sd_scr[1] & buswidth)) {
-            /* send CMD55(APP_CMD) to indicate next command is application specific command */
-            sdio_csm_disable();
-            sdio_command_response_config(SD_CMD_APP_CMD, (uint32_t)sd_rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-            sdio_wait_type_set(SDIO_WAITTYPE_NO);
-            sdio_csm_enable();
-            /* check if some error occurs */
-            status = r1_error_check(SD_CMD_APP_CMD);
-            if(SD_OK != status) {
-                return status;
-            }
-
-            /* send ACMD6(SET_BUS_WIDTH) to define the data bus width */
-            sdio_csm_disable();
-            sdio_command_response_config(SD_APPCMD_SET_BUS_WIDTH, (uint32_t)0x2, SDIO_RESPONSETYPE_SHORT);
-            sdio_wait_type_set(SDIO_WAITTYPE_NO);
-            sdio_csm_enable();
-            /* check if some error occurs */
-            status = r1_error_check(SD_APPCMD_SET_BUS_WIDTH);
-            if(SD_OK != status) {
-                return status;
-            }
-        } else {
-            status = SD_OPERATION_IMPROPER;
-        }
-        return status;
-    } else {
-        status = SD_PARAMETER_INVALID;
-        return status;
-    }
-}
-
-/*!
-    \brief      get the SCR of corresponding card
-    \param[in]  rca: RCA of a card
-    \param[out] pscr: a pointer that store the SCR content
-    \retval     sd_error_enum
-*/
-static sd_error_enum sd_scr_get(uint16_t rca, uint32_t *pscr)
-{
-    sd_error_enum status = SD_OK;
-    uint32_t temp_scr[2] = {0, 0}, idx_scr = 0;
-    /* send CMD16(SET_BLOCKLEN) to set block length */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_SET_BLOCKLEN, (uint32_t)8, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_SET_BLOCKLEN);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    /* send CMD55(APP_CMD) to indicate next command is application specific command */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_CMD_APP_CMD, (uint32_t)rca << SD_RCA_SHIFT, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_CMD_APP_CMD);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    /* configure SDIO data */
-    sdio_data_config(SD_DATATIMEOUT, (uint32_t)8, SDIO_DATABLOCKSIZE_8BYTES);
-    sdio_data_transfer_config(SDIO_TRANSMODE_BLOCK, SDIO_TRANSDIRECTION_TOSDIO);
-    sdio_dsm_enable();
-
-    /* send ACMD51(SEND_SCR) to read the SD configuration register */
-    sdio_csm_disable();
-    sdio_command_response_config(SD_APPCMD_SEND_SCR, (uint32_t)0x0, SDIO_RESPONSETYPE_SHORT);
-    sdio_wait_type_set(SDIO_WAITTYPE_NO);
-    sdio_csm_enable();
-    /* check if some error occurs */
-    status = r1_error_check(SD_APPCMD_SEND_SCR);
-    if(SD_OK != status) {
-        return status;
-    }
-
-    /* store the received SCR */
-    while(!sdio_flag_get(SDIO_FLAG_DTCRCERR | SDIO_FLAG_DTTMOUT | SDIO_FLAG_RXORE | SDIO_FLAG_DTBLKEND | SDIO_FLAG_STBITE)) {
-        if(RESET != sdio_flag_get(SDIO_FLAG_RXDTVAL)) {
-            *(temp_scr + idx_scr) = sdio_data_read();
-            ++idx_scr;
-        }
-    }
-
-    /* check whether some error occurs */
-    if(RESET != sdio_flag_get(SDIO_FLAG_DTCRCERR)) {
-        status = SD_DATA_CRC_ERROR;
-        sdio_flag_clear(SDIO_FLAG_DTCRCERR);
-        return status;
-    } else if(RESET != sdio_flag_get(SDIO_FLAG_DTTMOUT)) {
-        status = SD_DATA_TIMEOUT;
-        sdio_flag_clear(SDIO_FLAG_DTTMOUT);
-        return status;
-    } else if(RESET != sdio_flag_get(SDIO_FLAG_RXORE)) {
-        status = SD_RX_OVERRUN_ERROR;
-        sdio_flag_clear(SDIO_FLAG_RXORE);
-        return status;
-    } else if(RESET != sdio_flag_get(SDIO_FLAG_STBITE)) {
-        status = SD_START_BIT_ERROR;
-        sdio_flag_clear(SDIO_FLAG_STBITE);
-        return status;
-    }
-
-    /* clear all the SDIO_INTC flags */
-    sdio_flag_clear(SDIO_MASK_INTC_FLAGS);
-    /* readjust the temp SCR value */
-    *(pscr) = ((temp_scr[1] & SD_MASK_0_7BITS) << 24) | ((temp_scr[1] & SD_MASK_8_15BITS) << 8) |
-              ((temp_scr[1] & SD_MASK_16_23BITS) >> 8) | ((temp_scr[1] & SD_MASK_24_31BITS) >> 24);
-    *(pscr + 1) = ((temp_scr[0] & SD_MASK_0_7BITS) << 24) | ((temp_scr[0] & SD_MASK_8_15BITS) << 8) |
-                  ((temp_scr[0] & SD_MASK_16_23BITS) >> 8) | ((temp_scr[0] & SD_MASK_24_31BITS) >> 24);
-    return status;
-}
-
-/*!
-    \brief      get the data block size
-    \param[in]  bytesnumber: the number of bytes
-    \param[out] none
-    \retval     data block size
-      \arg        SDIO_DATABLOCKSIZE_1BYTE: block size = 1 byte
-      \arg        SDIO_DATABLOCKSIZE_2BYTES: block size = 2 bytes
-      \arg        SDIO_DATABLOCKSIZE_4BYTES: block size = 4 bytes
-      \arg        SDIO_DATABLOCKSIZE_8BYTES: block size = 8 bytes
-      \arg        SDIO_DATABLOCKSIZE_16BYTES: block size = 16 bytes
-      \arg        SDIO_DATABLOCKSIZE_32BYTES: block size = 32 bytes
-      \arg        SDIO_DATABLOCKSIZE_64BYTES: block size = 64 bytes
-      \arg        SDIO_DATABLOCKSIZE_128BYTES: block size = 128 bytes
-      \arg        SDIO_DATABLOCKSIZE_256BYTES: block size = 256 bytes
-      \arg        SDIO_DATABLOCKSIZE_512BYTES: block size = 512 bytes
-      \arg        SDIO_DATABLOCKSIZE_1024BYTES: block size = 1024 bytes
-      \arg        SDIO_DATABLOCKSIZE_2048BYTES: block size = 2048 bytes
-      \arg        SDIO_DATABLOCKSIZE_4096BYTES: block size = 4096 bytes
-      \arg        SDIO_DATABLOCKSIZE_8192BYTES: block size = 8192 bytes
-      \arg        SDIO_DATABLOCKSIZE_16384BYTES: block size = 16384 bytes
-*/
-static uint32_t sd_datablocksize_get(uint16_t bytesnumber)
-{
-    uint8_t exp_val = 0;
-    /* calculate the exponent of 2 */
-    while(1 != bytesnumber) {
-        bytesnumber >>= 1;
-        ++exp_val;
-    }
-    return DATACTL_BLKSZ(exp_val);
-}
-
-/*!
-    \brief      configure the DMA1 channel 3 for transferring data
-    \param[in]  srcbuf: a pointer point to a buffer which will be transferred
-    \param[in]  bufsize: the size of buffer(not used in flow controller is peripheral)
-    \param[out] none
-    \retval     none
-*/
-static void dma_transfer_config(uint32_t *srcbuf, uint32_t bufsize)
-{
-    dma_parameter_struct dma_struct;
-    /* clear all the interrupt flags */
-    dma_flag_clear(DMA1, DMA_CH3, DMA_FLAG_G);
-    dma_flag_clear(DMA1, DMA_CH3, DMA_FLAG_FTF);
-    dma_flag_clear(DMA1, DMA_CH3, DMA_FLAG_HTF);
-    dma_flag_clear(DMA1, DMA_CH3, DMA_FLAG_ERR);
-    dma_channel_disable(DMA1, DMA_CH3);
-    dma_deinit(DMA1, DMA_CH3);
-
-    /* configure the DMA1 channel3 */
-    dma_struct.periph_addr = (uint32_t)SDIO_FIFO_ADDR;
-    dma_struct.memory_addr = (uint32_t)srcbuf;
-    dma_struct.direction = DMA_MEMORY_TO_PERIPHERAL;
-    dma_struct.number = bufsize / 4;
-    dma_struct.periph_inc = DMA_PERIPH_INCREASE_DISABLE;
-    dma_struct.memory_inc = DMA_MEMORY_INCREASE_ENABLE;
-    dma_struct.periph_width = DMA_PERIPHERAL_WIDTH_32BIT;
-    dma_struct.memory_width = DMA_MEMORY_WIDTH_32BIT;
-    dma_struct.priority = DMA_PRIORITY_MEDIUM;
-    dma_init(DMA1, DMA_CH3, &dma_struct);
-
-    dma_circulation_disable(DMA1, DMA_CH3);
-    dma_channel_enable(DMA1, DMA_CH3);
-}
-
-/*!
-    \brief      configure the DMA1 channel 3 for receiving data
-    \param[in]  dstbuf: a pointer point to a buffer which will receive data
-    \param[in]  bufsize: the size of buffer(not used in flow controller is peripheral)
-    \param[out] none
-    \retval     none
-*/
-static void dma_receive_config(uint32_t *dstbuf, uint32_t bufsize)
-{
-    dma_parameter_struct dma_struct;
-    /* clear all the interrupt flags */
-    dma_flag_clear(DMA1, DMA_CH3, DMA_FLAG_G);
-    dma_flag_clear(DMA1, DMA_CH3, DMA_FLAG_FTF);
-    dma_flag_clear(DMA1, DMA_CH3, DMA_FLAG_HTF);
-    dma_flag_clear(DMA1, DMA_CH3, DMA_FLAG_ERR);
-    dma_channel_disable(DMA1, DMA_CH3);
-    dma_deinit(DMA1, DMA_CH3);
-
-    /* configure the DMA1 channel 3 */
-    dma_struct.periph_addr = (uint32_t)SDIO_FIFO_ADDR;
-    dma_struct.memory_addr = (uint32_t)dstbuf;
-    dma_struct.direction = DMA_PERIPHERAL_TO_MEMORY;
-    dma_struct.number = bufsize / 4;
-    dma_struct.periph_inc = DMA_PERIPH_INCREASE_DISABLE;
-    dma_struct.memory_inc = DMA_MEMORY_INCREASE_ENABLE;
-    dma_struct.periph_width = DMA_PERIPHERAL_WIDTH_32BIT;
-    dma_struct.memory_width = DMA_MEMORY_WIDTH_32BIT;
-    dma_struct.priority = DMA_PRIORITY_ULTRA_HIGH;
-    dma_init(DMA1, DMA_CH3, &dma_struct);
-
-    dma_circulation_disable(DMA1, DMA_CH3);
-    dma_channel_enable(DMA1, DMA_CH3);
-}

lib/BlueSCSI_platform_GD32F205/gd32_sdio_sdcard.h

@@ -1,271 +0,0 @@
-/*!
-    \file    sdcard.h
-    \brief   the header file of SD card driver
-
-    \version 2015-07-15, V1.0.0, firmware for GD32F20x
-    \version 2017-06-05, V2.0.0, firmware for GD32F20x
-    \version 2018-10-31, V2.1.0, firmware for GD32F20x
-    \version 2020-09-30, V2.2.0, firmware for GD32F20x
-    \version 2021-07-30, V2.3.0, firmware for GD32F20x
-*/
-
-/*
-    Copyright (c) 2021, GigaDevice Semiconductor Inc.
-
-    Redistribution and use in source and binary forms, with or without modification,
-are permitted provided that the following conditions are met:
-
-    1. Redistributions of source code must retain the above copyright notice, this
-       list of conditions and the following disclaimer.
-    2. Redistributions in binary form must reproduce the above copyright notice,
-       this list of conditions and the following disclaimer in the documentation
-       and/or other materials provided with the distribution.
-    3. Neither the name of the copyright holder nor the names of its contributors
-       may be used to endorse or promote products derived from this software without
-       specific prior written permission.
-
-    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
-IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
-INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
-NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
-PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
-WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
-OF SUCH DAMAGE.
-*/
-
-#ifndef SDCARD_H
-#define SDCARD_H
-
-#include "gd32f20x.h"
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/* SD memory card bus commands index */
-#define SD_CMD_GO_IDLE_STATE                  ((uint8_t)0)   /* CMD0, GO_IDLE_STATE */
-#define SD_CMD_ALL_SEND_CID                   ((uint8_t)2)   /* CMD2, ALL_SEND_CID */
-#define SD_CMD_SEND_RELATIVE_ADDR             ((uint8_t)3)   /* CMD3, SEND_RELATIVE_ADDR */
-#define SD_CMD_SET_DSR                        ((uint8_t)4)   /* CMD4, SET_DSR */
-#define SD_CMD_SWITCH_FUNC                    ((uint8_t)6)   /* CMD6, SWITCH_FUNC */
-#define SD_CMD_SELECT_DESELECT_CARD           ((uint8_t)7)   /* CMD7, SELECT_DESELECT_CARD */
-#define SD_CMD_SEND_IF_COND                   ((uint8_t)8)   /* CMD8, SEND_IF_COND */
-#define SD_CMD_SEND_CSD                       ((uint8_t)9)   /* CMD9, SEND_CSD */
-#define SD_CMD_SEND_CID                       ((uint8_t)10)  /* CMD10, SEND_CID */
-#define SD_CMD_STOP_TRANSMISSION              ((uint8_t)12)  /* CMD12, STOP_TRANSMISSION */
-#define SD_CMD_SEND_STATUS                    ((uint8_t)13)  /* CMD13, SEND_STATUS */
-#define SD_CMD_GO_INACTIVE_STATE              ((uint8_t)15)  /* CMD15, GO_INACTIVE_STATE */
-#define SD_CMD_SET_BLOCKLEN                   ((uint8_t)16)  /* CMD16, SET_BLOCKLEN */
-#define SD_CMD_READ_SINGLE_BLOCK              ((uint8_t)17)  /* CMD17, READ_SINGLE_BLOCK */
-#define SD_CMD_READ_MULTIPLE_BLOCK            ((uint8_t)18)  /* CMD18, READ_MULTIPLE_BLOCK */
-#define SD_CMD_WRITE_BLOCK                    ((uint8_t)24)  /* CMD24, WRITE_BLOCK */
-#define SD_CMD_WRITE_MULTIPLE_BLOCK           ((uint8_t)25)  /* CMD25, WRITE_MULTIPLE_BLOCK */
-#define SD_CMD_PROG_CSD                       ((uint8_t)27)  /* CMD27, PROG_CSD */
-#define SD_CMD_SET_WRITE_PROT                 ((uint8_t)28)  /* CMD28, SET_WRITE_PROT */
-#define SD_CMD_CLR_WRITE_PROT                 ((uint8_t)29)  /* CMD29, CLR_WRITE_PROT */
-#define SD_CMD_SEND_WRITE_PROT                ((uint8_t)30)  /* CMD30, SEND_WRITE_PROT */
-#define SD_CMD_ERASE_WR_BLK_START             ((uint8_t)32)  /* CMD32, ERASE_WR_BLK_START */
-#define SD_CMD_ERASE_WR_BLK_END               ((uint8_t)33)  /* CMD33, ERASE_WR_BLK_END */
-#define SD_CMD_ERASE                          ((uint8_t)38)  /* CMD38, ERASE */
-#define SD_CMD_LOCK_UNLOCK                    ((uint8_t)42)  /* CMD42, LOCK_UNLOCK */
-#define SD_CMD_APP_CMD                        ((uint8_t)55)  /* CMD55, APP_CMD */
-#define SD_CMD_GEN_CMD                        ((uint8_t)56)  /* CMD56, GEN_CMD */
-
-/* SD memory card application specific commands index */
-#define SD_APPCMD_SET_BUS_WIDTH               ((uint8_t)6)   /* ACMD6, SET_BUS_WIDTH */
-#define SD_APPCMD_SD_STATUS                   ((uint8_t)13)  /* ACMD13, SD_STATUS */
-#define SD_APPCMD_SEND_NUM_WR_BLOCKS          ((uint8_t)22)  /* ACMD22, SEND_NUM_WR_BLOCKS */
-#define SD_APPCMD_SET_WR_BLK_ERASE_COUNT      ((uint8_t)23)  /* ACMD23, SET_WR_BLK_ERASE_COUNT */
-#define SD_APPCMD_SD_SEND_OP_COND             ((uint8_t)41)  /* ACMD41, SD_SEND_OP_COND */
-#define SD_APPCMD_SET_CLR_CARD_DETECT         ((uint8_t)42)  /* ACMD42, SET_CLR_CARD_DETECT */
-#define SD_APPCMD_SEND_SCR                    ((uint8_t)51)  /* ACMD51, SEND_SCR */
-
-/* card command class */
-#define SD_CCC_SWITCH                          BIT(10)       /* class 10 */
-#define SD_CCC_IO_MODE                         BIT(9)        /* class 9 */
-#define SD_CCC_APPLICATION_SPECIFIC            BIT(8)        /* class 8 */
-#define SD_CCC_LOCK_CARD                       BIT(7)        /* class 7 */
-#define SD_CCC_WRITE_PROTECTION                BIT(6)        /* class 6 */
-#define SD_CCC_ERASE                           BIT(5)        /* class 5 */
-#define SD_CCC_BLOCK_WRITE                     BIT(4)        /* class 4 */
-#define SD_CCC_BLOCK_READ                      BIT(2)        /* class 2 */
-#define SD_CCC_BASIC                           BIT(0)        /* class 0 */
-
-/* SD card data transmission mode */
-#define SD_DMA_MODE                           ((uint32_t)0x00000000) /* DMA mode */
-#define SD_POLLING_MODE                       ((uint32_t)0x00000001) /* polling mode */
-
-/* lock unlock status */
-#define SD_LOCK                               ((uint8_t)0x05)        /* lock the SD card */
-#define SD_UNLOCK                             ((uint8_t)0x02)        /* unlock the SD card */
-
-/* supported memory cards types */
-typedef enum {
-    SDIO_STD_CAPACITY_SD_CARD_V1_1 = 0,   /* standard capacity SD card version 1.1 */
-    SDIO_STD_CAPACITY_SD_CARD_V2_0,       /* standard capacity SD card version 2.0 */
-    SDIO_HIGH_CAPACITY_SD_CARD,           /* high capacity SD card */
-    SDIO_SECURE_DIGITAL_IO_CARD,          /* secure digital IO card */
-    SDIO_SECURE_DIGITAL_IO_COMBO_CARD,    /* secure digital IO combo card */
-    SDIO_MULTIMEDIA_CARD,                 /* multimedia card */
-    SDIO_HIGH_CAPACITY_MULTIMEDIA_CARD,   /* high capacity multimedia card */
-    SDIO_HIGH_SPEED_MULTIMEDIA_CARD       /* high speed multimedia card */
-} sdio_card_type_enum;
-
-/* card identification (CID) register */
-typedef struct {
-    __IO uint8_t mid;                     /* manufacturer ID */
-    __IO uint16_t oid;                    /* OEM/application ID */
-    __IO uint32_t pnm0;                   /* product name */
-    __IO uint8_t pnm1;                    /* product name */
-    __IO uint8_t prv;                     /* product revision */
-    __IO uint32_t psn;                    /* product serial number */
-    __IO uint16_t mdt;                    /* manufacturing date */
-    __IO uint8_t cid_crc;                 /* CID CRC7 checksum */
-} sd_cid_struct;
-
-/* CSD register (CSD version 1.0 and 2.0) */
-typedef struct {
-    __IO uint8_t csd_struct;              /* CSD struct */
-    __IO uint8_t taac;                    /* data read access-time */
-    __IO uint8_t nsac;                    /* data read access-time in CLK cycles */
-    __IO uint8_t tran_speed;              /* max. data transfer rate */
-    __IO uint16_t ccc;                    /* card command classes */
-    __IO uint8_t read_bl_len;             /* max. read data block length */
-    __IO uint8_t read_bl_partial;         /* partial blocks for read allowed */
-    __IO uint8_t write_blk_misalign;      /* write block misalignment */
-    __IO uint8_t read_blk_misalign;       /* read block misalignment */
-    __IO uint8_t dsp_imp;                 /* DSR implemented */
-    __IO uint32_t c_size;                 /* device size, 12 bits in CSD version 1.0, 22 bits in CSD version 2.0 */
-    __IO uint8_t vdd_r_curr_min;          /* max. read current @VDD min, CSD version 1.0 */
-    __IO uint8_t vdd_r_curr_max;          /* max. read current @VDD max, CSD version 1.0 */
-    __IO uint8_t vdd_w_curr_min;          /* max. write current @VDD min, CSD version 1.0 */
-    __IO uint8_t vdd_w_curr_max;          /* max. write current @VDD max, CSD version 1.0 */
-    __IO uint8_t c_size_mult;             /* device size multiplier, CSD version 1.0 */
-    __IO uint8_t erase_blk_en;            /* erase single block enable */
-    __IO uint8_t sector_size;             /* erase sector size */
-    __IO uint8_t wp_grp_size;             /* write protect group size */
-    __IO uint8_t wp_grp_enable;           /* write protect group enable */
-    __IO uint8_t r2w_factor;              /* write speed factor */
-    __IO uint8_t write_bl_len;            /* max. write data block length */
-    __IO uint8_t write_bl_partial;        /* partial blocks for write allowed */
-    __IO uint8_t file_format_grp;         /* file format group */
-    __IO uint8_t copy_flag;               /* copy flag (OTP) */
-    __IO uint8_t perm_write_protect;      /* permanent write protection */
-    __IO uint8_t tmp_write_protect;       /* temporary write protection */
-    __IO uint8_t file_format;             /* file format */
-    __IO uint8_t csd_crc;                 /* CSD CRC checksum */
-} sd_csd_struct;
-
-/* information of card */
-typedef struct {
-    sd_cid_struct card_cid;               /* CID register */
-    sd_csd_struct card_csd;               /* CSD register */
-    sdio_card_type_enum card_type;        /* card tpye */
-    uint32_t card_capacity;               /* card capacity */
-    uint32_t card_blocksize;              /* card block size */
-    uint16_t card_rca;                    /* card relative card address */
-} sd_card_info_struct;
-
-/* SD error flags */
-typedef enum {
-    SD_OUT_OF_RANGE = 0,                  /* command's argument was out of range */
-    SD_ADDRESS_ERROR,                     /* misaligned address which did not match the block length */
-    SD_BLOCK_LEN_ERROR,                   /* transferred block length is not allowed for the card or the number of transferred bytes does not match the block length */
-    SD_ERASE_SEQ_ERROR,                   /* an error in the sequence of erase command occurs */
-    SD_ERASE_PARAM,                       /* an invalid selection of write-blocks for erase occurred */
-    SD_WP_VIOLATION,                      /* attempt to program a write protect block or permanent write protected card */
-    SD_LOCK_UNLOCK_FAILED,                /* sequence or password error has been detected in lock/unlock card command */
-    SD_COM_CRC_ERROR,                     /* CRC check of the previous command failed */
-    SD_ILLEGAL_COMMAND,                   /* command not legal for the card state */
-    SD_CARD_ECC_FAILED,                   /* card internal ECC was applied but failed to correct the data */
-    SD_CC_ERROR,                          /* internal card controller error */
-    SD_GENERAL_UNKNOWN_ERROR,             /* general or unknown error occurred during the operation */
-    SD_CSD_OVERWRITE,                     /* read only section of the CSD does not match the card content or an attempt to reverse the copy or permanent WP bits was made */
-    SD_WP_ERASE_SKIP,                     /* only partial address space was erased or the temporary or permanent write protected card was erased */
-    SD_CARD_ECC_DISABLED,                 /* command has been executed without using internal ECC */
-    SD_ERASE_RESET,                       /* erase sequence was cleared before executing because an out of erase sequence command was received */
-    SD_AKE_SEQ_ERROR,                     /* error in the sequence of the authentication process */
-
-    SD_CMD_CRC_ERROR,                     /* command response received (CRC check failed) */
-    SD_DATA_CRC_ERROR,                    /* data block sent/received (CRC check failed) */
-    SD_CMD_RESP_TIMEOUT,                  /* command response timeout */
-    SD_DATA_TIMEOUT,                      /* data timeout */
-    SD_TX_UNDERRUN_ERROR,                 /* transmit FIFO underrun error occurs */
-    SD_RX_OVERRUN_ERROR,                  /* received FIFO overrun error occurs */
-    SD_START_BIT_ERROR,                   /* start bit error in the bus */
-
-    SD_VOLTRANGE_INVALID,                 /* the voltage range is invalid */
-    SD_PARAMETER_INVALID,                 /* the parameter is invalid */
-    SD_OPERATION_IMPROPER,                /* the operation is improper */
-    SD_FUNCTION_UNSUPPORTED,              /* the function is unsupported */
-    SD_ERROR,                             /* an error occurred */
-    SD_OK                                 /* no error occurred */
-} sd_error_enum;
-
-typedef enum {
-    SD_NO_TRANSFER = 0,                     /* no data transfer is acting */
-    SD_TRANSFER_IN_PROGRESS                 /* data transfer is in progress */
-} sd_transfer_state_enum;
-
-extern uint32_t sd_scr[2];                /* SD card SCR */
-
-/* function declarations */
-/* initialize the SD card and make it in standby state */
-sd_error_enum sd_init(void);
-/* initialize the card and get CID and CSD of the card */
-sd_error_enum sd_card_init(void);
-/* configure the clock and the work voltage, and get the card type */
-sd_error_enum sd_power_on(void);
-/* close the power of SDIO */
-sd_error_enum sd_power_off(void);
-
-/* configure the bus mode */
-sd_error_enum sd_bus_mode_config(uint32_t busmode);
-/* configure the mode of transmission */
-sd_error_enum sd_transfer_mode_config(uint32_t txmode);
-
-typedef void (*sdio_callback_t)(uint32_t bytes_done);
-/* read a block data into a buffer from the specified address of a card */
-sd_error_enum sd_block_read(uint32_t *preadbuffer, uint64_t readaddr, uint16_t blocksize, sdio_callback_t callback);
-/* read multiple blocks data into a buffer from the specified address of a card */
-sd_error_enum sd_multiblocks_read(uint32_t *preadbuffer, uint64_t readaddr, uint16_t blocksize, uint32_t blocksnumber, sdio_callback_t callback);
-/* write a block data to the specified address of a card */
-sd_error_enum sd_block_write(uint32_t *pwritebuffer, uint64_t writeaddr, uint16_t blocksize, sdio_callback_t callback);
-/* write multiple blocks data to the specified address of a card */
-sd_error_enum sd_multiblocks_write(uint32_t *pwritebuffer, uint64_t writeaddr, uint16_t blocksize, uint32_t blocksnumber, sdio_callback_t callback);
-/* erase a continuous area of a card */
-sd_error_enum sd_erase(uint64_t startaddr, uint64_t endaddr);
-/* process all the interrupts which the corresponding flags are set */
-sd_error_enum sd_interrupts_process(void);
-
-/* select or deselect a card */
-sd_error_enum sd_card_select_deselect(uint16_t cardrca);
-/* get the card status */
-sd_error_enum sd_cardstatus_get(uint32_t *pcardstatus);
-/* get the SD card status */
-sd_error_enum sd_sdstatus_get(uint32_t *psdstatus);
-/* stop an ongoing data transfer */
-sd_error_enum sd_transfer_stop(void);
-/* lock or unlock a card */
-sd_error_enum sd_lock_unlock(uint8_t lockstate);
-
-/* get the data transfer state */
-sd_transfer_state_enum sd_transfer_state_get(void);
-/* get SD card capacity(KB) */
-uint32_t sd_card_capacity_get(void);
-/* get the detailed information of the SD card based on received CID and CSD */
-sd_error_enum sd_card_information_get(sd_card_info_struct *pcardinfo);
-sd_error_enum sd_card_information_get_short(sdio_card_type_enum *card_type, uint16_t *card_rca);
-
-/* Get card information in raw format */
-void sd_cid_get(uint8_t *cid);
-void sd_csd_get(uint8_t *csd);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* SDCARD_H */

lib/BlueSCSI_platform_GD32F205/greenpak.cpp

@@ -1,188 +0,0 @@
-// I2C communication with GreenPAK.
-// This uses bitbanging for I2C so that internal GPIO pull-up can be used
-// and to avoid the bugs that are present in STM32F2 I2C peripheral,
-// it is uncertain if the same bugs apply to GD32F2.
-
-#include "BlueSCSI_platform.h"
-#include "BlueSCSI_log.h"
-#include "greenpak.h"
-#include "greenpak_fw.h"
-
-#ifndef GREENPAK_I2C_PORT
-
-bool greenpak_write(uint16_t regaddr, const uint8_t *data, int length) { return false; }
-bool greenpak_read(uint16_t regaddr, uint8_t *data, int length) { return false; }
-bool greenpak_load_firmware() { return false; }
-bool greenpak_is_ready() { return false; }
-
-#else
-
-bool g_greenpak_is_ready;
-
-// SCL is driven as push-pull, SDA is driven as IPU / OUT_OD
-#define I2C_SCL_HI() GPIO_BOP(GREENPAK_I2C_PORT) = GREENPAK_I2C_SCL
-#define I2C_SCL_LO() GPIO_BC(GREENPAK_I2C_PORT) = GREENPAK_I2C_SCL
-#define I2C_SDA_HI() gpio_init(GREENPAK_I2C_PORT, GPIO_MODE_IPU, 0, GREENPAK_I2C_SDA)
-#define I2C_SDA_LO() gpio_init(GREENPAK_I2C_PORT, GPIO_MODE_OUT_OD, GPIO_OSPEED_2MHZ, GREENPAK_I2C_SDA), GPIO_BC(GREENPAK_I2C_PORT) = GREENPAK_I2C_SDA
-#define I2C_SDA_READ() (GPIO_ISTAT(GREENPAK_I2C_PORT) & GREENPAK_I2C_SDA)
-#define I2C_DELAY() delay_ns(10000);
-
-static void greenpak_gpio_init()
-{
-    gpio_bit_set(GREENPAK_I2C_PORT, GREENPAK_I2C_SCL | GREENPAK_I2C_SDA);
-    gpio_init(GREENPAK_I2C_PORT, GPIO_MODE_IPU, 0, GREENPAK_I2C_SDA);
-    gpio_init(GREENPAK_I2C_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_2MHZ, GREENPAK_I2C_SCL);
-
-    // Data bits used for communication
-    uint32_t greenpak_io = GREENPAK_PLD_IO1 | GREENPAK_PLD_IO2 | GREENPAK_PLD_IO3;
-    gpio_bit_reset(SCSI_OUT_PORT, greenpak_io);
-    gpio_init(SCSI_OUT_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, greenpak_io);
-}
-
-static void i2c_writebit(bool bit)
-{
-    if (bit)
-        I2C_SDA_HI();
-    else
-        I2C_SDA_LO();
-
-    I2C_DELAY();
-    I2C_SCL_HI();
-    I2C_DELAY();
-    I2C_SCL_LO();
-}
-
-static bool i2c_readbit()
-{
-    I2C_SDA_HI(); // Pull-up
-    I2C_DELAY();
-    I2C_SCL_HI();
-    I2C_DELAY();
-    bool result = I2C_SDA_READ();
-    I2C_SCL_LO();
-    return result;
-}
-
-// Write byte to I2C bus, return ACK bit status
-static bool i2c_writebyte(uint8_t byte)
-{
-    for (int i = 0; i < 8; i++)
-    {
-        i2c_writebit(byte & (0x80 >> i));
-    }
-    return !i2c_readbit();
-}
-
-// Read byte from I2C bus
-static uint8_t i2c_readbyte(bool ack)
-{
-    uint8_t result = 0;
-    for (int i = 0; i < 8; i++)
-    {
-        result |= i2c_readbit() << (7 - i);
-    }
-
-    i2c_writebyte(!ack);
-    return result;
-}
-
-static bool i2c_start(uint8_t device_addr)
-{
-    // Initial signal state
-    I2C_SCL_HI();
-    I2C_SDA_HI();
-    I2C_DELAY();
-
-    // Start condition
-    I2C_SDA_LO();
-    I2C_DELAY();
-
-    I2C_SCL_LO();
-    I2C_DELAY();
-
-    // Device address
-    return i2c_writebyte(device_addr);
-}
-
-static void i2c_stop()
-{
-    I2C_SDA_LO();
-    I2C_DELAY();
-    I2C_SCL_HI();
-    I2C_DELAY();
-    I2C_SDA_HI();
-    I2C_DELAY();
-}
-
-bool greenpak_write(uint16_t regaddr, const uint8_t *data, int length)
-{
-    bool status = true;
-    uint16_t blockaddr = regaddr >> 8;
-    status &= i2c_start(GREENPAK_I2C_ADDR | (blockaddr << 1));
-    status &= i2c_writebyte(regaddr & 0xFF);
-
-    for (int i = 0; i < length; i++)
-    {
-        status &= i2c_writebyte(data[i]);
-    }
-
-    i2c_stop();
-    return status;
-}
-
-bool greenpak_read(uint16_t regaddr, uint8_t *data, int length)
-{
-    bool status = true;
-    uint16_t blockaddr = (regaddr >> 8) & 7;
-    status &= i2c_start(GREENPAK_I2C_ADDR | (blockaddr << 1));
-    status &= i2c_writebyte(regaddr & 0xFF);
-
-    status &= i2c_start(GREENPAK_I2C_ADDR | (blockaddr << 1) | 1);
-
-    for (int i = 0; i < length; i++)
-    {
-        data[i] = i2c_readbyte(i < length - 1);
-    }
-
-    i2c_stop();
-    return status;
-}
-
-bool greenpak_load_firmware()
-{
-    uint8_t dummy;
-    greenpak_gpio_init();
-
-    if (!greenpak_read(0, &dummy, 1))
-    {
-        bluelog("Optional GreenPAK not detected");
-        return false;
-    }
-    else
-    {
-        bluelog("Optional GreenPAK detected, loading firmware");
-    }
-
-    if (!greenpak_write(0, g_greenpak_fw, sizeof(g_greenpak_fw)))
-    {
-        bluelog("GreenPAK firmware loading failed");
-        return false;
-    }
-    else
-    {
-        bluelog("GreenPAK firmware successfully loaded");
-        LED_ON();
-        delay(10);
-        LED_OFF();
-        delay(100);
-        g_greenpak_is_ready = true;
-        return true;
-    }
-}
-
-bool greenpak_is_ready()
-{
-    return g_greenpak_is_ready;
-}
-
-#endif

lib/BlueSCSI_platform_GD32F205/greenpak.h

@@ -1,13 +0,0 @@
-// External GreenPAK SLG46824 programmable logic can optionally be used to
-// accelerate SCSI communications. This module contains code to load firmware
-// to the GreenPAK through I2C.
-
-#pragma once
-
-#include <stdint.h>
-
-bool greenpak_write(uint16_t regaddr, const uint8_t *data, int length);
-bool greenpak_read(uint16_t regaddr, uint8_t *data, int length);
-
-bool greenpak_load_firmware();
-bool greenpak_is_ready();

lib/BlueSCSI_platform_GD32F205/greenpak_fw.h

@@ -1,24 +0,0 @@
-const uint8_t g_greenpak_fw[] = {
-  0xc4, 0x09, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x38, 0xc2, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xd0, 0x08,
-  0x13, 0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0xe7, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x30, 0x70, 0x00, 0x30, 0x20, 0x30, 0x30, 0x00, 0x00, 0x30, 0x30,
-  0x30, 0x00, 0x30, 0x30, 0x30, 0x30, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x14, 0x22, 0x30, 0x0c, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x06, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x40, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0xd7, 0x14, 0x20, 0x00, 0x01, 0x00, 0x00,
-  0x00, 0x02, 0x01, 0x00, 0x00, 0x02, 0x00, 0x01, 0x00, 0x00, 0x02, 0x01,
-  0x00, 0x00, 0x02, 0x00, 0x01, 0x00, 0x00, 0x02, 0x01, 0x00, 0x00, 0x02,
-  0x00, 0x01, 0x00, 0x00, 0x02, 0x00, 0x01, 0x00, 0x00, 0x00, 0x01, 0x01,
-  0x01, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-  0x00, 0x00, 0x00, 0xa5
-};

lib/BlueSCSI_platform_GD32F205/scsi2sd_time.h

@@ -1,14 +0,0 @@
-// Timing functions for SCSI2SD.
-// This file is derived from time.h in SCSI2SD-V6.
-
-#pragma once
-
-#include <stdint.h>
-#include "BlueSCSI_platform.h"
-
-#define s2s_getTime_ms() millis()
-#define s2s_elapsedTime_ms(since) ((uint32_t)(millis() - (since)))
-#define s2s_delay_ms(x) delay_ns(x * 1000000)
-#define s2s_delay_us(x) delay_ns(x * 1000)
-#define s2s_delay_ns(x) delay_ns(x)
-

lib/BlueSCSI_platform_GD32F205/scsiPhy.cpp

@@ -1,600 +0,0 @@
-// Implements the low level interface to SCSI bus
-// Partially derived from scsiPhy.c from SCSI2SD-V6
-
-#include "scsiPhy.h"
-#include "BlueSCSI_platform.h"
-#include "scsi_accel_asm.h"
-#include "scsi_accel_dma.h"
-#include "scsi_accel_greenpak.h"
-#include "scsi_accel_sync.h"
-#include "BlueSCSI_log.h"
-#include "BlueSCSI_log_trace.h"
-#include "BlueSCSI_config.h"
-#include <minIni.h>
-
-#include <scsi2sd.h>
-extern "C" {
-#include <scsi.h>
-#include <scsi2sd_time.h>
-}
-
-// Acceleration mode in use
-static enum {
-    PHY_MODE_BEST_AVAILABLE = 0,
-    PHY_MODE_PIO = 1,
-    PHY_MODE_DMA_TIMER = 2,
-    PHY_MODE_GREENPAK_PIO = 3,
-    PHY_MODE_GREENPAK_DMA = 4
-} g_scsi_phy_mode;
-static const char *g_scsi_phy_mode_names[] = {
-    "Unknown", "PIO", "DMA_TIMER", "GREENPAK_PIO", "GREENPAK_DMA"
-};
-
-// State of polling write request
-static struct {
-    const uint8_t *data;
-    uint32_t count;
-    bool use_sync_mode;
-} g_scsi_writereq;
-
-static void init_irqs();
-
-/***********************/
-/* SCSI status signals */
-/***********************/
-
-extern "C" bool scsiStatusATN()
-{
-    return SCSI_IN(ATN);
-}
-
-extern "C" bool scsiStatusBSY()
-{
-    return SCSI_IN(BSY);
-}
-
-/************************/
-/* SCSI selection logic */
-/************************/
-
-volatile uint8_t g_scsi_sts_selection;
-volatile uint8_t g_scsi_ctrl_bsy;
-
-static void scsi_bsy_deassert_interrupt()
-{
-    if (SCSI_IN(SEL) && !SCSI_IN(BSY))
-    {
-        uint8_t sel_bits = SCSI_IN_DATA();
-        int sel_id = -1;
-        for (int i = 0; i < S2S_MAX_TARGETS; i++)
-        {
-            if (scsiDev.targets[i].targetId <= 7 && scsiDev.targets[i].cfg)
-            {
-                if (sel_bits & (1 << scsiDev.targets[i].targetId))
-                {
-                    sel_id = scsiDev.targets[i].targetId;
-                    break;
-                }
-            }
-        }
-
-        if (sel_id >= 0)
-        {
-            uint8_t atn_flag = SCSI_IN(ATN) ? SCSI_STS_SELECTION_ATN : 0;
-            g_scsi_sts_selection = SCSI_STS_SELECTION_SUCCEEDED | atn_flag | sel_id;
-        }
-
-        // selFlag is required for Philips P2000C which releases it after 600ns
-        // without waiting for BSY.
-        // Also required for some early Mac Plus roms
-        scsiDev.selFlag = *SCSI_STS_SELECTED;
-    }
-}
-
-extern "C" bool scsiStatusSEL()
-{
-    if (g_scsi_ctrl_bsy)
-    {
-        // We don't have direct register access to BSY bit like SCSI2SD scsi.c expects.
-        // Instead update the state here.
-        // Releasing happens with bus release.
-        g_scsi_ctrl_bsy = 0;
-        SCSI_OUT(BSY, 1);
-    }
-
-    return SCSI_IN(SEL);
-}
-
-/************************/
-/* SCSI bus reset logic */
-/************************/
-
-static void scsi_rst_assert_interrupt()
-{
-    bool rst1 = SCSI_IN(RST);
-    delay_ns(500);
-    bool rst2 = SCSI_IN(RST);
-
-    if (rst1 && rst2)
-    {
-        bluedbg("BUS RESET");
-        scsiDev.resetFlag = 1;
-    }
-}
-
-static void selectPhyMode()
-{
-    int oldmode = g_scsi_phy_mode;
-
-    int default_mode = PHY_MODE_BEST_AVAILABLE;
-
-    // Read overriding setting from configuration file
-    int wanted_mode = ini_getl("SCSI", "PhyMode", default_mode, CONFIGFILE);
-
-    // Default: software GPIO bitbang, available on all revisions
-    g_scsi_phy_mode = PHY_MODE_PIO;
-
-    // Timer based DMA bitbang, available on V1.1, 2.8 MB/s
-#ifdef SCSI_ACCEL_DMA_AVAILABLE
-    if (wanted_mode == PHY_MODE_BEST_AVAILABLE || wanted_mode == PHY_MODE_DMA_TIMER)
-    {
-        g_scsi_phy_mode = PHY_MODE_DMA_TIMER;
-    }
-#endif
-
-    // GreenPAK with software write, available on V1.1 with extra chip, 3.5 MB/s
-    if (wanted_mode == PHY_MODE_BEST_AVAILABLE || wanted_mode == PHY_MODE_GREENPAK_PIO)
-    {
-        if (greenpak_is_ready())
-        {
-            g_scsi_phy_mode = PHY_MODE_GREENPAK_PIO;
-        }
-    }
-
-    // GreenPAK with DMA write, available on V1.1 with extra chip
-#ifdef SCSI_ACCEL_DMA_AVAILABLE
-    if (wanted_mode == PHY_MODE_BEST_AVAILABLE || wanted_mode == PHY_MODE_GREENPAK_DMA)
-    {
-        if (greenpak_is_ready())
-        {
-            g_scsi_phy_mode = PHY_MODE_GREENPAK_DMA;
-        }
-    }
-#endif
-
-    if (g_scsi_phy_mode != oldmode)
-    {
-        bluelog("SCSI PHY operating mode: ", g_scsi_phy_mode_names[g_scsi_phy_mode]);
-    }
-}
-
-extern "C" void scsiPhyReset(void)
-{
-    SCSI_RELEASE_OUTPUTS();
-    scsi_accel_dma_stopWrite();
-
-    g_scsi_sts_selection = 0;
-    g_scsi_ctrl_bsy = 0;
-    g_scsi_writereq.count = 0;
-    init_irqs();
-
-#ifdef SCSI_SYNC_MODE_AVAILABLE
-    scsi_accel_sync_init();
-#endif
-
-    selectPhyMode();
-
-    if (g_scsi_phy_mode == PHY_MODE_DMA_TIMER)
-    {
-        scsi_accel_timer_dma_init();
-    }
-    else if (g_scsi_phy_mode == PHY_MODE_GREENPAK_DMA)
-    {
-        scsi_accel_greenpak_dma_init();
-    }
-}
-
-/************************/
-/* SCSI bus phase logic */
-/************************/
-
-static SCSI_PHASE g_scsi_phase;
-
-extern "C" void scsiEnterPhase(int phase)
-{
-    int delay = scsiEnterPhaseImmediate(phase);
-    if (delay > 0)
-    {
-        s2s_delay_ns(delay);
-    }
-}
-
-// Change state and return nanosecond delay to wait
-extern "C" uint32_t scsiEnterPhaseImmediate(int phase)
-{
-    if (phase != g_scsi_phase)
-    {
-        // ANSI INCITS 362-2002 SPI-3 10.7.1:
-        // Phase changes are not allowed while REQ or ACK is asserted.
-        while (likely(!scsiDev.resetFlag) && SCSI_IN(ACK)) {}
-
-        if (scsiDev.compatMode < COMPAT_SCSI2 && (phase == DATA_IN || phase == DATA_OUT))
-        {
-            // Akai S1000/S3000 seems to need extra delay before changing to data phase
-            // after a command. The code in BlueSCSI_disk.cpp tries to do this while waiting
-            // for SD card, to avoid any extra latency.
-            s2s_delay_ns(400000);
-        }
-
-        int oldphase = g_scsi_phase;
-        g_scsi_phase = (SCSI_PHASE)phase;
-        scsiLogPhaseChange(phase);
-
-        if (phase < 0)
-        {
-            // Other communication on bus or reset state
-            SCSI_RELEASE_OUTPUTS();
-            return 0;
-        }
-        else
-        {
-            SCSI_OUT(MSG, phase & __scsiphase_msg);
-            SCSI_OUT(CD,  phase & __scsiphase_cd);
-            SCSI_OUT(IO,  phase & __scsiphase_io);
-
-            int delayNs = 400; // Bus settle delay
-            if ((oldphase & __scsiphase_io) != (phase & __scsiphase_io))
-            {
-                delayNs += 400; // Data release delay
-            }
-
-            if (scsiDev.compatMode < COMPAT_SCSI2)
-            {
-                // EMU EMAX needs 100uS ! 10uS is not enough.
-                delayNs += 100000;
-            }
-
-            return delayNs;
-        }
-    }
-    else
-    {
-        return 0;
-    }
-}
-
-// Release all signals
-void scsiEnterBusFree(void)
-{
-    g_scsi_phase = BUS_FREE;
-    g_scsi_sts_selection = 0;
-    g_scsi_ctrl_bsy = 0;
-    scsiDev.cdbLen = 0;
-
-    SCSI_RELEASE_OUTPUTS();
-}
-
-/********************/
-/* Transmit to host */
-/********************/
-
-#define SCSI_WAIT_ACTIVE(pin) \
-  if (!SCSI_IN(pin)) { \
-    if (!SCSI_IN(pin)) { \
-      while(!SCSI_IN(pin) && !scsiDev.resetFlag); \
-    } \
-  }
-
-#define SCSI_WAIT_INACTIVE(pin) \
-  if (SCSI_IN(pin)) { \
-    if (SCSI_IN(pin)) { \
-      while(SCSI_IN(pin) && !scsiDev.resetFlag); \
-    } \
-  }
-
-static inline void scsiWriteOneByte(uint8_t value)
-{
-    SCSI_OUT_DATA(value);
-    delay_100ns(); // DB setup time before REQ
-    SCSI_OUT(REQ, 1);
-    SCSI_WAIT_ACTIVE(ACK);
-    SCSI_RELEASE_DATA_REQ(); // Release data and REQ
-    SCSI_WAIT_INACTIVE(ACK);
-}
-
-extern "C" void scsiWriteByte(uint8_t value)
-{
-    scsiLogDataIn(&value, 1);
-    scsiWriteOneByte(value);
-}
-
-extern "C" void scsiWrite(const uint8_t* data, uint32_t count)
-{
-    scsiStartWrite(data, count);
-    scsiFinishWrite();
-}
-
-extern "C" void scsiStartWrite(const uint8_t* data, uint32_t count)
-{
-    scsiLogDataIn(data, count);
-
-    g_scsi_writereq.use_sync_mode = (g_scsi_phase == DATA_IN && scsiDev.target->syncOffset > 0);
-
-    if (g_scsi_phy_mode == PHY_MODE_PIO
-        || g_scsi_phy_mode == PHY_MODE_GREENPAK_PIO
-        || g_scsi_writereq.use_sync_mode)
-    {
-        // Software based bit-banging.
-        // Write requests are queued and then executed in isWriteFinished() callback.
-        // This allows better parallelism with SD card transfers.
-
-        if (g_scsi_writereq.count)
-        {
-            if (data == g_scsi_writereq.data + g_scsi_writereq.count)
-            {
-                // Combine with previous one
-                g_scsi_writereq.count += count;
-                return;
-            }
-            else
-            {
-                // Actually execute previous request
-                scsiFinishWrite();
-            }
-        }
-
-        g_scsi_writereq.data = data;
-        g_scsi_writereq.count = count;
-    }
-    else if (g_scsi_phy_mode == PHY_MODE_DMA_TIMER || g_scsi_phy_mode == PHY_MODE_GREENPAK_DMA)
-    {
-        // Accelerated writes using DMA and timers
-        scsi_accel_dma_startWrite(data, count, &scsiDev.resetFlag);
-    }
-    else
-    {
-        bluelog("Unknown SCSI PHY mode: ", (int)g_scsi_phy_mode);
-    }
-}
-
-static void processPollingWrite(uint32_t count)
-{
-    if (count > g_scsi_writereq.count)
-        count = g_scsi_writereq.count;
-
-    const uint8_t *data = g_scsi_writereq.data;
-    uint32_t count_words = count / 4;
-
-    if (g_scsi_writereq.use_sync_mode)
-    {
-        // Synchronous mode transfer
-        scsi_accel_sync_send(data, count, &scsiDev.resetFlag);
-    }
-    else if (count_words * 4 == count)
-    {
-        if (g_scsi_phy_mode == PHY_MODE_GREENPAK_PIO)
-        {
-            // GreenPAK PIO accelerated asynchronous transfer
-            scsi_accel_greenpak_send((const uint32_t*)data, count_words, &scsiDev.resetFlag);
-        }
-        else
-        {
-            // Assembler optimized asynchronous transfer
-            scsi_accel_asm_send((const uint32_t*)data, count_words, &scsiDev.resetFlag);
-        }
-    }
-    else
-    {
-        // Use simple loop for unaligned transfers
-        for (uint32_t i = 0; i < count; i++)
-        {
-            if (scsiDev.resetFlag) break;
-            scsiWriteOneByte(data[i]);
-        }
-    }
-
-    g_scsi_writereq.count -= count;
-    if (g_scsi_writereq.count)
-    {
-        g_scsi_writereq.data += count;
-    }
-    else
-    {
-        g_scsi_writereq.data = NULL;
-    }
-}
-
-static bool isPollingWriteFinished(const uint8_t *data)
-{
-    if (g_scsi_writereq.count)
-    {
-        if (data == NULL)
-        {
-            return false;
-        }
-        else if (data >= g_scsi_writereq.data &&
-            data < g_scsi_writereq.data + g_scsi_writereq.count)
-        {
-            return false;
-        }
-    }
-    return true;
-}
-
-extern "C" bool scsiIsWriteFinished(const uint8_t *data)
-{
-    // Check if there is still a polling transfer in progress
-    if (!isPollingWriteFinished(data) && !check_sd_read_done())
-    {
-        // Process the transfer piece-by-piece while waiting
-        // for SD card to react.
-        int max_count = g_scsi_writereq.count / 8;
-
-        // Always transfer whole sectors without pause to avoid problems with some SCSI hosts.
-        int bytesPerSector = 512;
-        if (scsiDev.target)
-        {
-            bytesPerSector = scsiDev.target->liveCfg.bytesPerSector;
-        }
-        if (max_count % bytesPerSector != 0) max_count -= (max_count % bytesPerSector);
-        if (max_count < bytesPerSector) max_count = bytesPerSector;
-
-        // Avoid SysTick interrupt pauses during the transfer
-        SysTick_Handle_PreEmptively();
-
-        processPollingWrite(max_count);
-        return isPollingWriteFinished(data);
-    }
-
-    if (g_scsi_phy_mode == PHY_MODE_DMA_TIMER || g_scsi_phy_mode == PHY_MODE_GREENPAK_DMA)
-    {
-        return scsi_accel_dma_isWriteFinished(data);
-    }
-    else
-    {
-        return true;
-    }
-}
-
-extern "C" void scsiFinishWrite()
-{
-    if (g_scsi_writereq.count)
-    {
-        // Finish previously started polling write request.
-        processPollingWrite(g_scsi_writereq.count);
-    }
-
-    if (g_scsi_phy_mode == PHY_MODE_DMA_TIMER || g_scsi_phy_mode == PHY_MODE_GREENPAK_DMA)
-    {
-        scsi_accel_dma_finishWrite(&scsiDev.resetFlag);
-    }
-}
-
-/*********************/
-/* Receive from host */
-/*********************/
-
-static inline uint8_t scsiReadOneByte(void)
-{
-    SCSI_OUT(REQ, 1);
-    SCSI_WAIT_ACTIVE(ACK);
-    delay_100ns();
-    uint8_t r = SCSI_IN_DATA();
-    SCSI_OUT(REQ, 0);
-    SCSI_WAIT_INACTIVE(ACK);
-
-    return r;
-}
-
-extern "C" uint8_t scsiReadByte(void)
-{
-    uint8_t r = scsiReadOneByte();
-    scsiLogDataOut(&r, 1);
-    return r;
-}
-
-extern "C" void scsiRead(uint8_t* data, uint32_t count, int* parityError)
-{
-    *parityError = 0;
-
-    uint32_t count_words = count / 4;
-    bool use_greenpak = (g_scsi_phy_mode == PHY_MODE_GREENPAK_DMA || g_scsi_phy_mode == PHY_MODE_GREENPAK_PIO);
-
-    SysTick_Handle_PreEmptively();
-
-    if (g_scsi_phase == DATA_OUT && scsiDev.target->syncOffset > 0)
-    {
-        // Synchronous data transfer
-        scsi_accel_sync_recv(data, count, parityError, &scsiDev.resetFlag);
-    }
-    else if (count_words * 4 == count && count_words >= 2 && use_greenpak)
-    {
-        // GreenPAK accelerated receive can handle a multiple of 4 bytes with minimum of 8 bytes.
-        scsi_accel_greenpak_recv((uint32_t*)data, count_words, &scsiDev.resetFlag);
-    }
-    else if (count_words * 4 == count && count_words >= 1)
-    {
-        // Optimized ASM subroutine can handle multiple of 4 bytes with minimum of 4 bytes.
-        scsi_accel_asm_recv((uint32_t*)data, count_words, &scsiDev.resetFlag);
-    }
-    else
-    {
-        // Use a simple loop for short and unaligned transfers
-        for (uint32_t i = 0; i < count; i++)
-        {
-            if (scsiDev.resetFlag) break;
-
-            data[i] = scsiReadOneByte();
-        }
-    }
-
-    scsiLogDataOut(data, count);
-}
-
-/**********************/
-/* Interrupt handlers */
-/**********************/
-
-extern "C"
-void SCSI_RST_IRQ (void)
-{
-    if (exti_interrupt_flag_get(SCSI_RST_EXTI))
-    {
-        exti_interrupt_flag_clear(SCSI_RST_EXTI);
-        scsi_rst_assert_interrupt();
-    }
-
-    if (exti_interrupt_flag_get(SCSI_BSY_EXTI))
-    {
-        exti_interrupt_flag_clear(SCSI_BSY_EXTI);
-        scsi_bsy_deassert_interrupt();
-    }
-
-    if (exti_interrupt_flag_get(SCSI_SEL_EXTI))
-    {
-        // Check BSY line status when SEL goes active.
-        // This is needed to handle SCSI-1 hosts that use the single initiator mode.
-        // The host will just assert the SEL directly, without asserting BSY first.
-        exti_interrupt_flag_clear(SCSI_SEL_EXTI);
-        scsi_bsy_deassert_interrupt();
-    }
-}
-
-#if SCSI_RST_IRQn != SCSI_BSY_IRQn
-extern "C"
-void SCSI_BSY_IRQ (void)
-{
-    SCSI_RST_IRQ();
-}
-#endif
-
-#if (SCSI_SEL_IRQn != SCSI_RST_IRQn) && (SCSI_SEL_IRQn != SCSI_BSY_IRQn)
-extern "C"
-void SCSI_SEL_IRQ (void)
-{
-    SCSI_RST_IRQ();
-}
-#endif
-
-static void init_irqs()
-{
-    // Falling edge of RST pin
-    gpio_exti_source_select(SCSI_RST_EXTI_SOURCE_PORT, SCSI_RST_EXTI_SOURCE_PIN);
-    exti_init(SCSI_RST_EXTI, EXTI_INTERRUPT, EXTI_TRIG_FALLING);
-    NVIC_SetPriority(SCSI_RST_IRQn, 1);
-    NVIC_EnableIRQ(SCSI_RST_IRQn);
-
-    // Rising edge of BSY pin
-    gpio_exti_source_select(SCSI_BSY_EXTI_SOURCE_PORT, SCSI_BSY_EXTI_SOURCE_PIN);
-    exti_init(SCSI_BSY_EXTI, EXTI_INTERRUPT, EXTI_TRIG_RISING);
-    NVIC_SetPriority(SCSI_BSY_IRQn, 1);
-    NVIC_EnableIRQ(SCSI_BSY_IRQn);
-
-    // Falling edge of SEL pin
-    gpio_exti_source_select(SCSI_SEL_EXTI_SOURCE_PORT, SCSI_SEL_EXTI_SOURCE_PIN);
-    exti_init(SCSI_SEL_EXTI, EXTI_INTERRUPT, EXTI_TRIG_FALLING);
-    NVIC_SetPriority(SCSI_SEL_IRQn, 1);
-    NVIC_EnableIRQ(SCSI_SEL_IRQn);
-}
-
-

lib/BlueSCSI_platform_GD32F205/scsiPhy.h

@@ -1,67 +0,0 @@
-// Interface to SCSI physical interface.
-// This file is derived from scsiPhy.h in SCSI2SD-V6.
-
-#pragma once
-
-#include <stdint.h>
-#include <stdbool.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-// Read SCSI status signals
-bool scsiStatusATN();
-bool scsiStatusBSY();
-bool scsiStatusSEL();
-
-// Parity not yet implemented
-#define scsiParityError() 0
-
-// Get SCSI selection status.
-// This is latched by interrupt when BSY is deasserted while SEL is asserted.
-// Lowest 3 bits are the selected target id.
-// Highest bits are status information.
-#define SCSI_STS_SELECTION_SUCCEEDED 0x40
-#define SCSI_STS_SELECTION_ATN 0x80
-extern volatile uint8_t g_scsi_sts_selection;
-#define SCSI_STS_SELECTED (&g_scsi_sts_selection)
-extern volatile uint8_t g_scsi_ctrl_bsy;
-#define SCSI_CTRL_BSY (&g_scsi_ctrl_bsy)
-
-// Called when SCSI RST signal has been asserted, should release bus.
-void scsiPhyReset(void);
-
-// Change MSG / CD / IO signal states and wait for necessary transition time.
-// Phase argument is one of SCSI_PHASE enum values.
-void scsiEnterPhase(int phase);
-
-// Change state and return nanosecond delay to wait
-uint32_t scsiEnterPhaseImmediate(int phase);
-
-// Release all signals
-void scsiEnterBusFree(void);
-
-// Blocking data transfer
-void scsiWrite(const uint8_t* data, uint32_t count);
-void scsiRead(uint8_t* data, uint32_t count, int* parityError);
-void scsiWriteByte(uint8_t value);
-uint8_t scsiReadByte(void);
-
-// Non-blocking data transfer.
-// Depending on platform support the start() function may block.
-// The start function can be called multiple times, it may internally
-// either combine transfers or block until previous transfer completes.
-void scsiStartWrite(const uint8_t* data, uint32_t count);
-void scsiFinishWrite();
-
-// Query whether the data at pointer has already been read, i.e. buffer can be reused.
-// If data is NULL, checks if all writes have completed.
-bool scsiIsWriteFinished(const uint8_t *data);
-
-
-#define s2s_getScsiRateKBs() 0
-
-#ifdef __cplusplus
-}
-#endif

lib/BlueSCSI_platform_GD32F205/scsi_accel_asm.cpp

@@ -1,152 +0,0 @@
-#include "scsi_accel_asm.h"
-#include "BlueSCSI_platform.h"
-
-// Optimized ASM blocks for the SCSI communication subroutine
-
-// Take 8 bits from d and format them for writing
-// d is name of data operand, b is bit offset, x is unique label
-#define ASM_LOAD_DATA(d, b, x) \
-"    load_data1_" x "_%=: \n" \
-"        ubfx    %[tmp1], %[" d "], #" b ", #8 \n" \
-"        ldr     %[tmp1], [%[byte_lookup], %[tmp1], lsl #2] \n"
-
-// Write data to SCSI port and set REQ high
-#define ASM_SEND_DATA(x) \
-"    send_data" x "_%=: \n" \
-"        str     %[tmp1], [%[out_port_bop]] \n"
-
-// Read data from SCSI port, set REQ high, store data to d at bit offset b
-#define ASM_RECV_DATA(d, b, x) \
-"    recv_data" x "_%=: \n" \
-"        ldr     %[tmp1], [%[in_port_istat]] \n" \
-"        mov     %[tmp2], %[req_high_bop] \n" \
-"        str     %[tmp2], [%[out_port_bop]] \n" \
-"        ubfx    %[tmp1], %[tmp1], %[data_in_shift], #8 \n" \
-"        bfi     %[" d "], %[tmp1], #" b ", #8 \n"
-
-// Wait for ACK to be high, set REQ low, wait ACK low
-#define ASM_HANDSHAKE(x) \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        str     %[tmp2], [%[req_pin_bb]] \n" \
-"        cbnz    %[tmp2], req_is_low_now" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        str     %[tmp2], [%[req_pin_bb]] \n" \
-"        cbnz    %[tmp2], req_is_low_now" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        str     %[tmp2], [%[req_pin_bb]] \n" \
-"        cbnz    %[tmp2], req_is_low_now" x "_%= \n" \
-"    wait_ack_inactive" x "_%=: \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        str     %[tmp2], [%[req_pin_bb]] \n" \
-"        cbnz    %[tmp2], req_is_low_now" x "_%= \n" \
-"        ldr     %[tmp2], [%[reset_flag]] \n" \
-"        cbnz    %[tmp2], req_is_low_now" x "_%= \n" \
-"        b.n     wait_ack_inactive" x "_%= \n" \
-"    req_is_low_now" x "_%=: \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], over_ack_active" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], over_ack_active" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], over_ack_active" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], over_ack_active" x "_%= \n" \
-"    wait_ack_active" x "_%=: \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], over_ack_active" x "_%= \n" \
-"        ldr     %[tmp2], [%[reset_flag]] \n" \
-"        cbnz    %[tmp2], over_ack_active" x "_%= \n" \
-"        b.n     wait_ack_active" x "_%= \n" \
-"    over_ack_active" x "_%=: \n" \
-
-// Send bytes to SCSI bus using the asynchronous handshake mechanism
-// Takes 4 bytes at a time for sending from buf.
-void scsi_accel_asm_send(const uint32_t *buf, uint32_t num_words, volatile int *resetFlag)
-{
-    volatile uint32_t *out_port_bop = (volatile uint32_t*)&GPIO_BOP(SCSI_OUT_PORT);
-    const uint32_t *byte_lookup = g_scsi_out_byte_to_bop;
-    uint32_t ack_pin_bb = PERIPH_BB_BASE + (((uint32_t)&GPIO_ISTAT(SCSI_ACK_PORT)) - APB1_BUS_BASE) * 32 + SCSI_IN_ACK_IDX * 4;
-    uint32_t req_pin_bb = PERIPH_BB_BASE + (((uint32_t)out_port_bop) - APB1_BUS_BASE) * 32 + (SCSI_OUT_REQ_IDX + 16) * 4;
-    register uint32_t tmp1 = 0;
-    register uint32_t tmp2 = 0;
-    register uint32_t data = 0;
-
-    asm volatile (
-    "   ldr      %[data], [%[buf]], #4 \n" \
-        ASM_LOAD_DATA("data", "0", "first")
-
-    "inner_loop_%=: \n" \
-        ASM_SEND_DATA("0")
-        ASM_LOAD_DATA("data", "8", "8")
-        ASM_HANDSHAKE("0")
-
-        ASM_SEND_DATA("8")
-        ASM_LOAD_DATA("data", "16", "16")
-        ASM_HANDSHAKE("8")
-
-        ASM_SEND_DATA("16")
-        ASM_LOAD_DATA("data", "24", "24")
-        ASM_HANDSHAKE("16")
-
-        ASM_SEND_DATA("24")
-    "   ldr      %[data], [%[buf]], #4 \n" \
-        ASM_LOAD_DATA("data", "0", "0")
-        ASM_HANDSHAKE("24")
-
-    "   subs     %[num_words], %[num_words], #1 \n" \
-    "   bne     inner_loop_%= \n"
-    : /* Output */ [tmp1] "+l" (tmp1), [tmp2] "+l" (tmp2), [data] "+r" (data),
-                   [buf] "+r" (buf), [num_words] "+r" (num_words)
-    : /* Input */ [ack_pin_bb] "r" (ack_pin_bb),
-                  [req_pin_bb] "r" (req_pin_bb),
-                  [out_port_bop] "r"(out_port_bop),
-                  [byte_lookup] "r" (byte_lookup),
-                  [reset_flag] "r" (resetFlag)
-    : /* Clobber */ );
-
-    SCSI_RELEASE_DATA_REQ();
-}
-
-// Read bytes from SCSI bus using asynchronous handshake mechanism
-// Takes 4 bytes at a time.
-void scsi_accel_asm_recv(uint32_t *buf, uint32_t num_words, volatile int *resetFlag)
-{
-    volatile uint32_t *out_port_bop = (volatile uint32_t*)&GPIO_BOP(SCSI_OUT_PORT);
-    volatile uint32_t *in_port_istat = (volatile uint32_t*)&GPIO_ISTAT(SCSI_IN_PORT);
-    uint32_t ack_pin_bb = PERIPH_BB_BASE + (((uint32_t)&GPIO_ISTAT(SCSI_ACK_PORT)) - APB1_BUS_BASE) * 32 + SCSI_IN_ACK_IDX * 4;
-    uint32_t req_pin_bb = PERIPH_BB_BASE + (((uint32_t)out_port_bop) - APB1_BUS_BASE) * 32 + (SCSI_OUT_REQ_IDX + 16) * 4;
-    register uint32_t tmp1 = 0;
-    register uint32_t tmp2 = 0;
-    register uint32_t data = 0;
-
-    asm volatile (
-    "inner_loop_%=: \n" \
-        ASM_HANDSHAKE("0")
-        ASM_RECV_DATA("data", "0", "0")
-
-        ASM_HANDSHAKE("8")
-        ASM_RECV_DATA("data", "8", "8")
-
-        ASM_HANDSHAKE("16")
-        ASM_RECV_DATA("data", "16", "16")
-
-        ASM_HANDSHAKE("24")
-        ASM_RECV_DATA("data", "24", "24")
-
-    "   mvn      %[data], %[data] \n" \
-    "   str      %[data], [%[buf]], #4 \n" \
-    "   subs     %[num_words], %[num_words], #1 \n" \
-    "   bne     inner_loop_%= \n"
-    : /* Output */ [tmp1] "+l" (tmp1), [tmp2] "+l" (tmp2), [data] "+r" (data),
-                   [buf] "+r" (buf), [num_words] "+r" (num_words)
-    : /* Input */ [ack_pin_bb] "r" (ack_pin_bb),
-                  [req_pin_bb] "r" (req_pin_bb),
-                  [out_port_bop] "r"(out_port_bop),
-                  [in_port_istat] "r" (in_port_istat),
-                  [reset_flag] "r" (resetFlag),
-                  [data_in_shift] "I" (SCSI_IN_SHIFT),
-                  [req_high_bop] "I" (SCSI_OUT_REQ)
-    : /* Clobber */ );
-
-    SCSI_RELEASE_DATA_REQ();
-}

lib/BlueSCSI_platform_GD32F205/scsi_accel_asm.h

@@ -1,8 +0,0 @@
-// SCSI subroutines using hand-optimized assembler
-
-#pragma once
-
-#include <stdint.h>
-
-void scsi_accel_asm_send(const uint32_t *buf, uint32_t num_words, volatile int *resetFlag);
-void scsi_accel_asm_recv(uint32_t *buf, uint32_t num_words, volatile int *resetFlag);

lib/BlueSCSI_platform_GD32F205/scsi_accel_dma.cpp

@@ -1,659 +0,0 @@
-#include "scsi_accel_dma.h"
-#include <BlueSCSI_log.h>
-#include <gd32f20x_timer.h>
-#include <gd32f20x_rcu.h>
-#include <assert.h>
-#include <string.h>
-
-#ifndef SCSI_ACCEL_DMA_AVAILABLE
-
-void scsi_accel_timer_dma_init() {}
-void scsi_accel_greenpak_dma_init() {}
-void scsi_accel_dma_startWrite(const uint8_t* data, uint32_t count, volatile int *resetFlag) {}
-void scsi_accel_dma_stopWrite() {}
-void scsi_accel_dma_finishWrite(volatile int *resetFlag) {}
-bool scsi_accel_dma_isWriteFinished(const uint8_t* data) { return true; }
-
-
-#else
-
-static void greenpak_refill_dmabuf();
-static void greenpak_start_dma();
-static void greenpak_stop_dma();
-
-enum greenpak_state_t { GREENPAK_IO1_LOW = 0, GREENPAK_IO1_HIGH, GREENPAK_STOP};
-
-#define DMA_BUF_SIZE 256
-#define DMA_BUF_MASK (DMA_BUF_SIZE - 1)
-static struct {
-    uint8_t *app_buf; // Buffer provided by application
-    uint32_t dma_buf[DMA_BUF_SIZE]; // Buffer of data formatted for GPIO BOP register
-    uint32_t dma_idx; // Write index to DMA buffer
-    uint32_t dma_fillto; // Point up to which DMA buffer is available for refilling
-    uint32_t timer_buf; // Control value for timer SWEVG register
-    uint32_t bytes_app; // Bytes available in application buffer
-    uint32_t bytes_dma; // Bytes (words) written so far to DMA buffer
-    uint32_t scheduled_dma; // Bytes (words) that DMA data count was last set to
-    greenpak_state_t greenpak_state; // Toggle signal state for greenpak
-
-    uint8_t *next_app_buf; // Next buffer from application after current one finishes
-    uint32_t next_app_bytes; // Bytes in next buffer
-} g_scsi_dma;
-
-enum scsidma_state_t { SCSIDMA_IDLE = 0, SCSIDMA_WRITE };
-static volatile scsidma_state_t g_scsi_dma_state;
-static bool g_scsi_dma_use_greenpak;
-
-void scsi_accel_timer_dma_init()
-{
-    g_scsi_dma_state = SCSIDMA_IDLE;
-    g_scsi_dma_use_greenpak = false;
-    rcu_periph_clock_enable(SCSI_TIMER_RCU);
-    rcu_periph_clock_enable(SCSI_TIMER_DMA_RCU);
-
-    // DMA Channel A: data copy
-    // GPIO DMA copies data from memory buffer to GPIO BOP register.
-    // The memory buffer is filled by interrupt routine.
-    dma_parameter_struct gpio_dma_config =
-    {
-        .periph_addr = (uint32_t)&GPIO_BOP(SCSI_OUT_PORT),
-        .periph_width = DMA_PERIPHERAL_WIDTH_32BIT,
-        .memory_addr = 0, // Filled before transfer
-        .memory_width = DMA_MEMORY_WIDTH_32BIT,
-        .number = DMA_BUF_SIZE,
-        .priority = DMA_PRIORITY_ULTRA_HIGH,
-        .periph_inc = DMA_PERIPH_INCREASE_DISABLE,
-        .memory_inc = DMA_MEMORY_INCREASE_ENABLE,
-        .direction = DMA_MEMORY_TO_PERIPHERAL
-    };
-    dma_init(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA, &gpio_dma_config);
-    dma_circulation_enable(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA);
-    NVIC_SetPriority(SCSI_TIMER_DMACHA_IRQn, 1);
-    NVIC_EnableIRQ(SCSI_TIMER_DMACHA_IRQn);
-
-    // DMA Channel B: timer update
-    // Timer DMA causes update event to restart timer after
-    // GPIO DMA operation is done.
-    dma_parameter_struct timer_dma_config =
-    {
-        .periph_addr = (uint32_t)&TIMER_SWEVG(SCSI_TIMER),
-        .periph_width = DMA_PERIPHERAL_WIDTH_32BIT,
-        .memory_addr = (uint32_t)&g_scsi_dma.timer_buf,
-        .memory_width = DMA_MEMORY_WIDTH_32BIT,
-        .number = DMA_BUF_SIZE,
-        .priority = DMA_PRIORITY_HIGH,
-        .periph_inc = DMA_PERIPH_INCREASE_DISABLE,
-        .memory_inc = DMA_PERIPH_INCREASE_DISABLE,
-        .direction = DMA_MEMORY_TO_PERIPHERAL
-    };
-    dma_init(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB, &timer_dma_config);
-    NVIC_SetPriority(SCSI_TIMER_DMACHB_IRQn, 2);
-    NVIC_EnableIRQ(SCSI_TIMER_DMACHB_IRQn);
-
-    g_scsi_dma.timer_buf = TIMER_SWEVG_UPG;
-
-    // Timer is used to toggle the request signal based on external trigger input.
-    // OUT_REQ is driven by timer output.
-    // 1. On timer update event, REQ is set low.
-    // 2. When ACK goes low, timer counts and OUT_REQ is set high.
-    //    Simultaneously a DMA request is triggered to write next data to GPIO.
-    // 3. When ACK goes high, a DMA request is triggered to cause timer update event.
-    //    The DMA request priority is set so that 2. always completes before it.
-    TIMER_CTL0(SCSI_TIMER) = 0;
-    TIMER_SMCFG(SCSI_TIMER) = TIMER_SLAVE_MODE_EXTERNAL0 | TIMER_SMCFG_TRGSEL_CI0F_ED;
-    TIMER_CAR(SCSI_TIMER) = 65535;
-    TIMER_PSC(SCSI_TIMER) = 0;
-    TIMER_DMAINTEN(SCSI_TIMER) = 0;
-    TIMER_CHCTL0(SCSI_TIMER) = 0x6001; // CH0 as input, CH1 as DMA trigger
-    TIMER_CHCTL1(SCSI_TIMER) = 0x6074; // CH2 as fast PWM output, CH3 as DMA trigger
-    TIMER_CHCTL2(SCSI_TIMER) = TIMER_CHCTL2_CH2NEN;
-    TIMER_CCHP(SCSI_TIMER) = TIMER_CCHP_POEN;
-    TIMER_CH1CV(SCSI_TIMER) = 1; // Copy data when ACK goes low
-    TIMER_CH2CV(SCSI_TIMER) = 1; // REQ is low until ACK goes low
-    TIMER_CH3CV(SCSI_TIMER) = 2; // Reset timer after ACK goes high & previous DMA is complete
-    gpio_init(SCSI_TIMER_IN_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_TIMER_IN_PIN);
-
-    scsi_accel_dma_stopWrite();
-}
-
-// Select whether OUT_REQ is connected to timer or GPIO port
-static void scsi_dma_gpio_config(bool enable)
-{
-    if (enable)
-    {
-        gpio_init(SCSI_OUT_PORT, GPIO_MODE_IPU, GPIO_OSPEED_50MHZ, SCSI_OUT_REQ);
-
-        if (g_scsi_dma_use_greenpak)
-        {
-            GPIO_BC(SCSI_OUT_PORT) = GREENPAK_PLD_IO1;
-            GPIO_BOP(SCSI_OUT_PORT) = GREENPAK_PLD_IO2;
-        }
-        else
-        {
-            gpio_init(SCSI_TIMER_OUT_PORT, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, SCSI_TIMER_OUT_PIN);
-        }
-    }
-    else
-    {
-        GPIO_BC(SCSI_OUT_PORT) = GREENPAK_PLD_IO2;
-        gpio_init(SCSI_TIMER_OUT_PORT, GPIO_MODE_IN_FLOATING, GPIO_OSPEED_50MHZ, SCSI_TIMER_OUT_PIN);
-        gpio_init(SCSI_OUT_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_REQ);
-    }
-}
-
-// Convert input bytes into BOP values in the DMA buffer
-static void refill_dmabuf()
-{
-    if (g_scsi_dma_use_greenpak)
-    {
-        greenpak_refill_dmabuf();
-        return;
-    }
-
-    // Check how many bytes we have available from the application
-    uint32_t count = g_scsi_dma.bytes_app - g_scsi_dma.bytes_dma;
-
-    // Check amount of free space in DMA buffer
-    uint32_t max = g_scsi_dma.dma_fillto - g_scsi_dma.dma_idx;
-    if (count > max) count = max;
-    if (count == 0) return;
-
-    uint8_t *src = g_scsi_dma.app_buf + g_scsi_dma.bytes_dma;
-    uint32_t *dst = g_scsi_dma.dma_buf;
-    uint32_t pos = g_scsi_dma.dma_idx;
-    uint32_t end = pos + count;
-    g_scsi_dma.dma_idx = end;
-    g_scsi_dma.bytes_dma += count;
-
-    while (pos + 4 <= end)
-    {
-        uint32_t input = *(uint32_t*)src;
-        src += 4;
-
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop[(input >> 0) & 0xFF];
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop[(input >> 8) & 0xFF];
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop[(input >> 16) & 0xFF];
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop[(input >> 24) & 0xFF];
-    }
-
-    while (pos < end)
-    {
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop[*src++];
-    }
-
-    if (end < g_scsi_dma.dma_fillto)
-    {
-        // Partial buffer fill, this will get refilled from interrupt if we
-        // get more data. Set next byte to an invalid parity value so that
-        // any race conditions will get caught as parity error.
-        dst[pos & DMA_BUF_MASK] = g_scsi_out_byte_to_bop[0] ^ SCSI_OUT_DBP;
-    }
-}
-
-// Start DMA transfer
-static void start_dma()
-{
-    if (g_scsi_dma_use_greenpak)
-    {
-        greenpak_start_dma();
-        return;
-    }
-
-    // Disable channels while configuring
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) &= ~DMA_CHXCTL_CHEN;
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) &= ~DMA_CHXCTL_CHEN;
-    TIMER_CTL0(SCSI_TIMER) = 0;
-
-    // Set new buffer address and size
-    // CHA / Data channel is in circular mode and always has DMA_BUF_SIZE buffer size.
-    // CHB / Update channel limits the number of data.
-    DMA_CHMADDR(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) = (uint32_t)g_scsi_dma.dma_buf;
-    DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) = DMA_BUF_SIZE;
-    uint32_t dma_to_schedule = g_scsi_dma.bytes_app - g_scsi_dma.scheduled_dma;
-    DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) = dma_to_schedule;
-    g_scsi_dma.scheduled_dma += dma_to_schedule;
-
-    // Clear pending DMA events
-    TIMER_DMAINTEN(SCSI_TIMER) = 0;
-    TIMER_DMAINTEN(SCSI_TIMER) = TIMER_DMAINTEN_CH1DEN | TIMER_DMAINTEN_CH3DEN;
-
-    // Clear and enable interrupt
-    DMA_INTC(SCSI_TIMER_DMA) = DMA_FLAG_ADD(DMA_FLAG_HTF | DMA_FLAG_FTF | DMA_FLAG_ERR, SCSI_TIMER_DMACHA);
-    DMA_INTC(SCSI_TIMER_DMA) = DMA_FLAG_ADD(DMA_FLAG_HTF | DMA_FLAG_FTF | DMA_FLAG_ERR, SCSI_TIMER_DMACHB);
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) |= DMA_CHXCTL_FTFIE | DMA_CHXCTL_HTFIE;
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) |= DMA_CHXCTL_FTFIE;
-
-    // Enable channels
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) |= DMA_CHXCTL_CHEN;
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) |= DMA_CHXCTL_CHEN;
-
-    // Make sure REQ is initially high
-    TIMER_CNT(SCSI_TIMER) = 16;
-    TIMER_CHCTL1(SCSI_TIMER) = 0x6050;
-    TIMER_CHCTL1(SCSI_TIMER) = 0x6074;
-
-    // Enable timer
-    TIMER_CTL0(SCSI_TIMER) |= TIMER_CTL0_CEN;
-
-    // Generate first events
-    TIMER_SWEVG(SCSI_TIMER) = TIMER_SWEVG_CH1G;
-    TIMER_SWEVG(SCSI_TIMER) = TIMER_SWEVG_CH3G;
-}
-
-// Stop DMA transfer
-static void stop_dma()
-{
-    greenpak_stop_dma();
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) &= ~DMA_CHXCTL_CHEN;
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) &= ~DMA_CHXCTL_CHEN;
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) &= ~(DMA_CHXCTL_FTFIE | DMA_CHXCTL_HTFIE);
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) &= ~DMA_CHXCTL_FTFIE;
-    TIMER_CTL0(SCSI_TIMER) &= ~TIMER_CTL0_CEN;
-    g_scsi_dma_state = SCSIDMA_IDLE;
-    SCSI_RELEASE_DATA_REQ();
-}
-
-static void check_dma_next_buffer()
-{
-    // Check if we are at the end of the application buffer
-    if (g_scsi_dma.next_app_buf && g_scsi_dma.bytes_dma == g_scsi_dma.bytes_app)
-    {
-        // Switch to next buffer
-        assert(g_scsi_dma.scheduled_dma == g_scsi_dma.bytes_app);
-        g_scsi_dma.app_buf = g_scsi_dma.next_app_buf;
-        g_scsi_dma.bytes_app = g_scsi_dma.next_app_bytes;
-        g_scsi_dma.bytes_dma = 0;
-        g_scsi_dma.scheduled_dma = 0;
-        g_scsi_dma.next_app_buf = 0;
-        g_scsi_dma.next_app_bytes = 0;
-        refill_dmabuf();
-    }
-}
-
-// Convert new data from application buffer to DMA buffer
-extern "C" void SCSI_TIMER_DMACHA_IRQ()
-{
-    // bluedbg("DMA irq A, counts: ", DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA), " ",
-    //             DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB), " ",
-    //             TIMER_CNT(SCSI_TIMER));
-
-    uint32_t intf = DMA_INTF(SCSI_TIMER_DMA);
-    const uint32_t half_flag = DMA_FLAG_ADD(DMA_FLAG_HTF, SCSI_TIMER_DMACHA);
-    const uint32_t full_flag = DMA_FLAG_ADD(DMA_FLAG_FTF, SCSI_TIMER_DMACHA);
-    if (intf & half_flag)
-    {
-        if (intf & full_flag)
-        {
-            bluelog("ERROR: SCSI DMA overrun: ", intf,
-               " bytes_app: ", g_scsi_dma.bytes_app,
-               " bytes_dma: ", g_scsi_dma.bytes_dma,
-               " dma_idx: ", g_scsi_dma.dma_idx,
-               " sched_dma: ", g_scsi_dma.scheduled_dma);
-            stop_dma();
-            return;
-        }
-
-        DMA_INTC(SCSI_TIMER_DMA) = DMA_FLAG_ADD(DMA_FLAG_HTF, SCSI_TIMER_DMACHA);
-        g_scsi_dma.dma_fillto += DMA_BUF_SIZE / 2;
-    }
-    else if (intf & full_flag)
-    {
-        DMA_INTC(SCSI_TIMER_DMA) = DMA_FLAG_ADD(DMA_FLAG_FTF, SCSI_TIMER_DMACHA);
-        g_scsi_dma.dma_fillto += DMA_BUF_SIZE / 2;
-    }
-
-    // Fill DMA buffer with data from current application buffer
-    refill_dmabuf();
-
-    check_dma_next_buffer();
-}
-
-// Check if enough data is available to continue DMA transfer
-extern "C" void SCSI_TIMER_DMACHB_IRQ()
-{
-    // bluedbg("DMA irq B, counts: ", DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA), " ",
-    //             DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB), " ",
-    //             TIMER_CNT(SCSI_TIMER));
-    uint32_t intf = DMA_INTF(SCSI_TIMER_DMA);
-    if (intf & DMA_FLAG_ADD(DMA_FLAG_FTF, SCSI_TIMER_DMACHB))
-    {
-        DMA_INTC(SCSI_TIMER_DMA) = DMA_FLAG_ADD(DMA_FLAG_FTF, SCSI_TIMER_DMACHB);
-
-        if (g_scsi_dma.bytes_app > g_scsi_dma.scheduled_dma)
-        {
-            if (g_scsi_dma.dma_idx < g_scsi_dma.dma_fillto)
-            {
-                // Previous request didn't have a complete buffer worth of data.
-                // Refill the buffer and ensure that the first byte of the new data gets
-                // written to outputs.
-                __disable_irq();
-                refill_dmabuf();
-                __enable_irq();
-            }
-
-            // Verify the first byte of the new data has been written to outputs
-            // It may have been updated after the DMA write occurred.
-            __disable_irq();
-            uint32_t first_data_idx = g_scsi_dma.dma_idx - (g_scsi_dma.bytes_dma - g_scsi_dma.scheduled_dma);
-            uint32_t first_data = g_scsi_dma.dma_buf[first_data_idx & DMA_BUF_MASK];
-            GPIO_BOP(SCSI_OUT_PORT) = first_data;
-            __enable_irq();
-
-            // Update the total number of bytes available for DMA
-            uint32_t dma_to_schedule = g_scsi_dma.bytes_app - g_scsi_dma.scheduled_dma;
-            DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) &= ~DMA_CHXCTL_CHEN;
-            DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) = dma_to_schedule;
-            DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) |= DMA_CHXCTL_CHEN;
-            g_scsi_dma.scheduled_dma += dma_to_schedule;
-        }
-        else
-        {
-            // No more data available
-            stop_dma();
-        }
-    }
-}
-
-void scsi_accel_dma_startWrite(const uint8_t* data, uint32_t count, volatile int *resetFlag)
-{
-    __disable_irq();
-    if (g_scsi_dma_state == SCSIDMA_WRITE)
-    {
-        if (!g_scsi_dma.next_app_buf && data == g_scsi_dma.app_buf + g_scsi_dma.bytes_app)
-        {
-            // Combine with currently running request
-            g_scsi_dma.bytes_app += count;
-            count = 0;
-        }
-        else if (data == g_scsi_dma.next_app_buf + g_scsi_dma.next_app_bytes)
-        {
-            // Combine with queued request
-            g_scsi_dma.next_app_bytes += count;
-            count = 0;
-        }
-        else if (!g_scsi_dma.next_app_buf)
-        {
-            // Add as queued request
-            g_scsi_dma.next_app_buf = (uint8_t*)data;
-            g_scsi_dma.next_app_bytes = count;
-            count = 0;
-        }
-    }
-    __enable_irq();
-
-    // Check if the request was combined
-    if (count == 0) return;
-
-    if (g_scsi_dma_state != SCSIDMA_IDLE)
-    {
-        // Wait for previous request to finish
-        scsi_accel_dma_finishWrite(resetFlag);
-        if (*resetFlag)
-        {
-            return;
-        }
-    }
-
-    // bluedbg("Starting DMA write of ", (int)count, " bytes");
-    scsi_dma_gpio_config(true);
-    g_scsi_dma_state = SCSIDMA_WRITE;
-    g_scsi_dma.app_buf = (uint8_t*)data;
-    g_scsi_dma.dma_idx = 0;
-    g_scsi_dma.dma_fillto = DMA_BUF_SIZE;
-    g_scsi_dma.bytes_app = count;
-    g_scsi_dma.bytes_dma = 0;
-    g_scsi_dma.scheduled_dma = 0;
-    g_scsi_dma.next_app_buf = NULL;
-    g_scsi_dma.next_app_bytes = 0;
-    g_scsi_dma.greenpak_state = GREENPAK_IO1_LOW;
-    refill_dmabuf();
-    start_dma();
-}
-
-bool scsi_accel_dma_isWriteFinished(const uint8_t* data)
-{
-    // Check if everything has completed
-    if (g_scsi_dma_state == SCSIDMA_IDLE)
-    {
-        return true;
-    }
-
-    if (!data)
-        return false;
-
-    // Check if this data item is still in queue.
-    __disable_irq();
-    bool finished = true;
-    if (data >= g_scsi_dma.app_buf + g_scsi_dma.bytes_dma &&
-        data < g_scsi_dma.app_buf + g_scsi_dma.bytes_app)
-    {
-        finished = false; // In current transfer
-    }
-    else if (data >= g_scsi_dma.next_app_buf &&
-             data < g_scsi_dma.next_app_buf + g_scsi_dma.next_app_bytes)
-    {
-        finished = false; // In queued transfer
-    }
-    __enable_irq();
-
-    return finished;
-}
-
-void scsi_accel_dma_stopWrite()
-{
-    stop_dma();
-    scsi_dma_gpio_config(false);
-}
-
-void scsi_accel_dma_finishWrite(volatile int *resetFlag)
-{
-    uint32_t start = millis();
-    while (g_scsi_dma_state != SCSIDMA_IDLE && !*resetFlag)
-    {
-        if ((uint32_t)(millis() - start) > 5000)
-        {
-            bluelog("scsi_accel_dma_finishWrite() timeout, DMA counts ",
-                DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA), " ",
-                DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB), " ",
-                TIMER_CNT(SCSI_TIMER));
-            *resetFlag = 1;
-            break;
-        }
-    }
-
-    scsi_accel_dma_stopWrite();
-}
-
-/************************************************/
-/* Functions using external GreenPAK logic chip */
-/************************************************/
-
-void scsi_accel_greenpak_dma_init()
-{
-    g_scsi_dma_state = SCSIDMA_IDLE;
-    g_scsi_dma_use_greenpak = true;
-    rcu_periph_clock_enable(SCSI_TIMER_RCU);
-    rcu_periph_clock_enable(SCSI_TIMER_DMA_RCU);
-
-    // DMA Channel A: data copy
-    // GPIO DMA copies data from memory buffer to GPIO BOP register.
-    // The memory buffer is filled by interrupt routine.
-    dma_parameter_struct gpio_dma_config =
-    {
-        .periph_addr = (uint32_t)&GPIO_BOP(SCSI_OUT_PORT),
-        .periph_width = DMA_PERIPHERAL_WIDTH_32BIT,
-        .memory_addr = (uint32_t)g_scsi_dma.dma_buf,
-        .memory_width = DMA_MEMORY_WIDTH_32BIT,
-        .number = DMA_BUF_SIZE,
-        .priority = DMA_PRIORITY_ULTRA_HIGH,
-        .periph_inc = DMA_PERIPH_INCREASE_DISABLE,
-        .memory_inc = DMA_MEMORY_INCREASE_ENABLE,
-        .direction = DMA_MEMORY_TO_PERIPHERAL
-    };
-    dma_init(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA, &gpio_dma_config);
-    dma_circulation_enable(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA);
-    NVIC_SetPriority(SCSI_TIMER_DMACHA_IRQn, 2);
-    NVIC_EnableIRQ(SCSI_TIMER_DMACHA_IRQn);
-    NVIC_DisableIRQ(SCSI_TIMER_DMACHB_IRQn);
-
-    // EXTI channel is used to trigger when we reach end of the transfer.
-    // Because the main DMA is circular and transfer size may not be even
-    // multiple of it, we cannot trigger the end at the DMA interrupt.
-    gpio_exti_source_select(GREENPAK_PLD_IO2_EXTI_SOURCE_PORT, GREENPAK_PLD_IO2_EXTI_SOURCE_PIN);
-    exti_init(GREENPAK_PLD_IO2_EXTI, EXTI_INTERRUPT, EXTI_TRIG_FALLING);
-    exti_interrupt_flag_clear(GREENPAK_PLD_IO2_EXTI);
-    exti_interrupt_disable(GREENPAK_PLD_IO2_EXTI);
-    NVIC_SetPriority(GREENPAK_IRQn, 1);
-    NVIC_EnableIRQ(GREENPAK_IRQn);
-
-    // Timer is used to trigger DMA requests
-    // OUT_REQ is driven by timer output.
-    // 1. On timer update event, REQ is set low.
-    // 2. When ACK goes low, timer counts and OUT_REQ is set high.
-    //    Simultaneously a DMA request is triggered to write next data to GPIO.
-    // 3. When ACK goes high, a DMA request is triggered to cause timer update event.
-    //    The DMA request priority is set so that 2. always completes before it.
-    TIMER_CTL0(SCSI_TIMER) = 0;
-    TIMER_SMCFG(SCSI_TIMER) = TIMER_SLAVE_MODE_EXTERNAL0 | TIMER_SMCFG_TRGSEL_CI0F_ED;
-    TIMER_CAR(SCSI_TIMER) = 1;
-    TIMER_PSC(SCSI_TIMER) = 0;
-    TIMER_DMAINTEN(SCSI_TIMER) = 0;
-    TIMER_CHCTL0(SCSI_TIMER) = 0x6001; // CH0 as input, CH1 as DMA trigger
-    TIMER_CHCTL1(SCSI_TIMER) = 0;
-    TIMER_CHCTL2(SCSI_TIMER) = 0;
-    TIMER_CCHP(SCSI_TIMER) = 0;
-    TIMER_CH1CV(SCSI_TIMER) = 1; // Copy data when ACK goes low
-    gpio_init(SCSI_TIMER_IN_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_TIMER_IN_PIN);
-}
-
-extern const uint32_t g_scsi_out_byte_to_bop_pld1hi[256];
-extern const uint32_t g_scsi_out_byte_to_bop_pld1lo[256];
-
-static void greenpak_refill_dmabuf()
-{
-    if (g_scsi_dma.greenpak_state == GREENPAK_STOP)
-    {
-        // Wait for previous DMA block to end first
-        return;
-    }
-
-    // Check how many bytes we have available from the application
-    uint32_t count = g_scsi_dma.bytes_app - g_scsi_dma.bytes_dma;
-
-    // Check amount of free space in DMA buffer
-    uint32_t max = g_scsi_dma.dma_fillto - g_scsi_dma.dma_idx;
-    if (count > max) count = max;
-
-    uint8_t *src = g_scsi_dma.app_buf + g_scsi_dma.bytes_dma;
-    uint32_t *dst = g_scsi_dma.dma_buf;
-    uint32_t pos = g_scsi_dma.dma_idx;
-    uint32_t end = pos + count;
-    g_scsi_dma.dma_idx = end;
-    g_scsi_dma.bytes_dma += count;
-    g_scsi_dma.scheduled_dma = g_scsi_dma.bytes_dma;
-
-    if (pos < end && g_scsi_dma.greenpak_state == GREENPAK_IO1_HIGH)
-    {
-        // Fix alignment so that main loop begins with PLD1HI
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop_pld1lo[*src++];
-        g_scsi_dma.greenpak_state = GREENPAK_IO1_LOW;
-    }
-
-    while (pos + 4 <= end)
-    {
-        uint32_t input = *(uint32_t*)src;
-        src += 4;
-
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop_pld1hi[(input >> 0) & 0xFF];
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop_pld1lo[(input >> 8) & 0xFF];
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop_pld1hi[(input >> 16) & 0xFF];
-        dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop_pld1lo[(input >> 24) & 0xFF];
-    }
-
-    while (pos < end)
-    {
-        if (g_scsi_dma.greenpak_state == GREENPAK_IO1_HIGH)
-        {
-            dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop_pld1lo[*src++];
-            g_scsi_dma.greenpak_state = GREENPAK_IO1_LOW;
-        }
-        else
-        {
-            dst[(pos++) & DMA_BUF_MASK] = g_scsi_out_byte_to_bop_pld1hi[*src++];
-            g_scsi_dma.greenpak_state = GREENPAK_IO1_HIGH;
-        }
-    }
-
-    uint32_t remain = g_scsi_dma.dma_fillto - g_scsi_dma.dma_idx;
-    if (!g_scsi_dma.next_app_buf && remain > 0)
-    {
-        // Mark the end of transfer by turning PD2 off
-        dst[(pos++) & DMA_BUF_MASK] = (GREENPAK_PLD_IO2 << 16) | (GREENPAK_PLD_IO1 << 16);
-        g_scsi_dma.dma_idx = pos;
-        g_scsi_dma.greenpak_state = GREENPAK_STOP;
-    }
-}
-
-extern "C" void GREENPAK_IRQ()
-{
-    if (EXTI_PD & GREENPAK_PLD_IO2_EXTI)
-    {
-        EXTI_PD = GREENPAK_PLD_IO2_EXTI;
-
-        if (g_scsi_dma.bytes_app > g_scsi_dma.bytes_dma || g_scsi_dma.next_app_buf)
-        {
-            assert(g_scsi_dma.greenpak_state == GREENPAK_STOP);
-            g_scsi_dma.greenpak_state = GREENPAK_IO1_LOW;
-            // More data is available
-            check_dma_next_buffer();
-            refill_dmabuf();
-
-            // Continue transferring
-            GPIO_BOP(SCSI_OUT_PORT) = GREENPAK_PLD_IO2;
-            TIMER_SWEVG(SCSI_TIMER) = TIMER_SWEVG_CH1G;
-        }
-        else
-        {
-            stop_dma();
-        }
-    }
-}
-
-static void greenpak_start_dma()
-{
-    // Disable channels while configuring
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) &= ~DMA_CHXCTL_CHEN;
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHB) &= ~DMA_CHXCTL_CHEN;
-    TIMER_CTL0(SCSI_TIMER) = 0;
-
-    // Set buffer address and size
-    DMA_CHMADDR(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) = (uint32_t)g_scsi_dma.dma_buf;
-    DMA_CHCNT(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) = DMA_BUF_SIZE;
-
-    // Clear pending DMA events
-    TIMER_DMAINTEN(SCSI_TIMER) = 0;
-    TIMER_DMAINTEN(SCSI_TIMER) = TIMER_DMAINTEN_CH1DEN | TIMER_DMAINTEN_CH3DEN;
-
-    // Clear and enable interrupt
-    DMA_INTC(SCSI_TIMER_DMA) = DMA_FLAG_ADD(DMA_FLAG_HTF | DMA_FLAG_FTF | DMA_FLAG_ERR, SCSI_TIMER_DMACHA);
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) |= DMA_CHXCTL_FTFIE | DMA_CHXCTL_HTFIE;
-    exti_interrupt_flag_clear(GREENPAK_PLD_IO2_EXTI);
-    exti_interrupt_enable(GREENPAK_PLD_IO2_EXTI);
-
-    // Enable channels
-    DMA_CHCTL(SCSI_TIMER_DMA, SCSI_TIMER_DMACHA) |= DMA_CHXCTL_CHEN;
-
-    // Enable timer
-    TIMER_CNT(SCSI_TIMER) = 0;
-    TIMER_CTL0(SCSI_TIMER) |= TIMER_CTL0_CEN;
-
-    // Generate first event
-    TIMER_SWEVG(SCSI_TIMER) = TIMER_SWEVG_CH1G;
-}
-
-static void greenpak_stop_dma()
-{
-    exti_interrupt_disable(GREENPAK_PLD_IO2_EXTI);
-}
-
-#endif

lib/BlueSCSI_platform_GD32F205/scsi_accel_dma.h

@@ -1,27 +0,0 @@
-// SCSI subroutines that use hardware DMA for transfer in the background.
-// Uses either GD32 timer or external GreenPAK to implement REQ pin toggling.
-
-#pragma once
-
-#include <stdint.h>
-#include "BlueSCSI_platform.h"
-#include "greenpak.h"
-
-#ifdef SCSI_TIMER
-#define SCSI_ACCEL_DMA_AVAILABLE 1
-#endif
-
-/* Initialization function decides whether to use timer or GreenPAK */
-void scsi_accel_greenpak_dma_init();
-void scsi_accel_timer_dma_init();
-
-/* Common functions */
-void scsi_accel_dma_startWrite(const uint8_t* data, uint32_t count, volatile int *resetFlag);
-void scsi_accel_dma_stopWrite();
-void scsi_accel_dma_finishWrite(volatile int *resetFlag);
-
-// Query whether the data at pointer has already been read, i.e. buffer can be reused.
-// If data is NULL, checks if all writes have completed.
-bool scsi_accel_dma_isWriteFinished(const uint8_t* data);
-
-

lib/BlueSCSI_platform_GD32F205/scsi_accel_greenpak.cpp

@@ -1,365 +0,0 @@
-#include "scsi_accel_greenpak.h"
-#include "BlueSCSI_platform.h"
-#include <BlueSCSI_log.h>
-#include <assert.h>
-
-#ifndef GREENPAK_PLD_IO1
-
-void scsi_accel_greenpak_send(const uint32_t *buf, uint32_t num_words, volatile int *resetFlag)
-{
-    assert(false);
-}
-
-void scsi_accel_greenpak_recv(uint32_t *buf, uint32_t num_words, volatile int *resetFlag)
-{
-    assert(false);
-}
-
-#else
-
-/*********************************************************/
-/* Optimized writes to SCSI bus in GREENPAK_PIO mode     */
-/*********************************************************/
-
-extern const uint32_t g_scsi_out_byte_to_bop_pld1hi[256];
-extern const uint32_t g_scsi_out_byte_to_bop_pld1lo[256];
-
-// Optimized ASM blocks for the SCSI communication subroutine
-
-// Take 8 bits from d and format them for writing
-// d is name of data operand, b is bit offset, x is unique label
-#define ASM_LOAD_DATA_PLD1HI(d, b, x) \
-"    load_data1_" x "_%=: \n" \
-"        ubfx    %[tmp1], %[" d "], #" b ", #8 \n" \
-"        ldr     %[tmp1], [%[byte_lookup_pld1hi], %[tmp1], lsl #2] \n"
-
-#define ASM_LOAD_DATA_PLD1LO(d, b, x) \
-"    load_data1_" x "_%=: \n" \
-"        ubfx    %[tmp1], %[" d "], #" b ", #8 \n" \
-"        ldr     %[tmp1], [%[byte_lookup_pld1lo], %[tmp1], lsl #2] \n"
-
-// Write data to SCSI port
-#define ASM_SEND_DATA(x) \
-"    send_data" x "_%=: \n" \
-"        str     %[tmp1], [%[out_port_bop]] \n"
-
-// Wait for ACK to be low or REQ to be high.
-// The external logic will set REQ low when PLD_IO1 is toggled and
-// back high as soon as ACK goes low. New data can be written to
-// GPIO as soon as ACK goes low. If an interrupt happens in the
-// middle, we may miss the ACK pulse and should check REQ.
-#define ASM_WAIT_DONE(x) \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], wait_done_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], wait_done_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], wait_done_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], wait_done_" x "_%= \n" \
-"    wait_req_inactive_" x "_%=: \n" \
-"        ldr     %[tmp2], [%[req_pin_bb]] \n" \
-"        cbnz    %[tmp2], wait_done_" x "_%= \n" \
-"        ldr     %[tmp2], [%[reset_flag]] \n" \
-"        cbnz    %[tmp2], wait_done_" x "_%= \n" \
-"        b.n     wait_req_inactive_" x "_%= \n" \
-"    wait_done_" x "_%=: \n"
-
-// Send bytes to SCSI bus using the asynchronous handshake mechanism
-// Takes 4 bytes at a time for sending from buf.
-void scsi_accel_greenpak_send(const uint32_t *buf, uint32_t num_words, volatile int *resetFlag)
-{
-    volatile uint32_t *out_port_bop = (volatile uint32_t*)&GPIO_BOP(SCSI_OUT_PORT);
-    uint32_t ack_pin_bb = PERIPH_BB_BASE + (((uint32_t)&GPIO_ISTAT(SCSI_ACK_PORT)) - APB1_BUS_BASE) * 32 + SCSI_IN_ACK_IDX * 4;
-    uint32_t req_pin_bb = PERIPH_BB_BASE + (((uint32_t)&GPIO_ISTAT(SCSI_OUT_PORT)) - APB1_BUS_BASE) * 32 + SCSI_OUT_REQ_IDX * 4;
-    register uint32_t tmp1 = 0;
-    register uint32_t tmp2 = 0;
-    register uint32_t data = 0;
-
-    // Set REQ pin as input and PLD_IO2 high to enable logic
-    GPIO_BC(SCSI_OUT_PORT) = GREENPAK_PLD_IO1;
-    gpio_init(SCSI_OUT_PORT, GPIO_MODE_IPU, 0, SCSI_OUT_REQ);
-    GPIO_BOP(SCSI_OUT_PORT) = GREENPAK_PLD_IO2;
-
-    asm volatile (
-    "   ldr      %[data], [%[buf]], #4 \n" \
-        ASM_LOAD_DATA_PLD1HI("data", "0", "first")
-
-    "inner_loop_%=: \n" \
-        ASM_SEND_DATA("0")
-        ASM_LOAD_DATA_PLD1LO("data", "8", "8")
-        ASM_WAIT_DONE("0")
-
-        ASM_SEND_DATA("8")
-        ASM_LOAD_DATA_PLD1HI("data", "16", "16")
-        ASM_WAIT_DONE("8")
-
-        ASM_SEND_DATA("16")
-        ASM_LOAD_DATA_PLD1LO("data", "24", "24")
-        ASM_WAIT_DONE("16")
-
-        ASM_SEND_DATA("24")
-    "   ldr      %[data], [%[buf]], #4 \n" \
-        ASM_LOAD_DATA_PLD1HI("data", "0", "0")
-        ASM_WAIT_DONE("24")
-
-    "   subs     %[num_words], %[num_words], #1 \n" \
-    "   bne     inner_loop_%= \n"
-    : /* Output */ [tmp1] "+l" (tmp1), [tmp2] "+l" (tmp2), [data] "+r" (data),
-                   [buf] "+r" (buf), [num_words] "+r" (num_words)
-    : /* Input */ [ack_pin_bb] "r" (ack_pin_bb),
-                  [req_pin_bb] "r" (req_pin_bb),
-                  [out_port_bop] "r"(out_port_bop),
-                  [byte_lookup_pld1hi] "r" (g_scsi_out_byte_to_bop_pld1hi),
-                  [byte_lookup_pld1lo] "r" (g_scsi_out_byte_to_bop_pld1lo),
-                  [reset_flag] "r" (resetFlag)
-    : /* Clobber */ );
-
-    SCSI_RELEASE_DATA_REQ();
-
-    // Disable external logic and set REQ pin as output
-    GPIO_BC(SCSI_OUT_PORT) = GREENPAK_PLD_IO2;
-    gpio_init(SCSI_OUT_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_REQ);
-}
-
-/**********************************************/
-/* Mapping from data bytes to GPIO BOP values */
-/**********************************************/
-
-#define PARITY(n) ((1 ^ (n) ^ ((n)>>1) ^ ((n)>>2) ^ ((n)>>3) ^ ((n)>>4) ^ ((n)>>5) ^ ((n)>>6) ^ ((n)>>7)) & 1)
-#define X(n) (\
-    ((n & 0x01) ? (SCSI_OUT_DB0 << 16) : SCSI_OUT_DB0) | \
-    ((n & 0x02) ? (SCSI_OUT_DB1 << 16) : SCSI_OUT_DB1) | \
-    ((n & 0x04) ? (SCSI_OUT_DB2 << 16) : SCSI_OUT_DB2) | \
-    ((n & 0x08) ? (SCSI_OUT_DB3 << 16) : SCSI_OUT_DB3) | \
-    ((n & 0x10) ? (SCSI_OUT_DB4 << 16) : SCSI_OUT_DB4) | \
-    ((n & 0x20) ? (SCSI_OUT_DB5 << 16) : SCSI_OUT_DB5) | \
-    ((n & 0x40) ? (SCSI_OUT_DB6 << 16) : SCSI_OUT_DB6) | \
-    ((n & 0x80) ? (SCSI_OUT_DB7 << 16) : SCSI_OUT_DB7) | \
-    (PARITY(n)  ? (SCSI_OUT_DBP << 16) : SCSI_OUT_DBP) | \
-    (GREENPAK_PLD_IO1) \
-)
-
-const uint32_t g_scsi_out_byte_to_bop_pld1hi[256] =
-{
-    X(0x00), X(0x01), X(0x02), X(0x03), X(0x04), X(0x05), X(0x06), X(0x07), X(0x08), X(0x09), X(0x0a), X(0x0b), X(0x0c), X(0x0d), X(0x0e), X(0x0f),
-    X(0x10), X(0x11), X(0x12), X(0x13), X(0x14), X(0x15), X(0x16), X(0x17), X(0x18), X(0x19), X(0x1a), X(0x1b), X(0x1c), X(0x1d), X(0x1e), X(0x1f),
-    X(0x20), X(0x21), X(0x22), X(0x23), X(0x24), X(0x25), X(0x26), X(0x27), X(0x28), X(0x29), X(0x2a), X(0x2b), X(0x2c), X(0x2d), X(0x2e), X(0x2f),
-    X(0x30), X(0x31), X(0x32), X(0x33), X(0x34), X(0x35), X(0x36), X(0x37), X(0x38), X(0x39), X(0x3a), X(0x3b), X(0x3c), X(0x3d), X(0x3e), X(0x3f),
-    X(0x40), X(0x41), X(0x42), X(0x43), X(0x44), X(0x45), X(0x46), X(0x47), X(0x48), X(0x49), X(0x4a), X(0x4b), X(0x4c), X(0x4d), X(0x4e), X(0x4f),
-    X(0x50), X(0x51), X(0x52), X(0x53), X(0x54), X(0x55), X(0x56), X(0x57), X(0x58), X(0x59), X(0x5a), X(0x5b), X(0x5c), X(0x5d), X(0x5e), X(0x5f),
-    X(0x60), X(0x61), X(0x62), X(0x63), X(0x64), X(0x65), X(0x66), X(0x67), X(0x68), X(0x69), X(0x6a), X(0x6b), X(0x6c), X(0x6d), X(0x6e), X(0x6f),
-    X(0x70), X(0x71), X(0x72), X(0x73), X(0x74), X(0x75), X(0x76), X(0x77), X(0x78), X(0x79), X(0x7a), X(0x7b), X(0x7c), X(0x7d), X(0x7e), X(0x7f),
-    X(0x80), X(0x81), X(0x82), X(0x83), X(0x84), X(0x85), X(0x86), X(0x87), X(0x88), X(0x89), X(0x8a), X(0x8b), X(0x8c), X(0x8d), X(0x8e), X(0x8f),
-    X(0x90), X(0x91), X(0x92), X(0x93), X(0x94), X(0x95), X(0x96), X(0x97), X(0x98), X(0x99), X(0x9a), X(0x9b), X(0x9c), X(0x9d), X(0x9e), X(0x9f),
-    X(0xa0), X(0xa1), X(0xa2), X(0xa3), X(0xa4), X(0xa5), X(0xa6), X(0xa7), X(0xa8), X(0xa9), X(0xaa), X(0xab), X(0xac), X(0xad), X(0xae), X(0xaf),
-    X(0xb0), X(0xb1), X(0xb2), X(0xb3), X(0xb4), X(0xb5), X(0xb6), X(0xb7), X(0xb8), X(0xb9), X(0xba), X(0xbb), X(0xbc), X(0xbd), X(0xbe), X(0xbf),
-    X(0xc0), X(0xc1), X(0xc2), X(0xc3), X(0xc4), X(0xc5), X(0xc6), X(0xc7), X(0xc8), X(0xc9), X(0xca), X(0xcb), X(0xcc), X(0xcd), X(0xce), X(0xcf),
-    X(0xd0), X(0xd1), X(0xd2), X(0xd3), X(0xd4), X(0xd5), X(0xd6), X(0xd7), X(0xd8), X(0xd9), X(0xda), X(0xdb), X(0xdc), X(0xdd), X(0xde), X(0xdf),
-    X(0xe0), X(0xe1), X(0xe2), X(0xe3), X(0xe4), X(0xe5), X(0xe6), X(0xe7), X(0xe8), X(0xe9), X(0xea), X(0xeb), X(0xec), X(0xed), X(0xee), X(0xef),
-    X(0xf0), X(0xf1), X(0xf2), X(0xf3), X(0xf4), X(0xf5), X(0xf6), X(0xf7), X(0xf8), X(0xf9), X(0xfa), X(0xfb), X(0xfc), X(0xfd), X(0xfe), X(0xff)
-};
-
-#undef X
-
-#define X(n) (\
-    ((n & 0x01) ? (SCSI_OUT_DB0 << 16) : SCSI_OUT_DB0) | \
-    ((n & 0x02) ? (SCSI_OUT_DB1 << 16) : SCSI_OUT_DB1) | \
-    ((n & 0x04) ? (SCSI_OUT_DB2 << 16) : SCSI_OUT_DB2) | \
-    ((n & 0x08) ? (SCSI_OUT_DB3 << 16) : SCSI_OUT_DB3) | \
-    ((n & 0x10) ? (SCSI_OUT_DB4 << 16) : SCSI_OUT_DB4) | \
-    ((n & 0x20) ? (SCSI_OUT_DB5 << 16) : SCSI_OUT_DB5) | \
-    ((n & 0x40) ? (SCSI_OUT_DB6 << 16) : SCSI_OUT_DB6) | \
-    ((n & 0x80) ? (SCSI_OUT_DB7 << 16) : SCSI_OUT_DB7) | \
-    (PARITY(n)  ? (SCSI_OUT_DBP << 16) : SCSI_OUT_DBP) | \
-    (GREENPAK_PLD_IO1 << 16) \
-)
-
-const uint32_t g_scsi_out_byte_to_bop_pld1lo[256] =
-{
-    X(0x00), X(0x01), X(0x02), X(0x03), X(0x04), X(0x05), X(0x06), X(0x07), X(0x08), X(0x09), X(0x0a), X(0x0b), X(0x0c), X(0x0d), X(0x0e), X(0x0f),
-    X(0x10), X(0x11), X(0x12), X(0x13), X(0x14), X(0x15), X(0x16), X(0x17), X(0x18), X(0x19), X(0x1a), X(0x1b), X(0x1c), X(0x1d), X(0x1e), X(0x1f),
-    X(0x20), X(0x21), X(0x22), X(0x23), X(0x24), X(0x25), X(0x26), X(0x27), X(0x28), X(0x29), X(0x2a), X(0x2b), X(0x2c), X(0x2d), X(0x2e), X(0x2f),
-    X(0x30), X(0x31), X(0x32), X(0x33), X(0x34), X(0x35), X(0x36), X(0x37), X(0x38), X(0x39), X(0x3a), X(0x3b), X(0x3c), X(0x3d), X(0x3e), X(0x3f),
-    X(0x40), X(0x41), X(0x42), X(0x43), X(0x44), X(0x45), X(0x46), X(0x47), X(0x48), X(0x49), X(0x4a), X(0x4b), X(0x4c), X(0x4d), X(0x4e), X(0x4f),
-    X(0x50), X(0x51), X(0x52), X(0x53), X(0x54), X(0x55), X(0x56), X(0x57), X(0x58), X(0x59), X(0x5a), X(0x5b), X(0x5c), X(0x5d), X(0x5e), X(0x5f),
-    X(0x60), X(0x61), X(0x62), X(0x63), X(0x64), X(0x65), X(0x66), X(0x67), X(0x68), X(0x69), X(0x6a), X(0x6b), X(0x6c), X(0x6d), X(0x6e), X(0x6f),
-    X(0x70), X(0x71), X(0x72), X(0x73), X(0x74), X(0x75), X(0x76), X(0x77), X(0x78), X(0x79), X(0x7a), X(0x7b), X(0x7c), X(0x7d), X(0x7e), X(0x7f),
-    X(0x80), X(0x81), X(0x82), X(0x83), X(0x84), X(0x85), X(0x86), X(0x87), X(0x88), X(0x89), X(0x8a), X(0x8b), X(0x8c), X(0x8d), X(0x8e), X(0x8f),
-    X(0x90), X(0x91), X(0x92), X(0x93), X(0x94), X(0x95), X(0x96), X(0x97), X(0x98), X(0x99), X(0x9a), X(0x9b), X(0x9c), X(0x9d), X(0x9e), X(0x9f),
-    X(0xa0), X(0xa1), X(0xa2), X(0xa3), X(0xa4), X(0xa5), X(0xa6), X(0xa7), X(0xa8), X(0xa9), X(0xaa), X(0xab), X(0xac), X(0xad), X(0xae), X(0xaf),
-    X(0xb0), X(0xb1), X(0xb2), X(0xb3), X(0xb4), X(0xb5), X(0xb6), X(0xb7), X(0xb8), X(0xb9), X(0xba), X(0xbb), X(0xbc), X(0xbd), X(0xbe), X(0xbf),
-    X(0xc0), X(0xc1), X(0xc2), X(0xc3), X(0xc4), X(0xc5), X(0xc6), X(0xc7), X(0xc8), X(0xc9), X(0xca), X(0xcb), X(0xcc), X(0xcd), X(0xce), X(0xcf),
-    X(0xd0), X(0xd1), X(0xd2), X(0xd3), X(0xd4), X(0xd5), X(0xd6), X(0xd7), X(0xd8), X(0xd9), X(0xda), X(0xdb), X(0xdc), X(0xdd), X(0xde), X(0xdf),
-    X(0xe0), X(0xe1), X(0xe2), X(0xe3), X(0xe4), X(0xe5), X(0xe6), X(0xe7), X(0xe8), X(0xe9), X(0xea), X(0xeb), X(0xec), X(0xed), X(0xee), X(0xef),
-    X(0xf0), X(0xf1), X(0xf2), X(0xf3), X(0xf4), X(0xf5), X(0xf6), X(0xf7), X(0xf8), X(0xf9), X(0xfa), X(0xfb), X(0xfc), X(0xfd), X(0xfe), X(0xff)
-};
-
-#undef X
-
-/*********************************************************/
-/* Optimized reads from SCSI bus in GREENPAK_PIO mode    */
-/*********************************************************/
-
-// Wait for ACK to go high and back low.
-// This indicates that there is a byte ready to be read
-// If interrupt occurs in middle, we may miss ACK going high.
-// In that case, verify that REQ is already low.
-#define ASM_WAIT_ACK(x) \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbnz    %[tmp2], ack_is_high_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbnz    %[tmp2], ack_is_high_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbnz    %[tmp2], ack_is_high_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbnz    %[tmp2], ack_is_high_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbnz    %[tmp2], ack_is_high_" x "_%= \n" \
-"    wait_req_low_" x "_%=: \n" \
-"        cpsid   i \n" \
-"        ldr     %[tmp2], [%[req_pin_bb]] \n" \
-"        cbz     %[tmp2], ack_is_high_" x "_%= \n" \
-"        ldr     %[tmp2], [%[reset_flag]] \n" \
-"        cbnz    %[tmp2], ack_is_high_" x "_%= \n" \
-"        cpsie   i \n" \
-"        b.n     wait_req_low_" x "_%= \n" \
-"    ack_is_high_" x "_%=: \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], ack_is_low_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], ack_is_low_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], ack_is_low_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], ack_is_low_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], ack_is_low_" x "_%= \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], ack_is_low_" x "_%= \n" \
-"    wait_ack_low_" x "_%=: \n" \
-"        cpsid   i \n" \
-"        ldr     %[tmp2], [%[ack_pin_bb]] \n" \
-"        cbz     %[tmp2], ack_is_low_" x "_%= \n" \
-"        ldr     %[tmp2], [%[reset_flag]] \n" \
-"        cbnz    %[tmp2], ack_is_low_" x "_%= \n" \
-"        cpsie   i \n" \
-"        b.n     wait_ack_low_" x "_%= \n" \
-"    ack_is_low_" x "_%=: \n"
-
-// Prepare for reception of data by loading the next PLD_IO1 value
-// and disabling interrupts.
-#define ASM_PREP_RECV(l) \
-"        mov    %[tmp1], %[" l "] \n" \
-"        cpsid  i \n"
-
-// Read GPIO bus, take the data byte and toggle PLD_IO1.
-// Note that the PLD_IO1 write is done first to reduce latency, but
-// the istat value that is read by next instruction is still the old
-// one due to IO port delays. Interrupts must be disabled for this
-// sequence to work correctly.
-//
-// d is the name of register where data is to be stored
-// b is the bit offset to store the byte at
-// x is unique label
-#define ASM_RECV_DATA(d, b, x) \
-"    read_data_" x "_%=: \n" \
-"        str    %[tmp1], [%[out_port_bop]] \n" \
-"        ldr    %[tmp1], [%[in_port_istat]] \n" \
-"        ubfx   %[tmp1], %[tmp1], %[data_in_shift], #8 \n" \
-"        bfi    %[" d "], %[tmp1], #" b ", #8 \n" \
-"        cpsie  i \n"
-
-// Read bytes from SCSI bus using asynchronous handshake mechanism
-// Takes 4 bytes at a time.
-void scsi_accel_greenpak_recv(uint32_t *buf, uint32_t num_words, volatile int *resetFlag)
-{
-    volatile uint32_t *out_port_bop = (volatile uint32_t*)&GPIO_BOP(SCSI_OUT_PORT);
-    volatile uint32_t *in_port_istat = (volatile uint32_t*)&GPIO_ISTAT(SCSI_IN_PORT);
-    uint32_t ack_pin_bb = PERIPH_BB_BASE + (((uint32_t)&GPIO_ISTAT(SCSI_ACK_PORT)) - APB1_BUS_BASE) * 32 + SCSI_IN_ACK_IDX * 4;
-    uint32_t req_pin_bb = PERIPH_BB_BASE + (((uint32_t)&GPIO_ISTAT(SCSI_OUT_PORT)) - APB1_BUS_BASE) * 32 + SCSI_OUT_REQ_IDX * 4;
-    register uint32_t tmp1 = 0;
-    register uint32_t tmp2 = 0;
-    register uint32_t data = 0;
-
-    // Last word requires special handling so that hardware doesn't issue new REQ pulse.
-    assert(num_words >= 2);
-    num_words -= 1;
-
-    // Set PLD_IO3 high to enable read from SCSI bus
-    GPIO_BOP(SCSI_OUT_PORT) = GREENPAK_PLD_IO3;
-
-    // Make sure that the previous access has fully completed.
-    // E.g. Macintosh can hold ACK low for long time after last byte of block.
-    while (SCSI_IN(ACK) && !*resetFlag);
-
-    // Set REQ pin as input and PLD_IO2 high to enable logic
-    GPIO_BC(SCSI_OUT_PORT) = GREENPAK_PLD_IO1;
-    gpio_init(SCSI_OUT_PORT, GPIO_MODE_IPU, 0, SCSI_OUT_REQ);
-    GPIO_BOP(SCSI_OUT_PORT) = GREENPAK_PLD_IO2;
-
-    asm volatile (
-    "inner_loop_%=: \n"
-        ASM_PREP_RECV("pld1_hi")
-        ASM_WAIT_ACK("0")
-        ASM_RECV_DATA("data", "0", "0")
-
-        ASM_PREP_RECV("pld1_lo")
-        ASM_WAIT_ACK("8")
-        ASM_RECV_DATA("data", "8", "8")
-
-        ASM_PREP_RECV("pld1_hi")
-        ASM_WAIT_ACK("16")
-        ASM_RECV_DATA("data", "16", "16")
-
-        ASM_PREP_RECV("pld1_lo")
-        ASM_WAIT_ACK("24")
-        ASM_RECV_DATA("data", "24", "24")
-
-    "   mvn      %[data], %[data] \n"
-    "   str      %[data], [%[buf]], #4 \n"
-    "   subs     %[num_words], %[num_words], #1 \n"
-    "   bne     inner_loop_%= \n"
-
-    // Process last word separately to avoid issuing extra REQ pulse at end.
-    "recv_last_word_%=: \n"
-        ASM_PREP_RECV("pld1_hi")
-        ASM_WAIT_ACK("0b")
-        ASM_RECV_DATA("data", "0", "0b")
-
-        ASM_PREP_RECV("pld1_lo")
-        ASM_WAIT_ACK("8b")
-        ASM_RECV_DATA("data", "8", "8b")
-
-        ASM_PREP_RECV("pld1_hi")
-        ASM_WAIT_ACK("16b")
-        ASM_RECV_DATA("data", "16", "16b")
-
-        ASM_PREP_RECV("pld1_hi")
-        ASM_WAIT_ACK("24b")
-        ASM_RECV_DATA("data", "24", "24b")
-
-    "   mvn      %[data], %[data] \n"
-    "   str      %[data], [%[buf]], #4 \n"
-
-    : /* Output */ [tmp1] "+l" (tmp1), [tmp2] "+l" (tmp2), [data] "+r" (data),
-                   [buf] "+r" (buf), [num_words] "+r" (num_words)
-    : /* Input */ [ack_pin_bb] "r" (ack_pin_bb),
-                  [req_pin_bb] "r" (req_pin_bb),
-                  [out_port_bop] "r"(out_port_bop),
-                  [in_port_istat] "r" (in_port_istat),
-                  [reset_flag] "r" (resetFlag),
-                  [data_in_shift] "I" (SCSI_IN_SHIFT),
-                  [pld1_lo] "I" (SCSI_OUT_PLD1 << 16),
-                  [pld1_hi] "I" (SCSI_OUT_PLD1)
-    : /* Clobber */ );
-
-    SCSI_RELEASE_DATA_REQ();
-
-    // Disable external logic and set REQ pin as output
-    GPIO_BC(SCSI_OUT_PORT) = GREENPAK_PLD_IO2;
-    gpio_init(SCSI_OUT_PORT, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, SCSI_OUT_REQ);
-    GPIO_BC(SCSI_OUT_PORT) = GREENPAK_PLD_IO3;
-}
-
-#endif

lib/BlueSCSI_platform_GD32F205/scsi_accel_greenpak.h

@@ -1,9 +0,0 @@
-// SCSI subroutines using external GreenPAK logic chip for acceleration
-
-#pragma once
-
-#include <stdint.h>
-#include "greenpak.h"
-
-void scsi_accel_greenpak_send(const uint32_t *buf, uint32_t num_words, volatile int *resetFlag);
-void scsi_accel_greenpak_recv(uint32_t *buf, uint32_t num_words, volatile int *resetFlag);

lib/BlueSCSI_platform_GD32F205/scsi_accel_sync.cpp

@@ -1,479 +0,0 @@
-/* Synchronous mode SCSI implementation.
- *
- * In synchronous mode, the handshake mechanism is not used. Instead
- * either end of the communication will just send a bunch of bytes
- * and only afterwards checks that the number of acknowledgement
- * pulses matches.
- *
- * The receiving end should latch in the data at the falling edge of
- * the request pulse (on either REQ or ACK pin). We use the GD32 EXMC
- * peripheral to implement this latching with the NWAIT pin when
- * reading data from the host. NOE is used to generate the REQ pulses.
- *
- * Writing data to the host is simpler, as we can just write it out
- * from the GPIO port at our own pace. A timer is used for generating
- * the output pulses on REQ pin.
- */
-
-#include "scsi_accel_sync.h"
-#include <BlueSCSI_log.h>
-#include <gd32f20x_exmc.h>
-#include <scsi.h>
-
-#ifndef SCSI_SYNC_MODE_AVAILABLE
-
-void scsi_accel_sync_init() {}
-
-void scsi_accel_sync_recv(uint8_t *data, uint32_t count, int* parityError, volatile int *resetFlag) {}
-void scsi_accel_sync_send(const uint8_t* data, uint32_t count, volatile int *resetFlag) {}
-
-#else
-
-/********************************/
-/* Transfer from host to device */
-/********************************/
-
-#define SYNC_DMA_BUFSIZE 512
-static uint32_t g_sync_dma_buf[SYNC_DMA_BUFSIZE];
-
-void scsi_accel_sync_init()
-{
-    rcu_periph_clock_enable(RCU_EXMC);
-    rcu_periph_clock_enable(SCSI_EXMC_DMA_RCU);
-    rcu_periph_clock_enable(SCSI_SYNC_TIMER_RCU);
-
-    exmc_norsram_timing_parameter_struct timing_param = {
-        .asyn_access_mode = EXMC_ACCESS_MODE_A,
-        .syn_data_latency = EXMC_DATALAT_2_CLK,
-        .syn_clk_division = EXMC_SYN_CLOCK_RATIO_2_CLK,
-        .bus_latency = 1,
-        .asyn_data_setuptime = 2,
-        .asyn_address_holdtime = 2,
-        .asyn_address_setuptime = 16
-    };
-
-    exmc_norsram_parameter_struct sram_param = {
-        .norsram_region = EXMC_BANK0_NORSRAM_REGION0,
-        .write_mode = EXMC_ASYN_WRITE,
-        .extended_mode = DISABLE,
-        .asyn_wait = ENABLE,
-        .nwait_signal = ENABLE,
-        .memory_write = DISABLE,
-        .nwait_config = EXMC_NWAIT_CONFIG_DURING,
-        .wrap_burst_mode = DISABLE,
-        .nwait_polarity = EXMC_NWAIT_POLARITY_HIGH,
-        .burst_mode = DISABLE,
-        .databus_width = EXMC_NOR_DATABUS_WIDTH_16B,
-        .memory_type = EXMC_MEMORY_TYPE_SRAM,
-        .address_data_mux = DISABLE,
-        .read_write_timing = &timing_param
-    };
-
-    EXMC_SNCTL(EXMC_BANK0_NORSRAM_REGION0) &= ~EXMC_SNCTL_NRBKEN;
-    exmc_norsram_init(&sram_param);
-
-    // DMA used to transfer data from EXMC to RAM
-    // DMA is used so that if data transfer fails, we can at least abort by resetting CPU.
-    // Accessing EXMC from the CPU directly hangs it totally if ACK pulses are not received.
-    dma_parameter_struct exmc_dma_config =
-    {
-        .periph_addr = EXMC_NOR_PSRAM,
-        .periph_width = DMA_PERIPHERAL_WIDTH_16BIT,
-        .memory_addr = (uint32_t)g_sync_dma_buf,
-        .memory_width = DMA_MEMORY_WIDTH_16BIT,
-        .number = 0, // Filled before transfer
-        .priority = DMA_PRIORITY_MEDIUM,
-        .periph_inc = DMA_PERIPH_INCREASE_DISABLE,
-        .memory_inc = DMA_MEMORY_INCREASE_ENABLE,
-        .direction = DMA_PERIPHERAL_TO_MEMORY
-    };
-    dma_init(SCSI_EXMC_DMA, SCSI_EXMC_DMACH, &exmc_dma_config);
-    dma_memory_to_memory_enable(SCSI_EXMC_DMA, SCSI_EXMC_DMACH);
-
-    gpio_init(SCSI_IN_ACK_EXMC_NWAIT_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_IN_ACK_EXMC_NWAIT_PIN);
-    gpio_init(SCSI_TIMER_IN_PORT, GPIO_MODE_IN_FLOATING, 0, SCSI_TIMER_IN_PIN);
-
-    // TIMER1 is used to count ACK pulses
-    TIMER_CTL0(SCSI_SYNC_TIMER) = 0;
-    TIMER_SMCFG(SCSI_SYNC_TIMER) = TIMER_SLAVE_MODE_EXTERNAL0 | TIMER_SMCFG_TRGSEL_CI0FE0;
-    TIMER_CAR(SCSI_SYNC_TIMER) = 65535;
-    TIMER_PSC(SCSI_SYNC_TIMER) = 0;
-    TIMER_CHCTL0(SCSI_SYNC_TIMER) = 0x0001; // CH0 as input
-}
-
-void scsi_accel_sync_recv(uint8_t *data, uint32_t count, int* parityError, volatile int *resetFlag)
-{
-    // Enable EXMC to drive REQ from EXMC_NOE pin
-    EXMC_SNCTL(EXMC_BANK0_NORSRAM_REGION0) |= EXMC_SNCTL_NRBKEN;
-    uint32_t oldmode = GPIO_CTL0(SCSI_OUT_REQ_EXMC_NOE_PORT);
-    uint32_t newmode = oldmode & ~(0xF << (SCSI_OUT_REQ_EXMC_NOE_IDX * 4));
-    newmode |= 0xB << (SCSI_OUT_REQ_EXMC_NOE_IDX * 4);
-    GPIO_CTL0(SCSI_OUT_REQ_EXMC_NOE_PORT) = newmode;
-
-    while (count > 0)
-    {
-        uint32_t blocksize = (count > SYNC_DMA_BUFSIZE * 2) ? (SYNC_DMA_BUFSIZE * 2) : count;
-        count -= blocksize;
-
-        DMA_CHCNT(SCSI_EXMC_DMA, SCSI_EXMC_DMACH) = blocksize;
-        DMA_CHCTL(SCSI_EXMC_DMA, SCSI_EXMC_DMACH) |= DMA_CHXCTL_CHEN;
-
-        uint16_t *src = (uint16_t*)g_sync_dma_buf;
-        uint8_t *dst = data;
-        uint8_t *end = data + blocksize;
-        uint32_t start = millis();
-        while (dst < end)
-        {
-            uint32_t remain = DMA_CHCNT(SCSI_EXMC_DMA, SCSI_EXMC_DMACH);
-
-            while (dst < end - remain)
-            {
-                *dst++ = ~(*src++) >> SCSI_EXMC_DATA_SHIFT;
-            }
-
-            if ((uint32_t)(millis() - start) > 500 || *resetFlag)
-            {
-                // We are in a pinch here: without ACK pulses coming, the EXMC and DMA peripherals
-                // are locked up. The only way out is a whole system reset.
-                bluelog("SCSI Synchronous read timeout: resetting system");
-                NVIC_SystemReset();
-            }
-        }
-
-        DMA_CHCTL(SCSI_EXMC_DMA, SCSI_EXMC_DMACH) &= ~DMA_CHXCTL_CHEN;
-        data = end;
-    }
-
-    GPIO_CTL0(SCSI_OUT_REQ_EXMC_NOE_PORT) = oldmode;
-    EXMC_SNCTL(EXMC_BANK0_NORSRAM_REGION0) &= ~EXMC_SNCTL_NRBKEN;
-}
-
-/********************************/
-/* Transfer from device to host */
-/********************************/
-
-// Simple delay, about 20 ns.
-// This is less likely to get optimized away by CPU pipeline than nop
-#define ASM_DELAY()  \
-"   ldr     %[tmp2], [%[reset_flag]] \n"
-
-// Take 8 bits from d and format them for writing
-// d is name of data operand, b is bit offset
-#define ASM_LOAD_DATA(b) \
-"        ubfx    %[tmp1], %[data], #" b ", #8 \n" \
-"        ldr     %[tmp1], [%[byte_lookup], %[tmp1], lsl #2] \n"
-
-// Write data to SCSI port and set REQ high
-#define ASM_SEND_DATA() \
-"        str     %[tmp1], [%[out_port_bop]] \n"
-
-// Set REQ low
-#define ASM_SET_REQ_LOW() \
-"        mov     %[tmp2], %[bop_req_low] \n" \
-"        str     %[tmp2], [%[out_port_bop]] \n"
-
-// Wait for ACK_TIMER - n to be less than num_bytes
-#define ASM_WAIT_ACK_TIMER(n) \
-    "wait_acks_" n "_%=: \n" \
-        "   ldr     %[tmp2], [%[ack_timer]] \n" \
-        "   sub     %[tmp2], # " n " \n" \
-        "   cmp     %[tmp2], %[num_bytes] \n" \
-        "   ble     got_acks_" n "_%= \n" \
-        "   ldr     %[tmp2], [%[reset_flag]] \n" \
-        "   cmp     %[tmp2], #0 \n" \
-        "   bne     all_done_%= \n" \
-        "   b       wait_acks_" n "_%= \n" \
-    "got_acks_" n "_%=: \n"
-
-// Send 4 bytes
-#define ASM_SEND_4BYTES() \
-ASM_LOAD_DATA("0") \
-ASM_SEND_DATA() \
-ASM_DELAY1() \
-ASM_SET_REQ_LOW() \
-ASM_DELAY2() \
-ASM_LOAD_DATA("8") \
-ASM_SEND_DATA() \
-ASM_DELAY1() \
-ASM_SET_REQ_LOW() \
-ASM_DELAY2() \
-ASM_LOAD_DATA("16") \
-ASM_SEND_DATA() \
-ASM_DELAY1() \
-ASM_SET_REQ_LOW() \
-ASM_DELAY2() \
-ASM_LOAD_DATA("24") \
-ASM_SEND_DATA() \
-ASM_DELAY1() \
-ASM_SET_REQ_LOW()
-
-// Send 1 byte, wait for ACK_TIMER to be less than num_bytes + n and send 3 bytes more
-// This interleaving minimizes the delay caused by WAIT_ACK_TIMER.
-#define ASM_SEND_4BYTES_WAIT(n) \
-ASM_LOAD_DATA("0") \
-ASM_SEND_DATA() \
-ASM_DELAY2() \
-ASM_LOAD_DATA("8") \
-ASM_SET_REQ_LOW() \
-ASM_DELAY2() \
-"   ldr     %[tmp2], [%[ack_timer]] \n" \
-"   sub     %[tmp2], # " n " \n" \
-ASM_SEND_DATA() \
-"   cmp     %[tmp2], %[num_bytes] \n" \
-"   ble     got_acks_" n "_%= \n" \
-ASM_WAIT_ACK_TIMER(n) \
-ASM_DELAY2() \
-ASM_SET_REQ_LOW() \
-ASM_DELAY2() \
-ASM_LOAD_DATA("16") \
-ASM_SEND_DATA() \
-ASM_DELAY1() \
-ASM_SET_REQ_LOW() \
-ASM_DELAY2() \
-ASM_LOAD_DATA("24") \
-ASM_SEND_DATA() \
-ASM_DELAY1() \
-ASM_SET_REQ_LOW() \
-
-// Specialized routine for settings:
-// <=100 ns period, >=15 outstanding REQs
-static void sync_send_100ns_15off(const uint8_t *buf, uint32_t num_bytes, volatile int *resetFlag)
-{
-    volatile uint32_t *out_port_bop = (volatile uint32_t*)&GPIO_BOP(SCSI_OUT_PORT);
-    volatile uint32_t *ack_timer = &TIMER_CNT(SCSI_SYNC_TIMER);
-    const uint32_t *byte_lookup = g_scsi_out_byte_to_bop;
-    register uint32_t tmp1 = 0;
-    register uint32_t tmp2 = 0;
-    register uint32_t data = 0;
-
-// Delay 1 is typically longest and delay 2 shortest.
-// Tuning these is just trial and error.
-#define ASM_DELAY1() "    nop\n   nop\n   nop\n"
-#define ASM_DELAY2() "    nop\n   nop\n"
-
-    asm volatile (
-    "main_loop_%=: \n"
-        "   subs  %[num_bytes], %[num_bytes], #16 \n"
-        "   bmi     last_bytes_%= \n"
-
-        /* At each point make sure there is at most 15 bytes in flight */
-        "   ldr   %[data], [%[buf]], #4 \n"
-        ASM_SEND_4BYTES_WAIT("22")
-        "   ldr   %[data], [%[buf]], #4 \n"
-        ASM_SEND_4BYTES()
-        "   ldr   %[data], [%[buf]], #4 \n"
-        ASM_SEND_4BYTES_WAIT("14")
-        "   ldr   %[data], [%[buf]], #4 \n"
-        ASM_SEND_4BYTES()
-
-        "   cbz   %[num_bytes], all_done_%= \n"
-        "   b     main_loop_%= \n"
-
-    "last_bytes_%=: \n"
-        "   add  %[num_bytes], %[num_bytes], #16 \n"
-    "last_bytes_loop_%=: \n"
-        "   ldrb    %[data], [%[buf]], #1 \n"
-        ASM_LOAD_DATA("0")
-
-        ASM_WAIT_ACK_TIMER("15")
-        ASM_SEND_DATA()
-        ASM_DELAY1()
-        ASM_SET_REQ_LOW()
-
-        "   subs %[num_bytes], %[num_bytes], #1 \n"
-        "   bne  last_bytes_loop_%= \n"
-    "all_done_%=: \n"
-        ASM_DELAY()
-
-    : /* Output */ [tmp1] "+l" (tmp1), [tmp2] "+l" (tmp2), [data] "+r" (data),
-                   [buf] "+r" (buf), [num_bytes] "+r" (num_bytes)
-    : /* Input */ [ack_timer] "r" (ack_timer),
-                  [bop_req_low] "I" (SCSI_OUT_REQ << 16),
-                  [out_port_bop] "r"(out_port_bop),
-                  [byte_lookup] "r" (byte_lookup),
-                  [reset_flag] "r" (resetFlag)
-    : /* Clobber */);
-
-#undef ASM_DELAY1
-#undef ASM_DELAY2
-
-    SCSI_RELEASE_DATA_REQ();
-}
-
-// Specialized routine for settings:
-// <=200 ns period, >=15 outstanding REQs
-static void sync_send_200ns_15off(const uint8_t *buf, uint32_t num_bytes, volatile int *resetFlag)
-{
-    volatile uint32_t *out_port_bop = (volatile uint32_t*)&GPIO_BOP(SCSI_OUT_PORT);
-    volatile uint32_t *ack_timer = &TIMER_CNT(SCSI_SYNC_TIMER);
-    const uint32_t *byte_lookup = g_scsi_out_byte_to_bop;
-    register uint32_t tmp1 = 0;
-    register uint32_t tmp2 = 0;
-    register uint32_t data = 0;
-
-#define ASM_DELAY1() ASM_DELAY() ASM_DELAY() ASM_DELAY() ASM_DELAY()
-#define ASM_DELAY2() ASM_DELAY() ASM_DELAY() ASM_DELAY()
-
-    asm volatile (
-    "main_loop_%=: \n"
-        "   subs  %[num_bytes], %[num_bytes], #16 \n"
-        "   bmi     last_bytes_%= \n"
-
-        /* At each point make sure there is at most 15 bytes in flight */
-        "   ldr   %[data], [%[buf]], #4 \n"
-        ASM_SEND_4BYTES_WAIT("22")
-        ASM_DELAY2()
-        "   ldr   %[data], [%[buf]], #4 \n"
-        ASM_SEND_4BYTES()
-        ASM_DELAY2()
-        "   ldr   %[data], [%[buf]], #4 \n"
-        ASM_SEND_4BYTES_WAIT("14")
-        ASM_DELAY2()
-        "   ldr   %[data], [%[buf]], #4 \n"
-        ASM_SEND_4BYTES()
-
-        "   cbz   %[num_bytes], all_done_%= \n"
-        "   b     main_loop_%= \n"
-
-    "last_bytes_%=: \n"
-        "   add  %[num_bytes], %[num_bytes], #16 \n"
-    "last_bytes_loop_%=: \n"
-        "   ldrb    %[data], [%[buf]], #1 \n"
-        ASM_LOAD_DATA("0")
-
-        ASM_WAIT_ACK_TIMER("15")
-        ASM_SEND_DATA()
-        ASM_DELAY1()
-        ASM_SET_REQ_LOW()
-        ASM_DELAY2()
-
-        "   subs %[num_bytes], %[num_bytes], #1 \n"
-        "   bne  last_bytes_loop_%= \n"
-    "all_done_%=: \n"
-        ASM_DELAY1()
-
-    : /* Output */ [tmp1] "+l" (tmp1), [tmp2] "+l" (tmp2), [data] "+r" (data),
-                   [buf] "+r" (buf), [num_bytes] "+r" (num_bytes)
-    : /* Input */ [ack_timer] "r" (ack_timer),
-                  [bop_req_low] "I" (SCSI_OUT_REQ << 16),
-                  [out_port_bop] "r"(out_port_bop),
-                  [byte_lookup] "r" (byte_lookup),
-                  [reset_flag] "r" (resetFlag)
-    : /* Clobber */);
-
-#undef ASM_DELAY1
-#undef ASM_DELAY2
-
-    SCSI_RELEASE_DATA_REQ();
-}
-
-// Specialized routine for settings:
-// <=260 ns period, >=7 outstanding REQs
-static void sync_send_260ns_7off(const uint8_t *buf, uint32_t num_bytes, volatile int *resetFlag)
-{
-    volatile uint32_t *out_port_bop = (volatile uint32_t*)&GPIO_BOP(SCSI_OUT_PORT);
-    volatile uint32_t *ack_timer = &TIMER_CNT(SCSI_SYNC_TIMER);
-    const uint32_t *byte_lookup = g_scsi_out_byte_to_bop;
-    register uint32_t tmp1 = 0;
-    register uint32_t tmp2 = 0;
-    register uint32_t data = 0;
-
-#define ASM_DELAY1() ASM_DELAY() ASM_DELAY() ASM_DELAY() ASM_DELAY() \
-                     ASM_DELAY() ASM_DELAY()
-#define ASM_DELAY2() ASM_DELAY() ASM_DELAY() ASM_DELAY() ASM_DELAY() \
-                     ASM_DELAY() ASM_DELAY() ASM_DELAY() ASM_DELAY()
-
-    asm volatile (
-    "main_loop_%=: \n"
-        "   subs  %[num_bytes], %[num_bytes], #4 \n"
-        "   bmi     last_bytes_%= \n"
-
-        /* At each point make sure there is at most 3 bytes in flight */
-        "   ldr   %[data], [%[buf]], #4 \n"
-        ASM_SEND_4BYTES_WAIT("7")
-
-        "   cbz   %[num_bytes], all_done_%= \n"
-        "   b     main_loop_%= \n"
-
-    "last_bytes_%=: \n"
-        "   add  %[num_bytes], %[num_bytes], #4 \n"
-    "last_bytes_loop_%=: \n"
-        "   ldrb    %[data], [%[buf]], #1 \n"
-        ASM_LOAD_DATA("0")
-
-        ASM_WAIT_ACK_TIMER("5")
-        ASM_SEND_DATA()
-        ASM_DELAY1()
-        ASM_SET_REQ_LOW()
-        ASM_DELAY2()
-
-        "   subs %[num_bytes], %[num_bytes], #1 \n"
-        "   bne  last_bytes_loop_%= \n"
-    "all_done_%=: \n"
-        ASM_DELAY1()
-
-    : /* Output */ [tmp1] "+l" (tmp1), [tmp2] "+l" (tmp2), [data] "+r" (data),
-                   [buf] "+r" (buf), [num_bytes] "+r" (num_bytes)
-    : /* Input */ [ack_timer] "r" (ack_timer),
-                  [bop_req_low] "I" (SCSI_OUT_REQ << 16),
-                  [out_port_bop] "r"(out_port_bop),
-                  [byte_lookup] "r" (byte_lookup),
-                  [reset_flag] "r" (resetFlag)
-    : /* Clobber */);
-
-#undef ASM_DELAY1
-#undef ASM_DELAY2
-
-    SCSI_RELEASE_DATA_REQ();
-}
-
-void scsi_accel_sync_send(const uint8_t* data, uint32_t count, volatile int *resetFlag)
-{
-    // Timer counts down from the initial number of bytes.
-    TIMER_CNT(SCSI_SYNC_TIMER) = count;
-    TIMER_CTL0(SCSI_SYNC_TIMER) = TIMER_CTL0_CEN | TIMER_CTL0_DIR;
-
-    int syncOffset = scsiDev.target->syncOffset;
-    int syncPeriod = scsiDev.target->syncPeriod;
-
-    if (syncOffset >= 15 && syncPeriod <= 25)
-    {
-        sync_send_100ns_15off(data, count, resetFlag);
-    }
-    else if (syncOffset >= 15 && syncPeriod <= 50)
-    {
-        sync_send_200ns_15off(data, count, resetFlag);
-    }
-    else if (syncOffset >= 7 && syncPeriod <= 65)
-    {
-        sync_send_260ns_7off(data, count, resetFlag);
-    }
-    else
-    {
-        bluedbg("No optimized routine for syncOffset=", syncOffset, " syndPeriod=", syncPeriod, ", using fallback");
-        while (count-- > 0)
-        {
-            while (TIMER_CNT(SCSI_SYNC_TIMER) > count + syncOffset && !*resetFlag);
-
-            SCSI_OUT_DATA(*data++);
-            delay_ns(syncPeriod * 2);
-            SCSI_OUT(REQ, 0);
-            delay_ns(syncPeriod * 2);
-        }
-        delay_ns(syncPeriod * 2);
-        SCSI_RELEASE_DATA_REQ();
-    }
-
-    while (TIMER_CNT(SCSI_SYNC_TIMER) > 0 && !*resetFlag);
-
-    if (*resetFlag)
-    {
-        bluedbg("Bus reset during sync transfer, total ", (int)count,
-              " bytes, remaining ACK count ", (int)TIMER_CNT(SCSI_SYNC_TIMER));
-    }
-
-    TIMER_CTL0(SCSI_SYNC_TIMER) = 0;
-}
-
-
-#endif

lib/BlueSCSI_platform_GD32F205/scsi_accel_sync.h

@@ -1,17 +0,0 @@
-// SCSI subroutines that implement synchronous mode SCSI.
-// Uses DMA for data transfer, EXMC for data input and
-// GD32 timer for the REQ pin toggling.
-
-#pragma once
-
-#include <stdint.h>
-#include "BlueSCSI_platform.h"
-
-#ifdef SCSI_IN_ACK_EXMC_NWAIT_PORT
-#define SCSI_SYNC_MODE_AVAILABLE
-#endif
-
-void scsi_accel_sync_init();
-
-void scsi_accel_sync_recv(uint8_t *data, uint32_t count, int* parityError, volatile int *resetFlag);
-void scsi_accel_sync_send(const uint8_t* data, uint32_t count, volatile int *resetFlag);

lib/BlueSCSI_platform_GD32F205/sd_card_sdio.cpp

@@ -1,310 +0,0 @@
-// Driver and interface for accessing SD card in SDIO mode
-// Used on BlueSCSI v1.1.
-
-#include "BlueSCSI_platform.h"
-
-#ifdef SD_USE_SDIO
-
-#include "BlueSCSI_log.h"
-#include "gd32f20x_sdio.h"
-#include "gd32f20x_dma.h"
-#include "gd32_sdio_sdcard.h"
-#include <SdFat.h>
-
-static sd_error_enum g_sdio_error = SD_OK;
-static int g_sdio_error_line = 0;
-static uint32_t g_sdio_card_status;
-static uint32_t g_sdio_clk_kHz;
-static sdio_card_type_enum g_sdio_card_type;
-static uint16_t g_sdio_card_rca;
-static uint32_t g_sdio_sector_count;
-
-#define checkReturnOk(call) ((g_sdio_error = (call)) == SD_OK ? true : logSDError(__LINE__))
-static bool logSDError(int line)
-{
-    g_sdio_error_line = line;
-    bluelog("SDIO SD card error on line ", line, ", error code ", (int)g_sdio_error);
-    return false;
-}
-
-bool SdioCard::begin(SdioConfig sdioConfig)
-{
-    rcu_periph_clock_enable(RCU_SDIO);
-    rcu_periph_clock_enable(RCU_DMA1);
-    nvic_irq_enable(SDIO_IRQn, 0, 0);
-
-    g_sdio_error = sd_init();
-    if (g_sdio_error != SD_OK)
-    {
-        // Don't spam the log when main program polls for card insertion.
-        bluedbg("sd_init() failed: ", (int)g_sdio_error);
-        return false;
-    }
-
-    return checkReturnOk(sd_card_information_get_short(&g_sdio_card_type, &g_sdio_card_rca))
-        && checkReturnOk(sd_card_select_deselect(g_sdio_card_rca))
-        && checkReturnOk(sd_cardstatus_get(&g_sdio_card_status))
-        && checkReturnOk(sd_bus_mode_config(SDIO_BUSMODE_4BIT))
-        && checkReturnOk(sd_transfer_mode_config(sdioConfig.useDma() ? SD_DMA_MODE : SD_POLLING_MODE))
-        && (g_sdio_sector_count = sectorCount());
-}
-
-uint8_t SdioCard::errorCode() const
-{
-    if (g_sdio_error == SD_OK)
-        return SD_CARD_ERROR_NONE;
-    else
-        return 0x80 + g_sdio_error;
-}
-
-uint32_t SdioCard::errorData() const
-{
-    return 0;
-}
-
-uint32_t SdioCard::errorLine() const
-{
-    return g_sdio_error_line;
-}
-
-bool SdioCard::isBusy()
-{
-    return (GPIO_ISTAT(SD_SDIO_DATA_PORT) & SD_SDIO_D0) == 0;
-}
-
-uint32_t SdioCard::kHzSdClk()
-{
-    return g_sdio_clk_kHz;
-}
-
-bool SdioCard::readCID(cid_t* cid)
-{
-    sd_cid_get((uint8_t*)cid);
-    return true;
-}
-
-bool SdioCard::readCSD(csd_t* csd)
-{
-    sd_csd_get((uint8_t*)csd);
-    return true;
-}
-
-bool SdioCard::readOCR(uint32_t* ocr)
-{
-    // SDIO mode does not have CMD58, but main program uses this to
-    // poll for card presence. Return status register instead.
-    return sd_cardstatus_get(ocr) == SD_OK;
-}
-
-bool SdioCard::readData(uint8_t* dst)
-{
-    bluelog("SdioCard::readData() called but not implemented!");
-    return false;
-}
-
-bool SdioCard::readStart(uint32_t sector)
-{
-    bluelog("SdioCard::readStart() called but not implemented!");
-    return false;
-}
-
-bool SdioCard::readStop()
-{
-    bluelog("SdioCard::readStop() called but not implemented!");
-    return false;
-}
-
-uint32_t SdioCard::sectorCount()
-{
-    csd_t csd;
-    sd_csd_get((uint8_t*)&csd);
-    return sdCardCapacity(&csd);
-}
-
-uint32_t SdioCard::status()
-{
-    uint32_t status = 0;
-    if (!checkReturnOk(sd_cardstatus_get(&status)))
-        return 0;
-    else
-        return status;
-}
-
-bool SdioCard::stopTransmission(bool blocking)
-{
-    if (!checkReturnOk(sd_transfer_stop()))
-        return false;
-
-    if (!blocking)
-    {
-        return true;
-    }
-    else
-    {
-        uint32_t end = millis() + 100;
-        while (millis() < end && isBusy())
-        {
-        }
-        if (isBusy())
-        {
-            bluelog("SdioCard::stopTransmission() timeout");
-            return false;
-        }
-        else
-        {
-            return true;
-        }
-    }
-}
-
-bool SdioCard::syncDevice()
-{
-    if (sd_transfer_state_get() != SD_NO_TRANSFER)
-    {
-        return stopTransmission(true);
-    }
-    return true;
-}
-
-uint8_t SdioCard::type() const
-{
-    if (g_sdio_card_type == SDIO_HIGH_CAPACITY_SD_CARD)
-        return SD_CARD_TYPE_SDHC;
-    else if (g_sdio_card_type == SDIO_STD_CAPACITY_SD_CARD_V2_0)
-        return SD_CARD_TYPE_SD2;
-    else
-        return SD_CARD_TYPE_SD1;
-}
-
-bool SdioCard::writeData(const uint8_t* src)
-{
-    bluelog("SdioCard::writeData() called but not implemented!");
-    return false;
-}
-
-bool SdioCard::writeStart(uint32_t sector)
-{
-    bluelog("SdioCard::writeStart() called but not implemented!");
-    return false;
-}
-
-bool SdioCard::writeStop()
-{
-    bluelog("SdioCard::writeStop() called but not implemented!");
-    return false;
-}
-
-bool SdioCard::erase(uint32_t firstSector, uint32_t lastSector)
-{
-    return checkReturnOk(sd_erase(firstSector * 512, lastSector * 512));
-}
-
-/* Writing and reading, with progress callback */
-
-static sd_callback_t m_stream_callback;
-static const uint8_t *m_stream_buffer;
-static uint32_t m_stream_count;
-static uint32_t m_stream_count_start;
-
-void bluescsiplatform_set_sd_callback(sd_callback_t func, const uint8_t *buffer)
-{
-    m_stream_callback = func;
-    m_stream_buffer = buffer;
-    m_stream_count = 0;
-    m_stream_count_start = 0;
-}
-
-static void sdio_callback(uint32_t complete)
-{
-    if (m_stream_callback)
-    {
-        m_stream_callback(m_stream_count_start + complete);
-    }
-}
-
-static sdio_callback_t get_stream_callback(const uint8_t *buf, uint32_t count, const char *accesstype, uint32_t sector)
-{
-    m_stream_count_start = m_stream_count;
-
-    if (m_stream_callback)
-    {
-        if (buf == m_stream_buffer + m_stream_count)
-        {
-            m_stream_count += count;
-            return &sdio_callback;
-        }
-        else
-        {
-            bluedbg("SD card ", accesstype, "(", (int)sector,
-                  ") slow transfer, buffer", (uint32_t)buf, " vs. ", (uint32_t)(m_stream_buffer + m_stream_count));
-            return NULL;
-        }
-    }
-
-    return NULL;
-}
-
-
-bool SdioCard::writeSector(uint32_t sector, const uint8_t* src)
-{
-    return checkReturnOk(sd_block_write((uint32_t*)src, (uint64_t)sector * 512, 512,
-        get_stream_callback(src, 512, "writeSector", sector)));
-}
-
-bool SdioCard::writeSectors(uint32_t sector, const uint8_t* src, size_t n)
-{
-    return checkReturnOk(sd_multiblocks_write((uint32_t*)src, (uint64_t)sector * 512, 512, n,
-        get_stream_callback(src, n * 512, "writeSectors", sector)));
-}
-
-bool SdioCard::readSector(uint32_t sector, uint8_t* dst)
-{
-    return checkReturnOk(sd_block_read((uint32_t*)dst, (uint64_t)sector * 512, 512,
-        get_stream_callback(dst, 512, "readSector", sector)));
-}
-
-bool SdioCard::readSectors(uint32_t sector, uint8_t* dst, size_t n)
-{
-    if (sector + n >= g_sdio_sector_count)
-    {
-        // sd_multiblocks_read() seems to have trouble reading the very last sector
-        for (int i = 0; i < n; i++)
-        {
-            if (!readSector(sector + i, dst + i * 512))
-            {
-                bluelog("End of drive read failed at ", sector, " + ", i);
-                return false;
-            }
-        }
-        return true;
-    }
-
-    return checkReturnOk(sd_multiblocks_read((uint32_t*)dst, (uint64_t)sector * 512, 512, n,
-        get_stream_callback(dst, n * 512, "readSectors", sector)));
-}
-
-// Check if a DMA request for SD card read has completed.
-// This is used to optimize the timing of data transfers on SCSI bus.
-bool check_sd_read_done()
-{
-    return (DMA_CHCTL(DMA1, DMA_CH3) & DMA_CHXCTL_CHEN)
-        && (DMA_INTF(DMA1) & DMA_FLAG_ADD(DMA_FLAG_FTF, DMA_CH3));
-}
-
-// These functions are not used for SDIO mode but are needed to avoid build error.
-void sdCsInit(SdCsPin_t pin) {}
-void sdCsWrite(SdCsPin_t pin, bool level) {}
-
-// Interrupt handler for SDIO
-extern "C" void SDIO_IRQHandler(void)
-{
-    sd_interrupts_process();
-}
-
-// SDIO configuration for main program
-SdioConfig g_sd_sdio_config(DMA_SDIO);
-
-// SDIO configuration in crash
-SdioConfig g_sd_sdio_config_crash(0);
-
-#endif

lib/BlueSCSI_platform_GD32F205/sd_card_spi.cpp

@@ -1,274 +0,0 @@
-// Driver and interface for accessing SD card in SPI mode
-// Used on BlueSCSI v1.0.
-
-#include "BlueSCSI_platform.h"
-#include "BlueSCSI_log.h"
-#include "gd32f20x_spi.h"
-#include "gd32f20x_dma.h"
-#include <SdFat.h>
-
-#ifndef SD_USE_SDIO
-
-class GD32SPIDriver : public SdSpiBaseClass
-{
-public:
-    void begin(SdSpiConfig config) {
-        rcu_periph_clock_enable(RCU_SPI0);
-        rcu_periph_clock_enable(RCU_DMA0);
-
-        dma_parameter_struct rx_dma_config =
-        {
-            .periph_addr = (uint32_t)&SPI_DATA(SD_SPI),
-            .periph_width = DMA_PERIPHERAL_WIDTH_8BIT,
-            .memory_addr = 0, // Set before transfer
-            .memory_width = DMA_MEMORY_WIDTH_8BIT,
-            .number = 0, // Set before transfer
-            .priority = DMA_PRIORITY_ULTRA_HIGH,
-            .periph_inc = DMA_PERIPH_INCREASE_DISABLE,
-            .memory_inc = DMA_MEMORY_INCREASE_ENABLE,
-            .direction = DMA_PERIPHERAL_TO_MEMORY
-        };
-        dma_init(DMA0, SD_SPI_RX_DMA_CHANNEL, &rx_dma_config);
-
-        dma_parameter_struct tx_dma_config =
-        {
-            .periph_addr = (uint32_t)&SPI_DATA(SD_SPI),
-            .periph_width = DMA_PERIPHERAL_WIDTH_8BIT,
-            .memory_addr = 0, // Set before transfer
-            .memory_width = DMA_MEMORY_WIDTH_8BIT,
-            .number = 0, // Set before transfer
-            .priority = DMA_PRIORITY_HIGH,
-            .periph_inc = DMA_PERIPH_INCREASE_DISABLE,
-            .memory_inc = DMA_MEMORY_INCREASE_ENABLE,
-            .direction = DMA_MEMORY_TO_PERIPHERAL
-        };
-        dma_init(DMA0, SD_SPI_TX_DMA_CHANNEL, &tx_dma_config);
-    }
-
-    void activate() {
-        spi_parameter_struct config = {
-            SPI_MASTER,
-            SPI_TRANSMODE_FULLDUPLEX,
-            SPI_FRAMESIZE_8BIT,
-            SPI_NSS_SOFT,
-            SPI_ENDIAN_MSB,
-            SPI_CK_PL_LOW_PH_1EDGE,
-            SPI_PSC_256
-        };
-
-        // Select closest available divider based on system frequency
-        int divider = (SystemCoreClock + m_sckfreq / 2) / m_sckfreq;
-        if (divider <= 2)
-            config.prescale = SPI_PSC_2;
-        else if (divider <= 4)
-            config.prescale = SPI_PSC_4;
-        else if (divider <= 8)
-            config.prescale = SPI_PSC_8;
-        else if (divider <= 16)
-            config.prescale = SPI_PSC_16;
-        else if (divider <= 32)
-            config.prescale = SPI_PSC_32;
-        else if (divider <= 64)
-            config.prescale = SPI_PSC_64;
-        else if (divider <= 128)
-            config.prescale = SPI_PSC_128;
-        else
-            config.prescale = SPI_PSC_256;
-
-        spi_init(SD_SPI, &config);
-        spi_enable(SD_SPI);
-    }
-
-    void deactivate() {
-        spi_disable(SD_SPI);
-    }
-
-    void wait_idle() {
-        while (!(SPI_STAT(SD_SPI) & SPI_STAT_TBE));
-        while (SPI_STAT(SD_SPI) & SPI_STAT_TRANS);
-    }
-
-    // Single byte receive
-    uint8_t receive() {
-        // Wait for idle and clear RX buffer
-        wait_idle();
-        (void)SPI_DATA(SD_SPI);
-
-        // Send dummy byte and wait for receive
-        SPI_DATA(SD_SPI) = 0xFF;
-        while (!(SPI_STAT(SD_SPI) & SPI_STAT_RBNE));
-        return SPI_DATA(SD_SPI);
-    }
-
-    // Single byte send
-    void send(uint8_t data) {
-        SPI_DATA(SD_SPI) = data;
-        wait_idle();
-    }
-
-    // Multiple byte receive
-    uint8_t receive(uint8_t* buf, size_t count)
-    {
-        // Wait for idle and clear RX buffer
-        wait_idle();
-        (void)SPI_DATA(SD_SPI);
-
-        // Check if this is part of callback streaming request
-        bool stream = false;
-        if (m_stream_callback && buf == m_stream_buffer + m_stream_count)
-        {
-            stream = true;
-        }
-        else if (m_stream_callback)
-        {
-            bluedbg("Stream buffer mismatch: ", (uint32_t)buf, " vs. ", (uint32_t)(m_stream_buffer + m_stream_count));
-        }
-
-        // Use DMA to stream dummy TX data and store RX data
-        uint8_t tx_data = 0xFF;
-        DMA_INTC(DMA0) = DMA_FLAG_ADD(DMA_FLAG_FTF | DMA_FLAG_ERR, SD_SPI_RX_DMA_CHANNEL);
-        DMA_INTC(DMA0) = DMA_FLAG_ADD(DMA_FLAG_FTF | DMA_FLAG_ERR, SD_SPI_TX_DMA_CHANNEL);
-        DMA_CHMADDR(DMA0, SD_SPI_RX_DMA_CHANNEL) = (uint32_t)buf;
-        DMA_CHMADDR(DMA0, SD_SPI_TX_DMA_CHANNEL) = (uint32_t)&tx_data;
-        DMA_CHCTL(DMA0, SD_SPI_TX_DMA_CHANNEL) &= ~DMA_CHXCTL_MNAGA; // No memory increment for TX
-        DMA_CHCNT(DMA0, SD_SPI_RX_DMA_CHANNEL) = count;
-        DMA_CHCNT(DMA0, SD_SPI_TX_DMA_CHANNEL) = count;
-        DMA_CHCTL(DMA0, SD_SPI_RX_DMA_CHANNEL) |= DMA_CHXCTL_CHEN;
-        DMA_CHCTL(DMA0, SD_SPI_TX_DMA_CHANNEL) |= DMA_CHXCTL_CHEN;
-
-        SPI_CTL1(SD_SPI) |= SPI_CTL1_DMAREN | SPI_CTL1_DMATEN;
-
-        uint32_t start = millis();
-        while (!(DMA_INTF(DMA0) & DMA_FLAG_ADD(DMA_FLAG_FTF | DMA_FLAG_ERR, SD_SPI_RX_DMA_CHANNEL)))
-        {
-            if (millis() - start > 500)
-            {
-                bluelog("ERROR: SPI DMA receive of ", (int)count, " bytes timeouted");
-                return 1;
-            }
-
-            if (stream)
-            {
-                uint32_t complete = m_stream_count + (count - DMA_CHCNT(DMA0, SD_SPI_RX_DMA_CHANNEL));
-                m_stream_callback(complete);
-            }
-        }
-
-        if (DMA_INTF(DMA0) & DMA_FLAG_ADD(DMA_FLAG_ERR, SD_SPI_RX_DMA_CHANNEL))
-        {
-            bluelog("ERROR: SPI DMA receive set DMA_FLAG_ERR");
-        }
-
-        SPI_CTL1(SD_SPI) &= ~(SPI_CTL1_DMAREN | SPI_CTL1_DMATEN);
-        DMA_CHCTL(DMA0, SD_SPI_RX_DMA_CHANNEL) &= ~DMA_CHXCTL_CHEN;
-        DMA_CHCTL(DMA0, SD_SPI_TX_DMA_CHANNEL) &= ~DMA_CHXCTL_CHEN;
-
-        if (stream)
-        {
-            m_stream_count += count;
-        }
-
-        return 0;
-    }
-
-    // Multiple byte send
-    void send(const uint8_t* buf, size_t count) {
-        // Check if this is part of callback streaming request
-        bool stream = false;
-        if (m_stream_callback && buf == m_stream_buffer + m_stream_count)
-        {
-            stream = true;
-        }
-        else if (m_stream_callback)
-        {
-            bluedbg("Stream buffer mismatch: ", (uint32_t)buf, " vs. ", (uint32_t)(m_stream_buffer + m_stream_count));
-        }
-
-        // Use DMA to stream TX data
-        DMA_INTC(DMA0) = DMA_FLAG_ADD(DMA_FLAG_FTF | DMA_FLAG_ERR, SD_SPI_TX_DMA_CHANNEL);
-        DMA_CHMADDR(DMA0, SD_SPI_TX_DMA_CHANNEL) = (uint32_t)buf;
-        DMA_CHCTL(DMA0, SD_SPI_TX_DMA_CHANNEL) |= DMA_CHXCTL_MNAGA; // Memory increment for TX
-        DMA_CHCNT(DMA0, SD_SPI_TX_DMA_CHANNEL) = count;
-        DMA_CHCTL(DMA0, SD_SPI_TX_DMA_CHANNEL) |= DMA_CHXCTL_CHEN;
-
-        SPI_CTL1(SD_SPI) |= SPI_CTL1_DMATEN;
-
-        uint32_t start = millis();
-        while (!(DMA_INTF(DMA0) & DMA_FLAG_ADD(DMA_FLAG_FTF | DMA_FLAG_ERR, SD_SPI_TX_DMA_CHANNEL)))
-        {
-            if (millis() - start > 500)
-            {
-                bluelog("ERROR: SPI DMA transmit of ", (int)count, " bytes timeouted");
-                return;
-            }
-
-            if (stream)
-            {
-                uint32_t complete = m_stream_count + (count - DMA_CHCNT(DMA0, SD_SPI_TX_DMA_CHANNEL));
-                m_stream_callback(complete);
-            }
-        }
-
-        if (DMA_INTF(DMA0) & DMA_FLAG_ADD(DMA_FLAG_ERR, SD_SPI_TX_DMA_CHANNEL))
-        {
-            bluelog("ERROR: SPI DMA transmit set DMA_FLAG_ERR");
-        }
-
-        wait_idle();
-
-        SPI_CTL1(SD_SPI) &= ~(SPI_CTL1_DMAREN | SPI_CTL1_DMATEN);
-        DMA_CHCTL(DMA0, SD_SPI_TX_DMA_CHANNEL) &= ~DMA_CHXCTL_CHEN;
-
-        if (stream)
-        {
-            m_stream_count += count;
-        }
-    }
-
-    void setSckSpeed(uint32_t maxSck) {
-        m_sckfreq = maxSck;
-    }
-
-    void set_sd_callback(sd_callback_t func, const uint8_t *buffer)
-    {
-        m_stream_buffer = buffer;
-        m_stream_count = 0;
-        m_stream_callback = func;
-    }
-
-private:
-    uint32_t m_sckfreq;
-    const uint8_t *m_stream_buffer;
-    uint32_t m_stream_count;
-    sd_callback_t m_stream_callback;
-};
-
-void sdCsInit(SdCsPin_t pin)
-{
-}
-
-void sdCsWrite(SdCsPin_t pin, bool level)
-{
-    if (level)
-        GPIO_BOP(SD_PORT) = SD_CS_PIN;
-    else
-        GPIO_BC(SD_PORT) = SD_CS_PIN;
-}
-
-GD32SPIDriver g_sd_spi_port;
-SdSpiConfig g_sd_spi_config(0, DEDICATED_SPI, SD_SCK_MHZ(30), &g_sd_spi_port);
-
-void bluescsiplatform_set_sd_callback(sd_callback_t func, const uint8_t *buffer)
-{
-    g_sd_spi_port.set_sd_callback(func, buffer);
-}
-
-// Check if a DMA request for SD card read has completed.
-// This is used to optimize the timing of data transfers on SCSI bus.
-bool check_sd_read_done()
-{
-    return (DMA_CHCTL(DMA0, SD_SPI_RX_DMA_CHANNEL) & DMA_CHXCTL_CHEN)
-        && (DMA_INTF(DMA0) & DMA_FLAG_ADD(DMA_FLAG_FTF, SD_SPI_RX_DMA_CHANNEL));
-}
-
-#endif

lib/SdFat_NoArduino/.gitattributes

@@ -1,22 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto
-
-# Custom for Visual Studio
-*.cs     diff=csharp
-*.sln    merge=union
-*.csproj merge=union
-*.vbproj merge=union
-*.fsproj merge=union
-*.dbproj merge=union
-
-# Standard to msysgit
-*.doc	 diff=astextplain
-*.DOC	 diff=astextplain
-*.docx diff=astextplain
-*.DOCX diff=astextplain
-*.dot  diff=astextplain
-*.DOT  diff=astextplain
-*.pdf  diff=astextplain
-*.PDF	 diff=astextplain
-*.rtf	 diff=astextplain
-*.RTF	 diff=astextplain

lib/SdFat_NoArduino/.gitignore

@@ -1,215 +0,0 @@
-#################
-## Eclipse
-#################
-
-*.pydevproject
-.project
-.metadata
-bin/
-tmp/
-*.tmp
-*.bak
-*.swp
-*~.nib
-local.properties
-.classpath
-.settings/
-.loadpath
-
-# External tool builders
-.externalToolBuilders/
-
-# Locally stored "Eclipse launch configurations"
-*.launch
-
-# CDT-specific
-.cproject
-
-# PDT-specific
-.buildpath
-
-
-#################
-## Visual Studio
-#################
-
-## Ignore Visual Studio temporary files, build results, and
-## files generated by popular Visual Studio add-ons.
-
-# User-specific files
-*.suo
-*.user
-*.sln.docstates
-
-# Build results
-
-[Dd]ebug/
-[Rr]elease/
-x64/
-build/
-[Bb]in/
-[Oo]bj/
-
-# MSTest test Results
-[Tt]est[Rr]esult*/
-[Bb]uild[Ll]og.*
-
-*_i.c
-*_p.c
-*.ilk
-*.meta
-*.obj
-*.pch
-*.pdb
-*.pgc
-*.pgd
-*.rsp
-*.sbr
-*.tlb
-*.tli
-*.tlh
-*.tmp
-*.tmp_proj
-*.log
-*.vspscc
-*.vssscc
-.builds
-*.pidb
-*.log
-*.scc
-
-# Visual C++ cache files
-ipch/
-*.aps
-*.ncb
-*.opensdf
-*.sdf
-*.cachefile
-
-# Visual Studio profiler
-*.psess
-*.vsp
-*.vspx
-
-# Guidance Automation Toolkit
-*.gpState
-
-# ReSharper is a .NET coding add-in
-_ReSharper*/
-*.[Rr]e[Ss]harper
-
-# TeamCity is a build add-in
-_TeamCity*
-
-# DotCover is a Code Coverage Tool
-*.dotCover
-
-# NCrunch
-*.ncrunch*
-.*crunch*.local.xml
-
-# Installshield output folder
-[Ee]xpress/
-
-# DocProject is a documentation generator add-in
-DocProject/buildhelp/
-DocProject/Help/*.HxT
-DocProject/Help/*.HxC
-DocProject/Help/*.hhc
-DocProject/Help/*.hhk
-DocProject/Help/*.hhp
-DocProject/Help/Html2
-DocProject/Help/html
-
-# Click-Once directory
-publish/
-
-# Publish Web Output
-*.Publish.xml
-*.pubxml
-
-# NuGet Packages Directory
-## TODO: If you have NuGet Package Restore enabled, uncomment the next line
-#packages/
-
-# Windows Azure Build Output
-csx
-*.build.csdef
-
-# Windows Store app package directory
-AppPackages/
-
-# Others
-sql/
-*.Cache
-ClientBin/
-[Ss]tyle[Cc]op.*
-~$*
-*~
-*.dbmdl
-*.[Pp]ublish.xml
-*.pfx
-*.publishsettings
-
-# RIA/Silverlight projects
-Generated_Code/
-
-# Backup & report files from converting an old project file to a newer
-# Visual Studio version. Backup files are not needed, because we have git ;-)
-_UpgradeReport_Files/
-Backup*/
-UpgradeLog*.XML
-UpgradeLog*.htm
-
-# SQL Server files
-App_Data/*.mdf
-App_Data/*.ldf
-
-#############
-## Windows detritus
-#############
-
-# Windows image file caches
-Thumbs.db
-ehthumbs.db
-
-# Folder config file
-Desktop.ini
-
-# Recycle Bin used on file shares
-$RECYCLE.BIN/
-
-# Mac crap
-.DS_Store
-
-
-#############
-## Python
-#############
-
-*.py[co]
-
-# Packages
-*.egg
-*.egg-info
-dist/
-build/
-eggs/
-parts/
-var/
-sdist/
-develop-eggs/
-.installed.cfg
-
-# Installer logs
-pip-log.txt
-
-# Unit test / coverage reports
-.coverage
-.tox
-
-#Translations
-*.mo
-
-#Mr Developer
-.mr.developer.cfg

lib/SdFat_NoArduino/.piopm

@@ -1 +0,0 @@
-{"type": "library", "name": "SdFat", "version": "2.1.2", "spec": {"owner": "greiman", "id": 322, "name": "SdFat", "requirements": null, "url": null}}

lib/SdFat_NoArduino/LICENSE.md

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2011..2020 Bill Greiman
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

lib/SdFat_NoArduino/README.md

@@ -1,110 +0,0 @@
-### Warning: This is SdFat Version 2.
-
-Earlier releases of Version 1 are here:
-
-https://github.com/greiman/SdFat/releases
-
-UTF-8 encoded filenames are supported in v2.1.0 or later.
-
-Try the UnicodeFilenames example.  Here is output from ls:
-<pre>
-Type any character to begin
-ls:
-         0 😀/
-          20 россиянин
-          17 très élégant
-           9 狗.txt
-</pre>
-
-SdFat Version 2 supports FAT16/FAT32 and exFAT SD cards. It is mostly
-backward compatible with SdFat Version 1 for FAT16/FAT32 cards.
-
-exFAT supports files larger than 4GB so files sizes and positions are
-type uint64_t for classes that support exFAT.
-
-exFAT has many features not available in FAT16/FAT32.  exFAT has excellent
-support for contiguous files on flash devices and supports preallocation.
-
-If the SD card is the only SPI device, use dedicated SPI mode. This can
-greatly improve performance. See the bench example.
-
-Here is write performance for an old, 2011, card on a Due board.
-```
-Shared SPI:
-write speed and latency
-speed,max,min,avg
-KB/Sec,usec,usec,usec
-294.45,24944,1398,1737
-
-Dedicated SPI:
-write speed and latency
-speed,max,min,avg
-KB/Sec,usec,usec,usec
-3965.11,16733,110,127
-```
-The default version of SdFatConfig.h enables support for dedicated SPI and
-optimized access to contiguous files.  This makes SdFat Version 2 slightly
-larger than Version 1.  If these features are disabled, Version 2 is smaller
-than Version 1.
-
-The types for the classes SdFat and File are defined in SdFatConfig.h.
-The default version of SdFatConfig.h defines SdFat to only support FAT16/FAT32.
-SdFat and File are defined in terms of more basic classes by typedefs.  You
-can use these basic classes in applications.
-
-Support for exFAT requires a substantial amount of flash.  Here are sizes on
-an UNO for a simple program that opens a file, prints one line, and closes
-the file.
-```
-FAT16/FAT32 only: 9780 bytes flash, 875 bytes SRAM.
-
-exFAT only: 13830 bytes flash, 938 bytes SRAM.
-
-FAT16/FAT32/exFAT: 19326 bytes flash, 928 bytes SRAM.
-```
-The section below of SdFatConfig.h has been edited to uses FAT16/FAT32 for
-small AVR boards and FAT16/FAT32/exFAT for all other boards.
-```
-/**
- * File types for SdFat, File, SdFile, SdBaseFile, fstream,
- * ifstream, and ofstream.
- *
- * Set SDFAT_FILE_TYPE to:
- *
- * 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
- */
-#if defined(__AVR__) && FLASHEND < 0X8000
-// FAT16/FAT32 for 32K AVR boards.
-#define SDFAT_FILE_TYPE 1
-#else  // defined(__AVR__) && FLASHEND < 0X8000
-// FAT16/FAT32 and exFAT for all other boards.
-#define SDFAT_FILE_TYPE 3
-#endif  // defined(__AVR__) && FLASHEND < 0X8000
-```
-The SdBaseFile class has no Arduino Stream or Print support.
-
-The File class is derived from Stream and SdBaseFile.
-
-The SdFile class is derived from SdBaseFile and Print.
-
-Please try the examples.  Start with SdInfo, bench, and ExFatLogger.
-
-To use SdFat Version 2, unzip the download file, rename the library folder
-SdFat and place the SdFat folder into the libraries sub-folder in your main
-sketch folder.
-
-For more information see the Manual installation section of this guide:
-
-http://arduino.cc/en/Guide/Libraries
-
-A number of configuration options can be set by editing SdFatConfig.h
-define macros.  See the html documentation File tab for details.
-
-Please read the html documentation for this library in SdFat/doc/SdFat.html.
-Start with the  Main Page.  Next go to the Classes tab and read the
-documentation for the classes SdFat32, SdExFat, SdFs, File32, ExFile, FsFile.
-
-The SdFat and File classes are defined in terms of the above classes by
-typedefs. Edit SdFatConfig.h to select class options.
-
-Please continue by reading the html documentation in the SdFat/doc folder.

lib/SdFat_NoArduino/doc/Doxyfile

@@ -1,2685 +0,0 @@
-# Doxyfile 1.9.2
-
-# This file describes the settings to be used by the documentation system
-# doxygen (www.doxygen.org) for a project.
-#
-# All text after a double hash (##) is considered a comment and is placed in
-# front of the TAG it is preceding.
-#
-# All text after a single hash (#) is considered a comment and will be ignored.
-# The format is:
-# TAG = value [value, ...]
-# For lists, items can also be appended using:
-# TAG += value [value, ...]
-# Values that contain spaces should be placed between quotes (\" \").
-
-#---------------------------------------------------------------------------
-# Project related configuration options
-#---------------------------------------------------------------------------
-
-# This tag specifies the encoding used for all characters in the configuration
-# file that follow. The default is UTF-8 which is also the encoding used for all
-# text before the first occurrence of this tag. Doxygen uses libiconv (or the
-# iconv built into libc) for the transcoding. See
-# https://www.gnu.org/software/libiconv/ for the list of possible encodings.
-# The default value is: UTF-8.
-
-DOXYFILE_ENCODING      = UTF-8
-
-# The PROJECT_NAME tag is a single word (or a sequence of words surrounded by
-# double-quotes, unless you are using Doxywizard) that should identify the
-# project for which the documentation is generated. This name is used in the
-# title of most generated pages and in a few other places.
-# The default value is: My Project.
-
-PROJECT_NAME           = SdFat
-
-# The PROJECT_NUMBER tag can be used to enter a project or revision number. This
-# could be handy for archiving the generated documentation or if some version
-# control system is used.
-
-PROJECT_NUMBER         =
-
-# Using the PROJECT_BRIEF tag one can provide an optional one line description
-# for a project that appears at the top of each page and should give viewer a
-# quick idea about the purpose of the project. Keep the description short.
-
-PROJECT_BRIEF          =
-
-# With the PROJECT_LOGO tag one can specify a logo or an icon that is included
-# in the documentation. The maximum height of the logo should not exceed 55
-# pixels and the maximum width should not exceed 200 pixels. Doxygen will copy
-# the logo to the output directory.
-
-PROJECT_LOGO           =
-
-# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
-# into which the generated documentation will be written. If a relative path is
-# entered, it will be relative to the location where doxygen was started. If
-# left blank the current directory will be used.
-
-OUTPUT_DIRECTORY       = .
-
-# If the CREATE_SUBDIRS tag is set to YES then doxygen will create 4096 sub-
-# directories (in 2 levels) under the output directory of each output format and
-# will distribute the generated files over these directories. Enabling this
-# option can be useful when feeding doxygen a huge amount of source files, where
-# putting all generated files in the same directory would otherwise causes
-# performance problems for the file system.
-# The default value is: NO.
-
-CREATE_SUBDIRS         = NO
-
-# If the ALLOW_UNICODE_NAMES tag is set to YES, doxygen will allow non-ASCII
-# characters to appear in the names of generated files. If set to NO, non-ASCII
-# characters will be escaped, for example _xE3_x81_x84 will be used for Unicode
-# U+3044.
-# The default value is: NO.
-
-ALLOW_UNICODE_NAMES    = NO
-
-# The OUTPUT_LANGUAGE tag is used to specify the language in which all
-# documentation generated by doxygen is written. Doxygen will use this
-# information to generate all constant output in the proper language.
-# Possible values are: Afrikaans, Arabic, Armenian, Brazilian, Catalan, Chinese,
-# Chinese-Traditional, Croatian, Czech, Danish, Dutch, English (United States),
-# Esperanto, Farsi (Persian), Finnish, French, German, Greek, Hungarian,
-# Indonesian, Italian, Japanese, Japanese-en (Japanese with English messages),
-# Korean, Korean-en (Korean with English messages), Latvian, Lithuanian,
-# Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese, Romanian, Russian,
-# Serbian, Serbian-Cyrillic, Slovak, Slovene, Spanish, Swedish, Turkish,
-# Ukrainian and Vietnamese.
-# The default value is: English.
-
-OUTPUT_LANGUAGE        = English
-
-# If the BRIEF_MEMBER_DESC tag is set to YES, doxygen will include brief member
-# descriptions after the members that are listed in the file and class
-# documentation (similar to Javadoc). Set to NO to disable this.
-# The default value is: YES.
-
-BRIEF_MEMBER_DESC      = YES
-
-# If the REPEAT_BRIEF tag is set to YES, doxygen will prepend the brief
-# description of a member or function before the detailed description
-#
-# Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
-# brief descriptions will be completely suppressed.
-# The default value is: YES.
-
-REPEAT_BRIEF           = YES
-
-# This tag implements a quasi-intelligent brief description abbreviator that is
-# used to form the text in various listings. Each string in this list, if found
-# as the leading text of the brief description, will be stripped from the text
-# and the result, after processing the whole list, is used as the annotated
-# text. Otherwise, the brief description is used as-is. If left blank, the
-# following values are used ($name is automatically replaced with the name of
-# the entity):The $name class, The $name widget, The $name file, is, provides,
-# specifies, contains, represents, a, an and the.
-
-ABBREVIATE_BRIEF       = "The $name class" \
-                         "The $name widget" \
-                         "The $name file" \
-                         is \
-                         provides \
-                         specifies \
-                         contains \
-                         represents \
-                         a \
-                         an \
-                         the
-
-# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
-# doxygen will generate a detailed section even if there is only a brief
-# description.
-# The default value is: NO.
-
-ALWAYS_DETAILED_SEC    = NO
-
-# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
-# inherited members of a class in the documentation of that class as if those
-# members were ordinary class members. Constructors, destructors and assignment
-# operators of the base classes will not be shown.
-# The default value is: NO.
-
-INLINE_INHERITED_MEMB  = YES
-
-# If the FULL_PATH_NAMES tag is set to YES, doxygen will prepend the full path
-# before files name in the file list and in the header files. If set to NO the
-# shortest path that makes the file name unique will be used
-# The default value is: YES.
-
-FULL_PATH_NAMES        = YES
-
-# The STRIP_FROM_PATH tag can be used to strip a user-defined part of the path.
-# Stripping is only done if one of the specified strings matches the left-hand
-# part of the path. The tag can be used to show relative paths in the file list.
-# If left blank the directory from which doxygen is run is used as the path to
-# strip.
-#
-# Note that you can specify absolute paths here, but also relative paths, which
-# will be relative from the directory where doxygen is started.
-# This tag requires that the tag FULL_PATH_NAMES is set to YES.
-
-STRIP_FROM_PATH        = C:/Users/bill/Documents/
-
-# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of the
-# path mentioned in the documentation of a class, which tells the reader which
-# header file to include in order to use a class. If left blank only the name of
-# the header file containing the class definition is used. Otherwise one should
-# specify the list of include paths that are normally passed to the compiler
-# using the -I flag.
-
-STRIP_FROM_INC_PATH    =
-
-# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but
-# less readable) file names. This can be useful is your file systems doesn't
-# support long names like on DOS, Mac, or CD-ROM.
-# The default value is: NO.
-
-SHORT_NAMES            = NO
-
-# If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the
-# first line (until the first dot) of a Javadoc-style comment as the brief
-# description. If set to NO, the Javadoc-style will behave just like regular Qt-
-# style comments (thus requiring an explicit @brief command for a brief
-# description.)
-# The default value is: NO.
-
-JAVADOC_AUTOBRIEF      = NO
-
-# If the JAVADOC_BANNER tag is set to YES then doxygen will interpret a line
-# such as
-# /***************
-# as being the beginning of a Javadoc-style comment "banner". If set to NO, the
-# Javadoc-style will behave just like regular comments and it will not be
-# interpreted by doxygen.
-# The default value is: NO.
-
-JAVADOC_BANNER         = NO
-
-# If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
-# line (until the first dot) of a Qt-style comment as the brief description. If
-# set to NO, the Qt-style will behave just like regular Qt-style comments (thus
-# requiring an explicit \brief command for a brief description.)
-# The default value is: NO.
-
-QT_AUTOBRIEF           = NO
-
-# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a
-# multi-line C++ special comment block (i.e. a block of //! or /// comments) as
-# a brief description. This used to be the default behavior. The new default is
-# to treat a multi-line C++ comment block as a detailed description. Set this
-# tag to YES if you prefer the old behavior instead.
-#
-# Note that setting this tag to YES also means that rational rose comments are
-# not recognized any more.
-# The default value is: NO.
-
-MULTILINE_CPP_IS_BRIEF = NO
-
-# By default Python docstrings are displayed as preformatted text and doxygen's
-# special commands cannot be used. By setting PYTHON_DOCSTRING to NO the
-# doxygen's special commands can be used and the contents of the docstring
-# documentation blocks is shown as doxygen documentation.
-# The default value is: YES.
-
-PYTHON_DOCSTRING       = YES
-
-# If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the
-# documentation from any documented member that it re-implements.
-# The default value is: YES.
-
-INHERIT_DOCS           = NO
-
-# If the SEPARATE_MEMBER_PAGES tag is set to YES then doxygen will produce a new
-# page for each member. If set to NO, the documentation of a member will be part
-# of the file/class/namespace that contains it.
-# The default value is: NO.
-
-SEPARATE_MEMBER_PAGES  = NO
-
-# The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen
-# uses this value to replace tabs by spaces in code fragments.
-# Minimum value: 1, maximum value: 16, default value: 4.
-
-TAB_SIZE               = 8
-
-# This tag can be used to specify a number of aliases that act as commands in
-# the documentation. An alias has the form:
-# name=value
-# For example adding
-# "sideeffect=@par Side Effects:^^"
-# will allow you to put the command \sideeffect (or @sideeffect) in the
-# documentation, which will result in a user-defined paragraph with heading
-# "Side Effects:". Note that you cannot put \n's in the value part of an alias
-# to insert newlines (in the resulting output). You can put ^^ in the value part
-# of an alias to insert a newline as if a physical newline was in the original
-# file. When you need a literal { or } or , in the value part of an alias you
-# have to escape them by means of a backslash (\), this can lead to conflicts
-# with the commands \{ and \} for these it is advised to use the version @{ and
-# @} or use a double escape (\\{ and \\})
-
-ALIASES                =
-
-# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources
-# only. Doxygen will then generate output that is more tailored for C. For
-# instance, some of the names that are used will be different. The list of all
-# members will be omitted, etc.
-# The default value is: NO.
-
-OPTIMIZE_OUTPUT_FOR_C  = NO
-
-# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java or
-# Python sources only. Doxygen will then generate output that is more tailored
-# for that language. For instance, namespaces will be presented as packages,
-# qualified scopes will look different, etc.
-# The default value is: NO.
-
-OPTIMIZE_OUTPUT_JAVA   = NO
-
-# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
-# sources. Doxygen will then generate output that is tailored for Fortran.
-# The default value is: NO.
-
-OPTIMIZE_FOR_FORTRAN   = NO
-
-# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
-# sources. Doxygen will then generate output that is tailored for VHDL.
-# The default value is: NO.
-
-OPTIMIZE_OUTPUT_VHDL   = NO
-
-# Set the OPTIMIZE_OUTPUT_SLICE tag to YES if your project consists of Slice
-# sources only. Doxygen will then generate output that is more tailored for that
-# language. For instance, namespaces will be presented as modules, types will be
-# separated into more groups, etc.
-# The default value is: NO.
-
-OPTIMIZE_OUTPUT_SLICE  = NO
-
-# Doxygen selects the parser to use depending on the extension of the files it
-# parses. With this tag you can assign which parser to use for a given
-# extension. Doxygen has a built-in mapping, but you can override or extend it
-# using this tag. The format is ext=language, where ext is a file extension, and
-# language is one of the parsers supported by doxygen: IDL, Java, JavaScript,
-# Csharp (C#), C, C++, Lex, D, PHP, md (Markdown), Objective-C, Python, Slice,
-# VHDL, Fortran (fixed format Fortran: FortranFixed, free formatted Fortran:
-# FortranFree, unknown formatted Fortran: Fortran. In the later case the parser
-# tries to guess whether the code is fixed or free formatted code, this is the
-# default for Fortran type files). For instance to make doxygen treat .inc files
-# as Fortran files (default is PHP), and .f files as C (default is Fortran),
-# use: inc=Fortran f=C.
-#
-# Note: For files without extension you can use no_extension as a placeholder.
-#
-# Note that for custom extensions you also need to set FILE_PATTERNS otherwise
-# the files are not read by doxygen. When specifying no_extension you should add
-# * to the FILE_PATTERNS.
-#
-# Note see also the list of default file extension mappings.
-
-EXTENSION_MAPPING      =
-
-# If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments
-# according to the Markdown format, which allows for more readable
-# documentation. See https://daringfireball.net/projects/markdown/ for details.
-# The output of markdown processing is further processed by doxygen, so you can
-# mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in
-# case of backward compatibilities issues.
-# The default value is: YES.
-
-MARKDOWN_SUPPORT       = YES
-
-# When the TOC_INCLUDE_HEADINGS tag is set to a non-zero value, all headings up
-# to that level are automatically included in the table of contents, even if
-# they do not have an id attribute.
-# Note: This feature currently applies only to Markdown headings.
-# Minimum value: 0, maximum value: 99, default value: 5.
-# This tag requires that the tag MARKDOWN_SUPPORT is set to YES.
-
-TOC_INCLUDE_HEADINGS   = 0
-
-# When enabled doxygen tries to link words that correspond to documented
-# classes, or namespaces to their corresponding documentation. Such a link can
-# be prevented in individual cases by putting a % sign in front of the word or
-# globally by setting AUTOLINK_SUPPORT to NO.
-# The default value is: YES.
-
-AUTOLINK_SUPPORT       = YES
-
-# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
-# to include (a tag file for) the STL sources as input, then you should set this
-# tag to YES in order to let doxygen match functions declarations and
-# definitions whose arguments contain STL classes (e.g. func(std::string);
-# versus func(std::string) {}). This also make the inheritance and collaboration
-# diagrams that involve STL classes more complete and accurate.
-# The default value is: NO.
-
-BUILTIN_STL_SUPPORT    = NO
-
-# If you use Microsoft's C++/CLI language, you should set this option to YES to
-# enable parsing support.
-# The default value is: NO.
-
-CPP_CLI_SUPPORT        = NO
-
-# Set the SIP_SUPPORT tag to YES if your project consists of sip (see:
-# https://www.riverbankcomputing.com/software/sip/intro) sources only. Doxygen
-# will parse them like normal C++ but will assume all classes use public instead
-# of private inheritance when no explicit protection keyword is present.
-# The default value is: NO.
-
-SIP_SUPPORT            = NO
-
-# For Microsoft's IDL there are propget and propput attributes to indicate
-# getter and setter methods for a property. Setting this option to YES will make
-# doxygen to replace the get and set methods by a property in the documentation.
-# This will only work if the methods are indeed getting or setting a simple
-# type. If this is not the case, or you want to show the methods anyway, you
-# should set this option to NO.
-# The default value is: YES.
-
-IDL_PROPERTY_SUPPORT   = YES
-
-# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
-# tag is set to YES then doxygen will reuse the documentation of the first
-# member in the group (if any) for the other members of the group. By default
-# all members of a group must be documented explicitly.
-# The default value is: NO.
-
-DISTRIBUTE_GROUP_DOC   = NO
-
-# If one adds a struct or class to a group and this option is enabled, then also
-# any nested class or struct is added to the same group. By default this option
-# is disabled and one has to add nested compounds explicitly via \ingroup.
-# The default value is: NO.
-
-GROUP_NESTED_COMPOUNDS = NO
-
-# Set the SUBGROUPING tag to YES to allow class member groups of the same type
-# (for instance a group of public functions) to be put as a subgroup of that
-# type (e.g. under the Public Functions section). Set it to NO to prevent
-# subgrouping. Alternatively, this can be done per class using the
-# \nosubgrouping command.
-# The default value is: YES.
-
-SUBGROUPING            = YES
-
-# When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and unions
-# are shown inside the group in which they are included (e.g. using \ingroup)
-# instead of on a separate page (for HTML and Man pages) or section (for LaTeX
-# and RTF).
-#
-# Note that this feature does not work in combination with
-# SEPARATE_MEMBER_PAGES.
-# The default value is: NO.
-
-INLINE_GROUPED_CLASSES = NO
-
-# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions
-# with only public data fields or simple typedef fields will be shown inline in
-# the documentation of the scope in which they are defined (i.e. file,
-# namespace, or group documentation), provided this scope is documented. If set
-# to NO, structs, classes, and unions are shown on a separate page (for HTML and
-# Man pages) or section (for LaTeX and RTF).
-# The default value is: NO.
-
-INLINE_SIMPLE_STRUCTS  = NO
-
-# When TYPEDEF_HIDES_STRUCT tag is enabled, a typedef of a struct, union, or
-# enum is documented as struct, union, or enum with the name of the typedef. So
-# typedef struct TypeS {} TypeT, will appear in the documentation as a struct
-# with name TypeT. When disabled the typedef will appear as a member of a file,
-# namespace, or class. And the struct will be named TypeS. This can typically be
-# useful for C code in case the coding convention dictates that all compound
-# types are typedef'ed and only the typedef is referenced, never the tag name.
-# The default value is: NO.
-
-TYPEDEF_HIDES_STRUCT   = NO
-
-# The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This
-# cache is used to resolve symbols given their name and scope. Since this can be
-# an expensive process and often the same symbol appears multiple times in the
-# code, doxygen keeps a cache of pre-resolved symbols. If the cache is too small
-# doxygen will become slower. If the cache is too large, memory is wasted. The
-# cache size is given by this formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range
-# is 0..9, the default is 0, corresponding to a cache size of 2^16=65536
-# symbols. At the end of a run doxygen will report the cache usage and suggest
-# the optimal cache size from a speed point of view.
-# Minimum value: 0, maximum value: 9, default value: 0.
-
-LOOKUP_CACHE_SIZE      = 0
-
-# The NUM_PROC_THREADS specifies the number threads doxygen is allowed to use
-# during processing. When set to 0 doxygen will based this on the number of
-# cores available in the system. You can set it explicitly to a value larger
-# than 0 to get more control over the balance between CPU load and processing
-# speed. At this moment only the input processing can be done using multiple
-# threads. Since this is still an experimental feature the default is set to 1,
-# which effectively disables parallel processing. Please report any issues you
-# encounter. Generating dot graphs in parallel is controlled by the
-# DOT_NUM_THREADS setting.
-# Minimum value: 0, maximum value: 32, default value: 1.
-
-NUM_PROC_THREADS       = 1
-
-#---------------------------------------------------------------------------
-# Build related configuration options
-#---------------------------------------------------------------------------
-
-# If the EXTRACT_ALL tag is set to YES, doxygen will assume all entities in
-# documentation are documented, even if no documentation was available. Private
-# class members and static file members will be hidden unless the
-# EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES.
-# Note: This will also disable the warnings about undocumented members that are
-# normally produced when WARNINGS is set to YES.
-# The default value is: NO.
-
-EXTRACT_ALL            = NO
-
-# If the EXTRACT_PRIVATE tag is set to YES, all private members of a class will
-# be included in the documentation.
-# The default value is: NO.
-
-EXTRACT_PRIVATE        = NO
-
-# If the EXTRACT_PRIV_VIRTUAL tag is set to YES, documented private virtual
-# methods of a class will be included in the documentation.
-# The default value is: NO.
-
-EXTRACT_PRIV_VIRTUAL   = NO
-
-# If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal
-# scope will be included in the documentation.
-# The default value is: NO.
-
-EXTRACT_PACKAGE        = NO
-
-# If the EXTRACT_STATIC tag is set to YES, all static members of a file will be
-# included in the documentation.
-# The default value is: NO.
-
-EXTRACT_STATIC         = YES
-
-# If the EXTRACT_LOCAL_CLASSES tag is set to YES, classes (and structs) defined
-# locally in source files will be included in the documentation. If set to NO,
-# only classes defined in header files are included. Does not have any effect
-# for Java sources.
-# The default value is: YES.
-
-EXTRACT_LOCAL_CLASSES  = NO
-
-# This flag is only useful for Objective-C code. If set to YES, local methods,
-# which are defined in the implementation section but not in the interface are
-# included in the documentation. If set to NO, only methods in the interface are
-# included.
-# The default value is: NO.
-
-EXTRACT_LOCAL_METHODS  = NO
-
-# If this flag is set to YES, the members of anonymous namespaces will be
-# extracted and appear in the documentation as a namespace called
-# 'anonymous_namespace{file}', where file will be replaced with the base name of
-# the file that contains the anonymous namespace. By default anonymous namespace
-# are hidden.
-# The default value is: NO.
-
-EXTRACT_ANON_NSPACES   = NO
-
-# If this flag is set to YES, the name of an unnamed parameter in a declaration
-# will be determined by the corresponding definition. By default unnamed
-# parameters remain unnamed in the output.
-# The default value is: YES.
-
-RESOLVE_UNNAMED_PARAMS = YES
-
-# If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all
-# undocumented members inside documented classes or files. If set to NO these
-# members will be included in the various overviews, but no documentation
-# section is generated. This option has no effect if EXTRACT_ALL is enabled.
-# The default value is: NO.
-
-HIDE_UNDOC_MEMBERS     = NO
-
-# If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all
-# undocumented classes that are normally visible in the class hierarchy. If set
-# to NO, these classes will be included in the various overviews. This option
-# has no effect if EXTRACT_ALL is enabled.
-# The default value is: NO.
-
-HIDE_UNDOC_CLASSES     = NO
-
-# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend
-# declarations. If set to NO, these declarations will be included in the
-# documentation.
-# The default value is: NO.
-
-HIDE_FRIEND_COMPOUNDS  = NO
-
-# If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any
-# documentation blocks found inside the body of a function. If set to NO, these
-# blocks will be appended to the function's detailed documentation block.
-# The default value is: NO.
-
-HIDE_IN_BODY_DOCS      = NO
-
-# The INTERNAL_DOCS tag determines if documentation that is typed after a
-# \internal command is included. If the tag is set to NO then the documentation
-# will be excluded. Set it to YES to include the internal documentation.
-# The default value is: NO.
-
-INTERNAL_DOCS          = NO
-
-# With the correct setting of option CASE_SENSE_NAMES doxygen will better be
-# able to match the capabilities of the underlying filesystem. In case the
-# filesystem is case sensitive (i.e. it supports files in the same directory
-# whose names only differ in casing), the option must be set to YES to properly
-# deal with such files in case they appear in the input. For filesystems that
-# are not case sensitive the option should be be set to NO to properly deal with
-# output files written for symbols that only differ in casing, such as for two
-# classes, one named CLASS and the other named Class, and to also support
-# references to files without having to specify the exact matching casing. On
-# Windows (including Cygwin) and MacOS, users should typically set this option
-# to NO, whereas on Linux or other Unix flavors it should typically be set to
-# YES.
-# The default value is: system dependent.
-
-CASE_SENSE_NAMES       = NO
-
-# If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with
-# their full class and namespace scopes in the documentation. If set to YES, the
-# scope will be hidden.
-# The default value is: NO.
-
-HIDE_SCOPE_NAMES       = NO
-
-# If the HIDE_COMPOUND_REFERENCE tag is set to NO (default) then doxygen will
-# append additional text to a page's title, such as Class Reference. If set to
-# YES the compound reference will be hidden.
-# The default value is: NO.
-
-HIDE_COMPOUND_REFERENCE= NO
-
-# If the SHOW_HEADERFILE tag is set to YES then the documentation for a class
-# will show which file needs to be included to use the class.
-# The default value is: YES.
-
-SHOW_HEADERFILE        = YES
-
-# If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of
-# the files that are included by a file in the documentation of that file.
-# The default value is: YES.
-
-SHOW_INCLUDE_FILES     = YES
-
-# If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each
-# grouped member an include statement to the documentation, telling the reader
-# which file to include in order to use the member.
-# The default value is: NO.
-
-SHOW_GROUPED_MEMB_INC  = NO
-
-# If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include
-# files with double quotes in the documentation rather than with sharp brackets.
-# The default value is: NO.
-
-FORCE_LOCAL_INCLUDES   = NO
-
-# If the INLINE_INFO tag is set to YES then a tag [inline] is inserted in the
-# documentation for inline members.
-# The default value is: YES.
-
-INLINE_INFO            = YES
-
-# If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the
-# (detailed) documentation of file and class members alphabetically by member
-# name. If set to NO, the members will appear in declaration order.
-# The default value is: YES.
-
-SORT_MEMBER_DOCS       = YES
-
-# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief
-# descriptions of file, namespace and class members alphabetically by member
-# name. If set to NO, the members will appear in declaration order. Note that
-# this will also influence the order of the classes in the class list.
-# The default value is: NO.
-
-SORT_BRIEF_DOCS        = YES
-
-# If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the
-# (brief and detailed) documentation of class members so that constructors and
-# destructors are listed first. If set to NO the constructors will appear in the
-# respective orders defined by SORT_BRIEF_DOCS and SORT_MEMBER_DOCS.
-# Note: If SORT_BRIEF_DOCS is set to NO this option is ignored for sorting brief
-# member documentation.
-# Note: If SORT_MEMBER_DOCS is set to NO this option is ignored for sorting
-# detailed member documentation.
-# The default value is: NO.
-
-SORT_MEMBERS_CTORS_1ST = NO
-
-# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy
-# of group names into alphabetical order. If set to NO the group names will
-# appear in their defined order.
-# The default value is: NO.
-
-SORT_GROUP_NAMES       = NO
-
-# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by
-# fully-qualified names, including namespaces. If set to NO, the class list will
-# be sorted only by class name, not including the namespace part.
-# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
-# Note: This option applies only to the class list, not to the alphabetical
-# list.
-# The default value is: NO.
-
-SORT_BY_SCOPE_NAME     = NO
-
-# If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper
-# type resolution of all parameters of a function it will reject a match between
-# the prototype and the implementation of a member function even if there is
-# only one candidate or it is obvious which candidate to choose by doing a
-# simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still
-# accept a match between prototype and implementation in such cases.
-# The default value is: NO.
-
-STRICT_PROTO_MATCHING  = NO
-
-# The GENERATE_TODOLIST tag can be used to enable (YES) or disable (NO) the todo
-# list. This list is created by putting \todo commands in the documentation.
-# The default value is: YES.
-
-GENERATE_TODOLIST      = YES
-
-# The GENERATE_TESTLIST tag can be used to enable (YES) or disable (NO) the test
-# list. This list is created by putting \test commands in the documentation.
-# The default value is: YES.
-
-GENERATE_TESTLIST      = YES
-
-# The GENERATE_BUGLIST tag can be used to enable (YES) or disable (NO) the bug
-# list. This list is created by putting \bug commands in the documentation.
-# The default value is: YES.
-
-GENERATE_BUGLIST       = YES
-
-# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or disable (NO)
-# the deprecated list. This list is created by putting \deprecated commands in
-# the documentation.
-# The default value is: YES.
-
-GENERATE_DEPRECATEDLIST= YES
-
-# The ENABLED_SECTIONS tag can be used to enable conditional documentation
-# sections, marked by \if <section_label> ... \endif and \cond <section_label>
-# ... \endcond blocks.
-
-ENABLED_SECTIONS       =
-
-# The MAX_INITIALIZER_LINES tag determines the maximum number of lines that the
-# initial value of a variable or macro / define can have for it to appear in the
-# documentation. If the initializer consists of more lines than specified here
-# it will be hidden. Use a value of 0 to hide initializers completely. The
-# appearance of the value of individual variables and macros / defines can be
-# controlled using \showinitializer or \hideinitializer command in the
-# documentation regardless of this setting.
-# Minimum value: 0, maximum value: 10000, default value: 30.
-
-MAX_INITIALIZER_LINES  = 2
-
-# Set the SHOW_USED_FILES tag to NO to disable the list of files generated at
-# the bottom of the documentation of classes and structs. If set to YES, the
-# list will mention the files that were used to generate the documentation.
-# The default value is: YES.
-
-SHOW_USED_FILES        = YES
-
-# Set the SHOW_FILES tag to NO to disable the generation of the Files page. This
-# will remove the Files entry from the Quick Index and from the Folder Tree View
-# (if specified).
-# The default value is: YES.
-
-SHOW_FILES             = YES
-
-# Set the SHOW_NAMESPACES tag to NO to disable the generation of the Namespaces
-# page. This will remove the Namespaces entry from the Quick Index and from the
-# Folder Tree View (if specified).
-# The default value is: YES.
-
-SHOW_NAMESPACES        = YES
-
-# The FILE_VERSION_FILTER tag can be used to specify a program or script that
-# doxygen should invoke to get the current version for each file (typically from
-# the version control system). Doxygen will invoke the program by executing (via
-# popen()) the command command input-file, where command is the value of the
-# FILE_VERSION_FILTER tag, and input-file is the name of an input file provided
-# by doxygen. Whatever the program writes to standard output is used as the file
-# version. For an example see the documentation.
-
-FILE_VERSION_FILTER    =
-
-# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed
-# by doxygen. The layout file controls the global structure of the generated
-# output files in an output format independent way. To create the layout file
-# that represents doxygen's defaults, run doxygen with the -l option. You can
-# optionally specify a file name after the option, if omitted DoxygenLayout.xml
-# will be used as the name of the layout file. See also section "Changing the
-# layout of pages" for information.
-#
-# Note that if you run doxygen from a directory containing a file called
-# DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
-# tag is left empty.
-
-LAYOUT_FILE            =
-
-# The CITE_BIB_FILES tag can be used to specify one or more bib files containing
-# the reference definitions. This must be a list of .bib files. The .bib
-# extension is automatically appended if omitted. This requires the bibtex tool
-# to be installed. See also https://en.wikipedia.org/wiki/BibTeX for more info.
-# For LaTeX the style of the bibliography can be controlled using
-# LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the
-# search path. See also \cite for info how to create references.
-
-CITE_BIB_FILES         =
-
-#---------------------------------------------------------------------------
-# Configuration options related to warning and progress messages
-#---------------------------------------------------------------------------
-
-# The QUIET tag can be used to turn on/off the messages that are generated to
-# standard output by doxygen. If QUIET is set to YES this implies that the
-# messages are off.
-# The default value is: NO.
-
-QUIET                  = NO
-
-# The WARNINGS tag can be used to turn on/off the warning messages that are
-# generated to standard error (stderr) by doxygen. If WARNINGS is set to YES
-# this implies that the warnings are on.
-#
-# Tip: Turn warnings on while writing the documentation.
-# The default value is: YES.
-
-WARNINGS               = YES
-
-# If the WARN_IF_UNDOCUMENTED tag is set to YES then doxygen will generate
-# warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag
-# will automatically be disabled.
-# The default value is: YES.
-
-WARN_IF_UNDOCUMENTED   = YES
-
-# If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for
-# potential errors in the documentation, such as documenting some parameters in
-# a documented function twice, or documenting parameters that don't exist or
-# using markup commands wrongly.
-# The default value is: YES.
-
-WARN_IF_DOC_ERROR      = YES
-
-# If WARN_IF_INCOMPLETE_DOC is set to YES, doxygen will warn about incomplete
-# function parameter documentation. If set to NO, doxygen will accept that some
-# parameters have no documentation without warning.
-# The default value is: YES.
-
-WARN_IF_INCOMPLETE_DOC = YES
-
-# This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that
-# are documented, but have no documentation for their parameters or return
-# value. If set to NO, doxygen will only warn about wrong parameter
-# documentation, but not about the absence of documentation. If EXTRACT_ALL is
-# set to YES then this flag will automatically be disabled. See also
-# WARN_IF_INCOMPLETE_DOC
-# The default value is: NO.
-
-WARN_NO_PARAMDOC       = YES
-
-# If the WARN_AS_ERROR tag is set to YES then doxygen will immediately stop when
-# a warning is encountered. If the WARN_AS_ERROR tag is set to FAIL_ON_WARNINGS
-# then doxygen will continue running as if WARN_AS_ERROR tag is set to NO, but
-# at the end of the doxygen process doxygen will return with a non-zero status.
-# Possible values are: NO, YES and FAIL_ON_WARNINGS.
-# The default value is: NO.
-
-WARN_AS_ERROR          = NO
-
-# The WARN_FORMAT tag determines the format of the warning messages that doxygen
-# can produce. The string should contain the $file, $line, and $text tags, which
-# will be replaced by the file and line number from which the warning originated
-# and the warning text. Optionally the format may contain $version, which will
-# be replaced by the version of the file (if it could be obtained via
-# FILE_VERSION_FILTER)
-# The default value is: $file:$line: $text.
-
-WARN_FORMAT            = "$file:$line: $text"
-
-# The WARN_LOGFILE tag can be used to specify a file to which warning and error
-# messages should be written. If left blank the output is written to standard
-# error (stderr).
-
-WARN_LOGFILE           =
-
-#---------------------------------------------------------------------------
-# Configuration options related to the input files
-#---------------------------------------------------------------------------
-
-# The INPUT tag is used to specify the files and/or directories that contain
-# documented source files. You may enter file names like myfile.cpp or
-# directories like /usr/src/myproject. Separate the files or directories with
-# spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
-# Note: If this tag is empty the current directory is searched.
-
-INPUT                  = ../src \
-                         ../src/ExFatLib \
-                         ../src/FatLib \
-                         ../src/iostream \
-                         ../src/common \
-                         ../src/SdCard \
-                         ../src/SpiDriver \
-                         mainpage.h \
-                         ../src/FsLib \
-                         ../src/FsLib
-
-# This tag can be used to specify the character encoding of the source files
-# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
-# libiconv (or the iconv built into libc) for the transcoding. See the libiconv
-# documentation (see:
-# https://www.gnu.org/software/libiconv/) for the list of possible encodings.
-# The default value is: UTF-8.
-
-INPUT_ENCODING         = UTF-8
-
-# If the value of the INPUT tag contains directories, you can use the
-# FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
-# *.h) to filter out the source-files in the directories.
-#
-# Note that for custom extensions or not directly supported extensions you also
-# need to set EXTENSION_MAPPING for the extension otherwise the files are not
-# read by doxygen.
-#
-# Note the list of default checked file patterns might differ from the list of
-# default file extension mappings.
-#
-# If left blank the following patterns are tested:*.c, *.cc, *.cxx, *.cpp,
-# *.c++, *.java, *.ii, *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h,
-# *.hh, *.hxx, *.hpp, *.h++, *.l, *.cs, *.d, *.php, *.php4, *.php5, *.phtml,
-# *.inc, *.m, *.markdown, *.md, *.mm, *.dox (to be provided as doxygen C
-# comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08, *.f18, *.f, *.for, *.vhd,
-# *.vhdl, *.ucf, *.qsf and *.ice.
-
-FILE_PATTERNS          = *.c \
-                         *.cc \
-                         *.cxx \
-                         *.c++ \
-                         *.d \
-                         *.java \
-                         *.ii \
-                         *.ixx \
-                         *.ipp \
-                         *.i++ \
-                         *.inl \
-                         *.h \
-                         *.hh \
-                         *.hxx \
-                         *.hpp \
-                         *.h++ \
-                         *.idl \
-                         *.odl \
-                         *.cs \
-                         *.php \
-                         *.php3 \
-                         *.inc \
-                         *.m \
-                         *.mm \
-                         *.dox \
-                         *.py \
-                         *.f90 \
-                         *.f \
-                         *.vhd \
-                         *.vhdl \
-                         *.cpp
-
-# The RECURSIVE tag can be used to specify whether or not subdirectories should
-# be searched for input files as well.
-# The default value is: NO.
-
-RECURSIVE              = NO
-
-# The EXCLUDE tag can be used to specify files and/or directories that should be
-# excluded from the INPUT source files. This way you can easily exclude a
-# subdirectory from a directory tree whose root is specified with the INPUT tag.
-#
-# Note that relative paths are relative to the directory from which doxygen is
-# run.
-
-EXCLUDE                = ../src/common/FsStructs.h \
-                         ../src/ExFatLib/upcase.cpp \
-                         ../src/common/PrintBasic.h \
-                         ../src/common/PrintBasic.cpp \
-                         ../src/SpiDriver/SdSpiBareUnoDriver.h \
-                         ../src/iostream/StreamBaseClass.cpp
-
-# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
-# directories that are symbolic links (a Unix file system feature) are excluded
-# from the input.
-# The default value is: NO.
-
-EXCLUDE_SYMLINKS       = NO
-
-# If the value of the INPUT tag contains directories, you can use the
-# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
-# certain files from those directories.
-#
-# Note that the wildcards are matched against the file with absolute path, so to
-# exclude all test directories for example use the pattern */test/*
-
-EXCLUDE_PATTERNS       =
-
-# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
-# (namespaces, classes, functions, etc.) that should be excluded from the
-# output. The symbol name can be a fully qualified name, a word, or if the
-# wildcard * is used, a substring. Examples: ANamespace, AClass,
-# AClass::ANamespace, ANamespace::*Test
-#
-# Note that the wildcards are matched against the file with absolute path, so to
-# exclude all test directories use the pattern */test/*
-
-EXCLUDE_SYMBOLS        =
-
-# The EXAMPLE_PATH tag can be used to specify one or more files or directories
-# that contain example code fragments that are included (see the \include
-# command).
-
-EXAMPLE_PATH           =
-
-# If the value of the EXAMPLE_PATH tag contains directories, you can use the
-# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
-# *.h) to filter out the source-files in the directories. If left blank all
-# files are included.
-
-EXAMPLE_PATTERNS       = *
-
-# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
-# searched for input files to be used with the \include or \dontinclude commands
-# irrespective of the value of the RECURSIVE tag.
-# The default value is: NO.
-
-EXAMPLE_RECURSIVE      = NO
-
-# The IMAGE_PATH tag can be used to specify one or more files or directories
-# that contain images that are to be included in the documentation (see the
-# \image command).
-
-IMAGE_PATH             =
-
-# The INPUT_FILTER tag can be used to specify a program that doxygen should
-# invoke to filter for each input file. Doxygen will invoke the filter program
-# by executing (via popen()) the command:
-#
-# <filter> <input-file>
-#
-# where <filter> is the value of the INPUT_FILTER tag, and <input-file> is the
-# name of an input file. Doxygen will then use the output that the filter
-# program writes to standard output. If FILTER_PATTERNS is specified, this tag
-# will be ignored.
-#
-# Note that the filter must not add or remove lines; it is applied before the
-# code is scanned, but not when the output code is generated. If lines are added
-# or removed, the anchors will not be placed correctly.
-#
-# Note that for custom extensions or not directly supported extensions you also
-# need to set EXTENSION_MAPPING for the extension otherwise the files are not
-# properly processed by doxygen.
-
-INPUT_FILTER           =
-
-# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
-# basis. Doxygen will compare the file name with each pattern and apply the
-# filter if there is a match. The filters are a list of the form: pattern=filter
-# (like *.cpp=my_cpp_filter). See INPUT_FILTER for further information on how
-# filters are used. If the FILTER_PATTERNS tag is empty or if none of the
-# patterns match the file name, INPUT_FILTER is applied.
-#
-# Note that for custom extensions or not directly supported extensions you also
-# need to set EXTENSION_MAPPING for the extension otherwise the files are not
-# properly processed by doxygen.
-
-FILTER_PATTERNS        =
-
-# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
-# INPUT_FILTER) will also be used to filter the input files that are used for
-# producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES).
-# The default value is: NO.
-
-FILTER_SOURCE_FILES    = NO
-
-# The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file
-# pattern. A pattern will override the setting for FILTER_PATTERN (if any) and
-# it is also possible to disable source filtering for a specific pattern using
-# *.ext= (so without naming a filter).
-# This tag requires that the tag FILTER_SOURCE_FILES is set to YES.
-
-FILTER_SOURCE_PATTERNS =
-
-# If the USE_MDFILE_AS_MAINPAGE tag refers to the name of a markdown file that
-# is part of the input, its contents will be placed on the main page
-# (index.html). This can be useful if you have a project on for instance GitHub
-# and want to reuse the introduction page also for the doxygen output.
-
-USE_MDFILE_AS_MAINPAGE =
-
-#---------------------------------------------------------------------------
-# Configuration options related to source browsing
-#---------------------------------------------------------------------------
-
-# If the SOURCE_BROWSER tag is set to YES then a list of source files will be
-# generated. Documented entities will be cross-referenced with these sources.
-#
-# Note: To get rid of all source code in the generated output, make sure that
-# also VERBATIM_HEADERS is set to NO.
-# The default value is: NO.
-
-SOURCE_BROWSER         = NO
-
-# Setting the INLINE_SOURCES tag to YES will include the body of functions,
-# classes and enums directly into the documentation.
-# The default value is: NO.
-
-INLINE_SOURCES         = NO
-
-# Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any
-# special comment blocks from generated source code fragments. Normal C, C++ and
-# Fortran comments will always remain visible.
-# The default value is: YES.
-
-STRIP_CODE_COMMENTS    = YES
-
-# If the REFERENCED_BY_RELATION tag is set to YES then for each documented
-# entity all documented functions referencing it will be listed.
-# The default value is: NO.
-
-REFERENCED_BY_RELATION = NO
-
-# If the REFERENCES_RELATION tag is set to YES then for each documented function
-# all documented entities called/used by that function will be listed.
-# The default value is: NO.
-
-REFERENCES_RELATION    = NO
-
-# If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set
-# to YES then the hyperlinks from functions in REFERENCES_RELATION and
-# REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will
-# link to the documentation.
-# The default value is: YES.
-
-REFERENCES_LINK_SOURCE = YES
-
-# If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the
-# source code will show a tooltip with additional information such as prototype,
-# brief description and links to the definition and documentation. Since this
-# will make the HTML file larger and loading of large files a bit slower, you
-# can opt to disable this feature.
-# The default value is: YES.
-# This tag requires that the tag SOURCE_BROWSER is set to YES.
-
-SOURCE_TOOLTIPS        = YES
-
-# If the USE_HTAGS tag is set to YES then the references to source code will
-# point to the HTML generated by the htags(1) tool instead of doxygen built-in
-# source browser. The htags tool is part of GNU's global source tagging system
-# (see https://www.gnu.org/software/global/global.html). You will need version
-# 4.8.6 or higher.
-#
-# To use it do the following:
-# - Install the latest version of global
-# - Enable SOURCE_BROWSER and USE_HTAGS in the configuration file
-# - Make sure the INPUT points to the root of the source tree
-# - Run doxygen as normal
-#
-# Doxygen will invoke htags (and that will in turn invoke gtags), so these
-# tools must be available from the command line (i.e. in the search path).
-#
-# The result: instead of the source browser generated by doxygen, the links to
-# source code will now point to the output of htags.
-# The default value is: NO.
-# This tag requires that the tag SOURCE_BROWSER is set to YES.
-
-USE_HTAGS              = NO
-
-# If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a
-# verbatim copy of the header file for each class for which an include is
-# specified. Set to NO to disable this.
-# See also: Section \class.
-# The default value is: YES.
-
-VERBATIM_HEADERS       = NO
-
-# If the CLANG_ASSISTED_PARSING tag is set to YES then doxygen will use the
-# clang parser (see:
-# http://clang.llvm.org/) for more accurate parsing at the cost of reduced
-# performance. This can be particularly helpful with template rich C++ code for
-# which doxygen's built-in parser lacks the necessary type information.
-# Note: The availability of this option depends on whether or not doxygen was
-# generated with the -Duse_libclang=ON option for CMake.
-# The default value is: NO.
-
-CLANG_ASSISTED_PARSING = NO
-
-# If the CLANG_ASSISTED_PARSING tag is set to YES and the CLANG_ADD_INC_PATHS
-# tag is set to YES then doxygen will add the directory of each input to the
-# include path.
-# The default value is: YES.
-# This tag requires that the tag CLANG_ASSISTED_PARSING is set to YES.
-
-CLANG_ADD_INC_PATHS    = YES
-
-# If clang assisted parsing is enabled you can provide the compiler with command
-# line options that you would normally use when invoking the compiler. Note that
-# the include paths will already be set by doxygen for the files and directories
-# specified with INPUT and INCLUDE_PATH.
-# This tag requires that the tag CLANG_ASSISTED_PARSING is set to YES.
-
-CLANG_OPTIONS          =
-
-# If clang assisted parsing is enabled you can provide the clang parser with the
-# path to the directory containing a file called compile_commands.json. This
-# file is the compilation database (see:
-# http://clang.llvm.org/docs/HowToSetupToolingForLLVM.html) containing the
-# options used when the source files were built. This is equivalent to
-# specifying the -p option to a clang tool, such as clang-check. These options
-# will then be passed to the parser. Any options specified with CLANG_OPTIONS
-# will be added as well.
-# Note: The availability of this option depends on whether or not doxygen was
-# generated with the -Duse_libclang=ON option for CMake.
-
-CLANG_DATABASE_PATH    =
-
-#---------------------------------------------------------------------------
-# Configuration options related to the alphabetical class index
-#---------------------------------------------------------------------------
-
-# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all
-# compounds will be generated. Enable this if the project contains a lot of
-# classes, structs, unions or interfaces.
-# The default value is: YES.
-
-ALPHABETICAL_INDEX     = NO
-
-# In case all classes in a project start with a common prefix, all classes will
-# be put under the same header in the alphabetical index. The IGNORE_PREFIX tag
-# can be used to specify a prefix (or a list of prefixes) that should be ignored
-# while generating the index headers.
-# This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
-
-IGNORE_PREFIX          =
-
-#---------------------------------------------------------------------------
-# Configuration options related to the HTML output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_HTML tag is set to YES, doxygen will generate HTML output
-# The default value is: YES.
-
-GENERATE_HTML          = YES
-
-# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a
-# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
-# it.
-# The default directory is: html.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_OUTPUT            = html
-
-# The HTML_FILE_EXTENSION tag can be used to specify the file extension for each
-# generated HTML page (for example: .htm, .php, .asp).
-# The default value is: .html.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_FILE_EXTENSION    = .html
-
-# The HTML_HEADER tag can be used to specify a user-defined HTML header file for
-# each generated HTML page. If the tag is left blank doxygen will generate a
-# standard header.
-#
-# To get valid HTML the header file that includes any scripts and style sheets
-# that doxygen needs, which is dependent on the configuration options used (e.g.
-# the setting GENERATE_TREEVIEW). It is highly recommended to start with a
-# default header using
-# doxygen -w html new_header.html new_footer.html new_stylesheet.css
-# YourConfigFile
-# and then modify the file new_header.html. See also section "Doxygen usage"
-# for information on how to generate the default header that doxygen normally
-# uses.
-# Note: The header is subject to change so you typically have to regenerate the
-# default header when upgrading to a newer version of doxygen. For a description
-# of the possible markers and block names see the documentation.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_HEADER            =
-
-# The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each
-# generated HTML page. If the tag is left blank doxygen will generate a standard
-# footer. See HTML_HEADER for more information on how to generate a default
-# footer and what special commands can be used inside the footer. See also
-# section "Doxygen usage" for information on how to generate the default footer
-# that doxygen normally uses.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_FOOTER            =
-
-# The HTML_STYLESHEET tag can be used to specify a user-defined cascading style
-# sheet that is used by each HTML page. It can be used to fine-tune the look of
-# the HTML output. If left blank doxygen will generate a default style sheet.
-# See also section "Doxygen usage" for information on how to generate the style
-# sheet that doxygen normally uses.
-# Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as
-# it is more robust and this tag (HTML_STYLESHEET) will in the future become
-# obsolete.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_STYLESHEET        =
-
-# The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined
-# cascading style sheets that are included after the standard style sheets
-# created by doxygen. Using this option one can overrule certain style aspects.
-# This is preferred over using HTML_STYLESHEET since it does not replace the
-# standard style sheet and is therefore more robust against future updates.
-# Doxygen will copy the style sheet files to the output directory.
-# Note: The order of the extra style sheet files is of importance (e.g. the last
-# style sheet in the list overrules the setting of the previous ones in the
-# list). For an example see the documentation.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_EXTRA_STYLESHEET  =
-
-# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
-# other source files which should be copied to the HTML output directory. Note
-# that these files will be copied to the base HTML output directory. Use the
-# $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these
-# files. In the HTML_STYLESHEET file, use the file name only. Also note that the
-# files will be copied as-is; there are no commands or markers available.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_EXTRA_FILES       =
-
-# The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
-# will adjust the colors in the style sheet and background images according to
-# this color. Hue is specified as an angle on a color-wheel, see
-# https://en.wikipedia.org/wiki/Hue for more information. For instance the value
-# 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300
-# purple, and 360 is red again.
-# Minimum value: 0, maximum value: 359, default value: 220.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_COLORSTYLE_HUE    = 220
-
-# The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors
-# in the HTML output. For a value of 0 the output will use gray-scales only. A
-# value of 255 will produce the most vivid colors.
-# Minimum value: 0, maximum value: 255, default value: 100.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_COLORSTYLE_SAT    = 100
-
-# The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the
-# luminance component of the colors in the HTML output. Values below 100
-# gradually make the output lighter, whereas values above 100 make the output
-# darker. The value divided by 100 is the actual gamma applied, so 80 represents
-# a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not
-# change the gamma.
-# Minimum value: 40, maximum value: 240, default value: 80.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_COLORSTYLE_GAMMA  = 80
-
-# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
-# page will contain the date and time when the page was generated. Setting this
-# to YES can help to show when doxygen was last run and thus if the
-# documentation is up to date.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_TIMESTAMP         = YES
-
-# If the HTML_DYNAMIC_MENUS tag is set to YES then the generated HTML
-# documentation will contain a main index with vertical navigation menus that
-# are dynamically created via JavaScript. If disabled, the navigation index will
-# consists of multiple levels of tabs that are statically embedded in every HTML
-# page. Disable this option to support browsers that do not have JavaScript,
-# like the Qt help browser.
-# The default value is: YES.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_DYNAMIC_MENUS     = YES
-
-# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
-# documentation will contain sections that can be hidden and shown after the
-# page has loaded.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_DYNAMIC_SECTIONS  = NO
-
-# With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries
-# shown in the various tree structured indices initially; the user can expand
-# and collapse entries dynamically later on. Doxygen will expand the tree to
-# such a level that at most the specified number of entries are visible (unless
-# a fully collapsed tree already exceeds this amount). So setting the number of
-# entries 1 will produce a full collapsed tree by default. 0 is a special value
-# representing an infinite number of entries and will result in a full expanded
-# tree by default.
-# Minimum value: 0, maximum value: 9999, default value: 100.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_INDEX_NUM_ENTRIES = 100
-
-# If the GENERATE_DOCSET tag is set to YES, additional index files will be
-# generated that can be used as input for Apple's Xcode 3 integrated development
-# environment (see:
-# https://developer.apple.com/xcode/), introduced with OSX 10.5 (Leopard). To
-# create a documentation set, doxygen will generate a Makefile in the HTML
-# output directory. Running make will produce the docset in that directory and
-# running make install will install the docset in
-# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at
-# startup. See https://developer.apple.com/library/archive/featuredarticles/Doxy
-# genXcode/_index.html for more information.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-GENERATE_DOCSET        = NO
-
-# This tag determines the name of the docset feed. A documentation feed provides
-# an umbrella under which multiple documentation sets from a single provider
-# (such as a company or product suite) can be grouped.
-# The default value is: Doxygen generated docs.
-# This tag requires that the tag GENERATE_DOCSET is set to YES.
-
-DOCSET_FEEDNAME        = "Doxygen generated docs"
-
-# This tag specifies a string that should uniquely identify the documentation
-# set bundle. This should be a reverse domain-name style string, e.g.
-# com.mycompany.MyDocSet. Doxygen will append .docset to the name.
-# The default value is: org.doxygen.Project.
-# This tag requires that the tag GENERATE_DOCSET is set to YES.
-
-DOCSET_BUNDLE_ID       = org.doxygen.Project
-
-# The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify
-# the documentation publisher. This should be a reverse domain-name style
-# string, e.g. com.mycompany.MyDocSet.documentation.
-# The default value is: org.doxygen.Publisher.
-# This tag requires that the tag GENERATE_DOCSET is set to YES.
-
-DOCSET_PUBLISHER_ID    = org.doxygen.Publisher
-
-# The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher.
-# The default value is: Publisher.
-# This tag requires that the tag GENERATE_DOCSET is set to YES.
-
-DOCSET_PUBLISHER_NAME  = Publisher
-
-# If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three
-# additional HTML index files: index.hhp, index.hhc, and index.hhk. The
-# index.hhp is a project file that can be read by Microsoft's HTML Help Workshop
-# on Windows. In the beginning of 2021 Microsoft took the original page, with
-# a.o. the download links, offline the HTML help workshop was already many years
-# in maintenance mode). You can download the HTML help workshop from the web
-# archives at Installation executable (see:
-# http://web.archive.org/web/20160201063255/http://download.microsoft.com/downlo
-# ad/0/A/9/0A939EF6-E31C-430F-A3DF-DFAE7960D564/htmlhelp.exe).
-#
-# The HTML Help Workshop contains a compiler that can convert all HTML output
-# generated by doxygen into a single compiled HTML file (.chm). Compiled HTML
-# files are now used as the Windows 98 help format, and will replace the old
-# Windows help format (.hlp) on all Windows platforms in the future. Compressed
-# HTML files also contain an index, a table of contents, and you can search for
-# words in the documentation. The HTML workshop also contains a viewer for
-# compressed HTML files.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-GENERATE_HTMLHELP      = NO
-
-# The CHM_FILE tag can be used to specify the file name of the resulting .chm
-# file. You can add a path in front of the file if the result should not be
-# written to the html output directory.
-# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
-
-CHM_FILE               =
-
-# The HHC_LOCATION tag can be used to specify the location (absolute path
-# including file name) of the HTML help compiler (hhc.exe). If non-empty,
-# doxygen will try to run the HTML help compiler on the generated index.hhp.
-# The file has to be specified with full path.
-# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
-
-HHC_LOCATION           =
-
-# The GENERATE_CHI flag controls if a separate .chi index file is generated
-# (YES) or that it should be included in the main .chm file (NO).
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
-
-GENERATE_CHI           = NO
-
-# The CHM_INDEX_ENCODING is used to encode HtmlHelp index (hhk), content (hhc)
-# and project file content.
-# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
-
-CHM_INDEX_ENCODING     =
-
-# The BINARY_TOC flag controls whether a binary table of contents is generated
-# (YES) or a normal table of contents (NO) in the .chm file. Furthermore it
-# enables the Previous and Next buttons.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
-
-BINARY_TOC             = NO
-
-# The TOC_EXPAND flag can be set to YES to add extra items for group members to
-# the table of contents of the HTML help documentation and to the tree view.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
-
-TOC_EXPAND             = NO
-
-# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and
-# QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that
-# can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help
-# (.qch) of the generated HTML documentation.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-GENERATE_QHP           = NO
-
-# If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify
-# the file name of the resulting .qch file. The path specified is relative to
-# the HTML output folder.
-# This tag requires that the tag GENERATE_QHP is set to YES.
-
-QCH_FILE               =
-
-# The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help
-# Project output. For more information please see Qt Help Project / Namespace
-# (see:
-# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#namespace).
-# The default value is: org.doxygen.Project.
-# This tag requires that the tag GENERATE_QHP is set to YES.
-
-QHP_NAMESPACE          = org.doxygen.Project
-
-# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt
-# Help Project output. For more information please see Qt Help Project / Virtual
-# Folders (see:
-# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#virtual-folders).
-# The default value is: doc.
-# This tag requires that the tag GENERATE_QHP is set to YES.
-
-QHP_VIRTUAL_FOLDER     = doc
-
-# If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom
-# filter to add. For more information please see Qt Help Project / Custom
-# Filters (see:
-# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#custom-filters).
-# This tag requires that the tag GENERATE_QHP is set to YES.
-
-QHP_CUST_FILTER_NAME   =
-
-# The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the
-# custom filter to add. For more information please see Qt Help Project / Custom
-# Filters (see:
-# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#custom-filters).
-# This tag requires that the tag GENERATE_QHP is set to YES.
-
-QHP_CUST_FILTER_ATTRS  =
-
-# The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this
-# project's filter section matches. Qt Help Project / Filter Attributes (see:
-# https://doc.qt.io/archives/qt-4.8/qthelpproject.html#filter-attributes).
-# This tag requires that the tag GENERATE_QHP is set to YES.
-
-QHP_SECT_FILTER_ATTRS  =
-
-# The QHG_LOCATION tag can be used to specify the location (absolute path
-# including file name) of Qt's qhelpgenerator. If non-empty doxygen will try to
-# run qhelpgenerator on the generated .qhp file.
-# This tag requires that the tag GENERATE_QHP is set to YES.
-
-QHG_LOCATION           =
-
-# If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be
-# generated, together with the HTML files, they form an Eclipse help plugin. To
-# install this plugin and make it available under the help contents menu in
-# Eclipse, the contents of the directory containing the HTML and XML files needs
-# to be copied into the plugins directory of eclipse. The name of the directory
-# within the plugins directory should be the same as the ECLIPSE_DOC_ID value.
-# After copying Eclipse needs to be restarted before the help appears.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-GENERATE_ECLIPSEHELP   = NO
-
-# A unique identifier for the Eclipse help plugin. When installing the plugin
-# the directory name containing the HTML and XML files should also have this
-# name. Each documentation set should have its own identifier.
-# The default value is: org.doxygen.Project.
-# This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES.
-
-ECLIPSE_DOC_ID         = org.doxygen.Project
-
-# If you want full control over the layout of the generated HTML pages it might
-# be necessary to disable the index and replace it with your own. The
-# DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top
-# of each HTML page. A value of NO enables the index and the value YES disables
-# it. Since the tabs in the index contain the same information as the navigation
-# tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-DISABLE_INDEX          = NO
-
-# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
-# structure should be generated to display hierarchical information. If the tag
-# value is set to YES, a side panel will be generated containing a tree-like
-# index structure (just like the one that is generated for HTML Help). For this
-# to work a browser that supports JavaScript, DHTML, CSS and frames is required
-# (i.e. any modern browser). Windows users are probably better off using the
-# HTML help feature. Via custom style sheets (see HTML_EXTRA_STYLESHEET) one can
-# further fine tune the look of the index (see "Fine-tuning the output"). As an
-# example, the default style sheet generated by doxygen has an example that
-# shows how to put an image at the root of the tree instead of the PROJECT_NAME.
-# Since the tree basically has the same information as the tab index, you could
-# consider setting DISABLE_INDEX to YES when enabling this option.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-GENERATE_TREEVIEW      = NO
-
-# When both GENERATE_TREEVIEW and DISABLE_INDEX are set to YES, then the
-# FULL_SIDEBAR option determines if the side bar is limited to only the treeview
-# area (value NO) or if it should extend to the full height of the window (value
-# YES). Setting this to YES gives a layout similar to
-# https://docs.readthedocs.io with more room for contents, but less room for the
-# project logo, title, and description. If either GENERATOR_TREEVIEW or
-# DISABLE_INDEX is set to NO, this option has no effect.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-FULL_SIDEBAR           = NO
-
-# The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that
-# doxygen will group on one line in the generated HTML documentation.
-#
-# Note that a value of 0 will completely suppress the enum values from appearing
-# in the overview section.
-# Minimum value: 0, maximum value: 20, default value: 4.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-ENUM_VALUES_PER_LINE   = 4
-
-# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used
-# to set the initial width (in pixels) of the frame in which the tree is shown.
-# Minimum value: 0, maximum value: 1500, default value: 250.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-TREEVIEW_WIDTH         = 250
-
-# If the EXT_LINKS_IN_WINDOW option is set to YES, doxygen will open links to
-# external symbols imported via tag files in a separate window.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-EXT_LINKS_IN_WINDOW    = NO
-
-# If the HTML_FORMULA_FORMAT option is set to svg, doxygen will use the pdf2svg
-# tool (see https://github.com/dawbarton/pdf2svg) or inkscape (see
-# https://inkscape.org) to generate formulas as SVG images instead of PNGs for
-# the HTML output. These images will generally look nicer at scaled resolutions.
-# Possible values are: png (the default) and svg (looks nicer but requires the
-# pdf2svg or inkscape tool).
-# The default value is: png.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-HTML_FORMULA_FORMAT    = png
-
-# Use this tag to change the font size of LaTeX formulas included as images in
-# the HTML documentation. When you change the font size after a successful
-# doxygen run you need to manually remove any form_*.png images from the HTML
-# output directory to force them to be regenerated.
-# Minimum value: 8, maximum value: 50, default value: 10.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-FORMULA_FONTSIZE       = 10
-
-# Use the FORMULA_TRANSPARENT tag to determine whether or not the images
-# generated for formulas are transparent PNGs. Transparent PNGs are not
-# supported properly for IE 6.0, but are supported on all modern browsers.
-#
-# Note that when changing this option you need to delete any form_*.png files in
-# the HTML output directory before the changes have effect.
-# The default value is: YES.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-FORMULA_TRANSPARENT    = YES
-
-# The FORMULA_MACROFILE can contain LaTeX \newcommand and \renewcommand commands
-# to create new LaTeX commands to be used in formulas as building blocks. See
-# the section "Including formulas" for details.
-
-FORMULA_MACROFILE      =
-
-# Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see
-# https://www.mathjax.org) which uses client side JavaScript for the rendering
-# instead of using pre-rendered bitmaps. Use this if you do not have LaTeX
-# installed or if you want to formulas look prettier in the HTML output. When
-# enabled you may also need to install MathJax separately and configure the path
-# to it using the MATHJAX_RELPATH option.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-USE_MATHJAX            = NO
-
-# With MATHJAX_VERSION it is possible to specify the MathJax version to be used.
-# Note that the different versions of MathJax have different requirements with
-# regards to the different settings, so it is possible that also other MathJax
-# settings have to be changed when switching between the different MathJax
-# versions.
-# Possible values are: MathJax_2 and MathJax_3.
-# The default value is: MathJax_2.
-# This tag requires that the tag USE_MATHJAX is set to YES.
-
-MATHJAX_VERSION        = MathJax_2
-
-# When MathJax is enabled you can set the default output format to be used for
-# the MathJax output. For more details about the output format see MathJax
-# version 2 (see:
-# http://docs.mathjax.org/en/v2.7-latest/output.html) and MathJax version 3
-# (see:
-# http://docs.mathjax.org/en/latest/web/components/output.html).
-# Possible values are: HTML-CSS (which is slower, but has the best
-# compatibility. This is the name for Mathjax version 2, for MathJax version 3
-# this will be translated into chtml), NativeMML (i.e. MathML. Only supported
-# for NathJax 2. For MathJax version 3 chtml will be used instead.), chtml (This
-# is the name for Mathjax version 3, for MathJax version 2 this will be
-# translated into HTML-CSS) and SVG.
-# The default value is: HTML-CSS.
-# This tag requires that the tag USE_MATHJAX is set to YES.
-
-MATHJAX_FORMAT         = HTML-CSS
-
-# When MathJax is enabled you need to specify the location relative to the HTML
-# output directory using the MATHJAX_RELPATH option. The destination directory
-# should contain the MathJax.js script. For instance, if the mathjax directory
-# is located at the same level as the HTML output directory, then
-# MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax
-# Content Delivery Network so you can quickly see the result without installing
-# MathJax. However, it is strongly recommended to install a local copy of
-# MathJax from https://www.mathjax.org before deployment. The default value is:
-# - in case of MathJax version 2: https://cdn.jsdelivr.net/npm/mathjax@2
-# - in case of MathJax version 3: https://cdn.jsdelivr.net/npm/mathjax@3
-# This tag requires that the tag USE_MATHJAX is set to YES.
-
-MATHJAX_RELPATH        = http://www.mathjax.org/mathjax
-
-# The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax
-# extension names that should be enabled during MathJax rendering. For example
-# for MathJax version 2 (see
-# https://docs.mathjax.org/en/v2.7-latest/tex.html#tex-and-latex-extensions):
-# MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols
-# For example for MathJax version 3 (see
-# http://docs.mathjax.org/en/latest/input/tex/extensions/index.html):
-# MATHJAX_EXTENSIONS = ams
-# This tag requires that the tag USE_MATHJAX is set to YES.
-
-MATHJAX_EXTENSIONS     =
-
-# The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces
-# of code that will be used on startup of the MathJax code. See the MathJax site
-# (see:
-# http://docs.mathjax.org/en/v2.7-latest/output.html) for more details. For an
-# example see the documentation.
-# This tag requires that the tag USE_MATHJAX is set to YES.
-
-MATHJAX_CODEFILE       =
-
-# When the SEARCHENGINE tag is enabled doxygen will generate a search box for
-# the HTML output. The underlying search engine uses javascript and DHTML and
-# should work on any modern browser. Note that when using HTML help
-# (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET)
-# there is already a search function so this one should typically be disabled.
-# For large projects the javascript based search engine can be slow, then
-# enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to
-# search using the keyboard; to jump to the search box use <access key> + S
-# (what the <access key> is depends on the OS and browser, but it is typically
-# <CTRL>, <ALT>/<option>, or both). Inside the search box use the <cursor down
-# key> to jump into the search results window, the results can be navigated
-# using the <cursor keys>. Press <Enter> to select an item or <escape> to cancel
-# the search. The filter options can be selected when the cursor is inside the
-# search box by pressing <Shift>+<cursor down>. Also here use the <cursor keys>
-# to select a filter and <Enter> or <escape> to activate or cancel the filter
-# option.
-# The default value is: YES.
-# This tag requires that the tag GENERATE_HTML is set to YES.
-
-SEARCHENGINE           = YES
-
-# When the SERVER_BASED_SEARCH tag is enabled the search engine will be
-# implemented using a web server instead of a web client using JavaScript. There
-# are two flavors of web server based searching depending on the EXTERNAL_SEARCH
-# setting. When disabled, doxygen will generate a PHP script for searching and
-# an index file used by the script. When EXTERNAL_SEARCH is enabled the indexing
-# and searching needs to be provided by external tools. See the section
-# "External Indexing and Searching" for details.
-# The default value is: NO.
-# This tag requires that the tag SEARCHENGINE is set to YES.
-
-SERVER_BASED_SEARCH    = NO
-
-# When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP
-# script for searching. Instead the search results are written to an XML file
-# which needs to be processed by an external indexer. Doxygen will invoke an
-# external search engine pointed to by the SEARCHENGINE_URL option to obtain the
-# search results.
-#
-# Doxygen ships with an example indexer (doxyindexer) and search engine
-# (doxysearch.cgi) which are based on the open source search engine library
-# Xapian (see:
-# https://xapian.org/).
-#
-# See the section "External Indexing and Searching" for details.
-# The default value is: NO.
-# This tag requires that the tag SEARCHENGINE is set to YES.
-
-EXTERNAL_SEARCH        = NO
-
-# The SEARCHENGINE_URL should point to a search engine hosted by a web server
-# which will return the search results when EXTERNAL_SEARCH is enabled.
-#
-# Doxygen ships with an example indexer (doxyindexer) and search engine
-# (doxysearch.cgi) which are based on the open source search engine library
-# Xapian (see:
-# https://xapian.org/). See the section "External Indexing and Searching" for
-# details.
-# This tag requires that the tag SEARCHENGINE is set to YES.
-
-SEARCHENGINE_URL       =
-
-# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the unindexed
-# search data is written to a file for indexing by an external tool. With the
-# SEARCHDATA_FILE tag the name of this file can be specified.
-# The default file is: searchdata.xml.
-# This tag requires that the tag SEARCHENGINE is set to YES.
-
-SEARCHDATA_FILE        = searchdata.xml
-
-# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the
-# EXTERNAL_SEARCH_ID tag can be used as an identifier for the project. This is
-# useful in combination with EXTRA_SEARCH_MAPPINGS to search through multiple
-# projects and redirect the results back to the right project.
-# This tag requires that the tag SEARCHENGINE is set to YES.
-
-EXTERNAL_SEARCH_ID     =
-
-# The EXTRA_SEARCH_MAPPINGS tag can be used to enable searching through doxygen
-# projects other than the one defined by this configuration file, but that are
-# all added to the same external search index. Each project needs to have a
-# unique id set via EXTERNAL_SEARCH_ID. The search mapping then maps the id of
-# to a relative location where the documentation can be found. The format is:
-# EXTRA_SEARCH_MAPPINGS = tagname1=loc1 tagname2=loc2 ...
-# This tag requires that the tag SEARCHENGINE is set to YES.
-
-EXTRA_SEARCH_MAPPINGS  =
-
-#---------------------------------------------------------------------------
-# Configuration options related to the LaTeX output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.
-# The default value is: YES.
-
-GENERATE_LATEX         = NO
-
-# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
-# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
-# it.
-# The default directory is: latex.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_OUTPUT           = latex
-
-# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
-# invoked.
-#
-# Note that when not enabling USE_PDFLATEX the default is latex when enabling
-# USE_PDFLATEX the default is pdflatex and when in the later case latex is
-# chosen this is overwritten by pdflatex. For specific output languages the
-# default can have been set differently, this depends on the implementation of
-# the output language.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_CMD_NAME         = latex
-
-# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate
-# index for LaTeX.
-# Note: This tag is used in the Makefile / make.bat.
-# See also: LATEX_MAKEINDEX_CMD for the part in the generated output file
-# (.tex).
-# The default file is: makeindex.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-MAKEINDEX_CMD_NAME     = makeindex
-
-# The LATEX_MAKEINDEX_CMD tag can be used to specify the command name to
-# generate index for LaTeX. In case there is no backslash (\) as first character
-# it will be automatically added in the LaTeX code.
-# Note: This tag is used in the generated output file (.tex).
-# See also: MAKEINDEX_CMD_NAME for the part in the Makefile / make.bat.
-# The default value is: makeindex.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_MAKEINDEX_CMD    = makeindex
-
-# If the COMPACT_LATEX tag is set to YES, doxygen generates more compact LaTeX
-# documents. This may be useful for small projects and may help to save some
-# trees in general.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-COMPACT_LATEX          = NO
-
-# The PAPER_TYPE tag can be used to set the paper type that is used by the
-# printer.
-# Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x
-# 14 inches) and executive (7.25 x 10.5 inches).
-# The default value is: a4.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-PAPER_TYPE             = a4
-
-# The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
-# that should be included in the LaTeX output. The package can be specified just
-# by its name or with the correct syntax as to be used with the LaTeX
-# \usepackage command. To get the times font for instance you can specify :
-# EXTRA_PACKAGES=times or EXTRA_PACKAGES={times}
-# To use the option intlimits with the amsmath package you can specify:
-# EXTRA_PACKAGES=[intlimits]{amsmath}
-# If left blank no extra packages will be included.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-EXTRA_PACKAGES         =
-
-# The LATEX_HEADER tag can be used to specify a user-defined LaTeX header for
-# the generated LaTeX document. The header should contain everything until the
-# first chapter. If it is left blank doxygen will generate a standard header. It
-# is highly recommended to start with a default header using
-# doxygen -w latex new_header.tex new_footer.tex new_stylesheet.sty
-# and then modify the file new_header.tex. See also section "Doxygen usage" for
-# information on how to generate the default header that doxygen normally uses.
-#
-# Note: Only use a user-defined header if you know what you are doing!
-# Note: The header is subject to change so you typically have to regenerate the
-# default header when upgrading to a newer version of doxygen. The following
-# commands have a special meaning inside the header (and footer): For a
-# description of the possible markers and block names see the documentation.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_HEADER           =
-
-# The LATEX_FOOTER tag can be used to specify a user-defined LaTeX footer for
-# the generated LaTeX document. The footer should contain everything after the
-# last chapter. If it is left blank doxygen will generate a standard footer. See
-# LATEX_HEADER for more information on how to generate a default footer and what
-# special commands can be used inside the footer. See also section "Doxygen
-# usage" for information on how to generate the default footer that doxygen
-# normally uses. Note: Only use a user-defined footer if you know what you are
-# doing!
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_FOOTER           =
-
-# The LATEX_EXTRA_STYLESHEET tag can be used to specify additional user-defined
-# LaTeX style sheets that are included after the standard style sheets created
-# by doxygen. Using this option one can overrule certain style aspects. Doxygen
-# will copy the style sheet files to the output directory.
-# Note: The order of the extra style sheet files is of importance (e.g. the last
-# style sheet in the list overrules the setting of the previous ones in the
-# list).
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_EXTRA_STYLESHEET =
-
-# The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or
-# other source files which should be copied to the LATEX_OUTPUT output
-# directory. Note that the files will be copied as-is; there are no commands or
-# markers available.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_EXTRA_FILES      =
-
-# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is
-# prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will
-# contain links (just like the HTML output) instead of page references. This
-# makes the output suitable for online browsing using a PDF viewer.
-# The default value is: YES.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-PDF_HYPERLINKS         = YES
-
-# If the USE_PDFLATEX tag is set to YES, doxygen will use the engine as
-# specified with LATEX_CMD_NAME to generate the PDF file directly from the LaTeX
-# files. Set this option to YES, to get a higher quality PDF documentation.
-#
-# See also section LATEX_CMD_NAME for selecting the engine.
-# The default value is: YES.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-USE_PDFLATEX           = YES
-
-# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode
-# command to the generated LaTeX files. This will instruct LaTeX to keep running
-# if errors occur, instead of asking the user for help.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_BATCHMODE        = NO
-
-# If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the
-# index chapters (such as File Index, Compound Index, etc.) in the output.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_HIDE_INDICES     = NO
-
-# The LATEX_BIB_STYLE tag can be used to specify the style to use for the
-# bibliography, e.g. plainnat, or ieeetr. See
-# https://en.wikipedia.org/wiki/BibTeX and \cite for more info.
-# The default value is: plain.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_BIB_STYLE        = plain
-
-# If the LATEX_TIMESTAMP tag is set to YES then the footer of each generated
-# page will contain the date and time when the page was generated. Setting this
-# to NO can help when comparing the output of multiple runs.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_TIMESTAMP        = NO
-
-# The LATEX_EMOJI_DIRECTORY tag is used to specify the (relative or absolute)
-# path from which the emoji images will be read. If a relative path is entered,
-# it will be relative to the LATEX_OUTPUT directory. If left blank the
-# LATEX_OUTPUT directory will be used.
-# This tag requires that the tag GENERATE_LATEX is set to YES.
-
-LATEX_EMOJI_DIRECTORY  =
-
-#---------------------------------------------------------------------------
-# Configuration options related to the RTF output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_RTF tag is set to YES, doxygen will generate RTF output. The
-# RTF output is optimized for Word 97 and may not look too pretty with other RTF
-# readers/editors.
-# The default value is: NO.
-
-GENERATE_RTF           = NO
-
-# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a
-# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
-# it.
-# The default directory is: rtf.
-# This tag requires that the tag GENERATE_RTF is set to YES.
-
-RTF_OUTPUT             = rtf
-
-# If the COMPACT_RTF tag is set to YES, doxygen generates more compact RTF
-# documents. This may be useful for small projects and may help to save some
-# trees in general.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_RTF is set to YES.
-
-COMPACT_RTF            = NO
-
-# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will
-# contain hyperlink fields. The RTF file will contain links (just like the HTML
-# output) instead of page references. This makes the output suitable for online
-# browsing using Word or some other Word compatible readers that support those
-# fields.
-#
-# Note: WordPad (write) and others do not support links.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_RTF is set to YES.
-
-RTF_HYPERLINKS         = YES
-
-# Load stylesheet definitions from file. Syntax is similar to doxygen's
-# configuration file, i.e. a series of assignments. You only have to provide
-# replacements, missing definitions are set to their default value.
-#
-# See also section "Doxygen usage" for information on how to generate the
-# default style sheet that doxygen normally uses.
-# This tag requires that the tag GENERATE_RTF is set to YES.
-
-RTF_STYLESHEET_FILE    = rtfstyle.cfg
-
-# Set optional variables used in the generation of an RTF document. Syntax is
-# similar to doxygen's configuration file. A template extensions file can be
-# generated using doxygen -e rtf extensionFile.
-# This tag requires that the tag GENERATE_RTF is set to YES.
-
-RTF_EXTENSIONS_FILE    =
-
-#---------------------------------------------------------------------------
-# Configuration options related to the man page output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_MAN tag is set to YES, doxygen will generate man pages for
-# classes and files.
-# The default value is: NO.
-
-GENERATE_MAN           = NO
-
-# The MAN_OUTPUT tag is used to specify where the man pages will be put. If a
-# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
-# it. A directory man3 will be created inside the directory specified by
-# MAN_OUTPUT.
-# The default directory is: man.
-# This tag requires that the tag GENERATE_MAN is set to YES.
-
-MAN_OUTPUT             = man
-
-# The MAN_EXTENSION tag determines the extension that is added to the generated
-# man pages. In case the manual section does not start with a number, the number
-# 3 is prepended. The dot (.) at the beginning of the MAN_EXTENSION tag is
-# optional.
-# The default value is: .3.
-# This tag requires that the tag GENERATE_MAN is set to YES.
-
-MAN_EXTENSION          = .3
-
-# The MAN_SUBDIR tag determines the name of the directory created within
-# MAN_OUTPUT in which the man pages are placed. If defaults to man followed by
-# MAN_EXTENSION with the initial . removed.
-# This tag requires that the tag GENERATE_MAN is set to YES.
-
-MAN_SUBDIR             =
-
-# If the MAN_LINKS tag is set to YES and doxygen generates man output, then it
-# will generate one additional man file for each entity documented in the real
-# man page(s). These additional files only source the real man page, but without
-# them the man command would be unable to find the correct page.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_MAN is set to YES.
-
-MAN_LINKS              = NO
-
-#---------------------------------------------------------------------------
-# Configuration options related to the XML output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_XML tag is set to YES, doxygen will generate an XML file that
-# captures the structure of the code including all documentation.
-# The default value is: NO.
-
-GENERATE_XML           = NO
-
-# The XML_OUTPUT tag is used to specify where the XML pages will be put. If a
-# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
-# it.
-# The default directory is: xml.
-# This tag requires that the tag GENERATE_XML is set to YES.
-
-XML_OUTPUT             = xml
-
-# If the XML_PROGRAMLISTING tag is set to YES, doxygen will dump the program
-# listings (including syntax highlighting and cross-referencing information) to
-# the XML output. Note that enabling this will significantly increase the size
-# of the XML output.
-# The default value is: YES.
-# This tag requires that the tag GENERATE_XML is set to YES.
-
-XML_PROGRAMLISTING     = YES
-
-# If the XML_NS_MEMB_FILE_SCOPE tag is set to YES, doxygen will include
-# namespace members in file scope as well, matching the HTML output.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_XML is set to YES.
-
-XML_NS_MEMB_FILE_SCOPE = NO
-
-#---------------------------------------------------------------------------
-# Configuration options related to the DOCBOOK output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_DOCBOOK tag is set to YES, doxygen will generate Docbook files
-# that can be used to generate PDF.
-# The default value is: NO.
-
-GENERATE_DOCBOOK       = NO
-
-# The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put.
-# If a relative path is entered the value of OUTPUT_DIRECTORY will be put in
-# front of it.
-# The default directory is: docbook.
-# This tag requires that the tag GENERATE_DOCBOOK is set to YES.
-
-DOCBOOK_OUTPUT         = docbook
-
-#---------------------------------------------------------------------------
-# Configuration options for the AutoGen Definitions output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_AUTOGEN_DEF tag is set to YES, doxygen will generate an
-# AutoGen Definitions (see http://autogen.sourceforge.net/) file that captures
-# the structure of the code including all documentation. Note that this feature
-# is still experimental and incomplete at the moment.
-# The default value is: NO.
-
-GENERATE_AUTOGEN_DEF   = NO
-
-#---------------------------------------------------------------------------
-# Configuration options related to Sqlite3 output
-#---------------------------------------------------------------------------
-
-#---------------------------------------------------------------------------
-# Configuration options related to the Perl module output
-#---------------------------------------------------------------------------
-
-# If the GENERATE_PERLMOD tag is set to YES, doxygen will generate a Perl module
-# file that captures the structure of the code including all documentation.
-#
-# Note that this feature is still experimental and incomplete at the moment.
-# The default value is: NO.
-
-GENERATE_PERLMOD       = NO
-
-# If the PERLMOD_LATEX tag is set to YES, doxygen will generate the necessary
-# Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI
-# output from the Perl module output.
-# The default value is: NO.
-# This tag requires that the tag GENERATE_PERLMOD is set to YES.
-
-PERLMOD_LATEX          = NO
-
-# If the PERLMOD_PRETTY tag is set to YES, the Perl module output will be nicely
-# formatted so it can be parsed by a human reader. This is useful if you want to
-# understand what is going on. On the other hand, if this tag is set to NO, the
-# size of the Perl module output will be much smaller and Perl will parse it
-# just the same.
-# The default value is: YES.
-# This tag requires that the tag GENERATE_PERLMOD is set to YES.
-
-PERLMOD_PRETTY         = YES
-
-# The names of the make variables in the generated doxyrules.make file are
-# prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. This is useful
-# so different doxyrules.make files included by the same Makefile don't
-# overwrite each other's variables.
-# This tag requires that the tag GENERATE_PERLMOD is set to YES.
-
-PERLMOD_MAKEVAR_PREFIX =
-
-#---------------------------------------------------------------------------
-# Configuration options related to the preprocessor
-#---------------------------------------------------------------------------
-
-# If the ENABLE_PREPROCESSING tag is set to YES, doxygen will evaluate all
-# C-preprocessor directives found in the sources and include files.
-# The default value is: YES.
-
-ENABLE_PREPROCESSING   = YES
-
-# If the MACRO_EXPANSION tag is set to YES, doxygen will expand all macro names
-# in the source code. If set to NO, only conditional compilation will be
-# performed. Macro expansion can be done in a controlled way by setting
-# EXPAND_ONLY_PREDEF to YES.
-# The default value is: NO.
-# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
-
-MACRO_EXPANSION        = YES
-
-# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then
-# the macro expansion is limited to the macros specified with the PREDEFINED and
-# EXPAND_AS_DEFINED tags.
-# The default value is: NO.
-# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
-
-EXPAND_ONLY_PREDEF     = NO
-
-# If the SEARCH_INCLUDES tag is set to YES, the include files in the
-# INCLUDE_PATH will be searched if a #include is found.
-# The default value is: YES.
-# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
-
-SEARCH_INCLUDES        = YES
-
-# The INCLUDE_PATH tag can be used to specify one or more directories that
-# contain include files that are not input files but should be processed by the
-# preprocessor.
-# This tag requires that the tag SEARCH_INCLUDES is set to YES.
-
-INCLUDE_PATH           =
-
-# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
-# patterns (like *.h and *.hpp) to filter out the header-files in the
-# directories. If left blank, the patterns specified with FILE_PATTERNS will be
-# used.
-# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
-
-INCLUDE_FILE_PATTERNS  =
-
-# The PREDEFINED tag can be used to specify one or more macro names that are
-# defined before the preprocessor is started (similar to the -D option of e.g.
-# gcc). The argument of the tag is a list of macros of the form: name or
-# name=definition (no spaces). If the definition and the "=" are omitted, "=1"
-# is assumed. To prevent a macro definition from being undefined via #undef or
-# recursively expanded use the := operator instead of the = operator.
-# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
-
-PREDEFINED             = __attribute__(x)= \
-                         DOXYGEN \
-                         protected=private \
-                         DOXYGEN_SHOULD_SKIP_THIS \
-                         ARDUINO
-
-# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
-# tag can be used to specify a list of macro names that should be expanded. The
-# macro definition that is found in the sources will be used. Use the PREDEFINED
-# tag if you want to use a different macro definition that overrules the
-# definition found in the source code.
-# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
-
-EXPAND_AS_DEFINED      =
-
-# If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will
-# remove all references to function-like macros that are alone on a line, have
-# an all uppercase name, and do not end with a semicolon. Such function macros
-# are typically used for boiler-plate code, and will confuse the parser if not
-# removed.
-# The default value is: YES.
-# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
-
-SKIP_FUNCTION_MACROS   = YES
-
-#---------------------------------------------------------------------------
-# Configuration options related to external references
-#---------------------------------------------------------------------------
-
-# The TAGFILES tag can be used to specify one or more tag files. For each tag
-# file the location of the external documentation should be added. The format of
-# a tag file without this location is as follows:
-# TAGFILES = file1 file2 ...
-# Adding location for the tag files is done as follows:
-# TAGFILES = file1=loc1 "file2 = loc2" ...
-# where loc1 and loc2 can be relative or absolute paths or URLs. See the
-# section "Linking to external documentation" for more information about the use
-# of tag files.
-# Note: Each tag file must have a unique name (where the name does NOT include
-# the path). If a tag file is not located in the directory in which doxygen is
-# run, you must also specify the path to the tagfile here.
-
-TAGFILES               =
-
-# When a file name is specified after GENERATE_TAGFILE, doxygen will create a
-# tag file that is based on the input files it reads. See section "Linking to
-# external documentation" for more information about the usage of tag files.
-
-GENERATE_TAGFILE       =
-
-# If the ALLEXTERNALS tag is set to YES, all external class will be listed in
-# the class index. If set to NO, only the inherited external classes will be
-# listed.
-# The default value is: NO.
-
-ALLEXTERNALS           = NO
-
-# If the EXTERNAL_GROUPS tag is set to YES, all external groups will be listed
-# in the modules index. If set to NO, only the current project's groups will be
-# listed.
-# The default value is: YES.
-
-EXTERNAL_GROUPS        = YES
-
-# If the EXTERNAL_PAGES tag is set to YES, all external pages will be listed in
-# the related pages index. If set to NO, only the current project's pages will
-# be listed.
-# The default value is: YES.
-
-EXTERNAL_PAGES         = YES
-
-#---------------------------------------------------------------------------
-# Configuration options related to the dot tool
-#---------------------------------------------------------------------------
-
-# If the CLASS_DIAGRAMS tag is set to YES, doxygen will generate a class diagram
-# (in HTML and LaTeX) for classes with base or super classes. Setting the tag to
-# NO turns the diagrams off. Note that this option also works with HAVE_DOT
-# disabled, but it is recommended to install and use dot, since it yields more
-# powerful graphs.
-# The default value is: YES.
-
-CLASS_DIAGRAMS         = YES
-
-# You can include diagrams made with dia in doxygen documentation. Doxygen will
-# then run dia to produce the diagram and insert it in the documentation. The
-# DIA_PATH tag allows you to specify the directory where the dia binary resides.
-# If left empty dia is assumed to be found in the default search path.
-
-DIA_PATH               =
-
-# If set to YES the inheritance and collaboration graphs will hide inheritance
-# and usage relations if the target is undocumented or is not a class.
-# The default value is: YES.
-
-HIDE_UNDOC_RELATIONS   = YES
-
-# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
-# available from the path. This tool is part of Graphviz (see:
-# http://www.graphviz.org/), a graph visualization toolkit from AT&T and Lucent
-# Bell Labs. The other options in this section have no effect if this option is
-# set to NO
-# The default value is: NO.
-
-HAVE_DOT               = YES
-
-# The DOT_NUM_THREADS specifies the number of dot invocations doxygen is allowed
-# to run in parallel. When set to 0 doxygen will base this on the number of
-# processors available in the system. You can set it explicitly to a value
-# larger than 0 to get control over the balance between CPU load and processing
-# speed.
-# Minimum value: 0, maximum value: 32, default value: 0.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_NUM_THREADS        = 0
-
-# When you want a differently looking font in the dot files that doxygen
-# generates you can specify the font name using DOT_FONTNAME. You need to make
-# sure dot is able to find the font, which can be done by putting it in a
-# standard location or by setting the DOTFONTPATH environment variable or by
-# setting DOT_FONTPATH to the directory containing the font.
-# The default value is: Helvetica.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_FONTNAME           = Helvetica
-
-# The DOT_FONTSIZE tag can be used to set the size (in points) of the font of
-# dot graphs.
-# Minimum value: 4, maximum value: 24, default value: 10.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_FONTSIZE           = 10
-
-# By default doxygen will tell dot to use the default font as specified with
-# DOT_FONTNAME. If you specify a different font using DOT_FONTNAME you can set
-# the path where dot can find it using this tag.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_FONTPATH           =
-
-# If the CLASS_GRAPH tag is set to YES then doxygen will generate a graph for
-# each documented class showing the direct and indirect inheritance relations.
-# Setting this tag to YES will force the CLASS_DIAGRAMS tag to NO.
-# The default value is: YES.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-CLASS_GRAPH            = YES
-
-# If the COLLABORATION_GRAPH tag is set to YES then doxygen will generate a
-# graph for each documented class showing the direct and indirect implementation
-# dependencies (inheritance, containment, and class references variables) of the
-# class with other documented classes.
-# The default value is: YES.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-COLLABORATION_GRAPH    = YES
-
-# If the GROUP_GRAPHS tag is set to YES then doxygen will generate a graph for
-# groups, showing the direct groups dependencies.
-# The default value is: YES.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-GROUP_GRAPHS           = YES
-
-# If the UML_LOOK tag is set to YES, doxygen will generate inheritance and
-# collaboration diagrams in a style similar to the OMG's Unified Modeling
-# Language.
-# The default value is: NO.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-UML_LOOK               = NO
-
-# If the UML_LOOK tag is enabled, the fields and methods are shown inside the
-# class node. If there are many fields or methods and many nodes the graph may
-# become too big to be useful. The UML_LIMIT_NUM_FIELDS threshold limits the
-# number of items for each type to make the size more manageable. Set this to 0
-# for no limit. Note that the threshold may be exceeded by 50% before the limit
-# is enforced. So when you set the threshold to 10, up to 15 fields may appear,
-# but if the number exceeds 15, the total amount of fields shown is limited to
-# 10.
-# Minimum value: 0, maximum value: 100, default value: 10.
-# This tag requires that the tag UML_LOOK is set to YES.
-
-UML_LIMIT_NUM_FIELDS   = 10
-
-# If the DOT_UML_DETAILS tag is set to NO, doxygen will show attributes and
-# methods without types and arguments in the UML graphs. If the DOT_UML_DETAILS
-# tag is set to YES, doxygen will add type and arguments for attributes and
-# methods in the UML graphs. If the DOT_UML_DETAILS tag is set to NONE, doxygen
-# will not generate fields with class member information in the UML graphs. The
-# class diagrams will look similar to the default class diagrams but using UML
-# notation for the relationships.
-# Possible values are: NO, YES and NONE.
-# The default value is: NO.
-# This tag requires that the tag UML_LOOK is set to YES.
-
-DOT_UML_DETAILS        = NO
-
-# The DOT_WRAP_THRESHOLD tag can be used to set the maximum number of characters
-# to display on a single line. If the actual line length exceeds this threshold
-# significantly it will wrapped across multiple lines. Some heuristics are apply
-# to avoid ugly line breaks.
-# Minimum value: 0, maximum value: 1000, default value: 17.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_WRAP_THRESHOLD     = 17
-
-# If the TEMPLATE_RELATIONS tag is set to YES then the inheritance and
-# collaboration graphs will show the relations between templates and their
-# instances.
-# The default value is: NO.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-TEMPLATE_RELATIONS     = NO
-
-# If the INCLUDE_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are set to
-# YES then doxygen will generate a graph for each documented file showing the
-# direct and indirect include dependencies of the file with other documented
-# files.
-# The default value is: YES.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-INCLUDE_GRAPH          = YES
-
-# If the INCLUDED_BY_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are
-# set to YES then doxygen will generate a graph for each documented file showing
-# the direct and indirect include dependencies of the file with other documented
-# files.
-# The default value is: YES.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-INCLUDED_BY_GRAPH      = YES
-
-# If the CALL_GRAPH tag is set to YES then doxygen will generate a call
-# dependency graph for every global function or class method.
-#
-# Note that enabling this option will significantly increase the time of a run.
-# So in most cases it will be better to enable call graphs for selected
-# functions only using the \callgraph command. Disabling a call graph can be
-# accomplished by means of the command \hidecallgraph.
-# The default value is: NO.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-CALL_GRAPH             = NO
-
-# If the CALLER_GRAPH tag is set to YES then doxygen will generate a caller
-# dependency graph for every global function or class method.
-#
-# Note that enabling this option will significantly increase the time of a run.
-# So in most cases it will be better to enable caller graphs for selected
-# functions only using the \callergraph command. Disabling a caller graph can be
-# accomplished by means of the command \hidecallergraph.
-# The default value is: NO.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-CALLER_GRAPH           = NO
-
-# If the GRAPHICAL_HIERARCHY tag is set to YES then doxygen will graphical
-# hierarchy of all classes instead of a textual one.
-# The default value is: YES.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-GRAPHICAL_HIERARCHY    = YES
-
-# If the DIRECTORY_GRAPH tag is set to YES then doxygen will show the
-# dependencies a directory has on other directories in a graphical way. The
-# dependency relations are determined by the #include relations between the
-# files in the directories.
-# The default value is: YES.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DIRECTORY_GRAPH        = YES
-
-# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
-# generated by dot. For an explanation of the image formats see the section
-# output formats in the documentation of the dot tool (Graphviz (see:
-# http://www.graphviz.org/)).
-# Note: If you choose svg you need to set HTML_FILE_EXTENSION to xhtml in order
-# to make the SVG files visible in IE 9+ (other browsers do not have this
-# requirement).
-# Possible values are: png, jpg, gif, svg, png:gd, png:gd:gd, png:cairo,
-# png:cairo:gd, png:cairo:cairo, png:cairo:gdiplus, png:gdiplus and
-# png:gdiplus:gdiplus.
-# The default value is: png.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_IMAGE_FORMAT       = png
-
-# If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to
-# enable generation of interactive SVG images that allow zooming and panning.
-#
-# Note that this requires a modern browser other than Internet Explorer. Tested
-# and working are Firefox, Chrome, Safari, and Opera.
-# Note: For IE 9+ you need to set HTML_FILE_EXTENSION to xhtml in order to make
-# the SVG files visible. Older versions of IE do not have SVG support.
-# The default value is: NO.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-INTERACTIVE_SVG        = NO
-
-# The DOT_PATH tag can be used to specify the path where the dot tool can be
-# found. If left blank, it is assumed the dot tool can be found in the path.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_PATH               =
-
-# The DOTFILE_DIRS tag can be used to specify one or more directories that
-# contain dot files that are included in the documentation (see the \dotfile
-# command).
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOTFILE_DIRS           =
-
-# The MSCFILE_DIRS tag can be used to specify one or more directories that
-# contain msc files that are included in the documentation (see the \mscfile
-# command).
-
-MSCFILE_DIRS           =
-
-# The DIAFILE_DIRS tag can be used to specify one or more directories that
-# contain dia files that are included in the documentation (see the \diafile
-# command).
-
-DIAFILE_DIRS           =
-
-# When using plantuml, the PLANTUML_JAR_PATH tag should be used to specify the
-# path where java can find the plantuml.jar file. If left blank, it is assumed
-# PlantUML is not used or called during a preprocessing step. Doxygen will
-# generate a warning when it encounters a \startuml command in this case and
-# will not generate output for the diagram.
-
-PLANTUML_JAR_PATH      =
-
-# When using plantuml, the PLANTUML_CFG_FILE tag can be used to specify a
-# configuration file for plantuml.
-
-PLANTUML_CFG_FILE      =
-
-# When using plantuml, the specified paths are searched for files specified by
-# the !include statement in a plantuml block.
-
-PLANTUML_INCLUDE_PATH  =
-
-# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of nodes
-# that will be shown in the graph. If the number of nodes in a graph becomes
-# larger than this value, doxygen will truncate the graph, which is visualized
-# by representing a node as a red box. Note that doxygen if the number of direct
-# children of the root node in a graph is already larger than
-# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that
-# the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
-# Minimum value: 0, maximum value: 10000, default value: 50.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_GRAPH_MAX_NODES    = 50
-
-# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the graphs
-# generated by dot. A depth value of 3 means that only nodes reachable from the
-# root by following a path via at most 3 edges will be shown. Nodes that lay
-# further from the root node will be omitted. Note that setting this option to 1
-# or 2 may greatly reduce the computation time needed for large code bases. Also
-# note that the size of a graph can be further restricted by
-# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.
-# Minimum value: 0, maximum value: 1000, default value: 0.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-MAX_DOT_GRAPH_DEPTH    = 1000
-
-# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent
-# background. This is disabled by default, because dot on Windows does not seem
-# to support this out of the box.
-#
-# Warning: Depending on the platform used, enabling this option may lead to
-# badly anti-aliased labels on the edges of a graph (i.e. they become hard to
-# read).
-# The default value is: NO.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_TRANSPARENT        = YES
-
-# Set the DOT_MULTI_TARGETS tag to YES to allow dot to generate multiple output
-# files in one run (i.e. multiple -o and -T options on the command line). This
-# makes dot run faster, but since only newer versions of dot (>1.8.10) support
-# this, this feature is disabled by default.
-# The default value is: NO.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-DOT_MULTI_TARGETS      = NO
-
-# If the GENERATE_LEGEND tag is set to YES doxygen will generate a legend page
-# explaining the meaning of the various boxes and arrows in the dot generated
-# graphs.
-# The default value is: YES.
-# This tag requires that the tag HAVE_DOT is set to YES.
-
-GENERATE_LEGEND        = YES
-
-# If the DOT_CLEANUP tag is set to YES, doxygen will remove the intermediate
-# files that are used to generate the various graphs.
-#
-# Note: This setting is not only used for dot files but also for msc temporary
-# files.
-# The default value is: YES.
-
-DOT_CLEANUP            = YES

lib/SdFat_NoArduino/doc/SdErrorCodes.txt

@@ -1,50 +0,0 @@
-2021-01-06
-
-Run the SdErrorCode example to produce an updated list.
-
-Code,Symbol - failed operation
-0X00,SD_CARD_ERROR_NONE - No error
-0X01,SD_CARD_ERROR_CMD0 - Card reset failed
-0X02,SD_CARD_ERROR_CMD2 - SDIO read CID
-0X03,SD_CARD_ERROR_CMD3 - SDIO publish RCA
-0X04,SD_CARD_ERROR_CMD6 - Switch card function
-0X05,SD_CARD_ERROR_CMD7 - SDIO card select
-0X06,SD_CARD_ERROR_CMD8 - Send and check interface settings
-0X07,SD_CARD_ERROR_CMD9 - Read CSD data
-0X08,SD_CARD_ERROR_CMD10 - Read CID data
-0X09,SD_CARD_ERROR_CMD12 - Stop multiple block read
-0X0A,SD_CARD_ERROR_CMD13 - Read card status
-0X0B,SD_CARD_ERROR_CMD17 - Read single block
-0X0C,SD_CARD_ERROR_CMD18 - Read multiple blocks
-0X0D,SD_CARD_ERROR_CMD24 - Write single block
-0X0E,SD_CARD_ERROR_CMD25 - Write multiple blocks
-0X0F,SD_CARD_ERROR_CMD32 - Set first erase block
-0X10,SD_CARD_ERROR_CMD33 - Set last erase block
-0X11,SD_CARD_ERROR_CMD38 - Erase selected blocks
-0X12,SD_CARD_ERROR_CMD58 - Read OCR register
-0X13,SD_CARD_ERROR_CMD59 - Set CRC mode
-0X14,SD_CARD_ERROR_ACMD6 - Set SDIO bus width
-0X15,SD_CARD_ERROR_ACMD13 - Read extended status
-0X16,SD_CARD_ERROR_ACMD23 - Set pre-erased count
-0X17,SD_CARD_ERROR_ACMD41 - Activate card initialization
-0X18,SD_CARD_ERROR_READ_TOKEN - Bad read data token
-0X19,SD_CARD_ERROR_READ_CRC - Read CRC error
-0X1A,SD_CARD_ERROR_READ_FIFO - SDIO fifo read timeout
-0X1B,SD_CARD_ERROR_READ_REG - Read CID or CSD failed.
-0X1C,SD_CARD_ERROR_READ_START - Bad readStart argument
-0X1D,SD_CARD_ERROR_READ_TIMEOUT - Read data timeout
-0X1E,SD_CARD_ERROR_STOP_TRAN - Multiple block stop failed
-0X1F,SD_CARD_ERROR_TRANSFER_COMPLETE - SDIO transfer complete
-0X20,SD_CARD_ERROR_WRITE_DATA - Write data not accepted
-0X21,SD_CARD_ERROR_WRITE_FIFO - SDIO fifo write timeout
-0X22,SD_CARD_ERROR_WRITE_START - Bad writeStart argument
-0X23,SD_CARD_ERROR_WRITE_PROGRAMMING - Flash programming
-0X24,SD_CARD_ERROR_WRITE_TIMEOUT - Write timeout
-0X25,SD_CARD_ERROR_DMA - DMA transfer failed
-0X26,SD_CARD_ERROR_ERASE - Card did not accept erase commands
-0X27,SD_CARD_ERROR_ERASE_SINGLE_SECTOR - Card does not support erase
-0X28,SD_CARD_ERROR_ERASE_TIMEOUT - Erase command timeout
-0X29,SD_CARD_ERROR_INIT_NOT_CALLED - Card has not been initialized
-0X2A,SD_CARD_ERROR_INVALID_CARD_CONFIG - Invalid card config
-0X2B,SD_CARD_ERROR_FUNCTION_NOT_SUPPORTED - Unsupported SDIO command
-0X2C,SD_CARD_ERROR_UNKNOWN - Unknown error

lib/SdFat_NoArduino/doc/SdFat.html

@@ -1,10 +0,0 @@
-<html>
-<head>
-<title>A web page that points a browser to a different page</title>
-<meta http-equiv="refresh" content="0; URL=html/index.html">
-<meta name="keywords" content="automatic redirection">
-</head>
-<body>
-Your browser didn't automatically redirect. Open html/index.html manually.
-</body>
-</html>

lib/SdFat_NoArduino/doc/ZipMsg/index.html

@@ -1,4 +0,0 @@
-<h3>Replace the content of the html folder by unzipping html.zip.</h3>
-<h3>I have zipped the documentation since Doxygen changes every file each time it runs.</h3>
-<h3>This makes viewing changes on GitHub difficult.</h3>
-<p>&nbsp;</p>

lib/SdFat_NoArduino/doc/clean_html.bat

@@ -1,3 +0,0 @@
-del html\*.md5
-del html\*.map
-pause

lib/SdFat_NoArduino/doc/del_html.bat

@@ -1,3 +0,0 @@
-rm html/*.*
-rm html/search/*.*
-pause

lib/SdFat_NoArduino/doc/html/index.html

@@ -1,4 +0,0 @@
-<h3>Replace the content of the html folder by unzipping html.zip.</h3>
-<h3>I have zipped the documentation since Doxygen changes every file each time it runs.</h3>
-<h3>This makes viewing changes on GitHub difficult.</h3>
-<p>&nbsp;</p>

lib/SdFat_NoArduino/doc/mainpage.h

@@ -1,289 +0,0 @@
-/**
- * Copyright (c) 2011-2021 Bill Greiman
- * This file is part of the SdFat library for SD memory cards.
- *
- * MIT License
- *
- * Permission is hereby granted, free of charge, to any person obtaining a
- * copy of this software and associated documentation files (the "Software"),
- * to deal in the Software without restriction, including without limitation
- * the rights to use, copy, modify, merge, publish, distribute, sublicense,
- * and/or sell copies of the Software, and to permit persons to whom the
- * Software is furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included
- * in all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
- * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
- * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
- * DEALINGS IN THE SOFTWARE.
- */
-/**
-\mainpage Arduino %SdFat Library
-
-\section Warn Warnings for SdFat V2
-
-This is a major new version of SdFat. It is mostly
-backward compatible with SdFat Version 1 for FAT16/FAT32 cards.
-
-You should edit SdFatConfig.h to select features. The default version of
-SdFatConfig.h is suitable for UNO and other small AVR boards. 
-
-\section Intro Introduction
- 
-The Arduino %SdFat library supports FAT16, FAT32, and exFAT file systems 
-on Standard SD, SDHC, and SDXC cards.
- 
-In %SdFat version 1, SdFat and File are the main classes.
-
-In %SdFat version 2, SdFat and File are defined by typedefs in terms of the
-following classes. 
-
-The file system classes in the %SdFat library are SdFat32, SdExFat, and SdFs. 
-SdFat32 supports FAT16 and FAT32. SdExFat supports exFAT, SdFs supports
-FAT16, FAT32, and exFAT.
-
-The corresponding file classes are File32, ExFile, and FsFile.
-
-The types for SdFat and File are defined in SdFatConfig.h. This version
-uses FAT16/FAT32 for small AVR boards and FAT16/FAT32/exFAT for all other
-boards.
-
-\code{.cpp}
-// File types for SdFat, File, SdFile, SdBaseFile, fstream,
-// ifstream, and ofstream.
-//
-// Set SDFAT_FILE_TYPE to:
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-//
-#if defined(__AVR__) && FLASHEND < 0X8000
-// FAT16/FAT32 for 32K AVR boards.
-#define SDFAT_FILE_TYPE 1
-#else  // defined(__AVR__) && FLASHEND < 0X8000
-// FAT16/FAT32 and exFAT for all other boards.
-#define SDFAT_FILE_TYPE 3
-#endif  // defined(__AVR__) && FLASHEND < 0X8000
-\endcode
-
-It is possible to use option three, support or FAT16/FAT32 and exFat 
-on an Uno or other AVR board with 32KB flash and 2KB SRAM but memory
-will be very limited.
-
-Uno memory use for a simple data logger is:
-
-> option 1, FAT16/FAT32, 11902 bytes of flash and 855 bytes of SRAM.
->
-> option 2, exFAT, 14942 bytes of flash and 895 bytes of SRAM.
->
-> option 3, FAT16/FAT32 and exFAT, 21834 bytes of flash and 908 bytes of SRAM. 
-
-Please read documentation under the above classes tab for more information.
-
-A number of example are provided in the %SdFat/examples folder.  These were
-developed to test %SdFat and illustrate its use.
-
-\section exFAT exFAT Features
-
-exFAT has many features not available in FAT16/FAT32.
-
-Files larger than 4GiB, 64-bit file size and file position.
-
-Free space allocation performance improved by using a free space bitmap.
-
-Removal of the physical "." and ".." directory entries that appear in
-FAT16/FAT32 subdirectories.
-
-Better support for large flash pages with boundary alignment offsets
-for the FAT table and data region.
-
-exFAT files have two separate 64-bit length fields.  The DataLength
-field indicate how much space is allocate to the file. The ValidDataLength
-field indicates how much actual data has been written to the file.
-
-An exFAT file can be contiguous with pre-allocate clusters and bypass the
-use of the FAT table.  In this case the contiguous flag is set in the
-directory entry.  This allows an entire file to be written as one large
-multi-block write.
-
-\section SDPath Paths and Working Directories
-
-Relative paths in %SdFat are resolved in a manner similar to Windows.
-
-Each instance of SdFat32, SdExFat, and SdFs has a current directory.  
-This directory is called the volume working directory, vwd.  
-Initially this directory is the root directory for the volume.
-
-The volume working directory is changed by calling the chdir(path).
-
-The call sd.chdir("/2014") will change the volume working directory
-for sd to "/2014", assuming "/2014" exists.
-
-Relative paths for member functions are resolved by starting at
-the volume working directory.
-
-For example, the call sd.mkdir("April") will create the directory
-"/2014/April" assuming the volume working directory is "/2014".
-
-There is current working directory, cwd, that is used to resolve paths
-for file.open() calls.
-
-For a single SD card, the current working directory is always the volume
-working directory for that card.
-
-For multiple SD cards the current working directory is set to the volume
-working directory of a card by calling the chvol() member function.
-The chvol() call is like the Windows \<drive letter>: command.
-
-The call sd2.chvol() will set the current working directory to the volume
-working directory for sd2.
-
-If the volume working directory for sd2 is "/music" the call
-
-file.open("BigBand.wav", O_READ);
-
-will open "/music/BigBand.wav" on sd2.
-
-\section Install Installation
-
-You must manually install %SdFat by renaming the download folder %SdFat 
-and copy the %SdFat folder to the Arduino libraries folder in your
-sketchbook folder. 
-
-It will be necessary to unzip and rename the folder if you download a zip
-file from GitHub.
-
-See the Manual installation section of this guide.
-
-http://arduino.cc/en/Guide/Libraries
-
-\section SDconfig SdFat Configuration
-
-Several configuration options may be changed by editing the SdFatConfig.h
-file in the %SdFat/src folder.
-
-Here are a few of the key options.
-
-If the symbol ENABLE_DEDICATED_SPI is nonzero, multi-block SD I/O may
-be used for better performance.  The SPI bus may not be shared with
-other devices in this mode.
-
-The symbol SPI_DRIVER_SELECT is used to select the SPI driver.
-
-> If the symbol SPI_DRIVER_SELECT is:
->
-> 0 - An optimized custom SPI driver is used if it exists
->     else the standard library driver is used.
->
-> 1 - The standard library driver is always used.
->
-> 2 - The software SPI driver is always used.
->
-> 3 - An external SPI driver derived from SdSpiBaseClass is always used.
-
-To enable SD card CRC checking in SPI mode set USE_SD_CRC nonzero.
-
-See SdFatConfig.h for other options.
-
-\section Hardware Hardware Configuration
-
-The hardware interface to the SD card should not use a resistor based level
-shifter. Resistor based level shifters results in signal rise times that are
- too slow for many newer SD cards.
-
-
-\section HowTo How to format SD Cards
-
-The best way to restore an SD card's format on a PC or Mac is to use
-SDFormatter which can be downloaded from:
-
-http://www.sdcard.org/downloads
-
-A formatter program, SdFormatter.ino, is included in the
-%SdFat/examples/SdFormatter directory.  This program attempts to
-emulate SD Association's SDFormatter.
-
-SDFormatter aligns flash erase boundaries with file
-system structures which reduces write latency and file system overhead.
-
-The PC/Mac SDFormatter does not have an option for FAT type so it may format
-very small cards as FAT12.  Use the %SdFormatter example to force FAT16
-formatting of small cards.
-
-Do not format the SD card with an OS utility, OS utilities do not format SD
-cards in conformance with the SD standard.
-
-You should use a freshly formatted SD card for best performance.  FAT
-file systems become slower if many files have been created and deleted.
-This is because the directory entry for a deleted file is marked as deleted,
-but is not deleted.  When a new file is created, these entries must be scanned
-before creating the file.  Also files can become
-fragmented which causes reads and writes to be slower.
-
-\section ExampleFiles Examples
-
-A number of examples are provided in the SdFat/examples folder.
-
-To access these examples from the Arduino development environment
-go to:  %File -> Examples -> %SdFat -> \<program Name\>
-
-Compile, upload to your Arduino and click on Serial Monitor to run
-the example.
-
-Here is a list:
-
-AvrAdcLogger - Fast AVR ADC logger using Timer/ADC interrupts.
-
-BackwardCompatibility - Demonstrate SD.h compatibility with %SdFat.h.
-
-bench - A read/write benchmark.
-
-%BufferedPrint - Demo a buffered print class for AVR loggers.
-
-debug folder - Some of my debug programs - will be remove in the future.
-
-DirectoryFunctions - Use of chdir(), ls(), mkdir(), and rmdir().
-
-examplesV1 folder - Examples from SdFat V1 for compatibility tests.
-
-ExFatLogger - A data-logger optimized for exFAT features.
-
-MinimumSizeSdReader - Example of small file reader for FAT16/FAT32.
-
-OpenNext - Open all files in the root dir and print their filename.
-
-QuickStart - Quick hardware test for SPI card access.
-
-ReadCsvFile - Function to read a CSV text file one field at a time.
-
-rename - demonstrates use of rename().
-
-RtcTimestampTest - Demonstration of timestamps with RTClib.
-
-SdErrorCodes - Produce a list of error codes.
-
-SdFormatter - This program will format an SD, SDHC, or SDXC card.
-
-SdInfo - Initialize an SD card and analyze its structure for trouble shooting.
-
-SoftwareSpi - Demo of limited Software SPI support in SdFat V2.
-
-STM32Test - Example use of two SPI ports on an STM32 board.
-
-TeensyDmaAdcLogger - Fast logger using DMA ADC.
-
-TeensyRtcTimestamp - %File timestamps for Teensy3.
-
-TeensySdioDemo - Demo of SDIO and SPI modes for the Teensy 3.5/3.6 built-in SD.
-
-TeensySdioLogger -  Fast logger using a ring buffer.
-
-UnicodeFilenames - Test program for Unicode file names.
-
-UserChipSelectFunction - Useful for port expanders or replacement of the standard GPIO functions.
-
-UserSPIDriver - An example of an external SPI driver.
- */

lib/SdFat_NoArduino/examples/AvrAdcLogger/AvrAdcLogger.h

@@ -1,31 +0,0 @@
-#ifndef AnalogBinLogger_h
-#define AnalogBinLogger_h
-const size_t BLOCK_SIZE = 64;
-//------------------------------------------------------------------------------
-// First block of file.
-const size_t PIN_NUM_DIM = BLOCK_SIZE - 3*sizeof(uint32_t) - 2*sizeof(uint8_t);
-struct metadata_t {
-  uint32_t adcFrequency;           // ADC clock frequency
-  uint32_t cpuFrequency;           // CPU clock frequency
-  uint32_t sampleInterval;         // Sample interval in CPU cycles.
-  uint8_t recordEightBits;         // Size of ADC values, nonzero for 8-bits.
-  uint8_t pinCount;                // Number of analog pins in a sample.
-  uint8_t pinNumber[PIN_NUM_DIM];  // List of pin numbers in a sample.
-};
-//------------------------------------------------------------------------------
-// Data block for 8-bit ADC mode.
-const size_t DATA_DIM8 = (BLOCK_SIZE - 2*sizeof(uint16_t))/sizeof(uint8_t);
-struct block8_t {
-  uint16_t count;    // count of data values
-  uint16_t overrun;  // count of overruns since last block
-  uint8_t  data[DATA_DIM8];
-};
-//------------------------------------------------------------------------------
-// Data block for 10-bit ADC mode.
-const size_t DATA_DIM16 = (BLOCK_SIZE - 2*sizeof(uint16_t))/sizeof(uint16_t);
-struct block16_t {
-  unsigned short count;    // count of data values
-  unsigned short overrun;  // count of overruns since last block
-  unsigned short data[DATA_DIM16];
-};
-#endif  // AnalogBinLogger_h

lib/SdFat_NoArduino/examples/AvrAdcLogger/AvrAdcLogger.ino

@@ -1,898 +0,0 @@
-/**
- * This program logs data from the Arduino ADC to a binary file.
- *
- * Samples are logged at regular intervals. Each Sample consists of the ADC
- * values for the analog pins defined in the PIN_LIST array.  The pins numbers
- * may be in any order.
- *
- * Edit the configuration constants below to set the sample pins, sample rate,
- * and other configuration values.
- *
- * If your SD card has a long write latency, it may be necessary to use
- * slower sample rates.  Using a Mega Arduino helps overcome latency
- * problems since more 64 byte buffer blocks will be used.
- *
- * Each 64 byte data block in the file has a four byte header followed by up
- * to 60 bytes of data. (60 values in 8-bit mode or 30 values in 10-bit mode)
- * Each block contains an integral number of samples with unused space at the
- * end of the block.
- *
- */
-#ifdef __AVR__
-#include <SPI.h>
-#include "SdFat.h"
-#include "BufferedPrint.h"
-#include "FreeStack.h"
-#include "AvrAdcLogger.h"
-
-// Save SRAM if 328.
-#ifdef __AVR_ATmega328P__
-#include "MinimumSerial.h"
-MinimumSerial MinSerial;
-#define Serial MinSerial
-#endif  // __AVR_ATmega328P__
-//------------------------------------------------------------------------------
-// This example was designed for exFAT but will support FAT16/FAT32.
-//
-// Note: Uno will not support SD_FAT_TYPE = 3.
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 2
-//------------------------------------------------------------------------------
-// Set USE_RTC nonzero for file timestamps.
-// RAM use will be marginal on Uno with RTClib.
-// Set USE_RTC nonzero for file timestamps.
-// RAM use will be marginal on Uno with RTClib.
-// 0 - RTC not used
-// 1 - DS1307
-// 2 - DS3231
-// 3 - PCF8523
-#define USE_RTC 0
-#if USE_RTC
-#include "RTClib.h"
-#endif  // USE_RTC
-//------------------------------------------------------------------------------
-// Pin definitions.
-//
-// Digital pin to indicate an error, set to -1 if not used.
-// The led blinks for fatal errors. The led goes on solid for SD write
-// overrun errors and logging continues.
-const int8_t ERROR_LED_PIN = -1;
-
-// SD chip select pin.
-const uint8_t SD_CS_PIN = SS;
-//------------------------------------------------------------------------------
-// Analog pin number list for a sample.  Pins may be in any order and pin
-// numbers may be repeated.
-const uint8_t PIN_LIST[] = {0, 1, 2, 3, 4};
-//------------------------------------------------------------------------------
-// Sample rate in samples per second.
-const float SAMPLE_RATE = 5000;  // Must be 0.25 or greater.
-
-// The interval between samples in seconds, SAMPLE_INTERVAL, may be set to a
-// constant instead of being calculated from SAMPLE_RATE.  SAMPLE_RATE is not
-// used in the code below.  For example, setting SAMPLE_INTERVAL = 2.0e-4
-// will result in a 200 microsecond sample interval.
-const float SAMPLE_INTERVAL = 1.0/SAMPLE_RATE;
-
-// Setting ROUND_SAMPLE_INTERVAL non-zero will cause the sample interval to
-// be rounded to a a multiple of the ADC clock period and will reduce sample
-// time jitter.
-#define ROUND_SAMPLE_INTERVAL 1
-//------------------------------------------------------------------------------
-// Reference voltage.  See the processor data-sheet for reference details.
-// uint8_t const ADC_REF = 0; // External Reference AREF pin.
-uint8_t const ADC_REF = (1 << REFS0);  // Vcc Reference.
-// uint8_t const ADC_REF = (1 << REFS1);  // Internal 1.1 (only 644 1284P Mega)
-// uint8_t const ADC_REF = (1 << REFS1) | (1 << REFS0);  // Internal 1.1 or 2.56
-//------------------------------------------------------------------------------
-// File definitions.
-//
-// Maximum file size in bytes.
-// The program creates a contiguous file with MAX_FILE_SIZE_MiB bytes.
-// The file will be truncated if logging is stopped early.
-const uint32_t MAX_FILE_SIZE_MiB = 100;  // 100 MiB file.
-
-// log file name.  Integer field before dot will be incremented.
-#define LOG_FILE_NAME "AvrAdc00.bin"
-
-// Maximum length name including zero byte.
-const size_t NAME_DIM = 40;
-
-// Set RECORD_EIGHT_BITS non-zero to record only the high 8-bits of the ADC.
-#define RECORD_EIGHT_BITS 0
-//------------------------------------------------------------------------------
-// FIFO size definition. Use a multiple of 512 bytes for best performance.
-//
-#if RAMEND < 0X8FF
-#error SRAM too small
-#elif RAMEND < 0X10FF
-const size_t FIFO_SIZE_BYTES = 512;
-#elif RAMEND < 0X20FF
-const size_t FIFO_SIZE_BYTES = 4*512;
-#elif RAMEND < 0X40FF
-const size_t FIFO_SIZE_BYTES = 12*512;
-#else  // RAMEND
-const size_t FIFO_SIZE_BYTES = 16*512;
-#endif  // RAMEND
-//------------------------------------------------------------------------------
-// ADC clock rate.
-// The ADC clock rate is normally calculated from the pin count and sample
-// interval.  The calculation attempts to use the lowest possible ADC clock
-// rate.
-//
-// You can select an ADC clock rate by defining the symbol ADC_PRESCALER to
-// one of these values.  You must choose an appropriate ADC clock rate for
-// your sample interval.
-// #define ADC_PRESCALER 7 // F_CPU/128 125 kHz on an Uno
-// #define ADC_PRESCALER 6 // F_CPU/64  250 kHz on an Uno
-// #define ADC_PRESCALER 5 // F_CPU/32  500 kHz on an Uno
-// #define ADC_PRESCALER 4 // F_CPU/16 1000 kHz on an Uno
-// #define ADC_PRESCALER 3 // F_CPU/8  2000 kHz on an Uno (8-bit mode only)
-//==============================================================================
-// End of configuration constants.
-//==============================================================================
-// Temporary log file.  Will be deleted if a reset or power failure occurs.
-#define TMP_FILE_NAME "tmp_adc.bin"
-
-// Number of analog pins to log.
-const uint8_t PIN_COUNT = sizeof(PIN_LIST)/sizeof(PIN_LIST[0]);
-
-// Minimum ADC clock cycles per sample interval
-const uint16_t MIN_ADC_CYCLES = 15;
-
-// Extra cpu cycles to setup ADC with more than one pin per sample.
-const uint16_t ISR_SETUP_ADC = PIN_COUNT > 1 ? 100 : 0;
-
-// Maximum cycles for timer0 system interrupt.
-const uint16_t ISR_TIMER0 = 160;
-//==============================================================================
-const uint32_t MAX_FILE_SIZE = MAX_FILE_SIZE_MiB << 20;
-
-// Max SPI rate for AVR is 10 MHz for F_CPU 20 MHz, 8 MHz for F_CPU 16 MHz.
-#define SPI_CLOCK SD_SCK_MHZ(10)
-// Select fastest interface.
-#if ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // ENABLE_DEDICATED_SPI
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-typedef File file_t;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-typedef File32 file_t;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-typedef ExFile file_t;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-typedef FsFile file_t;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-file_t binFile;
-file_t csvFile;
-
-char binName[] = LOG_FILE_NAME;
-
-#if RECORD_EIGHT_BITS
-const size_t BLOCK_MAX_COUNT = PIN_COUNT*(DATA_DIM8/PIN_COUNT);
-typedef block8_t block_t;
-#else  // RECORD_EIGHT_BITS
-const size_t BLOCK_MAX_COUNT = PIN_COUNT*(DATA_DIM16/PIN_COUNT);
-typedef block16_t block_t;
-#endif // RECORD_EIGHT_BITS
-
-// Size of FIFO in blocks.
-size_t const FIFO_DIM = FIFO_SIZE_BYTES/sizeof(block_t);
-block_t* fifoData;
-volatile size_t fifoCount = 0; // volatile - shared, ISR and background.
-size_t fifoHead = 0;  // Only accessed by ISR during logging.
-size_t fifoTail = 0;  // Only accessed by writer during logging.
-//==============================================================================
-// Interrupt Service Routines
-
-// Disable ADC interrupt if true.
-volatile bool isrStop = false;
-
-// Pointer to current buffer.
-block_t* isrBuf = nullptr;
-// overrun count
-uint16_t isrOver = 0;
-
-// ADC configuration for each pin.
-uint8_t adcmux[PIN_COUNT];
-uint8_t adcsra[PIN_COUNT];
-uint8_t adcsrb[PIN_COUNT];
-uint8_t adcindex = 1;
-
-// Insure no timer events are missed.
-volatile bool timerError = false;
-volatile bool timerFlag = false;
-//------------------------------------------------------------------------------
-// ADC done interrupt.
-ISR(ADC_vect) {
-  // Read ADC data.
-#if RECORD_EIGHT_BITS
-  uint8_t d = ADCH;
-#else  // RECORD_EIGHT_BITS
-  // This will access ADCL first.
-  uint16_t d = ADC;
-#endif  // RECORD_EIGHT_BITS
-
-  if (!isrBuf) {
-    if (fifoCount < FIFO_DIM) {
-      isrBuf = fifoData + fifoHead;
-    } else {
-      // no buffers - count overrun
-      if (isrOver < 0XFFFF) {
-        isrOver++;
-      }
-      // Avoid missed timer error.
-      timerFlag = false;
-      return;
-    }
-  }
-  // Start ADC for next pin
-  if (PIN_COUNT > 1) {
-    ADMUX = adcmux[adcindex];
-    ADCSRB = adcsrb[adcindex];
-    ADCSRA = adcsra[adcindex];
-    if (adcindex == 0) {
-      timerFlag = false;
-    }
-    adcindex =  adcindex < (PIN_COUNT - 1) ? adcindex + 1 : 0;
-  } else {
-    timerFlag = false;
-  }
-  // Store ADC data.
-  isrBuf->data[isrBuf->count++] = d;
-
-  // Check for buffer full.
-  if (isrBuf->count >= BLOCK_MAX_COUNT) {
-    fifoHead = fifoHead < (FIFO_DIM - 1) ? fifoHead + 1 : 0;
-    fifoCount++;
-    // Check for end logging.
-    if (isrStop) {
-      adcStop();
-      return;
-    }
-    // Set buffer needed and clear overruns.
-    isrBuf = nullptr;
-    isrOver = 0;
-  }
-}
-//------------------------------------------------------------------------------
-// timer1 interrupt to clear OCF1B
-ISR(TIMER1_COMPB_vect) {
-  // Make sure ADC ISR responded to timer event.
-  if (timerFlag) {
-    timerError = true;
-  }
-  timerFlag = true;
-}
-//==============================================================================
-// Error messages stored in flash.
-#define error(msg) (Serial.println(F(msg)),errorHalt())
-#define assert(e) ((e) ? (void)0 : error("assert: " #e))
-//------------------------------------------------------------------------------
-//
-void fatalBlink() {
-  while (true) {
-    if (ERROR_LED_PIN >= 0) {
-      digitalWrite(ERROR_LED_PIN, HIGH);
-      delay(200);
-      digitalWrite(ERROR_LED_PIN, LOW);
-      delay(200);
-    }
-  }
-}
-//------------------------------------------------------------------------------
-void errorHalt() {
-  // Print minimal error data.
-  // sd.errorPrint(&Serial);
-  // Print extended error info - uses extra bytes of flash.
-  sd.printSdError(&Serial);
-  // Try to save data.
-  binFile.close();
-  fatalBlink();
-}
-//------------------------------------------------------------------------------
-void printUnusedStack() {
-  Serial.print(F("\nUnused stack: "));
-  Serial.println(UnusedStack());
-}
-//------------------------------------------------------------------------------
-#if USE_RTC
-#if USE_RTC == 1
-RTC_DS1307 rtc;
-#elif USE_RTC == 2
-RTC_DS3231 rtc;
-#elif USE_RTC == 3
-RTC_PCF8523 rtc;
-#else  // USE_RTC == type
-#error USE_RTC type not implemented.
-#endif  // USE_RTC == type
-// Call back for file timestamps.  Only called for file create and sync().
-void dateTime(uint16_t* date, uint16_t* time, uint8_t* ms10) {
-  DateTime now = rtc.now();
-
-  // Return date using FS_DATE macro to format fields.
-  *date = FS_DATE(now.year(), now.month(), now.day());
-
-  // Return time using FS_TIME macro to format fields.
-  *time = FS_TIME(now.hour(), now.minute(), now.second());
-
-  // Return low time bits in units of 10 ms.
-  *ms10 = now.second() & 1 ? 100 : 0;
-}
-#endif  // USE_RTC
-//==============================================================================
-#if ADPS0 != 0 || ADPS1 != 1 || ADPS2 != 2
-#error unexpected ADC prescaler bits
-#endif
-//------------------------------------------------------------------------------
-inline bool adcActive() {return (1 << ADIE) & ADCSRA;}
-//------------------------------------------------------------------------------
-// initialize ADC and timer1
-void adcInit(metadata_t* meta) {
-  uint8_t adps;  // prescaler bits for ADCSRA
-  uint32_t ticks = F_CPU*SAMPLE_INTERVAL + 0.5;  // Sample interval cpu cycles.
-
-  if (ADC_REF & ~((1 << REFS0) | (1 << REFS1))) {
-    error("Invalid ADC reference");
-  }
-#ifdef ADC_PRESCALER
-  if (ADC_PRESCALER > 7 || ADC_PRESCALER < 2) {
-    error("Invalid ADC prescaler");
-  }
-  adps = ADC_PRESCALER;
-#else  // ADC_PRESCALER
-  // Allow extra cpu cycles to change ADC settings if more than one pin.
-  int32_t adcCycles = (ticks - ISR_TIMER0)/PIN_COUNT - ISR_SETUP_ADC;
-
-  for (adps = 7; adps > 0; adps--) {
-    if (adcCycles >= (MIN_ADC_CYCLES << adps)) {
-      break;
-    }
-  }
-#endif  // ADC_PRESCALER
-  meta->adcFrequency = F_CPU >> adps;
-  if (meta->adcFrequency > (RECORD_EIGHT_BITS ? 2000000 : 1000000)) {
-    error("Sample Rate Too High");
-  }
-#if ROUND_SAMPLE_INTERVAL
-  // Round so interval is multiple of ADC clock.
-  ticks += 1 << (adps - 1);
-  ticks >>= adps;
-  ticks <<= adps;
-#endif  // ROUND_SAMPLE_INTERVAL
-
-  if (PIN_COUNT > BLOCK_MAX_COUNT || PIN_COUNT > PIN_NUM_DIM) {
-    error("Too many pins");
-  }
-  meta->pinCount = PIN_COUNT;
-  meta->recordEightBits = RECORD_EIGHT_BITS;
-
-  for (int i = 0; i < PIN_COUNT; i++) {
-    uint8_t pin = PIN_LIST[i];
-    if (pin >= NUM_ANALOG_INPUTS) {
-      error("Invalid Analog pin number");
-    }
-    meta->pinNumber[i] = pin;
-
-    // Set ADC reference and low three bits of analog pin number.
-    adcmux[i] = (pin & 7) | ADC_REF;
-    if (RECORD_EIGHT_BITS) {
-      adcmux[i] |= 1 << ADLAR;
-    }
-
-    // If this is the first pin, trigger on timer/counter 1 compare match B.
-    adcsrb[i] = i == 0 ? (1 << ADTS2) | (1 << ADTS0) : 0;
-#ifdef MUX5
-    if (pin > 7) {
-      adcsrb[i] |= (1 << MUX5);
-    }
-#endif  // MUX5
-    adcsra[i] = (1 << ADEN) | (1 << ADIE) | adps;
-    // First pin triggers on timer 1 compare match B rest are free running.
-    adcsra[i] |= i == 0 ? 1 << ADATE : 1 << ADSC;
-  }
-
-  // Setup timer1
-  TCCR1A = 0;
-  uint8_t tshift;
-  if (ticks < 0X10000) {
-    // no prescale, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS10);
-    tshift = 0;
-  } else if (ticks < 0X10000*8) {
-    // prescale 8, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS11);
-    tshift = 3;
-  } else if (ticks < 0X10000*64) {
-    // prescale 64, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS11) | (1 << CS10);
-    tshift = 6;
-  } else if (ticks < 0X10000*256) {
-    // prescale 256, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS12);
-    tshift = 8;
-  } else if (ticks < 0X10000*1024) {
-    // prescale 1024, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS12) | (1 << CS10);
-    tshift = 10;
-  } else {
-    error("Sample Rate Too Slow");
-  }
-  // divide by prescaler
-  ticks >>= tshift;
-  // set TOP for timer reset
-  ICR1 = ticks - 1;
-  // compare for ADC start
-  OCR1B = 0;
-
-  // multiply by prescaler
-  ticks <<= tshift;
-
-  // Sample interval in CPU clock ticks.
-  meta->sampleInterval = ticks;
-  meta->cpuFrequency = F_CPU;
-  float sampleRate = (float)meta->cpuFrequency/meta->sampleInterval;
-  Serial.print(F("Sample pins:"));
-  for (uint8_t i = 0; i < meta->pinCount; i++) {
-    Serial.print(' ');
-    Serial.print(meta->pinNumber[i], DEC);
-  }
-  Serial.println();
-  Serial.print(F("ADC bits: "));
-  Serial.println(meta->recordEightBits ? 8 : 10);
-  Serial.print(F("ADC clock kHz: "));
-  Serial.println(meta->adcFrequency/1000);
-  Serial.print(F("Sample Rate: "));
-  Serial.println(sampleRate);
-  Serial.print(F("Sample interval usec: "));
-  Serial.println(1000000.0/sampleRate);
-}
-//------------------------------------------------------------------------------
-// enable ADC and timer1 interrupts
-void adcStart() {
-  // initialize ISR
-  adcindex = 1;
-  isrBuf = nullptr;
-  isrOver = 0;
-  isrStop = false;
-
-  // Clear any pending interrupt.
-  ADCSRA |= 1 << ADIF;
-
-  // Setup for first pin.
-  ADMUX = adcmux[0];
-  ADCSRB = adcsrb[0];
-  ADCSRA = adcsra[0];
-
-  // Enable timer1 interrupts.
-  timerError = false;
-  timerFlag = false;
-  TCNT1 = 0;
-  TIFR1 = 1 << OCF1B;
-  TIMSK1 = 1 << OCIE1B;
-}
-//------------------------------------------------------------------------------
-inline void adcStop() {
-  TIMSK1 = 0;
-  ADCSRA = 0;
-}
-//------------------------------------------------------------------------------
-// Convert binary file to csv file.
-void binaryToCsv() {
-  uint8_t lastPct = 0;
-  block_t* pd;
-  metadata_t* pm;
-  uint32_t t0 = millis();
-  // Use fast buffered print class.
-  BufferedPrint<file_t, 64> bp(&csvFile);
-  block_t binBuffer[FIFO_DIM];
-
-  assert(sizeof(block_t) == sizeof(metadata_t));
-  binFile.rewind();
-  uint32_t tPct = millis();
-  bool doMeta = true;
-  while (!Serial.available()) {
-    pd = binBuffer;
-    int nb = binFile.read(binBuffer, sizeof(binBuffer));
-    if (nb < 0) {
-      error("read binFile failed");
-    }
-    size_t nd = nb/sizeof(block_t);
-    if (nd < 1) {
-      break;
-    }
-    if (doMeta) {
-      doMeta = false;
-      pm = (metadata_t*)pd++;
-      if (PIN_COUNT != pm->pinCount) {
-        error("Invalid pinCount");
-      }
-      bp.print(F("Interval,"));
-      float intervalMicros = 1.0e6*pm->sampleInterval/(float)pm->cpuFrequency;
-      bp.print(intervalMicros, 4);
-      bp.println(F(",usec"));
-      for (uint8_t i = 0; i < PIN_COUNT; i++) {
-        if (i) {
-          bp.print(',');
-        }
-        bp.print(F("pin"));
-        bp.print(pm->pinNumber[i]);
-      }
-      bp.println();
-      if (nd-- == 1) {
-        break;
-      }
-    }
-    for (size_t i = 0; i < nd; i++, pd++) {
-      if (pd->overrun) {
-        bp.print(F("OVERRUN,"));
-        bp.println(pd->overrun);
-      }
-      for (size_t j = 0; j < pd->count; j += PIN_COUNT) {
-        for (size_t i = 0; i < PIN_COUNT; i++) {
-          if (!bp.printField(pd->data[i + j], i == (PIN_COUNT-1) ? '\n' : ',')) {
-            error("printField failed");
-          }
-        }
-      }
-    }
-    if ((millis() - tPct) > 1000) {
-      uint8_t pct = binFile.curPosition()/(binFile.fileSize()/100);
-      if (pct != lastPct) {
-        tPct = millis();
-        lastPct = pct;
-        Serial.print(pct, DEC);
-        Serial.println('%');
-      }
-    }
-  }
-  if (!bp.sync() || !csvFile.close()) {
-    error("close csvFile failed");
-  }
-  Serial.print(F("Done: "));
-  Serial.print(0.001*(millis() - t0));
-  Serial.println(F(" Seconds"));
-}
-//------------------------------------------------------------------------------
-void clearSerialInput() {
-  uint32_t m = micros();
-  do {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  } while (micros() - m < 10000);
-}
-//------------------------------------------------------------------------------
-void createBinFile() {
-  binFile.close();
-  while (sd.exists(binName)) {
-    char* p = strchr(binName, '.');
-    if (!p) {
-      error("no dot in filename");
-    }
-    while (true) {
-      p--;
-      if (p < binName || *p < '0' || *p > '9') {
-        error("Can't create file name");
-      }
-      if (p[0] != '9') {
-        p[0]++;
-        break;
-      }
-      p[0] = '0';
-    }
-  }
-  Serial.print(F("Opening: "));
-  Serial.println(binName);
-  if (!binFile.open(binName, O_RDWR | O_CREAT)) {
-    error("open binName failed");
-  }
-  Serial.print(F("Allocating: "));
-  Serial.print(MAX_FILE_SIZE_MiB);
-  Serial.println(F(" MiB"));
-  if (!binFile.preAllocate(MAX_FILE_SIZE)) {
-    error("preAllocate failed");
-  }
-}
-//------------------------------------------------------------------------------
-bool createCsvFile() {
-  char csvName[NAME_DIM];
-
-  if (!binFile.isOpen()) {
-    Serial.println(F("No current binary file"));
-    return false;
-  }
-  binFile.getName(csvName, sizeof(csvName));
-  char* dot = strchr(csvName, '.');
-  if (!dot) {
-    error("no dot in binName");
-  }
-  strcpy(dot + 1, "csv");
-  if (!csvFile.open(csvName, O_WRONLY|O_CREAT|O_TRUNC)) {
-    error("open csvFile failed");
-  }
-  Serial.print(F("Writing: "));
-  Serial.print(csvName);
-  Serial.println(F(" - type any character to stop"));
-  return true;
-}
-//------------------------------------------------------------------------------
-// log data
-void logData() {
-  uint32_t t0;
-  uint32_t t1;
-  uint32_t overruns =0;
-  uint32_t count = 0;
-  uint32_t maxLatencyUsec = 0;
-  size_t maxFifoUse = 0;
-  block_t fifoBuffer[FIFO_DIM];
-
-  adcInit((metadata_t*)fifoBuffer);
-  // Write metadata.
-  if (sizeof(metadata_t) != binFile.write(fifoBuffer, sizeof(metadata_t))) {
-    error("Write metadata failed");
-  }
-  fifoCount = 0;
-  fifoHead = 0;
-  fifoTail = 0;
-  fifoData = fifoBuffer;
-  // Initialize all blocks to save ISR overhead.
-  memset(fifoBuffer, 0, sizeof(fifoBuffer));
-
-  Serial.println(F("Logging - type any character to stop"));
-  // Wait for Serial Idle.
-  Serial.flush();
-  delay(10);
-
-  t0 = millis();
-  t1 = t0;
-  // Start logging interrupts.
-  adcStart();
-  while (1) {
-    uint32_t m;
-    noInterrupts();
-    size_t tmpFifoCount = fifoCount;
-    interrupts();
-    if (tmpFifoCount) {
-      block_t* pBlock = fifoData + fifoTail;
-      // Write block to SD.
-      m = micros();
-      if (sizeof(block_t) != binFile.write(pBlock, sizeof(block_t))) {
-        error("write data failed");
-      }
-      m = micros() - m;
-      t1 = millis();
-      if (m > maxLatencyUsec) {
-        maxLatencyUsec = m;
-      }
-      if (tmpFifoCount >maxFifoUse) {
-        maxFifoUse = tmpFifoCount;
-      }
-      count += pBlock->count;
-
-      // Add overruns and possibly light LED.
-      if (pBlock->overrun) {
-        overruns += pBlock->overrun;
-        if (ERROR_LED_PIN >= 0) {
-          digitalWrite(ERROR_LED_PIN, HIGH);
-        }
-      }
-      // Initialize empty block to save ISR overhead.
-      pBlock->count = 0;
-      pBlock->overrun = 0;
-      fifoTail = fifoTail < (FIFO_DIM - 1) ? fifoTail + 1 : 0;
-
-      noInterrupts();
-      fifoCount--;
-      interrupts();
-
-      if (binFile.curPosition() >= MAX_FILE_SIZE) {
-        // File full so stop ISR calls.
-        adcStop();
-        break;
-      }
-    }
-    if (timerError) {
-      error("Missed timer event - rate too high");
-    }
-    if (Serial.available()) {
-      // Stop ISR interrupts.
-      isrStop = true;
-    }
-    if (fifoCount == 0 && !adcActive()) {
-       break;
-    }
-  }
-  Serial.println();
-  // Truncate file if recording stopped early.
-  if (binFile.curPosition() < MAX_FILE_SIZE) {
-    Serial.println(F("Truncating file"));
-    Serial.flush();
-    if (!binFile.truncate()) {
-      error("Can't truncate file");
-    }
-  }
-  Serial.print(F("Max write latency usec: "));
-  Serial.println(maxLatencyUsec);
-  Serial.print(F("Record time sec: "));
-  Serial.println(0.001*(t1 - t0), 3);
-  Serial.print(F("Sample count: "));
-  Serial.println(count/PIN_COUNT);
-  Serial.print(F("Overruns: "));
-  Serial.println(overruns);
-  Serial.print(F("FIFO_DIM: "));
-  Serial.println(FIFO_DIM);
-  Serial.print(F("maxFifoUse: "));
-  Serial.println(maxFifoUse + 1);  // include ISR use.
-  Serial.println(F("Done"));
-}
-//------------------------------------------------------------------------------
-void openBinFile() {
-  char name[NAME_DIM];
-  clearSerialInput();
-  Serial.println(F("Enter file name"));
-  if (!serialReadLine(name, sizeof(name))) {
-    return;
-  }
-  if (!sd.exists(name)) {
-    Serial.println(name);
-    Serial.println(F("File does not exist"));
-    return;
-  }
-  binFile.close();
-  if (!binFile.open(name, O_RDWR)) {
-    Serial.println(name);
-    Serial.println(F("open failed"));
-    return;
-  }
-  Serial.println(F("File opened"));
-}
-//------------------------------------------------------------------------------
-// Print data file to Serial
-void printData() {
-  block_t buf;
-  if (!binFile.isOpen()) {
-    Serial.println(F("No current binary file"));
-    return;
-  }
-  binFile.rewind();
-  if (binFile.read(&buf , sizeof(buf)) != sizeof(buf)) {
-    error("Read metadata failed");
-  }
-  Serial.println(F("Type any character to stop"));
-  delay(1000);
-  while (!Serial.available() &&
-         binFile.read(&buf , sizeof(buf)) == sizeof(buf)) {
-    if (buf.count == 0) {
-      break;
-    }
-    if (buf.overrun) {
-      Serial.print(F("OVERRUN,"));
-      Serial.println(buf.overrun);
-    }
-    for (size_t i = 0; i < buf.count; i++) {
-      Serial.print(buf.data[i], DEC);
-      if ((i+1)%PIN_COUNT) {
-        Serial.print(',');
-      } else {
-        Serial.println();
-      }
-    }
-  }
-  Serial.println(F("Done"));
-}
-//------------------------------------------------------------------------------
-bool serialReadLine(char* str, size_t size) {
-  size_t n = 0;
-  while(!Serial.available()) {
-  }
-  while (true) {
-    int c = Serial.read();
-    if (c < ' ') break;
-    str[n++] = c;
-    if (n >= size) {
-      Serial.println(F("input too long"));
-      return false;
-    }
-    uint32_t m = millis();
-    while (!Serial.available() && (millis() - m) < 100){}
-    if (!Serial.available()) break;
-  }
-  str[n] = 0;
-  return true;
-}
-//------------------------------------------------------------------------------
-void setup(void) {
-  if (ERROR_LED_PIN >= 0) {
-    pinMode(ERROR_LED_PIN, OUTPUT);
-  }
-  Serial.begin(9600);
-  while(!Serial) {}
-  Serial.println(F("Type any character to begin."));
-  while(!Serial.available()) {}
-
-  FillStack();
-
-  // Read the first sample pin to init the ADC.
-  analogRead(PIN_LIST[0]);
-
-#if !ENABLE_DEDICATED_SPI
-  Serial.println(F(
-    "\nFor best performance edit SdFatConfig.h\n"
-    "and set ENABLE_DEDICATED_SPI nonzero"));
-#endif  // !ENABLE_DEDICATED_SPI
-  // Initialize SD.
-  if (!sd.begin(SD_CONFIG)) {
-    error("sd.begin failed");
-  }
-#if USE_RTC
-  if (!rtc.begin()) {
-    error("rtc.begin failed");
-  }
-  if (!rtc.isrunning()) {
-    // Set RTC to sketch compile date & time.
-    // rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));
-    error("RTC is NOT running!");
-  } else {
-    Serial.println(F("RTC is running"));
-  }
-  // Set callback
-  FsDateTime::setCallback(dateTime);
-#endif  // USE_RTC
-}
-//------------------------------------------------------------------------------
-void loop(void) {
-  printUnusedStack();
-  // Read any Serial data.
-  clearSerialInput();
-  Serial.println();
-  Serial.println(F("type:"));
-  Serial.println(F("b - open existing bin file"));
-  Serial.println(F("c - convert file to csv"));
-  Serial.println(F("l - list files"));
-  Serial.println(F("p - print data to Serial"));
-  Serial.println(F("r - record ADC data"));
-
-  while(!Serial.available()) {
-    yield();
-  }
-  char c = tolower(Serial.read());
-  Serial.println();
-  if (ERROR_LED_PIN >= 0) {
-    digitalWrite(ERROR_LED_PIN, LOW);
-  }
-  // Read any Serial data.
-  clearSerialInput();
-
-  if (c == 'b') {
-    openBinFile();
-  } else if (c == 'c') {
-    if (createCsvFile()) {
-      binaryToCsv();
-    }
-  } else if (c == 'l') {
-    Serial.println(F("ls:"));
-    sd.ls(&Serial, LS_DATE | LS_SIZE);
-  } else if (c == 'p') {
-    printData();
-  } else if (c == 'r') {
-    createBinFile();
-    logData();
-  } else {
-    Serial.println(F("Invalid entry"));
-  }
-}
-#else  // __AVR__
-#error This program is only for AVR.
-#endif  // __AVR__

lib/SdFat_NoArduino/examples/BackwardCompatibility/BackwardCompatibility.ino

@@ -1,83 +0,0 @@
-// A simple read/write example for SD.h.
-// Mostly from the SD.h ReadWrite example.
-//
-// Your SD must be formatted FAT16/FAT32.
-//
-// SD.h does not support some default SdFat features.
-// To compare flash size, set USE_FAT_FILE_FLAG_CONTIGUOUS,
-// ENABLE_DEDICATED_SPI, and USE_LONG_FILE_NAMES to zero also
-// set SDFAT_FILE_TYPE to one in SdFat/src/SdFatCongfig.h
-//
-// Set USE_SD_H nonzero to use SD.h.
-// Set USE_SD_H zero to use SdFat.h.
-//
-#define USE_SD_H 0
-//
-#if USE_SD_H
-#include <SD.h>
-#else  // USE_SD_H
-#include "SdFat.h"
-SdFat SD;
-#endif  // USE_SD_H
-
-// Modify SD_CS_PIN for your board.
-// For Teensy 3.6 and SdFat.h use BUILTIN_SDCARD.
-#define SD_CS_PIN SS
-
-File myFile;
-
-void setup() {
-  Serial.begin(9600);
-  while (!Serial) {}
-
-#if USE_SD_H
-  Serial.println(F("Using SD.h. Set USE_SD_H zero to use SdFat.h."));
-#else  // USE_SD_H
-  Serial.println(F("Using SdFat.h. Set USE_SD_H nonzero to use SD.h."));
-#endif  // USE_SD_H
-  Serial.println(F("\nType any character to begin."));
-  while (!Serial.available()) {
-    yield();
-  }
-  Serial.print("Initializing SD card...");
-
-  if (!SD.begin(SD_CS_PIN)) {
-    Serial.println("initialization failed!");
-    return;
-  }
-  Serial.println("initialization done.");
-
-  // open the file.
-  myFile = SD.open("test.txt", FILE_WRITE);
-
-  // if the file opened okay, write to it:
-  if (myFile) {
-    Serial.print("Writing to test.txt...");
-    myFile.println("testing 1, 2, 3.");
-    // close the file:
-    myFile.close();
-    Serial.println("done.");
-  } else {
-    // if the file didn't open, print an error:
-    Serial.println("error opening test.txt");
-  }
-
-  // re-open the file for reading:
-  myFile = SD.open("test.txt");
-  if (myFile) {
-    Serial.println("test.txt:");
-
-    // read from the file until there's nothing else in it:
-    while (myFile.available()) {
-      Serial.write(myFile.read());
-    }
-    // close the file:
-    myFile.close();
-  } else {
-    // if the file didn't open, print an error:
-    Serial.println("error opening test.txt");
-  }
-}
-void loop() {
-  // nothing happens after setup
-}

lib/SdFat_NoArduino/examples/BufferedPrint/BufferedPrint.ino

@@ -1,235 +0,0 @@
-// Test and benchmark of the fast bufferedPrint class.
-//
-// Mainly for AVR but may improve print performance with other CPUs.
-#include "SdFat.h"
-#include "BufferedPrint.h"
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 0
-/*
-  Change the value of SD_CS_PIN if you are using SPI and
-  your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try max SPI clock for an SD. Reduce SPI_CLOCK if errors occur.
-#define SPI_CLOCK SD_SCK_MHZ(50)
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif  ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // HAS_SDIO_CLASS
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-typedef File file_t;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-typedef File32 file_t;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-typedef ExFile file_t;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-typedef FsFile file_t;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-// number of lines to print
-const uint16_t N_PRINT = 20000;
-//------------------------------------------------------------------------------
-void benchmark() {
-  file_t file;
-  BufferedPrint<file_t, 64> bp;
-  // do write test
-  Serial.println();
-  for (int test = 0; test < 6; test++) {
-    char fileName[13] = "bench0.txt";
-    fileName[5] = '0' + test;
-    // open or create file - truncate existing file.
-    if (!file.open(fileName, O_RDWR | O_CREAT | O_TRUNC)) {
-      sd.errorHalt(&Serial, F("open failed"));
-    }
-    if (test & 1) {
-      bp.begin(&file);
-    }
-    uint32_t t = millis();
-    switch(test) {
-    case 0:
-      Serial.println(F("Test of println(uint16_t)"));
-      for (uint16_t i = 0; i < N_PRINT; i++) {
-        file.println(i);
-      }
-      break;
-
-    case 1:
-      Serial.println(F("Test of printField(uint16_t, char)"));
-      for (uint16_t i = 0; i < N_PRINT; i++) {
-        bp.printField(i, '\n');
-      }
-      break;
-
-    case 2:
-      Serial.println(F("Test of println(uint32_t)"));
-      for (uint16_t i = 0; i < N_PRINT; i++) {
-        file.println(12345678UL + i);
-      }
-      break;
-
-    case 3:
-      Serial.println(F("Test of printField(uint32_t, char)"));
-      for (uint16_t i = 0; i < N_PRINT; i++) {
-        bp.printField(12345678UL + i, '\n');
-      }
-      break;
-
-    case 4:
-      Serial.println(F("Test of println(double)"));
-      for (uint16_t i = 0; i < N_PRINT; i++) {
-        file.println((double)0.01*i);
-      }
-      break;
-
-    case 5:
-      Serial.println(F("Test of printField(double, char)"));
-      for (uint16_t i = 0; i < N_PRINT; i++) {
-        bp.printField((double)0.01*i, '\n');
-      }
-      break;
-
-    }
-    if (test & 1) {
-      bp.sync();
-    }
-    if (file.getWriteError()) {
-      sd.errorHalt(&Serial, F("write failed"));
-    }
-    double s = file.fileSize();
-    file.close();
-    t = millis() - t;
-    Serial.print(F("Time "));
-    Serial.print(0.001*t, 3);
-    Serial.println(F(" sec"));
-    Serial.print(F("File size "));
-    Serial.print(0.001*s);
-    Serial.println(F(" KB"));
-    Serial.print(F("Write "));
-    Serial.print(s/t);
-    Serial.println(F(" KB/sec"));
-    Serial.println();
-  }
-}
-//------------------------------------------------------------------------------
-void testMemberFunctions() {
-  BufferedPrint<Print, 32> bp(&Serial);
-  char c = 'c';    // char
-//#define BASIC_TYPES
-#ifdef BASIC_TYPES
-  signed char sc = -1;   // signed 8-bit
-  unsigned char uc = 1;  // unsiged 8-bit
-  signed short ss = -2;  // signed 16-bit
-  unsigned short us = 2; // unsigned 16-bit
-  signed long sl = -4;   // signed 32-bit
-  unsigned long ul = 4;  // unsigned 32-bit
-#else  // BASIC_TYPES
-  int8_t sc = -1;  // signed 8-bit
-  uint8_t uc = 1;  // unsiged 8-bit
-  int16_t ss = -2; // signed 16-bit
-  uint16_t us = 2; // unsigned 16-bit
-  int32_t sl = -4; // signed 32-bit
-  uint32_t ul = 4; // unsigned 32-bit
-#endif  // BASIC_TYPES
-  float f = -1.234;
-  double d = -5.678;
-  bp.println();
-  bp.println("Test print()");
-  bp.print(c);
-  bp.println();
-  bp.print("string");
-  bp.println();
-  bp.print(F("flash"));
-  bp.println();
-  bp.print(sc);
-  bp.println();
-  bp.print(uc);
-  bp.println();
-  bp.print(ss);
-  bp.println();
-  bp.print(us);
-  bp.println();
-  bp.print(sl);
-  bp.println();
-  bp.print(ul);
-  bp.println();
-  bp.print(f);
-  bp.println();
-  bp.print(d);
-  bp.println();
-  bp.println();
-
-  bp.println("Test println()");
-  bp.println(c);
-  bp.println("string");
-  bp.println(F("flash"));
-  bp.println(sc);
-  bp.println(uc);
-  bp.println(ss);
-  bp.println(us);
-  bp.println(sl);
-  bp.println(ul);
-  bp.println(f);
-  bp.println(d);
-  bp.println();
-
-  bp.println("Test printField()");
-  bp.printField(c, ',');
-  bp.printField("string", ',');
-  bp.printField(F("flash"), ',');
-  bp.printField(sc, ',');
-  bp.printField(uc, ',');
-  bp.printField(ss, ',');
-  bp.printField(us, ',');
-  bp.printField(sl, ',');
-  bp.printField(ul, ',');
-  bp.printField(f, ',');
-  bp.printField(d, '\n');
-
-  bp.sync();
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  while (!Serial) {}
-  Serial.println("Type any character to begin.");
-  while(!Serial.available()) {}
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  Serial.println();
-  Serial.println(F("Test member funcions:"));
-  testMemberFunctions();
-  Serial.println();
-  Serial.println(F("Benchmark performance for uint16_t, uint32_t, and double:"));
-  benchmark();
-  Serial.println("Done");
-}
-//------------------------------------------------------------------------------
-void loop() {
-}

lib/SdFat_NoArduino/examples/DirectoryFunctions/DirectoryFunctions.ino

@@ -1,158 +0,0 @@
-/*
- * Example use of chdir(), ls(), mkdir(), and  rmdir().
- */
-#include "SdFat.h"
-#include "sdios.h"
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 0
-/*
-  Change the value of SD_CS_PIN if you are using SPI and
-  your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try max SPI clock for an SD. Reduce SPI_CLOCK if errors occur.
-#define SPI_CLOCK SD_SCK_MHZ(50)
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif  ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // HAS_SDIO_CLASS
-//------------------------------------------------------------------------------
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File file;
-File root;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 file;
-File32 root;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile file;
-ExFile root;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile file;
-FsFile root;
-#endif  // SD_FAT_TYPE
-
-// Create a Serial output stream.
-ArduinoOutStream cout(Serial);
-//------------------------------------------------------------------------------
-// Store error strings in flash to save RAM.
-#define error(s) sd.errorHalt(&Serial, F(s))
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  delay(1000);
-  cout << F("Type any character to start\n");
-  while (!Serial.available()) {
-    yield();
-  }
-
-  // Initialize the SD card.
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  if (sd.exists("Folder1")
-    || sd.exists("Folder1/file1.txt")
-    || sd.exists("Folder1/File2.txt")) {
-    error("Please remove existing Folder1, file1.txt, and File2.txt");
-  }
-
-  int rootFileCount = 0;
-  if (!root.open("/")) {
-    error("open root");
-  }
-  while (file.openNext(&root, O_RDONLY)) {
-    if (!file.isHidden()) {
-      rootFileCount++;
-    }
-    file.close();
-    if (rootFileCount > 10) {
-      error("Too many files in root. Please use an empty SD.");
-    }
-  }
-  if (rootFileCount) {
-    cout << F("\nPlease use an empty SD for best results.\n\n");
-    delay(1000);
-  }
-  // Create a new folder.
-  if (!sd.mkdir("Folder1")) {
-    error("Create Folder1 failed");
-  }
-  cout << F("Created Folder1\n");
-
-  // Create a file in Folder1 using a path.
-  if (!file.open("Folder1/file1.txt", O_WRONLY | O_CREAT)) {
-    error("create Folder1/file1.txt failed");
-  }
-  file.close();
-  cout << F("Created Folder1/file1.txt\n");
-
-  // Change volume working directory to Folder1.
-  if (!sd.chdir("Folder1")) {
-    error("chdir failed for Folder1.\n");
-  }
-  cout << F("chdir to Folder1\n");
-
-  // Create File2.txt in current directory.
-  if (!file.open("File2.txt", O_WRONLY | O_CREAT)) {
-    error("create File2.txt failed");
-  }
-  file.close();
-  cout << F("Created File2.txt in current directory\n");
-
-  cout << F("\nList of files on the SD.\n");
-  sd.ls("/", LS_R);
-
-  // Remove files from current directory.
-  if (!sd.remove("file1.txt") || !sd.remove("File2.txt")) {
-    error("remove failed");
-  }
-  cout << F("\nfile1.txt and File2.txt removed.\n");
-
-  // Change current directory to root.
-  if (!sd.chdir()) {
-    error("chdir to root failed.\n");
-  }
-
-  cout << F("\nList of files on the SD.\n");
-  sd.ls(LS_R);
-
-  // Remove Folder1.
-  if (!sd.rmdir("Folder1")) {
-    error("rmdir for Folder1 failed\n");
-  }
-  cout << F("\nFolder1 removed.\n");
-  cout << F("\nList of files on the SD.\n");
-  sd.ls(LS_R);
-  cout << F("Done!\n");
-}
-//------------------------------------------------------------------------------
-// Nothing happens in loop.
-void loop() {}

lib/SdFat_NoArduino/examples/ExFatLogger/ExFatLogger.h

@@ -1,9 +0,0 @@
-// Avoid IDE problems by defining struct in septate .h file.
-// Pad record so size is a power of two for best write performance.
-#ifndef ExFatLogger_h
-#define ExFatLogger_h
-const size_t ADC_COUNT = 4;
-struct data_t {
-  uint16_t adc[ADC_COUNT];
-};
-#endif  // ExFatLogger_h

lib/SdFat_NoArduino/examples/ExFatLogger/ExFatLogger.ino

@@ -1,595 +0,0 @@
-// Example to demonstrate write latency for preallocated exFAT files.
-// I suggest you write a PC program to convert very large bin files.
-//
-// The maximum data rate will depend on the quality of your SD,
-// the size of the FIFO, and using dedicated SPI.
-#include "SdFat.h"
-#include "FreeStack.h"
-#include "ExFatLogger.h"
-//------------------------------------------------------------------------------
-// This example was designed for exFAT but will support FAT16/FAT32.
-// Note: Uno will not support SD_FAT_TYPE = 3.
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 2
-//------------------------------------------------------------------------------
-// Interval between data records in microseconds.
-// Try 250 with Teensy 3.6, Due, or STM32.
-// Try 2000 with AVR boards.
-// Try 4000 with SAMD Zero boards.
-const uint32_t LOG_INTERVAL_USEC = 2000;
-
-// Set USE_RTC nonzero for file timestamps.
-// RAM use will be marginal on Uno with RTClib.
-// 0 - RTC not used
-// 1 - DS1307
-// 2 - DS3231
-// 3 - PCF8523
-#define USE_RTC 0
-#if USE_RTC
-#include "RTClib.h"
-#endif  // USE_RTC
-
-// LED to light if overruns occur.
-#define ERROR_LED_PIN -1
-
-/*
-  Change the value of SD_CS_PIN if you are using SPI and
-  your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// FIFO SIZE - 512 byte sectors.  Modify for your board.
-#ifdef __AVR_ATmega328P__
-// Use 512 bytes for 328 boards.
-#define FIFO_SIZE_SECTORS 1
-#elif defined(__AVR__)
-// Use 2 KiB for other AVR boards.
-#define FIFO_SIZE_SECTORS 4
-#else  // __AVR_ATmega328P__
-// Use 8 KiB for non-AVR boards.
-#define FIFO_SIZE_SECTORS 16
-#endif  // __AVR_ATmega328P__
-
-// Preallocate 1GiB file.
-const uint32_t PREALLOCATE_SIZE_MiB = 1024UL;
-
-// Try max SPI clock for an SD. Reduce SPI_CLOCK if errors occur.
-#define SPI_CLOCK SD_SCK_MHZ(50)
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif  ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // HAS_SDIO_CLASS
-
-// Save SRAM if 328.
-#ifdef __AVR_ATmega328P__
-#include "MinimumSerial.h"
-MinimumSerial MinSerial;
-#define Serial MinSerial
-#endif  // __AVR_ATmega328P__
-//==============================================================================
-// Replace logRecord(), printRecord(), and ExFatLogger.h for your sensors.
-void logRecord(data_t* data, uint16_t overrun) {
-  if (overrun) {
-    // Add one since this record has no adc data. Could add overrun field.
-    overrun++;
-    data->adc[0] = 0X8000 | overrun;
-  } else {
-    for (size_t i = 0; i < ADC_COUNT; i++) {
-      data->adc[i] = analogRead(i);
-    }
-  }
-}
-//------------------------------------------------------------------------------
-void printRecord(Print* pr, data_t* data) {
-  static uint32_t nr = 0;
-  if (!data) {
-    pr->print(F("LOG_INTERVAL_USEC,"));
-    pr->println(LOG_INTERVAL_USEC);
-    pr->print(F("rec#"));
-    for (size_t i = 0; i < ADC_COUNT; i++) {
-      pr->print(F(",adc"));
-      pr->print(i);
-    }
-    pr->println();
-    nr = 0;
-    return;
-  }
-  if (data->adc[0] & 0X8000) {
-    uint16_t n = data->adc[0] & 0X7FFF;
-    nr += n;
-    pr->print(F("-1,"));
-    pr->print(n);
-    pr->println(F(",overuns"));
-  } else {
-    pr->print(nr++);
-    for (size_t i = 0; i < ADC_COUNT; i++) {
-      pr->write(',');
-      pr->print(data->adc[i]);
-    }
-    pr->println();
-  }
-}
-//==============================================================================
-const uint64_t PREALLOCATE_SIZE  =  (uint64_t)PREALLOCATE_SIZE_MiB << 20;
-// Max length of file name including zero byte.
-#define FILE_NAME_DIM 40
-// Max number of records to buffer while SD is busy.
-const size_t FIFO_DIM = 512*FIFO_SIZE_SECTORS/sizeof(data_t);
-
-#if SD_FAT_TYPE == 0
-typedef SdFat sd_t;
-typedef File file_t;
-#elif SD_FAT_TYPE == 1
-typedef SdFat32 sd_t;
-typedef File32 file_t;
-#elif SD_FAT_TYPE == 2
-typedef SdExFat sd_t;
-typedef ExFile file_t;
-#elif SD_FAT_TYPE == 3
-typedef SdFs sd_t;
-typedef FsFile file_t;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-sd_t sd;
-
-file_t binFile;
-file_t csvFile;
-// You may modify the filename.  Digits before the dot are file versions.
-char binName[] = "ExFatLogger00.bin";
-//------------------------------------------------------------------------------
-#if USE_RTC
-#if USE_RTC == 1
-RTC_DS1307 rtc;
-#elif USE_RTC == 2
-RTC_DS3231 rtc;
-#elif USE_RTC == 3
-RTC_PCF8523 rtc;
-#else  // USE_RTC == type
-#error USE_RTC type not implemented.
-#endif  // USE_RTC == type
-// Call back for file timestamps.  Only called for file create and sync().
-void dateTime(uint16_t* date, uint16_t* time, uint8_t* ms10) {
-  DateTime now = rtc.now();
-
-  // Return date using FS_DATE macro to format fields.
-  *date = FS_DATE(now.year(), now.month(), now.day());
-
-  // Return time using FS_TIME macro to format fields.
-  *time = FS_TIME(now.hour(), now.minute(), now.second());
-
-  // Return low time bits in units of 10 ms.
-  *ms10 = now.second() & 1 ? 100 : 0;
-}
-#endif  // USE_RTC
-//------------------------------------------------------------------------------
-#define error(s) sd.errorHalt(&Serial, F(s))
-#define dbgAssert(e) ((e) ? (void)0 : error("assert " #e))
-//-----------------------------------------------------------------------------
-// Convert binary file to csv file.
-void binaryToCsv() {
-  uint8_t lastPct = 0;
-  uint32_t t0 = millis();
-  data_t binData[FIFO_DIM];
-
-  if (!binFile.seekSet(512)) {
-	  error("binFile.seek failed");
-  }
-  uint32_t tPct = millis();
-  printRecord(&csvFile, nullptr);
-  while (!Serial.available() && binFile.available()) {
-    int nb = binFile.read(binData, sizeof(binData));
-    if (nb <= 0 ) {
-      error("read binFile failed");
-    }
-    size_t nr = nb/sizeof(data_t);
-    for (size_t i = 0; i < nr; i++) {
-      printRecord(&csvFile, &binData[i]);
-    }
-
-    if ((millis() - tPct) > 1000) {
-      uint8_t pct = binFile.curPosition()/(binFile.fileSize()/100);
-      if (pct != lastPct) {
-        tPct = millis();
-        lastPct = pct;
-        Serial.print(pct, DEC);
-        Serial.println('%');
-        csvFile.sync();
-      }
-    }
-    if (Serial.available()) {
-      break;
-    }
-  }
-  csvFile.close();
-  Serial.print(F("Done: "));
-  Serial.print(0.001*(millis() - t0));
-  Serial.println(F(" Seconds"));
-}
-//------------------------------------------------------------------------------
-void clearSerialInput() {
-  uint32_t m = micros();
-  do {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  } while (micros() - m < 10000);
-}
-//-------------------------------------------------------------------------------
-void createBinFile() {
-  binFile.close();
-  while (sd.exists(binName)) {
-    char* p = strchr(binName, '.');
-    if (!p) {
-      error("no dot in filename");
-    }
-    while (true) {
-      p--;
-      if (p < binName || *p < '0' || *p > '9') {
-        error("Can't create file name");
-      }
-      if (p[0] != '9') {
-        p[0]++;
-        break;
-      }
-      p[0] = '0';
-    }
-  }
-  if (!binFile.open(binName, O_RDWR | O_CREAT)) {
-    error("open binName failed");
-  }
-  Serial.println(binName);
-  if (!binFile.preAllocate(PREALLOCATE_SIZE)) {
-    error("preAllocate failed");
-  }
-
-  Serial.print(F("preAllocated: "));
-  Serial.print(PREALLOCATE_SIZE_MiB);
-  Serial.println(F(" MiB"));
-}
-//-------------------------------------------------------------------------------
-bool createCsvFile() {
-  char csvName[FILE_NAME_DIM];
-  if (!binFile.isOpen()) {
-    Serial.println(F("No current binary file"));
-    return false;
-  }
-
-  // Create a new csvFile.
-  binFile.getName(csvName, sizeof(csvName));
-  char* dot = strchr(csvName, '.');
-  if (!dot) {
-    error("no dot in filename");
-  }
-  strcpy(dot + 1, "csv");
-  if (!csvFile.open(csvName, O_WRONLY | O_CREAT | O_TRUNC)) {
-    error("open csvFile failed");
-  }
-  clearSerialInput();
-  Serial.print(F("Writing: "));
-  Serial.print(csvName);
-  Serial.println(F(" - type any character to stop"));
-  return true;
-}
-//-------------------------------------------------------------------------------
-void logData() {
-  int32_t delta;  // Jitter in log time.
-  int32_t maxDelta = 0;
-  uint32_t maxLogMicros = 0;
-  uint32_t maxWriteMicros = 0;
-  size_t maxFifoUse = 0;
-  size_t fifoCount = 0;
-  size_t fifoHead = 0;
-  size_t fifoTail = 0;
-  uint16_t overrun = 0;
-  uint16_t maxOverrun = 0;
-  uint32_t totalOverrun = 0;
-  uint32_t fifoBuf[128*FIFO_SIZE_SECTORS];
-  data_t* fifoData = (data_t*)fifoBuf;
-
-  // Write dummy sector to start multi-block write.
-  dbgAssert(sizeof(fifoBuf) >= 512);
-  memset(fifoBuf, 0, sizeof(fifoBuf));
-  if (binFile.write(fifoBuf, 512) != 512) {
-    error("write first sector failed");
-  }
-  clearSerialInput();
-  Serial.println(F("Type any character to stop"));
-
-  // Wait until SD is not busy.
-  while (sd.card()->isBusy()) {}
-
-  // Start time for log file.
-  uint32_t m = millis();
-
-  // Time to log next record.
-  uint32_t logTime = micros();
-  while (true) {
-    // Time for next data record.
-    logTime += LOG_INTERVAL_USEC;
-
-    // Wait until time to log data.
-    delta = micros() - logTime;
-    if (delta > 0) {
-      Serial.print(F("delta: "));
-      Serial.println(delta);
-      error("Rate too fast");
-    }
-    while (delta < 0) {
-      delta = micros() - logTime;
-    }
-
-    if (fifoCount < FIFO_DIM) {
-      uint32_t m = micros();
-      logRecord(fifoData + fifoHead, overrun);
-      m = micros() - m;
-      if (m > maxLogMicros) {
-        maxLogMicros = m;
-      }
-      fifoHead = fifoHead < (FIFO_DIM - 1) ? fifoHead + 1 : 0;
-      fifoCount++;
-      if (overrun) {
-        if (overrun > maxOverrun) {
-          maxOverrun = overrun;
-        }
-        overrun = 0;
-      }
-    } else {
-      totalOverrun++;
-      overrun++;
-      if (overrun > 0XFFF) {
-        error("too many overruns");
-      }
-      if (ERROR_LED_PIN >= 0) {
-        digitalWrite(ERROR_LED_PIN, HIGH);
-      }
-    }
-    // Save max jitter.
-    if (delta > maxDelta) {
-      maxDelta = delta;
-    }
-    // Write data if SD is not busy.
-    if (!sd.card()->isBusy()) {
-      size_t nw = fifoHead > fifoTail ? fifoCount : FIFO_DIM - fifoTail;
-      // Limit write time by not writing more than 512 bytes.
-      const size_t MAX_WRITE = 512/sizeof(data_t);
-      if (nw > MAX_WRITE) nw = MAX_WRITE;
-      size_t nb = nw*sizeof(data_t);
-      uint32_t usec = micros();
-      if (nb != binFile.write(fifoData + fifoTail, nb)) {
-        error("write binFile failed");
-      }
-      usec = micros() - usec;
-      if (usec > maxWriteMicros) {
-        maxWriteMicros = usec;
-      }
-      fifoTail = (fifoTail + nw) < FIFO_DIM ? fifoTail + nw : 0;
-      if (fifoCount > maxFifoUse) {
-        maxFifoUse = fifoCount;
-      }
-      fifoCount -= nw;
-      if (Serial.available()) {
-        break;
-      }
-    }
-  }
-  Serial.print(F("\nLog time: "));
-  Serial.print(0.001*(millis() - m));
-  Serial.println(F(" Seconds"));
-  binFile.truncate();
-  binFile.sync();
-  Serial.print(("File size: "));
-  // Warning cast used for print since fileSize is uint64_t.
-  Serial.print((uint32_t)binFile.fileSize());
-  Serial.println(F(" bytes"));
-  Serial.print(F("totalOverrun: "));
-  Serial.println(totalOverrun);
-  Serial.print(F("FIFO_DIM: "));
-  Serial.println(FIFO_DIM);
-  Serial.print(F("maxFifoUse: "));
-  Serial.println(maxFifoUse);
-  Serial.print(F("maxLogMicros: "));
-  Serial.println(maxLogMicros);
-  Serial.print(F("maxWriteMicros: "));
-  Serial.println(maxWriteMicros);
-  Serial.print(F("Log interval: "));
-  Serial.print(LOG_INTERVAL_USEC);
-  Serial.print(F(" micros\nmaxDelta: "));
-  Serial.print(maxDelta);
-  Serial.println(F(" micros"));
-}
-//------------------------------------------------------------------------------
-void openBinFile() {
-  char name[FILE_NAME_DIM];
-  clearSerialInput();
-  Serial.println(F("Enter file name"));
-  if (!serialReadLine(name, sizeof(name))) {
-    return;
-  }
-  if (!sd.exists(name)) {
-    Serial.println(name);
-    Serial.println(F("File does not exist"));
-    return;
-  }
-  binFile.close();
-  if (!binFile.open(name, O_RDONLY)) {
-    Serial.println(name);
-    Serial.println(F("open failed"));
-    return;
-  }
-  Serial.println(F("File opened"));
-}
-//-----------------------------------------------------------------------------
-void printData() {
-  if (!binFile.isOpen()) {
-    Serial.println(F("No current binary file"));
-    return;
-  }
-  // Skip first dummy sector.
-  if (!binFile.seekSet(512)) {
-    error("seek failed");
-  }
-  clearSerialInput();
-  Serial.println(F("type any character to stop\n"));
-  delay(1000);
-  printRecord(&Serial, nullptr);
-  while (binFile.available() && !Serial.available()) {
-    data_t record;
-    if (binFile.read(&record, sizeof(data_t)) != sizeof(data_t)) {
-      error("read binFile failed");
-    }
-    printRecord(&Serial, &record);
-  }
-}
-//------------------------------------------------------------------------------
-void printUnusedStack() {
-#if HAS_UNUSED_STACK
-  Serial.print(F("\nUnused stack: "));
-  Serial.println(UnusedStack());
-#endif  // HAS_UNUSED_STACK
-}
-//------------------------------------------------------------------------------
-bool serialReadLine(char* str, size_t size) {
-  size_t n = 0;
-  while(!Serial.available()) {
-    yield();
-  }
-  while (true) {
-    int c = Serial.read();
-    if (c < ' ') break;
-    str[n++] = c;
-    if (n >= size) {
-      Serial.println(F("input too long"));
-      return false;
-    }
-    uint32_t m = millis();
-    while (!Serial.available() && (millis() - m) < 100){}
-    if (!Serial.available()) break;
-  }
-  str[n] = 0;
-  return true;
-}
-//------------------------------------------------------------------------------
-void testSensor() {
-  const uint32_t interval = 200000;
-  int32_t diff;
-  data_t data;
-  clearSerialInput();
-  Serial.println(F("\nTesting - type any character to stop\n"));
-  delay(1000);
-  printRecord(&Serial, nullptr);
-  uint32_t m = micros();
-  while (!Serial.available()) {
-    m += interval;
-    do {
-      diff = m - micros();
-    } while (diff > 0);
-    logRecord(&data, 0);
-    printRecord(&Serial, &data);
-  }
-}
-//------------------------------------------------------------------------------
-void setup() {
-  if (ERROR_LED_PIN >= 0) {
-    pinMode(ERROR_LED_PIN, OUTPUT);
-    digitalWrite(ERROR_LED_PIN, HIGH);
-  }
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  delay(1000);
-  Serial.println(F("Type any character to begin"));
-  while (!Serial.available()) {
-    yield();
-  }
-  FillStack();
-#if !ENABLE_DEDICATED_SPI
-  Serial.println(F(
-    "\nFor best performance edit SdFatConfig.h\n"
-    "and set ENABLE_DEDICATED_SPI nonzero"));
-#endif  // !ENABLE_DEDICATED_SPI
-
-  Serial.print(FIFO_DIM);
-  Serial.println(F(" FIFO entries will be used."));
-
-  // Initialize SD.
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-#if USE_RTC
-  if (!rtc.begin()) {
-    error("rtc.begin failed");
-  }
-  if (!rtc.isrunning()) {
-    // Set RTC to sketch compile date & time.
-    // rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));
-    error("RTC is NOT running!");
-  }
-  // Set callback
-  FsDateTime::setCallback(dateTime);
-#endif  // USE_RTC
-}
-//------------------------------------------------------------------------------
-void loop() {
-  printUnusedStack();
-  // Read any Serial data.
-  clearSerialInput();
-
-  if (ERROR_LED_PIN >= 0) {
-    digitalWrite(ERROR_LED_PIN, LOW);
-  }
-  Serial.println();
-  Serial.println(F("type: "));
-  Serial.println(F("b - open existing bin file"));
-  Serial.println(F("c - convert file to csv"));
-  Serial.println(F("l - list files"));
-  Serial.println(F("p - print data to Serial"));
-  Serial.println(F("r - record data"));
-  Serial.println(F("t - test without logging"));
-  while(!Serial.available()) {
-    yield();
-  }
-  char c = tolower(Serial.read());
-  Serial.println();
-
-  if (c == 'b') {
-    openBinFile();
-  } else if (c == 'c') {
-    if (createCsvFile()) {
-      binaryToCsv();
-    }
-  } else if (c == 'l') {
-    Serial.println(F("ls:"));
-    sd.ls(&Serial, LS_DATE | LS_SIZE);
-  } else if (c == 'p') {
-    printData();
-  } else if (c == 'r') {
-    createBinFile();
-    logData();
-  } else if (c == 't') {
-    testSensor();
-  } else {
-    Serial.println(F("Invalid entry"));
-  }
-}

lib/SdFat_NoArduino/examples/MinimumSizeSdReader/MinimumSizeSdReader.ino

@@ -1,58 +0,0 @@
-// Create a text file on the SD with this path using short 8.3 names.
-#define SFN_PATH "/DIR/TEST.TXT"
-
-// Modify CS_PIN for your chip select pin.
-#define CS_PIN SS
-
-// Set USE_SD_H to one for SD.h or zero for SdFat.
-#define USE_SD_H 0
-
-#if USE_SD_H
-#include "SD.h"
-File file;
-#else
-#include "SdFat.h"
-// Setting ENABLE_DEDICATED_SPI to zero saves over 200 more bytes.
-#if ENABLE_DEDICATED_SPI
-#warning "Set ENABLE_DEDICATED_SPI zero in SdFat/src/SdFatConfig.h for minimum size"
-#endif  // ENABLE_DEDICATED_SPI
-// Insure FAT16/FAT32 only.
-SdFat32 SD;
-// FatFile does not support Stream functions, just simple read/write.
-FatFile file;
-#endif
-
-void error(const char* msg) {
-  Serial.println(msg);
-  while(true);
-}
-
-void setup() {
-  int n;
-  char buf[4];
-
-  Serial.begin(9600);
-  while (!Serial) {}
-  Serial.println("Type any character to begin");
-  while (!Serial.available()) {}
-
-  if (!SD.begin(CS_PIN)) error("SD.begin");
-
-#if USE_SD_H
-  file = SD.open(SFN_PATH);
-  if (!file) error("open");
-#else
-  // Open existing file with a path of 8.3 names.
-  // Directories will be opened O_RDONLY files O_RDWR.
-  if (!file.openExistingSFN(SFN_PATH)) error("open");
-#endif
-  while ((n = file.read(buf, sizeof(buf)))) {
-   Serial.write(buf, n);
-  }
-// close() is only needed if you write to the file. For example, read
-// config data, modify the data, rewind the file and write the data.
-// file.close();
-}
-
-void loop() {
-}

lib/SdFat_NoArduino/examples/OpenNext/OpenNext.ino

@@ -1,105 +0,0 @@
-/*
- * Print size, modify date/time, and name for all files in root.
- */
-#include "SdFat.h"
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 0
-/*
-  Change the value of SD_CS_PIN if you are using SPI and
-  your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try max SPI clock for an SD. Reduce SPI_CLOCK if errors occur.
-#define SPI_CLOCK SD_SCK_MHZ(50)
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif  ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // HAS_SDIO_CLASS
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File dir;
-File file;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 dir;
-File32 file;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile dir;
-ExFile file;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile dir;
-FsFile file;
-#else  // SD_FAT_TYPE
-#error invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-//------------------------------------------------------------------------------
-// Store error strings in flash to save RAM.
-#define error(s) sd.errorHalt(&Serial, F(s))
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-
-  Serial.println("Type any character to start");
-  while (!Serial.available()) {
-    yield();
-  }
-
-  // Initialize the SD.
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  // Open root directory
-  if (!dir.open("/")){
-    error("dir.open failed");
-  }
-  // Open next file in root.
-  // Warning, openNext starts at the current position of dir so a
-  // rewind may be necessary in your application.
-  while (file.openNext(&dir, O_RDONLY)) {
-    file.printFileSize(&Serial);
-    Serial.write(' ');
-    file.printModifyDateTime(&Serial);
-    Serial.write(' ');
-    file.printName(&Serial);
-    if (file.isDir()) {
-      // Indicate a directory.
-      Serial.write('/');
-    }
-    Serial.println();
-    file.close();
-  }
-  if (dir.getError()) {
-    Serial.println("openNext failed");
-  } else {
-    Serial.println("Done!");
-  }
-}
-//------------------------------------------------------------------------------
-void loop() {}

lib/SdFat_NoArduino/examples/QuickStart/QuickStart.ino

@@ -1,187 +0,0 @@
-// Quick hardware test for SPI card access.
-//
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 3
-//
-// Set DISABLE_CHIP_SELECT to disable a second SPI device.
-// For example, with the Ethernet shield, set DISABLE_CHIP_SELECT
-// to 10 to disable the Ethernet controller.
-const int8_t DISABLE_CHIP_SELECT = -1;
-//
-// Test with reduced SPI speed for breadboards.  SD_SCK_MHZ(4) will select
-// the highest speed supported by the board that is not over 4 MHz.
-// Change SPI_SPEED to SD_SCK_MHZ(50) for best performance.
-#define SPI_SPEED SD_SCK_MHZ(4)
-//------------------------------------------------------------------------------
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File file;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 file;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile file;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile file;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-// Serial streams
-ArduinoOutStream cout(Serial);
-
-// input buffer for line
-char cinBuf[40];
-ArduinoInStream cin(Serial, cinBuf, sizeof(cinBuf));
-
-// SD card chip select
-int chipSelect;
-
-void cardOrSpeed() {
-  cout << F("Try another SD card or reduce the SPI bus speed.\n");
-  cout << F("Edit SPI_SPEED in this program to change it.\n");
-}
-
-void clearSerialInput() {
-  uint32_t m = micros();
-  do {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  } while (micros() - m < 10000);
-}
-
-void reformatMsg() {
-  cout << F("Try reformatting the card.  For best results use\n");
-  cout << F("the SdFormatter program in SdFat/examples or download\n");
-  cout << F("and use SDFormatter from www.sdcard.org/downloads.\n");
-}
-
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  cout << F("\nSPI pins:\n");
-  cout << F("MISO: ") << int(MISO) << endl;
-  cout << F("MOSI: ") << int(MOSI) << endl;
-  cout << F("SCK:  ") << int(SCK) << endl;
-  cout << F("SS:   ") << int(SS) << endl;
-#ifdef SDCARD_SS_PIN
-  cout << F("SDCARD_SS_PIN:   ") << int(SDCARD_SS_PIN) << endl;
-#endif  // SDCARD_SS_PIN
-
-  if (DISABLE_CHIP_SELECT < 0) {
-    cout << F(
-           "\nBe sure to edit DISABLE_CHIP_SELECT if you have\n"
-           "a second SPI device.  For example, with the Ethernet\n"
-           "shield, DISABLE_CHIP_SELECT should be set to 10\n"
-           "to disable the Ethernet controller.\n");
-  }
-  cout << F(
-         "\nSD chip select is the key hardware option.\n"
-         "Common values are:\n"
-         "Arduino Ethernet shield, pin 4\n"
-         "Sparkfun SD shield, pin 8\n"
-         "Adafruit SD shields and modules, pin 10\n");
-}
-
-bool firstTry = true;
-void loop() {
-  // Read any existing Serial data.
-  clearSerialInput();
-
-  if (!firstTry) {
-    cout << F("\nRestarting\n");
-  }
-  firstTry = false;
-
-  cout << F("\nEnter the chip select pin number: ");
-  while (!Serial.available()) {
-    yield();
-  }
-  cin.readline();
-  if (cin >> chipSelect) {
-    cout << chipSelect << endl;
-  } else {
-    cout << F("\nInvalid pin number\n");
-    return;
-  }
-  if (DISABLE_CHIP_SELECT < 0) {
-    cout << F(
-           "\nAssuming the SD is the only SPI device.\n"
-           "Edit DISABLE_CHIP_SELECT to disable another device.\n");
-  } else {
-    cout << F("\nDisabling SPI device on pin ");
-    cout << int(DISABLE_CHIP_SELECT) << endl;
-    pinMode(DISABLE_CHIP_SELECT, OUTPUT);
-    digitalWrite(DISABLE_CHIP_SELECT, HIGH);
-  }
-  if (!sd.begin(chipSelect, SPI_SPEED)) {
-    if (sd.card()->errorCode()) {
-      cout << F(
-             "\nSD initialization failed.\n"
-             "Do not reformat the card!\n"
-             "Is the card correctly inserted?\n"
-             "Is chipSelect set to the correct value?\n"
-             "Does another SPI device need to be disabled?\n"
-             "Is there a wiring/soldering problem?\n");
-      cout << F("\nerrorCode: ") << hex << showbase;
-      cout << int(sd.card()->errorCode());
-      cout << F(", errorData: ") << int(sd.card()->errorData());
-      cout << dec << noshowbase << endl;
-      return;
-    }
-    cout << F("\nCard successfully initialized.\n");
-    if (sd.vol()->fatType() == 0) {
-      cout << F("Can't find a valid FAT16/FAT32 partition.\n");
-      reformatMsg();
-      return;
-    }
-    cout << F("Can't determine error type\n");
-    return;
-  }
-  cout << F("\nCard successfully initialized.\n");
-  cout << endl;
-
-  uint32_t size = sd.card()->sectorCount();
-  if (size == 0) {
-    cout << F("Can't determine the card size.\n");
-    cardOrSpeed();
-    return;
-  }
-  uint32_t sizeMB = 0.000512 * size + 0.5;
-  cout << F("Card size: ") << sizeMB;
-  cout << F(" MB (MB = 1,000,000 bytes)\n");
-  cout << endl;
-  cout << F("Volume is FAT") << int(sd.vol()->fatType());
-  cout << F(", Cluster size (bytes): ") << sd.vol()->bytesPerCluster();
-  cout << endl << endl;
-
-  cout << F("Files found (date time size name):\n");
-  sd.ls(LS_R | LS_DATE | LS_SIZE);
-
-  if ((sizeMB > 1100 && sd.vol()->sectorsPerCluster() < 64)
-      || (sizeMB < 2200 && sd.vol()->fatType() == 32)) {
-    cout << F("\nThis card should be reformatted for best performance.\n");
-    cout << F("Use a cluster size of 32 KB for cards larger than 1 GB.\n");
-    cout << F("Only cards larger than 2 GB should be formatted FAT32.\n");
-    reformatMsg();
-    return;
-  }
-  // Read any extra Serial data.
-  clearSerialInput();
-
-  cout << F("\nSuccess!  Type any character to restart.\n");
-  while (!Serial.available()) {
-    yield();
-  }
-}

lib/SdFat_NoArduino/examples/ReadCsvFile/ReadCsvFile.ino

@@ -1,156 +0,0 @@
-#include "SdFat.h"
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 0
-/*
-  Change the value of SD_CS_PIN if you are using SPI and
-  your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try max SPI clock for an SD. Reduce SPI_CLOCK if errors occur.
-#define SPI_CLOCK SD_SCK_MHZ(50)
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif  ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // HAS_SDIO_CLASS
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File file;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 file;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile file;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile file;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-char line[40];
-
-//------------------------------------------------------------------------------
-// Store error strings in flash to save RAM.
-#define error(s) sd.errorHalt(&Serial, F(s))
-//------------------------------------------------------------------------------
-// Check for extra characters in field or find minus sign.
-char* skipSpace(char* str) {
-  while (isspace(*str)) str++;
-  return str;
-}
-//------------------------------------------------------------------------------
-bool parseLine(char* str) {
-  char* ptr;
-
-  // Set strtok start of line.
-  str = strtok(str, ",");
-  if (!str) return false;
-
-  // Print text field.
-  Serial.println(str);
-
-  // Subsequent calls to strtok expects a null pointer.
-  str = strtok(nullptr, ",");
-  if (!str) return false;
-
-  // Convert string to long integer.
-  int32_t i32 = strtol(str, &ptr, 0);
-  if (str == ptr || *skipSpace(ptr)) return false;
-  Serial.println(i32);
-
-  str = strtok(nullptr, ",");
-  if (!str) return false;
-
-  // strtoul accepts a leading minus with unexpected results.
-  if (*skipSpace(str) == '-') return false;
-
-  // Convert string to unsigned long integer.
-  uint32_t u32 = strtoul(str, &ptr, 0);
-  if (str == ptr || *skipSpace(ptr)) return false;
-  Serial.println(u32);
-
-  str = strtok(nullptr, ",");
-  if (!str) return false;
-
-  // Convert string to double.
-  double d = strtod(str, &ptr);
-  if (str == ptr || *skipSpace(ptr)) return false;
-  Serial.println(d);
-
-  // Check for extra fields.
-  return strtok(nullptr, ",") == nullptr;
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  Serial.println("Type any character to start");
-  while (!Serial.available()) {
-    yield();
-  }
-  // Initialize the SD.
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-    return;
-  }
-  // Remove any existing file.
-  if (sd.exists("ReadCsvDemo.csv")) {
-    sd.remove("ReadCsvDemo.csv");
-  }
-  // Create the file.
-  if (!file.open("ReadCsvDemo.csv", FILE_WRITE)) {
-    error("open failed");
-  }
-  // Write test data.
-  file.print(F(
-    "abc,123,456,7.89\r\n"
-    "def,-321,654,-9.87\r\n"
-    "ghi,333,0xff,5.55"));
-
-  // Rewind file for read.
-  file.rewind();
-
-  while (file.available()) {
-    int n = file.fgets(line, sizeof(line));
-    if (n <= 0) {
-      error("fgets failed");
-    }
-    if (line[n-1] != '\n' && n == (sizeof(line) - 1)) {
-      error("line too long");
-    }
-    if (!parseLine(line)) {
-      error("parseLine failed");
-    }
-    Serial.println();
-  }
-  file.close();
-  Serial.println(F("Done"));
-}
-
-void loop() {
-}

lib/SdFat_NoArduino/examples/RtcTimestampTest/RtcTimestampTest.ino

@@ -1,236 +0,0 @@
-// Test of time-stamp callback.
-// Set the callback with this statement.
-// FsDateTime::setCallback(dateTime);
-#include "SdFat.h"
-// https://github.com/adafruit/RTClib
-#include "RTClib.h"
-// Set RTC_TYPE for file timestamps.
-// 0 - millis()
-// 1 - DS1307
-// 2 - DS3231
-// 3 - PCF8523
-#define RTC_TYPE 3
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 0
-/*
-  Change the value of SD_CS_PIN if you are using SPI and
-  your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try max SPI clock for an SD. Reduce SPI_CLOCK if errors occur.
-#define SPI_CLOCK SD_SCK_MHZ(50)
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif  ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // HAS_SDIO_CLASS
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File file;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 file;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile file;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile file;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-
-#if RTC_TYPE == 0
-RTC_Millis rtc;
-#elif RTC_TYPE == 1
-RTC_DS1307 rtc;
-#elif RTC_TYPE == 2
-RTC_DS3231 rtc;
-#elif RTC_TYPE == 3
-RTC_PCF8523 rtc;
-#else  // RTC_TYPE == type
-#error RTC_TYPE type not implemented.
-#endif  // RTC_TYPE == type
-
-//------------------------------------------------------------------------------
-// Call back for file timestamps.  Only called for file create and sync().
-void dateTime(uint16_t* date, uint16_t* time, uint8_t* ms10) {
-  DateTime now = rtc.now();
-
-  // Return date using FS_DATE macro to format fields.
-  *date = FS_DATE(now.year(), now.month(), now.day());
-
-  // Return time using FS_TIME macro to format fields.
-  *time = FS_TIME(now.hour(), now.minute(), now.second());
-
-  // Return low time bits in units of 10 ms, 0 <= ms10 <= 199.
-  *ms10 = now.second() & 1 ? 100 : 0;
-}
-//------------------------------------------------------------------------------
-#define error(msg) (Serial.println(F("error " msg)), false)
-//------------------------------------------------------------------------------
-void clearSerialInput() {
-  uint32_t m = micros();
-  do {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  } while (micros() - m < 10000);
-}
-//------------------------------------------------------------------------------
-void getLine(char* line, size_t size) {
-  size_t i = 0;
-  uint32_t t;
-  line[0] = '\0';
-  while (!Serial.available()) {
-    yield();
-  }
-  while (true) {
-    t = millis() + 10;
-    while (!Serial.available()) {
-      if (millis() > t){
-        return;
-      }
-    }
-    int c = Serial.read();
-    if (i >= (size - 1) || c == '\r' || c == '\n' ) {
-      return;
-    }
-    line[i++] = c;
-    line[i] = '\0';
-  }
-}
-//------------------------------------------------------------------------------
-void printField(Print* pr, char sep, uint8_t v) {
-  if (sep) {
-    pr->write(sep);
-  }
-  if (v < 10) {
-    pr->write('0');
-  }
-  pr->print(v);
-}
-//------------------------------------------------------------------------------
-void printNow(Print* pr) {
-  DateTime now = rtc.now();
-  pr->print(now.year());
-  printField(pr, '-',now.month());
-  printField(pr, '-',now.day());
-  printField(pr, ' ',now.hour());
-  printField(pr, ':',now.minute());
-  printField(pr, ':',now.second());
-}
-//------------------------------------------------------------------------------
-bool setRtc() {
-  uint16_t y;
-  uint8_t m, d, hh, mm, ss;
-  char line[30];
-  char* ptr;
-
-  clearSerialInput();
-  Serial.println(F("Enter: YYYY-MM-DD hh:mm:ss"));
-  getLine(line, sizeof(line));
-  Serial.print(F("Input: "));
-  Serial.println(line);
-
-  y = strtol(line, &ptr, 10);
-  if (*ptr++ != '-' || y < 2000 || y > 2099) return error("year");
-  m = strtol(ptr, &ptr, 10);
-  if (*ptr++ != '-' || m < 1 || m > 12) return error("month");
-  d = strtol(ptr, &ptr, 10);
-  if (d < 1 || d > 31) return error("day");
-  hh = strtol(ptr, &ptr, 10);
-  if (*ptr++ != ':' || hh > 23) return error("hour");
-  mm = strtol(ptr, &ptr, 10);
-  if (*ptr++ != ':' || mm > 59) return error("minute");
-  ss = strtol(ptr, &ptr, 10);
-  if (ss > 59) return error("second");
-
-  rtc.adjust(DateTime(y, m, d, hh, mm, ss));
-  Serial.print(F("RTC set to "));
-  printNow(&Serial);
-  Serial.println();
-  return true;
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  while (!Serial) {
-    yield();
-  }
-#if RTC_TYPE == 0
-  rtc.begin(DateTime(F(__DATE__), F(__TIME__)));
-#else  // RTC_TYPE
-  if (!rtc.begin()) {
-    Serial.println(F("rtc.begin failed"));
-    return;
-  }
-  if (!rtc.isrunning()) {
-    Serial.println(F("RTC is NOT running!"));
-    return;
-    // following line sets the RTC to the date & time this sketch was compiled
-    // rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));
-    // This line sets the RTC with an explicit date & time, for example to set
-    // January 21, 2014 at 3am you would call:
-    // rtc.adjust(DateTime(2014, 1, 21, 3, 0, 0));
-  }
-#endif  // RTC_TYPE
-  while (true) {
-    Serial.print(F("DateTime::now "));
-    printNow(&Serial);
-    Serial.println();
-    clearSerialInput();
-    Serial.println(F("Type Y to set RTC, any other character to continue"));
-    while (!Serial.available()) {}
-    if (Serial.read() != 'Y') break;
-    if (setRtc()) break;
-  }
-  Serial.println();
-
-  // Set callback
-  FsDateTime::setCallback(dateTime);
-
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  // Remove old version to set create time.
-  if (sd.exists("RtcTest.txt")) {
-    sd.remove("RtcTest.txt");
-  }
-  if (!file.open("RtcTest.txt", FILE_WRITE)) {
-    Serial.println(F("file.open failed"));
-    return;
-  }
-  // Print current date time to file.
-  file.print(F("Test file at: "));
-  printNow(&file);
-  file.println();
-
-  file.close();
-  // List files in SD root.
-  sd.ls(LS_DATE | LS_SIZE);
-  Serial.println(F("Done"));
-}
-//------------------------------------------------------------------------------
-void loop() {
-}

lib/SdFat_NoArduino/examples/SdErrorCodes/SdErrorCodes.ino

@@ -1,19 +0,0 @@
-// Print a list of error codes, symbols, and comments.
-#include "SdFat.h"
-void setup() {
-  Serial.begin(9600);
-  while (!Serial) {}
-  delay(1000);
-  Serial.println();
-  Serial.println(F("Code,Symbol - failed operation"));
-  for (uint8_t code = 0; code <= SD_CARD_ERROR_UNKNOWN; code++) {
-    Serial.print(code < 16 ? "0X0" : "0X");
-    Serial.print(code, HEX);
-    Serial.print(",");
-    printSdErrorSymbol(&Serial, code);
-    Serial.print(" - ");
-    printSdErrorText(&Serial, code);
-    Serial.println();
-  }
-}
-void loop() {}

lib/SdFat_NoArduino/examples/SdFormatter/SdFormatter.ino

@@ -1,249 +0,0 @@
-/*
- * This program will format SD/SDHC/SDXC cards.
- * Warning all data will be deleted!
- *
- * This program attempts to match the format
- * generated by SDFormatter available here:
- *
- * http://www.sdcard.org/consumers/formatter/
- *
- * For very small cards this program uses FAT16
- * and the above SDFormatter uses FAT12.
- */
-#include "SdFat.h"
-#include "sdios.h"
-
-/*
-  Set DISABLE_CS_PIN to disable a second SPI device.
-  For example, with the Ethernet shield, set DISABLE_CS_PIN
-  to 10 to disable the Ethernet controller.
-*/
-const int8_t DISABLE_CS_PIN = -1;
-/*
-  Change the value of SD_CS_PIN if you are using SPI
-  and your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try max SPI clock for an SD. Reduce SPI_CLOCK if errors occur.
-#define SPI_CLOCK SD_SCK_MHZ(50)
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif  ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // HAS_SDIO_CLASS
-//==============================================================================
-// Serial output stream
-ArduinoOutStream cout(Serial);
-//------------------------------------------------------------------------------
-uint32_t cardSectorCount = 0;
-uint8_t  sectorBuffer[512];
-//------------------------------------------------------------------------------
-// SdCardFactory constructs and initializes the appropriate card.
-SdCardFactory cardFactory;
-// Pointer to generic SD card.
-SdCard* m_card = nullptr;
-//------------------------------------------------------------------------------
-#define sdError(msg) {cout << F("error: ") << F(msg) << endl; sdErrorHalt();}
-//------------------------------------------------------------------------------
-void sdErrorHalt() {
-  if (!m_card) {
-    cout << F("Invalid SD_CONFIG") << endl;
-  } else if (m_card->errorCode()) {
-    if (m_card->errorCode() == SD_CARD_ERROR_CMD0) {
-      cout << F("No card, wrong chip select pin, or wiring error?") << endl;
-    }
-    cout << F("SD errorCode: ") << hex << showbase;
-    printSdErrorSymbol(&Serial, m_card->errorCode());
-    cout << F(" = ") << int(m_card->errorCode()) << endl;
-    cout << F("SD errorData = ") << int(m_card->errorData()) << endl;
-  }
-  while (true) {}
-}
-//------------------------------------------------------------------------------
-void clearSerialInput() {
-  uint32_t m = micros();
-  do {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  } while (micros() - m < 10000);
-}
-//------------------------------------------------------------------------------
-// flash erase all data
-uint32_t const ERASE_SIZE = 262144L;
-void eraseCard() {
-  cout << endl << F("Erasing\n");
-  uint32_t firstBlock = 0;
-  uint32_t lastBlock;
-  uint16_t n = 0;
-
-  do {
-    lastBlock = firstBlock + ERASE_SIZE - 1;
-    if (lastBlock >= cardSectorCount) {
-      lastBlock = cardSectorCount - 1;
-    }
-    if (!m_card->erase(firstBlock, lastBlock)) {
-      sdError("erase failed");
-    }
-    cout << '.';
-    if ((n++)%64 == 63) {
-      cout << endl;
-    }
-    firstBlock += ERASE_SIZE;
-  } while (firstBlock < cardSectorCount);
-  cout << endl;
-
-  if (!m_card->readSector(0, sectorBuffer)) {
-    sdError("readBlock");
-  }
-  cout << hex << showbase << setfill('0') << internal;
-  cout << F("All data set to ") << setw(4) << int(sectorBuffer[0]) << endl;
-  cout << dec << noshowbase << setfill(' ') << right;
-  cout << F("Erase done\n");
-}
-//------------------------------------------------------------------------------
-void formatCard() {
-  ExFatFormatter exFatFormatter;
-  FatFormatter fatFormatter;
-
-  // Format exFAT if larger than 32GB.
-  bool rtn = cardSectorCount > 67108864 ?
-    exFatFormatter.format(m_card, sectorBuffer, &Serial) :
-    fatFormatter.format(m_card, sectorBuffer, &Serial);
-
-  if (!rtn) {
-    sdErrorHalt();
-  }
-  cout << F("Run the SdInfo example for format details.") << endl;
-}
-//------------------------------------------------------------------------------
-void printConfig(SdSpiConfig config) {
-  if (DISABLE_CS_PIN < 0) {
-    cout << F(
-           "\nAssuming the SD is the only SPI device.\n"
-           "Edit DISABLE_CS_PIN to disable an SPI device.\n");
-  } else {
-    cout << F("\nDisabling SPI device on pin ");
-    cout << int(DISABLE_CS_PIN) << endl;
-    pinMode(DISABLE_CS_PIN, OUTPUT);
-    digitalWrite(DISABLE_CS_PIN, HIGH);
-  }
-  cout << F("\nAssuming the SD chip select pin is: ") << int(config.csPin);
-  cout << F("\nEdit SD_CS_PIN to change the SD chip select pin.\n");
-}
-//------------------------------------------------------------------------------
-void printConfig(SdioConfig config) {
-  (void)config;
-  cout << F("Assuming an SDIO interface.\n");
-}
-//------------------------------------------------------------------------------
-void setup() {
-  char c;
-  Serial.begin(9600);
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  printConfig(SD_CONFIG);
-  cout << F("\nType any character to start\n");
-  while (!Serial.available()) {
-    yield();
-  }
-  // Discard any extra characters.
-  clearSerialInput();
-
-  cout << F(
-         "\n"
-         "This program can erase and/or format SD/SDHC/SDXC cards.\n"
-         "\n"
-         "Erase uses the card's fast flash erase command.\n"
-         "Flash erase sets all data to 0X00 for most cards\n"
-         "and 0XFF for a few vendor's cards.\n"
-         "\n"
-         "Cards up to 2 GiB (GiB = 2^30 bytes) will be formated FAT16.\n"
-         "Cards larger than 2 GiB and up to 32 GiB will be formatted\n"
-         "FAT32. Cards larger than 32 GiB will be formatted exFAT.\n"
-         "\n"
-         "Warning, all data on the card will be erased.\n"
-         "Enter 'Y' to continue: ");
-  while (!Serial.available()) {
-    yield();
-  }
-  c = Serial.read();
-  cout << c << endl;
-  if (c != 'Y') {
-    cout << F("Quiting, you did not enter 'Y'.\n");
-    return;
-  }
-  // Read any existing Serial data.
-  clearSerialInput();
-
-  // Select and initialize proper card driver.
-  m_card = cardFactory.newCard(SD_CONFIG);
-  if (!m_card || m_card->errorCode()) {
-    sdError("card init failed.");
-    return;
-  }
-
-  cardSectorCount = m_card->sectorCount();
-  if (!cardSectorCount) {
-    sdError("Get sector count failed.");
-    return;
-  }
-
-  cout << F("\nCard size: ") << cardSectorCount*5.12e-7;
-  cout << F(" GB (GB = 1E9 bytes)\n");
-  cout << F("Card size: ") << cardSectorCount/2097152.0;
-  cout << F(" GiB (GiB = 2^30 bytes)\n");
-
-  cout << F("Card will be formated ");
-  if (cardSectorCount > 67108864) {
-    cout << F("exFAT\n");
-  } else if (cardSectorCount > 4194304) {
-    cout << F("FAT32\n");
-  } else {
-    cout << F("FAT16\n");
-  }
-  cout << F(
-         "\n"
-         "Options are:\n"
-         "E - erase the card and skip formatting.\n"
-         "F - erase and then format the card. (recommended)\n"
-         "Q - quick format the card without erase.\n"
-         "\n"
-         "Enter option: ");
-
-  while (!Serial.available()) {
-    yield();
-  }
-  c = Serial.read();
-  cout << c << endl;
-  if (!strchr("EFQ", c)) {
-    cout << F("Quiting, invalid option entered.") << endl;
-    return;
-  }
-  if (c == 'E' || c == 'F') {
-    eraseCard();
-  }
-  if (c == 'F' || c == 'Q') {
-    formatCard();
-  }
-}
-void loop() {
-}

lib/SdFat_NoArduino/examples/SdInfo/SdInfo.ino

@@ -1,265 +0,0 @@
-/*
- * This program attempts to initialize an SD card and analyze its structure.
- */
-#include "SdFat.h"
-#include "sdios.h"
-/*
-  Set DISABLE_CS_PIN to disable a second SPI device.
-  For example, with the Ethernet shield, set DISABLE_CS_PIN
-  to 10 to disable the Ethernet controller.
-*/
-const int8_t DISABLE_CS_PIN = -1;
-/*
-  Change the value of SD_CS_PIN if you are using SPI
-  and your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SD_SCK_MHZ(16))
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SD_SCK_MHZ(16))
-#endif  // HAS_SDIO_CLASS
-
-//------------------------------------------------------------------------------
-SdFs sd;
-cid_t m_cid;
-csd_t m_csd;
-uint32_t m_eraseSize;
-uint32_t m_ocr;
-static ArduinoOutStream cout(Serial);
-//------------------------------------------------------------------------------
-bool cidDmp() {
-  cout << F("\nManufacturer ID: ");
-  cout << uppercase << showbase << hex << int(m_cid.mid) << dec << endl;
-  cout << F("OEM ID: ") << m_cid.oid[0] << m_cid.oid[1] << endl;
-  cout << F("Product: ");
-  for (uint8_t i = 0; i < 5; i++) {
-    cout << m_cid.pnm[i];
-  }
-  cout << F("\nVersion: ");
-  cout << int(m_cid.prv_n) << '.' << int(m_cid.prv_m) << endl;
-  cout << F("Serial number: ") << hex << m_cid.psn << dec << endl;
-  cout << F("Manufacturing date: ");
-  cout << int(m_cid.mdt_month) << '/';
-  cout << (2000 + 16*m_cid.mdt_year_high + m_cid.mdt_year_low) << endl;
-  cout << endl;
-  return true;
-}
-//------------------------------------------------------------------------------
-void clearSerialInput() {
-  uint32_t m = micros();
-  do {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  } while (micros() - m < 10000);
-}
-//------------------------------------------------------------------------------
-bool csdDmp() {
-  bool eraseSingleBlock;
-  if (m_csd.v1.csd_ver == 0) {
-    eraseSingleBlock = m_csd.v1.erase_blk_en;
-    m_eraseSize = (m_csd.v1.sector_size_high << 1) | m_csd.v1.sector_size_low;
-  } else if (m_csd.v2.csd_ver == 1) {
-    eraseSingleBlock = m_csd.v2.erase_blk_en;
-    m_eraseSize = (m_csd.v2.sector_size_high << 1) | m_csd.v2.sector_size_low;
-  } else {
-    cout << F("m_csd version error\n");
-    return false;
-  }
-  m_eraseSize++;
-  cout << F("cardSize: ") << 0.000512 * sdCardCapacity(&m_csd);
-  cout << F(" MB (MB = 1,000,000 bytes)\n");
-
-  cout << F("flashEraseSize: ") << int(m_eraseSize) << F(" blocks\n");
-  cout << F("eraseSingleBlock: ");
-  if (eraseSingleBlock) {
-    cout << F("true\n");
-  } else {
-    cout << F("false\n");
-  }
-  return true;
-}
-//------------------------------------------------------------------------------
-void errorPrint() {
-  if (sd.sdErrorCode()) {
-    cout << F("SD errorCode: ") << hex << showbase;
-    printSdErrorSymbol(&Serial, sd.sdErrorCode());
-    cout << F(" = ") << int(sd.sdErrorCode()) << endl;
-    cout << F("SD errorData = ") << int(sd.sdErrorData()) << endl;
-  }
-}
-//------------------------------------------------------------------------------
-bool mbrDmp() {
-  MbrSector_t mbr;
-  bool valid = true;
-  if (!sd.card()->readSector(0, (uint8_t*)&mbr)) {
-    cout << F("\nread MBR failed.\n");
-    errorPrint();
-    return false;
-  }
-  cout << F("\nSD Partition Table\n");
-  cout << F("part,boot,bgnCHS[3],type,endCHS[3],start,length\n");
-  for (uint8_t ip = 1; ip < 5; ip++) {
-    MbrPart_t *pt = &mbr.part[ip - 1];
-    if ((pt->boot != 0 && pt->boot != 0X80) ||
-        getLe32(pt->relativeSectors) > sdCardCapacity(&m_csd)) {
-      valid = false;
-    }
-    cout << int(ip) << ',' << uppercase << showbase << hex;
-    cout << int(pt->boot) << ',';
-    for (int i = 0; i < 3; i++ ) {
-      cout << int(pt->beginCHS[i]) << ',';
-    }
-    cout << int(pt->type) << ',';
-    for (int i = 0; i < 3; i++ ) {
-      cout << int(pt->endCHS[i]) << ',';
-    }
-    cout << dec << getLe32(pt->relativeSectors) << ',';
-    cout << getLe32(pt->totalSectors) << endl;
-  }
-  if (!valid) {
-    cout << F("\nMBR not valid, assuming Super Floppy format.\n");
-  }
-  return true;
-}
-//------------------------------------------------------------------------------
-void dmpVol() {
-  cout << F("\nScanning FAT, please wait.\n");
-  uint32_t freeClusterCount = sd.freeClusterCount();
-  if (sd.fatType() <= 32) {
-    cout << F("\nVolume is FAT") << int(sd.fatType()) << endl;
-  } else {
-    cout << F("\nVolume is exFAT\n");
-  }
-  cout << F("sectorsPerCluster: ") << sd.sectorsPerCluster() << endl;
-  cout << F("clusterCount:      ") << sd.clusterCount() << endl;
-  cout << F("freeClusterCount:  ") << freeClusterCount << endl;
-  cout << F("fatStartSector:    ") << sd.fatStartSector() << endl;
-  cout << F("dataStartSector:   ") << sd.dataStartSector() << endl;
-  if (sd.dataStartSector() % m_eraseSize) {
-    cout << F("Data area is not aligned on flash erase boundary!\n");
-    cout << F("Download and use formatter from www.sdcard.org!\n");
-  }
-}
-//------------------------------------------------------------------------------
-void printCardType() {
-
-  cout << F("\nCard type: ");
-
-  switch (sd.card()->type()) {
-    case SD_CARD_TYPE_SD1:
-      cout << F("SD1\n");
-      break;
-
-    case SD_CARD_TYPE_SD2:
-      cout << F("SD2\n");
-      break;
-
-    case SD_CARD_TYPE_SDHC:
-      if (sdCardCapacity(&m_csd) < 70000000) {
-        cout << F("SDHC\n");
-      } else {
-        cout << F("SDXC\n");
-      }
-      break;
-
-    default:
-      cout << F("Unknown\n");
-  }
-}
-//------------------------------------------------------------------------------
-void printConfig(SdSpiConfig config) {
-  if (DISABLE_CS_PIN < 0) {
-    cout << F(
-           "\nAssuming the SD is the only SPI device.\n"
-           "Edit DISABLE_CS_PIN to disable an SPI device.\n");
-  } else {
-    cout << F("\nDisabling SPI device on pin ");
-    cout << int(DISABLE_CS_PIN) << endl;
-    pinMode(DISABLE_CS_PIN, OUTPUT);
-    digitalWrite(DISABLE_CS_PIN, HIGH);
-  }
-  cout << F("\nAssuming the SD chip select pin is: ") << int(config.csPin);
-  cout << F("\nEdit SD_CS_PIN to change the SD chip select pin.\n");
-}
-//------------------------------------------------------------------------------
-void printConfig(SdioConfig config) {
-  (void)config;
-  cout << F("Assuming an SDIO interface.\n");
-}
-//-----------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  cout << F("SdFat version: ") << SD_FAT_VERSION_STR << endl;
-  printConfig(SD_CONFIG);
-
-}
-//------------------------------------------------------------------------------
-void loop() {
-  // Read any existing Serial data.
-  clearSerialInput();
-
-  // F stores strings in flash to save RAM
-  cout << F("\ntype any character to start\n");
-  while (!Serial.available()) {
-    yield();
-  }
-  uint32_t t = millis();
-  if (!sd.cardBegin(SD_CONFIG)) {
-    cout << F(
-           "\nSD initialization failed.\n"
-           "Do not reformat the card!\n"
-           "Is the card correctly inserted?\n"
-           "Is there a wiring/soldering problem?\n");
-    if (isSpi(SD_CONFIG)) {
-      cout << F(
-           "Is SD_CS_PIN set to the correct value?\n"
-           "Does another SPI device need to be disabled?\n"
-           );
-    }
-    errorPrint();
-    return;
-  }
-  t = millis() - t;
-  cout << F("init time: ") << t << " ms" << endl;
-
-  if (!sd.card()->readCID(&m_cid) ||
-      !sd.card()->readCSD(&m_csd) ||
-      !sd.card()->readOCR(&m_ocr)) {
-    cout << F("readInfo failed\n");
-    errorPrint();
-    return;
-  }
-  printCardType();
-  cidDmp();
-  csdDmp();
-  cout << F("\nOCR: ") << uppercase << showbase;
-  cout << hex << m_ocr << dec << endl;
-  if (!mbrDmp()) {
-    return;
-  }
-  if (!sd.volumeBegin()) {
-    cout << F("\nvolumeBegin failed. Is the card formatted?\n");
-    errorPrint();
-    return;
-  }
-  dmpVol();
-}

lib/SdFat_NoArduino/examples/SoftwareSpi/SoftwareSpi.ino

@@ -1,80 +0,0 @@
-// An example of the SoftSpiDriver template class.
-// This example is for an old Adafruit Data Logging Shield on a Mega.
-// Software SPI is required on Mega since this shield connects to pins 10-13.
-// This example will also run on an Uno and other boards using software SPI.
-//
-#include "SdFat.h"
-#if SPI_DRIVER_SELECT == 2  // Must be set in SdFat/SdFatConfig.h
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 0
-//
-// Chip select may be constant or RAM variable.
-const uint8_t SD_CS_PIN = 10;
-//
-// Pin numbers in templates must be constants.
-const uint8_t SOFT_MISO_PIN = 12;
-const uint8_t SOFT_MOSI_PIN = 11;
-const uint8_t SOFT_SCK_PIN  = 13;
-
-// SdFat software SPI template
-SoftSpiDriver<SOFT_MISO_PIN, SOFT_MOSI_PIN, SOFT_SCK_PIN> softSpi;
-// Speed argument is ignored for software SPI.
-#if ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SD_SCK_MHZ(0), &softSpi)
-#else  // ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SD_SCK_MHZ(0), &softSpi)
-#endif  // ENABLE_DEDICATED_SPI
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File file;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 file;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile file;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile file;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-void setup() {
-  Serial.begin(9600);
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  Serial.println("Type any character to start");
-  while (!Serial.available()) {
-    yield();
-  }
-
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt();
-  }
-
-  if (!file.open("SoftSPI.txt", O_RDWR | O_CREAT)) {
-    sd.errorHalt(F("open failed"));
-  }
-  file.println(F("This line was printed using software SPI."));
-
-  file.rewind();
-
-  while (file.available()) {
-    Serial.write(file.read());
-  }
-
-  file.close();
-
-  Serial.println(F("Done."));
-}
-//------------------------------------------------------------------------------
-void loop() {}
-#else  // SPI_DRIVER_SELECT
-#error SPI_DRIVER_SELECT must be two in SdFat/SdFatConfig.h
-#endif  //SPI_DRIVER_SELECT

lib/SdFat_NoArduino/examples/TeensyDmaAdcLogger/TeensyDmaAdcLogger.ino

@@ -1,247 +0,0 @@
-// Test of Teensy exFAT DMA ADC logger.
-// This is mainly to test use of RingBuf in an ISR.
-// You should modify it for serious use as a data logger.
-//
-#include "DMAChannel.h"
-#include "SdFat.h"
-#include "FreeStack.h"
-#include "RingBuf.h"
-
-// 400 sector RingBuf - could be larger on Teensy 4.1.
-const size_t RING_BUF_SIZE = 400*512;
-
-// Preallocate 8GiB file.
-const uint64_t PRE_ALLOCATE_SIZE = 8ULL << 30;
-
-// Use FIFO SDIO.
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-
-DMAChannel dma(true);
-
-SdFs sd;
-
-FsFile file;
-//------------------------------------------------------------------------------
-// Ping-pong DMA buffer.
-DMAMEM static uint16_t __attribute__((aligned(32))) dmaBuf[2][256];
-size_t dmaCount;
-
-// RingBuf for 512 byte sectors.
-RingBuf<FsFile, RING_BUF_SIZE> rb;
-
-// Shared between ISR and background.
-volatile size_t maxBytesUsed;
-
-volatile bool overrun;
-//------------------------------------------------------------------------------
-//ISR.
-static void isr() {
-  if (rb.bytesFreeIsr() >= 512 && !overrun) {
-    rb.memcpyIn(dmaBuf[dmaCount & 1], 512);
-    dmaCount++;
-    if (rb.bytesUsed() > maxBytesUsed) {
-      maxBytesUsed = rb.bytesUsed();
-    }
-  } else {
-    overrun = true;
-  }
-  dma.clearComplete();
-  dma.clearInterrupt();
-#if defined(__IMXRT1062__)
-  // Handle clear interrupt glitch in Teensy 4.x!
-  asm("DSB");
-#endif  // defined(__IMXRT1062__)
-}
-//------------------------------------------------------------------------------
-// Over-clocking will degrade quality - use only for stress testing.
-void overclock() {
-#if defined(__IMXRT1062__) // Teensy 4.0
-  ADC1_CFG  =
-    // High Speed Configuration
-    ADC_CFG_ADHSC |
-    // Sample period 3 clocks
-    ADC_CFG_ADSTS(0) |
-    // Input clock
-    ADC_CFG_ADIV(0) |
-    // Not selected - Long Sample Time Configuration
-    // ADC_CFG_ADLSMP |
-    // 12-bit
-    ADC_CFG_MODE(2) |
-    // Asynchronous clock
-    ADC_CFG_ADICLK(3);
-#else // defined(__IMXRT1062__)
-  // Set 12 bit mode and max over-clock
-  ADC0_CFG1 =
-    // Clock divide select, 0=direct, 1=div2, 2=div4, 3=div8
-    ADC_CFG1_ADIV(0) |
-    // Sample time configuration, 0=Short, 1=Long
-    // ADC_CFG1_ADLSMP |
-    // Conversion mode, 0=8 bit, 1=12 bit, 2=10 bit, 3=16 bit
-    ADC_CFG1_MODE(1) |
-    // Input clock, 0=bus, 1=bus/2, 2=OSCERCLK, 3=async
-    ADC_CFG1_ADICLK(0);
-
-  ADC0_CFG2 = ADC_CFG2_MUXSEL | ADC_CFG2_ADLSTS(3);
-#endif  // defined(__IMXRT1062__)
-}
-//------------------------------------------------------------------------------
-#if defined(__IMXRT1062__) // Teensy 4.0
-#define SOURCE_SADDR ADC1_R0
-#define SOURCE_EVENT DMAMUX_SOURCE_ADC1
-#else
-#define SOURCE_SADDR ADC0_RA
-#define SOURCE_EVENT DMAMUX_SOURCE_ADC0
-#endif
-//------------------------------------------------------------------------------
-// Should replace ADC stuff with calls to Teensy ADC library.
-// https://github.com/pedvide/ADC
-static void init(uint8_t pin) {
-  uint32_t adch;
-	uint32_t i, sum = 0;
-	// Actually, do many normal reads, to start with a nice DC level
-	for (i=0; i < 1024; i++) {
-		sum += analogRead(pin);
-	}
-#if defined(__IMXRT1062__) // Teensy 4.0
-  // save channel
-  adch = ADC1_HC0 & 0x1F;
-  // Continuous conversion , DMA enable
-  ADC1_GC = ADC_GC_ADCO | ADC_GC_DMAEN;
-  // start conversion
-  ADC1_HC0 = adch;
-#else  // defined(__IMXRT1062__) // Teensy 4.0
-  // save channel
-  adch = ADC0_SC1A & 0x1F;
-  // DMA enable
-  ADC0_SC2 |= ADC_SC2_DMAEN;
-  // Continuous conversion enable
-  ADC0_SC3 = ADC_SC3_ADCO;
-  // Start ADC
-  ADC0_SC1A = adch;
- #endif  // defined(__IMXRT1062__) // Teensy 4.0
-	// set up a DMA channel to store the ADC data
- 	dma.attachInterrupt(isr);
-	dma.begin();
-  dma.source((volatile const signed short &)SOURCE_SADDR);
-  dma.destinationBuffer((volatile uint16_t*)dmaBuf, sizeof(dmaBuf));
-  dma.interruptAtHalf();
-  dma.interruptAtCompletion();
-	dma.triggerAtHardwareEvent(SOURCE_EVENT);
-	dma.enable();
-}
-//------------------------------------------------------------------------------
-void stopDma() {
-#if defined(__IMXRT1062__) // Teensy 4.0
-  ADC1_GC = 0;
-#else  // defined(__IMXRT1062__)
-  ADC0_SC3 = 0;
-#endif  // defined(__IMXRT1062__)
-  dma.disable();
-}
-//------------------------------------------------------------------------------
-void printTest(Print* pr) {
-  if (file.fileSize() < 1024*2) {
-    return;
-  }
-  file.rewind();
-  rb.begin(&file);
-  // Could readIn RING_BUF_SIZE bytes and write to a csv file in a loop.
-  if (rb.readIn(2048) != 2048) {
-    sd.errorHalt("rb.readIn failed");
-  }
-  uint16_t data;
-  for (size_t i = 0; i < 1024; i++) {
-    pr->print(i);
-    pr->print(',');
-    rb.memcpyOut(&data, 2);
-    pr->println(data);
-  }
-}
-//------------------------------------------------------------------------------
-void runTest(uint8_t pin) {
-  dmaCount = 0;
-  maxBytesUsed = 0;
-  overrun = false;
-  do {
-    delay(10);
-  } while (Serial.read() >= 0);
-
-  if (!file.open("IsrLoggerTest.bin", O_CREAT | O_TRUNC | O_RDWR)) {
-    sd.errorHalt("file.open failed");
-  }
-  if (!file.preAllocate(PRE_ALLOCATE_SIZE)) {
-    sd.errorHalt("file.preAllocate failed");
-  }
-  rb.begin(&file);
-  Serial.println("Type any character to stop\n");
-
-  init(pin);
-  uint32_t samplingTime = micros();
-  while (!overrun && !Serial.available()) {
-    size_t n = rb.bytesUsed();
-    if ((n + file.curPosition()) >= (PRE_ALLOCATE_SIZE - 512)) {
-      Serial.println("File full - stopping");
-      break;
-    }
-    if (n >= 512) {
-      if (rb.writeOut(512) != 512) {
-        Serial.println("writeOut() failed");
-        file.close();
-        return;
-      }
-    }
-  }
-  stopDma();
-  samplingTime = (micros() - samplingTime);
-  if (!file.truncate()) {
-    sd.errorHalt("truncate failed");
-  }
-  if (overrun) {
-    Serial.println("Overrun ERROR!!");
-  }
-  Serial.print("RingBufSize ");
-  Serial.println(RING_BUF_SIZE);
-  Serial.print("maxBytesUsed ");
-  Serial.println(maxBytesUsed);
-  Serial.print("fileSize ");
-  Serial.println((uint32_t)file.fileSize());
-  Serial.print(0.000001*samplingTime);
-  Serial.println(" seconds");
-  Serial.print(1.0*file.fileSize()/samplingTime, 3);
-  Serial.println(" MB/sec\n");
-  printTest(&Serial);
-  file.close();
-}
-//------------------------------------------------------------------------------
-void waitSerial(const char* msg) {
-  uint32_t m = micros();
-  do {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  } while (micros() - m < 10000);
-  Serial.println(msg);
-  while (!Serial.available()) {}
-  Serial.println();
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  while (!Serial) {
-    yield();
-  }
-  waitSerial("Type any character to begin");
-  Serial.print("FreeStack: ");
-  Serial.println(FreeStack());
-}
-//------------------------------------------------------------------------------
-void loop() {
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-//analogReadAveraging(1);
-//analogReadResolution(12);
-//overclock(); // 3 Msps on Teensy 3.6 - requires high quality card.
-  runTest(A0);
-  waitSerial("Type any character to run test again");
-}

lib/SdFat_NoArduino/examples/TeensyRtcTimestamp/TeensyRtcTimestamp.ino

@@ -1,139 +0,0 @@
-// Test of time-stamp callback with Teensy 3/4.
-// The upload time will be used to set the RTC.
-// You must arrange for syncing the RTC.
-#include "SdFat.h"
-#include <TimeLib.h>
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 3
-/*
-  Change the value of SD_CS_PIN if you are using SPI and
-  your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try max SPI clock for an SD. Reduce SPI_CLOCK if errors occur.
-#define SPI_CLOCK SD_SCK_MHZ(50)
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif  ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // HAS_SDIO_CLASS
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File file;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 file;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile file;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile file;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-//------------------------------------------------------------------------------
-// Call back for file timestamps.  Only called for file create and sync().
-void dateTime(uint16_t* date, uint16_t* time, uint8_t* ms10) {
-
-  // Return date using FS_DATE macro to format fields.
-  *date = FS_DATE(year(), month(), day());
-
-  // Return time using FS_TIME macro to format fields.
-  *time = FS_TIME(hour(), minute(), second());
-
-  // Return low time bits in units of 10 ms.
-  *ms10 = second() & 1 ? 100 : 0;
-}
-//------------------------------------------------------------------------------
-time_t getTeensy3Time()
-{
-  return Teensy3Clock.get();
-}
-//------------------------------------------------------------------------------
-void printField(Print* pr, char sep, uint8_t v) {
-  if (sep) {
-    pr->write(sep);
-  }
-  if (v < 10) {
-    pr->write('0');
-  }
-  pr->print(v);
-}
-//------------------------------------------------------------------------------
-void printNow(Print* pr) {
-  pr->print(year());
-  printField(pr, '-', month());
-  printField(pr, '-', day());
-  printField(pr, ' ', hour());
-  printField(pr, ':', minute());
-  printField(pr, ':', second());
-}
-//------------------------------------------------------------------------------
-void setup() {
-  // set the Time library to use Teensy 3.0's RTC to keep time
-  setSyncProvider(getTeensy3Time);
-
-  Serial.begin(9600);
-  while (!Serial) {
-    yield();
-  }
-  Serial.println(F("Type any character to begin"));
-  while (!Serial.available()) {
-    yield();
-  }
-  if (timeStatus()!= timeSet) {
-    Serial.println("Unable to sync with the RTC");
-    return;
-  }
-  Serial.print(F("DateTime::now "));
-  printNow(&Serial);
-  Serial.println();
-
-  // Set callback
-  FsDateTime::setCallback(dateTime);
-
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  // Remove old version to set create time.
-  if (sd.exists("RtcTest.txt")) {
-    sd.remove("RtcTest.txt");
-  }
-  if (!file.open("RtcTest.txt", FILE_WRITE)) {
-    Serial.println(F("file.open failed"));
-    return;
-  }
-  // Print current date time to file.
-  file.print(F("Test file at: "));
-  printNow(&file);
-  file.println();
-
-  file.close();
-  // List files in SD root.
-  sd.ls(LS_DATE | LS_SIZE);
-  Serial.println(F("Done"));
-}
-//------------------------------------------------------------------------------
-void loop() {
-}

lib/SdFat_NoArduino/examples/TeensySdioDemo/TeensySdioDemo.ino

@@ -1,221 +0,0 @@
-// Simple performance test for Teensy 3.5/3.6 4.0 SDHC.
-// Demonstrates yield() efficiency for SDIO modes.
-#include "SdFat.h"
-
-// Use built-in SD for SPI modes on Teensy 3.5/3.6.
-// Teensy 4.0 use first SPI port.
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 3
-
-// 32 KiB buffer.
-const size_t BUF_DIM = 32768;
-
-// 8 MiB file.
-const uint32_t FILE_SIZE = 256UL*BUF_DIM;
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File file;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 file;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile file;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile file;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-uint8_t buf[BUF_DIM];
-
-// buffer as uint32_t
-uint32_t* buf32 = (uint32_t*)buf;
-
-// Total usec in read/write calls.
-uint32_t totalMicros = 0;
-// Time in yield() function.
-uint32_t yieldMicros = 0;
-// Number of yield calls.
-uint32_t yieldCalls = 0;
-// Max busy time for single yield call.
-uint32_t yieldMaxUsec = 0;
-//------------------------------------------------------------------------------
-void clearSerialInput() {
-  uint32_t m = micros();
-  do {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  } while (micros() - m < 10000);
-}
-//------------------------------------------------------------------------------
-void errorHalt(const char* msg) {
-  Serial.print("Error: ");
-  Serial.println(msg);
-  if (sd.sdErrorCode()) {
-    if (sd.sdErrorCode() == SD_CARD_ERROR_ACMD41) {
-      Serial.println("Try power cycling the SD card.");
-    }
-    printSdErrorSymbol(&Serial, sd.sdErrorCode());
-    Serial.print(", ErrorData: 0X");
-    Serial.println(sd.sdErrorData(), HEX);
-  }
-  while (true) {}
-}
-bool ready = false;
-//------------------------------------------------------------------------------
-bool sdBusy() {
-  return ready ? sd.card()->isBusy() : false;
-}
-//------------------------------------------------------------------------------
-// Replace "weak" system yield() function.
-void yield() {
-  // Only count cardBusy time.
-  if (!sdBusy()) {
-    return;
-  }
-  uint32_t m = micros();
-  yieldCalls++;
-  while (sdBusy()) {
-    // Do something here.
-  }
-  m = micros() - m;
-  if (m > yieldMaxUsec) {
-    yieldMaxUsec = m;
-  }
-  yieldMicros += m;
-}
-//------------------------------------------------------------------------------
-void runTest() {
-  // Zero Stats
-  totalMicros = 0;
-  yieldMicros = 0;
-  yieldCalls = 0;
-  yieldMaxUsec = 0;
-  if (!file.open("TeensyDemo.bin", O_RDWR | O_CREAT)) {
-    errorHalt("open failed");
-  }
-  Serial.println("\nsize,write,read");
-  Serial.println("bytes,KB/sec,KB/sec");
-  for (size_t nb = 512; nb <= BUF_DIM; nb *= 2) {
-    uint32_t nRdWr = FILE_SIZE/nb;
-    if (!file.truncate(0)) {
-      errorHalt("truncate failed");
-    }
-
-    Serial.print(nb);
-    Serial.print(',');
-    uint32_t t = micros();
-    for (uint32_t n = 0; n < nRdWr; n++) {
-      // Set start and end of buffer.
-      buf32[0] = n;
-      buf32[nb/4 - 1] = n;
-      if (nb != file.write(buf, nb)) {
-        errorHalt("write failed");
-      }
-    }
-    t = micros() - t;
-    totalMicros += t;
-    Serial.print(1000.0*FILE_SIZE/t);
-    Serial.print(',');
-    file.rewind();
-    t = micros();
-
-    for (uint32_t n = 0; n < nRdWr; n++) {
-      if ((int)nb != file.read(buf, nb)) {
-        errorHalt("read failed");
-      }
-      // crude check of data.
-      if (buf32[0] != n || buf32[nb/4 - 1] != n) {
-        errorHalt("data check");
-      }
-    }
-    t = micros() - t;
-    totalMicros += t;
-    Serial.println(1000.0*FILE_SIZE/t);
-  }
-  file.close();
-  Serial.print("\ntotalMicros  ");
-  Serial.println(totalMicros);
-  Serial.print("yieldMicros  ");
-  Serial.println(yieldMicros);
-  Serial.print("yieldCalls   ");
-  Serial.println(yieldCalls);
-  Serial.print("yieldMaxUsec ");
-  Serial.println(yieldMaxUsec);
-//  Serial.print("kHzSdClk     ");
-//  Serial.println(kHzSdClk());
-  Serial.println("Done");
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  while (!Serial) {
-  }
-}
-//------------------------------------------------------------------------------
-void loop() {
-  static bool warn = true;
-  if (warn) {
-    warn = false;
-    Serial.println(
-      "SD cards must be power cycled to leave\n"
-      "SPI mode so do SDIO tests first.\n"
-      "\nCycle power on the card if an error occurs.");
-  }
-  clearSerialInput();
-
-  Serial.println(
-    "\nType '1' for FIFO SDIO"
-    "\n     '2' for DMA SDIO"
-    "\n     '3' for Dedicated SPI"
-    "\n     '4' for Shared SPI");
-  while (!Serial.available()) {
-  }
-  char c = Serial.read();
-
-  if (c =='1') {
-    if (!sd.begin(SdioConfig(FIFO_SDIO))) {
-      errorHalt("begin failed");
-    }
-    Serial.println("\nFIFO SDIO mode.");
-  } else if (c == '2') {
-    if (!sd.begin(SdioConfig(DMA_SDIO))) {
-      errorHalt("begin failed");
-    }
-    Serial.println("\nDMA SDIO mode - slow for small transfers.");
-  } else if (c == '3') {
-#if ENABLE_DEDICATED_SPI
-    if (!sd.begin(SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SD_SCK_MHZ(50)))) {
-      errorHalt("begin failed");
-    }
-    Serial.println("\nDedicated SPI mode.");
-#else  // ENABLE_DEDICATED_SPI
-    Serial.println("ENABLE_DEDICATED_SPI must be non-zero.");
-    return;
-#endif  // ENABLE_DEDICATED_SPI
-  } else if (c == '4') {
-    if (!sd.begin(SdSpiConfig(SD_CS_PIN, SHARED_SPI, SD_SCK_MHZ(50)))) {
-      errorHalt("begin failed");
-    }
-    Serial.println("\nShared SPI mode - slow for small transfers.");
-  } else {
-    Serial.println("Invalid input");
-    return;
-  }
-  ready = true;
-  runTest();
-  ready = false;
-}

lib/SdFat_NoArduino/examples/TeensySdioLogger/TeensySdioLogger.ino

@@ -1,148 +0,0 @@
-// Test Teensy SDIO with write busy in a data logger demo.
-//
-// The driver writes to the uSDHC controller's FIFO then returns
-// while the controller writes the data to the SD.  The first sector
-// puts the controller in write mode and takes about 11 usec on a
-// Teensy 4.1. About 5 usec is required to write a sector when the
-// controller is in write mode.
-
-#include "SdFat.h"
-#include "RingBuf.h"
-
-// Use Teensy SDIO
-#define SD_CONFIG  SdioConfig(FIFO_SDIO)
-
-// Interval between points for 25 ksps.
-#define LOG_INTERVAL_USEC 40
-
-// Size to log 10 byte lines at 25 kHz for more than ten minutes.
-#define LOG_FILE_SIZE 10*25000*600  // 150,000,000 bytes.
-
-// Space to hold more than 800 ms of data for 10 byte lines at 25 ksps.
-#define RING_BUF_CAPACITY 400*512
-#define LOG_FILENAME "SdioLogger.csv"
-
-SdFs sd;
-FsFile file;
-
-// RingBuf for File type FsFile.
-RingBuf<FsFile, RING_BUF_CAPACITY> rb;
-
-void logData() {
-  // Initialize the SD.
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  // Open or create file - truncate existing file.
-  if (!file.open(LOG_FILENAME, O_RDWR | O_CREAT | O_TRUNC)) {
-    Serial.println("open failed\n");
-    return;
-  }
-  // File must be pre-allocated to avoid huge
-  // delays searching for free clusters.
-  if (!file.preAllocate(LOG_FILE_SIZE)) {
-     Serial.println("preAllocate failed\n");
-     file.close();
-     return;
-  }
-  // initialize the RingBuf.
-  rb.begin(&file);
-  Serial.println("Type any character to stop");
-
-  // Max RingBuf used bytes. Useful to understand RingBuf overrun.
-  size_t maxUsed = 0;
-
-  // Min spare micros in loop.
-  int32_t minSpareMicros = INT32_MAX;
-
-  // Start time.
-  uint32_t logTime = micros();
-  // Log data until Serial input or file full.
-  while (!Serial.available()) {
-    // Amount of data in ringBuf.
-    size_t n = rb.bytesUsed();
-    if ((n + file.curPosition()) > (LOG_FILE_SIZE - 20)) {
-      Serial.println("File full - quitting.");
-      break;
-    }
-    if (n > maxUsed) {
-      maxUsed = n;
-    }
-    if (n >= 512 && !file.isBusy()) {
-      // Not busy only allows one sector before possible busy wait.
-      // Write one sector from RingBuf to file.
-      if (512 != rb.writeOut(512)) {
-        Serial.println("writeOut failed");
-        break;
-      }
-    }
-    // Time for next point.
-    logTime += LOG_INTERVAL_USEC;
-    int32_t spareMicros = logTime - micros();
-    if (spareMicros < minSpareMicros) {
-      minSpareMicros = spareMicros;
-    }
-    if (spareMicros <= 0) {
-      Serial.print("Rate too fast ");
-      Serial.println(spareMicros);
-      break;
-    }
-    // Wait until time to log data.
-    while (micros() < logTime) {}
-
-    // Read ADC0 - about 17 usec on Teensy 4, Teensy 3.6 is faster.
-    uint16_t adc = analogRead(0);
-    // Print spareMicros into the RingBuf as test data.
-    rb.print(spareMicros);
-    rb.write(',');
-    // Print adc into RingBuf.
-    rb.println(adc);
-    if (rb.getWriteError()) {
-      // Error caused by too few free bytes in RingBuf.
-      Serial.println("WriteError");
-      break;
-    }
-  }
-  // Write any RingBuf data to file.
-  rb.sync();
-  file.truncate();
-  file.rewind();
-  // Print first twenty lines of file.
-  Serial.println("spareMicros,ADC0");
-  for (uint8_t n = 0; n < 20 && file.available();) {
-    int c = file.read();
-    if (c < 0) {
-      break;
-    }
-    Serial.write(c);
-    if (c == '\n') n++;
-  }
-  Serial.print("fileSize: ");
-  Serial.println((uint32_t)file.fileSize());
-  Serial.print("maxBytesUsed: ");
-  Serial.println(maxUsed);
-  Serial.print("minSpareMicros: ");
-  Serial.println(minSpareMicros);
-  file.close();
-}
-void clearSerialInput() {
-  for (uint32_t m = micros(); micros() - m < 10000;) {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  }
-}
-void setup() {
-  Serial.begin(9600);
-  while (!Serial) {}
-  // Go faster or log more channels.  ADC quality will suffer.
-  // analogReadAveraging(1);
-}
-
-void loop() {
-  clearSerialInput();
-  Serial.println("Type any character to start");
-  while (!Serial.available()) {};
-  clearSerialInput();
-  logData();
-}

lib/SdFat_NoArduino/examples/UnicodeFilenames/UnicodeFilenames.ino

@@ -1,98 +0,0 @@
-// Simple test of Unicode filename.
-// Unicode is supported as UTF-8 encoded strings.
-#include "SdFat.h"
-
-// USE_UTF8_LONG_NAMES must be non-zero in SdFat/src/SdFatCongfig.h
-#if USE_UTF8_LONG_NAMES
-
-#define UTF8_FOLDER u8"😀"
-const char* names[] = {u8"россиянин", u8"très élégant", u8"狗.txt", nullptr};
-
-// Remove files if non-zero.
-#define REMOVE_UTF8_FILES 1
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 0
-
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SD_SCK_MHZ(16))
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SD_SCK_MHZ(16))
-#endif  // HAS_SDIO_CLASS
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File file;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 file;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile file;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile file;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-void setup() {
-  Serial.begin(9600);
-  while (!Serial) {
-    yield();
-  }
-  Serial.println("Type any character to begin");
-  while (!Serial.available()) {
-    yield();
-  }
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  if (!sd.exists(UTF8_FOLDER)) {
-    if (!sd.mkdir(UTF8_FOLDER)) {
-      Serial.println("sd.mkdir failed");
-      return;
-    }
-  }
-  if (!sd.chdir(UTF8_FOLDER)) {
-    Serial.println("sd.chdir failed");
-    return;
-  }
-  for (uint8_t i = 0; names[i]; i++) {
-    if (!file.open(names[i], O_WRONLY | O_CREAT)) {
-      Serial.println("file.open failed");
-      return;
-    }
-    file.println(names[i]);
-    file.close();
-  }
-  Serial.println("ls:");
-  sd.ls("/", LS_SIZE | LS_R);
-#if REMOVE_UTF8_FILES  // For debug test of remove and rmdir.
-  for (uint8_t i = 0; names[i]; i++) {
-    sd.remove(names[i]);
-  }
-  sd.chdir();
-  sd.rmdir(UTF8_FOLDER);
-  Serial.println("After remove and rmdir");
-  sd.ls(LS_SIZE | LS_R);
-#endif  // REMOVE_UTF8_FILES
-  Serial.println("Done!");
-}
-void loop() {
-}
-#else  // USE_UTF8_LONG_NAMES
-#error USE_UTF8_LONG_NAMES must be non-zero in SdFat/src/SdFatCongfig.h
-#endif  // USE_UTF8_LONG_NAMES

lib/SdFat_NoArduino/examples/UserChipSelectFunction/UserChipSelectFunction.ino

@@ -1,47 +0,0 @@
-// An example of an external chip select functions.
-// Useful for port expanders or replacement of the standard GPIO functions.
-//
-#include "SdFat.h"
-
-// SD_CHIP_SELECT_MODE must be set to one or two in SdFat/SdFatConfig.h.
-// A value of one allows optional replacement and two requires replacement.
-#if SD_CHIP_SELECT_MODE == 1 || SD_CHIP_SELECT_MODE == 2
-
-// SD chip select pin.
-#define SD_CS_PIN SS
-
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SD_SCK_MHZ(50))
-
-SdFat sd;
-
-// Stats to verify function calls.
-uint32_t initCalls = 0;
-uint32_t writeCalls = 0;
-//------------------------------------------------------------------------------
-// Modify these functions for your port expander or custom GPIO library.
-void sdCsInit(SdCsPin_t pin) {
-  initCalls++;
-  pinMode(pin, OUTPUT);
-}
-void sdCsWrite(SdCsPin_t pin, bool level) {
-  writeCalls++;
-  digitalWrite(pin, level);
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  sd.ls(&Serial, LS_SIZE);
-
-  Serial.print(F("sdCsInit calls: "));
-  Serial.println(initCalls);
-  Serial.print(F("sdCsWrite calls: "));
-  Serial.println(writeCalls);
-}
-//------------------------------------------------------------------------------
-void loop() {}
-#else  // SD_CHIP_SELECT_MODE == 1 || SD_CHIP_SELECT_MODE == 2
-#error SD_CHIP_SELECT_MODE must be one or two in SdFat/SdFatConfig.h
-#endif  // SD_CHIP_SELECT_MODE == 1 || SD_CHIP_SELECT_MODE == 2

lib/SdFat_NoArduino/examples/UserSPIDriver/UserSPIDriver.ino

@@ -1,81 +0,0 @@
-// An example of an external SPI driver.
-//
-#include "SdFat.h"
-#include "SPI.h"  // Only required if you use features in the SPI library.
-
-#if SPI_DRIVER_SELECT == 3  // Must be set in SdFat/SdFatConfig.h
-
-// SD chip select pin.
-#define SD_CS_PIN SS
-
-// This is a simple driver based on the the standard SPI.h library.
-// You can write a driver entirely independent of SPI.h.
-// It can be optimized for your board or a different SPI port can be used.
-// The driver must be derived from SdSpiBaseClass.
-// See: SdFat/src/SpiDriver/SdSpiBaseClass.h
-class MySpiClass : public SdSpiBaseClass {
- public:
-  // Activate SPI hardware with correct speed and mode.
-  void activate() {
-    SPI.beginTransaction(m_spiSettings);
-  }
-  // Initialize the SPI bus.
-  void begin(SdSpiConfig config) {
-    (void)config;
-    SPI.begin();
-  }
-  // Deactivate SPI hardware.
-  void deactivate() {
-    SPI.endTransaction();
-  }
-  // Receive a byte.
-  uint8_t receive() {
-    return SPI.transfer(0XFF);
-  }
-  // Receive multiple bytes.
-  // Replace this function if your board has multiple byte receive.
-  uint8_t receive(uint8_t* buf, size_t count) {
-    for (size_t i = 0; i < count; i++) {
-      buf[i] = SPI.transfer(0XFF);
-    }
-    return 0;
-  }
-  // Send a byte.
-  void send(uint8_t data) {
-    SPI.transfer(data);
-  }
-  // Send multiple bytes.
-  // Replace this function if your board has multiple byte send.
-  void send(const uint8_t* buf, size_t count) {
-    for (size_t i = 0; i < count; i++) {
-      SPI.transfer(buf[i]);
-    }
-  }
-  // Save SPISettings for new max SCK frequency
-  void setSckSpeed(uint32_t maxSck) {
-    m_spiSettings = SPISettings(maxSck, MSBFIRST, SPI_MODE0);
-  }
-
- private:
-  SPISettings m_spiSettings;
-} mySpi;
-#if ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SD_SCK_MHZ(50), &mySpi)
-#else  // ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SD_SCK_MHZ(50), &mySpi)
-#endif  // ENABLE_DEDICATED_SPI
-SdFat sd;
-
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  sd.ls(&Serial, LS_SIZE);
-}
-//------------------------------------------------------------------------------
-void loop() {}
-#else  // SPI_DRIVER_SELECT
-#error SPI_DRIVER_SELECT must be three in SdFat/SdFatConfig.h
-#endif  // SPI_DRIVER_SELECT

lib/SdFat_NoArduino/examples/bench/bench.ino

@@ -1,276 +0,0 @@
-/*
- * This program is a simple binary write/read benchmark.
- */
-#include "SdFat.h"
-#include "sdios.h"
-#include "FreeStack.h"
-
-// SD_FAT_TYPE = 0 for SdFat/File as defined in SdFatConfig.h,
-// 1 for FAT16/FAT32, 2 for exFAT, 3 for FAT16/FAT32 and exFAT.
-#define SD_FAT_TYPE 0
-/*
-  Change the value of SD_CS_PIN if you are using SPI and
-  your hardware does not use the default value, SS.
-  Common values are:
-  Arduino Ethernet shield: pin 4
-  Sparkfun SD shield: pin 8
-  Adafruit SD shields and modules: pin 10
-*/
-// SDCARD_SS_PIN is defined for the built-in SD on some boards.
-#ifndef SDCARD_SS_PIN
-const uint8_t SD_CS_PIN = SS;
-#else  // SDCARD_SS_PIN
-// Assume built-in SD is used.
-const uint8_t SD_CS_PIN = SDCARD_SS_PIN;
-#endif  // SDCARD_SS_PIN
-
-// Try max SPI clock for an SD. Reduce SPI_CLOCK if errors occur.
-#define SPI_CLOCK SD_SCK_MHZ(50)
-
-// Try to select the best SD card configuration.
-#if HAS_SDIO_CLASS
-#define SD_CONFIG SdioConfig(FIFO_SDIO)
-#elif ENABLE_DEDICATED_SPI
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, DEDICATED_SPI, SPI_CLOCK)
-#else  // HAS_SDIO_CLASS
-#define SD_CONFIG SdSpiConfig(SD_CS_PIN, SHARED_SPI, SPI_CLOCK)
-#endif  // HAS_SDIO_CLASS
-
-// Set PRE_ALLOCATE true to pre-allocate file clusters.
-const bool PRE_ALLOCATE = true;
-
-// Set SKIP_FIRST_LATENCY true if the first read/write to the SD can
-// be avoid by writing a file header or reading the first record.
-const bool SKIP_FIRST_LATENCY = true;
-
-// Size of read/write.
-const size_t BUF_SIZE = 512;
-
-// File size in MB where MB = 1,000,000 bytes.
-const uint32_t FILE_SIZE_MB = 5;
-
-// Write pass count.
-const uint8_t WRITE_COUNT = 2;
-
-// Read pass count.
-const uint8_t READ_COUNT = 2;
-//==============================================================================
-// End of configuration constants.
-//------------------------------------------------------------------------------
-// File size in bytes.
-const uint32_t FILE_SIZE = 1000000UL*FILE_SIZE_MB;
-
-// Insure 4-byte alignment.
-uint32_t buf32[(BUF_SIZE + 3)/4];
-uint8_t* buf = (uint8_t*)buf32;
-
-#if SD_FAT_TYPE == 0
-SdFat sd;
-File file;
-#elif SD_FAT_TYPE == 1
-SdFat32 sd;
-File32 file;
-#elif SD_FAT_TYPE == 2
-SdExFat sd;
-ExFile file;
-#elif SD_FAT_TYPE == 3
-SdFs sd;
-FsFile file;
-#else  // SD_FAT_TYPE
-#error Invalid SD_FAT_TYPE
-#endif  // SD_FAT_TYPE
-
-// Serial output stream
-ArduinoOutStream cout(Serial);
-//------------------------------------------------------------------------------
-// Store error strings in flash to save RAM.
-#define error(s) sd.errorHalt(&Serial, F(s))
-//------------------------------------------------------------------------------
-void cidDmp() {
-  cid_t cid;
-  if (!sd.card()->readCID(&cid)) {
-
-    error("readCID failed");
-  }
-  cout << F("\nManufacturer ID: ");
-  cout << hex << int(cid.mid) << dec << endl;
-  cout << F("OEM ID: ") << cid.oid[0] << cid.oid[1] << endl;
-  cout << F("Product: ");
-  for (uint8_t i = 0; i < 5; i++) {
-    cout << cid.pnm[i];
-  }
-  cout << F("\nVersion: ");
-  cout << int(cid.prv_n) << '.' << int(cid.prv_m) << endl;
-  cout << F("Serial number: ") << hex << cid.psn << dec << endl;
-  cout << F("Manufacturing date: ");
-  cout << int(cid.mdt_month) << '/';
-  cout << (2000 + cid.mdt_year_low + 10 * cid.mdt_year_high) << endl;
-  cout << endl;
-}
-//------------------------------------------------------------------------------
-void clearSerialInput() {
-  uint32_t m = micros();
-  do {
-    if (Serial.read() >= 0) {
-      m = micros();
-    }
-  } while (micros() - m < 10000);
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  delay(1000);
-  cout << F("\nUse a freshly formatted SD for best performance.\n");
-  if (!ENABLE_DEDICATED_SPI) {
-    cout << F(
-      "\nSet ENABLE_DEDICATED_SPI nonzero in\n"
-      "SdFatConfig.h for best SPI performance.\n");
-  }
-  // use uppercase in hex and use 0X base prefix
-  cout << uppercase << showbase << endl;
-}
-//------------------------------------------------------------------------------
-void loop() {
-  float s;
-  uint32_t t;
-  uint32_t maxLatency;
-  uint32_t minLatency;
-  uint32_t totalLatency;
-  bool skipLatency;
-
-  // Discard any input.
-  clearSerialInput();
-
-  // F() stores strings in flash to save RAM
-  cout << F("Type any character to start\n");
-  while (!Serial.available()) {
-    yield();
-  }
-#if HAS_UNUSED_STACK
-  cout << F("FreeStack: ") << FreeStack() << endl;
-#endif  // HAS_UNUSED_STACK
-
-  if (!sd.begin(SD_CONFIG)) {
-    sd.initErrorHalt(&Serial);
-  }
-  if (sd.fatType() == FAT_TYPE_EXFAT) {
-    cout << F("Type is exFAT") << endl;
-  } else {
-    cout << F("Type is FAT") << int(sd.fatType()) << endl;
-  }
-
-  cout << F("Card size: ") << sd.card()->sectorCount()*512E-9;
-  cout << F(" GB (GB = 1E9 bytes)") << endl;
-
-  cidDmp();
-
-  // open or create file - truncate existing file.
-  if (!file.open("bench.dat", O_RDWR | O_CREAT | O_TRUNC)) {
-    error("open failed");
-  }
-
-  // fill buf with known data
-  if (BUF_SIZE > 1) {
-    for (size_t i = 0; i < (BUF_SIZE - 2); i++) {
-      buf[i] = 'A' + (i % 26);
-    }
-    buf[BUF_SIZE-2] = '\r';
-  }
-  buf[BUF_SIZE-1] = '\n';
-
-  cout << F("FILE_SIZE_MB = ") << FILE_SIZE_MB << endl;
-  cout << F("BUF_SIZE = ") << BUF_SIZE << F(" bytes\n");
-  cout << F("Starting write test, please wait.") << endl << endl;
-
-  // do write test
-  uint32_t n = FILE_SIZE/BUF_SIZE;
-  cout <<F("write speed and latency") << endl;
-  cout << F("speed,max,min,avg") << endl;
-  cout << F("KB/Sec,usec,usec,usec") << endl;
-  for (uint8_t nTest = 0; nTest < WRITE_COUNT; nTest++) {
-    file.truncate(0);
-    if (PRE_ALLOCATE) {
-      if (!file.preAllocate(FILE_SIZE)) {
-        error("preAllocate failed");
-      }
-    }
-    maxLatency = 0;
-    minLatency = 9999999;
-    totalLatency = 0;
-    skipLatency = SKIP_FIRST_LATENCY;
-    t = millis();
-    for (uint32_t i = 0; i < n; i++) {
-      uint32_t m = micros();
-      if (file.write(buf, BUF_SIZE) != BUF_SIZE) {
-        error("write failed");
-      }
-      m = micros() - m;
-      totalLatency += m;
-      if (skipLatency) {
-        // Wait until first write to SD, not just a copy to the cache.
-        skipLatency = file.curPosition() < 512;
-      } else {
-        if (maxLatency < m) {
-          maxLatency = m;
-        }
-        if (minLatency > m) {
-          minLatency = m;
-        }
-      }
-    }
-    file.sync();
-    t = millis() - t;
-    s = file.fileSize();
-    cout << s/t <<',' << maxLatency << ',' << minLatency;
-    cout << ',' << totalLatency/n << endl;
-  }
-  cout << endl << F("Starting read test, please wait.") << endl;
-  cout << endl <<F("read speed and latency") << endl;
-  cout << F("speed,max,min,avg") << endl;
-  cout << F("KB/Sec,usec,usec,usec") << endl;
-
-  // do read test
-  for (uint8_t nTest = 0; nTest < READ_COUNT; nTest++) {
-    file.rewind();
-    maxLatency = 0;
-    minLatency = 9999999;
-    totalLatency = 0;
-    skipLatency = SKIP_FIRST_LATENCY;
-    t = millis();
-    for (uint32_t i = 0; i < n; i++) {
-      buf[BUF_SIZE-1] = 0;
-      uint32_t m = micros();
-      int32_t nr = file.read(buf, BUF_SIZE);
-      if (nr != BUF_SIZE) {
-        error("read failed");
-      }
-      m = micros() - m;
-      totalLatency += m;
-      if (buf[BUF_SIZE-1] != '\n') {
-
-        error("data check error");
-      }
-      if (skipLatency) {
-        skipLatency = false;
-      } else {
-        if (maxLatency < m) {
-          maxLatency = m;
-        }
-        if (minLatency > m) {
-          minLatency = m;
-        }
-      }
-    }
-    s = file.fileSize();
-    t = millis() - t;
-    cout << s/t <<',' << maxLatency << ',' << minLatency;
-    cout << ',' << totalLatency/n << endl;
-  }
-  cout << endl << F("Done") << endl;
-  file.close();
-}

lib/SdFat_NoArduino/examples/examplesV1/#attic/AnalogLogger/AnalogLogger.ino

@@ -1,197 +0,0 @@
-// A simple data logger for the Arduino analog pins with optional DS1307
-// uses RTClib from https://github.com/adafruit/RTClib
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-#include "FreeStack.h"
-
-#define SD_CHIP_SELECT  SS  // SD chip select pin
-#define USE_DS1307       0  // set nonzero to use DS1307 RTC
-#define LOG_INTERVAL  1000  // mills between entries
-#define SENSOR_COUNT     3  // number of analog pins to log
-#define ECHO_TO_SERIAL   1  // echo data to serial port if nonzero
-#define WAIT_TO_START    1  // Wait for serial input in setup()
-#define ADC_DELAY       10  // ADC delay for high impedence sensors
-
-// file system object
-SdFat sd;
-
-// text file for logging
-ofstream logfile;
-
-// Serial print stream
-ArduinoOutStream cout(Serial);
-
-// buffer to format data - makes it eaiser to echo to Serial
-char buf[80];
-//------------------------------------------------------------------------------
-#if SENSOR_COUNT > 6
-#error SENSOR_COUNT too large
-#endif  // SENSOR_COUNT
-//------------------------------------------------------------------------------
-// store error strings in flash to save RAM
-#define error(s) sd.errorHalt(F(s))
-//------------------------------------------------------------------------------
-#if USE_DS1307
-// use RTClib from Adafruit
-// https://github.com/adafruit/RTClib
-
-// The Arduino IDE has a bug that causes Wire and RTClib to be loaded even
-// if USE_DS1307 is false.
-
-#error remove this line and uncomment the next two lines.
-//#include <Wire.h>
-//#include <RTClib.h>
-RTC_DS1307 RTC;  // define the Real Time Clock object
-//------------------------------------------------------------------------------
-// call back for file timestamps
-void dateTime(uint16_t* date, uint16_t* time) {
-  DateTime now = RTC.now();
-
-  // return date using FAT_DATE macro to format fields
-  *date = FAT_DATE(now.year(), now.month(), now.day());
-
-  // return time using FAT_TIME macro to format fields
-  *time = FAT_TIME(now.hour(), now.minute(), now.second());
-}
-//------------------------------------------------------------------------------
-// format date/time
-ostream& operator << (ostream& os, DateTime& dt) {
-  os << dt.year() << '/' << int(dt.month()) << '/' << int(dt.day()) << ',';
-  os << int(dt.hour()) << ':' << setfill('0') << setw(2) << int(dt.minute());
-  os << ':' << setw(2) << int(dt.second()) << setfill(' ');
-  return os;
-}
-#endif  // USE_DS1307
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial.
-  while (!Serial) {
-    yield();
-  }
-  // F() stores strings in flash to save RAM
-  cout << endl << F("FreeStack: ") << FreeStack() << endl;
-
-#if WAIT_TO_START
-  cout << F("Type any character to start\n");
-  while (!Serial.available()) {
-    yield();
-  }
-  // Discard input.
-  do {
-    delay(10);
-  } while(Serial.available() && Serial.read() >= 0);
-#endif  // WAIT_TO_START
-
-#if USE_DS1307
-  // connect to RTC
-  Wire.begin();
-  if (!RTC.begin()) {
-    error("RTC failed");
-  }
-
-  // set date time callback function
-  SdFile::dateTimeCallback(dateTime);
-  DateTime now = RTC.now();
-  cout  << now << endl;
-#endif  // USE_DS1307
-
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(SD_CHIP_SELECT, SD_SCK_MHZ(50))) {
-    sd.initErrorHalt();
-  }
-
-  // create a new file in root, the current working directory
-  char name[] = "logger00.csv";
-
-  for (uint8_t i = 0; i < 100; i++) {
-    name[6] = i/10 + '0';
-    name[7] = i%10 + '0';
-    if (sd.exists(name)) {
-      continue;
-    }
-    logfile.open(name);
-    break;
-  }
-  if (!logfile.is_open()) {
-    error("file.open");
-  }
-
-  cout << F("Logging to: ") << name << endl;
-  cout << F("Type any character to stop\n\n");
-
-  // format header in buffer
-  obufstream bout(buf, sizeof(buf));
-
-  bout << F("millis");
-
-#if USE_DS1307
-  bout << F(",date,time");
-#endif  // USE_DS1307
-
-  for (uint8_t i = 0; i < SENSOR_COUNT; i++) {
-    bout << F(",sens") << int(i);
-  }
-  logfile << buf << endl;
-
-#if ECHO_TO_SERIAL
-  cout << buf << endl;
-#endif  // ECHO_TO_SERIAL
-}
-//------------------------------------------------------------------------------
-void loop() {
-  uint32_t m;
-
-  // wait for time to be a multiple of interval
-  do {
-    m = millis();
-  } while (m % LOG_INTERVAL);
-
-  // use buffer stream to format line
-  obufstream bout(buf, sizeof(buf));
-
-  // start with time in millis
-  bout << m;
-
-#if USE_DS1307
-  DateTime now = RTC.now();
-  bout << ',' << now;
-#endif  // USE_DS1307
-
-  // read analog pins and format data
-  for (uint8_t ia = 0; ia < SENSOR_COUNT; ia++) {
-#if ADC_DELAY
-    analogRead(ia);
-    delay(ADC_DELAY);
-#endif  // ADC_DELAY
-    bout << ',' << analogRead(ia);
-  }
-  bout << endl;
-
-  // log data and flush to SD
-  logfile << buf << flush;
-
-  // check for error
-  if (!logfile) {
-    error("write data failed");
-  }
-
-#if ECHO_TO_SERIAL
-  cout << buf;
-#endif  // ECHO_TO_SERIAL
-
-  // don't log two points in the same millis
-  if (m == millis()) {
-    delay(1);
-  }
-
-  if (!Serial.available()) {
-    return;
-  }
-  logfile.close();
-  cout << F("Done!");
-  while (true) {}
-}

lib/SdFat_NoArduino/examples/examplesV1/#attic/BaseExtCaseTest/BaseExtCaseTest.ino

@@ -1,46 +0,0 @@
-/*
- * Program to test Short File Name character case flags.
- */
-#include <SPI.h>
-#include "SdFat.h"
-
-const uint8_t chipSelect = SS;
-
-SdFat sd;
-
-SdFile file;
-const char* name[] = {
-  "low.low", "low.Mix", "low.UP",
-  "Mix.low", "Mix.Mix", "Mix.UP",
-  "UP.low",  "UP.Mix",  "UP.UP"
-};
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  Serial.println("type any character to start");
-  while (!Serial.available()) {
-    yield();
-  }
-  if (!sd.begin(chipSelect, SD_SCK_MHZ(50))) {
-    Serial.println("begin failed");
-    return;
-  }
-  for (uint8_t i = 0; i < 9; i++) {
-    sd.remove(name[i]);
-    if (!file.open(name[i], O_RDWR | O_CREAT | O_EXCL)) {
-      sd.errorHalt(name[i]);
-    }
-    file.println(name[i]);
-
-    file.close();
-  }
-  sd.ls(LS_DATE|LS_SIZE);
-  Serial.println("Done");
-}
-//------------------------------------------------------------------------------
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/HelloWorld/HelloWorld.ino

@@ -1,20 +0,0 @@
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-
-//  create a serial output stream
-ArduinoOutStream cout(Serial);
-
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  delay(2000);
-
-  cout << "Hello, World!\n";
-}
-
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/MiniSerial/MiniSerial.ino

@@ -1,29 +0,0 @@
-// This example illustrates use of SdFat's
-// minimal unbuffered AVR Serial support.
-//
-// This is useful for debug and saves RAM
-// Will not work on Due, Leonardo, or Teensy
-
-#include <SPI.h>
-#include "SdFat.h"
-#include "FreeStack.h"
-#ifdef UDR0  // Must be AVR with serial port zero.
-#include "MinimumSerial.h"
-
-MinimumSerial MiniSerial;
-
-void setup() {
-  MiniSerial.begin(9600);
-  MiniSerial.println(FreeStack());
-}
-void loop() {
-  int c;
-  MiniSerial.println(F("Type any Character"));
-  while ((c = MiniSerial.read()) < 0) {}
-  MiniSerial.print(F("Read: "));
-  MiniSerial.println((char)c);
-  while (MiniSerial.read() >= 0) {}
-}
-#else  // UDR0
-#error no AVR serial port 0
-#endif  // UDR0

lib/SdFat_NoArduino/examples/examplesV1/#attic/PrintBenchmarkSD/PrintBenchmarkSD.ino

@@ -1,125 +0,0 @@
-/*
- * This program is a simple Print benchmark.
- */
-#include <SPI.h>
-#include <SD.h>
-
-// SD chip select pin
-const uint8_t chipSelect = SS;
-
-// number of lines to print
-const uint16_t N_PRINT = 20000;
-
-
-// test file
-File file;
-
-//------------------------------------------------------------------------------
-void error(const char* s) {
-  Serial.println(s);
-  while (1) {
-    yield();
-  }
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-}
-//------------------------------------------------------------------------------
-void loop() {
-  uint32_t maxLatency;
-  uint32_t minLatency;
-  uint32_t totalLatency;
-
-  // Read any existing Serial data.
-  do {
-    delay(10);
-  } while (Serial.available() && Serial.read() >= 0);
-
-  // F() stores strings in flash to save RAM
-  Serial.println(F("Type any character to start"));
-  while (!Serial.available()) {
-    yield();
-  }
-
-  // initialize the SD card
-  if (!SD.begin(chipSelect)) {
-    error("begin");
-  }
-
-  Serial.println(F("Starting print test.  Please wait.\n"));
-
-  // do write test
-  for (int test = 0; test < 2; test++) {
-    file = SD.open("bench.txt", FILE_WRITE);
-
-    if (!file) {
-      error("open failed");
-    }
-    switch(test) {
-    case 0:
-      Serial.println(F("Test of println(uint16_t)"));
-      break;
-
-    case 1:
-      Serial.println(F("Test of println(double)"));
-      break;
-    }
-    maxLatency = 0;
-    minLatency = 999999;
-    totalLatency = 0;
-    uint32_t t = millis();
-    for (uint16_t i = 0; i < N_PRINT; i++) {
-      uint32_t m = micros();
-
-      switch(test) {
-      case 0:
-        file.println(i);
-        break;
-
-      case 1:
-        file.println((double)0.01*i);
-        break;
-      }
-
-      if (file.getWriteError()) {
-        error("write failed");
-      }
-      m = micros() - m;
-      if (maxLatency < m) {
-        maxLatency = m;
-      }
-      if (minLatency > m) {
-        minLatency = m;
-      }
-      totalLatency += m;
-    }
-    file.flush();
-    t = millis() - t;
-    double s = file.size();
-    Serial.print(F("Time "));
-    Serial.print(0.001*t);
-    Serial.println(F(" sec"));
-    Serial.print(F("File size "));
-    Serial.print(0.001*s);
-    Serial.print(F(" KB\n"));
-    Serial.print(F("Write "));
-    Serial.print(s/t);
-    Serial.print(F(" KB/sec\n"));
-    Serial.print(F("Maximum latency: "));
-    Serial.print(maxLatency);
-    Serial.print(F(" usec, Minimum Latency: "));
-    Serial.print(minLatency);
-    Serial.print(F(" usec, Avg Latency: "));
-    Serial.print(totalLatency/N_PRINT);
-    Serial.println(F(" usec\n"));
-    SD.remove("bench.txt");
-  }
-  file.close();
-  Serial.println(F("Done!\n"));
-}

lib/SdFat_NoArduino/examples/examplesV1/#attic/SD_Size/SD_Size.ino

@@ -1,30 +0,0 @@
-/*
- * Program to compare size of Arduino SD library with SdFat.
- * See SdFatSize.ino for SdFat program.
- */
-#include <SPI.h>
-#include <SD.h>
-
-File file;
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-
-  if (!SD.begin()) {
-    Serial.println("begin failed");
-    return;
-  }
-  file = SD.open("TEST_SD.TXT", FILE_WRITE);
-
-  file.println("Hello");
-
-  file.close();
-  Serial.println("Done");
-}
-//------------------------------------------------------------------------------
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/SdFatSize/SdFatSize.ino

@@ -1,33 +0,0 @@
-/*
- * Program to compare size of SdFat with Arduino SD library.
- * See SD_Size.ino for Arduino SD program.
- *
- */
-#include <SPI.h>
-#include "SdFat.h"
-
-SdFat sd;
-
-SdFile file;
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-
-  if (!sd.begin()) {
-    Serial.println("begin failed");
-    return;
-  }
-  file.open("SizeTest.txt", O_RDWR | O_CREAT | O_AT_END);
-
-  file.println("Hello");
-
-  file.close();
-  Serial.println("Done");
-}
-//------------------------------------------------------------------------------
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/StreamParseInt/StreamParseInt.ino

@@ -1,44 +0,0 @@
-// Simple demo of the Stream parsInt() member function.
-#include <SPI.h>
-// The next two lines replace #include <SD.h>.
-#include "SdFat.h"
-SdFat SD;
-
-// SD card chip select pin - Modify the value of csPin for your SD module.
-const uint8_t csPin = SS;
-
-File file;
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  // Wait for USB Serial.
-  while(!Serial) {
-    yield();
-  }
-  Serial.println(F("Type any character to start"));
-  while (!Serial.available()) {
-    yield();
-  }
-  // Initialize the SD.
-  if (!SD.begin(csPin)) {
-    Serial.println(F("begin error"));
-    return;
-  }
-  // Create and open the file.  Use flag to truncate an existing file.
-  file = SD.open("stream.txt", O_RDWR|O_CREAT|O_TRUNC);
-  if (!file) {
-    Serial.println(F("open error"));
-    return;
-  }
-  // Write a test number to the file.
-  file.println("12345");
-
-  // Rewind the file and read the number with parseInt().
-  file.seek(0);
-  int i = file.parseInt();
-  Serial.print(F("parseInt: "));
-  Serial.println(i);
-  file.close();
-}
-
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/append/append.ino

@@ -1,77 +0,0 @@
-/*
- * Append Example
- *
- * This program shows how to use open for append.
- * The program will append 100 line each time it opens the file.
- * The program will open and close the file 100 times.
- */
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-
-// SD chip select pin
-const uint8_t chipSelect = SS;
-
-// file system object
-SdFat sd;
-
-// create Serial stream
-ArduinoOutStream cout(Serial);
-
-// store error strings in flash to save RAM
-#define error(s) sd.errorHalt(F(s))
-//------------------------------------------------------------------------------
-void setup() {
-  // filename for this example
-  char name[] = "append.txt";
-
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  // F() stores strings in flash to save RAM
-  cout << endl << F("Type any character to start\n");
-  while (!Serial.available()) {
-    yield();
-  }
-
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(chipSelect, SD_SCK_MHZ(50))) {
-    sd.initErrorHalt();
-  }
-
-  cout << F("Appending to: ") << name;
-
-  for (uint8_t i = 0; i < 100; i++) {
-    // open stream for append
-    ofstream sdout(name, ios::out | ios::app);
-    if (!sdout) {
-      error("open failed");
-    }
-
-    // append 100 lines to the file
-    for (uint8_t j = 0; j < 100; j++) {
-      // use int() so byte will print as decimal number
-      sdout << "line " << int(j) << " of pass " << int(i);
-      sdout << " millis = " << millis() << endl;
-    }
-    // close the stream
-    sdout.close();
-
-    if (!sdout) {
-      error("append data failed");
-    }
-
-    // output progress indicator
-    if (i % 25 == 0) {
-      cout << endl;
-    }
-    cout << '.';
-  }
-  cout << endl << "Done" << endl;
-}
-//------------------------------------------------------------------------------
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/average/average.ino

@@ -1,82 +0,0 @@
-/*
- * Calculate the sum and average of a list of floating point numbers
- */
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-
-// SD chip select pin
-const uint8_t chipSelect = SS;
-
-// object for the SD file system
-SdFat sd;
-
-// define a serial output stream
-ArduinoOutStream cout(Serial);
-//------------------------------------------------------------------------------
-void writeTestFile() {
-  // open the output file
-  ofstream sdout("AvgTest.txt");
-
-  // write a series of float numbers
-  for (int16_t i = -1001; i < 2000; i += 13) {
-    sdout << 0.1 * i << endl;
-  }
-  if (!sdout) {
-    sd.errorHalt("sdout failed");
-  }
-
-  sdout.close();
-}
-//------------------------------------------------------------------------------
-void calcAverage() {
-  uint16_t n = 0;  // count of input numbers
-  double num;      // current input number
-  double sum = 0;  // sum of input numbers
-
-  // open the input file
-  ifstream sdin("AvgTest.txt");
-
-  // check for an open failure
-  if (!sdin) {
-    sd.errorHalt("sdin failed");
-  }
-
-  // read and sum the numbers
-  while (sdin >> num) {
-    n++;
-    sum += num;
-  }
-
-  // print the results
-  cout << "sum of " << n << " numbers = " << sum << endl;
-  cout << "average = " << sum/n << endl;
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  // F() stores strings in flash to save RAM
-  cout << F("Type any character to start\n");
-  while (!Serial.available()) {
-    yield();
-  }
-
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(chipSelect, SD_SCK_MHZ(50))) {
-    sd.initErrorHalt();
-  }
-
-  // write the test file
-  writeTestFile();
-
-  // read the test file and calculate the average
-  calcAverage();
-}
-//------------------------------------------------------------------------------
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/benchSD/benchSD.ino

@@ -1,149 +0,0 @@
-/*
- * This program is a simple binary write/read benchmark
- * for the standard Arduino SD.h library.
- */
-#include <SPI.h>
-#include <SD.h>
-
-// SD chip select pin
-const uint8_t chipSelect = SS;
-
-#define FILE_SIZE_MB 5
-#define FILE_SIZE (1000000UL*FILE_SIZE_MB)
-#define BUF_SIZE 100
-
-uint8_t buf[BUF_SIZE];
-
-// test file
-File file;
-
-//------------------------------------------------------------------------------
-void error(const char* s) {
-  Serial.println(s);
-  while (1) {
-    yield();
-  }
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-}
-//------------------------------------------------------------------------------
-void loop() {
-  uint32_t maxLatency;
-  uint32_t minLatency;
-  uint32_t totalLatency;
-
-  // Discard any input.
-  do {
-    delay(10);
-  } while (Serial.available() && Serial.read() >= 0);
-
-  // F() stores strings in flash to save RAM
-  Serial.println(F("Type any character to start"));
-
-  while (!Serial.available()) {
-    yield();
-  }
-  if (!SD.begin(chipSelect)) {
-    error("begin");
-  }
-
-  // open or create file - truncate existing file.
-  file = SD.open("Bench.dat", O_RDWR | O_TRUNC | O_CREAT);
-  if (!file) {
-    error("open failed");
-  }
-
-  // fill buf with known data
-  for (size_t_t i = 0; i < (BUF_SIZE-2); i++) {
-    buf[i] = 'A' + (i % 26);
-  }
-  buf[BUF_SIZE-2] = '\r';
-  buf[BUF_SIZE-1] = '\n';
-
-  Serial.print(F("File size "));
-  Serial.print(FILE_SIZE_MB);
-  Serial.println(F("MB"));
-  Serial.print(F("Buffer size "));
-  Serial.print(BUF_SIZE);
-  Serial.println(F(" bytes"));
-  Serial.println(F("Starting write test.  Please wait up to a minute"));
-
-  // do write test
-  uint32_t n = FILE_SIZE/sizeof(buf);
-  maxLatency = 0;
-  minLatency = 999999;
-  totalLatency = 0;
-  uint32_t t = millis();
-  for (uint32_t i = 0; i < n; i++) {
-    uint32_t m = micros();
-    if (file.write(buf, sizeof(buf)) != sizeof(buf)) {
-      error("write failed");
-    }
-    m = micros() - m;
-    if (maxLatency < m) {
-      maxLatency = m;
-    }
-    if (minLatency > m) {
-      minLatency = m;
-    }
-    totalLatency += m;
-  }
-  file.flush();
-  t = millis() - t;
-  double s = file.size();
-  Serial.print(F("Write "));
-  Serial.print(s/t);
-  Serial.print(F(" KB/sec\n"));
-  Serial.print(F("Maximum latency: "));
-  Serial.print(maxLatency);
-  Serial.print(F(" usec, Minimum Latency: "));
-  Serial.print(minLatency);
-  Serial.print(F(" usec, Avg Latency: "));
-  Serial.print(totalLatency/n);
-  Serial.print(F(" usec\n\n"));
-  Serial.println(F("Starting read test.  Please wait up to a minute"));
-  // do read test
-  file.seek(0);
-  maxLatency = 0;
-  minLatency = 99999;
-  totalLatency = 0;
-  t = millis();
-  for (uint32_t i = 0; i < n; i++) {
-    buf[BUF_SIZE-1] = 0;
-    uint32_t m = micros();
-    if (file.read(buf, sizeof(buf)) != sizeof(buf)) {
-      error("read failed");
-    }
-    m = micros() - m;
-    if (maxLatency < m) {
-      maxLatency = m;
-    }
-    if (minLatency > m) {
-      minLatency = m;
-    }
-    totalLatency += m;
-    if (buf[BUF_SIZE-1] != '\n') {
-      error("data check");
-    }
-  }
-  t = millis() - t;
-  Serial.print(F("Read "));
-  Serial.print(s/t);
-  Serial.print(F(" KB/sec\n"));
-  Serial.print(F("Maximum latency: "));
-  Serial.print(maxLatency);
-  Serial.print(F(" usec, Minimum Latency: "));
-  Serial.print(minLatency);
-  Serial.print(F(" usec, Avg Latency: "));
-  Serial.print(totalLatency/n);
-  Serial.print(F(" usec\n\n"));
-  Serial.print(F("Done\n\n"));
-  file.close();
-}

lib/SdFat_NoArduino/examples/examplesV1/#attic/bufstream/bufstream.ino

@@ -1,39 +0,0 @@
-/*
- * Use of ibufsteam to parse a line and obufstream to format a line
- */
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-
-// create a serial output stream
-ArduinoOutStream cout(Serial);
-//------------------------------------------------------------------------------
-void setup() {
-  char buf[20];   // buffer for formatted line
-  int i, j, k;    // values from parsed line
-
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  delay(2000);
-
-  // initialize input string
-  ibufstream bin("123 456 789");
-
-  // parse the string "123 456 789"
-  bin >> i >> j >> k;
-
-  // initialize output buffer
-  obufstream bout(buf, sizeof(buf));
-
-  // format the output string
-  bout << k << ',' << j << ',' << i << endl;
-
-  // write the string to serial
-  cout << buf;
-}
-
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/cin_cout/cin_cout.ino

@@ -1,39 +0,0 @@
-/*
- * Demo of ArduinoInStream and ArduinoOutStream
- */
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-
-// create serial output stream
-ArduinoOutStream cout(Serial);
-
-// input line buffer
-char cinBuf[40];
-
-// create serial input stream
-ArduinoInStream cin(Serial, cinBuf, sizeof(cinBuf));
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-}
-//------------------------------------------------------------------------------
-void loop() {
-  int32_t n = 0;
-
-  cout << "\nenter an integer\n";
-
-  cin.readline();
-
-  if (cin >> n) {
-    cout << "The number is: " << n;
-  } else {
-    // will fail if no digits or not in range [-2147483648, 2147483647]
-    cout << "Invalid input: " << cinBuf;
-  }
-  cout << endl;
-}

lib/SdFat_NoArduino/examples/examplesV1/#attic/eventlog/eventlog.ino

@@ -1,62 +0,0 @@
-/*
- * Append a line to a file - demo of pathnames and streams
- */
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-// SD chip select pin
-const uint8_t chipSelect = SS;
-
-// file system object
-SdFat sd;
-
-// define a serial output stream
-ArduinoOutStream cout(Serial);
-//------------------------------------------------------------------------------
-/*
- * Append a line to logfile.txt
- */
-void logEvent(const char *msg) {
-  // create dir if needed
-  sd.mkdir("logs/2014/Jan");
-
-  // create or open a file for append
-  ofstream sdlog("logs/2014/Jan/logfile.txt", ios::out | ios::app);
-
-  // append a line to the file
-  sdlog << msg << endl;
-
-  // check for errors
-  if (!sdlog) {
-    sd.errorHalt("append failed");
-  }
-
-  sdlog.close();
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  // F() stores strings in flash to save RAM
-  cout << F("Type any character to start\n");
-  while (!Serial.available()) {
-    yield();
-  }
-  delay(400);  // catch Due reset problem
-
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(chipSelect, SD_SCK_MHZ(50))) {
-    sd.initErrorHalt();
-  }
-
-  // append a line to the logfile
-  logEvent("Another line for the logfile");
-
-  cout << F("Done - check /logs/2014/Jan/logfile.txt on the SD") << endl;
-}
-//------------------------------------------------------------------------------
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/fgetsRewrite/fgetsRewrite.ino

@@ -1,111 +0,0 @@
-// Demo of rewriting a line read by fgets
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-
-// SD card chip select pin
-const uint8_t chipSelect = SS;
-
-// file system
-SdFat sd;
-
-// print stream
-ArduinoOutStream cout(Serial);
-//------------------------------------------------------------------------------
-// store error strings in flash memory
-#define error(s) sd.errorHalt(F(s))
-//------------------------------------------------------------------------------
-void demoFgets() {
-  char line[25];
-  int c;
-  uint32_t pos;
-
-  // open test file
-  SdFile rdfile("fgets.txt", O_RDWR);
-
-  // check for open error
-  if (!rdfile.isOpen()) {
-    error("demoFgets");
-  }
-
-  // list file
-  cout << F("-----Before Rewrite\r\n");
-  while ((c = rdfile.read()) >= 0) {
-    Serial.write(c);
-  }
-
-  rdfile.rewind();
-  // read lines from the file to get position
-  while (1) {
-    pos = rdfile.curPosition();
-    if (rdfile.fgets(line, sizeof(line)) < 0) {
-      error("Line not found");
-    }
-    // find line that contains "Line C"
-    if (strstr(line, "Line C")) {
-      break;
-    }
-  }
-
-  // rewrite line with 'C'
-  if (!rdfile.seekSet(pos)) {
-    error("seekSet");
-  }
-  rdfile.println("Line R");
-  rdfile.rewind();
-
-  // list file
-  cout << F("\r\n-----After Rewrite\r\n");
-  while ((c = rdfile.read()) >= 0) {
-    Serial.write(c);
-  }
-
-  // close so rewrite is not lost
-  rdfile.close();
-}
-//------------------------------------------------------------------------------
-void makeTestFile() {
-  // create or open test file
-  SdFile wrfile("fgets.txt", O_WRONLY | O_CREAT | O_TRUNC);
-
-  // check for open error
-  if (!wrfile.isOpen()) {
-    error("MakeTestFile");
-  }
-
-  // write test file
-  wrfile.print(F(
-                 "Line A\r\n"
-                 "Line B\r\n"
-                 "Line C\r\n"
-                 "Line D\r\n"
-                 "Line E\r\n"
-               ));
-  wrfile.close();
-}
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  cout << F("Type any character to start\n");
-  while (!Serial.available()) {
-    yield();
-  }
-
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(chipSelect, SD_SCK_MHZ(50))) {
-    sd.initErrorHalt();
-  }
-
-  makeTestFile();
-
-  demoFgets();
-
-  cout << F("\nDone\n");
-}
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/readlog/readlog.ino

@@ -1,51 +0,0 @@
-/*
- * Read the logfile created by the eventlog.ino example.
- * Demo of pathnames and working directories
- */
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-
-// SD chip select pin
-const uint8_t chipSelect = SS;
-
-// file system object
-SdFat sd;
-
-// define a serial output stream
-ArduinoOutStream cout(Serial);
-//------------------------------------------------------------------------------
-void setup() {
-  int c;
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(chipSelect, SD_SCK_MHZ(50))) {
-    sd.initErrorHalt();
-  }
-
-  // set current working directory
-  if (!sd.chdir("logs/2014/Jan/")) {
-    sd.errorHalt("chdir failed. Did you run eventlog.ino?");
-  }
-  // open file in current working directory
-  ifstream file("logfile.txt");
-
-  if (!file.is_open()) {
-    sd.errorHalt("open failed");
-  }
-
-  // copy the file to Serial
-  while ((c = file.get()) >= 0) {
-    cout << (char)c;
-  }
-
-  cout << "Done" << endl;
-}
-//------------------------------------------------------------------------------
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/#attic/readme.txt

@@ -1,34 +0,0 @@
-Old and debug examples.
-
-AnalogLogger - A simple data logger for one or more analog pins.
-
-append - This sketch creates a large file by successive
-         open/write/close operations.
-
-average - A demonstration of parsing floating point numbers.
-
-BaseExtCaseTest - Long file name test.
-
-benchSD - A read/write benchmark for the standard Arduino SD.h library.
-
-bufstream - ibufsteam to parse a line and obufstream to format a line.
-
-cin_cout - Demo of ArduinoInStream and ArduinoOutStream.             
-
-eventlog - Append a line to a file - demo of pathnames and streams.
-
-fgetsRewrite - Demo of rewriting a line read by fgets.
-
-HelloWorld - Create a serial output stream.
-
-MiniSerial - SdFat minimal serial support for debug.
-
-PrintBenchmarkSD - Bench mark SD.h print.
-
-readlog - Read file. Demo of pathnames and current working directory.
-
-SD_Size - Determine flash used by SD.h example.
-
-SdFatSize - Determine flash used by SdFat.
-
-StreamParseInt - Simple demo of the Stream parsInt() member function.

lib/SdFat_NoArduino/examples/examplesV1/AnalogBinLogger/AnalogBinLogger.h

@@ -1,39 +0,0 @@
-#ifndef AnalogBinLogger_h
-#define AnalogBinLogger_h
-//------------------------------------------------------------------------------
-// First block of file.
-struct metadata_t {
-  unsigned long  adcFrequency;     // ADC clock frequency
-  unsigned long  cpuFrequency;     // CPU clock frequency
-  unsigned long  sampleInterval;   // Sample interval in CPU cycles.
-  unsigned long  recordEightBits;  // Size of ADC values, nonzero for 8-bits.
-  unsigned long  pinCount;         // Number of analog pins in a sample.
-  unsigned long  pinNumber[123];   // List of pin numbers in a sample.
-};
-//------------------------------------------------------------------------------
-// Data block for 8-bit ADC mode.
-const size_t DATA_DIM8 = 508;
-struct block8_t {
-  unsigned short count;    // count of data values
-  unsigned short overrun;  // count of overruns since last block
-  unsigned char  data[DATA_DIM8];
-};
-//------------------------------------------------------------------------------
-// Data block for 10-bit ADC mode.
-const size_t DATA_DIM16 = 254;
-struct block16_t {
-  unsigned short count;    // count of data values
-  unsigned short overrun;  // count of overruns since last block
-  unsigned short data[DATA_DIM16];
-};
-//------------------------------------------------------------------------------
-// Data block for PC use
-struct adcdata_t {
-  unsigned short count;    // count of data values
-  unsigned short overrun;  // count of overruns since last block
-  union {
-    unsigned char  u8[DATA_DIM8];
-    unsigned short u16[DATA_DIM16];
-  } data;
-};
-#endif  // AnalogBinLogger_h

lib/SdFat_NoArduino/examples/examplesV1/AnalogBinLogger/AnalogBinLogger.ino

@@ -1,826 +0,0 @@
-/**
- * This program logs data from the Arduino ADC to a binary file.
- *
- * Samples are logged at regular intervals. Each Sample consists of the ADC
- * values for the analog pins defined in the PIN_LIST array.  The pins numbers
- * may be in any order.
- *
- * Edit the configuration constants below to set the sample pins, sample rate,
- * and other configuration values.
- *
- * If your SD card has a long write latency, it may be necessary to use
- * slower sample rates.  Using a Mega Arduino helps overcome latency
- * problems since 13 512 byte buffers will be used.
- *
- * Each 512 byte data block in the file has a four byte header followed by up
- * to 508 bytes of data. (508 values in 8-bit mode or 254 values in 10-bit mode)
- * Each block contains an integral number of samples with unused space at the
- * end of the block.
- *
- * Data is written to the file using a SD multiple block write command.
- */
-#ifdef __AVR__
-#include <SPI.h>
-#include "SdFat.h"
-#include "FreeStack.h"
-#include "AnalogBinLogger.h"
-//------------------------------------------------------------------------------
-// Analog pin number list for a sample.  Pins may be in any order and pin
-// numbers may be repeated.
-const uint8_t PIN_LIST[] = {0, 1, 2, 3, 4};
-//------------------------------------------------------------------------------
-// Sample rate in samples per second.
-const float SAMPLE_RATE = 5000;  // Must be 0.25 or greater.
-
-// The interval between samples in seconds, SAMPLE_INTERVAL, may be set to a
-// constant instead of being calculated from SAMPLE_RATE.  SAMPLE_RATE is not
-// used in the code below.  For example, setting SAMPLE_INTERVAL = 2.0e-4
-// will result in a 200 microsecond sample interval.
-const float SAMPLE_INTERVAL = 1.0/SAMPLE_RATE;
-
-// Setting ROUND_SAMPLE_INTERVAL non-zero will cause the sample interval to
-// be rounded to a a multiple of the ADC clock period and will reduce sample
-// time jitter.
-#define ROUND_SAMPLE_INTERVAL 1
-//------------------------------------------------------------------------------
-// ADC clock rate.
-// The ADC clock rate is normally calculated from the pin count and sample
-// interval.  The calculation attempts to use the lowest possible ADC clock
-// rate.
-//
-// You can select an ADC clock rate by defining the symbol ADC_PRESCALER to
-// one of these values.  You must choose an appropriate ADC clock rate for
-// your sample interval.
-// #define ADC_PRESCALER 7 // F_CPU/128 125 kHz on an Uno
-// #define ADC_PRESCALER 6 // F_CPU/64  250 kHz on an Uno
-// #define ADC_PRESCALER 5 // F_CPU/32  500 kHz on an Uno
-// #define ADC_PRESCALER 4 // F_CPU/16 1000 kHz on an Uno
-// #define ADC_PRESCALER 3 // F_CPU/8  2000 kHz on an Uno (8-bit mode only)
-//------------------------------------------------------------------------------
-// Reference voltage.  See the processor data-sheet for reference details.
-// uint8_t const ADC_REF = 0; // External Reference AREF pin.
-uint8_t const ADC_REF = (1 << REFS0);  // Vcc Reference.
-// uint8_t const ADC_REF = (1 << REFS1);  // Internal 1.1 (only 644 1284P Mega)
-// uint8_t const ADC_REF = (1 << REFS1) | (1 << REFS0);  // Internal 1.1 or 2.56
-//------------------------------------------------------------------------------
-// File definitions.
-//
-// Maximum file size in blocks.
-// The program creates a contiguous file with FILE_BLOCK_COUNT 512 byte blocks.
-// This file is flash erased using special SD commands.  The file will be
-// truncated if logging is stopped early.
-const uint32_t FILE_BLOCK_COUNT = 256000;
-
-// log file base name.  Must be six characters or less.
-#define FILE_BASE_NAME "analog"
-
-// Set RECORD_EIGHT_BITS non-zero to record only the high 8-bits of the ADC.
-#define RECORD_EIGHT_BITS 0
-//------------------------------------------------------------------------------
-// Pin definitions.
-//
-// Digital pin to indicate an error, set to -1 if not used.
-// The led blinks for fatal errors. The led goes on solid for SD write
-// overrun errors and logging continues.
-const int8_t ERROR_LED_PIN = 3;
-
-// SD chip select pin.
-const uint8_t SD_CS_PIN = SS;
-//------------------------------------------------------------------------------
-// Buffer definitions.
-//
-// The logger will use SdFat's buffer plus BUFFER_BLOCK_COUNT additional
-// buffers.  QUEUE_DIM must be a power of two larger than
-//(BUFFER_BLOCK_COUNT + 1).
-//
-#if RAMEND < 0X8FF
-#error Too little SRAM
-//
-#elif RAMEND < 0X10FF
-// Use total of two 512 byte buffers.
-const uint8_t BUFFER_BLOCK_COUNT = 1;
-// Dimension for queues of 512 byte SD blocks.
-const uint8_t QUEUE_DIM = 4;  // Must be a power of two!
-//
-#elif RAMEND < 0X20FF
-// Use total of five 512 byte buffers.
-const uint8_t BUFFER_BLOCK_COUNT = 4;
-// Dimension for queues of 512 byte SD blocks.
-const uint8_t QUEUE_DIM = 8;  // Must be a power of two!
-//
-#elif RAMEND < 0X40FF
-// Use total of 13 512 byte buffers.
-const uint8_t BUFFER_BLOCK_COUNT = 12;
-// Dimension for queues of 512 byte SD blocks.
-const uint8_t QUEUE_DIM = 16;  // Must be a power of two!
-//
-#else  // RAMEND
-// Use total of 29 512 byte buffers.
-const uint8_t BUFFER_BLOCK_COUNT = 28;
-// Dimension for queues of 512 byte SD blocks.
-const uint8_t QUEUE_DIM = 32;  // Must be a power of two!
-#endif  // RAMEND
-//==============================================================================
-// End of configuration constants.
-//==============================================================================
-// Temporary log file.  Will be deleted if a reset or power failure occurs.
-#define TMP_FILE_NAME "tmp_log.bin"
-
-// Size of file base name.  Must not be larger than six.
-const uint8_t BASE_NAME_SIZE = sizeof(FILE_BASE_NAME) - 1;
-
-// Number of analog pins to log.
-const uint8_t PIN_COUNT = sizeof(PIN_LIST)/sizeof(PIN_LIST[0]);
-
-// Minimum ADC clock cycles per sample interval
-const uint16_t MIN_ADC_CYCLES = 15;
-
-// Extra cpu cycles to setup ADC with more than one pin per sample.
-const uint16_t ISR_SETUP_ADC = PIN_COUNT > 1 ? 100 : 0;
-
-// Maximum cycles for timer0 system interrupt, millis, micros.
-const uint16_t ISR_TIMER0 = 160;
-//==============================================================================
-SdFat sd;
-
-SdBaseFile binFile;
-
-char binName[13] = FILE_BASE_NAME "00.bin";
-
-#if RECORD_EIGHT_BITS
-const size_t SAMPLES_PER_BLOCK = DATA_DIM8/PIN_COUNT;
-typedef block8_t block_t;
-#else  // RECORD_EIGHT_BITS
-const size_t SAMPLES_PER_BLOCK = DATA_DIM16/PIN_COUNT;
-typedef block16_t block_t;
-#endif // RECORD_EIGHT_BITS
-
-block_t* emptyQueue[QUEUE_DIM];
-uint8_t emptyHead;
-uint8_t emptyTail;
-
-block_t* fullQueue[QUEUE_DIM];
-volatile uint8_t fullHead;  // volatile insures non-interrupt code sees changes.
-uint8_t fullTail;
-
-// queueNext assumes QUEUE_DIM is a power of two
-inline uint8_t queueNext(uint8_t ht) {
-  return (ht + 1) & (QUEUE_DIM -1);
-}
-//==============================================================================
-// Interrupt Service Routines
-
-// Pointer to current buffer.
-block_t* isrBuf;
-
-// Need new buffer if true.
-bool isrBufNeeded = true;
-
-// overrun count
-uint16_t isrOver = 0;
-
-// ADC configuration for each pin.
-uint8_t adcmux[PIN_COUNT];
-uint8_t adcsra[PIN_COUNT];
-uint8_t adcsrb[PIN_COUNT];
-uint8_t adcindex = 1;
-
-// Insure no timer events are missed.
-volatile bool timerError = false;
-volatile bool timerFlag = false;
-//------------------------------------------------------------------------------
-// ADC done interrupt.
-ISR(ADC_vect) {
-  // Read ADC data.
-#if RECORD_EIGHT_BITS
-  uint8_t d = ADCH;
-#else  // RECORD_EIGHT_BITS
-  // This will access ADCL first.
-  uint16_t d = ADC;
-#endif  // RECORD_EIGHT_BITS
-
-  if (isrBufNeeded && emptyHead == emptyTail) {
-    // no buffers - count overrun
-    if (isrOver < 0XFFFF) {
-      isrOver++;
-    }
-
-    // Avoid missed timer error.
-    timerFlag = false;
-    return;
-  }
-  // Start ADC
-  if (PIN_COUNT > 1) {
-    ADMUX = adcmux[adcindex];
-    ADCSRB = adcsrb[adcindex];
-    ADCSRA = adcsra[adcindex];
-    if (adcindex == 0) {
-      timerFlag = false;
-    }
-    adcindex =  adcindex < (PIN_COUNT - 1) ? adcindex + 1 : 0;
-  } else {
-    timerFlag = false;
-  }
-  // Check for buffer needed.
-  if (isrBufNeeded) {
-    // Remove buffer from empty queue.
-    isrBuf = emptyQueue[emptyTail];
-    emptyTail = queueNext(emptyTail);
-    isrBuf->count = 0;
-    isrBuf->overrun = isrOver;
-    isrBufNeeded = false;
-  }
-  // Store ADC data.
-  isrBuf->data[isrBuf->count++] = d;
-
-  // Check for buffer full.
-  if (isrBuf->count >= PIN_COUNT*SAMPLES_PER_BLOCK) {
-    // Put buffer isrIn full queue.
-    uint8_t tmp = fullHead;  // Avoid extra fetch of volatile fullHead.
-    fullQueue[tmp] = (block_t*)isrBuf;
-    fullHead = queueNext(tmp);
-
-    // Set buffer needed and clear overruns.
-    isrBufNeeded = true;
-    isrOver = 0;
-  }
-}
-//------------------------------------------------------------------------------
-// timer1 interrupt to clear OCF1B
-ISR(TIMER1_COMPB_vect) {
-  // Make sure ADC ISR responded to timer event.
-  if (timerFlag) {
-    timerError = true;
-  }
-  timerFlag = true;
-}
-//==============================================================================
-// Error messages stored in flash.
-#define error(msg) {sd.errorPrint(F(msg));fatalBlink();}
-//------------------------------------------------------------------------------
-//
-void fatalBlink() {
-  while (true) {
-    if (ERROR_LED_PIN >= 0) {
-      digitalWrite(ERROR_LED_PIN, HIGH);
-      delay(200);
-      digitalWrite(ERROR_LED_PIN, LOW);
-      delay(200);
-    }
-  }
-}
-//==============================================================================
-#if ADPS0 != 0 || ADPS1 != 1 || ADPS2 != 2
-#error unexpected ADC prescaler bits
-#endif
-//------------------------------------------------------------------------------
-// initialize ADC and timer1
-void adcInit(metadata_t* meta) {
-  uint8_t adps;  // prescaler bits for ADCSRA
-  uint32_t ticks = F_CPU*SAMPLE_INTERVAL + 0.5;  // Sample interval cpu cycles.
-
-  if (ADC_REF & ~((1 << REFS0) | (1 << REFS1))) {
-    error("Invalid ADC reference");
-  }
-#ifdef ADC_PRESCALER
-  if (ADC_PRESCALER > 7 || ADC_PRESCALER < 2) {
-    error("Invalid ADC prescaler");
-  }
-  adps = ADC_PRESCALER;
-#else  // ADC_PRESCALER
-  // Allow extra cpu cycles to change ADC settings if more than one pin.
-  int32_t adcCycles = (ticks - ISR_TIMER0)/PIN_COUNT - ISR_SETUP_ADC;
-
-  for (adps = 7; adps > 0; adps--) {
-    if (adcCycles >= (MIN_ADC_CYCLES << adps)) {
-      break;
-    }
-  }
-#endif  // ADC_PRESCALER
-  meta->adcFrequency = F_CPU >> adps;
-  if (meta->adcFrequency > (RECORD_EIGHT_BITS ? 2000000 : 1000000)) {
-    error("Sample Rate Too High");
-  }
-#if ROUND_SAMPLE_INTERVAL
-  // Round so interval is multiple of ADC clock.
-  ticks += 1 << (adps - 1);
-  ticks >>= adps;
-  ticks <<= adps;
-#endif  // ROUND_SAMPLE_INTERVAL
-
-  if (PIN_COUNT > sizeof(meta->pinNumber)/sizeof(meta->pinNumber[0])) {
-    error("Too many pins");
-  }
-  meta->pinCount = PIN_COUNT;
-  meta->recordEightBits = RECORD_EIGHT_BITS;
-
-  for (int i = 0; i < PIN_COUNT; i++) {
-    uint8_t pin = PIN_LIST[i];
-    if (pin >= NUM_ANALOG_INPUTS) {
-      error("Invalid Analog pin number");
-    }
-    meta->pinNumber[i] = pin;
-
-    // Set ADC reference and low three bits of analog pin number.
-    adcmux[i] = (pin & 7) | ADC_REF;
-    if (RECORD_EIGHT_BITS) {
-      adcmux[i] |= 1 << ADLAR;
-    }
-
-    // If this is the first pin, trigger on timer/counter 1 compare match B.
-    adcsrb[i] = i == 0 ? (1 << ADTS2) | (1 << ADTS0) : 0;
-#ifdef MUX5
-    if (pin > 7) {
-      adcsrb[i] |= (1 << MUX5);
-    }
-#endif  // MUX5
-    adcsra[i] = (1 << ADEN) | (1 << ADIE) | adps;
-    adcsra[i] |= i == 0 ? 1 << ADATE : 1 << ADSC;
-  }
-
-  // Setup timer1
-  TCCR1A = 0;
-  uint8_t tshift;
-  if (ticks < 0X10000) {
-    // no prescale, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS10);
-    tshift = 0;
-  } else if (ticks < 0X10000*8) {
-    // prescale 8, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS11);
-    tshift = 3;
-  } else if (ticks < 0X10000*64) {
-    // prescale 64, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS11) | (1 << CS10);
-    tshift = 6;
-  } else if (ticks < 0X10000*256) {
-    // prescale 256, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS12);
-    tshift = 8;
-  } else if (ticks < 0X10000*1024) {
-    // prescale 1024, CTC mode
-    TCCR1B = (1 << WGM13) | (1 << WGM12) | (1 << CS12) | (1 << CS10);
-    tshift = 10;
-  } else {
-    error("Sample Rate Too Slow");
-  }
-  // divide by prescaler
-  ticks >>= tshift;
-  // set TOP for timer reset
-  ICR1 = ticks - 1;
-  // compare for ADC start
-  OCR1B = 0;
-
-  // multiply by prescaler
-  ticks <<= tshift;
-
-  // Sample interval in CPU clock ticks.
-  meta->sampleInterval = ticks;
-  meta->cpuFrequency = F_CPU;
-  float sampleRate = (float)meta->cpuFrequency/meta->sampleInterval;
-  Serial.print(F("Sample pins:"));
-  for (uint8_t i = 0; i < meta->pinCount; i++) {
-    Serial.print(' ');
-    Serial.print(meta->pinNumber[i], DEC);
-  }
-  Serial.println();
-  Serial.print(F("ADC bits: "));
-  Serial.println(meta->recordEightBits ? 8 : 10);
-  Serial.print(F("ADC clock kHz: "));
-  Serial.println(meta->adcFrequency/1000);
-  Serial.print(F("Sample Rate: "));
-  Serial.println(sampleRate);
-  Serial.print(F("Sample interval usec: "));
-  Serial.println(1000000.0/sampleRate, 4);
-}
-//------------------------------------------------------------------------------
-// enable ADC and timer1 interrupts
-void adcStart() {
-  // initialize ISR
-  isrBufNeeded = true;
-  isrOver = 0;
-  adcindex = 1;
-
-  // Clear any pending interrupt.
-  ADCSRA |= 1 << ADIF;
-
-  // Setup for first pin.
-  ADMUX = adcmux[0];
-  ADCSRB = adcsrb[0];
-  ADCSRA = adcsra[0];
-
-  // Enable timer1 interrupts.
-  timerError = false;
-  timerFlag = false;
-  TCNT1 = 0;
-  TIFR1 = 1 << OCF1B;
-  TIMSK1 = 1 << OCIE1B;
-}
-//------------------------------------------------------------------------------
-void adcStop() {
-  TIMSK1 = 0;
-  ADCSRA = 0;
-}
-//------------------------------------------------------------------------------
-// Convert binary file to csv file.
-void binaryToCsv() {
-  uint8_t lastPct = 0;
-  block_t buf;
-  metadata_t* pm;
-  uint32_t t0 = millis();
-  char csvName[13];
-  StdioStream csvStream;
-
-  if (!binFile.isOpen()) {
-    Serial.println(F("No current binary file"));
-    return;
-  }
-  binFile.rewind();
-  if (binFile.read(&buf , 512) != 512) {
-    error("Read metadata failed");
-  }
-  // Create a new csv file.
-  strcpy(csvName, binName);
-  strcpy(&csvName[BASE_NAME_SIZE + 3], "csv");
-
-  if (!csvStream.fopen(csvName, "w")) {
-    error("open csvStream failed");
-  }
-  Serial.println();
-  Serial.print(F("Writing: "));
-  Serial.print(csvName);
-  Serial.println(F(" - type any character to stop"));
-  pm = (metadata_t*)&buf;
-  csvStream.print(F("Interval,"));
-  float intervalMicros = 1.0e6*pm->sampleInterval/(float)pm->cpuFrequency;
-  csvStream.print(intervalMicros, 4);
-  csvStream.println(F(",usec"));
-  for (uint8_t i = 0; i < pm->pinCount; i++) {
-    if (i) {
-      csvStream.putc(',');
-    }
-    csvStream.print(F("pin"));
-    csvStream.print(pm->pinNumber[i]);
-  }
-  csvStream.println();
-  uint32_t tPct = millis();
-  while (!Serial.available() && binFile.read(&buf, 512) == 512) {
-    if (buf.count == 0) {
-      break;
-    }
-    if (buf.overrun) {
-      csvStream.print(F("OVERRUN,"));
-      csvStream.println(buf.overrun);
-    }
-    for (uint16_t j = 0; j < buf.count; j += PIN_COUNT) {
-      for (uint16_t i = 0; i < PIN_COUNT; i++) {
-        if (i) {
-          csvStream.putc(',');
-        }
-        csvStream.print(buf.data[i + j]);
-      }
-      csvStream.println();
-    }
-    if ((millis() - tPct) > 1000) {
-      uint8_t pct = binFile.curPosition()/(binFile.fileSize()/100);
-      if (pct != lastPct) {
-        tPct = millis();
-        lastPct = pct;
-        Serial.print(pct, DEC);
-        Serial.println('%');
-      }
-    }
-    if (Serial.available()) {
-      break;
-    }
-  }
-  csvStream.fclose();
-  Serial.print(F("Done: "));
-  Serial.print(0.001*(millis() - t0));
-  Serial.println(F(" Seconds"));
-}
-//------------------------------------------------------------------------------
-// read data file and check for overruns
-void checkOverrun() {
-  bool headerPrinted = false;
-  block_t buf;
-  uint32_t bgnBlock, endBlock;
-  uint32_t bn = 0;
-
-  if (!binFile.isOpen()) {
-    Serial.println(F("No current binary file"));
-    return;
-  }
-  if (!binFile.contiguousRange(&bgnBlock, &endBlock)) {
-    error("contiguousRange failed");
-  }
-  binFile.rewind();
-  Serial.println();
-  Serial.println(F("Checking overrun errors - type any character to stop"));
-  if (binFile.read(&buf , 512) != 512) {
-    error("Read metadata failed");
-  }
-  bn++;
-  while (binFile.read(&buf, 512) == 512) {
-    if (buf.count == 0) {
-      break;
-    }
-    if (buf.overrun) {
-      if (!headerPrinted) {
-        Serial.println();
-        Serial.println(F("Overruns:"));
-        Serial.println(F("fileBlockNumber,sdBlockNumber,overrunCount"));
-        headerPrinted = true;
-      }
-      Serial.print(bn);
-      Serial.print(',');
-      Serial.print(bgnBlock + bn);
-      Serial.print(',');
-      Serial.println(buf.overrun);
-    }
-    bn++;
-  }
-  if (!headerPrinted) {
-    Serial.println(F("No errors found"));
-  } else {
-    Serial.println(F("Done"));
-  }
-}
-//------------------------------------------------------------------------------
-// dump data file to Serial
-void dumpData() {
-  block_t buf;
-  if (!binFile.isOpen()) {
-    Serial.println(F("No current binary file"));
-    return;
-  }
-  binFile.rewind();
-  if (binFile.read(&buf , 512) != 512) {
-    error("Read metadata failed");
-  }
-  Serial.println();
-  Serial.println(F("Type any character to stop"));
-  delay(1000);
-  while (!Serial.available() && binFile.read(&buf , 512) == 512) {
-    if (buf.count == 0) {
-      break;
-    }
-    if (buf.overrun) {
-      Serial.print(F("OVERRUN,"));
-      Serial.println(buf.overrun);
-    }
-    for (uint16_t i = 0; i < buf.count; i++) {
-      Serial.print(buf.data[i], DEC);
-      if ((i+1)%PIN_COUNT) {
-        Serial.print(',');
-      } else {
-        Serial.println();
-      }
-    }
-  }
-  Serial.println(F("Done"));
-}
-//------------------------------------------------------------------------------
-// log data
-// max number of blocks to erase per erase call
-uint32_t const ERASE_SIZE = 262144L;
-void logData() {
-  uint32_t bgnBlock, endBlock;
-
-  // Allocate extra buffer space.
-  block_t block[BUFFER_BLOCK_COUNT];
-
-  Serial.println();
-
-  // Initialize ADC and timer1.
-  adcInit((metadata_t*) &block[0]);
-
-  // Find unused file name.
-  if (BASE_NAME_SIZE > 6) {
-    error("FILE_BASE_NAME too long");
-  }
-  while (sd.exists(binName)) {
-    if (binName[BASE_NAME_SIZE + 1] != '9') {
-      binName[BASE_NAME_SIZE + 1]++;
-    } else {
-      binName[BASE_NAME_SIZE + 1] = '0';
-      if (binName[BASE_NAME_SIZE] == '9') {
-        error("Can't create file name");
-      }
-      binName[BASE_NAME_SIZE]++;
-    }
-  }
-  // Delete old tmp file.
-  if (sd.exists(TMP_FILE_NAME)) {
-    Serial.println(F("Deleting tmp file"));
-    if (!sd.remove(TMP_FILE_NAME)) {
-      error("Can't remove tmp file");
-    }
-  }
-  // Create new file.
-  Serial.println(F("Creating new file"));
-  binFile.close();
-  if (!binFile.createContiguous(TMP_FILE_NAME, 512 * FILE_BLOCK_COUNT)) {
-    error("createContiguous failed");
-  }
-  // Get the address of the file on the SD.
-  if (!binFile.contiguousRange(&bgnBlock, &endBlock)) {
-    error("contiguousRange failed");
-  }
-  // Use SdFat's internal buffer.
-  uint8_t* cache = (uint8_t*)sd.vol()->cacheClear();
-  if (cache == 0) {
-    error("cacheClear failed");
-  }
-
-  // Flash erase all data in the file.
-  Serial.println(F("Erasing all data"));
-  uint32_t bgnErase = bgnBlock;
-  uint32_t endErase;
-  while (bgnErase < endBlock) {
-    endErase = bgnErase + ERASE_SIZE;
-    if (endErase > endBlock) {
-      endErase = endBlock;
-    }
-    if (!sd.card()->erase(bgnErase, endErase)) {
-      error("erase failed");
-    }
-    bgnErase = endErase + 1;
-  }
-  // Start a multiple block write.
-  if (!sd.card()->writeStart(bgnBlock, FILE_BLOCK_COUNT)) {
-    error("writeBegin failed");
-  }
-  // Write metadata.
-  if (!sd.card()->writeData((uint8_t*)&block[0])) {
-    error("Write metadata failed");
-  }
-  // Initialize queues.
-  emptyHead = emptyTail = 0;
-  fullHead = fullTail = 0;
-
-  // Use SdFat buffer for one block.
-  emptyQueue[emptyHead] = (block_t*)cache;
-  emptyHead = queueNext(emptyHead);
-
-  // Put rest of buffers in the empty queue.
-  for (uint8_t i = 0; i < BUFFER_BLOCK_COUNT; i++) {
-    emptyQueue[emptyHead] = &block[i];
-    emptyHead = queueNext(emptyHead);
-  }
-  // Give SD time to prepare for big write.
-  delay(1000);
-  Serial.println(F("Logging - type any character to stop"));
-  // Wait for Serial Idle.
-  Serial.flush();
-  delay(10);
-  uint32_t bn = 1;
-  uint32_t t0 = millis();
-  uint32_t t1 = t0;
-  uint32_t overruns = 0;
-  uint32_t count = 0;
-  uint32_t maxLatency = 0;
-
-  // Start logging interrupts.
-  adcStart();
-  while (1) {
-    if (fullHead != fullTail) {
-      // Get address of block to write.
-      block_t* pBlock = fullQueue[fullTail];
-
-      // Write block to SD.
-      uint32_t usec = micros();
-      if (!sd.card()->writeData((uint8_t*)pBlock)) {
-        error("write data failed");
-      }
-      usec = micros() - usec;
-      t1 = millis();
-      if (usec > maxLatency) {
-        maxLatency = usec;
-      }
-      count += pBlock->count;
-
-      // Add overruns and possibly light LED.
-      if (pBlock->overrun) {
-        overruns += pBlock->overrun;
-        if (ERROR_LED_PIN >= 0) {
-          digitalWrite(ERROR_LED_PIN, HIGH);
-        }
-      }
-      // Move block to empty queue.
-      emptyQueue[emptyHead] = pBlock;
-      emptyHead = queueNext(emptyHead);
-      fullTail = queueNext(fullTail);
-      bn++;
-      if (bn == FILE_BLOCK_COUNT) {
-        // File full so stop ISR calls.
-        adcStop();
-        break;
-      }
-    }
-    if (timerError) {
-      error("Missed timer event - rate too high");
-    }
-    if (Serial.available()) {
-      // Stop ISR calls.
-      adcStop();
-      if (isrBuf != 0 && isrBuf->count >= PIN_COUNT) {
-        // Truncate to last complete sample.
-        isrBuf->count = PIN_COUNT*(isrBuf->count/PIN_COUNT);
-        // Put buffer in full queue.
-        fullQueue[fullHead] = isrBuf;
-        fullHead = queueNext(fullHead);
-        isrBuf = 0;
-      }
-      if (fullHead == fullTail) {
-        break;
-      }
-    }
-  }
-  if (!sd.card()->writeStop()) {
-    error("writeStop failed");
-  }
-  // Truncate file if recording stopped early.
-  if (bn != FILE_BLOCK_COUNT) {
-    Serial.println(F("Truncating file"));
-    if (!binFile.truncate(512L * bn)) {
-      error("Can't truncate file");
-    }
-  }
-  if (!binFile.rename(binName)) {
-    error("Can't rename file");
-  }
-  Serial.print(F("File renamed: "));
-  Serial.println(binName);
-  Serial.print(F("Max block write usec: "));
-  Serial.println(maxLatency);
-  Serial.print(F("Record time sec: "));
-  Serial.println(0.001*(t1 - t0), 3);
-  Serial.print(F("Sample count: "));
-  Serial.println(count/PIN_COUNT);
-  Serial.print(F("Samples/sec: "));
-  Serial.println((1000.0/PIN_COUNT)*count/(t1-t0));
-  Serial.print(F("Overruns: "));
-  Serial.println(overruns);
-  Serial.println(F("Done"));
-}
-//------------------------------------------------------------------------------
-void setup(void) {
-  if (ERROR_LED_PIN >= 0) {
-    pinMode(ERROR_LED_PIN, OUTPUT);
-  }
-  Serial.begin(9600);
-
-  // Read the first sample pin to init the ADC.
-  analogRead(PIN_LIST[0]);
-
-  Serial.print(F("FreeStack: "));
-  Serial.println(FreeStack());
-
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(SD_CS_PIN, SD_SCK_MHZ(50))) {
-    sd.initErrorPrint();
-    fatalBlink();
-  }
-}
-//------------------------------------------------------------------------------
-void loop(void) {
-  // Read any Serial data.
-  do {
-    delay(10);
-  } while (Serial.available() && Serial.read() >= 0);
-  Serial.println();
-  Serial.println(F("type:"));
-  Serial.println(F("c - convert file to csv"));
-  Serial.println(F("d - dump data to Serial"));
-  Serial.println(F("e - overrun error details"));
-  Serial.println(F("r - record ADC data"));
-
-  while(!Serial.available()) {
-    yield();
-  }
-  char c = tolower(Serial.read());
-  if (ERROR_LED_PIN >= 0) {
-    digitalWrite(ERROR_LED_PIN, LOW);
-  }
-  // Read any Serial data.
-  do {
-    delay(10);
-  } while (Serial.available() && Serial.read() >= 0);
-
-  if (c == 'c') {
-    binaryToCsv();
-  } else if (c == 'd') {
-    dumpData();
-  } else if (c == 'e') {
-    checkOverrun();
-  } else if (c == 'r') {
-    logData();
-  } else {
-    Serial.println(F("Invalid entry"));
-  }
-}
-#else  // __AVR__
-#error This program is only for AVR.
-#endif  // __AVR__

lib/SdFat_NoArduino/examples/examplesV1/DirectoryFunctions/DirectoryFunctions.ino

@@ -1,129 +0,0 @@
-/*
- * Example use of chdir(), ls(), mkdir(), and  rmdir().
- */
-#include <SPI.h>
-#include "SdFat.h"
-#include "sdios.h"
-// SD card chip select pin.
-const uint8_t chipSelect = SS;
-//------------------------------------------------------------------------------
-
-// File system object.
-SdFat sd;
-
-// Directory file.
-SdFile root;
-
-// Use for file creation in folders.
-SdFile file;
-
-// Create a Serial output stream.
-ArduinoOutStream cout(Serial);
-
-// Buffer for Serial input.
-char cinBuf[40];
-
-// Create a serial input stream.
-ArduinoInStream cin(Serial, cinBuf, sizeof(cinBuf));
-//==============================================================================
-// Error messages stored in flash.
-#define error(msg) sd.errorHalt(F(msg))
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  delay(1000);
-
-  cout << F("Type any character to start\n");
-  // Wait for input line and discard.
-  cin.readline();
-  cout << endl;
-
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(chipSelect, SD_SCK_MHZ(50))) {
-    sd.initErrorHalt();
-  }
-  if (sd.exists("Folder1")
-    || sd.exists("Folder1/file1.txt")
-    || sd.exists("Folder1/File2.txt")) {
-    error("Please remove existing Folder1, file1.txt, and File2.txt");
-  }
-
-  int rootFileCount = 0;
-  if (!root.open("/")) {
-    error("open root failed");
-  }
-  while (file.openNext(&root, O_RDONLY)) {
-    if (!file.isHidden()) {
-      rootFileCount++;
-    }
-    file.close();
-    if (rootFileCount > 10) {
-      error("Too many files in root. Please use an empty SD.");
-    }
-  }
-  if (rootFileCount) {
-    cout << F("\nPlease use an empty SD for best results.\n\n");
-    delay(1000);
-  }
-  // Create a new folder.
-  if (!sd.mkdir("Folder1")) {
-    error("Create Folder1 failed");
-  }
-  cout << F("Created Folder1\n");
-
-  // Create a file in Folder1 using a path.
-  if (!file.open("Folder1/file1.txt", O_WRONLY | O_CREAT)) {
-    error("create Folder1/file1.txt failed");
-  }
-  file.close();
-  cout << F("Created Folder1/file1.txt\n");
-
-  // Change volume working directory to Folder1.
-  if (!sd.chdir("Folder1")) {
-    error("chdir failed for Folder1.\n");
-  }
-  cout << F("chdir to Folder1\n");
-
-  // Create File2.txt in current directory.
-  if (!file.open("File2.txt", O_WRONLY | O_CREAT)) {
-    error("create File2.txt failed");
-  }
-  file.close();
-  cout << F("Created File2.txt in current directory\n");
-
-  cout << F("\nList of files on the SD.\n");
-  sd.ls("/", LS_R);
-
-  // Remove files from current directory.
-  if (!sd.remove("file1.txt") || !sd.remove("File2.txt")) {
-    error("remove failed");
-  }
-  cout << F("\nfile1.txt and File2.txt removed.\n");
-
-  // Change current directory to root.
-  if (!sd.chdir()) {
-    error("chdir to root failed.\n");
-  }
-
-  cout << F("\nList of files on the SD.\n");
-  sd.ls(LS_R);
-
-  // Remove Folder1.
-  if (!sd.rmdir("Folder1")) {
-    error("rmdir for Folder1 failed\n");
-  }
-
-  cout << F("\nFolder1 removed.\n");
-  cout << F("\nList of files on the SD.\n");
-  sd.ls(LS_R);
-  cout << F("Done!\n");
-}
-//------------------------------------------------------------------------------
-// Nothing happens in loop.
-void loop() {}

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/LongFileName.ino

@@ -1,102 +0,0 @@
-// Example use of lfnOpenNext and open by index.
-// You can use test files located in
-// SdFat/examples/LongFileName/testFiles.
-#include<SPI.h>
-#include "SdFat.h"
-#include "FreeStack.h"
-
-// SD card chip select pin.
-const uint8_t SD_CS_PIN = SS;
-
-SdFat sd;
-SdFile file;
-SdFile dirFile;
-
-// Number of files found.
-uint16_t n = 0;
-
-// Max of ten files since files are selected with a single digit.
-const uint16_t nMax = 10;
-
-// Position of file's directory entry.
-uint16_t dirIndex[nMax];
-//------------------------------------------------------------------------------
-void setup() {
-  Serial.begin(9600);
-  while (!Serial) {}
-  delay(1000);
-
-  // Print the location of some test files.
-  Serial.println(F("\r\n"
-                   "You can use test files located in\r\n"
-                   "SdFat/examples/LongFileName/testFiles"));
-
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(SD_CS_PIN, SD_SCK_MHZ(50))) {
-    sd.initErrorHalt();
-  }
-  Serial.print(F("FreeStack: "));
-  Serial.println(FreeStack());
-  Serial.println();
-
-  // List files in root directory.
-  if (!dirFile.open("/", O_RDONLY)) {
-    sd.errorHalt("open root failed");
-  }
-  while (n < nMax && file.openNext(&dirFile, O_RDONLY)) {
-
-    // Skip directories and hidden files.
-    if (!file.isSubDir() && !file.isHidden()) {
-
-      // Save dirIndex of file in directory.
-      dirIndex[n] = file.dirIndex();
-
-      // Print the file number and name.
-      Serial.print(n++);
-      Serial.write(' ');
-      file.printName(&Serial);
-      Serial.println();
-    }
-    file.close();
-  }
-}
-//------------------------------------------------------------------------------
-void loop() {
-  int c;
-
-  // Read any existing Serial data.
-  do {
-    delay(10);
-  } while (Serial.available() && Serial.read() >= 0);
-  Serial.print(F("\r\nEnter File Number: "));
-
-  while (!Serial.available()) {
-    yield();
-  }
-  c = Serial.read();
-  uint8_t i = c - '0';
-  if (!isdigit(c) || i >= n) {
-    Serial.println(F("Invald number"));
-    return;
-  }
-  Serial.println(i);
-  if (!file.open(&dirFile, dirIndex[i], O_RDONLY)) {
-    sd.errorHalt(F("open"));
-  }
-  Serial.println();
-
-  char last = 0;
-
-  // Copy up to 500 characters to Serial.
-  for (int k = 0; k < 500 && (c = file.read()) > 0; k++)  {
-    Serial.write(last = (char)c);
-  }
-  // Add new line if missing from last line.
-  if (last != '\n') {
-    Serial.println();
-  }
-  file.close();
-  Serial.flush();
-  delay(100);
-}

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/A long name can be 255 characters.txt

@@ -1,4 +0,0 @@
-This is "A long name can be 255 characters.txt"
-This file has a typical Long File Name.
-
-The maximum length of a Long File Name is 255 characters.

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/LFN,NAME.TXT

@@ -1 +0,0 @@
-LFN,NAME.TXT is not 8.3 since it has a comma.

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/MIXCASE.txt

@@ -1,5 +0,0 @@
-MIXCASE.txt does not have a Long File Name.
-
-Starting with NT, file names of this form,
-have the basename and extension character case
-encoded in two bits of the 8.3 directory entry.

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/Not_8_3.txt

@@ -1,2 +0,0 @@
-Not_8_3.txt has a Long File Name
-since the basename is mixed case.

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/OK%83.TXT

@@ -1 +0,0 @@
-OK%83.TXT is a valid 8.3 name.

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/STD_8_3.TXT

@@ -1 +0,0 @@
-STD_8_3.TXT - a vanilla 8.3 name.

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/With Blank.txt

@@ -1,2 +0,0 @@
-With Blank.txt
-Just another example of a Long File Name.

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/With.Two dots.txt

@@ -1,2 +0,0 @@
-"With Two.dots.txt" 
-Lots of reasons this is a Long File Name.

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/lower.txt

@@ -1,5 +0,0 @@
-lower.txt does not have a Long File Name.
-
-Starting with NT, file names of this form,
-have the basename and extension character case
-encoded in two bits of the 8.3 directory entry.

lib/SdFat_NoArduino/examples/examplesV1/LongFileName/testFiles/mixed.TXT

@@ -1,5 +0,0 @@
-mixed.TXT does not have a Long File Name.
-
-Starting with NT, file names of this form,
-have the basename and extension character case
-encoded in two bits of the 8.3 directory entry.

lib/SdFat_NoArduino/examples/examplesV1/LowLatencyLogger/LowLatencyLogger.ino

@@ -1,655 +0,0 @@
-/**
- * This program logs data to a binary file.  Functions are included
- * to convert the binary file to a csv text file.
- *
- * Samples are logged at regular intervals.  The maximum logging rate
- * depends on the quality of your SD card and the time required to
- * read sensor data.  This example has been tested at 500 Hz with
- * good SD card on an Uno.  4000 HZ is possible on a Due.
- *
- * If your SD card has a long write latency, it may be necessary to use
- * slower sample rates.  Using a Mega Arduino helps overcome latency
- * problems since 12 512 byte buffers will be used.
- *
- * Data is written to the file using a SD multiple block write command.
- */
-#include <SPI.h>
-#include "SdFat.h"
-#include "FreeStack.h"
-#include "UserTypes.h"
-
-#ifdef __AVR_ATmega328P__
-#include "MinimumSerial.h"
-MinimumSerial MinSerial;
-#define Serial MinSerial
-#endif  // __AVR_ATmega328P__
-//==============================================================================
-// Start of configuration constants.
-//==============================================================================
-// Abort run on an overrun.  Data before the overrun will be saved.
-#define ABORT_ON_OVERRUN 1
-//------------------------------------------------------------------------------
-//Interval between data records in microseconds.
-const uint32_t LOG_INTERVAL_USEC = 2000;
-//------------------------------------------------------------------------------
-// Set USE_SHARED_SPI non-zero for use of an SPI sensor.
-// May not work for some cards.
-#ifndef USE_SHARED_SPI
-#define USE_SHARED_SPI 0
-#endif  // USE_SHARED_SPI
-//------------------------------------------------------------------------------
-// Pin definitions.
-//
-// SD chip select pin.
-const uint8_t SD_CS_PIN = SS;
-//
-// Digital pin to indicate an error, set to -1 if not used.
-// The led blinks for fatal errors. The led goes on solid for
-// overrun errors and logging continues unless ABORT_ON_OVERRUN
-// is non-zero.
-#ifdef ERROR_LED_PIN
-#undef ERROR_LED_PIN
-#endif  // ERROR_LED_PIN
-const int8_t ERROR_LED_PIN = -1;
-//------------------------------------------------------------------------------
-// File definitions.
-//
-// Maximum file size in blocks.
-// The program creates a contiguous file with FILE_BLOCK_COUNT 512 byte blocks.
-// This file is flash erased using special SD commands.  The file will be
-// truncated if logging is stopped early.
-const uint32_t FILE_BLOCK_COUNT = 256000;
-//
-// log file base name if not defined in UserTypes.h
-#ifndef FILE_BASE_NAME
-#define FILE_BASE_NAME "data"
-#endif  // FILE_BASE_NAME
-//------------------------------------------------------------------------------
-// Buffer definitions.
-//
-// The logger will use SdFat's buffer plus BUFFER_BLOCK_COUNT-1 additional
-// buffers.
-//
-#ifndef RAMEND
-// Assume ARM. Use total of ten 512 byte buffers.
-const uint8_t BUFFER_BLOCK_COUNT = 10;
-//
-#elif RAMEND < 0X8FF
-#error Too little SRAM
-//
-#elif RAMEND < 0X10FF
-// Use total of two 512 byte buffers.
-const uint8_t BUFFER_BLOCK_COUNT = 2;
-//
-#elif RAMEND < 0X20FF
-// Use total of four 512 byte buffers.
-const uint8_t BUFFER_BLOCK_COUNT = 4;
-//
-#else  // RAMEND
-// Use total of 12 512 byte buffers.
-const uint8_t BUFFER_BLOCK_COUNT = 12;
-#endif  // RAMEND
-//==============================================================================
-// End of configuration constants.
-//==============================================================================
-// Temporary log file.  Will be deleted if a reset or power failure occurs.
-#define TMP_FILE_NAME FILE_BASE_NAME "##.bin"
-
-// Size of file base name.
-const uint8_t BASE_NAME_SIZE = sizeof(FILE_BASE_NAME) - 1;
-const uint8_t FILE_NAME_DIM  = BASE_NAME_SIZE + 7;
-char binName[FILE_NAME_DIM] = FILE_BASE_NAME "00.bin";
-
-SdFat sd;
-
-SdBaseFile binFile;
-
-// Number of data records in a block.
-const uint16_t DATA_DIM = (512 - 4)/sizeof(data_t);
-
-//Compute fill so block size is 512 bytes.  FILL_DIM may be zero.
-const uint16_t FILL_DIM = 512 - 4 - DATA_DIM*sizeof(data_t);
-
-struct block_t {
-  uint16_t count;
-  uint16_t overrun;
-  data_t data[DATA_DIM];
-  uint8_t fill[FILL_DIM];
-};
-//==============================================================================
-// Error messages stored in flash.
-#define error(msg) {sd.errorPrint(&Serial, F(msg));fatalBlink();}
-//------------------------------------------------------------------------------
-//
-void fatalBlink() {
-  while (true) {
-    yield();
-    if (ERROR_LED_PIN >= 0) {
-      digitalWrite(ERROR_LED_PIN, HIGH);
-      delay(200);
-      digitalWrite(ERROR_LED_PIN, LOW);
-      delay(200);
-    }
-  }
-}
-//------------------------------------------------------------------------------
-// read data file and check for overruns
-void checkOverrun() {
-  bool headerPrinted = false;
-  block_t block;
-  uint32_t bn = 0;
-
-  if (!binFile.isOpen()) {
-    Serial.println();
-    Serial.println(F("No current binary file"));
-    return;
-  }
-  binFile.rewind();
-  Serial.println();
-  Serial.print(F("FreeStack: "));
-  Serial.println(FreeStack());
-  Serial.println(F("Checking overrun errors - type any character to stop"));
-  while (binFile.read(&block, 512) == 512) {
-    if (block.count == 0) {
-      break;
-    }
-    if (block.overrun) {
-      if (!headerPrinted) {
-        Serial.println();
-        Serial.println(F("Overruns:"));
-        Serial.println(F("fileBlockNumber,sdBlockNumber,overrunCount"));
-        headerPrinted = true;
-      }
-      Serial.print(bn);
-      Serial.print(',');
-      Serial.print(binFile.firstBlock() + bn);
-      Serial.print(',');
-      Serial.println(block.overrun);
-    }
-    bn++;
-  }
-  if (!headerPrinted) {
-    Serial.println(F("No errors found"));
-  } else {
-    Serial.println(F("Done"));
-  }
-}
-//-----------------------------------------------------------------------------
-// Convert binary file to csv file.
-void binaryToCsv() {
-  uint8_t lastPct = 0;
-  block_t block;
-  uint32_t t0 = millis();
-  uint32_t syncCluster = 0;
-  SdFile csvFile;
-  char csvName[FILE_NAME_DIM];
-
-  if (!binFile.isOpen()) {
-    Serial.println();
-    Serial.println(F("No current binary file"));
-    return;
-  }
-  Serial.println();
-  Serial.print(F("FreeStack: "));
-  Serial.println(FreeStack());
-
-  // Create a new csvFile.
-  strcpy(csvName, binName);
-  strcpy(&csvName[BASE_NAME_SIZE + 3], "csv");
-
-  if (!csvFile.open(csvName, O_WRONLY | O_CREAT | O_TRUNC)) {
-    error("open csvFile failed");
-  }
-  binFile.rewind();
-  Serial.print(F("Writing: "));
-  Serial.print(csvName);
-  Serial.println(F(" - type any character to stop"));
-  printHeader(&csvFile);
-  uint32_t tPct = millis();
-  while (!Serial.available() && binFile.read(&block, 512) == 512) {
-    uint16_t i;
-    if (block.count == 0 || block.count > DATA_DIM) {
-      break;
-    }
-    if (block.overrun) {
-      csvFile.print(F("OVERRUN,"));
-      csvFile.println(block.overrun);
-    }
-    for (i = 0; i < block.count; i++) {
-      printData(&csvFile, &block.data[i]);
-    }
-    if (csvFile.curCluster() != syncCluster) {
-      csvFile.sync();
-      syncCluster = csvFile.curCluster();
-    }
-    if ((millis() - tPct) > 1000) {
-      uint8_t pct = binFile.curPosition()/(binFile.fileSize()/100);
-      if (pct != lastPct) {
-        tPct = millis();
-        lastPct = pct;
-        Serial.print(pct, DEC);
-        Serial.println('%');
-      }
-    }
-    if (Serial.available()) {
-      break;
-    }
-  }
-  csvFile.close();
-  Serial.print(F("Done: "));
-  Serial.print(0.001*(millis() - t0));
-  Serial.println(F(" Seconds"));
-}
-//-----------------------------------------------------------------------------
-void createBinFile() {
-  // max number of blocks to erase per erase call
-  const uint32_t ERASE_SIZE = 262144L;
-  uint32_t bgnBlock, endBlock;
-
-  // Delete old tmp file.
-  if (sd.exists(TMP_FILE_NAME)) {
-    Serial.println(F("Deleting tmp file " TMP_FILE_NAME));
-    if (!sd.remove(TMP_FILE_NAME)) {
-      error("Can't remove tmp file");
-    }
-  }
-  // Create new file.
-  Serial.println(F("\nCreating new file"));
-  binFile.close();
-  if (!binFile.createContiguous(TMP_FILE_NAME, 512 * FILE_BLOCK_COUNT)) {
-    error("createContiguous failed");
-  }
-  // Get the address of the file on the SD.
-  if (!binFile.contiguousRange(&bgnBlock, &endBlock)) {
-    error("contiguousRange failed");
-  }
-  // Flash erase all data in the file.
-  Serial.println(F("Erasing all data"));
-  uint32_t bgnErase = bgnBlock;
-  uint32_t endErase;
-  while (bgnErase < endBlock) {
-    endErase = bgnErase + ERASE_SIZE;
-    if (endErase > endBlock) {
-      endErase = endBlock;
-    }
-    if (!sd.card()->erase(bgnErase, endErase)) {
-      error("erase failed");
-    }
-    bgnErase = endErase + 1;
-  }
-}
-//------------------------------------------------------------------------------
-// dump data file to Serial
-void dumpData() {
-  block_t block;
-  if (!binFile.isOpen()) {
-    Serial.println();
-    Serial.println(F("No current binary file"));
-    return;
-  }
-  binFile.rewind();
-  Serial.println();
-  Serial.println(F("Type any character to stop"));
-  delay(1000);
-  printHeader(&Serial);
-  while (!Serial.available() && binFile.read(&block , 512) == 512) {
-    if (block.count == 0) {
-      break;
-    }
-    if (block.overrun) {
-      Serial.print(F("OVERRUN,"));
-      Serial.println(block.overrun);
-    }
-    for (uint16_t i = 0; i < block.count; i++) {
-      printData(&Serial, &block.data[i]);
-    }
-  }
-  Serial.println(F("Done"));
-}
-//------------------------------------------------------------------------------
-// log data
-void logData() {
-  createBinFile();
-  recordBinFile();
-  renameBinFile();
-}
-//------------------------------------------------------------------------------
-void openBinFile() {
-  char name[FILE_NAME_DIM];
-  strcpy(name, binName);
-  Serial.println(F("\nEnter two digit version"));
-  Serial.write(name, BASE_NAME_SIZE);
-  for (int i = 0; i < 2; i++) {
-    while (!Serial.available()) {
-     yield();
-    }
-    char c = Serial.read();
-    Serial.write(c);
-    if (c < '0' || c > '9') {
-      Serial.println(F("\nInvalid digit"));
-      return;
-    }
-    name[BASE_NAME_SIZE + i] = c;
-  }
-  Serial.println(&name[BASE_NAME_SIZE+2]);
-  if (!sd.exists(name)) {
-    Serial.println(F("File does not exist"));
-    return;
-  }
-  binFile.close();
-  strcpy(binName, name);
-  if (!binFile.open(binName, O_RDONLY)) {
-    Serial.println(F("open failed"));
-    return;
-  }
-  Serial.println(F("File opened"));
-}
-//------------------------------------------------------------------------------
-void recordBinFile() {
-  const uint8_t QUEUE_DIM = BUFFER_BLOCK_COUNT + 1;
-  // Index of last queue location.
-  const uint8_t QUEUE_LAST = QUEUE_DIM - 1;
-
-  // Allocate extra buffer space.
-  block_t block[BUFFER_BLOCK_COUNT - 1];
-
-  block_t* curBlock = 0;
-
-  block_t* emptyStack[BUFFER_BLOCK_COUNT];
-  uint8_t emptyTop;
-  uint8_t minTop;
-
-  block_t* fullQueue[QUEUE_DIM];
-  uint8_t fullHead = 0;
-  uint8_t fullTail = 0;
-
-  // Use SdFat's internal buffer.
-  emptyStack[0] = (block_t*)sd.vol()->cacheClear();
-  if (emptyStack[0] == 0) {
-    error("cacheClear failed");
-  }
-  // Put rest of buffers on the empty stack.
-  for (int i = 1; i < BUFFER_BLOCK_COUNT; i++) {
-    emptyStack[i] = &block[i - 1];
-  }
-  emptyTop = BUFFER_BLOCK_COUNT;
-  minTop = BUFFER_BLOCK_COUNT;
-
-  // Start a multiple block write.
-  if (!sd.card()->writeStart(binFile.firstBlock())) {
-    error("writeStart failed");
-  }
-  Serial.print(F("FreeStack: "));
-  Serial.println(FreeStack());
-  Serial.println(F("Logging - type any character to stop"));
-  bool closeFile = false;
-  uint32_t bn = 0;
-  uint32_t maxLatency = 0;
-  uint32_t overrun = 0;
-  uint32_t overrunTotal = 0;
-  uint32_t logTime = micros();
-  while(1) {
-     // Time for next data record.
-    logTime += LOG_INTERVAL_USEC;
-    if (Serial.available()) {
-      closeFile = true;
-    }
-    if (closeFile) {
-      if (curBlock != 0) {
-        // Put buffer in full queue.
-        fullQueue[fullHead] = curBlock;
-        fullHead = fullHead < QUEUE_LAST ? fullHead + 1 : 0;
-        curBlock = 0;
-      }
-    } else {
-      if (curBlock == 0 && emptyTop != 0) {
-        curBlock = emptyStack[--emptyTop];
-        if (emptyTop < minTop) {
-          minTop = emptyTop;
-        }
-        curBlock->count = 0;
-        curBlock->overrun = overrun;
-        overrun = 0;
-      }
-      if ((int32_t)(logTime - micros()) < 0) {
-        error("Rate too fast");
-      }
-      int32_t delta;
-      do {
-        delta = micros() - logTime;
-      } while (delta < 0);
-      if (curBlock == 0) {
-        overrun++;
-        overrunTotal++;
-        if (ERROR_LED_PIN >= 0) {
-          digitalWrite(ERROR_LED_PIN, HIGH);
-        }
-#if ABORT_ON_OVERRUN
-        Serial.println(F("Overrun abort"));
-        break;
- #endif  // ABORT_ON_OVERRUN
-      } else {
-#if USE_SHARED_SPI
-        sd.card()->spiStop();
-#endif  // USE_SHARED_SPI
-        acquireData(&curBlock->data[curBlock->count++]);
-#if USE_SHARED_SPI
-        sd.card()->spiStart();
-#endif  // USE_SHARED_SPI
-        if (curBlock->count == DATA_DIM) {
-          fullQueue[fullHead] = curBlock;
-          fullHead = fullHead < QUEUE_LAST ? fullHead + 1 : 0;
-          curBlock = 0;
-        }
-      }
-    }
-    if (fullHead == fullTail) {
-      // Exit loop if done.
-      if (closeFile) {
-        break;
-      }
-    } else if (!sd.card()->isBusy()) {
-      // Get address of block to write.
-      block_t* pBlock = fullQueue[fullTail];
-      fullTail = fullTail < QUEUE_LAST ? fullTail + 1 : 0;
-      // Write block to SD.
-      uint32_t usec = micros();
-      if (!sd.card()->writeData((uint8_t*)pBlock)) {
-        error("write data failed");
-      }
-      usec = micros() - usec;
-      if (usec > maxLatency) {
-        maxLatency = usec;
-      }
-      // Move block to empty queue.
-      emptyStack[emptyTop++] = pBlock;
-      bn++;
-      if (bn == FILE_BLOCK_COUNT) {
-        // File full so stop
-        break;
-      }
-    }
-  }
-  if (!sd.card()->writeStop()) {
-    error("writeStop failed");
-  }
-  Serial.print(F("Min Free buffers: "));
-  Serial.println(minTop);
-  Serial.print(F("Max block write usec: "));
-  Serial.println(maxLatency);
-  Serial.print(F("Overruns: "));
-  Serial.println(overrunTotal);
-  // Truncate file if recording stopped early.
-  if (bn != FILE_BLOCK_COUNT) {
-    Serial.println(F("Truncating file"));
-    if (!binFile.truncate(512L * bn)) {
-      error("Can't truncate file");
-    }
-  }
-}
-//------------------------------------------------------------------------------
-void recoverTmpFile() {
-  uint16_t count;
-  if (!binFile.open(TMP_FILE_NAME, O_RDWR)) {
-    return;
-  }
-  if (binFile.read(&count, 2) != 2 || count != DATA_DIM) {
-    error("Please delete existing " TMP_FILE_NAME);
-  }
-  Serial.println(F("\nRecovering data in tmp file " TMP_FILE_NAME));
-  uint32_t bgnBlock = 0;
-  uint32_t endBlock = binFile.fileSize()/512 - 1;
-  // find last used block.
-  while (bgnBlock < endBlock) {
-    uint32_t midBlock = (bgnBlock + endBlock + 1)/2;
-    binFile.seekSet(512*midBlock);
-    if (binFile.read(&count, 2) != 2) error("read");
-    if (count == 0 || count > DATA_DIM) {
-      endBlock = midBlock - 1;
-    } else {
-      bgnBlock = midBlock;
-    }
-  }
-  // truncate after last used block.
-  if (!binFile.truncate(512*(bgnBlock + 1))) {
-    error("Truncate " TMP_FILE_NAME " failed");
-  }
-  renameBinFile();
-}
-//-----------------------------------------------------------------------------
-void renameBinFile() {
-  while (sd.exists(binName)) {
-    if (binName[BASE_NAME_SIZE + 1] != '9') {
-      binName[BASE_NAME_SIZE + 1]++;
-    } else {
-      binName[BASE_NAME_SIZE + 1] = '0';
-      if (binName[BASE_NAME_SIZE] == '9') {
-        error("Can't create file name");
-      }
-      binName[BASE_NAME_SIZE]++;
-    }
-  }
-  if (!binFile.rename(binName)) {
-    error("Can't rename file");
-    }
-  Serial.print(F("File renamed: "));
-  Serial.println(binName);
-  Serial.print(F("File size: "));
-  Serial.print(binFile.fileSize()/512);
-  Serial.println(F(" blocks"));
-}
-//------------------------------------------------------------------------------
-void testSensor() {
-  const uint32_t interval = 200000;
-  int32_t diff;
-  data_t data;
-  Serial.println(F("\nTesting - type any character to stop\n"));
-  // Wait for Serial Idle.
-  delay(1000);
-  printHeader(&Serial);
-  uint32_t m = micros();
-  while (!Serial.available()) {
-    m += interval;
-    do {
-      diff = m - micros();
-    } while (diff > 0);
-    acquireData(&data);
-    printData(&Serial, &data);
-  }
-}
-//------------------------------------------------------------------------------
-void setup(void) {
-  if (ERROR_LED_PIN >= 0) {
-    pinMode(ERROR_LED_PIN, OUTPUT);
-  }
-  Serial.begin(9600);
-
-  // Wait for USB Serial
-  while (!Serial) {
-    yield();
-  }
-  Serial.print(F("\nFreeStack: "));
-  Serial.println(FreeStack());
-  Serial.print(F("Records/block: "));
-  Serial.println(DATA_DIM);
-  if (sizeof(block_t) != 512) {
-    error("Invalid block size");
-  }
-  // Allow userSetup access to SPI bus.
-  pinMode(SD_CS_PIN, OUTPUT);
-  digitalWrite(SD_CS_PIN, HIGH);
-
-  // Setup sensors.
-  userSetup();
-
-  // Initialize at the highest speed supported by the board that is
-  // not over 50 MHz. Try a lower speed if SPI errors occur.
-  if (!sd.begin(SD_CS_PIN, SD_SCK_MHZ(50))) {
-    sd.initErrorPrint(&Serial);
-    fatalBlink();
-  }
-  // recover existing tmp file.
-  if (sd.exists(TMP_FILE_NAME)) {
-    Serial.println(F("\nType 'Y' to recover existing tmp file " TMP_FILE_NAME));
-    while (!Serial.available()) {
-      yield();
-    }
-    if (Serial.read() == 'Y') {
-      recoverTmpFile();
-    } else {
-      error("'Y' not typed, please manually delete " TMP_FILE_NAME);
-    }
-  }
-}
-//------------------------------------------------------------------------------
-void loop(void) {
-  // Read any Serial data.
-  do {
-    delay(10);
-  } while (Serial.available() && Serial.read() >= 0);
-  Serial.println();
-  Serial.println(F("type:"));
-  Serial.println(F("b - open existing bin file"));
-  Serial.println(F("c - convert file to csv"));
-  Serial.println(F("d - dump data to Serial"));
-  Serial.println(F("e - overrun error details"));
-  Serial.println(F("l - list files"));
-  Serial.println(F("r - record data"));
-  Serial.println(F("t - test without logging"));
-  while(!Serial.available()) {
-    yield();
-  }
-#if WDT_YIELD_TIME_MICROS
-  Serial.println(F("LowLatencyLogger can not run with watchdog timer"));
-  while (true) {}
-#endif
-
-  char c = tolower(Serial.read());
-
-  // Discard extra Serial data.
-  do {
-    delay(10);
-  } while (Serial.available() && Serial.read() >= 0);
-
-  if (ERROR_LED_PIN >= 0) {
-    digitalWrite(ERROR_LED_PIN, LOW);
-  }
-  if (c == 'b') {
-    openBinFile();
-  } else if (c == 'c') {
-    binaryToCsv();
-  } else if (c == 'd') {
-    dumpData();
-  } else if (c == 'e') {
-    checkOverrun();
-  } else if (c == 'l') {
-    Serial.println(F("\nls:"));
-    sd.ls(&Serial, LS_SIZE);
-  } else if (c == 'r') {
-    logData();
-  } else if (c == 't') {
-    testSensor();
-  } else {
-    Serial.println(F("Invalid entry"));
-  }
-}