Matrix Orbital GTT TFT Thermometer Stage 1

Breadboard (generic)

Matrix Orbital Center Positive 5V Adapter (optional)

DS18S20

Matrix Orbital DS18S20 Temperature Probe

Arduino UNO

Arduino IDE

Matrix Orbital GTT70A

Resistor 4.75k ohm

Matrix Orbital GTT GUI Designer

Matrix Orbital 4 pin Bread Board Cable

USB A to Mini-B Cable

Jumper wires (generic)

<div class="se-component se-video-container __se__float-none" contenteditable="false" style="width: 100%;"><figure style="width: 100%; height: 56.25%; padding-bottom: 56.25%; margin: 0px;"><iframe frameborder="0" allowfullscreen="" src="https://www.youtube.com/embed/A4d3_fNZMFM" data-proportion="true" data-percentage="100%,56.25%" data-size="100%,56.25%" data-align="none" style="width: 100%; height: 100%;" data-index="0" data-file-size="0" data-origin="100%,56.25%"></iframe><figcaption contenteditable="true"><div>Matrix Orbital GTT Thermometer in Action</div></figcaption></figure></div>Hello everyone! This project is meant to demonstrate how easy it is to interface a Matrix Orbital GTT Intelligent TFT HMI display with an Arduino Uno through I2C. A DS18S20 temperature sensor is used to obtain temperature information, which is then processed by the Uno. Once the Arduino processes the temperature information, it updates the GTT's bar graph, and label. <h3 >Hardware</h3><ul ><li >GTT Series Intelligent TFT HMI Display </li></ul><ul ><li >Arduino Uno</li></ul><ul ><li >Bread Board</li></ul><ul ><li >Male to Male Jumper cables</li></ul><ul ><li >4.7k Ohm resistor</li></ul><ul ><li >DS18S20 Temperature Sensor</li></ul><ul ><li >4pin Bread Board cable </li></ul><ul ><li >USB to Mini-USB cable</li></ul><ul ><li >Power Adapter (optional)</li></ul><h3 >Software</h3><ul ><li >GTT GUI Designer Software </li></ul><ul ><li >Arduino IDE</li></ul><h3 >Step 1: Designing the User Interface</h3>The GTT Designer Suite allows users to easily drag and drop widgets on screen. Images and font files can also be imported for use when creating GUI's. For this project, we've dragged in a Bar graph, 3 Image Toggles, a label, and a Thermometer image. The Bar graph is used to visually represent the current temperature. The label displays the current temperature value numerically. Two of the image toggles are used to indicate whether or not the Arduino and DS18S20 temperature sensor are connected and operating properly. Finally, the third image toggle allows users to turn the display's backlight on and off.You can download our free and fast GUI design software <a href="https://matrixorbital.ca/gtt-software">here.</a>The project files can be downloaded <a href="https://github.com/MatrixOrbital/GTT-Arduino-Thermometer-Demo/tree/master/GTTProject21">here</a><figure><img src=https://projects.arduinocontent.cc/99b11a5d-7f89-4b43-a483-4f44c751b203.png /><figcaption>Matrix Orbital GTT Thermometer GUI</figcaption></figure>Once the design is completed, the project can be deployed to the GTT. You'll need to connect your PC to the GTT's Mass Storage header, and hit &#34;Deploy&#34; in the GTT Designer. All the necessary files will be generated and deployed directly to the display.<h3 >Step 2: Connecting the GTT</h3>For this demo, we'll be using I2C to communicate between the Arduino Uno and the GTT. Using the Bread Board Cable, connect the 4 pin header to the GTT's I2C header. Then connect the Red Bread Board Cable lead to 5V power, and connect the Black lead to ground. The Yellow (SDA) and Green (SCL) leads need to be connected to the Arduino Uno's SDA pin (A4) and SCL pin (A5) respectively. No I2C pull-up resistors are required for communication with the GTT. Additional power can be applied through the displays barrel jack.<h3 >Step 3: Connecting the DS18S20 </h3>A 4.7k Ohm pull-up resistor must be placed in parallel with the D18S20's power and data pins, otherwise the sensor will be unable to communicate properly. The data pin can be connected to any digital pin on the Arduino; in this case we selected pin 2.<figure><img src=https://projects.arduinocontent.cc/10548345-9942-4ede-81e0-8401a34a63c8.png /><figcaption>Matrix Orbital GTT Thermometer Schematic</figcaption></figure><h3 >Step 4: Installing Libraries</h3>Before continuing, download and unzip the the following GTT Client Libraries. These libraries can also be found within the most recent <a href="https://matrixorbital.ca/f/gtt-rev2-0">GTT Firmware release</a>. Once downloaded, copy over the contents of GttClient into \\Users\\YourUserName\\Documents\\Arduino\\libraries\\gtt. <a href="https://github.com/MatrixOrbital/GTT-Arduino-Thermometer-Demo/tree/master/GTT%20Client%20Library">GTT Client Library </a><h3 >Step 5: Code</h3><pre ><code >//GTT Arduino Thermometer Demo Stage 1 //Arduino Uno with Matrix Orbital GTT70A and DS18S20 //Created by Divino, 19/04/2018 //support@matrixorbital.ca //www.matrixorbital.ca/appnotes #include &lt;gtt.h&gt; #include &lt;gtt_device.h&gt; #include &lt;gtt_enum.h&gt; #include &lt;gtt_events.h&gt; #include &lt;gtt_ext_types.h&gt; #include &lt;gtt_packet_builder.h&gt; #include &lt;gtt_parser.h&gt; #include &lt;gtt_protocol.h&gt; #include &lt;gtt_text.h&gt; #include &lt;Wire.h&gt; #include &lt;OneWire.h&gt; #include &#34;GTTProject21.c&#34; #include &#34;GTTProject21.h&#34; #define I2C_Address 0x28 //Define default 8bit I2C address of 0x50 &gt;&gt; 1 for 7bit Arduino // Buffer for incoming data uint8_t rx_buffer[64]; // Buffer for outgoing data uint8_t tx_buffer[64]; #include &lt;stdlib.h&gt; OneWire ds18s20(2); //sensor on pin 2 byte addr[8]; //Buffer to store One wire Address bool probeConnected; //Bool to determine indicate if the DS18S20 is connected gtt_device gtt; //Declare the GTT device void setup() { //Setup I2C bus gtt.Write = i2cWrite; //Set the write function gtt.Read = i2cRead; //Set the read function gtt.rx_buffer = rx_buffer; //Declare a buffer for input data gtt.rx_buffer_size = sizeof(rx_buffer); //Declare the size of the input buffer gtt.tx_buffer = tx_buffer; //Declare a buffer for output data gtt.tx_buffer_size = sizeof(tx_buffer); //Declare the size of the output buffer Wire.begin(); //Begin I2C communication Serial.begin(9600); delay(500); resetDisplay(); delay(3000); gtt_set_screen1_image_toggle_2_state(&amp;gtt, 1); //If the Arduino can establish communication with the GTT, Arduino connection indicator appropriately } void loop() { // put your main code here, to run repeatedly: probeConnected = searchForTempProbe(); //Search for the DS18S20 if(probeConnected){ //If the probe is connected int16_t temp = readTempProbe(); //Read the temperature char buf[] = {0}; sprintf(buf,&#34;%d&#34;,temp); //Convert the temperature value to a string gtt_set_screen1_bar_graph_1_value(&amp;gtt, temp); //Update the GTT bar graph gtt_set_screen1_dynamic_label_2_text(&amp;gtt, gtt_make_text_ascii(buf)); //Update the GTT label } else{ //If the probe isn't connected gtt_set_screen1_image_toggle_3_state(&amp;gtt, 0); //Set the probe indicator to &#34;Disconnected&#34; gtt_set_screen1_bar_graph_1_value(&amp;gtt, 0); //Set the GTT bar graph appropriately gtt_set_screen1_dynamic_label_2_text(&amp;gtt, gtt_make_text_ascii(&#34;NA&#34;)); //Update the GTT label to &#34;NA&#34; } } void resetDisplay() { Serial.println(&#34;resetting display&#34;); char command[] = { 254, 1 }; i2cWrite(&amp;gtt, command, sizeof(command)); } /* The Code used in the searchorTempProbe and readTempProbe function is * sample code taken from https://playground.arduino.cc/Learning/OneWire */ byte searchForTempProbe(){ ds18s20.reset_search(); if ( !ds18s20.search(addr)) { Serial.print(&#34;No more addresses.\ &#34;); ds18s20.reset_search(); delay(250); return 0; } Serial.print(&#34;R=&#34;); for( byte i = 0; i &lt; 8; i++) { Serial.print(addr[i], HEX); Serial.print(&#34; &#34;); } Serial.println(); if ( OneWire::crc8( addr, 7) != addr[7]) { Serial.print(&#34;CRC is not valid!\ &#34;); gtt_set_screen1_image_toggle_3_state(&amp;gtt, 0); //Set the probe indicator to &#34;Disconnected&#34; return 0; } if ( addr[0] == 0x10) { Serial.print(&#34;Device is a DS18S20 family device.\ &#34;); gtt_set_screen1_image_toggle_3_state(&amp;gtt, 1); //Set the probe indicator to &#34;Connected&#34; return 1; } else { Serial.print(&#34;Device family is not recognized: 0x&#34;); Serial.println(addr[0],HEX); gtt_set_screen1_image_toggle_3_state(&amp;gtt, 0); //Set the probe indicator to &#34;Disconnected&#34; return 0; } } byte readTempProbe(){ byte present = 0; byte data[12]; float temp; ds18s20.reset(); ds18s20.select(addr); ds18s20.write(0x44,1);// start conversion, with parasite power on at the end delay(750);// maybe 750ms is enough, maybe not // we might do a ds.depower() here, but the reset will take care of it. present = ds18s20.reset(); ds18s20.select(addr); ds18s20.write(0xBE);// Read Scratchpad for ( byte i = 0; i &lt; 9; i++) {// we need 9 bytes data[i] = ds18s20.read(); } temp = ( (data[1] &lt;&lt; 8) + data[0] ) * 0.5; temp= (temp * 9/5) + 32; Serial.print(&#34;Temp = &#34;); Serial.println(temp); return temp; } int i2cWrite(gtt_device* gtt_device, char* data, byte data_length) {//Write an array of bytes over i2c Wire.beginTransmission(I2C_Address); for (int i = 0; i &lt; data_length; i++) { Wire.write(data[i]); } Wire.endTransmission(); return 0; } byte i2cRead(gtt_device* gtt_device) { //Wait for one byte to be read over i2c byte data; Wire.beginTransmission(I2C_Address); Wire.requestFrom(I2C_Address, 1); if(Wire.available()&lt;1) { return -1; } else{ data = Wire.read(); Serial.println(data); return data; } } </code></pre>Download the <a href="https://github.com/MatrixOrbital/GTT-Arduino-Thermometer-Demo/tree/master/GTT_Arduino_Thermometer_Demo">GTT_Arduino_Thermometer_Demo.ino</a> file. Navigate to the GTTProject21&gt;Output folder, and grab the.c and.h files generated by the GTT Designer Suite. Place both files in the GTT_Arduino_Thermometer_Demo.ino source directory, then open the.ino file.<figure><img src=https://projects.arduinocontent.cc/0fcc4468-3f7e-4ec0-aafb-3bdc697fe5c2.png /><figcaption>Generated .c and .h file from the GTT Designer</figcaption></figure><figure><img src=https://projects.arduinocontent.cc/5bf94551-bdd9-40d5-aed0-93519a90da8c.png /><figcaption>.c and .h file in the Demo Source directory</figcaption></figure>If everything is setup properly, the.c and.h file will open along with the GTT_Arduino_Thermometer_Demo.ino code.From there, you can upload the program to the Uno. The GTT will reset immediately after the program is uploaded. After a few seconds, the Thermometer demo screen will be displayed on the GTT. The image toggles will be set, indicating the connection status of the Arduino and the DS18S20 probe. If the probe becomes disconnected at any point, the indicators will provide visual notification that no temperature probe can be found.

Project Schematic

GTT Arduino Thermometer Demo Github Repository

External TFT Enclosure

Matrix Orbital GTT TFT Thermometer Stage 1

This project demonstrates how easy it is to display temperature information on a Matrix Orbital GTT HMI using a DS18S20 and an Arduino Uno.