[Image] [Image] Matt J. Gumbley - http://www.gumbley.demon.co.uk
[Ceci n'est ce pas Matt Gumbley]
scope - Linux Serial Line Analyser
Updated Thu Abstract
Feb 17
20:48:16 2000 scope is a simple Linux program that allows you to capture data
flowing between two devices that communicate over a 7-wire (or fewer)
RS232 serial connection. To do this, it requires a special cable. This
Site Map page tells you how to obtain scope and how to build it, install it,
> Site Home and build the cable.
page
> Matt's home Table Of Contents
page
> Angela's * 1 Download Instructions
home page * 2 The README File
> Our Wedding
Pages ---------------------------------------------------------------------------------
Personal 1 Download Instructions
> Online CV
> Family scope is currently at version 0.01 - the first main release. Prior to this, is
history was available as part of my linux-ncp package, but has proved very useful, and
> My Day Job so I've made it into a package in its own right.
Projects You may download it here: scope-0.01.tar.gz.
> Latest News
> The Crypt Then, do this:
> (Old, Dead
Projects) gzip -cd scope-x.xx.tar.gz | tar xvf -
Miscellaneous
> SigChange (Where x.xx is the version you downloaded).
> Home Page
Sync Then read the file called README. This is displayed below.
> HTML Macro ---------------------------------------------------------------------------------
System
Psion EPOC 2 The README File
> Overview
> Mixed Scope: A Serial Line Analyser/Logger for Linux
Language (and possibly other UNIX systems)
Programming ==============================================
> GDB Debug
Stub (C) 1999, Matt J Gumbley
> hForth Port Email: matt@gumbley.demon.co.uk
> Disassembler http://www.gumbley.demon.co.uk/scope.html
Psion SIBO
> All SIBO
projects are
in Introduction
> The Crypt ============
Linux Scope is a general-purpose serial line monitor, capable of recording the traffic
> Toshiba on an RS232 cable (if provided with a suitable cable and recording computer).
40xx & Linux
> Network-RS232
Bridge Tested On...
> Psion ------------
Protocol It was written for Red Hat Linux 4.2/Sparc, Red Hat Linux 6.0/Sparc,
Analyser although it should also compile on other UNIXes.
> Serial Line
Analyser
> Work on Licensing
plptools ---------
> Psion .img This program is free software; you can redistribute it and/or modify
tools it under the terms of the GNU General Public License as published by
> Happy the Free Software Foundation; either version 2 of the License, or
Badger Linux (at your option) any later version.
> Linux Psion
Link Ideas This program is distributed in the hope that it will be useful,
Amateur Radio but WITHOUT ANY WARRANTY; without even the implied warranty of
> Amateur MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
Radio GNU General Public License for more details.
Software
You should have received a copy of the GNU General Public License
Popularity along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
> accesses so
far..
[Image]
Building and Installing
=======================
1) In the main directory (NOT src), type 'make'
2) As 'root', in the main directory, type 'make install' to install the
scope program under /usr/local/bin.
Edit the Makefile, and change PREFIX to whatever you need for your system.
How to Use Scope
================
Basically, scope will monitor /dev/ttyS0 and /dev/ttyS1, with output on
standard out, at 19200 bps. Use the -d option to suppress the control/status
line data (since that's not 100% working), and use other options to control
speed, different ports, verbosity etc.
scope -h will give a short help file; there is no man page.
Capture the output in a file, and use this as input to some of my other
programs, such as ncpscope.
The Special Serial Cable
------------------------
Scope works best when used in conjunction with a special serial cable.
This cable goes inline between the two devices that you want to monitor, and
splits signals on the "main" line into two serial ports which are monitored
simultaneously to provide a composite view of the current line status.
The cable I use connects to a Sun SparcStation 5, which has two serial ports,
both D25's - similar to a PC. On a Sparc 10, the two ports (A/B) are housed in a
single socket - the cable is wired as follows:
SUN PORT A FEMALE MALE SUN PORT B
D25 D25 MALE D25
1 - FG ----- 1
2 - TD ----- 2 ------ SRD 16
3 - RD --------- 3 - RD ----- 3
4 - RTS ---- 4 ----- SCTS 13
5 - CTS -------- 5 - CTS ---- 5
6 - DSR -------- 6 - DSR ---- 6
7 - GND -------- 7 - GND ---- 7
8 - DCD -------- 8 - DCD ---- 8
20 - DTR ---- 20 ----- SDCD 12
22 - RI ----- 22
Basically, the first port is used to read most lines, and the second port is
used to read TD, RTS and DTR, which are read on the input lines RD, CTS and DCD
So wire the second plug:
2 ----------- 3
4 ----------- 5
20 ----------- 8
DISCLAIMER
==========
Standard disclaimer applies. If you blow up your systems
with this, don't blame me - it works fine (ish) for me.
TODO
====
* Put it all under GNU autoconf
* Make it work properly on Intel Linux (CRTSCTS undeclared for some reason)
- this ioctl option is not used on Intel.
* Use select(), don't poll.
* Add pass-through mode (for Charlie Stross) - anything coming in on one port is
echoed to another.
Matt J. Gumbley - matt@gumbley.demon.co.uk
(
geocities.com/tutorman_2000)