CCAux Documentation

Introduction

This documentation is generated from the CCAux source code. CCAux (CrossControl Common Aux control) is an API that gives access to settings, features and many hardware interfaces; backlight, buzzer, diagnostics, frontled, lightsensor and analog video interfaces.
The API is available for multiple platforms and operating systems: Linux on the CCpilot XA, XS, VC and XM products in all variations. For the XM and XL platforms, Windows XP, Windows 7 and 8 is also supported.

The known issues and changelog presented here also cover the following maximatecc applications (which are using the API and are released in conjunction with it):

• CCSettings
• ccvideo
• ccsettingsconsole
• touchcalibrator
• ccauxd

Go directly to the list of functions.

Changelog

Version 2.7.2.0 - XM/XL Windows x86, x64 platform, VC Linux platform

• XM/XL, Windows: Fixed a bug introduced in 2.7.0.0 where the light sensor data could not be read on XM/XL.
• CCSettingsConsole: Fixed an issue where some commands did not work in Windows.

Version 2.7.1.0 - XM/XL Windows x86, x64 platform, VC Linux platform

• ccvideo: Fixed an issue where channels were not displayed correctly in the menu.

Version 2.7.0.0 - XM/XL Windows x86, x64 platform, VC Linux platform

• VC: Support for the VC platform (Linux).
• XM/XL: Support for the XM 2.0 platform (Windows/Linux).
• Added the following classes/functions for the VC platform:
  • Class CfgIn - Functions for managing configurable inputs
  • Class PWMOut - Functions for managing PWM outputs
  • About_getNrOfCfgInConnections
  • About_getNrOfPWMOutConnections
  • About_getNrOfButtons
  • About_getNrOfButtons
  • Config_getButtonFunction
  • Config_setButtonFunction
• Added the following functions for all platforms:
  • About_getUserEepromData
  • About_setUserEepromData
  
  
• Known issues:
  • XA/XS: Same as 2.4.7.0 release
  • XM/XL: Same as 2.5.0.0 release
  • VC: -

Version 2.6.2.0 - XM/XL Windows x86, x64 platform

• XM/XL: Fix for an issue with the function Video_getActiveChannel in x86 API on x64 OS.
• XM/XL: Support for Power_getCanOCDStatus and Power_getVideoOCDStatus with SS v1.2.0.0 or later.
• XM/XL: Support for optional integrated WLAN on CCpilot XL4.
• XM/XL: CCsettings: Improved Telematic GUI when not all interfaces are available.
• XM/XL: SnbService: Improved unit type descriptions: "CCpilot XM" instead of just "XM".
• XM/XL: CCsettings, CCvideo and TouchCalibrator: QT x86 libraries updated to v4.8.5.
  
  
• Known issues:
  • XA/XS: Same as 2.4.7.0 release
  • XM/XL: Same as 2.5.0.0 release

Version 2.6.1.0 - XM/XL Windows x86, x64 platform and XA/XS Linux platform

• XA/XS: Functions added: Video_getGraphicsOverlay and Video_setGraphicsOverlay.
• XM/XL: 64-bit support. Both x86 and x64 versions of the API can be installed at the same time on x64 systems.
• XM/XL: SnbService is now a selectable component in the installer.
• XM/XL: CCsettings: Factory default settings for XL4 updated: ShortButtonPressAction=ActionShutDown, OnOffSigAction=NoAction
  
  
• Known issues:
  • XA/XS: Same as 2.4.7.0 release
  • XM/XL: Same as 2.5.0.0 release

Version 2.5.0.0 - XM/XL x86 platform

• CCAux2 API: Support for the XL platform. The XL platform is almost identical to the XM platform in terms of API support.
• CCAux2 API: Added SMART support for a second card used in XL (new functions Smart_getRemainingLifeTime2, Smart_getDeviceSerial2 and Smart_getInitialTime2).
• CCAux2 API: Bugfix for crash when incorrect filename was supplied to the functions FirmwareUpgrade_startFpgaUpgrade and FirmwareUpgrade_startFpgaVerification.
• CCvideo: Fixed a bug where selecting video 3 and 4 both selected video 3. The bug was only present in CCvideo v2.4.0.0 for XM and not in previous versions.
• CCvideo,CCAuxDrv: On the XL platform, video channel 3 and 4 are not available on both devices as on XM. Instead ch1 and ch2 can be selected for both devices.
  Only one channel can be shown at the same time per device and a device is on the XL platform equal to a physical connector.
