New Watchy user? - Szybet/InkWatchy GitHub Wiki

You just received your watchy?

Great! Welcome to the community

First, you should identify your device: https://github.com/Szybet/InkWatchy/wiki/Identify-the-device

Then learn how to reset it (The bar on the right has a page for all watchy versions)

Now you should learn about your watchy here: https://github.com/Szybet/WatchySourcingHub

If you are a watchy v3 user, you should also be interested in the review in the link above too

Now, some key points:

  • Use a modern, mantained firmware. I suggest InkWatchy (Subjective!)(You are now on the wiki of it!) or Watchy GSR. Others will not work, not even compile and barely anyone will help you, so no, use those 2 firmwares.
  • Don't use Arduino IDE, ever. Only platformio, why?
    • Arduino IDE uses outdated tooling. Compiling, flashing will be faster on platformio and their build system, most of the time
    • In arduino IDE you need to select the proper platform, cpu etc. In platformio the developer manages that for you, limiting that you have done something wrong
    • A proper platformio setup will download exactly the version dependencies that the developer used at the time of writing the software, while arduino will at default download the latest ones, once again forcing the user to choose
    • And many other issues watchy users had that were mysteriously fixed by switching to platformio...
  • Here is the community driven *Atchy server, feel free to ask questions there: https://discord.gg/6PUmRXZRGD ;)

Apart from this wiki, here are some more resources about the watchy: https://github.com/Szybet/WatchySourcingHub

Longer explanation for the firmwares

Most other firmwares are based on the default firmware which has many issues:

  • It's not mantained, SQFMI doesn't develop it further, some of it's features are still from the watchy v1 era, that shouldn't be used in watchy v3 era (like syncing time so often). Just look at the repo, many not closed issues and pull requests, still only arduino ide support etc.
  • It's code is bad, like chaos, no structure, it's blocking on major operations (wifi, bluetooth). Uses basic operations, no interrupts for example
  • For many people it won't even compile easily
  • No one uses it, no one helps with it. Everyone uses watchy gsr at this point
  • Documentation for it is lacking