ST / Mbed 2 deprecated HelloWorld_IPS02A1

Simple demo example of X-NUCLEO-IPS02A1 24V Intelligent Power Switch Library usage.

Dependencies:   X_NUCLEO_IPS02A1 mbed

Fork of HelloWorld_IPS02A1 by ST Expansion SW Team

HelloWorld_IPS02A1, demo example for IPS02A1 expansion board

Introduction

This example application provides a basic code to show how to use the X-NUCLEO-IPS02A1 Intelligent Power Switch Expansion Board. The example performs current measurements on output Channel 1 (Ch1) and Channel 2 (Ch2), continuously, in the following conditions:

  • 1) Ch1 OFF, Ch2 OFF
  • 2) Ch1 ON, Ch2 OFF
  • 3) Ch1 OFF, Ch2 ON
  • 4) Ch1 ON, Ch2 ON

for each configuration the Current for each channel is displayed over an opened console (use Hyperterminal or whatever, set 9600 as bauds, 8-bit data, no parity)

Demo Code

The basic operation done by the demo code, which can be used in the customer application are :

1) In order to use get the singleton instance of the X_NUCLEO_IPS02A1 by calling class method `Instance()`:

// IPS expansion board singleton instance
static X_NUCLEO_IPS02A1 *ips_expansion_board = X_NUCLEO_IPS02A1::Instance();

2) Switch-on or Switch-off loads output (Channel 1 or Channel 2) by setting or clearing associated digital input :

            ips_expansion_board.vps2535h.In_1 = 1; // switch-on Channel 1
            ips_expansion_board.vps2535h.In_2 = 0; // switch-off Channel 2

3) Read Current circulating on Channel 1 or Channel 2 and print on the Terminal

            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_1);
            printf("Current Ch1 = %2.3fA \n\r", Multisense_Signal);
            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_2);
            printf("Current Ch2 = %2.3fA \n\r", Multisense_Signal);

Diff: main.cpp

