rpp/include/rpp/mout.h

   1 /**
   2  * Power Output (12V, 2A, Push/Pull) RPP API header file.
   3  *
   4  * @file mout.h
   5  *
   6  * @copyright Copyright (C) 2013, 2016 Czech Technical University in Prague
   7  *
   8  * @author Carlos Jenkins <carlos@jenkins.co.cr>
   9  */
  10
  11
  12 #ifndef __RPP_MOUT_H
  13 #define __RPP_MOUT_H
  14
  15 /**
  16  * MOUT module initialization.
  17  *
  18  * Call this method before using this module.
  19  *
  20  * This function is not thread safe. Do not call it from multiple threads.
  21  *
  22  * @return SUCCESS if initialization successful.\n
  23  *         FAILURE if module already initialized.
  24  */
  25 int8_t rpp_mout_init();
  26
  27
  28 /**
  29  * Set the output of given pin to given value.
  30  *
  31  * The function is thread safe, unless compiled with -DRPP_THREADSAFE=0.
  32  *
  33  * This function will also verify if a faulty condition is detected. See return
  34  * documentation below for details.
  35  *
  36  * @param[in] pin       The pin number to set [1-6].
  37  * @param[in] val       The value to be set [HIGH|LOW].
  38  *
  39  * @return SUCCESS if pin could be set and verified.\n
  40  *         -1 if pin number is out of range.\n
  41  *         -2 if val is not HIGH or LOW.\n
  42  *         -3 if pin could not be set. With current implementation this should
  43  *            never happen.\n
  44  *         -4 if a fault is indicated by DIAG pin
  45  */
  46 int8_t rpp_mout_set(uint8_t pin, uint8_t val);
  47
  48
  49 /**
  50  * Get the cached value of the given pin set by rpp_mout_set().
  51  *
  52  * The function is thread safe, unless compiled with -DRPP_THREADSAFE=0.
  53  *
  54  * This will not read the value on the pin. To confirm if the output is
  55  * correctly set call rpp_mout_diag() and confirm SUCCESS.
  56  *
  57  * @param[in] pin       The pin number to get cached value [1-6].
  58  *
  59  * @return HIGH or LOW cached from last rpp_mout_set() call for given pin.
  60  *         -1 if pin number is out of range.
  61  */
  62 int8_t rpp_mout_get(uint8_t pin);
  63
  64
  65 /**
  66  * Reads the value on the given diagnostic pin.
  67  *
  68  * The function is thread safe, unless compiled with -DRPP_THREADSAFE=0.
  69  *
  70  * @param[in] pin       The pin number to read [1-6].
  71  *
  72  * @return 0 the pin is low, i.e. fault detected,
  73  *         1 the pin is high, i.e. normal operation,
  74  *         -RPP_EINVAL pin number out of range
  75  */
  76 int8_t rpp_mout_diag(uint8_t pin);
  77
  78
  79 #endif /* __RPP_MOUT_H */