Arcade Cabinet Linking - Revision history

Camo Yoshi at 00:24, 28 November 2023

2023-11-28T00:24:43Z

← Older revision		Revision as of 00:24, 28 November 2023
Line 133:		Line 133:

	TODO - Mix of the steps from above		TODO - Mix of the steps from above

			==Techincal Information==

			The games uses Ethernet II broadcast frames and do not have any concept of TCP/IP networking - Hence you must use unmanaged switches or hubs, and layer 2 tunneling VPN solutions. Each packet is broadcast so there is a high amount of PPS (packets per second). RTT latency and packet loss are major factors with regards to your experience in quality linked games, so avoiding using wireless (either WiFi or cellular internet providers) where possible is ideal. From limited testing we find that a RTT latency of 100ms or less and less than 1% packet loss is the most ideal.

Camo Yoshi: /* Automated install script */

2023-11-28T00:19:47Z

Automated install script

← Older revision		Revision as of 00:19, 28 November 2023
Line 44:		Line 44:

	=====Automated install script=====		=====Automated install script=====

			This is a work in progress - The script will be linked here once it is ready.

	=====Manual setup=====		=====Manual setup=====

Camo Yoshi: /* OpenWRT Device */

2023-11-28T00:15:26Z

OpenWRT Device

← Older revision		Revision as of 00:15, 28 November 2023
Line 124:		Line 124:
	10. Repeat these steps for any additional OpenWRT devices at other locations.		10. Repeat these steps for any additional OpenWRT devices at other locations.

	Wait for about 5-10 seconds and check if your devices appear in your My ZeroTier account, then check the "Auth?" checkbox and optionally give each one a name.		11. Wait for about 5-10 seconds and check if your devices appear in your My ZeroTier account, then check the "Auth?" checkbox and optionally give each one a name.

	Click the wrench icon for each device and check the following boxes: Allow Ethernet Bridging, Do Not Auto-Assign IP.		12. Click the wrench icon for each device and check the following boxes: Allow Ethernet Bridging, Do Not Auto-Assign IP.

	==Real cabinet(s) and MAME PC(s) at multiple physical locations==		==Real cabinet(s) and MAME PC(s) at multiple physical locations==

	TODO - Mix of the steps from above		TODO - Mix of the steps from above

Camo Yoshi at 00:15, 28 November 2023

2023-11-28T00:15:11Z

← Older revision		Revision as of 00:15, 28 November 2023
Line 96:		Line 96:
	====OpenWRT Device====		====OpenWRT Device====

	# By default, OpenWRT uses a 192.168.1.0/24 subnet, which may overlap with your current network at home - You will want to change this to prevent overlapping IP addresses to prevent packet routing issues. A good option would be to use 192.168.209.1 for the OpenWRT device. Change this on your br-lan interface and then reconnect to your router's new IP address.		1. By default, OpenWRT uses a 192.168.1.0/24 subnet, which may overlap with your current network at home - You will want to change this to prevent overlapping IP addresses to prevent packet routing issues. A good option would be to use 192.168.209.1 for the OpenWRT device. Change this on your br-lan interface and then reconnect to your router's new IP address.

	# Connect your existing network into the WAN/Internet port on your OpenWRT device so has internet connectivity.		2. Connect your existing network into the WAN/Internet port on your OpenWRT device so has internet connectivity.

	# Navigate to System > Software and click "Refresh Lists".		3. Navigate to System > Software and click "Refresh Lists".

	# In the package list, filter for "zerotier" and install the "zerotier" package.		4. In the package list, filter for "zerotier" and install the "zerotier" package.

	# SSH into your router and execute the following commands as root:		5. SSH into your router and execute the following commands as root:

	<code>uci set zerotier.openwrt_network=zerotier</code>		<code>uci set zerotier.openwrt_network=zerotier</code>
