Metrologic Optimus R Programming Manual Download

Page: 1 / 241

Printed on 20 March, 2006

"C" Programming Guide

Version 3.04.02

Optimus S
Optimus R

Summary of Contents for Optimus R

Page 1: ...Printed on 20 March 2006 C Programming Guide Version 3 04 02 Optimus S Optimus R...

Page 2: ...is confidential between the Company and the client and remains the exclusive property of the Company If you find any problems in the documentation please report them to us in writing The Company does...

Page 3: ...12 2 4 C Compiler 12 2 4 1 Size of Types 13 2 4 2 Representation Range of Integers 13 2 4 3 Floating Types 14 2 4 4 Alignment 14 2 4 5 Register and Interrupt Handling 14 2 4 6 Reserved Words 14 2 4 7...

Page 4: ...3 8 LCD 80 3 8 1 Properties 81 3 8 2 Cursor 84 3 8 3 Display 87 3 8 4 Clear 92 3 8 5 Image 94 3 9 Fonts 96 3 9 1 Font Size 96 3 9 2 Display Capability 96 3 9 3 Multi Language Font 97 3 9 4 Special Fon...

Page 5: ...h 221 4 3 String Functions string h 222 4 3 1 Functions start with str 222 4 3 2 Functions start with mem 223 4 4 Mathematical Functions math h 224 4 5 Utility Functions stdlib h 226 4 5 1 Number Con...

Page 6: ......

Page 7: ...es a concise introduction about the C Compiler and the development flow for applications which provides step by step description in developing application programs for the portable data terminals with...

Page 8: ...2 C Programming Guide For Optimus S R...

Page 9: ...contains six directories namely BIN ETC INCLUDE LIB README and USER The purposes and contents of each directory are listed below To set up the C language development environment on your PC you may cr...

Page 10: ...via RS 232 IrDA Cradle IR or TCP IP 2 1 2 ETC It contains help and version information of the C Compiler 2 1 3 INCLUDE It contains header files C header files for standard library routines assert h ct...

Page 11: ...ust for the compiler to locate all necessary files set tmp C tmp This is the temporary working directory for the compiler and linker for memory and file swapping Skip this if tmp is already specified...

Page 12: ...6 C Programming Guide For Optimus S R The flow is illustrated as shown below...

Page 13: ...ME C This batch file invokes the C compilation program which in turn calls many other executable programs under the BIN directory As these programs are invoked by the compiler sequentially their usage...

Page 14: ...ograms are successfully compiled into relocatable object files the linker must be used to create the absolute objects and then the file can be downloaded to the target machine s flash memory for execu...

Page 15: ...andard library User could provide suitable values to the following variables MainStackSize 0x001000 HeapSize 0x000100 MaxSysRamSize 0x020000 Do not modify anything beyond this line memory IRAM org 0x0...

Page 16: ...f_area RAM data org org code sizeof code addr org area sizeof area f_data global variables with initial values xcode org org data sizeof data addr addr data sizeof data f_xcode code reside on RAM RAM_...

Page 17: ...rg icode sizeof icode f_const f_tail ROM ActualRamSize addr xcode sizeof xcode 3 4 4 0x205000 long boundary SysRamEnd org area MaxSysRamSize long boundary DataRam addr data XCodeRam addr xcode ICodeRa...

Page 18: ...d if no error is found 2 3 5 Download Program to Flash Memory Now that the Motorola S format object file FILENAME shx is created successfully it can be downloaded to the flash memory for testing Run t...

Page 19: ...SCHAR_MIN minimum value of signed char type SCHAR_MAX maximum value of signed char type CHAR_MIN minimum value of char type CHAR_MAX maximum value of char type UCHAR_MAX maximum value of unsigned cha...

Page 20: ...and is fixed to 1 for all types In invoking the C compiler driver XA1 XD1 XC1 and Xp1 is specified 2 4 5 Register and Interrupt Handling Register and interrupt handling are possible through C However...

Page 21: ..._ _DMAS2 _ _DMAS3 _ _DMAD0 _ _DMAD1 _ _DMAD2 _ _DMAD3 _ _DMAC0 _ _DMAC1 _ _DMAC2 _ _DMAC3 _ _DMAM0 _ _DMAM1 _ _DMAM2 _ _DMAM3 _ _NSP _ _XNSP _ _INTNEST 2 4 8 Bit Field Usage The following types can b...

Page 22: ...t bits Little endien If the base type of a bit field member is a type requiring two bytes or more e g unsigned int the data is stored in memory after its bytes are turned upside down Different types d...

Page 23: ...Chapter 2 Development Environment 17 Different types signed unsigned Different types same size...

Page 24: ...18 C Programming Guide For Optimus S R...

Page 25: ...library routines as well as the declaration of the system variables can be found in the library header file lib_ops h or lib_opr h It is assumed that the programmer has prior knowledge of the C langu...

Page 26: ...Sixteenth 2 Eighth 3 Quarter 4 Half 5 Full Return None CheckWakeUp Optimus S Purpose To check the wakeup event Syntax int CheckWakeUp void Example event CheckWakeUp Description This routine checks on...

Page 27: ...le SetPwrKey 1 enable the POWER key for waking up the terminal Description The parameter mode is set to one of the following values POWER_KEY_DISABLE 0 The POWER key is disabled POWER_KEY_ENABLE 1 The...

Page 28: ...de For Optimus S R system_restart Purpose To restart the system Syntax void system_restart void Example system_restart Description This routine simply jumps to the Power On Reset point and restarts th...

Page 29: ...all disabled Reader ports all disabled Keypad scanning enabled LCD initialized and cleared to blank cursor is on and set to the upper left corner 0 0 Calendar initialized LED off Allocate stack area a...

Page 30: ...m to automatically shut down the user s program whenever there is no operation during the preset period When it is set to 0 the AUTO_OFF function will be disabled extern unsigned int POWER_ON This var...

Page 31: ...ls By default it is set to 1 i e 3 seconds 1 3 sec 2 8 sec 3 12 sec 4 16 sec 5 20 sec 6 25 sec 7 30 sec 8 40 sec extern int BC_X BC_Y These two variables govern the location of the battery icon i e on...

