All Collections
Knowledgebase
Installation of Developer Studio & AAF application on Devices
Installation of Developer Studio & AAF application on Devices
S
Written by Sierra Wireless
Updated over a week ago

Description:

  1. Download Developer Studio

  • Download AAF Developer Studio 2.0.0. Working with ALEOS 4.3.4 and above

Notes:

The Developer Studio is based on Eclipse and therefor a JVM version 1.6 is required. The official JRE of Oracle is recommended. If there is no JVM installed on the system, download the appropriate version for the system from Oracle's web site: https://www.java.com/en/download/

2. Install Developer Studio

  • Run DeveloperStudioALEOS.exe and select workspace

  • Create new project

2.1 Connect to the gateway

  • There are two ways to connect a device to the PC in order to use it with the Developer Studio: USB and Ethernet. Each way enables to create a TCP/IP connection, with a default IP address for the device:

  • Over USB the IP address of the device is 192.168.14.31 and the one of the pc is 192.168.14.100.

  • Over Ethernet the IP address of the device is 192.168.13.31 and the one of the PC is 192.168.13.100.

  • In the following documentation all the screenshots are done with an Ethernet connection

Step 1: Switch to the Remote System Explorer perspective by clicking on the icon in the toolbar. Create a new connection: right click in the Remote Systems view and select New Connection. A New Connection wizard automatically opens.

Step 2: The wizard's first step allows you to select the remote system type: select AirLink GX400 (General folder) and click on [Next]

Step 3: The wizard's second step allows you to set the host name: set it to the device IP address (by default 192.168.14.31 on USB and 192.168.13.31 on Ethernet).

Step 4: Click on [Finish]. The new system appears in the Remote System view.

Note: The connection to the device is done thanks to specific credentials. These credentials are not the same as the one used for AceManager. By default, these credentials are uasuser. Sierra Wireless gateways come without an AAF user password. Before using AAF, go to ACEManager, page Admin, Change Password to set up an AAF user password.

The AAF Development Studio (DevStudio) application uses this password to communicate with the gateway

Step 5:: Right click on the system icon in the Remote Systems view and select Connect.

Step 6:: A modal window opens asking for a user id and password.

Step 7: Click on [OK]. You are now connected to the device (successful connection is indicated by a green arrow in the system icon).

2.2 Launching the application

Step 1: Switch back to the Lua Embedded perspective. Right-click on the project and select Run As > Run Configurations modal window automatically opens.

Step 2: Enter a name in the Name field (for instance Hello_main).

Step 3: Click on [Run]. The application is uploaded into the connected device and executed through a shell. The standard output (and input) is redirected into a console within the IDE.

2.3 Installing the application

The application has been executed on the device but has not been installed in the ALEOS application container. It means that the application cannot run without the IDE launching it and being connected to the device. In order to make your application boot with a field device, you have to install it.

Step 1: Modify the main function of the application in the main.lua file so that the application can run in an infinite loop (replace the content of the file with the following code):

local sched = require 'sched'

local lib = require 'my_module'

local function main ()

lib.helloworld()

lib.default = "from ALEOS EAF"

while true do

lib.helloworld()

sched.wait(2)

end

end

sched.run(main)

sched.loop()

Step 2: Right click on the project and select Export... to open the Export Wizard. Select Sierra Wireless > Local Application Package. Click on [Next] to open the installation wizard

Step 3: Enter the version of the application, for instance 1.0. Select Host destination and the device on which you want to perform the installation.

Step 4: Click on [Finish]. The application will be downloaded to the device and installed into the Application Container. Switch to the Remote System Perspective and in the Remote System view unfold the App Container service to see the running application (decorated with a green arrow)

Verify on ACE Manager webpage

Did this answer your question?