DIASYM manual




DIASYM
version 1.14

Diabetes diary for Symbian smartphones
with data transfer interface to mediaspects DIABASS

© 2010-2011 by hermocom
http://www.hermocom.com


Table of contents

1. What is DIASYM
DIASYM is an electronic diabetes diary for cellphones.

DIASYM runs on cellphones / smartphones with the Symbian operating system with GUIs "S60" (from version 2) and "UIQ" (from version 2).

For further information about compatibility with phone models please click here.

DIASYM is compatible to mediaspects DIABASS ( http://www.diabass.info/ ), an MS Windows based application for gathering and evaluating diabetes data (diary and long-term), running on Windows PCs and Windows Mobile.

DIASYM can be used as a stand-alone diabetes diary on the cellphone, but it can also be used as an "input module" for DIABASS.

Forthermore it is possible to export the diary data from DIASYM to a CSV file, which can be imported into database or spreadsheet applcations for further processing and archiving.
CSV is a universal file format, which can be processed by many applications.
2. About this manual
The HTML version of this manual contains inline embedded images. Most modern Internet browsers are capable to display them. However, Microsoft Internet Explorer older than version 8 and Apple's Safari browser do not or only partially support displaying these images.
Known to work well are latest versions of Opera, Mozilla FireFox and Internet Explorer 8.

The screenshots of DIASYM shown in this manual are taken on a phone using Symbian UIQ3.

On phones with different software platforms the displayed screens and dialogs may look differently.
So the screenshots in this manual are only meant for orientation.

3. License
Please read the terms and conditions of the DIASYM license below carefully before installing and using DIASYM:


Copyright (C) 2010 hermocom

This software is provided 'as-is',without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

YOU USE THIS SOFTWARE AT YOUR OWN RISK. THE AUTHOR WILL NOT BE LIABLE FOR DATA LOSS, DAMAGES, LOSS OF PROFITS OR ANY OTHER KIND OF LOSS WHILE USING OR MISUSING THIS SOFTWARE.
THE AUTHOR WILL ALSO NOT BE LIABLE IN CASE THE HEALTH OF THE USER IS AFFECTED SINCE USING THIS SOFTWARE (NO MATTER IF A CAUSAL CONNECTION BETWEEN USAGE OF THIS SOFTWARE AND HEALTH AFFECTION EXISTS OR NOT).
THIS SOFTWARE IS ONLY A SUPPLEMENT FOR DIABETES TREATMENT. IT CAN IN NO WAY REPLACE THE ADVICE OF A DOCTOR.


All copyrights to "DIASYM" are exclusively owned by the author of this software - Daniel Hertrich (hermocom).The unregistered version (Demo mode) limits the number of diar entries which can be created. If you wish to remove the limitation, you must obtain a usage license from hermocom.


Once registered, you will receive a license key by email that unlocks all features of "DIASYM".

The LICENSOR grants you a non-exclusive, non-transferable license to install and use the Software conditional upon the following limitations:

You may:

1) Install and use the Software on one Symbian Smartphone

2) Copy the software onto the hard disk of the computer and retain the original installation file for archival purposes only.

You may not:

1) Use the Software for purposes other than as authorized in this License Agreement or knowingly permit anyone else to do so

2) Disclose any part of the product to anyone or make any part of the software, documentation or other material you may receive from hermocom relating to the Product available to anyone

3) Sell, transfer, sublicense, lend, rent, lease or give the product to any third party or allow any third party to use the product unless you are an authorized reseller or have written permission from hermocom.

4) Use, copy, emulate, clone, rent, lease, sell, modify, decompile, disassemble, otherwise reverse engineer, or transfer the licensed program, or any subset of the licensed program, or permit others to do so, except as provided for in this agreement. Any such unauthorized use shall result in immediate and automatic termination of this license and may result in criminal and/or civil prosecution.

The registered "DIASYM" software may not be rented or leased. All rights not expressly granted here are reserved by the author of this software. Installing and using "DIASYM" signifies acceptance of the terms and conditions of this license. If you do not agree with the terms of this license you must remove "DIASYM" files from your storage devices and cease to use the product.

Trademarks:

Product names, logos, brands, and other trademarks featured or referred to within this software are the property of their respective trademark holders.


Severability Clause:


Should any part of this Agreement be rendered or declared invalid by a court of competent jurisdiction, such invalidation of such part or portion of this Agreement should not invalidate the remaining portions thereof, and they shall remain in full force and effect.

It is further agreed that if part of the Agreement is determined invalid, either party may open negotiations solely with respect to a substitute for such Article, Section, or portion, within two (2) weeks after a ruling has been made.
4. Download of the latest DIASYM version / updates
DIASYM is downloadable for no fee from the Internet and can be tested in its unregistered mode immediately.
You can find the latest version of DIASYM here:
http://www.hermocom.com/downloads/diabetes/diasym/

In order to receive notifications about program updates, please subscribe to the hermocom newsletter.
This is possible on the hermocom homepage http://www.hermocom.com in the newsletter subscription field by entering your name and email address.



