Skip to content

Datasheet map

The driver follows the manual of the BASIS 2 meters and controllers, with the specification sheets for electrical and mechanical facts. This page says which revision, where to get it, and where each part of the driver is described in it, so you can check any behaviour against the source. Section names and page numbers are the documents' own (the printed page numbers, which equal the PDF's).

  • Datasheet manual: Operating Manual for Mass Flow Instruments, BASIS 2 Meters and Controllers, Alicat Scientific, Inc. DOC-MANUAL-BASIS2, revision Rev 4 (2025-05-23). Get it from the vendor page or as a PDF. SHA-256 of the file used: 388d686bd1a943e48d62ae13582a2114afd25d874600aeecdee33333f1a287d8.
  • Datasheet specification sheet: Technical Data for BASIS 2.0 Mass Flow Meters and Controllers, Alicat Scientific, Inc. DOC-SPECS-BASIS, revision Rev 19 (2026-08-17). Get it from the vendor page or as a PDF. SHA-256 of the file used: f3f11b4c949caf92b6952b8a6f5cc0b9b2ca4d6a325d4ea3b878c6db51d9a507.
  • Datasheet specification sheet: Technical Data for BASIS 2 (pages 1 to 3 of the combined manual and specification file), Alicat Scientific, Inc. MANUAL+SPECS_BASIS2, revision Rev 16 (2024-03-01). Get it from the vendor page or as a PDF. SHA-256 of the file used: f8ec4537221306cac68f851ef9a4dfb6886a75f6c8e6dcb6eef648e306c4c988.
  • Datasheet manual: Alicat Modbus Manual (generic, written for the classic registers), Alicat Scientific, Inc. DOC-MANUAL-MODBUS, revision Rev 7 (2024-11-01). Get it from the vendor page or as a PDF. SHA-256 of the file used: 4363886366ccd572c40fa47fdcc3cf9f98e6a397c7cfee720dfe9bdb2049de28.
  • Datasheet application note: Alicat Serial Communications Primer (classic line, firmware 4v to 10v), Alicat Scientific, Inc. Alicat-Serial-Primer, revision Rev 2 (2023-02-01). Get it from the vendor page or as a PDF. SHA-256 of the file used: e80684d7529eb62ce0725829207c567b35480d9efe655e7fb0fef2d978dc5e34.
