OPP - Revision history

Jwilson: /* Firmware */

2022-08-16T22:47:44Z

Firmware

← Older revision		Revision as of 22:47, 16 August 2022
Line 645:		Line 645:
	The '''OPP''' boards aren't just about the physical hardware, there's also an operating system - to handle the serial communication with the host, moving messages along the serial chain, activating coils and lamp, and maintaining state for all the above. This software is known as '''Firmware''' and it runs on each ''Processor'' board. This is what talks to the host computer over USB.		The '''OPP''' boards aren't just about the physical hardware, there's also an operating system - to handle the serial communication with the host, moving messages along the serial chain, activating coils and lamp, and maintaining state for all the above. This software is known as '''Firmware''' and it runs on each ''Processor'' board. This is what talks to the host computer over USB.

	The firmware is available for download via the [https://openpinballproject.wordpress.com/repository/ OPP SVN] repo. It must be copied to each ''Processor'' individually in order for them to work. If using a PSoC4200 a group of processors can be upgraded via the Serial Chain. The stm32f103c8t6 must currently be upgraded using the ST-LINK V2 JTAG debugger.		The firmware is available for download via the [https://openpinballproject.wordpress.com/repository/ OPP SVN] repo. It must be copied to each ''Processor'' individually in order for them to work. If using a PSoC4200 a group of processors can be upgraded via the Serial Chain. The stm32f103c8t6 must currently be upgraded using the '''ST-LINK V2 JTAG debugger'''.

	=== stm32f103c8t6 ===		=== stm32f103c8t6 ===
Line 653:		Line 653:
	===== Linux / MacOS Firmware Programming =====		===== Linux / MacOS Firmware Programming =====

	Install ~~required software~~:		* Install libusb and git: <code>sudo apt-get install libusb-1.0-0-dev git</code>
			* Move to home: <code>cd ~</code>
			* Grab stlink code: <code>git clone https://github.com/texane/stlink</code>
			* Move into stlink folder: <code>cd stlink</code>
			* Build stlink: <code>make</code>
			* Copy binary to /usr/bin: <code>sudo cp build/Release/bin/st-flash /usr/bin</code>

	* Install libusb and git: sudo apt-get install libusb-1.0-0-dev git		For MacOS, you can get the libraries from ''Homebrew'':
	* Move to home: cd ~
	* Grab stlink code: git clone https://github.com/texane/stlink
	* Move into stlink folder: cd stlink
	* Build stlink: make
	* Copy binary to /usr/bin: sudo cp build/Release/bin/st-flash /usr/bin

	For MacOS, you can get the libraries from Homebrew:

	* libusb: https://formulae.brew.sh/formula/libusb		* libusb: https://formulae.brew.sh/formula/libusb
	* stlink: https://formulae.brew.sh/formula/stlink		* stlink: https://formulae.brew.sh/formula/stlink

	Attaching the debugger and programming firmware:		===== Attaching the debugger and programming firmware =====

	* Connect the four pins at the edge of the stm32f103c8t6 to 3.3V, SWD, SWCLK and GND to the pins on the ST-LINK V2		* Connect the four pins at the edge of the stm32f103c8t6 to 3.3V, SWD, SWCLK and GND to the pins on the ST-LINK V2
	* Move the Boot0 jumper from position 0 to 1		* Move the '''Boot0''' jumper from position '''0''' to '''1'''
	* Plug the ST-LINK V2 into a USB port		* Plug the ST-LINK V2 into a USB port
	* Program firmware (firmware is found at repos/Stm32Workbench/Gen3Images): sudo st-flash –format ihex write OppStm32.2.0.0.6.hex		* Program firmware (firmware is found at ''repos/Stm32Workbench/Gen3Images''): <code>sudo st-flash –format ihex write OppStm32.2.0.0.6.hex</code>
	* After programming is completed (printing out Jolly Good!), unplug the ST-LINK V2 from the USB port		* After programming is completed (printing out Jolly Good!), unplug the ST-LINK V2 from the USB port
	* Move the Boot0 jumper from position 1 to 0		* Move the Boot0 jumper from position 1 to 0

	Verify firmware version:		===== Verify firmware version =====

	* Plug the stm32f103c8t6 into a USB port		* Plug the stm32f103c8t6 into a USB port
	* Run Gen2Test.py (Gen2Test is found at repos/Python/Gen2Test): sudo python Gen2Test.py -port=/dev/ttyACM0		* Run Gen2Test.py (Gen2Test is found at repos/Python/Gen2Test): <code>sudo python Gen2Test.py -port=/dev/ttyACM0</code>

	Note: Gen2Test.py may need to be run a few times to “sync” the serial port because plugging in the USB port may send garbage on the serial port.		Note: Gen2Test.py may need to be run a few times to “sync” the serial port because plugging in the USB port may send garbage on the serial port.

Jwilson: /* Linux Firmware Programming */

2022-08-16T22:41:55Z

Linux Firmware Programming

← Older revision		Revision as of 22:41, 16 August 2022
Line 651:		Line 651:
	The firmware must be copied onto the stm32f103 processor using a ST-LINK V2 JTAG debugger. (Don't worry, these only cost $1.50 or so) The JTAG debugger is used for programming if using Linux or Windows.		The firmware must be copied onto the stm32f103 processor using a ST-LINK V2 JTAG debugger. (Don't worry, these only cost $1.50 or so) The JTAG debugger is used for programming if using Linux or Windows.

	===== Linux Firmware Programming =====		===== Linux / MacOS Firmware Programming =====

	Install required software:		Install required software:
Line 661:		Line 661:
	* Build stlink: make		* Build stlink: make
	* Copy binary to /usr/bin: sudo cp build/Release/bin/st-flash /usr/bin		* Copy binary to /usr/bin: sudo cp build/Release/bin/st-flash /usr/bin

			For MacOS, you can get the libraries from Homebrew:

			* libusb: https://formulae.brew.sh/formula/libusb
			* stlink: https://formulae.brew.sh/formula/stlink

	Attaching the debugger and programming firmware:		Attaching the debugger and programming firmware:

OpenPinballProject: /* STM32F103 */

2021-01-22T01:08:08Z

STM32F103

← Older revision		Revision as of 01:08, 22 January 2021
Line 588:		Line 588:

	=== STM32F103 ===		=== STM32F103 ===

			[[File:STM32ChangesToSupportAllWings.png]]

			[[File:STM32NeoInpPlank.png]]

			[[File:STM32NeoSolInpIncand.png]]

	=== PSOC4200 ===		=== PSOC4200 ===

OpenPinballProject: /* Assembly */

2021-01-22T00:56:30Z

Assembly

← Older revision		Revision as of 00:56, 22 January 2021
Line 584:		Line 584:

	When assembling, start with the shortest components and work towards tallest - resistors and jumpers, headers, and lastly, MOSFETs. The 2x6 header should be installed with the locking tab facing "down" as in the silkscreen.		When assembling, start with the shortest components and work towards tallest - resistors and jumpers, headers, and lastly, MOSFETs. The 2x6 header should be installed with the locking tab facing "down" as in the silkscreen.

			[[Image:solenoid-assembly.jpg]]

	=== STM32F103 ===		=== STM32F103 ===
Line 630:		Line 632:

	==== Attaching solenoid plank to PSOC4200 ====		==== Attaching solenoid plank to PSOC4200 ====

	~~[[Image:solenoid-assembly.jpg]]~~

	After assembly, it can be soldered in the appropriate spot on the ''Processor'' board. Be careful to line up the pins. If soldering as '''Interface''' , '''Wing 0''' and '''Wing 1''' positions, the bottom pin of the plank lines up with pin4.0 on the processor, and the top pin of the plank lines up with pin4.VDD. If soldering as '''Wing 2''' and '''Wing 3''' positions, the third pin from the bottom lines up with GND on the processor, and the top pin of the plank lines up with pin3.3SWDCLK. The bottom pin on the plank in this position should not be attached to VDD on USB to serial interface portion of the processor card. Make sure to add the extra jumper to attach the logic ground to the pulldown resistors when in '''Wing 2''' and '''Wing 3''' positions.		After assembly, it can be soldered in the appropriate spot on the ''Processor'' board. Be careful to line up the pins. If soldering as '''Interface''' , '''Wing 0''' and '''Wing 1''' positions, the bottom pin of the plank lines up with pin4.0 on the processor, and the top pin of the plank lines up with pin4.VDD. If soldering as '''Wing 2''' and '''Wing 3''' positions, the third pin from the bottom lines up with GND on the processor, and the top pin of the plank lines up with pin3.3SWDCLK. The bottom pin on the plank in this position should not be attached to VDD on USB to serial interface portion of the processor card. Make sure to add the extra jumper to attach the logic ground to the pulldown resistors when in '''Wing 2''' and '''Wing 3''' positions.

OpenPinballProject: /* Assembly */

2021-01-22T00:55:03Z

Assembly

@@ Line 553: / Line 553: @@
 The parts for the ''Solenoid'' wing are the four MOSFETs, four 10K Resistors, a 2x3 header and a 4-pin locking header.  If you are not using the ''direct switch'' capabilities of the ''Solenoid'' wing, it is recommended to leave the 4-pin out of the build as it causes some packaging issues when placing wings next to each other, as the 2x3 header sticks off the end of the board slightly and makes contact with the 4-pin header on the adjacent wing.
-[[Image:solenoid-assembly.png]]
+Start with the smallest components and work upwards - resistors, MOSFETs then headers.  The 2x3 header should be installed with the locking tab facing "up" as in the above diagram.
 ==== Incandescent Wing Assembly ====
 The through-hole ''Incandescent'' wing parts are eight 2N7000 MOSFETs, an 1x8 locking header for lamp connections and a 2-pin header for the 12V ground connection.  No resistors are required, so all resistor spots are left empty.
 The tab for the 2-pin header should face inwards towards the center of the board.
 ==== Switch Wing Assembly ====
 There is no physical wing board required for the ''Switch'' wing - it consists entirely of a single 8-pin 2.54mm locking header connected directly to the ''Processor'' board.
 ==== Power Filter Board ====
@@ Line 596: / Line 582: @@
 The parts for the ''Solenoid'' plank are the eight MOSFETs, eight 10K Resistors, a 2x6 header and a 8-pin locking header.
 When assembling, start with the shortest components and work towards tallest - resistors and jumpers, headers, and lastly, MOSFETs.  The 2x6 header should be installed with the locking tab facing "down" as in the silkscreen.
 === STM32F103 ===
@@ Line 626: / Line 608: @@
 The final step is to connect VDD and GND to the ''Interface'' wing by soldering wire from the ''Processor'' board to the ''Interface'' wing as per the diagram - GND to '''Pin 1''' and 5V to '''Pin 2'''.   This is required to power all the downstream ''Processor'' boards as none of them will be plugged into the USB connector which normally provides power.  The 8-pin ribbon cable used for serial communications also provides 5V and ground connections.
 == Firmware ==

OpenPinballProject: /* Assembly */

2021-01-22T00:46:12Z

Assembly

@@ Line 547: / Line 547: @@
 Once all the boards and the components are available, you can begin assembly.
+=== Common ===
 ==== Solenoid Wing Assembly ====
@@ Line 621: / Line 602: @@
 After assembly, it can be soldered in the appropriate spot on the ''Processor'' board.  Be careful to line up the pins.  If soldering as '''Interface''' , '''Wing 0''' and '''Wing 1''' positions, the bottom pin of the plank lines up with pin4.0 on the processor, and the top pin of the plank lines up with pin4.VDD.   If soldering as '''Wing 2''' and '''Wing 3''' positions, the third pin from the bottom lines up with GND on the processor, and the top pin of the plank lines up with pin3.3SWDCLK.  The bottom pin on the plank in this position should not be attached to VDD on USB to serial interface portion of the processor card.  Make sure to add the extra jumper to attach the logic ground to the pulldown resistors when in '''Wing 2''' and '''Wing 3''' positions.
 == Firmware ==

OpenPinballProject: /* Solenoid Wing */

2021-01-22T00:36:12Z

Solenoid Wing

← Older revision		Revision as of 00:36, 22 January 2021
Line 229:		Line 229:

	'''Note:''' The total number of crimp-style pins included in the BoM is higher than actually needed to account for re-crimping.		'''Note:''' The total number of crimp-style pins included in the BoM is higher than actually needed to account for re-crimping.

	'''Note 2:''' Since the price of the higher current (IRL540) MOSFETs have dropped, it now makes sense just to use these MOSFETs for all configurations.		'''Note 2:''' Since the price of the higher current (IRL540) MOSFETs have dropped, it now makes sense just to use these MOSFETs for all configurations.

OpenPinballProject: /* Solenoid Plank */

2021-01-22T00:35:41Z

Solenoid Plank

← Older revision		Revision as of 00:35, 22 January 2021
Line 540:		Line 540:

	'''Note:''' The total number of crimp-style pins included in the BoM is higher than actually needed to account for re-crimping. The interface section can only be populated if the plank board is installed as wing 0, wing 1 and using PSOC4200 processor boards.		'''Note:''' The total number of crimp-style pins included in the BoM is higher than actually needed to account for re-crimping. The interface section can only be populated if the plank board is installed as wing 0, wing 1 and using PSOC4200 processor boards.

	'''Note 2:''' Since the price of the higher current (IRL540) MOSFETs have dropped, it now makes sense just to use these MOSFETs for all configurations.		'''Note 2:''' Since the price of the higher current (IRL540) MOSFETs have dropped, it now makes sense just to use these MOSFETs for all configurations.

OpenPinballProject: /* Solenoid Plank */

2021-01-22T00:34:47Z

Solenoid Plank

← Older revision		Revision as of 00:34, 22 January 2021
Line 489:		Line 489:

	==== Solenoid Plank ====		==== Solenoid Plank ====

	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
Line 498:		Line 497:
	\|-		\|-
	\| 8		\| 8
	\| [~~http~~://www.mouser.com/~~ProductDetail~~/~~Fairchild~~-~~Semiconductor/FQP13N06L 512-FQP13N06L~~]		\| [https://www.mouser.com/_/?keyword=IRL540NPBF 942-IRL540NPBF]
	\| ~~FQP13N06L~~ MOSFET		\| N-Channel MOSFET 100V 36A
	\| $0.67/ea		\| $0.71/ea
	\|-		\|-
	\| 8		\| 8
	\| [~~http~~://www.mouser.com/~~ProductDetail/Yageo~~/CFR-12JR-~~52-10K/~~ 603-CFR-12JR-5210K]		\| [https://www.mouser.com/_/?keyword=CFR-12JR-5210K 603-CFR-12JR-5210K]
	\| 10K Ohm Resistor (1/6W 5%)		\| 10K Ohm Resistor (1/6W 5%)
	\| $0.02/ea		\| $0.02/ea
	\|-		\|-
	\| 1		\| 1
	\| [~~http~~://www.mouser.com/~~ProductDetail/Molex~~/35317-1220/ 538-35317-1220]		\| [https://www.mouser.com/_/?keyword=35317-1220 538-35317-1220]
	\| Molex 12-pin 4.2 mm Mini-Fit Header		\| Molex 12-pin 4.2 mm Mini-Fit Header
	\| $0.66/ea		\| $0.66/ea
	\|-		\|-
	\| 12		\| 12
	\| [~~http~~://www.mouser.com/~~ProductDetail/Molex~~/39-00-0039/ 538-39-00-0039]		\| [https://www.mouser.com/_/?keyword=39-00-0039 538-39-00-0039]
	\| Molex Crimp-Style 4.2 mm 24-18AWG Female Pins		\| Molex Crimp-Style 4.2 mm 24-18AWG Female Pins
	\| $0.19/ea		\| $0.19/ea
	\|-		\|-
	\| 1		\| 1
	\| [~~http~~://www.mouser.com/~~ProductDetail/Molex~~/39-01-2125/ 538-39-01-2125]		\| [https://www.mouser.com/_/?keyword=39-01-2125 538-39-01-2125]
	\| Molex 12-pin 4.2 mm Mini-Fit Housing		\| Molex 12-pin 4.2 mm Mini-Fit Housing
	\| $0.74/ea		\| $0.74/ea
Line 525:		Line 524:
	\|-		\|-
	\| 1		\| 1
	\| [~~http~~://www.mouser.com/~~ProductDetail/TE-Connectivity~~/640454-8/ 571-6404548]		\| [https://www.mouser.com/_/?keyword=640454-8 571-6404548]
	\| 8-pin 2.54 mm Polarized Header		\| 8-pin 2.54 mm Polarized Header
	\| $0.45/ea		\| $0.45/ea
	\|-		\|-
	\| 12		\| 12
	\| [~~http~~://www.mouser.com/~~ProductDetail/Molex~~/08-50-0136/ 538-08-50-0136]		\| [https://www.mouser.com/_/?keyword=08-50-0136 538-08-50-0136]
	\| Molex Crimp-Style 2.54 mm KK Pins		\| Molex Crimp-Style 2.54 mm KK Pins
	\| $0.13/ea		\| $0.13/ea
	\|-		\|-
	\| 1		\| 1
	\| [~~http~~://www.mouser.com/~~ProductDetail/Molex~~/22-01-2087/ 538-22-01-2087]		\| [https://www.mouser.com/_/?keyword=22-01-2087 538-22-01-2087]
	\| Molex 8-pin 2.54 mm Housing		\| Molex 8-pin 2.54 mm Housing
	\| $0.32/ea		\| $0.32/ea
	\|-
	~~\|colspan=4\|Parts Needed ONLY If Populating Interface Section~~
	\|-
	~~\| 2~~
	~~\| [http://www.mouser.com/ProductDetail/Amphenol-FCI/68602-108HLF/ 649-68602-108HLF]~~
	~~\| 2 x 4 position 2.54 mm Header~~
	~~\| [http://mezelmods.com/collections/under20/products/4-pin-2-54mm-dual-in-line-row-male-header-connector $0.20/ea]~~
	\|-
	~~\| 1~~
	~~\| [http://www.mouser.com/ProductDetail/TE-Connectivity/640454-4/ 640454-4]~~
	~~\| Molex 4-Pin 2.54 mm Polarized Header~~
	~~\| $0.12/ea~~
	\|-
	~~\| 2~~
	~~\| [http://www.mouser.com/ProductDetail/Molex/22-01-2047/ 538-22-01-2047]~~
	~~\| Molex 4-Pin 2.54 mm Housing~~
	~~\| $0.17/ea~~
	\|-
	~~\| 10~~
	~~\| [http://www.mouser.com/ProductDetail/Molex/08-50-0136/ 538-08-50-0136]~~
	~~\| Molex Crimp-Style 2.54 mm KK Pins~~
	~~\| $0.13/ea~~
	\|-
	~~\| 2~~
	~~\| eBay (search "FC-8P")~~
	~~\| FC-8P IDC Socket 2.54 mm~~
	~~\| [http://mezelmods.com/collections/under20/products/fc-8p-2-54mm-idc-connector-8-pin-cable-socket $0.20/ea]~~
	\|-
	~~\| ~10ft~~
	~~\| eBay (search "8 pin IDC cable")~~
	~~\| 8-pin IDC Flat cable~~
	~~\| ~$1/ft~~
	\|-
	~~\|colspan=4\|Pin-Compatible Higher Current MOSFET (Flippers, etc.)~~
	\|-
	~~\| 8~~
	~~\| [http://www.mouser.com/ProductDetail/Infineon-Technologies/IRL540NPBF 942-IRL540NPBF]~~
	~~\| N-Channel MOSFET 100V 36A~~
	~~\| $1.55/ea~~
	\|}		\|}

	'''Note:''' The total number of crimp-style pins included in the BoM is higher than actually needed to account for re-crimping. The interface section can only be populated if the plank board is installed as wing 0, wing 1 and ~~interface board~~.		'''Note:''' The total number of crimp-style pins included in the BoM is higher than actually needed to account for re-crimping. The interface section can only be populated if the plank board is installed as wing 0, wing 1 and using PSOC4200 processor boards.
			'''Note 2:''' Since the price of the higher current (IRL540) MOSFETs have dropped, it now makes sense just to use these MOSFETs for all configurations.

	== Assembly ==		== Assembly ==

OpenPinballProject: /* Processor Board */

2021-01-22T00:23:11Z

Processor Board

← Older revision		Revision as of 00:23, 22 January 2021
Line 174:		Line 174:
	\|}		\|}

	'''Note:''' ~~The 40-pin header is available much cheaper in larger quantities from eBay - search for "1x40 2.54mm header". These parts are also available through Mezel Mods.~~ The STM32F103C8T6 processor boards come with the headers so there is no need to purchase them anymore.		'''Note:''' The STM32F103C8T6 processor boards come with the headers so there is no need to purchase them anymore.

	==== Solenoid Wing ====		==== Solenoid Wing ====