Difference between revisions of "User:JF/Getting-started-draft"

From PINE64
Jump to navigation Jump to search
m (Fxc moved page Getting-started-draft to User:JF/Getting-started-draft: User draft article)
 
(5 intermediate revisions by 4 users not shown)
Line 3: Line 3:
'''Dear Pinetimer,'''
'''Dear Pinetimer,'''


Congratulations on your new Pinetime devkit.  
Congratulations on your new smartwatch devkit.  


'''Getting started:'''
'''Getting started:'''


This devkit is running InfiniTime, one of the many open source firmware available for the PineTime. Like many other, this project is still under development, but already provide basic functionalities like time synchronization with your phone, firmware upgrade via BLE (OTA) and support from companion applications like Gadgetbridge on Android and Amazfish on SailfishOS. You can learn more about InfiniTime on the website of the project (https://infinitime.io/) or its Github repository (https://github.com/JF002/Pinetime).
This devkit is running InfiniTime, one of many open source firmwares available for the PineTime. Like many others, this project is still under development, but already provides functionalities such as time synchronization with your phone, over-the-air (OTA) firmware upgrades and support from companion applications like Gadgetbridge on Android and Amazfish on SailfishOS. You can learn more about InfiniTime on the website of the project (https://infinitime.io/) or its Github repository (https://github.com/JF002/Pinetime).


The OTA functionality allows you to install new versions of InfiniTime, or even other compatible firmwares like Hypnos (https://github.com/endian-albin/pinetime-hypnos) and Klok (https://gitlab.com/caspermeijn/klok).
The OTA upgrade functionality allows you to install new versions of InfiniTime, or even other compatible firmwares like Hypnos (https://github.com/endian-albin/pinetime-hypnos) and Klok (https://gitlab.com/caspermeijn/klok).


Please note that it is still recommended to have an SWD debugger on hands in case the OTA fails or if you need to install a new version of the bootloader.
Please note that it is still recommended to have an SWD debugger at hand in case the OTA upgrade fails or if you need to install a new version of the bootloader.


There are many other projects under development. The complete list, with many more informations (technical informations, FAQ, howtos,...) is available on the Pine64 Wiki (https://wiki.pine64.org/).
There are many other projects under development. The complete list, containing much more information (technical details, FAQ, howtos...), is available on the Pine64 Wiki (https://wiki.pine64.org/).


'''You are a developer?'''
'''Are you are a developer?'''


Welcome to the community! You can choose to contribute to an existing project, or start yours from scratch. All you need is an SWD debugger (ST-LinkV2, J-Link, OpenOCD probe,...) and some programming knowledge.
Welcome to the community! You can choose to contribute to an existing project, or start yours from scratch. All you need is an SWD debugger (ST-LinkV2, J-Link, OpenOCD probe,...) and some programming knowledge.
Line 21: Line 21:
'''Is it possible to contribute without programming knowledge?'''
'''Is it possible to contribute without programming knowledge?'''


Yes, of course! You can join the community, test the firmwares and their new features, report bugs, write documentation and articles about the Pinetime,...
Yes, of course! You can join the community, test the new firmware versions and their features, report bugs, write documentation and/or articles about Pinetime...


'''Links:'''
'''Links:'''
* Wiki: [https://wiki.pine64.org/index.php?title=PineTime]
* Wiki: [https://wiki.pine64.org/index.php?title=PineTime https://wiki.pine64.org/index.php?title=PineTime]
* Forum: [https://forum.pine64.org/forumdisplay.php?fid=134]
* Forum: [https://forum.pine64.org/forumdisplay.php?fid=134 https://forum.pine64.org/forumdisplay.php?fid=134]
* Chat rooms:  
* Chat rooms:  
** [https://app.element.io/#/room/#pinetime:matrix.org Matrix Channel] (No login required to read)
** [https://app.element.io/#/room/#pinetime:matrix.org Matrix] (No login required to read)
** IRC Server: [ircs://irc.pine64.org#pinetime irc.pine64.org] Channel: PineTime
** [ircs://irc.pine64.org#pinetime IRC irc.pine64.org] channel: #pinetime
** [https://t.me/pinetime Telegram group]
** [https://t.me/pinetime Telegram]
** [https://discordapp.com/invite/DgB7kzr Discord server invite link]
** [https://discordapp.com/invite/DgB7kzr Discord]


* A cool article from Lup
* A cool article from Lup
Line 38: Line 38:


----
----
== Another (simpler) draft from JF ==
NOTE : this is a much simple version of the guide. It is intended to be printed on a small piece of paper that'll ship in the box of the devkit. It redirects the user to the wiki, so we should write a new wiki page that contains more info and links, and ensure this new page is well visible from the front page of the wiki
'''Quick start guide'''
1. Learn more about the PineTime and available firmware on the Wiki from Pine64 (https://wiki.pine64.org/index.php?title=PineTime)
    << Add A QR Code to the wiki >>
2. Connect your SWD debugger
    << Add simple schema / picture >>
3. Contribute to existing projects or create your own
4. Join the community of developers
5. Have fun


== Another draft ==
== Another draft ==
TODO
TODO

Latest revision as of 09:51, 1 February 2023

Draft from JF

Dear Pinetimer,

Congratulations on your new smartwatch devkit.

Getting started:

This devkit is running InfiniTime, one of many open source firmwares available for the PineTime. Like many others, this project is still under development, but already provides functionalities such as time synchronization with your phone, over-the-air (OTA) firmware upgrades and support from companion applications like Gadgetbridge on Android and Amazfish on SailfishOS. You can learn more about InfiniTime on the website of the project (https://infinitime.io/) or its Github repository (https://github.com/JF002/Pinetime).

The OTA upgrade functionality allows you to install new versions of InfiniTime, or even other compatible firmwares like Hypnos (https://github.com/endian-albin/pinetime-hypnos) and Klok (https://gitlab.com/caspermeijn/klok).

Please note that it is still recommended to have an SWD debugger at hand in case the OTA upgrade fails or if you need to install a new version of the bootloader.

There are many other projects under development. The complete list, containing much more information (technical details, FAQ, howtos...), is available on the Pine64 Wiki (https://wiki.pine64.org/).

Are you are a developer?

Welcome to the community! You can choose to contribute to an existing project, or start yours from scratch. All you need is an SWD debugger (ST-LinkV2, J-Link, OpenOCD probe,...) and some programming knowledge.

Is it possible to contribute without programming knowledge?

Yes, of course! You can join the community, test the new firmware versions and their features, report bugs, write documentation and/or articles about Pinetime...

Links:

  • A cool article from Lup
  • Another super article from Lup
  • I think Lup wrote another amazing article
  • ...

Another (simpler) draft from JF

NOTE : this is a much simple version of the guide. It is intended to be printed on a small piece of paper that'll ship in the box of the devkit. It redirects the user to the wiki, so we should write a new wiki page that contains more info and links, and ensure this new page is well visible from the front page of the wiki


Quick start guide

1. Learn more about the PineTime and available firmware on the Wiki from Pine64 (https://wiki.pine64.org/index.php?title=PineTime)

   << Add A QR Code to the wiki >>

2. Connect your SWD debugger

   << Add simple schema / picture >>

3. Contribute to existing projects or create your own

4. Join the community of developers

5. Have fun


Another draft

TODO