Tutorial  Updated

fwpatcher: fw.img patcher for WiiU WiiVC firmware image

fwpatcher: fw.img patcher for WiiU WiiVC firmware image

Since about two weeks, it is possible to inject custom ISO files and homebrew into the WiiU WiiVC games, as seen in this thread: https://gbatemp.net/threads/wii-on-wii-u-virtual-console-injecting-games.483007/

The main piece of software that is responsible for handling all the differences between WiiU mode and vWii is a file called "fw.img". That file has been released by Nintendo in three different versions: r569, r570 and r590.

Because there are now quite a few different patches for this file, including a Trucha patch for non-signed content, all hidden in some posts in the thread above, I have decided to create a small tool called "fwpatcher". I have read the whole thread and other related threads and embedded all the patching info into that tool. Most patches have also been ported to it doesn't matter which version of the fw.img you use (although I still recommend using r590. The ported patches are not tested yet, and not all patches are ported).

How does this work?

For an exact description on how to edit the WiiU VC game contents, please refer to the thread linked above. This thread is only about patching the fw.img file.

To patch that file, first download my tool: https://download.florian-bach.de/fwpatcher_0.01_current.zip

If you have followed the tutorial above until step 1, you should have a "fw.img" somewhere. Open a command line and execute "fwpatcher-win64.exe INTERACTIVE fw.img" (obviously replace program name if you use another OS).

The patcher will give you a list of patches and ask which ones you want to apply. If you don't understand a patch, press "h" for help and it will be explained. Otherwise, press "y" or "n" to select the patches you want to apply. The patched file will be stored as "fw-new.img".

The tool also supports the command CHECK ("fwpatcher-win64.exe CHECK fw.img"), that command analyzes an fw.img and tells you which patches have been applied.

Supported patches

- Trucha (all versions)
- ES_Identify (all versions)
- HW_AHBPROT (all versions)
- HW_MEMPROT (all versions)
- Wiimotes in Gamepad mode (all versions)
- Gamepad Cache flush (r590 only) to use Gamepad in homebrew
- Emulate Wiimote only instead of Classic Controller (all versions)
- Emulate sideways Wiimote (all versions)
- Swap L&R with ZL&ZR buttons (r590 only)
- Nintendont patches (r590 only)

Changelog

Code:
fwpatcher v0.01 r20-31a911a2 - 2017-09-16:
- Unknown patches will be recognized by the CHECK command and a warning
  message will be printed.

fwpatcher v0.01 r19-16520666 - 2017-09-16:
- Help and recommended value for each patch added.
- Patch combinations are now validated (some patches require another,
  some are incompatible)

fwpatcher v0.01 r17-ea6c6acd - 2017-09-15:
- New Nintendont patch (fix94) added
- Bugfix where certain patches weren't always recognized

fwpatcher v0.01 r16-3108dffd - 2017-09-15:
- Initial release
- Can patch an fw.img file
- Can check which patches have been applied
- "Gamepad Cache flush" and "L-R -> ZL-ZR" patch are not ported to all versions
  yet (r590) needed for those.
- Not all ported patches have been tested.
 
Last edited by leseratte,

leseratte

Wiimmfi Team
OP
Member
Joined
Jun 2, 2012
Messages
453
Trophies
1
XP
1,859
Country
Germany
The newest Build of Nintendont supports the gamepad, if you add the Nintendont patches to the fw.img. This has nothing to do with the Gamecube adapter.
 

Cyan

GBATemp's lurking knight
Former Staff
Joined
Oct 27, 2002
Messages
23,749
Trophies
4
Age
46
Location
Engine room, learning
XP
15,662
Country
France
for people who didn't read the last few days progress, I made a quick resume here :
https://gbatemp.net/threads/savegame-manager-gx.210111/page-88#post-7577590

This patcher is used to patch the "IOS255", this is the IOS used by WiiVC channels, and the patches are used to make a "cIOS255". that cIOS is not installed on vWii but build into the WiiU channel.
this is still in development, and probably more patches will be found and could be applied to the IOS255 (aka fw.img) to unlock more features, like maybe USB support one day.

Currently, the patches can :
Allows WiiU Gamepad button support in Wii homebrew ! (homebrew need to be recompiled with new library)
unlock hardware access (NAND, SD, etc.)
unlock RAM access (patch memory in real time, etc.)
Patch wiimote support to work ALONG the gamepad support
etc.


This does not mean you can launch gamecube directly from WiiU.
the current progress is : you can launch nintendont directly from WiiU, and nintendont will load games from SD once in vwii mode.
future progress will be :
1. you can launch Forwarder from WiiU, which will load homebrew on SD (easier to work and test new homebrew version without rebuilding and reinstalling the WiiU channel everytime) Fix94 is working on it.
2. you can launch gamecube from WiiU (hidden nintendont with autoboot, or gamecube ISO inside the WiiVC, not sure yet. fix94 is working on something...)
 
Last edited by Cyan,
  • Like
Reactions: gamecaptor and Azel

Cyan

GBATemp's lurking knight
Former Staff
Joined
Oct 27, 2002
Messages
23,749
Trophies
4
Age
46
Location
Engine room, learning
XP
15,662
Country
France
hmm, read my previous post, there's a link to the explanation and to a nintendont version you can install on WiiU ;)
Nintendont v5.453 (yeah, Nintendont just got to v5.x)

or, just read Nintendont thread, it was released there.
 
  • Like
Reactions: CatmanFan

kid sampson

Well-Known Member
Member
Joined
Jul 20, 2006
Messages
329
Trophies
1
XP
886
Country
United States
for people who didn't read the last few days progress, I made a quick resume here :
https://gbatemp.net/threads/savegame-manager-gx.210111/page-88#post-7577590

This patcher is used to patch the "IOS255", this is the IOS used by WiiVC channels, and the patches are used to make a "cIOS255". that cIOS is not installed on vWii but build into the WiiU channel.
this is still in development, and probably more patches will be found and could be applied to the IOS255 (aka fw.img) to unlock more features, like maybe USB support one day.

Currently, the patches can :
Allows WiiU Gamepad button support in Wii homebrew ! (homebrew need to be recompiled with new library)
unlock hardware access (NAND, SD, etc.)
unlock RAM access (patch memory in real time, etc.)
Patch wiimote support to work ALONG the gamepad support
etc.


This does not mean you can launch gamecube directly from WiiU.
the current progress is : you can launch nintendont directly from WiiU, and nintendont will load games from SD once in vwii mode.
future progress will be :
1. you can launch Forwarder from WiiU, which will load homebrew on SD (easier to work and test new homebrew version without rebuilding and reinstalling the WiiU channel everytime) Fix94 is working on it.
2. you can launch gamecube from WiiU (hidden nintendont with autoboot, or gamecube ISO inside the WiiVC, not sure yet. fix94 is working on something...)

Thanks for the summary. Is this also applicable to WiiWare games like Contra Rebirth?
 
  • Like
Reactions: CatmanFan

Cyan

GBATemp's lurking knight
Former Staff
Joined
Oct 27, 2002
Messages
23,749
Trophies
4
Age
46
Location
Engine room, learning
XP
15,662
Country
France
I don't think so, WiiVC is only launching Wii disc ISO.

Wii channels are not disc ISO, but extracted data installed on the console.
it would require you to convert the channel to disc (hmm, don't remember if possible).

a workaround is to currently install the game on your vWii, and make a vWii forwarder to that channel installed on WiiU.
like using hbl2hbc with a config.txt pointing to that channel's titleID, or mod it to install as individual WiiU channel loading that vWii channel.
another solution could be to inject a Wii channel loader or game launcher (not USBLoaders, they are currently not compatible) which still launch installed channels. but I don't know if it will work as IOS reload is blocked until a patch is found.
 
Last edited by Cyan,

Cyan

GBATemp's lurking knight
Former Staff
Joined
Oct 27, 2002
Messages
23,749
Trophies
4
Age
46
Location
Engine room, learning
XP
15,662
Country
France
ahh, there's such a tool ?
I knew I forgotten something!

if you can convert a channel wad to iso, please test it :)
it might failed on first try, it's not necessarily because it's not compatible but maybe just requires more patches or different fw.img, etc.

edit:
sorry, I don't think this is what I thought
it will not work.
wad2iso is only a channel launcher homebrew packed inside a disc ISO. not the channel itself.

to work, it would require path rewriting to replace NAND path to ISO path. not sure it's possible.
 
Last edited by Cyan,

KiiWii

Editorial Team
Editorial Team
Joined
Nov 17, 2008
Messages
16,704
Trophies
3
Website
defaultdnb.github.io
XP
27,258
Country
United Kingdom
ahh, there's such a tool ?
I knew I forgotten something!

if you can convert a channel wad to iso, please test it :)
it might failed on first try, it's not necessarily because it's not compatible but maybe just requires more patches or different fw.img, etc.

edit:
sorry, I don't think this is what I thought
it will not work.
wad2iso is only a channel launcher homebrew packed inside a disc ISO. not the channel itself.

Yeah its weird i had a flash back and thought i remembered a tool for this. Turns out not.

Sorry.

@Cyan seems we need the opposite of CRAP.... wiigsc...

Edit 2

What about wadunpacker, wadtools etc to extract wads. Then wiimms wbfstool?

Out of interest does anyone know how dolphin handles wads as isos? (It doesnt require you to install them before use) etc?

Edit 3:

Showmiiwads + makekeybin.exe = converts wad to .app/.tik/.cert/.tmd/.trailer files ... after that the question is: how can we (decrypt further: like wiiu's NUS *.app etc to loadiine style method &) repack to wbfs or iso...
 
Last edited by KiiWii,

LuisGerdez

Well-Known Member
Newcomer
Joined
May 27, 2016
Messages
65
Trophies
0
Age
23
XP
165
Country
Venezuela
What parameters do I have to activate and deactivate in order to play games like DBZ: BT3 and RE4 through the gamepad?
 

N7Kopper

Lest we forget... what Nazi stood for.
Member
Joined
Aug 24, 2014
Messages
977
Trophies
0
Age
30
XP
1,301
Country
United Kingdom
Can someone make the Homebrew Channel Gamepad friendly?
It's not possible now yet.
The Homebrew Channel is open source, so I don't see why it couldn't happen. You might need to deal with the traps that check for an unmodified IOS 58 if they're still in the open source version, though.
 

Site & Scene News

Popular threads in this forum

General chit-chat
Help Users
  • No one is chatting at the moment.
  • BigOnYa @ BigOnYa:
    Biomutant looks cool tho, may have to try that
  • Quincy @ Quincy:
    Usually when such a big title leaks the Temp will be the first to report about it (going off of historical reports here, Pokemon SV being the latest one I can recall seeing pop up here)
  • K3Nv2 @ K3Nv2:
    I still like how a freaking mp3 file hacks webos all that security defeated by text yet again
  • BigOnYa @ BigOnYa:
    They have simulators for everything nowdays, cray cray. How about a sim that shows you playing the Switch.
  • K3Nv2 @ K3Nv2:
    That's called yuzu
    +1
  • BigOnYa @ BigOnYa:
    I want a 120hz 4k tv but crazy how more expensive the 120hz over the 60hz are. Or even more crazy is the price of 8k's.
  • K3Nv2 @ K3Nv2:
    No real point since movies are 30fps
  • BigOnYa @ BigOnYa:
    Not a big movie buff, more of a gamer tbh. And Series X is 120hz 8k ready, but yea only 120hz 4k games out right now, but thinking of in the future.
  • K3Nv2 @ K3Nv2:
    Mostly why you never see TV manufacturers going post 60hz
  • BigOnYa @ BigOnYa:
    I only watch tv when i goto bed, it puts me to sleep, and I have a nas drive filled w my fav shows so i can watch them in order, commercial free. I usually watch Married w Children, or South Park
  • K3Nv2 @ K3Nv2:
    Stremio ruined my need for nas
  • BigOnYa @ BigOnYa:
    I stream from Nas to firestick, one on every tv, and use Kodi. I'm happy w it, plays everything. (I pirate/torrent shows/movies on pc, and put on nas)
  • K3Nv2 @ K3Nv2:
    Kodi repost are still pretty popular
  • BigOnYa @ BigOnYa:
    What the hell is Kodi reposts? what do you mean, or "Wut?" -xdqwerty
  • K3Nv2 @ K3Nv2:
    Google them basically web crawlers to movie sites
  • BigOnYa @ BigOnYa:
    oh you mean the 3rd party apps on Kodi, yea i know what you mean, yea there are still a few cool ones, in fact watched the new planet of the apes movie other night w wifey thru one, was good pic surprisingly, not a cam
  • BigOnYa @ BigOnYa:
    Damn, only $2.06 and free shipping. Gotta cost more for them to ship than $2.06
  • BigOnYa @ BigOnYa:
    I got my Dad a firestick for Xmas and showed him those 3rd party sites on Kodi, he loves it, all he watches anymore. He said he has got 3 letters from AT&T already about pirating, but he says f them, let them shut my internet off (He wants out of his AT&T contract anyways)
  • K3Nv2 @ K3Nv2:
    That's where stremio comes to play never got a letter about it
  • BigOnYa @ BigOnYa:
    I just use a VPN, even give him my login and password so can use it also, and he refuses, he's funny.
  • BigOnYa @ BigOnYa:
    I had to find and get him an old style flip phone even without text, cause thats what he wanted. No text, no internet, only phone calls. Old, old school.
    K3Nv2 @ K3Nv2: @BigOnYa...