Date: Sat, 6 Jun 2020 14:21:38 +0000 (UTC) From: Dirk Meyer <dinoex@FreeBSD.org> To: ports-committers@freebsd.org, svn-ports-all@freebsd.org, svn-ports-head@freebsd.org Subject: svn commit: r538094 - in head/comms: . opencbm-kmod opencbm-kmod/files Message-ID: <202006061421.056ELctu034410@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: dinoex Date: Sat Jun 6 14:21:38 2020 New Revision: 538094 URL: https://svnweb.freebsd.org/changeset/ports/538094 Log: OpenCBM driver module for parallel-port X[MA]-1541 cables The OpenCBM package contains user space support programs and development libraries to control and use CBM serial IEC/IEEE-488 bus devices as used by most Commodore (CBM) 8-bit machines. This port contains the FreeBSD driver for parallel-port cables for OpenCBM. WWW: http://opencbm.sourceforge.net/ PR: 246784 Submitted by: Felix Palmen Added: head/comms/opencbm-kmod/ head/comms/opencbm-kmod/Makefile (contents, props changed) head/comms/opencbm-kmod/files/ head/comms/opencbm-kmod/files/opencbm.4 (contents, props changed) head/comms/opencbm-kmod/pkg-descr (contents, props changed) head/comms/opencbm-kmod/pkg-plist (contents, props changed) Modified: head/comms/Makefile Modified: head/comms/Makefile ============================================================================== --- head/comms/Makefile Sat Jun 6 14:20:30 2020 (r538093) +++ head/comms/Makefile Sat Jun 6 14:21:38 2020 (r538094) @@ -108,6 +108,7 @@ SUBDIR += o2sms SUBDIR += obexapp SUBDIR += opencbm + SUBDIR += opencbm-kmod SUBDIR += openobex SUBDIR += openzwave SUBDIR += openzwave-devel Added: head/comms/opencbm-kmod/Makefile ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ head/comms/opencbm-kmod/Makefile Sat Jun 6 14:21:38 2020 (r538094) @@ -0,0 +1,26 @@ +# Created by: Felix Palmen <felix@palmen-it.de> +# $FreeBSD$ + +PORTNAME= opencbm-kmod +PORTVERSION= ${OCBM_VERSION} +CATEGORIES= comms archivers + +PATCHFILES= ca4c06e7430caf3b2296d4e1e00051fff015fc53.diff \ + 073b833772e4325c7f680d6aeb81bc11844f03ca.diff \ + 3e967551e200d0c03aa4898e482626a7510acd21.diff + +MAINTAINER= felix@palmen-it.de +COMMENT= OpenCBM driver module for parallel-port X[MA]-1541 cables + +LICENSE= GPLv2+ + +USES= kmod uidfix + +WRKSRC_SUBDIR= opencbm/sys/freebsd + +post-install: + ${INSTALL_MAN} ${FILESDIR}/opencbm.4 ${STAGEDIR}${PREFIX}/man/man4 + +.include "../opencbm/Makefile.inc" + +.include <bsd.port.mk> Added: head/comms/opencbm-kmod/files/opencbm.4 ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ head/comms/opencbm-kmod/files/opencbm.4 Sat Jun 6 14:21:38 2020 (r538094) @@ -0,0 +1,86 @@ +.Dd May 27, 2020 +.Dt OPENCBM 4 +.Os +.Sh NAME +.Nm opencbm +.Nd OpenCBM driver for parallel-port X[MA]-1541 cables +.Sh SYNOPSIS +.Nm +.Sh DESCRIPTION +The +.Nm +driver supports Commodore disk drives connected to the parallel port using +an XM(P)-1541 or XA(P)-1541 cable. +.Ss Loader Tunables +The following loader tunables are used to set driver configuration at the +.Xr loader 8 +prompt before booting the kernel, or they can be stored in +.Pa /boot/loader.conf +in order to automatically set them before booting the kernel. +It is also possible to use +.Xr kenv 1 +to change these tunables before loading the +.Nm +driver. +.Bl -tag -width indent +.It Va cbm.cable +Set to 0 or 1 to explicitly select an XM-1541 (0) or XA-1541 (1) type cable. +The default value of -1 will attempt to auto-detect the cable type, which +only works reliably when +.Va cbm.reset +is active and the drive is connected and powered on while loading the +.Nm +driver. +.It Va cbm.hold_clk +Set to 0 explicitly to release the CLK line of the bus when idle. +The default (1) is to strictly follow C64 behavior, always holding the CLK +line. +.It Va cbm.reset +When set to 1 (default), execute a bus reset and wait for response from the +drive while loading the +.Nm +driver. +Set to 0 explicitly to load the driver without having to wait for the bus. +In this case, you should also select a cable type explicity. +.El +.Sh FILES +The +.Nm +driver creates the following device node: +.Bl -tag -width indent +.It Pa /dev/cbm +Device for communicating with a Commodore disk drive over a parallel-port +cable. +.El +.Sh EXAMPLES +To load the driver with a drive connected and powered on, auto-detecting +the cable type: +.Pp +.Dl kldload opencbm +.Pp +To load the driver without issuing a bus reset and selecting an active +(XA-1541) cable: +.Pp +.Dl kenv cbm.cable=1 +.Dl kenv cbm.reset=0 +.Dl kldload opencbm +.Pp +If you want to load the driver at system startup, adding it to +.Va kld_list +in +.Pa /etc/rc.conf +.Ns , +it is recommended to disable +.Va cbm.reset +and explicitly select a cable type in +.Pa /boot/loader.conf +.Ns , +e.g. add the following lines for a passive (XM-1541) cable: +.Pp +.Dl cbm.cable=0 +.Dl cbm.reset=0 +.Sh SEE ALSO +The cables supported by the +.Nm +driver (XM-1541, XA-1541 and their variations) are described on +.Lk https://sta.c64.org/xcables.html Added: head/comms/opencbm-kmod/pkg-descr ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ head/comms/opencbm-kmod/pkg-descr Sat Jun 6 14:21:38 2020 (r538094) @@ -0,0 +1,9 @@ +OpenCBM driver module for parallel-port X[MA]-1541 cables + +The OpenCBM package contains user space support programs and development +libraries to control and use CBM serial IEC/IEEE-488 bus devices as used by +most Commodore (CBM) 8-bit machines. + +This port contains the FreeBSD driver for parallel-port cables for OpenCBM. + +WWW: http://opencbm.sourceforge.net/ Added: head/comms/opencbm-kmod/pkg-plist ============================================================================== --- /dev/null 00:00:00 1970 (empty, because file is newly added) +++ head/comms/opencbm-kmod/pkg-plist Sat Jun 6 14:21:38 2020 (r538094) @@ -0,0 +1,2 @@ +/%%KMODDIR%%/opencbm.ko +man/man4/opencbm.4.gz
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202006061421.056ELctu034410>