[Docs] Various corrections to VMX128 documentation

[0dinD]

The VMX128 documentation seems to contain some errors and missing instructions. I have made some corrections based on findings from the Xenia implementation, and a few other sources such as:

• https://github.com/hedge-dev/XenonRecomp/
• https://github.com/encounter/powerpc-rs/

More specifically:

• stvewx128

  • xenia/tools/ppc-instructions.xml

    Lines 1596 to 1601 in dfa1b3f

    	<insn mnem="stvewx128" opcode="10000183" form="VX128_1" group="m" desc="Store Vector Element Word Indexed 128">
    	<in field="VS" />
    	<in field="RA0" />
    	<in field="RB" />
    	<disasm>stvewx128 [VS], [RA0], [RB]</disasm>
    	</insn>

• vandc128

  • xenia/tools/ppc-instructions.xml

    Lines 1770 to 1775 in dfa1b3f

    	<insn mnem="vandc128" opcode="14000250" form="VX128" group="v" desc="Vector128 Logical AND with Complement">
    	<in field="VA" />
    	<in field="VB" />
    	<out field="VD" />
    	<disasm>vandc128 [VD], [VA], [VB]</disasm>
    	</insn>

• vrlw128

  • xenia/tools/ppc-instructions.xml

    Lines 2491 to 2496 in dfa1b3f

    	<insn mnem="vrlw128" opcode="18000050" form="VX128" group="v" desc="Vector128 Rotate Left Word">
    	<in field="VA" />
    	<in field="VB" />
    	<out field="VD" />
    	<disasm>vrlw128 [VD], [VA], [VB]</disasm>
    	</insn>

• vsro128

  • xenia/tools/ppc-instructions.xml

    Lines 2669 to 2674 in dfa1b3f

    	<insn mnem="vsro128" opcode="140003D0" form="VX128" group="v" desc="Vector128 Shift Right Octet">
    	<in field="VA" />
    	<in field="VB" />
    	<out field="VD" />
    	<disasm>vsro128 [VD], [VA], [VB]</disasm>
    	</insn>

• vupkhsh128

  • xenia/src/xenia/cpu/ppc/ppc_emit_altivec.cc

    Lines 2026 to 2029 in dfa1b3f

    	if (va == 0x60) {
    	// Hrm, my instruction tables suck.
    	return InstrEmit_vupkhsh_(f, VX128_VD128, VX128_VB128);
    	}

  • xenia/src/xenia/cpu/ppc/ppc_emit_altivec.cc

    Lines 1988 to 1992 in dfa1b3f

    	int InstrEmit_vupkhsh128(PPCHIRBuilder& f, const InstrData& i) {
    	uint32_t va = VX128_VA128;
    	assert_zero(va);
    	return InstrEmit_vupkhsh_(f, VX128_VD128, VX128_VB128);
    	}

  • https://github.com/hedge-dev/XenonRecomp/blob/ddd128bcca99fe8bfbb99bea583c972351fa6ace/XenonRecomp/recompiler.cpp#L523
  • https://github.com/encounter/powerpc-rs/blob/4643ee0fd3275e3a89dee709185c37968acca83b/isa.yaml#L5222-L5228
• vupklsh128

  • xenia/src/xenia/cpu/ppc/ppc_emit_altivec.cc

    Lines 2047 to 2050 in dfa1b3f

    	if (va == 0x60) {
    	// Hrm, my instruction tables suck.
    	return InstrEmit_vupklsh_(f, VX128_VD128, VX128_VB128);
    	}

  • xenia/src/xenia/cpu/ppc/ppc_emit_altivec.cc

    Lines 2006 to 2010 in dfa1b3f

    	int InstrEmit_vupklsh128(PPCHIRBuilder& f, const InstrData& i) {
    	uint32_t va = VX128_VA128;
    	assert_zero(va);
    	return InstrEmit_vupklsh_(f, VX128_VD128, VX128_VB128);
    	}

  • https://github.com/hedge-dev/XenonRecomp/blob/ddd128bcca99fe8bfbb99bea583c972351fa6ace/XenonRecomp/recompiler.cpp#L524
  • https://github.com/encounter/powerpc-rs/blob/4643ee0fd3275e3a89dee709185c37968acca83b/isa.yaml#L5238-L5244
• Others are just typos by Biallas that I fixed

I made this effort while working on NationalSecurityAgency/ghidra#2094, see NationalSecurityAgency/ghidra#2094 (comment) for more details.

I thought Xenia would be a good place for hosting the updated VMX128 documentation since it is useful for Xenia, and we have Git version control here.

Let me know if you have any questions.