CASTLES TECHNOLOGY UPT1000 Book 2 User Manual Confidential Version 1.1 Jan. 2017 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.
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.
Revision History Version Date Descriptions Author 1.0 Dec 19, 2016 Initial creation. Jeff 1.1 Jan 11, 2017 Add “7. Appinex” and “7.1 Cautions”. Jeff Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
Contents 1. Introduction .................................................................................................................. 6 2. Hardware Setup............................................................................................................ 7 3. 2.1. Parts of the UPT1000 .......................................................................................... 7 2.2. Communication Support .....................................................................................
4.3.2. Download by Removable Media ............................................................. 42 4.4. 5. 6. Font Management ...................................................................................................... 51 5.1. Loading New Font.............................................................................................. 51 5.2. Custom Font ...................................................................................................... 54 5.3.
1. Introduction This document provides a guideline on operating and configuring Castles UPT1000 . The scope of this document includes setting up the UPT1000, basic operation, application life cycle, and some advance features. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
2. Hardware Setup 2.1. Parts of the UPT1000 Front 10 9 1 8 7 6 2 5 4 3 UPT1000 1. LCD Display (Color TFT) 7. Cancel Key 2. Keypad 8. Magnetic Stripe Reader 3. Smart Card Reader 9. Contactless Card Landing 4. Enter Key 5. Return Key (RFU) Zone 10. LED indicator 6. Clear Key Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
Rear 11 18 12 17 13 14 16 15 UPT1000 11. USB port 1~3 12. MDB (power connector) 13. RS232 port 1~3 14. BT antenna socket 15. GPRS antenna socket 16. GSM SIM Card Slots 1~2 17. SAM Card Slots 1~4 18. LAN port 2.2. Communication Support 1. 2. 3. 4. Ethernet BT UMTS 850/1900 GPRG 850/1900 Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
3. Basic Operation 3.1. Program Manager Once the power is on in normal status, UPT1000 will enter Program Manager if no default application selected. All user applications are listed in Program Manager. Users can select an application and run the application, view the application info, delete the application, or set application to the default one to run once the power is on. Users may enter System Menu to configure UPT1000 settings. Program Manager Program Manager -----------01/02 1.App1 2.
Page 2 System Menu 1.FK PWD Change 2.Share obj Mng 3.Embedded TMS 4.Font Mng 5.Debug Tools 6.ULD KEY HASH 7.HW Detect Press [↑] button to page1. Press [↓] button to page3. Page 3 System Menu 1.BluetoothSetup 2.Plug-in Mng 3.Key Injection Press [↑] button to page2. 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.
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. Press [2] button to select source as USB disk. Press [3] button to select source as SD card. (Not support) 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.
Page 4 SYSTEM INFO ----- SOVer----UART :VR0017 USBH :VR0011 MODEM :VR0019 ETHERNET :VR0035 FONT :VR0032 LCD :VR0042 Page 8 SYSTEM INFO --- HWMVer --CRDL/ETHE:ONCHIP CLM-MP : N/A --- APVer --ULDPM :VR0036 Page 5 Page 6 SYSTEM INFO ---- SO Ver2 --PRT :VR0025 RTC :VR0013 ULDPM :VR0029 PPPMODEM :VR0031 KMS :VR0032 FS :VR0016 Page 9 SYSTEM INFO --- SO Ver3 --GSM :VR0029 BARCODE :VR0013 TLS :VR0014 CLVW :VR0024 CTOSAPI :VR0039 Page 10 SYSTEM INFO HUSBID:0CA6A050 CUSBID:N/A --Factory S/N--FFFFFFFFFFFFFFFF S
3.5. System Settings View or change 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” in Program Manager. PMEnter PWD Enable (Y) or disable (N) password protection to enter Program Manager.
NTP Enable Enable (Y) or disable (N) NTP (Network Time Protocol) function. NTP Update Freq Frequency of Network Time Protocol updating. Halt Timeout Set timeout of AP to get 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 to make machine enter power saving mode from idle state. BAT PROTECT MODE Set battery protect mode.
Page 5 Page 6 SYS SETTINGS RTC Time Zone : GMT NTP Enable : N NTP Update Freq : X SYS SETTINGS Halt Timeout : PWM Auto : PWM Mode : PWM Time : BAT PROTECT MODE : 1: Prev 1: Prev Page 2: Next 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. 0 X X X X Pg.
3.6. Test Utility Perform 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 9123 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 2 Main Menu 9123 7.LED 8.RTC 9.Printer 10.Font 11.CL Transparent 12.CL Card Test -> 2/3 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 UPT1000. 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 3 Main Menu 9123 13.SD Card Test 14.Wi-Fi Test 15.Power Saving 16.
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 OK to reset? Press [OK]. FacRest Password Enter Password: **** Enter password and press [OK]. Enter factory reset password.(Default password: 8418) Castles Technology Co., Ltd.
FacRestPassword Enter Password: **** Erasing… Start erasing, and then go back to Program Manager. 3.8. Power Off Power off the machine. 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 the machine. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
3.9. FK PWD Change Change the keyin password. System Menu (Page 2) System Menu 1.FK PWD Change 2.Share obj Mng 3.Embedded TMS 4.Font Mng 5.Debug Tools 6.ULD KEY HASH 7.HW Detect Press [1] button to enter Password Manager Menu. FunKey Password Enter Password: **** Enter current password. (Default password is "0000") FunKey Password New Password: **** Confirm Password **** PWD Changed OK Enter new password. Enter new password again to confirm.
3.10. Share Object Management View share object in machine . System Menu (Page 2) System Menu 1.FK PWD Change 2.Share obj Mng 3.Embedded TMS 4.Font Mng 5.Debug Tools 6.ULD KEY HASH 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 libraries. Press [2] button to view shared files. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
3.11. Embedded TMS TMS (Terminal Managerment System) setting menu. System Menu (Page 2) System Menu 1.FK PWD Change 2.Share obj Mng 3.Embedded TMS 4.Font Mng 5.Debug Tools 6.ULD KEY HASH 7.HW Detect Press [3] button to enter TMS setting menu. CASTLES TMS CASTLES TMS 1.Connect Server 2.System Config 3.Reset Config 4.CompatibleConfig Press [1] button to connect server. Press [2] button to enter system config menu. Press [3] button to reset config.
3.12. Font Mng View Font Management. System Menu (Page 2) System Menu 1.FK PWD Change 2.Share obj Mng 3.Embedded TMS 4.Font Mng 5.Debug Tools 6.ULD KEY HASH 7.HW Detect Press [4] 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 Get core dump or debug log. System Menu (Page 2) System Menu 1.FK PWD Change 2.Share obj Mng 3.Embedded TMS 4.Font Mng 5.Debug Tools 6.ULD KEY HASH 7.HW Detect Press [5] button to enter Debug Tools menu. Debug Tools Debug Tools 1.Core Dump 2.Debug Log Press [1] button to enter core dump menu. Press [2] button to enter debug log menu. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
3.14. ULD Key Hash View ULD user key hash value. System Menu (Page 2) System Menu 1.FK PWD Change 2.Share obj Mng 3.Embedded TMS 4.Font Mng 5.Debug Tools 6.ULD KEY HASH 7.HW Detect Press [6] button to view hash value. USER ENV KEY DA9C91FE668DF4B6D637 CDBCCEC201444AA2C7FF USER SIGN KEY D52F36A1B569B5ABBA4F EAEFB34BEC000101D58C Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
3.15. HW Detect Run hardware detection. System Menu (Page 2) System Menu 1.FK PWD Change 2.Share obj Mng 3.Embedded TMS 4.Font Mng 5.Debug Tools 6.ULD KEY HASH 7.HW Detect Press [7] button to run HW detection. HW TYPE Original HW-TYPE : EGCB New HW-TYPE : EGCB Please Any Key. Press any key to reboot system. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
3.16. Bluetooth Setup Setup Bluetooth config. System Menu (Page 2) System Menu 1.Bluetooth Setup 2.Plug-in Mng 3.Key Injection Press [1] button to enter Bluetooth setting menu. Bluetooth Setup Bluetooth Setup 1.Handset BT Setup 2.Cradle CH Setup Press [1] button to enter Handset BT Setup menu. Press [2] button to enter Cradle CH Setup menu. Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
3.17. Plug-in Mng View Plug-in Management. System Menu (Page 2) System Menu 1.Bluetooth Setup 2.Plug-in Mng 3.Key Injection 4.TP Calibration Press [2] button to view Plug-in Management. Plug-in Mng 1.Bluetooth :V9116 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.
3.18. Key Injection Key Injection function. (Factory use only.) System Menu (Page 3) System Menu 1.Bluetooth Setup 2.Plug-in Mng 3.Key Injection Press [3] button to view Key Injection. Key Injection Waiting for Command Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
4. Secure File Loading Castles implemented an interface 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 kennel 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.
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 UPT1000. Castles Technology provides a tool named “CAP Signing Tool” to perform this task. The CAP Signing Tool is located at: C:\Program Files\Castles\UPT1000\tools\Signing Tool Run CAP Signing Tool Insert Key Card and select smart card reader Castles Technology Co., Ltd. Confidential • All Right Reserved. Pg.
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 UPT1000. This is to ensure the application data and codes confidential and integrity. The output file will be “CAP” file which format is 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 UPT1000. 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 UPT1000. 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 UPT1000 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, UPT1000 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.
4.3.2. Download by Removable Media The file download process can be achieved without PC by using removable media, USB flash drive. 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.mci Note: If user would like to load multiple application, create a new file with extension of “mmci”.
Insert removable media to UPT1000, 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. (Not support) Finally, UPT1000 will process the file in “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,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.
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 the 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 UPT1000 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 UPT1000. 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. Pg.
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 convert 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 UPT1000. In the 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 supported in UPT1000. You can download the TrueType font to UPT1000 for displaying or printing. Following steps demonstrate how to use “Cooper Black” TrueType font. Copy the TTF file needed to an empty folder. TTF COOPBL.TTF Use CAP Generator to convert 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. Download the font CAP file to UPT1000.
In the 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. Appendix 7.1. Cautions Federal Communication Commission Interference Statement This device complies with Part 15 of the FCC Rules. Operation is subject to the following two conditions: (1) This device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. 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.