Topic Datasheet section Page In the driver Explained on
Models, ranges and options DOC-MANUAL-BASIS2: Introduction p. 3 DeviceKind, Config::kind BASIS 2 Driver, Hardware, Quickstart
Mounting, LED and power-up behaviour DOC-MANUAL-BASIS2: Getting Started, Mounting p. 5 - Hardware, Safety notes
Power and signal connections, pin 4 only DOC-MANUAL-BASIS2: Power and Signal Connections p. 6 - Hardware, Safety notes
Connector pins and serial levels DOC-MANUAL-BASIS2: Power and Signal Connections (pin table) p. 7 UartPort::Write, UartPort::Read Hardware, Porting, Quickstart
Default serial settings and the link layer DOC-MANUAL-BASIS2: Alicat ASCII Serial Communication, Establishing Communication p. 10 Bus, Config::baud, Config::unit_id, ascii::Make Architecture, Protocols, Contract
Data frame DOC-MANUAL-BASIS2: Data Frame Format p. 10 Frame, Decimal, StatusFlags, Basis2::ReadFrame() Protocols, API guide
Query specific data DOC-MANUAL-BASIS2: Query Specific Data p. 11 Basis2::ReadData(), ReadFlow(), ReadTemperature(), ReadTotal(), ReadValveDrive() API guide, Protocols
Setpoint, setpoint source and ramp DOC-MANUAL-BASIS2: Setpoint; Setpoint Source; Maximum Setpoint Ramp Rate p. 11 SetSetpoint(), SetSetpointSource(), SetRamp(), Config::saved_setpoint_min_interval_ms API guide, Safety notes
Communication watchdog DOC-MANUAL-BASIS2: Communication Watchdog p. 12 SetWatchdog(), WatchdogProtects() Safety notes, API guide
Hold valve, gains, reference temperature, averaging DOC-MANUAL-BASIS2: Hold Valve Position; Loop Control Gains; Reference Temperature; Readings Averaging p. 13 HoldValve(), SetGains(), SetReferenceTemperature(), SetAveraging() API guide, Safety notes
Measurement triggering, averages and ranges DOC-MANUAL-BASIS2: Configure Measurement Triggering; Start a Measurement; Measurement Averages and Ranges p. 13 SetMeasurementTrigger(), StartMeasurement(), ReadAverages(), ReadRanges() API guide
Tare and autotare DOC-MANUAL-BASIS2: Taring the Instrument; Using Ground to Tare; Autotare p. 14 Tare(), TareDefault(), SetAutotare() API guide, Safety notes, Hardware
Active gas DOC-MANUAL-BASIS2: Active Gas p. 15 SetGas(), ReadGasList(), GasId, GasName() API guide, Protocols
Totalizer and batch DOC-MANUAL-BASIS2: Totalizer Reset; Totalizer Batch; Totalizer Configuration p. 15 ResetTotal(), SetBatch(), DisableBatch(), SetTotalizerLimit() API guide
Full scale flow, serial number, firmware DOC-MANUAL-BASIS2: Full Scale Flow; Unit ID; Version Number p. 16 ReadFullScale(), ReadSerialNumber(), ReadFirmware(), Identity API guide, Configuration
Unit ID DOC-MANUAL-BASIS2: Unit ID p. 16 ChangeUnitId(), FactoryRestore() Safety notes, API guide, Troubleshooting
Modbus address, baud rate, command protocol DOC-MANUAL-BASIS2: Modbus Address; Serial Baud Rate; Command Protocol p. 17 SetModbusAddress(), ChangeBaud(), SwitchToProtocol1(), FactoryRestore() Safety notes, API guide, Troubleshooting
Modbus RTU framing, address and baud DOC-MANUAL-BASIS2: Modbus-RTU; Communicating Via Modbus-RTU; Changing the Baud Rate p. 18 modbus::Build*(), modbus::ParseResponse(), Config::modbus_address Protocols, Architecture
Modbus setpoint, watchdog and tare DOC-MANUAL-BASIS2: Setpoint Type; Changing the Setpoint; Communication Watchdog; Taring the Instrument p. 19 Config::protocol, Basis2::SetSetpoint(), Tare() Protocols
Modbus averaging, totalizer, batch, gas table DOC-MANUAL-BASIS2: Flow Averaging; Totalizer; Batch Dispensing; Changing the Gas p. 20 Basis2::SetAveraging(), ResetTotal(), SetBatch(), SetGas() Protocols
Modbus register tables DOC-MANUAL-BASIS2: User, Instantaneous Data, Measurement Data and Configuration and Function Registers p. 21 inc/alicat_basis2_registers.hpp, reg::kRegisterRows Protocols, Datasheet map
Analog signals DOC-MANUAL-BASIS2: Analog Signals p. 28 - Hardware, Safety notes
Troubleshooting DOC-MANUAL-BASIS2: Troubleshooting p. 29 Error Troubleshooting
Engineering units DOC-MANUAL-BASIS2: Reference, Engineering Units p. 31 FlowUnit, TimeUnit, Identity::unit_label API guide, Protocols
Supply current, accuracy and update rate DOC-SPECS-BASIS: Technical Data p. 1 Config::flow_margin_permille, Config::processing_ms Hardware, Configuration
Size classes and dimensions DOC-SPECS-BASIS: Dimensions p. 3 - Hardware

The vendor URL of the manual served a file with other bytes (SHA-256 0f6b51bd13b98c2b4387b55a4c58aa19780db43371dbbb2d59123837e0b53c2e) on the day it was fetched; its text equals the recorded file after whitespace normalisation, so both are Rev 4. The 35-page combined file MANUAL+SPECS_BASIS2.pdf embeds an older manual (Rev 3) whose command and register tables are the same; it differs in a few sentences (no "ground pin 1 to tare" for meters, FACTORY RESTORE "in ALL CAPITAL LETTERS with exactly one space").

Which document is used for what

Document Used for
Operating manual Rev 4 Every command, register, pin, LED and warning: the only source of the protocols
Technical data Rev 19 and Rev 16 Supply current, accuracy, update rate, size classes and weights
Modbus manual Rev 7 and serial primer Rev 2 Generic facts of the vendor's classic line only (big-endian registers, the ? error token, streaming): each is an assumption for BASIS 2 and is marked below

