查看“珠海公交刷卡机应用”的源代码

2018年11月后，珠海公交已将全部刷卡机更换为雄帝EMP5210A车载收费机。

注意：珠海公交并不负责清算刷卡机数据，刷卡机数据由'''珠海通'''负责维护清算。珠海通默认已录入多密钥功能，支持珠海通、交通部、岭南通、住建部、中山通五类卡（银联、二维码支付不在本文介绍范围内）。

2019年，珠海通为推进发行CPU卡与全国交通联合一卡通工作，升级售卡、发卡与清算系统，在清算系统中采用新代码排序方式。所有常规数据不再以“K"开头。

2019年12月，珠海公交投放新车'''[[GTQ6111BEVBT20]]'''，此起珠海公交新车标配雄帝EMP5211彩屏安卓刷卡机，亦是首款使用新代码的刷卡机。

至于雄帝EMP5210（旧卡机）前台仍显示为旧代码，但后台上传至清算中心时，会自动转为新代码。
==雄帝EMP5210A==
===卡机简介===
{{pic|外链=https://cdn.zbc.wiki/large/9f04c19egy1fmwh6f0uicj21kw11x1kx.jpg|描述=雄帝EMP5210A}}
从上到下第一行起介绍：（此理论只适用珠海公交绝大部分线路）
*'''珠海公交'''为珠海通设置卡机标题，如珠海有轨电车一号线则显示为'''珠海有轨电车'''，万达通显示为'''口岸接驳巴士'''
*右上角竖条为实时网络通讯信号强度显示条
*'''K0XXXXX-XXXXX'''为该车所属分公司、车牌号及执行线路号；
*后五位数字为本车车号，亦可以作为刷卡机编号
*'''LZJ'''为刷卡通道标识
*最下即为当前时间
以下录取部分卡机数据，仅供参考。
===雄帝EMP5210A刷卡机代码===
 88路金湾分公司派车卡机数据为：K018088
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=10%|K
!width=10%|01
!width=10%|8
!width=10%|088
|-
|空调
|线路属性
|分公司代码
|线路号
|}
===部分线路刷卡机数据===
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=30%|卡机数据
!width=20%|所属线路
!width=20%|所属分公司
|-
|K028115
|Z115路
|金湾分公司
|-
|K03505B
|B5路
|前山分公司
|-
|K01807F
|K7路
|金湾分公司
|-
|K01907E
|L7路
|斗门分公司
|}
===配置错误卡机数据===
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=20%|卡机数据
!width=30%|所属建制站及线路
!width=20%|错误原因
|-
|K016903
|{{海虹}}<br>B3路
|无法享受换乘优惠
|-
|K018207
|{{三灶}}<br>Z101路
|无法享受换乘优惠
|-
|K021011
|{{体育南}}<br>9路
|无法享受换乘优惠
|-
|colspan=3|*以上为举例数据，非实际错误数据。
<nowiki>*</nowiki>如因卡机数据错误致换乘优惠失效，请致电珠海通客服追回退款。
|}
*注：部分车辆或因临时机动，仍在采用原线路数据。
*部分线路因线路所属建制站转移，数据尚未更新，仍使用前分公司数据。
==雄帝EMP5211==
===卡机简介===
雄帝EMP5211界面排版与旧款卡机稍有区别，但显示内容无差异，并在下方增加了图片滚动界面。
{{pic|外链=https://cdn.zbc.wiki/mw690/9f04c19egy1g8vr0n3vb1j20u0140dk5.jpg|描述=雄帝EMP5211，时间显示移至顶部}}
===雄帝EMP5211刷卡机代码===
 B4路香洲分公司派车卡机数据为：104B03
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=10%|1
!width=10%|04B
!width=10%|03
|-
|分公司代码
|线路号
|线路属性
|}
===部分线路刷卡机数据===
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=30%|卡机数据
!width=20%|所属线路
!width=20%|所属分公司
|-
|006F01
|K6路
|斗门分公司
|-
|104F01
|K4路
|香洲分公司
|-
|811702
|Z117路
|金湾分公司
|-
|052501
|525路
|斗门分公司
|-
|002101
|21路
|吉大分公司
|-
|708501
|85路
|香洲分公司
|-
|804B03
|B4路
|金湾分公司
|}
===配置错误卡机数据===
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=20%|卡机数据
!width=30%|所属建制站及线路
!width=20%|错误原因
|-
|201702
|{{上冲检查}}<br>43路
|线路配置错误
|-
|colspan=3|*以上为举例数据，非实际错误数据。
|}
*注：部分车辆或因临时机动，仍在采用原线路数据。
*部分线路因线路所属建制站转移，数据尚未更新，仍使用前分公司数据。
*EMP5211上线时默认数据为'''201702'''（对应吉大分公司Z17路）。如因卡机数据错误致换乘优惠失效，请致电珠海通客服追回退款。
==卡机代码范围表==
在分公司代码中，仍保持早期各分公司结构，以方便清算。
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=10%|空调
!width=30%|线路属性
!width=30%|分公司代码
!width=30%|线路号
|-
|K
|01 普通线路
|1 香洲
|数字结尾 普通线路
|-
|
|02 微公交/专线
|2 拱北
|F结尾 K线
|-
|
|03 B线
|3 吉大
|E结尾 L线
|-
|
|07 特殊应用
|4 横琴
|B结尾 B线
|-
|
|
|5 上冲
|9**或09* A结尾线路
|-
|
|
|6 前山
|
|-
|
|
|7 金鼎
|
|-
|
|
|8 金湾
|
|-
|
|
|0 斗门/独营线路
|
|}

