Skip to main content
Knowledgebase
Home
Renesas Electronics Europe - Knowledgebase

r_gpt_input_capture Module Guide Resources

Last Updated:03/12/2018

Question:

Where can I find the references to module guide resources for the GPT input capture HAL module on r_gpt_input_capture?

Answer:

Information on the module guide itself and the associated resources and known issues are available here.

Introduction

The Input Capture HAL module is an API used for measuring input pulse-widths which is implemented on r_gpt_input_capture. The Input Capture HAL module configures the input capture parameters to use with the GPT peripheral on the Synergy MCU. A user-defined callback can be created to acquire the value each time a new measurement is complete. 

The Input Capture HAL module configures the GPT for an input capture function.

  • The Input Capture HAL allows the user to perform the following tasks:
    • Initialize the module
    • Enable input capture measurement
    • Disable input capture measurement
    • Get the status (running or not) of the measurement counter
    • Get the last captured timer/overflows counter value
    • Close the input capture operation
  • The Input Capture HAL module supports:
    • Pulse-width measurement only
    • Rising-edge or falling-edge measurement start
    • One-shot or periodic mode
    • Hardware-enable signals to enable captures (low enable/high enable)
    • Callback function with the following events:
      • Counter overflow
      • Input capture occur
    • Callback structure (input_capture_callback_args_t) that provides data on the interrupting event, including which interrupt occurs and the associated counter values.

Module Guide

The GPT Input Capture HAL module guide is targeted for SSP 1.2.0 and above and the SK-S7G2 Kit.

The most recent versions of the GPT Input Capture HAL module guide application note, application project and import guide are available here.

 

Module Guide Errata

Section 1- Features edit

The Input Capture HAL module supports:

Pulse-width measurement and pulse-period measurement only

 

Section 3- Input Capture HAL Module Operational Overview addition

If the interrupts are not enabled, the values read by the APIs would be the last captured timer/overflows counter value.

 

Section 3.1.1- Input Capture HAL Module Operational Notes addition of third sentence

The input capture interface provides support for one-shot measurement and periodic measurement. The GPT hardware does not natively support one-shot functionality. Code is automatically included in the interrupt service routine (ISR) to stop and clear the timer. For this reason, ISRs must be enabled for one-shot mode, even when the callback is unused.

 

Section 3.1.2- Input Capture HAL Module Limitations- edit to first bullet point

Currently, the Input Capture HAL module supports only pulse-width measurement and pulse-period measurement and pulse-period measurement.

 

Section 6- Using the Input Capture HAL Module- Updates to step 3 and 4.

3.         The capture and overflow interrupt can be disabled and the timer stopped using the disable API.

 

Module Guide Resources

The following application projects are available from the Renesas web site at the referenced url.

  • HMI Brushless DC (BLDC) Motor Controller - Application Project here.

Known issues

  • Refer to the SSP release notes for known issues, available here.

 

Suitable Products
GLCD HAL module on r_glcd (SSP 1.2.0)
  • Was this article helpful?