Line 114:		Line 114:
	<code>uci commit zerotier</code>		<code>uci commit zerotier</code>

	# Reboot your router.		6. Reboot your router.

	# Navigate to Network > Interfaces and click on the Devices tab.		7. Navigate to Network > Interfaces and click on the Devices tab.

	# Edit the br-lan device. In the dropdown, select the ZeroTier virtual interface (Interface name will start with ztpp).		8. Edit the br-lan device. In the dropdown, select the ZeroTier virtual interface (Interface name will start with ztpp).

	# Save and apply the changes.		9. Save and apply the changes.

	# Repeat ~~this step~~ for any additional OpenWRT devices at other locations.		10. Repeat these steps for any additional OpenWRT devices at other locations.

	~~== Real cabinet(s)~~ and ~~MAME PC(s) at multiple physical locations==~~		Wait for about 5-10 seconds and check if your devices appear in your My ZeroTier account, then check the "Auth?" checkbox and optionally give each one a name.

	TODO		Click the wrench icon for each device and check the following boxes: Allow Ethernet Bridging, Do Not Auto-Assign IP.

			==Real cabinet(s) and MAME PC(s) at multiple physical locations==

			TODO - Mix of the steps from above

Camo Yoshi: /* Manual setup */

2023-11-28T00:13:05Z

Manual setup

Camo Yoshi: /* Real cabinet(s) at multiple physical locations */

2023-11-28T00:11:58Z

Real cabinet(s) at multiple physical locations

@@ Line 27: / Line 27: @@
 ==Real cabinet(s) at multiple physical locations==