Page 32: ...attery charging events For the Optimus S it is possible to wake up the terminal by one of the following pre defined events PwrKey_WakeUp when the POWER key is pressed Alarm_WakeUp when the alarm time...

Page 33: ...e current system information is displayed Note The Kernel Menu is launched by pressing three keys simultaneously 1 7 and the POWER key Step 2 Press down 1 7 for approximately 3 seconds Step 3 Type the...

Page 34: ...nalSerialNumber SerialNumber FontVersion Purpose To get version information of font file Syntax void FontVersion void Example printf FONT s FontVersion Description By default the version information w...

Page 35: ...lso DeviceType FontVersion GetRFmode KernelVersion KeypadLayout LibraryVersion ManufactureDate NetVersion OriginalSerialNumber SerialNumber KernelVersion Purpose To get version information of kenel Sy...

Page 36: ...ptimus R lib_opr lib Return It always returns a pointer indicating where the information is stored See Also DeviceType FontVersion GetRFmode HardwareVersion KernelVersion KeypadLayout ManufactureDate...

Page 37: ...ntax void OriginalSerialNumber void Example printf S N s OriginalSerialNumber Description This routine gets the original serial number of the terminal Note that if the original serial number is it mea...

Page 38: ...whether the system password is enabled or not By default the System Menu is not password protected Return If enabled it returns 1 Otherwise it returns 0 i e no password required See Also CheckSysPass...

Page 39: ...ting Enter it returns 1 If input is cancelled by hitting ESC it returns 0 See Also CheckPasswordActive CheckSysPassword SaveSysPassword SaveSysPassword Purpose To save or change the system password Sy...

Page 40: ...name Otherwise it will be named as Unknown automatically This file name may be changed by rename if necessary A program in the file system can be loaded to the Program Manager flash memory by calling...

Page 41: ...RAM Syntax int DownLoadProgram char filename int comport int baudrate char filename pointer to a buffer where filename of the program is stored int comport COM1 or COM2 for transmission int baudrate a...

Page 42: ...ar programtype pointer to a buffer where program type is stored char programname pointer to a buffer where program name is stored Example val ProgramInfo 2 typebuffer namebuffer Description This routi...

Page 43: ...h memory the new program will replace the old one Otherwise it will be stored in an automatically assigned residence location Return If successful it returns the residence location of program i e slot...

Page 44: ...ter not included The original program resided in the active area will then be replaced by the new program While replacing the program the POWER key is disabled to protect the system If successful this...

Page 45: ...Decode function can be called in the program loops to perform barcode decoding Below are four global variables related to the barcode decoding routines These variables are declared by the system and t...

Page 46: ...EAN 8 with Addon 2 78 N Italian Pharmacode 66 B EAN 8 with Addon 5 79 O CIP 39 67 C EAN 13 80 P Industrial 25 68 D EAN 13 with Addon 2 81 Q Interleave 25 69 E EAN 13 with Addon 5 82 R Matrix 25 70 F M...

Page 47: ...talian Pharmacode 0 5 1 Enable CIP 39 0 Disable CIP 39 0 4 1 Enable Industrial 25 0 Disable Industrial 25 0 3 1 Enable Interleave 25 0 Disable Interleave 25 0 2 1 Enable Matrix 25 0 Disable Matrix 25...

Page 48: ...lepen Numeric 2 0 1 Enable RSS14 Limited 0 Disable RSS14 Limited 3 7 1 Enable RSS14 Expanded 0 Disable RSS14 Expanded 3 6 1 Enable RSS14 0 Disable RSS14 3 5 1 Transmit RSS14 Code ID 0 DO NOT transmit...

Page 49: ...ansmit Italian Pharmacode Check Character 5 2 1 Transmit CIP 39 Check Character 0 DO NOT transmit CIP 39 Check Character 5 1 1 Verify Interleave 25 Check Digit 0 DO NOT verify Interleave 25 Check Digi...

Page 50: ...cd abcd 01 abcd tn e 10 ABCD ABCD 11 ABCD TN E 7 3 1 Transmit Codabar Start Stop Character 0 DO NOT transmit Codabar Start Stop Character 7 2 0 Reserved 8 7 0 Reserved 9 7 6 MSI Check Digit Verificati...

Page 51: ...NOT transmit UPCE System Number 10 0 1 Transmit UPCA System Number 0 DO NOT transmit UPCA System Number 11 7 1 Convert EAN 8 to EAN 13 0 No conversion 11 6 Reserved 11 5 1 Enable GTIN 0 Disable GTIN...

Page 52: ...de Length Fixed Length 1 17 7 0 Matrix 25 Min Code Length Fixed Length 2 18 7 1 MSI 25 Code Length Limitation in Max Min Length Format 0 MSI 25 Code Length Limitation in Fixed Length Format 18 6 0 MSI...

Page 53: ...l to define a scan mode that best suits the requirements of a specific application If necessary set the 22nd byte for timeout duration ON OFF Scan Mode Always Press trigger once Hold trigger Press tri...

Page 54: ...The reader is always scanning but only one decoding is allowed for the same barcode That is to read i e scan and decode the same barcode multiple times the barcode must be re approached for new scanni...

Page 55: ...3 Terminal Specific Function Library 49 Test mode The reader is always scanning for testing purpose Comparing to the Continuous mode it will decode repeatedly even with the same barcode without re app...

Page 56: ...ter a successful reading the same data will be re transmitted without actually reading the barcode Such re transmission can be activated as many times as needed as long as the time interval between ea...

Page 57: ...Chapter 3 Terminal Specific Function Library 51 Momentary mode Hold down the scan trigger to start scanning The scanning continues until the trigger is released...

Page 58: ...52 C Programming Guide For Optimus S R Alternate mode Press the scan trigger to start scanning The scanning continues until the trigger is pressed again...

Page 59: ...ct barcode will be scanned Press the scan trigger to aim at a barcode Within one second press the trigger again to decode the barcode The scanning continues until one of the events happens 1 A barcode...

Page 60: ...R Laser mode This mode is most often used on laser scanners Hold down the scan trigger to start scanning The scanning continues until one of the events happens 1 A barcode is read 2 The preset timeou...

Page 61: ...Function Library 55 Auto Off mode This is the default mode The reader will start to scan once the scan trigger is pressed The scanning continues until one of the events happens 1 A barcode is read 2...

