Added screenshots for kitchen README file

apps.json

@@ -3046,7 +3046,7 @@
   "name": "Kitchen Combo",
   "icon": "kitchen.png",
   "version":"0.01",
-  "description": "Combination of the stepo, walkersclock, arrow and waypointer apps into a multiclock format.",
+  "description": "Combination of the stepo, walkersclock, arrow and waypointer apps into a multiclock format. 'Everything but the kitchen'. Requires firmware v2.08.167 or later",
   "tags": "tool,outdoors,gps",
   "readme": "README.md",
   "interface":"waypoints.html",

apps/kitchen/README.md

@@ -0,0 +1,199 @@
+# Kitchen Combo - a multiclock format of the waypointer, walksersclock, stopo and arrow apps.
+
+![](screenshot_kitchen.jpg)
+
+*...everything but the kitchen sink..*
+
+NOTE: This app require Bangle firmware 2.08.187 or later.  
+
+The app is aimed at navigation whilst walking. Please note that it
+would be foolish in the extreme to rely on this as your only
+navigation aid!
+
+Please refer to the section on calibration of the compass.  This
+should be done each time the app is going to be used.
+
+The app has 4 faces that can quickly be switched from one to another.
+* Stepo - a large font clock that dosplays the current steps in a doughnut guauge
+* GPS - when the GPS is on displays current grid ref, lat, lon, speed, altitude and course
+* Digi - a digital clock with day and date, displays battery and memory status (click BTN1)
+* Waypointer - a compass arrow that points to a selected waypoint when the GPS is on.
+  - enables you to mark waypoints and cycle through a list of waypoints
+  - shows distance and bearing to currently selected waypoint
+
+
+## Common buttons used to navigate through the app
+
+* BTN3 - short press, next app/clock face
+* BTN3 - long press, reset the watch
+* BTN2 - long press, start the app launcher
+
+The following buttons depend on which face is currently in use
+
+* BTN1 - Short press
+  - Digi : Cycle the battery, memory display on the mode line
+  - GPS : Cycle through the GPS data displays (grid ref, lat lon, speed, alt, course)
+  - Waypointer : Select previous waypoint
+* BTN1 - long press
+  - GPS : switch GPS on or off
+  - Waypointer : set or unset the current waypoint
+* BTN2 - short press
+  - Waypointer : select next waypoint
+
+
+## Stepo
+![](screenshot_stepo.jpg)
+
+- Displays the time in large font
+- Display current step count in a doughnut guage
+- Show step count in the middle of the doughnut guage
+- The guage show percentage of steps out of a goal of 10000 steps
+- When the battery is less than 25% the doughnut turns red
+- Use BTN3 to switch to the next app
+
+## GPS
+![](screenshot_gps.jpg)
+- Use BTN1 long press to switch the GPS on or off
+- Use BTN1 short press to switch between the display of the Os grid refernce, lat lon, speed, alt, course.
+- Use BTN3 to switch to the next app
+
+## Digi
+![](screenshot_digi.jpg)
+- Displays the time in large font
+- Display day and date
+- Use BTN1 to switch between display of battery and memory %.
+- Use BTN3 to switch to the next app.
+
+## Waypointer
+- Use BTN1 to select previous waypoint (when GPS is on)
+- Use BTN2 to select the next waypoint (when GPS is on)
+- Use BTN3 to switch to the next app
+- Use BTN1 long press to clear a waypoint or to record the current position
+
+When the GPS is off this screen acts as a compass and points
+North. The white digits below the arrow show your current heading
+with reference to North.
+
+When the GPS in on the screen points to the selected waypoint which
+are loaded from the waypoints.json file. The compass arrow now points
+in the direction you need to walk in. Once you have selected a
+waypoint a bearing from your current position (received from a GPS
+fix) is calculated and the compass is set to point in that direction.
+If the arrow is pointing to the left, turning left should straighten
+the arrow up so that it is pointing straight ahead.
+
+The large digits are the bearing from the current position. On the
+left is the distance to the waypoint in local units. When the
+selected waypoint has a lat/lon recorded the text of the distance and
+waypoint name will be shown in blue.  If the waypoint name is shown
+in white it means it is available to record a waypoint.
+
+Use BTN1 and BTN2 to select the previous or next waypoint
+respectively. In the screen shot below a waypoint giving the location
+of Stone Henge has been selected.
+
+![](screenshot_stone.jpg)
+
+The screenshot above shows that Stone Henge is 259.9 miles from the
+current location. To travel towards Stone Henge I need to turn
+slightly right until the arrow is pointing straight ahead. As you
+continue to walk in the pointed direction you should see the distance
+to the waypoint reduce.  The frequency of updates will depend on
+which settings you have used in the GPS.
+
+At the top of the screen you can see two widgets.  These are the [GPS
+Power
+Widget](https://github.com/espruino/BangleApps/tree/master/apps/widgps)
+and the [Compass Power Indicator Widget]. These can be installed
+seperately and provide you a indication of when the GPS and Compass
+are switched on and drawing power.
+
+
+### Marking Waypoints
+
+The app lets you mark your current location as follows. There are
+vacant slots in the waypoint file which can be allocated a
+location. In the distributed waypoint file these are labelled WP0 to
+WP4. Select one of these - WP2 is shown below.
+
+![](screenshot_wp2_cleared.jpg)
+
+Bearing and distance are both zero as WP2 has currently no GPS
+location associated with it. To mark the location, long press BTN1.
+
+![](screenshot_wp2_set.jpg)
+
+The app indicates that WP2 is now marked by changing the color to
+blue. The distance should be small as shown in the screen shot as you
+have just marked your current location.
+
+You can free the waypoint by long pressing BTN1 again.
+
+
+### Waypoint JSON file
+
+When the app is loaded from the app loader, a file named
+`waypoints.json` is loaded along with the javascript etc. The file
+has the following contents:
+
+
+```
+[
+  {
+  "name":"NONE"
+  },
+  {
+  "name":"No10",
+  "lat":51.5032,
+  "lon":-0.1269
+  },
+  {
+  "name":"Stone",
+  "lat":51.1788,
+  "lon":-1.8260
+  },
+  { "name":"WP0" },
+  { "name":"WP1" },
+  { "name":"WP2" },
+  { "name":"WP3" },
+  { "name":"WP4" }
+]
+```
+
+The file contains the initial NONE waypoint which is useful if you
+just want to display course and speed. The next two entries are
+waypoints to No 10 Downing Street and to Stone Henge - obtained from
+Google Maps. The last five entries are entries which can be *marked*.
+
+You add and delete entries using the Web IDE to load and then save
+the file from and to watch storage. The app itself does not limit the
+number of entries although it does load the entire file into RAM
+which will obviously limit this.
+
+
+### Waypoint Editor
+
+Clicking on the download icon of gpsnav in the app loader invokes the
+waypoint editor.  The editor downloads and displays the current
+`waypoints.json` file. Clicking the `Edit` button beside an entry
+causes the entry to be deleted from the list and displayed in the
+edit boxes. It can be restored - by clicking the `Add waypoint`
+button. A new markable entry is created by using the `Add name`
+button. The edited `waypoints.json` file is uploaded to the Bangle by
+clicking the `Upload` button.
+
+
+### Calibration of the Compass
+
+The Compass should be calibrated before using the App to navigate to
+a waypoint (or a series of waypoints).  To do this use either the
+Arrow Compass or the [Navigation
+Compass](https://github.com/espruino/BangleApps/tree/master/apps/magnav).
+Open the compass app and clicking on BTN3.  The calibration process
+takes 30 seconds during which you should move the watch slowly
+through figures of 8. It is important that during calibration the
+watch is fully rotated around each of it axes. If the app does give
+the correct direction heading or is not stable with respect to tilt
+and roll - redo the calibration by pressing *BTN3*. Calibration data
+is recorded in a storage file named `magnav.json`.
+