Simple demo example of X-NUCLEO-IPS02A1 24V Intelligent Power Switch Library usage.
Dependencies: X_NUCLEO_IPS02A1 mbed
Fork of HelloWorld_IPS02A1 by
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);
main.cpp
- Committer:
- grussian
- Date:
- 2016-04-07
- Revision:
- 1:59b97633b43d
- Child:
- 3:52b7f2fcaf74
File content as of revision 1:59b97633b43d:
/** ****************************************************************************** * @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>© 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; }