Please enable JavaScript to run this help system!
Execu/Tech Systems, Inc.
Knowledgebase
Search:
850-747-0581
Email
Website
Contents
Index
Search
Page Properties
Page Keywords
Page Visibility
Preview For Mobile Device
Lightbox Code & Preview
Save
Cancel
Saving...
Welcome
What's New
System Requirements
Computer Hardware
Other Hardware
Operating Systems
TLS 1.2 Requirements
Data Security
Firewall Settings
Credit Card Interfaces
Software Installation
Installation Checklists
Software Installation - Server
Software Installation - Client
Software Reinstall / Move
Create Shortcut Manually
Software Launcher
Software Updates
Software Update Requirements
Software Updates
Running ETUpdate from update.zip
Software Update without download
Post-Update Requirements
Questions and Answers
Common Questions
Common Mistakes
Sending a Screen Shot
Recording step by step
Glossary
Data Flow
Execu/Tech Services
Execu/Suite Hotel PMS
Setup - Execu/Suite PMS
Preparation/Installation
Getting Started
Data Preparation
Your Company Setup
Zip Code Database
License Access Code
HTML Templates
Manager Menu / Setup
Hotel Control Files Setup
Parameter Record
Season Record
Rooms
Room Types
Tax Codes
Charge Codes
Payment Codes
Guest Packages Setup
Market Segment Codes
Source of Business Codes
Corporate File
Guest Profile Tools
Housekeeping Codes
Yield Management
Meeting Room Parameters
User Defined Comments
Graphical Room View
Auto-Trace Setup
Wholesalers and Travel Agencies
Setup Bullet Points & Notes
Rooms, Room Types, Rates
Charge, Payment, Tax Codes
Guest Packages
User IDs, Passwords, & Security Levels
Parameters & Policies
Guest Profile Tabs and Fields
Market and Source Codes
System Maintenance
User I.D. / Security Setup
PMS Employee Setup
PMS Menu Permissions
Security Levels
Other Settings
Configuration Settings
Editing HTML Letters, Documents and Forms
Email Settings
Thank-you emails
Enable PDF Saving
Hotel Logo
Import Rate Spreadsheets
Master Folios
MENUINI.FIL Configuration
Terminal ID Number Codes-Batch Terminals
Hotel Print Settings
ETHTMLPrint (Print Folios, Reg Card, etc.)
Procedures Execu/Suite PMS
Manager
Manager Procedures
Adjusting Statistics-AM Report
Other Manager Tasks
Manager Reports
Reservations
Reservations Operations
Availability
New Reservations
Guest Profile Entry & Reports
Advance Deposits
Share-withs
Changing Reservations
Cancellations and No-Shows
Reservation Reports & Printouts
Sample Reports
Trace Reports
Front Desk
Front Desk Operations
Availability
Check In
Check In Master Folio
Assign Master Folio to Guest or Group
Guest Folio
Guest Profile
Credit Card Procedures
Guest Packages
Changes - Room, etc.
Posting Charges & Payments
Check Out
Guest History
Housekeeping
Front Desk Reports & Printouts
Night Audit
Night Audit FAQ
Night Audit Procedures
Night Audit Reports
Night Audit Bullet Points
Night Audit Report Viewer
Travel Agency Processing
Travel Agency Setup
Travel Agency Reports
Travel Agency Checks
Clearing Adv. Deposits Remaining
Folio Detail Export
Groups
Guest Name Changes-Profile
Guest Opt-out
Report Generator
How-To Videos and Tutorials
Change Terminal Number
Check In a Guest
Check Out a Guest
ETShortcutWizard
Export Guest Contact Info
Guest Profile Creation
Housekeeping Screen - Changing Status
Interface - Create a Scheduled Task
Posting Charge or Payment to Folio
Transfer Charge or Payment to a Folio
Voiding Charge or Payment in Folio
How-To Documents
Post CC After Check-out
Credit Card Reminders
Change Company Code
Reports - Execu/Suite Hotel PMS
Execu/Suite CRS
Initial Setup
Menu and Navigation
Rooms Setup
Inventory & Availability
Viewing Inventory & Availability
Default Inventory
House Inventory
Periods of Closure
Events and Groups
Room Type Variations/Adjustments
Stop Sale Limits
Availability by Rate Category
Availability by Channel
Allotments
Booking Rules & Closure Date Rules
Calendar quick changes
Minimum Stay Policies
Automated Revenue Rules
Occupancy Rules
Channel / IDS Rules
Products/Rates Setup
Payments - Cancellations
Groups
Setup
Booking
Lookup
Channel Manager
Corporate Client Setup
Services Setup
Force CRS to PMS Sync
Marina and RV Settings
Interfaces
OTA / HTNG
OTA / HTNG Installation and Configuration
OTA / HTNG 2 Way Push
OTA / HTNG 1 & 2 Way Pull
OTA / HTNG Functions and Limitations
OTA / HTNG PMS Settings
OTA / HTNG ROH (Run Of House)
OTA / HTNG Troubleshooting
OTA / HTNG Logs
Phone, Movie, POS, etc.
Comtrol® Interfaces
Comtrol® Network Requirements
Comtrol® Install
Comtrol® Setup
Comtrol® Testing
Comtrol® Resync
Comtrol® Troubleshooting
Legacy Interfaces
Legacy Interface Installation
Communication Settings
Phone Interface Resync
Troubleshooting Serial Connections
Micros POS Interface
Execu/Touch Point Of Sale
POS to Hotel Data Flow
Execu/Touch POS Administrator
Store Record
Departments/ Revenue Centers
Payment Records
Discount Records
Menu Items
Item Modifiers
Item Categories
Combinations (Value Meals)
Employee Records
Employee Work Codes
Void Codes
Table Setup
Terminal Records
Printer Setup
Item Button (Keyboard) Setup
Supervisor Menu
How To - POS Admin
Create POS Item
Execu/Touch POS Procedures
F&B Open a Check
Close a Check with CC
Separate Checks
Split Checks
Split Tendering
Retail Procedures
Reports
Supervisor
Paid-Out Tips and Other
Create TAB
Transfer Checks
Video-Credit Cards in POS
Execu/Touch POS Miscellaneous
POS Cash Management
Dining Reservations
Tableside Wireless Tablets
Edit/ Purge History Records
Add Comment to POS Guest Receipt
Suppress Remote Printing
Use Employee Login Cards
Encode Employee Login Cards
POS Activities Deposits - Setup
POS Activities Deposits - Procedures
Export POS Check Detail (GAPOCKH.TXT)
FUEL sales in POS
POS Copy / Delete Records (GAPOCOPY)
POS Copy all records to another store
POS Copy records from GAPOCNTL.OLD
POS Delete Records
POS Change item fixed tax amount
POS Reset Table Types
POS Resynch employee/password records
POS Copy ONE record to another store
POS Convert gapo999.fin's
POS Printers and Cash Drawers
POS Printer Setup
POS Printer Troubleshooting
Cash Drawer Setup
Configure Bar Code Printer and Labels
Print Bar Codes
Credit Card Processing
Shift4 Credit Card Processing
Shift4 Card Readers (Non-EMV)
Magtek Programming
Shift4 Data Flow
Shift4 Installation
Shift4 UTG Install
Shift4 EMV Setup
Shift4 AuthToken, AccessToken, AccessBlock
Shift4 PMS/POS Setup (MENUS4CO)
Shift4 PMS/POS Setup (Payment Codes)
Shift4 PMS/POS Setup (Other Settings)
Shift4 i4Go V2
Using Shift4 i4Go
Shift4 i4Go V2 Requirements
Shift4 i4Go V2 Errors
Shift4 i4Go V2 PMS / POS Settings
Shift4 i4Go V2 Internet Explorer Trusted Zone
Shift4 Receipt Printer Setup
Shift4 Troubleshooting
Shift4 UTG IP Address and Port
Shift4 Error Codes
Test Shift4 UTG Connection with Telnet
Shift4 Fix (June 19, 2020)
Worldpay Credit Card Processing
Worldpay Critical Setup Info
Worldpay EMV PIN Pad Setup
Worldpay EMV Cloud Config
Worldpay EMV Failure Messages
Worldpay EMV PIN Pad Troubleshooting
Worldpay EMV Data Flow
Worldpay Non-EMV Data Flow
Worldpay Receipt Printer Setup
Credit Card Service Fees / Surcharges
Credit Card Procedures
EMV Credit Card Processing
Switching Gateways/Providers
Inventory Control
Inventory Overview
Inventory Setup
Store, Locations, Classes-Categories
Inventory Items
Recipe File
Inventory Processing
Physical Inventory Entry
Physical Inventory Handheld Scanner
Purchase Orders
Miscellaneous Postings
Enter Waste Adjustments
Batch Updating
Display Item Detail
Inventory Integration
Integration to POS
Integration to A/P
Integration to GL
Inventory Reports
Time & Attendance
Direct Bill / City Ledger
Direct Bill Introduction
Direct Bill Setup
Control Files Setup
Customer Setup
Direct Bill - Execu/Suite PMS Interface
Direct Bill - Execu/Touch POS Interface
Direct Bill - General Ledger Interface
Membership Billing
Direct Bill Procedures
Hotel DB Transfers
Transaction Batches
Open Item Payments
Manual Postings
Fix Out of Balance Direct Bill Accounts
Late Fees
Member Billing
DB Reports and Statements
Transaction Batch Update Report
Customer Aged Trial Balance
Customer Detail Report
Open Item Statements
Balance Forward Statements
A/R Report Generator
Sample Reports
Events and Catering
Getting Started
Event Setup
Sample Reports
Gift Cards (Execu/Gift)
Execu/Gift Setup and Configuration
Selling/Issuing Gift Cards
Redeeming Gift Cards
Manual Entry / Edit / Delete
Donated Gift Cards
Reward cards
Encode Gift Cards
Back Office
General Ledger
GL Setup
GL Processing
GL Integration
GL Reports
Accounts Payable
A/P Setup
A/P Processing
A/P Reports
Condo
Condo Overview
Condo Setup
Condo Procedures
Condo Reports
Payroll
Payroll Setup
PR - GL Interface Setup
Company
Federal Tax Tables
Employee Setup
PR-TimeClock Interface Setup
Payroll Procedures
Payroll Reports
3rd Party Accounting Interfaces
GL Export
DataPlus
QuickBooks
Errors / Fixes
cbl.out Program Missing
Class Not Registered
Cobol Errors
Common System Issues
Company Selection Keeps Appearing
Detail File Update Error
Error: 80040154
File Error: 3000
Find Software Application Folder
Folio Stops Printing (HTMLPRNT.EXE)
Forms Print to Wrong Printer
Forms Print Too Large
LoadEntity invoke failed
Memory Access Violation
Microsoft .NET Framework
Microsoft.Office.Interop
Missing or Broken Shortcut / Icon
Network Benchmark
Rebuild Corrupted File
Rebuild Cross Reference
Register Programs and Controls
Restarting Servers and Terminals
Run Program By Name
Run-time error '429'
Run-time error '-2147319779'
Program Warnings
Cannot Run More Than Once
Could Not Read Card
Current time not set up
In Reorg - Not Posted
Invalid Company Code
Invalid Room Type
Keyboard Record Not Set Up
Record Busy Message
Software License Warning
Terminal Record Not Set Up
Shift4 Errors
Slow / Stuck Software
Start Program Missing
Support File Uploader
Unable to Select Printers
User Account Control (UAC)
What's My Terminal Number?
Execu/Vault
Remote Connection (RemoteET)
Uninstall Old Remote Connection App
Sample Reports
Year-End Procedures
Fiscal Year
Master Folios Year-End
Seasons and Rates
Year-End Advance Deposits
Server and System Health
PCI Compliance
City Ledger - Direct Bill
General Ledger
Accounts Payable
Payroll
Backup and Storage
Training
New Modules
Cloud Hosting
Cloud Hosting Access
Cloud Launcher Install
Cloud Launcher Setup
Cloud Launcher Update
Cloud Access for Mac
Cloud Hosting Preparation
Hosting Network/Hardware Requirements
Important Issues and Settings
Document Access
WebRes
WebRes - Installation
WebRes - Credit Card Processing
WebRes - Shift4
WebRes - Worldpay
WebRes - Customize / Configure
WebRes - Cancellation Policy
WebRes - Confirmation Page and Email
WebRes - Errors / Troubleshooting
Theresa's Test Page 1
Search
:
Index
Bookmark
Print This Article
Login
Edit Page
Publish Draft
Delete Draft
Compare Draft
Edit Header
Home
>
Interfaces
>
Phone, Movie, POS, etc.
>
Legacy Interfaces
>
Troubleshooting Serial Connections
If you're testing ports using the tool provided below, or any other serial port testing tool and can't seem to get any data sent or received, contact your hardware technician. Execu/Tech does not employ hardware technicians and will not be able to assist you. It is the customer's responsibility to ensure that all hardware is properly functioning before contacting Execu/Tech. Contacting a hardware technician who understands serial ports will save you time and money.
This page is provided as a courtesy to those unfamiliar with the different aspects of serial communication. The steps provided on this page should only be performed by someone who feels confident in their abilities and is willing to assume responsibility for any mistakes and damage to hardware that may occur.
Troubleshooting serial hardware and identification of port numbers is the responsibility of you or your hardware technician and not Execu/Tech Systems The hospitality industry employs serial interfaces quite heavily for devices like phone systems, energy management systems, pole displays, printers, scales , etc. If you're unfamiliar with serial communication, we provide some basic troubleshooting steps and a tool that will assist you in troubleshooting your serial hardware. When you've finished troubleshooting, you should be able to provide us with basic information like Call Accounting is on COM1, PBX is on COM2, etc. Finally, be prepared to do a Google search for any terms or procedures that are unfamiliar to you.
Read this Wikipedia article if you need help understanding serial ports.
Many technicians familiar with the needs of the hospitality industry will have a tool similar to this, commonly called an RS323 Tester. The second image shows what the tester looks like with the port open and data transmitting and receiving. the TD and RD lights appear orange because they're flashing between green and red too fast for the camera.
With this tool, you can troubleshoot nearly all serial connection issues. You can quickly and easily determine which serial port you're dealing with, whether or not it's been opened by the interface, and whether or not data is flowing. You can also determine the same information about the 3rd party device. You can buy the simple testers, like this one, for less than $20. You will also want to invest in a couple of DB9 to DB25 adapters, both male and female, so you'll be able to test whatever size port you encounter.
Each tester is a little different so read the manual that comes with yours. With this tester, the lights tell you that while there is power to the serial port, the port has not been opened. Once the port has been opened, the DTR light will turn green. As data passes through the tester, the TD and RD lights will flash green. You should expect similar light activity if you have a similar tester.
When you've tried 'everything' and you still can't seem to get our interface to receive data, it's time to verify which serial port is connected to which interface, and that those serial ports are actually working. To do this, you create a 'loopback' device for the serial port on computer. This device simply connects pins 2 and 3 in the serial port, causing data to flow right back to itself. This allows us to pick a port, send data and see if it returns, letting us know of we have the correct port and if it's functioning.
There should be no expectation that your serial ports are properly labeled. This is normal and that's why you need to identify the ports before our interfaces can be configured. When you're finished with these steps, please label the ports to save time and frustration in the future.
You can, however, make an educated guess as to which serial ports have been assigned which com port numbers. Looking at the computer's Device Manager, in Windows, will tell you which com port is assigned to which serial port. Often, the device's own driver, configuration software or documentation will tell you how to identify the port number, typically left to right starting with the lowest port number. If you have 2 serial ports on the motherboard and COM2 is currently successfully communicating with your phone system and receiving call accounting data, you can logically assume that the other port is COM1, or whichever identity it has been assigned in the Device Manager. These simple steps can be applied to any PCI serial card or USB serial ports like Rocketport or Edgeport and will help you to more quickly identify which com port number has been assigned to which serial port on the back of the computer.
Our interfaces match the settings of your hardware so correct knowledge of your hardware is critical in properly configuring an interface
.
Don't force anything. The pins in serial cables and ports are small and are easily broken if you force them at an incorrect angle.
Before you begin unplugging cables, be sure to label all cables and ports with a letter so you'll know where to return them.
Download our Serial Port Tester application by clicking this link.
Extract it to the computer with the serial ports in question.
Make a 'loopback' plug. The jumper from a hard drive works well for this simple test and most hardware techs have plenty of them. You can also make a proper 'loopback' plug from a female DB9 or DB25 kit. Use the following table for a guide, though it isn't needed for these troubleshooting steps.
DB9
Pins 2, 3
Pins 7,8
Pins 1,4,6,9
DB25
Pins 2,3
Pins 4,5
Pins 6,8,20,22
Stop all Execu/Tech Serial interfaces before running this test.
Unplug the serial cables from the ports being tested.
Attach your 'loopback' plug. The simple 'loopback' plug attaches to pins 2 and 3.
This image shows a hard drive jumper placed on a DB25 (25 pin) male connector. The male DB25 and DB9 (9 pin) connectors use the same numbering of the pins, starting at the top left, with the longest row on top. If in doubt, put on your glasses and look really closely and you may see numbers near each pin. Female connectors have a mirror of the numbering, with pin one being at the top right, with the longest row on top. The first image shows the simple hard drive jumper and the second shows a proper 'loopback' plug made from a discarded serial cable and some wire. The proper 'loopback' adapter took about 15 minutes to make. It isn't pretty but it's free, it works and you won't have to search for a store that sells one. If you don't have time to make the proper 'loopback' plug, you can canabalize a cable and connect pins 2 and 3 together.
Run the Serial Port Tester application.
This application is provided AS IS with NO WARRANTY. We don't provide support outside of this document.
You may copy it, use it and redistribute it as long as the application remains free.
After entering the Serial Port Settings you click the Connect button. If it connects, the status bar at the bottom will read "Serial Port Connected!". If the port didn't open you will see a popup window with an error. Google this error and have your hardware technician help you with a solution.
When testing a serial port with a 'loopback' device, stick with easy settings.
Use: Baud Rate = 1200, Data Bits = 8, Parity = None and Stop Bits = 1, Handshake = None*.
*
Handshake Notes
Xon Xoff is also referred to as 'software' handshaking.
RTS is also referred to as 'hardware' handshaking.
RTS / Xon Xoff combines both 'hardware' and 'software' handshaking.
Most devices require at least Xon Xoff handshaking and won't respond with None so start with Xon Xoff handshaking when testing 3rd party devices if you can't find the manual telling you which setting to use. RTS handshaking won't work unless the devices support it and the cable is properly wired.
You have several options for sending serial data.
These checkboxes affect how the serial data is sent when the Send buttons are clicked.
Send <STX> <ETX> ?
Check this box to wrap the data with <STX> and <ETX>, or Start of Text and End of Text. (Hex 02 and Hex 03)
Send <LRC> ?
Check this box to add a <LRC>, or Longitudinal Redundancy Check to the end of the data. This is a simple Xor of all of the bytes in the data, excluding the <STX>. Don't use this setting if your 3rd party devices uses a different <LRC> formula.
These buttons will send serial data.
Send This String
This button will send the string in the box labeled "String To Send."
Send <ENQ>
This button will send an <ENQ>, or Enquiry. (Hex 05)
Send <ACK>
This button will send an <ACK>, or Acknowledgement. (Hex 06)
Send <NAK>
This button will send a <NAK>, or Negative Acknowledgement. (Hex 15)
A <LF> or Line Feed (Hex 0A) is added to the end of the data before it's sent. This is often require for serial interfaces as a method of letting the other side know you're finished.
After the port is connected, type something in the String To Send box, then click Send This String. If you're connected to the correct port, and your 'loopback' plug is in place, you will see that same string of text in the Received box. When testing using a 'loopback' device, the receive (RxD) and transmit (TxD) indicators will be green because the string is being both transmitted and received through the same port. When testing 3rd party devices, you will typically only see the transmit or receive indicator active and not both at the same time. This is the nature of serial communication. Unless the interface provides responses, you may never see both lights active for a particular interface.
In this image, you see characters at the beginning and ending of the string "This is a test". This is because both checkboxes were checked and what you're seeing is the ASCII representation of the <STX>, <ETX> and <LRC> characters. This is normal and shouldn't be confused with garbage, as discussed in the next step.
Most serial interfaces send plain, readable text. If you see nothing but garbage, like in the picture below, the most likely reason is an incorrect Baud Rate. Change this setting, click the Connect button and have the 3rd party device send the message again.
After you've verified the identity of the serial port, you should label it. It's common for a hospitality server to have several serial ports with no real identification. This lack of identification may be part of the reason you need troubleshooting assistance.
If you don't see anything but you're sure the 'loopback' plug is properly installed, try another com port and click Connect, again. Next, click the Send This String button. Do this until you see the message in the Received box.
If you can't get anything to show, you need to hire a qualified hardware technician to take a look at your serial ports.
After verifying the serial port, you can use this application to test whether or not you are receiving data from the 3rd party device.
Attach the serial cable from the 3rd party device to the serial port that you've just verified.
Set the Serial Port Settings in this application to match those of the 3rd party device on serial port you've just verified and connect.
Have the 3rd party device send data.
Most serial interfaces sent plain, readable text. If you see nothing but garbage, like in the picture below, the most likely reason is an incorrect Baud Rate. Change this setting, click the Connect button and have the 3rd party device send the message again.
If you see the data you were expecting, you've got all the settings right and you're ready to modify the interface settings and restart them.
If you still don't see data, you'll need to work with your hardware technician and 3rd party device vendor to resolve the communication issues. Execu/Tech can't help you until you can verify that data is being received from the 3rd party device.
Article ID
troubleshooting_serial_connections
Views
6478
Last Modified
12/8/2021 10:24 AM
Copyright © Execu/Tech Systems, Inc. All Rights Reserved.
{1}
##LOC[OK]##
{1}
##LOC[OK]##
##LOC[Cancel]##
{1}
##LOC[OK]##
##LOC[Cancel]##