On 03/12/2015 08:32 PM, Eric Anholt wrote: > Stephen Warren was concerned that the rmb() present in the new mailbox > driver was unnecessary, and after seeing the docs, that it was just so > surprising that somebody would come along and remove it later. The > explanation for the need for the rmb() is long enough that we won't > want to place it at every callsite. Make a wrapper with the whole > explanation in it, so that anyone wondering what's going on sees the > docs right there. > diff --git a/include/soc/bcm2835/peripheral-workaround.h b/include/soc/bcm2835/peripheral-workaround.h > +static inline void bcm2835_peripheral_read_workaround(void) > +{ > +#ifdef CONFIG_ARCH_BCM2835 Would this header be included if that wasn't defined? Perhaps that'll be answered by a later patch... > + /* > + * The BCM2835 bus is unusual in that it doesn't guarantee > + * ordering between reads from different peripherals (where > + * peripherals roughly correspond to Linux devices). From > + * BCM2835 ARM Peripherals.pdf, page 7: Many buses don't guarantee ordering; that's quite common. The issue is that the CPU then doesn't match up the correct read request and response, thus causing it to swap the results of read requests. That's the unusual part. It would be useful to spell that out more explicitly in this introduction, even though it is called out in the example below. BTW, the ARM mailing list is linux-arm-kernel@xxxxxxxxxxxxxxxxxxx not linux-arm-kernel@xxxxxxxxxxxxxxx. -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html