-TODO
+In order to link one or more cabinets at multiple locations you will need some sort of network device that can bridge Layer 2 network traffic over a VPN connection where each cabinet or cabinets are located. The simplest to set up is [https://zerotier.com/ ZeroTier].
 == Real cabinet(s) and MAME PC(s) at multiple physical locations==
 TODO

Camo Yoshi: /* Real cabinet(s) and MAME PC(s) at one physical location */

2023-11-27T23:08:19Z

Real cabinet(s) and MAME PC(s) at one physical location

← Older revision		Revision as of 23:08, 27 November 2023
Line 17:		Line 17:
	TODO: Detailed steps		TODO: Detailed steps

			* Test if game can run at full speed on PC (critical for reliable linked play)
	* Install TAP adapter		* Install TAP adapter
	* Create bridge between NIC and TAP adapter		* Create bridge between NIC and TAP adapter

Camo Yoshi: Created page with "This article goes over all the aspects you need to know when it comes to linking either real physical cabinets, PCs running MAME, or a combination of the two. Please note these tutorials are written with the expectation you have basic computer knowledge like how to use a command line interface as well as fundamental networking concepts. Disclaimer: MAME networking support is still very much in an alpha state. The emulator has a tendency to crash at random and wireless i..."

2023-11-27T23:07:05Z

Created page with "This article goes over all the aspects you need to know when it comes to linking either real physical cabinets, PCs running MAME, or a combination of the two. Please note these tutorials are written with the expectation you have basic computer knowledge like how to use a command line interface as well as fundamental networking concepts. Disclaimer: MAME networking support is still very much in an alpha state. The emulator has a tendency to crash at random and wireless i..."

New page

This article goes over all the aspects you need to know when it comes to linking either real physical cabinets, PCs running MAME, or a combination of the two. Please note these tutorials are written with the expectation you have basic computer knowledge like how to use a command line interface as well as fundamental networking concepts.

Disclaimer: MAME networking support is still very much in an alpha state. The emulator has a tendency to crash at random and wireless interfaces are '''NOT SUPPORTED'''. You must use a wired network interface. Additionally this likely only works on Windows and Linux (unverified) - MacOS is not supported.

First, determine which scenario applies to your setup the best by looking at the table of contents:

__TOC__

==Real cabinets at one physical location==

This is the easiest scenario - All you simply have to do is connect one or more (maximum of 8) cabs to the same unmanaged network switch. Afterwords, adjust each cabinet's setting so that the car color (for San Francisco Rush/Rush The Rock) or cabinet number (for Rush 2049) is different for each cab. You can then enter the network test on every cab through the test menu - Each cab should show up on each other cab. From there reboot back into the game and start a game and select a course on one cab. All other cabs should get an invitation to join the game that is about to start.

==Real cabinet(s) and MAME PC(s) at one physical location==

First, connect one or more (maximum of 8) cabs and/or PCs to the same unmanaged network switch.

TODO: Detailed steps

* Install TAP adapter
* Create bridge between NIC and TAP adapter
* Configure MAME to use TAP adapter
* Set up game (change car color/cab number, network test)

Afterwords, adjust each cabinet's setting so that the car color (for San Francisco Rush/Rush The Rock) or cabinet number (for Rush 2049) is different for each cab. You can then enter the network test on every cab through the test menu - Each cab should show up on each other cab.

==Real cabinet(s) at multiple physical locations==

TODO

== Real cabinet(s) and MAME PC(s) at multiple physical locations==

TODO

← Older revision		Revision as of 00:13, 28 November 2023
Line 47:		Line 47:
	=====Manual setup=====		=====Manual setup=====

	# Install packages via package manager:		1. Install packages via package manager:

	<code>apt update && apt install curl bridge-utils gpg</code>		<code>apt update && apt install curl bridge-utils gpg</code>

	# Add the ZeroTier GPG Key, download and install ZeroTier:		2. Add the ZeroTier GPG Key, download and install ZeroTier:

	<code>curl -s 'https://raw.githubusercontent.com/zerotier/ZeroTierOne/master/doc/contact%40zerotier.com.gpg' \| gpg --import && if z=$(curl -s 'https://install.zerotier.com/' \| gpg); then echo "$z" \| sudo bash; fi</code>		<code>curl -s 'https://raw.githubusercontent.com/zerotier/ZeroTierOne/master/doc/contact%40zerotier.com.gpg' \| gpg --import && if z=$(curl -s 'https://install.zerotier.com/' \| gpg); then echo "$z" \| sudo bash; fi</code>

	# Join your ZeroTier network you created earlier:		3. Join your ZeroTier network you created earlier:

	<code>zerotier-cli join 123abc456def789g</code>		<code>zerotier-cli join 123abc456def789g</code>

	# Wait for about 5-10 seconds and check if your device appears in your My ZeroTier account, then check the "Auth?" checkbox and optionally give it a name.		4. Wait for about 5-10 seconds and check if your device appears in your My ZeroTier account, then check the "Auth?" checkbox and optionally give it a name.

	# Click the wrench icon and check the following boxes: Allow Ethernet Bridging, Do Not Auto-Assign IP.		5. Click the wrench icon and check the following boxes: Allow Ethernet Bridging, Do Not Auto-Assign IP.

	# Check that your device has connected to your ZeroTier network:		6. Check that your device has connected to your ZeroTier network:
	<code>zerotier-cli info</code>		<code>zerotier-cli info</code>

	# Identify your network interfaces and note the name of the wired network interface that will connect to the switch that your cabs will be plugged into, as well as the name of your ZeroTier interface (starts with <code>zt</code>):		7. Identify your network interfaces and note the name of the wired network interface that will connect to the switch that your cabs will be plugged into, as well as the name of your ZeroTier interface (starts with <code>zt</code>):

	<code>ip a</code>		<code>ip a</code>

	# Create a bridge and add the interfaces to the bridge:		8. Create a bridge and add the interfaces to the bridge:

	<code>brctl addbr br0</code>		<code>brctl addbr br0</code>
Line 78:		Line 78:
	<code>brctl addif br0 ztppabc123</code>		<code>brctl addif br0 ztppabc123</code>

	# Restart your networking stack to apply the changes:		9. Restart your networking stack to apply the changes:

	<code>systemctl restart networking</code>		<code>systemctl restart networking</code>