{
 "manufacturer": "Laumas",
 "manufacturer_slug": "laumas",
 "model": "TLS weight transmitter with analog output (Modbus RTU)",
 "model_slug": "tls",
 "short_model": "TLS",
 "aliases": [
  "TLS",
  "TLS 4-20mA",
  "TLS 0-10V",
  "CASTLTASTATEX"
 ],
 "equipment_type": "Sensor (load-cell weight transmitter)",
 "applies_to": "Laumas TLS weight transmitter / indicator with RS-485, installation and user manual version 1.19.",
 "summary": "The TLS is a single-channel load-cell transmitter with an analog output and RS-485. With the port set to Modbus RTU it gives gross, net and peak weight, a status word, two inputs and two outputs, two setpoints and the analog-output span as holding registers. Tare, zero, calibration and EEPROM saves are triggered by writing codes to one command register.",
 "transport": [
  "RTU"
 ],
 "defaults": {
  "unit_id": 1,
  "baud": 9600,
  "parity": "None",
  "data_bits": 8,
  "stop_bits": 1,
  "tcp_port": null
 },
 "addressing": {
  "convention": "Modicon",
  "note": "The manual prints registers as 40001-40131 and says to subtract 40001 for 0-based clients (40028 -> 27). Its read example asks for start address 0x0007 to read gross weight at 40008, which confirms it."
 },
 "default_word_order": "ABCD",
 "firmware": null,
 "source": {
  "title": "TLS Installation and User Manual",
  "doc_number": "version 1.19",
  "revision_date": null,
  "url": "https://www.massload.com/wp-content/uploads/2026/08/TLS_UserManual.pdf",
  "unofficial": true,
  "pages": "pp. 25-26 (serial settings), pp. 39-52 (Modbus RTU, register list, status/IO bits, commands, examples)"
 },
 "notes": [
  "Host: this copy is hosted by Massload, not by Laumas; a search did not turn up a public copy on laumas.com.",
  "Word order: 32-bit values are H/L pairs, high word at the lower address. The read example returns gross 4000 as 0x0000 0x0FA0 at 40008-40009 and the -56 calibration example is 0xFFFF 0xFFC8 at 40037-40038, so ABCD is documented.",
  "Weights carry no sign and no decimal point: apply status bits 7-9 for the sign and the division index for decimals. Divisions/units register 40014: low byte = division index (0-18: 100, 50, 20, 10, 5, 2, 1 with 0 decimals; 0.5, 0.2, 0.1 with 1; 0.05, 0.02, 0.01 with 2; 0.005, 0.002, 0.001 with 3; 0.0005, 0.0002, 0.0001 with 4); high byte = unit index (0 kg, 1 g, 2 t, 3 lb, 4 N, 5 l, 6 bar, 7 atm, 8 pieces, 9 N m, 10 kg m, 11 other).",
  "Left out: Hysteresis 1 (40021-40022) because its access column is blank in the table; display coefficient 40015-40016 because the manual does not give its scaling for Modbus; exchange registers 40124-40131 whose use is not described.",
  "Command codes 1, 6, 20, 98 and 131 appear in the list with their name printed as display symbols that do not extract; they are not listed.",
  "Setpoints, hysteresis and analog-span values are written to RAM; send command 99 to keep them after power-off. EEPROM allows about 100000 writes.",
  "The manual says the calibration sample weight is a signed 32-bit number; it does not state signedness for setpoints, hysteresis or the analog-output weights, which are typed INT32 here (this only matters for negative values)."
 ],
 "integration": {
  "summary": "Set the serial port to Modbus RTU, then read 40007-40013 with FC3: status word, gross, net and peak weight. Use the status sign bits and the division index (40014) to get the real value. Write 7, 9 and 8 to 40006 for tare on, tare off and zero.",
  "minimum_registers": [
   {
    "table": "holding_register",
    "address": 6,
    "why": "Status word"
   },
   {
    "table": "holding_register",
    "address": 7,
    "why": "Gross weight"
   },
   {
    "table": "holding_register",
    "address": 9,
    "why": "Net weight"
   },
   {
    "table": "holding_register",
    "address": 13,
    "why": "Division index for decimals"
   },
   {
    "table": "holding_register",
    "address": 5,
    "why": "Command register"
   },
   {
    "table": "holding_register",
    "address": 24,
    "why": "Digital inputs"
   }
  ],
  "enable": "In the serial communication menu choose the Modbus RTU protocol (communication is disabled by default), then set address (1-99, default 1), baud (default 9600), parity (default none) and stop bits (default 1).",
  "watchdog": null,
  "quirks": [
   "Only FC3 and FC16 are supported; write single registers with FC16.",
   "Maximum 32 registers per request.",
   "A settable reply delay (0-200 ms) in the serial menu slows responses."
  ],
  "setup": [
   "RS-485: if the line is over 100 m or runs above 9600 baud, close the two RS-485 termination jumpers (120 ohm) on the furthest instruments.",
   "Broadcast writes (address 0) are executed without reply."
  ],
  "gotchas": [
   "Outputs can be written only when configured for PLC control in the outputs menu.",
   "Changing the theoretical full scale or the sensitivity resets weight-based settings such as setpoints and hysteresis to their defaults."
  ]
 },
 "registers": [
  {
   "table": "holding_register",
   "address": 0,
   "documented": "40001",
   "name": "Firmware version",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 1,
   "documented": "40002",
   "name": "Instrument type",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 2,
   "documented": "40003",
   "name": "Year of manufacture",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 3,
   "documented": "40004",
   "name": "Serial number",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 4,
   "documented": "40005",
   "name": "Active program",
   "description": "",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 5,
   "documented": "40006",
   "name": "Command register",
   "description": "Write a command code to run it.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "W",
   "values": {
    "0": "No command",
    "7": "Semi-automatic tare on (net display)",
    "8": "Semi-automatic zero",
    "9": "Semi-automatic tare off (gross display)",
    "21": "Keypad lock",
    "22": "Keypad and display unlock",
    "23": "Keypad and display lock",
    "99": "Save data in EEPROM",
    "100": "Tare weight zero setting for calibration",
    "101": "Save first sample weight for calibration",
    "104": "Cancel real calibration",
    "106": "Add sample weight for calibration",
    "130": "Enable preset tare",
    "6811": "Write requested analog output current (value in registers 40122-40123)",
    "6812": "Read requested analog output current into 40122-40123",
    "6813": "Write requested analog output voltage (value in registers 40122-40123)",
    "6814": "Read requested analog output voltage into 40122-40123"
   },
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 6,
   "documented": "40007",
   "name": "Status register",
   "description": "Weight sign, stability and error flags.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Load cell error",
    "1": "AD converter malfunction",
    "2": "Maximum weight exceeded by 9 divisions",
    "3": "Gross weight over 110% of full scale",
    "4": "Gross weight over 999999 or under -999999",
    "5": "Net weight over 999999 or under -999999",
    "7": "Gross weight negative sign",
    "8": "Net weight negative sign",
    "9": "Peak weight negative sign",
    "10": "Net display mode",
    "11": "Weight stable",
    "12": "Weight within +/- 1/4 division of zero"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 7,
   "documented": "40008",
   "name": "Gross weight",
   "description": "Magnitude without decimal point; sign is status bit 7.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 9,
   "documented": "40010",
   "name": "Net weight",
   "description": "Magnitude without decimal point; sign is status bit 8.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 11,
   "documented": "40012",
   "name": "Peak weight",
   "description": "Magnitude without decimal point; sign is status bit 9.",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 13,
   "documented": "40014",
   "name": "Divisions and units of measure",
   "description": "High byte = unit index, low byte = division index.",
   "data_type": "UINT16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 16,
   "documented": "40017",
   "name": "Setpoint 1",
   "description": "Weight value without decimal point; RAM until command 99.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 18,
   "documented": "40019",
   "name": "Setpoint 2",
   "description": "Weight value without decimal point; RAM until command 99.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 22,
   "documented": "40023",
   "name": "Hysteresis 2",
   "description": "Subtracted from setpoint 2 for release.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 24,
   "documented": "40025",
   "name": "Inputs",
   "description": "",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "R",
   "values": null,
   "bits": {
    "0": "Input 1 status",
    "1": "Input 2 status"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 25,
   "documented": "40026",
   "name": "Outputs",
   "description": "Writable only for outputs configured for PLC control.",
   "data_type": "BITMAP16",
   "length": 1,
   "word_order": null,
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": {
    "0": "Output 1 status",
    "1": "Output 2 status"
   },
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 36,
   "documented": "40037",
   "name": "Sample weight for calibration",
   "description": "Test weight in divisions; use with command 101/106. Reads 0 after success.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 42,
   "documented": "40043",
   "name": "Analog output zero weight",
   "description": "Weight giving analog zero; save with command 99.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 44,
   "documented": "40045",
   "name": "Analog output full-scale weight",
   "description": "Weight giving analog full scale; save with command 99.",
   "data_type": "INT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 1,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  },
  {
   "table": "holding_register",
   "address": 121,
   "documented": "40122",
   "name": "Exchange register 1-2 (analog value)",
   "description": "mA or V x 10000 for commands 6811-6814 (REGISTER 1 = H, REGISTER 2 = L).",
   "data_type": "UINT32",
   "length": 2,
   "word_order": "ABCD",
   "scale": 0.0001,
   "scale_factor_ref": null,
   "units": "",
   "access": "RW",
   "values": null,
   "bits": null,
   "offset": 0
  }
 ],
 "page": "https://easymodbus.com/modbus-register-maps/laumas/tls",
 "address_note": "address = 0-based Modbus wire (PDU) address; documented = as printed in the source.",
 "note": "Re-typed from the manufacturer's public documentation (see source) and verified against it. Registers vary by firmware and options; verify against the live device before writing."
}