Page 62: ...tart to scan once the scan trigger is pressed The scanning continues until one of the events happens 1 The preset timeout expires Comparing to the Auto Off mode the reader continues to scan whenever t...

Page 63: ...And integer variable CodeLen as well as the character variable CodeType will reflect the length and code type of the decoded data respectively Return If successful it returns an integer whose value e...

Page 64: ...58 C Programming Guide For Optimus S R Description The scanner port will not work unless it is initialized Return None See Also Decode HaltScanner1...

Page 65: ...unsigned char WedgeSetting 3 This unsigned character array governs the operation of the SendData routine 3 3 1 Definition of the WedgeSettingArray Subscriptor Bit Description 0 7 0 KBD Terminal Type...

Page 66: ...002 8A 003 8A 5 PCAT SV 26 IBM 3477 TYPE 4 6 PCAT NO 27 PS2 30 7 PCAT UK 28 Memorex Telex 122 Keys 8 PCAT BE 29 PCXT 9 PCAT SP 30 IBM 5550 10 PCAT PO 31 NEC 5200 11 PS55 A01 1 32 NEC 9800 12 PS55 A01...

Page 67: ...though the auto detection setting is enabled To enable Capital Lock Auto Detection add 128 to the value of the second element of the WedgeSetting array 3 3 4 Capital Lock Status Setting In order to se...

Page 68: ...user is sure about the selection 3 3 7 Shift Capital Lock Keyboard This setting can force the SendData routine to treat the keyboard type to be a shift lock keyboard or a capital lock keyboard This s...

Page 69: ...ng 2 10 3 3 10 Composition of Output String The keyboard wedge character mapping is shown below Each character in the output string is translated by this table when the SendData routine transmits data...

Page 70: ...ombination status key after sending the next character For example to send A Ctrl Insert 5 scan code 0x29 Tab 2 Shift Ctrl A B Alt 1 Alt 2 Break Alt 1 Alt 3 the following characters are inserted into...

Page 71: ...d Example if WedgeReady SendData CodeBuf Description Before sending data via keyboard wedge it is recommended to check if the cable is well connected otherwise the transmission may be blocked Return I...

Page 72: ...how the beeper is activated It comprises a number of pairs of beep frequency and duration Each pair is one beep When the value of the beep duration is set to 0 it means the end of a beeper sequence i...

Page 73: ...ption This routine checks if there is a beeper sequence in progress Return If beeper sequence is undergoing it returns 1 Otherwise it returns 0 See Also off_beeper on_beeper play off_beeper Purpose To...

Page 74: ...st char song 0x31 10 0x32 10 0x33 10 0x34 10 0x35 10 0x36 10 0x37 10 0x41 10 0x31 4 0x32 4 0x33 4 0x34 4 0x35 4 0x36 4 0x37 4 0x41 4 0x00 0x00 play song Description This routine is similar to on_beepe...

Page 75: ...tem time variable sys_msec and sys_sec is maintained by CPU timers and has nothing to do with this calendar chip Accuracy of these two time variables depends on the CPU clock and is not suitable for p...

Page 76: ...he calendar chip Syntax int set_time char new_time char new_time Example set_time 20050805125800 AUGUST 5 2005 12 58 00 Description This routine sets new date and time new_time to the calendar chip ne...

Page 77: ...date time and the string terminator The format of the system date and time is YYYYMMDDhhmmss Return None See Also SetAlarm SetAlarm Optimus S Purpose To set the alarm time Syntax void SetAlarm char ne...

Page 78: ...nt duration duration in units of 10 milli second Example set_led LED_RED LED_FLASH 50 set red LED to flash for each 1 second cycle Description This routine sets the LED operation mode The value of the...

Page 79: ...fy the type as the last parameter There are two types CHK_EXC 1 exclusive checking only the keys being pressed match the keys specified will the function return 1 CHK_INC 2 inclusive checking as long...

Page 80: ...Key d pressed c else printf No key pressed Description This routine can be used with menu operation to detect a shortcut key being pressed Return If successful it returns the character read from the k...

Page 81: ...key click Example SetKeyClick 1 enable key click sound Description There are five different tones available You can choose a tone from the System Menu or through programming Moreover the frequency and...

Page 82: ...ault the input mode is numeric and can be modified by the ALPHA key If the ALPHA key is disabled by dis_alpha this routine is used to enable it If the ALPHA key is locked by LockAlphaState this routin...

Page 83: ...is_alpha en_alpha LockAlphaState get_alpha_lock_state Purpose To get information of the ALPHA state for input mode either locked or unlocked Syntax int get_alpha_lock_state void Example state get_alph...

Page 84: ...lock Purpose To set the ALPHA state for input mode Syntax void set_alpha_lock int state int state input mode that can be modified by ALPHA key Example set_alpha_lock 1 upper case alpha mode ALPHA key...

Page 85: ...of the FN function key Return The return value can be 0 3 See Also SetFuncToggle SetFuncToggle Optimus R Purpose To set the state of the FN function key Syntax void SetFuncToggle int state int state F...

Page 86: ...oid Example DecContrast Description This routine decreases the LCD contrast by one level each time it is called and the minimum value is 0 Return None See Also GetContrast IncContrast SetContrast GetC...

Page 87: ...the maximum value is 7 Return None See Also DecContrast GetContrast SetContrast lcd_backlit Purpose To set the LCD backlight Syntax void lcd_backlit int state int state LCD backlight state Example lcd...

Page 88: ...urn None See Also DecContrast GetContrast IncContrast SetVideoMode Purpose To set the display mode of the LCD Syntax void SetVideoMode int mode int mode video mode reverse or normal Example SetVideoMo...

Page 89: ...his routine checks the cursor indication on the LCD i e whether it is visible On or not Off Return If visible it returns 1 Otherwise it returns 0 See Also SetCursor gotoxy Purpose To move the cursor t...

Page 90: ...tine retrieves the x coordinate of the current cursor position Return It returns the x coordinate See Also wherexy wherey wherexy Purpose To get the x coordinate and y coordinate of the current cursor...

Page 91: ...Chapter 3 Terminal Specific Function Library 85 Description This routine retrieves the y coordinate of the current cursor position Return It returns the y coordinate See Also wherex wherexy...

