Version

Installed version 1.5.7

How to Update

Update by replacing only the executable — your configuration, drivers, and data are preserved.

  1. Stop Mascarata: sudo systemctl stop mascarata (or kill the process).
  2. Download the .tar.gz for your version from the link above.
  3. Extract: tar -xzf mascarata-linux-x64-X.Y.Z.tar.gz
  4. Copy only the mascarata/mascarata binary from the extracted folder into your existing installation directory, replacing the old file.
  5. Restore execute permission if needed: chmod +x mascarata
  6. Do not overwrite config/, drivers/, or data/ — they contain your settings and readings.
  7. Start Mascarata: sudo systemctl start mascarata

Mascarata Hardware Bridge

Mascarata is a lightweight hardware-API bridge that simplifies industrial protocols (Modbus RTU, serial ASCII, binary) into clean JSON values consumable by modern web applications via REST and WebSocket. Connect any RS-232/RS-485 device — scales, thermometers, pressure sensors — and get a ready-to-use HTTP endpoint in seconds.

Every device in your topology gets its own auto-generated URL per parameter. No middleware, no message broker, no driver installation — drop in a JSON driver file and Mascarata handles the rest: polling, parsing, history, webhooks, and alerts.

Protocols STRING · STRING_BINARY · BINARY · MODBUS_RTU · BE · BE_DECIMAL · FLOAT32
Interfaces RS-232 · RS-485 (serial) · TCP socket (virtual / simulation)
API surface REST (HTTP/JSON) · WebSocket (live stream)
Driver library JSON driver files — scales, thermometers, barometers, pressure & environmental sensors
Platforms Windows · Linux
Deployment Single binary — no Docker, no Java, no external dependencies

API Usage

# Read a single parameter
GET http://localhost:8000/{device_id}/read/{parameter}

# Read all parameters at once (one serial round-trip)
GET http://localhost:8000/{device_id}/read/multi-read

# Send a service command (e.g. tare, calibration)
GET http://localhost:8000/{device_id}/command?command=tare

# List all configured devices
GET http://localhost:8000/api/devices

# Health check
GET http://localhost:8000/api/health

# Examples
GET http://localhost:8000/scales-1/read/weight
GET http://localhost:8000/thermo-01/read/temperature
GET http://localhost:8000/pressure-sensor/read/multi-read

All responses are plain JSON. The device_id and parameter names are defined in the driver file — no code changes required when adding a new device.