User Tools

Site Tools


manual:user_guide:add-ons:locusforgarmin

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
manual:user_guide:add-ons:locusforgarmin [2019/06/11 09:13]
jcapek [Importing track keeps ending with error]
manual:user_guide:add-ons:locusforgarmin [2019/11/02 15:21] (current)
jcapek [Garmin devices]
Line 2: Line 2:
 ====== Locus Map for Garmin ====== ====== Locus Map for Garmin ======
 Created by [[http://​www.wearsoft.info/​|WearSoft]] Created by [[http://​www.wearsoft.info/​|WearSoft]]
- 
 ===== USER GUIDE ===== ===== USER GUIDE =====
-Hot shortcuts: [[manual:​user_guide:​add-ons:​locusforgarmin#​devices_compatibility|Devices compatibility]],​+Hot shortcuts: [[manual:​user_guide:​add-ons:​locusforgarmin#​quick_setup|Quick Setup]], [[manual:​user_guide:​add-ons:​locusforgarmin#​compatibility|Devices compatibility]],​
 [[manual:​user_guide:​add-ons:​locusforgarmin#​course_import|Course import]], ​ [[manual:​user_guide:​add-ons:​locusforgarmin#​course_import|Course import]], ​
 [[manual:​user_guide:​add-ons:​locusforgarmin#​data_screens|Activity data screens]], ​ [[manual:​user_guide:​add-ons:​locusforgarmin#​data_screens|Activity data screens]], ​
 [[manual:​user_guide:​add-ons:​locusforgarmin#​activity_recording|Activity record]], ​ [[manual:​user_guide:​add-ons:​locusforgarmin#​activity_recording|Activity record]], ​
-[[manual:​user_guide:​add-ons:​locusforgarmin#​troubleshooting|Troubleshooting]]+[[manual:​user_guide:​add-ons:​locusforgarmin#​faq_troubleshooting|FAQ & Troubleshooting]]
 ---- ----
  
-Locus Map for Garmin is an extension which provides features of **Locus Map** mobile app on **Garmin** devices while providing some native Garmin activity functionalities. It consists of two applications: ​+Locus Map for Garmin is an extension which provides features of **[[https://​play.google.com/​store/​apps/​details?​id=menion.android.locus|Locus Map]]** mobile app on **Garmin** devices while providing some native Garmin activity functionalities. It consists of two applications: ​
   * Android add-on **Locus Map for Garmin** available on **[[https://​play.google.com/​store/​apps/​details?​id=info.wearsoft.locus.addon.ciq|Google Play]]**   * Android add-on **Locus Map for Garmin** available on **[[https://​play.google.com/​store/​apps/​details?​id=info.wearsoft.locus.addon.ciq|Google Play]]**
   * Garmin Connect IQ application **Locus Map** available on **[[https://​apps.garmin.com/​en-US/​apps/​f15dd655-e734-456e-b8f5-314d287df4a4|Connect IQ Store]]**   * Garmin Connect IQ application **Locus Map** available on **[[https://​apps.garmin.com/​en-US/​apps/​f15dd655-e734-456e-b8f5-314d287df4a4|Connect IQ Store]]**
  
 +{{:​manual:​user_guide:​add-ons:​map-va4.png?​nolink&​250|}}
 {{:​manual:​user_guide:​add-ons:​navscreen.png?​nolink&​250|}} {{:​manual:​user_guide:​add-ons:​navscreen.png?​nolink&​250|}}
 {{:​manual:​user_guide:​add-ons:​infoscreen.png?​nolink&​250|}} {{:​manual:​user_guide:​add-ons:​infoscreen.png?​nolink&​250|}}
-{{:​manual:​user_guide:​add-ons:​locusactivityscreen.png?​nolink&​250|}} 
  
 ==== Main Features ==== ==== Main Features ====
Line 23: Line 22:
   * display real-time data from Locus Map running on your smartphone:   * display real-time data from Locus Map running on your smartphone:
     * navigation     * navigation
 +    * maps 
     * guidance     * guidance
     * track recording     * track recording
Line 29: Line 29:
   * render maps stored on your Garmin device (on supported devices)   * render maps stored on your Garmin device (on supported devices)
   * import routes/​courses from your smartphone to your Garmin to navigate by them with Garmin native activity apps (on devices supporting navigation features)   * import routes/​courses from your smartphone to your Garmin to navigate by them with Garmin native activity apps (on devices supporting navigation features)
-===== Devices compatibility ===== 
-In order to use Locus Map for Garmin, you must have compatible both Android phone and Garmin device. Android add-on is compatible with all smartphones running OS Android 4.1 and higher.  ​ 
  
 +==== Quick setup ====
 +  - If you don't using it yet, [[https://​www.locusmap.eu/​download/​|install Locus Map]] outdoor navigation to your smartphone. Both Free or Pro versions will work fine with Garmin extension. ​
 +  - Install [[https://​play.google.com/​store/​apps/​details?​id=info.wearsoft.locus.addon.ciq|Locus Map for Garmin]] Android extension. ​
 +  - Install [[https://​apps.garmin.com/​en-US/​apps/​f15dd655-e734-456e-b8f5-314d287df4a4#​0|Locus Map]] from Garmin Connect IQ Store to your Garmin device. You can do so by clicking to button in phone app installed in previous step. 
 +  - Test connection from Garmin device to smartphone by opening the Locus Map in your Garmin. Service providing communication to watch should start automatically in your Android. If this is not case for you, please refer troubleshooting section. If maps are loaded too slowly, try restart both Garmin and phone.
 +  - We recommend to use offline LoMaps for best results on Phone Map screen (optimised colors).
 +  - Playing geocaching? Then check also [[https://​geocaching4locus.eu/​|Geocaching4Locus extension]]
 +==== Controls ====
 +Controls of the app differs by various Garmin models and is similar to native activity applications of the device. ​
 +
 +Summary for most non-touch devices: ​
 +  * **START button** - Access on-device activity recording
 +  * **UP/DOWN buttons** - list through available screens
 +  * **MENU** (holding UP button) - on map screens - zoom mode
 +  * **MENU** (holding UP button) - on other screens - access app menu with settings ​
 +  * **BACK button** - exit the app or dialog to save active activity
 +
 +
 +===== Compatibility =====
 +In order to use Locus Map for Garmin, you must have compatible both Android phone and Garmin device. Android add-on is compatible with all smartphones running OS Android 5 and higher.  ​
  
 ==== Garmin devices ==== ==== Garmin devices ====
 Due to large differences between Garmin products, please check the table below to see the compatibility of your Garmin device. In case no feature is available for your device yet, you will not be able to install the application from Garmin Connect IQ Store.\\ Due to large differences between Garmin products, please check the table below to see the compatibility of your Garmin device. In case no feature is available for your device yet, you will not be able to install the application from Garmin Connect IQ Store.\\
-^ Device ​     ^ Main activity app       ​^ Import ​Courses ​        ^ +^ Device ​     ^ Navigation & activity app  Phone Maps     ^ Course ​Import ​        ^ 
-| D2™ Charlie | **YES** | **YES** | +| D2™ Bravo ** * ** | **YES** | N/A | N/A | 
-| D2™ Delta | **YES** | **YES** | +| D2™ Charlie ​| **YES** ​| **YES** | **YES** | 
-| D2™ Delta PX | **YES** | **YES** | +| D2™ Delta | **YES** ​| **YES** | **YES** | 
-| D2™ Delta S | **YES** | **YES** | +| D2™ Delta PX | **YES** ​| **YES** | **YES** | 
-| Descent™ Mk1 | **YES** | **YES** | +| D2™ Delta S | **YES** ​| **YES** | **YES** | 
-| Forerunner® 245 | **YES** | **YES** | +| Descent™ Mk1 | **YES** ​| **YES** | **YES** ​
-| Forerunner® 245 Music | **YES** | **YES** | +| Forerunner® 230 ** * ** | **YES** | N/A | N/A | 
-| Forerunner® 645 | **YES** | **YES** | +| Forerunner® 235 ** * ** | **YES** | N/A | N/A 
-| Forerunner® 645 Music | **YES** | **YES** | +| Forerunner® 245 | **YES** ​| **YES** | **YES** | 
-| Forerunner® 735 XT | **YES** | **YES** | +| Forerunner® 245 Music | **YES** | **YES** ​| **YES** | 
-| Forerunner® 935 | **YES** | **YES** | +| Forerunner® 630 | **YES** | N/A | N/A 
-| Forerunner® 945 | **YES** | **YES** | +| Forerunner® 645 | **YES** ​| **YES** | **YES** | 
-| fēnix® ​5, quatix® ​5 | **YES** | **YES** | +| Forerunner® 645 Music | **YES** ​| **YES** | **YES** | 
-| fēnix® ​5 Plus | **YES** | **YES** | +| Forerunner® 735 XT | **YES** ​| YES/Colors limit | **YES** | 
-| fēnix® 5S | **YES** | **YES** | +| Forerunner® 935 | **YES** ​| **YES** | **YES** | 
-| fēnix® 5S Plus | **YES** | **YES** | +| Forerunner® 945 | **YES** ​| **YES** | **YES** | 
-| fēnix® ​5X, tactix® Charlie ​| **YES** | **YES** | +| fēnix® ​3, quatix® ​3, tactix® Bravo ** * ** | **YES** ​| N/A | N/A 
-| fēnix® ​5X Plus | **YES** | **YES** | +| fēnix® ​3 HR ** * ** | **YES** ​| N/A | N/A 
-| fēnix® Chronos | **YES** ​| **YES** | +| fēnix® ​5/5S/5X, quatix® 5 | **YES** ​| **YES** | **YES** | 
-| MARQ™ Athlete ​| **YES** | **YES** | +| fēnix® ​5/5S/5X Plus | **YES** ​| **YES** | **YES** | 
-| MARQ™ ​Aviator ​| **YES** ​| **YES** | +| fēnix® ​6/6S | **YES** ​| **YES** | **YES** | 
-| MARQ™ Captain ​| **YES** | **YES** | +| fēnix® ​6/6S/6X Pro | **YES** ​| **YES** | **YES** | 
-MARQ™ Driver ​| **YES** | **YES** | +| fēnix® Chronos | **YES** | **YES** | **YES** | 
-MARQ™ Expedition | **YES** | **YES** | +| MARQ™ ​Series ​| **YES** | **YES** | **YES** | 
-| vívoactive® HR | **YES** | N/A | +Venu | **YES** | **YES** ​| N/A 
-| vívoactive® 3 | **YES** | N/A | +vívoactive® ** * ** | **YES** ​| N/A | N/A 
-| vívoactive® 3 Music | **YES** | N/A | +| vívoactive® HR | **YES** ​| N/A | N/A | 
-| vívoactive® ​3 Mercedes-Benz® Collection ​| **YES** | N/A | +| vívoactive® 3 | **YES** ​| **YES** | N/A | 
-| EDGE bike computers | IN CONSIDERATION | PLANNED | +| vívoactive® 3 Music | **YES** ​| **YES** | N/A | 
-fēnix® 3, fēnix® 3 HR, quatix® 3, tactix® Bravo | IN CONSIDERATION | PLANNED ​|+| vívoactive® ​4/4S | **YES** ​| **YES** | N/A | 
 +| EDGE bike computers | IN CONSIDERATION ​| PLANNED | 
 +Garmin handheld devices ​| IN CONSIDERATION | | 
 +** * ** these devices are extremely memory limited. Please let us know if you experience crash of the app on those devices! It also means that some future features might not be available for those watches. ​
  
-Possibility to add other devices is constantly being analyzed.  ​+Let us know if you miss your device in the list!
  
 ==== Main activity app / Import courses ==== ==== Main activity app / Import courses ====
Line 80: Line 101:
  
 The main screen of the application provides information about the state of connectivity and reports if there is some problem preventing communication with the Connect IQ application. ​ The main screen of the application provides information about the state of connectivity and reports if there is some problem preventing communication with the Connect IQ application. ​
 +
 +Please note, that provided version info is related to Android application and not Connect IQ application which is updated much more regular. ​
  
 ===== Connect IQ application ===== ===== Connect IQ application =====
Line 88: Line 111:
 ==== Preview/​Premium modes ==== ==== Preview/​Premium modes ====
  
-At the first start, the app runs in a “Preview mode” ​offering limited functionality. Its “Premium mode” can be permanently unlocked for about 4 euros via Locus Store within Locus Map in your smartphone.+At the first start, the app runs in a “Preview mode”. Its “Premium mode” can be permanently unlocked for about 4 euros via Locus Store within Locus Map in your smartphone.
  
 {{:​manual:​user_guide:​add-ons:​94p82313.png?​nolink|}} {{:​manual:​user_guide:​add-ons:​94p82313.png?​nolink|}}
  
-Preview Mode allows the user to get feel about application possibilities and check that app connectivity with the phone behave as expected. While in Preview Mode, screen elements shown by orange color do not provide their intended function and are there for illustration of screen layouts in Premium ​mode+Preview Mode allows the user to get feel about application possibilities and check that app behave as expected ​before payment ​for Premium ​version
  
 By activating the Premium mode, the user gains: By activating the Premium mode, the user gains:
-  * graphical and text navigation instructions +  * removed Preview Mode overlays 
-  * arrow on compass ​screen ​pointing to the desired position or next navigation ​point +  * no Preview mode splash ​screen 
-  * dynamic screen manager ​showing only available ​screens ​for particular recording/​navigation modes +  * vibrations before ​navigation ​events 
-  * more data fields on Locus Map track recording screen +  * dynamic screen manager ​(hides unused ​screens ​etc.) 
-  * no Preview mode splash screen with a delay+  * and more 
  
 ==== Application start ==== ==== Application start ====
Line 106: Line 130:
 After every start, the application will first try to start the background process of Android add-on application which provides connectivity. This process may take several seconds. Please be aware, that app is unable to detect that user didn't installed Android addon app yet. After every start, the application will first try to start the background process of Android add-on application which provides connectivity. This process may take several seconds. Please be aware, that app is unable to detect that user didn't installed Android addon app yet.
  
-Messages shown on Garmin screen under application logo during this process are only informative and don’t affect initializing as the application is trying to connect repeatedly.  +In case connectivity is not initialised ​even after about 20 seconds and the app doesn’t throw any error, starting of android background communication process probably failed. In this case, please see the troubleshooting section. ​
- +
-In case connectivity is not initialized ​even after about 20 seconds and the app doesn’t throw any error, starting of android background communication process probably failed. In this case, please see the troubleshooting section. ​+
  
 ==== Course import ==== ==== Course import ====
Line 167: Line 189:
  
 In case the user doesn’t get valid direction by the arrow, it is advisable to calibrate compass of Garmin device by main device settings. ​ In case the user doesn’t get valid direction by the arrow, it is advisable to calibrate compass of Garmin device by main device settings. ​
 +
 +=== Phone Map screen ===
 +{{:​manual:​user_guide:​add-ons:​9ahd1602.png?​nolink|}}
 +{{:​manual:​user_guide:​add-ons:​9ag71633.png?​nolink|}}
 +
 +Maps from Locus Map running on smartphone are streamed to this screen, including any object, track or navigation instructions shown on screen on Android Locus Map. 
 +
 +Maps are streamed in the real-time via Bluetooth connection with smartphone. Any chosen map which user will select to show on Android Locus Map will be streamed also to Garmin. Offline maps can be streamed to watch without active internet connection or cellular signal. For best results, we recommend to use LoMaps. ​
 +
 +Map are loaded only when user have this screen active on watch. Loading map takes several second - this is limitation of connectivity between watch and smartphone. After map is loaded to screen, updated map is continuously loaded in background to update the map as soon as possible. ​
 +
 +Phone Map screen have map zoom independent on zoom used on smartphone. Zoom mode can be activated by the same way how MENU is accessed (by holding UP button on touch watches). Please note, that it can take 2 map refresh to get proper map details after change of zoom.
 +
 +The map is centered based on available location data - source can be either:
 +  * Garmin GPS - position is shown by a red arrow which rotates based on the current heading
 +  * GPS on phone - position is shown same way as in Android Locus Map application
 +
 +Screen can optionally show DELAY info which indicates time between generating map source image and last refresh of the screen with it. Speed of map loading can vary based on used Garmin device, smartphone model, Garmin Connect version etc. Write us if you are not sure, whether it behaves correctly in your case. 
  
 === Garmin Map screen === === Garmin Map screen ===
Line 216: Line 256:
 {{:​manual:​user_guide:​add-ons:​garmin_15.png?​nolink|}} {{:​manual:​user_guide:​add-ons:​garmin_15.png?​nolink|}}
  
-Recording can be paused or restarted by another press of the START button. If paused, the app will show a menu where user can save activity and prepare it for export to Garmin Connect. This is done automatically by Garmin device during next synchronisation with Garmin Connect Mobile or with Garmin Express desktop app. +Recording can be paused or restarted by another press of the START button. If paused, the app will show a menu where user can save activity and prepare it for export to Garmin Connect. This is done automatically by Garmin device during next synchronisation with Garmin Connect Mobile or with Garmin Express desktop app. During inactive activity recording, GPS is automatically turned off to safe battery (based on app setting with 5 minutes timeout or immediately).
  
 By pressing the BACK button (or sliding to right on touch-enabled devices) on this menu or selecting “Keep paused”, user can go back to data screens while activity recording is paused. ​ By pressing the BACK button (or sliding to right on touch-enabled devices) on this menu or selecting “Keep paused”, user can go back to data screens while activity recording is paused. ​
Line 225: Line 265:
 {{:​manual:​user_guide:​add-ons:​garmin_16.png?​nolink|}} {{:​manual:​user_guide:​add-ons:​garmin_16.png?​nolink|}}
  
-User can affect the behavior ​of the application by accessing settings in the app menu. Settings are stored in device permanent memory.+User can affect the behaviour ​of the application by accessing settings in the app menu. Application menu can be opened same way as watch system menus (long-press UP on non-touch watches) from any activity screen except map screens. Settings are stored in device permanent memory.
  
-  * Garmin GPS autostart - turn on or off automatic starting of GPS in Garmin ​device. More on section Activity recording +On device menu is available only on devices with Connect IQ 3.0 and higher. On older devices, ​limited ​settings can be changed via Garmin Express or Garmin Connect Mobile. ​
-  * No record alert - turn on or off showing a red alert on edge of the screen which indicated that user doesn’t record activity. +
-  * Vibrate on connect - turn on or off vibration if connectivity is initialized or lost.   +
- +
-This menu is available only on devices with Connect IQ 3.0. On older devices, settings can be changed via Garmin Express or Garmin Connect Mobile. ​+
        
 ==== Losing phone connectivity ==== ==== Losing phone connectivity ====
Line 237: Line 273:
 If the application loses connectivity with the phone or Android companion app was forced to close, the app will automatically try to reconnect and continue. Garmin activity recording is not affected by losing connectivity,​ and even if connectivity was not established user can still select to save or discard it before leaving the app.  If the application loses connectivity with the phone or Android companion app was forced to close, the app will automatically try to reconnect and continue. Garmin activity recording is not affected by losing connectivity,​ and even if connectivity was not established user can still select to save or discard it before leaving the app. 
  
-===== Troubleshooting =====+ 
 +===== FAQ & Troubleshooting ===== 
  
 ==== Garmin application keeps loosing connectivity ==== ==== Garmin application keeps loosing connectivity ====
 {{:​manual:​user_guide:​add-ons:​94ia5900.png?​nolink|}} {{:​manual:​user_guide:​add-ons:​94ia5900.png?​nolink|}}
  
-If you experience loosing of app connectivity with the phone while staying in its Bluetooth range, the reason is that Battery Saver Management in Android is set too strictly and keeps closing background process of Android add-on. ​+You can get this error for several reasons:  
 + 
 +1) **You leave range of your phone Bluetooth connectivity**\\ 
 +- once you go back the error will hide automatically 
 + 
 +2) **Bluetooth on one of the devices was turned off**\\ 
 +- turn it on again and app will automatically reconnect 
 + 
 +3) **Locus Map for Garmin app in you phone is killed by Android battery management**\\ 
 +If you experience loosing of app connectivity with the phone while staying in its Bluetooth range, the reason is that Battery Saver Management in Android is set too strictly and keeps closing background process of Android add-on. You can verify this by manually opening Locus Map for Garmin in your smartphone. If the watch is connected after this, it is this case
  
 Smartphones from various brands - for example, Huawei, Honor, Xiaomi doesn'​t by default allow to run apps in the background unless the user changes it in system settings. Please ensure, that you **enable to start in the background for applications Locus Map for Garmin and Garmin Connect** or try to turn-off battery saving features. Smartphones from various brands - for example, Huawei, Honor, Xiaomi doesn'​t by default allow to run apps in the background unless the user changes it in system settings. Please ensure, that you **enable to start in the background for applications Locus Map for Garmin and Garmin Connect** or try to turn-off battery saving features.
  
    * **Huawei & Honor**: Settings > Battery > App Launch > set manual for Locus Map for Garmin and Garmin Connect    * **Huawei & Honor**: Settings > Battery > App Launch > set manual for Locus Map for Garmin and Garmin Connect
 +
 +For more smartphone brands or more guides, please go to: https://​dontkillmyapp.com/​
  
 You can also access native Android battery optimization settings via the top-right menu in Locus Map for Garmin. ​ You can also access native Android battery optimization settings via the top-right menu in Locus Map for Garmin. ​
 +
 +4) **Garmin Connect connectivity lock itself**\\
 +This is known bug on Garmin Connect IQ platform which we are still waiting to be fixed by them. Sometimes connectivity can fail without obvious reason or possibility to automatically reconnect by application itself. During this issue Garmin device still can synchronise with the smartphone or receive notifications,​ but no Connect IQ app will be able to connect. It can be solved by deactivating and activating Bluetooth again - either on phone or Garmin device. Easiest way is to hold LIGHT button on non-touch devices or main button on touch devices while app is running and double click on Connection icon. 
  
  
Line 268: Line 320:
 ==== Keep getting "​Bluetooth error - reconnect your Garmin to phone" ==== ==== Keep getting "​Bluetooth error - reconnect your Garmin to phone" ====
 Due to issue in Garmin Connect Mobile, it may rarely happen that you get this error while trying to start application. From this error app usually do not recover by itself. In order to initialise app properly, please disconnect your Garmin from phone and reconnect it again. You can quickly do it by opening round context menu on your watch (by holding light button on non-touch devices or select button on touch devices) and use Phone connection option. After that the app should initialise properly. Due to issue in Garmin Connect Mobile, it may rarely happen that you get this error while trying to start application. From this error app usually do not recover by itself. In order to initialise app properly, please disconnect your Garmin from phone and reconnect it again. You can quickly do it by opening round context menu on your watch (by holding light button on non-touch devices or select button on touch devices) and use Phone connection option. After that the app should initialise properly.
 +
 +==== Application show only IQ sign on start (crash) ====
 +Please update firmware on your device to latest version (via Garmin Express). ​
 ===== Contact us ===== ===== Contact us =====
 If you didn't find the answer to your question or you will be so kind as to let us know your feedback, please write to us! If you didn't find the answer to your question or you will be so kind as to let us know your feedback, please write to us!
  
 Email: <​locusmap@wearsoft.info>​\\ Email: <​locusmap@wearsoft.info>​\\
-Facebook: https://​www.facebook.com/​wearsoft.info/ \\+Facebook: https://​www.facebook.com/​LocusMapForGarmin/ \\
 Community platform: https://​help.locusmap.eu/​topics/​all/​status/​all/​category/​27/​sort/​updated/​page/​1 \\ Community platform: https://​help.locusmap.eu/​topics/​all/​status/​all/​category/​27/​sort/​updated/​page/​1 \\
 Locus Map Forum: https://​forum.locusmap.eu/​index.php?​topic=6540.0 Locus Map Forum: https://​forum.locusmap.eu/​index.php?​topic=6540.0
manual/user_guide/add-ons/locusforgarmin.1560237239.txt.gz · Last modified: 2019/06/11 09:13 by jcapek