Added README

This commit is contained in:
Tor-Eirik Bakke Lunde 2021-01-29 01:50:58 +01:00
parent 0d336e85b1
commit 7482046e0e
6 changed files with 1663 additions and 1528 deletions

File diff suppressed because it is too large Load Diff

View File

@ -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

View File

@ -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
View 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
View 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 |