Don't worry. Your data is safe and won't be given or sold to a third party. You also won't be spammed by any newletters and advertisement. You only will receive the selected newsletters, which are not published very frequently.

5. Installation
You have received or downloaded DIASYM as a ZIP archive file.
This ZIP file contains several variants of DIASYM for different types of phones.
The SIS files contained in the ZIP file are the actual installation packages.
Currently, five SIS files are delivered for the following phone platforms:

  • Symbian S60 2nd edition
  • Symbian S60 3rd edition
  • Symbian S60 5th edition and Symbian^3
  • Symbian UIQ 2
  • Symbian UIQ 3

New Symbian Smartphones are usually delivered with Symbian S60 5th edition or Symbian^3 (as of December 2010).

The section "Supported phone models" of this manual's appendix lists the supported phone models and the according SIS version for each phone.


Please install only the one SIS file on your phone which fits the phone's operating system and GUI type, according to the instructions for installation of additional applications, which should be given in the manual of your phone.
Usually this is done using the PC application suite for your phone, or manually by transfering the SIS file to the phone (using a memory card or the file manager of the PC suite, or via Bluetooth) and opening the SIS file on the phone.

It is strongly recommended to install DIASYM on the internal phone memory, not on a memory card or built-in additional Multimedia storage, because only the phone memory is permanently available to the phone. If you connect your phone e.g. via USB cable to a PC, the additional storage or memory card is usually disconnected internally from the phone and made visible to the PC instead. If DIASYM is installed on that memory and if it is running during that process, DIASYM may hang, crash and maybe you will lose diary data.

Attention:
In case you are unable to install DIASYM due to a failed signature check, you must disable signature ceck on your phone and restart the installation.
On UIQ phones this should not be necessary.
On S60 phones this is done in the program manager's options dialog. Change the setting from "install only signed aplications" to "install all applications".

If you have problems or questions, please don't hesitate to contact hermocom.
5.1. Update to a newer version
Usually, in order to update DIASYM to the latest version, it is sufficient to download the new version from http://www.hermocom.com/products/symbian/diasym and initiate the installation. The phone will take care about updating the old version.

However, please verify that the update is properly installed. Sometimes it can happen that the new version is installed in parallel to the old version and that after the update you still use the old version instead of the new one.
  • Once you started the installation, make sure the installation routine reports that this is an update of an older version, not a new install
  • If it didn't, use the "About DIASYM" menu item to check the version number and compare it to the version number shown here besides the download link.
  • Check your applications menu to see if there are now two instances of DIASYM
  • If you are running an older version after the update, or if there are two DIASYM entries, uninstall DIASYM entirely (both, if there are two) and reinstall the new one. Don't worry: Your settings and data will be kept.

6. How to start and how to quit DIASYM
After successful installation, you find the DIASYM icon in the application menu of your cellphone. Using this icon, you can start DIASYM.

Generally DIASYM does not need to be quit manually by you. The operating system of your cellphone terminates DIASYM automatically, if DIASYM is currently not active and if the operating system needs more ressources.

In special cases it may make sense to quit DIASYM manually, e.g. if you plan to install an update of DIASYM, or if you have installed the program and/or its data on a memory card and plan to eject the card out of the cellphone, or if you want to trigger automatic deletion of old DIASYM reminders from the calendar (this is decribed later on).
7. Konfiguration
When you first launch DIASYM, the configuration dialog is shown.
If you are unsure about some of the settings, you can leave the default values unchanged and adjust the settings later using the "Configuration" menu item. Data which you may have entered until then will not be changed or deleted.

Only the storage location for the diary file should be chosen carefully directly at the beginning. See below in the section "Choose data storage".
It is recommended to chose the phone memory here.
7.1. Language
In this first configuration dialog you can set the language for the user interface of DIASYM.

Currently you can choose between German, English and French.
7.2. Choose data storage
This dialog is only shown if a memory card or internal memory expansion is detected, in addition to the internal phone memory.
Otherwise, the internal phone memory is automatically defined as storage location for the diary file, without asking.

If such a memory expansion is detected, it can be chosen as the storage location for the diary file and for exported CSV files.

Please note:
It is strongly recommended to use the internal phone memory as data storage.
If you choose the memory card / memory expansion, there is a risk of data loss, especially in following scenarios:

  • You connect your phone with a cable to the PC: The expansion memory will maybe be attached to the PC as mass storage device and internally disconnected from the phone. DIASYM won't be able to save the diary anymore and may at least run into an error, maybe crash.
  • You remove the memory card from the phone. Also here, DIASYM cannot save the diary anymore.

If you change the data storage location in the configuration dialog later, DIASYM offers to move the data from the old storage location to the new one.

DIASYM uses a database file with a fixed name in a fixed directory in the chosen storage location. It is not possible to have DIASYM use more than one diary with different file names or in different directories.
7.3. Units / Blood pressure
In the next dialog you can configure the units you use for measurements:

  • Blood glucose (mg/dl or mmol/l)
  • Carbohydrates (BE 12g, KE10g or grams)
  • Your weight (kg or lbs)

