2018-01-14 22:15:00 +01:00
/* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation , either version 3 of the License , or
* ( at your option ) any later version .
*
* This program is distributed in the hope that it will be useful ,
* but WITHOUT ANY WARRANTY ; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE . See the
* GNU General Public License for more details .
*
* You should have received a copy of the GNU General Public License
* along with this program . If not , see < http : //www.gnu.org/licenses/>.
*
*/
/** BusVoodoo high impedance (HiZ) default mode (code)
2018-01-23 23:41:41 +01:00
* @ file busvoodoo_hiz . c
2018-01-14 22:15:00 +01:00
* @ author King Kévin < kingkevin @ cuvoodoo . info >
* @ date 2018
*/
/* standard libraries */
# include <stdint.h> // standard integer types
# include <math.h> // math utilities
/* STM32 (including CM3) libraries */
# include <libopencm3/stm32/gpio.h> // general purpose input output library
# include <libopencm3/stm32/rcc.h> // real-time control clock library
# include <libopencm3/stm32/dbgmcu.h> // debug utilities
# include <libopencm3/stm32/desig.h> // design utilities
# include <libopencm3/stm32/dac.h> // DAC utilities
/* own libraries */
# include "global.h" // board definitions
# include "print.h" // printing utilities
2018-01-21 23:43:37 +01:00
# include "menu.h" // menu definitions
2018-01-14 22:15:00 +01:00
# include "busvoodoo_global.h" // BusVoodoo definitions
# include "busvoodoo_hiz.h" // own definitions
2018-01-17 13:17:08 +01:00
# define BUSVOODOO_XV_DEFAULT (0.8*(1+30.0 / 10.0)) /**< default (when not driven) xV voltage regulator output voltage based on R1 and R2 */
# define BUSVOODOO_XV_TEST 2.5 /**< target xV output voltage to test if we can set control the xV voltage regulator */
# define BUSVOODOO_12V_DEFAULT (1.25*(1+100.0 / 10.0)) /**< default (when not driven) 12V voltage regulator output voltage based on R1 and R2 */
# define BUSVOODOO_12V_TEST 12.0 /**< target 12V output voltage to test if we can set control the 12V voltage regulator */
2018-01-23 15:18:41 +01:00
/** setup HiZ mode
* @ param [ out ] prefix terminal prompt prefix
* @ param [ in ] line terminal prompt line to configure mode
* @ return if setup is complete
*/
static bool busvoodoo_hiz_setup ( char * * prefix , const char * line )
{
( void ) line ; // no configuration is required
2018-01-23 23:41:41 +01:00
* prefix = " HiZ " ; // set command line prefix
2018-01-23 15:18:41 +01:00
return true ;
}
/** exit HiZ mode
*/
static void busvoodoo_hiz_exit ( void )
{
// there is nothing to do
}
2018-01-21 23:43:37 +01:00
/** perform self tests
* @ return if self tests passed
*/
static bool busvoodoo_hiz_test_self ( void )
2018-01-14 22:15:00 +01:00
{
bool to_return = false ; // success of the self-test
busvoodoo_safe_state ( ) ; // start from a safe state
// get device information
// get device identifier (DEV_ID)
// 0x412: low-density, 16-32 kB flash
// 0x410: medium-density, 64-128 kB flash
// 0x414: high-density, 256-512 kB flash
// 0x430: XL-density, 768-1024 kB flash
// 0x418: connectivity
if ( 0 = = ( DBGMCU_IDCODE & DBGMCU_IDCODE_DEV_ID_MASK ) ) {
printf ( " device identifier not set: this is probably a defective micro-controller \n " ) ;
} else if ( 0x414 ! = ( DBGMCU_IDCODE & DBGMCU_IDCODE_DEV_ID_MASK ) ) {
printf ( " this (DEV_ID=%03x) is not a high-density device: a wrong micro-controller might have been used \n " , ( DBGMCU_IDCODE & DBGMCU_IDCODE_DEV_ID_MASK ) ) ;
}
// ensure flash size is ok
if ( 0xffff = = DESIG_FLASH_SIZE ) {
printf ( " unknown flash size: this is probably a defective micro-controller \n " ) ;
}
// check 5V power rail
2018-01-17 12:28:15 +01:00
float voltage = busvoodoo_vreg_get ( BUSVOODOO_5V_CHANNEL ) ; // get 5V power rail voltage
2018-01-14 22:15:00 +01:00
if ( voltage < 4.0 ) {
printf ( " 5V power rail voltage is too low: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > 5.5 ) {
printf ( " 5V power rail voltage is too high: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
// check 3.3V power rail
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_get ( BUSVOODOO_3V3_CHANNEL ) ; // get 3.3V power rail voltage
2018-01-14 22:15:00 +01:00
if ( voltage < 3.0 ) {
printf ( " 3.3V power rail voltage is too low: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > 3.6 ) {
printf ( " 3.3V power rail voltage is too high: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
// test 5V and 3.3V outputs
2018-01-17 13:17:08 +01:00
busvoodoo_vout_switch ( true ) ; // enable Vout
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_get ( BUSVOODOO_5V_CHANNEL ) ; // get 5V power rail voltage
2018-01-14 22:15:00 +01:00
if ( voltage < 4.0 ) {
printf ( " 5V power rail voltage is too low when 5V output is enabled: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > 5.5 ) {
printf ( " 5V power rail voltage is too high when 5V output is enabled: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_get ( BUSVOODOO_3V3_CHANNEL ) ; // get 3.3V power rail voltage
2018-01-14 22:15:00 +01:00
if ( voltage < 3.0 ) {
printf ( " 3.3V power rail voltage is too low when 3V3 output is enabled: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > 3.6 ) {
printf ( " 3.3V power rail voltage is too high when 3V3 is enabled: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
2018-01-17 13:17:08 +01:00
busvoodoo_vout_switch ( false ) ; // disable Vout
2018-01-14 22:15:00 +01:00
// check xV voltage regulator
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_set ( BUSVOODOO_XV_CHANNEL , 0 ) ; // disable xV voltage regulator
2018-01-14 22:15:00 +01:00
if ( voltage > 0.2 ) { // ensure the output is at 0V when the regulator is not enabled
printf ( " xV voltage is %.2fV instead of 0V when the regulator is disabled \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
gpio_set ( GPIO ( BUSVOODOO_XVEN_PORT ) , GPIO ( BUSVOODOO_XVEN_PIN ) ) ; // enable xV voltage regulator
sleep_ms ( 5 ) ; // let the voltage regulator start and voltage settle
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) ; // get xV voltage
2018-01-14 22:15:00 +01:00
// without being driven it should be around the default voltage
if ( voltage < BUSVOODOO_XV_DEFAULT - 0.2 ) {
printf ( " xV voltage is lower (%.2fV) than expected (%.2fV) when the regulator is enabled \n " , voltage , BUSVOODOO_XV_DEFAULT ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > BUSVOODOO_XV_DEFAULT + 0.2 ) {
printf ( " xV voltage is higher (%.2fV) than expected (%.2fV) when the regulator is enabled \n " , voltage , BUSVOODOO_XV_DEFAULT ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
// check if we can control xV
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_set ( BUSVOODOO_XV_CHANNEL , BUSVOODOO_XV_TEST ) ; // get xV voltage
2018-01-14 22:15:00 +01:00
if ( voltage < BUSVOODOO_XV_TEST - 0.2 ) {
printf ( " xV voltage is lower (%.2fV) than set (%.2fV) \n " , voltage , BUSVOODOO_XV_TEST ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > BUSVOODOO_XV_TEST + 0.2 ) {
printf ( " xV voltage is highed (%.2fV) than set (%.2fV) \n " , voltage , BUSVOODOO_XV_TEST ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
2018-01-17 12:28:15 +01:00
busvoodoo_vreg_set ( BUSVOODOO_XV_CHANNEL , 0 ) ; // disable xV voltage regulator
2018-01-14 22:15:00 +01:00
// check 12V voltage regulator
if ( busvoodoo_full ) {
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_set ( BUSVOODOO_12V_CHANNEL , 0 ) ; // disable 12V voltage regulator
2018-01-14 22:15:00 +01:00
if ( voltage > 0.2 ) { // ensure the output is at 0V when the regulator is not enabled
printf ( " 12V voltage is %.2fV instead of 0V when the regulator is disabled \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
gpio_clear ( GPIO ( BUSVOODOO_12VEN_PORT ) , GPIO ( BUSVOODOO_12VEN_PIN ) ) ; // enable 12V voltage regulator
sleep_ms ( 10 ) ; // let the voltage regulator start and voltage settle
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_get ( BUSVOODOO_12V_CHANNEL ) ; // get 12V voltage
2018-01-14 22:15:00 +01:00
// without being driven it should be around the default voltage
if ( voltage < BUSVOODOO_12V_DEFAULT - 0.3 ) {
printf ( " 12V voltage is lower (%.2fV) than expected (%.2fV) when regulator is enabled \n " , voltage , BUSVOODOO_12V_DEFAULT ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > BUSVOODOO_12V_DEFAULT + 0.3 ) {
printf ( " 12V voltage is higher (%.2fV) than expected (%.2fV) when regulator is enabled \n " , voltage , BUSVOODOO_12V_DEFAULT ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
// check if we can control 12V voltage regulator
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_set ( BUSVOODOO_12V_CHANNEL , BUSVOODOO_12V_TEST ) ; // set voltage on 12V voltage regulator
2018-01-14 22:15:00 +01:00
if ( voltage < BUSVOODOO_12V_TEST - 0.3 ) {
printf ( " 12V voltage is lower (%.2fV) than set (%.2fV) \n " , voltage , BUSVOODOO_12V_TEST ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > BUSVOODOO_12V_TEST + 0.3 ) {
printf ( " 12V voltage is higher (%.2fV) than set (%.2fV) \n " , voltage , BUSVOODOO_12V_TEST ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
2018-01-17 12:28:15 +01:00
voltage = busvoodoo_vreg_set ( BUSVOODOO_12V_CHANNEL , 0 ) ; // disable 12V voltage regulator
2018-01-14 22:15:00 +01:00
}
// pull all pins down and ensure they are low
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) ; pin + + ) {
gpio_set_mode ( busvoodoo_io_ports [ pin ] , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , busvoodoo_io_pins [ pin ] ) ; // set pin to input
gpio_clear ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ; // pull down so it's not floating
}
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) & & pin < LENGTH ( busvoodoo_io_names ) ; pin + + ) {
if ( gpio_get ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ) { // ensure it really is low
printf ( " signal %s is high although it is pulled low (internal) \n " , busvoodoo_io_names [ pin ] ) ; // warn user about the error
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
}
// pull all pins up and ensure they are high
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) ; pin + + ) {
gpio_set_mode ( busvoodoo_io_ports [ pin ] , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , busvoodoo_io_pins [ pin ] ) ; // set pin to input
gpio_set ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ; // pull up using internal pull-up
}
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) & & pin < LENGTH ( busvoodoo_io_names ) ; pin + + ) {
if ( ! gpio_get ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ) { // ensure it really is high
printf ( " signal %s is low although it is pulled up (internal) \n " , busvoodoo_io_names [ pin ] ) ; // warn user about the error
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
}
// set individual pin high and ensure only pins in the same group are at the same level
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) ; pin + + ) {
gpio_set_mode ( busvoodoo_io_ports [ pin ] , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , busvoodoo_io_pins [ pin ] ) ; // set pin to input
gpio_clear ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ; // pull down to ensure it is not high by accident
}
for ( uint8_t pin1 = 0 ; pin1 < LENGTH ( busvoodoo_io_ports ) & & pin1 < LENGTH ( busvoodoo_io_pins ) & & pin1 < LENGTH ( busvoodoo_io_groups ) & & pin1 < LENGTH ( busvoodoo_io_names ) ; pin1 + + ) {
gpio_set_mode ( busvoodoo_io_ports [ pin1 ] , GPIO_MODE_OUTPUT_2_MHZ , GPIO_CNF_OUTPUT_PUSHPULL , busvoodoo_io_pins [ pin1 ] ) ; // set button pin to output
gpio_set ( busvoodoo_io_ports [ pin1 ] , busvoodoo_io_pins [ pin1 ] ) ; // set pin high
for ( uint8_t pin2 = 0 ; pin2 < LENGTH ( busvoodoo_io_ports ) & & pin2 < LENGTH ( busvoodoo_io_pins ) & & pin2 < LENGTH ( busvoodoo_io_groups ) & & pin2 < LENGTH ( busvoodoo_io_names ) ; pin2 + + ) {
if ( busvoodoo_io_groups [ pin1 ] = = busvoodoo_io_groups [ pin2 ] & & ! gpio_get ( busvoodoo_io_ports [ pin2 ] , busvoodoo_io_pins [ pin2 ] ) ) {
printf ( " signal %s of I/O-%u is low while it should be set high by signal %s of I/O-%u \n " , busvoodoo_io_names [ pin2 ] , busvoodoo_io_groups [ pin2 ] , busvoodoo_io_names [ pin1 ] , busvoodoo_io_groups [ pin1 ] ) ; // warn user about the error
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( busvoodoo_io_groups [ pin1 ] ! = busvoodoo_io_groups [ pin2 ] & & gpio_get ( busvoodoo_io_ports [ pin2 ] , busvoodoo_io_pins [ pin2 ] ) ) {
printf ( " signal %s of I/O-%u is high while it should not be set high by signal %s of I/O-%u \n " , busvoodoo_io_names [ pin2 ] , busvoodoo_io_groups [ pin2 ] , busvoodoo_io_names [ pin1 ] , busvoodoo_io_groups [ pin1 ] ) ; // warn user about the error
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
}
gpio_set_mode ( busvoodoo_io_ports [ pin1 ] , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , busvoodoo_io_pins [ pin1 ] ) ; // set pin back to input
gpio_clear ( busvoodoo_io_ports [ pin1 ] , busvoodoo_io_pins [ pin1 ] ) ; // pull pin back down
}
// set individual pin low and ensure only pins in the same group are at the same level
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) ; pin + + ) {
gpio_set_mode ( busvoodoo_io_ports [ pin ] , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , busvoodoo_io_pins [ pin ] ) ; // set pin to input
gpio_set ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ; // pull up to ensure it is not low by accident
}
for ( uint8_t pin1 = 0 ; pin1 < LENGTH ( busvoodoo_io_ports ) & & pin1 < LENGTH ( busvoodoo_io_pins ) & & pin1 < LENGTH ( busvoodoo_io_groups ) & & pin1 < LENGTH ( busvoodoo_io_names ) ; pin1 + + ) {
gpio_set_mode ( busvoodoo_io_ports [ pin1 ] , GPIO_MODE_OUTPUT_2_MHZ , GPIO_CNF_OUTPUT_PUSHPULL , busvoodoo_io_pins [ pin1 ] ) ; // set button pin to output
gpio_clear ( busvoodoo_io_ports [ pin1 ] , busvoodoo_io_pins [ pin1 ] ) ; // set pin low
for ( uint8_t pin2 = 0 ; pin2 < LENGTH ( busvoodoo_io_ports ) & & pin2 < LENGTH ( busvoodoo_io_pins ) & & pin2 < LENGTH ( busvoodoo_io_groups ) & & pin2 < LENGTH ( busvoodoo_io_names ) ; pin2 + + ) {
if ( busvoodoo_io_groups [ pin1 ] = = busvoodoo_io_groups [ pin2 ] & & gpio_get ( busvoodoo_io_ports [ pin2 ] , busvoodoo_io_pins [ pin2 ] ) ) {
printf ( " signal %s of I/O-%u is high while it should be set low by signal %s of I/O-%u \n " , busvoodoo_io_names [ pin2 ] , busvoodoo_io_groups [ pin2 ] , busvoodoo_io_names [ pin1 ] , busvoodoo_io_groups [ pin1 ] ) ; // warn user about the error
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( busvoodoo_io_groups [ pin1 ] ! = busvoodoo_io_groups [ pin2 ] & & ! gpio_get ( busvoodoo_io_ports [ pin2 ] , busvoodoo_io_pins [ pin2 ] ) ) {
printf ( " signal %s of I/O-%u is low while it should not be set low by signal %s of I/O-%u \n " , busvoodoo_io_names [ pin2 ] , busvoodoo_io_groups [ pin2 ] , busvoodoo_io_names [ pin1 ] , busvoodoo_io_groups [ pin1 ] ) ; // warn user about the error
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
}
gpio_set_mode ( busvoodoo_io_ports [ pin1 ] , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , busvoodoo_io_pins [ pin1 ] ) ; // set pin back to input
gpio_set ( busvoodoo_io_ports [ pin1 ] , busvoodoo_io_pins [ pin1 ] ) ; // pull pin back up
}
// test 5V pull-up
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) ; pin + + ) {
gpio_set_mode ( busvoodoo_io_ports [ pin ] , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , busvoodoo_io_pins [ pin ] ) ; // set pin to input
gpio_clear ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ; // pull down to ensure it is not high by accident
}
2018-01-17 18:25:59 +01:00
busvoodoo_vreg_set ( BUSVOODOO_XV_CHANNEL , 5.0 ) ; // set xV voltage regulator to use the 5.0V power rail
voltage = busvoodoo_embedded_pullup ( true ) ; // enable 5V pull-up
2018-01-14 22:15:00 +01:00
if ( voltage < 4.0 ) {
printf ( " 5V power rail voltage is too low when used to pull up: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > 5.5 ) {
printf ( " 5V power rail voltage is too high when used to pull up: %.2fV \n " , voltage ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) & & pin < LENGTH ( busvoodoo_io_names ) ; pin + + ) {
if ( ! gpio_get ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ) { // ensure it really is high
printf ( " signal %s is low although it is pulled up by 5V (embedded) \n " , busvoodoo_io_names [ pin ] ) ; // warn user about the error
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
}
2018-01-17 18:25:59 +01:00
busvoodoo_embedded_pullup ( false ) ; // disable pull-ups
voltage = busvoodoo_vreg_set ( BUSVOODOO_XV_CHANNEL , 0 ) ; // disable xV voltage regulator
2018-01-14 22:15:00 +01:00
// test xV pull-up set to 3.3V
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) ; pin + + ) {
gpio_set_mode ( busvoodoo_io_ports [ pin ] , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , busvoodoo_io_pins [ pin ] ) ; // set pin to input
gpio_clear ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ; // pull down to ensure it is not high by accident
}
2018-01-17 18:25:59 +01:00
busvoodoo_vreg_set ( BUSVOODOO_XV_CHANNEL , 3.3 ) ; // set xV voltage regulator
voltage = busvoodoo_embedded_pullup ( 3.3 ) ; // enable pull-up with adjustable regulator
2018-01-14 22:15:00 +01:00
if ( voltage < BUSVOODOO_XV_DEFAULT - 0.2 ) {
printf ( " xV voltage is lower (%.2fV) than expected (%.2fV) when used to pull up \n " , voltage , BUSVOODOO_XV_DEFAULT ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
} else if ( voltage > BUSVOODOO_XV_DEFAULT + 0.2 ) {
printf ( " xV voltage is higher (%.2fV) than expected (%.2fV) when used to pull up \n " , voltage , BUSVOODOO_XV_DEFAULT ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) & & pin < LENGTH ( busvoodoo_io_names ) ; pin + + ) {
if ( ! gpio_get ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ) { // ensure it really is high
printf ( " signal %s is low although it is pulled up by xV (embedded) \n " , busvoodoo_io_names [ pin ] ) ; // warn user about the error
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
}
2018-01-17 18:25:59 +01:00
busvoodoo_vreg_set ( BUSVOODOO_XV_CHANNEL , 0 ) ; // disable xV voltage regulator
busvoodoo_embedded_pullup ( false ) ; // disable pull-ups
2018-01-14 22:15:00 +01:00
to_return = true ; // all tests are successful
2018-01-17 12:28:15 +01:00
# if DEBUG
# else
2018-01-14 22:15:00 +01:00
error :
2018-01-17 12:28:15 +01:00
# endif
2018-01-14 22:15:00 +01:00
busvoodoo_safe_state ( ) ; // set back to safe state
if ( ! to_return ) {
printf ( " the test procedure has been aborted for safety reasons \n " ) ;
}
return to_return ;
}
2018-01-21 23:43:37 +01:00
/** test if signals are soldered correctly to the connector pins
* @ return if pin test passed
*/
static bool busvoodoo_hiz_test_pins ( void )
2018-01-14 22:15:00 +01:00
{
bool to_return = false ; // test result to return
busvoodoo_safe_state ( ) ; // start from safe state with all outputs switched off
const char * xv_to = " connect I/O pin 4 to " ; // most outputs will be tested using xV ADC
const char * xv_high = " pin 4 is high while it should be low, other pin might be defective \n " ; // error message if expect low output is high
// test GND on pin 1 by shorting xV_CTL to ground (through 40k resistor) and measure short
gpio_set ( GPIO ( BUSVOODOO_XVCTL_PORT ) , GPIO ( BUSVOODOO_XVCTL_PIN ) ) ; // set pin high
gpio_set_mode ( GPIO ( BUSVOODOO_XVCTL_PORT ) , GPIO_MODE_OUTPUT_2_MHZ , GPIO_CNF_OUTPUT_PUSHPULL , GPIO ( BUSVOODOO_XVCTL_PIN ) ) ; // set xV control pin as output
printf ( " %sI/O pin 1 \n " , xv_to ) ;
2018-01-17 12:28:15 +01:00
while ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) > 0.2 ) { // wait until pin is shorted to ground
2018-01-14 22:15:00 +01:00
sleep_ms ( 200 ) ; // wait for user to make connection
}
gpio_clear ( GPIO ( BUSVOODOO_XVCTL_PORT ) , GPIO ( BUSVOODOO_XVCTL_PIN ) ) ; // set pin low
gpio_set_mode ( GPIO ( BUSVOODOO_XVCTL_PORT ) , GPIO_MODE_OUTPUT_2_MHZ , GPIO_CNF_OUTPUT_PUSHPULL , GPIO ( BUSVOODOO_XVCTL_PIN ) ) ; // set xV control pin as output
led_toggle ( ) ; // notify user test is almost almost
sleep_ms ( 200 ) ; // wait for voltage to settle an debounce
2018-01-17 12:28:15 +01:00
if ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) > 0.2 ) {
2018-01-14 22:15:00 +01:00
printf ( xv_high ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
gpio_set_mode ( GPIO ( BUSVOODOO_XVCTL_PORT ) , GPIO_MODE_INPUT , GPIO_CNF_INPUT_ANALOG , GPIO ( BUSVOODOO_XVCTL_PIN ) ) ; // set xV control pin back to analog input for DAC
led_toggle ( ) ; // notify user test is complete
// test 5V output on pin 2
gpio_clear ( GPIO ( BUSVOODOO_VOUTEN_PORT ) , GPIO ( BUSVOODOO_VOUTEN_PIN ) ) ; // enable Vout
printf ( " %sI/O pin 2 \n " , xv_to ) ;
2018-01-17 12:28:15 +01:00
while ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) < 0.2 ) { // wait until pin is connected
2018-01-14 22:15:00 +01:00
sleep_ms ( 200 ) ; // wait for user to make connection
}
gpio_set ( GPIO ( BUSVOODOO_VOUTEN_PORT ) , GPIO ( BUSVOODOO_VOUTEN_PIN ) ) ; // disable Vout
led_toggle ( ) ; // notify user test is almost complete
sleep_ms ( 200 ) ; // wait for voltage to settle and debounce
2018-01-17 12:28:15 +01:00
if ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) > 0.2 ) {
2018-01-14 22:15:00 +01:00
printf ( xv_high ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
led_toggle ( ) ; // notify user test is complete
// test 3.3V output on pin 3
gpio_clear ( GPIO ( BUSVOODOO_VOUTEN_PORT ) , GPIO ( BUSVOODOO_VOUTEN_PIN ) ) ; // enable Vout
printf ( " %sI/O pin 3 \n " , xv_to ) ;
2018-01-17 12:28:15 +01:00
while ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) < 0.2 | | busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) > 3.5 ) { // wait until pin is connected
2018-01-14 22:15:00 +01:00
sleep_ms ( 200 ) ; // wait for user to make connection
}
gpio_set ( GPIO ( BUSVOODOO_VOUTEN_PORT ) , GPIO ( BUSVOODOO_VOUTEN_PIN ) ) ; // disable Vout
led_toggle ( ) ; // notify user test is almost complete
sleep_ms ( 200 ) ; // wait for voltage to settle and debounce
2018-01-17 12:28:15 +01:00
if ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) > 0.2 ) {
2018-01-14 22:15:00 +01:00
printf ( xv_high ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
led_toggle ( ) ; // notify user test is complete
// test I/O pins
for ( uint8_t io = 1 ; io < = 6 ; io + + ) { // test each I/O pin
for ( uint8_t pin = 0 ; pin < LENGTH ( busvoodoo_io_ports ) & & pin < LENGTH ( busvoodoo_io_pins ) & & pin < LENGTH ( busvoodoo_io_groups ) ; pin + + ) { // look for a pin mapped on this I/O
if ( busvoodoo_io_groups [ pin ] = = io ) {
gpio_set ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ; // set pin high
gpio_set_mode ( busvoodoo_io_ports [ pin ] , GPIO_MODE_OUTPUT_2_MHZ , GPIO_CNF_OUTPUT_PUSHPULL , busvoodoo_io_pins [ pin ] ) ; // set pin to output
printf ( " %sI/O pin %u \n " , xv_to , io + 4 ) ;
2018-01-17 12:28:15 +01:00
while ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) < 0.2 ) { // wait until pin is connected
2018-01-14 22:15:00 +01:00
sleep_ms ( 200 ) ; // wait for user to make connection
}
gpio_clear ( busvoodoo_io_ports [ pin ] , busvoodoo_io_pins [ pin ] ) ; // set pin low
led_toggle ( ) ; // notify user test is almost complete
sleep_ms ( 200 ) ; // wait for voltage to settle and debounce
2018-01-17 12:28:15 +01:00
if ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) > 0.2 ) {
2018-01-14 22:15:00 +01:00
printf ( xv_high ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
gpio_set_mode ( busvoodoo_io_ports [ pin ] , GPIO_MODE_INPUT , GPIO_CNF_INPUT_FLOAT , busvoodoo_io_pins [ pin ] ) ; // set pin back to input
led_toggle ( ) ; // notify user test is complete
break ; // stop looking for pin
}
}
}
if ( busvoodoo_full ) {
// test 12V output on RS/CAN pin 1
2018-01-17 12:28:15 +01:00
double voltage = busvoodoo_vreg_get ( BUSVOODOO_3V3_CHANNEL ) ; // get reference voltage
2018-01-14 22:15:00 +01:00
uint16_t dac_set = BUSVOODOO_12V_SET ( 5.0 ) / voltage * 4095 ; // DAC value corresponding to the voltage
dac_load_data_buffer_single ( dac_set , RIGHT12 , BUSVOODOO_12VCTL_CHANNEL ) ; // set output so the voltage regulator is set to desired output voltage
dac_software_trigger ( BUSVOODOO_12VCTL_CHANNEL ) ; // transfer the value to the DAC
dac_enable ( BUSVOODOO_12VCTL_CHANNEL ) ; // enable DAC
gpio_clear ( GPIO ( BUSVOODOO_12VEN_PORT ) , GPIO ( BUSVOODOO_12VEN_PIN ) ) ; // enable 12V voltage regulator
printf ( " %sRS/CAN pin 1 \n " , xv_to ) ;
2018-01-17 12:28:15 +01:00
while ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) < 0.2 ) { // wait until pin is connected
2018-01-14 22:15:00 +01:00
sleep_ms ( 200 ) ; // wait for user to make connection
}
gpio_set ( GPIO ( BUSVOODOO_12VEN_PORT ) , GPIO ( BUSVOODOO_12VEN_PIN ) ) ; // disable 12V voltage regulator
dac_disable ( BUSVOODOO_12VCTL_CHANNEL ) ; // disable 12V control
led_toggle ( ) ; // notify user test is almost complete
sleep_ms ( 200 ) ; // wait for voltage to settle (and debounce)
2018-01-17 12:28:15 +01:00
if ( busvoodoo_vreg_get ( BUSVOODOO_XV_CHANNEL ) > 0.2 ) {
2018-01-14 22:15:00 +01:00
printf ( xv_high ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
led_toggle ( ) ; // notify user test is complete
// test RS-232 port (with itself)
rcc_periph_clock_enable ( RCC_GPIO ( BUSVOODOO_RS232_EN_PORT ) ) ; // enable clock for GPIO domain
gpio_clear ( GPIO ( BUSVOODOO_RS232_EN_PORT ) , GPIO ( BUSVOODOO_RS232_EN_PIN ) ) ; // set low to enable receiver
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_EN_PORT ) , GPIO_MODE_OUTPUT_2_MHZ , GPIO_CNF_OUTPUT_OPENDRAIN , GPIO ( BUSVOODOO_RS232_EN_PIN ) ) ; // set pin as output (open-drain pulled high to disable receiver)
rcc_periph_clock_enable ( RCC_GPIO ( BUSVOODOO_RS232_SHDN_PORT ) ) ; // enable clock for GPIO domain
gpio_set ( GPIO ( BUSVOODOO_RS232_SHDN_PORT ) , GPIO ( BUSVOODOO_RS232_SHDN_PIN ) ) ; // set high to enable transmitter
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_SHDN_PORT ) , GPIO_MODE_OUTPUT_2_MHZ , GPIO_CNF_OUTPUT_PUSHPULL , GPIO ( BUSVOODOO_RS232_SHDN_PIN ) ) ; // set pin as output (push-pull pulled low to disable transmitter)
rcc_periph_clock_enable ( RCC_GPIO ( BUSVOODOO_RS232_TX_PORT ) ) ; // enable clock for GPIO
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_TX_PORT ) , GPIO_MODE_OUTPUT_2_MHZ , GPIO_CNF_OUTPUT_PUSHPULL , GPIO ( BUSVOODOO_RS232_TX_PIN ) ) ; // set pin as output (push-pull)
rcc_periph_clock_enable ( RCC_GPIO ( BUSVOODOO_RS232_RX_PORT ) ) ; // enable clock for GPIO
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_RX_PORT ) , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , GPIO ( BUSVOODOO_RS232_RX_PIN ) ) ; // set pin as input (with pull resistors)
// start by setting low since unconnected (pulled to ground by 3 kO) is considered as high
gpio_clear ( GPIO ( BUSVOODOO_RS232_TX_PORT ) , GPIO ( BUSVOODOO_RS232_TX_PIN ) ) ; // set low
gpio_set ( GPIO ( BUSVOODOO_RS232_RX_PORT ) , GPIO ( BUSVOODOO_RS232_RX_PIN ) ) ; // pull high to avoid false negative
sleep_ms ( 5 ) ;
printf ( " connect RS/CAN pin 2 to RS/CAN pin 3 \n " ) ;
while ( gpio_get ( GPIO ( BUSVOODOO_RS232_RX_PORT ) , GPIO ( BUSVOODOO_RS232_RX_PIN ) ) ) { // wait until pin is connected
sleep_ms ( 200 ) ; // wait for user to make connection
}
gpio_set ( GPIO ( BUSVOODOO_RS232_TX_PORT ) , GPIO ( BUSVOODOO_RS232_TX_PIN ) ) ; // set high
gpio_clear ( GPIO ( BUSVOODOO_RS232_RX_PORT ) , GPIO ( BUSVOODOO_RS232_RX_PIN ) ) ; // pull low to avoid false negative
led_toggle ( ) ; // notify user test is almost complete
sleep_ms ( 200 ) ; // wait for voltage to settle and debounce
if ( ! gpio_get ( GPIO ( BUSVOODOO_RS232_RX_PORT ) , GPIO ( BUSVOODOO_RS232_RX_PIN ) ) ) { // check if RX is set low by TX
printf ( " CAN/RS pin 2 is high while it should be set low by pin 3 \n " ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_TX_PORT ) , GPIO_MODE_INPUT , GPIO_CNF_INPUT_FLOAT , GPIO ( BUSVOODOO_RS232_TX_PIN ) ) ; // free pin
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_RX_PORT ) , GPIO_MODE_INPUT , GPIO_CNF_INPUT_FLOAT , GPIO ( BUSVOODOO_RS232_RX_PIN ) ) ; // free pin
led_toggle ( ) ; // notify user test is complete
rcc_periph_clock_enable ( RCC_GPIO ( BUSVOODOO_RS232_RTS_PORT ) ) ; // enable clock for GPIO
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_RTS_PORT ) , GPIO_MODE_OUTPUT_2_MHZ , GPIO_CNF_OUTPUT_PUSHPULL , GPIO ( BUSVOODOO_RS232_RTS_PIN ) ) ; // set pin as output (push-pull)
rcc_periph_clock_enable ( RCC_GPIO ( BUSVOODOO_RS232_CTS_PORT ) ) ; // enable clock for GPIO
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_CTS_PORT ) , GPIO_MODE_INPUT , GPIO_CNF_INPUT_PULL_UPDOWN , GPIO ( BUSVOODOO_RS232_CTS_PIN ) ) ; // set pin as input (with pull resistors)
// start by setting low since unconnected (pulled to ground by 3 kO) is considered as high
gpio_clear ( GPIO ( BUSVOODOO_RS232_RTS_PORT ) , GPIO ( BUSVOODOO_RS232_RTS_PIN ) ) ; // set low
gpio_set ( GPIO ( BUSVOODOO_RS232_CTS_PORT ) , GPIO ( BUSVOODOO_RS232_CTS_PIN ) ) ; // pull high to avoid false negative
printf ( " connect RS/CAN pin 4 to RS/CAN pin 5 \n " ) ;
while ( gpio_get ( GPIO ( BUSVOODOO_RS232_CTS_PORT ) , GPIO ( BUSVOODOO_RS232_CTS_PIN ) ) ) { // wait until pin is connected
sleep_ms ( 200 ) ; // wait for user to make connection
}
gpio_set ( GPIO ( BUSVOODOO_RS232_RTS_PORT ) , GPIO ( BUSVOODOO_RS232_RTS_PIN ) ) ; // set high
gpio_clear ( GPIO ( BUSVOODOO_RS232_CTS_PORT ) , GPIO ( BUSVOODOO_RS232_CTS_PIN ) ) ; // pull low to avoid false negative
led_toggle ( ) ; // notify user test is almost complete
sleep_ms ( 200 ) ; // wait for voltage to settle an debounce
if ( ! gpio_get ( GPIO ( BUSVOODOO_RS232_CTS_PORT ) , GPIO ( BUSVOODOO_RS232_CTS_PIN ) ) ) { // check if CTS is set high by RTS
printf ( " CAN/RS pin 5 is high while it should be set low by pin 4 \n " ) ;
# if DEBUG
while ( true ) ;
# else
goto error ;
# endif
}
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_RTS_PORT ) , GPIO_MODE_INPUT , GPIO_CNF_INPUT_FLOAT , GPIO ( BUSVOODOO_RS232_RTS_PIN ) ) ; // free pin
gpio_set_mode ( GPIO ( BUSVOODOO_RS232_CTS_PORT ) , GPIO_MODE_INPUT , GPIO_CNF_INPUT_FLOAT , GPIO ( BUSVOODOO_RS232_CTS_PIN ) ) ; // free pin
led_toggle ( ) ; // notify user test is complete
gpio_set ( GPIO ( BUSVOODOO_RS232_EN_PORT ) , GPIO ( BUSVOODOO_RS232_EN_PIN ) ) ; // set high to disable receiver
gpio_clear ( GPIO ( BUSVOODOO_RS232_SHDN_PORT ) , GPIO ( BUSVOODOO_RS232_SHDN_PIN ) ) ; // set low to disable transmitter
}
to_return = true ; // all tests passed
# if DEBUG
# else
error :
# endif
busvoodoo_safe_state ( ) ; // go back to safe state
if ( ! to_return ) {
printf ( " the test procedure has been aborted for safety reasons \n " ) ;
}
return to_return ;
}
2018-01-21 23:43:37 +01:00
// command handlers
/** command to perform board self-test
* @ param [ in ] argument no argument required
*/
static void busvoodoo_hiz_command_test_self ( void * argument )
{
( void ) argument ; // we won't use the argument
printf ( " performing self-test \n " ) ;
printf ( " remove all cables from connectors \n " ) ;
if ( wait_space ( ) ) {
if ( busvoodoo_hiz_test_self ( ) ) { // perform self-test
led_blink ( 0 , 1.0 ) ; // show blue OK LED
printf ( " self-test succeeded \n " ) ; // notify user
} else {
led_blink ( 0.5 , 0.5 ) ; // show error on LEDs
printf ( " self-test failed \n " ) ; // notify user
}
} else {
printf ( " self-test aborted \n " ) ;
}
}
/** command to perform pins test
* @ param [ in ] argument no argument required
*/
static void busvoodoo_hiz_command_test_pins ( void * argument )
{
( void ) argument ; // we won't use the argument
printf ( " performing pins test \n " ) ;
printf ( " remove all cables from connectors \n " ) ;
if ( wait_space ( ) ) {
if ( busvoodoo_hiz_test_pins ( ) ) { // perform pin test
led_blink ( 0 , 1.0 ) ; // show blue OK LED
2018-01-22 21:40:53 +01:00
printf ( " pins test succeeded \n " ) ; // notify user
2018-01-21 23:43:37 +01:00
} else {
led_blink ( 0.5 , 0.5 ) ; // show error on LEDs
2018-01-22 21:40:53 +01:00
printf ( " pins test failed \n " ) ; // notify user
2018-01-21 23:43:37 +01:00
}
} else {
2018-01-22 21:40:53 +01:00
printf ( " pins test aborted \n " ) ;
2018-01-21 23:43:37 +01:00
}
}
2018-01-23 15:18:41 +01:00
static const struct menu_command_t busvoodoo_hiz_commands [ ] = {
2018-01-21 23:43:37 +01:00
{
' s ' ,
" self-test " ,
" perform board self-test " ,
MENU_ARGUMENT_NONE ,
NULL ,
& busvoodoo_hiz_command_test_self ,
} ,
{
2018-01-22 21:40:53 +01:00
' t ' ,
2018-01-21 23:43:37 +01:00
" pins-test " ,
" perform connector pins test " ,
MENU_ARGUMENT_NONE ,
NULL ,
& busvoodoo_hiz_command_test_pins ,
} ,
} ;
2018-01-23 15:18:41 +01:00
2018-01-23 15:36:05 +01:00
struct busvoodoo_mode_t busvoodoo_hiz_mode = {
2018-01-23 23:41:41 +01:00
" hiz " ,
" high impedance " ,
2018-01-23 15:18:41 +01:00
& busvoodoo_hiz_setup ,
busvoodoo_hiz_commands ,
LENGTH ( busvoodoo_hiz_commands ) ,
& busvoodoo_hiz_exit ,
} ;