SimpleExpressions: Make your robots cute and noisy

This library simply takes a 7 LED Circle module and a buzzer to do lots of funny things, see for yourself. The reason I made this was that I wanted to have a simple way to make combine mouths and sounds on this funny little Robots

You can buy these little ws2812 circles for a dollar or two at aliexpress and other china marketplaces and they are a really simple way to make some funny output. And a beeper or buzzer is available literally everywhere.

Dependencies

Internally the library uses the Adafruit NeoPixel Library, so make sure you have this one installed

Install

The library can be installed manually (by unzipping and copying the files to the "libraries" directory) or using the Arduino Library installer, there is not to much to care about, just make sure the Adafruit NeoPixel Library is also installed.

Supported Platforms

The sound are taken from BQs Zowie. The Library supports all Arduino boards (that are compatible with the NeoPixel Library) and also the ESP8266 and ESP32

Functions

Just see the example how everything works together

SimpleExpressions.init(ledPin, buzzerPin); Initializes the library with the given pins
SimpleExpressions.clearMouth(); Clears the mouth and sets all pixels off
SimpleExpressions.printMouth(mouthNumber, red, green, blue); Prints a mouth by its number and using the given color, useful to iterate through all of them (use frameCount or colorFrameCount to determine the maximum number) (use without the colorvalues for multicolor mouths)
SimpleExpressions.writeMouth("cross", red, green, blue); Does basically the same but you can select the mouth by its name (use without the colorvalues for multicolor mouths)
SimpleExpressions.writeMouthGeneric(moutharray) Advanced: Write a mouth straight from your code with color values fo all of the pixels
SimpleExpressions.playSound(SOUND_NUMBER); Plays a sound by its number using the constants you can find below.
SimpleExpressions._tone(noteFrequency, noteDuration, silentDuration); Similar to the arduino tone function, but also working on ESP32 (using ledc)
SimpleExpressions.bendTones(note1Frequency, note2Frequency, prop, noteDuration, ilentDuration); Similar to the arduino tone function, but also working on ESP32 (using ledc)

Available mouth shapes

single color shapes

zeros
happySmall
happyFull
sadSmall
sadFull
neutral
circle
center
hook
upsidedownhook
kooh
upsidedownkooh
cross
rect
leftarrow
rightarrow
lefthalf
righthalf

multi color shapes

colorCircle

Available SOUNDS

S_CONNECTION
S_DISCONNECTION
S_BUTTON_PUSHED
S_MODE1
S_MODE2
S_MODE3
S_SURPRISE
S_OHOOH
S_OHOOH2
S_CUDDLY
S_SLEEPING
S_HAPPY
S_SUPER_HAPPY
S_HAPPY_SHORT
S_SAD
S_CONFUSED
S_FART1
S_FART2
S_FART3
PIRATES The complete PIRATES OF THE CARIBBEAN theme (highly experimental, but funny =P)

TODO

If you have new Ideas for different shapes or multicolor shapes just write them down and create a pull request (Or if you are not familiar with git draw them and post an issue)
Calculate frame count from arraysize
Example for writeMouthGeneric()
Currently I am happy with it, any Ideas? let me know

Buy me a coffee ☕️

If you like the library and all my other projects maybe think about buying me a coffee.? I really like coffee. ☕️ 🙃

4.0 KiB Raw Blame History Unescape Escape