The install instructions can be found here.

No.

In order to function properly, AMBER/Autonomie needs the system’s region to be set to English (United States). This can be done via the Region applet in the Control Panel.

Changing this system setting may require administrator privileges depending on the security policies in place so you may need to contact your IT department for assistance.

Check for the existence of a file named ‘Program’ at the root of the C drive (C:\Program) and if it’s there, delete it.

Note - A Windows account with administrator privileges is required.

1. Click on the ‘Settings’ button located within the Matlab group in the AMBER tab.

   

2. In the Manage Matlab screen, select a version of Matlab and click the ‘Register’ button.

   

3. Enter the credentials for an account with administrator privileges.

4. Enter the credentials for the account that is registered with Matlab.

If you don’t see any vehicle in the Autonomie workflows, it’s most likely due to a missing folder in the settings of your Autonomie Project.

Please check that your Autonomie Project includes all the Autonomie Libraries as such:

1. Close all your currently opened workflows

2. Edit the Project setting via the Autonomie menu

   

3. Check the 3 default Autonomie libraries are included in the project setting, and add any missing ones.

   

4. Save and close you project setting

5. Open the Run Vehicle workflow, you should now see the vehicles in the GUI.

Figure 1

If an error dialog similar to figure 1 is encountered, perform the following:

1. Close all instances of AMBER.

2. Open Windows Explorer with the path %TEMP%.

   Note: Your path will be slightly different than the one depicted in figure 2.

Figure 2

3. Locate and delete the ‘dotnetbrowser-chromium’ folder.
4. Launch AMBER.

If AMBER’s splash screen isn’t visible or it’s inaccessible try the following:

• Turn Off Sticky Keys

  1. In Windows 10 pull up the start menu and type ’turn off sticky keys’ (see Fig. 1).
  2. Select the option highlighted in Fig. 1.

3. Search for the ‘Use Sticky Keys’ section in the Settings dialog and ensure it’s off (see Fig. 2).

• Use Task Manager to switch to it

  1. Open Task Manager.
  2. Look for the AMBER entry within the Apps group (see Fig. 3). Then expand it and right click on AMBERSplashScreen and then click on ‘Switch to’.

Requires Microsoft Outlook

You can email your log file to support by navigating to the AMBER tab and clicking on the ‘Email Log File’ button within the Help group. An email will be composed in Outlook awaiting for you to send. No other information is sent to support.

Troubleshooting A Floating License Server (FLS)

Note - The following procedure assumes the AMBERLicenseServerSetup.pdf document has been completed.

Step #1 - Verify the FLS is installed and running

• Launch the Services App

• Find the FLS entry and verify the status says ‘Running’.

   If no entry can be found, install the FLS via the AMBERLicenseServerSetup.pdf document.

   If the status indicates an error, check the FLS’s log file (debug.log) for errors.

Step #2 - Verify AMBER is correctly configured to use the FLS

• Open the License.Lic file located at %AppData%\Argonne National Laboratory\AMBER\Version where Version is the release name (e.g. Beta, 2023, 2024).

If the FLS name is AMBER-FLS and the port number is 27001 then the contents of the file should be:

SERVER AMBER-FLS 0 27001
USE_SERVER

Step #3 - Verify the computers can communicate with each other

• On the computer that’s running AMBER, open a command prompt and type ping followed by the name of the computer that’s running the FLS.

If the FLS name is AMBER-FLS it should be:

ping AMBER-FLS.

If errors are found it is most likely due to network and/or firewall issues. Machine and network firewalls must allow traffic through the ports used by the license server (default is 27001). Contact your IT Department to troubleshoot these matters.

Step #4 - Email Support

If you’re still having problems email us at [email protected].
In the email attach the following:

• Zip up the entire contents of the FLS directory (e.g. C:\AMBER\LicenseServer).
• Zip up the entire contents of the %AppData%\Argonne National Laboratory\AMBER\Version directory where Version is the release name (e.g. Beta, 2023, 2024).

Perform the following steps:

1. Hold down the Ctrl & Shift keys and launch AMBER by double-clicking its icon on the desktop (see Fig. 1).

   

2. Once AMBER’s splash screen (see Fig. 2) is visible, you can release the Ctrl & Shift keys and proceed to enter option 2 (Manage Licenses).
   Note - If it seems that AMBER isn’t responding to the keyboard, ensure the splash screen is receiving keyboard input by clicking it.

   

3. In the Manage Licenses screen (see Fig. 3), select the ‘Diagnostics’ tab to view the data.

   

Perform the following steps:

1. Copy your license key to the clipboard.

2. Hold down the Ctrl & Shift keys and launch AMBER by double-clicking its icon on the desktop (see Fig. 1).

   

3. Once AMBER’s splash screen (see Fig. 2) is visible, you can release the Ctrl & Shift keys and proceed to enter option 2 (Manage Licenses).
   Note - If it seems that AMBER isn’t responding to the keyboard, ensure the splash screen is receiving keyboard input by clicking it.

   

4. In the Manage Licenses screen (see Fig. 3), check the boxes next to the types that were included with your purchase of AMBER. Then click the ‘Reset’ button.

   

5. Click the ‘Yes’ button in the Reset Licensing screen (see Fig. 4).

   

6. Click the ‘OK’ button in the Reset Licensing Success screen (see Fig. 5).

   

7. Click the ‘Cancel’ button in the Manage Licenses screen (see Fig. 6).

   

8. Enter your key in the License Activation screen (see Fig. 7) and then click the ‘Activate’ button when you’re finished.

   

Perform the following steps:

1. Hold down the Ctrl & Shift keys and launch AMBER by double-clicking its icon on the desktop (see Fig. 1).

   

2. Once AMBER’s splash screen (see Fig. 2) is visible, you can release the Ctrl & Shift keys and proceed to enter option 5 (Purge All).
   Note - If it seems that AMBER isn’t responding to the keyboard, ensure the splash screen is receiving keyboard input by clicking it.

   

3. Click the ‘Yes’ button in the Purge All screen (see Fig. 3).

   

Perform the following steps:

1. Hold down the Ctrl & Shift keys and launch AMBER by double-clicking its icon on the desktop (see Fig. 1).

   

2. Once AMBER’s splash screen (see Fig. 2) is visible, you can release the Ctrl & Shift keys and proceed to enter option 3 (Reset All Data Sources).
   Note - If it seems that AMBER isn’t responding to the keyboard, ensure the splash screen is receiving keyboard input by clicking it.

   

3. Click the ‘Yes’ button in the Reset All Data Sources screen (see Fig. 3).

   

Note - This applies to AMBER 2024 and later releases.

Perform the following steps:

1. Hold down the Ctrl & Shift keys and launch AMBER by double-clicking its icon on the desktop (see Fig. 1).

   

2. Once AMBER’s splash screen (see Fig. 2) is visible, you can release the Ctrl & Shift keys and proceed to enter option 6 (Update).
   Note - If it seems that AMBER isn’t responding to the keyboard, ensure the splash screen is receiving keyboard input by clicking it.

   

3. In the AMBER Update screen (see Fig. 3), click the ‘Patch’ button.

   

4. Enter the ID of the patch in the Apply Patch dialog (see Fig. 4) and then click the ‘Apply’ button.

   

5. Click the ‘OK’ button on the AMBER Patch Complete dialog (see Fig. 5).

   

No.

Matlab strings are not compatible with AMBER/Autonomie please use character arrays instead. That is, use single quotes to enclose a string and not double quotes. e.g. use ‘This is a good string’ vs. “This is a bad string”

Uninstalling AMBER can be done via the control panel applet ‘appwiz.cpl’.

appwiz.cpl

The section below shows 3 ways to launch the applet:

1. Control Panel\Uninstall a program

   

   Click on the ‘Uninstall a program’ link and then proceed to the Programs and Features section.

2. Control Panel\Programs and Features

   

   Click on the ‘Uninstall a program’ link and then proceed to the Programs and Features section.

3. The Run Dialog Box Open the Run Dialog Box (⊞ Win+R) and enter ‘appwiz.cpl’ and then click ‘OK’.

   

Programs and Features

***** Please close all instances of AMBER as well as any open files before proceeding. This will help to ensure a complete and successful uninstall. *****

1. Upon entering Programs and Features, find the AMBER entry, select it and then click the ‘Uninstall/Change’ button.

   

2. Click the ‘Yes’ button on the AMBER Uninstall dialog and wait until the success or failure dialog is shown.

   

   • Success

     

   • Failure

     • If any other dialog appears, ensure that all files are closed in the ‘C:\AMBER\[Release]’ and ‘%AppData%\Argonne National Laboratory\AMBER\[Release]’ ([Release] denotes the release name) directories and try again.

Yes because it uses HERE Maps and Google Maps.