Differences

This shows you the differences between two versions of the page.

--- eeros_architecture:hal:feature_functions [2017/04/30 10:14] – graf
+++ eeros_architecture:hal:feature_functions [2021/05/16 09:33] (current) – [List of Feature Function for Hardware Wrapper Libraries] ursgraf
@@ Line 6: / Line 6: @@
   void callInputFeature(InputInterface *obj, std::string featureName, ArgTypesIn... args);
 </code>
+The parameter are as follows:
+  - OutputInterface / InputInterface: the HAL object
+  - featureName: name of the function as defined in the appropriate hardware wrapper library, see [[eeros_architecture:hal:hardware_libraries|]].
+  - args: arguments to this function
+The following example shows how to set the frequency of a pulse width modulated output. This
+is usually done just once. After this you can release the object.
+<code cpp>
+  HAL& hal = HAL::instance();
+  eeros::hal::Output<double>* pwm = hal.getScalableOutput("pwm1");
+  hal.callOutputFeature(pwm, "setPwmFrequency", 100.0);
+  hal.releaseOutput("pwm1");
+</code>
+===== Accessing Feature Functions from the Control System =====
+The control system defines a peripheral output objects which is connected to our HAL object. The control system will usually periodically write to this output and set the duty cycle.
+However, if you wish to change the frequency of the signal you must again use the feature function as follows:
+<code cpp>
+  PeripheralOutput<double> motorSpeed("pwm1");
+  motorSpeed.callOutputFeature("setPwmFrequency", 200.0);
+</code>
+===== List of Feature Function for Hardware Wrapper Libraries =====
+^library^type^function^Parameter^Description^
+|bbblue-eeros|AnalogOut|freeSpin|channel|Puts a motor into a zero-throttle state allowing it to spin freely. Motor channel (1-4) or 0 for all channels. Make sure, that the peripheral output driving the motor does not run, else the set function will reenable the H-bridge.|
+|:::|:::|brake|channel|Connects the motor terminal pairs together which makes the motor fight against its own back EMF turning it into a brake resisting rotation. Motor channel (1-4) or 0 for all channels. Make sure, that the peripheral output driving the motor does not run, else the set function will reenable the H-bridge.|
+|:::|Fqd|resetFqd| |Sets the encoder position to zero. This can be useful for homing.|
+|:::|:::|setFqdPos|position|Sets the encoder position to a given value. This can be useful for homing.|
+|flink-eeros|Fqd|resetFqd| |Sets the encoder position to zero. This can be useful for homing.|
+|:::|Pwm|setPwmFrequency|frequency|Sets the pwm frequency (Hz).|
+|:::|:::|setPwmDutyCycle|duty cycle|Sets the pwm duty cycle (0.0 .. 1.0).|
+|:::|Watchdog|resetWatchdog| |Resets the watchdog.|
+|:::|:::|setWatchdogTimeout|timeout|Sets the watchdog timeout (s).|