Close
0%
0%

Arduino, HT16C32, and the Library

While a simple example of putting a 8x32 matrix on an Arduino, a more in-depth look at a library for the noobs and non-career- programmers.

peterPeter
Following
Liked Like project

Just one more thing

To make the experience fit your profile, pick a username and tell us what interests you.

Pick an awesome username
hackaday.io/
Your profile's URL: hackaday.io/username. Max 25 alphanumeric characters.
Pick a few interests
Projects that share your interests
People that share your interests

We found and based on your interests.

Choose more interests.

OK, I'm done! Skip
Similar projects worth following
1.5k views
0 comments
2 followers
View Gallery
My background isn't in programming or engineering but I my career is in computers and networking. A couple of years back I started with a generic Uno and I keep learning and delving deeper into the micro controller world. I like the hardware side much better, but software kind of goes hand in hand.

It can be frustrating to have a device and not find a lot of information pertaining to it. No being sure of how to program it to do something. While usually there is a readme and keywords file, sometimes there is not. The worst can be an example of how to program the device and the example doesn't work. What to do? Fix it I say. Let see how to start.

This is geared towards the newly initiated in the world of Arduino, but I hope others will stop and take a read as well. 

Here I am going to use a simple project to cover this subject. I have an Arduino Nano and 8x32 controlled by a HT1632C. This project is focused on the library used by the Arduino IDE and HT1632. 

While this is a well put together library, there were a couple of items I had to check on and wanted to share some of the knowledge to help and inspire others. A note to all of the real engineers and programmers out there, I welcome constructive criticism and corrections. I want to help some other soul out there who is just dying to get a project put together but can't find quite all the information they need. 

At this point I am going to make a note that the data sheet of any device / chip will provide some very useful details. I highly recommend you take a look. Even if you don't know what everything means, it is another place to start learning; but that is for another article. 

What is a Library?

According to the Arduino site, the definition of a library is

"Arduino Libraries

Libraries are files written in C or C++ (.c, .cpp) which provide your sketches with extra functionality (e.g. the ability to control an LED matrix, or read an encoder, etc.)."

Within these files lies all of the information needed to grasp control of said device. Most of libraries will have a decent README file laying out how to setup the program, the device, options available, and a word or two of advice. Others might be short on the README but long on the comments in the examples. And others might leave you high and dry and your kind of left poking around to find what you can. This guide will hopefully get you started on that path if need be; or if you are just a curious mind and need to know more. 

Included in an usual Arduino library are the following files:

  • device_name.h - the header file. This is the file declared in the "#include" statement. And  what can be done with the device.
  • device_name.cpp - the source file. This is the code the C compiler works with. The .h file is not used directly, but is copied if "#included" in the .cpp file. 
  • keywords.txt - commands for programming and Arduino IDE coloring of class and member
  • README - a little or a lot of info
  • examples directory - a quick look at what it can do

Let's get wired

Now here is how the HT1632 panel is wired to the Arduino. In this case I have used a Nano, but the pins assignments are the same. Up to 4 panels are supported, but being I only have one on hand here it is. 

The core of the matter

Off the bat, here is the scoop. To complete this project you must have the Arduino IDE installed.

Download the library HT1632-for-Arduino. One can either download the library from GitHub through a web browser with the link above, or if you have GitHub installed on your computer that can be used as well. 

Install the library in the Arduino IDE.  From the menu Sketch -> Include Library -> Add .ZIP library. Once the selection window appears, navigate to where the .zip file is, select it, and click Choose. 

This library is a bit different than some as it must be edited to declare what type of display is being used. This edit is done in the HT1632.h file. It includes instructions on how to edit the file for your panel. Be and sure to edit the file in the library directory being used. This can be done with any text editor. I used BBEdit to make sure it is set to:

// SureElectronics 32X08 Monochrome LED Dot Matrix Unit Board
#define TYPE_3208_MONO 1

In the Arduino IDE, open the example sketch from the File menu. 

... Read more »

View all details

8x8_vid.m4v

A quick demo of the hardware and program

x-m4v - 11.83 MB - 09/05/2019 at 01:06

Download

8x32_HT1632_Demo.ino

This is my highly commented code for this project.

ino - 1.16 kB - 09/05/2019 at 00:41

Download

  • 1 × Elegoo Arduino Uno Arduino Uno
  • 1 × 8x32 LED matrix HT16C32 Actuall 4 8x8 panels on one board
  • 1 × Jumper wires :: Female - Male

  • Nano Pinouts

    Peter • 09/05/2019 at 19:21 • 0 comments

    The source URL for this image is included in the Links/reference section. 

  • Example sketch - with lots and lots of comments

    Peter • 09/05/2019 at 01:05 • 0 comments

    Here is my commented code for an example of using an Arduino Nano with a HT1632C 8x32 panel. 

    // Libraries needed for the demo
#include <HT1632.h>
#include <font_5x4.h>

// Set the variables
// integers
int i = 0;
int wd;

// a string of characters to display
char disp [] = "Welcome to TVLand!";

void setup () {
  // Which pins is the display using. 
  // The pin order is (CS1, pinWR, pinDATA)
  HT1632.begin(9, 10, 11);

  // Setting up the font
  wd = HT1632.getTextWidth(disp, FONT_5X4_END, FONT_5X4_HEIGHT);
}

void loop () {
  // Original code - drawTarget not a keyword
  // HT1632.drawTarget(BUFFER_BOARD(1));
  // Below, renderTarget, reflects the updated library - v2.0,
  // which screen to send the data to. There can be up to 4 panels.
  HT1632.renderTarget(1);
  
  // Clear the RAM buffer for the display
  HT1632.clear();
  
  // OUT_SIZE, FONT_5X4, FONT_5X4_END, FONT_5X4_HEIGHT
  // All of the above variables come from the font.h file
  // OUT_SIZE is the width of the display
  HT1632.drawText(disp, OUT_SIZE - i, 2, FONT_5X4, FONT_5X4_END, FONT_5X4_HEIGHT);
  
  // Display the contents of RAM to the screen
  HT1632.render();

  // Scrolling the text from right to left
  i = (i+1)%(wd + OUT_SIZE);

  // a quick pause before cycling through
  delay(100);
}

View all 2 project logs

Enjoy this project?

Share

Discussions

Similar Projects

"BlackMath" is a small DSP board, based on Blackfin BF592A, using an Arduino-compatible as loader and PC interface.
Project Owner Contributor

BlackMath

marcellus-pereiraMarcellus Pereira

uGFX was written for use with makefiles. Using it in arduino is possible with minimal effort, though. Here's how.
Project Owner Contributor

using uGFX in Arduino

christophChristoph

Using some external software we an easily get the code back from Arduino, but this time the code is in the form of HEX file
Project Owner Contributor

How to Get Code/ Program back from Arduino

lithium-ionLithium ION

Arduino library that allows to include any file into your Arduino project
Project Owner Contributor

incbin - Include any files in Arduino project

alexanderAlexander

Does this project spark your interest?

Become a member to follow this project and never miss any updates

Going up?

About Us Contact Hackaday.io Give Feedback Terms of Use Privacy Policy Hackaday API

© 2024 Hackaday

Yes, delete it Cancel

Report project as inappropriate

You are about to report the project "Arduino, HT16C32, and the Library", please tell us the reason.

Send message

Your application has been submitted.

Remove Member

Are you sure you want to remove yourself as a member for this project?

Project owner will be notified upon removal.