==部分特殊卡机代码==
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=30%|卡机数据
!width=20%|所属线路
|-
|01001D
|吉大总站
|-
|K089981
|万达通口岸巴士
|-
|K089801
|观光巴士坦洲线
|-
|K089802
|观光巴士井岸线
|-
|071998
|公交移动饭堂
|}
==黑白名单==
===白名单===
#白名单由各互联互通城市的机构代码组成，格式为16进制。
#白名单是保证收单机构（珠海通）能与中交金卡广东省清算平台（岭南通部级清算系统）清分清算资金的保障名单。
#每一城市加入互联互通并缴纳保证金后，由全国交通一卡通互联互通平台每月统一更新下发各级发卡/收单机构，并由当地机构统一维护更新。
#当卡机读取AID应用时，刷卡机依次读取卡片17应用信息、互联互通判断、15公共应用基本信息文件，然后判断发卡机构代码。
如发卡机构代码在本机白名单则进行下一步读取判断发卡机构应用。

如发卡机构代码不在本机白名单，卡机拒绝交易并报错退出。

2020年3月，时隔一年半后，珠海公交已首次更新下发交通部白名单。
====白名单版本====
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=30%|卡机型号
!width=20%|版本
|-
|EMP5210
|20220505
|-
|EMP5211
|20220505
|-
|通达一体机
|20220505
|-
|colspan=2|最后更新日期：2022年6月10日
|}
===黑名单===
#黑名单是存储各类挂失、注销等卡片名单，目前全国交通一卡通互联互通平台尚未做黑名单卡处理，但珠海通有自行维护黑名单。
#珠海通每日统一下发最新黑名单，该黑名单存储珠海本地卡片数据，为挂失、注销等各类学生卡、老人卡等卡片。
#当卡片交易触发黑名单时，卡机拒绝交易，并显示：'''警告;黑名单卡！'''。
====黑名单版本====
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=30%|卡机型号
!width=20%|版本
|-
|EMP5210
|20200728
|-
|EMP5211
|20200728
|-
|colspan=2|最后更新日期：2020年7月28日
|}

