software installation guideline & user manual of heartbook ... · software installation...

Software Installation Guideline & User Manual of HeartBook & SmartHelper System by HeartBook (Hong Kong)

P.1 / 13

Software Installation Guideline &

User Manual of HeartBook & SmartHelper System:

Introduction:

The software component of this system consists of client-sided, server-sided applications and MCU’s

programs. The client-sided application is a WP8 APPS, called “HeartBook & SmartHelper Client”. The

server-sided application consists of WCF Services, Server application and Central Database, which are

“HeartBook WCF”, “HeartBook Server” and “HeartBook Database” respectively. The client-sided app

should be installed in users’ Windows Phone 8, and the server-sided system should be installed in a

Windows Server with IIS 8 (However, “HeartBook Server” can also be installed any other PC which has

the network connecting to the server). Finally, the MCU’s programs should be deployed to the Arduino

MCUs in HeartBook Sensor and SmartHelper Sensor (the circuit diagrams can be found in our site:

http://www.stfa-yyc.edu.hk/it/heartbook ) (Note: besides, Ardunio, Netdurino can also be used).

System Requirement:

“HeartBook & SmartHelper Client” – client-sided WP8 APPS:

Windows Phone 8 mobile phone

Resolution: 480 x 800 (or better)

Support: Locationing, Bluetooth (v2.1 or above) and WiFi (and/or 3/4 G)

Server-sided System (for WCF, Database, HeartBook Server):

.NET Framework 4.5

Windows Server 2012 / Windows 8

IIS 8 (or SharePoint Server)

Microsoft SQL Server 2012 (or Express version)

CPU: Intel Core i-3 (or above)

RAM: 4GB (or above)

HeartBook Server (only)

.Net Framework 4.5

Windows Server 2012 / Windows 8

CPU: Intel Core i-3 (or above)

RAM: 4GB (or above)

http://www.stfa-yyc.edu.hk/it/heartbook


P.2 / 13

Installation Procedure: Note: First, please unzip the file (“heartbook_product.zip”), which containing all the XAP,

Installers, Database dacpac/bak, WCF Services and ASP.Net of HeartBook &

SmartHelper.

“HeartBook & SmartHelper Client” – client-sided WP8 APPS:

Connect the WP8 to the Windows 8/7, installed Windows Phone SDK 8.0, with a USB cable

Execute Windows Phone Application Deployment, then press “Browse” to select the

“WP8\HeartBook_SmartHelper_client\HeartBook_Release_AnyCPU.xap” (the name of the

APPS is HeartBook).

Afterwards, press “Deploy” to deploy the APPS to the WP8

The End-point URL of “HeartBook_Release_AnyCPU.xap” is set to be

“http://heartBook.stfa-yyc.edu.hk/HeartRate/HeartRateRecord.Service1.svc” (port: 80), and it

is connected to HeartBook central server in our site. Therefore, this XAP will connect to the

developer’s server. For your testing, you can install “WP8\

HeartBook_SmartHelper_client\HeartBook_Release_AnyCPU_Test.xap” (the name of the APPS

is HeartBook_test), in which the End-point is set to

“http://192.168.12.10/HeartRate/HeartRateRecord.Service1.svc” (port: 80) and you can setup

a server with IIS8 (or SharePoint Server) to hold the Database and WCF (the installation

procedure is described as below).

For the first time of using the APPS “HeartBook”, user is required to enter the user’s

UserID and Password. The users of this APPS can email their applications for the UserID

and Password to [email protected] .

For the honorable judges, you can try the APPS “HeartBook” by using the following user

info:

UserID: 0000000001 Password: 123456

After installing the Database (as described in the below steps), judges can also, try the

APPS “HeartBook_test”, by using the same user’ info (i.e.: UserID: 0000000001 , Password:

123456).

“HelpMe” – another client-sided WP8 APPS:

Connect the WP8 to the Windows 8/7, installed Windows Phone SDK 8.0, with a USB cable

Execute Windows Phone Application Deployment, then press “Browse” to select the

“WP8\HelpMe\HeartBook_Release_AnyCPU.xap” (the name of the APPS is HelpMe).

Afterwards, press “Deploy” to deploy the APPS to the WP8

The End-point URL of “HeartBook_Release_AnyCPU.xap” is set to be

“http://heartBook.stfa-yyc.edu.hk/HeartRate/HeartRateRecord.Service1.svc” (port: 80), and it

is connected to HeartBook central server in our site. Therefore, this XAP will connect to the

developer’s server. For your testing, you can install

http://heartbook.stfa-yyc.edu.hk/HeartRate/HeartRateRecord.Service1.svc


http://192.168.12.10/HeartRate/HeartRateRecord.Service1.svc

mailto:[email protected]




P.3 / 13

“WP8\HelpMe\HeartBook_Release_AnyCPU_Test.xap” (the name of the APPS is Help_test),

in which the End-point is set to

“http://192.168.12.10/HeartRate/HeartRateRecord.Service1.svc” (port: 80) and you can setup

a server with IIS8 (or SharePoint Server) to hold the Database and WCF (the installation

procedure is described as below).

For the first time of using the APPS “Help”, user is required to enter the user’s UserID and

Password. Whenever users of this APPS email their applications for the UserID and

Password to [email protected] for the “HeartBook” APPS, the given ID and

password are also applicable in “HelpMe”.

For the honorable judges, you can try the APPS “HelpMe” by using the following user info:

UserID: 0000000001 Password: 123456

After installing the Database (as described in the below steps), judges can also, try the

APPS “HelpMe_test”, by using the same user’ info (i.e.: UserID: 0000000001 , Password:

123456).

Server-sided System:

Note: as mentioned above, if “HeartBook_Release_AnyCPU.xap” is used, there is NO need to setup

the server. Otherwise, if you want to use “HeartBook_Release_AnyCPU_Test.xap” and test the

power of WCF services, database and server, please prepare a server running Windows Server 2012

with the above system requirement, and set its IP to be “192.168.12.10/255.255.255.0”. Then

following the below procedures:

WCF Services:

Note: All the files and folders are in “WCF\”

When only IIS 8 is installed in the server,

Go to IIS Manager,

In “ApplicationPool”, CREATE a new pool, called “HeartRate” and set the “Application

Pool Identity” to be “NetworkService”

Under “Default Web Site”, CREATE a new “Application”, called “HeartRate”, and

assign the newly created “Application Pool”, “HeartRate” to be this “Application”’s

application pool.

Copy the folders (“bin”, “Service References”) and files

(“HeartRateRecord.Service1.svc” and “Web.config”), after the unzip of the zip file, to

the newly created “Application”’s directory (wwwroot\HeartRate)

Afterwards, just restart the IIS to run this “Application”. Then the WCF Services will

work normally.

When SharePoint is installed in the server,

Just create a directory, “HeartRate” in the working directory in SharePoint Server

Copy the folders (“bin”, “Service References”) and files

(“HeartRateRecord.Service1.svc” and “Web.config”), after the unzip of the zip file, to

the newly created “Application”’s directory (wwwroot\HeartRate)

http://192.168.12.10/HeartRate/HeartRateRecord.Service1.svc

mailto:[email protected]


P.4 / 13

HeartBook Database:

use SQL Server Data Tools (SSDT) to "Publish" the "HeartRate_Record" Database (by giving

the Database name as "HeartRate_Record") with the "database\HeartBookDB.dacpac"

file

If the above “DACPAC” file is failed to imported into the SQL Server (or not data in

the tables), please try to RESTORE the “database\HeartBookDB.bak” in SQL Server

Management Studio to restore all the tables and necessary data in the database

"HeartRate_Record"

Note: the operational administrator account of the database, “HeartRate_Record” is

“hr_admin” (with password: 123456)

Please CREATE “hr_admin” and “NT AUTHORITY\NETWORK SERVICE” accounts in

SQL Server, and assign these two accounts the roles of “sysadmin”. Also, assign all

the Rights of the database “HeartRate_Record” to these two accounts.

HeartBook Server (WPF program for central administrator in local):

Just execute the installed, “HeartBookServer\HeartBookServer_installer.exe”. Then the

“HeartBook Server” will be installed in your machine

Note: “HeartBook Server” can be installed in different Server/PC other than the server

installed the WCF Service and Database

HeartBook Server For Users (for users to browse and extract their own data,

such as heart rate, status of irregular heart beating, no heart beat, fall down

and HelpMe calling (all with the GPS location)) (ASP.Net application, and

hosted in IIS 8):

In IIS 8, CREATE an APPLICATION, “hbserver” under the “Default Web Site”

Copy all the files and folders in “HeartBookServer_ASPNET__for_user\hbserver” to the

newly created APPLICATION’s folder (i.e.: C:\inetpub\wwwroot\hbserver ).

Also, in IIS, create an ApplicationPool, “HeartBookServer”, and assign “NetworkService” as

its ID

Finally in IIS, go to the “Advanced Setting” of the Application “hbserver”, and assign

“HeartBookServer” as its ApplicationPool.

Note: the users of the WP8 APPS, “HeartBook” can browse and extract their data from

Server in our site (http://heartbook.stfa-yyc.edu.hk/hbserver/login.aspx ). For all

honorable judges, you can access the data in the above site by using the UerID:

0000000001 (password: 123456). Besides, after installing this APS.Net application in your

machine with IIS, you can try this application in your own site with the same Ids (share

the data with the same Database, HeartRate_Record).

MCU programs:

HeartBook Sensor:

Note: If you are interested in it, you are encouraged to build this sensor according to the

http://heartbook.stfa-yyc.edu.hk/hbserver/login.aspx


P.5 / 13

instructions in our website (http://www.stfa-yyc.edu.hk/it/heartbook )

Connect the Arduino (Mini) MCU to the PC (with Arduino 1.0.0 installed).

Open Arduino 1.0.0 (can be downloaded from its website).

Then load the “arduino\HeartBook_Sensor.txt”, the HeartBook Sensor MCU program.

Finally, press “Compile” and then “Upload” to upload the program to the Arduino MCU.

SmartHelper Sensor:

Note: If you are interested in it, you are encouraged to build this sensor according to the

instructions in our website (http://www.stfa-yyc.edu.hk/it/heartbook )

Connect anther Arduino MCU to the PC (with Arduino 1.0.0 installed).

Open Arduino 1.0.0 (can be downloaded from its website).

Then load the “arduino\SmartHelper_Sensor.txt”, the SmartHelper Sensor MCU program.

Finally, press “Compile” and then “Upload” to upload the program to the Arduino MCU.

User Manual – Operation Procedure:

1. User Manual of “HeartBook & SmartHelper Client” (WP8 APPS):

1.1 Configuration

Case 1: Configuration should be done at the first time using HeartBook & SmartHelper Client

1. Press“Config” 2. Enter the user’s information, which are UserID and Password (in this case the user ID be 0000000001 and the password be 123456




P.6 / 13

3. Press “Check” button to validate the user’s identity. If the user’s name is displayed correctly will appear (e.g. “Peter Chow”in this case), that means the user’s identity is verified.

4. Press”Save and Return”to save the user’s information and return to the system (The APPS will “memorize” and use the user’s info in the daily operation.

Case 2: When the user want to change the configuration

1. Open the “APPS”, then press “Config” 2. Enter the new information


P.7 / 13

3. Press “Check” button 4. Press”Save and Return”

1.2 HeartBook & SmartHelper Client program (WP8 APPS) -- Operation:

1. User can open ”HeartBook” on the start page. 2. Press ”Discover Bluetooth Device”

OR


P.8 / 13

3. Choose BT (e.g.: STFAYYC_BT02) 4. Press ”Connect to SmartHelper” 5. Choose BT (e.g.: STFAYYC_BT03)

6. Press ”Connect to HeartBook

Sensor”

7. Tick”Track GPS”(show GPS

location) (red circle in the following

picture)

NOTE： HeartBook and SmartHelper can running

alone。

- If running HeartBook system only，only need to

run step 1,2,5,6,7

- If running SmartHelper system only, only need to

run step 1,2,5,6,7


P.9 / 13

2. HelpMe (WP8 APPS) (User Manual):

Step

1

A.) Press the APPS’ shortcut key.

1. Press ”HelpMe” APPS

which is circle with red

circle.

B.) Using Voice-command-triggered

1. Press ”Start ”of 3 seconds(red circle part).

2. Then the phone will listen the instruction.

3. Say ”open HelpMe”

(the following box

will be showed).

OR

Step

2

The rescue message is sending, please wait for a while (message and user’s GPS location will send to HeartBook Server).

Step

3

After finish send the message, the system would then automatically shut down..

Note: Just like the “HeartBook & SmartHelper Client”, in the first time of execution, user will be asked to enter user’s info (UserID and Password). The procedure of entering the user’s identity is the same as that of “HeartBook & SmartHelper Client”. Of course, whenever, the user want to change his/her ID, he/she can press “Config” in step 2.

OPEN HELPMe


P.10 / 13

3. HeartBook Server (User Manual):

3.1 Instant Monitoring for the user Special Event and Rescue:

1. Special Event information

2. Choose to check all user or only user (when choose only user, you should enter User ID)

3. Choose to check the Time Period

4. Choose to check only unhandled case

5. Search to check 2, 3, 4 information

6. Choose to Auto Update

7. Press to check the normal event

1

2

3

4 6 5

7


P.11 / 13

3.2 Instant Monitoring for the user Normal Event:

8. Normal Event information

9. Choose to check all user or only user (when choose only user, you should enter User ID)

10. Choose to check the Time Period

11. Search to check 9, 10 information

12. Choose to Auto Update

13. Press to check the special event

8

9

10

1211

13


P.12 / 13

4. HeartBook Server For User (User Manual):

HeartBook Server For Users (for users to browse or extract their own data (to CSV file) from the server) (http://heartbook.stfa-yyc.edu.hk/hbserver/login.aspx)

Step 1: Login(By typing user ID and password)

Step 2: Select the period of the data, and select the type of the data (Special Event / Normal Event).

Then click submit


P.13 / 13

Step 3: Then the user’s required data will be displayed

Step 4: User can click “Extract Data to Excel” button to get/save the CSV file

software installation guideline & user manual of heartbook ... · software installation...

Documents