maximatecc CCpilot XM, Software Manual

Page 1: ...CCpilot XM and CrossCore XM Software guide Revision 1 6 Software Guide Date Jun 24 13 Software guide www maximatecc com CCpilot XM and CrossCore XM ...

Page 2: ...ows system start up specifics 9 3 3 Linux system start up specifics 9 3 4 Status LED indication 10 4 Accessing and using the interfaces of XM device 11 4 1 CF HDD 11 4 2 CAN 11 4 3 Ethernet 12 4 4 USB 12 4 5 RS232 Serial access 12 4 6 Video in 12 4 7 Audio In Out 12 4 8 Digital Input 13 4 9 Status LED 13 4 10 Backlight 13 4 11 Ambient light sensor 14 4 12 Buzzer 14 4 13 EEPROM 14 4 14 Hardware wat...

Page 3: ...ing system 24 8 Linux specifics 26 8 1 Linux system content 26 8 2 Updating system software 26 8 3 Installing new drivers applications and system packages 27 8 4 IP address configuration 30 8 5 Changing serial port settings 31 8 6 Remote access 31 8 7 Serial Number Broadcast configuration 32 8 8 Splash screen image replacement 33 8 9 Desktop background image replacement 33 8 10 USB memory installe...

Page 4: ...11 07 06 P1 1 2012 02 17 xx P1 2 2012 03 30 Update for new windows and Linux system images Licensing and 3rd party SW annotations added P1 3 2012 04 04 Small fixes and layout changes P1 4 2012 11 27 A I CrossCore XM P1 5 2012 12 03 Update after review P1 6 2013 06 17 Small clarification for WLAN settings in networking for Linux Company name change ...

Page 5: ...in most cases identical in functionality and usage The following definition is used to separate unit specific details The observe symbol is also used to highlight such difference Defines Use CCpilot XM Information that is specific for CCpilot XM CrossCore XM Information that is specific for CrossCore XM XM device Information that applies to both CCpilot XM and CrossCore XM The observe symbol is us...

Page 6: ...ilable in the CC AUX SDK 4 CAN Interface Description available within the Windows SDK 5 CCpilot XM and CrossCore XM Technical Manual 6 Embedded Write filer documentation MSDN http msdn microsoft com en us library bb521449 28v winembedded 51 29 aspx 7 File based write filter FBWF documentation MSDN http msdn microsoft com en us library ee832762 aspx 8 Hibernate once resume many HORM documentation M...

Page 7: ... service can however be disabled if a peripheral connection on serial port is desired This is specifically covered in chapter 8 5 Changing serial port settings Login service is using the same credentials as mentioned above for serial port terminal access 2 2 Using the touch screen Navigate the desktop or any application using the touch screen with a stylus or finger Tap the screen to perform the e...

Page 8: ...ints and edge distance settings of the calibration points The 5 point calibration is the default method The 13 point calibration can be used if the results of the 5 point calibration are not satisfactory The available command line options can be seen with the h or help option flags Touch screen functionality is only available in CCpilot XM product versions 2 5 Software deployment There are several...

Page 9: ...g system is started normal operating system steps are performed The Windows operating system is fully available as standard with installed device drivers for all hardware peripherals available 3 3 Linux system start up specifics The Linux operating system an Ubuntu LTS derivate has two start up modes the normal mode and the recovery mode In the normal mode the root file system is write protected m...

Page 10: ...ing suspended mode 2 LED OFF Device is off 3 4 3 Suspend resume sequence Once suspend is initiated 1 Flashing YELLOW at 0 2 Hz In suspend mode 2 Flashing YELLOW at 2 Hz Resuming operation 3 Static GREEN System is operational 3 4 4 Error indication There are two different types of error indications available from the status LED Flashing RED An occasional three RED blinks during startup indicates an...

Page 11: ...te larger blocks at one time instead of frequently writing smaller pieces Additional details about CF usage recommendations can be found in CCpilot XM and CrossCore XM Programmers guide 4 1 1 Windows In the maximatecc Windows images measures have been taken to reduce the number of write accesses during normal operation These measures include disabling of file access timestamps and disabling of pre...

Page 12: ...his is specifically covered in chapter 8 5 Changing serial port settings The Serial port in XM device follows RS232 signalling levels but with a limited set of signals For more information see the Technical manual Note that the serial port should not be used by any software when performing upgrades of internal microcontroller firmware The internals of the device needs to have undisturbed access to...

