The purpose of this article is to guide the user on how to install a CMS application on an Amino media player using different methods.
This article assumes that you have completed the basic setup with Orchestrate, USB or DHCP to allow your media player to be provisioned using one of these methods.
Many customers wish to install third party CMS applications on Amino devices. The steps to install a CMS differ depending on the method you have chosen to manage and configure devices in your installation. This article is divided into sections with instructions relating to the three possible deployment models for Amino devices
Select the CMS application in your Group
Navigate to the Group Details screen in Orchestrate for the Group which your device belongs to.
Click the "Add Application" button to select which CMS application you want automatically deployed to your devices that belong to this group.
In this article we will use the "Amino-ACME-CMS" application application in our examples. When you click 'Add Application' you should find the name of the CMS applications which you wish to use, select it and press save.
If you don't find your preferred CMS application from the list, please contact Amino to publish it into your domain.
Auto-Launch CMS Application on start-up
One of the enhanced features of the Amino media players is for an application to be defined to be the main application which the device will auto-launch.
For an application to use this feature, its "package_id" or "Application ID", as it is sometimes named, needs to be obtained and pasted into the "tvapp.package_id" parameter.
The "package_id" or "Application ID" can be obtained by navigating to the "Manage Android Apps" and selecting the app you want to auto-launch.
See below for the article's example, the "AminoACME CMS" application has the ApplicationID of "com.aminocom.amino.acmecms".
Click on the "Add/Remove Parameters" and include the "tvapp.package_id" param to your list of parameters to be configured and then click "Apply".
Add the "Application ID" to the "tvapp.package_id" field. See below for the example "com.aminocom.amino.acmecms" and press Save.
All H200 media player devices assigned to this group will have the Amino ACME CMS application remotely installed and it has been configured to Auto-Start on bootup.
Create a USB image with our Offline Image Creator
Get the image from the Offline Image Creator here, by selecting only the latest available FW and skipping the next 2 steps. Export the image and download the zip file to your PC.
Prepare the USB thumb drive
1. Format a USB thumb drive with FAT32.
2. Unzip all the files from the previously downloaded USBImage.zip to the root directory of the USB thumb drive.
3. Place your CMS application file (.apk) in the root directory of the USB thumb drive. The total size of the APK file should be less than 976MB.
4. On the root directory create the file apk_list.txt and add the file name of your apk file.
ie. CMS.apk (replace CMS.apk with your CMS application name)
5. The root directory of your USB thumb drive will look like this:
6. Finally open the amino_h2xx_usb_upgrade.txt and add the line --apk_list=/udisk/apk_list.txt so it looks like this:
In case you previously added INI parameters and created a channel lineup in the Offline Image Creator the amino_h2xx_usb_upgrade.txt would contain the following lines:
Flash and install the FW and the CMS application
1. Insert the USB thumb drive into the USB slot nearest to the H200's power adapter.
2. Connect the power adapter to the H200.
3. The H200 should detect the USB thumb drive and start to upgrade automatically without user interaction.
4. Once you see the on-screen prompt confirming the system upgrade was done, remove the USB thumb drive and reboot the H200.
5. After the reboot, the H200 will then install the CMS application and an on-screen message will appear to confirm it.
Please note that the CMS application will not automatically start on this reboot but on all subsequent reboots it will auto-launch if you have configured the settings as described above.
This section assumes that you have configured a DHCP server, VCI and the INI configuration file for your media player. If you want more information about the H200 VCI+INI option, follow this article.
Having done this and tested it, you can now install your CMS application.
CMS application Deployment
In the INI file you will need to add the following lines:
appinstaller.link="<insert here the CMS application's link>"
Automatically launch the CMS application
If you wish to launch the CMS application upon the H200 boot add the following line to the INI file:
tvapp.package_id="<insert here the CMS application's id>"
INI file example
# Application Firmware and Version
firmware_upgrade.url=http://<preferred ip and path>/25.3.2022.9R.zip
# App Parameters
Reboot the H200 for the changes to take effect.
The Amino Offline Image Creator
Configuration of dhcp and VCI deployments