SAL does not document address storage order

[bremoran]

The SAL assumes that all addresses are stored in network order (big endian). This is not documented, which is a bug.

[ciarmcom]

ARM Internal Ref: IOTSFW-2140