6. The Wubby IDE

Wubby IDE is an eclipse based, dedicated development environment for Wubby. Through the Wubby IDE users can develop Python 3 applications for their Wubby enabled devices, upload them on the Wubby Cloud and install them in their devices.

The Wubby IDE includes:

  • A Python editor with syntax highlighting, auto indenting, multi-tab support.
  • An integrated serial port monitoring.
  • Direct upload of developed project to the Wubby Cloud
  • Direct installation of the developed application into the device.
  • Direct installation of the Wubby VM into the device.
  • Integrated documentation.
  • Example applications for the supported platforms.

6.1. Overview

The Wubby IDE consists of the following elements:

  • Main menu Contains all the possible actions (New File/project, Install, etc)
  • Toolbar menu Contains a subset of all the possible actions
  • Project Navigator Shows all the developed projects that exist within the workspace
  • Python Editor The main editor
  • Serial Viewer Monitors the serial port
  • Log Viewer Prints log messages
_images/ide1.png

6.2. New Wubby Project

The first step when developing a new application for a Wubby enabled device is to create the corresponding project. To do so, the developer has to select from the top menu File –> New –> Wubby Project or from the toolbar menu Project_newIcon.

_images/newProject1.png

The user has to enter a project name and select the platform that corresponds to his Wubby device.

The newly created project will appear in the Project Navigator. The existing examples for the platform he selected will appear, too.

_images/newProject2.png

6.3. Installing the application to the device

The Wubby IDE provides the ability to install a new application to the device either through the Wubby Cloud or locally. If the user selects to install the application through the Wubby Cloud, it will first be uploaded to the Cloud and then installed to the device. This way, it will be immediately available for installation through the Wubby Client, too.

6.3.1. Local Installation

The installation of an application directly to a Wubby enabled device through the Wubby IDE is performed using the UART interface of the device.

To start the local installation process the user has to select Project–> Install App –> Local Install from the main menu or localInstallicon from the toolbar menu and follow the wizard steps.

Note

If the serial viewer is open, it will be closed since the same port has to be used for the local installation. If you use a different serial control application you should make sure that you close the port before starting the local installation process.

_images/ideLocalInstall1.png

The first step of the wizard is to select the application to be installed and the USB port that will be used.

_images/ideLocalInstall3.png

After you press finish an information message will appear driving you to the next step of the process: press the RESET button on the device and then keep the SW2 button (this corresponds to the Evaluation Kits supported so far) pressed for about 3-4 seconds to initiate the installation process on the device. After some seconds the process completes. A message will appear in the IDE informing you about the completeness of the process.

_images/ideLocalInstall2.png
_images/ideLocalInstall4.png

Then press the RESET button on the device so that it starts executing the application.

_images/ideLocalInstall5.png

In case that something went wrong an information message will appear. For example, if the process does not start within a specific timeout the following message will appear.

_images/ideLocalInstall_timeout.png

6.3.2. Cloud Installation

To upload the developed project to the Wubby Cloud the user has to select Project–> Install App –> Cloud Install from the main menu or cloudInstallicon from the toolbar menu and follow the wizard steps.

The first step is the selection of the project to be uploaded.

_images/ideUpload1.png

The second step is to connect to the Wubby Cloud. To do so, the user has to enter the credentials of his developer account. If he doesn’t own a developer account he has to register himself using the Wubby Client.

_images/ideUpload2.png

If the credentials are correct, the wizard will proceed to the next step which is the selection of the device where the application will be installed. A dropdown list with all the registered Wubby enabled devices will appear.

_images/ideUpload3.png

During the upload of the application, information messages will appear in the “Log Viewer”.

6.4. Installing the Wubby VM

One of the supported services of the Wubby IDE is the installation of the Wubby VM (see Wubby VM Tutorial) to a Wubby enabled embedded device. Moreover, if the device has never been flashed before, a bootloader is needed to be loaded. This is needed only once, just for the first flash of the device.

The user has to select either Project–>Install Wubby VM from the main menu or select toolbarWubbyVM from the toolbar. In both cases, the user has first to select the platform that corresponds to his Wubby device.

Note

You can download the binary Wubby VM (mp_prog) and the corresponding bootloader (mp_bootloader) that suits your platform from here: Broadcom BCM943362WCD4 Wi-Fi module , Murata Type YD Wi-Fi module

Note

In order to have access to the device make sure you have prepared it properly following the instructions of section Instructions for the Cypress BCM943362WCD4EVB WICED Dev. Board Kit.

_images/ideInstall1.png

While the installation is in progress, information messages appear in the “Log Viewer”.

_images/ideInstall2.png

6.5. Configuring the WiFi settings of the device

When you first get a Wubby enabled device, it comes with preconfigured WiFi settings (ssid and passphrase) which probably do not match the settings of your access point. In order to set your own WiFi settings to the device select the Wi-Fi-icon from the toolbar and enter the settings.

_images/ideWiFi.png

Then, there is a process similar to the local application installation (see Local Installation): press the “Reset” button on the device. Then, keep the SW2 button (this corresponds to the Evaluation Kits supported so far) pressed for about 3-4 seconds. After some seconds the process completes. A message will appear in the IDE informing you about the completeness of the process. Then, press the “Reset” button on the device again and it will try to connect to the selected WiFi network.

6.6. The Serial Viewer

Wubby IDE provides a serial monitoring view where all the messages (if any) printed by the Wubby device are shown. Those messages include both those printed by the Python application running on the device, as well as information messages printed by the Wubby VM.

Note

In order to have access to the device make sure you have prepared it properly following the instructions of section Instructions for the Cypress BCM943362WCD4EVB WICED Dev. Board Kit.

To open the Serial Viewer select either Tools–>Serial Viewer from the main menu or icon_serial from the toolbar and from the dropdown list the select the USB port where your device is connected.

The Serial Viewer will open at the right side of the editor area. You can open/close the viewer anytime you like. You can also clean the Serial Viewer area by pressing the icon_clear_console button on its toolbar.