qmk-keychron-q3-colemak-dh/lib/usbhost/USB_Host_Shield_2.0/examples/testusbhostFAT/README.md

This small sketch tests the USB host shield mass storage library.

__Note:__ This will not run a Arduino Uno due to the limited ram available in the ATmega328p.

The Arduino Mega (ATmega1280) and the Arduino Mega 2560 (ATmega2560) are confirmed to work with this test code.

To compile this example you will need the following libraries as well:

* [xmem2](https://github.com/xxxajk/xmem2)
* [generic_storage FATfs](https://github.com/xxxajk/generic_storage)
* [RTClib](https://github.com/xxxajk/RTClib)

The following shield is recommended for larger projects: <https://www.rugged-circuits.com/new-products/quadram>.

You may use the bundled [Makefile](Makefile) to compile the code instead of the Arduino IDE if you have problems or want a smaller binary. The master makefile is bundled as a submodule, but can also be downloaded manually at the following link: <https://github.com/xxxajk/Arduino_Makefile_master>.

To download the USB Host library and all the needed libraries for this test.

Run the following command in a terminal application:

```
git clone --recursive https://github.com/felis/USB_Host_Shield_2.0
```

If you want to update all the submodules run:

```
git submodule foreach --recursive git pull origin master
```
Squashed 'tmk_core/' changes from caca2c0..dc0e46e dc0e46e Rename LUFA to LUFA-git 3bfa7fa Remove LUFA-120730 215b764 Merge commit 'afa0f22a9299686fd88f58ce09c5b521ac917e8f' as 'protocol/lufa/LUFA' afa0f22 Squashed 'protocol/lufa/LUFA/' content from commit def7fca c0c42fa Remove submodule of LUFA 30f897d Merge commit '87ced33feb74e79c3281dda36eb6d6d153399b41' as 'protocol/usb_hid/USB_Host_Shield_2.0' 87ced33 Squashed 'protocol/usb_hid/USB_Host_Shield_2.0/' content from commit aab4a69 14f6d49 Remove submodule of USB_Host_Shield_2.0 git-subtree-dir: tmk_core git-subtree-split: dc0e46eaa4367d4e218f8816e3c117895820f07c 2015-05-13 04:13:10 +02:00			`This small sketch tests the USB host shield mass storage library.`

			`__Note:__ This will not run a Arduino Uno due to the limited ram available in the ATmega328p.`

			`The Arduino Mega (ATmega1280) and the Arduino Mega 2560 (ATmega2560) are confirmed to work with this test code.`

			`To compile this example you will need the following libraries as well:`

			`* [xmem2](https://github.com/xxxajk/xmem2)`
			`* [generic_storage FATfs](https://github.com/xxxajk/generic_storage)`
			`* [RTClib](https://github.com/xxxajk/RTClib)`

Fixed dead links (#2451) * Fixed typo of 'confid.h' to 'config.h' * Fixed broken links in docs * Fixed a lot of dead links 2018-03-01 16:45:47 +01:00			`The following shield is recommended for larger projects: <https://www.rugged-circuits.com/new-products/quadram>.`
Squashed 'tmk_core/' changes from caca2c0..dc0e46e dc0e46e Rename LUFA to LUFA-git 3bfa7fa Remove LUFA-120730 215b764 Merge commit 'afa0f22a9299686fd88f58ce09c5b521ac917e8f' as 'protocol/lufa/LUFA' afa0f22 Squashed 'protocol/lufa/LUFA/' content from commit def7fca c0c42fa Remove submodule of LUFA 30f897d Merge commit '87ced33feb74e79c3281dda36eb6d6d153399b41' as 'protocol/usb_hid/USB_Host_Shield_2.0' 87ced33 Squashed 'protocol/usb_hid/USB_Host_Shield_2.0/' content from commit aab4a69 14f6d49 Remove submodule of USB_Host_Shield_2.0 git-subtree-dir: tmk_core git-subtree-split: dc0e46eaa4367d4e218f8816e3c117895820f07c 2015-05-13 04:13:10 +02:00
			`You may use the bundled [Makefile](Makefile) to compile the code instead of the Arduino IDE if you have problems or want a smaller binary. The master makefile is bundled as a submodule, but can also be downloaded manually at the following link: <https://github.com/xxxajk/Arduino_Makefile_master>.`

			`To download the USB Host library and all the needed libraries for this test.`

			`Run the following command in a terminal application:`

			```
			`git clone --recursive https://github.com/felis/USB_Host_Shield_2.0`
			```

			`If you want to update all the submodules run:`

			```
			`git submodule foreach --recursive git pull origin master`
			```