background image

CCilot XA and CCpilot XS 

Product revision: 0.12 

Software guide 

2018-03-19 

 

 

 

www.crosscontrol.com 

8

 

3.3.2.

 

Shutdown sequence 

Once shutdown or reboot is initiated: 

1.

 

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.

 

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.3.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 internal error 
that is recoverable, i.e. the system can continue its execution and normal operation. The 
error code can be retrieved trough the CCAux API, since the status LED will follow its 
normal status indication scheme. 

 

Flashing BLUE – The device becomes non-operational, and seems to be dead, despite 
powered on. A number of BLUE LED blinks should be displayed. Record the number of 
blinks, as this can be useful in an eventual support contact. 

Reason for BLUE LED blinking could be voltage levels out of range, temperature related problems 
or internal hardware errors. First steps should be to let the device cool off, and verify it has correct 
power supply attached, before starting the device again.  

3.4.

 

Default start-up applications 

On the CCpilot versions, a default graphical application is started when the device is started. This 
application supports the user with a GUI for simple tasks and information until the startup 
application can be replaced with the proper user defined application. The replacement of this 
application is described in section 7.6. 

It’s also possible to connect to the device via a VNC Viewer application by default, it will however 
require a known IP address of the device. By default, it’s only the CCSettings application that’s 
accessible via the VNC protocol, but it can be replaced with any desired Qt application. Further 
information about that is found in section 7.11. 

 

 

 

 

Summary of Contents for CCilot XA

Page 1: ...Product revision 0 12 2018 03 19 CCilot XA and CCpilot XS Software guide www crosscontrol com...

Page 2: ...up behaviour 6 3 1 Boot loader 6 3 2 Linux system start up specifics 6 3 3 Status LED indication 7 3 4 Default start up applications 8 4 Accessing and using the interfaces 9 4 1 SD file storage 9 4 2...

Page 3: ...ng new drivers applications and system packages 21 7 2 Text editor 23 7 3 IP address configuration 23 7 4 Remote access 23 7 5 Frame buffer graphics 25 7 6 Default start up application 25 7 7 Late loa...

Page 4: ...nformation that is specific for CrossCore XS device Information that applies to CCpilot XA CCpilot XS and CrossCore XS The observe symbol is used to highligt information in this document such as diffe...

Page 5: ...ld the on the touch screen to perform the equivalent to a right click Besides the touch screen keyboard and mouse connected via USB can also be used Touch screen functionality is only available in pro...

Page 6: ...section 4 5 RS232 Serial access for additional details and how to disable the recovery login via external serial port method Once logged in the user should have access to the device and should be abl...

Page 7: ...might not yet have been initialized properly and thus the application needs to handle that properly On the other hand a slower startup level guarantees that the required functionality is available upo...

Page 8: ...ional and seems to be dead despite powered on A number of BLUE LED blinks should be displayed Record the number of blinks as this can be useful in an eventual support contact Reason for BLUE LED blink...

Page 9: ...ical or not An application shouldn t cache files on the SD card since in case of a sudden power loss the SD card s writable partition is made write protected to protect the files from being corrupted...

Page 10: ...as described in 7 3 Be aware that connecting the device to a network environment can impose a security threat if not taking the required security measures 4 4 USB Via the USB port a multitude of peri...

Page 11: ...ings as described in 3 3 Status LED indication The status LED can also be controlled by the applications running on the device using the CCAux API The blinking frequency and colour of the LED can be c...

Page 12: ...c watchdog kicker software called wdt If user software wants to take over the watchdog handling then wdt task should be killed first for example killall wdt If the user software does not want to handl...

Page 13: ...that settings relevant for the PPP peers are written in the standard format for this information and stored under opt etc ppp peers Once this is properly configured the PPP connection is initialized...

Page 14: ...wpa_supplicant Dwext B ieth1 c usr local etc name_of_config dhclient pf var run dhclient eth1 pid eth1 4 19 Bluetooth Devices with All Integrated options have HCI Bluetooth support HCI stands for Host...

Page 15: ...n or from the command line with the tool ccsettingsconsole For details about this please see the API documentation or ccsettingsconsole help Start CCsettings from its menu item or optional desktop sho...

Page 16: ...t 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...

Page 17: ...the possible LED indication types and to adjust the LED behavior during startup Enable or disable the status LED indication during startup of the device using the Enable checkbox 5 9 Buzzer The Buzzer...

Page 18: ...ering a time at Right click time and pressing Apply it is possible to adjust the time needed until pressing on the touch screen will result in a right click action See the CCAux API documentation for...

Page 19: ...o 0 disables the shut down feature the device will stay in suspended mode indefinitely until started or until power is removed 5 15 Advanced The Advanced page is used for loading new firmware into the...

Page 20: ...The API is further described in 1 Video functionality viewing is not applicable for the CrossCore XS 6 1 CCvideo main window When starting CCvideo the main window will be shown as illustrated This wi...

Page 21: ...of the video signal The video feed is cropped by the number of lines set for each part of the picture 7 Software configuration possibilities This section describes specific details for the configurabi...

Page 22: ...up script 7 1 4 Start up scripts The user has the possibility to start applications and scripts by modifying or adding start up scripts When the kernel is started the start up script rc located in etc...

Page 23: ...ade transparent to that fact This method requires knowledge about the interfaces file format but a sample is given below sudo nano etc network interfaces Sample of interfaces file setting same static...

Page 24: ...ipts or alike On connecting host not the target device execute the command below and enter an empty passphrase when prompted ssh keygen t rsa f xa_rsa Copy or append the created xa_rsa pub file into t...

Page 25: ...ristic of the Qt QWS system However only one Qt application should act as the GUI server i e use the qws flag when starting Make sure that the graphical applications adhere to that requirement for pro...

Page 26: ...ION then RESOLUTION DEFAULT_RESOLUTION fi if check_feature DISPLAY check_feature EXTDISPLAY then if USE_VNC ne 0 then QWS_KEYBOARD LinuxInput dev kb0 LinuxInput dev kb1 LinuxInput dev kb2 QWS_MOUSE_PR...

Page 27: ...anged if critical functions in drivers are needed earlier at the expense of slower startup of applications The user can edit a configuration file to change the behavior The file is opt etc late loaded...

Page 28: ...ations in that script this feature can be used for creating auto update of user and system software There are no specific limits on what user can do with cc auto sh file but it s recommended that all...

Page 29: ...ia VNC you will need to use a VNC viewer application and enter the IP address of the XA device By default there is no application made available for access through VNC but it can be enabled to use a d...

Page 30: ...controllers The FPGA can also be updated programmatically with this tool Each of these firmware components can only be updated individually The preferred method to perform the update is by using the C...

Page 31: ...ails to boot 5 times in a row backup system is automatically entered From a working main system entering the backup system is done using following reboot command reboot rescue sh Once the module has e...

Page 32: ...e This is you last change to do cancel IF YOU CONTINUE DO NOT INTERRUPT THE PROCESS UNTIL READY The process is pausing here and waiting for Enter or cancellation Now doing Requested reprogramming DO N...

Page 33: ...his is an example that enables operating system update to be automated but it can be used as an illustration on what can be done with the installer script as such This script solution is to be used fo...

Page 34: ...it within Linux Prerequisite New file images are at the devices tmp folder Update tool command fullup sh is already present or it can be copied to target explicitly Warning All excess processes that m...

Page 35: ...ot responsible for editing errors technical errors or for material which has been omitted in this document CrossControl is not responsible for unintentional damage or for damage which occurs as a resu...

Reviews: