portasm.h 3.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  1. /*
  2. * FreeRTOS Kernel V10.4.6
  3. * Copyright (C) 2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  4. *
  5. * SPDX-License-Identifier: MIT
  6. *
  7. * Permission is hereby granted, free of charge, to any person obtaining a copy of
  8. * this software and associated documentation files (the "Software"), to deal in
  9. * the Software without restriction, including without limitation the rights to
  10. * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
  11. * the Software, and to permit persons to whom the Software is furnished to do so,
  12. * subject to the following conditions:
  13. *
  14. * The above copyright notice and this permission notice shall be included in all
  15. * copies or substantial portions of the Software.
  16. *
  17. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  18. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
  19. * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
  20. * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
  21. * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  22. * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  23. *
  24. * https://www.FreeRTOS.org
  25. * https://github.com/FreeRTOS
  26. *
  27. */
  28. #ifndef PORT_ASM_H
  29. #define PORT_ASM_H
  30. typedef void TCB_t;
  31. extern volatile TCB_t * volatile pxCurrentTCB;
  32. extern void vTaskSwitchContext( void );
  33. /*
  34. * Saves the stack pointer for one task into its TCB, calls
  35. * vTaskSwitchContext() to update the TCB being used, then restores the stack
  36. * from the new TCB read to run the task.
  37. */
  38. void portSWITCH_CONTEXT( void );
  39. /*
  40. * Load the stack pointer from the TCB of the task which is going to be first
  41. * to execute. Then force an IRET so the registers and IP are popped off the
  42. * stack.
  43. */
  44. void portFIRST_CONTEXT( void );
  45. /* There are slightly different versions depending on whether you are building
  46. to include debugger information. If debugger information is used then there
  47. are a couple of extra bytes left of the ISR stack (presumably for use by the
  48. debugger). The true stack pointer is then stored in the bp register. We add
  49. 2 to the stack pointer to remove the extra bytes before we restore our context. */
  50. #define portSWITCH_CONTEXT() \
  51. asm { mov ax, seg pxCurrentTCB } \
  52. asm { mov ds, ax } \
  53. asm { les bx, pxCurrentTCB } /* Save the stack pointer into the TCB. */ \
  54. asm { mov es:0x2[ bx ], ss } \
  55. asm { mov es:[ bx ], sp } \
  56. asm { call far ptr vTaskSwitchContext } /* Perform the switch. */ \
  57. asm { mov ax, seg pxCurrentTCB } /* Restore the stack pointer from the TCB. */ \
  58. asm { mov ds, ax } \
  59. asm { les bx, dword ptr pxCurrentTCB } \
  60. asm { mov ss, es:[ bx + 2 ] } \
  61. asm { mov sp, es:[ bx ] }
  62. #define portFIRST_CONTEXT() \
  63. __asm { mov ax, seg pxCurrentTCB } \
  64. __asm { mov ds, ax } \
  65. __asm { les bx, dword ptr pxCurrentTCB } \
  66. __asm { mov ss, es:[ bx + 2 ] } \
  67. __asm { mov sp, es:[ bx ] } \
  68. __asm { pop bp } \
  69. __asm { pop di } \
  70. __asm { pop si } \
  71. __asm { pop ds } \
  72. __asm { pop es } \
  73. __asm { pop dx } \
  74. __asm { pop cx } \
  75. __asm { pop bx } \
  76. __asm { pop ax } \
  77. __asm { iret }
  78. #endif