文档用途：用于现场调试、售后排查、客户答疑、销售问题解释，统一MDB刷卡器、纸币器、投币器透传故障标准原因与解决方案。
Document Purpose: For on-site commissioning, after-sales troubleshooting, customer Q&A, and sales issue explanation; to standardize the causes and solutions for MDB card reader, bill acceptor, and coin acceptor pass-through faults.
适用设备：MDB刷卡器、MDB纸币器、MDB投币器
Applicable Devices: MDB card readers, MDB bill acceptors, MDB coin acceptors.
¶ 问题一：接线连接错误故障（外设完全无响应）
¶ Issue 1: Wiring Connection Error (Peripheral Completely Unresponsive)
故障现象：透传串口与主机通信正常，主机可正常下发MDB指令，但MDB总线外设无任何应答。透传日志仅有发送报文、无接收报文，设备无法初始化、无法正常工作。
Symptom: The pass-through serial port communicates normally with the host, and the host can normally send MDB commands, but the MDB bus peripheral gives no response at all. The pass-through log contains only sent messages and no received messages. The device cannot initialize or work normally.
处理过程：1、检查设备物理线路，排查是否存在接反、虚接、错接、线路破损等问题；2、进入设备工厂设置，核对支付串口配置，确保与当前接入外设型号匹配。
Handling Procedure: 1. Check the physical wiring of the device to identify reversed wiring, loose connections, incorrect connections, or damaged cables. 2. Enter the device factory settings and verify the payment serial port configuration to ensure it matches the currently connected peripheral model.
故障根本原因：设备物理接线错误、线路接触不良或系统串口参数配置不匹配，主机指令正常下发，但外设无法识别有效信号，导致无应答、无数据返回。
Root Cause: Incorrect physical wiring, poor line contact, or mismatched system serial port parameters. Although host commands are sent normally, the peripheral cannot recognize valid signals, resulting in no response and no data return.
故障总结：该故障属于现场接线与参数配置问题，非软件程序故障。日志出现“只发不收”状态，均可判定为接线错误、串口选错或线路接触不良。重新规范接线、匹配对应串口参数后，设备通信可恢复正常。
Summary: This fault is a site wiring and parameter configuration issue, not a software program fault. When the log shows a “send only, no receive” state, it can be determined as incorrect wiring, wrong serial port selection, or poor line contact. After standardizing the wiring and matching the correct serial port parameters, device communication can return to normal.
相关日志
Related Logs
¶ 问题二：通信指示灯异常故障（灯常亮不闪烁）
¶ Issue 2: Abnormal Communication Indicator (Steady On, Not Flashing)
故障现象：刷卡器、纸币器、投币器接入设备后，通信指示灯常亮不闪烁，设备无法初始化、无法正常交易。透传日志可正常发送指令，接收报文为FF异常数据。
Symptom: After the card reader, bill acceptor, or coin acceptor is connected to the device, the communication indicator stays on without flashing. The device cannot initialize or conduct transactions normally. The pass-through log can send commands normally, but the received message is abnormal FF data.
处理过程：1、观察外设指示灯状态，常亮代表硬件通电正常，但未进入MDB通信工作模式；2、检查外设本体物理开关，确认设备MDB协议功能已开启；3、排查设备串口、协议模式是否错乱。
Handling Procedure: 1. Observe the peripheral indicator status. Steady on means the hardware is powered normally but has not entered MDB communication working mode. 2. Check the physical switch on the peripheral itself and confirm that the device MDB protocol function is enabled. 3. Check whether the device serial port and protocol mode are confused.
故障根本原因：外设硬件通电正常、具备基础应答能力，但未手动开启MDB协议模式，设备工作模式不匹配，导致返回FF异常报文，无法正常交互通信。
Root Cause: The peripheral hardware is powered normally and has basic response capability, but the MDB protocol mode is not manually enabled. The device working mode does not match, causing abnormal FF messages to be returned and preventing normal interactive communication.
故障总结：该故障为外设设备模式设置问题，与主机、透传板硬件及程序无关。外设未切换至MDB工作模式，引发通信异常、指示灯常亮、报文异常。开启设备MDB功能开关后，指示灯正常闪烁，通信恢复正常。
Summary: This fault is a peripheral device mode setting issue and is unrelated to the host, pass-through board hardware, or program. The peripheral has not switched to MDB working mode, causing abnormal communication, steady indicator light, and abnormal messages. After enabling the device MDB function switch, the indicator flashes normally and communication returns to normal.
相关日志
Related Logs
¶ 问题三：通信正常但报V01/1000待机断开、无法唤醒支付
¶ Issue 3: Communication Normal but Reports V01/1000 Standby Disconnect, Unable to Wake Up for Payment
故障现象：设备接线、参数配置均正常，日志收发报文无异常，但设备无法唤醒支付交易。日志特征：接收报文为FF，设备主动上报1000待机断开事件。
Symptom: Device wiring and parameter configuration are normal, and log sent/received messages show no abnormality, but the device cannot wake up for payment transactions. Log characteristics: the received message is FF, and the device actively reports a 1000 standby disconnect event.
处理过程：逐一排查硬件接线、外设MDB开关、串口参数均无异常，最终定位为设备固件版本适配问题。
Handling Procedure: Hardware wiring, peripheral MDB switch, and serial port parameters were checked one by one with no abnormality found. Finally, it was identified as a device firmware version compatibility issue.
故障根本原因：旧版本固件对部分新款MDB刷卡器及外设的待机唤醒协议不兼容，设备持续处于待机断开状态，系统无法唤醒设备发起支付交易。
Root Cause: The old firmware version is incompatible with the standby wake-up protocol of some new MDB card readers and peripherals. The device remains in standby disconnect state, and the system cannot wake up the device to initiate payment transactions.
故障总结：该问题为固件版本兼容BUG，新版本固件已完全适配对应外设待机唤醒逻辑。现场升级最新APP程序版本，解决V01/1000待机断开、无法唤醒支付的问题；若升级后问题依旧存在，需对接技术人员深度排查。
Summary: This issue is a firmware version compatibility bug. The new firmware version has fully adapted to the corresponding peripheral standby wake-up logic. Upgrade to the latest APP program version on site to solve the V01/1000 standby disconnect and inability to wake up for payment. If the problem persists after upgrade, contact technical personnel for in-depth troubleshooting.
相关日志
Related Logs
¶ 问题四：刷卡器金额显示不正确（倍率配置错误）
¶ Issue 4: Incorrect Amount Display on Card Reader (Wrong Multiplier Configuration)
故障现象：刷卡器通信、交易、扣款功能均正常，但设备显示金额与实际扣款金额不符，出现金额放大、缩小、错乱等问题。
Symptom: The card reader communication, transaction, and deduction functions are normal, but the amount displayed by the device does not match the actual deducted amount, resulting in enlarged, reduced, or disordered amounts.
处理过程：进入设备工厂设置，核对MDB最小币值倍率参数，检查刷卡主币与设备最小币值的换算比例是否匹配设备规格。
Handling Procedure: Enter the device factory settings, verify the MDB minimum denomination multiplier parameter, and check whether the conversion ratio between the card reader main currency unit and the device minimum denomination matches the device specification.
故障根本原因：工厂倍率参数配置错误，导致外设上报金额与系统解析金额换算错位，最终出现金额显示异常。
Root Cause: Incorrect factory multiplier parameter configuration causes a mismatch between the amount reported by the peripheral and the amount parsed by the system, resulting in abnormal amount display.
故障总结：该故障为参数配置问题，非软硬件故障。标准倍率适配规则：1、倍率=1，适配大金额设备，刷卡范围100255000元；2、倍率=100（设备默认），适配常规小额设备，刷卡范围0.01255元。根据设备规格匹配对应倍率，解决金额显示错误问题。
Summary: This fault is a parameter configuration issue, not a software or hardware fault. Standard multiplier adaptation rules: 1. Multiplier = 1, suitable for large-amount devices, card payment range 100–255,000 yuan. 2. Multiplier = 100 (device default), suitable for regular small-amount devices, card payment range 0.01–255 yuan. Match the corresponding multiplier according to the device specification to solve the incorrect amount display problem.
相关日志
Related Logs
¶ 问题五：NV11纸币器找零失败、金额错乱
¶ Issue 5: NV11 Bill Acceptor Change Dispensing Failure and Amount Confusion
故障现象：NV11纸币器通信正常、可正常收钱入账，但出现找零失败、找零金额错误、吐钞异常等问题。
Symptom: The NV11 bill acceptor communicates normally and can receive and credit money normally, but problems occur such as change dispensing failure, incorrect change amount, and abnormal note dispensing.
处理过程：排查设备接线、固件版本、通信状态均无异常，最终定位为纸币最小币值倍率与设备规格不匹配。
Handling Procedure: Device wiring, firmware version, and communication status were checked with no abnormality found. Finally, it was identified that the bill minimum denomination multiplier did not match the device specification.
故障根本原因：系统工厂倍率参数与NV11纸币器硬件最小面额不对应，金额换算逻辑出错，导致找零指令执行异常、找零失败。
Root Cause: The system factory multiplier parameter does not correspond to the NV11 bill acceptor hardware minimum denomination. The amount conversion logic is incorrect, causing abnormal change dispensing command execution and change dispensing failure.
故障总结：该故障为参数适配问题，需根据纸币器实际规格匹配倍率：1、最小面额1/5 → 倍率1；2、最小面额10/50 → 倍率10；3、最小面额100/500 → 倍率100；4、最小面额1000/5000 → 倍率1000；5、最小面额10000/50000 → 倍率10000。设备默认倍率为1，现场按需调整解决找零异常问题。
Summary: This fault is a parameter adaptation issue. Match the multiplier according to the actual bill acceptor specification: 1. Minimum denomination 1/5 → multiplier 1. 2. Minimum denomination 10/50 → multiplier 10. 3. Minimum denomination 100/500 → multiplier 100. 4. Minimum denomination 1000/5000 → multiplier 1000. 5. Minimum denomination 10000/50000 → multiplier 10000. The device default multiplier is 1. Adjust as needed on site to solve abnormal change dispensing.
相关日志
Related Logs
¶ 问题六：NV9/NV11纸币器未识别到纸币面额
¶ Issue 6: NV9/NV11 Bill Acceptor Does Not Recognize Banknote Denomination
故障现象：NV9、NV11纸币器通信正常，可正常接收纸币，但设备无法识别纸币面额，无对应面额上报数据。
Symptom: NV9 and NV11 bill acceptors communicate normally and can receive banknotes normally, but the device cannot recognize banknote denominations, and there is no corresponding denomination reporting data.
处理过程：排查设备参数、固件、开关配置均无异常，最终核查为现场接线线材不符合MDB标准规格。
Handling Procedure: Device parameters, firmware, and switch configuration were checked with no abnormality found. Finally, it was verified that the on-site wiring cable did not meet MDB standard specifications.
故障根本原因：使用非MDB标准线材接线，导致纸币器读取自身配置信息、面额数据异常，无法正常识别、上报纸币面额。
Root Cause: Non-MDB-standard cable was used for wiring, causing abnormal reading of the bill acceptor’s own configuration information and denomination data, and preventing normal recognition and reporting of banknote denominations.
故障总结：该故障为现场线材不达标导致，非设备软硬件问题。更换合规的MDB标准专用线材后，重新接线测试，恢复纸币面额识别功能。
Summary: This fault is caused by substandard on-site cable, not a device software or hardware issue. After replacing it with compliant MDB-standard dedicated cable and reconnecting for testing, the banknote denomination recognition function is restored.
相关日志
Related Logs
¶ 问题七：刷卡支付成功后设备未自动制作、无退款
¶ Issue 7: After Successful Card Payment, Device Does Not Automatically Produce and No Refund Is Made
故障现象：用户刷卡支付成功，扣款完成后设备未执行制作流程，且系统未自动触发退款，流程卡死。
Symptom: The user makes a successful card payment. After deduction is completed, the device does not execute the production process, and the system does not automatically trigger a refund. The process gets stuck.
处理过程：复盘设备透传日志，排查到设备接收1006拒绝出货指令，导致正常制作流程中断终止，无后续执行动作。
Handling Procedure: Review the device pass-through log and find that the device received a 1006 reject dispensing command, causing the normal production process to be interrupted and terminated, with no subsequent execution action.
故障根本原因：刷卡器硬件主动下发异常拒绝出货指令，打断整机交易流程，导致支付成功后无法出货、无自动退款。
Root Cause: The card reader hardware actively sends an abnormal reject dispensing command, interrupting the whole machine transaction process, resulting in failure to dispense after successful payment and no automatic refund.
故障总结：该故障为刷卡器设备自身指令异常导致，非主机、程序、接线问题。需联系刷卡器原厂技术人员深度排查，确认设备触发1006拒绝出货、不执行退款的底层原因，完成设备固件或硬件问题修复。
Summary: This fault is caused by an abnormal command from the card reader device itself, not by the host, program, or wiring. Contact the card reader manufacturer’s technical personnel for in-depth troubleshooting to confirm the underlying reason why the device triggers 1006 reject dispensing and does not execute a refund, and complete repair of the device firmware or hardware issue.
相关日志
Related Logs
¶ 问题八：CC6100投币器找零金额未找完
¶ Issue 8: CC6100 Coin Acceptor Does Not Dispense Full Change Amount
故障现象
CC6100 投币器通信正常、可正常识别投币、交易流程正常，但设备实际找零金额不完整，存在尾数未找零、找零金额不足的情况。
Symptom
The CC6100 coin acceptor communicates normally, can recognize inserted coins normally, and the transaction process is normal, but the actual change amount dispensed by the device is incomplete. There are cases where the remaining amount is not dispensed or the change amount is insufficient.
处理过程
排查设备接线、固件版本、MDB 倍率参数、通信日志均无异常，排除软件配置与通信问题，最终定位为设备钱箱找零面额库存缺失、部分小面额硬币存量不足。
Handling Procedure
Device wiring, firmware version, MDB multiplier parameters, and communication logs were checked with no abnormality found, ruling out software configuration and communication issues. Finally, it was identified as missing change denomination inventory in the device cash box and insufficient stock of some small-denomination coins.
故障根本原因
设备系统可正常计算全额找零金额，但因实物钱箱内部部分小面额硬币库存不足、空缺，硬件无法吐出完整找零尾数，导致出现找零残留、金额未找完的现象。
Root Cause
The device system can normally calculate the full change amount, but because some small-denomination coins in the physical cash box are insufficient or missing, the hardware cannot dispense the complete remaining change, resulting in residual change and incomplete change dispensing.
故障总结
该故障属于现场物料库存问题，非程序、接线、参数及设备故障。整机通信、协议解析、金额换算均正常。只需现场补齐各档位找零硬币、保证全面额库存充足，即可恢复全额正常找零功能。
Summary
This fault is a site material inventory issue, not a program, wiring, parameter, or device fault. The whole machine communication, protocol parsing, and amount conversion are all normal. It is only necessary to replenish coins for each change denomination on site and ensure sufficient inventory of all denominations to restore full normal change dispensing.
相关日志
Related Logs
¶ 问题九：刷卡支付成功，后台产品 ID 默认显示 0001
¶ Issue 9: Card Payment Successful, Backend Product ID Defaults to 0001
故障现象
用户刷卡支付成功、扣款正常、设备可正常制作出货，但后台订单内产品 ID 固定显示为 0001，无法匹配实际售卖商品。
Symptom
The user makes a successful card payment, deduction is normal, and the device can produce and dispense normally, but the product ID in the backend order is fixedly displayed as 0001 and cannot match the actual product sold.
处理过程
复盘设备透传日志，整机通信、扣款、制作流程均正常，排查确认刷卡交易上报产品 ID 固定为 0001，导致后台订单产品信息显示异常。
Handling Procedure
Review the device pass-through log. The whole machine communication, deduction, and production processes are all normal. Troubleshooting confirms that the product ID reported by card transactions is fixed at 0001, causing abnormal product information display in backend orders.
故障根本原因
旧版程序未适配 MDB 刷卡协议的多商品 ID 上报逻辑，刷卡交易统一默认上报固定产品 ID 0001，无法区分不同商品。
Root Cause
The old program version does not adapt to the multi-product ID reporting logic of the MDB card payment protocol. Card transactions uniformly default to reporting a fixed product ID 0001, making it impossible to distinguish different products.
故障总结
该问题为程序版本适配问题，非接线、硬件、外设故障。升级最新 APP 程序版本后，系统可正常适配对应刷卡商品的独立产品 ID，彻底解决刷卡订单统一显示 0001 的问题。
Summary
This issue is a program version adaptation issue, not a wiring, hardware, or peripheral fault. After upgrading to the latest APP program version, the system can normally adapt to the independent product ID of the corresponding card payment product, completely solving the problem of card payment orders uniformly displaying 0001.
相关日志
Related Logs
¶ 问题十：饮品未制作完成，刷卡器扣款
¶ Issue 10: Card Reader Deducts Payment Before Drink Is Made
故障现象
用户刷卡下单后，饮品处于制作过程中，刷卡器提前主动上报扣款成功，但饮品尚未制作完成。设备硬件功能正常，可正常完成饮品制作及出货操作。
Symptom
After the user places an order by card, the drink is still being made, but the card reader actively reports payment success in advance, while the drink has not yet been completed. The device hardware functions normally and can normally complete drink production and dispensing.
处理过程
1、调取设备MDB透传日志与刷卡器通信日志，核对完整报文交互时序；
2、排查确认：售货机主机未下发1302扣款成功指令，刷卡器自主触发并上报扣款成功事件，与主机业务流程无关；
3、修改刷卡器MDB工作配置，调整设备上报逻辑，仅保留读卡金额事件上报，扣款成功结果统一由主机指令控制；
Handling Procedure
-
Retrieve the device MDB pass-through log and card reader communication log, and verify the complete message interaction sequence.
-
Troubleshooting confirms that the vending machine host did not send the 1302 payment success command. The card reader independently triggered and reported the payment success event, which is unrelated to the host business process.
-
Modify the card reader MDB working configuration and adjust the device reporting logic. Keep only the card read amount event report, and let the payment success result be uniformly controlled by the host command.
故障根本原因
刷卡器MDB协议配置异常，内部交易上报逻辑不符合标准时序。刷卡器读取卡片成功后，自主判定扣款完成并主动上报，未遵循MDB通信规范、未等待售货机主机扣款确认指令。本次故障与售货机主机APP业务流程、设备硬件均无关联。
Root Cause
The card reader MDB protocol configuration is abnormal, and the internal transaction reporting logic does not conform to standard timing. After successfully reading the card, the card reader independently determines that payment is complete and actively reports it, without following MDB communication specifications and without waiting for the vending machine host payment confirmation command. This fault is unrelated to the vending machine host APP business process and device hardware.
故障总结
本次故障为刷卡器参数配置问题导致，非设备程序、硬件故障。原刷卡器逻辑存在缺陷，读卡成功后直接上报扣款完成，造成扣款状态与饮品制作进度不同步。需联系刷卡器原厂技术人员深度排查，确认设备底层原因，完成设备固件或硬件问题修复。
Summary
This fault is caused by a card reader parameter configuration issue, not a device program or hardware fault. The original card reader logic has a defect: after successfully reading the card, it directly reports payment completion, causing the payment status to be out of sync with the drink production progress. Contact the card reader manufacturer’s technical personnel for in-depth troubleshooting to confirm the underlying cause of the device and complete repair of the device firmware or hardware issue.
相关日志
Related Logs
