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.

  1. Download Gecko OS Studio (GSS)
  2. Install GSS
  3. 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

Special Notes

Downloading GSS

Download GSS for your operating system:

Installing GSS

Run the downloaded executable to install GSS. The installer removes and replaces any previous version.

Getting Started with GSS

Open GSS.

In this version you can click Skip Log in to go directly to the Welcome screen.

Selecting Your Device

Click 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.

When the 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.

Hello World

We demonstrate building and downloading a project with the Hello World example project.

Choose Clone Example:

On the Clone Example screen,

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.

Choose 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:

Downloading Resources

Choose the 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>

The recommended work-around is to use either: