cafe.batopens with a warning message.
The CAT-DEV tool chain uses TCP/IP broadcast packets to find CAT-DEVs by name or MAC address if the IP address is unknown. However, many corporate network environments do not allow broadcast packets and filter them at the router level.
Try using a local switch to connect the host PC and the CAT-DEV to your network. A local, unmanaged switch provides a direct routing path between the host PC and the CAT-DEV, bypassing this restriction.
You may also use a static IP configuration for the CAT-DEV. However, if broadcast packets are not allowed, connect the host PC directly to the CAT-DEV. For more information, see Direct Connection in the Alternate Connections section.
The CAT-DEV cannot communicate with a host PC from a different broadcast domain. Ensure that the CAT-DEV and the host PC are in the same broadcast domain. Consult your IT department for details.
The Windows Firewall may interfere with operation of the
findbridge tool. To unblock the tool:
The CAT-DEV is not reachable if the Local LAN Access feature is not allowed on the network. If it is allowed, enable the Allow Local LAN Access feature in your VPN client.
If DHCP is disabled in your network environment, configure a static IP address on the CAT-DEV. Because DHCP is not available, you must connect the host PC and CAT-DEV together directly. For more information, see the Direct Connection in the Alternate Connections section.
After you have establish a direct connection with the CAT-DEV and can access the configuration page for the host bridge, follow the instructions in the Set Up A Static IP Address section of Direct Connection.
As a last resort for CAT-DEV connection issues, you may restore the CAT-DEV network configuration parameters to the factory default settings:
There are several LEDs on the front of the CAT-DEV that show information about the state of MION and CAFE. For information about the LEDs, see Devkit LEDs
When you open
cafe.bat, you receive the following warning message.
************************************* WARNING: GHS MULTI.EXE not found at C:\ghs\multixxxx\ YOU MUST ACQUIRE AND INSTALL MULTI TO BUILD ************************************* mionps: ERROR: MIONTCPSession to ip 10.1.4.149 returned error code 5
cafe.bat script expects a specific version of MULTI as documented in the Cafe SDK Release Notes. If you have installed a later version of MULTI, and wish to avoid a warning message, update the MULTI version referenced in
cafe.bat to match the version of MULTI that you installed.
cafe.bat, and then click Edit. The
cafe.batscript opens in a text editor.
set GHS_ROOT=C:\ghs\multi53xx, where "
53xx" corresponds to the expected version of MULTI such as "
5318", and then change the version to match the version of MULTI that you downloaded and installed. For example, if you installed MULTI version 5.3.19, then change the version in the code to
If you encounter DRC issues and want to post the issue for feedback from other developers or Nintendo technical support, it would be helpful to have as much information at possible. Use the suggested form found on DRC Bug Report Form to help you collect and post the information necessary to help others understand your problem.
Update of the boot1 image will fail when there are multiple directories under the update directory, which is
%CAFE_ROOT%\data\mlc\sys\update\pcfs. The failure message is:
Update /vol/storage_hfiomlc01/sys/update/pcfs Failed: -262146
The ON (Blue) LED also blinks.
To resolve this issue, please delete any directories under
which were not originally packaged in the SDK.
Sometimes, SDK demos may fail to run because of errors related to file permissions on the host PC. For example, you may see the following error message:
To work around these issues, run
rebaseall from an
dash shell command prompt:
cygwin\binfolder. By default, this location is
Sometimes there are difficulties switching to NAND boot mode, because of rare NAND corruption issues. To recover from such a scenario and return to PCFS boot mode try one of the following options.
cafex recovercommand. This step will format the NAND on the CAT-DEV and leave it in a clean state
cattoucan -p localhost:6001to monitor the CAT-DEV status
devkitmsg 'update /vol/storage_hfiomlc01/sys/update/pcfs'
To return the CAT-DEV to PCFS boot mode after successfully using one of these options, ensure that
CAFE_BOOT_MODE is set to
PCFS in your environment. If none of these options work, contact your local Nintendo developer software support group.
$ make run ------------------------------------------------------------------ Building/Installing demo/helloworld DEBUG >> Compiling helloworld ... ------------------------------------------------------------------ caferun -b -w 0 /cygdrive/k/sdk/cafe_sdk/system/bin/ghs/cafe/demo/helloworld/DEBUG/helloworld.rpx caferun: Will use NAND file system caferun: bridge parameters: -em caferun: Copying default config file to /cygdrive/k/sdk/cafe_sdk/system/bin/ghs/cafe/demo/helloworld/DEBUG/app.xml caferun: Copying default config file to /cygdrive/k/sdk/cafe_sdk/system/bin/ghs/cafe/demo/helloworld/DEBUG/cos.xml Updating title id, group id and app type in /cygdrive/k/sdk/cafe_sdk/data/disc/meta/meta.xml, based on /cygdrive/k/sdk/cafe_sdk/system/bin/ghs/cafe/demo/helloworld/DEBUG/app.xml... devkitmsg failed: timed out waiting for response (258) make: *** [rerun_binary] Error 127 make: *** [rerun] Error 2
cafex run" and "
cafex setbootmodePCFS" commands fail
If the Boot Mode is set to NAND and the System Mode is set to Production, the
cafex run and
cafex setbootmode PCFS commands fail. To use these commands, you must to change the System Mode. To learn how to change the System Mode, see Change CAT-DEV Boot Modes. The new setting is enabled after restarting.
If the Boot Mode is set to PCFS and the System Mode is set to
cafex on and
cafex run commands
fail. You must edit
dev_mode in the
system.xml file to recover.
To learn how to change dev_mode, see System Config Tool: Boot Configuration.
When a CAT-DEV is configured to boot from NAND, but
CAFE_BOOT_MODE is set
erroneously set to
cafex run will always load the default
title, which in this case is System Config Tool.
When this behavior is encountered, ensure that
CAFE_BOOT_MODE is set to
NAND in the Cafe shell.
ERROR: __CATDEVStateMgr_BootMismatch: Environment boot mode [PCFS] does not match CATDEV boot mode [NAND]
then the CAT-DEV has been configured for NAND boot mode but the
CAFE_BOOT_MODE environment variable is set to PCFS.
To resolve this issue, either:
CAFE_BOOT_MODEto the correct value (NAND) and re-run; or alternatively,
cafex_env.batsession, as the CAT-DEV’s internal state determines the setting of
CAFE_BOOT_MODEfor the next session.
The screen on the TV or DRC that is connected to the CAT-DEV becomes dimmed.
To resolve this issue:
Set the Screen Burn-In Reduction option from the HOME Menu (HBM) and/or set the Auto Dimming option using the System Config Tool.
2014/09/30 Updated Troubleshoot to include screen issues.
2014/01/24 Updated to '
cafex cleardata' command.
2013/12/20 Cygwin->CMD transition changes.
2013/09/11 Added a new way to recover from corrupted NAND
2013/07/20 Added information about deleting data before returning system for repair.
2013/05/08 Automated cleanup pass.
2013/03/22 Add update and mismatched boot mode errors.
2013/03/06 Merge the diverse troubleshooting sections.
2013/02/15 Edit pass
2012/07/26 Updated section for recovering CAT-DEVs
2012/05/04 Use the correct devkitmsg command to switch to PCFS.
2012/04/15 Major rework for new NAND boot mode.
2011/02/21 Initial version.