background image

The INT pin is active low and is open drain output. The interrupt pin will go low when any of the follow events
happen:

The user presses the button is pressed or released.
The user has turned the knob and no movement has been detected for a certain amount of time. This
amount of time is called the 

turnInterruptTimeout

 and is 250ms by default. This means that once the user

has stopped turning the knob for 250ms the interrupt will fire. This is helpful when the user is doing lots of
knob changes. The Qwiic Twist won’t fire the interrupt until the user has stopped fidgeting. The
turnInterruptTimeout is software configurable from 1ms to 65000ms (65 seconds).

The INT pin is open drain and is pulled up through a 10k resistor but if you want to connect multiple Twists and
share the interrupt pins among many Twists then you can optionally cut the jumper to remove the 10k pull up on
each Twist board.

Jumpers

The ADR jumper is normally open and controls the I C address of the device. By default the Qwiic Twist 7-bit
unshifted address is 

0x3F

. If the jumper is closed with solder, the address will become 

0x3E

.

The Twist is unique in that it can have any address assigned to it between 0x08 and 0x77. This means over 100
Twists can be connected on a single bus!

Note:

 If the ADR jumper is closed then Qwiic Twist will resort to address 

0x3E

 regardless of what address may

have been configured via software commands. This is a safety mechanism in case the Twist gets set to an
unknown address.

The INT jumper is a normally closed jumper; there is a small trace connecting the two pads. This jumper connects
the INT pin on the ATtiny84 through a 10k resistor to 

3.3V

. Cutting the small trace disconnects the 10k resistor

from the INT pin on the ATtiny84.

2

Summary of Contents for DEV-15083

Page 1: ...you just need a volume knob The Qwiic Twist is a digital RGB encoder also known as a continuously rotating knob that is read and controlled over I C 2 SparkFun Qwiic Twist RGB Rotary Encoder Breakout...

Page 2: ...tasks The Qwiic Twist has an indent type encoder which gives the user a great clicky feel as they turn The Qwiic Twist also has an RGB LED and a built in button We ve written an Arduino library to mak...

Page 3: ...nology as it becomes available SparkX products are tested but come with no guarantees Live technical support is not available for SparkX products You will also need a Qwiic cable to connect the shield...

Page 4: ...you may need a soldering iron solder and general soldering accessories Suggested Reading If you aren t familiar with the Qwiic system we recommend reading here for an overview Qwiic Cable 500mm PRT 14...

Page 5: ...rtant Hardware Overview The RGB encoder is a 24 indent encoder You ll feel 24 clicks when turning one 360 degree rotation I2C An introduction to I2C one of the main embedded communications protocols i...

Page 6: ...t we recommend a clear knob but depending on your setup you may also be able to get a backlit effect with an opaque knob The RGB LEDs are pulse width modulated and controlled via software and backed b...

Page 7: ...talking to it Alternatively you can solder to the I C pins on the board Heads Up The Qwiic Twist is designed to operate at 3 3V so please don t drive it at 5V Your I C pins however can be 5V logic RS...

Page 8: ...are the interrupt pins among many Twists then you can optionally cut the jumper to remove the 10k pull up on each Twist board Jumpers The ADR jumper is normally open and controls the I C address of th...

Page 9: ...ou are using the latest version of the Arduino IDE on your desktop If this is your first time using Arduino please review our tutorial on installing the Arduino IDE If you have not previously installe...

Page 10: ...t8_t Set the red LED 0 255 boolean setGreen uint8_t Set the green LED 0 255 boolean setBlue uint8_t Set the blue LED 0 255 uint8_t getRed Get current value uint8_t getGreen Get current value uint8_t g...

Page 11: ...d but really handy features of Qwiic Twist is the ability to connect the color control to the knob movement What this means is that you can have the red LED brightness increase or decrease as the user...

Page 12: ...other Qwiic products Qwiic Shield for Arduino Photon Hookup Guide Get started with our Qwiic ecosystem with the Qwiic shield for Arduino or Photon CCS811 BME280 Qwiic Environmental Combo Breakout Hook...

Reviews: