A web-based Laboratory Information System (LIS) interface for ChemWell 2902 and hematology machines that enables direct data transmission to hospital servers through a web browser.
- Serial port communication via Web Serial API
- Real-time data parsing and display
- Support for HL7/ASTM data formats
- Automatic data logging
- Clean and modern user interface
- Backend data persistence
- Node.js (v14 or higher)
- Modern web browser with Web Serial API support (Chrome/Edge)
- ChemWell 2902 or compatible device connected via serial port
- Clone the repository:
git clone [repository-url]
cd LIS_ChemWell_2902_Machine_System- Install dependencies:
npm install- Start the backend server:
node backend/server.js- Open your web browser and navigate to:
http://localhost:3000
-
Click the "Connect" button and select your ChemWell 2902 device from the serial port list.
-
The interface will automatically start receiving and displaying results.
The system expects HL7 or ASTM formatted data from the device. Example format:
OBX|1|NM|WBC^White Blood Count||5.27|10^9/L|4.00-10.00|N|||F
All received data is automatically logged in:
backend/data/lab-data.log- Contains all received resultsbackend/data/error.log- Contains error logs
- The system should be run on a secure network
- Use HTTPS in production
- Implement appropriate authentication mechanisms
- Validate and sanitize all incoming data
- Google Chrome 89+
- Microsoft Edge 89+
- Other Chromium-based browsers with Web Serial API support
-
Serial Connection Issues:
- Ensure the device is properly connected
- Verify the correct COM port is selected
- Check baud rate settings (default: 9600)
-
Data Reception Issues:
- Verify device output format
- Check serial port settings
- Monitor browser console for errors
MIT License