Tracker Download Button

- Optional control for downloading tracker-edge samples without needing git

Author: rickkas7

src/assets/js/api-helper-tracker.js

@@ -19,6 +19,7 @@ $(document).ready(function() {
                 main: $(thisPartial).attr('data-main'),
                 project: $(thisPartial).attr('data-project'),
                 libraries: $(thisPartial).attr('data-libraries'),
+                src: $(thisPartial).attr('data-src'),
                 setStatus: setStatus,
                 next: function() {
                     $(thisButton).removeAttr('disabled');
@@ -51,15 +52,30 @@ async function buildTrackerDownload(options) {
     const zipFsVsCodeDir = zipFsTrackerDir.addDirectory('.vscode');
     await zipFsVsCodeDir.importHttpContent(vsCodeSettingsUrl);
 
+    const srcDir = zipFs.find(zipFsTrackerDir.getFullname() + '/src');
+
     if (options.main) {
         const oldMain = zipFs.find(zipFsTrackerDir.getFullname() + '/src/main.cpp');
         zipFs.remove(oldMain);
 
-        const srcDir = zipFs.find(zipFsTrackerDir.getFullname() + '/src');
-
         await srcDir.addHttpContent('main.cpp', options.main);
     }
 
+    if (options.src) {
+        for(const src of options.src.split(' ')) {
+            let name;
+            const lastSlashIndex = src.lastIndexOf('/');
+            if (lastSlashIndex > 0) {
+                name = src.substr(lastSlashIndex + 1);
+            }
+            else {
+                name = src;
+            }
+            
+            await srcDir.addHttpContent(name, src);
+        }
+    }
+
     if (options.libraries) {
         const projectPropertiesEntry = zipFs.find(zipFsTrackerDir.getFullname() + '/project.properties');
 

src/content/tutorials/asset-tracking/tracker-configuration.md

@@ -4,7 +4,7 @@ columns: two
 layout: tutorials.hbs
 order: 32
 description: Particle Tracker Configuration
-includeDefinitions: [api-helper, api-helper-config]
+includeDefinitions: [api-helper, api-helper-config, api-helper-tracker, zip]
 ---
 
 # Tracker Configuration
@@ -310,6 +310,24 @@ This is what it looks like in the console.
 
 ### Getting the Tracker Edge Firmware
 
+
+You can download a complete project for use with Particle Workbench as a zip file here:
+
+{{> tracker-edge main="/assets/files/tracker/example/main.cpp" project="config-sample"
+    src="/assets/files/tracker/example/MyConfig.cpp /assets/files/tracker/example/MyConfig.h" }}
+
+- Extract **tracker-config-example.zip** in your Downloads directory 
+- Open the **tracker-config-example** folder in Workbench using **File - Open...**; it is a pre-configured project directory.
+- From the Command Palette (Command-Shift-P or Ctrl-Shift-P), use **Particle: Configure Project for Device**.
+- If you are building in the cloud, you can use **Particle: Cloud Flash** or **Particle: Cloud Compile**.
+- If you are building locally, open a CLI window using **Particle: Launch CLI** then:
+
+```
+particle library copy
+```
+
+#### Manually
+
 The Tracker Edge firmware can be downloaded from Github:
 
 [https://github.com/particle-iot/tracker-edge](https://github.com/particle-iot/tracker-edge)

templates/partials/tracker-edge.hbs

@@ -1,4 +1,4 @@
-<div class="apiHelper apiHelperTrackerEdge" data-main="{{main}}" data-project="{{project}}" data-libraries="{{libraries}}">
+<div class="apiHelper apiHelperTrackerEdge" data-main="{{main}}" data-project="{{project}}" data-libraries="{{libraries}}" data-src="{{src}}">
     <div class="apiHelperBox">
         <div class="apiHelperTrackerEdgeControls">
             <p>