Page 92: ...CON_ZONE int mode int mode 1 for printing enabled 0 for printing disabled default Example ICON_ZONE 1 Description The icon zone refers to an area on the LCD that is reserved for showing status icon su...

Page 93: ...codes embedded in the format specification format To print values of C variables a format specification must be embedded in format for each variable to be printed The format specification for each va...

Page 94: ...o x or X see below non zero output values are prefixed with 0 0x or 0X respectively Type Expected Input c d i o u x X s Single character Signed decimal integer Signed decimal integer Octal digits wit...

Page 95: ...g hourglass on the LCD Syntax void WaitHourglass int UppLeftX int UppLeftY int type int UppLeftX x coordinate of the upper left corner of the hourglass int UppLeftY y coordinate of the upper left corn...

Page 96: ...ers can show custom icons in this area by using the show_image function When calling clr_scr to clear the screen this icon zone won t be cleared Therefore if you need to erase the icon zone you have t...

Page 97: ...ion Return None See Also fill_rect clr_scr Purpose To clear everything on the LCD Syntax void clr_scr void Example clr_scr Description This routine clears contents of the current screen and places the...

Page 98: ...pper left corner of the rectangle int top y coordinate of the upper left corner of the rectangle int width width of the rectangle in dots int height height of the rectangle in dots unsigned char pat p...

Page 99: ...on This routine displays the bitmap pattern from a buffer pat to a rectangular area on the LCD whose top left position and size are specified by left top width and height The cursor position is not af...

Page 100: ...ont file is downloaded to the terminal Font Files Custom Font Size SetFont Options System font default N A FONT_6X8 FONT_8X16 Multi language font file N A FONT_6X8 FONT_8X16 Single byte Others He Nd P...

Page 101: ...racters must be determined by SetFont either 6x12 or 12x12 Otherwise the characters cannot be displayed properly CheckFont Purpose To check which font file resides in the flash memory Syntax int Check...

Page 102: ...s call The value of the parameter font depends on the current font and its available font size options It can be one of the following FONT_6X8 6x8 graphic dots per character FONT_8X16 8x16 graphic dot...

Page 103: ...ys change this setting in the System Menu The value of the parameter setting with code page specified can be one of the following 0x10 English_437 English default 0x11 French_863 Canadian French 0x12...

Page 104: ...12 5 lines Font_OP_Korean shx Font size 16x16 4 lines Font_OP_Simplified_Chinese shx Font size 16x16 4 lines Font_OP_Simplified_Chinese12 shx Font size 6x12 or 12x12 5 lines Font_OP_Traditional_Chines...

Page 105: ...scription This routine checks the charging progress of the main battery Return The return value can be one of the following CHARGE_STANDBY Not connected to any external power CHARGING The battery is b...

Page 106: ...gramming Guide For Optimus S R Example bat1 get_vbackup Description This routine reads the voltage level of the backup battery in units of mV Return It returns the voltage reading milli volt See Also...

Page 107: ...se read and write the data via different interfaces RS 232 Serial IR IrDA or Bluetooth SPP DUN 3 11 2 Receive Transmit Buffers Receive Buffer A 256 byte FIFO buffer is allocated for each port The data...

Page 108: ...n None See Also com_overrun close_com Purpose To terminate communication and disable a specified COM port Syntax int close_com int port int port COM port to be closed Example close_com 2 close COM 2 D...

Page 109: ...ers through a specified COM port Syntax int nwrite_com int port char s int count int port COM port to be used char s string to be sent out int count number of characters to be sent Example char s Hell...

Page 110: ...MMAND Bluetooth Setting 0x00 0x03 0x04 BT SPP Slave BT SPP Master BT DUN BT_SERIALPORT_SLAVE BT_SERIALPORT_MASTER BT_DIALUP_NETWORKING Example open_com 1 0x0b open COM 1 to 38400 8 data bits no parity...

Page 111: ...ns 0 to indicate the buffer is empty See Also nwrite_com write_com SetCommType Purpose To set the communication type of a specified COM port Syntax int SetCommType int port int type int port COM port...

Page 112: ...tring Hello n through COM 1 Description This routine sends a string through a specific COM port If any prior transmission is still in progress it will be terminated and then the current transmission r...

Page 113: ...200 76800 57600 38400 19200 9600 4800 2400 Data Bits 7 or 8 Parity Even Odd or None Stop Bit 1 Flow Control None Flow Control To avoid data loss three options of flow control are supported and done by...

Page 114: ...ion is enabled Then every character received is examined to see if it is normal data or flow control codes If an XOFF is received transmission is halted It is resumed later when XON is received Just l...

Page 115: ...he direct RS 232 port Return If asserted it returns 1 i e mark Otherwise it returns 0 i e space See Also com_rts com_rts Optimus R Purpose To set RTS level Syntax void com_rts int port int val int por...

Page 116: ...PPP Connection via RS 232 It is supported on the Optimus R only when being connected to a generic modem direct RS 232 PPP Connection Practice Follow the same programming flow of WLAN 802 11b Practice...

Page 117: ...Chapter 3 Terminal Specific Function Library 111 Bluetooth ops_ppp lib or ops_bnep lib Batch opr_ppp lib Bluetooth opr_ppp lib or opr_bnep lib Optimus R 802 11b opr_ppp lib or opr_wlan lib...

Page 118: ...o a library file such as opr_wlan lib opr_bnep lib ops_wlan lib and ops_bnep lib This file should be specified in the link file of user program It will ask the linker program to search for the TCP IP...

Page 119: ...N IEEE 802 11b Terminal 8061 8360 8071 8370 Access Point 3560 3570 WLAN stands for IEEE 802 11b PAN stands for Personal Area Networking Profile of Bluetooth SPP stands for Serial Port Profile of Bluet...

Page 120: ...tically fallback from 11 Mbps to 5 5 2 or 1 Mbps as range increases or signal quality decreases 802 11b Specification Frequency Range 2 4 2 5 GHz Data Rate 11 5 5 2 1 Mbps auto fallback Connected Devi...

Page 121: ...e commands as for 802 11b TCP IP networking Dial Up Networking Profile DUN makes use of a Bluetooth modem or mobile phone as a wireless modem Bluetooth Specification Frequency Range 2 4 2 5 GHz Data R...

