Skip to content

Commit c856061

Browse files
tschak909tschak909
committed
[fujinet-for-atari-users] grinding through what is.
1 parent 6efc6bf commit c856061

File tree

7 files changed

+2657
-1
lines changed

7 files changed

+2657
-1
lines changed

‎fujinet_for_atari_users/figs/fujinet-by-itself-transparent.svg‎

Lines changed: 410 additions & 0 deletions
Loading

‎fujinet_for_atari_users/figs/fujinet-by-itself.svg‎

Lines changed: 410 additions & 0 deletions
Loading

‎fujinet_for_atari_users/figs/virtual_network.png‎

22.9 KB
Loading

‎fujinet_for_atari_users/figs/virtual_network.svg‎

Lines changed: 1027 additions & 0 deletions
Loading

‎fujinet_for_atari_users/figs/virtual_printer.png‎

13.6 KB
Loading

‎fujinet_for_atari_users/figs/virtual_printer.svg‎

Lines changed: 432 additions & 0 deletions
Loading

‎fujinet_for_atari_users/fujinet_for_atari_users.dbk‎

Lines changed: 378 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
multiple platforms. You all have given the FujiNet team the drive and
3434
determination to make FujiNet a comprehensive</para>
3535

36-
<para> platform to connect all of our retro-computing and retro-gaming
36+
<para>platform to connect all of our retro-computing and retro-gaming
3737
systems together to do new and fun things.</para>
3838
</dedication>
3939

@@ -96,6 +96,10 @@
9696
<para><personname> <firstname>Benjamin</firstname>
9797
<surname>Krein</surname> </personname></para>
9898
</listitem>
99+
100+
<listitem>
101+
<para><personname><firstname>Andy</firstname><surname>Diller</surname></personname></para>
102+
</listitem>
99103
</itemizedlist>
100104
</acknowledgements>
101105

