.. contents:: Contents .. section-numbering:: ======================================= File Formats for various sync devices ======================================= Various ``SyncML`` capable devices exchange data (adress, calendar, todo, notes) in various data formats. This page is designed to collect as many examples from as many devices as possible to allow for an implementation that can deal with any of these. ----------------------- Synthesis ``SyncML`` client ----------------------- The Synthesis (www.synthesis.ch) client can be used to sync Palm and various Windows Mobile PDAs. Synthesis Tasks Example ======================= :: BEGIN:VCALENDAR VERSION:1.0 BEGIN:VTODO SUMMARY:Synthesis todo entry on pal, CATEGORIES:Tests CLASS:PUBLIC DESCRIPTION;ENCODING=QUOTED-PRINTABLE:Note line1=0D=0A= line2=0D=0A= DUE:20050929T000000 PRIORITY:1 STATUS:NEEDS ACTION END:VTODO END:VCALENDAR **Notes**: * Priority can be 1-5. * If a todo entry is marked as completed, its status becomes COMPLETED. * The client is quite picky about the version number: ensure it's VERSION:1.0. Synthesis Events Example ======================== :: BEGIN:VCALENDAR VERSION:1.0 BEGIN:VEVENT SUMMARY:test CLASS:PUBLIC DESCRIPTION;ENCODING=QUOTED-PRINTABLE:line1 aumlaut: ae=0D=0A= line2=0D=0A= DTSTART:20050923T130000 DTEND:20050923T140000 AALARM:20050923T080000;;; DALARM:20050923T080000;;; END:VEVENT END:VCALENDAR Synthesis Address Book Example ============================== :: BEGIN:VCARD VERSION:2.1 N;CHARSET=UTF-8:Last Name;First Name aumlaut: ä ;;; FN;CHARSET=UTF-8:Last Name, First Name aumlaut: ä TITLE:title ORG:company; CLASS:PUBLIC TEL;WORK:+4989111 TEL;HOME:+4989222 TEL;FAX:+4989333 EMAIL: ADR:;;Marienplatz 1;Munich;By;D-81777;Germany NOTE;ENCODING=QUOTED-PRINTABLE:line1=0D=0A= line2=0D=0A= END:VCARD ------------------ Motorola RAZR V3 ------------------ Motorola RAZR V3 Contact Example ================================ :: BEGIN:VCARD VERSION:2.1 N:lastname;firstname TEL;WORK:number TEL;CELL:number END:VCARD ------------ Nokia 6230 ------------ Nokia 6230 Notes example ======================== :: BEGIN:VNOTE VERSION:1.1 BODY:Nokia3nndies ist zusätzlicher Text! DCREATED:20051030T111735Z LAST-MODIFIED:20051030T112041Z END:VNOTE Nokia 6230 Calendar example =========================== :: BEGIN:VCALENDAR VERSION:1.0 BEGIN:VEVENT DTSTART:20051030T170000 DTEND:20051030T180000 CATEGORIES:MEETING SUMMARY:calendar entry DESCRIPTION;CHARSET=ISO-8859-1;ENCODING=QUOTED-PRINTABLE:description=0Aline= 2=0Aumlaut: =E4=0Alast line LOCATION:B END:VEVENT END:VCALENDAR Nokia 6230 Task Example ======================= (events and tasks are in the same database) :: BEGIN:VCALENDAR VERSION:1.0 BEGIN:VTODO DUE:20051113T090000 DTEND:20051113T090000 PRIORITY:2 STATUS:NEEDS ACTION SUMMARY:Task1 END:VTODO END:VCALENDAR -------------- Nokia 9300i -------------- Nokia 9300i Contact Example =========================== :: BEGIN:VCARD VERSION:2.1 REV:20060506T100811Z N:lastname;firstname;second firstname;title;addon name ADR;HOME:homepost-office-box;addonHome;homestreet;homecity;homestate;homepostcode;homecountry ADR;WORK:workpost-office-box;addon-work;workstreet;workcity;workstate;workpostcode;workcountry ADR;PREF:otherpost-office-box;;otherstreet;othercity;otherstate;otherpostcode;othercountry ORG:company; TITLE:position TEL;WORK;VOICE:+4900 TEL;HOME;VOICE:+4901 TEL;CELL:+4902 TEL;WORK;FAX:+4904 EMAIL;INTERNET:email1@example.org EMAIL;INTERNET:email2@example.org NOTE:memo NOTE:memo2 TEL;PAGER:+4903 URL:www1.example.org URL:www2.example.org BDAY:20060508 END:VCARD ------------ Nokia 9500 ------------ Nokia 9500 Contact Example ========================== :: BEGIN:VCARD VERSION:2.1 REV:20060301T021807Z N:Lastname;Firstname;Middlename;Title;Suffix ADR;HOME:PostBox;;Street;City;State;Postcode;RegionCountry ADR;WORK:PotsBox;;Street;City;State;Postcode;RegionCountry ORG:Company; TITLE:Job TEL;VOICE:0000000000 TEL;CELL:0000000000 TEL;FAX:0000000000000 EMAIL;INTERNET:test@example.com EMAIL;INTERNET:test2@example.com TEL;WORK;VOICE:0000000000000 BDAY:20060228 END:VCARD Nokia 9500 Todo Example ======================== :: BEGIN:VCALENDAR VERSION:1.0 BEGIN:VTODO UID:170 SUMMARY:Send email to mates X-EPOCTODOLIST:To-do list STATUS:NEEDS ACTION X-EPOCAGENDAENTRYTYPE:TODO CLASS:PUBLIC DCREATED:20060301T000000 LAST-MODIFIED:20060302T050500Z PRIORITY:3 END:VTODO END:VCALENDAR Nokia 9500 Calendar Example =========================== :: BEGIN:VCALENDAR VERSION:1.0 BEGIN:VEVENT UID:171 SUMMARY:Happy Hour DTSTART:20060309T213000Z DTEND:20060310T010000Z X-EPOCAGENDAENTRYTYPE:APPOINTMENT CLASS:PUBLIC LOCATION:Deck DCREATED:20060301T000000 LAST-MODIFIED:20060302T050800Z PRIORITY:0 STATUS:NEEDS ACTION END:VEVENT END:VCALENDAR -------------------- Sony Ericsson P900 -------------------- Sony Ericsson Tasks Example =========================== :: VERSION:1.0 BEGIN:VTODO UID:396 SUMMARY:A1 X-EPOCTODOLIST:To-do list STATUS:NEEDS ACTION X-EPOCAGENDAENTRYTYPE:TODO CLASS:PUBLIC DCREATED:20050422T220000Z LAST-MODIFIED:20050423T195500Z CATEGORIES:X-65536 PRIORITY:1 END:VTODO END:VCALENDAR Sony Ericsson Daylight.ini file configuration example (phone location C:\system\data) for Russian Federation (2001-2024) ======================================================================================================================== :: BEGIN:VCALENDAR DAYLIGHT:TRUE;01:00;20010325T020000;20011028T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20020331T020000;20021027T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20030330T020000;20031026T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20040328T020000;20041031T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20050327T020000;20051030T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20060326T020000;20061029T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20070325T020000;20071028T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20080330T020000;20081026T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20090329T020000;20091025T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20100328T020000;20101031T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20110327T020000;20111030T030000;03:00;04:00 DAYLIGHT:TRUE;01:00;20120302T000000;20130302T000000;04:00;04:00 DAYLIGHT:TRUE;01:00;20130302T000000;20140302T000000;04:00;04:00 DAYLIGHT:TRUE;00:00;20140302T000000;20140302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20150302T000000;20150302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20160302T000000;20160302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20170302T000000;20170302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20180302T000000;20180302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20190302T000000;20190302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20200302T000000;20200302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20210302T000000;20210302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20220302T000000;20220302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20230302T000000;20230302T000000;03:00;03:00 DAYLIGHT:TRUE;00:00;20240302T000000;20240302T000000;03:00;03:00 END:VCALENDAR -------------------- Sony Ericsson P990 -------------------- P990 Contact Example ==================== :: BEGIN:VCARD VERSION:2.1 REV:20061004T182204Z UID:b2229084c1b63051-00e0fcb3600dd5a3-515 N:Contact;Test;;Ph.d.; ADR;HOME:;;Home street;Homeville;Homeprovince;1234;Homia ADR;WORK:;;Corp street;Jobtown;Working state;5678;Usania TEL;WORK;VOICE;CELL:11111111 TEL;WORK;VOICE:22222222 TEL;FAX:77777777 EMAIL;INTERNET;X-SYNCMLREF1:test@example.com URL:http://www.example.com TEL;HOME;VOICE:33333333 EMAIL;INTERNET;HOME;X-SYNCMLREF2:private@example.com ORG:Example Inc; TITLE:Cto BDAY:19571004 NOTE:Noteworthy for contact PHOTO;TYPE=JPEG;ENCODING=BASE64: /9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkS Ew8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDIBCQkJDAsM V7czRFBWzUckav1pp21FYxNFsTB1FbtMVFQcCnUN3dxpWIpoRL1psdsqKQe9T0lJ sCmbBN+4AUPYxuOlW80lK47H/9k= END:VCARD P990 Calendar example ===================== :: BEGIN:VCALENDAR VERSION:1.0 TZ:+0124 DAYLIGHT:TRUE;+02;20060326T010000Z;20061029T010000Z;; DAYLIGHT:TRUE;+02;20070325T010000Z;20071028T010000Z;; DAYLIGHT:TRUE;+02;20080330T010000Z;20081026T010000Z;; DAYLIGHT:TRUE;+02;20090329T010000Z;20091025T010000Z;; DAYLIGHT:TRUE;+02;20100328T010000Z;20101031T010000Z;; BEGIN:VEVENT UID:20061004T174515Z-619750-H2_Board SUMMARY:Test appointment DESCRIPTION:Notes for test DTSTART:20061005T080000Z DTEND:20061005T090000Z X-EPOCAGENDAENTRYTYPE:APPOINTMENT CLASS:PUBLIC LOCATION:Ortopedisk poliklinikk SEQUENCE:-1 X-METHOD:NONE ATTENDEE;ROLE=ORGANIZER;STATUS=NEEDS ACTION;RSVP=NO;EXPECT=FYI;X-PHONEOWNER:havardw (a) wigtil.net ATTENDEE;ROLE=ATTENDEE;STATUS=NEEDS ACTION;RSVP=YES;EXPECT=FYI;X-ROLE=REQ-PARTICIPANT;X-STATUS=NEEDS-ACTION:test@example.com RRULE:MP1 1+ TH 21001231T000000 AALARM;TYPE=X-EPOCSOUND:20061005T075000Z;;0;0x100048ac0x00000205 LAST-MODIFIED:20061004T174546Z CATEGORIES:X-Test PRIORITY:0 STATUS:CONFIRMED X-SYMBIAN-LUID:13 END:VEVENT END:VCALENDAR P990 Task example ================= :: BEGIN:VCALENDAR VERSION:1.0 BEGIN:VTODO UID:20061004174658601750 SUMMARY:Test task DESCRIPTION:Notes for task DTSTART:20061005T215959 DUE:20061006T235959 X-EPOCTODOLIST:TODO STATUS:NEEDS ACTION X-EPOCAGENDAENTRYTYPE:TODO CLASS:PUBLIC SEQUENCE:-1 X-METHOD:NONE AALARM;TYPE=X-EPOCSOUND:20061004T204700;;0;0x100048ac0x00000205 LAST-MODIFIED:20061004T174658Z CATEGORIES:X-Test PRIORITY:3 X-SYMBIAN-LUID:14 END:VTODO END:VCALENDAR P990 Notes example ================== :: BEGIN:VNOTE VERSION:1.1 DCREATED:20060927T202756Z LAST-MODIFIED:20061004T180306Z BODY;ENCODING=QUOTED-PRINTABLE;CHARSET=UTF-8:= Teolog=0D=0ADager=20og=20blir=20ute=20til=20i=20kassa=20tar=20v=C3=A5r=20= teolog=20dager=20og=20=20 END:VNOTE --------------------- Sony Ericsson W800i --------------------- Sony Ericsson W800i Calendar Example ==================================== :: BEGIN:VCALENDAR VERSION:1.0 BEGIN:VEVENT DTSTART;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:20061003T180000Z DTEND;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:20061003T190000Z SUMMARY;CHARSET=UTF-8:Test LOCATION;CHARSET=UTF-8:Test LAST-MODIFIED;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:20061003T173042Z X-SONYERICSSON-DST:0 X-IRMC-LUID:000000010003 END:VEVENT END:VCALENDAR Sony Ericsson W800i Contact Example =================================== :: BEGIN:VCARD VERSION:2.1 N;CHARSET=UTF-8:Test;Abe TITLE;CHARSET=UTF-8:none ORG;CHARSET=UTF-8:Example TEL;HOME:8888888 TEL;WORK:7777777 TEL;CELL:9999999 TEL;FAX:6666666 TEL:5555555 EMAIL;INTERNET;PREF;CHARSET=UTF-8:mail@example.com URL;CHARSET=UTF-8:www.example.com ADR;HOME;CHARSET=UTF-8:;;Test 99;Aab;Caba;99;Caba NOTE;CHARSET=UTF-8:Friend BDAY:20060930 X-IRMC-LUID:000200000053 END:VCARD HTC Desire HD Example (Android 2.3) with Funambol Client v10.0.2 ================================================================= :: BEGIN:VCARD VERSION:2.1 N:Tnachname;Testname;;; NICKNAME:Nick ADR;HOME:Pfach;Nachb;Proad;Port;Pland;055553;Land ADR:Zg;Dg;Aroad;Aort;Aland;555533;Ggj BDAY:1900-00-14 TEL;VOICE;HOME:00421 TEL;PREF;VOICE:88992 TEL;FAX:6666 TEL;VOICE:0815 TEL;CELL:0177 TEL;FAX;HOME:004213 TEL;PAGER:555 EMAIL;INTERNET;HOME;X-FUNAMBOL-INSTANTMESSENGER:im0 EMAIL;INTERNET;HOME:mp@de.de EMAIL;INTERNET:ms@de.de URL:google.de URL;HOME:http://www.bellosbude.de X-ANNIVERSARY:2011-06-16 ADR;WORK:Gg;Tt;Broad;Bort;Bland;523531;Zz TITLE:Technik ORG:Rwe;Zlt TEL;WORK;PREF:1974 TEL;VOICE;WORK:02222 TEL;FAX;WORK:022223 EMAIL;INTERNET;WORK:ma@de.de URL;WORK:rrr.de NOTE:Notiz PHOTO;ENCODING=BASE64;TYPE=image/png: iVBORw0KGgoAAAANSUhEUgAAAGAAAABgCAYAAADimHc4AAAABHNCSVQICAgIfAhkiAAAIABJREF ... and so on X-FUNAMBOL-CHILDREN: X-SPOUSE: UID: TZ: REV: GEO: END:VCARD ----------------------------------- Getting your device's file format ----------------------------------- If you have been asked for the format that your device sends data in, you need to perform a sync of the kind of data in question. To get a dump of the device data, create an address entry (or an event, or ...) with all features (as many device fields filled in as possible). Then do a sync. Within /tmp/sync then do: :: for a in *.wbxml; do wbxml2xml -m 1 -i 4 -o `basename $a .wbxml`_conv.xml $a; done 2>/dev/null You need libwbxml (http://libwbxml.aymerick.com/) installed. Then you get _conv.xml data with the readable XML in it. Locate the "BEGIN:VCARD" or "BEGIN:VEVENT" part in the *client*_conv.xml files; then you can add the data to this collection.