Kynetics is a leading software development company providing customized U-Boot, Secure Boot, Drivers, Linux Kernel, Android HAL, and embedded Android and Linux Operating Systems for the Toradex Apalis and Colibri family of product lines for our customers’ projects in various industries. These projects incorporate Colibri SoMs featuring NXP i.MX 6, i.MX 7, i.MX 8X as well as Apalis SoMs featuring i.MX 6 and i.MX 8. In addition, to help speed up development to production timelines, Kynetics offers an over-the-air embedded OS builds delivery platform: Update Factory, which includes support for both Android and Linux. If you want to learn more about Kynetics Android, check our Android software page.
Kynetics has built a vanilla image of Android supporting Toradex hardware for evaluation. It is pretty exciting to share with all of you this work done by Kynetics and to give you the chance to enjoy Android on Toradex embedded systems.
This image supports OTA updates through Kynetics Update Factory. To learn more, check the article Update Factory Client for Android Embedded Devices.
Warning: please migrate to the newest Apalis iMX8QM and Colibri iMX8QXP as soon as possible. See the Apalis iMX8QM PCN and the Colibri iMX8QXP PCN for more information.
Modules supported with flashing instructions alternative to Toradex Easy Installer. For flashing instructions, see the Kynetics documentation respective to each module, available in the Toradex Android article:
Tip: Please remember that you can always refer to the Android Support on Toradex Products for more information about this topic.
A section at the end of this guide provides instructions about the display and touch screen configuration.
The Android evaluation BSPs provided by Kynetics are meant for evaluation. They are suitable for development, but not for production.
Make sure to carefully read about the Android Evaluation BSPs by Kynetics.
This section provides instructions for you to quickly get started with the Kynetics Android demo image.
Please choose your module from the tabs below:
Load the Toradex Easy Installer on the target module and select Kynetics Android from the list of available images.
Installing Kynetics Android using the Toradex Easy Installer (click to enlarge)
Once the installation finishes, power-cycle the board and Android will start. You can then interact with the Android user interface either from a touchscreen or a mouse and keyboard setup.
Note: These modules are supported by flashing instructions alternative to Toradex Easy Installer. For flashing instructions, see the Kynetics documentation respective to each module, available in the Toradex Android article.
To deploy and debug apps, connect the board to your computer using a micro-USB to USB cable and remove the jumper short-circuit in JP2 on Ixora:
Connect a micro-USB to USB cable and remove JP2 on Ixora (click to enlarge)
Alternatively, you can use the Ethernet or Wi-Fi interface for debugging. Search the official Android documentation on how to use adb to setup debugging over TCP/IP.
Note: This article is not meant as an introduction to Android development. If you have questions, go through its comprehensive documentation.
To avoid issues when deploying the app to the actual hardware, go through the following article:
Note: If your host OS is Ubuntu, apt-get install adb might do the trick.
Download, install, and start Android Studio. Once it starts you will see a welcome screen. Choose the option Import an Android code sample:
Import an Android code sample (click to enlarge)
Select a sample of your choice. In this article we will build and deploy the Sunflower sample app:
Select the Sunflower sample (click to enlarge)
Configure sample (click to enlarge)
Wait for the Gradle build to finish. The outcome is a view of the IDE. Click the Run button in the top-right corner of the IDE:
Android Studio IDE (click to enlarge)
Select the Toradex SoM from the list of Connected Devices, click OK and wait for the app to start:
Select the Toradex SoM (click to enlarge)
Sunflower app running on the target module (click to enlarge)
Register at Update Factory for a trial.
Update Factory Dashboard (click to enlarge)
The Partner Demo Image comes with the Update Factory service and UI client pre-installed. If you ever need to re-install or update them, have a look at the dropdown below:
It is then possible to add devices to your targets. At the dashboard, click the plus (+) sign on the targets panel and follow the instructions.
To connect the device to the dashboard, a configuration file has to be pushed to Android's file system. Follow this article to create the ufConf.conf file according to your security keys, then push it to the device:
adb push ufConf.conf /sdcard/UpdateFactoryConfiguration/ufConf.conf
Your ufConf.conf file should be similar to:
ufConf.conf
tenant=<Your Tenant>
url=https://personal.updatefactory.io/
controllerId=<Chosen Controller ID>
gatewayToken=<From System Config>
targetToken=<From Device Details>
apiMode=true
enable=true
updateFactoryServer=true
Reboot the system to apply the file change. It is now possible to check the current communication status from the UI application or from Android's notification system. For a comprehensive list of Machine States, go through Kynetics's own documentation. If the log says (WAITING, SLEEP_REQUEST) -> WAITING, the system has connected to the dashboard and is ready for receiving instructions. If it raises an error, recheck your ufConf.conf file with the documentation.
The following video shows how to send OTA updates to the devices. Just drag a distribution from the distribution's list to the target module and choose between a soft or forced update, according to the video. Follow the prompts on the android device. For more information, be sure to visit Update Fatory's documentation page.
From now onwards, you are able to use Android development tools to create your own Android apps. Refer to the Android developer website for documentation.
Kynetics has a comprehensive documentation website named Technical Notes as well as the Update Factory documentation.
For more information about how to get this demonstration image supported and customized, get in contact with Kynetics.
Touch should work out-of-box but in case it does not, check the Kynetics documentation for your specific Computer on Module and Android version:
This Partner Demo Image is subject to the terms of the Kynetics Software License Agreement, provided either from their Technical Notes articles, or during the installation from the Toradex Easy Installer online feeds.
Android-related webinars that you can watch on-demand.
The release notes are related to the Partner Demo Image, and not to the Kynetics Android releases. If you are interested in the Kynetics Android release notes, browse the Kynetics Technical Notes.
Download releases of Kynetics Android here:
