modem-works / terra

GNU General Public License v3.0
520 stars 22 forks source link

Details missing from setup instructions #2

Open therealmoss opened 7 months ago

therealmoss commented 7 months ago

Hello, I've been enjoying starting to build my own terra device.

Below are some details missing from the readme that I think are extremely important to add to help people get going without too much friction.


  1. Install correct board drivers if using Mac / PC I was unable to connect to my Feather32 until I had installed the correct drivers as detailed here in the Adafruit documentation. . I think it would be wise to add this into the 'Setup steps' section of the readme.

  2. Adjust User_Setup.h file for TFT_eSPI library This one really caused me a lot of headaches. I spent many hours trying to figure out how to get the display to run (I've only lightly dabbled in this sort of prototyping before)!!! Finally, I stumbled across this video, which explains how you must edit the User_Setup.h file in the display driver library. This finally got the display up and running for me. Here is my own edited version of the file with the correct code changes to make the display run. Perhaps this could be included in the repo files, along with adding explicit instructions on doing this into the 'Install Libraries' step in the Arduino Code section?

  3. Add haptic motor to parts list You include the breakout in the parts list, but not the motor, as listed in the Assembly Guide PDF. I didn't purchase this initially, so this would be helpful to add, along with a link to an example part.

WannabeSpaceman commented 5 months ago

I'm very glad you opened up this issue, because I'd been banging my head against a wall regarding the TFT_eSPI config issue for days now!

While the assembly instructions make sense once you've got the hardware in front of you, the setup steps could do with a lil more work

therealmoss commented 5 months ago

I'm glad it was helpful @WannabeSpaceman !