Details missing from setup instructions

[therealmoss]

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]

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]

I'm glad it was helpful @WannabeSpaceman !

[phoebeeluo]

@therealmoss Hey there!
I tinker in my free time and decided to finally give building this a go after following it for so long - thanks for all the work you've done so far and sharing it on GitHub! I'm currently in the purchasing materials stage, and I think I have everything (as you've pointed out, things are missing) but I am unsure of what 12. USB C Male/Female breakouts on the assembly guide are. I have been trying to figure out if its a specific board (found some adafruit ones, but only female boards - feels off to be looking for a male one?) or if its more like an adapter. Any insight/links?

One other thing - currently sourcing a battery as the circular battery listed isn't available in my country. I found a rectangular battery of similar specs/capacity (1050 mAH) with dimensions: 51.80 x 32.85 x 5.40mm. From what I've seen online, this should be smaller than the battery listed, just wondering if you had insight on if there would be any issues at the assembly stage with a battery like this. From the CAD of the shell it might be fine but definitely difficult to gauge based on the photos!

Thanks!!

[sebastiantcook-beep]

hey, i'm currently building my own Terra compass and I was wondering if you ended up making your own? Interested to see if yours is working fine

[therealmoss]

Hello – I never got it fully working, only partly.

Not something I've had the time to commit to in the last few months unfortunately, but might well pick it up again in the future. Sorry I can't be more helpful.