Gecko OS Studio Quickstart
Follow the steps below to prepare your device and set up your Gecko OS development environment for developing Gecko OS Apps.
- Download Gecko OS Studio (GSS)
- Install GSS
- Get Started with GSS
Note: You can use the GSS to set up your device with the latest Gecko OS firmware.
Special terms used in Gecko OS documentation
- GSS - Gecko OS Studio.
- App - in the Gecko OS context, app refers to a Gecko OS Native 'C' API application.
- The current GSS version does not support file or directory names containing spaces.
Download GSS for your operating system:
Run the downloaded executable to install GSS. The installer removes and replaces any previous version.
Getting Started with GSS
In this version you can click
Skip Log in to go directly to the
Selecting Your Device
Device in the menu to open the Device screen:
Connect the device to the USB socket and power it up. GSS detects the device:
Select the device in the list of devices found. GSS opens the Projects screen:
Setting Up Your Device
Select AEM Power Source
The WGM160P_WSTK power source selector switch should be set to the AEM (Advanced Energy Monitor) position. The AEM provides features required by the GSS.
Setting Up Your Device with Gecko OS
On GSS, click the
Setup Device with Gecko OS button to flash the latest version of Gecko OS to your device.
This is optional. If your device is already set up with Gecko OS, or you intend to build a Project and download the image to your device, there is no need to set up your device.
The GSS takes a few seconds to set up your device.
Device Ready notice appears, your device has a standard Gecko OS image for your platform.
You can now connect to the device via the UART and use the Command API. See Opening a Gecko OS Terminal.
When you move to other GSS screens, the
Setup Device with Gecko OS button appears again. There is no need to set up the device again.
You can also move on in GSS to create a project, build it and download it to your device.
We demonstrate building and downloading a project with the
Hello World example project.
Clone Example screen,
- specify workspace path
- scroll down and choose the
GSS creates the project, showing progress:
Finally the Project Created screen appears.
In the workspace, GSS has created the
sdk-WGM160P directory containing sdk files, and the
hello_world project directory.
Open Project to open the project directory. You can view and edit the project source files in the IDE or text editor of your choice. For example, here is main.c:
When you are ready to build, in the
Project Created screen, choose
Program Selected Board to build the project and write the hello world code to the device.
The hello_world app runs each time the device reboots.
To view the output you can use a serial terminal program such as TeraTerm. See Opening a Gecko OS terminal.
In the case of the
hello_world project, the App prints "Hello world!!" to the terminal.
[Ready] > Hello world!!
Browse the basic and demo examples to see how Gecko OS Native C APIs are used in a range of applications. You can clone an example even when you have no physical development platform. Just choose the required target platform, clone the example and press
Open Project in the
Project Created screen.
Using the IDE
To install the Integrated Development Environment (IDE), choose the
Tools tab and click
Install Gecko OS IDE.
With the IDE installed, you can choose
Open in IDE in the
Project Created screen.
In the IDE you can edit, build, download, run and debug your App.
To build your app in the IDE, in the Project Explorer panel,, right click on the project to build. In the context menu, choose
Gecko OS. In the
Gecko OS menu, select the build options you require.
The IDE builds the project and displays output in the build console.
When you choose the
Build / Download / Run option with a board connected, the compiled image is downloaded to the board and runs.
If you have a Gecko OS terminal connected to the board port, the App output appears on the terminal:
Download Resources option on the project
Gecko OS menu to download resources to your Gecko OS device. Resources include the webapp, wifi firmware and other resources related to Gecko OS and your App.
Restrictions on Command Line Make
Due to GNU make limitations, the following characters cannot be used in a password from the command line target:
make login USER=<user> PASSWORD=<pass>
$( dollar-sign character)
#(hash or pound-sign)
The recommended work-around is to use either:
(i.e. don't provide un/pw on command line but instead launch login dialog)
- Update DMS password to a password without the disallowed characters