background image

The information contained here are property of DIGITAX Automotive Electronics Italy, and extremely con

 dential. Any disclosure, copying, distribution to third 

party is strictly prohibited.

68

Digitax SDK

ComTax2 .NET SDK libraries

Digitax devices communicate each other with a protocol named ComTax2, to make much more faster the development 

on Digitax devices has been developed a complete set of high level libraries that allow you to simply interact with the 

hardware. Those dlls are developed on .NET Compact Framework 2.0. 

To a complete guide about Digitax ComTax2 SDK see the 

 le: ComTax2SDK.chm

Digitax ComTax2 SDK is made of a set of this dlls:

• 

Digitax.Protocols.dll

• 

Digitax.Protocols.SerialProtocols.dll

• 

Digitax.Protocols.ComTax2.dll

• 

Digitax.Protocols.Aitp.dll

• 

Digitax.Protocols.Taximeter.dll

• 

Digitax.Protocols.Display.dll

This SDK is valid for any windows CE  Digitax device running CE 5.0 or later.

Digitax.Protocols.SerialProtocol.dll

It is the implementa  on on the serial port of several protocols, like the ComTax2 protocol

Digitax.Protocols.ComTax2.dll

Digitax.Protocols.ComTax2.dll library provides a .NET interface for the Digitax ComTax2 protocol; it allows to 

communicate with every Digitax ComTax2-enabled device like Taximeters, AITP, or smart standalone displays. It 

contains methods and events to send and receive ComTax2 binary messages and to manage the serial port. It doesn’t 

contain any speci

 c message de

 ni  on so message decoding/encoding  should be implemented by the developer.  

Mul  ple ComTax2 Protocols (or its deriva  on like aitp and Taximeters) can run on the same serial port.

Digitax.Protocols.Aitp.dll

Digitax.Protocols.Aitp.dll library provides a .NET interface to interact with the AITP hardware. Derived from Digitax.

Protocols.ComTax2.dll contains all Aitp Messages de

 ni  on. With this library the developer can control several 

ForceOne/ForceOne/MDT/MCU speci

 c features such as:

• 

light dimmer;

• 

hardware watchdog;

• 

odometer;

• 

hardware keys;

• 

analog inputs (MDT and MCU only);

• 

digital inputs/outputs (AITP-managed);

• 

power status;

• 

alarm and stealth mode;

• 

temperature and fans (MDT and MCU only);

• 

magne  c card reader;

• 

Windows status;

• 

other hardware informa  on (like hardware ID);

It is an asynchronous library so you have to send a command and you’ll have an event for the answer, on MDT/MCU 

Aitp is on “COM4:” at 19200 baud, on ForceOne /ForceOne Aitp is on “COM3:” at 38400 baud.

Summary of Contents for M1 mdt

Page 1: ...Technical Manual InstallationandProgramming ver 1 16 12 2014...

Page 2: ......

Page 3: ...5 For Hire Hired Stopped 16 The Operative Mode 16 Pre Selection of the Tariff 17 The K Constant 18 Car Transmission Ratio 18 Time Synchro 19 Time and Date setting 20 How to set the taximeter s time an...

Page 4: ...is conceived to be user friendly more graphical and easy to understand In the rst sec on are described the electrical connec ons the ways to x and lead the taximeter how to assemble the sensor box The...

Page 5: ...e copying distribution to third party is strictly prohibited 5 Main Connectors Panel Appearance Main Connectors Panel 1 Microphone 2 Command Taximeter Keys 3 Cover Wires 4 Label 5 SIM Card 6 Wires Con...

Page 6: ...on dential Any disclosure copying distribution to third party is strictly prohibited 6 How to Seal the Taximeter Regular Way of Sealing the Taximeter 2 1 3 4 5 6 4 Taximeter s Seals 1 Tari Programming...

Page 7: ...Automotive Electronics Italy and extremely con dential Any disclosure copying distribution to third party is strictly prohibited 7 Top Front Dimensions in millimeters Width 289 Height 88 3 Depth 28 We...