• CCAux2CS: Added support for SMART interface for the C# dll
• CCAux2CS: Rewrote the following functions and changed their declaration to use System.String as output. The old overloads now return ERR_NOT_SUPPORTED:
  About_getMainPCBSerial
  About_getUnitSerial
  About_getMainPCBArt
  About_getMainManufacturingDate
  About_getMainHWversion
  About_getMainProdRev
  About_getMainProdArtNr
  About_getAddOnPCBSerial
  About_getAddOnPCBArt
  About_getAddOnManufacturingDate
  About_getAddOnHWversion
  FirmwareUpgrade_startFpgaUpgrade
  FirmwareUpgrade_startFpgaVerification
  FirmwareUpgrade_startSSUpgrade
  FirmwareUpgrade_startSSVerification
  FirmwareUpgrade_startFrontUpgrade
  FirmwareUpgrade_startFrontVerification
  Video_takeSnapshot
  
  
• Known issues:
  • Some API functions are missing from ccsettingsconsole and CCAux2CS.

Version 2.4.7.0 - XM Linux platform

• XM: Improved fault-handling in function registerControlledSuspendOrShutDown()
  
  
• Known issues:
  • Same as 2.4.6.0 release

Version 2.4.6.0 - XA/XS platform

• XA/XS: Improve initialization of video channels 3/4
• XA/XS: Prevent scrolling when changing between video channels 3/4
• Calling Buzzer_buzze no longer leaks memory
  
  
• Known issues:
  • Same as 2.4.0.0 release (minus Buzzer_buzze memory leak)

Version 2.4.2.0 - XA/XS platform

• XA/XS: Config_get/setRS485Mode now uses settings file for intermediate storage
  
  
• Known issues:
  • Same as 2.4.0.0 release

Version 2.4.0.0 - XA/XS, XM platforms

• Removed the following functions: Config_get/set TFT Mode/Scan/Mirror
• Optimized version queries of different firmware components
• Bugfixes for Backlight and Lightsensor
• The factory defaults settings in CCsettings no longer generates errors
• CCSettings and StartupGUI rebranded for maximatecc
• CCSettings now adapts to the number of CAN ports available
• Added the following function blocks: Battery, PowerMgr and Smart from 1.x API
• XM: CCAux2 is now fully supported on the XM platform with the same functionality as in the 1.6.4.0 release.
• XM: CCAux api 1.6.4.0 will be available for backwards compability. It is compatible back to the 1.3.1.0 release.
• XA/XS: Config_setRS485Enabled now sets MP_RS422_MODE GPIO pins to correct state
• XA/XS: Video_setMirroring implemented
• XA/XS: Playing two video channels simultaneously now works (1/2+3/4)
• XA/XS: Video can be cropped from left/right for channels 3/4
• XA/XS: Various other improvements for video channels 3/4
• XA/XS: Video standard now reported correctly
• XA/XS: ccvideo context menu now appearing consistently
• XA/XS: ccvideo context menu hanging now fixed
• XA/XS: ccvideo blanking now fixed
• XA/XS: ccvideo now handles rotation
• XA/XS: ccsettingsconsole now up to date
• XA/XS: Context menu no longer opened while calibrating
• XA/XS: The PowerOnAtStartup setting ("Always start when power turned on" in CCsettings) was always read as Enabled
• XA/XS: 1V2 is now a supported ADC channel on some instances
• XA/XS: Added TS_TCHAUTOCAL in TouchScreen class
• ccauxd: Fixed issues that caused crash when shutting the daemon off
• ccauxd: Added support for PowerMgr
  
  
• Known issues:
  • XA/XS: When automatic backlight is enabled, updating SS or Front uC software is very slow and may fail. Workaround: Make sure automatic backlight is disabled before attempting to do any firmware upgrade.
  • XA/XS: CCSettings - Advanced: After Firmware update, the shutdown button does not work. Workaround: Turn off power to the device.
  • Some info/functions are missing from ccsettingsconsole
  • XA/XS: About_hasOsBooted can return true even when not all drivers have not been loaded (API)
  • XA/XS: Calling Buzzer_buzze in non-blocking mode leaks memory

