Document error codes of the games

[icex2]

Though this is not bemanitools specific, I think it is very valuable to have this part of the documentation since many users are facing these errors and error codes, can't read them and don't know what to do. I know these are part of the manuals as well but the accessability is likely an issue.

Examples: The network error on startup when eamuse is enabled but not configured properly; Error when backup data is corrupted.

Start a document with various sections for the different games (?) and document the error codes with an English translation and what the potential actions are.

[icex2]

In GitLab by @Emmi on Oct 15, 2020, 12:13

Bemaniso.ws wiki provides error codes already.

[icex2]

Thanks for the pointer. That is right but these are not accessible to people without accounts. Also, I would not have expected these to be there, so I consider this also a fairly hidden spot for this kind of information. The goal of this task is to make them more visible, e.g. when you are setting up the game anyway and will likely run into any of the error codes at that point.

[icex2]

Blunt copy-paste (with some redaction) from above source, these should go into a separate document that is linked in various FAQ sections, e.g. iidxhook readmes.

== 5-0000 series errors ==
=== 5-0000-0000 ===
What is it?
A generic critical error.

How do I fix it?
[*] Make sure your data is not set to read only, especially the dev folder.
[*] Disable all network adapters other than the one used to connect to the Internet.
[*] Check for hidden network adapters in Device Manager.

== 5-1500 series errors ==
===  5-1500-0000 ===
What is it?
[b]IO ERROR[/b]
Seen in Pop'n Music 15 Adventure.

How do I fix it?
No fix yet, contribute if you find one!

=== 5-1500-0002 ===
What is it?
[b]SOUND DATA CREATE ERROR[/b]

How do I fix it?
[*] Hash check your original download of the data and recopy from your seeding directory to your gameplay one.
[*] Check your physical drive. Is it failing?

== 5-1501 series errors ==
=== 5-1501-0000 ===
What is it?
[b]IO BOARD ERROR[/b]

How do I fix it?
[*] Recopy Bemanitools.
[*] For Reflec Beat, make sure you are not missing device.dll.

== 5-1502 series errors ==
=== 5-1502-0000 ===
What is it?
[b]BACKUP CHECK ERROR[/b]
Seen in Pop'n'Music 21 Sunny Park

How do I fix it?
[*]Give access to gamestart.bat and launcher.exe from Windows Firewall if enabled.
[*]Make sure no antivirus software firewall is blocking access to those files.
[*]Start gamestart.bat as Administrator.

=== 5-1502-0000 ===
What is it?
[b]HDD READ ERROR[/b]

How do I fix it?
[*] Make sure /dev/ isn't read-only.

=== 5-1502-0002 ===
What is it?
[b]HDD READ ERROR[/b]
Seen in GFDM V4.

How do I fix it?
No fix yet, contribute if you find one!

== 5-1503 series errors ==
=== 5-1503-0000 ===
What is it?
[b]USB I/O ERROR (FPGA WRITE ERROR)[/b]

How do I fix it?
[*] Make sure data\hex\030408.hex exists.

=== 5-1503-0001 ===
What is it?
[b]DATA ERROR[/b] "Could not read the file normally. There is a likelihood the file is damaged." This error occurs when a file is either missing or corrupt.

How do I fix it?
[*] Hash check your original download of the data and recopy from your seeding directory to your gameplay one.
[*] If the data came in an archive format, try extracting it again with another application.
[*] Make sure your game is up to date with the current data available.
[*] Check your physical drive. Is it failing?

=== 5-1503-0004 ===
What is it?
[b]USBIO ERROR (NO ANSWER...)[/b]. This error occurs when the game does not receive a heartbeat from the IO board. On legitimate hardware, this error is usually caused by the IO board resetting during play. The issue is rarely fixed by simply restarting the game and will require a full power cycle.

How do I fix it?
[b]Real hardware[/b]
[*] Check the USB cable between the PC and the IO board is okay.
[*] Make sure the IO board is getting enough of a clean supply of power.

[b]Bemanitools[/b]
[*] Don't attempt to put your computer to sleep while playing rhythm games.
[*] Change launcher.exe process priority to High when starting the game.

=== 5-1503-0006 ===
What is it?
[b]CARD DEVICE ERROR[/b]

How do I fix it?
[*] Recopy Bemanitools.

=== 5-1503-0007 ===
What is it?
[b]USBIO ERROR (FM DL-ERR)[/b]

