You are here

Missing API documentation for CapSense_ADC Component | サイプレス セミコンダクタ

Missing API documentation for CapSense_ADC Component

We released a new component in PSoC Creator 3.3 SP2 called “CapSense_ADC”. Unfortunately, the API documentation is missing from the component datasheet.  To get the complete datasheet, please go here. This will be fixed in PSoC Creator 4.0.


The CapSense_ADC component supports the usual widgets such as buttons, matrix buttons, sliders, touchpads, and proximity sensors with the bonus of added analog-to-digital converter (ADC) functionality.  It has a new, easier-to-use interface as well.

One thing to note - The CapSense_P4 component is not an update of the CapSense_CSD_P4 component, which is still shipped with PSoC Creator so that existing projects will continue to work. It is completely new, with a more streamlined Customizer GUI and very different firmware API philosophy. If you are working on a project with the older component, we recommend backing up your design before replacing the component in your schematic.

The firmware changes are documented in the component datasheet in the Migration Guide section. Some notable changes are as follows.

  • The CapSense_Start() function automatically initializes the tuner interface and baselines so that, for example, there is no need to call the CapSense_InitializeAllBaselines() function.
  • Low power operation is improved with the use of a single function, CapSense_ProcessAllWidgets(), to read all results of a scan in one action.
  • Baselines are automatically updated in CapSense_ProcessAllWidgets() so there is no need to call the CapSense_UpdateEnabledBaselines() function.
  • The widget interrogation functions, such as CapSense_CheckIsWidgetActive(), are replaced by new functions, such as CapSense_IsWidgetActive(), that only look at the processed data.
  • The macros for each widget have new naming formats. For example, a single button widget would default to CapSense_BUTTON0_WDGT_ID instead of CapSense_BUTTON0__BTN with that annoying double underscore.
  • The tuner is enabled with just a single function, Capsense_RunTuner(), which no longer blocks the application.

Here is some example code to highlight the differences in the approach to a single button implementation.

CapSense_P4 (v3.0)  CapSense_CSD_P4 (v2.40)

CyGlobalIntEnable;

CapSense_Start();

CapSense_ScanAllWidgets();

for(;;)

{

 if( CapSense_NOT_BUSY == CapSense_IsBusy() )

 {

    CapSense_ProcessAllWidgets();

   if ( CapSense_IsWidgetActive(CapSense_BUTTON0_WDGT_ID) )

   {

     /* Do something */

   }

    CapSense_ScanAllWidgets();

 }

}

CyGlobalIntEnable;

CapSense_Start();

CapSense_InitializeAllBaselines();

CapSense_ScanEnabledWidgets();

for(;;)

{

 if( CapSense_NOT_BUSY == CapSense_IsBusy() )

 {

   if ( CapSense_CheckIsWidgetActive( CapSense_BUTTON0__BTN ) )

   {

     /* Do something */

   }

    CapSense_UpdateEnabledBaselines();

    CapSense_ScanEnabledWidgets();

 }

}

Blog: 

Comments

Carlos's picture

Hi,

Any proposed release date for Creator 4.0?

Thanks for the continuous improvement :D

このサイトに掲示されているすべてのコンテンツと資料は、「そのままの状態」で提供されます。サイプレス セミコンダクタとその関連サプライヤは、これらの資料について、いかなる目的への適合性をも表明することはありません。また、これらの資料について、すべての保証や条件を放棄します。これには、暗示的な保証および条件、商用性、特定の目的への適合性、すべてのサードパーティの知的財産権に対する権利と非侵害などが含まれますが、これらに制限されることはありません。サイプレス セミコンダクタにより、明示または暗示にかかわらず、禁反言などによるライセンスは、付与されないものとします。このサイトに掲示されている情報の使用には、サードパーティまたはサイプレス セミコンダクタからのライセンスが必要となる場合があります。

このサイトのコンテンツには、特定のガイドラインや使用制限が含まれている場合があります。このサイトにおけるすべての掲示やコンテンツの使用は、サイトの利用規約に準じて行われるものとします。このコンテンツを使用するサードパーティは、制限やガイドラインに従い、このサイトの利用規約を遵守するものとします。サイプレス セミコンダクタとそのサプライヤは、コンテンツや資料、その製品、プログラム、サービスに対し、いつでも修正、削除、変更、改善、向上、その他の変更を加える権利を有します。また、いかなるコンテンツ、製品、プログラム、サービスを予告なく変更または閉鎖する権利を有します。