Page 13: ...plications running on XM device using the CCAux API The blinking frequency and colour of the LED can be controlled The latest status LED instruction is always used The status LED can also be disabled which means that only hardware error codes and user application behaviour is enabled Yellow blinking at start up and static green in operational mode are turned off 4 10 Backlight The XM device has an...

Page 14: ...e are several temperature sensors placed internally in the device Thus it is possible for an application to retrieve temperature information from the temperatures sensors through the CCAux API or the JIDA interface depending on temperature sensor placement 4 16 GPS The internal GPS receiver in XM device All Integrated follows NMEA 0183 standards To access the GPS receiver data you should open up a...

Page 15: ...h the CCSettings program or through the CC AUX API In Linux the wireless tools that are installed on the device can be used for setting up the actual network Such tools include the iwconfig iwlist iwspy iwpriv wpa_supplicant and wpa_cli commands Additionally the network interfaces file can be used for configuring WLAN settings In Windows the standard operating system network connections can be use...

Page 16: ...ettingsconsole For details about this please see the API documentation or ccsettingsconsole help Start CCsettings from its menu item or optional desktop shortcut In Windows CCsettings can also be started from the Control Panel 5 1 Main menu The main screen of CCsettings show the available settings pages Click on the respective icons to enter its settings page It is always possible to revert to the...

Page 17: ...e surrounding light The Status LED can be automatically dimmed according to the backlight setting if LED dimming is enabled Note that this may not work if a custom color is used or if a blink sequence is set up by user applications For CrossCore XM the Display option is not available in CCSettings 5 5 Power The power page is used to enable or disable the built in power controls in XM device Enable...

Page 18: ...ion types and to adjust the LED behavior during startup Enable or disable the status LED indication during startup of XM device using the Enable checkbox 5 9 Buzzer The Buzzer page is used to analyze the possible audio output from the Buzzer Adjust the frequency and volume of the built in buzzer using the sliders Test the buzzer sound by pressing the On button Press it again to turn off the buzzer...

Page 19: ...g is required for Windows XP based installations without the tablet PC component If the touch screen if the pointing precision seems low it is possible to make a calibration Start the calibration sequence by selecting Calibrate Now and follow the step by step sequence Different calibration methods can be chosen to perform more precise calibration In the Advanced tab additional touch and calibratio...

Page 20: ...ust the unit behavior when pressing and holding the On Off button ON OFF signal adjust the behavior of the On off signal through the power connector The time settings adjust how long the signal must stay low before XM device reacts to the signal Unit start up makes it possible to select if the unit shall respond to start up from both the on off button and or the on off signal in the power connecto...

Page 21: ...oller This includes the serial console usage under Linux and thus an upgrade must disable this prior to starting the upgrade For detailed information about how to upgrade the firmware please see 10 CCpilot XM and CrossCore XM Performing Firmware Updates 5 16 Telematics The Telematics page is used for control of All Integrated functionality such as the GPRS modem the GPS received the Bluetooth modu...

Page 22: ...hannel Select the video in signal to display Deinterlace mode Select deinterlace mode for video generation Video cropping Opens the Video cropping dialog Show video Enables disables the video in feed to be displayed Stretch Enables disables stretching of the video image to fit the size of the CCvideo application window Mirror image Enables disables video image mirroring Take snapshot Take a snapsh...

Page 23: ...e with of the signal in pixels Height Native height of the signal in pixels Frame rate Current frame rate of the video signal Video standard The detected video standard of the video signal 6 4 Video cropping Use the video format settings to adjust the video being shown Cropping Removes black or unwanted parts of the video signal The video feed is cropped by the number of lines set for each part of...

Page 24: ...CCpilot XM and CrossCore XM Performing Firmware Updates 7 3 Updating system components Updated system components can be installed in XM device to enable new features or provide enhancement on existing functionalities XM device specific drivers interfaces and applications are updated using updated software packages available from maximatecc or your sales contact These packages contain installation ...

Page 25: ...CCpilot XM and CrossCore XM Software guide Revision 1 6 Software Guide Date Jun 24 13 www maximatecc com ...

Page 26: ...or install updated packages The preferred method is to use package based updates 8 2 1 Image based update With this method all the user modifications to the system will be erased Device will be set to same state as it would be when left from factory This method can be used to recover devices that for some reason have corrupted system software This is also simplified with the tools mentioned in 9 B...

Page 27: ...tion has finished the update package and ccp xm update v1 2 0 0 directory can be removed Reboot the device 8 3 Installing new drivers applications and system packages All additional software or user files should normally be installed and stored under the user partition opt which is mounted read write Under opt a limited set of standard directories are found which are always writable those director...

Page 28: ...started the start up script rc located in etc init d is executed Normally this script reads start up scripts under etc rcX d depending on the actual run level X The default run level is 2 so applications should at least have startup scripts for this run level The rc script has been modified to parse additionally start up scripts found in opt etc rcX d as well as standard system scripts The parsing...

Page 29: ...Add your application using the dialog Add button 8 3 7 Upstart jobs Upstart is an event based replacement for the sbin init daemon which handles starting of tasks and services during boot stopping them during shutdown and supervising them while the system is running The XM device Linux system also uses upstart to be able to schedule applications starting correctly It is a stable way of adding auto...

Page 30: ...o effect either restart the device or press the top menu networking icon to toggle a network interfaces reset The network manager should also be used when configuring the WLAN connection details but the interface name will be different then 8 4 2 File method for IP address configuration The network interfaces file is located in writable storage but the edit process has been made transparent to tha...

Page 31: ...onnect to the XM device issue the following command and give password when asked ssh ccs X X X X To connect to a host from the XM device issue the following command ssh Username X X X X Above X X X X is known as an SSH server IP address with username Username A password might be necessary 8 6 2 SCP To copy a file to target use the following command and give password when asked scp File1 ccs X X X ...

Page 32: ...ss devices To access the device via VNC you will need to use a VCN viewer application and enter the IP address of the XM device along with the password when prompted for 8 7 Serial Number Broadcast configuration The XM device Linux version can identify itself over the IP network by sending out its serial number as a broadcast IP packet The Serial Number Broadcast SNB service is started by default ...

Page 33: ...that the device is shut down not just restarted Shutdown can also be made through the top menu command Once the device is started again the splash screen image should have been changed 8 9 Desktop background image replacement The desktop image that is shown as default image can be replaced Follow these steps to replace it with an image of your own Restart the system into rescue mode and then open ...

Page 34: ...lOS_v8 8 0 1014 Ethernet Win 7 Intel Intel PROSet 16 8 1 Win XP Intel Intel PROSet 16 8 1 Graphic Win 7 Intel Intel Graphics Media Accelerator 500 Driver Release 5 0 0 2030 Win XP Intel Intel_GMA500_Graphics_Media_Accelerator_WinXP_v3 3 0 Jida All Kontron JIDA32_Win_R118 Virtual COM All Future Technology Devices International CDM20814_WHQL_Certified 9 2 File system layout The default file system i...

Page 35: ...act flash disk EWF is primarily intended to write protect a run time image For Compact flash based devices it can also be used to extend the lifespan of the media by limiting the number of disk writes In WES7 EWF can work only in RAM mode This means that EWF works as a RAM overlay enabling the OS to act as normal but no changes are committed to disk until the user triggers a commit EWF commits inc...

Page 36: ...t damages to the file system HORM requires RAM or RAM Reg overlay and can only be configured using EWF HORM can be activated and deactivated using a command line tool HORM has a requirement that all volumes must either be protected with EWF or be in unmounted state when the Hibernate Once occurs This is to prevent state synchronization problems Each Resume from hibernation expects the entire syste...

Page 37: ... WS7P SKU licence the tablet PC package included in the image requires this license www microsoft com windowsembedded Windows Microsoft Windows XP Tablet PC Edition maximatecc s Windows XP Tablet PC edition image for XM device requires a Windows XP Pro for embedded systems licence Windows Microsoft Windows XP Embedded maximatecc does not provide a standard Windows XP image but a board Support Pack...

Page 38: ...ark which is the property of Intel Corporation in the USA and or other countries Linux is a registered trademark of Linus Torvalds Microsoft and Windows are registered trademarks which belong to Microsoft Corporation in the USA and or other countries CrossControl AB is not responsible for editing errors technical errors or for material which has been omitted in this document CrossControl is not re...