chipmisc: Add support for statically configured output pins

Allow digital and PWM output pins to be setup via new config
sections.  This makes it easier to setup pin configurations.

Signed-off-by: Kevin O'Connor <kevin@koconnor.net>

1 files changed, 83 insertions, 0 deletions

diff --git a/config/example-extras.cfg b/config/example-extras.cfg
new file mode 100644
index 00000000..ec9de90b
--- /dev/null
+++ b/config/example-extras.cfg
@@ -0,0 +1,83 @@
+# This file serves as documentation for config parameters of
+# additional devices that may be configured on a printer. The snippets
+# in this file may be copied into the main printer.cfg file. See the
+# "example.cfg" file for description of common config parameters.
+
+
+# In a multi-extruder printer add an additional extruder section for
+# each additional extruder. The additional extruder sections should be
+# named "extruder1", "extruder2", "extruder3", and so on. See the
+# "extruder" section in example.cfg for a description of available
+# parameters.
+#[extruder1]
+#step_pin: ar36
+#dir_pin: ar34
+#...
+#deactivate_gcode:
+#   A list of G-Code commands (one per line) to execute on a G-Code
+#   tool change command (eg, "T1") that deactivates this extruder and
+#   activates some other extruder. It only makes sense to define this
+#   section on multi-extruder printers. The default is to not run any
+#   special G-Code commands on deactivation.
+#activate_gcode:
+#   A list of G-Code commands (one per line) to execute on a G-Code
+#   tool change command (eg, "T0") that activates this extruder. It
+#   only makes sense to define this section on multi-extruder
+#   printers. The default is to not run any special G-Code commands on
+#   activation.
+
+
+# Heater cooling fans (one may define any number of sections with a
+# "heater_fan" prefix). A "heater fan" is a fan that will be enabled
+# whenever its associated heater is active.
+#[heater_fan my_nozzle_fan]
+# See the "fan" section for fan configuration parameters.
+#pin: ar4
+# The remaining variables are specific to heater_fan.
+#heater: extruder
+#   Name of the config section defining the heater that this fan is
+#   associated with.  The default is "extruder".
+#heater_temp: 50.0
+#   A temperature (in Celsius) that the heater must drop below before
+#   the fan is disabled. The default is 50 Celsius.
+
+
+# Statically configured digital output pins (one may define any number
+# of sections with a "static_digital_output" prefix). Pins configured
+# here will be setup as a GPIO output during MCU configuration.
+#[static_digital_output my_output_pins]
+#pins:
+#   A comma separated list of pins to be set as GPIO output pins. The
+#   pin will be set to a high level unless the pin name is prefaced
+#   with "!". This parameter must be provided.
+
+
+# Statically configured PWM output pins (one may define any number of
+# sections with a "static_pwm_output" prefix). Pins configured here
+# will be setup as PWM outputs during MCU configuration.
+#[static_pwm_output my_output_pwm]
+#pin:
+#   The pin to configure as PWM output. This parameter must be
+#   provided.
+#value:
+#   The value to statically set the PWM output to. This is typically
+#   set to a number between 0.0 and 1.0 with 1.0 being full on and 0.0
+#   being full off. However, the range may be changed with the 'scale'
+#   parameter (see below). This parameter must be provided.
+#hard_pwm:
+#   Set this value to force hardware PWM instead of software PWM. Set
+#   to 1 to force a hardware PWM at the fastest rate; set to a higher
+#   number to force hardware PWM with the given cycle time in clock
+#   ticks. The default is to use software PWM.
+#cycle_time: 0.100
+#   The amount of time (in seconds) per PWM cycle when using software
+#   based PWM. The default is 0.100 seconds.
+#scale:
+#   This parameter can be used to alter how the 'value' parameter is
+#   interpreted. If provided, then the 'value' parameter should be
+#   between 0.0 and 'scale'. This may be useful when configuring a PWM
+#   pin that controls a stepper voltage reference. The 'scale' can be
+#   set to the equivalent stepper amperage if the PWM were fully
+#   enabled, and then the 'value' parameter can be specified using the
+#   desired amperage for the stepper. The default is to not scale the
+#   'value' parameter.