C-Diary is compatible to SINOVO SiDiary (http://www.sinovo.net), a platform independent application for gathering and evaluating diabetes data (diary and long-term), running on Windows PCs, Windows Mobile and Java, as well as online as a web application.
C-Diary can be used as a stand-alone diabetes diary on the cellphone, but it can also be used as an "input module" for SiDiary. There are several ways to transfer C-Diary data to SiDiary.
Forthermore it is possible to export the diary data from C-Diary 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 C-Diary 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 C-Diary license below carefully before installing and using C-Diary:
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 "C-Diary".
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 "C-Diary" software may not be rented or leased. All rights not expressly granted here are reserved by the author of this software. Installing and using "C-Diary" signifies acceptance of the terms and conditions of this license. If you do not agree with the terms of this license you must remove "C-Diary" 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 C-Diary version / updates
C-Diary is downloadable for no fee from the Internet and can be tested in its unregistered mode immediately.
You can find the latest version of C-Diary here: http://www.hermocom.com/downloads/diabetes/C-Diary/
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 C-Diary as a ZIP archive file.
This ZIP file contains several variants of C-Diary 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 C-Diary 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 C-Diary is installed on that memory and if it is running during that process, C-Diary may hang, crash and maybe you will lose diary data.
Attention:
In case you are unable to install C-Diary 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 C-Diary to the latest version, it is sufficient to download the new version from http://www.hermocom.com/products/symbian/c-diary 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 C-Diary" 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 C-Diary
If you are running an older version after the update, or if there are two C-Diary entries, uninstall C-Diary 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 C-Diary
After successful installation, you find the C-Diary icon in the application menu of your cellphone. Using this icon, you can start C-Diary.
Generally C-Diary does not need to be quit manually by you. The operating system of your cellphone terminates C-Diary automatically, if C-Diary is currently not active and if the operating system needs more ressources.
In special cases it may make sense to quit C-Diary manually, e.g. if you plan to install an update of C-Diary, 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 C-Diary reminders from the calendar (this is decribed later on).
7. Konfiguration
When you first launch C-Diary, 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 C-Diary.
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. C-Diary 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, C-Diary cannot save the diary anymore.
If you change the data storage location in the configuration dialog later, C-Diary offers to move the data from the old storage location to the new one.
C-Diary uses a database file with a fixed name in a fixed directory in the chosen storage location. It is not possible to have C-Diary 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 ranges:
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"), C-Diary asks for the severity of your hypo (hard or slight).Dependent on your answer, C-Diary 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"), C-Diary 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:
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 C-Diary 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/c-diary
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 C-Diary
When prigramming C-Diary 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 C-Diary further, please drop me a line. Contact data is printed at the end of this manual.
9.1. The diary
The diary of C-Diary is, technically spoken, a file saved on your phone, containing all entered diary data in coded form.
C-Diary 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, no diary entry marked) shows day statistics
- The entry mode (orange, 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.1.1. New entry
You can add a new entry to the diary by pressing the "1" key on your phone.
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 C-Diary. 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, C-Diary 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.26): 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.1.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), C-Diary'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.
This is how the touchscreen button overlay looks like in the detail view area (left: entry mode, right: day mode).
9.1.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.1.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.
C-Diary doen't offer any such analysis features at this time. But in SINOVO SiDiary 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 C-Diary mostly fit those predefined in SINOVO SiDiary.
In the C-Diary installation archive (C-Diary_vX.XX.zip) there is the file "C-Diary_Events.pdf". This is a table listing all events which are available in C-Diary.
There is also visualized, which ones of these events are also predefined in SiDiary and hence on data import from C-Diary initally are "understood" by SiDiary, and which of those events are C-Diary-specific.
In the C-Diary_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 "cdiary.properties" manually.
If you transfer C-Diary data to SiDiary (using AirSync or CSV Export), events are transfered using their abbreviations.
The abbreviations of the C-Diary events, which are also predefined in SiDiary, are initially "understood" by SiDiary. If you use events in C-Diary, which are not predefined in SiDiary (see C-Diary_Events.pdf), you may need to defined those events in SiDiary 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 C-Diary this event will probably be removed. Please always let it activated.
9.1.4. Delete an entry
An entry is deleted by marking the entry and choosing "Delete" from the menu.
9.1.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.1.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 blue instead of black.
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 yellow instead of black.
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.1.7. Saving of the diary
Normally you don't need to care about saving at all. C-Diary handles that automatically.
In the upper right corner of the C-Diary screen you find a small red or green dot. If this dot is red, it means that there are unsaved changes to the diary. C-Diary 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 changes its color to green.
In practice the dot color means:
Should you, while the dot is red, 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.2. Reminders
You can let C-Diary 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.2.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.2.2. Food reminders
If you create a new entry at the current time and enter an injection-food delay, C-Diary 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.2.3. Deletion of reminders from the calendar of your phone
C-Diary 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 C-Diary by using the menu item "Quit" or by hitting the "9" key or the "Q" key.
9.3. CSV export / data tranfer to SINOVO SiDiary using a file
Using the menu item "CSV export" you can export the diary in CSV format.
That means, C-Diary will generate a file containing the diary data in a format which is human-readable, but which is especially readable by e.g. spreadsheet applications such as Microsoft Excel or database applications, but also of course by SINOVO SiDiary.
On the first CSV export the complete C-Diary 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 C-Diary only as entry module for SiDiary or another application, you can delete the entire diary after export. This ensures that you always get the maximum performance of C-Diary. The more data the C-Diary diary contains, the slower will C-Diary be. This is only noticeable when there are several hundered entries, though. Several thousand entries may make C-Diary slow enough to be annoying.
After successful export C-Diary asks, if you want to send the generated CSV file to a PC, e.g. for import into SiDiary or another application. If you reply with "Yes", C-Diary 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 C-Diary 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.3.1. Import of a CSV file into SiDiary
In SiDiary version 6 choose menu "File" / "Import data".
In the following dialog choose the import driver for "SINOVO ASCII/CSV-Import".
Afterwards in the file chooser dialog choose the CSV file which you have just exported / transfered with C-Diary.
9.4. SiDiary AirSync
If your phone is configured for an Internet connection, you can use the SiDiary AirSync feature.
With AirSync, C-Diary sends your diary data over the Internet into your SiDiary Online (SDO) account where the data is automatically imported. this is very convenient. All you have to do is enter your SiDiary Online login data once.
Additionally (and this is possible even without a SiDiary Online account), the SiDiary Online server optionally generates an Email with a file attachment. This file contains the data sent by C-Diary in a format which you can import with SiDiary (PC version) using the Java Mobile import filter. That way, AirSync is a convenient alternative for the CSV export / import data transfer method described above.
If you start the C-Diary AirSync using the according menu item, you are asked to enter Email and password of your SiDiary Online account. Here you have the following options:
If you have a SiDiary Online (SDO) account:
Enter the SDO login data (Email and password) into the dialog. After sending the data from C-Diary, SDO will import the data automatically.
If you only enter your SDO email, but not your password (the password field must be left completely empty for this to work), the data sent by C-Diary will be received and saved by the SDO server but not imported yet.
If you login to your SDO account next time, you will be asked to explicitly confirm import of the data. This is for your safety. This method prevents that anyone can send random data into your SDO account.
If you enter your SDO email and (by accident) a wrong password, you get an error message after the transmission of the data. In that case, your data will not be saved by SDO, nor an email will be sent. Your data will be dismissed in that case. If this happens, try again with the correct password.
If you have an SDO account but enter another email address than the one registered at SDO, your data will not be applied to your SDO account (the SDO server then doesn't know that it is you who sends the data, even if you enter the password belonging to your SDO account). If you entered a password, you will get an error message and your data will be dismissed.
However, if you enter an email address (not your SDO address) only and leave the password field empty, the SDO server will send an email with your data to the email address you entered. The data will not be saved or imported by SDO, though.
If you don't have an SDO account:
Enter your email address into the email field and leave the password field empty.
The C-Diary data will be sent to SDO, but there they won't be assigned to any SDO account, but the server will only send an email to the address you entered, with a file attachment which you can import into SiDiary (PC version) using the Java Mobile import filter.
If you don't leave the password field empty, you will get an error message and your data will be dismissed by the SDO server.
You C-Diary data will always sent to the SDO server over an SSL-encrypted Internet connection in order to preserve your privacy.
But please note that the email which may be sent by SiDiary Online contains your data in unencrypted form.
So, if you don't want your C-Diary diabetes data to be transfered over the Internet in unencrypted form, make sure that you disable the according email notification options in SiDiary Online and that you enter your SiDiary Online account data correctly into C-Diary.
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
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
11. Appendix
11.1. Technical information
Information given in this section is not needed for normal usage of C-Diary.
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 C-Diary 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 cdiary.config and cdiary.properties
C-Diary uses two files to permanently store its settings.
The file cdiary.config contains configuration settings which can be changed in the C-Diary configuration dialog. When you reconfigure C-Diary, this file is deleted and recreated with the new settings.
Settings which should be preserved on reconfiguring are stored in the file cdiary.properties.
These are for example the login data for SiDiary Online, the time of the last CSV export and AirSync, your license information and the 26 user event labels.
The settings files usually reside in the same directory as the executable file of C-Diary. Depending on your phone's system, platform security may prevent you from having access to that directory using "normal" ways.
The settings files reside in the same directory as the diary file of C-Diary.
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 C-Diary). 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 cdiary.properties file with a text editor, either directly on the phone, or on the PC after copying the file over to your PC.
C-Diary 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 cdiary.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. AirSync: "ErrNotReady: Device is not ready"
When trying to perform a SiDiary AirSync, you may get the error message
"Synchronization failed. ErrNotReady: Device is not ready".
Reason:
This error is displayed when the network connection cannot be established.
Solution:
Make sure that you have good signal perception (not only for speech, but especially for data services. Most phones visualize this using a special symbol.)
11.2.2. "Loading of database file unsuccessful" / Backups
C-Diary 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 C-Diary is saving, or if the battery is empty etc.)
This leads to a corrupted diary file, and C-Diary cannot load the diary file on the next start ("Loading of database file unsuccessful").
C-Diary 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 "c_diary.bak1".
Before each save process C-Diary creates an additional backup copy named "c_diary.bak2". This backup copy is only used when even "c_diary.bak1" is corrupted.
The backup files are stored in the same directory on your cellphone as the diary file "c_diary.dat".
When C-Diary 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 "c_diary.bak1". If this attempt fails, it tries to open "c_diary.bak2".
11.2.3. Font sizes are too small or too large
C-Diary originally has been written with QVGA portrait screens in mind (UIQ3 devides).
However, with time C-Diary 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.24 of C-Diary, 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 C-Diary 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 cdiary.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 cdiary.properties file, you need to quit C-Diary first and after editing the file restart C-Diary.
11.3. Supported phone models
This document lists the phone models which should be supported by C-Diary.
"Should" because C-Diary 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:
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 C-Diary, 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