Welcome Visitor:

Getting Started with Project Gamma

Congratulations on acquiring a Project Gamma. Now you'd like to know how to use it. Well, good news: it's not that hard.

Step one - Install the development environment

First you will need the development environment to be able to write software. Project Gamma is fully supported by UECIDE and, in the near future, the Arduino IDE. We will detail how to use UECIDE since it is our preferred environment.

  1. Download UECIDE. Visit https://uecide.org/download and grab your preferred installation type for your chosen operating system.
  2. Install the Project Gamma board and chipKIT core and compiler. If this is your first time running UECIDE it will prompt you to install boards - otherwise you should use the Plugin Manager located in the Tools menu to install the board.
    • Once in the plugin manager press the Refresh button to make sure you have the latest set of plugins listed
    • Browse to the Boards -> Majenko Technologies section of the tree and select Project Gamma. Hit the Install button.

It can take a little while to install all the prerequisites, including the compiler, so have patience. Once finished you can close the Plugin Manager window and select the Project Gamma board in Hardware -> Boards -> Majenko Technologies -> Project Gamma.

You're now ready to start programming your Gamma!

Step two - Hello world

The TFT is supported by DisplayCore, so working with it is pretty simple and straight forward. The required libraries should have been installed at the same time as the board for you.

To get a "Hello World" example going is as simple as instantiating and starting a GammaTFT object, turning on the back light, clearing the screen, and printing "Hello World" at a location of your choosing. Here's how it looks:

#include <Gamma.h>

GammaTFT tft;

void setup() {
    tft.initializeDevice();
    tft.setBacklight(255);
    tft.fillScreen(Color::Black);

    tft.setTextColor(Color::Red);
    tft.setCursor(100, 100);
    tft.print("Hello World");
}

void loop() {
}

Step three - connecting and uploading

You will need a USB Micro cable to connect Project Gamma to your computer. Owing to the thickness of the mounting bracket it is recommended that you use a cable that has a low profile to make it easier to fit (such as pictured right).

Connect the USB cable to the outer-most USB socket on Project Gamma. Your computer should then identify a new COM port automatically (on all modern operating systems).

You should now be able to select that COM port in the Devices section of the Hardware menu in UECIDE. Then pressing the Upload button in the toolbar (second from the left) will compile the program and should automatically upload it to the connected board.

Congratulations. You have now programmed your Project Gamma. From here the world is your edible mollusc of choice.

Further reading

You can see all the DisplayCore API documentation and what functions are available here.

Like0 Dislike0
superannuation