SWComApi.

dll
User’s Guide V1.0

1
 SWComApi.DLL is a dynamic link library designed to facilitate RFID application
software development.

1. Function List:
SWComApi.DLL includes the following functions：
1.1 General Function:
1) BOOL SWCom_OpenDevice(char *pcCom, int iBaudRate) ;
2) BOOL SWCom_CloseDevice(void);
3) BOOL SWCom_GetDeviceSystemInfo(unsigned char bDevAdr,unsigned char
*pucSystemInfo);
4) BOOL SWCom_ReadDeviceOneParam(unsigned char bDevAdr,unsigned char
pucDevParamAddr,unsigned char *pValue);
5) BOOL SWCom_SetDeviceOneParam(unsigned char bDevAdr,unsigned char
pucDevParamAddr,unsigned char bValue);
6) BOOL SWCom_StopRead(unsigned char bDevAdr);
7) BOOL SWCom_StartRead(unsigned char bDevAdr);
8) void ( * FUNPTR_ACTIVE_CALLBACK)(int msg, int param1, unsigned char *param2,
int param3,unsigned char *param4);
9) int SWCom_SetCallback(FUNPTR_ACTIVE_CALLBACK pfAddr);
10) BOOL SWCom_InventoryG2(unsigned char bDevAdr, unsigned char *pBuffer,
unsigned short * Totallen, unsigned short *CardNum);
11) BOOL SWCom_WriteEPCG2(unsigned char bDevAdr, unsigned char * Password,
unsigned char * WriteEPC, unsigned char WriteEPClen);
12) BOOL SWCom_ReadCardG2 (unsigned char bDevAdr, unsigned char *
Password ,unsigned char Mem, unsigned char WordPtr, unsigned char ReadEPClen,
unsigned char * Data);
13) BOOL SWCom_WriteCardG2(unsigned char bDevAdr, unsigned char * Password,
unsigned char Mem, unsigned char WordPtr,unsigned char Writelen, unsigned char *
Writedata);
14) BOOL SWCom_RelayOn(unsigned char bDevAdr);
15) BOOL SWCom_RelayOff(unsigned char bDevAdr);

2. Function Explanation:

2.1) General Function:

2.1.1) BOOL SWCom_OpenDevice(char *pcCom, int iBaudRate)
Open Device.
Param: pcCom: COM, Value: "COM1" , "COM2" ....
iBaudRate:Baud rate from 4800bps to 115200bps
device default BaudRate is 115200bps
Return:Success return 1, failed return 0
2.1.2) BOOL SWCom_CloseDevice(void)
Close Device
Param: None
Return:Success return 1, failed return 0

1
2.1.3)BOOL SWCom_GetDeviceSystemInfo(unsigned char bDevAdr,unsigned char
*pucSystemInfo)
GetDeviceInfo. 9Bytes
Param: bDevAdr: 0xFF
pucSystemInfo:SysInfo 9Bytes 1:SoftVer 2:HardVer 3 - 9:DeviceSN
Return:Success return 1, failed return 0
2.1.4)BOOL SWCom_ReadDeviceOneParam(unsigned char bDevAdr,unsigned char
pucDevParamAddr,unsigned char *pValue)
Get Device One Param
Param: bDevAdr: 0xFF
pucDevParamAddr: Param Addr
pValue:Return Param Value
Return:Success return 1, failed return 0
2.1.5)BOOL SWCom_SetDeviceOneParam(unsigned char bDevAdr,unsigned char
pucDevParamAddr,unsigned char bValue)
Set Device One Param
Param: bDevAdr: 0xFF
pucDevParamAddr: Param Addr
bValue:Param
Return:Success return 1, failed return 0
2.1.6)BOOL SWCom_StopRead(unsigned char bDevAdr)
Stop all RF reading
Param: bDevAdr: 0xFF
Return:Success return 1, failed return 0
2.1.7)BOOL SWCom_StartRead(unsigned char bDevAdr)
Start all RF reading
Param: bDevAdr: 0xFF
Return:Success return 1, failed return 0
2.1.8)typedef void ( * FUNPTR_ACTIVE_CALLBACK)(int msg, int param1, unsigned char
*param2, int param3,unsigned char *param4)
Callback function prototype
msg == 0: Device Insert
msg == 1: Device Out
msg == 2: param1 means tag number, param2 means tagdata, param3 means
tagdata length,param4 means DevSN
2.1.9)int SWCom_SetCallback(FUNPTR_ACTIVE_CALLBACK pfAddr)
pfAddr: Callback function
2.1.10)BOOL SWCom_InventoryG2(unsigned char bDevAdr, unsigned char *pBuffer,
unsigned short * Totallen, unsigned short *CardNum)
Inventory EPC
Param: bDevAdr: 0xFF
pBuffer: Get Buffer
Totallen: Get Buffer Length
CardNum: Tag Number
Return: Success return 1, failed return 0

2
2.1.11)BOOL SWCom_WriteEPCG2(unsigned char bDevAdr, unsigned char * Password,
unsigned char * WriteEPC, unsigned char WriteEPClen)
Write EPC
Param: bDevAdr: 0xFF
Password: Password (4 bytes)
WriteEPC: Write Data
WriteEPClen: Write Length
Return:Success return 1, failed return 0
2.1.12)BOOL SWCom_ReadCardG2 (unsigned char bDevAdr, unsigned char *
Password ,unsigned char Mem, unsigned char WordPtr, unsigned char ReadEPClen,
unsigned char * Data)
Read Card
Param: bDevAdr: 0xFF
Password: Password (4 bytes)
Mem: 0:Reserved 1:EPC 2:TID 3:USER
WordPtr: Start Address
ReadEPClen: Read Length
Data: Read Data
Return:Success return 1, failed return 0
2.1.13)BOOL SWCom_WriteCardG2(unsigned char bDevAdr, unsigned char * Password,
unsigned char Mem, unsigned char WordPtr,unsigned char Writelen, unsigned char *
Writedata)
Write Card
Param: bDevAdr: 0xFF
Password: Password (4 bytes)
Mem: 0:Reserved 1:EPC 2:TID 3:USER
WordPtr: Start Address
WriteEPC: Write Data
WriteEPClen: Write Length
Return:Success return 1, failed return 0
2.1.14) BOOL SWCom_RelayOn(unsigned char bDevAdr)
RelayOn
Param: bDevAdr: 0xFF
Return:Success return 1, failed return 0
2.1.15) BOOL SWCom_RelayOff(unsigned char bDevAdr)
RelayOff
Param: bDevAdr: 0xFF
Return:Success return 1, failed return 0