Skip to content

Commit a3dbcd6

Browse files
Documentation improvements (#2091)
Add documentation about watch faces and applications. Update getting started documentation. Co-authored-by: tituscmd <154823939+tituscmd@users.noreply.github.com>
1 parent 4fddf93 commit a3dbcd6

33 files changed

+150
-12
lines changed

README.md

+3-1
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,8 @@ Fast open-source firmware for the [PineTime smartwatch](https://pine64.org/devic
99
- [Getting started with InfiniTime](doc/gettingStarted/gettingStarted-1.0.md)
1010
- [Updating the software](doc/gettingStarted/updating-software.md)
1111
- [About the firmware and bootloader](doc/gettingStarted/about-software.md)
12+
- [Available apps](doc/gettingStarted/Applications.md)
13+
- [Available watch faces](/doc/gettingStarted/Watchfaces.md)
1214
- [PineTimeStyle Watch face](https://pine64.org/documentation/PineTime/Watchfaces/PineTimeStyle)
1315
- [Weather integration](https://pine64.org/documentation/PineTime/Software/InfiniTime_weather/)
1416

@@ -35,7 +37,7 @@ Fast open-source firmware for the [PineTime smartwatch](https://pine64.org/devic
3537

3638
### Contributing
3739

38-
- [How to contribute?](CONTRIBUTING.md)
40+
- [How to contribute](CONTRIBUTING.md)
3941
- [Coding conventions](doc/coding-convention.md)
4042

4143
### Build, flash and debug

doc/gettingStarted/Applications.md

+99
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
# Applications
2+
3+
InfiniTime has 13 apps on the `main` branch at the time of writing.
4+
5+
## List of apps
6+
- Stopwatch
7+
- Alarm
8+
- Timer
9+
- Steps
10+
- Heartrate
11+
- Music
12+
- InfiniPaint
13+
- Paddle
14+
- 2
15+
- InfiniDice
16+
- Metronome
17+
- Maps
18+
- Weather
19+
20+
### Stopwatch
21+
![Stopwatch UI](/doc/gettingStarted/AppsScreenshots/stopwatch.png)
22+
- Press the Start button (bottom right) to start or stop the timer.
23+
- You can also press the side button while the timer is running to pause the timer.
24+
- Press the Flag button (bottom left) to add a lap.
25+
- The stopwatch will not yet continue counting time while the app is closed.
26+
27+
### Alarm
28+
![Alarm UI](/doc/gettingStarted/AppsScreenshots/alarm.png)
29+
- Ajust the time with the time picker.
30+
- Press the Info button in the top middle to see time remaning.
31+
- Use the toggle in the bottom left to turn the alarm on/off.
32+
- Use the button in the bottom right to change the alarm frequency.
33+
- You can choose between once, daily, or Monday - Friday.
34+
35+
### Timer
36+
![Timer UI](/doc/gettingStarted/AppsScreenshots/timer.png)
37+
- Ajust how long the timer should go for with the time picker.
38+
- Press the Start button at the bottom to start/stop the timer.
39+
40+
### Steps
41+
![Steps UI](/doc/gettingStarted/AppsScreenshots/steps.png)
42+
- The total count of steps for the current display will show in the middle of the screen.
43+
- The Reset button in the bottom middle resets the Trip counter. (Total of all steps taken.)
44+
- The progress circle shows the percentage of your daily goal completed.
45+
46+
### Heartrate
47+
![Heartrate UI](/doc/gettingStarted/AppsScreenshots/Heartrate.png)
48+
- Press Start to start measuring your heartrate.
49+
- It may take a bit to get the first measurement.
50+
51+
### Music
52+
![Music UI](/doc/gettingStarted/AppsScreenshots/Music.png)
53+
- This app shows currently playing music.
54+
- Please note that this app is not very useful without a device connected.
55+
- Press the button in the center to play/pause, and the buttons on the left and right to go to the previous and next tracks, respectively.
56+
- Swipe up to get to volume controls.
57+
58+
### InfiniPaint
59+
![InfiniPaint UI](/doc/gettingStarted/AppsScreenshots/Paint.png)
60+
- This app does not allow you to swipe from the top to exit, use the side button instead.
61+
- Draw on the screen to add lines.
62+
- Hold down in one spot to change paint colors.
63+
64+
### Paddle
65+
![Paddle UI](/doc/gettingStarted/AppsScreenshots/Pong.png)
66+
- This app does not allow you to swipe from the top to exit, use the side button instead.
67+
- Drag your finger to move the paddle.
68+
- Goal: Don't let the ball go off the left side of the screen.
69+
70+
### 2
71+
![2 UI](/doc/gettingStarted/AppsScreenshots/2048.png)
72+
- This app does not allow you to swipe from the top to exit, use the side button instead.
73+
- Play a game of 2048.
74+
- Swipe up, down, left, or right tomove the tiles.
75+
- When two tiles with the same number run into each other, they will add together.
76+
- Goal: Don't let the screen fill up with tiles, and get to the 2048 tile to win.
77+
78+
### InfiniDice
79+
![InfiniDice UI](/doc/gettingStarted/AppsScreenshots/Dice.png)
80+
- Ajust the count to change the number of dice.
81+
- Ajust the sides to change the number of sides.
82+
- Press the button at the bottom to roll.
83+
- The result will be on the right side of the screen.
84+
85+
### Metronome
86+
![Metronome UI](/doc/gettingStarted/AppsScreenshots/Metronome.png)
87+
- Ajust the BPM with the circular slider.
88+
- A bug currently makes it always snap to 98 BPM.
89+
- Use the button in the bottom left to start the metronome.
90+
91+
### Maps
92+
![Maps UI](/doc/gettingStarted/AppsScreenshots/Maps.png)
93+
- This app shows info from a navigation app.
94+
- Please note that this app is not very useful without a device connected.
95+
96+
### Weather
97+
![Weather UI](/doc/gettingStarted/AppsScreenshots/Weather.png)
98+
- This app shows weather info.
99+
- Please note that this app is not very useful without a device connected.
4.43 KB
Loading
4.59 KB
Loading
4.27 KB
Loading
3.19 KB
Loading
8.83 KB
Loading
6.13 KB
Loading
3.06 KB
Loading
2.92 KB
Loading
2.57 KB
Loading
4.95 KB
Loading
6.83 KB
Loading
2.87 KB
Loading
3.45 KB
Loading

doc/gettingStarted/Watchfaces.md

+31
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Watchfaces
2+
3+
InfiniTime has 6 apps on the `main` branch at the time of writing.
4+
5+
## List of apps
6+
- Digital
7+
- Analog
8+
- PineTimeStyle
9+
- Terminal
10+
- Infinineat
11+
- Casio G7710
12+
13+
### Digital
14+
![Digital face](/doc/gettingStarted/Watchfaces/Digital.png)
15+
16+
### Analog
17+
![Analog face](/doc/gettingStarted/Watchfaces/Analog.png)
18+
19+
### PineTimeStyle
20+
![PineTimeStyle face](/doc/gettingStarted/Watchfaces/PineTimeStyle.png)
21+
- You can long-press on the display to change colors, step style, and weather.
22+
23+
### Terminal
24+
![Terminal face](/doc/gettingStarted/Watchfaces/Terminal.png)
25+
26+
### Infinineat
27+
![Infinineat face](/doc/gettingStarted/Watchfaces/Infinineat.png)
28+
- You can long-press on the display to change colors.
29+
30+
### Casio G7710
31+
![Casio G7710 face](/doc/gettingStarted/Watchfaces/CasioG7710.png)
4.6 KB
Loading
6.38 KB
Loading
4.77 KB
Loading
8.85 KB
Loading
6.39 KB
Loading
6.04 KB
Loading

doc/gettingStarted/gadgetbridge0.jpg

89.7 KB
Loading

doc/gettingStarted/gadgetbridge1.jpg

44.6 KB
Loading

doc/gettingStarted/gadgetbridge2.jpg

75 KB
Loading

doc/gettingStarted/gadgetbridge3.jpg

61.8 KB
Loading

doc/gettingStarted/gadgetbridge4.jpg

94 KB
Loading

doc/gettingStarted/gadgetbridge5.jpg

223 KB
Loading

doc/gettingStarted/gettingStarted-1.0.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ You can sync the time using companion apps.
1414

1515
- Gadgetbridge automatically synchronizes the time when you connect it to your watch. More information on Gadgetbridge [here](/doc/gettingStarted/ota-gadgetbridge.md)
1616
- [Sync the time with NRFConnect](/doc/gettingStarted/time-nrfconnect.md)
17-
- Sync the time with your browser https://hubmartin.github.io/WebBLEWatch/
17+
- [Sync the time with your browser](https://hubmartin.github.io/WebBLEWatch/)
1818

1919
You can also set the time in the settings without a companion app. (version >1.7.0)
2020

@@ -46,7 +46,7 @@ On the bottom right, you can see how many steps you have taken today.
4646
![Settings](ui/settings.jpg)
4747

4848
- Swipe **up** to display the application menus. Apps (stopwatch, music, step, games,...) can be started from this menu.
49-
- Swipe **down** to display the notification panel. Notification sent by your companion app will be displayed here.
49+
- Swipe **down** to display the notification panel. Notifications sent by your companion app will be displayed here.
5050
- Swipe **right** to display the Quick Actions menu. This menu allows you to
5151
- Set the brightness of the display
5252
- Start the **flashlight** app
+13-7
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,35 @@
11
# Connecting to Gadgetbridge
22

3-
Launch Gadgetbridge and tap on the **"+"** button on the bottom right to add a new device:
3+
Launch Gadgetbridge and tap on the menu button in the top left:
44

55
![Gadgetbridge 0](gadgetbridge0.jpg)
66

7-
Wait for the scan to complete, your PineTime should be detected:
7+
Press the "Connect new device" button:
88

99
![Gadgetbridge 1](gadgetbridge1.jpg)
1010

11+
Your PineTime should appear on the list. Tap on it.
12+
1113
Tap on it. Gadgdetbridge will pair and connect to your device:
1214

1315
![Gadgetbridge 2](gadgetbridge2.jpg)
1416

1517
# Updating with Gadgetbridge
1618

17-
Now that Gadgetbridge is connected to your PineTime, use a file browser application and find the DFU file (`pinetime-mcuboot-app-dfu-x.x.x.zip`) you downloaded previously. Tap on it and open it using the Gadgetbridge application/firmware installer:
19+
Now that Gadgetbridge is connected to your PineTime, press the three dots on the device card:
1820

1921
![Gadgetbridge 3](gadgetbridge3.jpg)
2022

21-
Read the warning carefully and tap **Install**:
23+
Now press the "File Installer" button:
2224

2325
![Gadgetbridge 4](gadgetbridge4.jpg)
2426

25-
Wait for the transfer to finish. Your PineTime should reset and reboot with the new version of InfiniTime!
26-
27-
Don't forget to **validate** your firmware. In the InfiniTime go to the settings (swipe right, select gear icon) and Firmware option and click **validate**. Otherwise after reboot the previous firmware will be used.
27+
Select the firmware you downloaded (`pinetime-mcuboot-app-dfu-x.x.x.zip`) from the [Releases tab](https://github.com/InfiniTimeOrg/InfiniTime/releases/latest):
2828

2929
![Gadgetbridge 5](gadgetbridge5.jpg)
30+
31+
Wait for the transfer to finish. There will be a progress bar on both the watch and the phone. Your PineTime should reboot with the new version of InfiniTime!
32+
33+
Don't forget to **validate** your firmware. In the InfiniTime go to the settings (swipe right, select gear icon) and scroll to the Firmware option and click **validate**. Otherwise, after reboot the previous firmware will be used.
34+
35+
![Validate](validate.png)

doc/gettingStarted/updating-software.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ If you just want to flash or upgrade InfiniTime on your PineTime, this page is f
66

77
You can check the InfiniTime version by first swiping right on the watch face to open quick settings, tapping the cogwheel to open settings, swipe up until you find an entry named "About" and tap on it.
88

9-
![InfiniTime 1.0 version](version-1.0.jpg)
9+
![InfiniTime 1.14 version](version.png)
1010

1111
PineTimes shipped after June 2021 will ship with the latest version of [the bootloader](https://github.com/JF002/pinetime-mcuboot-bootloader/releases/tag/1.0.0) and [recovery firmware](https://github.com/InfiniTimeOrg/InfiniTime/releases/tag/0.14.1)
1212

@@ -49,7 +49,7 @@ Since those resources are not part of the firmware, they need to be flashed and
4949
Resources are packaged into a single .zip file named `infinitime-resources-x.y.z.zip` (where `x`, `y` and `z` are the version numbers of InfiniTime).
5050
You can use the companion app of your choice to flash the resources.
5151

52-
**Note : at the time of writing this page, [Amazfish](https://github.com/piggz/harbour-amazfish) and [ITD](https://gitea.arsenm.dev/Arsen6331/itd) have already integrated this functionality. Other companion apps will hopefully implement it soon!*
52+
**Note: at the time of writing this page, [Amazfish](https://github.com/piggz/harbour-amazfish) and [ITD](https://gitea.arsenm.dev/Arsen6331/itd) have already integrated this functionality. Other companion apps will hopefully implement it soon!*
5353

5454
## Amazfish
5555
Use the `Download file` functionality of Amazfish.

doc/gettingStarted/validate.png

5.34 KB
Loading

doc/gettingStarted/version.png

3.74 KB
Loading

0 commit comments

Comments
 (0)