Page 122: ...cture and are saved in the system They are kept by the system during normal operations and power on off cycles These parameters can be accessed through the System Menu or an application program via Ge...

Page 123: ...DhcpEnable unsigned char IpAddr 4 unsigned char SubnetMask 4 unsigned char DefaultGateway 4 unsigned char DnsServer 4 char DomainName 129 char LocalName 33 char SSID 33 int SystemScale WLAN_FLAG Flag...

Page 124: ...l host name By default it shows the serial number of terminal char SSID 33 Null Service Set ID or AP name which is used for Remote Device association int SystemScale 2 Access Point Density determines...

Page 125: ...e can be used at a time 802 11b or PAN Parameter Bit Default Description WLAN PAN unsigned int Authen 0 1 0 Share Key 1 Open System unsigned int Wep 1 0 0 WEP Key disable 1 WEP Key enable unsigned int...

Page 126: ...Fail do OSTimeDly 10 GetNetStatus ns while ns IPReady Description This routine gets the whole network configurations from the system It is useful when the application wants to change more than one par...

Page 127: ...e writes the whole network configurations to the system Before writing the application should make sure that every setting is significant The best way is calling GetNetConfig first to get the original...

Page 128: ...er Default Description Index char BTRemoteName 20 Null ID used for Remote Device association 25 unsigned char BTPINCode 16 Null PIN Code for pairing usually in Slave mode 27 unsigned char BTLinkKey 16...

Page 129: ...1 unsigned int Reservedflag 13 BT_FLAG Parameter Bit Default Description Index unsigned int BTPWRSaveON 0 1 Bluetooth Power saving 0 disable 1 enable 29 unsigned int BTSecurity 1 0 Bluetooth Security...

Page 130: ...ey 16 BTSearchInfo size 51 bytes Parameter Default Description unsigned char Machine 0 Host profile indication 0 empty 1 AP 3 SPP 4 DUN If bit 7 1 it means the device is currently connected unsigned c...

Page 131: ...Return None See Also GetNetParameter SetBTConfig SetBTConfig Purpose To write the whole Bluetooth configurations to the system Syntax void SetBTConfig BTCONFIG config Example Description This routine...

Page 132: ...e 20 unsigned char LoginPassword 20 int ComBaudRate PPPCONFIG Parameter Default Description Index unsigned char DialUpPhone 20 Null Phone number of ISP 70 unsigned char LoginName 20 Null Login user na...

Page 133: ...ned char 14 9 P_WEPKEY_2 unsigned char 14 10 P_WEPKEY_3 unsigned char 14 11 P_DHCP_ENABLE int 12 P_AUTHEN_ENABLE unsigned int 13 P_WEP_LEN int 14 P_SYSTEMSCALE int 15 P_DEFAULTWEPKEY int 16 P_DOMAINNA...

Page 134: ..._DEVICE1 BTSearchInfo 41 P_BT_FREQUENT_DEVICE2 BTSearchInfo 42 P_BT_FREQUENT_DEVICE3 BTSearchInfo 43 P_BT_FREQUENT_DEVICE4 BTSearchInfo 44 P_BT_FREQUENT_DEVICE5 BTSearchInfo 45 P_BT_FREQUENT_DEVICE6 B...

Page 135: ...IP 4 DhcpEnable 1 SetNetParameter void DhcpEnable P_DHCP_ENABLE if NetInit 0 printf Initialization Fail do OSTimeDly 10 GetNetStatus ns while ns IPReady GetNetParameter void IP P_LOCAL_IP printf IP d...

Page 136: ...SetNetParameter void DhcpEnable P_DHCP_ENABLE if NetInit 0 printf Initialization Fail do OSTimeDly 10 GetNetStatus ns while ns IPReady GetNetParameter void IP P_LOCAL_IP printf IP d d d d IP 0 IP 1 I...

Page 137: ...e called again Note Any previous network connection and data will be lost after calling NetClose NetInit Purpose To perform TCP IP networking initialization Syntax int NetInit void int NetInit unsigne...

Page 138: ...t Bluetooth PAN NetInit NetInit Bluetooth DUN GPRS NetInit 3 NetInit 3 PPP via IR NetInit 4 NetInit 4 NetInit 4 PPP via RS 232 NetInit 5 NetInit 5 Return If successful it returns 0 On error it returns...

Page 139: ...ucture and the system will periodically update it Note User program must explicitly call CheckNetStatus to get the latest status WLAN 802 11b Status NETSTATUS Structure struct NETSTATUS int State int...

Page 140: ...ps 5 int IPReady Terminal IP Status for both WLAN and Bluetooth 1 0 1 Error Not Ready Ready 6 Note IPReady is used for both WLAN 802 11b and Bluetooth GetNetStatus Purpose To retrieve information on 8...

Page 141: ...on State 0 1 BT_DISCONNECTED BT_CONNECTED 7 int Signal RSSI Signal Level 10 6 6 5 over 5 Weak Moderate Strong 8 int Reserved 10 Reserved Null GetBTStatus Purpose To retrieve information on Bluetooth n...

Page 142: ...or PAN DUN1 refers to Bluetooth DUN for connecting a modem DUN2 refers to Bluetooth DUN GPRS for activating a mobile s GPRS Index Remarks WLAN SPP DUN1 DUN2 PAN 0 WLAN_State 1 WLAN_Quality 2 WLAN_Sign...

Page 143: ...hcpEnable 1 SetNetParameter void DhcpEnable P_DHCP_ENABLE if NetInit 0 printf Initialization Fail while CheckNetStatus NET_IPReady OSTimeDly 10 GetNetParameter void IP P_LOCAL_IP printf IP d d d d IP...

Page 144: ...connection Syntax int Nclose int conno int conno the connection to be closed Example Nclose conno Description This routine closes a previously established connection The connection number conno is a...

Page 145: ...ip 230 145 22 4 if conno Nopen remote_ip TCP IP Nportno 2000 0 0 printf Fail to connect to Host s r n remote_ip Description This routine is used for both active and passive opens The behavior is deter...

