View source for 24x8 LED Dot Matrix Module - Emo


==Introduction==
[[File:Emo01.png]]

Controlled by MCU, the EMO is an 24x8 LED dot matrix display module in white color. It obeys the protocol of SPI and will refresh the module automatically which could avoid occupying the refresh interruption of the control board. <br>

The EMO provides two acrylic sheets. One of the acrylic stick at the LED is used for shading. The other acrylic sheet can be used as a holder.<br>
<span style="color:red">Note: When the Emo dot matrix display is working, don't touch the hot pin header at the back side. It's normal of the pin header being hot because the work rate is high-energy consumption.</span><br>

==Schematic diagram==

[[File:Emo2.png]]
<br>

==Using the Emo with Raspberry Pi==
<span style="color:red">Note：The Emo is high-energy consumption. Before using it ,you may need to prepare an external power. When applying the external power, you need to connect the GND of power to that of the Raspberry Pi.</span><br>

===Step 1: Connect the Emo and the Raspberry Pi===

{| border="1" class="wikitable"
|-
! scope="col" |Emo
! scope="col" |Raspberry Pi
|-
|align="center"|VCC
|align="center"|3.3V
|-
|align="center"|GND
|align="center"|GND
|-
|align="center"|MOSI
|align="center"|MOSI
|-
|align="center"|MISO
|align="center"|MISO
|-
|align="center"|SCLK
|align="center"|SCLK
|-
|align="center"|CS
|align="center"|CE0
|-
|align="center"|VLED
|align="center"|5V
|-
|align="center"|GND
|align="center"|GND
|}

[[File:Emo9.png]]

[[File:Emo10.png]]


===Step 2: Type in sudo raspi-config to open the Raspberry Pi’s SPI:===
 sudo raspi-config
Then select <span style="color:red">3 Interfacing Options -> P4 SPI -> yes</span>

===Step 3: Download the SunFounder Emo package by git clone command:===
 cd ~
 git clone https://github.com/sunfounder/SunFounder_LED_Matrix.git
===Step 4: Then get into the directory and execute the sample code by Python command:===
 cd ~/SunFounder_LED_Matrix/examples/
 python3 animate.py
When the module works normally, you can see different emoji display on the Emo circularly.<br>
[[File:Emo11.jpg]]

===Code Explanation===
SunFounder_LED_Matrix<br>
├── animate.py<br>
├── led_matrix.py<br>
├── LICENSE<br>
├── maps.py<br>
└── test.py<br>

{| border="1" class="wikitable"
|-
|align="center" |led_matrix.py
|align="center" |The python file of the Emo, you need to import it when you use the Emo.
|-
|align="center"|animate.py
|align="center"|A sample code file
|-
|align="center"|maps.py
|align="center"|Some pre-set Emoji in the Emo. You can check the details by the following print_supported() method after creating the LED_Matrix sample.
|}

Type in the following to check the supported emoji:
 lm = LED_Matrix()
 lm.print_supported()

<span style="color:OrangeRed">class LED_Matrix</span><br>
To classify the emoji<br>
<span style="color:OrangeRed">show_string(s, pos=0)</span><br>
To show the string, pos is the position of the string<br>
 def test_character():
    lm = LED_Matrix()
    value = ';) :( :D'
    value_len = lm.map_len(value)
    for i in range(value_len):
        lm.show_string(value, -i+10)
        time.sleep(0.1)

<span style="color:OrangeRed">show_emo(emo)</span><br>
To show the emoji. “emo” is the pre-set emoji in the Emo. Emoji will be shown on the whole Emo display, so we need to set different position and value for every emoji in the Emo. And set a delay for the emoji show up, thus we can see it clearly just like watching animation.<br>
 def test_animate():
    lm = LED_Matrix()
    lm.show_emo("pac_man1")
    time.sleep(0.8)
 
    lm.show_emo("pac_man2")
    time.sleep(0.8)
 
    lm.show_emo("pac_man3")
    time.sleep(0.8)