Version 2.3.0.0 - XA/XS platform

• Functions added: Backlight_getHWStatus, Config_getRS485Enabled and Config_setRS485Enabled
• CCSettings: Led tab improved
• CCSettings: Hide unsupported options in Power tab
• CCSettings: Hide suspend options if unsupported by HW
• CCSettings: Fixed rotation glitches
• Bugfixes
  
  
• Known issues:
  • Same as 2.2.0.0 release

Version 2.2.0.0 - XA/XS platform

• Functions added: About_getIsAnybusMounted, Config_setTFTMode, Config_getTFTMode, Video_showFrame and About_getIOExpanderValue
• Fixed rotation issues with GUI applications
• Many bugfixes
  
  
• Known issues:
  • When automatic backlight is enabled, updating SS or Front uC software is very slow and may fail. Workaround: Make sure automatic backlight is disabled before attempting to do any firmware upgrade.
  • CCSettings - Advanced: After Firmware update, the shutdown button does not work. Workaround: Turn off power to the device.
  • Some info/functions are missing from ccsettingsconsole
  • About_hasOsBooted can return true even when not all drivers have not been loaded (API)
  • Calling Buzzer_buzze in non-blocking mode leaks memory
  • ccvideo: Rightclick (long press) menu not appearing consistently
  • Calling Video_showVideo for ports 3/4 will not return if no camera is attached
  • Cannot show analog video from two ports simultaneously (1/2+3/4), trying to do so leads to crash
  • For ports 3/4, video sometimes scrolls or has wrong size when starting the application first time
  • API calls for analog video currently not supported: get/setMirroring, get/setCropping (for ports 3/4), get/setDeInterlaceMode, get/setScaling, get/setColorKeys
  • ccvideo: Selecting "Mirror image" does not have an effect

Version 2.1.0.0 - XA/XS platform

• Functions added: Power_getVideoOCDStatus, Power_getCanOCDStatus and About_hasOsBooted
• Touch calibration can be started from CCSettings
• 7" touch calibration now supported
• Many bugfixes
  
  
• Known issues:
  • About_hasOsBooted can return true even when not all drivers have not been loaded
  • Analog video API only supports VIDEO1/2 ports
  • Video control only supports positioning and resizing
  • The factory defaults button in the Advanced tab in CCSettings produces some error messages. These can be ignored

Version 2.0.0.0 - XA/XS platform

• Initial release
• The CCAux API v1.x from the CCpilot XM platform has been rewritten to ensure compability between releases
• Porting to CCpilot XA/XS platform nearly complete. Some new platform specific functions remain to be implemented
• The API gives access to several hardware interfaces, for example backlight, buzzer, diagnostics, frontled, lightsensor and analog video interfaces
  
  
• Known issues:
  • Digital input/output does not work correctly
  • CAN settings interface does not work
  • Analog video API only supports VIDEO1/2 ports
  • Video control only supports positioning and resizing
  • SS/Front software update - sometimes crashes before update has begun. When this happens (segmentation fault or Open failed error), restart the unit and try again
  • Font issue in CCSettings causes some text to disappear
  • TouchCalibrator cannot be started from within CCSettings. Instead it can be started manually: # TouchCalibrator -qws
  • The factory defaults button in the Advanced tab in CCSettings produces some error messages. These can be ignored
  • Error messages related to automatic backlight will show the very first time the Display tab in CCsettings is opened. These can be ignored.
  • GetHWErrorStatusString functions do not return correct description of error messages

Known Issues

• XA/XS: Unsupported API calls for analog video: get/setDeInterlaceMode, get/setScaling, get/setColorKeys, get/setCropping (for ports 3/4)
• XA/XS: ccvideostream: de-interlacing artifacts with certain output window sizes