Usage Scenario

Jens Hansen is an elderly patient who has a Net4Care powered device at his home, enabling him to perform daily measurements. He has no former experience with computers whatsoever, hence the system has to be as simple as possible.

Because of the fact that he most recently received this equipment, he is suppose to be in contact with a physician every time he wishes to perform a new measurement. Therefore, as Jens go to his device to perform a measurement, he is met with the single option, namely 'call hospital'. After pressing the call hospital button, Jens is informed to wait until the hospital responds. Inside the hospital the physician Anders Jakobsen is responsible for aiding the Net4Care patients and has the Net4Care physician application running on his personal computer. The application now alerts Anders with the message that Jens is ready to perform a new measurement. Hans now has two options: the first option is to call Jens right away, otherwise it is possible to write a message like for example 'You will get help with your measurement in no later than 2 minutes'. When Jens eventually receives a call from the hospital, his Net4Care application automatically accepts the call and makes the new option 'perform measurement' available. At this point the physician and the patient is able to talk together to ensure a valid measurement. When the measurement is performed then Net4Care ensures a proper handling and persistence of the data. After the measurement is completed successfully the physician can look a history of previous measurements. When done, the physician hangs up and this resets the state of both patient and physician to their initial state.

About the example code

Under n4c_example in the Net4Care source, you will find a folder named SkypeSpirometry. This folder contains code to perform the above scenario.

This example should preferably be run on two different machines. Alternatively, have a VM running on top of your OS as the second machine. A third option is to fake the behavior of one of the applications using the chat functionality of the official Skype program (does not matter if you use the desktop version or the smartphone app), see: How to run spirometry example using only one machine.

Both applications takes some arguments.

PatientApplication:

• SkypeAccount
• SkypePassword
• PhysicianSkypeAccount
• Path to keypair

PhysicianApplication:

• SkypeAccount
• SkypePassword
• Path to keypair

Running SkypeSpirometry

Fire up your SkypeKit runtime (as always when running SkypeKit applications). On windows you simple double-click the executable.

More detail can be found at: http://developer.skype.com/skypekit/development-guide/java-tutorial/tutorial-guide-java step 5.

        /path_to_net4care/n4c_example/SkypeSpirometry/mvn clean install

        /path_to_net4care/n4c_example/SkypeSpirometry/n4c_physician

        /path_to_net4care/n4c_example/SkypeSpirometry/n4c_patient

        <!-- Patient skype account name -->
        <arg value="" />
        <!-- Patient skype account password -->
        <arg value="" />
        <!-- Physician skype account name -->
        <arg value="" />
        <!-- Path to keypair -->
        <arg value="" />
        

        mvn test

Using Eclipse

At this point, following the steps above, you should have eclipse setup to use working sets and inside a working set have the n4c_skype project.

Now lets compile the code:

        /path_to_net4care/n4c_example/SkypeSpirometry/mvn clean install eclipse:eclipse

And import the three projects: n4c_data, n4c_patient and n4c_physician the same way that you imported n4c_skype.

Note: If you forget to specify your working set when importing, then the projects most likely gets imported to the working set 'Other Projects'. Simply drag the projects to your own working set if this happens.

Your package explorer should look something like this:

Start either PatientApplication or PhysicianApplication with the correct arguments. The arguments are passed by creating a run configuration for the application by:

        Right-click application->Run As->Run configuration 

Here you have the option to run as a java application and pass the needed arguments.

The arguments needed for PatientApplication are:

• accountname
• accountpassword
• accountname of physician
• an absolute path to the keypair

The arguments needed for PatientApplication are:

• accountname
• accountpassword
• an absolute path to the keypair

Below is an image showing how to add the arguments.

How to run Spirometry example using only one machine

Since both applications communicate through Skype using chat, it is possible to fake the behavior of both applications using one of the official Skype programs.

Below we use skypePatient and skypePhysician as examples of the two skype account names being used.

It should be clear that both Spirometry example applications operate by moving from one fixed state to another, see SkypeSpirometry Screenshots. The states are described below with a comment on how make the application change state using an official Skype program:

• Initial State

  skypePhysician waits for patients to take contact.

• Patient pressed 'Contact the hospital'

  The initial message generated by the skypePatient when pressing 'Contact the hospital' is:

    [<ptName>:<ptCPR>] wishes to perform measurement

  Here the crucial part is [<ptName>:<ptCPR>] which is used by the skypePhysician later. So to fake the initial contact by the skypePatient, use one of the following valid name and CPR pairs:

  • Nancy Berggren 251248-4916
  • Jens Hansen 120753-2355
  • Birgitte Roenholt 120753-2355
  • Birgitte Roenholt 030167-1648
  • Morten Larsson 210688-1111

   

  and write it in a chat message to skypePhysician.

  For instance:

    [<Jens Hansen>:<120753-2355>] wishes to perform measurement

• Patient waiting for physician to become available
• Physician pressed 'Call patient'

  To fake skypePhysician, simply place a call to skypePatient.

• Physician has received measurements

  Since the handling of measurements is done by Net4Care code, the actual storage of measurements cannot be faked by Skype. It is possible to make the application move to the next state though, simply by sending a chat message like:

    Spirometry measurements: \n FVC: 6.6 \n FEV1: 7.8

SkypeSpirometry Screenshots

Initial State

Patient pressed 'Contact the hospital'

Patient waiting for physician to become available

Physician pressed 'Call patient'

Physician has received measurements

Physician looking up history of earlier measurements