Page 146: ...ilable to be read or until a timeout occurs The timeout can be adjusted using socket_rxtout The application can avoid this blocking behavior by using socket_hasdata to make sure there is data availabl...

Page 147: ...e following cases Case 1 In TCP four packets have been sent but never get any ACK The protocol stack will try to resend the packets until it times out i e 8 seconds The application can avoid this situ...

Page 148: ...relevant structures please refer to the header file for terminal specific library Connection oriented Protocol TCP For a connection oriented socket such as SOCK_STREAM it provides full duplex connect...

Page 149: ...nal Specific Function Library 143 Connectionless Protocol UDP For a connectionless message oriented socket datagrams can be sent to and received from a specific connected peer using sendto and recvfro...

Page 150: ...name int size_of_name listen_socket socket PF_INET SOCK_STREAM TCP if listen_socket 0 printf SOCKET allocation failed memset local_name 0 sizeof local_name local_name sin_family AF_INET local_name sin...

Page 151: ...inal socket remains in the listening state and can be used in a subsequent call to this routine to provide additional connections Note that this is a blocking function This routine will not return unl...

Page 152: ...an use getsockname to learn the address and port that has been assigned to it If it is other than 0 this routine will verify this information against the actual local IP address of the local terminal...

Page 153: ...zeof name name sin_family AF_INET name sin_port htons 3000 phostent gethostbyname server1 Metrologic com tw if phostent printf Can not get IP from DNS server memcpy name sin_addr phostent h_addr_list...

Page 154: ...flags arg is ignored F_SETFL Set descriptor status flags to arg Depending on the value of cmd it can take an additional third argument arg Return If successful it returns a non negative value dependi...

Page 155: ...renced by name This routine gets the IP address of the specified host from DNS server The IP address of DNS server must be specified when calling SetNetConfig Or it can be automatically retrieved from...

Page 156: ...if the buffer provided is too small Return If successful it returns 0 On error it returns 1 The global variable errno is set to indicate the error condition encountered See Also connect getsockname g...

Page 157: ...ocket level Level at which the option resides SOL_SOCKET IPPROTO_TCP or IPPROTO_IP optname Socket option for which the value is to be retrieved optval Pointer to the buffer in which the value for the...

Page 158: ...ed option is returned in the optval buffer The integer pointed to by optlen should originally contain the size of this buffer on return it will be set to the size of the value returned Return If succe...

Page 159: ...ocket Purpose To provide controls on the I O mode of a socket Syntax int ioctlsocket int fildes int request Example Description This routine manipulates the underlying device parameters of special fil...

Page 160: ...edged and queued pending acceptance by the accept process This routine is typically used by servers that can have more than one connection request at a time If a connection request arrives and the que...

Page 161: ...socket The flags argument allows one of the following values MSG_OOB returns urgent data out of bound data MSG_PEEK returns data but do not remove it from buffer allowing it to be read again on subseq...

Page 162: ...s MSG_OOB returns urgent data out of bound data MSG_PEEK returns data but do not remove it from buffer allowing it to be read again on subsequent calls If from is not a null pointer the source address...

Page 163: ...he requested operation It returns the total number of ready descriptors in all the sets The descriptor sets are stored as bit fields in arrays of integers The following are provided for manipulating s...

Page 164: ...outgoing data to a specified send buffer buf on a connected socket The flags argument allows one of the following values MSG_OOB sends urgent data out of bound data MSG_DONTROUTE sends data using dire...

Page 165: ...g behavior by using socket_cansend to make sure there is data available before calling sendto The whole data may not be sent at one time Check the return value in case the send buffer overflows Return...

Page 166: ...ation SO_REUSEADDR Enables local address reuse SO_KEEPALIVE Enables keep connections alive SO_DONTROUTE Enables routing bypass for outgoing messages SO_BROADCAST Enables permission to transmit broadca...

Page 167: ...on encountered See Also closesocket socket Purpose To create a socket that is bound to a specific service provider Syntax SOCKET socket int domain int type int protocol domain Protocol family this sho...

Page 168: ...the communication domain in which communication is to take place The allowed combination of type and protocol parameters are as follows type protocol SOCK_STREAM TCP Stream socket SOCK_DGRAM UDP Data...

Page 169: ...turns the value of conversion Otherwise See Also ntohl htons Purpose To convert an unsigned short integer from host byte order to network byte order Syntax unsigned htons unsigned val unsigned val an...

Page 170: ...order Return If successful it returns the value of conversion Otherwise See Also htonl ntohs Purpose To convert an unsigned short integer from network byte order to host byte order Syntax unsigned nto...

Page 171: ...ways returns the port number See Also Nopen DNS_resolver Purpose To get the remote IP address by remote name Syntax int DNS_resolver const char remote_host char remote_ip const char remote_host remote...

Page 172: ...len buf Nwrite conno buf strlen buf Description This function checks if the amount of data byte count specified by len can be written out immediately to the connection specified conno Return If okay i...

Page 173: ...har ipaddr int conno connection number char ipaddr pointer to IP address returned Example unsigned char ip 4 socket_ipaddr conno ip printf Remote IP d d d d r n ip 0 ip 1 ip 2 ip 3 Description This fu...

Page 174: ...function will send an empty packet to the remote end to avoid such problem TCP only Return If successful it returns 0 On error it returns a negative value See Also socket_noblock Purpose To set the co...

Page 175: ...ve status for a connection Syntax int socket_rxstat int conno int conno connection number Example val socket_rxstat conno Description The function gets the receive status for a connection Return The r...

Page 176: ...ets the socket status for a connection Return The return value can be one of the following ESTABLISHED 1 SYN_SENT 2 SYN_RECEIVED 3 LISTEN 4 CLOSING 5 See Also socket_rxstat socket_txstat socket_testfi...

Page 177: ...socket_txstat conno Description The function gets the transmit status for a connection Return The return value can be one of the following S_PSH 0x01 push S_FIN_SENT 0x08 FIN has been sent S_FIN_ACKED...

Page 178: ...tion DUN mode Only one device is listed for quick connection PAN mode Up to eight access points are listed for roaming purpose Once the pairing procedure is completed and the list is generated success...

Page 179: ...character stands for the string of MAC ID The next property after MAC ID is Device Name which consists of up to 20 characters and ends with a delimiter code r The next property after Device Name is P...