==交通联合卡应用==
当使用交通联合一卡通刷卡时会触发互联互通交易流程，并更新卡片0x1E文件。
===0x1E===
0x1E文件为互联互通文件，文件格式是定长的循环记录文件，0x1E文件为电子钱包和电子现金共用的文件，所有交易都需更新1E以确保交易记录的完整性。

文件的更新由终端自行完成，而非卡片cos自行维护，因为其内部存储的数据可以由终端自行定义，而非都是交易过程中的指令传输的参数。

0x1E文件主要用于存储换乘优惠等交易过程中的前面几笔的交易记录，也可以作为复合消费（扩展应用）的交易日志记录文件。也可由终端自行决定需要记录的信息，目前记录条数为前30条。

当在珠海使用交通联合一卡通刷卡消费时，刷卡机会更新1E循环记录文件，记录本次乘车线路、时间与扣费信息，可使用手机APP贴卡读取乘车信息。

由于程序设计问题，珠海公交仅雄帝刷卡机写入线路信息，而通达一体机则不写入线路信息。

目前，可贴卡使用“读卡识途”APP读取珠海公交部分乘车刷卡信息，目前线路数据仍不断完善当中。

现支持珠海公交普通线路、快线、B线、Z线、L线、826快线与吉大总站读取，暂不支持非专营通勤专线。

并已支持有轨电车、口岸巴士与观光巴士刷卡信息。由于口岸巴士问题，待接入交联刷卡通道即可读取相应内容。

如遇APP读卡数据有误，在确认刷卡机配置正确的情况下，敬请联系本站管理员修正数据。
===雄帝刷卡机===
====1E文件线路记录解析====
 23路刷卡写入1E数据：23010000783509
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=10%|23
!width=10%|01
!width=10%|0000783509
|-
|所刷线路
|线路属性
|固定数据
|}
====1E文件线路记录举例====
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=30%|1E文件数据
!width=20%|所属线路
|-
|23010000783509
|23路
|-
|3F010000783509
|K3路
|-
|03020000783509
|洪湾渔港专线
|-
|9B030000783509
|B9
|-
|15020000783509
|Z115
|-
|1D010000783509
|吉大总站
|}
即读取前四位数据，前两位为线路，第三第四位为线路属性。

可参考'''扣费通道及代码'''。

由于珠海通只写入两位线路，因此三位数线路与两位数线路的1E文件数据是一样的。

如：
{|class="wikitable" width=50% style="text-align:center;background:#d4fffc;"
!width=30%|1E文件数据
!width=20%|所属线路
|-
|1F010000783509
|K1路
|-
|1F010000783509
|K11路
|-
|10010000783509
|10路
|-
|10010000783509
|10A路
|}

===通达一体机===
====1E文件线路记录解析====
 23路刷卡写入1E数据：000000000000A1

在通达一体机中，程序不再写入线路信息，而是写入当日刷卡次数。

程序向卡片1E文件写入16进制编码，如“A1”，转换为10进制即为“161”，即当日第161个刷卡乘客，以此类推。

==刷卡优先度==
目前，珠海公交绝大部分卡机均已配置支持多种支付方式，并根据密钥配置收单优先度。

目前珠海公交卡片优先度如下：

雄帝从最优先依次为：[[珠海通]]↔[[岭南通]]↔[[全国城市一卡通]]↔[[全国交通一卡通]]↔[[中山通]]↔银联云闪付

通达从最优先依次为：[[珠海通]]↔[[岭南通]]↔[[全国交通一卡通]]↔[[全国城市一卡通]]↔[[中山通]]↔银联云闪付

*注1：[[岭南通]]+[[全国交通一卡通]]双标卡（茂名、云浮、肇庆、广州等）在珠海走岭南通通道扣款。
*注2：如三标卡（[[全国城市一卡通]]↔[[全国交通一卡通]]↔银联云闪付）走住建部通道收单。
*注3：如双标卡（[[全国交通一卡通]]↔银联云闪付）走交通部通道收单。