酒店门锁V10SDK接口说明-幽冥大陆(一百22)—东方仙盟
调用函数库：
//-----------------------------------------------------------------------------------//
功能：读DLL版本，不涉及USB口操作
C++原型：int __stdcall GetDLLVersion(uchar *bufVer)
返回：DLL版本
//-----------------------------------------------------------------------------------//
功能：打开USB
C++原型：int __stdcall initializeUSB(uchar d12)
参数说明：
d12 à USB类型，对于 固定为1
返回：0表示成功，否则失败
注意：以下的函数均要用到此参数，均固定为1
//-----------------------------------------------------------------------------------//
功能：关闭
C++原型：void __stdcall CloseUSB(uchar d12)
参数说明：
d12 à USB类型，对于 固定为1，只能关闭
返回：没有返回值
注意：关闭以后就不能操作USB了，如果要操作USB，请先用initializeUSB打开USB
//-----------------------------------------------------------------------------------//
功能：发卡器鸣叫一声
C++原型：int __stdcall Buzzer(uchar d12,unsigned char t)
参数说明：
d12 à USB类型，对于 固定为1
t à鸣叫时间，乘以10毫秒
返回：0表示成功，否则失败
//-----------------------------------------------------------------------------------//
功能：发行“宾客卡”，又称“宾客卡”或“房卡”
C++原型：int __stdcall GuestCard(uchar d12,int dlsCoID,uchar CardNo,uchar dai,uchar LLock,uchar pdoors,uchar BDate[10],uchar EDate[10],uchar LockNo[8],uchar *cardHexStr)
参数说明：
d12 à USB类型，对于 固定为1
dlsCoID à 酒店标识，可以从现有卡片读取
CardNo à 同一分钟内发卡最多16张，每发一张卡加1
Dai à 客人代，0--255，用于后卡覆盖前卡，一般情况下固定为0
LLock à 反锁标志，1能开反锁，0不能开反锁
pdoors à 固定为0
BDate à 发卡时间10位数字字符串，包含年月日时分，各占两位
例：'2405201345'表示2024/05/20 13:45
EDate à 退房时间10位数字字符串，包含年月日时分，各占两位
LockNo à 房间号8位数字字符串，从门锁软件的房间定义里获取
cardHexStr à 返回的卡数据字符串
返回：0表示成功，否则失败
//-----------------------------------------------------------------------------------//
功能：读取卡片数据
C++原型：int __stdcall ReadCard(uchar d12,uchar *buffData)
d12 à USB类型，对于 固定为1
buffData à 返回的卡数据字符串，数据头的第五第六位01表示成功，
从第25个字符开始的8个字符是卡的唯一号，也称为卡的ID号
返回：0表示成功，否则失败
对于M1卡，从第57个字符开始的8个字符是卡序列号，也称为卡的固有ID号
//-----------------------------------------------------------------------------------//
功能：注销卡片
C++原型：int __stdcall CardErase(uchar d12,int dlsCoID,unsigned char *cardHexStr)
d12 à USB类型，对于 固定为1
dlsCoID à 酒店标识，可以从现有卡片读取
cardHexStr à 返回的卡数据字符串
返回：0表示成功，否则失败
//-----------------------------------------------------------------------------------//
功能：挂失卡片
C++原型：int __stdcall LimitCard(uchar d12,int dlsCoID,uchar CardNo,uchar dai,uchar BDate[10],uchar LCardNo[4],uchar *cardHexStr)
参数说明：
d12 à USB类型，对于 固定为1
dlsCoID à 酒店标识，可以从现有卡片读取
CardNo à 同一分钟内发卡最多16张，每发一张卡加1
Dai à 代，0--255，用于后卡覆盖前卡，一般情况下固定为0
BDate à 发卡时间10位数字字符串，包含年月日时分，各占两位
例：'0905201345'表示2009/05/20 13:45
uchar LCardNo à 遗失卡的卡流水号，4个字节，由发卡时间、卡类型、卡号等组成
cardHexStr à 返回的卡数据字符串
返回：0表示成功，否则失败
//-----------------------------------------------------------------------------------//
功能：读取卡类型
C++原型：int __stdcall GetCardTypeByCardDataStr(unsigned char *cardHexStr, unsigned char *CardType)
cardHexStr à ReadCard函数返回的卡数据字符串
返回：0表示成功，否则失败
CardType==’0’ 控制卡
CardType==’1’ 记录卡
CardType==’2’ 房间设置卡
CardType==’3’ 时钟设置卡
CardType==’4’ 限制卡,也称为挂失卡
CardType==’5’ 区域号设置卡
CardType==’6’ 宾客卡
CardType==’7’ 退房卡
CardType==’8’ 区域卡
CardType==’9’ 未知卡,没有此卡类型
CardType==’A’ 应急卡
CardType==’B’ 总管卡
CardType==’C’ 楼栋卡
CardType==’D’ 楼层卡
CardType==’E’ 未知卡,没有此卡类型
CardType==’F’ 空白卡
//-----------------------------------------------------------------------------------//
功能：读取宾客卡的房间号
C++原型：int __stdcall GetGuestLockNoByCardDataStr(int dlsCoID,unsigned char *cardHexStr, unsigned char *LockNo)
dlsCoID à 当前酒店的酒店标识
cardHexStr à ReadCard函数返回的卡数据字符串
返回：0表示成功，否则失败,
1—卡数据串无效
3—不是宾客卡
LockNo：房间号，有8位数字字符串组成，同GuestCard函数
//-----------------------------------------------------------------------------------//
功能：读取宾客卡的离店时间
C++原型：int __stdcall GetGuestETimeByCardDataStr(int dlsCoID,unsigned char *cardHexStr, unsigned char *ETime)
dlsCoID à 当前酒店的酒店标识
cardHexStr à ReadCard函数返回的卡数据字符串
返回：0表示成功，否则失败
1—卡数据串无效
ETime：离店时间，有10位数字字符串组成，分别为年月日时分，各占两位
//-----------------------------------------------------------------------------------//
人人皆为创造者，共创方能共成长
每个人都是使用者，也是创造者；是数字世界的消费者，更是价值的生产者与分享者。在智能时代的浪潮里，单打独斗的发展模式早已落幕，唯有开放连接、创意共创、利益共享，才能让个体价值汇聚成生态合力，让技术与创意双向奔赴，实现平台与伙伴的快速成长、共赢致远。
原创永久分成，共赴星辰大海
原创创意共创、永久收益分成，是东方仙盟始终坚守的核心理念。我们坚信，每一份原创智慧都值得被尊重与回馈，以永久分成锚定共创初心，让创意者长期享有价值红利，携手万千伙伴向着科技星辰大海笃定前行，拥抱硅基 生命与数字智能交融的未来，共筑跨越时代的数字文明共同体。
东方仙盟：拥抱知识开源，共筑数字新生态
在全球化与数字化浪潮中，东方仙盟始终秉持开放协作、知识共享的理念，积极拥抱开源技术与开放标准。我们相信，唯有打破技术壁垒、汇聚全球智慧，才能真正推动行业的可持续发展。
开源赋能中小商户：通过将前端异常检测、跨系统数据互联等核心能力开源化，东方仙盟为全球中小商户提供了低成本、高可靠的技术解决方案，让更多商家能够平等享受数字转型的红利。
共建行业标准：我们积极参与国际技术社区，与全球开发者、合作伙伴共同制定开放协议 与技术规范，推动跨境零售、文旅、餐饮等多业态的系统互联互通，构建更加公平、高效的数字生态。
知识普惠，共促发展：通过开源社区 、技术文档与培训体系，东方仙盟致力于将前沿技术转化为可落地的行业实践，赋能全球合作伙伴，共同培育创新人才，推动数字经济 的普惠式增长
阿雪技术观
在科技发展浪潮中，我们不妨积极投身技术共享。不满足于做受益者，更要主动担当贡献者 。无论是分享代码、撰写技术博客，还是参与开源项目 维护改进，每一个微小举动都可能蕴含推动技术进步的巨大能量。东方仙盟是汇聚力量的天地，我们携手在此探索硅基 生命，为科技进步添砖加瓦。
Hey folks, in this wild tech - driven world, why not dive headfirst into the whole tech - sharing scene? Don't just be the one reaping all the benefits; step up and be a contributor too. Whether you're tossing out your code snippets , hammering out some tech blogs, or getting your hands dirty with maintaining and sprucing up open - source projects, every little thing you do might just end up being a massive force that pushes tech forward. And guess what? The Eastern FairyAlliance is this awesome place where we all come together. We're gonna team up and explore the whole silicon - based life thing, and in the process, we'll be fueling the growth of technology