This screen also offers a field to configure if you want to enter blood pressure data or not.

Furthermore you can set the time range of your diagram day (day h-h) in this dialog.
If this is set to 0, the day view will reach from midnight to midnight.
Another setting shifts the time range by the amount of set hours.
E.g. if you set "day h-h" to 2, the day diagram will reach from 2am of the current day to 2am of the following day.
This makes sense if you go to sleep after midnight and thus the lived day is shifted against the real day.
The day diagram should rather show the lived day than the real day.


Note:
If you reconfigure the program, all data in the diary file won't be touched. That means, if you change e.g. the unit for blood glucose from mg/dl to mmol/l, you see and enter all blood glucose values from then on in mmol/l. But the conversion into mmol/l happens only in the user interface when entering and displaying the data. In the database file, all data is stored independently from the unit.
You can also switch back to mg/dl whenever you want to.
Or to say it differenty:
You may change the units in the configuration whenever you want to. You never have to worry about data in the database being damaged, having less accuracy afterwards, or being deleted.
7.4. BG ranges
In this configuration dialog you determine the target range and several other ranges respectively limits and presets for your blood glucose.


Hypo to
All values lower or equal to this value are displayed in the hypoglycemia range in the diagram (blue range).

Good to
All values between "Hypo to" and this value are your target range ("good values", green range).

High to
All values between "Good to" and this value are displayed as "too high" (yellow range).

Graph to
All values between "High to" and this value are displayed as "much too high" in the diagram (red range).
All values larger than this value are displayed at the top edge of the diagram and marked with an up-arrow.




In the example above you see the results of the BG range settings:
 
Hypo to: 70 mg/dl
Good to: 140 mg/dl
High to: 200 mg/dl
Graph to: 300 mg/dl

The BG value at 11pm (23:00) is 350mg/dl. Due to the diagram only reaching up to 300mg/dl, it is marked with an arrow to show that the value is larger than the diagram can show.


Hypo range
s:

Enter two BG values here. One for the average BG value of a slight hypoglycemia and one for the average BG of a hard hypoglycemia. Since "slight" and "hard" are highly subjective, there are no exact values to be given here. But take the values from your experience.

The values to be given here are used for two purposes:

1. Whenever a hypoglycemia without a BG value is entered (i.e. you don't give a BG value but check the field "hypo"), DIASYM asks for the severity of your hypo (hard or slight).Dependent on your answer, DIASYM enters the value tor "hard" or "slight" automatically into the diary and flags the value as "estimated" with the according event setting. That way, also only felt but not measured hypoglycemias can be visualized and evaluated statistically.

2. Whenever a hypo with a BG value is enered (i.e. you enter a low BG and check the field "hypo"), DIASYM determines automatically which one of the two hypo events it should set (slight hypo "-" or hard hypo "--"), dependent of in which range the value is (lower or greater than the average of the values for slight and hard hypo). Example:

Slight = 70 mg/dl
Hard = 40 mg/dl
Entered = 53 mg/dl

Entered value is classified as hard hypo, because 53mg/dl is lower than the average value (Slight + Hard) / 2.
8. Registration / Obtaining a license
When you installed and run DIASYM for the first time on your phone, the program runs in DEMO mode. In DEMO mode, you can only enter a limited number of diary entries. If you have reached that limit, you cannot generate more entries.

In order to overcome this limitation, you need a license key.

You can buy a license key directly from hermocom.
http://www.hermocom.com/products/symbian/diasym
Contact data is printed at the end of this manual.
The price for a full license is given on the hermocom homepage (s.a.).
There is no automated order system for licenses (yet), so please simply order a license by email or telephone.
Payment can be done using direct wire transfer (BIC, IBAN) or Paypal (and using Paypal also with the credit card).

Once you have obtained a license username / key pair, use the menu item "Registration", where you can enter the user name and license key.
Please note that both user name and license key must be entered exactly into the respective fields. Each error only in capitalization or spaces will result in the license data not being accepted.

After you have entered valid license data and submitted it with "OK", the program runs in licensed mode and you can use the program without any limitation.

9. Usage of DIASYM
When prigramming DIASYM I have set a high value on quick and simple handling of this program
In case you have suggestions how to improve the handling of DIASYM further, please drop me a line. Contact data is printed at the end of this manual.
9.1. The home screen
The first screen you see after starting DIASYM is the so-called home screen.



From the home screen you can do the following, either using the touchscreen, or the menu, or the key printed near to the icon:
  • Enter a new record into your diary (key 1)
  • View and browse your diary (key 3)
  • Export your data (e.g. for import into DIABASS) (key 7)
  • Configure DIASYM (key 9)


Using the menu you have the additional option to quit DIASYM entirely.
(Usually, if you just don't use DIASYM and switch to another applications, DIASYM either continues to run in the background, or, if it runs in background, the Symbian OS terminates DIASYM automatically, if it needs more system ressources. This is normal behavior under Symbian.)

9.2. The diary
The diary of DIASYM is, technically spoken, a file saved on your phone, containing all entered diary data in coded form.

DIASYM presents the diary data in a convenient way in a day diagram in the upper and a detail view in the lower part of the screen.

The detail view has two modes:
- The day mode (blue frame around detail view, no diary entry marked) shows day statistics
- The entry mode (red frame around detail view, one diary entry is marked and "connected" to the detail view using a red bar) shows details about the selected entry.

This is how the two modes look lile (left: entry mode, right: day mode).


9.2.1. New entry
You can add a new entry to the diary by pressing the "1" key on your phone, when the day screen is shown.

On phones with QWERT keyboards, you press the "N" key ("new").

Or you choose the menu item "New entry".

With touchscreen operation, touch the screen in the detail view area and then touch the button "NEW". If there is no "NEW" button, first touch the button "DAY", then "NEW".


A dialog is shown, with several fields for the values you can enter.


Date and time are predefined with the current date and time, if the day view showed the current day.

If you navigated to another day than the current one before, only the date will be predefined. The time is empty and must bei filled by you manually. This way it is easier to add entries for prior days (less key presses are necessary).

If you don't want to give a value for a fields, you can simple leave the field empty or leave the default value (mostly "0"). This is interpreted as "no value".

BG (Blood glucose):
Here you enter the measured blood glucose in the unit you defined in the configuration dialog.

Hypo:
If you feel you have a hypoglycemia, check this field.

Date / Time:
Date and time of the diary entry.
Please note that date and time do not have to be entered in the format of the predefined values. You may omit the delimiters entirely or use other delimiters. Only the count and order of numbers must match.

Currently, the German format is possible only:
DD.MM.YYYY for date and
HH:MM for the time,
respectively
DDMMYYYY and HHMM.

E.g. for 22th of March, 2010 3:25pm you may enter e.g.
Date: 22.03.2010
Time: 15:25
or
Date: 22-03-2010
Time: 15,25
or simply
Date: 22032010
Time: 1525

If your entry is detected to be valid, it will be converted to normal presentation for the detail view and for saving in the database.

Please note:
The fields "Date" and "Time" are handled as text fields by DIASYM. Due to that, the text mode is active first, if you enter the fields to write something into them. In order to write numbers into the fields, you first have to switch to number mode. The documentation of your phone explains how to do that. Usually this is only one keystroke.

Bolus un.:
Bolus insulin units
(alternatively different medication)

Basal un.:
Basal insulin units
(alternatively different medication)

Carbohydrates:
Carbohydratees in the unit you defined in the configuration dialog.

Inj.-Food delay (min):
Delay between the insulin injection and the meal, in minutes (e.g. input "120" for two hours).
If you enter an injection-food delay at the current time, DIASYM offers you to add a food reminder to the agenda of your phone. If you confirm, the reminder is created so that at the current time plus injection-food delay an alarm is triggered, so you recall that you need to eat at that time.

Comment:
Here you can enter arbitrary text as a comment for this record.

Weight:
Your weight in the unit you defined in the configuration dialog.

Once you are done entering the values, confirm the dialog with "OK".
The created entry is displayed in the day graph and the detail view shows the details of the entry. If you have entered a BG value, it will be displayed as a dot in the diagram in the height which corresponds to the height of the BG.
If you did not enter a BG value, the new record will be displayed as a short vertical line at the bottom of the diagram.

Events
are entered in another dialog.
To see that dialog, you must edit the record you want to add events to.
Once the dialog with the record values is shown, confirm that with "OK" and then the events dialog will be displayed.
Read more about events further down in this manual.

Blood pressure and pulse:
(new since program version 1.12):
If you have chosen "Yes" for the item "Use blood pressure" in the configuration, the blood pressure dialog will be shown now after the main entry dialog and - maybe - the events dialog.
Here you can enter the values for the blood pressure (systolic / diastolic) and pulse. Leave "0" if you don't want to fill a field.

9.2.2. Navigating inside the diary
There are two ways to scroll through the diary.

1. Entry-wise
2. Day-wise

Entry-wise scrolling puts the detail view in entry mode (s.a.).
Day-wise scrolling puts the detail view in day mode (s.a.).

The ways how you scroll through the diary are different from phone to phone. This depends on the available controls and keys.

You scroll entry-wise by e.g. turning the jog-dial wheel of a Sony-Ericsson phone (the small wheel on the left side). On devices with a 2-dimensional navigation key or cross press the up/down keys.

You scroll day-wise
by using the cursor keys or navigation keys left/right.

By hitting the "0" key or space key (depending on the kind of keyboard) or the "DAY" touchscreen button, you switch the display from entry mode to day mode.
Hitting that key a second time (or when you already are in day mode), DIASYM's day view jumps to the current day.


Touchscreen navigation:
All navigation functions are also available using the touchscreen
Activate the touchscreen buttons by touching the detail view area of the display.
The touchscreen buttons will be displayed as an overlay to the detail view.

In all modes:
"<" und ">" scroll entry-wise.
"<<" und ">>" scroll day-wise.
In entry mode:
"EDIT" opens the corrent recurs for editing.
"DAY" changes to day mode.
In day mode:
"NEW" creates a new record.
"TODAY" jumps to the current day.

If you don't use the touchscreen for a few seconds, the touchscreen buttons will be hidden again so you can read the detail view contents better.
You can also hide the touchscreen buttons manually by touching the screen in the area of the diagram.
9.2.3. Edit entry / Events
Forediting an existing entry and for adding events to an entry, mark the entry and press the "Go" key of your phone. This is, depending on the phone model, the center of the navigation key, a press of the jog dial etc..

On the touchscreen, touch the "EDIT" button.

The edit dialog, which is similar to the "add entry" dialog, is opened and allows to modify all data.

If you confirm this dialog with "OK", the events dialog is shown.
Here you can mark all events which apply to this record.
Then hit "OK" again to save the record with the marked events.
If you don't want to add events, simply hit "OK" without prior marking any event.
9.2.3.1. Usage of events
You don't need to use events.
It can make sense to consequently use events, though, if you like to analyze your blood glucose values depentent on events.
DIASYM doen't offer any such analysis features at this time. But in mediaspects DIABASS this is possible.
But note that a reliable event-dependent analysis is only possible, if you use events consequently.

The events which are predefined in DIASYM mostly fit those predefined in mediaspects DIABASS.

In the DIASYM installation archive (DIASYM_vX.XX.zip) there is the file "Events.pdf". This is a table listing all events which are available in DIASYM.
There is also visualized, which ones of these events are also predefined in DIABASS and hence on data import from DIASYM initally are "understood" by DIABASS, and which of those events are DIASYM-specific.
In the Events.pdf you also see the event abbreviations.

In practice you may not set all events which really apply to a record, but only those which are of interest to you. This is okay, in case you are sure that those events not set won't interest you even in future.

In the lower part of the event dialog, below the predefined events, you find 25 "Undefined" events.
You can use those, if you want to use events which do not match one of the predefined events.
You can either apply a meaning to an "Undefined" event by yourself and write it down somewhere so you don't forget the meaning. Or you can change the display of these events in the events dialog so it does not say "Undefined" anymore but reflects the meaning you wish. However, this is currently only possible by editing the settings file "diasym.properties" manually.

If you transfer DIASYM data to DIABASS (using DIABASS Export), events are transfered using their abbreviations.
The abbreviations of the DIASYM events, which are also predefined in DIABASS, are initially "understood" by DIABASS. If you use events in DIASYM, which are not predefined in DIABASS (see DIASYM_Events.pdf), you may need to defined those events in DIABASS manually.


At the bottom of the event list there is an event called "LetActivated". This event is activated. It does not have any meaning to you. It's only there to work around a bug in the Symbian S60 5th edition programming interface. in later versions of DIASYM this event will probably be removed. Please always let it activated.
9.2.4. Delete an entry
An entry is deleted by marking the entry and choosing "Delete" from the menu.
9.2.5. Day statistics
In day mode (detail view colored blue), day statistics are displayed in the detail view.

The statistics are mostly self-explanatory.
Displayed are average values (BG) and sums (carbohydrates, insulin) for the entire day. The events of all records of a day are collected and displayed.

There is also a pie chart in the right area, which is intended to make the "quality" of the day visible at a glance.
The colored pie pieces represent the percentage of the amount of values in the respective range (hypo, good, high, too high) at that day.
The diameter of the pie represents the significance of the graph. This depends on the amount of measurements taken over the day. The larger the diagram is, the more measurements are done on that day, and the more singnificant is the graph.
9.2.6. How special properties of a record are visualized
In the diagram BG values are normally displayed as black dots which are placed at the intersection of the axis for the according time and BG value.

If a value is marked as hypoglycemia, the color of the dot is purple.

If a value is marked as "estimated", its color is slightly transparent.

If a value is marked as "outlier with known reason", the color of the dot is white.

If a value is higher than the diagram can display, the dot is marked with an arrow pointing upwards.

A record without a BG value is displayed in the diagram as a short vertical line at the lower edge of the diagram.
9.2.7. Saving of the diary
Normally you don't need to care about saving at all. DIASYM handles that automatically.

In the upper right corner of the DIASYM screen you sometimes find a small red dot. This red dot means that there are unsaved changes to the diary. DIASYM saves the diary automatically to the diary file, when 15 seconds have elapsed since the last user input (key press, touch screen tap). Then the dot disappears.

In practice the red dot means:
Should you, while the red dot is there, e.g. switch off the telephone, remove the battery, or start an application which needs so many system ressources that the system automatically shuts down C-Diary, the last changes to your diary would be lost.

In case you like to manually trigger a diary save (e.g. if you enter a lot of records, don't wait for 15 seconds in between and want to make sure that the new records are saved from time to time), press:

Key "3" on a numeric keyboard,
Key "S" on a QWERT keyboard (S for "Save"),
or on a touchscreen, tap the area around the red dot (the right half of the diagram area).
9.3. Reminders
You can let DIASYM add reminders to the calendar application of your phone, in order to let the phone remind you of a BG measurement or a meal.

Please take care that you configure the alarm of your phone properly so you really hear the alarm.

Warning: Don't rely too much on these reminders! Should a reminder not work properly, and you don't recall the measurement or meal yourself, the blood glucose may go very high or low and this may even result in life-threatening situations!
For proper function of the reminder / alarm features cannot be given any warranty.

9.3.1. Measurement reminders
Choose the menu item "Reminder" or hit the "2" key or the "E" key of your phone in order to create a reminder for a BG measurement.
Then enter the amount of hours from the current time on to be reminded.

Using this reminder makes sense e.g. when you have corrected a high BG value by an insulin injection and you want to check if the correction was successful.
9.3.2. Food reminders
If you create a new entry at the current time and enter an injection-food delay, DIASYM offers you to create a food reminder.

The time at which the reminder is triggered is calculated by adding the infection-food delay (minutes) to the current time.

Example:
You usually do not have injection-food delays because you use fast insulin.
Your BG value is 200 mg/dl.
You want to eat as soon as possible.
You know that your BG drops by about 100 mg/dl in one hour for each 2 insulin units injected.
Now you inject 14 insulin units and enter an injection-food delay of 60 minutes.
Two of those insulin units are meant to lower your BG by 100 mg/dl before you eat. The remaining 12 insulin uints are meant for the meal as a bolus.
If the phone reminds you to eat after one hour, the BG should be in the normal range (better check that by a new measurement!) and you still have 12 insulin units left for your meal.
9.3.3. Deletion of reminders from the calendar of your phone
DIASYM deletes old reminders automatically from the calendar, in order to release unneeded ressources of your phone (and maybe also of the calendar of your PC, if you synchronize those).
This process is initiated everytime you quit DIASYM completely by using the menu item "Quit" or by hitting the "9" key or the "Q" key from the home screen.
9.4. DIABASS export / data tranfer to mediaspects DIABASS using a file
Using the menu item "DIABASS export" you can export the diary in DAE format.
DAE is a kind of CSV format, i.e. a text-based table format, which can be imported by mediaspects DIABASS.

The file created this way can also be imported into spreadsheet or database applications such as Microsoft Excel or Access. Some applications prefer the imported file to be named ".csv". You can simply remane the file from "*.dae" to "*.csv".

On the first DIABASS export the complete DIASYM diary data is exported.
On each subsequent export you can choose whether the entire diary should be exported or only that part of the diary which has been added since the last export.

After the export you can choose if the diary so far shall be kept and continued, or if you want to start over with a clean new diary.
If you use DIASYM only as entry module for DIABASS or another application, you can delete the entire diary after export. This ensures that you always get the maximum performance of DIASYM. The more data the DIASYM diary contains, the slower will DIASYM be. This is only noticeable when there are several hundered entries, though. Several thousand entries may make DIASYM slow enough to be annoying.

After successful export DIASYM asks, if you want to send the generated CSV file to a PC, e.g. for import into DIABASS or another application. If you reply with "Yes", DIASYM hands over the generated file to the operating system (OS) of your phone, telling the OS that you want to send the file to a PC.
The OS then automatically displays a dialog in which you can choose from several methods to send the file. The available choices depend on the capabilities of your phone.
Depending on the configuration of your phone the following items may be displayed:

Bluetooth
IR (Infrared interface)
MMS
E-Mail

Bluetooth and IR are, if available, the most convenient methods.
When transfering these ways, you can choose on the PC where the transfered file should be saved.
When choosing Bluetooth, you may be asked to enter a PIN at the PC, which is then asked for on the phone immediately. This is for authentication, thus for your safety. Usually there is a way to permanently save this authentication so you don't have to enter the PINs again on future file transfers.

Usually you can choose where to store the file when you chose Bluetooth or IR: You may - depending on the used Bluetooth software on the PC - also find your file in the folder "My documents\Bluetooth\Inbox" or similar.

Transfering using MMS does not make sense, since PCs usually are not capable of receiving MMS.

Transfering using Email only works if you have configured the Email client of your phone properly.

Independent of the choice for sending the file to a PC, the CSV file is saved on your phone, too, in the same directory as the DIASYM diary file is stored in. An according hint with the full path name is displayed after CSV export. That way you can also access the file using the PC suite's file manager of your phone.

9.4.1. Import of DIASYM data into DIABASS
If you have installed mediaspects DIABASS with the DIASYM import filter on your PC, all you need to do is doubleclick the transfered file on the PC. DIABASS will take care about importing the data into your DIABASS diary.

For details about the import into DIABASS, please consult the manual of mediaspects DIABASS.
9.5. Diary info
The menu item "Diary info" shows statistical information about your diary.

The displayed "Calculated A1C" value is calculated using the well-known formula from your 3-months average blood glucose:
("3-months-blood-glucose in mg/dl" + 86) / 33.3

Please note, though, that the calculated A1C value may be very different from the real A1C value.
The accuracy of the calculated A1C value, as well as the accuracy of the average blood glucose values, highly depends on your measurement habits.
10. Summary: key bindings and touchscreen handling
In the day screen of DIASYM:

Assignment of keys of a numeric keyboard:

0: Day mode / today
1: New entry
2: Measurement reminder
3: Manual save
9: Quit program

Assignment of keys of a QWERT keyboard:

Space: Day mode / today
N: New entry
E: Measurement reminder
S: Manual save
Q: Quit

Touchscreen:
Tap into the preview area (lower part of the screen): Enable touchscreen buttons
Tap into the diagram area (upper part of the screen): Disable touchscreen buttons
Tap into the area of the red dot (upper right corner): Manual save


In the home screen of DIASYM:

See above.
11. Appendix
11.1. Technical information
Information given in this section is not needed for normal usage of DIASYM.
For experienced users, the info may be valuable to better understand how the software works, to resolve problems on your own or to make even better use of the software.
11.1.1. Storage location of the diary file and CSV files
The storage location for the diary file and files generated by the CSV export function of DIASYM is chosen that way, that from the file manager of your phone's PC softare suite the files are accessible.
You can look up the exact location by using the "Diary info" function from the menu.
11.1.2. The settings files diasym.config and diasym.properties
DIASYM uses two files to permanently store its settings.
The file diasym.config contains configuration settings which can be changed in the DIASYM configuration dialog. When you reconfigure DIASYM, this file is deleted and recreated with the new settings.

Settings which should be preserved on reconfiguring are stored in the file diasym.properties.
These are for example the time of the last CSV export, your license information and the 26 user event labels.

The settings files reside in the same directory as the diary file of DIASYM.
You can find out which directory this is if you choose "Diary info" from the menu.
11.1.2.1. Definition of the user events
For configuration of the user events there is no geaphical dialog yet (stauts of version 1.0 of DIASYM). For future versions such a dialog is planned.

If you like to change the labels of user events, you may do that now by manually editing the diasym.properties file with a text editor, either directly on the phone, or on the PC after copying the file over to your PC.
DIASYM must be completely terminated when doing this. Otherwise your chagnes may get overwritten again.
11.1.2.2. Additional ways for customization
11.1.2.2.1. ForceEvents = 1
Use this if you enter events for most or all of your data records.

If you set ForceEvents=1 in diasym.properties file, everytime the main input dialog is displayed, also the event input dialog is displayed.

Normally the event dialog is only displayed if an existing entry is edited or when you generate a new entry but dont't enter anything into the main input dialog.
11.2. Troubleshooting
11.2.1. "Loading of database file unsuccessful" / Backups
DIASYM saves changes of the diary automatically into a file, when a certain timeout is reached after the last user interaction.
In very rare cases it can happen, that the saving process is interrupted (e.g. when the user switches off the cellphone during DIASYM is saving, or if the battery is empty etc.)
This leads to a corrupted diary file, and DIASYM cannot load the diary file on the next start ("Loading of database file unsuccessful").

DIASYM creates two backup copies of the diary file. One backup file is created directly before and one directly after saving.
The file which is created after successful saving of the main diary file (an exact copy of that file, the most recent backup) is named "diasym.bak1".
Before each save process DIASYM creates an additional backup copy named "diasym.bak2". This backup copy is only used when even "diasym.bak1" is corrupted.

The backup files are stored in the same directory on your cellphone as the diary file "diasym.dat".

When DIASYM detects that the diary file is corrupted, it automatically tries (after an appropriate warning and after user confirmation) to restore the diary from the backup files. First it tries to open "diasym.bak1". If this attempt fails, it tries to open "diasym.bak2".

11.2.2. Font sizes are too small or too large
DIASYM originally has been written with QVGA portrait screens in mind (UIQ3 devides).
However, with time DIASYM began to support other phones, and especially newer ones with Symbian S60 5th edition or Symbian^3 have higher screen resolutions.
Beginning with version 1.11 of DIASYM, font sizes of the date line and the preview pane are adjusted dynamically to the screen resolution in order to enhance the readability.

Since I cannot test DIASYM on each phone and configuration available on the market, it may be that this dynamic font size adjustment may fail for some configurations.

If you think font sizes are too small or too large on your phone, please do the following:
- Write an email to me describing the problem and how font sizes should be adjusted
- If possible, submit a screenshot of the problem
- You may try to adjust font sizes yourself by modifying the parameter MaxFontSize in the diasym.properties file. Its default value is 36 (pixels). The parameter limits the font size which is calculated by the dynamic adaption to a maximum value.
If the fonts on your phone are too large, let a lower value here, e.g. 30 or 24.
If the fonts on your high-resolution phone are too small, try a higher value, e.g. 40, 44 or 48.

Please note that this affects only the date line on top of the diagram and the preview pane below the diagram. It does not affect menu fonts, diagram axis fonts etc.

Please note that for adjusting the diasym.properties file, you need to quit DIASYM first and after editing the file restart DIASYM.
11.3. Supported phone models
This document lists the phone models which should be supported by DIASYM.
"Should" because DIASYM has not been tested on all of these phones.

Additionally, you can see in this list, which one of the different SIS versions is the right one for your phone:

DIASYM_vX.XX_S60_2nd.sis
DIASYM_vX.XX_S60_3rd.sis
DIASYM_vX.XX_S60_5th_and_Symbian-3.sis
DIASYM_vX.XX_UIQ2.sis
DIASYM_vX.XX_UIQ3.sis


Date of compilation of this list: 2010-12-23
Source of information: Wikipedia
This list may not be complete.


Symbian^3:

    * Nokia N8
    * Nokia E7
    * Nokia C6-01
    * Nokia C7
    * Nokia X7


S60_5th:

    * Nokia 5230/5235
    * Nokia 5530 XpressMusic
    * Nokia 5800 XpressMusic
    * Nokia N97
    * Nokia N97 mini
    * Nokia X6
    * Nokia C6-00
    * Samsung i8910 HD
    * Sony Ericsson Satio (Konzeptname: Idou)
    * Sony Ericsson Vivaz
    * Sony Ericsson Vivaz Pro


S60_3rd:

    * Nokia 3250
    * Nokia 5500
    * Nokia E50
    * Nokia E60
    * Nokia E61
    * Nokia E61i
    * Nokia E62
    * Nokia E65
    * Nokia E70
    * Nokia N71
    * Nokia N73
    * Nokia N75
    * Nokia N77
    * Nokia N80
    * Nokia N80 Internet Edition
    * Nokia N91
    * Nokia N92
    * Nokia N93
    * Nokia N93i
    * LG KS10 JoY
    * LG KT610
    * Nokia 5700 XpressMusic
    * Nokia 6110 Navigator
    * Nokia 6120 classic
    * Nokia 6121 classic
    * Nokia 6124 classic
    * Nokia 6290
    * Nokia E51
    * Nokia E63
    * Nokia E66
    * Nokia E71
    * Nokia E90 Communicator
    * Nokia N81
    * Nokia N81 8GB
    * Nokia N82
    * Nokia N76
    * Nokia N95
    * Nokia N95 8GB
    * Samsung SGH-G810
    * Samsung SGH-i520
    * Samsung SGH-i450
    * Samsung SGH-i550
    * Samsung SGH-i560
    * LG KT770
    * Nokia 5320 XpressMusic
    * Nokia 5630 XpressMusic
    * Nokia 5730 XpressMusic
    * Nokia 6220 classic
    * Nokia 6210 Navigator
    * Nokia 6650 (nur bei T-Mobile)
    * Nokia 6700 slide
    * Nokia 6720 classic
    * Nokia 6730 classic (nur bei vodafone)
    * Nokia 6710 Navigator
    * Nokia 6760 slide
    * Nokia C5-00
    * Nokia E52
    * Nokia E55
    * Nokia E71x
    * Nokia E72
    * Nokia E75
    * Nokia N78
    * Nokia N79
    * Nokia N85
    * Nokia N86 8MP
    * Nokia N96
    * Samsung i7110
    * Samsung i8510 Innov8


S60_2nd:

    * Nokia 6600
    * Panasonic X700
    * Panasonic X800
    * Samsung SGH-D710
    * Samsung SGH-D720
    * Samsung SGH-D730
    * Nokia 3230
    * Nokia 6260
    * Nokia 6620
    * Nokia 6670
    * Nokia 7610
    * Nokia 6630
    * Nokia 6680
    * Nokia 6681
    * Nokia 6682
    * Lenovo P930
    * Nokia N70
    * Nokia N72
    * Nokia N90
    * Samsung SGH-Z600



UIQ3:

    * Sony Ericsson P1/Sony Ericsson P1i/P1c (UIQ 3.0)
    * Sony Ericsson M600/Sony Ericsson M600i/M608c (UIQ 3.0)
    * Sony Ericsson P990/Sony Ericsson P990i/P990c (UIQ 3.0)
    * Sony Ericsson W950/Sony Ericsson W950i/W958c (UIQ 3.0)
    * Sony Ericsson W960/Sony Ericsson W960i/W960c (UIQ 3.0)
    * Sony Ericsson G700 (UIQ 3.0)
    * Sony Ericsson G900 (UIQ 3.0)
    * Motorola RIZR Z8/Motorola Nahpohos Z8 (UIQ 3.1)
    * Motorola RIZR Z10 (UIQ 3.2)


UIQ2:

    * Sony Ericsson P800 (UIQ 2.0)
    * Sony Ericsson P900 (UIQ 2.1)
    * Sony Ericsson P910 (UIQ 2.1)
    * Motorola A920 (UIQ 2.0)
    * Motorola A925 (UIQ 2.0)
    * Motorola A1000 (UIQ 2.1)
    * Motorola M1000 (UIQ 2.1)
    * Benq P30 (UIQ 2.0)
    * Benq P31 (UIQ 2.1)
    * Nokia 6708 (UIQ 2.1)
    * Arima U300 (UIQ 2.0)
    * Arima U308 (UIQ 2.1)

12. Support
In case you have questions about or problems with DIASYM, or if you should find programming errors in the program, please contact the author directly, either in English or in German.

hermocom
Dipl.-Ing. Daniel Hertrich
Achstraße 21
85077 Manching
Germany

Email: info@hermocom.com
http://www.hermocom.com
Skype: hermocom