How do I fix it?
[*] Run the game using gamestart.bat, don't just drag and drop the game dll onto launcher.exe

=== 5-1503-0008 ===
What is it?
[b]FPGA Write error[/b]
Seen in Tricoro Omnimix RC1.

How do I fix it?
[*] Update Bemanitools 4

=== 5-1503-9000 ===
What is it?
[b]PCB ERROR (PCB is unusual.)[/b]

How do I fix it?
[*] Make sure your AC(real)IO board is on the correct COM port.

== 5-1504 series errors ==
=== 5-1504-0000 ===
What is it?
[b]IC CARD READER ERROR[/b] Something is wrong with your e-amusement card readers (usually a timeout due to them not existing).

How do I fix it?
[b]Real hardware[/b]
[*] Make sure your readers are connected and powered on.
[*] Check your serial cables are good.

=== 5-1504-0003 ===
=== 5-1504-0004 ===
What is it?
[b]SDLOAD TIMEOUT[/b] or [b]SOUND LOAD TIMEOUT[/b]

How do I fix it?
[*] Update Bemanitools, or downgrade to 4.21bis

== 5-1505 series errors ==
=== 5-1505-0000 ===
[b]For Jubeat Ripples:[/b] Getting this error the first time you boot is normal. After getting this error, the game may take 1-3 minutes longer to boot as it regenerates backup data.

What is it?
[b]HDD Data Error(BPM Notes)[/b]

How do I fix it?
[*] Hash check your original download of the data and recopy from your seeding directory to your gameplay one.
[*] If the data came in an archive format, try extracting it again with another application.
[*] Check your physical drive. Is it failing?

=== 5-1505-0001 ===
What is it?
[b]HDD Data Error(Music Data)[/b]

How do I fix it?
[*] Hash check your original download of the data and recopy from your seeding directory to your gameplay one.
[*] If the data came in an archive format, try extracting it again with another application.
[*] Check your physical drive. Is it failing?

=== 5-1505-0002 ===
What is it?
[b]Coin Error[/b] This error occurs when the coin line (the input triggered when a coin is inserted) is held closed for too long.

How do I fix it?
[b]Real hardware[/b]
[*] There may be a coin stuck, check.
[*] The coin mechanism may be stuck, check.
[*] Don't hold down the coin line so long.

=== 5-1505-0006 ===
What is it?
[b]HDD DATA ERROR(MOUNT IMAGEFS)[/b]

How do I fix it?
[*] Hash check your original download of the data and recopy from your seeding directory to your gameplay one.
[*] If the data came in an archive format, try extracting it again with another application.
[*] Check your physical drive. Is it failing?

=== 5-1505-0025 ===
[b]For Jubeat Saucer Fullfill[/b]

How do I fix it?
[*]Disable excess network adapters

== 5-1506 series errors ==
=== 5-1506-0000 ===
What is it?
[b]ACIO ERROR (ERR_INIT_LINE)[/b]

How do I fix it?
[*] If you're using ACrealIO, cut the reset trace on your Arduino.

=== 5-1506-0001 ===
What is it?
[b]SHOP NAME ERROR[/b]
This error may happen before the monitor check on IIDX.

How do I fix it?
[*] Press the service button and set the shop name in "NETWORK OPTIONS".

=== 5-1506-1001 ===
What is it?
[b]CLOCK ERROR[/b]

How do I fix it?
[*] "Set" and save the clock date and time in the test menu
[*] Recopy Bemanitools

== 5-1507 series errors ==
=== 5-1507-0000 ===
What is it?
[b]SECURITY ERROR[/b]

How do I fix it?
Make sure your ea3-config.xml file contains valid values on the following lines:
[*] <dest __type="str">[b]?[/b]</dest>
Should almost always be [b]J[/b]. Certain games will support K (Korea) or A (Asia) but there is rarely a reason to use it. DDR 2014 and forward will support U. DanEvo will support (I believe) C.
[*] <spec __type="str">[b]?[/b]</spec>
Should almost always be [b]A[/b]. DDR will support B for non-HD monitors.
[*] <rev __type="str">[b]?[/b]</rev>
Should always be [b]A[/b].

== 5-1508 series errors ==
=== 5-1508-0000 ===
What is it?
[b]LAMP CHECK ERROR[/b]
Seen in Pop'n Music 20 Fantasia.

How do I fix it?
[*] Update Bemanitools

== 5-1509 series errors ==
=== 5-1509-0000 ===
What is it?
[b]REBOOT THE MACHINE[/b]
Seen in Pop'n Music 22 Lapistoria.
The original message in Japanese: 電源を再投入して下さい

How do I fix it?
Restart entire machine if on cabinet, or close the game (ALT+F4/ALT+TAB and then close through taskbar) and re-run the launcher/gamestart file

== 5-2000 series errors (Network errors) ==
=== 5-2000-0000 ===
What is it?
[b]Router error[/b]. Something's not okay with the connection between the game and your router. This can either be a (W)LAN error, or something within your computer settings (firewall, network adapter, etc.)

How do I fix it?
[*]Restart your game.
[*]Check if your computer is connected to the Internet at all.
[*]Make sure the services URL is correct.
[*]Disable all network adapters other than the one used to connect to the Internet. Alternatively, setting that adapter to have the highest affinity also works.
[*]If none of the above work, reinstall a newer or older version of your network drivers.

=== 5-2002-0000 ===
What is it?
[b][i]speculation[/i]: general malformed ea3-config.xml file or server communication error[/b]

How do I fix it?
[*]Make sure you're editing the right file for network configuration settings.

=== 5-2002-0916 ===
Cannot communicate with the server.

=== 5-2002-2301 ===
Cannot communicate with the server.

Your ea3 services URL is probably incorrect.

=== 5-2000-2402 ===
What is it?
[b]No PCBID[/b]. You have no PCBID.

How do I fix it?
[*]Add a valid PCBID to ea3-config.xml.

=== 5-2002-0910 ===
What is it?
[b]Server Error[/b]. The game cannot communicate with the server.

How do I fix it?
[*]Make sure the services URL is correct.

=== 5-2002-2403 ===
What is it?
[b]Unauthorized[/b]. The server is rejecting your PCBID.

How do I fix it?
[*]Check that there is a valid PCBID in ea3-config.xml.

=== 5-2002-2400 ===
What is it?
[b]Bad Request[/b]. Syntax was entered improperly and the server does not understand it.

How do I fix it?
[*]Check your services URL and make sure it is entered correctly (e.g. "http:" instead of "https:")

=== 5-2002-2404 ===
What is it?
[b]Not found[/b]. The server can't find the URL that the game has requested, this is usually because the game is attempting to connect to an incorrect endpoint.

How do I fix it?
[*]Check your services URL in ea3-config.xml. Make sure to remove any slash at the end of the URL and check for https/http.
[*]If you are running Spada, ensure to use a service URL that supports that older game (check with your private server provider)
[*]If you are running Tune Street, ensure to use a service URL that supports that older game (check with your private server provider)

=== 5-2003-2404 ===
What is it?
[b]Malformed <network> section[/b].  The <network> section in your ea3-config.xml file is malformed in some way.

How do I fix it?
[*]Ensure your <network> section follows the following format:
[quote] <network>
        <timeout __type="u32">10000</timeout>
        <sz_xrpc_buf __type="u32">102400</sz_xrpc_buf>
        <ssl __type="bool">0</ssl>
        <services></services>
        <url_slash __type="bool">1</url_slash> (note: delete this line if you're connecting to Arcana)
    </network>[/quote]

=== 5-2002-2500 ===
What is it?
??? (Logs say http status 500)
If you are playing Lincle, use the /core/services URL from Tricoro, not xrpc.

=== 5-2003-2502 ===
What is it?
[b]Server Error[/b]. The game cannot communicate with the server.

How do I fix it?
[*]Check if your hosts file has any dns redirects to other private servers that might interfere with this

=== 5-2016-0000 ===
What is it?
"apsmanager" is a special eAM Participation system for Korean machines(XXX:K). This system is maybe not supported by private servers.

How do I fix it?
[*]Make sure your ea3-config has this line set to 0
[quote]<apsmanager __type="u8">0</apsmanager>[/quote]

[icex2]

In GitLab by @Emmi on Nov 16, 2020, 12:30

Could always ship a HTML file, PDF or CHM with bemanitools to include extensive information on common errors, fixes etc.

[icex2]

https://dev.s-ul.net/djhackers/bemanitools/-/merge_requests/94 kicks this off. Further codes and documentation should be added in the future by anyone encountering error codes and having knowledge about them. Considering this issue resolved.