Page 180: ...o specify the first three fields Otherwise the PIN code field needs to be specified for generating Link Key Inquiry Inquiry is used to discover other Bluetooth devices within range BTInquiryDevice Pur...

Page 181: ...intf Find d devices in range Result Rst BTPairingTest Info 0 BTSerialPort if Rst printf Pair OK else printf Pair Fail Description This routine tries to pair with one Bluetooth device with matching typ...

Page 182: ...clude lib_ops h include ucos h static const MENU_ENTRY PAIRING_ENTRY static const MENU_ENTRY DEVICELIST_ENTRY MENU SPP_MENU 2 1 0 Bluetooth void PAIRING_ENTRY void DEVICELIST_ENTRY static const MENU_E...

Page 183: ...luetooth device Once pairing successfully the MAC ID of this remote device will be updated to the Frequent Device List Return None See Also BTPairingTest FreqDevListMenu FreqDevListMenu Purpose To cre...

Page 184: ...5 NetInit 5 Network Status Once the initialization process is done the status of the network status can be retrieved from the system It will be periodically updated by the system The application progr...

Page 185: ...n for other useful functions Close a Connection Call Nclose to terminate a particular connection i e conno returned by Nopen when the application program does not use it any more Termination of Networ...

Page 186: ...if com_eot 2 break OSTimeDly 4 Call write_com and read_com to transmit and receive data respectively Call com_eot to detect if connection is broken For example if com_eot 2 printf Connection break Cal...

Page 187: ...of DUN GPRS must be specified Parameter Default Description Index P_ BT_GPRS_APNAME 20 Null Name of Access Point for Bluetooth DUN GPRS 32 Wedge Emulator The program Serial to Keyboard Converter is a...

Page 188: ...de lib_opr h include ucos h static const int beep 32 5 0 0 main SetCommType 2 COMM_RF Add WEDGE_EMULATOR flag to open_com open_com 2 BT_SERIALPORT_SLAVE WEDGE_EmULATOR clr_scr gotoxy 0 0 printf Virtua...

Page 189: ...scr gotoxy 0 0 printf Virtual Wedge gotoxy 0 1 printf gotoxy 0 2 printf Ready gotoxy 0 3 printf Press a key to start gotoxy 0 4 printf on_beeper beep while getchar OSTimeDly 4 while 1 if getchar SendD...

Page 190: ...tures will be further discussed later in this section 3 14 1 File System On each terminal there is an on board SRAM for data memory This is the place where all the system parameters program variables...

Page 191: ...en use the file handle to identify the file 3 14 5 Error Code A system variable fErrorCode indicates the result of the last file operation A value other than zero indicates error Note The error code c...

Page 192: ...currently exist in the system read_error_code Purpose To get the value of the global variable fErrorCode Syntax int read_error_code void Example if read_error_code 2 puts File not exist n Description...

Page 193: ...e of the file to be renamed char new_filename new file name desired Example if rename data1 text1 puts data1 is renamed n Description This routine changes the file name specified by the argument old_f...

Page 194: ...ax int append int fd char buffer int count int fd file handle of the target DAT file char buffer pointer to a buffer where data is written to int count number of bytes to be written Example append fd...

Page 195: ...itten to the file Writing of data starts at the end of file position and the file pointer position is unaffected by the operation This routine will automatically extend the file size to hold the data...

Page 196: ...le error codes and their interpretation Error Code Interpretation 2 File specified by fd does not exist 4 File specified by fd is not a DAT file 7 Invalid file handle 8 File not opened 10 No free file...

Page 197: ...le size automatically Return If successful it returns the number of bytes actually removed from the file On error it returns 1 An error code is set to the global variable fErrorCode to indicate the er...

Page 198: ...AT file 7 Invalid file handle 8 File not opened See Also delete_top eof Purpose To check if the file pointer of a DAT file reaches the end of file Syntax int eof int fd int fd file handle of the targe...

Page 199: ...7 Invalid file handle 8 File not opened lseek Purpose To reposition the file pointer of a DAT file Syntax long lseek int fd long offset int origin int fd file handle of the target DAT file long offset...

Page 200: ...greater than zero used to identify the file for subsequent file manipulation on the file If the file specified by filename does not exist it will be created first If filename exceeds eight characters...

Page 201: ...is set to the global variable fErrorCode to indicate the error condition encountered Below are possible error codes and their interpretation Error Code Interpretation 2 File specified by fd does not...

Page 202: ...specified by fd does not exist 4 File specified by fd is not a DAT file 7 Invalid file handle 8 File not opened 9 The value of max_count is negative See Also read write writeln tell Purpose To get th...

Page 203: ...omatically extend the file size to hold the data written The maximum number of characters that can be written is 32767 Return If successful it returns the number of bytes actually written to the file...

Page 204: ...uring operation this routine will automatically extend the file size to hold the data written Return If successful it returns the number of bytes actually written to the file including the null charac...

Page 205: ...u where the book is actually stored As you can see the books kept in the library are analogous to the data records stored in the DBF file and the various index entries are just its associate IDX files...

Page 206: ...not a DBF file 7 Invalid file handle 8 File not opened 10 No free file space for adding members See Also create_DBF delete_member close_DBF Purpose To close a DBF file and its associated IDX files Syn...

Page 207: ...th greater than member_len will be truncated to fit in User defined indexes may be created after the DBF file is created Return If successful it returns the file handle On error it returns 1 An error...

Page 208: ...error codes and their interpretation Error Code Interpretation 2 File specified by DBF_fd does not exist 4 File specified by DBF_fd is not a DBF file 6 Cannot create file Because it is beyond the maxi...

Page 209: ...er from a DBF file Syntax int get_member int DBF_fd int key_number char buffer int DBF_fd file handle of the target DBF file int key_number key no of the IDX file whose pointer points to the target me...

Page 210: ...alue in an IDX file key_number which is associated to a DBF file DBF_fd If there is a complete match to the key_value the index pointer will point to the first of all matches In case there is more tha...

Page 211: ...e value of origin can be one of the three values 1 the first index of IDX file 0 current index pointer position 1 the last index of IDX file Return If successful it returns the sequence number of offs...

