Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
This
Panel
borderColordarkred
titleColorwhite
titleBGColordarkred
borderStylesolid
titlePurpose

Overview

This troubleshooting guide is intended to

guide

provide the reader

through the 

with a walkthrough about how to troubleshoot the LaundryCard Card Reader Network experiencing one of the following issues:

 

  • Entire, or partial line outages.

 
  • Intermittent single reader outages.

  • Entire store outages.

 

Multiexcerpt include
SpaceWithExcerptcom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@7627108f
MultiExcerptNameContactUs
PageWithExcerptCCIDOC:_Contact Us

On this page

Table of Contents
minLevel1
maxLevel3
outlinefalse
styledefault
typelist
printabletrue

Preliminary steps

Card reader network issues are most commonly caused by:

  1. Overheating from a build-up of lint.

Problem confirmation

Do the displays show up blank
  1. RJ45 (Cat. 5) port corrosion damage.

  2. Chemical vapor, sulfide, or direct contact with water.

  3. One reader has the same unit address as another.

Problem identification

Before troubleshooting the problem, we must identify and log how the system is currently functioning. It is imperative to know what is being affected, how long this has been going on for, and the various points of failure that may be present with this problem. To do this, we must first know what sort of card reader problem is being presented. Ask yourself the following questions and write down their answers:

  1. Do the readers display a blank screen or say "See Attendant/Temporarily out of service"?

Note which
  1. Which lines have

problem readers and find or create a cable layout. Find out which readers are home runs
  1. problems with readers?

    1. Creating a layout or using your store diagram will help guide your troubleshooting process.

  2. Which readers are directly connected to X-Changers A and B

.Confirm whether the system uses Control Heads or a Distribution Board. 
Tip

Write down the affected reader numbers and the primary X-Changer. 

Prerequisite items
  1. ?

  2. Does your system use Distribution boards, V1 Control Heads, or V2 Control Heads?

  3. Which X-Changer is controlling the readers at the present moment?

Gathering materials

Once we’ve asked and answered the above questions, we’ll need to create a checklist of prerequisite materials needed to begin troubleshooting the card reader network. You will need:

  1. Access to both X-

ChangersFunctioning Virtual Private Network (VPN) connection
  1. Changer cabinets.

  2. 8-32 hex bit to unmount readers (if necessary).

  3. Access to washers and dryers.

  4. Spare Cat5/5e Ethernet cables.

  • Optional: Spare LaundryCard card readers. 
      1. It is best practice to have multiple Ethernet cables of various lengths (i.e., 15', 50', and 100').

    1. Network access to the store for CCI Technical Support to connect.

    2. A cable diagram for the technician on-site; the layout may have changed over time so make sure it is

    accurate
    1. up-to-date.

    2. Optional: Ethernet cable tester

    3. Optional: Spare LaundryCard card readers. 

    Before you troubleshoot…

    Finally, before troubleshooting the card reader system we need to verify the following:

    1. Which computer is the Primary database? This one should not be turned off unless database responsibility has been failed over.

    2. Which computer is running the card reader program WCRD in Master/Control mode? The other computer(s) should be running WCRD in Backup mode.

    3. Are all cables physically intact and fully seated in their proper locations? Spare card readers/cables and Cat5 testers are recommended.

    4. Has the Primary database or WCRD Master computer been rebooted recently? If not, it could be running low on memory and having trouble running its applications.

    5. Was there a storm or power surge? If so, there could be damage to the computer or anything connected to it.

    6. Is there a Distribution Board or a Control Head installed? 

    Distribution board

    V1 ControlHead

    V2 ControlHead

    Untitled-20240720-152842.jpgImage AddedUntitled-20240720-152900.jpgImage AddedUntitled-20240720-152912.jpgImage Added
    Note

    CCI Technical Support no longer supports Distribution Boards. For more information please see our list of End of Life and End of Support Products.

    You may have an electrical short

    if...

    if…

    1. The card readers have power but no vend price

    , when they did before
    1. .

    2. The card readers are completely blank

    with no LCD display showing
    1. and the machine display is also blank.

    2. The card reader displays will

    sporadic changes
    1. sporadically change to “See Attendant/Temporarily Out of Service” and then back to its regular vend price.

    2. A red

    “FAULT”
    1. “bad” light

    glowing
    1. appears on the Control Head near one of the line ports (e.g., Local Reader, Lines 0-

    4
    1. 5).

    2. The card reader program (WCRD) cannot stay stable and crashes multiple times until it gives up.

    The following
      1. You will see a gray pop-up window

    recurs
      1. every 10-20 seconds lasting between 5-10 minutes:

    Image Removed
    Card readers receive low poll counts or generate a "WCRD.txt" red line message atop the welcome screen.
      1. Image Added
    1. For Version 1 cabinets: Check the circuit breakers in X-Changer A. There are usually 4 of them ("I" means "ON", "O" means "OFF"). Verify that they are on and have not tripped due to a power surge. If the power breakers are tripped, it may be caused by one of the lines. To identify which line is causing the breakers to trip, unplug all lines and add them back one line at a time to see which line causes the readers to lose communication, or the breaker to trip.

    Line troubleshooting

    Now that we’ve covered all the required preliminary steps to ensure we’ve cleared all other potential components as causing an issue we can focus our attention on the card readers themselves. During this process, we will focus on the reader “Poll” count generated over the card reader network.

    Reader polling

    Poll counts represent the health of communication between card readers and the computer. These counts should be refreshed and referred to often during the troubleshooting process

    . There are 9

    . As of LaundryCard v9.2.0, there are 11 columns in the WCRD section of Store Status, the most commonly

    used are PollCnt and RspOK. Pay

    used are StaPollCntRspOK., ErPollTmOt, and Error Description. Pay attention to the fractions for these two columns; the number before a forward slash should be very close (if not equal) to its counterpart in the neighboring column. If this is not the case, (as illustrated below) be ready to test all cables near the low polls.

    Bad polling

    Good polling

    Image Removed

    Untitled-20240720-153642.pngImage Added

    Image Removed

    Untitled-20240720-153650.pngImage Added

    • MachID: Reader number as identified in LaundryCard application suite (from 001-327~ (MachID number count cannot exceed 327.67 due to (((216-1)-1) property).

    • Adr: Actual reader-assigned address (from 001-255)

    • Lin: Line number (0-4 or 0-5)

    • Sta: Machine Status (1-12) -> Learn More

    • PollCnt: Signals sent to the card reader by the computer

    • RspOK: Signals sent to the computer by

    the card readers

    What to know before you begin

  • Which computer is the Primary database? This one should not be turned off unless database responsibility has been failed over.
  • Which computer is running
    • the card

    reader program WCRD in Master/Control mode? The other computer(s) should be running WCRD in Backup mode.
  • Are all cables physically intact and fully seated in their proper locations? Spare card readers/cables and Cat5 testers are recommended.
  • Is there a Distribution Board or a Control Head installed? 
    Distribution BoardControl Head V1Control Head V2
    1. Image Removed

    Image Removed

    Image Removed

    Note
    titleDistribution Board support

    CCI Technical Support no longer supports Distribution Boards. For more information please see our list of End of Life and End of Support Products.

  • Has the Primary database or WCRD Master computer been rebooted recently? If not, it could be running low on memory and having trouble running its applications.
  • Was there a storm or power surge? If so, there could be damage to the computer or anything connected to it.
  • For Version 1 tall cabinets: Check the circuit breakers in X-Changer A. There are usually 4 of them ("I" means "ON", "O" means "OFF"). Verify that they are on and have not tripped due to a power surge. If the power breakers are tripped, it may be caused by one of the lines. To identify which line is causing the breakers to trip, unplug all lines and add them back one line at a time to see which line causes the
    • readers

    to lose communication, or the breaker to trip.
    1. CCI Technical Support recommends taking a photo of the line cables before disconnecting them. They must be plugged in the same way. 
    Note
    title

    Technician notice

    Check Windows Device Manager to make sure eight SeaLINK+8 ports are still active. If not, right-click the Ports (COM & LPT) group heading and re-scan for hardware changes from that menu. If nothing shows up, you may need to uninstall and then re-install the ports.

    To do this, use the SeaLevel Device Remover application found in D:\Setup\Drivers\SeaLevel. Unplug the USB cable from your SeaPort or Control Head device, then select all ports and remove them using this program; re-connect the USB cable. After installation, if 8 ports are active try to fail WCRD over to the opposite X-Changer. This can refresh the signal to the lines and restore vend prices, though it is still important that the reader

    is able to iconfalsetitleExample scenario

    can pulse (start) equipment. A reboot of the computer may also help.

    Failover the card reader program by logging out of the computer running WCRD Master mode. Before long you will see a change (from Backup to Master) if you check the WCRD section of the Store Status screen at the opposite X-Changer. If this does not bring the line back into service, someone will need to visit the store to continue troubleshooting. In the meantime, check Event Viewer for 'System' and 'Application' error messages that may hint at a hardware or software issue. These will be identified by a red circle with an "X" in the middle. If you find any, double-click them and read the status in the window that appears.

    Image Modified

    Beginning line troubleshooting

    Info

    In this line troubleshooting example, we’ll assume the following is true:

    • X-Changer A (Primary database) has WCRD Master

    • X-Changer B (Backup database) has WCRD Backup

    • Store HAS Control Heads

    • Line 0 is completely down, meaning all readers display “See Attendant/Temporarily Out of Service

    Disconnect the link between X-Changers A and B. This crossover cable (P/N: C-1036) is thick and gray

    in color

    with RS232 (thumb screw) connections at both ends and can be unplugged from either Control Head. In the case of an older store, this cable will be located at the bottom of a green Distribution Board mounted vertically in the cabinet. This forces one computer to control vend prices only. 

    Image RemovedImage Removed

    V1 ControlHead TOVC

    Distribution Board TOVC

    V2 ControlHead TOVC

    Image AddedImage Added

    image-20240720-155204.pngImage Added

    Disconnect Line 0 at X-Changer B and use Windows Task Manager to end the process WCRD on X-Changer A; the application KeepAGoin will restart WCRD. If a red light labeled "FAULT" is glowing, the Control Head device has detected an electrical short, and all cables on this line should be tested. For version 1 cabinets there is no fault light, and line 0 would be second from the top.

    Image RemovedImage Removed

    V1 ControlHead Fault Light

    V2 ControlHead Fault Light

    Distribution Board Fault Light

    Image Added

    image-20240720-155632.pngImage Added

    Image Added

    Poll counts give clues as to where the problem is; you will see a change in the level of communication. If not, try this method:

    Find the middle-most card reader and unplug both network cables so it loses power. For this

    eX-Changer Ample

    example, readers on the X-Changer B side will go blank. Reset power to the side being tested (unplug/replug line 0 at X-Changer A) to make sure the electric current is refreshed after being disconnected from the other half of line 0. If readers show the vend price on the X-Changer A side after a few minutes, the problem is likely on the X-Changer B side which was previously blank.

    Image RemovedImage Removed
    Image AddedImage Added

    Plug the middle-most reader back in and repeat the process at the halfway point of the readers which were previously blank. If only a few come back to normal, the problem is probably with a cable that connects a functional reader to one that's out of order. Continue this way until you observe one connection that brings the entire line down, then test and/or replace that cable. Sometimes Cat. 5 ports on card readers stop working, always try both ports when testing.

    An alternate way of doing the same thing is to connect one card reader at a time beginning with the "home run" back to the WCRD Master cabinet. If vend prices do not display with even one card reader connected, then the "home run" cable or a device inside the cabinet may be the issue. At which point you should fail WCRD over and try testing from the opposite direction. After adding a reader, be sure it loads prices and can pulse (start) equipment before moving on. As previously stated, a bad connection will eventually be made that prevents a new one from being added and/or takes the previously connected and functioning readers back out of service. 

    Monitoring during troubleshooting

    The Card Reader/Line Status section of Store Status (

    Click

    click here for info regarding Version 8 Store Status) is a clear indicator of which line(s)/reader(s) are inoperative. The refresh rate can be anywhere between less than 10 seconds to up to approximately two (2) minutes for an update to process.

    Info
    title

    Version 9 Only

    /wiki/spaces/SD/pages/7900272

    T-Sentry's WCRD Monitor allows real-time line polling and monitoring with an immediate reactive response based on whatever actions are taken on card reader(s)/line(s).

    After the faulty items have been repaired

    1. Plug Line 0 back into X-Changer B (Backup WCRD computer) and make sure all connections to card readers are fully

    -
    1. seated.

    2. Re-connect the crossover cable, then unplug Lines 0-4 on X-Changer A to make sure the readers will work on a signal from the crossover only.

    3. Fail WCRD to the other computer and repeat the tests, making sure the store can run the

    Cat.5
    1. Cat5 lines alone, and then through the crossover cable.

    2. Test and start the equipment again if desired

    .

    Card reader problem causes

    Overheating from a build-up of lint

    Related Guides

    1. .

  • RJ45 (Cat. 5) port corrosion damage.
  • Chemical vapor, sulfide, or direct contact with water.
  • One reader has the same unit address as another.
  • Filter by label (Content by label)
    showLabelsfalse

    showSpace

    maxCheckboxfalse
    sortmodified
    showSpacefalse
    reversetrue
    titleRelated articles
    excludeCurrenttrue
    cqllabel in ( "controlhead" , "wcrd" ) and type = "page" and space in ( "LG" , "LCV8" , "LCV9" )