irq_foreach.c 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118
  1. /****************************************************************************
  2. * sched/irq/irq_foreach.c
  3. *
  4. * Copyright (C) 2018 Gregory Nutt. All rights reserved.
  5. * Author: Gregory Nutt <gnutt@nuttx.org>
  6. *
  7. * Redistribution and use in source and binary forms, with or without
  8. * modification, are permitted provided that the following conditions
  9. * are met:
  10. *
  11. * 1. Redistributions of source code must retain the above copyright
  12. * notice, this list of conditions and the following disclaimer.
  13. * 2. Redistributions in binary form must reproduce the above copyright
  14. * notice, this list of conditions and the following disclaimer in
  15. * the documentation and/or other materials provided with the
  16. * distribution.
  17. * 3. Neither the name NuttX nor the names of its contributors may be
  18. * used to endorse or promote products derived from this software
  19. * without specific prior written permission.
  20. *
  21. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  22. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  23. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  24. * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  25. * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  26. * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  27. * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
  28. * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  29. * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30. * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  31. * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  32. * POSSIBILITY OF SUCH DAMAGE.
  33. *
  34. ****************************************************************************/
  35. /****************************************************************************
  36. * Included Files
  37. ****************************************************************************/
  38. #include <nuttx/config.h>
  39. #include <assert.h>
  40. #include <debug.h>
  41. #include <nuttx/irq.h>
  42. #include "irq/irq.h"
  43. #ifdef CONFIG_SCHED_IRQMONITOR
  44. /****************************************************************************
  45. * Pre-processor Definitions
  46. ****************************************************************************/
  47. /* This is the number of entries in the interrupt vector table */
  48. #ifdef CONFIG_ARCH_MINIMAL_VECTORTABLE
  49. # define TAB_SIZE CONFIG_ARCH_NUSER_INTERRUPTS
  50. #else
  51. # define TAB_SIZE NR_IRQS
  52. #endif
  53. /****************************************************************************
  54. * Public Functions
  55. ****************************************************************************/
  56. /****************************************************************************
  57. * Name: irq_foreach
  58. *
  59. * Description:
  60. * This function traverses the internal list of interrupts and provides
  61. * information about each attached interrupt.
  62. *
  63. * Some caution may be necessary: If interrupts are disabled then the
  64. * counts may change during the traversal. If pre-emption is enabled, then
  65. * the traversed sequence may be widely separated in time.
  66. *
  67. * Input Parameters:
  68. * callback - This function will be called for each attached interrupt
  69. * along with the IRQ number, an instance of struct irq_info_s,
  70. * and the caller provided argument
  71. * args - This is an opaque argument provided with each call to the
  72. * callback function.
  73. *
  74. * Returned Value:
  75. * Zero (OK) is returned after callback has been invoked for all of
  76. * the attached interrupts. The callback function may terminate the
  77. * traversal at any time by returning a non-zero value. In that case,
  78. * irq_foreach will return that non-zero value.
  79. *
  80. ****************************************************************************/
  81. int irq_foreach(irq_foreach_t callback, FAR void *arg)
  82. {
  83. int irq;
  84. int ret;
  85. DEBUGASSERT(callback != NULL);
  86. /* Visit each interrupt in the interrupt table */
  87. for (irq = 0; irq < TAB_SIZE; irq++)
  88. {
  89. if (g_irqvector[irq].handler != NULL &&
  90. g_irqvector[irq].handler != irq_unexpected_isr)
  91. {
  92. ret = callback(irq, &g_irqvector[irq], arg);
  93. if (ret != 0)
  94. {
  95. return ret;
  96. }
  97. }
  98. }
  99. return OK;
  100. }
  101. #endif /* CONFIG_SCHED_IRQMONITOR */