Page 212: ...le if fd open_DBF data1 0 puts data1 is opened n Description This routine opens a DBF file filename and gets the file handle of it A file handle is a positive integer greater than zero used to identif...

Page 213: ...le if a report is to be generated by the sequence of date department and ID number and the date and department data may be repeated This can be done by rebuilding the ID number index first Then rebuil...

Page 214: ...DBF_fd file handle of the associated DBF file int key_number key number of the IDX file to be deleted Example if remove_index DBF_fd 1 puts index is removed n Description This routine deletes an IDX...

Page 215: ...lobal variable fErrorCode to indicate the error condition encountered Below are possible error codes and their interpretation Error Code Interpretation 2 File specified by DBF_fd does not exist 4 File...

Page 216: ...e possible error codes and their interpretation Error Code Interpretation 2 File specified by DBF_fd does not exist 4 File specified by DBF_fd is not a DBF file 7 Invalid file handle 8 File not opened...

Page 217: ...nk 0xF60000 0xF6FFFF for data storage such as the application settings The rest banks are available for storing user programs as well as font files Because the flash memory is non volatile it needs to...

Page 218: ...yte See Also RamSize WriteFlash Purpose To write data to the flash memory Syntax int WriteFlash void target_addr void source_addr unsigned long size Example char szData 100 EraseSector 0xF60000 WriteF...

Page 219: ...See Also RamSize init_free_memory Purpose To initialize the file space in SRAM Syntax void init_free_memory void Example init_free_memory Description This routine first tries to identify how many SRA...

Page 220: ...214 C Programming Guide For Optimus S R See Also FlashSize free_memory...

Page 221: ...s to suppress the download submenu For example DownLoadPage NO_MENU COMM_DIRECT BAUD_115200 In this case the terminal will be set to the Ready to download state without prompting the download submenu...

Page 222: ...prc_menu MyMenu process MyMenu menu Description This routine creates a user defined menu SMENU and MENU structures are defined in the header files User can simply fill the MENU structure and call prc...

Page 223: ...String Functions string h 222 4 4 Mathematical Functions math h 224 4 5 Utility Functions stdlib h 226 4 6 Diagnostics assert h 227 4 7 Variable Argument Lists stdarg h 227 4 8 Non Local Jumps setjmp...

Page 224: ...se use proprietary Library routines Formatted Output Only sprintf is supported For formatted output to display refer to proprietary Library LCD Formatted Input Only sscanf is supported Character Input...

Page 225: ...isdigit c is true isalpha c isupper c or islower c is true iscntrl c control character isdigit c decimal digit isgraph c printing character except space islower c lower case letter isprint c printing...

Page 226: ...s ct n compare at most n characters of string cs with ct return valus 0 if cs ct return 0 if cs ct return 0 if cs ct char strchr cs c return pointer to first occurrence of c in cs or NULL if not prese...

Page 227: ...cters from ct to s return s void memmove s ct n same as memcpy except that it works fine even if objects overlap int memcmp cs ct n compare first n characters of cs with ct return as strcmp void memch...

Page 228: ...in the range radians sinh x hyperbolic sine of x cosh x hyperbolic cosine of x tanh x hyperbolic tangent of x exp x base e raised to the power of x log x log x x 0 log10 x log to the base 10 of x x 0...

Page 229: ...double ip split x into its integer and fraction parts each with the same sign as x Returns the fractional part and loads the integer part into ip fmod x y the remainder of x y with the same sign as x...

Page 230: ...double long strtol const char s char endp int base Convert the prefix of s to long unsigned long strtoul const char s char endp int base Convert the prefix of s to unsigned long int rand void Return...

Page 231: ...e Argument Lists stdarg h Functions for processing variable arguments are listed below va_start va_list ap lastarg type va_arg va_list ap type void va_end va_list ap 4 8 Non Local Jumps setjmp h Not s...

Page 232: ...226 C Programming Guide For Optimus S R 4 11 Implementation defined Limits limits h float h Refer to limit h and float h...

Page 233: ...to 32 tasks with priority set from 0 to 31 the lower number the higher priority for the user program The main task main takes priority 16 A task desiring the semaphore will perform a PEND operation A...

Page 234: ...L must be used in pairs Return None See Also OS_ENTER_CRITICAL OSSemCreate Purpose To create and initialize a semaphore Syntax OS_EVENT OSSemCreate unsigned value where OS_EVENT a data structure to ma...

Page 235: ...err is a pointer to a variable which will be sued to hold an error code OSSemPend sets err to either 1 OS_NO_ERR if the semaphore is available 2 OS_TIMEOUT if a timeout occurred Example OSSemPend Dis...

Page 236: ...rpose To create a task Syntax unsigned char OSTaskCreate void task void pd void pdata unsigned char pstk unsigned long stk_size unsigned char prio where task is a pointer to the task s code pdata is a...

Page 237: ...an ISR cannot delete a task This function will verify that you are not attempting to delete the C OS s idle task Return If successful it returns OS_NO_ERR If the task to be deleted does not exist it r...

Page 238: ...232 C Programming Guide For Optimus S R...

Page 239: ...190 close_com 102 close_DBF 200 closesocket 146 clr_eol 90 clr_icon 90 clr_kb 74 clr_rect 90 clr_scr 91 CodeBuf 39 CodeLen 39 CodeType 39 com_cts 109 com_eot 102 com_overrun 103 com_rts 109 connect 14...

Page 240: ...57 InputPassword 32 ioctlsocket 153 IrDA_Timeout 25 K kbhit 75 KernelVersion 29 KEY_CLICK 25 KeypadLayout 29 L lcd_backlit 81 LibraryVersion 30 listen 153 LoadProgram 36 LockAlphaState 77 lseek 193 l...

Page 241: ...ey 21 setsockopt 159 SetVideoMode 82 show_image 92 shut_down 21 shutdown 160 socket 161 socket_block 165 socket_cansend 166 socket_fin 166 socket_hasdata 167 socket_ipaddr 167 socket_isopen 167 socket...

Search results

Summary of Contents for Optimus R

Reviews:

Related manuals for Optimus R

Brands by name

Popular brands

Metrologic Optimus R, Programming Manual

Search results

Summary of Contents for Optimus R

Reviews:

Related manuals for Optimus R

Brands by name

Popular brands