summaryrefslogtreecommitdiffstats
path: root/network/fujinet-pc/fujinet-pc.rst
blob: 0296f813df975e5f8121083d7fa609a3cd2df8c1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
.. RST source for fujinet-pc(1) man page. Convert with:
..   rst2man.py fujinet-pc.rst > fujinet-pc.1
.. rst2man.py comes from the SBo development/docutils package.

.. |version| replace:: 2206.1
.. |date| date::

==========
fujinet-pc
==========

-----------------------------------------------------------------
peripheral emulator and network adaptor for Atari 8-bit computers
-----------------------------------------------------------------

:Manual section: 1
:Manual group: SlackBuilds.org
:Date: |date|
:Version: |version|

SYNOPSIS
========

fujinet-pc [**-V**] [**-u** *host:port*] [**-c** *config-file*] [**-s** *SD-directory*]

DESCRIPTION
===========

FujiNet is a network adaptor for the Atari 8-bit line of computers. It
has many features, including the ability to netboot the Atari from a
disk image on an Internet TNFS server. It's a piece of hardware which
plugs into the Atari's SIO port and connects to a wireless network.

fujinet-pc is a Linux port of the FujiNet firmware, which allows using
most of the FujiNet's features with just an SIO2PC cable and a PC.

FujiNet features that work with fujinet-pc:

  - Disk drive (D:) emulation with support for ATR disk images and XEX files (no ATX yet)
  - Modem emulation (R:)
  - Printer emulation (P:)
  - APETIME protocol
  - TNFS File System to access image files over network
  - Web interface to control program's settings, browse TNFS hosts and mount disk images
  - FujiNet network device (N:) with support for various network protocols:
    TCP, UDP, TNFS, HTTP, FTP, Telnet **[\*]**

Not (yet) working:

  - CP/M emulation
  - SSH and SMB support for N:
  - SAM voice synthesizer
  - MIDIMaze support
  - Program recorder (tape) emulation

**[\*]** Note that some applications using the N: device may rely on the SIO
**PROCEED** line being connected. Most SIO2PC cables don't have this
line connected.

OPTIONS
=======

**-V**
  Print version number (including build date and OS).

**-u** *host:port*
  Host interface and port to listen on, for the web user interface. Default is
  **0.0.0.0:8000**, meaning TCP port 8000 on all interfaces. To access the
  web UI, point a browser at e.g. **http://localhost:8000**. Leaving off
  the *:port* isn't actually an error, but it causes **fujinet-pc** to
  choose a random port number (which it doesn't tell you; you'd have
  to use **netstat**\(8) to find it).

**-c** *config-file*
  Use *config-file* instead of the default **fnconfig.ini**.

**-s** *SD-directory*
  Use *SD-directory* instead of the default **SD/** for the virtual
  SD card.

FILES
=====

**~/.fujinet-pc/**
  The default directory for **fujinet-pc**, containing the following:

**fnconfig.ini**
  The default config file for **fujinet-pc**. This is where settings
  are saved when they're changed with the web user interface. This file
  can also be edited with a regular text editor.

**SD/**
  The FujiNet hardware device has a slot for a Micro-SD card. For fujinet-pc,
  the contents of this directory will be available in the host list, under
  the name **SD**. The default contents of this directory include a good
  selection of DOS and utility disk images.

.. AUTHOR
.. ======
.. normally I would put the upstream author's name here, but I have
.. no idea what it is. The github user is just called FujiNetWIFI,
.. and I haven't found any contact info anywhere in the source git
.. repo. *shrug*.

COPYRIGHT
=========

See the file /usr/doc/fujinet-pc-|version|/LICENSE for license information.

SEE ALSO
========

**atariserver**\(1), **tnfsd**\(1), **tnfs-fuse**\(1)

The fujinet-pc homepage: https://github.com/FujiNetWIFI/fujinet-pc

The FujiNet documentation wiki: https://github.com/FujiNetWIFI/fujinet-platformio/wiki