001 /*
002 * ===========================================================================================
003 * = COPYRIGHT
004 *          PAX Computer Technology (Shenzhen) Co., Ltd. PROPRIETARY INFORMATION
005 *   This software is supplied under the terms of a license agreement or nondisclosure
006 *   agreement with PAX Computer Technology (Shenzhen) Co., Ltd. and may not be copied or
007 *   disclosed except in accordance with the terms in that agreement.
008 *     Copyright (C) 2017-2023 PAX Computer Technology (Shenzhen) Co., Ltd. All rights reserved.
009 * Description: // Detail description about the function of this module,
010 *             // interfaces with the other modules, and dependencies.
011 * Revision History:
012 * Date                         Author                        Action
013 * 2017/04/01                   PAX                     Create/Add/Modify/Delete
014 * ===========================================================================================
015 */
016 
017package com.pax.dal;
018
019import com.pax.dal.exceptions.Sle4442DevException;
020
021/**
022 * @since V2.00.01
023 */
024@Deprecated
025public interface ISle4442 {
026
027    /**
028     * <div class="zh"> 上电复位SLE4442模块、检查模块的初始状态是否正常 </div> <div class="en"> Power on and reset Sle4442 module, and check
029     * whether initial staus of the module is normal. </div>
030     * 
031     * @param slot
032     *            <div class="zh"> 目标通道号。 目前仅支持0 </div> <div class="en"> the number of card channel which should be
033     *            initialized. alway 0 now </div>
034     * @throws Sle4442Exception
035     */
036    @Deprecated
037    public void sle4442Open(int slot) throws Sle4442DevException;
038
039    /**
040     * <div class="zh"> 下电SLE4442模块,并设置其为停用态 </div> <div class="en"> Close Sle4442 module, and make it in stop status.
041     * </div>
042     * 
043     * @param slot
044     *            <div class="zh"> 目标通道号。 目前仅支持0 </div> <div class="en"> the number of card channel which should be
045     *            initialized. alway 0 now </div>
046     * @throws Sle4442DevException
047     */
048    @Deprecated
049    public void sle4442Close(int slot) throws Sle4442DevException;
050
051    /**
052     * <div class="zh"> 复位 IC卡,并返回卡的ATR </div> <div class="en"> Reset IC card and return ATR of the card. </div>
053     * 
054     * @param slot
055     *            <div class="zh"> 目标通道号。 目前仅支持0 </div> <div class="en"> the number of card channel which should be
056     *            initialized. alway 0 now </div>
057     * 
058     * @return <div class="zh"> 返回的卡的ATR </div> <div class="en"> ATR Answer To Reset information of the card. </div>
059     * @throws Sle4442DevException
060     */
061    @Deprecated
062    public byte[] sle4442Reset(int slot) throws Sle4442DevException;
063
064    /**
065     * <div class="zh"> 读取数据 </div> <div class="en"> Read data. </div>
066     * 
067     * @param slot
068     *            <div class="zh"> 目标通道号。 目前仅支持0 </div> <div class="en"> the number of card channel which should be
069     *            initialized. alway 0 now </div>
070     * @param Addr
071     *            <div class="zh"> 开始读取的位置,范围在0~255 </div> <div class="en"> the start address to read, its valid range
072     *            is 0~255. </div>
073     * @param length
074     *            <div class="zh"> 要读取的数据的长度,范围为1至256。 </div> <div class="en"> the length of the data to be read, its
075     *            valid range is 1~256. </div>
076     * @return <div class="zh"> 被读取到的数据 </div> <div class="en"> the data has been read </div>
077     * @throws Sle4442DevException
078     */
079    @Deprecated
080    public byte[] sle4442ReadMMem(int slot, int Addr, int length) throws Sle4442DevException;
081
082    /**
083     * <div class="zh"> 写入数据 </div> <div class="en"> Write data. </div>
084     * 
085     * @param slot
086     *            <div class="zh"> 目标通道号。 目前仅支持0 </div> <div class="en"> the number of card channel which should be
087     *            initialized. alway 0 now </div>
088     * @param Addr
089     *            <div class="zh"> 开始写入的位置,范围在0~255 </div> <div class="en"> the start address to write, its valid range
090     *            is 0~255. </div>
091     * @param length
092     *            <div class="zh"> 要写入的数据长度,范围在0~255 </div> <div class="en"> the length of the data to be writen, its
093     *            valid range is 0~255. </div>
094     * @param dataIn
095     *            <div class="zh"> 数据字节 </div> <div class="en"> number bytes of data </div>
096     * @throws Sle4442DevException
097     */
098    @Deprecated
099    public void sle4442WriteMMem(int slot, int Addr, int length, byte[] dataIn) throws Sle4442DevException;
100
101    /**
102     * <div class="zh"> 读取被保护的数据 </div> <div class="en"> Read proteceted data. </div>
103     * 
104     * @param slot
105     *            <div class="zh"> 目标通道号。 目前仅支持0 </div> <div class="en"> the number of card channel which should be
106     *            initialized. alway 0 now </div>
107     * 
108     * @return <div class="zh"> 被读到的数据 </div> <div class="en"> the data has been read </div>
109     * @throws Sle4442DevException
110     */
111    @Deprecated
112    public byte[] sle4442ReadProMMem(int slot) throws Sle4442DevException;
113
114    /**
115     * <div class="zh"> 写入被保护的数据 </div> <div class="en"> Write proteceted data. </div>
116     * 
117     * @param slot
118     *            <div class="zh"> 目标通道号。 目前仅支持0 </div> <div class="en"> the number of card channel which should be
119     *            initialized. alway 0 now </div>
120     * @param Addr
121     *            <div class="zh"> 开始写入的位置,范围在0~31 </div> <div class="en"> the start address to write, its valid range
122     *            is 0~31. </div>
123     * @param length
124     *            <div class="zh"> 要写入的数据长度,范围在1~32 </div> <div class="en"> the length of the data to be writen, its
125     *            valid range is 1~32. </div>
126     * @param dataIn
127     *            <div class="zh"> 数据字节 </div> <div class="en"> number bytes of data </div>
128     * @throws Sle4442DevException
129     */
130    @Deprecated
131    public void sle4442WriteProMMem(int slot, int Addr, int length, byte[] dataIn) throws Sle4442DevException;
132
133    /**
134     * <div class="zh"> 验证密码 </div> <div class="en"> Verify password. </div>
135     * 
136     * @param slot
137     *            <div class="zh"> 目标通道号。 目前仅支持0 </div> <div class="en"> the number of card channel which should be
138     *            initialized. alway 0 now </div>
139     * @param pwd
140     *            <div class="zh"> 密码数据字节,需要3个字节 </div> <div class="en"> number bytes of password, should be 3 bytes
141     *            </div>
142     * @throws Sle4442DevException
143     */
144    @Deprecated
145    public void sle4442VerifySc(int slot, byte[] pwd) throws Sle4442DevException;
146
147    /**
148     * <div class="zh"> 更新密码 </div> <div class="en"> Update password. </div>
149     * 
150     * @param slot
151     *            <div class="zh"> 目标通道号。 目前仅支持0 </div> <div class="en"> the number of card channel which should be
152     *            initialized. alway 0 now </div>
153     * 
154     * @param newPwd
155     *            <div class="zh"> 新的密码数据字节,需要3个字节 </div> <div class="en"> number bytes of password,should be 3 bytes
156     *            </div>
157     * @throws Sle4442DevException
158     */
159    @Deprecated
160    public void sle4442UpdateSc(int slot, byte[] newPwd) throws Sle4442DevException;
161}