| SETUP(System) |
| Description |
| Set up the system. These parameters can be set at initialisation or at any time during operation by specifying the parameter to be changed. Example: SETUP( SYSTEM ){ bled=50; }. To change a setting use a dot operator as follows: LOAD( SYSTEM.bled, 50 ); |
| Syntax/Parameters |
|
Setup(System) { ... } |
| Options |
|
startup = all; display messages and progress bar at start up using startup=all or none or bar. bled = 100; set backlight to OFF=0 or ON=100 (1-99 brightness levels available v4 PCB, v32 firmware) wdog = 1000; set the watchdog time out period in milliseconds. rotate = 0; set the rotation of the screen with respect to PCB. This is stored in EEPROM for use with boot messages.(0, 90, 180 or 270) test = hide/showTouchAreas; hide or show touch areas during product development angles = degrees; select degrees or radians for calc functions encode = s, w, m; menu text strings can contain single byte ASCII (s), 2 bytes for UNIcode (w) or multibyte for UTF8 (m) calibrate = y; initialise the internal touch screen calibration screen. This automatically returns to the previous page on completion. If it is necessary to abort then send SETUP( SYSTEM ) {calibrate=n;} clkfreq = 92000000; Main external bus clock is changeable in 2MHz steps from 80MHz to 92MHz (default). ignore = allErrors; Ignores all errors and continues execution (only recommended in test as can cause undesired results - error messages are still sent from a serial port set to debug, ie rxi=d;). = invalidJpg; Ignores errors for unsupported JPG formats (eg progressive) and the image is skipped = imageTooBig; Ignores errors when there's not enough memory to load image and the image is skipped System Version The software and hardware versions can be read to a serial port or text variable. LOAD( RS2, VERS_IBOOT ); returns NAND bootloader version LOAD( RS2, VERS_ILOADER ); returns main loader version LOAD( RS2, VERS_IAPP ); returns main application version LOAD( RS2, VERS_IMODULE ); returns module name and version Startup Information - v42.00 Displaying of messages and progress at start up now configurable using SETUP(SYSTEM){startup=all|none|bar;} Word 'DEMO' changed to 'PROTO' in version message as this software is still not formally released. Touch Calibration - v47.24 Create your own calibration screen and store parameters in host. Touch Calibration points can now be set in system setup with user parameters. > To use: SETUP(system) { tch_loc_tlx = num; // Top Left Touch Point Location X tch_loc_tly = num; // Top Left Touch Point Location Y tch_val_tlx = num; // Top Left Touch Value X tch_val_tly = num; // Top Left Touch Value Y tch_loc_trx = num; // Top Right Touch Point Location X tch_loc_try = num; // Top Right Touch Point Location Y tch_val_trx = num; // Top Right Touch Value X tch_val_try = num; // Top Right Touch Value Y tch_loc_brx = num; // Bot Right Touch Point Location X tch_loc_bry = num; // Bot Right Touch Point Location Y tch_val_brx = num; // Bot Right Touch Value X tch_val_bry = num; // Bot Right Touch Value Y tch_loc_blx = num; // Bot Left Touch Point Location X tch_loc_bly = num; // Bot Left Touch Point Location Y tch_val_blx = num; // Bot Left Touch Value X tch_val_bly = num; // Bot Left Touch Value Y } > also supports load(system.tch_loc_tlx,num); etc.. Touch Calibration points can also be read > load(num,tch_loc_tlx); etc.. <- note "system." not used here The actual touch values are obtained by using TOUCHX and TOUCHY built in variables. Error Message Suppression - v49.00 Error messages can be ignored/suppressed for certain situations. SETUP( system ) { ignore=imageTooBig; // Ignores errors when there's not enough memory to load image and the image is skipped ignore=invalidJpg; // Ignores errors for unsupported JPG formats (eg progressive) and the image is skipped ignore=allErrors; // Ignores all errors and continues execution (only recommended in test as can cause undesired results). //No messages are displayed on the screen, though they are transmitted on a serial port set to debug. } Memory Usage Output - v49.00 A run-time memory allocation can be output of the diagnostic serial port by setting SETUP(system){test=showMemoryUse;}. Note, that the transmit buffer should be at least 32KB otherwise transmit data may be lost. The top location of RAM is 0x23FFFFFF. Test Flags - v49.04 SETUP(SYSTEM){test=showLoadInfo;} displays loading file / line information on start screen System Errors - v49.19 All system errors now allocated a fixed error number, which is displayed on the System Error Screen. Details of the last error can be found from the built-in entities: SYSERRNUM (S32) Error number SYSERRSRC (TXT64) Source of error (menu file name or port name) SYSERRPOS (S32) Error line number in source file (if applicable) SYSERRMSG (TXT128) Error message for given error number The variables maintain the last error information. An error function can be specified which is called when a system error occurs: SETUP(SYSTEM) { errFunc=funcName; } The system error will appear on the screen then the function will be called. The error screen is then cleared by tapping the touch screen. The error function should be kept simple, as functionality is restricted, such as enabling USB port to allow updates. If SETUP(SYSTEM) { ignore=allErrors; } is set then just the error function is called, no error screen is displayed and no touch is required. All errors are always sent to a port set to debug (rxi=d;) independent of the ignore or errFunc settings. Error information can be found on the website click here Screen Rotation - v49.25 Screen rotations of 0, 90, 180 and 270 degrees fully supported. Use, for example, SETUP(SYSTEM){rotate=90;} at start of tuXXXa.mnu file. The value is stored in EEPROM and used to orientate boot messages etc on next boot. Also boot startup messages centralised and rotated. nandboot.bin V00.27 iuloader.bin V00.38 Touch Screen Calibration - Manual Save & Status - v49.37 * Added option to save manual touch calibration figures to EEPROM, either SETUP(SYSTEM) { tch_val_tlx = 123; ... tch_val_bly = 345; touchSave = eeprom; // or "none" for no storage } or, LOAD(SYSTEM.touchSave,eeprom); * Added system parameter calFunc which is called when calibration is started and finished. Reading TCH_CAL value will indicate what stage the calibration is at. SETUP(SYSTEM){calFunc=myFunc;} FUNC(myFunc){LOAD(RS2,TCH_CAL);} LOAD(SYSTEM.calibrate,y); > myFunc will run when calibration page is shown - TCH_CAL value = 255 (calibrating) > myFunc will run when calibration finished and previous page shown - TCH_CAL value = 1 (done) > TCH_CAL value = 0 when touch is not calibrated. * Added additional retry mechanisms for saving/retrieving values from EEPROM. Storage of cal figures, screen rotate, and start up text in file: tu480a.cfg - v49.47 * To use the NAND config file for settings, add useCfg=y; to system setup, SETUP(SYSTEM) { useCfg=y; } * File is named tuXXXa.cfg, where XXX is module size 320, 480, 640, 800. The file is stored in NAND in the "LIB" area. * Typical Config File contents (note parameter values are all numeric within the file): usecfg=1; // Use config file: 0=no, 1=yes sbled=100; // Start-up back light level: 0 to 100 wdog=-1; // Watchdog: -1 unset, 0 off, 1-16000 time ms rotate=0; // Screen rotate: 0, 90, 180, 270 startup=3; // Start-up: 0=none, 1=text, 2=bar, 3=text+bar tch_loc_tlx=19; // Touch - TL x location tch_loc_tly=19; // Touch - TL y location tch_loc_trx=459; // Touch - TR x location tch_loc_try=19; // Touch - TR y location tch_loc_brx=459; // Touch - BR x location tch_loc_bry=251; // Touch - BR y location tch_loc_blx=19; // Touch - BL x location tch_loc_bly=251; // Touch - BL y location tch_val_tlx=87; // Touch - TL x value tch_val_tly=912; // Touch - TL y value tch_val_trx=928; // Touch - TR x value tch_val_try=905; // Touch - TR y value tch_val_brx=912; // Touch - BR x value tch_val_bry=131; // Touch - BR y value tch_val_blx=84; // Touch - BL x value tch_val_bly=132; // Touch - BL y value * Changes made by SETUP(SYSTEM){} and LOAD(SYSTEM.param,val); will modify the file. * Following touch screen calibration, the calibration parameters will be stored to the config file. * The new file is compared with the file stored in NAND and only overwritten if different to save NAND write cycles. * When a RESET(NAND); or RESET(NANDLIB); is issued, the config file is preserved by reading file into memory, erasing NAND, writing the config file back to NAND. * A RESET(FACTORY); will erase the config file. * Parameters are read from EEPROM initially and then overwritten by parameters from the config file. * If an EEPROM is not fitted, then useCfg will default to y. Start-up backlight level ''sbled'' - v49.47 * A start-up backlight can be specified. SETUP(SYSTEM) { sbled = 100; // Values 0 to 100 } * This value is used as the default level rather than the current 100% value. * Value is also stored in EEPROM and used for boot-up screens. New boot code created: nandboot.bin V00.31 iuloader.bin V00.43 |
| Example |
|
SETUP( SYSTEM ) { bled=100; wdog=100; rotate=0; calibrate=n; test=showTouchAreas; angles=degrees; startup=all; encode=s; clkfreq=92000000; } |
This part of the website is under development. If you are unable to find what you are looking for please refer to our previous website.