==Using the Emo with Dragit==
You can object oriented programming on the visual programming language software Dragit to the Emo. For tutorial please refer to [http://wiki.sunfounder.cc/images/d/d5/Using_Emo_with_Dragit.pdf '''Using Emo with Dragit.pdf'''][[File:PDF.jpg]]<br>

==Using the Emo with Arduino==
<span style="color:red">Connect the Emo to the Arduino board may lead to the shortage of power supply. So it is better if an external power supply is added, such as battery holder, power adapter or input from the black power jack.</span><br>

====Step 1. Download the library====
Download the library [http://wiki.sunfounder.cc/images/1/1c/SunFounder_Emo.zip SunFounder_Emo][[File:ZIP.jpg]]<br>

====Step 2. Install the library====
Open the Arduino software, and select <strong>Sketch -> Include Library ->Add .ZIP Library.</strong><br>

[[File:Emo3.png]]

<br>
Go to the directory where you stored the package file, select the SunFounder_Emo.zip and click Open.<br>

[[File:Emo4.png]]
<br>

====Step 3. Open the example====
Go to <strong>File -> Examples -> Sunfounder Emo -> emo_animate</strong><br>

[[File:Emo5.png]]<br>

Click <strong>Upload</strong> to burn the code to the Arduino board. <br>
After the code is uploaded successfully to the board, you can see the emoji on the Emo. <br>

====Step 4: Connect the Emo to the Arduino Uno====
{| border="1" class="wikitable"
|-
! scope="col" |Emo
! scope="col" |Arduino Uno
|-
|align="center"|VLED
|align="center"|5V
|-
|align="center"|VCC
|align="center"|5V
|-
|align="center"|GND
|align="center"|GND
|-
|align="center"|MOSI
|align="center"|MOSI(Pin11)
|-
|align="center"|MISO
|align="center"|MISO(Pin12)
|-
|align="center"|SCLK
|align="center"|SCLK(Pin13)
|-
|align="center"|CS
|align="center"|Pin10
|-
|align="center"|GND
|align="center"|GND
|}

[[File:Emo6.png]]

===Tips:===
<span style="color:red">You can connect pin CS to any digital output pin. Here pin 10 is selected. Remember to change the pin number in the code if you use other pins. <br>
The position of pin SPI is different from various Arduino boards. Refer to the following page for details:</span><br> 
https://www.arduino.cc/en/Reference/SPI

<strong>Then you will see many emoji display on the Emo.</strong><br>

[[File:Emo7.jpg]]

===Code explanation: ===
 #include <SunFounder_Emo.h>
 #include <emo_maps.h>  // some emotions
At the beginning of coding, include the Emo library and the data of emoji expressions.<br>
The emo_maps.h file includes some pre-set emoji available for the Emo. Data of each emoji is stored via an array of hexadecimal numbers. You can also design the emoji by yourself. Please refer to the DIY emoji tutorial as shown below.<br>

 Emo my_emo(10);  // CS pin
When the Emo instance is created, the parameter is the number of the CS pin. In the example, pin CS connects to pin 10. If you connect to any other pin, DO CHANGE the pin number here accordingly.<br> 

  void loop() {
    my_emo.show_emo(sleepy1);  // sleepy1 is emotion data in emo_maps.h
    Serial.println("sleepy1");
    delay(500);
    my_emo.show_emo(sleepy2);
    Serial.println("sleepy2");
    delay(800);
    my_emo.show_emo(sleepy3);
    Serial.println("sleepy3");
    delay(800);
Use the show_emo() method in the my_emo instance, and the emoji can be shown on the Emo. <br>
The parameter this method function needs to transfer is the name of emoji stored in the emoji package emo_maps.h. You can open the file to check the name of the pre-set emoji. <br>

===DIY emoji tutorial ===
Now let’s learn how to do the emoji or characters in accordance with your own idea. Open the file of emo_maps.h in library SunFounder Emo. This is the file for saving emoji. Then find the array const byte sleepy1[24].<br>
[[File:Emo8.png]]

You will see it has 3 column and 8 line, 3 column stands for 3 LED dot matrix, 8 line means there are 8 lines of the dot matrix. Now rewrite them at the form of binary.<br>

[[File:emobiaoge.png]]

Then you will see the picture as shown above.<br>
You can draw a chart with 24 column and 8 line, and then point the dot as shown in the picture. The place that need to be displayed is 1, otherwise is 0. Then change into hexadecimal and save into emo_maps.h. Open my_emo.show_emo(sleepy1) if you want to display it. Easy, right? Let’s try it now. <br>

==Using Emo with Mixly==
You can object oriented programming by visual programming language software Mixly to Emo, for tutorial you can refer to [http://wiki.sunfounder.cc/images/8/85/Using_Emo_with_Mixly.pdf'''Using Emo with Mixly.pdf'''][[File:PDF.jpg]]<br>
Library download:
[http://wiki.sunfounder.cc/images/c/cb/Sunfounder_emo_Mixly.zip Sunfounder_emo_Mixly.zip][[File:ZIP.jpg]]