PAX L2 API Programming Guide
PAX L2 API
Programming Guide
For Public Library
Version 1.0.1
I
PAX L2 API Programming Guide
Copyright © 2018-2030 PAX Computer Technology (Shenzhen) Co., Ltd.
All rights reserved. No part of the contents of this document may be reproduced or
transmitted in any form or by any means without the written permission of PAX
Computer Technology (Shenzhen) Co., Ltd.
The information contained in this document is subject to change without notice.
Although PAX Computer Technology (Shenzhen) Co., Ltd. has attempted to ensure
the accuracy of the contents of this document, this document may contain errors or
omissions. The examples and sample programs are for illustration only and may not
be suitable for your purpose. You should verify the applicability of any example or
sample program before placing the software into productive use.
II
PAX L2 API Programming Guide
Revision History
Date Version Note Author
2019-03-06 v1.0.0 1. Initial Sunwei
2024-02-19 V1.0.1 1. Texted content revision Zhengyq
III
PAX L2 API Programming Guide
Contents
1 Introduction ......................................................................................................................... 1
1.1 Abbreviation ............................................................................................................. 1
1.2 Document Conventions ............................................................................................ 1
2 Functions ............................................................................................................................. 3
2.1 PUB_ReadVerInfo .................................................................................................. 3
2.2 PUB_MallocDatabase ............................................................................................. 4
2.3 PUB_FreeDatabase ................................................................................................. 4
IV
PAX L2 API Programming Guide
1 Introduction
1.1 Abbreviation
【List out the definition of the abbreviation in this document.】
Table 1 Abbreviation
Abbreviation Description
CLSS Contactless
1.2 Document Conventions
【List out all document conventions and the corresponding definitions.】
【Used for labelling common notes.】
【Used for reminding the audience to pay attention, which may
lead to exceptions or errors.】
1
PAX L2 API Programming Guide
【Used for warning the audience to be very careful, which may
lead to serious errors or damages.】
2
PAX L2 API Programming Guide
2 Functions
2.1 PUB_ReadVerInfo
Prototype int PUB_ReadVerInfo(char *paucVer);
Function Query the version of the Public Kernel.
Version number and issue date (character string,
Parameters paucVer(output)
end with ‘\0’ (at least 19 bytes)).
EMV_OK Successful
Return
CLSS_PARAM_ERR Parameter error.
Instruction None
3
PAX L2 API Programming Guide
2.2 PUB_MallocDatabase
Prototype int PUB_MallocDatabase(void);
Function Dynamically allocate memory for the L2 kernel.
Parameters None
EMV_OK Successful
Return
EMV_OVERFLOW Malloc failed.
Only the A1_PUBLIC_LIB_vxxx library is supported.
The size is 10K(PUB_MAX_DATABASE_MEM +
Instruction PUB_MAX_EXDATABASE_MEM)
This function must be called before the CoreInit API of other L2
kernels.
2.3 PUB_FreeDatabase
Prototype void PUB_FreeDatabase(void);
Function Free the allocated memory for the L2 kernel.
Parameters None
Return None
Only supports the A1_PUBLIC_LIB_vxxx library.
Instruction This function can be called after the transaction is finished.
4
PAX L2 API Programming Guide
The End