Susi Server

Xitac Tactile

Node ID: xitacTactile · Role: Filter · Realtime config: no

Description

Tactile force from a single magnetometer under the xitac magnetic gel. Reset Bias starts a calibration window: rotate the sensor without pressing, and the node fits the gel’s own field (sensor frame) plus the earth field (world frame, via the sensor orientation). Force is the remaining deviation.

Algorithm notes

How it works

The node reads the magnetometer of an IMU mounted under the magnetic gel. At rest, the sensor sees two fields: the gel’s own field and the earth’s field. A short calibration learns both, using the sensor’s orientation to tell them apart. After calibration, any remaining change in the field counts as a press. The size of that change, multiplied by Force scale (per uT), is the output force. The touch flag turns on when the force reaches Touch threshold (force units). It turns off again when the force drops below 70% of that threshold.

What you must configure

How it starts

The node calibrates at start, after a stream reset, and whenever you run Reset bias (rotate sensor). It sends no output while calibrating. During calibration, don’t touch the gel and slowly turn the sensor in several directions. Calibration ends in one of two ways:

If the sensor is not rotated, the node treats the average rest reading as zero. That is fine for a sensor that keeps the same orientation in use. If you rotate it later, though, the rotation will read as force.

Tuning

Troubleshooting

Inputs / Outputs

Inputs:

Outputs:

Config aliases

XitacTactileFilter, xitacTactileFilter, xitacTactile

Properties

Each row shows the setting’s label in the node’s Properties panel and, in code, its key in the node’s settings object in the config file. A setting omitted from the config file uses the default shown here.

PropertyTypeDefaultDescription
Force scale (per uT) gainnumber1.0
Force unit forceUnitstringuT
Touch threshold (force units) touchThresholdnumber20.0
Reset calibration rotation (deg) calibrationRotationDegnumber90.0
Reset calibration timeout (s) calibrationSnumber30.0
Auto-zero while idle autoZerobooleanfalse
Auto-zero time constant (s) autoZeroTauSnumber10.0
Auto-zero idle threshold (uT) autoZeroThresholdnumber5.0

Example node definition

A minimal entry in config.json looks like the block below. Paste it under the sinks key, keyed by an instance name of your choice. All settings are optional: anything not listed under settings uses the default from the Properties table above. See The configuration file for how the sections and endpoint wiring work.

{
  "sinks": {
    "xitacTactile": {
      "dataEndpoint": "inproc://xitacTactile_data",
      "inputEndpoints": [
        "inproc://imu_data"
      ],
      "inputDataFilter": [
        "Imu"
      ],
      "settings": {}
    }
  }
}
Loading documentation…