Logo!
-----
This is a very short description of 
logo, the logic analyser for the 
portfolio.

A logic analyser is a normally very 
expensive device to monitor and 
examine fast digital signals.

You need a portfolio and a parallel 
interface. Connect a ground wire to 
pin 25 and 8 test lines to pins 2 to 
9. Set your portfolio to at least 67 
KByte free memory by using FDISK.

Start the program, then choose a 
trigger method. "Manual" starts 
sampling directly after you have 
chosen a sampling frequency, 
"automatic" waits for one of the 
test wires to change its state. This 
is the default.
Then choose "Sample" and pick the 
desired sampling frequency. The 
number before the slash is the time 
between each sampled data in 
mircoseconds, the number behind it 
is the resulting sampling frequency 
in hertz. If you pick the last entry 
"...", you can enter a time or 
frequency directly. This is mainly 
for long-time samplings.
After you have chosen the frequency 
/ time, sampling starts immediately 
for trigger mode "manual" or when a 
signal change occurs ("automatic").

Then you are brought to the graphics 
screen. The signals from pin 2 are 
on the top of the screen, pin 9 is 
on the bottom. At the bottom of the 
screen you can see the actual 
position in memory. This ranges from 
0 to 32767. Now you have many 
possibilities:
Pressing "->" or "<-" takes you 180 
positions to the left or right. 
Pressing the up- or down-arrows 
takes you even 600 positions left or 
right. Pressing one of the number 
keys brings you to a position 
according to the position of the 
number key (p.ex. 1 to the beginning 
and 5 nearly to the middle.). "n" 
redraws the screen after using the 
internal applications. "f" or "r" 
brings you to the next / last place 
where one of the data signals 
change. <Esc> or <CR> brings you to 
the main menu. To enter graphics 
once more, choose "graphics".
Block functions: Maybe you have 
noticed the little error in 
graphics. This is not a bug, but a 
feature, it is the graphics cursor. 
OK, it is very tiny and ugly, but I 
have nothing better in the moment. 
You can move the first marker by 
pressing "b" and the last marker by 
pressing "e". If the markers are not 
on the screen, the keypress will 
bring them there. Move the marker by 
using the arrow keys, "+" and
"-", finish moving by <CR> and abort 
with <Esc>. If you move the first 
marker past the last marker or vice 
versa, they will change function. 
Look at them, they look differently. 
Now, what to do with these blocks? 
Pressing "o" will calculate an 
overview of the selected range, if 
it is greater than one screen. This 
will, of course, "eat away" the 
details. "s" lets you save the 
marked block on disk, "l" loads an 
already saved block at the position 
of the first marker. The last marker 
will be set at the end of the block. 
The data to be stored is packed by 
using a simple RLE coding technique. 
A german description of the file 
format can be found in LDDFILES.TXT.
"t" puts out the time between the 
markers, "f" the frequency. To make 
an accurate frequency measurement, 
place the markers on rising 
(falling) signals and leave only one 
falling (rising) signal in between. 
"B" or "E" brings you to the 
position of the first or last 
marker. "a" places the first marker 
at position 0 and the last at 32767.
"+" or "-" sets the marked signal 
HIGH or LOW, "*" or "_" (Shift + / -) sets all 8 signals HIGH or LOW. 
This is intended for use with the 
playback function mainly.

Choosing "Online" in the main menu 
shows you the real-time status of 
the test wires. This makes Logo a 
logic probe... The signal from pin 2 
is displayed on the left, pin 9 is 
right. The status is displayed by 
little arrows for high and low. If 
you press <Space>, the status will 
be held (Data Hold) until another 
press.

"playback" was a wish from Jens-Olaf. If you choose the desired 
frequency (see "Sample"), all data 
from memory will be put out on the 
test wires. So make sure not to draw 
too much current (max.  2mA) and 
don't apply any voltage to the test 
wires then. Otherwise your interface 
will be blown up...

"Help" displays various topics to 
choose from. You will see a short 
description of the available 
options.

Now three very interesting things:
a) this is a shareware product. You 
may copy and use it without charge. 
But if you choose to use it 
regularly or for a longer time 
(about 2 month or more), you need to 
pay for it. How much? Pay as much as 
you think is good for it and as much 
as you can afford. I consider about 
10 or 20 US$ as being a good price 
for the complete package including 
FastLogo. But if you are at school 
and can't afford this low price, 
then you may use it for free. 
Commercial and governmental users 
have to contact me before they use 
this program. Changing the program 
code or putting it into own programs 
is forbidden! This program was 
written by Gunnar Thoele, P.O. Box 
70 in D-2569 St.Michaelisdonn, 
Germany. EMail address: 
gthoele@usa.net . Bank account for 
registration fees: Account 
#100083426 at the "Alte Marner 
Sparkasse", german "Bankleitzahl" is 
21851720
Several assembler language routines 
are from Klaus Peichl 
(kspeichl@cip.e-technik.uni-erlangen.de). Many thanks and 
greeting for him!! Without Klaus 
this program would not be what it is 
now.
b) Be careful not to apply voltages 
below 0V or over 5V to your 
interface. It will be blown up 
otherwise. And repairing it is no 
fun. I think you have to change the 
interface chip (a 82C55, SMD 
version) then... But i deny any 
warranty or fitness of this package. 
If you blow up your interface or 
other things, don't blame me...
c) The program directly accesses the 
interface chip and the LCD driver 
chip. So it can't be run on a 
standard PC. But it won't lock the 
PC up, as this case is checked 
for.

Internal
--------
This is programmed in Turbo Pascal 
7, directly on the portfolio. A PC 
was only used for crunching the 
executable file with WWPACK (this is 
a little better than LZEXE) and for 
zipping the package together.
If the detection of the system clock 
should not work, you can start the 
program like "LOGO 65" for 6.5 MHz 
p.ex. Oh, i haven't mentioned yet, 
the menu entries at "Sample" and 
"Playback" depend on the portfolio 
system clock. So, if you make your 
portfolio faster, Logo will be 
faster, too!

Send me your wishes, critics and 
everything you think about this 
program!
Have fun using it!

Gunnar

New Versions available in the 
portfolio mailbox Carlsberg (+49 
6356 989011) and on the WWW at 
http://gunni.home.ml.org/epofo.htm
