background image

 

The information contained here are property of DIGITAX Automotive Electronics Italy, and extremely confidential. Any disclosure, copying, distribution to third 

party is strictly prohibited.

 

50 

Communication Protocol A.I.T.P. 

Ver. 3.5 

The purpose of this document is to describe the Communication Protocol COMMTAX2. 
It is divided into two sections: 
Basic protocol description 
Implementation in Digitax product 4GMCU 
The  COMMTAX2  communication  protocol  is  intended  as  a  standard  base  to  make  communicating 
two or more devices on the same line, it is designed to interface mobile modules and to interconnect 
them; also with the proper extension may be used for radio/infrared link to base station. 
The complete addressing of each packet allows several devices to share the same line without wrong 
routing or lost of data. 

IMPORTANT NOTE: 

The basic protocol structure is the same one used in Digitax F1 Taximeter, so applications can use 
the  same  transport  layer  protocol  to  communicate  both  with  Digitax  F1  and  with  the  AITP 
processor  inside  the  4GMCU.But  there  is  also  a  simplification:  only  single  packets  messages  are 
used. For this reason please use a data packet size bigger than the max quantity of data that have 
to  be  transferred,  actually  96  bytes  of  data.  Also  the  Device  ID  is  different,  for  the  Taximeter  is 
0001 hex, for the AITP is 1000 hex. 

Содержание 4GMCU

Страница 1: ...4GMCU Technical Manual V 1 3...

Страница 2: ...The information contained here are property of DIGITAX Automotive Electronics Italy and extremely confidential Any disclosure copying distribution to third party is strictly prohibited 2...

Страница 3: ...Mode 17 4GMCU Power On 17 4GMCU Power Off 17 On board peripheral power 18 Odometer and OverSpeed 19 Tips for the programmer 19 Embedded taximeter 21 Driver Logon and Authentication 21 Infrared Passen...

Страница 4: ...n 44 AITP Light Dimmer 45 Digital I O IPreShut 47 GPS 48 Communication Protocol A I T P 50 Standard Basic structure and operating principle 51 Packet 52 Character set 52 Device Id 53 ASCII coding 53 H...

Страница 5: ...n compatible with GPRS base EDGE option and UMTS option retrofit upgradable Warm reset and cold reset dedicated electronic circuit available through API calls 2 Hardware RS232 Serial Ports available o...

Страница 6: ...down MDT unit Multimedia Speaker and Microphone Supports wave speaker volume control API to be provided Playback wave and speech files Boot Triple Boot Manager Flash Disk SDHC Card Hidden Protected D...

Страница 7: ...f Light Navigation Software All On Field Tests and enrolling features can be used during first installation and swap of devices OS Image Loader Over The Air OTA OS image loader or microSDHC Card Image...

Страница 8: ...The information contained here are property of DIGITAX Automotive Electronics Italy and extremely confidential Any disclosure copying distribution to third party is strictly prohibited 8 Block Diagram...

Страница 9: ...pecial bootable SD Card In order to have a regular boot simply press the Power Button for a while then release it MCU will boot from the Hard Disk To get the alternative boot it s necessary to keep th...

Страница 10: ...The information contained here are property of DIGITAX Automotive Electronics Italy and extremely confidential Any disclosure copying distribution to third party is strictly prohibited 10 Appearance...

Страница 11: ...11 Technical Views 4GMCU...

Страница 12: ...The information contained here are property of DIGITAX Automotive Electronics Italy and extremely confidential Any disclosure copying distribution to third party is strictly prohibited 12 M2 Display...

Страница 13: ...Light green 5 Digital Input 2 Gray 6 Digital Input 3 Light blue 7 Digital Input GND Black 12 Digital Output 4 Thin orange 15 Odomer Input Black 18 Emergency Switch active low Violet 13 AITP Digital In...

Страница 14: ...SysBoot Is used by ROM DOS during the start up procedure It s an hidden folder Do not change its content Update Special folder which have to be used for update and backup as explained in the following...

Страница 15: ...rd as a temporary storage for the nk bin file about 30 Mb use Warning to copy twice the CE file will require some minutes If the copy is stopped in the meanwhile the system could not be able to boot a...

Страница 16: ...rive In SYS UTILS application there is also a quick way to create a simple update SD Card it can be later completed by copying in its update folder all the files that you wish to be updated in the MCU...

Страница 17: ...5 seconds If a bootable SD Card is inserted during start up a boot from the SD Card is possible in the same way Wake up on Ring Stealth Mode AITP can be configured to start automatically the MCU when...

Страница 18: ...eeds more than 12 hours of normal connection to the main battery to become fully charged anyway the system can operate properly while battery is charging The AITP continuously monitors main power volt...

