background image

CCilot XA and CCpilot XS 

Product revision: 0.12 

Software guide 

2018-03-19 

 

 

 

www.crosscontrol.com 

9

 

4.

 

Accessing and using the interfaces 

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. 

Depending on product model, all interfaces may not be present on your specific model. There may 
also be additional methods to access the device than the ones described herein, depending on 
operating system and additional installed software. 

4.1.

 

SD file storage 

The device uses Secure Digital flash card based storage, i.e. SD card. The storage is identified to the 
system as a block disk device. 

The Secure Digital flash card is industrial grade classified and has both static and dynamic wear 
levelling to prevent a premature aging and to ensure the longest lifetime. Still Secure Digital flash 
cards have a limited number of write cycles. It is recommended that the amounts of writing to 
storage are limited within the application. Rather keep information in RAM memory and write 
larger blocks at one time instead of frequently writing smaller pieces. 

There’s though a trade-off that an application needs to make here, if the data to be saved is mission 
critical 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 due to the power loss. An application needs to be careful when writing large files, as it 
can cause pro-longed write-protect sequences, which is a potential hazard to the file system and SD 
card. 

Additional details about SD card usage recommendations can be found in 

CCpilot XA and CCpilot 

XS – Programmers guide. 

4.1.1.

 

File system layout 

In Linux, the Secure Digital flash card is partitioned into two root file system, which are write 
protected, and one user file system area, which is write enabled by default. The latter area is the 
preferred location for user software installations. See chapter 7.1 Installing new drivers, 
applications and system packages.  

The two initial partitions hold each operating system mode’s root file systems, i.e. first the rescue 
system root file system and second the main system root file system. The root file system is located 
in the SD flash card. It is of type EXT4 and it is mounted as read-only for security reasons. It is 
mounted by the kernel boot-up sequence.  

Any attached USB memory is automatically mounted once inserted. Supported formats for USB-
memory include FAT types which is the default format for USB-memories. USB-memory devices 
are never automatically formatted so if file system is unsupported, device is just not mounted. 

Mount point 

Mount status 

Media 

Read only 

SD card, second partition 

/usr/local 

Read-write 

SD card, third partition 

/media/usb 

Read-write 

USB memory, if available 

/media/usb2 

Read-write 

Second USB memory, if available 

Содержание CCilot XA

Страница 1: ...Product revision 0 12 2018 03 19 CCilot XA and CCpilot XS Software guide www crosscontrol com...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Отзывы: