Updating Software Licenses

Software licenses (also known as software features or entitlements) control which features and capabilities are available on your BrainStem device. These licenses are embedded within the firmware image and are automatically loaded when you update your device’s firmware through either HubTool or the Updater CLI.

Note

Software licenses are tied to your device’s serial number and are automatically included in firmware updates when available from Acroname’s servers. Please allow 1-2 business days for new license purchases to be processed and activated in our system. If you have any questions or concerns, please contact Acroname support.

How Software Licenses Work

When you purchase additional features or capabilities for your BrainStem device, the corresponding software licenses are associated with your device’s serial number in Acroname’s licensing system. These licenses are then automatically embedded into the firmware image that is served to your device during firmware updates.

The license update process works as follows:

  1. License Assignment: Licenses are assigned to your device’s serial number in Acroname’s server system after purchase and processing

  2. Firmware Generation: When you request a firmware update, the server generates a custom firmware image that includes your device’s specific licenses

  3. Firmware Update: The licensed firmware is downloaded and installed on your device

  4. Feature Activation: Once the firmware update completes, the new features become available on your device

Updating Licenses via HubTool

The easiest way to update your software licenses is through HubTool’s Firmware Management interface. When you update your firmware through HubTool, any new licenses associated with your device will be automatically included.

For detailed instructions on using HubTool for firmware updates, see HubTool.

Updating Licenses via Updater CLI

For automated systems or remote installations, you can update software licenses using the Updater CLI utility. The CLI approach works the same way as HubTool - licenses are automatically included when you update to the latest firmware.

For detailed instructions on using the Updater CLI for firmware updates, see CLI.

Verifying License Updates

After updating your firmware (and licenses), you can verify that the new features are available by:

  1. Checking firmware version: Use the discover command to confirm the new firmware version is installed

  2. Testing licensed features: Attempt to use the newly licensed features through your application or HubTool

Verify via CLI:

$> ./Updater -D

This will show your device’s current firmware version and confirm the update was successful.

Troubleshooting License Updates

If you’re not seeing your expected licensed features after a firmware update:

  1. Verify license assignment: Contact Acroname support to confirm your licenses are properly assigned to your device’s serial number

  2. Check firmware version: Ensure you’re running the latest firmware version

  3. Network connectivity: Ensure your device has internet connectivity during firmware updates to download the licensed firmware image

Note

If you continue to experience issues with licensed features, contact Acroname support with your device’s serial number for assistance.

Important Notes

  • Serial Number Dependency: Licenses are tied to your device’s serial number.

  • Automatic Inclusion: Licenses are automatically included in all firmware updates no separate license installation step is required.

  • Server-Side Processing: License embedding happens on Acroname’s servers when you request firmware updates.

  • Firmware Version: Always ensure you’re running the latest firmware version to have access to all your licensed features.

  • Old Firmware: Licenses will also be loaded into old firmware versions but some features may not be available.