@@ -206,5 +210,378 @@
206210
</mediaobject>
207211
</figure>
208212
</section>
213+
214+
<section>
215+
<title>Virtual Printer "P:"</title>
216+
217+
<para>FujiNet also provides a virtual printer device, which works
218+
exactly the same as a physical printer attached directly to the
219+
<trademark class="registered">ATARI</trademark> computer. When a program
220+
sends something to the "P:" device, the FujiNet will simulate one of
221+
more than a dozen available virtual printers. The end result is rendered
222+
into a document which can be read in a viewer, or sent to a modern
223+
printer.</para>
224+
225+
<figure>
226+
<title>Virtual Printer</title>
227+
228+
<mediaobject>
229+
<imageobject>
230+
<imagedata fileref="figs/virtual_printer.png" scale="75"/>
231+
</imageobject>
232+
</mediaobject>
233+
</figure>
234+
235+
<para>The following printers are supported:</para>
236+
237+
<variablelist>
238+
<varlistentry>
239+
<term>RAW</term>
240+
241+
<listitem>
242+
<para>The printer data is sent as-is, with no conversion.</para>
243+
</listitem>
244+
</varlistentry>
245+
246+
<varlistentry>
247+
<term>TRIM</term>
248+
249+
<listitem>
250+
<para>Like RAW, but everything after an ATASCII EOL is
251+
truncated.</para>
252+
</listitem>
253+
</varlistentry>
254+
255+
<varlistentry>
256+
<term>ASCII</term>
257+
258+
<listitem>
259+
<para>Like RAW, but every non-ASCII character is ignored.</para>
260+
</listitem>
261+
</varlistentry>
262+
263+
<varlistentry>
264+
<term><trademark class="registered">ATARI</trademark>
265+
<trademark>820</trademark></term>
266+
267+
<listitem>
268+
<para>A 40 column dot matrix impact printer. Used a 5x7 font with
269+
ASCII characters. Printed to 3 7/8 inches (98.425mm) width paper.
270+
Could also print sideways (vertical). Outputs in
271+
<filename>PDF</filename>. Matches the 400/800 systems.</para>
272+
</listitem>
273+
</varlistentry>
274+
275+
<varlistentry>
276+
<term><trademark class="registered">ATARI</trademark>
277+
<trademark>822</trademark></term>
278+
279+
<listitem>
280+
<para>A 40 column thermal printer. Used a 5x7 font with ASCII
281+
characters. Printed to 4 7/16" (112.7125mm) width thermal paper.
282+
Could also print dot graphics. Outputs in
283+
<filename>PDF</filename>. Matches the 400/800 systems.</para>
284+
</listitem>
285+
</varlistentry>
286+
287+
<varlistentry>
288+
<term><trademark class="registered">ATARI</trademark><trademark>
289+
825</trademark></term>
290+
291+
<listitem>
292+
<para>An 80 column dot matrix impact printer. Supported normal,
293+
elongated, and condensed fonts in 10 and 16.7 characters per inch
294+
widths. Could also support reverse line feeds (which could be
295+
used, e.g. to make multi-column text in AtariWriter), and other
296+
advanced features. Outputs in <filename>PDF</filename>. Matches
297+
the 400/800 systems.</para>
298+
</listitem>
299+
</varlistentry>
300+
301+
<varlistentry>
302+
<term><trademark class="registered">ATARI</trademark>
303+
<trademark>1020</trademark></term>
304+
305+
<listitem>
306+
<para>A plotter which can draw calligraphic graphics using a pen,
307+
and one of four colors (red, green, blue, and black). Unlike most
308+
of the other printers in this list, this printer outputs in
309+
<filename>SVG</filename>. Matches the XL systems.</para>
310+
</listitem>
311+
</varlistentry>
312+
313+
<varlistentry>
314+
<term><trademark class="registered">ATARI</trademark>
315+
<trademark>1025</trademark></term>
316+
317+
<listitem>
318+
<para>An 80 column dot matrix impact printer. Uses a 5x7 font with
319+
ASCII characters. Printed to either single sheets or fan-fold
320+
tractor fed paper anywhere from 4.5 to 8.5 inches (114.3 to
321+
215.9mm) wide. Could accept tractor feed or friction fed paper.
322+
Could also accept an automatic document feeder attachment. Outputs
323+
in <filename>PDF</filename>. Matches the XL systems.</para>
324+
</listitem>
325+
</varlistentry>
326+
327+
<varlistentry>
328+
<term><trademark class="registered">ATARI</trademark>
329+
<trademark>1027</trademark></term>
330+
331+
<listitem>
332+
<para>An 80 column letter quality printer. The print font is very
333+
close to Prestige Elite. Outputs in <filename>PDF</filename>.
334+
Matches the XL systems.</para>
335+
</listitem>
336+
</varlistentry>
337+
338+
<varlistentry>
339+
<term><trademark class="registered">ATARI</trademark>
340+
<trademark>1029</trademark></term>
341+
342+
<listitem>
343+
<para>An 80 column dot matrix impact printer. Used a 5x7 font,
344+
with only ASCII characters. Released in limited quantities in
345+
Europe. Outputs in <filename>PDF</filename>. Matches the XL
346+
systems.</para>
347+
</listitem>
348+
</varlistentry>
349+
350+
<varlistentry>
351+
<term><trademark class="registered">ATARI</trademark>
352+
<trademark>XMM801</trademark></term>
353+
354+
<listitem>
355+
<para>An 80 column dot matrix impact printer. Epson MX80 and FX80
356+
compatible. Contains many font widths. Can handle NLQ
357+
(near-letter-quality) mode. Outputs in <filename>PDF</filename>.
358+
Matches the XE systems.</para>
359+
</listitem>
360+
</varlistentry>
361+
362+
<varlistentry>
363+
<term><trademark class="registered">ATARI</trademark>
364+
<trademark>XDM121</trademark></term>
365+
366+
<listitem>
367+
<para>An 80 column letter quality daisy wheel printer. Produced
368+
letter quality output. Outputs in <filename>PDF</filename>.
369+
Matches the XE systems.</para>
370+
</listitem>
371+
</varlistentry>
372+
373+
<varlistentry>
374+
<term><trademark class="registered">EPSON</trademark>
375+
<trademark>MX80</trademark></term>
376+
377+
<listitem>
378+
<para>An 80 column dot matrix impact printer with graphics
379+
printing capability, as well as configurable font widths. Widely
380+
considered the standard for dot matrix printers in the 1980s.
381+
Outputs in <filename>PDF</filename>. This is the printer to use
382+
with <trademark>The Print Shop.</trademark></para>
383+
</listitem>
384+
</varlistentry>
385+
386+
<varlistentry>
387+
<term><trademark class="registered">OKI Data</trademark>
388+
<trademark>OkiMate 10</trademark></term>
389+
390+
<listitem>
391+
<para>A thermal wax printer capable of printing vivid color
392+
graphics. Outputs in <filename>PDF</filename>.</para>
393+
</listitem>
394+
</varlistentry>
395+
396+
<varlistentry>
397+
<term>GRANTIC</term>
398+
399+
<listitem>
400+
<para>An implementation of Claus Buchholz's "PRANTIC" screen
401+
capture to printer device. Outputs in
402+
<filename>PNG</filename>.</para>
403+
</listitem>
404+
</varlistentry>
405+
406+
<varlistentry>
407+
<term>HTML Printer</term>
408+
409+
<listitem>
410+
<para>Useful for printing out program listings, as it embeds the
411+
ATASCII font.</para>
412+
</listitem>
413+
</varlistentry>
414+
</variablelist>
415+
</section>
416+
417+
<section>
418+
<title>Virtual MODEM "R:"</title>
419+
420+
<para>FujiNet also provides a virtual MODEM device by combining
421+
emulation for an <trademark class="registered">ATARI</trademark>
422+
<trademark>850</trademark> interface, and a <trademark
423+
class="registered">Hayes</trademark> compatible modem with AT
424+
instruction set. The resulting virtual device is compatible with
425+
existing communications programs that use the "R:" device, and can be
426+
used to dial hobbyist Bulletin Board Systems (BBS) hosts over raw or
427+
TELNET connections.</para>
428+
429+
<para>The following terminal emulator programs have been tested with
430+
FujiNet:</para>
431+
432+
<itemizedlist>
433+
<listitem>
434+
<para>ICE-T</para>
435+
</listitem>
436+
437+
<listitem>
438+
<para>BobTerm</para>
439+
</listitem>
440+
441+
<listitem>
442+
<para>Express!</para>
443+
</listitem>
444+
445+
<listitem>
446+
<para>AMODEM Plus</para>
447+
</listitem>
448+
449+
<listitem>
450+
<para><trademark class="registered">ATARI</trademark> Telelink
451+
I</para>
452+
</listitem>
453+
</itemizedlist>
454+
455+
<para>The MODEM emulation also supports opening a listening socket that
456+
can accept a single incoming connection. This allows existing BBS
457+
programs to be used as-is to accept TELNET or raw connections from
458+
potential "callers."</para>
459+
460+
<para>The following BBS programs have been tested with FujiNet:</para>
461+
462+
<itemizedlist>
463+
<listitem>
464+
<para>AMIS BBS</para>
465+
</listitem>
466+
467+
<listitem>
468+
<para>BBS Express 1.0, 2.0, 5.0</para>
469+
</listitem>
470+
471+
<listitem>
472+
<para>FoReM-26M, FoReM XE Professional 5.4</para>
473+
</listitem>
474+
</itemizedlist>
475+
</section>
476+
477+
<section>
478+
<title>Network Adapter "N:"</title>
479+
480+
<para>Finally, FujiNet provides a totally new <filename>N:</filename>
481+
device for your <trademark class="registered">ATARI</trademark>
482+
computer. This device brings not only any local network; the wider
483+
Internet, accessible from any program or programming language that
484+
accepts a devicespec, such as <trademark
485+
class="registered">ATARI</trademark><trademark> BASIC, or
486+
AtariWriter</trademark></para>
487+
488+
<para>This is made possible by the addition of <emphasis>protocol
489+
adapters</emphasis> which perform all the heavy lifting for the complex
490+
protocols used by the modern Internet. These adapters run on the FujiNet
491+
itself, and utilize its increased processing power to create an easy to
492+
use I/O channel for the <trademark class="registered">ATARI</trademark>
493+
computer.</para>
494+
495+
<figure>
496+
<title>The HTTP Protocol Adapter</title>
497+
498+
<mediaobject>
499+
<imageobject>
500+
<imagedata fileref="figs/virtual_network.png" scale="73"/>
501+
</imageobject>
502+
</mediaobject>
503+
</figure>
504+
505+
<para>Once you have loaded a DOS disk with the "N:" handler, you can,
506+
for example, load a BASIC program, directly from a web server:</para>
507+
508+
<sidebar>
509+
<example>
510+
<title>Loading a BASIC Program from a Web Server</title>
511+
512+
<screen>READY
513+
RUN"N:HTTP://FUJINET-TESTING.IRATA.ONLINE/BLACKJACK.BAS"</screen>
514+
</example>
515+
</sidebar>
516+
517+
<para>Similarly, opening a connection to a TCP socket to host
518+
192.168.0.123 port 1234 is as simple as:</para>
519+
520+
<sidebar>
521+
<example>
522+
<title>Opening a TCP socket in BASIC</title>
523+
524+
<screen>READY
525+
OPEN #1,12,2,"N:TCP://192.168.0.123:1234/"</screen>
526+
527+
<itemizedlist>
528+
<listitem>
529+
<para>12 = READ and WRITE</para>
530+
</listitem>
531+
532+
<listitem>
533+
<para>2 = Translate Line-feeds into ATASCII EOL (UNIX line
534+
endings)</para>
535+
</listitem>
536+
</itemizedlist>
537+
</example>
538+
</sidebar>
539+
540+
<para>Once a connection is opened, writing to it is equally as
541+
simple:</para>
542+
543+
<sidebar>
544+
<example>
545+
<title>Writing to a TCP socket in BASIC</title>
546+
547+
<screen>READY
548+
PRINT #1;"HELLO FROM THE ATARI"</screen>
549+
550+
<para>The EOL here is translated into a UNIX line feed, because of
551+
how the connection was previously opened.</para>
552+
</example>
553+
</sidebar>
554+
555+
<para>Reading from an open connection, is as simple as writing to
556+
it:</para>
557+
558+
<sidebar>
559+
<example>
560+
<title>Reading from a TCP socket in BASIC</title>
561+
562+
<screen>READY
563+
DIM A$(99)
564+
565+
READY
566+
INPUT #1,A$
567+
568+
READY
569+
PRINT A$
570+
Testing from PC.</screen>
571+
</example>
572+
</sidebar>
573+
574+
<para>When done with a connection, it can be closed. FujiNet will then
575+
disconnect the socket.</para>
576+
577+
<sidebar>
578+
<example>
579+
<title>Closing the previously opened TCP socket</title>
580+
581+
<screen>READY
582+
CLOSE #1</screen>
583+
</example>
584+
</sidebar>
585+
</section>
209586
</chapter>
210587
</book>

0 commit comments

Comments
 (0)