Last edited · 11 revisions  

 


Configuration (GitHub Master Branch)

This is an interim supplement to OnStep's main configuration help file and contains only information about new settings not present in the latest release.

There are numerous checks performed at compile time:  Read the compiler warnings and errors, they are there to help guard against invalid configurations.

The Config.h file settings are categorized as follows:


AUXILIARY FEATURES

This section allows you to control secondary telescope/mount automation equipment.

Parameter Name

  • FEATURE_LIST_DS
    • Default Value: OFF
    • Other Values: ON
    • Notes: Enable this temporarily to get a listing of the Dallas Semiconductor (now Maxim) devices on your OneWire bus.  There are two supported OneWire devices currently the DS18B20 (temperature sensor) and the DS2413 (GPIO - General Purpose Input Output.)  There can be up to eight total DS devices in OnStep.  To see the list open a serial monitor in the Arduino IDE after upload and you will see the list.  The serial numbers shown can be directly entered as FEATUREn_PIN below to associate specific DS devices with features.
    • Reminder: A DS device must be present on a _PIN of an DEW_HEATER or SWITCH in the FEATURES section for this to work.
  • FEATUREn_NAME
    • Default Value: "FEATUREn"
    • Other Values: "Any string"
    • Notes: A handy name to remind you of what this feature does.
    • Reminder:
      • String can be up to 10 characters, any more will be truncated.
      • The commas "," are NOT allowed in the string.
  • FEATUREn_PURPOSE
    • Default Value: OFF
    • Other Values: SWITCH, ANALOG, DEW_HEATER
    • Notes: Specify the type of feature you'd like.  A simple on/off switch (relay) or an analog output (using a MCU pin that supports PWM) or a dew heater.
    • Associated Options: In the case of a dew heater the DEW_HEATER_MAX_POWER n (where n the maximum power as a %) is an option which allows for a wider range of regulation. In-case the heater is a bit too powerful, for instance.
    • Reminder:
      • The WiFi Add-on has support for controlling these features (not supported in the Ethernet Add-on, SHC, or Android App yet.)
      • Dew Heaters
        • Control the power delivered to a heating wire (providing 1 watt per inch of circumference is an accepted standard.)
        • Regulate the power delivered as a slow PWM signal with a period of two seconds.
        • Scale the power delivered to the heater based on the Ambient or Dew Heater Temperature relative to the Dew Point Temperature.  To accomplish this you must update OnStep's Ambient conditions with temperature and humidity on a regular bases, this usually requires the WEATHER option be enabled (BME280.)
        • Have associated run-time settings for the Zero (100% power) and Offset (0% power) temperatures.
  • FEATUREn_TEMP
    • Default Value: OFF
    • Other Values: DS1820, n (ds18b20 serial number)
    • Notes: For dew heaters only.  Specifies an optional dew heater temperature souce associated with this feature.
    • Reminder:
      • If DS1820 is specified, the next available DS1820 on the bus is assigned (in order by serial number.) Use DS1820 or n (ds18b20 serial number) for all, you can not mix serial numbers and automatic assignment!
      • If omitted, a dew heater will use the Ambient temperature, from an BME280 I2C device for instance.
  • FEATUREn_PIN
    • Default Value: OFF
    • Other Values: AUX, DS2413, n (ds2413 serial number,) CHAIN, or n (MCU pin)
    • Notes: Specify an output pin (which this feature will control) on a DS2413 GPIO or micro-controller pin.
    • Reminder:
      • If AUX is specified, the corresponding micro-controller Aux pin is used.  For example if FEATURE5_PIN AUX is set FEATURE5 uses Aux5. The Aux pins are listed in each PINMAP.  For example FEATURE6,7, and 8 on a RAMPS14 or MKS Gen-L are mapped to built-in heater outputs (since the heaters are on Aux6,7, and 8.)
      • If DS2413 is specified, the next available DS2413 on the bus is assigned (in order by serial number.) Use DS2413 or n (ds2413 serial number) for all, you can not mix serial numbers and automatic assignment!
      • Each DS2413 has two GPIO pins.  For this reason you can only specify a DS2413 in every other FEATUREn position.  So if FEATURE1_PIN has a DS2413 (using its GPIO0) FEATURE2_PIN can use the same DS2413 and its GPIO1 via the CHAIN option.