Revision:
1:59b97633b43d
Child:
3:52b7f2fcaf74
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/main.cpp	Thu Apr 07 14:11:52 2016 +0000
@@ -0,0 +1,278 @@
+/**
+ ******************************************************************************
+ * @file    main.cpp
+ * @author  APG Mass Market
+ * @version V1.0.1
+ * @date    16-Nov-2015
+ * @brief   Example application for using the X_NUCLEO_IPS02A1 
+ *          Intelligent Power Switch Nucleo expansion board.
+ ******************************************************************************
+ * @attention
+ *
+ * <h2><center>&copy; COPYRIGHT(c) 2015 STMicroelectronics</center></h2>
+ *
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ *   1. Redistributions of source code must retain the above copyright notice,
+ *      this list of conditions and the following disclaimer.
+ *   2. Redistributions in binary form must reproduce the above copyright notice,
+ *      this list of conditions and the following disclaimer in the documentation
+ *      and/or other materials provided with the distribution.
+ *   3. Neither the name of STMicroelectronics nor the names of its contributors
+ *      may be used to endorse or promote products derived from this software
+ *      without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ *  SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ ******************************************************************************
+*/ 
+
+/**
+ * @mainpage X_NUCLEO_IPS02A1 Intelligent Power Switch Nucleo Expansion Board Firmware Package
+ *
+ * <b>Introduction</b>
+ *
+ * This firmware package includes Components Device Drivers, Board Support Package
+ * and example application for STMicroelectronics X_NUCLEO_IPS02A1 Intelligent Power Switch
+ * Nucleo Expansion Board
+ * 
+ * <b>Example Application</b>
+ *
+ */
+/*** Includes ----------------------------------------------------------------- ***/
+#include "mbed.h"
+#include "assert.h"
+#include "x_nucleo_ips02a1.h"
+
+/*** Static variables --------------------------------------------------------- ***/
+#ifdef DBG_MCU
+#include "DbgMCU.h"
+static DbgMCU enable_dbg;
+#endif // DBG_MCU
+
+/* HW settings */
+/* Pay attention before changing HW settings, they must be coherent with you HW design */
+/* Power Switch Connection to Arduino connectors */
+#define IPS02A1_PIN_IN_1             (D5)
+#define IPS02A1_PIN_IN_2             (D6)
+#define IPS02A1_PIN_FR_STBY          (D4)
+#define IPS02A1_PIN_CURRENTSENSE1    (A2)
+#define IPS02A1_PIN_CURRENTSENSE2    (A3)
+
+
+/* V-Ref */
+#define V_REF 3.3
+/* Rsense Value */
+#define R_SENSE 1e3
+/* R_D1 */
+#define R_D1 56e3
+/* R_D2 */
+#define R_D2 36e3
+
+/* End of HW settings */
+
+static X_NUCLEO_IPS02A1 &ips_expansion_board = X_NUCLEO_IPS02A1::Instance(IPS02A1_PIN_IN_1,
+                                                                          IPS02A1_PIN_IN_2,
+                                                                          IPS02A1_PIN_FR_STBY,
+                                                                          IPS02A1_PIN_CURRENTSENSE1,
+                                                                          IPS02A1_PIN_CURRENTSENSE2,                                                                         
+                                                                          V_REF,
+                                                                          R_SENSE,
+                                                                          R_D1,
+                                                                          R_D2);
+    
+                          
+static Ticker ticker;
+DigitalOut UserLed(LED1);    
+
+/*** Main function ------------------------------------------------------------- ***/
+/* Generic main function/loop, interrupt based cyclic execution
+*/
+
+float Multisense_Signal = 0;    // Multisense pin - signal level
+bool  ButtonPressed = 0;         // User Button
+int   TestSequence = 1;           // Test sequence counter
+
+//------------------------------------
+// Hyperterminal configuration
+// 9600 bauds, 8-bit data, no parity
+//------------------------------------
+
+InterruptIn UserButton(USER_BUTTON);  // B1 is the User Button
+void B1_pressed (void);
+void LedBlink (int TestSequence);
+void Write_Serial (void);
+void Reset_Pins (void);
+
+
+int main(void){
+    UserButton.fall(&B1_pressed);       //interrupt User Button
+   
+    printf("############################################################ \n\r");
+    printf("###################  TEST PROCEDURE ######################## \n\r");
+    printf("############################################################ \n\n\r");
+    printf("This demo performs current measurements on Ch1 and Ch2  \n\r");
+    printf("in the following conditions: \n\r\n\r");
+    printf(" 1) Ch1 OFF, Ch2 OFF \n\r");
+    printf(" 2) Ch1 ON,  Ch2 OFF \n\r");
+    printf(" 3) Ch1 OFF, Ch2 ON \n\r");
+    printf(" 4) Ch1 ON,  Ch2 ON \n\r\n\r");
+      
+    printf("Start test Procedure.... \n\r\n\r");
+    printf("PRESS USER BUTTON (Blue One) on NUCLEO to perform single test \n\r\n\r\n\r");
+    
+    
+    while (true) {
+        // wait for User button is pressed 
+        while (!ButtonPressed) {
+        }
+           
+        ButtonPressed = 0;
+        
+        LedBlink(TestSequence);
+     
+        switch (TestSequence) {
+          case (1):
+            printf("############################################################ \n\r");
+            printf("###################  TEST PROCEDURE ######################## \n\r");
+            printf("############################################################ \n\n\r");
+            printf("This demo performs current measurements on Ch1 and Ch2  \n\r");
+            printf("in the following conditions: \n\r\n\r");
+            printf(" 1) Ch1 OFF, Ch2 OFF \n\r");
+            printf(" 2) Ch1 ON,  Ch2 OFF \n\r");
+            printf(" 3) Ch1 OFF, Ch2 ON \n\r");
+            printf(" 4) Ch1 ON,  Ch2 ON \n\r\n\r");
+            printf("\n\r\n\r");
+            break;
+          case (2): {
+            printf("Test 1: StandBy\n\r");
+            Reset_Pins();
+            wait (0.1);
+            Write_Serial();
+            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_1);
+            printf("Current Ch1 = %2.3fA \n\r", Multisense_Signal);
+            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_2);
+            printf("Current Ch2 = %2.3fA \n\r", Multisense_Signal);
+            printf("\n\r\n\r");
+           }
+           break;
+
+          
+          case(3):{
+            printf("Test 2: Ch1=ON, CH2=OFF\n\r");
+            ips_expansion_board.vps235h2.In_1 = 1;
+            ips_expansion_board.vps235h2.In_2 = 0;
+            ips_expansion_board.vps235h2.Fr_Stby = 1;
+           
+            wait (0.1);
+            Write_Serial();
+            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_1);
+            printf("Current Ch1 = %2.3fA \n\r", Multisense_Signal);
+            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_2);
+            printf("Current Ch2 = %2.3fA \n\r", Multisense_Signal);
+            wait (0.5);
+            Reset_Pins();
+            printf("\n\r\n\r");
+           }
+           break;
+
+          case(4):{
+            printf("Test 3: Ch1=OFF, CH2=ON\n\r");
+            ips_expansion_board.vps235h2.In_1 = 0;
+            ips_expansion_board.vps235h2.In_2 = 1;
+            ips_expansion_board.vps235h2.Fr_Stby = 1;
+
+            wait (0.1);
+            Write_Serial();
+            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_1);
+            printf("Current Ch1 = %2.3fA \n\r", Multisense_Signal);
+            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_2);
+            printf("Current Ch2 = %2.3fA \n\r", Multisense_Signal);
+            wait (.5);
+            Reset_Pins();
+            printf("\n\r\n\r");
+           }
+           break;
+
+          case(5):{
+            printf("Test 4: Ch1=ON, CH2=ON  \n\r");
+            ips_expansion_board.vps235h2.In_1= 1;
+            ips_expansion_board.vps235h2.In_2 = 1;
+            ips_expansion_board.vps235h2.Fr_Stby = 1;
+            wait (0.1);
+            Write_Serial();
+            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_1);
+            printf("Current Ch1 = %2.3fA \n\r", Multisense_Signal);
+            Multisense_Signal= ips_expansion_board.GetCurrent(CHANNEL_2);
+            printf("Current Ch2 = %2.3fA \n\r", Multisense_Signal);
+            wait (.5);
+            Reset_Pins();
+            printf("\n\r\n\r");
+           }
+          break;
+
+          default: {
+            printf("End Test Cycle...press to user button to continue\n\n\n\r");  
+            TestSequence = 0;
+            Reset_Pins();
+           }
+          break;
+
+        } 
+        
+    }
+    
+ }
+
+
+void B1_pressed (){
+  // Interrupt procedure - User button is pressed
+    TestSequence ++;
+
+    UserLed = 1; // LED is ON
+    wait(0.05); // 50 ms
+    UserLed = 0; // LED is OFF
+
+    ButtonPressed = 1;
+
+}
+
+void LedBlink (int TestSequence){
+// Option feedback by usingUser LED
+    for (int TestCounter =0; TestCounter<TestSequence; TestCounter++) {
+        UserLed = 1; // LED is ON
+        wait(0.05); // 50 ms
+        UserLed = 0; // LED is OFF
+        wait(0.05); // 50 msec
+    }
+    wait(1-(TestSequence*2*0.05));
+}
+
+void Write_Serial (){
+// This code send messages and data to the serial port
+// send info to serial port
+
+    printf("Input 1= %d\t", ips_expansion_board.vps235h2.In_1.read());
+    printf("Input 2= %d\t", ips_expansion_board.vps235h2.In_2.read());
+    printf("Fr_Stby= %d\t\n\r", ips_expansion_board.vps235h2.Fr_Stby.read());
+    
+
+ }
+ 
+ void Reset_Pins(){
+// reset input pins to  
+   ips_expansion_board.vps235h2.In_1= 0;
+   ips_expansion_board.vps235h2.In_2 = 0;
+   ips_expansion_board.vps235h2.Fr_Stby = 0;
+}
+
+