From patchwork Mon May 26 13:59:49 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: George Anthony Vernon X-Patchwork-Id: 892664 Received: from out-186.mta0.migadu.com (out-186.mta0.migadu.com [91.218.175.186]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id AEB1186338 for ; Mon, 26 May 2025 14:00:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.186 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268041; cv=none; b=h/sDj8MxqPj5yD2WyHmoBxC9n7RTNkoUvJCHWQ2m5XwnNpZ7lIQBnCkVcLgg81LrlQMVS/X6ysWbxLJgENVjOrpnjDNU/K2TX/j4lHjDL+sTrnzk3TbWPa4H4zu0OOfWKIThLWEaE4a/2bDfcqfZ8FIH++omsN9p7sye7d5+d5M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268041; c=relaxed/simple; bh=aNQGcOGLGwzhcIOM8NfPYM0jf7KwNLGhz88QIVgMRM4=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=GLNas5acvEODGZrANdx9w0YDfq7o30RmBKV7LQd71HPAsP4saBIDxAP9Z57lDhSEifLJbV9enN3U422Pm746+wiUZVXY7W7GiFjCZPkLdlNYYWQ3gH8BiChxocT2le/gKiRSxcwkoF4Fp9lgSriALNT/eRtJC3ZBJx5GYEiNOjg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com; spf=pass smtp.mailfrom=gvernon.com; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b=LF8Zty1P; arc=none smtp.client-ip=91.218.175.186 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gvernon.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b="LF8Zty1P" X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gvernon.com; s=key1; t=1748268037; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=ORmLrLq9c8xhomXJo56yAZlyEE/xXLB0zfu2z9O+YZ0=; b=LF8Zty1PSNafiuCuzp3qeQKoFXTYqFxEnstUI2gpqI7prTx/YxUn97yrsLncUH1qtn8BqG qlxy3Zm1f4wZHYgkhNcKnnzi7MN+gaGCgLhT2Uc6Zvkz3WqrMIaZ2KZvynnumaPALqk158 86aqUnv1MPBefEB/ULCFPQsb7nbncaQ9vsjUtJwrt2JYJVPvsd9SbYkd6Da77U2sT/IpBy TmESmwlFjsFuceLp8miIXt9/bjIZGb0BsZ/bKBR0YkfUGbvYyq1VFSGA9RQZ0XfBkpVzVn aZ50AFbGsnwB4+a9eC9LSlrdLBVmaCHMBFiVVsliLBW7Pgdf3cIjSnU/tatjkg== From: George Anthony Vernon To: dmitry.torokhov@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org Cc: George Anthony Vernon , bagasdotme@gmail.com, linux-input@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kernel-mentees@lists.linux.dev Subject: [PATCH v2 1/4] input: docs: Fix broken table formatting Date: Mon, 26 May 2025 14:59:49 +0100 Message-ID: <20250526135957.180254-2-contact@gvernon.com> In-Reply-To: <20250526135957.180254-1-contact@gvernon.com> References: <20250526135957.180254-1-contact@gvernon.com> Precedence: bulk X-Mailing-List: linux-input@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Migadu-Flow: FLOW_OUT Missing '+' led to unintended spanning cell. Correct this. Signed-off-by: George Anthony Vernon Reviewed-by: Bagas Sanjaya --- Documentation/input/devices/amijoy.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/input/devices/amijoy.rst b/Documentation/input/devices/amijoy.rst index 8df7b11cd98d..f854ee975247 100644 --- a/Documentation/input/devices/amijoy.rst +++ b/Documentation/input/devices/amijoy.rst @@ -123,7 +123,7 @@ JOY1DAT Y7 Y6 Y5 Y4 Y3 Y2 Y1 Y0 X7 X6 X5 X4 X3 X2 X1 X0 clocked by 2 of the signals input from the mouse serial stream. Starting with first bit received: - +-------------------+-----------------------------------------+ + +--------+----------+-----------------------------------------+ | Serial | Bit Name | Description | +========+==========+=========================================+ | 0 | M0H | JOY0DAT Horizontal Clock | From patchwork Mon May 26 13:59:50 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: George Anthony Vernon X-Patchwork-Id: 892857 Received: from out-185.mta0.migadu.com (out-185.mta0.migadu.com [91.218.175.185]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9C45820E03F for ; Mon, 26 May 2025 14:00:44 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.185 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268046; cv=none; b=El9DF+HLZ3wIc0mcy3j10Fv+jM5TAioxx5ES1XaUqao41jmpX4rEUYbCEaV4LSZAWZyNIk2oO7cOETK/l1mo41Fc7iCC9n6EmzaV/T2hDKNqBz+Eudvh9duLXWuHCT1Ek0lzYB05xpON+8FoK0d3TZ4xEBE3eQglCFNrBVW3y4Q= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268046; c=relaxed/simple; bh=FH+XuZiqedmmbcdx7+ns4Iwr/ePiNYP4RtSE8O61uKE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=SIVo+bzHquRq3FXS1176CmeGWu3lMZ2GP5rtwbwf0ULsbDPxn8H4CC0154ReVUkeov0QVDMb3QJ/WE5SwqgbRN4xcemEXKa82lFm5MloXRIargyUZe8Wzl5GjsD/K3pTKsjxtQrqNCk1+te5M3qBVJzUcxPV0FgOct2Zzp5ABUY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com; spf=pass smtp.mailfrom=gvernon.com; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b=IO0v+y9O; arc=none smtp.client-ip=91.218.175.185 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gvernon.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b="IO0v+y9O" X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gvernon.com; s=key1; t=1748268042; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=cQmxapCCbfWgqmAUgREJ3k7qr9htA9/0TELdt2lF078=; b=IO0v+y9ORD++Xj+HZ0d83rIbOOYxxbyWn5y41u4CBYYtsHz23NppYLIuqwyUI8TPx2q1p7 4Ud2iHjgwFsuifJLognJK9Vdl7CqX3m/uj1Q7p+Xobw+rN4iapfZd3HBM0ikVbPsFUuYyn 6iqDHUhtAT4nr/maXdZFe4iBp0SC+4YqchtfukKNvHAvO4ne/LH2jWEuoLqrtCEscokYMa F4r00x+0N9+/eNoQPa/ZKvM4NDxeyamT5qif7+CYl72zfQJ6rtDxGHaiMNK+xsxFEpSUHb zxrnsA767jKR4tUGTp6ex7rRsFqFBidIRLoQFueag1NsbsipHUyQrpeNhd3tGg== From: George Anthony Vernon To: dmitry.torokhov@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org Cc: George Anthony Vernon , bagasdotme@gmail.com, linux-input@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kernel-mentees@lists.linux.dev Subject: [PATCH v2 2/4] input: docs: Correct Amiga 4-jstick adapter pinout Date: Mon, 26 May 2025 14:59:50 +0100 Message-ID: <20250526135957.180254-3-contact@gvernon.com> In-Reply-To: <20250526135957.180254-1-contact@gvernon.com> References: <20250526135957.180254-1-contact@gvernon.com> Precedence: bulk X-Mailing-List: linux-input@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Migadu-Flow: FLOW_OUT Pinout incorrectly duplicated pin 18, correct this. Signed-off-by: George Anthony Vernon --- Documentation/input/devices/amijoy.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/input/devices/amijoy.rst b/Documentation/input/devices/amijoy.rst index f854ee975247..ea4de1ac0360 100644 --- a/Documentation/input/devices/amijoy.rst +++ b/Documentation/input/devices/amijoy.rst @@ -17,7 +17,7 @@ Pin Meaning Pin Meaning 4 Left1 8 Left2 5 Right1 9 Right2 13 Fire1 11 Fire2 -18 Gnd1 18 Gnd2 +19 Gnd1 18 Gnd2 ===== ======== ==== ========== Amiga digital joystick pinout From patchwork Mon May 26 13:59:51 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: George Anthony Vernon X-Patchwork-Id: 892663 Received: from out-179.mta0.migadu.com (out-179.mta0.migadu.com [91.218.175.179]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A813F8632E for ; Mon, 26 May 2025 14:00:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.179 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268058; cv=none; b=G0BdMJBxCT8CTHrR5Vd/6xUAnNdHbOQRlzm+fdLlJhwJsbin2VUVGtMiWurRRI/qDRi1QNRfH/kuACLVqyEliCd9tRTrgjIO3XqkFrYk242qNLgGNScz/mdkN683rsLzcUIDnjCQKNCoYPKjfxKX0y/AhmMdXscjAJ6Ldsf195M= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268058; c=relaxed/simple; bh=wfA0OXfCddUpAyBQw3yxP6zgf6FNxqwcaPO4EqrHQBE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Lv6+VOiitPZ31ct7hu8SG2SB/oc2rxa9GLMipXA/do1ctGQfhEbVRSGq/7BV1lFKZ7pVGfItr1jQfcX5Y6CfceTGJwdWgMI0rdGOFuPkgq3Vz5UMEYU5opwNql+vaxxuSjzZZYzIdNjbs3HZ57V5xGN7B5sFVWWemr+j+jZC/U0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com; spf=pass smtp.mailfrom=gvernon.com; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b=ERuRzYax; arc=none smtp.client-ip=91.218.175.179 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gvernon.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b="ERuRzYax" X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gvernon.com; s=key1; t=1748268053; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=NmM4W7gNtdHHgIXWDPAIbmT8q++dEuBoXaCFg+z7w+A=; b=ERuRzYaxXLHaFmcpUHLNT1LQySJUhyBsdONlEV42p2QyTCB6M9J7ruiS6IkCuxVMSKVDiS wpFrdcUCDYRabeofqjnM+23P3+CUY1pODhzHHNDUxXmE/+dPZioz1weY3KH5gWNX/gDUpJ PhD86ZOTJcLa5/24PgV/nw0ZvnGARdFLOw+eVcPg4i3luOCu5lVVFXvBx4Dl4muJS0s3R9 wwqW1lc9O6dWBpUG/2S6Hn5greW8DVeIyx/VJ4E9gY4UQPWwAWmWvl0DLnrkVG2QAcXJmR /RloKenqCaYNwOPRa9FNNZzXwo6LSizrhmEMdAuQb3wUKHVFdLb7j+ZcYSr7LA== From: George Anthony Vernon To: dmitry.torokhov@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org Cc: George Anthony Vernon , bagasdotme@gmail.com, linux-input@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kernel-mentees@lists.linux.dev Subject: [PATCH v2 3/4] input: docs: Fix Amiga joysticks grammar Date: Mon, 26 May 2025 14:59:51 +0100 Message-ID: <20250526135957.180254-4-contact@gvernon.com> In-Reply-To: <20250526135957.180254-1-contact@gvernon.com> References: <20250526135957.180254-1-contact@gvernon.com> Precedence: bulk X-Mailing-List: linux-input@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Migadu-Flow: FLOW_OUT Make small grammar fixes to Amiga joystick documentation. Signed-off-by: George Anthony Vernon Reviewed-by: Bagas Sanjaya --- Documentation/input/devices/amijoy.rst | 85 +++++++++++++------------- 1 file changed, 42 insertions(+), 43 deletions(-) diff --git a/Documentation/input/devices/amijoy.rst b/Documentation/input/devices/amijoy.rst index ea4de1ac0360..cbc5240f8af3 100644 --- a/Documentation/input/devices/amijoy.rst +++ b/Documentation/input/devices/amijoy.rst @@ -1,14 +1,13 @@ -~~~~~~~~~~~~~~~~~~~~~~~~~ -Amiga joystick extensions -~~~~~~~~~~~~~~~~~~~~~~~~~ +~~~~~~~~~~~~~~~ +Amiga joysticks +~~~~~~~~~~~~~~~ -Amiga 4-joystick parport extension -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Amiga 4-joystick parallel port extension +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Parallel port pins: - ===== ======== ==== ========== Pin Meaning Pin Meaning ===== ======== ==== ========== @@ -90,17 +89,17 @@ Pin Meaning ------------------------------------------------------------------------------- -======== === ==== ==== ====== ======================================== +======== === ==== ==== ====== =========================================== NAME rev ADDR type chip Description -======== === ==== ==== ====== ======================================== -JOY0DAT 00A R Denise Joystick-mouse 0 data (left vert, horiz) -JOY1DAT 00C R Denise Joystick-mouse 1 data (right vert,horiz) -======== === ==== ==== ====== ======================================== +======== === ==== ==== ====== =========================================== +JOY0DAT 00A R Denise Joystick-mouse 0 data (left vert., horiz.) +JOY1DAT 00C R Denise Joystick-mouse 1 data (right vert., horiz.) +======== === ==== ==== ====== =========================================== These addresses each read a 16 bit register. These in turn are loaded from the MDAT serial stream and are clocked in on the rising edge of SCLK. MLD output is used to parallel load - the external parallel-to-serial converter.This in turn is + the external parallel-to-serial converter. This in turn is loaded with the 4 quadrature inputs from each of two game controller ports (8 total) plus 8 miscellaneous control bits which are new for LISA and can be read in upper 8 bits of @@ -108,7 +107,7 @@ JOY1DAT 00C R Denise Joystick-mouse 1 data (right vert,horiz) Register bits are as follows: - - Mouse counter usage (pins 1,3 =Yclock, pins 2,4 =Xclock) + - Mouse counter usage (pins 1,3 =Yclock, pins 2,4 =Xclock) ======== === === === === === === === === ====== === === === === === === === BIT# 15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 @@ -179,12 +178,12 @@ JOYTEST 036 W Denise Write to all 4 joystick-mouse counters at once. ------------------------------------------------------------------------------- -======= === ==== ==== ====== ======================================== +======= === ==== ==== ====== =========================================== NAME rev ADDR type chip Description -======= === ==== ==== ====== ======================================== -POT0DAT h 012 R Paula Pot counter data left pair (vert, horiz) -POT1DAT h 014 R Paula Pot counter data right pair (vert,horiz) -======= === ==== ==== ====== ======================================== +======= === ==== ==== ====== =========================================== +POT0DAT h 012 R Paula Pot counter data left pair (vert., horiz.) +POT1DAT h 014 R Paula Pot counter data right pair (vert., horiz.) +======= === ==== ==== ====== =========================================== These addresses each read a pair of 8 bit pot counters. (4 counters total). The bit assignment for both @@ -213,8 +212,8 @@ POT1DAT h 014 R Paula Pot counter data right pair (vert,horiz) +-------+------+-----+-----+-------+ With normal (NTSC or PAL) horiz. line rate, the pots will - give a full scale (FF) reading with about 500kohms in one - frame time. With proportionally faster horiz line times, + give a full scale (FF) reading with about 500k ohm in one + frame time. With proportionally faster horiz. line times, the counters will count proportionally faster. This should be noted when doing variable beam displays. @@ -238,26 +237,26 @@ POTINP 016 R Paula Pot pin data read This register controls a 4 bit bi-direction I/O port that shares the same 4 pins as the 4 pot counters above. - +-------+----------+---------------------------------------------+ - | BIT# | FUNCTION | DESCRIPTION | - +=======+==========+=============================================+ - | 15 | OUTRY | Output enable for Paula pin 33 | - +-------+----------+---------------------------------------------+ - | 14 | DATRY | I/O data Paula pin 33 | - +-------+----------+---------------------------------------------+ - | 13 | OUTRX | Output enable for Paula pin 32 | - +-------+----------+---------------------------------------------+ - | 12 | DATRX | I/O data Paula pin 32 | - +-------+----------+---------------------------------------------+ - | 11 | OUTLY | Out put enable for Paula pin 36 | - +-------+----------+---------------------------------------------+ - | 10 | DATLY | I/O data Paula pin 36 | - +-------+----------+---------------------------------------------+ - | 09 | OUTLX | Output enable for Paula pin 35 | - +-------+----------+---------------------------------------------+ - | 08 | DATLX | I/O data Paula pin 35 | - +-------+----------+---------------------------------------------+ - | 07-01 | X | Not used | - +-------+----------+---------------------------------------------+ - | 00 | START | Start pots (dump capacitors,start counters) | - +-------+----------+---------------------------------------------+ + +-------+----------+----------------------------------------------+ + | BIT# | FUNCTION | DESCRIPTION | + +=======+==========+==============================================+ + | 15 | OUTRY | Output enable for Paula pin 33 | + +-------+----------+----------------------------------------------+ + | 14 | DATRY | I/O data Paula pin 33 | + +-------+----------+----------------------------------------------+ + | 13 | OUTRX | Output enable for Paula pin 32 | + +-------+----------+----------------------------------------------+ + | 12 | DATRX | I/O data Paula pin 32 | + +-------+----------+----------------------------------------------+ + | 11 | OUTLY | Out put enable for Paula pin 36 | + +-------+----------+----------------------------------------------+ + | 10 | DATLY | I/O data Paula pin 36 | + +-------+----------+----------------------------------------------+ + | 09 | OUTLX | Output enable for Paula pin 35 | + +-------+----------+----------------------------------------------+ + | 08 | DATLX | I/O data Paula pin 35 | + +-------+----------+----------------------------------------------+ + | 07-01 | X | Not used | + +-------+----------+----------------------------------------------+ + | 00 | START | Start pots (dump capacitors, start counters) | + +-------+----------+----------------------------------------------+ From patchwork Mon May 26 13:59:52 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: George Anthony Vernon X-Patchwork-Id: 892856 Received: from out-182.mta0.migadu.com (out-182.mta0.migadu.com [91.218.175.182]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id BCAC91E3762 for ; Mon, 26 May 2025 14:00:57 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=91.218.175.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268059; cv=none; b=jMetp6gjeV6kj6Uzh63WJfJwDWF/p8lfyK/tNQ4kteTlxasGx5Rd2fw88aqt48ZccKoWeNw7ARgdavhRGHTdPyj7ZKVX+dtdTUnjV6rTtrh3ABfRbDTgo6LQBazBk/gDWuktb3w0hDoWvgKziUNcLCR3U6ObJnnkj577Fukw9L4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748268059; c=relaxed/simple; bh=nMyPEDnf/zkddzZ2Cw4741aAO+yU0d/61z+A8WlOS94=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=tNsj2rIxJEtzLPZVaUHYDQs1RdVp894ndJ+pQn0aqfCIitTnkUMMLIFJDQgPbZiezVV7hVM1OC+QndqW4a6WY1d1C/W6XpvDoBjHFqkwtYjQMFItadpSPiWGV7x8ikwslOjT471khGU+rPGaaJDvfT1BKlkCBZFHovsYEw1upBs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com; spf=pass smtp.mailfrom=gvernon.com; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b=FBLIAQVM; arc=none smtp.client-ip=91.218.175.182 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=gvernon.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gvernon.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gvernon.com header.i=@gvernon.com header.b="FBLIAQVM" X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gvernon.com; s=key1; t=1748268056; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=V6dGYyUwgVkfLIw2/DVw8Hb9GNF0VcyeeqTRDuJIL/A=; b=FBLIAQVMmdfIUncAJN6oqa+PKQUXox17Sv8De+wBqYNWky7H0t30it9SRYSgQ1JOmYz7Ey AXDSbnfDLv3hzEGyKbgIBfrrYUu/azuKE+gSYdPamgrSL4O5rX0Mht4E3D1URBTZfesCsG 59DWMnU7iTfXY8dA8jI2SbqwIiNQ/Q2DIL6vuO6q7LjDFzr+FQ2G8c9FKrY+OpQ+76LSiH mKyReVAEgCccBBTUsWezHYP2LXwo4nbhVKbbAgLYifOAGZ387j/WZRqpdQ5GPE+okuuNYt cPLakPex6754Op1M2Zc/TbFyNxLUnnagCiy+xpMVLkKYYSMtg+kqkQZx8eOJNg== From: George Anthony Vernon To: dmitry.torokhov@gmail.com, corbet@lwn.net, skhan@linuxfoundation.org Cc: George Anthony Vernon , bagasdotme@gmail.com, linux-input@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kernel-mentees@lists.linux.dev Subject: [PATCH v2 4/4] input: docs: Make headings compliant w/ guidelines Date: Mon, 26 May 2025 14:59:52 +0100 Message-ID: <20250526135957.180254-5-contact@gvernon.com> In-Reply-To: <20250526135957.180254-1-contact@gvernon.com> References: <20250526135957.180254-1-contact@gvernon.com> Precedence: bulk X-Mailing-List: linux-input@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Migadu-Flow: FLOW_OUT Make heading adornments compliant with the guidelines to improve organisation of the page. Signed-off-by: George Anthony Vernon Reviewed-by: Bagas Sanjaya --- Documentation/input/devices/amijoy.rst | 42 ++++++++++++++++---------- 1 file changed, 26 insertions(+), 16 deletions(-) diff --git a/Documentation/input/devices/amijoy.rst b/Documentation/input/devices/amijoy.rst index cbc5240f8af3..a81e9de481c7 100644 --- a/Documentation/input/devices/amijoy.rst +++ b/Documentation/input/devices/amijoy.rst @@ -1,10 +1,12 @@ -~~~~~~~~~~~~~~~ +=============== Amiga joysticks -~~~~~~~~~~~~~~~ +=============== +Pinouts +======= Amiga 4-joystick parallel port extension -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +---------------------------------------- Parallel port pins: @@ -19,8 +21,8 @@ Pin Meaning Pin Meaning 19 Gnd1 18 Gnd2 ===== ======== ==== ========== -Amiga digital joystick pinout -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Amiga digital joystick +---------------------- === ============ Pin Meaning @@ -36,8 +38,8 @@ Pin Meaning 9 Thumb button === ============ -Amiga mouse pinout -~~~~~~~~~~~~~~~~~~ +Amiga mouse +----------- === ============ Pin Meaning @@ -53,8 +55,8 @@ Pin Meaning 9 Right button === ============ -Amiga analog joystick pinout -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Amiga analog joystick +--------------------- === ============== Pin Meaning @@ -70,8 +72,8 @@ Pin Meaning 9 Analog Y === ============== -Amiga lightpen pinout -~~~~~~~~~~~~~~~~~~~~~ +Amiga lightpen +-------------- === ============= Pin Meaning @@ -87,7 +89,11 @@ Pin Meaning 9 Stylus button === ============= -------------------------------------------------------------------------------- +Register addresses +================== + +JOY0DAT/JOY1DAT +--------------- ======== === ==== ==== ====== =========================================== NAME rev ADDR type chip Description @@ -159,7 +165,8 @@ JOY1DAT Y7 Y6 Y5 Y4 Y3 Y2 Y1 Y0 X7 X6 X5 X4 X3 X2 X1 X0 | Right | 4 | X1 | +------------+------+---------------------------------+ -------------------------------------------------------------------------------- +JOYTEST +------- ======== === ==== ==== ====== ================================================= NAME rev ADDR type chip Description @@ -176,7 +183,8 @@ JOYTEST 036 W Denise Write to all 4 joystick-mouse counters at once. JOYxDAT Y7 Y6 Y5 Y4 Y3 Y2 xx xx X7 X6 X5 X4 X3 X2 xx xx ========= === === === === === === === === ====== === === === === === === === -------------------------------------------------------------------------------- +POT0DAT/POT1DAT +--------------- ======= === ==== ==== ====== =========================================== NAME rev ADDR type chip Description @@ -217,7 +225,8 @@ POT1DAT h 014 R Paula Pot counter data right pair (vert., horiz.) the counters will count proportionally faster. This should be noted when doing variable beam displays. -------------------------------------------------------------------------------- +POTGO +----- ====== === ==== ==== ====== ================================================ NAME rev ADDR type chip Description @@ -226,7 +235,8 @@ POTGO 034 W Paula Pot port (4 bit) bi-direction and data, and pot counter start. ====== === ==== ==== ====== ================================================ -------------------------------------------------------------------------------- +POTINP +------ ====== === ==== ==== ====== ================================================ NAME rev ADDR type chip Description