Page 8: ...Inscrip ons 6 Metrological Inscrip ons Plate Fare Display Day Night Indica on Status For Hire Hired Stopped Movement detec on status when it s blinking Secondary Display Tari Index Descrip on extras m...

Page 9: ...ution to third party is strictly prohibited 9 M1 mdt MID Taximeter Display Area Func onal area for Developer s Applica ons MID Taximeter Area This area is used only by the taximeter Developer s Functi...

Page 10: ...10 Electrical Connec on Table MECHANICAL TRANSDUCER or CAR ODOMETER INPUT PRINTER GREY VIOLET GREEN YELLOW Passenger Sensor PINK RED RED BLACK fuse 2 A fuse 2 A fuse 2 A fuse 2 A fuse 2 A fuse 2 A CAR...

Page 11: ...to 6553 50 CU km Resolu on of distance tari 0 10 CU km Odometer Transducer Input input range 0 to 32 V level for LOW voltage 0 0 3 V level for HIGH input 5 Vcc maximum frequency 1 KHz high voltage tri...

Page 12: ...the sheathing in the clamps and ght the 4 screws B 4 Loosen the 4 screws A and insert the internal wire Do not ght the 4 screws A A en on when you insert the internal wire the dummy sha must come out...

Page 13: ...plug must not be connected as it can damage the device NOTE In order to use with property the test connector func onality blue wire must be connected to a power ba ery suply with almost 12v Once the...

Page 14: ...ress K3 The following pictures are only an example of E Seal records because every single device could have a di erent records sequence MAIN DISPLAY PRINTED REPORT DESCRIPTION EVENTS K C ons K CONS Co...

Page 15: ...e second sec on Press K4 to go to the next event press K3 to go to the previous event Press OP to exit It can be displayed in the following format Exit to the main men K CONS 0 A DEFL 0 TARIFF 0 SYN C...

Page 16: ...he le digit of the secondary display 5 Insert the Extra n 1 if enabled Insert the Extra n 2 if enabled Reset the added Extras FOR HIRE STOPPED HIRED and the rela ve bu ons func ons It s the posi on se...

Page 17: ...so to start the trip directly with the pre selected tari Tari pre selec on is ac vated by changing the following setup ques ons Q32 yes Q2 0 Q3 number of tari s When Pre Selec on is enabled pressing...

Page 18: ...Autotest Press K2 bu on to increase the pulses km number Press K1 bu on to decrease the pulses km number By pressing K1 K2 at the same me the programmed K Constant becomes 1000 Press K4 to save the p...

Page 19: ...e every seven days between the 11 58 and 12 02 The Time Synchro works only if the manual me se ng is disabled Q269 Yes It is enabled only a er 7 days from the last me synchro or clock set When the tax...

Page 20: ...number and in right digits the minutes numbers in its format To set the Day number press K1 bu on only increasing way To set the Month number press K2 bu on only increasing way To set the Hour press K...

Page 21: ...16 Check Sum will be di erent from that stored for comparison b At each Trip the Taximeter recalculate the Checksum of the Tari and compares with the stored CS reference and in case of data corrup on...

Page 22: ...and Block 2 P S From loca on n 1 by pressing K1 the taximeter will go back to For Hire posi on The same will happen from loca on n 45 by pressing K2 bu on Press OP bu on to end the reading procedure a...

Page 23: ...number Press K4 bu on to print out the Over Speed events Press OP bu on to end the prin ng procedure and go back to For Hire posi on Memory Data Memory Block Memory Loca on Number Loc Block Memory Co...

Page 24: ...loca on n 30 and press K4 bu on to erase all informa on contained in both Blocks 1 and 2 If you want to erase and print select posi on 20 instead of 30 block 1 and block 2 informa on will be printed...

Page 25: ...ry Block Memory Block Memory Loca on Number Memory Loca on Number Trip by Trip Memory Loca on Trip by Trip Memory Loca on Select For Hire posi on Be sure printer is connected and Powered ON Press K1 a...

