mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-15 15:15:47 +00:00
9317726de4
The macro spin_event_timeout() takes a condition and timeout value (in microseconds) as parameters. It spins until either the condition is true or the timeout expires. It returns the result of the condition when the loop was terminated. This primary purpose of this macro is to poll on a hardware register until a status bit changes. The timeout ensures that the loop still terminates if the bit doesn't change as expected. This macro makes it easier for driver developers to perform this kind of operation properly. Signed-off-by: Timur Tabi <timur@freescale.com> Acked-by: Geoff Thorpe <Geoff.Thorpe@freescale.com> Signed-off-by: Benjamin Herrenschmidt <benh@kernel.crashing.org>
70 lines
2.8 KiB
C
70 lines
2.8 KiB
C
#ifndef _ASM_POWERPC_DELAY_H
|
|
#define _ASM_POWERPC_DELAY_H
|
|
#ifdef __KERNEL__
|
|
|
|
#include <asm/time.h>
|
|
|
|
/*
|
|
* Copyright 1996, Paul Mackerras.
|
|
* Copyright (C) 2009 Freescale Semiconductor, Inc. All rights reserved.
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version
|
|
* 2 of the License, or (at your option) any later version.
|
|
*
|
|
* PPC64 Support added by Dave Engebretsen, Todd Inglett, Mike Corrigan,
|
|
* Anton Blanchard.
|
|
*/
|
|
|
|
extern void __delay(unsigned long loops);
|
|
extern void udelay(unsigned long usecs);
|
|
|
|
/*
|
|
* On shared processor machines the generic implementation of mdelay can
|
|
* result in large errors. While each iteration of the loop inside mdelay
|
|
* is supposed to take 1ms, the hypervisor could sleep our partition for
|
|
* longer (eg 10ms). With the right timing these errors can add up.
|
|
*
|
|
* Since there is no 32bit overflow issue on 64bit kernels, just call
|
|
* udelay directly.
|
|
*/
|
|
#ifdef CONFIG_PPC64
|
|
#define mdelay(n) udelay((n) * 1000)
|
|
#endif
|
|
|
|
/**
|
|
* spin_event_timeout - spin until a condition gets true or a timeout elapses
|
|
* @condition: a C expression to evalate
|
|
* @timeout: timeout, in microseconds
|
|
* @delay: the number of microseconds to delay between each evaluation of
|
|
* @condition
|
|
*
|
|
* The process spins until the condition evaluates to true (non-zero) or the
|
|
* timeout elapses. The return value of this macro is the value of
|
|
* @condition when the loop terminates. This allows you to determine the cause
|
|
* of the loop terminates. If the return value is zero, then you know a
|
|
* timeout has occurred.
|
|
*
|
|
* This primary purpose of this macro is to poll on a hardware register
|
|
* until a status bit changes. The timeout ensures that the loop still
|
|
* terminates even if the bit never changes. The delay is for devices that
|
|
* need a delay in between successive reads.
|
|
*
|
|
* gcc will optimize out the if-statement if @delay is a constant.
|
|
*/
|
|
#define spin_event_timeout(condition, timeout, delay) \
|
|
({ \
|
|
typeof(condition) __ret; \
|
|
unsigned long __loops = tb_ticks_per_usec * timeout; \
|
|
unsigned long __start = get_tbl(); \
|
|
while (!(__ret = (condition)) && (tb_ticks_since(__start) <= __loops)) \
|
|
if (delay) \
|
|
udelay(delay); \
|
|
else \
|
|
cpu_relax(); \
|
|
__ret; \
|
|
})
|
|
|
|
#endif /* __KERNEL__ */
|
|
#endif /* _ASM_POWERPC_DELAY_H */
|