Watchy icon indicating copy to clipboard operation
Watchy copied to clipboard

Need documentation on how to compile the whole library

Open marmat8951 opened this issue 3 years ago • 8 comments

Hi sqfmi team,

This project needs a documentation on how to compile the whole library so we can test changes on it and not only changes on faces or new elements. Currently the only setup provided use the already compiled on with t;he Arduino IDE, but it would be great to be able to change code inside the library as well, instead of only on faces files.

Thanks for the great work you are doing here. I'm still loving my Watchy. <3

marmat8951 avatar May 30 '21 19:05 marmat8951

I'd also appreciate some documentation. I can open the watchface examples with the Arduino IDE, but there's no .ino file for the library and the Arduino IDE can only open ino files, so I can't change basic things like the weather location

elad661 avatar Jun 13 '21 10:06 elad661

I believe you could override any constants that are defined or methods and write your own just like the drawWatchFace() method?

Storms-Engineering avatar Jun 22 '21 21:06 Storms-Engineering

I believe you could override any constants that are defined or methods and write your own just like the drawWatchFace() method?

@Storms-Engineering I tried that to connect to wifi (since without wifi setting the weather location won't really do much) but it didn't work. Do you know how to connect the thing to wifi? I've been looking for information about that for a, well, couple of days (:

sterlingphoenix avatar Jul 29 '21 21:07 sterlingphoenix

I believe you could override any constants that are defined or methods and write your own just like the drawWatchFace() method?

@Storms-Engineering I tried that to connect to wifi (since without wifi setting the weather location won't really do much) but it didn't work. Do you know how to connect the thing to wifi? I've been looking for information about that for a, well, couple of days (:

So I ended up copying the entire source code and changing what I wanted and not extending any of watchys classes. To connect wifi you could probably find that info in discord: https://discord.gg/ZXDegGV8E7

There is a ton of information on discord, you can search through messages and try and find what you need. It is pretty active too.

Storms-Engineering avatar Jul 29 '21 21:07 Storms-Engineering

@Storms-Engineering after spending a few days on discord... it's just not a useful resource for me. It's incredibly busy, impossible to search for (since terms like "wifi" and "location" are going to pop up a lot), and nearly impossible to get responses to questions.

This project needs much better documentation. Changing stuff like your location should be straightforward, and if this requires rebuilding the library then that too should be documented somewhere (or at least linked to).

sterlingphoenix avatar Aug 01 '21 11:08 sterlingphoenix

@sterlingphoenix Hmmmm. Yea I could understand that. I have an INO file that I setup here https://github.com/Storms-Engineering/Watchy/tree/master/src/Storms. I will look and see if there is a place the community can contribute to documentation. If you want to setup your own .ino file, I just created a new sketch in arduino and save it in the watchy /src folder. Then I added all of the files in that folder to my sketch. (I don't know if that was necessary or not? But it worked shrug.)

To change your location for weather look for the CITY_NAME constant in config.h. There is some other stuff like country, and temp units. Good luck!

Edit:

There is a place where you can contribute to the watchy docs: https://github.com/sqfmi/watchy-docs If you get where you want to go, maybe you could document it and do a pull request there. I might submit one for how to compile the whole source code. (Though now thinking about it I think it does when you use one of the example watch faces, but IDK for sure)

Storms-Engineering avatar Aug 01 '21 15:08 Storms-Engineering

I'll try that. I have already downloaded the entire github repo and did change the location (and other things) in config.h, but when I build/upload a watch face that seems to not get included. I see others with that issue.

In the meantime I managed to break the screen, so I'll probably not try this till the replacements get here...

sterlingphoenix avatar Aug 02 '21 18:08 sterlingphoenix

What I did (paths are specific to my Mac):

  1. Uninstall the Watchy library using the Library Manager.
  2. cd into my Arduino work directory (/Users/lyndon/Documents/Arduino).
  3. cd into the 'libraries' subdirectory.
  4. git clone [email protected]/user/Watchy

The Arduino IDE should now find the Watchy library in its search path. It will automatically build the library components if they are missing or out of date.

Now you should be able to hack on the Watchy library source; it will rebuild any out of date files on the fly. Note that you won't be able to edit the library source using the Arduino IDE -- you'll have to use an external editor. That's not a problem for me since I do most of my editing outside of the Arduino app anyway.

rastagraffix avatar Jan 05 '22 08:01 rastagraffix