# 8x32 RGB LED Screen - Dynamic Effects Tutorial

This tutorial is about programming the RGB LED Screen to display animated text or icons.

### Wiring

RGB LED Screen is used with the Robotbit, please refer to the following figures.

#### 1. Connect the screen to the adapter.

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/matrixtoadapter.jpg)

#### 2. Connect the adapter to Robotbit

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/adaptertorobotbit.png)

#### 3. For prolonged use, connect a USB power.

As power is delivered via USB, you don’t have to use the 5V pin on the adapter.

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/usb1.jpg)

#### 4. Demonstration of wiring

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/usbpower.jpg)

### Makecode Coding Tutorial (Only for Offline Version of MakeCode)

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/mcbanner2.png)

It is troublesome to display text or images using NeoPixel, therefore Kittenbot has developed NeoMatrix to make it easy for users.

#### (This plugin is only supported in offline MakeCode)

Download Kittenbot’s MakeCode：<https://www.kittenbot.cn/software>

#### 1. Load NeoMatrix Extension

NeoMatrix Extension: <https://github.com/KittenBot/pxt-neomatrix>

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/210.png)

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/ext.png)

**NeoMatrix blocks:**

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/blocks.png)

```
Warning! This is incompatible with Powerbrick extension, only use Robotbit.
Powerbrick only supports the included RGB module.
```

#### 2. Enter NeoMatrix Editor

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/edit.png)

Choose type of screen.（16x16/8x32）

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/editor11.png)

Enter text in the Text Content Box, and then click Render Text.

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/hello.png)

Draw by filling the squares. (Click to color, double click to clear.)

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/editor2.png)

Add another frame by clicking Add Frame.

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/editor3.png)

Auto-generate pattern by clicking Open Image.

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/bianjiqi4.png)

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/glasses.png)

Finish your frames then click Matrix Panel in Output column to generate the blocks.

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/editor4.png)

Return to MakeCode Editor, a block called Show Frame will appear.

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/editor5.png)

#### 3. Coding

#### Animation with single frame

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/code23.png)

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/1frame.gif)

[Sample Code Download](https://bit.ly/LEDMatrixT2_02Hex)

[Sample Code Link](https://makecode.microbit.org/_37yRrvXKcFeu)

#### Animation with two frames

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/code32.png)

![](https://kittenbothk-eng.readthedocs.io/en/latest/_images/2frame.gif)

[Sample Code Download](https://bit.ly/LEDMatrixT2_03Hex)

[Sample Code Link](https://makecode.microbit.org/_DRheuAWbJcpo)

### Extension Version and Updates

There may be updates to extensions periodically, please refer to the following link to update/downgrade your extension.

[Makecode Extension Update](https://kittenbothk-eng.readthedocs.io/en/latest/Makecode/makecode_extensionUpdate.html)

### FAQ

Q: Why is red the only colour lit up when I try to use different colours?

A: There is not enough power.

Solution: Reduce brightness or turn on the power on the Robotbit, or connect to a USB power.

### Precautions

* Do not connect a power supply with a voltage higher than 5V.
* Connect to a USB power supply when for prolonged use.
* Lower the brighness when a lot of LEDs are lit.
* This product is suitable for users aged over 14, children aged 8-14 need to be under the supervision of an adult when using this product.
* Please refer to Kittenbot’s official guidelines before using, wiring must follow the guidelines, do not use a high power servo or motor when using this product.
* To avoid short circuiting, do not put this product on conductive surfaces such as metal.
* To avoid short circuiting, do not put this product in water.
* Do not touch the exposed wires with bare hands.