arm_pid_init_f32.c 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475
  1. /* ----------------------------------------------------------------------
  2. * Project: CMSIS DSP Library
  3. * Title: arm_pid_init_f32.c
  4. * Description: Floating-point PID Control initialization function
  5. *
  6. * $Date: 27. January 2017
  7. * $Revision: V.1.5.1
  8. *
  9. * Target Processor: Cortex-M cores
  10. * -------------------------------------------------------------------- */
  11. /*
  12. * Copyright (C) 2010-2017 ARM Limited or its affiliates. All rights reserved.
  13. *
  14. * SPDX-License-Identifier: Apache-2.0
  15. *
  16. * Licensed under the Apache License, Version 2.0 (the License); you may
  17. * not use this file except in compliance with the License.
  18. * You may obtain a copy of the License at
  19. *
  20. * www.apache.org/licenses/LICENSE-2.0
  21. *
  22. * Unless required by applicable law or agreed to in writing, software
  23. * distributed under the License is distributed on an AS IS BASIS, WITHOUT
  24. * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  25. * See the License for the specific language governing permissions and
  26. * limitations under the License.
  27. */
  28. #include "arm_math.h"
  29. /**
  30. * @addtogroup PID
  31. * @{
  32. */
  33. /**
  34. * @brief Initialization function for the floating-point PID Control.
  35. * @param[in,out] *S points to an instance of the PID structure.
  36. * @param[in] resetStateFlag flag to reset the state. 0 = no change in state & 1 = reset the state.
  37. * @return none.
  38. * \par Description:
  39. * \par
  40. * The <code>resetStateFlag</code> specifies whether to set state to zero or not. \n
  41. * The function computes the structure fields: <code>A0</code>, <code>A1</code> <code>A2</code>
  42. * using the proportional gain( \c Kp), integral gain( \c Ki) and derivative gain( \c Kd)
  43. * also sets the state variables to all zeros.
  44. */
  45. void arm_pid_init_f32(
  46. arm_pid_instance_f32 * S,
  47. int32_t resetStateFlag)
  48. {
  49. /* Derived coefficient A0 */
  50. S->A0 = S->Kp + S->Ki + S->Kd;
  51. /* Derived coefficient A1 */
  52. S->A1 = (-S->Kp) - ((float32_t) 2.0 * S->Kd);
  53. /* Derived coefficient A2 */
  54. S->A2 = S->Kd;
  55. /* Check whether state needs reset or not */
  56. if (resetStateFlag)
  57. {
  58. /* Clear the state buffer. The size will be always 3 samples */
  59. memset(S->state, 0, 3U * sizeof(float32_t));
  60. }
  61. }
  62. /**
  63. * @} end of PID group
  64. */