ncoscope - Linux-based PLP/NCP/RFSV Protocol Analyser

Abstract

ncpscope is a simple Linux program that interprets the output of scope, my serial line analyser, as connected to monitor the conversation between a Psion Series 3/5 and a PC running PsiWin/rcom/mclink/slink, etc. This page tells you how to obtain ncpscope and how to build it, install it, and build the cable.

1 Download Instructions
2 The README File

1 Download Instructions

ncpscope is currently at version 0.01 - the first main release. Prior to this, is was available as part of my linux-ncp package, but has proved very useful, and so I've made it into a package in its own right.

You may download it here: ncpscope-0.01.tar.gz.

Then, do this:

gzip -cd ncpscope-x.xx.tar.gz | tar xvf -

(Where x.xx is the version you downloaded).

Then read the file called README. This is displayed below.

2 The README File

ncpscope: a Psion Link Protocol Analyser
========================================

(C) 1999, Matt J Gumbley
Email: matt@gumbley.demon.co.uk
http://www.gumbley.demon.co.uk/ncpscope.html




Introduction
============
This is a PLP/NCP/RFSV protocol analyser, capable of working with the output of
'scope', my serial line analyser program (*), and interpreting the traffic as a
full-duplex link containing PLP/NCP/RFSV frames. 

(*) scope is available at http://www.gumbley.demon.co.uk/scope.html


Tested On...
------------
It was written for Red Hat Linux 4.2/Sparc, Red Hat Linux 6.0/Sparc/Intel,
although it should also compile on other UNIXes.


Licensing
---------
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA


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 NCPScope
===================
1) Capture some serial input with 'scope'. There are some samples in the
examples directory.
2) Run them through ncpscope:
ncpscope < examples/some-example-file | more


TODO
====
* Finish it
* Make RFSV work well enough to decode example sessions.
* Make it work for all SIBO.EPOC protocols

Matt J. Gumbley - matt <at> gumbley <dot> demon <dot> co <dot> uk

ncoscope - Linux-based PLP/NCP/RFSV Protocol Analyser

Table Of Contents

1 Download Instructions

2 The README File