CodyNick Python Quick Reference Handbook

Start Code

import CodyNick

cn = CodyNick.CN()

cn is the connected CodyNick device object. Pass it as the first argument to CodyNick hardware functions.

RGB LED Matrix

Set One LED By Number

CodyNick.RGB_Matrix.set(cn, led, color)

Accepted color formats:

0
"#00FFFF"
[0, 100, 100]

Examples:

CodyNick.RGB_Matrix.set(cn, 15, 0)
CodyNick.RGB_Matrix.set(cn, 15, "#00FFFF")
CodyNick.RGB_Matrix.set(cn, 15, [0, 100, 100])

Set One LED By Coordinate

CodyNick.RGB_Matrix.set_xy(cn, x, y, color)

Coordinate system:

(0,3)  (1,3)  (2,3)  (3,3)
(0,2)  (1,2)  (2,2)  (3,2)
(0,1)  (1,1)  (2,1)  (3,1)
(0,0)  (1,0)  (2,0)  (3,0)

Example:

CodyNick.RGB_Matrix.set_xy(cn, 0, 0, "#FF0000")

Clear All RGB LEDs

CodyNick.RGB_Matrix.clear(cn)

Turns off all RGB LEDs.

Built-In Color Codes

Joystick

Check One Direction

CodyNick.Joystick.position(cn, direction)

Returns True or False.

Example:

if CodyNick.Joystick.position(cn, "up"):
    print("up")

Check Button Click

CodyNick.Joystick.click(cn)

Returns True when the joystick button is pressed.

Read All Current States

CodyNick.Joystick.states(cn)

Returns a list such as:

[]
["UP"]
["LEFT"]
["CLICK"]
["UP", "CLICK"]

Example:

states = CodyNick.Joystick.states(cn)

CJP Sound Maker

Play A Note And Continue

CodyNick.CJP_Sound_Maker.play(cn, note, duration_ms)

Example:

CodyNick.CJP_Sound_Maker.play(cn, "F#2", 300)

Play A Note And Wait Until Done

CodyNick.CJP_Sound_Maker.play_until_done(cn, note, duration_ms)

Same parameters as play(), but Python waits until the note is finished.

Example:

CodyNick.CJP_Sound_Maker.play_until_done(cn, "C4", 500)

Seven Segment Display

Display A Number

CodyNick.Seven_Segment.display(cn, value)

Examples:

CodyNick.Seven_Segment.display(cn, 1234)
CodyNick.Seven_Segment.display(cn, -123)
CodyNick.Seven_Segment.display(cn, 1.234)

Motion Detection

Detect Motion

CodyNick.Motion_Detection.detect(cn)

Returns:

True
False

Example:

if CodyNick.Motion_Detection.detect(cn):
    print("motion detected")

Connection Control

Close The Connection

cn.close()

Closes the serial connection to the CodyNick device.