Page 26: ...s DRIVER Driver ID number KT Kilometers between 2 trips so in For Hire KB Kilometers in FOR HIRE posi on with passenger onboard detected for IR passenger detector KS Kilometers in HIRED posi on with p...

Page 27: ...cter 32 is equivalent to a blank space Press K4 bu on to forward of one space Press K3 bu on to backward of one space By pressing OP bu on the main display 3 will show PRGCAR This procedure will set t...

Page 28: ...Param 429 Working Block Param 001 Param 429 Working Block Param 001 P 340 Param 429 Block 0 Param 001 Param 429 Easy Tari Amount Power On Power On Power On Final Tari Amount Complex Tari Amount Modi...

Page 29: ...he Block 0 the taximeter behavior is as follow Starts up Block 0 loads its content of 429 parameters value in the Working Block Pressing OP it passes from For Hire to Hired state The programmed parame...

Page 30: ...t system And the values showed for prices will be of course in the local currency These 7 values are shown in the following parameters in order of appearance for each pro grammed Block the procedure i...

Page 31: ...ll go to the next pa rameter index in the same order as speci ed before for each programmed block up to 6 When the last parameter index of the last block t6 is shown by pressing K4 again the Tari Show...

Page 32: ...te 1 Holiday Time ProgDate 2 ac ons iden ed by Ques on 63 to Ques on 73 of the meter programming ProgDate 3 ac ons iden ed by Ques on 74 to Ques on 84 of the meter programming ProgDate 4 ac ons iden e...

Page 33: ...ce All these 5 types of Service Programming Keys are inserted in the same connector that is mechanical sealed as shown in the picture below and as explained in page 5 of this technical manual So to in...

Page 34: ...rd and higher units of the fare If the third and higher unit distance is the same as the second unit distance then the third and higher unit distance does not need to be given Automa cally the second...

Page 35: ...owed value goes from 0 min to 255 max The value 0 is a special case It means disabled 0 255 20 Distance in Stopped for automa c return to Hired this is the distance to run in Stopped posi on that will...

Page 36: ...cy of 0 1 The allowed value goes from 0 min to 6553 5 max 0 65535 percentage cost 43 Increase unit cost in night me Should the unit cost Q 8 to Q 10 in night me be increased based on the percentage Q...

Page 37: ...a xed cost pressing K1 No Yes 73 Insert as percentage in Prog Date 3 with K1 Passing from HIRED to STOPPED in Prog Date 3 should the parameter of Q 65 be inserted as a percentage pressing K1 No Yes PR...

Page 38: ...553 5 max 0 65535 percentage cost 99 Increase unit cost in Prog Date 6 Should the unit cost Q 8 to Q 10 in Prog Date 6 be increased based on the percentage Q 98 No Yes 100 Increase ini al cost in Prog...

Page 39: ...the parameter of Q 120 be inserted as a percentage No Yes 127 Insert as xed cost in Prog Date 8 with K1 Passing from HIRED to STOPPED in Prog Date 8 should the parameter of Q 120 be inserted as a xed...

Page 40: ...r block number is used again 0 62 141 Block o set at event n 1 This is the block o set rela ve to be used when the event occured that has been programmed in Q 139 The rela ve block o set is the number...

Page 41: ...ammed in Q 161 for event counter 3 the distance in metres No Yes 166 Load value is Wai ng Time in seconds Is the parameter programmed in Q 161 for event counter 3 the wai ng me in seconds No Yes 167 L...

Page 42: ...s disabled No Yes 187 Start of Fare me is used for Night Holiday extras Should the me in which the fare starts be considered for the calcula on of the night and or holiday extras In case of Yes and if...

Page 43: ...amount of velocity with which the threshold of the speedometer gets decremented or incremented every me key K3 dec or key K4 inc is pressed The velocity step is given in Km h with an accuracy of 1 Km...

Page 44: ...light number 1 should be ON The allowed value goes from 0 min to 62 max 0 64 232 Prog Date number for light n 1 ON this is the number of the Prog Date where light number 1 should be ON The allowed val...

Page 45: ...es then light number 4 will go ON in case the actual velocity is higher than the velocity programmed in Q 200 The allowed answer is either 0 No OFF or 1 Yes ON No Yes 259 Light n 4 must go on below ov...

Page 46: ...nc ons except the clock are disac vated and also the display is put OFF The taximeter is woken up by either pressing the OP key or by the rst pulse from the transducer Also see Q 192 If the answer is...

Page 47: ...dit card The number of ckets is given in whole numbers The allowed value goes from 0 min to 65535 max 0 65535 300 Number of ckets with commercial credit card this is the number of ckets that should be...

Page 48: ...answer is either 0 No visualize or 1 Yes inhibit No Yes 320 Enable visualiza on MB1 with password If the visualiza on of memory block number 1 has been inhibited see Q 319 should it be possible to und...

Page 49: ...ket the 3 lines footer No Yes 337 On service messages use normal font No Yes from Q 338 to Q 339 available for any possible so ware extension FIXED COST FARE forfait 340 Enable appl of cost with num k...

Page 50: ...dispatcher Transmit the Hired status to the dispatcher The allowed answer is either 0 No don t transmit or 1 Yes transmit No Yes 375 Block taximeter if driver ID is 0 Should the taximeter be blocked...

Page 51: ...hat is the baudrate transmission speed of COM 1 The baudrate is given in baud with an accuracy of 1 baud The allowed value goes from 0 min to 65535 max 0 65535 baud 392 Maximum packet length for COM 1...

Page 52: ...o Hired this is the number of the block that will be used when passing from Stopped back to Hired The allowed value goes from 0 min to 62 max 0 62 409 Block number if from Stopped to ForHire this is t...

Page 53: ...V RED 10 Power Supply 8 32 V RED 2 Pass Sensor input ac ve low PINK 9 Taxi Light 4 Vcc max 1A YELLOW 3 Light input ac ve high BROWN 8 Taxi Light 3 Vcc max 1A GREEN 4 Ground BLACK 7 Taxi Light 2 Vcc m...

Page 54: ...te or deac vate it It is necessary to use a standard type A male to male usb cable to connect the PC to the ac vesync USB2 female connector of the M1 MDT WINDOWS RS232 USB 1 2 3 4 5 6 7 8 9 10 11 12 1...

Page 55: ...de of those ap plica ons is available as example for the developers Autorun As soon as Windows CE is started the Autorun exe program is launched It is a system applica on that take care of many tasks...

Page 56: ...are and so ware version of the AITP It also shows the Hardware ID of the device that is a guaranteed unique ID of the device board It can be read from the AITP using the AITP libraries EESetup AITP co...

Page 57: ...c brightness of the display according to customer preferences This is an AITP setup When the Manual Dimmer Mode is used the brightness can be regulated from this panel or from the user applica on call...

Page 58: ...engine or by the user applica on sending the AITP shutdown or restart with the AITP DLL Stealth Mode Stealth Mode is a special opera on mode that leaves the device fully running but with the display a...

Page 59: ...the engine is OFF it can decide to shutdown following its own logic and hav ing all the me to perform a proper logout and disconnec on sequence before issuing the shutdown command to the AITP Alarm Al...

Page 60: ...switch it o or restart using Digitax Library Is also possible to switch the SIM used by the modem from the primary to the second ary one this switch can be done only when the modem is o Ring It s pos...

Page 61: ...can be required for a cold x This feature introduced in Digitax products some years ago is now less important since M1 MDT GPS receiver is very sen sible and is able to do usually a very quick cold x...

Page 62: ...tax Mobile RAS Digitax Mobile Ras Link that have a fully comprehensive management of the modem and of the RAS connec on C sample code is provided with our SDK GSMCall With the internal GSM module it i...

Page 63: ...pera ng System or the applica ons save into the Registry It s necessary because Windows Registry and also all the folders except the ones in the Hard Disk or the Stor age Card are not saved to disk bu...

Page 64: ...following the directory structure Any le saved in the Update folder will be copied to Hard Disk any le saved in the Update SysApps folder will be copied in Hard Disk SysApps folder of the device and...

Page 65: ...re SD because it can be used to format and completely ini alize the ForceOne device Windows CE image user applica ons AITP rmware and setup are all updated in the restored device The Restore procedure...

Page 66: ...descrip on SDK NET DLLs Includes the complete set of Digitax SDK NET libraries SDK NET Digitax Protocols Sample and SDK NET Digitax Mobile Demo Includes some folders containing various code examples M...

Page 67: ...heck the Allow connec on with desktop computer when device is a ached box and press ok see picture for details To save this con gura on go to hard disk sysapps and lunch savereg exe and press save win...

Page 68: ...dll library provides a NET interface for the Digitax ComTax2 protocol it allows to communicate with every Digitax ComTax2 enabled device like Taximeters AITP or smart standalone displays It contains...

Page 69: ...0 baud Internal Taximeters are on COM3 at 38400 baud on ForceOne and ForceOne on the same port can be created also an Aitp Manager Object Other Digitax SDK Libraries To manage other Digitax device fea...

Page 70: ...the PIN is provided by the PIN property the SIM will remain unlocked un l modem is powered on Instead if the PIN code is provided by the event the manager will not check the remaining a empts the coun...

Page 71: ...stencies between mobile device and the telephony provider If the modem is not registered to the network RAS entry dial will begin as soon as network availability comes back again The RAS link manager...

Page 72: ...t you can require to Digitax there you will find also latest available version of the NET sdk Create build and Deploy a project You have to create a Smart Device Project framework 3 5 or 2 0 for Windo...

Page 73: ...and link and the device will automatically try to connect NOTE If you are using link class do not call Dial it will be automatically called by link class if you want to reset the connection simply ca...

Page 74: ...connected to internet and you want to make a phone call if you are in a 2G band GPRS or EDGE even if you are using a 3G modem internet connection will be suspended while you are performing the voice c...

Page 75: ...installed on your device in the Hard Disk SysApps folder you can find the Connection service icons that allow you to run it to stop it to configure it and to use it to make phone calls By default Conn...

Page 76: ...ou can also edit the other parameters you can edit them also changing the xml file Hard Disk SysApps ConnectionService Xmls ConnectionServiceCfg xml Beware that the file will bad formatted Service may...

Page 77: ...d the same libraries are used in the ConnectionService itself most important thing if you want to continue to use the modem libraries is that you have to be sure that connection service auto startup i...

Page 78: ...theservicetorunonstartupandautomatical lyconnect Ifitisnotsetautomaticallyconnectitwillopentheserialportthefirsttimeaclientwillconnecttotheservice Dlls to reference To connect to the service from your...

Page 79: ...The information contained here are property of DIGITAX Automotive Electronics Italy and extremely con dential Any disclosure copying distribution to third party is strictly prohibited 79 Notes...

Page 80: ...The information contained here are property of DIGITAX Automotive Electronics Italy and extremely con dential Any disclosure copying distribution to third party is strictly prohibited 80 Notes...

Page 81: ...The information contained here are property of DIGITAX Automotive Electronics Italy and extremely con dential Any disclosure copying distribution to third party is strictly prohibited 81 Notes...

Page 82: ...The information contained here are property of DIGITAX Automotive Electronics Italy and extremely con dential Any disclosure copying distribution to third party is strictly prohibited 82 Notes...

Page 83: ......

Page 84: ...ax com GPS 43 412423 13 654716 Digitax UK Smokehouse 31 Tanners Bank North Shields Tyne Wear NE 30 1 JH ENGLAND Digitax Mauri us P O box 775 Bel Village MAURITIUS Digitax Deutschland Taxitech Handelsg...

Reviews: