Skip to content

awgrover/xod_lib

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

88 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Some XOD nodes

XOD is a flow-based-programming tool for programming arduino. See https://xod.io && https://github.com/xodio/xod .

This (https://github.com/awgrover/xod_lib) is a library of nodes for it. Some may be useful. Some may be ill conceived.

Many are available as proper XOD libraries. If possible, install as libraries.

Installation

XOD Add Library

  1. Browse (https://xod.io/libs/) for "published" libraries, mine start with "awgrover"
  2. File menu, Add Library, type the name, like "awgrover/utils".
  3. should install.

awgrover/midi

This requires FortySevenEffects/arduino_midi_library. A bit of a pain to install:

  1. run arduino-ide
  2. sketch:include library:manage-libraries...
  3. search for "MIDI", find "MIDI Library by Forty Seven Effects"
  4. latest version (has worked with 4.3.1, report problems please)
  5. "install"
  6. done with arduion-ide, you can close it
  7. Find your "Arduino/libraries" folder.
  8. It's "~/Arduino/libraries" on linux. Please send info on OS's not listed here.
  9. Find your "XOD IDE/resources" directory. On my debian linux, it's '/opt/XOD IDE/resources/arduino-libraries'
  10. You have to create a link (shortcut) from the arduino-library to the xod-arduino-lib. On linux it's: sudo ln -s ~/Arduino/libraries/MIDI_Library '/opt/XOD IDE/resources/arduino-libraries'
  11. "Reload" in XOD
  12. Should be ready to go

Un-"published"

I haven't "published" all of these yet, until then you have to put the 'awgrover' directory into the xod workspace lib manually.

  1. From this github repository https://github.com/awgrover/xod_lib
  2. Click "clone or download", click "Download zip"
  3. Open the downloaded zip, or let your OS just open it as it downloads.
  4. Navigate into the zip, inside 'lib'. So you can see the 'awgrover' directory.
  5. Find your xod workspace: run xod, choose File:Select Workspace. Note the "Current workspace directory". You can probabably select and copy it.
  6. Open your file-explorer, and navigate to the xod workspace.
  7. Make a directory "__lib__"
  8. Drag 'awgrover' from the zip to '__lib__' in the workspace.
  9. It's installed.
  10. Do a "reload" in XOD.
  11. My libs should be visible and usable.

Nodes

More detailed documentation at NODES.md

awgrover/adafruit-mma8451-library-ll/adafruitmma8451

constructor Default range is supposed ot be 2G, but get-range says 4G.

awgrover/adafruit-mma8451-library-ll/defer(adafruitmma8451)

Allows to create feedback loops. Repeats a change of the input on the output right after the current transaction will complete.

awgrover/adafruit-mma8451-library-ll/equal(adafruitmma8451)

Outputs true if IN1 = IN2, and false otherwise

awgrover/adafruit-mma8451-library-ll/example-xyz-orientation

awgrover/adafruit-mma8451-library-ll/gate(adafruitmma8451)

Allows values to pass through only if EN pin is set to true

awgrover/adafruit-mma8451-library-ll/get-data-rate

awgrover/adafruit-mma8451-library-ll/get-orientation

awgrover/adafruit-mma8451-library-ll/get-range

Returns 2,4,8 (G). (Not the range bit values)

awgrover/adafruit-mma8451-library-ll/if-else(adafruitmma8451)

Outputs either input value depending on condition

awgrover/adafruit-mma8451-library-ll/range

values for range of set-range.

awgrover/adafruit-mma8451-library-ll/read-xyz

Get the current xyz as -1..1. Mapped from -range..range. cf. read-xyz-g

awgrover/adafruit-mma8451-library-ll/read-xyz-accel

Get the current xyz in m/sec^2

awgrover/adafruit-mma8451-library-ll/read-xyz-g

Get the current xyz in G's (1 = 9.8m/s^2). cf. read-zyz-accel for 0..1 scale.

awgrover/adafruit-mma8451-library-ll/readme

awgrover/adafruit-mma8451-library-ll/set-data-rate

awgrover/adafruit-mma8451-library-ll/set-range

set the range 2,4,8 G. Higher sensitivey at 2G

awgrover/adafruit-neopixel-ll/adafruitneopixel

constructor https://github.com/adafruit/Adafruit_NeoPixel Arduino: Adafruit_NeoPixel XOD: @/input-adafruitneopixel cpp postfix: adafruitneopixel

awgrover/adafruit-neopixel-ll/adafruitneopixel1

constructor https://github.com/adafruit/Adafruit_NeoPixel Arduino: Adafruit_NeoPixel XOD: @/input-adafruitneopixel cpp postfix: adafruitneopixel

awgrover/adafruit-neopixel-ll/begin

awgrover/adafruit-neopixel-ll/black

convenience color: off

awgrover/adafruit-neopixel-ll/brightness

naive brightnes * (r,g,b)

awgrover/adafruit-neopixel-ll/can-show

awgrover/adafruit-neopixel-ll/clear

awgrover/adafruit-neopixel-ll/color-fade

val over the range maps to brightness the color.

awgrover/adafruit-neopixel-ll/color-order

Use example-rgb-revelation to discover the color-order. Set one of the 1-x's to true. Set one of the 2-x's to true. The third is deduced.

awgrover/adafruit-neopixel-ll/defer(adafruitneopixel)

Allows to create feedback loops. Repeats a change of the input on the output right after the current transaction will complete.

awgrover/adafruit-neopixel-ll/equal(adafruitneopixel)

Outputs true if IN1 = IN2, and false otherwise

awgrover/adafruit-neopixel-ll/example-rgb-revelation

Light up the first 3 pixels in Red, Green, Blue order. Nearest the Arduino should be Red, then Green, then Blue. This should help you decode the right RGB code to use (e.g. GRB, etc).

awgrover/adafruit-neopixel-ll/example-rgb-revelation1pixel

Light up the first pixel in order: OFF, Red, Green, Blue. Like the 3 pixel revelation, but this only requires 1 pixel. This should help you decode the right RGB code to use (e.g. GRB, etc).

awgrover/adafruit-neopixel-ll/example-simple

Turn all pixels light green, one by one. Repeat. Based on the Adafruit Neopixel example "simple",

awgrover/adafruit-neopixel-ll/extract-rgb

Get red, green, blue elements of rgb color

awgrover/adafruit-neopixel-ll/gamma8

awgrover/adafruit-neopixel-ll/gate(adafruitneopixel)

Allows values to pass through only if EN pin is set to true

awgrover/adafruit-neopixel-ll/get-brightness

awgrover/adafruit-neopixel-ll/get-pin

awgrover/adafruit-neopixel-ll/get-pixel-color

awgrover/adafruit-neopixel-ll/get-pixels

awgrover/adafruit-neopixel-ll/if-else(adafruitneopixel)

Outputs either input value depending on condition

awgrover/adafruit-neopixel-ll/if-else(rgb-color)

Outputs either input value depending on condition

awgrover/adafruit-neopixel-ll/num-pixels

awgrover/adafruit-neopixel-ll/readme

awgrover/adafruit-neopixel-ll/rgb-color

composite rgb+white object 0..1 values a rgbw should auto calculate w

awgrover/adafruit-neopixel-ll/set-pin

awgrover/adafruit-neopixel-ll/set-pixel-color

awgrover/adafruit-neopixel-ll/set-pixel-color-rgb

awgrover/adafruit-neopixel-ll/show

awgrover/adafruit-neopixel-ll/sine8

awgrover/adafruit-neopixel-ll/update-length

awgrover/adafruit-neopixel-ll/update-type

awgrover/analog-write-resolution/analog-write-resolution

Set the bit resolution of the PWM (analogWrite) for SAMD21 and SAMD51 boards. i.e. analogWriteResolution(). Usually 8..16 bits.

awgrover/analog-write-resolution/example-analog-write-resolution

Example showing bit-resolution on an LED. Read the comments for instructions.

awgrover/buffer1/buffer1

Make a buffer of n bytes. Only at beginning of program. Allocates from the heap. You must check ERR: means not-enough-free-memory

awgrover/buffer1/buffer1x

Make a buffer of n bytes. Only at beginning of program. Allocates from the heap. You must check ERR: means not-enough-free-memory

awgrover/buffer1/debug-dump

Dump the buffer to the console if debugging is on

awgrover/buffer1/defer(buffer1)

Allows to create feedback loops. Repeats a change of the input on the output right after the current transaction will complete.

awgrover/buffer1/equal(buffer1)

Outputs true if IN1 = IN2, and false otherwise

awgrover/buffer1/example-1

awgrover/buffer1/fill

Fill the entire buffer with a value. Default fill is 0.

awgrover/buffer1/gate(buffer1)

Allows values to pass through only if EN pin is set to true

awgrover/buffer1/get-byte

awgrover/buffer1/get-word

awgrover/buffer1/if-else(buffer1)

Outputs either input value depending on condition

awgrover/buffer1/length

awgrover/buffer1/set-byte

awgrover/buffer1/set-word

awgrover/buffer1/tutorial

awgrover/buffer1/tutorial-cpp

awgrover/buffer1/val-pulse-err

awgrover/conversions/data-to-pulse

Convert anything into a pulse

awgrover/conversions/true-to-pulse

Convert (each) true into a pulse. Compare with cast-boolean-to-pulse

awgrover/count/count

From START to LIMIT by STEP each INC. Then reset to START. Either up or down. aka Sawtooth.

awgrover/count/limited-counter

Count up/down on each INC pulse. Will not exceed MAX or go-below MIN. I.e. Count up to MAX. Won't output if nothing changes (e.g. RST when already MIN, or just changing STEP)

awgrover/count/simple

Simplified count: 0 to 1 by INC. Then repeat. Default is 256 steps suitable for LEDs etc. aka sawtooth.

awgrover/count/steps

counts from 0 to LIMIT in N steps. e.g. 0..1000 in 255 steps. sawtooth.

awgrover/hardware/button

never implemented.

This button signals up & down. The signal is immediate (debounce inhibits signals for 20msec). Assumes normally-open switch. Does input-pullup.

awgrover/hardware/digital-input

Use xod/hardware/digital-input.

Reads digital signal value from board port. Can set input-pullup.

awgrover/logical/if-else-string

Outputs either input value depending on condition

awgrover/logical/string-compare

generic equal should work.

Compares 2 strings, giving <, =, or > boolean output.

awgrover/math/bin

Classify v by range 0 if < r1, "0..r1" 1 if >= r1, "r1..r2" 2 if >= r2, etc.

awgrover/math/bin-decreasing

Bins the input-value: 0 if v < inf, 1 if v < r1, 2 if < r2, etc. NB: r's are decreasing

awgrover/math/exponential-smooth

Exponential smoothing The result lags the value, smoothing out

awgrover/math/negate

awgrover/math/ratio

Split the value: a + b = v

awgrover/midi/bank-program-change

Bank-Select and Program-Change

awgrover/midi/control-change

Set the inputs, send the control change on pulse ("send").

awgrover/midi/debug

For this to work, it must fire first. Putting in the top-left helps. Sets baud to 115200 for debugging

awgrover/midi/example-compile-test

awgrover/midi/example-control-change

Real simple examples

awgrover/midi/example-program-change

awgrover/midi/note

Start/stop a note.

awgrover/midi/note-button

A button starts the note (push) and stops on release. Uses xod/common-hardware/button

awgrover/midi/program-change

Set the inputs, send on pulse ("send")

awgrover/pulse/bit-mask

Set n least-significant bits

awgrover/pulse/example-set-bits

awgrover/pulse/pass-pulses

Block pulses until EN Then RST blocks again

awgrover/pulse/pass-strategies

Notes on passing/gating values/pulses/etc.

awgrover/pulse/set-bits

Set the bit corresponding to a pulse, on the least-significant end. e.g. p1,p2,p3 would set 00000111

awgrover/pulse/set-lsb

On pulse, set the lsb. Cf. set-bits

awgrover/pulse/wait-all

Wait for all pulses to accumulate.

awgrover/pulse/x-testing-area

awgrover/util/clock-per-second

Produce n ticks/sec. aka Hz

awgrover/util/log-data

Output the DATA on the console-log, possibly followed by a space. End-of-line is optional. So you can output more than 1 thing per line.

awgrover/util/timestamp

output "[time] prefix data". So you can see when it happened, what it's for (prefix). Unlike console-log, this outputs on prefix, or data. Of course, also on trig.

awgrover/util/write-string

awgrover/values/boolean

Use buffer or flip-flop.

On pulse or boolean, copy the boolean out. Set always=false to only copy if the boolean has changed. Acts like casting pulse to boolean

awgrover/values/number

use buffer and pulse-on-change

On pulse or number, copy the number out. Set always=false to only copy if the number has changed. Acts like casting pulse to number

awgrover/values/text

use buffer and pulse-on-change

On pulse or text, copy the text out. Set always=false to only copy if the text has changed. Acts like casting pulse to text

About

Nodes, "native" and patches for xod (see https://github.com/xodio and https://xod.io)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published