# 6502DecimalMode

### From VisualChips

(add some BCD tests, add linkage and minor rewording) |
(adjustments to account for Bruce's decimal test being exhaustive) |
||

Line 7: | Line 7: | ||

Many (software) emulators have decimal mode correct, and many have it incorrect or missing. The same is true for [http://forum.6502.org/viewtopic.php?t=1673 various re-implemented 6502 cores]. Because the CMOS 6502 and later parts set the flags differently from the NMOS 6502, correctness can only be judged relative to a specific part. | Many (software) emulators have decimal mode correct, and many have it incorrect or missing. The same is true for [http://forum.6502.org/viewtopic.php?t=1673 various re-implemented 6502 cores]. Because the CMOS 6502 and later parts set the flags differently from the NMOS 6502, correctness can only be judged relative to a specific part. | ||

- | + | Bruce Clark's tutorial contains a test program which can test all the flags (for the various CPU models) and will report the first failing case. Using this, we can collect some specific 'difficult' cases for use on a slow model, or for a rapid test of new code, or for illustration of the 6502 datapath in action. Some of the following tests are now found in the [https://github.com/mnaberez/py65/tree/master/src/py65/tests/devices py65 test suite] | |

- | + | We need a list of interesting signals to probe to observe the decimal mode adjustments. (The presently released JSSim doesn't have C34 named, but it will on next update) | |

The two operands, and the carry in, are added as a pair of nibbles. The carry-out from bit3 is adjusted in decimal mode, but only for ADC. So the ALU is not a binary byte-wide ALU with a decimal adjustment, it is a pair of binary nibble ALUs with a decimal adjustment. In the tests, we don't specifically need to test that carry-in is used (except to prove that carry-out is changing the carry bit, if we have that freedom) | The two operands, and the carry in, are added as a pair of nibbles. The carry-out from bit3 is adjusted in decimal mode, but only for ADC. So the ALU is not a binary byte-wide ALU with a decimal adjustment, it is a pair of binary nibble ALUs with a decimal adjustment. In the tests, we don't specifically need to test that carry-in is used (except to prove that carry-out is changing the carry bit, if we have that freedom) |

## Revision as of 22:38, 19 December 2010

The 6502 had a couple of unique selling points compared to its predecessor the 6800, and the decimal mode was crucial because it was patent protected. It saves an instruction and a couple of cycles from each byte of decimal arithmetic, and removes the half-carry from the status byte - it also works for both addition and subtraction.

Decimal mode only affects ADC and SBC instructions, and on the NMOS 6502 only usefully sets the C flag. The N, V and Z flags are set, but don't correspond to what you might expect from a 10's complement decimal operation.

Nonetheless, all four flags are set, so it's worth understanding how they are set, and why. (See Ijor's paper, and Bruce Clark's tutorial)

Many (software) emulators have decimal mode correct, and many have it incorrect or missing. The same is true for various re-implemented 6502 cores. Because the CMOS 6502 and later parts set the flags differently from the NMOS 6502, correctness can only be judged relative to a specific part.

Bruce Clark's tutorial contains a test program which can test all the flags (for the various CPU models) and will report the first failing case. Using this, we can collect some specific 'difficult' cases for use on a slow model, or for a rapid test of new code, or for illustration of the 6502 datapath in action. Some of the following tests are now found in the py65 test suite

We need a list of interesting signals to probe to observe the decimal mode adjustments. (The presently released JSSim doesn't have C34 named, but it will on next update)

The two operands, and the carry in, are added as a pair of nibbles. The carry-out from bit3 is adjusted in decimal mode, but only for ADC. So the ALU is not a binary byte-wide ALU with a decimal adjustment, it is a pair of binary nibble ALUs with a decimal adjustment. In the tests, we don't specifically need to test that carry-in is used (except to prove that carry-out is changing the carry bit, if we have that freedom)

Some of the tests below are found in Bruce Clark's V flag tutorial. Others are taken from failing cases when running his decimal mode test suite.

### Tests for ADC

- 00 + 00 and C=0 gives 00 and N=0 V=0 Z=1 C=0 (simulate)
- 79 + 00 and C=1 gives 80 and N=1 V=1 Z=0 C=0 (simulate)
- 24 + 56 and C=0 gives 80 and N=1 V=1 Z=0 C=0 (simulate)
- 93 + 82 and C=0 gives 75 and N=0 V=1 Z=0 C=1 (simulate)
- 89 + 76 and C=0 gives 55 and N=0 V=0 Z=0 C=1 (simulate)
- 89 + 76 and C=1 gives 56 and N=0 V=0 Z=1 C=1 (simulate)
- 80 + f0 and C=0 gives d0 and N=0 V=1 Z=0 C=1 (simulate)
- 80 + fa and C=0 gives e0 and N=1 V=0 Z=0 C=1 (simulate)
- 2f + 4f and C=0 gives 74 and N=0 V=0 Z=0 C=0 (simulate)
- 6f + 00 and C=1 gives 76 and N=0 V=0 Z=0 C=0 (simulate)

### Tests for SBC

- 00 - 00 and C=0 gives 99 and N=1 V=0 Z=0 C=0 (simulate)
- 00 - 00 and C=1 gives 00 and N=0 V=0 Z=1 C=1 (simulate)
- 00 - 01 and C=1 gives 99 and N=1 V=0 Z=0 C=0 (simulate)
- 0a - 00 and C=1 gives 0a and N=0 V=0 Z=0 C=1 (simulate)
- 0b - 00 and C=0 gives 0a and N=0 V=0 Z=0 C=1 (simulate)
- 9a - 00 and C=1 gives 9a and N=1 V=0 Z=0 C=1 (simulate)
- 9b - 00 and C=0 gives 9a and N=1 V=0 Z=0 C=1 (simulate)

One form of test program sets all the input flags using PLP:

lda #$c8 pha lda #$00 plp adc #$00 nop

and to calculate what that initial value of PLP should be, we can use a bit more code

php pla eor #$c3 // #$c2 if we don't want to invert the carry nop