hw/sd/sdcard: Document out-of-range addresses for SEND_WRITE_PROT
authorPhilippe Mathieu-Daudé <f4bug@amsat.org>
Wed, 28 Jul 2021 17:38:05 +0000 (19:38 +0200)
committerPhilippe Mathieu-Daudé <f4bug@amsat.org>
Tue, 3 Aug 2021 17:34:00 +0000 (19:34 +0200)
commit2a0396285daa9483459ec1d3791951300b595e85
tree8ecda38a66c395d02628940af834bdeb9bcaf286
parentacf8200722251a0a995cfa75fe5c15aea0886418
hw/sd/sdcard: Document out-of-range addresses for SEND_WRITE_PROT

Per the 'Physical Layer Simplified Specification Version 3.01',
Table 4-22: 'Block Oriented Write Protection Commands'

  SEND_WRITE_PROT (CMD30)

  If the card provides write protection features, this command asks
  the card to send the status of the write protection bits [1].

  [1] 32 write protection bits (representing 32 write protect groups
  starting at the specified address) [...]
  The last (least significant) bit of the protection bits corresponds
  to the first addressed group. If the addresses of the last groups
  are outside the valid range, then the corresponding write protection
  bits shall be set to 0.

Split the if() statement (without changing the behaviour of the code)
to better position the description comment.

Reviewed-by: Alexander Bulekov <alxndr@bu.edu>
Signed-off-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
Message-Id: <20210802235524.3417739-2-f4bug@amsat.org>
Reviewed-by: Peter Maydell <peter.maydell@linaro.org>
Tested-by: Alexander Bulekov <alxndr@bu.edu>
hw/sd/sd.c