2018-03-19 1. Introduction This software guide contains information on how to start using the CC pilot XA, CCpilot XS and CrossCore XS products and how to access Service functionality. These devices are available with Linux as operating system. The reader should be familiar with the respective operating system and computer usage to fully benefit from this material.
Besides the touch screen, keyboard and mouse connected via USB can also be used. Touch screen functionality is only available in product versions equipped with touch screen display, such as CCpilot XA and CCpilot XS. 2.3. Calibrating the touch screen To calibrate the touch screen, either start Touch Calibration from startup screen application, or open CCsettings from the startup screen application, select Touch and then Calibrate Now.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 2.4. Keyboard There is no virtual keyboard available, so a user that requires keyboard access needs to connect a USB keyboard. 2.5. Software deployment There are several methods to add your own software to the device. The standard methods to transfer software to the device are to either copy files using the network connection or to use USB storage devices, with manual or automatic copy functions.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 This is the main operation mode which includes all drivers to available hardware, system libraries, graphical applications and tools described in this and other documents. Rescue or Backup system This is only for device updates and recovery use.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 3.3.2. Shutdown sequence Once shutdown or reboot is initiated: Static YELLOW during shut down sequence. If it’s a reboot, the startup sequence immediately follows the shutdown sequence. 2. LED OFF. Device is off 3.3.3.
This section covers basic usage and access of the device hardware. Most of the hardware is accessed using the default Linux interfaces but some device specific interfaces may require additional software and/or interfaces to be accessed. See the CCpilot XA and CCpilot XS– Programmers guide documentation for general information regarding software development using the devices interfaces.
Normally the device have two or four CAN interfaces The CAN interfaces can also be accessed with the Linux operating system standard API SocketCAN. More information can be found in CCpilot XA and CCpilot XS – Programmers Guide. 4.3. Ethernet Up to two Ethernet ports are available on the device, thus enabling simultaneously connection with two physical network infrastructures.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 Video input channels 1 and 2 can be displayed without any significant CPU performance penalty, in one video window instance. Video channels 3 and 4 can be displayed as the second video window instance, but will have some CPU performance penalty due to hardware constraints.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 4.12. Buzzer In addition to the audio In/Out signals, the device is also equipped with a buzzer that can play tones in various frequency and intensity levels. The buzzer is accessed through the CCAux API. It can also be accessed for diagnostic through CCsettings.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 NMEA also allows the GPS device to be configured, for more details; locate Fastrax iSuite™ NMEA manual. It is also possible to use CCSettings for initial verification of GPS receiver functionality, see more in section 5.16.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 4.18.1. Association and authentication Unsecured networks (and simple WEP authentication) can be connected simply using iwconfig and “one liner” command. But WPA enabled access points require the use of the wpa_supplicant-daemon, which uses its own configuration file.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 5. CCsettings The images here are for illustration purposes and may not represent the real device user interface CCsettings is used for viewing and adjusting device specific features and information. Through the CCsettings main window, the different settings pages are reached, each containing different areas of settings and information.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 5.4. Display Use the display page to alter the device backlight functionality. Adjust the backlight of the display by dragging the Backlight level slider. Enable automatic backlight using the Enable checkbox.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 5.7. About The about page displays device specific information and status information. Select what type of information to display using the Selection drop down box. Select System report drop down to generate a full device information report, which can be saved to file.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 5.11. Digital Input/Output The digital input/output page displays the status of the digital input and output ports on the device. 5.12. Touch screen The touch screen page is used for touch screen related settings.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 Long press - ON/OFF button - adjust 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 setting adjust how long the signal must stay low before the device reacts to the signal.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 6. CCvideo CCvideo is a pre-loaded application for viewing the device video in signals. The CCVideo application can show video from channels one and two using the CC AUX API, while the CC AUX API can assist other applications with showing video channels 3 and 4.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 Mirror image - Enables/disables video image mirroring. Full Screen – View video in full screen mode. Input info - Displays input information for the currently viewed video in feed.
Page 22
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 Important, remember to use the following command to remount the file system as write protected again, before shutting down or restarting the device. Note that any changes to the write-protected file system will be overwritten when performing an operating system upgrade.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 Additionally, there’s a specific shutdown script available for user editing. It is called /opt/shutdown, and is by default an empty script. Any user can add specific shutdown related tasks in that script, if desired.
Page 24
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 7.4.2. SCP To copy a file to target use the following command (and give password when asked): # s cp File1 cc s@ X . X .X. X : / opt /Fil e To copy a file from target use the following command (and give password when asked): # s cp cc s@ X .
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 7.5. Frame buffer graphics The graphics framework uses the Linux frame buffer for graphics operations. It’s fast and efficient, and has vast standard support in the Linux user space world. For instance, Qt has a plugin that enables the Qt libraries to be built with direct frame buffer drawing possibilities.
Page 26
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 # !/ bi n/ s h . /et c /i nit .d/ cro s s - commo n # E N D U S ER : Re pla ce t hi s w it h yo ur o w n appli c atio n.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 M o use M a n: /de v /mo use0 " \ $ A PP L ICA T ION _P A T H/$ A PP L ICA T ION -q ws -di spl a y \ "...
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 # A d va nced fe at ure s onl y. U se w it h dis cr etion. # Fi rm w ar e - fiel d i s a uto di sco v ered , b ut ca n be o ve r writt en. Str i ng v al ue # F IR M WA R E =1 .0 .0...
Note: This can potentially also remove some applications and files that are part of the factory installation by CrossControl and delivered to you as such. If that is the case, please avoid this method of user data and file removal unless specific knowledge about this has been gathered.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 # re boot - re sc ue . s h clea r which will reboot the device twice and reformat the entire user partition, as well as restoring the default files that actually are there.
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 8.4. Released image files New versions of the operating system for the device are released as a set of binary format image files as well as additional configuration files and scripts required for update.
Page 32
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 Example output: = = = = C ros s Co ntrol : De vi ce U pda te = = = = = A 8 .2 N ow r unni ng o n...
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 8.6. Update automation This example shows how to automate remote update so that user interaction is not required. Similar automation can also be saved to USB memory; so that inserting the USB memory into a working device will execute an update without interaction.
Page 34
CCilot XA and CCpilot XS Product revision: 0.12 Software guide 2018-03-19 ccpilot-xa-bs.md5sum) a fullup.sh to unit /tmp/ folder. Copy method choice is free; scp, USB memory or NFS mount can all be used. Access the Linux console as root user, either over SSH connection from other host or serial console terminal access to Linux.
CrossControl. CrossControl respects the intellectual property of others, and we ask our users to do the same. Where software based on CrossControl software or products is distributed, the software may only be distributed in accordance with the terms and conditions provided by the reproduced licensors.
Need help?
Do you have a question about the CCpilot XS and is the answer not in the manual?
Questions and answers