Страница 19: ...order to let them trigger an appropriate action to the driver or the record log and when speed is again below the limit an Over Speed End Event is triggered giving also the maximum speed that has bee...

Страница 20: ...rotocols for GPS Card Reader ComTax2 and AITP Automotive Intensive Task Processor interface Using this DLL you will have in a little time the full control of all the hardware included in the MCU and a...

Страница 21: ...s no more need to costly replace Eprom E Seal record for every firmware change for tracing updates Independent Power Supply powered even when MCU is off Independent Wheel pulses input to allow the met...

Страница 22: ...Kb of memory where the taximeter can store information on the driver s shift totals and information can be downloaded to the office using the ComServer program Infrared Passenger Sensor These sensors...

Страница 23: ...ach one of the 3 special inputs if the trigger has to be enabled or not if the trigger is on both transitions or only on a selected one and to select the Low to High transition or the High to Low one...

Страница 24: ...operty of DIGITAX Automotive Electronics Italy and extremely confidential Any disclosure copying distribution to third party is strictly prohibited 24 4GMCU with Embedded F16 Taximeter and peripheral...

Страница 25: ...ed It is a system application that take care of many thinks Power up and initializes GPS and GSM modems Updates AITP firmware if the file MCU_21 hex is found in the Hard Disk SysApps Box folder Update...

Страница 26: ...ir the firmware file to the Hard Disk SysApps Box folder The next time the MCU will be restarted at start up the firmware will be automatically updated before running the user application After that a...

Страница 27: ...he battery charger activity The battery charge tension is measured without any load so is higher than the actual one After a programmed time that the Main Power supply is lost and so the Low Power sta...

Страница 28: ...ly Odometer The AITP also provides Odometer functionalities to the applications Travelled distance can be either read or read resetted by DLL functions This is done by application polling Otherwise it...

Страница 29: ...de if position is still usable or not Using this application it is possible to publish the position to Internet and look at a map at the address http www digitax it utils gps gps_map html This is prov...

Страница 30: ...trictly prohibited 30 VoiceCall With the internal GSM module it is possible to make voice calls using either the MCU speaker and microphone or the earphone jack The application allows to make and rece...

Страница 31: ...save registry changes you need to use this program We suggest to the developers not to use the registry to save applications setup and it use files in Hard Disk This avoids the necessity of continuou...

Страница 32: ...pying distribution to third party is strictly prohibited 32 2 System options allows you to choose the amount of memory to be used for storage in TEMP and in WINDOWS folders to enable or disable autoru...

Страница 33: ...nected to the ComPort with a NULL MODEM cable M16Flasher This program is used when the Embedded Taximeter is installed It flashes the taximeter firmware just like the AITPProg does with the AITP proce...

Страница 34: ...atus alarm and stealth mode temperature and fans MDT and MCU only magnetic card reader Windows status other hardware informations like hardware ID The developer can initialize only the needed callback...

Страница 35: ...ing voice calls the possibility of get information such as ID and signal strength about the neighbor cell stations the possibility of send receive direct AT commands to the modem Digitax Mobile RAS Th...

Страница 36: ...in the HangUp Dial procedure GPS Wrapper41 GPS Wrapper41 library provides a NET interface to the GPS receiver it allows the applications to have positioning information without knowledge of the NMEA p...

Страница 37: ...Link public Demo InitializeComponent instantiate modem manager _modem new ModemManager MODEM_PORT_NAME MODEM_PORT_BAUD _modem PIN 1234 set here you SIM PIN register to modem events _modem CellNameChan...

Страница 38: ...usChanged SimCardStatus status if InvokeRequired BeginInvoke new SimCardStatusChangedHandler _modem_SimCardStatusChanged new object status return switch status case SimCardStatus Absent case SimCardSt...

Страница 39: ...pe None txtDataProtocol Text protocolType ToString break default txtDataProtocol Text break void _modem_CellNameChanged string newCellName if InvokeRequired BeginInvoke new CellNameChangedHandler _mod...

Страница 40: ...ss ToString endregion private void btnClose_Click object sender EventArgs e btnClose Enabled false Close private void btnSmsSend_Click object sender EventArgs e btnSmsSend Enabled false _modem SendSMS...

Страница 41: ...ription please refer to the Comtax2 Protocol manual if EventCode byte ComTax2 Wrapper41 EvtCodeEnum COMTAX2_RX_MSGOK RemoteDevID byte ComTax2 Wrapper41 EnumDest DEST_TAX switch Command case AR Extende...

Страница 42: ...ort ComTax2 Wrapper41 EnumDest DEST_TAX new byte byte C byte R new byte 0 0 WriteLog Taximeter Clock Request Deliverd res ToString private void btOdometer_Click object sender EventArgs e bool res Requ...

