S5L8720 (Hardware - SHA1)

S5L8720 SHA-1 Hardware

Base Address: 0x38000000

Programming Guide

As i have no real documentation of the hardware (The Samsung S3C6400X seams to use a very similar SHA-1 generator, but not the same), this is based on what iBoot does and what i found out by trying myself.

How it works

Basically it is like a hardware version of a SHA-1 algorithm. The hardware processes data in 512Bit (64 Bytes) chunks (Just like a software algorithm).
It does NO pre-processing (appending a '1' Bit to the data, pad the data so that the length mod 512 is 448, and append the bit-length of the data as a 64-bit big-endian integer).
This has to be done in software.

Calculating the SHA-1 of a message

1. Prepare the message as usual. See Wikipedia on SHA
2. Switch on the clock for the SHA-1 generator
3. Reset the generator. To do this set bit 0 of reset register and clear it afterwards (iBoot waits until the hash is ready before resetting it)
4. Clear (Write 0) to the Configuration Register (Not sure if this is needed as it already reads 0 after resetting, but iBoot does it)
5. Clear register 0x80 and 0x10 (Also not sure why, as they also read 0)
6. Write 64 bytes of the message to the data input registers starting at the lowest
7. If this were the the first 64 bytes clear bit 3 in the Configuration register, else set it
8. Set bit 1 (Start Hash) of the Configuration register and wait until bit 0 (Hash Busy) is cleared
9. If more data to hash go to point 6
10. Read the calculated hash of the Output SHA-1 Hash registers
11. Switch off the clock

Registers

Register Summary

Register	Description
0x00	Configuration
0x04	Reset
0x08	Unknown, but referenced in iBoot
0x0C	Unknown, but referenced in iBoot
0x10	Unknown, but referenced in iBoot (Set to 0 before calculating a hash)
0x20 - 0x30	Output SHA-1 hash / Input Initialization Vector
0x40 - 0x7C	Data Input (64 Bytes)
0x80	Unknown, but referenced in iBoot (Set to 0 before calculating a hash)
0x84	Unknown, but referenced in iBoot
0x8C	Unknown, but referenced in iBoot

Configuration Register

Bit	Function
Bit 0	Hash Busy. Is set when the hash calculation is started and cleared when the generator is done.
Bit 1	Start Hash. Set to 1 to start hashing of the data in the Input Data registers.
Bit 2	Unknown
Bit 3	Config IV. Use arbitary IV (=1), Use SHA-1 constants (=0) (Used for starting a new hash (=0), or continue a previous one (=1)).

All other bits are unknown or not used

Reset Register

Bit	Function
Bit 0	Reset Hash. Resets the generator and all registers.

All other bits are unknown or not used

Hash Out / IV In

Read: Outputs the hash in little-endian
Write: Set the initialization vectors

Data Input

Read: Read what was previously written there (like normal RAM)
Write: The current 64 byte data chunk to calculate the hash of. (little-endian)