mirror of
https://github.com/tebl/Apple2-Joystick-Adapter.git
synced 2024-10-11 16:24:13 +00:00
Added README
This commit is contained in:
parent
0d336e85b1
commit
7482046e0e
File diff suppressed because it is too large
Load Diff
@ -17,8 +17,8 @@ $Comp
|
||||
L c64_joykey:C64_IDC2_OUT J1
|
||||
U 1 1 5FF9BFA3
|
||||
P 5300 4300
|
||||
F 0 "J1" H 5312 4715 50 0000 C CNN
|
||||
F 1 "IDC_PORT1" H 5312 4624 50 0000 C CNN
|
||||
F 0 "J1" H 5300 4725 50 0000 C CNN
|
||||
F 1 "IDC_PORT1" H 5300 4625 50 0000 C CNN
|
||||
F 2 "C64 JoyKEY:IDC_Joystick" H 5325 3975 50 0001 C CNN
|
||||
F 3 "" H 5325 3975 50 0001 C CNN
|
||||
1 5300 4300
|
||||
@ -28,8 +28,8 @@ $Comp
|
||||
L c64_joykey:C64_IDC2_OUT J2
|
||||
U 1 1 5FF9E0A1
|
||||
P 5300 1500
|
||||
F 0 "J2" H 5312 1915 50 0000 C CNN
|
||||
F 1 "IDC_PORT2" H 5312 1824 50 0000 C CNN
|
||||
F 0 "J2" H 5300 1925 50 0000 C CNN
|
||||
F 1 "IDC_PORT2" H 5300 1825 50 0000 C CNN
|
||||
F 2 "C64 JoyKEY:IDC_Joystick" H 5325 1175 50 0001 C CNN
|
||||
F 3 "" H 5325 1175 50 0001 C CNN
|
||||
1 5300 1500
|
||||
|
File diff suppressed because it is too large
Load Diff
@ -1,4 +1,4 @@
|
||||
19045815574634434
|
||||
19034051687613324
|
||||
Battery
|
||||
BatteryHolder_Bulgin_BX0036_1xC
|
||||
Bulgin Battery Holder, BX0036, Battery Type C (https://www.bulgin.com/products/pub/media/bulgin/data/Battery_holders.pdf)
|
||||
@ -2274,6 +2274,13 @@ speaker CUI
|
||||
0
|
||||
2
|
||||
2
|
||||
C64 JoyKEY
|
||||
IDC_Joystick
|
||||
Through hole straight IDC box header, 2x05, 2.54mm pitch, double rows
|
||||
Through hole IDC box header THT 2x05 2.54mm double row
|
||||
0
|
||||
10
|
||||
10
|
||||
Calibration_Scale
|
||||
Gauge_10mm_Type1_CopperTop
|
||||
Gauge, Massstab, 10mm, CopperTop, Type 1,
|
||||
@ -56356,6 +56363,27 @@ ESP8266 WiFi microcontroller
|
||||
0
|
||||
16
|
||||
16
|
||||
Mounting
|
||||
M2
|
||||
module 1 pin (ou trou mecanique de percage)
|
||||
DEV
|
||||
0
|
||||
1
|
||||
1
|
||||
Mounting
|
||||
M3
|
||||
module 1 pin (ou trou mecanique de percage)
|
||||
DEV
|
||||
0
|
||||
0
|
||||
0
|
||||
Mounting
|
||||
M3_pin
|
||||
module 1 pin (ou trou mecanique de percage)
|
||||
DEV
|
||||
0
|
||||
1
|
||||
1
|
||||
MountingEquipment
|
||||
DINRailAdapter_3xM3_PhoenixContact_1201578
|
||||
https://www.phoenixcontact.com/online/portal/us?uri=pxc-oc-itemdetail:pid=1201578&library=usen&tab=1
|
||||
@ -83026,94 +83054,10 @@ varistor SIOV
|
||||
0
|
||||
2
|
||||
2
|
||||
arduino_pro_micro
|
||||
Arduino_Pro_Micro
|
||||
|
||||
|
||||
adapter
|
||||
DIP-16_W7.62mm_Socket_LongPads
|
||||
16-lead though-hole mounted DIP package, row spacing 7.62 mm (300 mils), Socket, LongPads
|
||||
THT DIP DIL PDIP 2.54mm 7.62mm 300mil Socket LongPads
|
||||
0
|
||||
36
|
||||
24
|
||||
arduino_pro_micro
|
||||
Arduino_Pro_Micro_Reverse
|
||||
|
||||
|
||||
0
|
||||
36
|
||||
24
|
||||
artwork
|
||||
captain_blood1
|
||||
|
||||
|
||||
0
|
||||
0
|
||||
0
|
||||
artwork
|
||||
captain_blood2
|
||||
|
||||
|
||||
0
|
||||
0
|
||||
0
|
||||
artwork
|
||||
captain_blood3
|
||||
|
||||
|
||||
0
|
||||
0
|
||||
0
|
||||
artwork
|
||||
ik_plus
|
||||
|
||||
|
||||
0
|
||||
0
|
||||
0
|
||||
artwork
|
||||
last_ninja
|
||||
|
||||
|
||||
0
|
||||
0
|
||||
0
|
||||
artwork
|
||||
platoon
|
||||
|
||||
|
||||
0
|
||||
0
|
||||
0
|
||||
artwork
|
||||
robocop
|
||||
|
||||
|
||||
0
|
||||
0
|
||||
0
|
||||
artwork
|
||||
shinobi
|
||||
|
||||
|
||||
0
|
||||
0
|
||||
0
|
||||
mounting
|
||||
M2
|
||||
module 1 pin (ou trou mecanique de percage)
|
||||
DEV
|
||||
0
|
||||
1
|
||||
1
|
||||
mounting
|
||||
M3
|
||||
module 1 pin (ou trou mecanique de percage)
|
||||
DEV
|
||||
0
|
||||
0
|
||||
0
|
||||
mounting
|
||||
M3_pin
|
||||
module 1 pin (ou trou mecanique de percage)
|
||||
DEV
|
||||
0
|
||||
1
|
||||
1
|
||||
16
|
||||
16
|
||||
|
189
LICENSE.txt
Normal file
189
LICENSE.txt
Normal file
@ -0,0 +1,189 @@
|
||||
CERN Open Hardware Licence v1.2
|
||||
|
||||
Preamble
|
||||
|
||||
Through this CERN Open Hardware Licence ("CERN OHL") version 1.2, CERN
|
||||
wishes to provide a tool to foster collaboration and sharing among
|
||||
hardware designers. The CERN OHL is copyright CERN. Anyone is welcome
|
||||
to use the CERN OHL, in unmodified form only, for the distribution of
|
||||
their own Open Hardware designs. Any other right is reserved. Release
|
||||
of hardware designs under the CERN OHL does not constitute an
|
||||
endorsement of the licensor or its designs nor does it imply any
|
||||
involvement by CERN in the development of such designs.
|
||||
|
||||
1. Definitions
|
||||
|
||||
In this Licence, the following terms have the following meanings:
|
||||
|
||||
“Licence” means this CERN OHL.
|
||||
|
||||
“Documentation” means schematic diagrams, designs, circuit or circuit
|
||||
board layouts, mechanical drawings, flow charts and descriptive text,
|
||||
and other explanatory material that is explicitly stated as being made
|
||||
available under the conditions of this Licence. The Documentation may
|
||||
be in any medium, including but not limited to computer files and
|
||||
representations on paper, film, or any other media.
|
||||
|
||||
“Documentation Location” means a location where the Licensor has
|
||||
placed Documentation, and which he believes will be publicly
|
||||
accessible for at least three years from the first communication to
|
||||
the public or distribution of Documentation.
|
||||
|
||||
“Product” means either an entire, or any part of a, device built using
|
||||
the Documentation or the modified Documentation.
|
||||
|
||||
“Licensee” means any natural or legal person exercising rights under
|
||||
this Licence.
|
||||
|
||||
“Licensor” means any natural or legal person that creates or modifies
|
||||
Documentation and subsequently communicates to the public and/ or
|
||||
distributes the resulting Documentation under the terms and conditions
|
||||
of this Licence.
|
||||
|
||||
A Licensee may at the same time be a Licensor, and vice versa.
|
||||
|
||||
Use of the masculine gender includes the feminine and neuter genders
|
||||
and is employed solely to facilitate reading.
|
||||
|
||||
2. Applicability
|
||||
|
||||
2.1. This Licence governs the use, copying, modification,
|
||||
communication to the public and distribution of the Documentation, and
|
||||
the manufacture and distribution of Products. By exercising any right
|
||||
granted under this Licence, the Licensee irrevocably accepts these
|
||||
terms and conditions.
|
||||
|
||||
2.2. This Licence is granted by the Licensor directly to the Licensee,
|
||||
and shall apply worldwide and without limitation in time. The Licensee
|
||||
may assign his licence rights or grant sub-licences.
|
||||
|
||||
2.3. This Licence does not extend to software, firmware, or code
|
||||
loaded into programmable devices which may be used in conjunction with
|
||||
the Documentation, the modified Documentation or with Products, unless
|
||||
such software, firmware, or code is explicitly expressed to be subject
|
||||
to this Licence. The use of such software, firmware, or code is
|
||||
otherwise subject to the applicable licence terms and conditions.
|
||||
|
||||
3. Copying, modification, communication to the public and distribution
|
||||
of the Documentation
|
||||
|
||||
3.1. The Licensee shall keep intact all copyright and trademarks
|
||||
notices, all notices referring to Documentation Location, and all
|
||||
notices that refer to this Licence and to the disclaimer of warranties
|
||||
that are included in the Documentation. He shall include a copy
|
||||
thereof in every copy of the Documentation or, as the case may be,
|
||||
modified Documentation, that he communicates to the public or
|
||||
distributes.
|
||||
|
||||
3.2. The Licensee may copy, communicate to the public and distribute
|
||||
verbatim copies of the Documentation, in any medium, subject to the
|
||||
requirements specified in section 3.1.
|
||||
|
||||
3.3. The Licensee may modify the Documentation or any portion thereof
|
||||
provided that upon modification of the Documentation, the Licensee
|
||||
shall make the modified Documentation available from a Documentation
|
||||
Location such that it can be easily located by an original Licensor
|
||||
once the Licensee communicates to the public or distributes the
|
||||
modified Documentation under section 3.4, and, where required by
|
||||
section 4.1, by a recipient of a Product. However, the Licensor shall
|
||||
not assert his rights under the foregoing proviso unless or until a
|
||||
Product is distributed.
|
||||
|
||||
3.4. The Licensee may communicate to the public and distribute the
|
||||
modified Documentation (thereby in addition to being a Licensee also
|
||||
becoming a Licensor), always provided that he shall:
|
||||
|
||||
a) comply with section 3.1;
|
||||
|
||||
b) cause the modified Documentation to carry prominent notices stating
|
||||
that the Licensee has modified the Documentation, with the date and
|
||||
description of the modifications;
|
||||
|
||||
c) cause the modified Documentation to carry a new Documentation
|
||||
Location notice if the original Documentation provided for one;
|
||||
|
||||
d) make available the modified Documentation at the same level of
|
||||
abstraction as that of the Documentation, in the preferred format for
|
||||
making modifications to it (e.g. the native format of the CAD tool as
|
||||
applicable), and in the event that format is proprietary, in a format
|
||||
viewable with a tool licensed under an OSI-approved license if the
|
||||
proprietary tool can create it; and
|
||||
|
||||
e) license the modified Documentation under the terms and conditions
|
||||
of this Licence or, where applicable, a later version of this Licence
|
||||
as may be issued by CERN.
|
||||
|
||||
3.5. The Licence includes a non-exclusive licence to those patents or
|
||||
registered designs that are held by, under the control of, or
|
||||
sub-licensable by the Licensor, to the extent necessary to make use of
|
||||
the rights granted under this Licence. The scope of this section 3.5
|
||||
shall be strictly limited to the parts of the Documentation or
|
||||
modified Documentation created by the Licensor.
|
||||
|
||||
4. Manufacture and distribution of Products
|
||||
|
||||
4.1. The Licensee may manufacture or distribute Products always
|
||||
provided that, where such manufacture or distribution requires a
|
||||
licence under this Licence the Licensee provides to each recipient of
|
||||
such Products an easy means of accessing a copy of the Documentation
|
||||
or modified Documentation, as applicable, as set out in section 3.
|
||||
|
||||
4.2. The Licensee is invited to inform any Licensor who has indicated
|
||||
his wish to receive this information about the type, quantity and
|
||||
dates of production of Products the Licensee has (had) manufactured
|
||||
|
||||
5. Warranty and liability
|
||||
|
||||
5.1. DISCLAIMER – The Documentation and any modified Documentation are
|
||||
provided "as is" and any express or implied warranties, including, but
|
||||
not limited to, implied warranties of merchantability, of satisfactory
|
||||
quality, non-infringement of third party rights, and fitness for a
|
||||
particular purpose or use are disclaimed in respect of the
|
||||
Documentation, the modified Documentation or any Product. The Licensor
|
||||
makes no representation that the Documentation, modified
|
||||
Documentation, or any Product, does or will not infringe any patent,
|
||||
copyright, trade secret or other proprietary right. The entire risk as
|
||||
to the use, quality, and performance of a Product shall be with the
|
||||
Licensee and not the Licensor. This disclaimer of warranty is an
|
||||
essential part of this Licence and a condition for the grant of any
|
||||
rights granted under this Licence. The Licensee warrants that it does
|
||||
not act in a consumer capacity.
|
||||
|
||||
5.2. LIMITATION OF LIABILITY – The Licensor shall have no liability
|
||||
for direct, indirect, special, incidental, consequential, exemplary,
|
||||
punitive or other damages of any character including, without
|
||||
limitation, procurement of substitute goods or services, loss of use,
|
||||
data or profits, or business interruption, however caused and on any
|
||||
theory of contract, warranty, tort (including negligence), product
|
||||
liability or otherwise, arising in any way in relation to the
|
||||
Documentation, modified Documentation and/or the use, manufacture or
|
||||
distribution of a Product, even if advised of the possibility of such
|
||||
damages, and the Licensee shall hold the Licensor(s) free and harmless
|
||||
from any liability, costs, damages, fees and expenses, including
|
||||
claims by third parties, in relation to such use.
|
||||
|
||||
6. General
|
||||
|
||||
6.1. Except for the rights explicitly granted hereunder, this Licence
|
||||
does not imply or represent any transfer or assignment of intellectual
|
||||
property rights to the Licensee.
|
||||
|
||||
6.2. The Licensee shall not use or make reference to any of the names
|
||||
(including acronyms and abbreviations), images, or logos under which
|
||||
the Licensor is known, save in so far as required to comply with
|
||||
section 3. Any such permitted use or reference shall be factual and
|
||||
shall in no event suggest any kind of endorsement by the Licensor or
|
||||
its personnel of the modified Documentation or any Product, or any
|
||||
kind of implication by the Licensor or its personnel in the
|
||||
preparation of the modified Documentation or Product.
|
||||
|
||||
6.3. CERN may publish updated versions of this Licence which retain
|
||||
the same general provisions as this version, but differ in detail so
|
||||
far this is required and reasonable. New versions will be published
|
||||
with a unique version number.
|
||||
|
||||
6.4. This Licence shall terminate with immediate effect, upon written
|
||||
notice and without involvement of a court if the Licensee fails to
|
||||
comply with any of its terms and conditions, or if the Licensee
|
||||
initiates legal action against Licensor in relation to this
|
||||
Licence. Section 5 shall continue to apply.
|
52
README.md
Normal file
52
README.md
Normal file
@ -0,0 +1,52 @@
|
||||
# Apple ][ Joystick Adapter
|
||||
I have an Apple ][ somewhere in my storage room, I don't play on the thing much. Part of the reason might be the lack of a joystick, so I've been attempting to remedy that by soldering something together - the hard, and quite possibly the only real classic way, by reading about them in an old book and attempt to actually build the thing (Computer Controller Cookbook).
|
||||
|
||||
The adapter allows you to connect up to two Atari-style joysticks up to the Apple ][, if you like that sort of thing. I'm told most Apple fans prefer their joysticks to be analog because that was all the rage was all about at the end of the 70s, but as already mentioned I don't have one - I on the other hand have a ton of Atari-style joysticks so those are the ones I'd like to use. Keep reading, click links below to skip to a specific section.
|
||||
|
||||
- [1> Building the adapter](#1-building-the-adapter)
|
||||
- [1.2> IDC-cables](#12-idc-cables)
|
||||
- [2> BOM](#2-bom)
|
||||
- [2.1> Miscellaneous components](#21-miscellaneous-components)
|
||||
|
||||
# 1> Building the adapter
|
||||
Building the adapter, as with most things that deals with electronic projects, starts with going through the [BOM](#2-bom) and ordering whatever you don't already have. Compare with the gallery pictures if you're wondering what something looks like, unfortunately ebay is not a good place to shop for well-described components - I usually just order one of each if they're cheap (it'll get used sometime, if only to irritate someone attempting to build more than one of my projects).
|
||||
|
||||
Next up is soldering the resistors, these are have the lowest profile of the components and move on up in size from that point. Please use sockets though, everything that looks like ICs from ebay should be considered highly suspicious - you will want the ability to quickly change one of them out (usually they are B-grade or pulls; they may work or they might not).
|
||||
|
||||
The last component to get soldered into place are the machined pin headers that go into the area labelled A1, these go into the Game I/O socket on the Apple ][ motherboard - the regular kind will probably break your socket, so don't use those (even if they cost a bit more). They are soldered on the reverse side compared to the other components, to ensure that they are soldered into place at a reasonable angle, I recommend using a 16 pin machined pin socket as a template below the pins.
|
||||
|
||||
Onto the next step, because everyone loves making cables.
|
||||
|
||||
## 1.2> IDC-cables
|
||||
While I would have liked to just use something that could be ordered straight from AliExpress without going so far as creating a custom cable, all of the ones I've found were mostly IDC to RS232 adapters - those have a rather randomized pin layout so I chose not to use them as a basis. The method I used instead was order said cables, cut off the DB9 part and then just add a new male DB9 IDC connector that lines up pin 1 with pin 1.
|
||||
|
||||
Getting a length of cable that you'll be happy with, well - that usually means building the whole cable by yourself. Since soldering connectors suck, I've listed IDC connectors that are assembled by placing the cable in the correct place and pushing very hard. Note that the 2x5pin IDC side will have a spot for a tenth wire, this is left empty (DB9 naturally only require 9 wires).
|
||||
|
||||
# 2> BOM
|
||||
This is the list of parts that you'd need in order to construct Apple ][ Joystick Adapter, most could quite possibly be sourced from your friendly neighbourhood electronics store - if you should happen to have one available (using a passport on the way doesn't count). I don't, so I order most of the components on ebay and similar sources - parts may be cheap, but at least you'll need extras in order to assure at least one of them works.
|
||||
|
||||
| Reference | Item | Count |
|
||||
| -------------------- | ------------------------------------------------- | ----- |
|
||||
| Adapter (PCB) | Fabricate using Gerber files ([order]()) | 1 |
|
||||
| A1 * | 8 pin machined pin header | 2 |
|
||||
| C1,C2 | 100nF ceramic capacitor (5mm) | 2 |
|
||||
| C3 | 4.7uF electrolytic capacitor (2mm) | 1 |
|
||||
| IC1 | 74HCT04 (DIP-14) | 1 |
|
||||
| IC2 | CD4066 (DIP-14) | 1 |
|
||||
| J1,J2 | 2x5 pin straight IDC socket | 2 |
|
||||
| R1-R6 | 1k Ohm resistor | 6 |
|
||||
| R7-R10 | 68k Ohm resistor | 4 |
|
||||
| R11-R14 | 100k Ohm resistor | 4 |
|
||||
|
||||
*) These are soldered on the reverse side compared to the other components, these pins go into the Game I/O socket on the Apple ][ motherboard. These are usually sold as 40 pin breakable strips, it is recommended to use the machined pin headers as they won't destroy the mother board socket like regular pin header would.
|
||||
|
||||
## 2.1> Miscellaneous components
|
||||
This is a suggested list of components used to screw together each of the PCBs, most of these you can find as part of a set on ebay (just search for "*M3 nylon assorted standoff kit*"). Cable components are also listed here.
|
||||
|
||||
| Reference | Item | Count |
|
||||
| --------- | ----------------------------------------- | ----- |
|
||||
| | M3x6mm nylon screw | 1 |
|
||||
| | M3x10mm Nylon Hex standoff | 1 |
|
||||
| | IDC Flat Ribbon DB9 Male Connector | 2 |
|
||||
| | 2x5 Flat Riboon IDC Connector | 2 |
|
||||
| | 9 core flat ribbon cable | 2 |
|
Loading…
Reference in New Issue
Block a user