Subscribe to Our Youtube Channel
Summary of Contents for ACS ACR890
- Page 1 ACR890 All-in-One Mobile Smart Card Terminal Reference Manual V1.01 Subject to change without prior notice info@acs.com.hk www.acs.com.hk...
-
Page 2: Table Of Contents
Get status of the printer ....................... 40 11.0. Wireless LAN Module Control APIs..............42 11.1. Power on wireless LAN module ................... 42 11.2. Power off wireless LAN module ................... 43 Page 2 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... - Page 3 Get system sleep time ......................69 17.3. Enable or disable system auto sleep ................... 69 List of Tables Table 1 : Track Data State Bits Table ....................61 Page 3 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01...
-
Page 4: Introduction
This state-of-art product offers faster processing speed, large memory and portability. This Reference Manual describes the API (Application Programming Interface) calls developed specifically for the ACR890 terminal. Application software developers can make use of these APIs to develop their smart-card related applications. -
Page 5: File And Directory Structure
2.0. File and Directory Structure File Name Functional System Description acs_api.h Host API header acs_errno.h Host API returned error number defines libacs_api.so Target API shared library Page 5 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 6: Keypad Apis
Parameters None. Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 6 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 7: Get Current Keypad State
The mode value to Input; Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 7 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 8: Get Power Button Working Mode
= %d\n",(int)m); ret = kpd_state_get(&key_Point,5000); //read key press within 5s printf("Type: %d, Code: %d\n", key_Point.type, key_Point.code); mode = CMD_ONOFFMODE; pwrbtn_set_mode(mode); //set current powerkey working mode PowerKey Mode Page 8 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... - Page 9 //obtain current powerkey working mode printf("m3 = %d\n",(int)m); ret = kpd_close(); printf("ret = %d\n", ret); return 0; Page 9 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01...
-
Page 10: Backlight Control Apis
= backlight_get(&state); //call api to get backlight state if(0 == ret) {//show out the backlight state you get just now. printf("brightness=%d.max_brightness=%d,fb_power=%d,actual_brightn ess=%d", state.brightness,state.max_brightness,state.fb_power,state.actual_bri ghtness); return ret; Page 10 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 11: Set Backlight Level
Library Use libacs_api.so Example Code int main(void) int ret; enum bl_level level = BACKLIGHT_LEVEL_4; ret = backlight_set(level); //call api to set the level of backlight brightness. return ret; Page 11 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 12: Battery And Charger Apis
{ //print the battery state you get just now. printf("ifdc = %d, ifbattery = %d, chargerstate = %d, batt_voltage = %d, batt_voltage_max batt_voltage_min batt_volpercent %d\n", state.ifdc, state.ifbattery,state.chargerstate, state.batt_voltage, state.batt_voltage_max, state.batt_voltage_min, state.batt_volpercent); return ret; Page 12 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 13: Led Control Apis
The state of the specified LED. Return value If successful, the return value is 0. If failed, the return value is -1 or -2. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 13 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 14: Get Led's Blinking Status
//call API to set blue led blink on for 100ms and blink off for 900ms periodically. ret = led_set_state(led, stat); if(0 != ret) printf( " Set led blink state failed !, ret = %d\n", ret); return ret; Page 14 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 15: Gprs Module Power Management Apis
Parameter None. Return Value If successful, the return value is EGPRS_SUCCEEDED. If failed, the return value is ENODEV or EGPRS_POWER_ON_FAILED. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 15 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 16: Power Off Gprs
Parameters None. Return Value If successful, the return value is EGPRS_SUCCEEDED. If failed, the return value is ENODEV or EGPRS_POWER_OFF_FAILED. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 16 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 17: Set Pppd Connect Parameter
The proper netmask if needed. Return Value If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 17 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 18: Set Pppd Dialer Parameter
The APN of mobile network operator support. Return Value If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 18 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 19: Start Up Pppd Process
7.5. Start up pppd process This function is used to start up the pppd dial process. void ppp_on(void ). Parameters None. Return Value None. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 19 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 20: Turn Off Pppd Process
!= 0) printf(“no exist /dev/ttyUSB2\n”); return -1; set_ppp_param(“*99***1#”, “0.0.0.0”, “0.0.0.0”, “255.255.255.0”); if(ret != 0) printf("set ppp param Failed!\n); gprs_power_off(); return -1; ret = set_dialer_param(“IP”, “3gnet”); if(ret != 0) Page 20 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... - Page 21 = %d\n”,count); ret = system(“ ifconfig | grep ‘ppp0’ ”); if(ret == 0) system(“cp /etc/ppp/resolv.conf /etc/resolv.conf”); break; sleep(1); count++; if(count > 15) printf(“Timeout!!!\n”); break; return 0; Page 21 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01...
-
Page 22: Transmit One At Command
The length of RecvBuffer. Return Value If successful, the return value is 0. If failed, the return value is < 0 Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 22 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 23: Get Imei Serial Number
IMEI_SN Failed, ret = %d\n”,ret); gprs_power_off(); return -1; printf(“IMEI Serial Number = %s\n”, IMEI_Buf); ret = gprs_power_off(); if(ret != EGPRS_SUCCEEDED) printf(“gprs power off Failed!\n”); return -1; return 0; Page 23 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 24: Audio (Alsa) Apis
{//print the volume state you get just now. printf("max volume is %ld\nmin volume is %ld\n, left volume is %ld\nright volume is %ld\n", stat.max_vol, state.min_vol, stat.left_vol, stat.right_vol); return ret; Page 24 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 25: Set System Audio Volume
18). Return value If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 25 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 26: Sound Playback
If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Example Code int main(void) int ret; ret = sound_play ("./Niose.wav");//call api to play a specified audio file return ret; Page 26 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 27: Speaker Sound Control
If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Example Code int main(void) int ret; ret = speaker_onoff(1);//call api to sound on speaker. return ret; Page 27 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 28: Firmware Apis
Data pointer of device version(major, minor, revision) Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 28 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 29: Thermal Printer Apis
Parameters None. Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_OPEN_ERR. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 29 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 30: Close The Printer Port
Parameter None. Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_CLOSE_ERR. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 30 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 31: Reset The Printer
Parameter None. Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_RESET_ERR. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 31 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 32: Feed Paper To Printer
The paper space to be fed (ranges from 0 to 255, space is equal to nr_len * 0.125, in Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_FPAPER_ERR. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 32 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 33: Set Line Space In Standard Mode
Paper space to be fed, range from 0 to 255, space is equal to nr_len * 0.125 (in mm) Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_SETLINE_SPACE. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 33 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 34: Print String In Standard Mode
Null terminated string of characters to be printed. Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_STRPRINT_SM. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 34 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 35: Print String In
[in] data Pointer to the array of characters to be printed. [in] size Size of the array of characters to be printed (range from 1 to 490 bytes). Page 35 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... - Page 36 Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_STRPRINT_PM. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 36 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01...
-
Page 37: Print Data Array In Standard Mode
Size of the array of characters to be printed in bytes. Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_DATAPRINT_PM. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 37 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 38: Print Data Array In
Size of the array of characters to be printed (range from 1 to 490 in bytes). Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_DATAPRINT_PM. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 38 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 39: Print An Image
1 and 384 (inclusive). Return Values If successful, the return value is SUCCESS. If failed, the return value is ETHP_IMAGEPRINT. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 39 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 40: Get Status Of The Printer
//standard mode printing printer_printStrSM(szcom); PRT_PAGE_MODE_PARAM param; memset(¶m,0,sizeof(param)); //Page mode printing param.HorizontalOrigin_X = 50; param.VerticalOrigin_Y = 50; param.PrintWidth_X = 100; param.PrintHeight_Y = 150; param.ucLineSpace = 25; nRet = printer_status_get(); Page 40 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... - Page 41 -1; printer_printStrSM("ABCDEFGFH"); //printing and change new line printer_page_feed(100); printer_printStrSM("BBBBBB"); printer_pintStrSM("CCCCC"); nRet = pinter_status_get(); if(nRet !=PRINTER_READY) printf("ACR890_Printer_PrintStrSM nRet = [%x]\n",nRet); return -1; //Reset and cache flush ACR890_Printer_close(); i++; sleep(1); Page 41 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01...
-
Page 42: Wireless Lan Module Control Apis
Parameter None. Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 42 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 43: Power Off Wireless Lan Module
Parameter None. Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 43 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 44: Bluetooth Module Control Apis
Parameter None. Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 44 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 45: Power Off Bluetooth Module
Parameter None. Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 45 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 46: Contact Smart Card Reader Apis
Parameter None. Return values If successful, the return value is 0. If failed, the return value is -ENODEV. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 46 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 47: Close The Contact Card Reader Module
Parameter None. Return values If successful, the return value is 0. If failed, the return value is -ENODEV. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 47 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 48: Check If A Contact Card Is Present
If successful, the return value is 0 (card is present). If failed, the return value is ≠ 0 (card is not present). Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 48 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 49: Power On A Contact Smart Card
The returned ATR length. Return values If successful, the return value is 0. If failed, the return value is ≠ 0. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 49 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 50: Power Off A Contact Smart Card
The index ID of specified slot(IFD). Return values If successful, the return value is 0. If failed, the return value is ≠ 0. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 50 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 51: Send Pps To Contact Smart Card
The fi and di value. Return Values If successful, the return value is 0. If failed, the return value is ≠ 0. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 51 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 52: Contact Smart Card Apdu Transfer
== ret) printf("Found card in slot %d!\n", idx); ret = icc_power_on(idx, atr, &mlen); if(0 == ret) printf("ATR "); for(i = 0; i < mlen; i++) printf("%02X ",atr[i]); printf("\n"); Page 52 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... - Page 53 = 0; I < rxlen; i++) printf("%02X ",rxcmd[i]); printf("\n"); ret = icc_power_off(idx); else printf(“Power on card %d failed!\n”, idx); else printf("No card in slot %d!\n", idx); icc_close(); return ret; Page 53 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01...
-
Page 54: Contactless Reader Apis
Parameter None. Return values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 54 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 55: Close The Contactless Reader Module
Parameter None. Return Value If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 55 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 56: Read A Contactless Card
Length of the card UID */ Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 56 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 57: Power On The Contactless Card
32 bytes. Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h. Library Use libacs_api.so. Page 57 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 58: Power Off The Contactless Card
Parameter None. Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 58 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 59: Contactless Card Data Transfer
The length of the response data. Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 59 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 60: Contactless Card Reader Antenna Control
Declared in acs_api.h Library Use libacs_api.so Example Code int main(int argc,char *argv[]) int ret; ret = picc_Open(); if(ret) printf("Open PICC fail\n"); else printf("Open PICC succ\n"); picc_Close(); return ret; Page 60 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 61: Magnetic Stripes Card Apis
Track #1 data End Byte Error Bit 1 Track #1 data Parity Error Bit 0 Track #1 data Start Byte Error Table 1: Track Data State Bits Table Page 61 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... - Page 62 #1 data : \n"); for(i = 0; i < sizeof(tMSRData. track_data1); i++) printf(“0x%02X ”, tMSRData. track_data1[i]); printf(“\n”); else printf("track 1 error : "); PRINT_MSR_ERROR(tMSRData.track_state); printf("\n"); return ret; Page 62 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01...
-
Page 63: Error Code Description Apis
*acs_err(const int errno_code) Parameters [in] errno_code The error number to parse. Return values A parsed string for an error number. Requirements Header Declared in acs_api.h Library Use libacs_api.so Page 63 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 64: Ini File Parser Apis
= get_a_ini_key_value (“lcd”, “brightness”, key_value); //call api to get brightness value if(0 == ret) {//show out the brighness you get from ini file just now. printf("[lcd]\nbrightness=%s\n”, key_value); return ret; Page 64 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 65: Set A Ini Keyword Value
Use libacs_api.so Example Code int main(void) int ret; ret = set_a_ini_key_value (“lcd”, “brightness”, 3); //call api to set brightness value to 3 in the ini file. return ret; Page 65 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 66: Add A Ini Keyword
If failed, the return value is -1. Requirements Header Declared in acs_api.h Library Use libacs_api.so Example Code int main(void) int ret; ret = add_a_ini_key_value (“lcd”, “brightness”, 3); return ret; Page 66 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 67: Sync Setting Hardware Value According To All Keyword In /Etc/Config.ini
This function is to setting all hardware according to all keyword value in ini file (/etc/config.ini). void ini_init_hw_all(void); Parameters None. Return Value None. Requirements Header Declared in acs_api.h Library Use libacs_api.so Example Code int main(void) ini_init_hw_all(); return 0; Page 67 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 68: Sync Setting Hardware Value According To Specified Keyword
Declared in acs_api.h Library Use libacs_api.so Example Code int main(void) int ret; ret = record_set_to_hw (“lcd”, “brightness”, 3); //call api to set brightness value to 3 return ret; Page 68 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... -
Page 69: Power Management Apis
This function is used to get the device idle time. int pm_sleep_enable(unsigned char isEnable) Parameters [in] isEnable isEnable = 1 enable device auto sleep isEnable = 0 disable device auto sleep Page 69 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01... - Page 70 Return Values If successful, the return value is 0. If failed, the return value is -1. Requirements Header Declared in acs_api.h. Library Use libacs_api.so. Page 70 of 70 ACR890 – Reference Manual info@acs.com.hk www.acs.com.hk Version 1.01...
Need help?
Do you have a question about the ACR890 and is the answer not in the manual?
Questions and answers