User's Manual

ManualsBrandsCASTLES TECHNOLOGY ManualsElectronicsPIN Pad

VEGA3000UltraLite

Book 2

User Manual

Confidential

Version1.1

Aug 2016

CASTLES TECHNOLOGY

Castles Technology Co., Ltd.

6F, No. 207-5, Sec. 3, Beixin Rd., XindianDistrict,

New Taipei City 23143, Taiwan R.O.C.

http://www.castech.com.tw

Summary of content (62 pages)

PAGE 1
CASTLES TECHNOLOGY VEGA3000UltraLite Book 2 User Manual Confidential Version1.1 Aug 2016 Castles Technology Co., Ltd. 6F, No. 207-5, Sec. 3, Beixin Rd., XindianDistrict, New Taipei City 23143, Taiwan R.O.C. http://www.castech.com.
PAGE 2
WARNING Information in this document is subject to change without prior notice. No part of this publication may be reproduced, transmitted, stored in a retrieval system, nor translated into any human or computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without the prior written permission of Castles Technology Co., Ltd. All trademarks mentioned are proprietary of their respective owners. Castles Technology Co., Ltd.
PAGE 3
Revision History Version Date Descriptions 1.0 Jul 12, 2016 Initial creation. 1.1 Aug 11,2016 Castles Technology Co., Ltd. 1. Add “2.2. Power Supply”. 2. Add “2.3. Environment”. Confidential • All Right Reserved. Pg.
PAGE 4
Contents 1. Introduction .................................................................................................................. 6 2. Hardware Setup............................................................................................................ 7 3. 2.1. Parts of the Surface ............................................................................................. 7 2.2. Power Supply ...........................................................................................
PAGE 5
6. 5.1. Loading New Font.............................................................................................. 48 5.2. Custom Font ...................................................................................................... 51 5.3. Using TrueType Font (TTF) ............................................................................... 59 FCC Warning .............................................................................................................. 61 FCC Caution ........
PAGE 6
1. Introduction This document provides a guideline on operating and configuringCastles VEGA3000UltraLite. The scope of this document includes setting up the terminal, basic operation, application life cycle, and some advance features. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 7
2. Hardware Setup 2.1. Parts of the Surface Front Side 10 1 5 4 2 7 8 6 3 9 VEGA3000 UltraLite 1. LCD Display (MonoColor) 6. OK /Enter Key 2. Keyboard 7. Up Key 3. Cancel Key 8. Down Key 4. 0 / Funtion Key 9. Clear Key 5. Contactless Card Landing 10. Contactless LED Zone Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 9
2.2. Power Supply   DC Input: 9V/1A USB: 5V/1A 2.3. Environment   Operating: 0℃~40℃,5% to 90% non-condensing Storage: -20℃~70℃ Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 10
3. Basic Operation 3.1. Program Manager Upon power on, terminal will enter Program Manager if not default application selected. All user applications are list in Program Manager. User may select an application and run the application or view the application info, delete the application or set to default run upon power on. User may enter System Menu to configure terminal settings. Program Manager Program Manager -----------01/02 1.App1 2.App2 0:Download  Press[0] button to enter System Menu.
PAGE 11
Page 2 System Menu 1.PWD Change 2.ShareobjMng 3.FontMng4.ULD KEY HASH 5.Plug-in Mng 6.Key Injection 7.HW Detect  Press [*] button to page1.  Press [#] button to page3. 3.2. Download AP Download user application or kernel modules firmware. System Menu System Menu 1.Download AP 2.System Info 3.Memory Status 4.Sys Settings 5.Test Utility 6.Factory Reset 7.Power Off  Press [1] button to enter Download AP menu. Download AP Menu Download EX 1.RS232 or USB 2.USB Disk 3.
PAGE 12
 Press [3] button to select source as SD card. 3.3. System Info View kernel module firmware information. System Menu System Menu 1.Download AP 2.System Info 3.Memory Status 4.Sys Settings 5.Test Utility 6.Factory Reset 7.Power Off  Press [2] button to enter System Info menu.
PAGE 13
Page 11 SYSTEM INFO --EXT SO Ver P.1-CAVAP:VR0002 CACQP:VR6601 CAIFH :VR0002 CAEMVL2 :VRA016 CAEMVL2AP :VR0009 3.4. Memory Status View terminal flash memory and RAM information. System Menu System Menu 1.Download AP 2.System Info 3.Memory Status 4.Sys Settings 5.Test Utility 6.Factory Reset 7.Power Off  Press [3] button to enter Memory Status menu. Memory Status Menu MEMORY STATUS --FLASH Memory-Total: 130688KB Used :52404KB --SDRAM Memory-Total: 65408KB Used :38004KB Castles Technology Co., Ltd.
PAGE 14
3.5. System Settings View or change terminal system settings. Setting Descriptions Key Sound Enable (Y) or disable (N) the beep sound when pressing any key. Exec DFLT AP Enable (Y) or disable (N) execution of default selected application. USB CDC Mode Enable (Y) or disable (N) USB CDC mode. FunKey PWD Enable (Y) or disable (N) password protection to access function key (0, F1, F2, F3) in Program Manager. PMEnter PWD Enable (Y) or disable (N) password protection to enter Program Manager.
PAGE 15
Halt Timeout Set timeout for AP to back to Program Manager whenever AP is in halt state. PWM Auto Enable (Y) or disable (N) power saving mode. PWM Mode Select (STB) standby mode or (SLP) sleep mode for power saving mode. PWM Time Set time period by which to make terminal getting into power saving mode from idle state. Auto Reboot Terminal will reboot in specific time every day. Reboot Hour The specific hour of day for Auto Reboot. Reboot Min The specific minuteof day for Auto Reboot.
PAGE 16
Page 5Page 6 SYS SETTINGS BT DIRECT ACCESS :X Halt Timeout :999 PWM Auto :N PWM Mode : X PWM Time SYS SETTINGS Auto Reboot :Y Reboot Hour:00 Reboot Min :00 1: Prev2: Next 1: Prev Page  Press [*] or [#]button to select setting.  Press [OK] button to change the setting value.  Press [] button to toggle Y  N  Y.  Press [1] button to previous page.  Press [2] button to next page. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 17
3.6. Test Utility Perform terminal hardware components diagnosis. System Menu System Menu 1.Download AP 2.System Info 3.Memory Status 4.Sys Settings 5.Test Utility 6.Factory Reset 7.Power Off  Press [5] button to enter Test Utility menu. Test Utility Menu Page 1 Main Menu 0023 1.LCD 2.Keyboard 3.Flash 4.Smart Card 5.Backlight 6.MSR -> 1/3  Press [1] and [OK] to diagnose LCD.  Press [2] and [OK] to diagnose keyboard.  Press [3] and [OK] to diagnose flash memory.
PAGE 18
 Press[7] and [OK] to diagnose LED.  Press [8] and [OK] to diagnose RTC.  Press [9] and [OK] to check Printer.  Press [10] and [OK] to check FONT file in VEGA3000 UltraLite.  Press [11] and [OK] to check CL transparent.  Press [12] and [OK] to test Cantactless Card.  Press [*] button to page 1.  Press [#] button to page 3. Page 2 Main Menu 0023 13.SD Card Test 14.Wi-Fi Test 15.Power Saving 16.Comm Menu 17.BT Test -> 3/3  Press [13] and [OK] to execute SD Card Test.
PAGE 19
3.7. Factory Reset Perform factory reset, all user application, fonts and data will be deleted. System Menu System Menu 1.Download AP 2.System Info 3.Memory Status 4.Sys Settings 5.Test Utility 6.Factory Reset 7.Power Off  Press [6] button to enter Factory Reset menu. FacRest Password Enter Password: ********  Enter password and press [OK].  Enter factory reset password.(Default password: 12345678) FacRestPassword New Password: ******** Confirm Password ********  Enter new password.
PAGE 20
 Press [OK] to execute the Factory Reset. 3.8. Power Off Power offterminal. System Menu System Menu 1.Download AP 2.System Info 3.Memory Status 4.Sys Settings 5.Test Utility 6.Factory Reset 7.Power Off  Press [7] button to power off terminal. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 21
3.9. Password Manager Change thekeysin Password Manager. System Menu (Page 2) System Menu 1.PWDManager 2.ShareobjMng 3.FontMng4.ULD KEY HASH 5.Plug-in Mng 6.Key Injection 7.HW Detect  Press [1] button to enterPasswordManagermenu. Password Manager 1.Function Key 2.PMEnter Key 3.KeyInject Key 4.Factory Key  Press [1] button to changeFunction Key password.  Press [2] button to change Program Manager Key password.  Press [3] button to change Key Injection Key password.
PAGE 22
FunKey Password New Password: ******** Confirm Password ********  Enter new password.  Enter new password again to confirm. User must have to change the Default key to user own key at the first time. The Default Key Value in Password Manager is as below: Castles Technology Co., Ltd. Function Key 84188062 PMEnter Key NA KeyInject Key 87654321 Factory Key 12345678 Confidential • All Right Reserved. Pg.
PAGE 23
3.10.Share Object Management View share object in terminal. System Menu (Page 2) System Menu 1.PWD Change 2.ShareobjMng 3.FontMng4.ULD KEY HASH 5.Plug-in Mng 6.Key Injection 7.HW Detect  Press [2] button to enter Share Object Management menu. Share Object Management Menu Share objMng 1.Share LIB 2.Share File  Press [1] button to view shared library.  Press [2] button to view shared file. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 24
3.11.Font Mng View Font Management. System Menu (Page 2) System Menu 1.PWD Change 2.ShareobjMng 3.FontMng4.ULD KEY HASH 5.Plug-in Mng 6.Key Injection 7.HW Detect  Press [3] button to view Font Management. FontManagment Font Mng 1.FNT File 2.TTF File  Press [1] button to view FNT Font list.  Press [2] button to view TTF Font list. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 25
3.12.ULD Key Hash View ULD user key hash value. System Menu (Page 2) System Menu 1.PWD Change 2.ShareobjMng 3.FontMng4.ULD KEY HASH 5.Plug-in Mng 6.Key Injection 7.HW Detect  Press [4] button to view hash value. USER ENV KEY DA9C91FE668DF4B6D637 CDBCCEC201444AA2C7FF USER SIGN KEY D52F36A1B569B5ABBA4F EAEFB34BEC000101D58C Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 26
3.13.Plug-in Mng View Plug-in Management. System Menu (Page 2) System Menu 1.PWD Change 2.ShareobjMng 3.FontMng4.ULD KEY HASH 5.Plug-in Mng 6.Key Injection 7.HW Detect  Press [5] button to view Plug-in Management. Plug-in Mng 1.Info 2.Del  Press [*]or[#]button to select item.  Press [1]button to get item information.  Press [2]button to delete item. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 27
3.14.Key Injection View Key Injection. System Menu (Page 2) System Menu 1.PWD Change 2.ShareobjMng 3.FontMng4.ULD KEY HASH 5.Plug-in Mng 6.Key Injection 7.HW Detect  Press [6] button to view Key Injection. KeyInjPassword Enter Password: ********  Enter password and press [OK].  Enter Key Injection password.(Default password: 87654321) KeyInj Password New Password: ******** Confirm Password ********  Enter new password.  Enter new password again to confirm.
PAGE 28
 Please refer to document of Key Injection which is released by Castles Technology. 3.15.HW Detect View Key Injection. HW TYPE Original HW-TYPE : C New HW-TYPE : C Please Any Key.  Press any key to go back to Program Manager. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 29
4. Secure File Loading Castles implemented an interface in terminal named User Loader(ULD) to provide secure file loading to system memory. Loading of user application, kernel firmware, font and others must use User Loader. The loading process is secure by signing the files using ULD Key System. 4.1. ULD Key System The ULD Key System uses two key sets for securely managing the kernel updating and application downloading. Each key set contains two RSA key pairs.
PAGE 30
updating, the kernel CAP files must be “signed” via ULD User Key to get the user permission. For simple expression, we call the kernel CAP files generated by the manufacturer as “unsigned kernel CAP(s)” and call the kernel CAP files “signed” by the user later as “signed kenel CAP(s)”. Notes: 1. The kernel modules are encrypted by a random-generated 3DES key, which is retrieved from the Key Encryption Block of the CAP by ULD Manufacturer Key Encryption Key, not directly encrypted by ULD RSA Key. 2.
PAGE 31
4.1.2. ULD User Key ULD User Key are used to encrypt and sign the user/shared applications. In addition, they are as goalkeepers to prevent the system updating without user permission. This is done by the kernel CAPs which are encrypted and signed by the manufacturer having to perform the “signed’ action via ULD User Keys.
PAGE 32
4.2. File Signing 4.2.1. Signing Kernel Module Castles will release new version of kernel module in “unsigned” form. This files required to sign with ULD User Key before it can load to terminal. Castles Technology provideds a tool named “CAP Signing Tool” to perform this task. The CAP Signing Tool is located at: C:\Program Files\Castles\VEGA3000UL\tools\Signing Tool  Run CAP Signing Tool (VEGA3000 UltraLite)  Insert Key Card and select smart card reader Castles Technology Co., Ltd.
PAGE 33
 Enter Key Card PIN  CAP Signing Tool is ready, press “Select MCI File” button to browse the file.  Output file will be located in “signed” folder. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 34
4.2.2. Signing User Files Following files are required to sign before load to terminal. This is to ensure the application data and codes confidential and integrity. The output file will be “CAP” file which is file format defined by Castles.  User application  User application data files  User application library  Font file  Share library  Share files  System setting  Key CAP (Manufacturer ULD Key Set) Castles Technology provided a tool named “CAP Generator” to perform this task.
PAGE 36
 CAP Generator is ready, select the correct Type from the list.  Press “Step 1: Select AP Executable File” to select file to sign. This is valid for all the files to sign. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 37
 Enter file details and press “Step 2: Sign Application” to sign the file. This is valid for all the files to sign.  The output file will be in a set. A “mci” file with one or more “CAP” files.CAP file contents the signed file binaries, where MCI file contents the list of CAP files. App.CAP App.mci Note: If user would like to load multiple set of signed file, create a new file with extension of “mmci”. Then put the mmci file contents with the list of mci file. MultiApp.mmci Castles Technology Co.
PAGE 38
4.3. File Loading There are several ways of loading file to VEGA3000 UltraLite.  Download by User Loader  Download by user application  Download by Castles TMS User Loader is a tool provided by Castles Technology. It’s the formal way to download file to terminal. User may implement their own ways of updating application or files using CTOS API provided, CTOS_UpdateFromMMCI(). Castles TMS (CTMS or CASTLES Terminal Management System) is provided by Castles Technology.
PAGE 39
 Select COM port  Browse and select mci file or mmci file  Setup terminal to enter download mode  Press [0] button in Program Manager (PM)  Press [1] button to select “1. Download AP“  Press [1] button again to select download via RS232 or USB Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 40
 Press “Download” button to start. Note: To download using USB cable, terminal must enable CDC mode. Set USB CDC Mode to Y. SYS SETTINGS Key Sound : Y Exec DFLT AP: Y -AP Name USB CDC Mode: Y FunKeyPWD : N PMEnterPWD : N 2: Next Page Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 41
4.4. Changing ULD User Key User may change their ULD User Key Set stored in Key Card. Castles Technology provided a tool named “Secure Key Generator” to perform this task.  Run Secure Key Generator  Insert Key Card and select smart card reader  Enter Key Card PIN, default PIN is “1234”. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 42
 To change Key Card PIN, press “Update PIN” button. If not, please skip this steps.  Enter new PIN, enter new PIN again to confirm, then press [Enter] button to change PIN in Key Card. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 44
 To generate new user key set  Please generate the RSA key by yourself,thelengthof the RSA key set should be 2048 (bits).  Copy RSA key components to RSA Key for Kenc in Secure Key Generator. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 46
 Click [Get Hash] button to calculate the hash value for key sets.  Please copy down all the values into a text file and keep in a safe place. You will need this if you need to create duplicate Key Card.  To generate the key CAP for the newly generated user key set, press [Make Key CAP File] button. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 47
 The output file will be located in the Secure Key Generator folder. SecureKeyGenerator key.mci key.cap  To update the newly generated key set to Key Card, press [Save to Card] button to write the key set to Key Card. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 48
5. Font Management 5.1. Loading New Font  Run FontManager.exe Located at C:\Program Files\Castles\Font Manager  Select font to download Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 49
 Press [Setting] button to configure terminal type.  Select VEGA5000, press [Save] button to save and return font manager.  Press [Generate] to create the font file. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 50
 Output file “Font.FNT” will be located at sub-directory named “Font” in “Font Manager” folder. Font Manager Font Font.FNT  Sign the file using CAP Generator, the type must set to “11 – Linux Font”.  Lastly, download the signed file (CAP file) to terminal using Loader. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 51
5.2. Custom Font User may create font they preferred for displaying or printing on terminal. There are two zone defined: Zone 0x00 ~ 0x7F – ASCII characters, you may replace with the font type preferred or your own language character set. Zone 0x80 ~ 0xFF – Free to use, you may use for symbols. Following steps demonstrate how to create a 12x24 font.  Run GLCD Font Creator  Select [File]  [New Font]  [Import An Existing System Font] Castles Technology Co., Ltd. Confidential • All Right Reserved.
PAGE 52
 Select the font needed, simply choose a font size. The final value of font size should be determine by the minimum pixel width. You may need to repeat this steps few times to find the best fit font size.  Set the import range from 0 to 127. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 53
 Check the minimum pixel width and height.  If the pixel width of the font size is larger than expected, then you have to repeat the previous steps to import font with smaller size.  Use the following buttons to adjust the font size to match with expected font size. Add columnonrigh t Removecolum nonleft Add column on left Removecolumn onright Add row on top Remove row on bottom Add row on bottom Castles Technology Co., Ltd. Remove row on top Confidential • All Right Reserved. Pg.
PAGE 55
 Remove comment “// Code for char “ from offset 0x00 to 0x1F. Remove empty line if found. Then click [Save] button to save to file. Remove Remove Remove Remove  Run Font Manager Tool.  Click [Setting] button Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 56
 Enter the file name, font id, and select the size.  Click [Create] button, and select the C file previously created using GLCD Font Generator. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
PAGE 58
 Use CAP Generator to conver the FNT file to CAP. Set type to [11 – Linux Font], press [Step 1] button select the FNT file. Then press [Step 2] to generate CAP file.  Download the font CAP file to terminal.  In terminal application, add following code to display message using the newly created font. CTOS_LanguageConfig(0xA000,d_FONT_12x24,0,d_FALSE); CTOS_LanguageLCDSelectASCII(0xA000); CTOS_LCDTPrintXY(1, 1, "ABCDEFGH"); Or print message using the newly created font.
PAGE 59
5.3. Using TrueType Font (TTF) TrueType Font (TTF) is supported in VEGA3000 UltraLite.You may download the TrueType font preferred to terminal for displaying or printing. Following steps demonstrate how to use “Cooper Black” TrueType font.  Copy the TTF file needed to a empty folder. TTF COOPBL.TTF  Use CAP Generator to conver the TTF file to CAP. Set type to [11 – Linux Font], press [Step 1] button select the TTF file. Then press [Step 2] to generate CAP file.
PAGE 60
 In terminal application, add following code to display message using the newly added font. CTOS_LCDTTFSelect("COOPBL.TTF", 0); CTOS_LCDFontSelectMode(d_FONT_TTF_MODE); CTOS_LCDTSelectFontSize(0x203C); // 32x60 CTOS_LCDTClearDisplay(); CTOS_LCDTPrintXY(1, 1, "Hello World"); Or print message using the newly added font. CTOS_PrinterTTFSelect("COOPBL.
PAGE 61
6. FCC Warning Federal Communication Commission interference statement.This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation.
PAGE 62
7.