Rotary
Rotary Encoder with Push Button
- Overview
- Commands
- Samples
- On-Module Code
A rotary encoder with an integrated push button — turning the knob increments or decrements a count; the module tracks the encoder transitions internally so you don't have to watch for missed edges in your host code. Read the current position or button state with simple text commands over any supported interface.
Common uses: menu navigation on small displays, volume and parameter dials, scroll inputs, classroom encoder-counting lessons, and any UI where rotation reads better than buttons.
Key features • Encoder | Resources 📄 Schematics PID: 0x04000D |
Modules ship without cables to reduce waste. Some specialty boards include a USB cable; for the rest, see Cables to add cables to your order.
Commands this module accepts. See Samples for runnable code in popular host languages.
| Function | Description |
|---|---|
GetValue() | Returns the current rotary reading. |
SetValue(v) | Set rotary to v. |
Pressed() | Returns 1 if the rotary knob was pressed. |
Scan() | Start scanning loop. Only call it with tethered mode. |
DVer() | This driver version. |
Peek under the hood
The script below is this module's driver — it teaches the hardware how to respond to the commands listed above. It ships pre-loaded from the factory; most users never need to open it.
loading...
Example code that calls this module's commands from popular host languages.
New here? See Get Started to connect a module and send your first command.
- Script
- Python
- MicroPython
- JavaScript
- .NET
- Arduino
- MicroBlocks
loading...
loading...
loading...
loading...
loading...
loading...
This sample runs in MicroBlocks on a any host board that's connected/tethered to this module, or a chain of modules. This module keeps its official DUELink firmware and module driver and responds to commands from the connected MicroBlocks-running host. New here? See the MicroBlocks page.
There are two ways to use it:
Open the full sample — the complete project (the module's library plus a ready-to-run example) opens directly on the MicroBlocks website.
Add just the libraries to your own project — copy the link, then in your MicroBlocks project click Add Library → Cloud and paste it. This loads this module's libraries into your project without replacing your current work.
Copy Library LinkCode that runs directly on this module's MCU. See how On-Module Code allows modules to run standalone.
- Script
- Arduino IDE
This example runs using the default DUELink Internal Engine using its Scripting Language, and it expects the module's driver to be loaded first, see the Commands Tab.
loading...
See Arduino IDE page for more info.
loading...
Ordering Info
| Product | Part Number | Price |
|---|---|---|
| DUELink Rotary | GDL-HIROTARY-C | $14.95 |