Matt J. Gumbley | Website: http://www.gumbley.me.uk
Blog: On The Edge of Occam's Razor

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.

Table Of Contents



1 Download Instructions

This project or information is dead. I cannot release any code or further information on it, other than what you'll find on this page. All communication regarding it will be silently deleted. Apologies.

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

(C) Matt J. Gumbley 1998-2005 - All Tights Reversed