CASTLES TECHNOLOGY VEGA3000 EFT-POS Book 2 User Manual Confidential Version1.0 Jan 2015 Castles Technology Co., Ltd. 2F, No. 205, Sec. 3, Beixin Rd., XindianDistrict, New Taipei City 23143, Taiwan R.O.C. http://www.castech.com.
Revision History Version Date Descriptions 1.0 May 27, 2014 Initial creation. 1.1 Jan 14, 2015 Add FCC Warning Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
Contents 1. Introduction .................................................................................................................. 5 1.1. 2. 3. Type of Terminal .................................................................................................. 5 Hardware Setup............................................................................................................ 7 2.1. Parts of the Terminal ...................................................................................
.2.1. Signing Kernel Module ........................................................................... 38 4.2.2. Signing User Files .................................................................................. 40 4.3. File Loading ....................................................................................................... 44 4.3.1. Download by User Loader ...................................................................... 44 4.3.2. Download by Removable Media ..........................
1. Introduction This document provides a guideline on operating and configuringCastles VEGA3000 terminal. The scope of this document includesetting up the terminal, basic operation, application life cycle, and some advance features. 1.1. Type of Terminal VEGA3000 terminal is portable type can be battery operated. Portable type is designed as two pieces of hardware, handset and base unit. Handset unit features major components, and also optional contactless reader, WiFi, GRPS modem.
To start up the terminal needs to press “Power Button” key after the adapter connected. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
2. Hardware Setup 2.1. Parts of the Terminal Front 10 9 1 7 2 4 5 3 6 8 VEGA3000 1. LCD Display (Color TFT) 7. Magnetic Stripe Reader 2. Privacy Shields 8. Smart Card Reader 3. Keyboard 9. Contactless Card Landing 4. Cancel Key 5. Clear Key Zone 10. Paper Roll Handle 6. Enter Key Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
Rear 12 13 11 14 17 18 15 16 VEGA3000 Rechargeable Battery VEGA3000 VEGA3000 11. RechargeableBattery Cover 12. Battery Cover Lock 13. Base Connector 14. SAM Slots 15. Micro SD Card Slot 16. GSM SIM Card Slots 17. RTC Battery 18. Battery Connector Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
Side 19 20 VEGA3000 Portable 19. Power Connector 20. USB Port Base (Portable) 21 23 29 24 25 26 27 28 22 21. Base Connector 26. Com port 1 22. Base LED 27. Modem - Line Port 23. Power Connector 28. Ethernet Port 24. Com port 3 29. Micro USB Port 25. Com port 2 Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
2.2. Inserting the Battery Step 1 Align Step 2 Step 1: Remove battery cover Step 2: Insert battery into compartment, battery contact point must align with batteryconnector. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
2.3. Inserting the SAM Card SAM2 SAM1 SAM4 SAM3 VEGA3000 Portable Step 1: Remove battery cover / back cover Step 2: Insert SAM card into desire slot. SAM 1 & 2: Gold contact at lower side of card and facing right. SAM 3 & 4: Gold contact at lower side of card and facing left. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
2.4. Inserting the Paper Roll Step 3 Step 2 Step 1 Step 1: Pulluppaper roll box handle. Step 2: Gentle open paper roll cover. Step 3: Insert paper roll as direction showed. Paper specification Width: 57mm Outside diameter: 40mm Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
2.5. Inserting the GSM SIM Card SIM1 SIM2 VEGA3000 Portable Step 1: Remove battery cover / back cover Step 2: Open SIM socket and insert GSM SIM card into desire slot. SIM 1 & 2: Gold contact at upper side of card and facing down. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
2.6. Inserting the Memory card Micro SD VEGA3000 Portable Step 1: Remove battery cover / back cover Step 2: Insert Micro SD memory card. Micro SD : Gold contact at lower side of card and facing right. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
2.7. Power Supply Specifications I/P: 9Vdc, 4A 2.8. Operating Ambient Temperature Range : 0° ~ 50° Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
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.
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 8.FK PWD Change 9.Share objMng Down: Next Page Press [1] button to enter Download AP menu. Download AP Menu Download EX 1.RS232 or USB 2.USB Disk 3.SD Card Select DW Source Select download source: Press [1] button to select source as RS232 or USB connection and enter ULD download mode.
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 8.FK PWD Change 9.Share objMng Down: Next Page Press [2] button to enter System Info menu.
Page 7 SYSTEM INFO -EXT SO Ver P.1 CRDLMDL : VR0100 CACLENTRY: VR0100 CAMPP: VR0300 CAVPM : VR0012 CAEMVL2 : VR0013 CAEMVL2AP: VR0004 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 8.FK PWD Change 9.Share objMng Down: Next Page Press [3] button to enter Memory Status menu.
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 ~ 3) in Program Manager. PMEnter PWD Enable (Y) or disable (N) password protection to enter Program Manager.
NTP Update Freq Frequency of Network Time Protocol updating. 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 8.FK PWD Change 9.Share objMng Down: Next Page Press [4] button to enter System Settings menu.
Page 2 SYS SETTINGS Mobil AutoON: N Bklit Auto Off:X Bklit Off Time: N PWR KEY OFF:N GDB Mode:X GDB Timeout: X ETHER IP/PORT RTC Time Zone :GMT NTP Enable:N NTP Update Freq:X 1:PrevPage Press [Power] 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.
3.6. Test Utility Perform terminal hardware components diagnostic. 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 8.FK PWD Change 9.Share objMng Down: Next Page Press [5] button to enter Test Utility menu.
Press [7] and [OK] button to diagnose LED. Press [8] and [OK] button to diagnose real time clock. Press [9] and [OK] button to diagnose printer. Press [1], [0]and [OK] button to view font. Press [1], [1] and [OK] button to diagnose contactless reader in transparent mode. Press [1], [2]and [OK] button to diagnose contactless card. Press [1], [3] and [OK] button to diagnose SD memory card. Press [1], [4] and [OK] button to test Wi-Fi. Press [.] button to next page.
Communication Test Menu Communicate 1. COM1 2. 3. Com3 4. Ethernet 5. USB 6. Modem 7. GPRS 8. All Test Com2 Test Test Test Test Test Press [1] button to diagnose Com 1. Press [2] button to diagnose Com 2. Press [3] button to diagnose Com 3. Press [4] button to diagnose Ethernet module. Press [5] button to diagnose USB. Press [6] button to diagnose modem. Press [7] button to diagnose GPRS. Press [8] button to diagnose all, from item 1 to 7. Castles Technology Co., Ltd.
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 8.FK PWD Change 9.Share objMng Down: Next Page Press [6] button to enter Factory Reset menu. Factory Reset Menu Factory Reset OK to reset ? Press [OK] button to perform factory reset. Factory Reset Password : **** Enter factory reset password.
3.8. Power Off Power off terminal. 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 8.FK PWD Change 9.Share objMng Down: Next Page Press [7] button to power off terminal. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
3.9. Function Key Password Change Change function key access password. 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 8.FK PWD Change 9.Share objMng Down: Next Page Press [8] button to enter FunKey Password menu. FunKey Password Menu FunKey Password Enter Password: **** Enter current password. (Default password is "0000") FunKey Password New Password: **** Confirm Password **** Enter new password.
3.10.Share Object Management View share object in terminal. 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 8.FK PWD Change 9.Share objMng Down: Next Page Press [9] 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.
3.11.CastlesTMS Connect to TMS (Terminal Management Software) server, set or delete TMS configuration. System Menu (Page 2) System Menu 1.Castles TMS 2.Font Mng 3.Debug Tools 4.ULD KEY HASH 5.HW Detect Up:Prev Page Press [1] button to enter Castles TMS menu. Castles TMS Menu CASTLES TMS 1.Connect Server 2.SetConfig 3.DelConfig Press [1] button to connect to TMS server. Press [2] button to set TMS configuration. Press [3] button to delete TMS configuration. Castles Technology Co., Ltd.
3.12.Font Mng View Font Management. System Menu (Page 2) System Menu 1.Castles TMS 2.Font Mng 3.Debug Tools 4.ULD KEY HASH 5.HW Detect Up:Prev Page Press [2] 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.
3.13.Debug Tools Perform the Debug Tools. System Menu (Page 2) System Menu 1.Castles TMS 2.Font Mng 3.Debug Tools 4.ULD KEY HASH 5.HW Detect Up:Prev Page Press [3] go to the Debug Tools Menu. Debug Tools Debug Tools 1.CoreDump 2.Debug Log Press [1] go get the Core Dump error from terminal. Press [2] go to the Debug Log Menu. Debug Log Debug Log 1.Upload 2.Clean All Press [1] get the Debug Log from the memory of terminal to SD card. Press [2] clean all the Debug Log from the SD card.
3.14.ULD Key Hash View ULD user keyset hash value. System Menu (Page 2) System Menu 1.Castles TMS 2.Font Mng 3.Debug Tools 4.ULD KEY HASH 5.HW Detect Up:Prev Page Press [4] button to view hash value. USER ENC KEY 9572BC621C1D5406 0856D00BCC207000 D3320077 USER SIGN KEY A927768EA7DD7B9E 7E3F395C10726B6F 43B35C5A Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
3.15.Hardware Detect View the hardware type of the termianl. System Menu (Page 2) System Menu 1.Castles TMS 2.Font Mng 3.Debug Tools 4.ULD KEY HASH 5.HW Detect Up:Prev Page Press [5] button to view the hardware type of the termianl. HW TYPE Qriginal HW-TYPE :MEGC New HW-TYPE :MEGC Please Any Key. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
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.
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. Tthe 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.
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.
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\VEGA3000\tools\Signing Tool Run CAP Signing Tool (VEGA3000) Insert Key Card and select smart card reader Castles Technology Co., Ltd.
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.
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 fille 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.
Insert Key Card and select smart card reader Enter Key Card PIN Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
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.
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.
4.3. File Loading There are several ways of loading file to VEGA3000terminal. Download by User Loader Download by removable media 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.
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.
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 SET USB Host: N Base USB CDC: X List SHR Lib: N Key MNG Mode: 0 Bat Threshld: X Null Cradle : X Debug Mode : N Debug Port : X 2: Next Page Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
4.3.2. Download by Removable Media The file download process can be achieved without PC by using removable media, USB flash drive or MicroSD memory card. We recommend don’t put unwantedfile to removable media, as it will increase the time during detection. Create a folder name “vxupdate” under root directory. root vxupdate Place the mci file and cap file to “vxupdate” folder. root vxupdate App.CAP App.
Insert removable media to terminal, and select the removable media type in “Download AP” menu. Download AP Menu Download EX 1.RS232 or USB 2.USB Disk 3.SD Card Select DW Source o Press [2] button to select USB flash drive. o Press [3] button to select MicroSD card. Finally, terminal will process the file “vxupdate” folder. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
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.
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.
To view current key set hash value, goto “Option” and select key. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
To generate new user key set Please generate the RSA key by yourself,thelength of 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.
Generate second RSA key set for Signature. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
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.
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.
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.
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.
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.
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.
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.
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.
After adjust font size, select [File] [Export for MicroElektronika]. Select output format as [mikroC]. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
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.
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.
Select [Font Manager] tab and tick the newly createdfont, and press [Generate] button to export to FNT file. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
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.
5.3. Using TrueType Font (TTF) TrueType Font (TTF) is only supported in VEGA5000S terminal.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.
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.
6. Technical Notes 6.1. Serial Cable PIN Assignment RJ12 6P6C Male Plug Castles Technology Co., Ltd. 1 ○ VCC 2 ○ TXD 3 ○ RTS 4 ○ RXD 5 ○ CTS 6 ○ GND VCC ○ 1 RXD ○ 2 TXD ○ 3 ○4 GND ○ 5 ○6 RTS ○ 7 CTS ○ 8 ○9 Confidential • All Right Reserved. RS232 Female Pg.
7. 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.