Potentiometer

Analog

input

Small RAM

0.1.0

#Description

A rotary potentiometer is the basic turning knob. It can be used to get the angle. It is not fully turnable though, most commonly only between 0 and 270 degrees.

#Links

Open Wiki for Grove ComponentGet the Grove Component

#Units

• Percent%
• Degree°

#Aliases

• Rotary Potentiometer

#Functions

---

#JavaScript / Node.js

@blokdots/components on npm ↗

ClassPotentiometerextends AnalogSensor

Base class for analog input components that read continuous values (e.g. potentiometer, light sensor). Reads analog pins (A0–A5) and emits `change` events when the value shifts beyond a configurable threshold.

#Constructor options

Option	Type	Required	Description	Inherited from
invert	boolean	optional	—	AnalogSensor
pin	AnalogPin	required	—	AnalogSensor
minValue	number	optional	—	AnalogSensor
maxValue	number	optional	—	AnalogSensor
threshold	number	optional	—	AnalogSensor

#Methods

get value→ number | undefinedfrom ComponentBase

Get the current value of the component.

#Example

JavaScript

import { Board, Potentiometer } from "@blokdots/components";

const board = new Board("/dev/ttyACM0");
await board.open();

const potentiometer = new Potentiometer({ board, pin: "A0" });

potentiometer.on("change", (value) => {
  console.log("Potentiometer changed:", value);
});

---

#C++ (Arduino)

ClassAnalogSensorextends ComponentBase

Generic analog input with thresholded "change" events (potentiometer-style)

#Setup

C++

#include "blokdots.h"

AnalogSensor myComponent(eventBus, 5, MY_EVENT);

#Constructor

AnalogSensor(bus, pin, evtChange, threshold, intervalMs, minEmitIntervalMs, quantizeStep, invert)

Parameter	Type	Default
bus	EventBus	required
pin	uint8_t	required
evtChange	uint8_t	required
threshold	int	5
intervalMs	uint16_t	5
minEmitIntervalMs	uint16_t	20
quantizeStep	int	0
invert	bool	false

#Methods

value()→ int

Most recent sampled value (may change even if not emitted yet)

emittedValue()→ int

The value that was last emitted with evtChange (use this in handlers!)

See the AnalogSensor reference for the full API.