This shows you the differences between two versions of the page.
iot:labs:06 [2016/06/23 23:41] ioana_maria.culic created |
iot:labs:06 [2017/09/11 09:39] (current) alexandru.radovici created |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Lab 3: Light Blink ====== | + | ====== Lab 6: Connect and use an LCD ====== |
+ | In this project you are going to connect an LCD to your board and write a short message on it. | ||
===== What you need ===== | ===== What you need ===== | ||
- | * One Raspberry Pi connected to Wyliodrin STUDIO; | + | |
- | * One LED; | + | * One Raspberry Pi connected to Wyliodrin STUDIO; |
- | * One 220 Ohm resistor; | + | * One 16x2 LCD; |
+ | * One breadboard; | ||
* Jumper wires; | * Jumper wires; | ||
- | * Breadboard; | ||
- | {{ :iot2015:labs:leed.png?80 |}} | ||
- | {{ :iot2015:labs:resist.png?100 |}} | ||
- | |||
===== The Setup ===== | ===== The Setup ===== | ||
- | Connect the LED to the Raspberry Pi following the schematics in the figure. | + | {{ :iot:labs:lcd-expander.jpg?500 |}} |
- | + | The LCD in the kit is connected to a port expander (MCP23008). This allows the LCD to be controlled via the I2C protocol, thus reducing the number of pins you need to connect the LCD to. In this case, you just need to connect the expander to GND, 5V, SCL and SDA pins, according to the indicators on the expander. You can find the appropriate pins in the **Pin Layout** tab. You just need to connect the SDA port on the port expander with the SDA pin on the board and so on. | |
- | First of all, you need to distinguish the anode from the cathode. The LED has two legs: one is longer, that one is usually the anode and the shorter one is the cathode. Another way of identifying them is by looking inside the LED. There are two metal parts in it. The smaller one is connected to the anode and the bigger one is connected to the cathode. | + | |
- | {{ :iot2015:labs:ledblink.png?500 |}} | + | |
- | To understand the anode and the cathode of the LED, imagine these two following situations: | + | |
- | - The cathode is connected ,through the resistor of course, to the ground. This means that the anode will be wired to the GPIO pin, which has to be //High// in order to make the LED light up. | + | |
- | - The anode is connected to the VCC pin of the board. Which means that, should you want to light up the LED, the cathode has to be connected to the GPIO setted to //Low //. Don't forget this kind of a circuit also requires a resistor. | + | |
- | + | ||
- | To sum it up, although the position of the resistor is not fixed, it can can either connect the ground to the cathode or the anode to the GPIO pin, the cathode should be connected to the ground to obtain the usually desired behaviour. Meaning you want the LED to light when the GPIO is set to HIGH and not to light when the GPIO is set to LOW. If you put the legs the other way around, the effect will be the opposite. | + | |
===== The Code ===== | ===== The Code ===== | ||
- | Let's see the same application in three different programming languages. | + | {{ :iot:labs:lcd-simple-example.png?600 |}} |
- | + | You go to the Wyliodrin Applications page and create a new application. You name it and select Streams as programming language. Once created, you click on the new application's name to open it. | |
- | ==== Visual Programming ==== | + | |
- | First, you can try it out in Visual Programming. | + | |
- | Here's an example: | + | |
- | {{ :iot2015:labs:blink-application.png?300 |}} | + | |
- | The first two blocks will simply print on the screen the messages written inside them. | + | |
- | The // repeat while true// blocks will create an endless loop. Inside it, there will be the blocks that turn on and off the LED on the chosen pin. There is also a // delay// block, which will insert here a pause of 0.5 seconds between the // on // state of the LED and the // off // one. | + | |
- | + | ||
- | ==== Python ==== | + | |
- | + | ||
- | An important feature of Visual Programming in Wyliodrin is that you can easily get the Python code for your projects, just by clicking the // Show code// button. | + | |
- | <code python> | + | |
- | from wyliodrin import * | + | |
- | from time import * | + | |
- | + | ||
- | pinMode (0, 1) | + | |
- | + | ||
- | print('Led on pin 0 should blink') | + | |
- | print('Press the Stop button to stop') | + | |
- | while True: | + | |
- | digitalWrite (0, 1) | + | |
- | sleep ((500)/1000.0) | + | |
- | digitalWrite (0, 0) | + | |
- | sleep ((500)/1000.0) | + | |
- | </code> | + | |
- | + | ||
- | First of all, you need to import the //wyliodrin// and //time// modules that will allow you to use some simple functions. | + | |
- | + | ||
- | Firstly, you have to declare the pins you are going to use and their purpose. In this case, pin 0 is used as //OUTPUT//. This is what //pinMode(0,1)// does (1=OUTPUT, 0=INPUT). | + | |
- | + | ||
- | Next, there are the //print// functions that simply write the text in the shell. | + | |
- | + | ||
- | Another useful function is //digitalWrite//. The function receives as parameter the pin and the value. As you are doing a digital write, the value can be either 0 or 1. If the value is 0, the pin will have no current. If the value is 1, there is current. | + | |
- | The //sleep// function makes the program wait for the desired number of seconds. | + | First of all, you need to initialise the LCD. For this, you drag the **run** node and select **Fire once at start** so you make sure that once you run the application a first message is sent. This is only required to trigger the **init LCD** node, so you can assure there is no other message being sent again. For this, drag the **trigger** node and double click on it. |
- | All this code is enclosed within the //while True// loop that makes it to be run forever, until the application is stopped. | + | {{ :iot:labs:trigger-block.png?400 |}} |
- | ==== Streams Programming ==== | + | You need to set this node to **wait until reset**. This will make the node to send the first message and then wait until it receives a message containing the property **reset**, which will never happen. |
+ | Next, the **init LCD** node initializes the LCD. | ||
- | Now that you've seen both Visual and python, let's move on to Streams. | + | First of all, you need to require the **wyliodrin** module, which exposes some simple functions in order to control the LCD. Otherwise you would need to implement the protocol in order to control it. |
- | Streams is an inbuilt programming language used in Wyliodrin to create many complex IOT projects. | + | Once you have the **wyliodrin** variable, call the **LiquidCrystal** constructor in order to obtain a **LiquidCrystal** object. The constructer receives 0 as parameter. |
- | It is quite different from usual programming languages, and it can sometimes contain visual blocks as functions. | + | Why is the value 0 the parameter of the contructor? This type of LCD communicates with the Raspberry Pi board via that I2C protocol. Taking into account how the I2C protocol behaves, you would need to mention the bus specific to the LCD, that usually is 32. However, in order to be able to connect multiple LCDs at once, they have three jumpers which can be connected in order to represent values from 0 to 7, thus being able to identify eight different LCDs. This is the value you need to pass to the constructor, in this case, no jumper is connected so we passed the value 0. |
- | This programming language works not as an imperative one, but is based on data flow. The nodes will send messages to one another. You can look at these messages as JSON objects. Any message has two important fields: one will be the payload and a second one the topic. | + | {{ :iot:labs:init-lcd.png?400 |}} |
- | You go to the Wyliodrin Applications page and create a new application. You name it and select the Streams programming language, then, the example //Led Blink - Streams//. This will create an application that makes an LED connected to the pin 2 of the Edison blink. | + | What is new at the code presented above is the **context.global.lcd** structure. You need to use this because you want the **lcd** variable to be available from other nodes also (Display on LCD node) and **context.global** is a variable accessible to all the nodes, so you just set the lcd property and you will be able to use it from any other node. |
- | Once created, you click on the new application's name to open it. A new window will open to display it. | + | {{ :iot:labs:display-lcd-simple.png?400 |}} |
- | {{ :iot2015:labs:blink2.png?400 |}} | + | |
- | In this example, the //run// node will send a message every 1 second to the node that says //blink//. Look in its settings. The //payload// field will be a number, incremented by one. The //blink// node is the one which holds the visual blocks. Double click on the latter to see the function inside. It will be in Visual Programming. | + | |
- | {{ :iot2015:labs:blinkblocks.png?600 |}} | + | |
- | What it does is to set a variable //new message// with the value of the data sent from this node to the next one to come. Now, the very message is composed like this: take the payload sent from the first node and divide it by 2. Which means the new message will be either 1 or 0. The function returns just one of these values, depending on the case. | + | |
- | The last node is simply the digital write function. It will ask as a parameter the pin number, so double click on it and specify the pin you are going to use. On this pin, it will write the message that was previously composed. | + | |
- | ===== Tips & Tricks ===== | + | |
- | Usually the longer leg is the anode and the shorted one is the cathode. However, this is not standard, to make sure which is which, you should know that the cathode leg is always connected to the bigger part inside the LED. | + | |
- | ===== Add a button ===== | + | |
- | You can easily add a button to turn on and off the LED. | + | |
- | ==== What you need ==== | + | |
- | * One Edison connected to Wyliodrin; | + | The **display LCD** node is another function node which first clears the LCD, then prints a string on it. Notice that the global **lcd** variable is used. |
- | * Two 200 Ohm resistor; | + | |
- | * Six male-male jumper wires; | + | |
- | * One button; | + | |
- | * One LED. | + | |
- | ==== Schematics ==== | + | |
- | To connect it, just think about the button as a voltage divider, the same as for the thermistor. Look in the introduction to electronics to properly understand the concept. {{ :iot2015:labs:buton.png?400 |}} | + | |
- | ==== The code ==== | + | |
- | You won't need to use more than 3 blocks. | + | |
- | {{ :iot2015:labs:button.png?500 |}} | + | |
- | * one is the usual //run// | + | |
- | * read the digital pin to which the button is connected | + | |
- | * write its value on the pin where the LED is wired | + | |
===== Exercises===== | ===== Exercises===== | ||
- | - Connect two LEDs and one button that will light them up one by one. | + | - Use a temperature sensor and display the temperature on the LCD. |
- | - Use one LED to write SOS using the international morse code. {{ :iot2015:labs:international_morse_code.png?300 |}} | + |