Once the UAI connection verifies press the Apply button to save your changes.

Transcription

1 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: Verifying... Password and confirmation do not match! URL Verified. Using SaveVitalsData call. 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 Page 1 of 10

2 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 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: FamilyID=5A58B56F-60B B9-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 For 64 bit systems you will need to do some additional step after Page 2 of 10

3 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} Page 3 of 10

4 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 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. Page 4 of 10

5 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 Page 5 of 10

6 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 VitalsFieldNameWeightUnit VitalsFieldNameHeight VitalsFieldNameHeightUnit VitalsFieldNameBMI _1661_9 _1661_9_7_U _1661_8 _1661_8_6_U _1661_1599 VitalsValueHeightUnitInches 9 VitalsValueHeightUnitCentimeters 7 VitalsValueWeightUnitPounds 5 VitalsValueWeightUnitKilograms 3 UAIAppName healthometer Page 6 of 10

7 UAIUserName UAIUserPassword UAIURL pelstar 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 KL KL KL No KL KL KL No KL No KL Kl No KL KL KL KL KL KL KL (New) KL (New Models) KL (New Models) KL (New Models) KL 9600 Page 7 of 10

8 2595KL KL KLX No KL (Old) No KL KL KL KL 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 Core Core Core Core HOMAllscriptsInterface.pdf HealthOMeterV2Scales.dll HealthOMeterV2Scales.tlb HOMAllScriptsScales.e xe HOMAllScriptsScales.e xe.config An Electronic version of this document The main assembly The type library for COM inter operability. Used to configure the scales and also acts as a display. The C# sampel is the source code for this application. A configuration file for the sample reader. Core SiUSBXp32.dll Use to interact with the 32 bit USB driver. Core SiUSBXp64.dll Use to interact with the 64 bit USB driver. Page 8 of 10

9 Installed with Feature Core Core Core USB (32 USB (32 USB (32 USB (32 USB (32 USB (32 File Notes On CD Folder %ProgramData% \HealthOMeterScales HealthOMeterV2Scales.dll.config Folder [USB Install] DPInst64.exe or DPInst32.exe Healtho2.inf HealthoUSBXpressInst aller.exe setup.ini Folder [USB Install\x64] [USB Install\x86] Stores the scale configuration so all users have access to it. The configuration file for the scales. Note the location varies depending on your version of windows. This folder includes the USB drivers incase you need to repair or reinstall them. The driver installation utility used by the installation. Do not use this to install the drivers interactively. A 32 bit unsigned USB driver for the scales. The installer for the 32bit unsigned USB driver. Information file for the installer. The 32 and 64 bit files for the unsigned USB driver. SiLib.sys USB Driver Files SiUSBxp.sys USB Driver Files Folder [USB Install\SILabs] CP210xVCPInstaller.ex e Contains the USB to COM port driver. Installs the USB to COM port driver. Page 9 of 10

10 Installed with Feature ReleaseNotes.txt File Notes On CD Notes about the driver. setup.ini A driver install file slabvcp.cat slabvcp.inf Folder [USB Install\SILabs\x64] [USB Install\SILabs\x86] silabenm.sys silabser.sys WdfCoInstaller dll The signed catalog for the driver Information file for the driver 64 and 32 Bit driver files Page 10 of 10