debug.h 3.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  1. /****************************************************************************
  2. * arch/avr/include/debug.h
  3. *
  4. * Copyright (C) 2015 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. #ifndef __INCLUDE_ARCH_AVR_DEBUG_H
  36. #define __INCLUDE_ARCH_AVR_DEBUG_H
  37. /****************************************************************************
  38. * Included Files
  39. ****************************************************************************/
  40. #include <nuttx/config.h>
  41. #include <nuttx/compiler.h>
  42. #include <syslog.h>
  43. #ifdef CONFIG_AVR_HAS_MEMX_PTR
  44. /****************************************************************************
  45. * Pre-processor Definitions
  46. ****************************************************************************/
  47. /* Since format string that is passed to __arch_syslog() can be a
  48. * comma-separated list, we need some cpp trickery to handle it
  49. *
  50. * __dbg_first() helper macro accepts the format (that is potentially
  51. * a comma-separated) and substitutes to its first element.
  52. *
  53. * __dbg_subst() helper macro substitutes first element in the format
  54. * with prefix.
  55. */
  56. #define __dbg_first(format, ...) format
  57. #define __dbg_subst(prefix, format, ...) prefix, ##__VA_ARGS__
  58. #define __dbg_expand(logger, prio, format, ...) \
  59. do \
  60. { \
  61. static const IOBJ char dbg_s[] = __dbg_first(format); \
  62. logger(prio, __dbg_subst(dbg_s, format), ##__VA_ARGS__); \
  63. } \
  64. while(0)
  65. /* __arch_syslog() overrides the behavior of NuttX debug macros. They put
  66. * the format string into program memory and utilize IPTR (__memx) parameter
  67. * of syslog to take the format directly from program memory. This reduces
  68. * amount of RAM held by the format strings used in debug statements.
  69. */
  70. #define __arch_syslog(...) \
  71. __dbg_expand(syslog, ##__VA_ARGS__)
  72. #endif /* CONFIG_AVR_HAS_MEMX_PTR */
  73. #endif /* __INCLUDE_ARCH_DEBUG_H */