background image

CCilot XA and CCpilot XS 

Product revision: 0.12 

Software guide 

2018-03-19 

 

 

 

www.crosscontrol.com 

22

 

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. 

# sudo mount –o remount,ro / 

7.1.2.

 

User libraries 

To install additional shared libraries, install the library files into 

/opt/lib/

. Then, update the used 

library cache file by executing the following command: 

~# sudo ldconfig -C /opt/etc/ld.so.cache 

If additional library file locations are needed, the paths of these can be added to above command as 
parameters. The environment variable 

$LD_LIBRARY_PATH

 can also be used for finding library 

files not in the cache. 

Library cache file is never automatically updated. But if the file does not exist at system start-up, it 
is re-created with default version containing information only about the standard libraries. 

7.1.3.

 

User binaries    

Additional binaries such as customer application software or additional open-source solutions are 
preferably installed to 

/opt/bin/ 

or

 /opt/sbin/

. These directories are available in the standard path, 

adding binaries to these locations does not require an update to the 

$PATH

 environment variable. 

If additional levels of binaries are required, the 

$PATH

 environment variable must be updated 

through a start-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/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 3, 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 is done in a temporary directory, so scripts from each 
source location are interleaved depending on their respective names as described below.   

To start applications in run level 3, create a script located in 

/opt/etc/rc3.d/ 

that starts the desired 

applications. This is the default run level. Each script must be named 

SXXname

, where XX is two 

digits and corresponds to the order of the script execution.  

Note that these scripts are usually sourced, so no exit should be performed within these scripts, nor 
should any application lock the scripts by not performing proper spawning or forking.  

The scripts should follow the correct format for the start-stop system to work correctly. For more 
information on how the scripts should be created, see standard reference documentation for rc 
scripting. 

Run level 6 is dedicated for shutdown. When the device is shutting down the scripts from 

/etc/rc6.d/

 and 

/opt/etc/rc6.d/

 are executed to perform last clean-up actions. Required naming 

and execution order rules comply with start-up level 3, but kill scripts are normally named 

KXXname

 instead. 

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: