Introduction
This program provides a very simple mechanism to receive weight and height readings from the Health o meter® professional scales directly
into your Allscripts EMR with just a click of a mouse.
Usage
When you click the button to weigh the patient in the Allscripts EHR a screen will display showing the current reading from the scale, including height and BMI if available.
Press Accept when the reading has stabilized. Press escape or close the form to return to Allscripts without sending the weight.
Brief Installation
The setup program will run when you insert the disk into your computer. If it does not start automatically double click HOMAllscriptsInstall.msi on the disc.
Accept the defaults for the typical installation.
The scale detection screen will display. Follow the steps to for the system to detect your scales.
Accept the scale configuration.
Next the “Configure Allscripts Scale Interface” screen is displayed. Your Administrator or Allscripts support will be able to provide you with the information for this screen for your specific site and Allscripts system.
Enter the UAI URL for your particular UAI server. Enter the UAI user for your installation.
Enter the password and confirm it.
If you need a different Appname instead of the default healthometer change that too.
Verify your values by clicking the Verify UAI Connection button. A successful verification will display something like this:
Once the UAI connection verifies press the Apply button to save your changes.
Administration
The “Health o meter Integration” start menu group includes useful links
To configure the scales and UAI connection as you did in installation
Verifying...
Password and confirmation do not match! URL Verified.
choose “Configure Scales”.
To test the scale connection or selectively configure the system choose “Scale Reader”
For an electronic PDF version of this document choose “Scale Integration Documentation”.
There are also links to install USB drivers. Please see the USB drivers section for more information.
Full Installation Description
The installation installs the software and detects and scales that are connected.
If you do not have an installation CD please download the Allscripts integration from the Health o meter® Professional web site
http://www.homscales.com/innovation/emr_integration_kit.aspx or contact Pelstar Customer Support for the Health o meter® Professional
Allscripts integration CD.
The installation requires the .NET 4.0 Client Profile to be installed. If this is not already installed this is available as an optional update through windows update.
It also requires windows installer 3.1 or higher. Most versions of windows have this installed already. If it's not listed as an optional update in windows updates; you can also download a version 4.5 of the installer from:
http://www.microsoft.com/downloads/en/details.aspx? FamilyID=5A58B56F-60B6-4412-95B9-54D056D6F9F4
USB drivers
By Default the scales connect using the “Silicon Labs CP210x USB to UART Bridge” USB driver. This assigns the scale to a COM port. The system will install either the 32 or 64 bit version depending to your operating system.
Important: When using this driver DO NOT unplug the USB cable
while the application is running; this will cause an application crash. If you need to unplug the USB scales while the application is running please use the USB driver. This can be installed from Install USB drivers link in the Health o meter SDK program group. Use Add
remove programs in the control panel to remove the “Windows Driver Package – Silicon Laboratories”
connecting the scale.
• Open Device Manager. (one way to do this is right click on the my computer icon and choose manage)
• Select the scale under ports.
• Choose update driver.
• Choose Browse my computer for driver software
• Choose Let me pick from a list of drivers on my computer
• Click “Have Disk...”
• Browse to the “USB Install\USBDirect” folder where you installed the SDK. (The default is: C:\Program Files (x86)\Health o meter SDK\USB Install\USBDirect)
• Select SiUSBXp.Healtho.inf
• The driver should install and the scale should display as a USB device "Health o meter® USB Scale 2010(64 bit)"
Error Logging
The system will log any errors and some messages to the windows event log.
The event source will appear as HealthOMeter. This is configurable by modifying the
Allscripts EHR Configuration
The Health o meter professional integration is launched from within Allscripts. Your Administrator or Allscripts support will need to configure this for you. The program file is HOAllscripts.exe. It's folder should be included in the path. The default installation folder is “C:\Program Files\Health o meter Allscripts Integration” on 32 bit systems and “C:\Program Files (x86)\Health o meter Allscripts Integration” on 64 bit systems.
These are the parameters it expects:
HOMAllScriptsScales /SSO {SecurityToken} /Patient {PatientID} /Encounter {EncounterID} /System {SystemID} /User {UserName}
Scale Configuration
The user can configure the scales connected using the HOMAllScriptsScales.exe application.
Zero after seconds controls how long the weight from the scale is displayed, then the control will send a zero reading. (Note zero readings sent by the scale are not actually sent when received)
Maximum Number Of Readings is the number of readings the control will remember and return in the AllReadings method. (Note this is only in the life time of the object. Readings do not persist between
instantiations)
Keep Readings For (Seconds) is how long the system will retain the readings and return them in the AllReadings method. 86400 is 24 hours.
Use Units allows you to specify either metric or imperial units regardless of how the scale is configured.
Use the Add and Remove buttons to set the list of scales on COM ports. When adding you can select the scale model from the list and this will be translated to either 9600 or 2400 baud rate.
If USB scales are present the check box will be checked. This will detect any number of scales connected with the direct USB driver. Auto detect will try and recognize and scales that are connected to the PC. First it checks for USB drivers and scales connected at 9600 baud. If it does not find any then it checks for 2400 baud scales.
Configuring UAI Vitals Forms
The Allscripts Unity framework provides two methods to send vitals data into the EMR. The simplest (and most recent) way is to use the SaveVitalsData call. This call does not use any configuration. Older UAI interfaces can not use this call and will need to have the UAI vitals forms configured. Your Allscripts Administrator or Allscripts technical support will know which version your EMR supports. Use the “Use SaveVitalsData Call” check box to switch between the two. When not using SaveVitalsData, the UAI system requires that all the values saved are in a single vitals form. If your system requires a form other than the default provided (see the values in the “UAI Configuration File” section); your Administrator or Allscripts support can configure the UAI system for you and provide you with the values.
In the “Configure Allscripts Scale Interface” screen click the “UAI Vitals Forms...” button to toggle the display of the vitals form fields. The system will read all the available forms, variables and units with in each form.
Selecting the “Vitals Form” in its combo box updates the other variables and units on the form. Values that exist in the Allscripts system show the description and the value in parenthesis; for example “Height Weight BMI BSA_Weight (_1661_9)”. Values that
do not exist in the Allscripts system just display the value in the combo box. You can enter any value into the combo boxes.
To check the values and units within the forms click the “Reverify” button.
To save all values on the form including the UAI connection values click the “Apply” button.
Configuration Files
You should use the Configure method on the control to change the configuration. This updates the configuration file. Avoid manually changing the configuration files.
These are stored in HealthOMeterScales folder in the Program Data folder to allow all users to configure the scales. (Note this varies depending on which version of windows you are using;
C:\ProgramData on Windows 7 and Vista; “C:\Documents and
Settings\All Users\Application Data” on XP. The exact location of the files are included in the about information.
The files are XML files in a standard .NET config file format. Most properties are stored as values for settings.
UAI Configuration File
The UAI configuration is stored in a file called HOMAllScriptsScales.exe.config.
These are the setting names and their default values
VitalsFormName VS VitalsFieldNameWeight _1661_9 VitalsFieldNameWeightUnit _1661_9_7_U VitalsFieldNameHeight _1661_8 VitalsFieldNameHeightUnit _1661_8_6_U VitalsFieldNameBMI _1661_1599 VitalsValueHeightUnitInches 9 VitalsValueHeightUnitCentimeters 7 VitalsValueWeightUnitPounds 5 VitalsValueWeightUnitKilograms 3 UAIAppName healthometer
UAIUserName pelstar UAIUserPassword
UAIURL http://matrix3.allscripts.com/Unit yDev/UnityService.svc/unityservic e
Scale Configuration File
The interface stores its configuration in a file called HealthOMeterV2Scales.dll.config.
The list of connected scales is actually stored in an XML element called ScaleList.
This example shows two scales installed one on serial port 3 and the other connected via USB.
<ScaleList>
<Scale Type="ScaleUSBProPlus" />
<Scale Type="ScaleSerialPort" Com="COM3" Baud="2400" /> </ScaleList>
These are the models we support arranged by Baud Rate:
MODEL USB Baud Rate
1100KL Yes 9600 1600KL Yes 9600 2000KL Yes 9600 2101KL No 9600 2101KL Yes 9600 2400KL Yes 9600 2450KL No 9600 2500KL No 9600 2500KL Yes 9600 2600Kl No 9600 2600KL Yes 9600 2610KL Yes 9600 2650KL Yes 9600 2700KL Yes 9600 498KL Yes 9600 499KL Yes 9600 500KL (New) Yes 9600
597KL Yes (New Models) 9600
599KL Yes (New Models) 9600
752KL Yes (New Models) 9600
2595KL Yes 2400 2842KL Yes 2400 349KLX No 2400 500KL (Old) No 2400 522KL Yes 2400 524KL Yes 2400 553KL Yes 2400 844KL Yes 2400
Installed files
By default the files are installed in “c:\Program Files\Health o meter SDK”. On 64 bit versions of windows the path is “c:\Program
Files(x86)\Health o meter SDK”. Choose “Custom” setup type to select a different location.
These are the files installed for each feature. Some files are on the CD and can be read without installing the application.
Installed with
Feature File Notes On CD
Documentation HOMAllscriptsInterface
.pdf An Electronic version of this document Yes Core Drivers HealthOMeterV2Scales
.dll The main assembly Core Drivers HealthOMeterV2Scales
.tlb The type library for COM inter operability. Core Drivers HOMAllScriptsScales.e
xe Used to configure the scales and also acts as a display. The C# sampel is the source code for this
application. Core Drivers HOMAllScriptsScales.e
xe.config A configuration file for the sample reader. Core Drivers SiUSBXp32.dll Use to interact with
the 32 bit USB driver. Core Drivers SiUSBXp64.dll Use to interact with
Installed with
Feature File Notes On CD
Core Drivers Folder
%ProgramData% \HealthOMeterScales
Stores the scale configuration so all users have access to it.
HealthOMeterV2Scales
.dll.config The configuration file for the scales. Note the location varies depending on your version of windows.
Core Drivers Folder
[USB Install] This folder includes the USB drivers incase you need to repair or reinstall them.
Yes
Core Drivers DPInst64.exe or
DPInst32.exe The driver installation utility used by the installation. Do not use this to install the drivers interactively. USB Drivers (32
Bit) Healtho2.inf A 32 bit unsigned USB driver for the scales. Yes USB Drivers (32
Bit) HealthoUSBXpressInstaller.exe The installer for the 32bit unsigned USB driver.
Yes
USB Drivers (32
Bit) setup.ini Information file for the installer. Yes USB Drivers (32
Bit) Folder[USB Install\x64] [USB Install\x86]
The 32 and 64 bit files for the unsigned USB driver.
Yes
USB Drivers (32
Bit) SiLib.sys USB Driver Files Yes USB Drivers (32
Bit) SiUSBxp.sys USB Driver Files Yes USB COM
Drivers Folder[USB Install\SILabs] Contains the USB to COM port driver. Yes USB COM
Installed with
Feature File Notes On CD
USB COM
Drivers ReleaseNotes.txt Notes about the driver. Yes USB COM
Drivers setup.ini A driver install file Yes USB COM
Drivers slabvcp.cat The signed catalog for the driver Yes USB COM
Drivers slabvcp.inf Information file for the driver Yes USB COM
Drivers Folder[USB
Install\SILabs\x64] [USB
Install\SILabs\x86]
64 and 32 Bit driver
files Yes
USB COM
Drivers silabenm.sys Yes
USB COM
Drivers silabser.sys Yes
USB COM