Assumptions and open items

Everything the documents do not state is a knob of the test model and, where the driver has a choice, a Config field. Each assumption stays open until one capture from an instrument settles it (not verified on hardware).

ID Doubt What the driver does meanwhile
A1 A baud change answers at the new rate; port support for switching is not universal ChangeBaud() is Unsupported without SetBaud()
A2 The frame of a meter and whether flags carry brackets are not shown (only a controller example) FrameLayout::Auto accepts three or five numbers, bracketed or bare flags
A3 Replies to setters and the error reply are not documented The reply is accepted as a frame, a read form or short text; ? is Rejected; only SetSetpoint(), SetGas() and the unit ID change are checked (see below)
A4 The reply of DV n with several items is not shown Strict token counts per item mask; status as flags or as an integer
A5 The formats of GS *, VE and SN are not shown Own parsers; an unparsable gas list is kept raw
A6 Time commands write non-volatile memory; their latency is unknown Config::slow_command_ms
A7 When V d replies (at once or after d), and the Modbus samples-to-time mapping The bus is held for the duration after the send
A8 The watchdog protects only Modbus-set setpoints WatchdogProtects(); do not rely on it with ASCII
A9 The ramp rate unit ("the default units of the loop control variable") is undefined ASCII passes the number and unit code through; Modbus converts with the documented formula
A10 The reference temperature range for ASCII is not stated 0 to 30.00 C on both protocols
A11 Modbus flow decimals are factory-set and not readable Config::modbus_flow_decimals is required; the setpoint and total widths follow
A12 The broadcast * and the reply ID after @= Broadcast is never sent; either ID is accepted for the @= reply, then verified
A13 Modbus "pin 6" wording, address 0, the factory address, parallel ASCII and Modbus One protocol per object; address 1 by default; broadcast never sent
A14 BASIS Protocol 1 is unknown (its manual could not be obtained) P 1 is guarded; the driver is then abandoned
A15 The two specification sheets differ in a few dimensions Revision 19 is used; the differences are listed on the Hardware page
A16 Standard temperature references differ between the sheets (0 C against 21 C) The A10 range
A17 A batch reset by register 53 duplicates the totalizer reset; reading register 4214 may start a measurement ResetTotal() only; a warning on ReadPreviousMeasurement()
A18 Whether DVAS, DVAA, DVAR exist on meters Sent on both; a ? is Rejected
A19 Streaming mode exists on the classic line but is not in the manual Never sent; stray lines counted and ignored
A20 "Open", "close" and "exhaust" valve actions are buttons in the vendor's software, not commands OpenValve() holds 100 percent, CloseValve() holds 0
A21 The setpoint resolution over ASCII Config::setpoint_decimals
A22 Whether the temperature and flow limits differ from the instrument's own Plausibility limits in Config
A23 Whether the 50 and 100 SLPM models are still BASIS 2 Data only
A24 The factory Modbus address is 1: inferred from the default unit ID, not stated in the manual A switch-off in doubt after FactoryRestore() tries address 1; Recover() scans all addresses (model knob K-FACTORYADDR)
A25 The word order of the previous average flow, 4214-4215: M p.22 calls 4214 "the least significant register", which can mean the lower-numbered register or the low word; every other 4-byte value is high word first Decoded high word in 4214, like the other pairs; the literal reading favours low word first, so a bench read decides (Testing, model knob K-PREVAVG)

Searched, not obtained

Item Result
The BASIS 1 ASCII manual Not served; needed only to know what P 1 switches to
A BASIS 2 specific Modbus manual None exists; the manual's own register tables are the source
Firmware release notes; the reply formats of the setters, DV, GS *, VE, SN Not published in any document read
The vendor's LabVIEW library and desktop software Not downloaded: binary archives, not documents; they would show the real reply formats

Not in the driver

  • The analog setpoint and output are wired signals, not serial commands.
  • Basis2 speaks one protocol per object; it does not mix ASCII and Modbus on one line.
  • The vendor's BASIS Protocol 1 and the classic line's streaming commands.