Страница 43: ...terTrigger _aitp_EvAITPOdometerTrigger init odometer callback _aitp AITPInitOdometer void OdometerTest_Closing object sender CancelEventArgs e release aitp _aitp AITPRelease void _aitp_EvAITPOdometerT...

Страница 44: ...nitializeComponent this Closing new CancelEventHandler HardwareInfoForm_Closing init aitp in MDT MCU COM4 19200 on ForceOne COM3 38400 _aitp AITPInit COM4 19200 _aitp EvAITPAskSoftwareVersion new Aitp...

Страница 45: ...eTrigger _aitp_EvAITPDimmerValueAndTableTrigger _aitp EvAITPLightIntensityTrigger new Aitp Wrapper41 AitpCore delAITPActivateLightIntensityTrigger _aitp_EvAITPLightIntensityTrigger init light dimmer _...

Страница 46: ...ng _aitp AITPSetDimmerValue _dimVal void DiimerSample_Closing object sender CancelEventArgs e release aitp _aitp AITPRelease private void btAskLight_Click object sender EventArgs e _aitp AITPAskLightI...

Страница 47: ...O Wrapper41 DigitalIO ipreshut check tread System Threading Thread ipreshutThread bool stopExecuting false public DigitalIOTest InitializeComponent this Closing new CancelEventHandler DigitalIOTest_Cl...

Страница 48: ...M1 ForceOne COM2 _gps GPSInitData COM1 9600 init events and callbacks _gps EvGPSGSVSatellitesCallback new GPS Wrapper41 GPSWrapper delGPSGSVSatellitesCallback _gps_EvGPSGSVSatellitesCallback _gps EvGP...

Страница 49: ...xt _rmcData Longitude_deg ToString tbSpeed Text _rmcData Speed_kmH ToString tbFixMode Text _gsaData iFixMode ToString tbUsedSats Text _gsaData iSatsUsed ToString tbPDOP Text _gsaData dPDOP ToString tb...

Страница 50: ...e modules and to interconnect them also with the proper extension may be used for radio infrared link to base station The complete addressing of each packet allows several devices to share the same li...

Страница 51: ...and data transfer is based on MESSAGES it can be a collection of several packets as needed split into PACKETS of any suitable size till 1024 characters actually transmitted including header this is t...

Страница 52: ...everal devices sharing the same line A typical case can be a mobile installation where several devices must interchange messages Taximeter Printer Dispatcher Radio etc With this protocol all of them c...

Страница 53: ...cludes a representation each nibble by the corresponding ASCII value so the above value shall be coded 31h 1 45h E in this natural order At dealing with multi byte value the Intel convention is used p...

Страница 54: ...dressed equipment will accept it and will respond with a MESSAGE with or without data in the PACKET s body according to the received request At this point the originator waits until timeout for the re...

Страница 55: ...l be performed over the 15 first characters of the packet On the other side the receiving LRC will be performed over the received data in the order they are arriving The order is important since is a...

Страница 56: ...eceiving the acknowledge resends the same packet till 3 times see Handshake At this point the receiver which has already in its memory the correct copy of such packet must have the possibility to dete...

Страница 57: ...1 IN 2 id 2 IN 3 id 3 RING id 3 0 IN 1 0 Fall transition 1 Rise 1 IN 2 id 2 IN 3 id 3 RING id Byte 3 is valid only in case of having set 1 in byte 2 indicating that only the selected front will trigge...

Страница 58: ...ut Down procedure as if the Power Key has been pressed Windows Restart and Watchdog This command starts the Windows Shut Down procedure and the Restart of the MCU It can be used without parameters to...

Страница 59: ...n power supply is off The Power Down delay is the delay after which the MCU is automatically switched off If the value is 0 means that switch off is disabled In this case the MCU will be switched off...

Страница 60: ...sec If Wheel Code number of pulses for each Km is supplied Speed calculation is performed TD bytes 1 4 pulses from last odometer reset bytes 5 8 time tics 4800 Hz from last odometer reset bytes 9 10 a...

Страница 61: ...ry high 65 C or more The answer to command FR is message FS Setup Parameters Read Write It is used to sent read setup parameters file to the AITP The answer to command ER is message ES Stealth Mode an...

Страница 62: ...bit 2 if 1 than WAKE UP ON RING byte 2 Stealth Status on ring 0 start in normal mode 0 start in Stealth mode value is stealth Status HX the same 2 bytes data as HW that are the current AIxP Setxinxs...

Страница 63: ......

Страница 64: ...l info digitax com Digitax UK Digitax Mauritius Digitax Deutschland Smokehouse 31 Tanners Bank North Shields Tyne Wear NE 30 1 JH ENGLAND P O box 775 Bel Village MAURITIUS Taxitech Handelsges mbh Somm...

Отзывы: