From: Øyvind Harboe Date: Tue, 14 Dec 2010 08:29:26 +0000 (+0100) Subject: flash: clarify protect documentation X-Git-Tag: v0.5.0-rc1~278 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=39dbb516a4489c6a934669876774ebc711a0b781;p=openocd flash: clarify protect documentation some chips unprotect more than the range asked for. The protect fn, must unprotect/protect minimally the range given. Signed-off-by: Øyvind Harboe --- diff --git a/src/flash/nor/driver.h b/src/flash/nor/driver.h index 3757442f..cbf9c528 100644 --- a/src/flash/nor/driver.h +++ b/src/flash/nor/driver.h @@ -105,9 +105,12 @@ struct flash_driver /** * Bank/sector protection routine (target-specific). - * When called, the driver should disable 'flash write' bits (or - * enable 'erase protection' bits) for the given @a bank and @a - * sectors. + * + * When called, the driver should enable/disable protection + * for MINIMUM the range covered by first..last sectors + * inclusive. Some chips have alignment requirements will + * cause the actual range to be protected / unprotected to + * be larger than the first..last range. * * @param bank The bank to protect or unprotect. * @param set If non-zero, enable protection; if 0, disable it.