Gocator Add-on Tool Manager
The Gocator Add-on Tool Manager lets you quickly and easily add LMI-provided beta tools to an existing firmware file. This lets you try out upcoming tools and features before their public release. After updating the firmware, upload it to a compatible sensor; for more information, see Firmware Upgrade.
The tool manager is available in the 14577-x.x.xx.xx_SOFTWARE_AddOn_Beta_Tools.zip package, available in the Download Center (https://downloads.lmi3d.com/), under the Beta Software Releases section.
To get the package:
| 1. | Go to https://downloads.lmi3d.com/ and log in to your account. |
| 2. | Select Gocator in the brand drop-down. |
| 3. | Choose the product family of your sensor in the next drop-down. |
| 4. | Click Go. |
| 5. | Scroll down to the Beta Software Releases section and expand it. |
| 6. | Choose the package that corresponds to the firmware or accelerator you wish to run the tool manager on and download it. |
|
Remember that the tools available in the package are beta tools. LMI does not recommend using them in production settings. |
The general workflow with the Gocator Add-on Tool Manager is as follows:
| 1. | Load a .dat Gocator firmware file. |
| 2. | Load one or more beta tool packages (in .tar archives). |
| 3. | Enable the tools you want to add to the loaded firmware. |
| 4. | Run the tool manager on the firmware and tool packages. |
The result is a modified firmware file that contains the tools you selected.
|
|
At any point before creating the new firmware with the tool manager, you can click Reset to remove the loaded firmware and tool packages, and start over. |
Adding Beta Tools to a Firmware
To add beta tools to a firmware:
| 1. | If you haven’t already done so, download and unzip the package containing the Gocator Add-on Tool Manager to a convenient location on your computer. |
| 2. | Launch the tool manager (GoAddOn_x.x.x.x.exe) from the \GoAddOn subfolder. |
| 3. | In the tool manager, choose Firmware next to Type. |
| 4. | Click the  button next to the Gocator Firmware field. |
| 5. | In the Open dialog that displays, navigate to the location of the .dat firmware file you want to use and click Open. |
The tool manager loads the firmware. The firmware version is displayed in the upper right of the application.
If the firmware was previously created using the tool manager, the tools will be listed in the tool window. For information on removing tools, see Removing Beta Tools from a Firmware.
| 6. | Click the Add Tool Packages... button above the tool list. |
| 7. | In the Open dialog, navigate to the folder containing the \GoAddOn folder, select a .tar tool package, and click Open. |
The tool manager adds the package to the tool list.
You can add multiple packages at once from the Open dialog.
|
|
The version of a tool package must match the version of the loaded firmware. If a package’s version does not match the firmware’s, it is highlighted with grey in the tool list and can’t be selected and included in the firmware. (The version of a tool package comes from the version of the GDK used to create it. It is not currently possible for users to create their own tool packages.). |
| 8. | When you have finished adding the packages, in the tool list, check the checkbox next the tools you want to add to the loaded firmware. |
|
|
Be sure to select at least one tool. |
| 9. | (Optional) In the Output File Prefix field, change the default “NewCustom” to something that will help you remember what the new firmware is for. |
| 10. | Click Run. |
The tool manager creates a new firmware that contains the beta tools you selected, using the prefix you provided for the filename. The new firmware is created in the same location as the original firmware you loaded.
|
|
The tool manager will overwrite an existing firmware without warning. |
After you have successfully created the new firmware, you can upload it to any compatible sensor; for more information, see Firmware Upgrade.
Removing Beta Tools from a Firmware
To remove a tool previously added to a firmware:
| 1. | Launch the Gocator Add-on Tool Manager (GoAddOn_x.x.x.x.exe) from the \GoAddOn subfolder. |
| 2. | In the tool manager, choose Firmware next to Type. |
| 3. | Click the button next to the Gocator Firmware field. |
| 4. | In the Open dialog that displays, navigate to the location of the .dat firmware file from which you want to remove a tool. |
The tool manager loads the firmware and lists the previously added tools.
| 5. | In the tool list, deselect the tools you want to remove from the firmware. |
| 6. | Click Run. |
The Gocator Add-on Tool Manager saves a new version of the firmware with the deselected tools removed.
|
|
The tool manager overwrites existing firmware files with no warning. |
After you have successfully created the new firmware, you can upload it to any compatible sensor; for more information, see Firmware Upgrade.