bc36e9dde5
It also modifies the HP 2100 and PDP11 multiplexers to add serial support as demonstrations of the capability that, one day, might be extended to all simulators. I have tested the HP support, but I relied on Holger Veit to test the DEC stuff, so I can't guarantee that it works. I also relied on Holger to test under Linux, so the same caveat applies.
The changes needed in the device simulators are relatively small. For example, if you look at the patches for "hp2100_baci.c", you'll note that most of them are documentation changes. The only things of note are:
- an expansion of the TMXR initializer
- additional code in the "attach" routine to try attaching a serial port
if attaching a socket fails
- additional code in the "detach" routine for the same reasons
The HP MPX device (hp2100_mpx.c) needs a tiny bit of additional support from the ATTACH and DETACH commands. Specifically, SCP was modified to set a flag ("sim_unit_ref") to indicate whether ATTACH MPX or ATTACH MPX0 was done, i.e., to differentiate between a device and a unit attach (recall that SCP treats these as both referring to unit 0). This is needed because the socket attaches (logically) to the device, whereas a serial port attaches to a line. Without this flag, the attach routine cannot differentiate between ATTACH MPX and ATTACH MPX0, as the distinction is lost by the time the VM's attach routine is called. This support isn't needed for the HP MUX device because the socket attaches to a different device than the lines do.
MPX also requires a bit more work due to the capability to mix serial and Telnet lines on the same multiplexer (BACI is a single-line terminal device).
The attached PDF contains revisions to the "Writing a Simulator for the SIMH System" publication that documents the additions and changes to the multiplexer library for serial port support. User documentation for serial port support currently exists only in the initial comments in "sim_tmxr.c"; I will add the appropriate text to the "SIMH User's Guide" if we decide to add this to the release version.
139 lines
7.5 KiB
C
139 lines
7.5 KiB
C
/* sim_tmxr.h: terminal multiplexor definitions
|
|
|
|
Copyright (c) 2001-2008, Robert M Supnik
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a
|
|
copy of this software and associated documentation files (the "Software"),
|
|
to deal in the Software without restriction, including without limitation
|
|
the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
and/or sell copies of the Software, and to permit persons to whom the
|
|
Software is furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
all copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
ROBERT M SUPNIK BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
|
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
|
|
Except as contained in this notice, the name of Robert M Supnik shall not be
|
|
used in advertising or otherwise to promote the sale, use or other dealings
|
|
in this Software without prior written authorization from Robert M Supnik.
|
|
|
|
Based on the original DZ11 simulator by Thord Nilson, as updated by
|
|
Arthur Krewat.
|
|
|
|
17-Jan-11 MP Added buffered line capabilities
|
|
20-Nov-08 RMS Added three new standardized SHOW routines
|
|
07-Oct-08 JDB [serial] Added serial port support to TMXR, TMLN,
|
|
added tmxr_attach_line, tmxr_detach_line,
|
|
tmxr_line_free, tmxr_mux_free
|
|
27-May-08 JDB Added lnorder to TMXR structure,
|
|
added tmxr_set_lnorder and tmxr_set_lnorder
|
|
14-May-08 JDB Added dptr to TMXR structure
|
|
04-Jan-04 RMS Changed TMXR ldsc to be pointer to linedesc array
|
|
Added tmxr_linemsg, logging (from Mark Pizzolato)
|
|
29-Dec-03 RMS Added output stall support, increased buffer size
|
|
22-Dec-02 RMS Added break support (from Mark Pizzolato)
|
|
20-Aug-02 RMS Added tmxr_open_master, tmxr_close_master, tmxr.port
|
|
30-Dec-01 RMS Renamed tmxr_fstatus, added tmxr_fstats
|
|
20-Oct-01 RMS Removed tmxr_getchar, formalized buffer guard,
|
|
added tmxr_rqln, tmxr_tqln
|
|
*/
|
|
|
|
#ifndef _SIM_TMXR_H_
|
|
#define _SIM_TMXR_H_ 0
|
|
|
|
#include "sim_serial.h"
|
|
|
|
#define TMXR_V_VALID 15
|
|
#define TMXR_VALID (1 << TMXR_V_VALID)
|
|
#define TMXR_MAXBUF 256 /* buffer size */
|
|
#define TMXR_GUARD 12 /* buffer guard */
|
|
|
|
#define TMXR_DBG_XMT 0x10000 /* Debug Transmit Data */
|
|
#define TMXR_DBG_RCV 0x20000 /* Debug Received Data */
|
|
|
|
typedef struct tmln TMLN;
|
|
typedef struct tmxr TMXR;
|
|
|
|
struct tmln {
|
|
SOCKET conn; /* line conn */
|
|
uint32 ipad; /* IP address */
|
|
uint32 cnms; /* conn time */
|
|
int32 tsta; /* Telnet state */
|
|
int32 rcve; /* rcv enable */
|
|
int32 xmte; /* xmt enable */
|
|
int32 dstb; /* disable Tlnt bin */
|
|
int32 rxbpr; /* rcv buf remove */
|
|
int32 rxbpi; /* rcv buf insert */
|
|
int32 rxcnt; /* rcv count */
|
|
int32 txbpr; /* xmt buf remove */
|
|
int32 txbpi; /* xmt buf insert */
|
|
int32 txcnt; /* xmt count */
|
|
int32 txdrp; /* xmt drop count */
|
|
int32 txbsz; /* xmt buffer size */
|
|
int32 txbfd; /* xmt buffered flag */
|
|
FILE *txlog; /* xmt log file */
|
|
FILEREF *txlogref; /* xmt log file reference */
|
|
char *txlogname; /* xmt log file name */
|
|
char rxb[TMXR_MAXBUF]; /* rcv buffer */
|
|
char rbr[TMXR_MAXBUF]; /* rcv break */
|
|
char *txb; /* xmt buffer */
|
|
TMXR *mp; /* back pointer to mux */
|
|
SERHANDLE serport; /* serial port handle */
|
|
char *sername; /* serial port name */
|
|
};
|
|
|
|
struct tmxr {
|
|
int32 lines; /* # lines */
|
|
int32 port; /* listening port */
|
|
SOCKET master; /* master socket */
|
|
TMLN *ldsc; /* line descriptors */
|
|
int32 *lnorder; /* line connection order */
|
|
DEVICE *dptr; /* multiplexer device */
|
|
char logfiletmpl[FILENAME_MAX]; /* template logfile name */
|
|
int32 buffered; /* Buffered Line Behavior and Buffer Size Flag */
|
|
uint32 pending; /* count of pending serial connections */
|
|
};
|
|
|
|
int32 tmxr_poll_conn (TMXR *mp);
|
|
void tmxr_reset_ln (TMLN *lp);
|
|
t_stat tmxr_clear_ln (TMXR *mp, TMLN *lp);
|
|
int32 tmxr_getc_ln (TMLN *lp);
|
|
void tmxr_poll_rx (TMXR *mp);
|
|
t_stat tmxr_putc_ln (TMLN *lp, int32 chr);
|
|
void tmxr_poll_tx (TMXR *mp);
|
|
int32 tmxr_send_buffered_data (TMLN *lp);
|
|
t_stat tmxr_open_master (TMXR *mp, char *cptr);
|
|
t_stat tmxr_close_master (TMXR *mp);
|
|
t_stat tmxr_attach (TMXR *mp, UNIT *uptr, char *cptr);
|
|
t_stat tmxr_detach (TMXR *mp, UNIT *uptr);
|
|
t_stat tmxr_attach_line (UNIT *uptr, int32 val, char *cptr, void *desc);
|
|
t_stat tmxr_detach_line (UNIT *uptr, int32 val, char *cptr, void *desc);
|
|
t_bool tmxr_line_free (TMLN *lp);
|
|
t_bool tmxr_mux_free (TMXR *mp);
|
|
t_stat tmxr_ex (t_value *vptr, t_addr addr, UNIT *uptr, int32 sw);
|
|
t_stat tmxr_dep (t_value val, t_addr addr, UNIT *uptr, int32 sw);
|
|
void tmxr_msg (SOCKET sock, char *msg);
|
|
void tmxr_linemsg (TMLN *lp, char *msg);
|
|
void tmxr_fconns (FILE *st, TMLN *lp, int32 ln);
|
|
void tmxr_fstats (FILE *st, TMLN *lp, int32 ln);
|
|
t_stat tmxr_set_log (UNIT *uptr, int32 val, char *cptr, void *desc);
|
|
t_stat tmxr_set_nolog (UNIT *uptr, int32 val, char *cptr, void *desc);
|
|
t_stat tmxr_show_log (FILE *st, UNIT *uptr, int32 val, void *desc);
|
|
t_stat tmxr_dscln (UNIT *uptr, int32 val, char *cptr, void *desc);
|
|
int32 tmxr_rqln (TMLN *lp);
|
|
int32 tmxr_tqln (TMLN *lp);
|
|
t_stat tmxr_set_lnorder (UNIT *uptr, int32 val, char *cptr, void *desc);
|
|
t_stat tmxr_show_lnorder (FILE *st, UNIT *uptr, int32 val, void *desc);
|
|
t_stat tmxr_show_summ (FILE *st, UNIT *uptr, int32 val, void *desc);
|
|
t_stat tmxr_show_cstat (FILE *st, UNIT *uptr, int32 val, void *desc);
|
|
t_stat tmxr_show_lines (FILE *st, UNIT *uptr, int32 val, void *desc);
|
|
void tmxr_debug (uint32 dbits, TMLN *lp, const char *msg, char *buf, int bufsize);
|
|
|
|
#endif
|
|
|