From d3c13f997ef2b8dbf2a09eb88258bfbb120a41d3 Mon Sep 17 00:00:00 2001 From: sagiferi Date: Wed, 20 May 2026 21:48:13 +0200 Subject: [PATCH] init --- .gitattributes | 2 + .gitignore | 13 + CLAUDE.md | 67 + Config.h | 400 +++ Extended.config.h | 38 + LICENSE | 674 +++++ OnStepX.ino | 163 ++ app.bin | Bin 0 -> 4128768 bytes docs/CAN_NOTES.md | 437 +++ docs/COMMAND_REFERENCE.md | 861 ++++++ docs/GEM LIMITS EXAMPLE EAST OF PIER.jpg | Bin 0 -> 49542 bytes docs/GEM LIMITS EXAMPLE KEEP OUT ZONE.jpg | Bin 0 -> 37253 bytes docs/GEM LIMITS EXAMPLE WEST OF PIER.jpg | Bin 0 -> 49783 bytes docs/GOTO_NOTES.md | 514 ++++ docs/HOMING_NOTES.md | 461 +++ docs/PEC_NOTES.md | 420 +++ docs/SENSING_NOTES.md | 401 +++ docs/SERIAL_NOTES.md | 314 +++ docs/SERVO_SETUP.md | 496 ++++ docs/STARTUP_AUTHORITY_NOTES.md | 366 +++ juwei_gyari_backup.bin | Bin 0 -> 4194304 bytes src/Common.h | 76 + src/Config.defaults.h | 2460 +++++++++++++++++ src/Constants.h | 163 ++ src/HAL/HAL.cpp | 6 + src/HAL/HAL.h | 190 ++ src/HAL/HAL_ANALOG.h | 73 + src/HAL/HAL_FAST_TICKS.h | 248 ++ src/HAL/arduinoM0/ArduinoM0.h | 57 + src/HAL/atmel/Mega2560.h | 68 + src/HAL/atmel/Mega328.h | 63 + src/HAL/default/Default.h | 55 + src/HAL/esp/ESP32Libraries2.h | 96 + src/HAL/esp/ESP32Libraries3.h | 98 + src/HAL/esp/ESP32UnoR4WiFi.h | 56 + src/HAL/esp/ESP8266.h | 51 + src/HAL/mbed/Rpi2040.h | 52 + src/HAL/mbed/Rpi2350.h | 52 + src/HAL/stm32/STM32F103.h | 65 + src/HAL/stm32/STM32F303.h | 67 + src/HAL/stm32/STM32F407.h | 75 + src/HAL/stm32/STM32F446.h | 86 + src/HAL/stm32/STM32F4x1.h | 81 + src/HAL/stm32/STM32H7xx.h | 80 + src/HAL/teensy/Teensy3.2.h | 82 + src/HAL/teensy/Teensy3.5.h | 74 + src/HAL/teensy/Teensy3.6.h | 82 + src/HAL/teensy/Teensy4.0.h | 77 + src/HAL/teensy/Teensy4.1.h | 77 + src/Validate.h | 1466 ++++++++++ src/lib/1wire/1Wire.cpp | 10 + src/lib/1wire/1Wire.h | 13 + src/lib/Constants.h | 202 ++ src/lib/Macros.h | 291 ++ src/lib/analog/Analog.cpp | 660 +++++ src/lib/analog/Analog.h | 112 + src/lib/axis/Axis.command.cpp | 195 ++ src/lib/axis/Axis.cpp | 765 +++++ src/lib/axis/Axis.h | 552 ++++ src/lib/axis/motor/Drivers.h | 93 + src/lib/axis/motor/Motor.cpp | 212 ++ src/lib/axis/motor/Motor.h | 219 ++ src/lib/axis/motor/kTech/KTech.cpp | 377 +++ src/lib/axis/motor/kTech/KTech.h | 118 + src/lib/axis/motor/mksServo/MksServo.cpp | 454 +++ src/lib/axis/motor/mksServo/MksServo.h | 184 ++ src/lib/axis/motor/oDrive/ODrive.cpp | 288 ++ src/lib/axis/motor/oDrive/ODrive.h | 181 ++ src/lib/axis/motor/oDrive/ODriveCanPlus.cpp | 220 ++ src/lib/axis/motor/oDrive/ODriveCanPlus.h | 113 + src/lib/axis/motor/oDrive/ODriveNew.cpp | 437 +++ src/lib/axis/motor/oDrive/ODriveNew.h | 151 + src/lib/axis/motor/servo/Servo.cpp | 525 ++++ src/lib/axis/motor/servo/Servo.h | 190 ++ src/lib/axis/motor/servo/ServoDriver.cpp | 170 ++ src/lib/axis/motor/servo/ServoDriver.h | 135 + src/lib/axis/motor/servo/dc/DcServoDriver.cpp | 167 ++ src/lib/axis/motor/servo/dc/DcServoDriver.h | 65 + .../servo/dc/calibration/TrackingVelocity.cpp | 746 +++++ .../servo/dc/calibration/TrackingVelocity.h | 192 ++ src/lib/axis/motor/servo/dc/eE/EE.cpp | 92 + src/lib/axis/motor/servo/dc/eE/EE.h | 41 + src/lib/axis/motor/servo/dc/pE/PE.cpp | 95 + src/lib/axis/motor/servo/dc/pE/PE.h | 40 + .../motor/servo/dc/tmc/tmc2130/Tmc2130.cpp | 103 + .../axis/motor/servo/dc/tmc/tmc2130/Tmc2130.h | 39 + .../motor/servo/dc/tmc/tmc5160/Tmc5160.cpp | 103 + .../axis/motor/servo/dc/tmc/tmc5160/Tmc5160.h | 39 + .../motor/servo/feedback/DualPid/DualPid.cpp | 118 + .../motor/servo/feedback/DualPid/DualPid.h | 107 + src/lib/axis/motor/servo/feedback/Feedback.h | 5 + .../motor/servo/feedback/FeedbackBase.cpp | 19 + .../axis/motor/servo/feedback/FeedbackBase.h | 90 + src/lib/axis/motor/servo/feedback/Pid/Pid.cpp | 81 + src/lib/axis/motor/servo/feedback/Pid/Pid.h | 80 + src/lib/axis/motor/servo/filter/Filter.h | 7 + .../axis/motor/servo/filter/FilterBase.cpp | 4 + src/lib/axis/motor/servo/filter/FilterBase.h | 41 + .../axis/motor/servo/filter/Kalman/Kalman.cpp | 29 + .../axis/motor/servo/filter/Kalman/Kalman.h | 26 + .../motor/servo/filter/Learning/Learning.cpp | 198 ++ .../motor/servo/filter/Learning/Learning.h | 51 + .../motor/servo/filter/Rolling/Rolling.cpp | 28 + .../axis/motor/servo/filter/Rolling/Rolling.h | 23 + src/lib/axis/motor/servo/kTech/KTech.cpp | 177 ++ src/lib/axis/motor/servo/kTech/KTech.h | 73 + .../axis/motor/servo/tmc/TmcServoDriver.cpp | 133 + src/lib/axis/motor/servo/tmc/TmcServoDriver.h | 63 + .../axis/motor/servo/tmc/tmc2209/Tmc2209.cpp | 180 ++ .../axis/motor/servo/tmc/tmc2209/Tmc2209.h | 91 + .../axis/motor/servo/tmc/tmc5160/Tmc5160.cpp | 139 + .../axis/motor/servo/tmc/tmc5160/Tmc5160.h | 48 + src/lib/axis/motor/stepDir/StepDir.cpp | 572 ++++ src/lib/axis/motor/stepDir/StepDir.h | 179 ++ src/lib/axis/motor/stepDir/StepDirDriver.cpp | 310 +++ src/lib/axis/motor/stepDir/StepDirDriver.h | 146 + .../axis/motor/stepDir/generic/Generic.cpp | 113 + src/lib/axis/motor/stepDir/generic/Generic.h | 68 + .../motor/stepDir/tmc/TmcStepDirDriver.cpp | 253 ++ .../axis/motor/stepDir/tmc/TmcStepDirDriver.h | 52 + .../motor/stepDir/tmc/TmcStepDirDriverNSG.cpp | 14 + .../motor/stepDir/tmc/TmcStepDirDriverNSG.h | 30 + .../motor/stepDir/tmc/TmcStepDirDriverSG.cpp | 730 +++++ .../motor/stepDir/tmc/TmcStepDirDriverSG.h | 379 +++ .../axis/motor/stepDir/tmc/legacy/TmcSPI.cpp | 269 ++ .../axis/motor/stepDir/tmc/legacy/TmcSPI.h | 180 ++ .../stepDir/tmc/legacy/tmc2130/Tmc2130.cpp | 97 + .../stepDir/tmc/legacy/tmc2130/Tmc2130.h | 46 + .../stepDir/tmc/legacy/tmc2209/Tmc2209.cpp | 166 ++ .../stepDir/tmc/legacy/tmc2209/Tmc2209.h | 75 + .../stepDir/tmc/legacy/tmc5160/Tmc5160.cpp | 97 + .../stepDir/tmc/legacy/tmc5160/Tmc5160.h | 46 + .../tmc/tmcStepper/tmc2130/Tmc2130.cpp | 130 + .../stepDir/tmc/tmcStepper/tmc2130/Tmc2130.h | 69 + .../tmc/tmcStepper/tmc2160/Tmc2160.cpp | 133 + .../stepDir/tmc/tmcStepper/tmc2160/Tmc2160.h | 69 + .../tmc/tmcStepper/tmc2208/tmc2208.cpp | 152 + .../stepDir/tmc/tmcStepper/tmc2208/tmc2208.h | 62 + .../tmc/tmcStepper/tmc2209/Tmc2209.cpp | 180 ++ .../stepDir/tmc/tmcStepper/tmc2209/Tmc2209.h | 73 + .../tmc/tmcStepper/tmc2660/Tmc2660.cpp | 101 + .../stepDir/tmc/tmcStepper/tmc2660/Tmc2660.h | 51 + .../tmc/tmcStepper/tmc5160/Tmc5160.cpp | 131 + .../stepDir/tmc/tmcStepper/tmc5160/Tmc5160.h | 71 + .../tmc/tmcStepper/tmc5161/Tmc5161.cpp | 131 + .../stepDir/tmc/tmcStepper/tmc5161/Tmc5161.h | 69 + src/lib/bluetooth/Bluetooth.defaults.h | 91 + src/lib/bluetooth/BluetoothManager.cpp | 86 + src/lib/bluetooth/BluetoothManager.h | 75 + src/lib/calendars/Calendars.cpp | 73 + src/lib/calendars/Calendars.h | 43 + src/lib/canPlus/CanPlus.h | 15 + src/lib/canPlus/CanPlusBase.cpp | 131 + src/lib/canPlus/CanPlusBase.h | 117 + src/lib/canPlus/esp32/Esp32.cpp | 194 ++ src/lib/canPlus/esp32/Esp32.h | 40 + src/lib/canPlus/mcp2515/Mcp2515.cpp | 152 + src/lib/canPlus/mcp2515/Mcp2515.h | 31 + src/lib/canPlus/san/San.cpp | 124 + src/lib/canPlus/san/San.h | 29 + src/lib/canPlus/teensy4/Can0.cpp | 92 + src/lib/canPlus/teensy4/Can0.h | 38 + src/lib/canPlus/teensy4/Can1.cpp | 92 + src/lib/canPlus/teensy4/Can1.h | 38 + src/lib/canPlus/teensy4/Can2.cpp | 92 + src/lib/canPlus/teensy4/Can2.h | 38 + src/lib/canPlus/teensy4/Can3.cpp | 92 + src/lib/canPlus/teensy4/Can3.h | 38 + src/lib/canTransport/CanTransportBase.cpp | 227 ++ src/lib/canTransport/CanTransportBase.h | 224 ++ src/lib/canTransport/CanTransportClient.cpp | 222 ++ src/lib/canTransport/CanTransportClient.h | 84 + src/lib/canTransport/CanTransportServer.cpp | 108 + src/lib/canTransport/CanTransportServer.h | 67 + src/lib/commands/BufferCmds.cpp | 100 + src/lib/commands/BufferCmds.h | 30 + src/lib/commands/CommandErrors.h | 16 + src/lib/commands/SerialWrapper.cpp | 413 +++ src/lib/commands/SerialWrapper.h | 50 + src/lib/commands/commands.ino | 4 + src/lib/convert/Convert.cpp | 339 +++ src/lib/convert/Convert.h | 94 + src/lib/debug/Debug.cpp | 114 + src/lib/debug/Debug.h | 51 + src/lib/encoder/Encoder.h | 15 + src/lib/encoder/EncoderBase.cpp | 228 ++ src/lib/encoder/EncoderBase.h | 292 ++ src/lib/encoder/bissc/As37h39bb.cpp | 48 + src/lib/encoder/bissc/As37h39bb.h | 30 + src/lib/encoder/bissc/Asc85.cpp | 43 + src/lib/encoder/bissc/Asc85.h | 30 + src/lib/encoder/bissc/Bissc.cpp | 284 ++ src/lib/encoder/bissc/Bissc.h | 137 + src/lib/encoder/bissc/Jtw24.cpp | 45 + src/lib/encoder/bissc/Jtw24.h | 30 + src/lib/encoder/bissc/Jtw26.cpp | 45 + src/lib/encoder/bissc/Jtw26.h | 30 + src/lib/encoder/cwCcw/CwCcw.cpp | 180 ++ src/lib/encoder/cwCcw/CwCcw.h | 31 + src/lib/encoder/ktech/KTech.cpp | 207 ++ src/lib/encoder/ktech/KTech.h | 48 + src/lib/encoder/pulseDir/PulseDir.cpp | 159 ++ src/lib/encoder/pulseDir/PulseDir.h | 30 + src/lib/encoder/pulseOnly/PulseOnly.cpp | 158 ++ src/lib/encoder/pulseOnly/PulseOnly.h | 32 + src/lib/encoder/quadrature/Quadrature.cpp | 235 ++ src/lib/encoder/quadrature/Quadrature.h | 59 + .../quadratureEsp32/QuadratureEsp32.cpp | 63 + .../encoder/quadratureEsp32/QuadratureEsp32.h | 30 + src/lib/encoder/serialBridge/SerialBridge.cpp | 87 + src/lib/encoder/serialBridge/SerialBridge.h | 34 + src/lib/encoder/virtualEnc/VirtualEnc.cpp | 155 ++ src/lib/encoder/virtualEnc/VirtualEnc.h | 29 + src/lib/ethernet/EthernetManager.cpp | 174 ++ src/lib/ethernet/EthernetManager.defaults.h | 142 + src/lib/ethernet/EthernetManager.h | 114 + src/lib/ethernet/cmdServer/CmdServer.cpp | 78 + src/lib/ethernet/cmdServer/CmdServer.h | 27 + src/lib/ethernet/webServer/WebServer.cpp | 335 +++ src/lib/ethernet/webServer/WebServer.h | 115 + src/lib/gpioEx/GpioBase.cpp | 18 + src/lib/gpioEx/GpioBase.h | 68 + src/lib/gpioEx/GpioEx.h | 12 + src/lib/gpioEx/ds2413/Ds2413.cpp | 136 + src/lib/gpioEx/ds2413/Ds2413.h | 44 + src/lib/gpioEx/mcp23008/Mcp23008.cpp | 64 + src/lib/gpioEx/mcp23008/Mcp23008.h | 31 + src/lib/gpioEx/mcp23017/Mcp23017.cpp | 67 + src/lib/gpioEx/mcp23017/Mcp23017.h | 31 + src/lib/gpioEx/pcf8574/Pcf8574.cpp | 102 + src/lib/gpioEx/pcf8574/Pcf8574.h | 48 + src/lib/gpioEx/pcf8575/Pcf8575.cpp | 105 + src/lib/gpioEx/pcf8575/Pcf8575.h | 42 + src/lib/gpioEx/ssr74HC595/Ssr74HC595.cpp | 127 + src/lib/gpioEx/ssr74HC595/Ssr74HC595.h | 33 + src/lib/gpioEx/sws/Sws.cpp | 146 + src/lib/gpioEx/sws/Sws.h | 52 + src/lib/gpioEx/tca9555/Tca9555.cpp | 65 + src/lib/gpioEx/tca9555/Tca9555.h | 31 + src/lib/math/Crc.cpp | 39 + src/lib/math/Crc.h | 205 ++ src/lib/nv/Nv.cpp | 191 ++ src/lib/nv/Nv.h | 95 + src/lib/nv/NvConfig.h | 88 + src/lib/nv/NvIvPartition.cpp | 101 + src/lib/nv/NvIvPartition.h | 87 + src/lib/nv/NvKvPartition16.cpp | 722 +++++ src/lib/nv/NvKvPartition16.h | 302 ++ src/lib/nv/NvKvPartition32.cpp | 653 +++++ src/lib/nv/NvKvPartition32.h | 295 ++ src/lib/nv/NvVolume.cpp | 598 ++++ src/lib/nv/NvVolume.h | 184 ++ src/lib/nv/device/24xxI2C.h | 147 + src/lib/nv/device/DeviceNull.h | 71 + src/lib/nv/device/EepromArduino.h | 68 + src/lib/nv/device/EepromEmuEsp.h | 81 + src/lib/nv/device/EepromEmuM0.h | 88 + src/lib/nv/device/Mb85rcI2C.h | 127 + src/lib/nv/device/NvDeviceBase.h | 57 + src/lib/nv/device/ShimCached.h | 365 +++ src/lib/nv/device/ShimDelayedCommit.h | 118 + src/lib/pushButton/PushButton.cpp | 131 + src/lib/pushButton/PushButton.h | 68 + src/lib/sense/Sense.cpp | 170 ++ src/lib/sense/Sense.h | 92 + src/lib/serial/Serial_IP_Ethernet.cpp | 123 + src/lib/serial/Serial_IP_Ethernet.h | 63 + src/lib/serial/Serial_IP_Ethernet_Client.cpp | 113 + src/lib/serial/Serial_IP_Ethernet_Client.h | 60 + src/lib/serial/Serial_IP_Wifi.cpp | 125 + src/lib/serial/Serial_IP_Wifi.h | 65 + src/lib/serial/Serial_IP_Wifi_Client.cpp | 117 + src/lib/serial/Serial_IP_Wifi_Client.h | 60 + src/lib/serial/Serial_Local.cpp | 78 + src/lib/serial/Serial_Local.h | 128 + src/lib/serial/Serial_MEGA2560.cpp | 219 ++ src/lib/serial/Serial_MEGA2560.h | 112 + src/lib/serial/Serial_ST4_Master.cpp | 215 ++ src/lib/serial/Serial_ST4_Master.h | 72 + src/lib/serial/Serial_ST4_Slave.cpp | 298 ++ src/lib/serial/Serial_ST4_Slave.h | 84 + src/lib/softSpi/Pins.h | 5 + src/lib/softSpi/SoftSpi.cpp | 73 + src/lib/softSpi/SoftSpi.h | 26 + src/lib/sound/Sound.cpp | 67 + src/lib/sound/Sound.h | 21 + src/lib/tasks/HAL_ATMEGA328_HWTIMER.h | 81 + src/lib/tasks/HAL_EMPTY_HWTIMER.h | 139 + src/lib/tasks/HAL_ESP32_HWTIMER.h | 216 ++ src/lib/tasks/HAL_ESP32_V3_HWTIMER.h | 208 ++ src/lib/tasks/HAL_HWTIMERS.h | 54 + src/lib/tasks/HAL_MEGA2560_HWTIMER.h | 162 ++ src/lib/tasks/HAL_PROFILER.h | 48 + src/lib/tasks/HAL_STM32_HWTIMER.h | 202 ++ src/lib/tasks/HAL_TEENSY_HWTIMER.h | 150 + src/lib/tasks/OnTask.cpp | 660 +++++ src/lib/tasks/OnTask.h | 380 +++ src/lib/tasks/OnTaskExample.ino.txt | 189 ++ src/lib/tls/PPS.cpp | 38 + src/lib/tls/PPS.h | 30 + src/lib/tls/Tls.h | 13 + src/lib/tls/TlsBase.cpp | 2 + src/lib/tls/TlsBase.h | 45 + src/lib/tls/ds3231/DS3231.cpp | 111 + src/lib/tls/ds3231/DS3231.h | 36 + src/lib/tls/ds3234/DS3234.cpp | 99 + src/lib/tls/ds3234/DS3234.h | 37 + src/lib/tls/gps/GPS.cpp | 208 ++ src/lib/tls/gps/GPS.h | 55 + src/lib/tls/ntp/NTP.cpp | 143 + src/lib/tls/ntp/NTP.h | 60 + src/lib/tls/sd3031/SD3031.cpp | 85 + src/lib/tls/sd3031/SD3031.h | 36 + src/lib/tls/teensy/Teensy.cpp | 49 + src/lib/tls/teensy/Teensy.h | 32 + src/lib/watchdog/Watchdog.cpp | 63 + src/lib/watchdog/Watchdog.h | 31 + src/lib/wifi/WifiManager.cpp | 251 ++ src/lib/wifi/WifiManager.defaults.h | 337 +++ src/lib/wifi/WifiManager.h | 174 ++ src/lib/wifi/cmdServer/CmdServer.cpp | 81 + src/lib/wifi/cmdServer/CmdServer.h | 28 + src/lib/wifi/webServer/WebServer.cpp | 14 + src/lib/wifi/webServer/WebServer.h | 26 + src/libApp/commands/CommandBroker.cpp | 197 ++ src/libApp/commands/CommandBroker.h | 84 + src/libApp/commands/ProcessCmds.cpp | 315 +++ src/libApp/commands/ProcessCmds.h | 36 + src/libApp/temperature/Ds1820.cpp | 150 + src/libApp/temperature/Ds1820.h | 42 + src/libApp/temperature/Temperature.cpp | 21 + src/libApp/temperature/Temperature.h | 27 + src/libApp/temperature/Thermistor.cpp | 135 + src/libApp/temperature/Thermistor.h | 56 + src/libApp/weather/Weather.cpp | 204 ++ src/libApp/weather/Weather.h | 49 + src/pinmaps/Models.h | 101 + src/pinmaps/Pins.CNC3.h | 130 + src/pinmaps/Pins.FYSETC_E4.h | 182 ++ src/pinmaps/Pins.FYSETC_S6.h | 204 ++ src/pinmaps/Pins.JTWPCB2.h | 66 + src/pinmaps/Pins.Manticore.h | 137 + src/pinmaps/Pins.MaxESP3.h | 145 + src/pinmaps/Pins.MaxESP4.h | 151 + src/pinmaps/Pins.MaxPCB.h | 138 + src/pinmaps/Pins.MaxPCB3.h | 134 + src/pinmaps/Pins.MaxPCB36.h | 130 + src/pinmaps/Pins.MaxPCB4.h | 145 + src/pinmaps/Pins.MaxSTM.h | 148 + src/pinmaps/Pins.MicroScope.h | 119 + src/pinmaps/Pins.MiniPCB.h | 143 + src/pinmaps/Pins.OctopusPro.h | 182 ++ src/pinmaps/Pins.SAL_XB1.h | 149 + src/pinmaps/Pins.SKR_PRO.h | 234 ++ src/pinmaps/Pins.STM32B.h | 146 + src/pinmaps/Pins.defaults.h | 685 +++++ src/pinmaps/Validate.h | 276 ++ src/telescope/Telescope.command.cpp | 285 ++ src/telescope/Telescope.cpp | 334 +++ src/telescope/Telescope.h | 68 + src/telescope/addonFlasher/AddonFlasher.cpp | 135 + src/telescope/addonFlasher/AddonFlasher.h | 29 + src/telescope/auxiliary/Features.h | 21 + src/telescope/auxiliary/FeaturesBase.h | 108 + .../auxiliary/dewHeater/DewHeater.cpp | 92 + src/telescope/auxiliary/dewHeater/DewHeater.h | 55 + .../intervalometer/Intervalometer.cpp | 107 + .../auxiliary/intervalometer/Intervalometer.h | 58 + .../auxiliary/local/Features.can.command.cpp | 256 ++ .../auxiliary/local/Features.command.cpp | 218 ++ src/telescope/auxiliary/local/Features.cpp | 166 ++ src/telescope/auxiliary/local/Features.h | 118 + .../auxiliary/powerMonitor/PowerMonitor.cpp | 179 ++ .../auxiliary/powerMonitor/PowerMonitor.h | 59 + .../auxiliary/remote/Features.can.decode.cpp | 173 ++ .../auxiliary/remote/Features.can.encode.cpp | 98 + src/telescope/auxiliary/remote/Features.cpp | 65 + src/telescope/auxiliary/remote/Features.h | 46 + src/telescope/focuser/Focuser.h | 21 + src/telescope/focuser/FocuserBase.h | 114 + .../focuser/local/Focuser.axis.prototype.cpp | 109 + src/telescope/focuser/local/Focuser.axis4.cpp | 109 + src/telescope/focuser/local/Focuser.axis5.cpp | 109 + src/telescope/focuser/local/Focuser.axis6.cpp | 109 + src/telescope/focuser/local/Focuser.axis7.cpp | 109 + src/telescope/focuser/local/Focuser.axis8.cpp | 109 + src/telescope/focuser/local/Focuser.axis9.cpp | 109 + .../focuser/local/Focuser.can.command.cpp | 272 ++ .../focuser/local/Focuser.command.cpp | 341 +++ src/telescope/focuser/local/Focuser.cpp | 700 +++++ src/telescope/focuser/local/Focuser.h | 230 ++ .../focuser/remote/Focuser.can.decode.cpp | 126 + .../focuser/remote/Focuser.can.encode.cpp | 208 ++ src/telescope/focuser/remote/Focuser.cpp | 166 ++ src/telescope/focuser/remote/Focuser.h | 51 + src/telescope/mount/Mount.axis.cpp | 242 ++ src/telescope/mount/Mount.command.cpp | 489 ++++ src/telescope/mount/Mount.cpp | 597 ++++ src/telescope/mount/Mount.h | 163 ++ src/telescope/mount/coordinates/Align.hs.cpp | 569 ++++ src/telescope/mount/coordinates/Align.hs.h | 134 + src/telescope/mount/coordinates/Align.ref.cpp | 543 ++++ src/telescope/mount/coordinates/Align.ref.h | 132 + src/telescope/mount/coordinates/Transform.cpp | 310 +++ src/telescope/mount/coordinates/Transform.h | 114 + .../mount/coordinates/coordinates.ino | 4 + src/telescope/mount/goto/Goto.command.cpp | 583 ++++ src/telescope/mount/goto/Goto.cpp | 734 +++++ src/telescope/mount/goto/Goto.h | 170 ++ src/telescope/mount/guide/Guide.command.cpp | 196 ++ src/telescope/mount/guide/Guide.cpp | 484 ++++ src/telescope/mount/guide/Guide.h | 135 + src/telescope/mount/home/Home.command.cpp | 94 + src/telescope/mount/home/Home.cpp | 424 +++ src/telescope/mount/home/Home.h | 81 + .../mount/library/Library.command.cpp | 183 ++ src/telescope/mount/library/Library.cpp | 324 +++ src/telescope/mount/library/Library.h | 119 + src/telescope/mount/limits/Limits.command.cpp | 107 + src/telescope/mount/limits/Limits.cpp | 504 ++++ src/telescope/mount/limits/Limits.h | 126 + src/telescope/mount/park/Park.command.cpp | 37 + src/telescope/mount/park/Park.cpp | 323 +++ src/telescope/mount/park/Park.h | 69 + src/telescope/mount/pec/Pec.command.cpp | 251 ++ src/telescope/mount/pec/Pec.cpp | 334 +++ src/telescope/mount/pec/Pec.h | 84 + src/telescope/mount/site/Site.command.cpp | 282 ++ src/telescope/mount/site/Site.cpp | 459 +++ src/telescope/mount/site/Site.h | 158 ++ src/telescope/mount/st4/St4.cpp | 301 ++ src/telescope/mount/st4/St4.h | 27 + src/telescope/mount/status/Status.command.cpp | 202 ++ src/telescope/mount/status/Status.cpp | 105 + src/telescope/mount/status/Status.h | 52 + src/telescope/rotator/Rotator.h | 19 + src/telescope/rotator/RotatorBase.h | 110 + src/telescope/rotator/local/Rotator.axis.cpp | 108 + .../rotator/local/Rotator.can.command.cpp | 264 ++ .../rotator/local/Rotator.command.cpp | 270 ++ src/telescope/rotator/local/Rotator.cpp | 320 +++ src/telescope/rotator/local/Rotator.h | 109 + .../rotator/remote/Rotator.can.decode.cpp | 95 + .../rotator/remote/Rotator.can.encode.cpp | 187 ++ src/telescope/rotator/remote/Rotator.cpp | 66 + src/telescope/rotator/remote/Rotator.h | 48 + 446 files changed, 70716 insertions(+) create mode 100755 .gitattributes create mode 100755 .gitignore create mode 100644 CLAUDE.md create mode 100755 Config.h create mode 100755 Extended.config.h create mode 100755 LICENSE create mode 100755 OnStepX.ino create mode 100644 app.bin create mode 100755 docs/CAN_NOTES.md create mode 100755 docs/COMMAND_REFERENCE.md create mode 100755 docs/GEM LIMITS EXAMPLE EAST OF PIER.jpg create mode 100755 docs/GEM LIMITS EXAMPLE KEEP OUT ZONE.jpg create mode 100755 docs/GEM LIMITS EXAMPLE WEST OF PIER.jpg create mode 100755 docs/GOTO_NOTES.md create mode 100755 docs/HOMING_NOTES.md create mode 100755 docs/PEC_NOTES.md create mode 100755 docs/SENSING_NOTES.md create mode 100755 docs/SERIAL_NOTES.md create mode 100755 docs/SERVO_SETUP.md create mode 100755 docs/STARTUP_AUTHORITY_NOTES.md create mode 100755 juwei_gyari_backup.bin create mode 100755 src/Common.h create mode 100755 src/Config.defaults.h create mode 100755 src/Constants.h create mode 100755 src/HAL/HAL.cpp create mode 100755 src/HAL/HAL.h create mode 100755 src/HAL/HAL_ANALOG.h create mode 100755 src/HAL/HAL_FAST_TICKS.h create mode 100755 src/HAL/arduinoM0/ArduinoM0.h create mode 100755 src/HAL/atmel/Mega2560.h create mode 100755 src/HAL/atmel/Mega328.h create mode 100755 src/HAL/default/Default.h create mode 100755 src/HAL/esp/ESP32Libraries2.h create mode 100755 src/HAL/esp/ESP32Libraries3.h create mode 100755 src/HAL/esp/ESP32UnoR4WiFi.h create mode 100755 src/HAL/esp/ESP8266.h create mode 100755 src/HAL/mbed/Rpi2040.h create mode 100755 src/HAL/mbed/Rpi2350.h create mode 100755 src/HAL/stm32/STM32F103.h create mode 100755 src/HAL/stm32/STM32F303.h create mode 100755 src/HAL/stm32/STM32F407.h create mode 100755 src/HAL/stm32/STM32F446.h create mode 100755 src/HAL/stm32/STM32F4x1.h create mode 100755 src/HAL/stm32/STM32H7xx.h create mode 100755 src/HAL/teensy/Teensy3.2.h create mode 100755 src/HAL/teensy/Teensy3.5.h create mode 100755 src/HAL/teensy/Teensy3.6.h create mode 100755 src/HAL/teensy/Teensy4.0.h create mode 100755 src/HAL/teensy/Teensy4.1.h create mode 100755 src/Validate.h create mode 100755 src/lib/1wire/1Wire.cpp create mode 100755 src/lib/1wire/1Wire.h create mode 100755 src/lib/Constants.h create mode 100755 src/lib/Macros.h create mode 100755 src/lib/analog/Analog.cpp create mode 100755 src/lib/analog/Analog.h create mode 100755 src/lib/axis/Axis.command.cpp create mode 100755 src/lib/axis/Axis.cpp create mode 100755 src/lib/axis/Axis.h create mode 100755 src/lib/axis/motor/Drivers.h create mode 100755 src/lib/axis/motor/Motor.cpp create mode 100755 src/lib/axis/motor/Motor.h create mode 100755 src/lib/axis/motor/kTech/KTech.cpp create mode 100755 src/lib/axis/motor/kTech/KTech.h create mode 100755 src/lib/axis/motor/mksServo/MksServo.cpp create mode 100755 src/lib/axis/motor/mksServo/MksServo.h create mode 100755 src/lib/axis/motor/oDrive/ODrive.cpp create mode 100755 src/lib/axis/motor/oDrive/ODrive.h create mode 100755 src/lib/axis/motor/oDrive/ODriveCanPlus.cpp create mode 100755 src/lib/axis/motor/oDrive/ODriveCanPlus.h create mode 100755 src/lib/axis/motor/oDrive/ODriveNew.cpp create mode 100755 src/lib/axis/motor/oDrive/ODriveNew.h create mode 100755 src/lib/axis/motor/servo/Servo.cpp create mode 100755 src/lib/axis/motor/servo/Servo.h create mode 100755 src/lib/axis/motor/servo/ServoDriver.cpp create mode 100755 src/lib/axis/motor/servo/ServoDriver.h create mode 100755 src/lib/axis/motor/servo/dc/DcServoDriver.cpp create mode 100755 src/lib/axis/motor/servo/dc/DcServoDriver.h create mode 100755 src/lib/axis/motor/servo/dc/calibration/TrackingVelocity.cpp create mode 100755 src/lib/axis/motor/servo/dc/calibration/TrackingVelocity.h create mode 100755 src/lib/axis/motor/servo/dc/eE/EE.cpp create mode 100755 src/lib/axis/motor/servo/dc/eE/EE.h create mode 100755 src/lib/axis/motor/servo/dc/pE/PE.cpp create mode 100755 src/lib/axis/motor/servo/dc/pE/PE.h create mode 100755 src/lib/axis/motor/servo/dc/tmc/tmc2130/Tmc2130.cpp create mode 100755 src/lib/axis/motor/servo/dc/tmc/tmc2130/Tmc2130.h create mode 100755 src/lib/axis/motor/servo/dc/tmc/tmc5160/Tmc5160.cpp create mode 100755 src/lib/axis/motor/servo/dc/tmc/tmc5160/Tmc5160.h create mode 100755 src/lib/axis/motor/servo/feedback/DualPid/DualPid.cpp create mode 100755 src/lib/axis/motor/servo/feedback/DualPid/DualPid.h create mode 100755 src/lib/axis/motor/servo/feedback/Feedback.h create mode 100755 src/lib/axis/motor/servo/feedback/FeedbackBase.cpp create mode 100755 src/lib/axis/motor/servo/feedback/FeedbackBase.h create mode 100755 src/lib/axis/motor/servo/feedback/Pid/Pid.cpp create mode 100755 src/lib/axis/motor/servo/feedback/Pid/Pid.h create mode 100755 src/lib/axis/motor/servo/filter/Filter.h create mode 100755 src/lib/axis/motor/servo/filter/FilterBase.cpp create mode 100755 src/lib/axis/motor/servo/filter/FilterBase.h create mode 100755 src/lib/axis/motor/servo/filter/Kalman/Kalman.cpp create mode 100755 src/lib/axis/motor/servo/filter/Kalman/Kalman.h create mode 100755 src/lib/axis/motor/servo/filter/Learning/Learning.cpp create mode 100755 src/lib/axis/motor/servo/filter/Learning/Learning.h create mode 100755 src/lib/axis/motor/servo/filter/Rolling/Rolling.cpp create mode 100755 src/lib/axis/motor/servo/filter/Rolling/Rolling.h create mode 100755 src/lib/axis/motor/servo/kTech/KTech.cpp create mode 100755 src/lib/axis/motor/servo/kTech/KTech.h create mode 100755 src/lib/axis/motor/servo/tmc/TmcServoDriver.cpp create mode 100755 src/lib/axis/motor/servo/tmc/TmcServoDriver.h create mode 100755 src/lib/axis/motor/servo/tmc/tmc2209/Tmc2209.cpp create mode 100755 src/lib/axis/motor/servo/tmc/tmc2209/Tmc2209.h create mode 100755 src/lib/axis/motor/servo/tmc/tmc5160/Tmc5160.cpp create mode 100755 src/lib/axis/motor/servo/tmc/tmc5160/Tmc5160.h create mode 100755 src/lib/axis/motor/stepDir/StepDir.cpp create mode 100755 src/lib/axis/motor/stepDir/StepDir.h create mode 100755 src/lib/axis/motor/stepDir/StepDirDriver.cpp create mode 100755 src/lib/axis/motor/stepDir/StepDirDriver.h create mode 100755 src/lib/axis/motor/stepDir/generic/Generic.cpp create mode 100755 src/lib/axis/motor/stepDir/generic/Generic.h create mode 100755 src/lib/axis/motor/stepDir/tmc/TmcStepDirDriver.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/TmcStepDirDriver.h create mode 100755 src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverNSG.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverNSG.h create mode 100755 src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverSG.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverSG.h create mode 100755 src/lib/axis/motor/stepDir/tmc/legacy/TmcSPI.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/legacy/TmcSPI.h create mode 100755 src/lib/axis/motor/stepDir/tmc/legacy/tmc2130/Tmc2130.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/legacy/tmc2130/Tmc2130.h create mode 100755 src/lib/axis/motor/stepDir/tmc/legacy/tmc2209/Tmc2209.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/legacy/tmc2209/Tmc2209.h create mode 100755 src/lib/axis/motor/stepDir/tmc/legacy/tmc5160/Tmc5160.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/legacy/tmc5160/Tmc5160.h create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2130/Tmc2130.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2130/Tmc2130.h create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2160/Tmc2160.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2160/Tmc2160.h create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2208/tmc2208.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2208/tmc2208.h create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2209/Tmc2209.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2209/Tmc2209.h create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2660/Tmc2660.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2660/Tmc2660.h create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5160/Tmc5160.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5160/Tmc5160.h create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5161/Tmc5161.cpp create mode 100755 src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5161/Tmc5161.h create mode 100755 src/lib/bluetooth/Bluetooth.defaults.h create mode 100755 src/lib/bluetooth/BluetoothManager.cpp create mode 100755 src/lib/bluetooth/BluetoothManager.h create mode 100755 src/lib/calendars/Calendars.cpp create mode 100755 src/lib/calendars/Calendars.h create mode 100755 src/lib/canPlus/CanPlus.h create mode 100755 src/lib/canPlus/CanPlusBase.cpp create mode 100755 src/lib/canPlus/CanPlusBase.h create mode 100755 src/lib/canPlus/esp32/Esp32.cpp create mode 100755 src/lib/canPlus/esp32/Esp32.h create mode 100755 src/lib/canPlus/mcp2515/Mcp2515.cpp create mode 100755 src/lib/canPlus/mcp2515/Mcp2515.h create mode 100755 src/lib/canPlus/san/San.cpp create mode 100755 src/lib/canPlus/san/San.h create mode 100755 src/lib/canPlus/teensy4/Can0.cpp create mode 100755 src/lib/canPlus/teensy4/Can0.h create mode 100755 src/lib/canPlus/teensy4/Can1.cpp create mode 100755 src/lib/canPlus/teensy4/Can1.h create mode 100755 src/lib/canPlus/teensy4/Can2.cpp create mode 100755 src/lib/canPlus/teensy4/Can2.h create mode 100755 src/lib/canPlus/teensy4/Can3.cpp create mode 100755 src/lib/canPlus/teensy4/Can3.h create mode 100755 src/lib/canTransport/CanTransportBase.cpp create mode 100755 src/lib/canTransport/CanTransportBase.h create mode 100755 src/lib/canTransport/CanTransportClient.cpp create mode 100755 src/lib/canTransport/CanTransportClient.h create mode 100755 src/lib/canTransport/CanTransportServer.cpp create mode 100755 src/lib/canTransport/CanTransportServer.h create mode 100755 src/lib/commands/BufferCmds.cpp create mode 100755 src/lib/commands/BufferCmds.h create mode 100755 src/lib/commands/CommandErrors.h create mode 100755 src/lib/commands/SerialWrapper.cpp create mode 100755 src/lib/commands/SerialWrapper.h create mode 100755 src/lib/commands/commands.ino create mode 100755 src/lib/convert/Convert.cpp create mode 100755 src/lib/convert/Convert.h create mode 100755 src/lib/debug/Debug.cpp create mode 100755 src/lib/debug/Debug.h create mode 100755 src/lib/encoder/Encoder.h create mode 100755 src/lib/encoder/EncoderBase.cpp create mode 100755 src/lib/encoder/EncoderBase.h create mode 100755 src/lib/encoder/bissc/As37h39bb.cpp create mode 100755 src/lib/encoder/bissc/As37h39bb.h create mode 100755 src/lib/encoder/bissc/Asc85.cpp create mode 100755 src/lib/encoder/bissc/Asc85.h create mode 100755 src/lib/encoder/bissc/Bissc.cpp create mode 100755 src/lib/encoder/bissc/Bissc.h create mode 100755 src/lib/encoder/bissc/Jtw24.cpp create mode 100755 src/lib/encoder/bissc/Jtw24.h create mode 100755 src/lib/encoder/bissc/Jtw26.cpp create mode 100755 src/lib/encoder/bissc/Jtw26.h create mode 100755 src/lib/encoder/cwCcw/CwCcw.cpp create mode 100755 src/lib/encoder/cwCcw/CwCcw.h create mode 100755 src/lib/encoder/ktech/KTech.cpp create mode 100755 src/lib/encoder/ktech/KTech.h create mode 100755 src/lib/encoder/pulseDir/PulseDir.cpp create mode 100755 src/lib/encoder/pulseDir/PulseDir.h create mode 100755 src/lib/encoder/pulseOnly/PulseOnly.cpp create mode 100755 src/lib/encoder/pulseOnly/PulseOnly.h create mode 100755 src/lib/encoder/quadrature/Quadrature.cpp create mode 100755 src/lib/encoder/quadrature/Quadrature.h create mode 100755 src/lib/encoder/quadratureEsp32/QuadratureEsp32.cpp create mode 100755 src/lib/encoder/quadratureEsp32/QuadratureEsp32.h create mode 100755 src/lib/encoder/serialBridge/SerialBridge.cpp create mode 100755 src/lib/encoder/serialBridge/SerialBridge.h create mode 100755 src/lib/encoder/virtualEnc/VirtualEnc.cpp create mode 100755 src/lib/encoder/virtualEnc/VirtualEnc.h create mode 100755 src/lib/ethernet/EthernetManager.cpp create mode 100755 src/lib/ethernet/EthernetManager.defaults.h create mode 100755 src/lib/ethernet/EthernetManager.h create mode 100755 src/lib/ethernet/cmdServer/CmdServer.cpp create mode 100755 src/lib/ethernet/cmdServer/CmdServer.h create mode 100755 src/lib/ethernet/webServer/WebServer.cpp create mode 100755 src/lib/ethernet/webServer/WebServer.h create mode 100755 src/lib/gpioEx/GpioBase.cpp create mode 100755 src/lib/gpioEx/GpioBase.h create mode 100755 src/lib/gpioEx/GpioEx.h create mode 100755 src/lib/gpioEx/ds2413/Ds2413.cpp create mode 100755 src/lib/gpioEx/ds2413/Ds2413.h create mode 100755 src/lib/gpioEx/mcp23008/Mcp23008.cpp create mode 100755 src/lib/gpioEx/mcp23008/Mcp23008.h create mode 100755 src/lib/gpioEx/mcp23017/Mcp23017.cpp create mode 100755 src/lib/gpioEx/mcp23017/Mcp23017.h create mode 100755 src/lib/gpioEx/pcf8574/Pcf8574.cpp create mode 100755 src/lib/gpioEx/pcf8574/Pcf8574.h create mode 100755 src/lib/gpioEx/pcf8575/Pcf8575.cpp create mode 100755 src/lib/gpioEx/pcf8575/Pcf8575.h create mode 100755 src/lib/gpioEx/ssr74HC595/Ssr74HC595.cpp create mode 100755 src/lib/gpioEx/ssr74HC595/Ssr74HC595.h create mode 100755 src/lib/gpioEx/sws/Sws.cpp create mode 100755 src/lib/gpioEx/sws/Sws.h create mode 100755 src/lib/gpioEx/tca9555/Tca9555.cpp create mode 100755 src/lib/gpioEx/tca9555/Tca9555.h create mode 100755 src/lib/math/Crc.cpp create mode 100755 src/lib/math/Crc.h create mode 100755 src/lib/nv/Nv.cpp create mode 100755 src/lib/nv/Nv.h create mode 100755 src/lib/nv/NvConfig.h create mode 100755 src/lib/nv/NvIvPartition.cpp create mode 100755 src/lib/nv/NvIvPartition.h create mode 100755 src/lib/nv/NvKvPartition16.cpp create mode 100755 src/lib/nv/NvKvPartition16.h create mode 100755 src/lib/nv/NvKvPartition32.cpp create mode 100755 src/lib/nv/NvKvPartition32.h create mode 100755 src/lib/nv/NvVolume.cpp create mode 100755 src/lib/nv/NvVolume.h create mode 100755 src/lib/nv/device/24xxI2C.h create mode 100755 src/lib/nv/device/DeviceNull.h create mode 100755 src/lib/nv/device/EepromArduino.h create mode 100755 src/lib/nv/device/EepromEmuEsp.h create mode 100755 src/lib/nv/device/EepromEmuM0.h create mode 100755 src/lib/nv/device/Mb85rcI2C.h create mode 100755 src/lib/nv/device/NvDeviceBase.h create mode 100755 src/lib/nv/device/ShimCached.h create mode 100755 src/lib/nv/device/ShimDelayedCommit.h create mode 100755 src/lib/pushButton/PushButton.cpp create mode 100755 src/lib/pushButton/PushButton.h create mode 100755 src/lib/sense/Sense.cpp create mode 100755 src/lib/sense/Sense.h create mode 100755 src/lib/serial/Serial_IP_Ethernet.cpp create mode 100755 src/lib/serial/Serial_IP_Ethernet.h create mode 100755 src/lib/serial/Serial_IP_Ethernet_Client.cpp create mode 100755 src/lib/serial/Serial_IP_Ethernet_Client.h create mode 100755 src/lib/serial/Serial_IP_Wifi.cpp create mode 100755 src/lib/serial/Serial_IP_Wifi.h create mode 100755 src/lib/serial/Serial_IP_Wifi_Client.cpp create mode 100755 src/lib/serial/Serial_IP_Wifi_Client.h create mode 100755 src/lib/serial/Serial_Local.cpp create mode 100755 src/lib/serial/Serial_Local.h create mode 100755 src/lib/serial/Serial_MEGA2560.cpp create mode 100755 src/lib/serial/Serial_MEGA2560.h create mode 100755 src/lib/serial/Serial_ST4_Master.cpp create mode 100755 src/lib/serial/Serial_ST4_Master.h create mode 100755 src/lib/serial/Serial_ST4_Slave.cpp create mode 100755 src/lib/serial/Serial_ST4_Slave.h create mode 100755 src/lib/softSpi/Pins.h create mode 100755 src/lib/softSpi/SoftSpi.cpp create mode 100755 src/lib/softSpi/SoftSpi.h create mode 100755 src/lib/sound/Sound.cpp create mode 100755 src/lib/sound/Sound.h create mode 100755 src/lib/tasks/HAL_ATMEGA328_HWTIMER.h create mode 100755 src/lib/tasks/HAL_EMPTY_HWTIMER.h create mode 100755 src/lib/tasks/HAL_ESP32_HWTIMER.h create mode 100755 src/lib/tasks/HAL_ESP32_V3_HWTIMER.h create mode 100755 src/lib/tasks/HAL_HWTIMERS.h create mode 100755 src/lib/tasks/HAL_MEGA2560_HWTIMER.h create mode 100755 src/lib/tasks/HAL_PROFILER.h create mode 100755 src/lib/tasks/HAL_STM32_HWTIMER.h create mode 100755 src/lib/tasks/HAL_TEENSY_HWTIMER.h create mode 100755 src/lib/tasks/OnTask.cpp create mode 100755 src/lib/tasks/OnTask.h create mode 100755 src/lib/tasks/OnTaskExample.ino.txt create mode 100755 src/lib/tls/PPS.cpp create mode 100755 src/lib/tls/PPS.h create mode 100755 src/lib/tls/Tls.h create mode 100755 src/lib/tls/TlsBase.cpp create mode 100755 src/lib/tls/TlsBase.h create mode 100755 src/lib/tls/ds3231/DS3231.cpp create mode 100755 src/lib/tls/ds3231/DS3231.h create mode 100755 src/lib/tls/ds3234/DS3234.cpp create mode 100755 src/lib/tls/ds3234/DS3234.h create mode 100755 src/lib/tls/gps/GPS.cpp create mode 100755 src/lib/tls/gps/GPS.h create mode 100755 src/lib/tls/ntp/NTP.cpp create mode 100755 src/lib/tls/ntp/NTP.h create mode 100755 src/lib/tls/sd3031/SD3031.cpp create mode 100755 src/lib/tls/sd3031/SD3031.h create mode 100755 src/lib/tls/teensy/Teensy.cpp create mode 100755 src/lib/tls/teensy/Teensy.h create mode 100755 src/lib/watchdog/Watchdog.cpp create mode 100755 src/lib/watchdog/Watchdog.h create mode 100755 src/lib/wifi/WifiManager.cpp create mode 100755 src/lib/wifi/WifiManager.defaults.h create mode 100755 src/lib/wifi/WifiManager.h create mode 100755 src/lib/wifi/cmdServer/CmdServer.cpp create mode 100755 src/lib/wifi/cmdServer/CmdServer.h create mode 100755 src/lib/wifi/webServer/WebServer.cpp create mode 100755 src/lib/wifi/webServer/WebServer.h create mode 100755 src/libApp/commands/CommandBroker.cpp create mode 100755 src/libApp/commands/CommandBroker.h create mode 100755 src/libApp/commands/ProcessCmds.cpp create mode 100755 src/libApp/commands/ProcessCmds.h create mode 100755 src/libApp/temperature/Ds1820.cpp create mode 100755 src/libApp/temperature/Ds1820.h create mode 100755 src/libApp/temperature/Temperature.cpp create mode 100755 src/libApp/temperature/Temperature.h create mode 100755 src/libApp/temperature/Thermistor.cpp create mode 100755 src/libApp/temperature/Thermistor.h create mode 100755 src/libApp/weather/Weather.cpp create mode 100755 src/libApp/weather/Weather.h create mode 100755 src/pinmaps/Models.h create mode 100755 src/pinmaps/Pins.CNC3.h create mode 100755 src/pinmaps/Pins.FYSETC_E4.h create mode 100755 src/pinmaps/Pins.FYSETC_S6.h create mode 100755 src/pinmaps/Pins.JTWPCB2.h create mode 100755 src/pinmaps/Pins.Manticore.h create mode 100755 src/pinmaps/Pins.MaxESP3.h create mode 100755 src/pinmaps/Pins.MaxESP4.h create mode 100755 src/pinmaps/Pins.MaxPCB.h create mode 100755 src/pinmaps/Pins.MaxPCB3.h create mode 100755 src/pinmaps/Pins.MaxPCB36.h create mode 100755 src/pinmaps/Pins.MaxPCB4.h create mode 100755 src/pinmaps/Pins.MaxSTM.h create mode 100755 src/pinmaps/Pins.MicroScope.h create mode 100755 src/pinmaps/Pins.MiniPCB.h create mode 100755 src/pinmaps/Pins.OctopusPro.h create mode 100755 src/pinmaps/Pins.SAL_XB1.h create mode 100755 src/pinmaps/Pins.SKR_PRO.h create mode 100755 src/pinmaps/Pins.STM32B.h create mode 100755 src/pinmaps/Pins.defaults.h create mode 100755 src/pinmaps/Validate.h create mode 100755 src/telescope/Telescope.command.cpp create mode 100755 src/telescope/Telescope.cpp create mode 100755 src/telescope/Telescope.h create mode 100755 src/telescope/addonFlasher/AddonFlasher.cpp create mode 100755 src/telescope/addonFlasher/AddonFlasher.h create mode 100755 src/telescope/auxiliary/Features.h create mode 100755 src/telescope/auxiliary/FeaturesBase.h create mode 100755 src/telescope/auxiliary/dewHeater/DewHeater.cpp create mode 100755 src/telescope/auxiliary/dewHeater/DewHeater.h create mode 100755 src/telescope/auxiliary/intervalometer/Intervalometer.cpp create mode 100755 src/telescope/auxiliary/intervalometer/Intervalometer.h create mode 100755 src/telescope/auxiliary/local/Features.can.command.cpp create mode 100755 src/telescope/auxiliary/local/Features.command.cpp create mode 100755 src/telescope/auxiliary/local/Features.cpp create mode 100755 src/telescope/auxiliary/local/Features.h create mode 100755 src/telescope/auxiliary/powerMonitor/PowerMonitor.cpp create mode 100755 src/telescope/auxiliary/powerMonitor/PowerMonitor.h create mode 100755 src/telescope/auxiliary/remote/Features.can.decode.cpp create mode 100755 src/telescope/auxiliary/remote/Features.can.encode.cpp create mode 100755 src/telescope/auxiliary/remote/Features.cpp create mode 100755 src/telescope/auxiliary/remote/Features.h create mode 100755 src/telescope/focuser/Focuser.h create mode 100755 src/telescope/focuser/FocuserBase.h create mode 100755 src/telescope/focuser/local/Focuser.axis.prototype.cpp create mode 100755 src/telescope/focuser/local/Focuser.axis4.cpp create mode 100755 src/telescope/focuser/local/Focuser.axis5.cpp create mode 100755 src/telescope/focuser/local/Focuser.axis6.cpp create mode 100755 src/telescope/focuser/local/Focuser.axis7.cpp create mode 100755 src/telescope/focuser/local/Focuser.axis8.cpp create mode 100755 src/telescope/focuser/local/Focuser.axis9.cpp create mode 100755 src/telescope/focuser/local/Focuser.can.command.cpp create mode 100755 src/telescope/focuser/local/Focuser.command.cpp create mode 100755 src/telescope/focuser/local/Focuser.cpp create mode 100755 src/telescope/focuser/local/Focuser.h create mode 100755 src/telescope/focuser/remote/Focuser.can.decode.cpp create mode 100755 src/telescope/focuser/remote/Focuser.can.encode.cpp create mode 100755 src/telescope/focuser/remote/Focuser.cpp create mode 100755 src/telescope/focuser/remote/Focuser.h create mode 100755 src/telescope/mount/Mount.axis.cpp create mode 100755 src/telescope/mount/Mount.command.cpp create mode 100755 src/telescope/mount/Mount.cpp create mode 100755 src/telescope/mount/Mount.h create mode 100755 src/telescope/mount/coordinates/Align.hs.cpp create mode 100755 src/telescope/mount/coordinates/Align.hs.h create mode 100755 src/telescope/mount/coordinates/Align.ref.cpp create mode 100755 src/telescope/mount/coordinates/Align.ref.h create mode 100755 src/telescope/mount/coordinates/Transform.cpp create mode 100755 src/telescope/mount/coordinates/Transform.h create mode 100755 src/telescope/mount/coordinates/coordinates.ino create mode 100755 src/telescope/mount/goto/Goto.command.cpp create mode 100755 src/telescope/mount/goto/Goto.cpp create mode 100755 src/telescope/mount/goto/Goto.h create mode 100755 src/telescope/mount/guide/Guide.command.cpp create mode 100755 src/telescope/mount/guide/Guide.cpp create mode 100755 src/telescope/mount/guide/Guide.h create mode 100755 src/telescope/mount/home/Home.command.cpp create mode 100755 src/telescope/mount/home/Home.cpp create mode 100755 src/telescope/mount/home/Home.h create mode 100755 src/telescope/mount/library/Library.command.cpp create mode 100755 src/telescope/mount/library/Library.cpp create mode 100755 src/telescope/mount/library/Library.h create mode 100755 src/telescope/mount/limits/Limits.command.cpp create mode 100755 src/telescope/mount/limits/Limits.cpp create mode 100755 src/telescope/mount/limits/Limits.h create mode 100755 src/telescope/mount/park/Park.command.cpp create mode 100755 src/telescope/mount/park/Park.cpp create mode 100755 src/telescope/mount/park/Park.h create mode 100755 src/telescope/mount/pec/Pec.command.cpp create mode 100755 src/telescope/mount/pec/Pec.cpp create mode 100755 src/telescope/mount/pec/Pec.h create mode 100755 src/telescope/mount/site/Site.command.cpp create mode 100755 src/telescope/mount/site/Site.cpp create mode 100755 src/telescope/mount/site/Site.h create mode 100755 src/telescope/mount/st4/St4.cpp create mode 100755 src/telescope/mount/st4/St4.h create mode 100755 src/telescope/mount/status/Status.command.cpp create mode 100755 src/telescope/mount/status/Status.cpp create mode 100755 src/telescope/mount/status/Status.h create mode 100755 src/telescope/rotator/Rotator.h create mode 100755 src/telescope/rotator/RotatorBase.h create mode 100755 src/telescope/rotator/local/Rotator.axis.cpp create mode 100755 src/telescope/rotator/local/Rotator.can.command.cpp create mode 100755 src/telescope/rotator/local/Rotator.command.cpp create mode 100755 src/telescope/rotator/local/Rotator.cpp create mode 100755 src/telescope/rotator/local/Rotator.h create mode 100755 src/telescope/rotator/remote/Rotator.can.decode.cpp create mode 100755 src/telescope/rotator/remote/Rotator.can.encode.cpp create mode 100755 src/telescope/rotator/remote/Rotator.cpp create mode 100755 src/telescope/rotator/remote/Rotator.h diff --git a/.gitattributes b/.gitattributes new file mode 100755 index 0000000..dfe0770 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,2 @@ +# Auto detect text files and perform LF normalization +* text=auto diff --git a/.gitignore b/.gitignore new file mode 100755 index 0000000..e3ee71a --- /dev/null +++ b/.gitignore @@ -0,0 +1,13 @@ +.vscode/settings.json +*.json +__vm/* +*.vcxproj* +.vs/* +*.sln +Debug/* +Release/* +debug.cfg +esp32.svd +src/plugins/* +debug.svd +z.* diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..eaaae21 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,67 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Project type + +OnStepX is an Arduino sketch ([OnStepX.ino](OnStepX.ino)) — not a CMake / PlatformIO / Makefile project. There is no `platformio.ini`. Builds happen in the Arduino IDE or via `arduino-cli`. The MCU target is selected by which board the user picks in their IDE; the code adapts via the HAL. + +There is no test suite, no linter config, and no CI. "Build" means "compile this sketch for the target board." When asked to verify a change, the realistic checks are: +- Read the relevant `Config.defaults.h` and `Validate.h` sections to confirm the change passes preprocessor validation. +- For deeper checks, run `arduino-cli compile --fqbn .` from the repo root if `arduino-cli` is available. + +## Configuration is preprocessor-driven + +User-editable controller configuration lives in three header files at the project root or in `src/plugins/`: + +- [Config.h](Config.h) — the main per-installation config: pinmap, mount type, axis drivers, steps/degree, serial baud, WiFi/BT, etc. This file *will* differ between installations and is edited by the end user. Do not "tidy" it. +- [Extended.config.h](Extended.config.h) — debug/NV-wipe and other infrequently-changed knobs. +- [src/plugins/Plugins.config.h](src/plugins/Plugins.config.h) — enables PLUGIN1..PLUGIN8. + +Defaults live in [src/Config.defaults.h](src/Config.defaults.h); every option `Config.h` does not set is filled in there. Validation rules live in [src/Validate.h](src/Validate.h) — `#error` and `#warning` directives there are the closest thing to a type system this codebase has. When adding a new config option, add the default AND a validation rule. + +`#define FirmwareVersionConfig` in `OnStepX.ino` is bumped whenever `Config.h`'s structure changes; mismatches trigger a `#error` in `Validate.h`. + +`src/plugins/*` is gitignored (except the `sample/` dir). Plugin code is expected to be dropped into that directory by the user. + +## Big picture: HAL → pinmap → Telescope → subsystems + +`OnStepX.ino` is intentionally tiny. It calls `HAL_INIT()`, brings up NV, starts the cooperative task scheduler, instantiates one global `Telescope telescope;`, and registers command channels. Everything else is driven from there. + +Layers, from bottom up: + +1. **HAL** ([src/HAL/](src/HAL/)): one subdirectory per MCU family (`atmel`, `esp`, `stm32`, `teensy`, `mbed`, `arduinoM0`, `default`). `HAL.h` does compile-time `#if defined(__AVR_…)` / `defined(ESP32)` / etc. selection and pulls in the right per-MCU header, which provides `HAL_INIT()`, `HAL_TEMP()`, fast-tick macros, and analog wrappers. Adding a new MCU means adding a HAL subfolder and a branch in `src/HAL/HAL.h`. +2. **Pinmap** ([src/pinmaps/](src/pinmaps/)): `Pins.*.h` per board. The user picks one via `#define PINMAP ` in `Config.h`; [src/pinmaps/Models.h](src/pinmaps/Models.h) maps that to the include. `Pins.defaults.h` fills in anything the chosen pinmap omits. If `PINMAP == OFF`, the user is expected to define `AXIS*_STEP_PIN` etc. directly in `Config.h` (see the user's current config for an example). +3. **Generic libraries** ([src/lib/](src/lib/)): hardware-independent building blocks — `tasks/` (cooperative scheduler, see below), `axis/` (motion control, motor abstraction), `nv/` (non-volatile storage over EEPROM/FRAM/Flash), `commands/` (parser + buffer), plus transports: `serial/`, `bluetooth/`, `wifi/`, `ethernet/`, `canPlus/`, `canTransport/`, and peripherals: `analog/`, `sense/`, `gpioEx/`, `tls/` (time/location source), `encoder/`, `softSpi/`, `convert/`, `math/`, `calendars/`. +4. **App-level shared services** ([src/libApp/](src/libApp/)): `commands/` (the `ProcessCmds` command channel processor and `CommandBroker` for cross-channel request/reply), `weather/`, `temperature/`. +5. **Telescope domain** ([src/telescope/](src/telescope/)): `Telescope.cpp` owns the global object; subdirs implement the four optional subsystems: `mount/`, `rotator/`, `focuser/`, `auxiliary/`. Whether each is compiled in is controlled by `*_PRESENT` macros derived in [src/Common.h](src/Common.h) from the driver-model and feature-purpose settings in `Config.h`. + +A request typically flows: serial/IP byte stream → `CommandProcessor::poll()` ([src/libApp/commands/ProcessCmds.cpp](src/libApp/commands/ProcessCmds.cpp)) → `telescope.command(...)` → subsystem `*.command.cpp` files. Each subsystem has its own `Foo.command.cpp` that handles its slice of the LX200-style protocol; that's where to look when implementing or modifying a `:XX...#` command. + +## Cooperative scheduler (OnTask) + +There is no RTOS abstraction layer above this — everything that isn't an ISR runs through `tasks` from [src/lib/tasks/OnTask.h](src/lib/tasks/OnTask.h). New periodic work is added with `tasks.add(periodMs, durationMs, repeat, priority, function, name)`. Long-running code inside a task must call `tasks.yield()` (or the `Y;` macro) so the scheduler can run higher-priority work — including the step-pulse generator. This is critical: blocking inside a task starves stepper output. + +The main `loop()` is just `tasks.yield();`. + +## Command protocol + +The canonical reference for the wire protocol is [docs/COMMAND_REFERENCE.md](docs/COMMAND_REFERENCE.md), and it's explicitly derived from the current `*.command.cpp` files — if behavior and the older OnStep wiki disagree, the code wins. Frame format: `:CC...#` (plain) or `;CC...CCS#` (with checksum). Error codes returned by `:GE#` are listed in that doc. + +Many commands are compile-time-gated by feature defines. Code under `#ifdef MOUNT_PRESENT`, `#ifdef FOCUSER_PRESENT`, etc. only exists when the corresponding axes/drivers are configured. + +## Subsystem docs (read these before changing related code) + +The `docs/` directory holds the design notes that aren't otherwise discoverable from the code: + +- [COMMAND_REFERENCE.md](docs/COMMAND_REFERENCE.md) — wire protocol. +- [STARTUP_AUTHORITY_NOTES.md](docs/STARTUP_AUTHORITY_NOTES.md) — when the mount trusts its coordinate basis enough to allow goto/sync/park. Important: gating logic here affects nearly every motion command. +- [GOTO_NOTES.md](docs/GOTO_NOTES.md), [HOMING_NOTES.md](docs/HOMING_NOTES.md), [PEC_NOTES.md](docs/PEC_NOTES.md), [SENSING_NOTES.md](docs/SENSING_NOTES.md) — subsystem-specific design notes. +- [SERIAL_NOTES.md](docs/SERIAL_NOTES.md) — three-layer model (platform / pinmap / feature) for understanding why a serial transport may "exist but not work" on a given board. +- [SERVO_SETUP.md](docs/SERVO_SETUP.md), [CAN_NOTES.md](docs/CAN_NOTES.md) — motor and transport specifics. + +## Conventions + +- Each subsystem follows the pattern `Foo.h` / `Foo.cpp` for state, `Foo.command.cpp` for the command handler, optionally `Foo.can.command.cpp` / `Foo.can.encode.cpp` / `Foo.can.decode.cpp` for the CAN-bus remote-control variant of the same surface. +- Logging uses the `V…` / `D…` macros from `src/lib/debug/Debug.h` (e.g. `VLF`, `VF`, `DLF`). Output is gated by the `DEBUG` setting in `Extended.config.h` and goes to `SERIAL_DEBUG`. Don't add raw `Serial.print` — use the macros so debug output can be compiled out. +- Commit messages follow the brief, lowercase-prefixed style shown by `git log --date=short --pretty=format:"%h %ad %<(20)%an %<(150,trunc)%s"` (per [README.md](README.md)). diff --git a/Config.h b/Config.h new file mode 100755 index 0000000..9a04671 --- /dev/null +++ b/Config.h @@ -0,0 +1,400 @@ +/* --------------------------------------------------------------------------------------------------------------------------------- + * Configuration for OnStepX + * + * For more information on setting OnStep up see http://www.stellarjourney.com/index.php?r=site/equipment_onstep + * and join the OnStep Groups.io at https://groups.io/g/onstep + * + * *** Read the compiler warnings and errors, they are there to help guard against invalid configurations *** + * + * --------------------------------------------------------------------------------------------------------------------------------- + * ADJUST THE FOLLOWING TO CONFIGURE YOUR CONTROLLER FEATURES ---------------------------------------------------------------------- + * <-Req'd = always must set, <-Often = usually must set, Option = optional, Adjust = adjust as req'd, Infreq = infrequently changed +*/ +// Parameter Name Value Default Notes Hint + +// ================================================================================================================================= +// CONTROLLER ====================================================================================================================== +#define HOST_NAME "OnStep" // nStep", Hostname for this device up to 16 chars. Adjust + + +#define HOST_NAME "OnStep" + +#define AXIS1_STEP_PIN 14 +#define AXIS1_DIR_PIN 12 + +#define AXIS2_STEP_PIN 27 +#define AXIS2_DIR_PIN 26 + +#define SHARED_ENABLE_PIN 25 // Közös láb, ahogy gyárilag tervezték! +#define STATUS_LED_PIN 2 + +// PINMAP ------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Controller#PINMAP +#define PINMAP OFF // OFF, Choose from: MiniPCB, MiniPCB2, MaxPCB4, MaxESP4, MaxSTM3, FYSETC_E4, <-Req'd + // BTT_SKR_PRO, etc. Other boards and more info. in ~/src/Constants.h + +// SERIAL PORT COMMAND CHANNELS --------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Controller#SERIAL_PORTS +#define SERIAL_A_BAUD_DEFAULT 57600 // 9600, n. Where n=9600,19200,57600,115200,230400,460800 (common baud rates.) Infreq +#define SERIAL_B_BAUD_DEFAULT OFF // 9600, n. Baud rate as above. See (src/pinmaps/) for Serial port assignments. Infreq +#define SERIAL_B_ESP_FLASHING OFF // OFF, ON Upload ESP8266 WiFi firmware through SERIAL_B with :ESPFLASH# cmd. Option +#define SERIAL_C_BAUD_DEFAULT OFF // OFF, n. Baud rate as above. See (src/pinmaps/) for Serial port assignments. Infreq +#define SERIAL_D_BAUD_DEFAULT OFF // OFF, n. Baud rate as above. See (src/pinmaps/) for Serial port assignments. Infreq +#define SERIAL_E_BAUD_DEFAULT OFF // OFF, n. Baud rate as above. See (src/pinmaps/) for Serial port assignments. Infreq +#define SERIAL_RADIO WIFI_ACCESS_POINT // OFF, Use BLUETOOTH or WIFI_ACCESS_POINT or WIFI_STATION (ESP32 only.) Option + +// STATUS --------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Controller#STATUS_LED +#define STATUS_LED ON // OFF, Steady illumination if no error, blinks w/error code otherwise. Option + +// RETICLE CONTROL ------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Controller#RETICLE_CONTROL +#define RETICLE_LED_DEFAULT OFF // OFF, n. Where n=0..255 (0..100%) activates feature sets default brightness. Option +#define RETICLE_LED_MEMORY OFF // OFF, ON Remember reticle brightness across power cycles. Option +#define RETICLE_LED_INVERT OFF // OFF, ON Inverts control for cases where 0V is max brightness. Option + +// WEATHER SENSOR --------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Controller#WEATHER_SENSOR +#define WEATHER OFF // OFF, BME280 (I2C 0x77,) BME280_0x76, BME280_SPI (see pinmap for CS.) Option + // BMP280 (I2C 0x77,) BMP280_0x76, BMP280_SPI (see pinmap for CS.) + // BME280 or BMP280 for temperature, pressure. BME280 for humidity also. + +// SIGNALING ------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Controller#SIGNALING +#define STEP_WAVE_FORM SQUARE // SQUARE, PULSE Step signal wave form faster rates. SQUARE best signal integrity. Adjust + // Applies to all axes. + +// NON-VOLATILE MEMORY ---------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Controller#NV +#define NV_DRIVER NV_DEFAULT // NV_DEF, Use platforms default non-volatile device to remember runtime settings. Option + +// ================================================================================================================================= +// MOUNT =========================================================================================================================== + +// Driver models (Step/Dir and Servo) many have specific requirements so be sure to follow the link below to help learn about these. +// Typically: A4988, DRV8825, LV8729, S109, TMC2130, TMC5160, TMC2209, etc. + +// AXIS1 RA/AZM -------------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Axes +#define AXIS1_DRIVER_MODEL TMC2209S // OFF, Enter motor driver model (above) in both axes to activate the mount. <-Often + +// If runtime axis settings are enabled changes in the section below will be ignored (disable in SWS or by wiping NV/EEPROM): +// \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ +#define AXIS1_STEPS_PER_DEGREE 3582.2 // 12800, n. Number of steps per degree: <-Req'd + // n = (stepper_steps * micro_steps * overall_gear_reduction)/360.0 +#define AXIS1_REVERSE OFF // OFF, ON Reverses movement direction, or reverse wiring instead to correct. <-Often +#define AXIS1_LIMIT_MIN -180 // -180, n. Where n= -90..-360 (degrees.) Minimum "Hour Angle" or Azimuth. Adjust +#define AXIS1_LIMIT_MAX 180 // 180, n. Where n= 90.. 360 (degrees.) Maximum "Hour Angle" or Azimuth. Adjust +#define AXIS1_LIMIT_SYNC OFF // OFF, n. Where n= 0..90 (degrees.) Allow sync/reset only within this +/-range. Option + +#define AXIS1_DRIVER_MICROSTEPS 16 // OFF, n. Microstep mode when tracking. <-Req'd +#define AXIS1_DRIVER_MICROSTEPS_GOTO 4 // OFF, n. Microstep mode used during slews. OFF uses _DRIVER_MICROSTEPS. Option + +// for TMC2130, TMC5160, TMC2209, TMC2226 STEP/DIR driver models: +#define AXIS1_DRIVER_IHOLD OFF // OFF, n, (mA.) Current during standstill. OFF uses IRUN/2.0 Option +#define AXIS1_DRIVER_IRUN OFF // OFF, n, (mA.) Current during tracking, appropriate for stepper/driver/etc. Option +#define AXIS1_DRIVER_IGOTO OFF // OFF, n, (mA.) Current during slews. OFF uses IRUN. Option +// /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ / + +#define AXIS1_DRIVER_STATUS OFF // OFF, ON, HIGH, or LOW. For driver status info/fault detection. Option + +#define AXIS1_DRIVER_DECAY OFF // OFF, Tracking decay mode default override. TMC default is STEALTHCHOP. Infreq +#define AXIS1_DRIVER_DECAY_GOTO OFF // OFF, Decay mode goto default override. TMC default is SPREADCYCLE. Infreq + +#define AXIS1_POWER_DOWN OFF // OFF, ON Powers off 30sec after movement stops or 10min after last<=1x guide. Infreq + +#define AXIS1_SENSE_HOME OFF // OFF, HIGH or LOW enables & state clockwise home position, as seen from front. Option +#define AXIS1_SENSE_LIMIT_MIN LIMIT_SENSE // ...NSE, HIGH or LOW state on limit sense switch stops movement. Option +#define AXIS1_SENSE_LIMIT_MAX LIMIT_SENSE // ...NSE, HIGH or LOW state on limit sense switch stops movement. Option + // Digital, optionally add: |HYST(n) Where n=0..1023 stability time in ms. + // Analog capable sense inputs also allow adding: + // |THLD(n) Where n=1..1023 (ADU) for Analog threshold. + // |HYST(n) Where n=0..1023 (ADU) for +/- Hystersis range. + +// AXIS2 DEC/ALT ------------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Axes +#define AXIS2_DRIVER_MODEL TMC2209S // OFF, Enter motor driver model (above) in both axes to activate the mount. <-Often + +// If runtime axis settings are enabled changes in the section below will be ignored (disable in SWS or by wiping NV/EEPROM): +// \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ +#define AXIS2_STEPS_PER_DEGREE 3591.1 // 12800, n. Number of steps per degree: <-Req'd + // n = (stepper_steps * micro_steps * overall_gear_reduction)/360.0 +#define AXIS2_REVERSE OFF // OFF, ON Reverses movement direction, or reverse wiring instead to correct. <-Often +#define AXIS2_LIMIT_MIN -90 // -90, n. Where n=-90..0 (degrees.) Minimum allowed Declination or Altitude. Infreq +#define AXIS2_LIMIT_MAX 90 // 90, n. Where n= 0..90 (degrees.) Maximum allowed Declination or Altitude. Infreq +#define AXIS2_LIMIT_SYNC OFF // OFF, n. Where n= 0..90 (degrees.) Allow sync/reset only within this +/-range. Option + +#define AXIS2_DRIVER_MICROSTEPS 16 // OFF, n. Microstep mode when tracking. <-Req'd +#define AXIS2_DRIVER_MICROSTEPS_GOTO OFF // OFF, n. Microstep mode used during slews. OFF uses _DRIVER_MICROSTEPS. Option + +// for TMC2130, TMC5160, TMC2209, TMC2226 STEP/DIR driver models: +#define AXIS2_DRIVER_IHOLD OFF // OFF, n, (mA.) Current during standstill. OFF uses IRUN/2.0 Option +#define AXIS2_DRIVER_IRUN OFF // OFF, n, (mA.) Current during tracking, appropriate for stepper/driver/etc. Option +#define AXIS2_DRIVER_IGOTO OFF // OFF, n, (mA.) Current during slews. OFF uses IRUN. Option +// /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ / + +#define AXIS2_DRIVER_STATUS OFF // OFF, ON, HIGH, or LOW. Polling for driver status info/fault detection. Option + +#define AXIS2_DRIVER_DECAY OFF // OFF, Tracking decay mode default override. TMC default is STEALTHCHOP. Infreq +#define AXIS2_DRIVER_DECAY_GOTO OFF // OFF, Decay mode goto default override. TMC default is SPREADCYCLE. Infreq + +#define AXIS2_POWER_DOWN OFF // OFF, ON Powers off 30sec after movement stops or 10min after last<=1x guide. Option + +#define AXIS2_SENSE_HOME OFF // OFF, HIGH or LOW enables & state clockwise home position, as seen from above. Option +#define AXIS2_SENSE_LIMIT_MIN LIMIT_SENSE // ...NSE, HIGH or LOW state on limit sense switch stops movement. Option +#define AXIS2_SENSE_LIMIT_MAX LIMIT_SENSE // ...NSE, HIGH or LOW state on limit sense switch stops movement. Option + +// MOUNT -------------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Mount#MOUNT +#define MOUNT_TYPE GEM // GEM, GEM German Equatorial Mount, etc. that need meridian flips. <-Req'd + // GEM_TA GEM w/tangent arm Declination + // GEM_TAC GEM w/tangent arm Declination and geometry correction + // FORK Fork Mount + // FORK_TA FORK w/tangent arm Declination + // FORK_TAC FORK w/tangent arm Declination and geometry correction + // ALTAZM Altitude/Azimuth Mount, Dobsonians, etc. + // ALTAZM_UNL ALTAZM w/unlimited Azimuth motion + +#define MOUNT_ALTERNATE_ORIENTATION OFF // OFF, ON Enables Meridian Flips for FORK mounts and passing through the Option + // Zenith for ALTAZM mounts. GEM mode ignores this setting. + +#define MOUNT_STARTUP_MODE SA_AUTO // ..AUTO, SA_STRICT, or SA_PERMISSIVE. Controls when startup trust is granted. Option + // SA_AUTO keeps legacy immediate goto only when no absolute position source + // is present and coordinate memory is OFF. + +#define MOUNT_COORDS TOPOCENTRIC // ...RIC, Applies refraction to coordinates to/from OnStep, except exactly Infreq + // at the poles. Use TOPO_STRICT to apply refraction even in that case. + // Use OBSERVED_PLACE for no refraction. + +#define MOUNT_COORDS_MEMORY OFF // OFF, ON Remembers approximate mount coordinates across power cycles. Option + // Requires FRAM NV memory and the mount must not move while powered down. + +#define MOUNT_ENABLE_IN_STANDBY OFF // OFF, ON Enables mount motor drivers while in standby. Infreq + +// TIME AND LOCATION ---------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Mount#TLS +#define TIME_LOCATION_SOURCE OFF // OFF, DS3231 (I2C,) SD3031 (I2C,) TEENSY (T3.2 etc,) GPS, or NTP source. Option + // Provides Date/Time, and if available, PPS & Lat/Long also. +#define TIME_LOCATION_PPS_SENSE OFF // OFF, HIGH senses PPS (pulse per second,) signal rising edge, or use LOW for Option + // falling edge, or use BOTH for rising and falling edges. + +// STATUS ------------------------------------------------------ see https://onstep.groups.io/g/main/wiki/Configuration_Mount#STATUS +#define STATUS_MOUNT_LED OFF // OFF, ON Flashes proportional to rate of movement or solid on for slews. Option +#define STATUS_BUZZER OFF // OFF, ON, n. Where n=100..6000 (Hz freq.) for speaker. ON for piezo buzzer. Option +#define STATUS_BUZZER_DEFAULT OFF // OFF, ON starts w/buzzer sound enabled. Option +#define STATUS_BUZZER_MEMORY OFF // OFF, ON to remember buzzer sound setting across power cycles. Option + +// ST4 INTERFACE -------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Mount#ST4 +// *** It is up to you to verify the interface meets the electrical specifications of any connected device, use at your own risk *** +#define ST4_INTERFACE OFF // OFF, ON enables interface. <= 1X guides unless hand control mode. Option + // During goto btn press: aborts slew or continue meridian flip pause home +#define ST4_HAND_CONTROL ON // ON, ON for hand controller special features and SHC support. Option + // Hold [E]+[W] btns >2s: Guide rate [E]- [W]+ [N] trk on/off [S] sync + // Hold [N]+[S] btns >2s: Usr cat item [E]- [W]+ [N] goto [S] snd on/off +#define ST4_HAND_CONTROL_FOCUSER ON // ON, ON alternate to above: Focuser move [E]f1 [W]f2 [N]- [S]+ Option + +// GUIDING BEHAVIOUR ------------------------------------------ see https://onstep.groups.io/g/main/wiki/Configuration_Mount#GUIDING +#define GUIDE_TIME_LIMIT 10 // 10, n. Time limit n=0..120 seconds. Use 0 to disable. Adjust +#define GUIDE_DISABLE_BACKLASH OFF // OFF, Disable backlash takeup during guiding at <= 1X. Option + +// LIMITS ------------------------------------------------------ see https://onstep.groups.io/g/main/wiki/Configuration_Mount#LIMITS +#define LIMIT_SENSE OFF // OFF, HIGH or LOW state on limit sense switch stops movement. Option +#define LIMIT_STRICT OFF // OFF, disables limits until unpark goto or sync. ON enables limits at startup. Option + // note that ON also disables all motion until date/time are set. + +// PARKING ---------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Mount#PARKING +#define PARK_SENSE OFF // OFF, HIGH or LOW state indicates mount is in the park orientation. Option +#define PARK_SIGNAL OFF // OFF, HIGH or LOW state park input signal triggers parking. Option +#define PARK_STATUS OFF // OFF, signals with a HIGH or LOW state when successfully parked. Option + +// PEC ------------------------------------------------------------ see https://onstep.groups.io/g/main/wiki/Configuration_Mount#PEC +#define PEC_STEPS_PER_WORM_ROTATION 12800 // 0, n. Steps per worm rotation (0 disables else 720 sec buffer allocated.) <-Req'd + // n = (AXIS1_STEPS_PER_DEGREE*360)/reduction_final_stage + +#define PEC_SENSE OFF // OFF, HIGH. Senses the PEC signal rising edge or use LOW for falling edge. Option + // Ignored in ALTAZM mode. +#define PEC_BUFFER_SIZE_LIMIT 720 // 720, Seconds of PEC buffer allowed. Infreq + +// TRACKING BEHAVIOUR ---------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Mount#TRACKING +#define TRACK_BACKLASH_RATE 20 // 20, n. Where n=2..50 (x sidereal rate) during backlash takeup. Option + // Too fast motors stall/gears slam or too slow and sluggish in backlash. +#define TRACK_AUTOSTART OFF // OFF, ON Start with tracking enabled. Option +#define TRACK_COMPENSATION_DEFAULT OFF // OFF, No compensation or REFRACTION, REFRACTION_DUAL, MODEL, MODEL_DUAL. Option +#define TRACK_COMPENSATION_MEMORY OFF // OFF, ON Remembers refraction/pointing model compensated tracking settings. Option + +// SLEWING BEHAVIOUR ------------------------------------------ see https://onstep.groups.io/g/main/wiki/Configuration_Mount#SLEWING +#define SLEW_RATE_BASE_DESIRED 2.5 // 1.0, n. Desired slew rate in deg/sec. Adjustable at run-time from <-Req'd + // 1/2 to 2x this rate, and as performace considerations require. +#define SLEW_RATE_MEMORY OFF // OFF, ON Remembers rates set across power cycles. Option +#define SLEW_ACCELERATION_DIST 5.0 // 5.0, n, (degrees.) Approx. distance for acceleration (and deceleration.) Adjust +#define SLEW_RAPID_STOP_DIST 2.0 // 2.0, n, (degrees.) Approx. distance required to stop when a slew Adjust + // is aborted or a limit is exceeded. +#define GOTO_FEATURE ON // ON, Use OFF to disable mount Goto features. Infreq +#define GOTO_OFFSET 0.25 // 0.25, Offset in deg's for goto target unidirectional approach, 0.0 disables Adjust +#define GOTO_OFFSET_ALIGN OFF // OFF, ON skips final phase of goto for align stars so user tends to approach Option + // from the correct direction when centering. + +// PIER SIDE BEHAVIOUR --------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Mount#PIERSIDE +#define MFLIP_SKIP_HOME OFF // OFF, ON Goto directly to the destination without visiting home position. Option +#define MFLIP_AUTOMATIC_DEFAULT OFF // OFF, ON Start with automatic meridian flips enabled. Option +#define MFLIP_AUTOMATIC_MEMORY OFF // OFF, ON Remember automatic meridian flip setting across power cycles. Option +#define MFLIP_PAUSE_HOME_DEFAULT OFF // OFF, ON Start with meridian flip pause at home enabed. Infreq +#define MFLIP_PAUSE_HOME_MEMORY OFF // OFF, ON Remember meridian flip pause at home setting across power cycles. Infreq + +#define PIER_SIDE_SYNC_CHANGE_SIDES OFF // OFF, ON Allows sync to change pier side, for GEM mounts. Option +#define PIER_SIDE_PREFERRED_DEFAULT BEST // BEST, BEST Stays on current side if possible. EAST or WEST switch if possible. Option + // AUTOMATIC prefers west nearer the under pole meridian or east otherwise. Option +#define PIER_SIDE_PREFERRED_MEMORY OFF // OFF, ON Remember preferred pier side setting across power cycles. Option + +// ALIGN -------------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Mount#ALIGN +#define ALIGN_AUTO_HOME OFF // OFF, ON uses home switches to find home first when starting an align. Option +#define ALIGN_MODEL_MEMORY OFF // OFF, ON Restores any pointing model saved in NV at startup. Option +#define ALIGN_MAX_STARS AUTO // AUTO, Uses HAL specified default (either 6 or 9 stars.) Infreq + // Or use n. Where n=1 (for Sync only) or 3 to 9 (for Goto Assist.) + +// ================================================================================================================================= +// ROTATOR ========================================================================================================================= + +// Driver models (Step/Dir and Servo) many have specific requirements so be sure to follow the link below to help learn about these. +// Typically: A4988, DRV8825, LV8729, S109, TMC2130S, etc. + +// AXIS3 ROTATOR ---------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Rotator +#define AXIS3_DRIVER_MODEL OFF // OFF, Enter motor driver model (above) to activate the rotator. Option +#define AXIS3_SLEW_RATE_BASE_DESIRED 1.0 // 1.0, n. Desired slew rate in deg/sec. Adjustable at run-time from <-Req'd + // 1/2 to 2x this rate, and as performance considerations require. + +// If runtime axis settings are enabled changes in the section below will be ignored (disable in SWS or by wiping NV/EEPROM): +// \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ +#define AXIS3_STEPS_PER_DEGREE 64.0 // 64.0, n. Number of steps per degree for rotator/de-rotator. Adjust + // Alt/Az de-rotation: n = (num_circumference_pixels * 2)/360, minimum +#define AXIS3_REVERSE OFF // OFF, ON Reverses movement direction, or reverse wiring instead to correct. Option +#define AXIS3_LIMIT_MIN 0 // 0, n. Where n=-360..0 (degrees.) Minimum allowed rotator angle. Infreq +#define AXIS3_LIMIT_MAX 360 // 360, n. Where n=0..360 (degrees.) Maximum allowed rotator angle. Infreq + +#define AXIS3_DRIVER_MICROSTEPS OFF // OFF, n. Microstep mode when tracking. Option +#define AXIS3_DRIVER_MICROSTEPS_GOTO OFF // OFF, n. Microstep mode used during slews. OFF uses _DRIVER_MICROSTEPS. Option + +// for TMC2130, TMC5160, TMC2209, TMC2226 STEP/DIR driver models: +#define AXIS3_DRIVER_IHOLD OFF // OFF, n, (mA.) Current during standstill. OFF uses IRUN/2.0 Option +#define AXIS3_DRIVER_IRUN OFF // OFF, n, (mA.) Current during tracking, appropriate for stepper/driver/etc. Option +#define AXIS3_DRIVER_IGOTO OFF // OFF, n, (mA.) Current during slews. OFF uses IRUN. Option +// /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ / + +#define AXIS3_DRIVER_STATUS OFF // OFF, ON, HIGH, or LOW. For driver status info/fault detection. Option + +#define AXIS3_DRIVER_DECAY OFF // OFF, Tracking decay mode default override. TMC default is STEALTHCHOP. Infreq +#define AXIS3_DRIVER_DECAY_GOTO OFF // OFF, Decay mode goto default override. TMC default is SPREADCYCLE. Infreq + +#define AXIS3_POWER_DOWN OFF // OFF, ON Powers off 30 seconds after movement stops. Option + +#define AXIS3_SENSE_HOME OFF // OFF, HIGH or LOW enables & state clockwise home position, as seen from above. Option +#define AXIS3_SENSE_LIMIT_MIN OFF // OFF, HIGH or LOW state on limit sense switch stops movement. Option +#define AXIS3_SENSE_LIMIT_MAX OFF // OFF, HIGH or LOW state on limit sense switch stops movement. Option + +// ================================================================================================================================= +// FOCUSERS ======================================================================================================================== + +// Driver models (Step/Dir and Servo) many have specific requirements so be sure to follow the link below to help learn about these. +// Typically: A4988, DRV8825, LV8729, S109, TMC2130S, etc. + +// AXIS4 FOCUSER 1 -------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Focuser +#define AXIS4_DRIVER_MODEL OFF // OFF, Enter motor driver model (above) to activate the focuser. Option +#define AXIS4_SLEW_RATE_BASE_DESIRED 500 // 500, n, Where n=200..5000 (um/s.) Adjustable at run-time from <-Req'd + // 1/2 to 2x this rate, and as performance considerations require. +#define AXIS4_SLEW_RATE_MINIMUM 20 // 20, n. Where n=5..200 (um/s.) Minimum microns/second. Adjust + +// If runtime axis settings are enabled changes in the section below will be ignored (disable in SWS or by wiping NV/EEPROM): +// \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ \/ +#define AXIS4_STEPS_PER_MICRON 0.5 // 0.5, n. Steps per micrometer. Figure this out by testing or other means. Adjust +#define AXIS4_REVERSE OFF // OFF, ON Reverses movement direction, or reverse wiring instead to correct. Option +#define AXIS4_LIMIT_MIN 0 // 0, n. Where n=0..500 (millimeters.) Minimum allowed position. Adjust +#define AXIS4_LIMIT_MAX 50 // 50, n. Where n=0..500 (millimeters.) Maximum allowed position. Adjust + +#define AXIS4_DRIVER_MICROSTEPS OFF // OFF, n. Microstep mode when tracking. Option +#define AXIS4_DRIVER_MICROSTEPS_GOTO OFF // OFF, n. Microstep mode used during slews. OFF uses _DRIVER_MICROSTEPS. Option + +// for TMC2130, TMC5160, TMC2209, TMC2226 STEP/DIR driver models: +#define AXIS4_DRIVER_IHOLD OFF // OFF, n, (mA.) Current during standstill. OFF uses IRUN/2.0 Option +#define AXIS4_DRIVER_IRUN OFF // OFF, n, (mA.) Current during tracking, appropriate for stepper/driver/etc. Option +#define AXIS4_DRIVER_IGOTO OFF // OFF, n, (mA.) Current during slews. OFF uses IRUN. Option +// /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ /\ / + +#define AXIS4_DRIVER_STATUS OFF // OFF, ON, HIGH, or LOW. For driver status info/fault detection. Option + +#define AXIS4_DRIVER_DECAY OFF // OFF, Tracking decay mode default override. TMC default is STEALTHCHOP. Infreq +#define AXIS4_DRIVER_DECAY_GOTO OFF // OFF, Decay mode goto default override. TMC default is SPREADCYCLE. Infreq + +#define AXIS4_POWER_DOWN OFF // OFF, ON Powers off 30 seconds after movement stops. Option + +#define AXIS4_SENSE_HOME OFF // OFF, HIGH or LOW enables & state clockwise home position, as seen from above. Option +#define AXIS4_SENSE_LIMIT_MIN OFF // OFF, HIGH or LOW state on limit sense switch stops movement. Option +#define AXIS4_SENSE_LIMIT_MAX OFF // OFF, HIGH or LOW state on limit sense switch stops movement. Option + +// AXIS5 FOCUSER 2 ----------------------------------------------------------------------------------------------------------------- +// Up to 6 focusers can be present (AXIS4 to AXIS9) simply copy the above text for focuser 1 and rename to AXIS5_ for focuser 2, etc + +// FOCUSER TEMPERATURE ---------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Focuser +#define FOCUSER_TEMPERATURE OFF // OFF, THERMISTOR or n. Where n is the ds18b20 s/n for focuser temp. Adjust + +// ================================================================================================================================= +// AUXILIARY FEATURES ============================================================================================================== + +// FEATURES ------------------------------------------------------------- see https://onstep.groups.io/g/main/wiki/Configuration_Aux +// Note: Temporarily set DEBUG mode to VERBOSE and use "FEATURE1_TEMP DS1820" to list the DS18B20 device serial numbers. + +#define FEATURE1_PURPOSE OFF // OFF, SWITCH, MOMENTARY_SWITCH, ANALOG_OUT, DEW_HEATER, INTERVALOMETER. Option +#define FEATURE1_NAME "FEATURE1" // "FE..", Name of feature being controlled. Adjust +#define FEATURE1_TEMP OFF // OFF, THERMISTOR or n. Where n is the ds18b20 s/n. For DEW_HEATER temperature. Adjust +#define FEATURE1_PIN OFF // OFF, AUX for auxiliary pin, n. Where n is the pin#. Adjust +#define FEATURE1_VALUE_DEFAULT OFF // OFF, ON, n. Where n=0..255 for ANALOG_OUT purpose. Adjust +#define FEATURE1_VALUE_MEMORY OFF // OFF, ON remembers SWITCH, ANALOG_OUT, DEW_HEATER state across power cycles. Adjust +#define FEATURE1_ON_STATE HIGH // HIGH, LOW to invert so "ON" is 0V and "OFF" is Vcc (3.3V usually.) Adjust + +#define FEATURE2_PURPOSE OFF // OFF, SWITCH, MOMENTARY_SWITCH, ANALOG_OUT, DEW_HEATER, INTERVALOMETER. Option +#define FEATURE2_NAME "FEATURE2" // "FE..", Name of feature being controlled. Adjust +#define FEATURE2_TEMP OFF // OFF, THERMISTOR or n. Where n is the ds18b20 s/n. For DEW_HEATER temperature. Adjust +#define FEATURE2_PIN OFF // OFF, AUX for auxiliary pin, n. Where n is the pin#. Adjust +#define FEATURE2_VALUE_DEFAULT OFF // OFF, ON, n. Where n=0..255 for ANALOG_OUT purpose. Adjust +#define FEATURE2_VALUE_MEMORY OFF // OFF, ON remembers SWITCH, ANALOG_OUT, DEW_HEATER state across power cycles. Adjust +#define FEATURE2_ON_STATE HIGH // HIGH, LOW to invert so "ON" is 0V and "OFF" is Vcc (3.3V usually.) Adjust + +#define FEATURE3_PURPOSE OFF // OFF, SWITCH, MOMENTARY_SWITCH, ANALOG_OUT, DEW_HEATER, INTERVALOMETER. Option +#define FEATURE3_NAME "FEATURE3" // "FE..", Name of feature being controlled. Adjust +#define FEATURE3_TEMP OFF // OFF, THERMISTOR or n. Where n is the ds18b20 s/n. For DEW_HEATER temperature. Adjust +#define FEATURE3_PIN OFF // OFF, AUX for auxiliary pin, n. Where n is the pin#. Adjust +#define FEATURE3_VALUE_DEFAULT OFF // OFF, ON, n. Where n=0..255 for ANALOG_OUT purpose. Adjust +#define FEATURE3_VALUE_MEMORY OFF // OFF, ON remembers SWITCH, ANALOG_OUT, DEW_HEATER state across power cycles. Adjust +#define FEATURE3_ON_STATE HIGH // HIGH, LOW to invert so "ON" is 0V and "OFF" is Vcc (3.3V usually.) Adjust + +#define FEATURE4_PURPOSE OFF // OFF, SWITCH, MOMENTARY_SWITCH, ANALOG_OUT, DEW_HEATER, INTERVALOMETER. Option +#define FEATURE4_NAME "FEATURE4" // "FE..", Name of feature being controlled. Adjust +#define FEATURE4_TEMP OFF // OFF, THERMISTOR or n. Where n is the ds18b20 s/n. For DEW_HEATER temperature. Adjust +#define FEATURE4_PIN OFF // OFF, AUX for auxiliary pin, n. Where n is the pin#. Adjust +#define FEATURE4_VALUE_DEFAULT OFF // OFF, ON, n. Where n=0..255 for ANALOG_OUT purpose. Adjust +#define FEATURE4_VALUE_MEMORY OFF // OFF, ON remembers SWITCH, ANALOG_OUT, DEW_HEATER state across power cycles. Adjust +#define FEATURE4_ON_STATE HIGH // HIGH, LOW to invert so "ON" is 0V and "OFF" is Vcc (3.3V usually.) Adjust + +#define FEATURE5_PURPOSE OFF // OFF, SWITCH, MOMENTARY_SWITCH, ANALOG_OUT, DEW_HEATER, INTERVALOMETER. Option +#define FEATURE5_NAME "FEATURE5" // "FE..", Name of feature being controlled. Adjust +#define FEATURE5_TEMP OFF // OFF, THERMISTOR or n. Where n is the ds18b20 s/n. For DEW_HEATER temperature. Adjust +#define FEATURE5_PIN OFF // OFF, AUX for auxiliary pin, n. Where n is the pin#. Adjust +#define FEATURE5_VALUE_DEFAULT OFF // OFF, ON, n. Where n=0..255 for ANALOG_OUT purpose. Adjust +#define FEATURE5_VALUE_MEMORY OFF // OFF, ON remembers SWITCH, ANALOG_OUT, DEW_HEATER state across power cycles. Adjust +#define FEATURE5_ON_STATE HIGH // HIGH, LOW to invert so "ON" is 0V and "OFF" is Vcc (3.3V usually.) Adjust + +#define FEATURE6_PURPOSE OFF // OFF, SWITCH, MOMENTARY_SWITCH, ANALOG_OUT, DEW_HEATER, INTERVALOMETER. Option +#define FEATURE6_NAME "FEATURE6" // "FE..", Name of feature being controlled. Adjust +#define FEATURE6_TEMP OFF // OFF, THERMISTOR or n. Where n is the ds18b20 s/n. For DEW_HEATER temperature. Adjust +#define FEATURE6_PIN OFF // OFF, AUX for auxiliary pin, n. Where n is the pin#. Adjust +#define FEATURE6_VALUE_DEFAULT OFF // OFF, ON, n. Where n=0..255 for ANALOG_OUT purpose. Adjust +#define FEATURE6_VALUE_MEMORY OFF // OFF, ON remembers SWITCH, ANALOG_OUT, DEW_HEATER state across power cycles. Adjust +#define FEATURE6_ON_STATE HIGH // HIGH, LOW to invert so "ON" is 0V and "OFF" is Vcc (3.3V usually.) Adjust + +#define FEATURE7_PURPOSE OFF // OFF, SWITCH, MOMENTARY_SWITCH, ANALOG_OUT, DEW_HEATER, INTERVALOMETER. Option +#define FEATURE7_NAME "FEATURE7" // "FE..", Name of feature being controlled. Adjust +#define FEATURE7_TEMP OFF // OFF, THERMISTOR or n. Where n is the ds18b20 s/n. For DEW_HEATER temperature. Adjust +#define FEATURE7_PIN OFF // OFF, AUX for auxiliary pin, n. Where n is the pin#. Adjust +#define FEATURE7_VALUE_DEFAULT OFF // OFF, ON, n. Where n=0..255 for ANALOG_OUT purpose. Adjust +#define FEATURE7_VALUE_MEMORY OFF // OFF, ON remembers SWITCH, ANALOG_OUT, DEW_HEATER state across power cycles. Adjust +#define FEATURE7_ON_STATE HIGH // HIGH, LOW to invert so "ON" is 0V and "OFF" is Vcc (3.3V usually.) Adjust + +#define FEATURE8_PURPOSE OFF // OFF, SWITCH, MOMENTARY_SWITCH, ANALOG_OUT, DEW_HEATER, INTERVALOMETER. Option +#define FEATURE8_NAME "FEATURE8" // "FE..", Name of feature being controlled. Adjust +#define FEATURE8_TEMP OFF // OFF, THERMISTOR or n. Where n is the ds18b20 s/n. For DEW_HEATER temperature. Adjust +#define FEATURE8_PIN OFF // OFF, AUX for auxiliary pin, n. Where n is the pin#. Adjust +#define FEATURE8_VALUE_DEFAULT OFF // OFF, ON, n. Where n=0..255 for ANALOG_OUT purpose. Adjust +#define FEATURE8_VALUE_MEMORY OFF // OFF, ON remembers SWITCH, ANALOG_OUT, DEW_HEATER state across power cycles. Adjust +#define FEATURE8_ON_STATE HIGH // HIGH, LOW to invert so "ON" is 0V and "OFF" is Vcc (3.3V usually.) Adjust + +// --------------------------------------------------------------------------------------------------------------------------------- +#define FileVersionConfig 6 +#include "Extended.config.h" diff --git a/Extended.config.h b/Extended.config.h new file mode 100755 index 0000000..9c7914e --- /dev/null +++ b/Extended.config.h @@ -0,0 +1,38 @@ +/* --------------------------------------------------------------------------------------------------------------------------------- + * Extended configuration for OnStepX INFREQUENTLY USED options + * + * For more information on setting OnStep up see http://www.stellarjourney.com/index.php?r=site/equipment_onstep + * and join the OnStep Groups.io at https://groups.io/g/onstep + * + * *** Read the compiler warnings and errors, they are there to help guard against invalid configurations *** + * + * --------------------------------------------------------------------------------------------------------------------------------- + * ADJUST THE FOLLOWING TO CONFIGURE YOUR CONTROLLER FEATURES ---------------------------------------------------------------------- + * <-Req'd = always must set, <-Often = usually must set, Option = optional, Adjust = adjust as req'd, Infreq = infrequently changed +*/ +// Parameter Name Value Default Notes Hint + +// ================================================================================================================================= +// CONTROLLER ====================================================================================================================== + +// DEBUG --------------------------------------------------------------------------------------------------------------------------- +// Enables additional debugging and/or status messages on the specified SERIAL_DEBUG port (be sure to disable when done!) +// Note: The SERIAL_DEBUG port is often (almost always) attached to the same SERIAL_A port so it cannot be used for normal +// LX200 protocol communications. If this is the case set both to the same (faster) baud rate specified below. +#define DEBUG OFF // OFF, Use ON for background error messages only, use VERBOSE for all Infreq + // error and status messages, use CONSOLE for VT100 debug console, + // or use PROFILER for VT100 task profiler. +#define DEBUG_AXIS OFF // OFF, n. Where n=1 to 9 as the designated axis for logging activity. Option +#define DEBUG_CAN OFF // OFF, Use ON to log CAN interface statistics. Option +#define DEBUG_ECHO_COMMANDS OFF // OFF, Use ON or ERRORS_ONLY to log commands to the debug serial port. Option +#define SERIAL_DEBUG Serial // Serial, Use any available h/w serial port. Serial1 or Serial2, etc. Option +#define SERIAL_DEBUG_BAUD 230400 // 230400, n. Where n=9600,19200,57600,115200,230400,460800 (common baud rates.) Option + +// NON-VOLATILE STORAGE ------------------------------------------------------------------------------------------------------------ +#define NV_WIPE OFF // OFF, Causes the defaults to be written back into NV (FLASH,EEPROM,etc.) Infreq + // *** IMPORTANT: ENABLE THIS OPTION THEN UPLOAD, WAIT A MINUTE *** +// Warning ---> // *** OR TWO THEN SET THIS OPTION TO OFF AND UPLOAD AGAIN. *** + // *** LEAVING THIS OPTION ENABLED CAN CAUSE EXCESSIVE NV *** + // *** WEAR AND DAMAGE THE MICROCONTROLLER NV SUBSYSTEM !!! *** + +// --------------------------------------------------------------------------------------------------------------------------------- diff --git a/LICENSE b/LICENSE new file mode 100755 index 0000000..e62ec04 --- /dev/null +++ b/LICENSE @@ -0,0 +1,674 @@ +GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + 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 . + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. diff --git a/OnStepX.ino b/OnStepX.ino new file mode 100755 index 0000000..ed66400 --- /dev/null +++ b/OnStepX.ino @@ -0,0 +1,163 @@ +/* + * Title OnStepX + * by Howard Dutton + * + * Copyright (C) 2021-2026 Howard Dutton + * + * 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 . + * + * Description: + * Full featured telescope control for + * Equatorial and Alt-Az mounts + * Rotator + * Focusers + * Accessories (automatic covers, dew heaters, etc.) + * + * Author: Howard Dutton + * http://www.stellarjourney.com + * hjd1964@gmail.com + * + * Revision history, and newer versions: + * See GitHub: https://github.com/hjd1964/OnStep + * + * Documentation: + * https://groups.io/g/onstep/wiki/home + * + * Discussion, Questions, ...etc + * https://groups.io/g/onstep + */ + +// Use tabs "Config..." to configure OnStep to your requirements + +// Firmware version ---------------------------------------------------------------------------------------------------------------- +#define FirmwareName "On-Step" +#define FirmwareVersionMajor 10 +#define FirmwareVersionMinor 28 // minor version 00 to 99 +#define FirmwareVersionPatch "i" // for example major.minor patch: 10.03c +#define FirmwareVersionConfig 6 // internal, for tracking configuration file changes + +#include "src/Common.h" +#include "src/Validate.h" +#include "src/lib/nv/Nv.h" +#include "src/lib/analog/Analog.h" +#include "src/lib/sense/Sense.h" +#include "src/lib/tasks/OnTask.h" + +#include "src/telescope/Telescope.h" +extern Telescope telescope; + +#include "src/plugins/Plugins.config.h" + +#if DEBUG == PROFILER + extern void profiler(); +#endif + +void sensesPoll() { + sense.poll(); +} + +void setup() { + //pinMode(SHARED_ENABLE_PIN, OUTPUT); + //digitalWrite(SHARED_ENABLE_PIN, HIGH); + #if ADDON_SELECT_PIN != OFF + pinMode(ADDON_SELECT_PIN, OUTPUT); + digitalWrite(ADDON_SELECT_PIN, HIGH); + #endif + + #if DEBUG != OFF + SERIAL_DEBUG.begin(SERIAL_DEBUG_BAUD); + delay(2000); + #endif + + // let any special processing the pinmap needs happen + #ifdef PIN_INIT + PIN_INIT(); + #endif + + // say hello + VLF(""); + VF("MSG: OnStepX, version "); V(FirmwareVersionMajor); V("."); V(FirmwareVersionMinor); VL(FirmwareVersionPatch); + VF("MSG: OnStepX, MCU "); VLF(MCU_STR); + VF("MSG: OnStepX, pinmap "); VLF(PINMAP_STR); + + // start low level hardware + VLF("MSG: System, HAL initialize"); + HAL_INIT(); + WIRE_INIT(); + + analog.begin(); + + nv().setGate(&xBusy); + if (!nv().init()) { + DLF("ERR: Setup, NV (EEPROM/FRAM/Flash/etc.) device not found!"); + } + delay(2000); + + #if defined(NV_WIPE) && NV_WIPE == ON + nv().wipe(); + #endif + + // start input sense polling task + int pollingRate = round((1000.0F/HAL_FRACTIONAL_SEC)/2.0F); + if (pollingRate < 1) pollingRate = 1; + VF("MSG: System, start input sense service task (rate "); V(pollingRate); VF("ms priority 7)... "); + if (tasks.add(pollingRate, 0, true, 7, sensesPoll, "SysSens")) { VLF("success"); } else { VLF("FAILED!"); } + + // start telescope object + telescope.init(FirmwareName, FirmwareVersionMajor, FirmwareVersionMinor, FirmwareVersionPatch, FirmwareVersionConfig); + + // start command channel tasks + commandChannelInit(); + + tasks.yield(2000); + + // start any plugins + #if PLUGIN1 != OFF + PLUGIN1.init(); + #endif + #if PLUGIN2 != OFF + PLUGIN2.init(); + #endif + #if PLUGIN3 != OFF + PLUGIN3.init(); + #endif + #if PLUGIN4 != OFF + PLUGIN4.init(); + #endif + #if PLUGIN5 != OFF + PLUGIN5.init(); + #endif + #if PLUGIN6 != OFF + PLUGIN6.init(); + #endif + #if PLUGIN7 != OFF + PLUGIN7.init(); + #endif + #if PLUGIN8 != OFF + PLUGIN8.init(); + #endif + + // start task manager debug events + #if DEBUG == PROFILER + tasks.add(142, 0, true, 7, profiler, "Profilr"); + #endif + + sense.poll(); + + telescope.ready = true; +} + +void loop() { + tasks.yield(); +} diff --git a/app.bin b/app.bin new file mode 100644 index 0000000000000000000000000000000000000000..2ea70390364f3e7a046a4ea3c5ca2b9908fe3a93 GIT binary patch literal 4128768 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

Y2Aj> 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

~rG2}D>D^IBTffhC23OWz=JYWgH--Gl) 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

OiZU5D~JI)oi!mBt|||N9Q%_Z>LUQL{G& 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

?UgOL8BJGym$;^!i*0myXBr%V~?`w zV}y%zGG2()0TBwfGH|Y4F^=hqFZ_@rZ+3m>KEr5vVkkn#&Y_No2!qZc0O4W?_&D9IFRg!x%sW;%PSH7tvBl^<|Hd{o4foKq`p$fnQ4q~W#bF+eUyb6cl)Ngm+!jgF?|NQ zt_wx5!HZ@`sUtqIYV*fFdLyf|J%21XJ~{R+?2n&RX$@5l1j}7p?pSxEeQlkCoByL~ z4x$eea&j&JgjpZ7go|J zQ$)0=HjZgets>x405j%uXI}t}Bml%Q^;HkhsJg+}-cmJDEe_uX5a1udu$b0Ip=lt0 zXx|C-gF0%~>7+W6^2j-G-w%T%=+>+hE>NcmS1P z)T|3fcCWNJhJRwwW_CfMlg_kfc7fw@Co=Y#;e{s=Sc7`wjFDL{XoNwjj%iU-rp(4I z3hgdcQLxZJ2R_-THEeZ!Qmu8=I2vy3!}->&XS!pUwwwD7v|mnOZpsyHH})N>aH@5|4%eHdw)Lre{)R3YH!Af3DO9(2RiU>-J?!%1kw@7Jy&?xC=VNlIdKvc+}S z9#!)xa9mC}{`Fqqc;Tjj@T6x^q#YVQdH4ip1hzeKbD{B%9t$^*&@;yR64OF`NN#LZ zit7q~R>sHu$FJB8d#g&)DX^`PCMN_BivHD^jHrJw2C_U9T;3GsC@fK!vdLIq_jT{O zGYwKpp7}!^F%43|1Rj}s6A(T^bOtY}lYZO-!B$;*&3oMEYxjfp4C2?&n3LBB`=2le zOf&7E-(1Id#q$`P#jPmJl=DOOT~20Po7Upw47_pt&av*7`$Qy$oxiJktqTW?6Iy=7 zzUr=%f4ZnR)fJc^olkh+?~1gwIO3CyIozx~pLXkkrQfo!eHmfP7VTR#mJ93D1K$}T zMpv3QUx*pJp>B4ST-S^Mf!?EWZtQsrsjJxQmKUf?W@$FS^ z;!oeMmFO(^B6>gl;9Zo%cS-L&xf8*$+lym&F#g;mlhdaa9fv_)$o4mJGl?c{IJbAR zvR#HfrExJNyMgzZ|IIk%BbkQzXw;A!f(zCY;X;AtU+h@~t;(ql6AB{wOpu^eI}12i zzaXvK7foD_k870&{KNzB)CKep(jG^bwz>=6YlHn0kHKDuf<#?Z+Xpv2^;(gJh);Sa*=(fy(Hp)Z?+@OogK`cz@ksswGA zso&sCT3q#U(#pf&PPN%d^@nIT+2E<@D31ZU#WBEjA^D>(`-1EXu^M|nJQ!RC2Ips) z(!}szw;_(nMub0OyuL8R#tGPZFyWYg67>OCRa$uDw?IH<*n`tJE+E%MbvC%C_}M$08uaifoC#Mv$)4tA#gNNXVIe{cZqs?-GB7Eiwew32Mc4r z=e{M6g?LC6D?r^SkLoR`eyr9Zy6`u#a!hiEg5;~6ci?|mf!VGKX<#r@l$5FXK_;!hMpLGZ0vp3njV5-G!z4>hPFc3b2YG|X3JB2nT{82Z z?t5Op51*4zp7}&1D!?zSYiZsp`XQNwOX9?ly978_5~u6ksM9Rnu$c#j;0l!Cv_Tm6 z0V+V#4KeFQZS}=7XKwjfIl6)=u;0rR^GbOAADaZuc1CS$@cd>1`Yz@D_lRD04Y?W! zy-9w+U)zIq7QFX92wd#MEeBft(YkT^u&4j~wz<2NEm!?4bE@sR2J=rRP;JYMA5g83 zTj8$WUIGOb5uX6J!YvRjKUhT|4Hl4wvD!_<#bQCxGP2*jLqFy>r9RRcLXTuYZM;3^ zHK2oHeZ8;~5lwlSRXM)YI=%$qXlaLeF$sz#Yt&PLGTP*%Jd z!1e)3-pz)I*o)PBnGNsX2jDW*H$2pbK<8C=YBc1ky7N%r49>4Ou0EBk{HQUwH%S$k zlc@rl2g8a>s1fxW(; z_??e?yE2-qv}pOkZ&wT4#L9_bZW(89$4uf^Hy<%Q;wz(9zR!*u=>ILIqd_0uCWbV6eyO2W6M(3p$|_%-aD zOW*J9!CS>+4FA3O@F=5#SN}=o_ij_qUFQvcXnJz3oLTj)U&cXuF~WSDkQB*B4jBSB z?_faNKS;>7`36I~1aAKDzo?)N4#0N2$9hcmR>?KLtHfN~QR{ofu!+k=^z`5GC!iE*!5PQU0b;Tm5}Guc^8QDbt<3|}cu>|CHs7XKPOtE_mA6&hK3o(zOg zQ~nu@>P6tgZ^YcdhnMLACoulkdn%(@)z6vE@q{nG5^Gq78iw#MiFwB}{EPH}@B9ie z?;<7#6)YFO&S3aw#jkky1${-#8mjeYdq!qVOXdGo^C?Onbo*nTOpMzX!e+nH7BZNNfu+_VoQ@!hMtq zh=iKH4-GxpuTq^*7YMvL84<$8`s^DgBfs?Q`6E5Urv%UeRoRt5KpYQ<5BsxJYv7(p z=BWa`}v+`3xCxs;oCpxH;8XS47;X^ zoC7dkxop&yb?lyA+d9uf;^xUn@y!^ayT6jLNFmof|WC!ngrhHauiymE*5L1>5we@h~9Efxij# zxAy0V7L;K^SOwAr1S@o!6T6G27euCwju*4gWuPlL5dDZ;0`Yl-dcbSRKkC;Q8UOR$ zb?Q;L(BIV_S3gR8fZ(pOR$W6O8zP_!laQT5{pU3BAQ<=7vyz|w%FN?kOGyQ=4=z`k zYKl;Xa2sZ$+vCorczr2eZWLF|CsVeXyQb&?;0_=^nol+~9xvt%@GQK{oSnJbH*>ew z9oaB*ci;~nqIgnu8a6^W4r^G)6Ddt$e@;qiv4yY2Oq&*}PE<$ktv1ha0+ z?$FW!UwcxLE~7L{r5UE#X6}Tj0Z*Pk25A;+e>*-1vp`yG@X7O}B-;f;`J^h8c2yaC zGCwj%e9Eu|0nhM5cUP$$TXwbUYqnKsDxL6jL{N)Q7>ga03x5;=Y~C6kgxSQi;&~xO zHc<>q*stQ1OV!V%Yfa!0T^#fL)dQn>mR=S17;Jpsh;me zoD9N5x!b1#>=GO9d(CS?c~pqUNL@u9`vk^w;h}&tmA~(WQjac~5$6csilI9JMoq@w z^uk~K9h#(4T(iq=ul#J?EpG^%f$w{Az9G-q&071Pdn#`BG;7UOsTDWy3ysi9^;~&0o@{-c~mBNcNcH3XP4S(?l-o18OgYVt=?$JNo@W0-G znEy}oKKkLOHQO`o?_aan228V%pI?%S>>8nkug@t~*O_D5nH(1hQ}RDu15ko++vWB7 z(2H{oyS$#4J`~uY^(O?#e8i%m_@>6a-e%U5^l**dbDD~V$~Jg?yHWP*h6Zoog%5FI z(61EV?8T(ohd*3%zOByJZg|7%Sws2P(|aPpKx01I9|lvhUHJc#UH}}% zD1zgE-s`JE52iId@AWMHPvd`udak4Kck~^9vDdc>WfwFQdjpI9b^N~&#~(xEKS1Mu zj%tbMH~s>z?>W@)a>JA2_^M7zzbN|!$v#IAQ8h>lw z@xxn57Rvst!RQUl`Vhq8ZjXOw4-9|i2YjJ*XFhg2u#Gb>h_<&ff$SK&nJ5cj@7c@Q zpNqC1VLYRMz*!-X6CM)=u|N|hpnSL?+8g-UwSr+7 ztr>5L-oSrf%Zl|jE6fV|X8!MM=|jBD5M|RsHr{K4mSO@u;wnqETDe-WTD}^TMO^o1 z{kwerUEHV{`Mi%>Gk)H-m7OsI+!=p@-l0F3ELgL!h`0gL0qtzK_w<0aaPR0;^Isn_ z-avNUrr>Qm$XLVmHqX=7xB+Jw%Ecg;=i`Tr-%zg1pk6fP`e&PY0p+^ghFrJXMyJ|8 zddT>9%5}b1=-=?Swm{J}j!TS~oXX#5qt2Z|4%{@!LPy1~K5a|k%{jX8o6>0DchN9w?gr)2aa{X^_P-M0 zC8c}I$3SaG-tG`DV`H`=uG}NZhz(e%hLQk${IV79WIQK z`Sb9^8qw=as^7gR{Qdm5W0%dN|U8zm<(S+~URI8xgn z4fAp4x%Uv4hGu9aHE(hkHF?8Lvxs4+kRgZo6hZ`3jC`?|&3S@Z2%pZg@h<6kJIU73D z+l6o#WA(iWFvZKoy87w}n!?qlsr~M);uT^haw+hjCXH!oU(e2_c%_&riW466O6nA@ z+8*>%#G_LiZ|AWUf9Mg72)(#a#5hU$M8f3`g&Y1AHoC*a>TrzwGe%NpK5R0Yb@-OJRTQ^zJLiYI&z$1`A z^LxSLEtbr-6qO@e{VM-gwiZ)ShDPU8IQ}Sl#GBXAr|Nk=A2VERPR#75slQ#Ms6(N z@9nINP8gY?=3m=Y89f>q`B(7}%il%%NGfNFVNCN03Gu?!bjYW-@J4EF$c<*XCraYn zO>)MRuaNRc_}#KM?@jP74GbSg^9N3r{uW1o`4Y8k*Z8kf{Bm!PPOk)Q%358px_I@n z)%@yps~fPH^_x=MZ~fn$!@72+F2CBqfiePDnMrC{Ajji3)p8qRitcW(@8JDZ8S z-~2@Sm|YX%V$vITPKf(;dJ3M&sJHw=200@<6}E8L#`vYEUr86?q<`Dl6P0i z0|(HMt9(H6IS4i3NnYeHA-2P9IQFhUC5>TwbxpuJUj?hHd@TS6->pM#SY3?t*6m_Q zfje-$2fO$GNaYPS1GY3LTr;z;vr|@=H{9OYvc=^rccerW3M$y5K^g$hQPp7StMH&} zQFgmnerwyd}CbwVcwQLpJF&^0Ie+y1M=sJ+M6W9e8D_D~; z3j5tjf!%GC-X$8F*7wvrD6)>xK=d@+0upk!M zp+yMyi%&(iJ+;&A8W#8mm$hJLitHYnc>f|hc{Hps_4e1t_D#T2t{IywH+4tj6k;YUdwig9GS7~d(f|qfh%x3ju9A|t+O%j4+@UjBV|GFz`G`epSmZcTsC{y- z1J+8)fb(jZBK3tMbG7qJ;oe6T8g>;WF4itBL*U({So_+mD;25bN6NHI7u!l>#ix?a zCzm#@Y4JqCZNbu((P5{C%?zE#?7YCdvYmzL&BD8+b(} zH4$a6Mn_iV*l=56`pn8!yx#*;0I0~LYCGfz@M|t8qbR~@ ztII2u6Kyf-(kI3)nB|p6kUeYiw|r%5rQTF?%rB4VP`4@rC&a~0bZbQ!Y)g?0CSGZO zH$($U{K|!I83L~;UGoj;-8-P~(!E2py^Y2YNbj*(uCwDF1)l0Wd|Ax_Zpi6KlG!NI zz^+uyu5WjC%lzSV(}tv*Yy_O2yJW5|!@|7=3?t-XWZd3zlrebzyA08lqt&HT>9(-# zsn%9i;4pfEF?K_4eDVDI{ur6=kRpNjN*lm{0y{*mcUlJqKET21*S4;{;KW9zZ^X)6(V! zexe9uwPaqpxgij(I3$J>8P&j#6+a;uWnXtU#x*<0K}2-&of?7TMzy(JxH-NiAFrM}Jzh3~9=?hwOvO6aVQX<65M})nML`_K555DW z3O)WtF;k%#L zqe+LF$(pbO<{IdpHF+RPczqGvd|1uR)YLEKUZ(3oUp#+iJEjc}=I`WP8cx#E$^nBM zEx2SOce8?v!D+MdRS)n7;~l<(luo1TzSHeTbR}`va1C=!4qe*_hELc5`IR73AF0zq zR|J38wm3W~impuP#C*}?mZ`<)UT$&DH=p(U)Lx&)K1@-VAG+(t{1ALUR=DyFy1QYJ z+3TugkeLhboq?p>?fyk&X1H@U9l_{MQ*gTk@nr^`ndN*l4MoD<|K&`I*s#lwB0{JI zEWrv(HWB5)i$-(PTNU>BvIQf6%}I(Ha(z|-eF|#zPvfCQg5(c+S`{Q)6Mc7IqBAn+ zf}}}i9bI%qfW3%LcP&bt$+3qFEns%6ypnA)A}jsxn8H zQ73T<_ziWEkfX0UmGRH5Cd8X4pu@!)Xrg!yK`c-B3U2PC0vtlkHS@r-()@5~bVsp^ zV!Vr}Dk-0INBXV^w^a~om6c`|SYnvMu?mYK*5qOh!wtBPH;GUPD;ZBvFo%m!2*d&k z=8r;92y{qL@Eipc?0ZC}0YCvf%txtDm!vf$UdbMzMU=0!E6Yk#bAMQbaVk9W&^WWj zamHBsjWd07D|%%KjgvL+K%H1u;2GS-7JDFeSu2qYKX8fK;$Ti9s;pGlPKhA1q;_<)(fEdctf#Yy=p zRH*R$b8)Fz$30=2O=v|5N^pPnF(*26l2luU1u8kW__Z)ol=%mBA$3loKc3GQC+Wut zp#FJ7fiGUa(%d7KmJrx;b@2kXeM1D*=V&$rJRFdV#)3^SSkEi0v=ep^kqxMTx@% ze|{G%g~}6o75qw4tU2dFKMk|7?2s+Eapj_9uXuT6aYb6@vzC)^=q=~Iw&cfx#hc$(dg3;z10P=Ls%{qS-(1{zEnwAUumGRNA&WGTVPo`VJ7H)ywK1|Tbta^Dq-7;3b9pQNGNHsY3Tfli^XgoN38_L%TajMFV6HY5OA81bJ zXV4g`j9qzE>G@R;WOb;kI@?;l#NQ%;2`s{cXRNKD;Zd|QcQ;${ryh$= zc42rZFQ$DgwL>_U!PacS`@^C4C6aYGzKF9T?uF6nq`Vl3>G0!72ByP2OxajaXs9m=LK+t^-)vyvNUr50`P_v(ZE z!tGGPieN4(xEWl8qs3q^0waob4_=LE9MAm9I4}K8R+^CI&~{X;UUoZ|%}MP&jo2X0 z#C5SrJ0CvrZjCCMw=6V!ZZ&ID%N=vHEu^46y=wKcK^RNflleedqBnsS)N!ESK%PdNSUk?_}!0&yqOkE|(gQd>)x zD7aA-K(&2vv7hKR%FPf4YUFk4LOiqmoa3b<)KoZ*i=1+dlAA`daxT7t0>b2AEr*Nr zby@}X#c70))2f!ORxF>zmaZPoX`q%SsYH4l|^fIR&>IUs!xf8-GTiBeRFwK`-AO-Pk z#SEsst@JrV;*5^4RvG`37A!@#G0|%r;x`WMHV(UNG?+W&y1N727(%sB90Svo)Q#}! zSiPR$M!u4r{rq`4k#DQ}!BB-bG1zQBSIKog;UjfbRb_3u^CNZL)(v$jCX}*Ti(_zT zw)RB|N*B!ab^B((k9Kl{72y=3WvL_b8ceexLrOUtnt%*>;iB_g zH_&euO-(2{`7EvBVg`FEFW^^WSX+VEMvrWLz9wb*E+}$8ByC zU0zZ-=r5aM1FNq<=2PFY`Mh5*_reZd&v<^t!t%xx>-pUk{uqrObyIv{Yu|kY7i@yHFIa^^P%cL%5+6@DA%+ZsJZGW8 z()daLXN98>aR%Ic^?GM`lv8XLq3KN&sQY@w0IFmOhEbZl^#80R1Uc^rh1<_U%x>~W zV~E0u9;a_;H93xkz1OBXr)ZBAB7%?J$Ws)~{v31<@@$s_rxX0`lwR`Emy3~eJ7s{~ zRw9L4MQVq6vK6z|0+kgKxq?WmC}9t^jyS>A5eQU~c-g1tBG>p%k$(D{kXaU{4)8{Y zdr!rJZ>;~fh3McMM(N-WDlG@B$ z&+W`1TO+=u#gAj0LIb-`$5zLg16p_E6xTt=fkV@`Rc}1AUwhz?vvJ9$gU$%%(61cr zt}~lqw&rbo_P|EOoWHCcu;DS2qsny#vFW>Lg?0&vOt&`j!wk;v8`_~X|E1@iCh1xj z;FbLyfN@V{RVu7c=(rE8a|j21Hjua*xIv{m8%KR-jUB;}lW9EI{!tG^r;vJJ|9_8! zD`2Q;AqW(!4eJTqjXyd(cXF1$EB45fx6bOe`gB{tRx5cO)c{uZ*6VrEE= z>+X!@2T&4@4y@-DxW=Z#cqQsLxg7W_*4-@BRP!pzg~NjonkT^&)pZU#ABo_mUE%LH z<2#-MnOAfz_eIH^=b0;hR~qE9a6QKN(05wR zBMaP~HhH_;BAYD89)+jhtkvlgjla@be2-0(-R#s!Bf8QCmYwbuPE2}51D+4Zwag5Q zSg{K2G0R;Jxa5VO;pey33OiR;S2`xvHpxd>T%SxBY_2H0dB+%5*fgtd9)3#)5$ z)tZYMNoPNBQ7#<6!o_gmYo{3;Q_B}lEYFo=+#c)V5^FB-5XZmCi|bP_s4|4EqX}=H z4ug*ibZwSws{o8MPg<;71*zn_wOgi~@u zrvz#*Dido^f`Ww|j;jt2 za#-uYElO3KE-$<;PWPRVO6ZuWwX|!G8~Ib zz~QTi!@qtOcbv*8VCOf>Gp!hZHo4IZGWPGmhT2wP>XuoobZJTi1nV7hZ7B{1g~Fa~ zv5`2c+xNKN_ZZDMR;Syq^t>bo1XUGuDO#drEJ`}SEELVgY{y|=7$}wBt}ZNzj!pRG za$9UkXOy9It)-9{ju15}p0stP%GKgJvlO!U<&D{^N-xVE@0L9VZ@f5r2i~0YGtGsi z)?@e4i@hTTERT-m>RxKE?L>RH5w}Lib`2_V$qFl?tj2I_aYU$Af3%LIE`fiPZf($2 z55T&MTFfcn@_}K_9&Yj-ZVH~NJDLD>>^kQ);{82;jNUEBq6}l#T4ErS3Cx$jqLG5R zgsLtcxV28@s&<{h<-ro6F}u37UG*Hu`D0Gmd)!HSp&EG(-CP!Sz zHd=qb!BEJGxmCSzTe)+mVG~&~<1DjX&EIXVQ$PQb>r5r=#+Emht*W}GQ7xo7H6PTxO+7uaP9$j0&^877 zC9@T4Xt@{Y`pj3>3r%>-qYGxAOLLUEi>9DmdI*k#}3Zr>C!P}XP?=)}QUXJNiNafa7d z2G+lT0O2-9d5v1XF}m9rbJ;k^evgGu%+f_#Dy7xAeX~8o<&de{T#7=a@={jQ*{mi` zyu;$_sW_;`HMvbYv_v~>Wdl__8x?2LmwRDfsIZ?viq)#Ho6s`pWt8rY;}nU?92^uC zDlkkyB^Gr%Xn)}poTole^DNfzD5`*{sCFp!d~Ec@Yu#zc&zbTFVq#|2EN%_sJ=77)&XsB79n$iAT9G!l z_EDv6=gZ>yoS=xu{g^iW#3gY7CdpNVGsJ@g{>Bj8fiZ8qg$FS>f~T7hW_+;{$O5v6 z1q@?+{&o5u^g+MH?_P-gqqSaeuhmx}IN9&015YJa#>UfyS!`Hha^)M3bh2Q^x+~vM zmUKc0jay({Ndf8H03zY=vaqnZ_W9KiszgEx+!5yXS@`8t3p9}2sI}$Hd56DstAjIJ?QG26RMo8R)(&1$5CWGVOL59lHzEYnJ=GUs;IWi}si294tHS9S zB<=Omt;M>fz4FiEJx%Q@>|ajoUmLZbEYfDab*5Tdy~f>G)6L<1xJZ8CcH&q|)+mBfqPKOkSnvSu z;OtXLrz5YY6H+`^)dXE6HxxH2$_^Fn+~IU8v>3M-NA%92eXlr&{DV21SAaQ?Kvkfp zd}81lTX9opE^Tg?evZrI;Po^Ox09mj(&j_~HyusbB{cW9L(zlK4i1Z^9+Q6z2ABlW;iz9UNdOdNSZSwe< zJj7XaM)GfYFiD`R2g0h_Ankb*;(--HzHF`IMIoPETZO;!l6=KN$PDt8*8H$3^w9TW zxtVw8hP#lOOSf*PgWzm0KG?*srK$y!wQD6^8C3nlU1IHk>M?k5i46~w`~w5!!gA2j zH%?^fx)iz%in@Y?)k3Zcb%h2hgem-C@W2UcU&8{rSbuIGP*~SPRQCmK#0xxZh^6C@zQ?k2SmuiyVh%r_Q4R`Jm6f*ApsQ3ZkFHq$u57uj0!;vA>GbHE z%>RP=>V%`tW#n${dvFVVdXUG1btow?SaNA8hQ{bMs!Dv5-99T{NQJw7ld&$>H8%wQ zNv5L=HdvXcg{32!5qO`qfNPZxxbUg<_;=jk*X2_x%V(-fj(@#yLb+qCq2>iJwKkEd z4UHR3S&U7_EDs(edisjE7PE-o1wAeP{aekdlE&<%Eqh1k1ts`enWI!&U5Yg{YL3K- zatWAyZaSwb+^fkM1Nn)@3_Nh^qc-eiRl}hks9lVG&cM`Z>cT6AFpNJw?A_o0EHPz6 zOvZ$X;Yqdnq%DIxhce7lNJ(2;r!{EMq^SFxS%_Yh`8 zV7F4dso3>Kt#EXQm2sxp|wzvtGHr=~BI#3$0Nt7jYCMP8|_ zWjjYR6EYH$7EQhVf~IshTVZ69rsl#{ueKy<%TJTaX8@pyRh2QnnUFCMTX4*b#Inkm z+@#%PYlYo8W-{%^G2_ufOxBPak`*Q{nlTq-`q<~){w@sO`n;Q;>i^yRKHepB^1!Eb z^NUlx#Ddxj`o~F2d}Nma!&7y5x8(3wb3aeiAYOF9YmDS3H!su^bPKPlA;62 z`=m94E#$0ci_fz~!rMmb$o2zbKl&}6vC@TlsXNM=A4k{$MDB~jVtr?wTYOH`l(>|4 zQbje_LKQ(F=fS!w#+_^ke9Mijq%^%B4H-w8g9kKRw?VFtc=r>0?YBxj}ta%Le zJFhRatbkUwRqWZQD(lf}SjD$T7_gq6L@34ooKxD27QRv2ZrnwCQ5Nc%Vmq?fqkVGW zEzUWzHhfgliFDHpnk>k1C;Vle!176%46++&mV3d63*ci1hc|(cyv5M6GJ5e+RL{uaJ8OF>VEG_J)$c zAqBRRE;ZW5H&1iu1Ib!@^$2t&GK75`W#vy+*DkCwG{sF9j$P&w-bA9~ zxmx$J9j?u_i^C`43TGHg2aVGMM3Ey@{J>*B86c&2ze^@|$HCfM6*-s^h(un?k>M8) z{1|8);=U-@CpH25<9ZgRPq`T>rO&dR)0x{VB9cZtU7F2SKsV0Dl;Z1XrnHgmOkt8< zWjkjw6?)nv)|2;%+>AKvm+RS_bOu`{a*kn=_OPAVOof&hTabxL$RZ+Dn?3<(_Ib$(QKfM2tl(8A^JyxTt2-*pG)h09$(T>E=BtULygX8^eGA3zfK>essm z$Q>7D)4x1_4mLHA5ubRZ9`WvE5nTx%kovBI&JvRA1&L;YMChi<5Dh_hg@HDv-T7I~ zdh;qKt2b5IH)(n z(#+cQ;m{$oueZBn6o<~^cpq3OT5`rvuZc3?{=SH{ zuxSv#iWe)o@`wd?skeEoUlH+f+rqaD_Nuh+eV9*`IqDIsY+&g)ws29nRTi0;SE+~@ z`F92MV1O&}bN?O%5oR3LFQ<4N2LcrqFgNIRMbhvAx5p}zVg^E_ku)~EbZTS`v~+Nq zhGl6SI)`T*GK;8=ywW(U72#z^q!#&&bKvwOs$lk(xz5BN;$f(y@*E$B7@&(wQY}aC z;UuwlcrrpGf|a~FQ>_Z4wkm*<&*Er@cMy@8YN}UsIy_E{+f%pm6)7Z=Jq2)&<60%{4@LaXMM&k(5+t3==n13 zc4|0cx1*0S6%2$u@RGqo@f|JviLJnR@C+*=`)StVl2u?lkOY%nJlwvWMa6}m0-I@R zKW8V6*1!Tg-L7Fi0U4ZKL}l5)Dj867Rajt&y>uyCkpS}p&(A;m85CDl7v2UrDYKW( zk3TJ^yEOAs8voqO1EE2Owm1#-OOJk`J={@wVNLyB4{(8hwE?KptOz{w*`t~q70f9Z z`;yPF_ta~eHGwZ6yW(G_91&v+hvR&J^#fJ`h-Y3d!&PMAT?PDSoOP3UFQ`UVUA^uv zZc)y=y}57VIV9Gp>zAaJuT5)reX<5F3i&Q~bqo9-X&5rZAw@C?ZhOnO0Z^U=8016H zs#FB#+0nt-=wOA^!Jmp9)T4u+QU_;K2Q5c?3S-biabNc&%Eb!NOJ}pK=(R z+|5u%F?rS-S{(LycA{b8n#p47ZTuhIqGC%On;gCIO3EEi?7fiLFXjLY(=;QA&9u0) zm2fSq*1b|;^{mg&MZiyZ7x@&iigo$1CyWS{@IRQQnx!UvJc4{ZPPTrfrg*4bWYxKI z>!OUWxkY_>Q?!8#BR#xQQyl21acINH^#hH+34Js|OcMe3uu9WNbB)^?4JRb%1ptKA zXj~D>Wg0myY>a{%ET#|68rNXRK2oKvY-F(unK{CiO&k=X$X+F!V1Q@%!A;~<^ipKB z&5kq8?i-yNRN59X$2MDEl1+Cq9SUi%&FS_W`=OBqg>H)Q8eJ5qnX_gOoUJOEHI0G$ zxF@?%t;>cEEza8cb|7MutX1Jb#BkzQlvlJD+0!afEjq(vn^>q<)PUSIr)(O#h7ks|%eJ>j?5aeV;MUA`f9es1>;k2)lg~mZY7PZJ%$^ z$6NJ!lRpFE{*#Hgzd1=2k#a;U>-pux(7XrdUSx(vTf_UJdpOq=$7@l#D#p~{FpP-O zL5r%vF;XF`FB30-+HI} z_VwCImMxtTFJ2^(uExm>^QQmD-unkMd0qeG$&()hh)M!R1Zu;B5k%}DSou-ypCZMh*m z1}BdFsMKmWI%?z6vZG1e3GvGiIifO6=O)x~HTj4PH*J&uDykfRDi?O%YvEtwhQoT$!gnjCcIaiVM0l^tl8>~e zA#Yyw{wKQL(CzPN{Zp&kWA|T|b;r^ua1F_CMa03L^WHD7CBKcP{0R*vho5Yl^rhq8 zAQ6P>{POO4lH>M}9EUxG`!o(B0`ceooLZMwKa}-yYome=V{>)+d5D>;%QmCB^f$Ov z;66TuJ-W9pyG?+E?4COV;^kcIsTXPk{Nxcxq&zd^Yd{UqLdHsrxZVjuCNPCaUud`uq`xCY= z?`amH9ONPJ54*3<)bRf0N;gJXL0({7SvRgOplf5#VGM}(j{#lL$-j2Nf)M7j7=Iksczm&ruU^1l=)#a50E2roKPIizs=|SR2lv$5 zj~-3>;FSn}`hcNbiA^`cZ-(uHtL%#V6z%v{n-`Pg@RbPL z{c_R`c=rGt@APjiZEyH@U9lYh;)fmWgyij6e|P~uP#7$ZGbJBn`$G75kI>uDcq`a= zYq3tRs7-PVTN8n`YeR%Grjp4#S7}diXG3_9Y#7MeV<3prsDuQTt68k6KBX z)^LO;TiZeOb_dZ@(S4LLzz}o<^Bg*_aa9$9Jn3%6Q*vC@_UAfX)KB^$`0Mdn4c*fpc4d?Qb${y0mjM z-N5$sH4nR$9$bG>5nY~U#lf5AK27F5)wt4pmu6nBv2+3C>0e-Sn_IuyoqZ<=^>KOW z8FDkPk-ycR7G>5&AetQx5DT5VB3Ompf$d0$ZHw|I2JBtjHDk0ugUo*y%5=fB`Fm z_Eq|2MCorMNEkmNFKwnDwpAo<4CxWpxTyNyTH~VYZRIH=t#Pv6^;oZ8$Qd41M287k zX2A@^gR@|ci!xi|hCGOtLTF%BlC{?z;}}PDg$dY{N8HLl{rBVYzK3x^qw_EQ{(()C zZG$yDT^79n1KPKUtGPo)1G-;cdX&OoR*;ZdGZL8}ELmntIL20`%xcMm?|vzTd+b|5 zSs{a?nP2Xnx4^wb4`o%}JidC8nqkNYbh((fc(HlSJgoc^%J$*pYq$``~0kub+`QcWtNaABZyC34_+ zmtzUAMTF)JWD)uuqz#(go9V+R&7-aOd*`txmFBTHH8792bHx*A9&HwR>C#9n{oSMo z=10Q$J$xQ{rG~dqutX5=zSie`p6B5V#4VmyHtO5=?3XU?JWqe7-CmwOf(Ex}3`Jp) znMqf6rwkbO6KASPtk|LX;lBof!z-JWVn>J43mZ2EEXl^9kc_&$d+|~1GM=`cl zd0!^kuqU05vhU$N?l0P3^ygeX)|YgFE<2h&xdG9y5erFl2bM`%nxOA$FH?ltDf)4b z#ghQ1-RQsp%dW@|vk@jt2H4$^5M#LUOY(F!enXzNah>`j{3-J}!M|Nzu=@q%1=#h1 zWzl0Q#OXxHM0Hk+rrRCU(F1RU((x$GxglRoigs054^jergsYHx9P?#edw&{;5V2MQ zwP6iF)YxD#>5goACd{OjP3nc-ayZU$8$E&_b|#4|vQ^n9EX}}PHZuATlbuyY!ARtD zD;X@;jv|kzJQ7*pO)WApMP=xex749HQ+E_ym;PEFsU4}k#n@|n`BjwKL8#M^OQ;|O z4TZ+`==kHMm`ZGP}V0w|4C ze)&jSE=kG``KXR#a>Si>Fnhg64g!I_%e&T zy`u1rxCSv%^I-3J40iQ3sXgPJ;CKtz-nOa=JF!hgJ2CAZYpHfAZDOxzj4y40dhnR0 zHY!#7=#M)P=e2hSmZfsY84u4z^XwpqZJ`8OS`RD+#^@hFAUBSy6{cT7yCK0za3;ke>li>)q9ko}zD3%Kzlo5%G3 z$>Bti)fbX3Lh=E5Wy~N<+dDK}kQfpW2`^(MqsL1!j29urs=HLi!fN;JTV`Y%7sqny zJXzLz&zC4Ds-|eVsz;4wlv$OgdaqSEez8mCiHpIBB(vpl+Pbg$b8JYa+htitp0}pJ zaE0#`o{{%37`5SZ^(!jx-4EjWHWjZ_(Iod@#iPd_M4cp+_kn9!2cAd4qH8;#g=>1q zf9X=JGBk0n6uB!hbDPW9sBoQ@dmMedTN_}B9os*JO);{@m6!IDR1gzj4t1xmXkGvMnEri7((r95EhQ+FQNH1 zv&t2pkoqQl)EM>=`e^wq?Xw=TQ$%h=M8ycFzTSyIC5vM>;hDyjmXX5>?Ruesg9c*! zS$>C`-r=`5B}4<@DgV7%Y(SjDLvPu9W__~*eCT!OPhqvAl#G~ZvoNPiWqT)Zo@YlK4-g>`QW^L>-I``LEbw~?`YGA z?&>-bj-|Rfs^cEbmr&@D5jHWZJT>z>A53q;#WWt_9wn4DO#0SvQtj0DHs6s%G4 z;n)p)Pz}pvX!Iy#8^#77Ib(AbgP5}Z1_t|!9qf-tgwax!I!U(t=^btA$G9%KU)Y6+ z*E(0Ly4hI?rQ)B;E>V~6>{_i`v!*g4u6))HyDD|*wOyUM{rj2bA`~s)cjJ>cPPzv7r;x5XQ0uQ?*jz-wB5`=jI zZ6M>1f3bVZ8J2C5u^RLw$TXnw9bEBm)fL>a!%2xbN-nod2_#`TwH*-Hy~F&oN?Edb z2c=jcUr|~Hv_6~0@93iz3|DN1U<}-Qkj+oqfsn~{I*YTbP1o)vSU+xeT%?x0=exG* zENrzFSyj!dl=+ z(?16QEj2-(tlj}}-BqVU;WYf0DsT_3pO!0*kU4I&d~X+xf%X1aLW^{3Y}6Pcq$do; ze+=A(v+9A=<|x}${KU;=3|os6kAc*!EhM7K>77~7Qk0B9Ng*LJh=$SNL<=b8{@{CrMhYV` z5gI9s%*=hA^`qszayo_%dwY448cx zB-G1=n9c%v(oauFIzhMb#qhdZ);J$gj_}fT_@?0)3ynwNMlwD62R-UR+YVn<66#|) z?xw*KDsF~K4-RVdZ2j~Y2reT#ZlPg0HMr~S?e~GUTgl%TcBiFaRZEEycONMgR@WD$ zOCt&%9enW77r%Qn^MO4;rsFXA>Cc9Dd9Kj==|H_j934L^Ub941 z>b=T3P|@;}?>{eVcELUKA71{8(E694IB|b@iovYYn2TgYTSatSJE=&UQUm?5yinJX ztfV8j(y?R`!-SO(@+xNe@A-cUOAU^)$cz?Tn zL(Jxnw{MGACS3q=ce_I;Z=t5nPFhu3l z`Vz;oX3UM_;bw6`_@TBKH&$E_6W%y3L0q5{59Mya5wR>$v>U6;2h;Y6c8NEZgL0)~ z@yxC&It;dLxXmRWHLV0|AU(&HF)G``%+eqNI4zcxk01=V3UHItTrkSYoH*S+=-6@? zO24^Yzn`{q{~On*NA-}*bL$MHGKh6s{x!xYa=CPsM4JqZU4Uzfy}mS%(qgED*;W8fcmPd~B+>q6#HyhR)X_ zRr351NQ^76yX#1w3X=#&E+txcsgtxnhEwf_+Q}*`DP$uM6q3hewbPWaQwjezlI6rt zRna0HS~-8v&WU|elH+M$b+xFVq8;+AX z)q16wnNuyZ2Ol2T{B1LC$0y2C$BtkUiY)2FtZ!(961>d*OoRl(zw+1s{6C-r7~fJ4~|bqecS05v%YG|@12d* zTS2VzxZ)262yv1v29I3iRvAj3ixgCaE6&sa{U!6>i?K; z<`pH0JYQIX0pD^lUl5fg^^Mb&NYEe_Nzd3E|0@{f0T`3(K|jAvsPKt>~qHW?g0SKImeSbbsIgZ8~2RHHJME$qSp? zxXkLknT-v{C+gDE9ow4fcsL%oOgOu+`2rOJ5xhlwBrq442!tOZ_Rw`C#@Mu1m>q4M z9rf^7^F2y@P`XYg;AIj0W~;_i-2djq%?*v7hAjmRO$}#X(z%^oqM!~^8z<5ncX5w_xcEc8Vb4MPP5GkIfi=DMoZn7OJSGqJ3zKWkSb z+PG3^zFf;87FFHzBSa=|gM{6YymRAxk5A`lY6NL+>;pT~?Y~EG*oTjB(24&_^2EyI z3Ejz<-#}mk*Th~3LRzh_&sp*i4MOnB5z(-GON*dklM?c{zu5 z6_(52RzjHgZ^f-z!Jv$jWyfZ`0989i5GJ?d@KuO`h+Z zS^2B!qWB`m#-=)0v$Fd2TI|{Dp{sw41c=_f0l%y}I%f*k^Wgv;!|XD>_?@Q*Ub63A zQTzAaz<*xDe{B11yxP|2nGoZ>^$VOlmB-YKA>0=?tyX3(XvkdTK08xqnKl33rlnM3 z;H^X94i z_f@|j8Ki2*U$%h&uxXlhe@nA?;|A$?$#Q;qgn79}SRQ##>%*@GSK0CYHY`Noa%*Dn zsi+%Sjx3?Nm{;dCd3^caUz}8veOEH#h~w2+?8)krHMh#jJ0I(o|KNoDw$J2~zm{k4 z@=2mR-6fysk*9f z^=2|%VU>`$h}8E#XySeOZjasj)04~}Ez@3mbrL~w?4lt8aaVGp!z+z|tUCjd64^G7 zfsXo_?<=Ri?o~?_rFAy$*@F)GB0x;r0avQLplyCVKr?bU~TG7!;uN6rk*Rd zjU3o>K9CHnp1lg#a4@K}11(?4ck^;x#JvbapDgWU+%{XZI+>mFg@aNQd|`~|7P zbc9R}7|+2NhmBy6#>k|-`QVs+&i5G<);~DO3WE;b=YI~AA{94+yRHnBwnwlQhVh)e z*-nhsv7vTu9vEw_o==lp_X1=WJ}|7BoL0)mF&8jxCVaIuYvfU!^ZIlm-OtheBNlu7gP z{0G0ljDp_n<=Al*DyVxYcSR%p(K#7wrf^ZP;QD zMsDNXJ|~+XQ6cNC=r~C8^WE2L00^Zn7p?gj%&S>6;FhVu$*EME>mQ1KqO#ab^FYwC zvXy|%I$iZMyNi7gSXlolO z0mr3nZ8)*+MB1mZ5d4nk15-jYh3FP+{Ww;n)T^e>8^5AhrhLePmd`0>(SMZUtCZT< zRa0=+J&Ce%Ly=IMro*(B?f@d;KRa(7oL}i&*Y?_t`evpm!s;{SUy%-pp)iBuFS7s~ zhTC0S-(%1De)1g7cPx&_2r(qOJ(Cv|s=K4~H-FB?fpe=v+Zs8?p>1_d#1_N^p2)2F zm7YlR?hYI~qqa3>(DnN%U;?q5BKlnJ>$Pu2;(XhCt{+qaf2G27uD`=K64g+@_^RFm z1I^fOL=aIABChZ|JqGG~Zzcch0b_d%9{Y>FW%?-QsjuicUlFkMxOI*~LepSTY8!Fa z537pnPD^mxIs>`yA`cwZR)`i-vb2$as$Bx(u@2g=Oq@%iJFzLTch|$`-i`uoe07=0 z1ES02GIY$$-@tLZD9_vwQe8y(l))^def)Di9*88N_6Nh`D6%hv@Ic=Z9@@*mg11Do zynkA=Wdu34EF%TWD61t#II1sW^(1ih2{>9a`L6U-9)TeeuV$SKWEB@e7P-V!Oz41I0-B=j|-1Mnr} z8dxjQnVNQ`@7%M#zW`dse#be2b{8Tc)fu^=VLF4ulmI4O(?%a?mzqj3c*wh9q+}Bl zlP;%r$|q}%ZRLx|?x;!=QJSq}Ip%7|lO$x9kRmi95>yZ%Y2_VuQ zj!5IphT`Z%)xCJoaMG4E_7B)Ymf2L zRNIb(fnq$*?&3-j%<$LrZF<(X31jrQ^^ST57UdM%LSQ>XU{_0E%@*c?w~P=hBiTJe zA}NWUSa-fqcapq?eCext*7rD3#~DWz^?>_}bWc{Ijw7KC(n1{sQ1`wy2+J|ZBeUm2 zVBNEP)r_jyAvbQN&S=%~f^NL1n-Io2y0k&o!FkJuf*>jP&3o22k5<;=_z@elWh7ib zL7YwnaY|~Ga2m!(z%K|WZ9Z=yznl3e)2*jpOk2)d$j(9h0YntP`+w)L1iIlEmY98#zKS-tJwWsI;#x!Q<5wcM$DjMTjBdFII=L3 zkSipa6KqR=N8crt=AyGz#;>~v=MwxH^Q zlfEC=I*i|w!0I>gyL;&O#9M#g>ihdvM$dZ3R|Et>y@Q086dzmzEfLh^AX)v40-J8`>yKM~e+>3@^5(ukc>%fkKkUov3h!%qh(`Ny?*mt5 zk$q6qA;WrbVfs3@`Z~4}uZ?xQ%FtLEfq@3dE-5#J#<}k$JBV+_aWPhljwr8O84>D&` zMF^t+b4rX5pee5y4y*5%TYbMIKvx`V7@##;CbA)-xQXdWB1+!VE-(W6riHxNv{v4y zLJ$IS4o;5#zKX5BhXE;LjiZ9iQhr3z<W5u?KubkWpB2hgnA3kL0{TdUz)TgX*aD&XRtFI?SyUeff=N~f^_m?e9G>mloc?*e#bOjWv0H0*Uhh_jAGX%51B$)2G32s&2$t}K<5>UP41Opl_ zZ!(-ApsNA&e8&1(*a1w{w$hrYZmzI=d7igM&JbWv5$ z8N`-UGYxb$W+*HHzCa3w0`vrwDhr-74cXH2{N}kbNo+BBIVsemv=5Kl;u|N?+AR$E z@O_-;(U~wr@Ajq+{a&&=q!{16=qnHOWwS{HGmT{2P+a={>hk^7#rWpDi})rX%!Zil zvS?i47KA?`^fl-u%y`14Th({UHs_c9V~E`VTdu0_4VSNzMswcr z1{=*4Nq|KnJw~v1?2kidGB7iy5#eK#)~N4Amv1M*yW)6};JuX(y$Av^9NsW!p;ckC z9T5(*ufgSO05q~^pJDSe#GZ8qF+A{}+q3d;_%s1exO`7YYoK@hob_=gOur*43bDfK z;2I1ncXZ-9gcBYnP6$rW)qe&jT-rCNzaP7NKMwY{l=XKs&|ml*VML+cB*tU9JJiyAMnKaEj`P%DA4!8VI)sP9eIAJ|((-9FYN$gp9xfMY8k}IVqMWq9L2={V zfrkNo?CV<3U)k_K49BhS)6Kq5H%qj8b~Ewz5ZXOAh}VDWi!r?)4nM$e?`-xR*~~=9 zC`S+LW~D-6Imi)?94r#~{yV1g9uENy={J3^ZuY$j^sz_2N?`Yd?UBsrVf(}P?>EOn z;DUQ(Ro{-yzUL)8M><*i1CNV40>G7ibmwjlp9IuH50hRIN2j@&wjBg175rLcUPv%SLn-~r!Z-y@rSj|A3r zrPN=TkB#Zr!L2jMSO1NV&D$9onlxX1*3CYvH22n<=DssHpzob~|7*iwk;u7ov+sw& zxu1UX+=tlkUkQ5euR}lw>0{z%-$V(=i8tYR>fhq%eJKPkFkZuEpFx6UxCz$fe+$dM za}XA@YXcT7>b!)^*-Bk}-;D;}jRw%jQOETL#*3Pyk|2#Rotmu~5%v&8Ju|HeR$!*_ zad=NCNE2R3i*5!z)X$)Yu`@~@7c6mB%V=ik8p0OWdq2$nbX3J?j zvpE{iY=tmeN#mKVqVddD(|Be_SZ8Z!JhLOqW=GL@SR8EFcxG!WXOE!q%nn+}w)(;G zu(*)E)&^f|L%?t1X6T3Ss~OY>FoBbpK zDlt6~>OEw0&uQ?@L7$MzbEwO3xlA-1=rJw4#~`%I5VY{I^yM`8a)NU<^?T+F)D?hQ z5f1fV+AiKlhV|1ouE94>!g<_HI0NRt!P#FP4vU0Ybb~KCNLNt|+i<$lb_T(PYf%5G zzP2pXSvXzwef5m*@6Rxu_N!+wxh{ zK!>d3vsfn2wV&uQ9oV}88T_T zgzX1)aFpYDd29)(nOdGsS;mtWm_@`>k~uoKQ|!wAT&pNXU^b8p9foiI1?9Sn#0;OB|7PRMH{(z;-8Btt+Wye1I=!^nawQ_ zMXEVCWM+nDAix(@ee0j`t$&8e8?9p<8-KWefSJfJ6Tyt}(#Qh~6UqpY8*@GsTF0fRMv%D((TqFjrOp$DDuG8C)ZnxNR79;FX#MLK3#=4MWxK{ zp#$LXL!=z(5XqJ`43ECspYh#J1i9Zag}Mm$2PMHg*J!)>aLd*^mo+%+fLwNZ5)4m%|GakPF zG=PQkFga+Y_5AldY#J8=EsYm@PT!xO_MMa9{`n@j=l(Oe-uR(#tNKnn?K|;wfR_6R z?2xfDhv)avvMDYENE&-z*VDc(VCQjU#v~M>}z!}GG>LFZ?WmE(^_}(=)MGk{S^SR||-&Scpw+x?8Nl(LK zMgIGB@+yYHt-6mp>(TZ7>S^DvXfBRw9Z#~ksM92hXPr7kw9<@_^*!w#_;0koClAh% z>zI&Zb%Em?ZE>vZVvDZfq#cF0JD6w;szWDkksUu(aH53#MGaf+(&H16vJ)i~7aeRB z$gx^N76pvvInKoyzb2c}fB90-MIh0AK##FL?XyZ0Fv>As!ZysTo3=VMu~@?>vn852 zQM7_(1k+w5tqc(j--MtCJDldnbea5ghe&OLjDTE+vS$+%KPZVyYg9+zmcT%`4AQ~#tx(C?ia0c(JjN( z4$*BD1>!y-@=087jWP@D1U$<2=SxyN5#%wm^Q!trJnb6+q?0TTt%S1*p9So^j82*n zOa{s1#&B95^py?LGJIvsU1^<5Yeef{I~$H8?E(MTKWeCq0Rz)`u-;0`wPZ_0OpkNJ-o?xSi)E5IK=Qp z9^jC_2gCeOk#W*&(Y#!TD#%P1KwMJB!NDhqN3<)WgywacCIr7O<6)OX2hlXH zdk|;c?4lz+Ns~H|=-l-P{Al#5d3Cs^34j2zxbx{PsF`4yohN6iA zQWHJEn1)nN!~BL!ssLm8+e5$tw4S)hmk4~JXCx3P_|Nl@bD62CkT`Sz8y11%-xd0t zWCzZiqBr@XC0w+QD27Y8o;R0`_XuGVFJTj8a8C$OP%o(JyIk+PTp!qH|5;BwJ_Obh zn!E3T<=yc;u>AEte-PFeH^W-}FJSo_hrxQAZu&vu-LVcb5*%aY9_DeKRNN!8R~xCG zhA`r)OAtuJ2Tq8+!&SUlY3Cu)wm^Vl&M3`A&s>aIW^Zgbo2Sb+n^Q^+)v=8W>VMG@ zdBLN&usdvYNuwF)3dWExg?rfm*+c|mAlI%j$NcR>_UBJHSS8r&dA;JP_-Dk z&y9JN_NDn3H!V>eTLfJ@N9IDvY2=8FUhjcRp2N8|`tK6|{!87hb{6Bgl8A!E2OnPT zxR3o2FV4hS)Wp$Ge$6k6;};d*^SIR(Yqf=fy^~LGqKp^gc>OefQIR-vt$Ai0{~qFb zr(*R@?|kA(AA1(s{h}TC6PKH9IiGrLKPn$@3@%mj@7edfS#LoW8yy(jkuBS)3WyEv|jKAR3 zO(n`>RL(FG5!AAl)#4vP4^wj*M`<6W^sk3jJMN}&)*nq=B(~b?igwNX6M0eDGzM%f zT)d-5c)HsqGh6D=XD}YLd6N@a1jq53s=!?%;tE)pebM#4=z454o~@23#%O1>OnMxv zhC~7Yaj>Sw)bcdkUx8erXr!0xq_#R-$|)O&i@& zLN|Mer;s}-^hgk7RzdC(u)*QBIDH>XOca>o{u#%~$BiJJ39%97DUsS)6iA#(HhF|L zX%dRp*uENgtKDpgLtcBP1k$qYOC4#o7{sIT%quyDp3I5{Rg*7|DXQ+Hxc^DF!fa2` z^=9c@yb4z;lhRUiZ*ff9War&!oSTzzZi*W%cOjmXB5n|+8+y$Dw7Vx!q zNORj(>D4c5t2`04_Jm-e=NZ~LrY{Bz7L~~B*yY4HJPpz(J&Wg9qG>`q^q9jMgog-; z`WV)TM)EFdpHoBhR2jrwQku(S<3w)mm7s*bqbN|alpxp>+?;N=qQi}hG7=K#tPi^x#4MAmUEp8XzQU(#_bn*GdVj}`2AbKtZXUIcMCD9U3xp5K<|o3>Epo`S{Ew~H27eIi!u4&gORS1@Zd<7Vw9^SVn{DBu9EOT zNtZ(BDj`4JAPl{WWuzH=5Q{7|Lt3Du3AykFTa0#<(7m$32dG&>`oiFYF|LyETi7l| zysISq7Pd=)lo+}ppCq_S^g|vbx=Lb)JVk&8p&+=PJ0g_kLepqPFWK2;*kK$x)f%^cRE(BCJB@^wDFYTBfWk2 zNT&`PX>1}xhxVAkRn8qwetE-2s>mNses>HTrefM~@|!-K{O%l1em@*eelv!XANX)6 z`3XbG&#WjkGxC%6DH;)Ewl_8?PyZvi#sruo*vus3NR~Zv0GojJUi>0>Yp^f<59L{K za>ZB_Pe*-(aB+qkHIQUP5JwZFcCJ`fS!al3gV1|xBFVf2l6m36jLEzt_WihFGVhil z>-zs>p5p(>ya0tMhRZx|%`lm#pMJB<!aML;gWebI+;SS~1m6Z``mE_JF z40KpsDUONz>D_g!RvTBXuBx;|&RbRWa;<35zPz3l;v7L@XC%V&=_XkCb}w>sM2qf` zCn_!aM;>RNhVSf^9A7y^i(3Fg7USWc&L}&RKF88_= zxUwjpVej97LZA;uJGJSx`Reu}OSW1sn{>#jdnYYd)|B$xOWZrA+uv5SB|Dy@K~GxO zm|WM?6uMsKM1j{XOqKQU4g7Z!J}-tdVR}Rl915#)j89~56OuV=vSQv882A0cL8_fD z6i1O-UK~9s+gwUJ?7Qlq?co2lv<9%_kHf!A2l@sV*X@p=(uSt711(1p*1>f8(XgaK zW)vy+c>gke41F9QTDi5>!*Z)YMi4wnWKsza+^0Ojt<@sSGt9HNfjw(nN8>&$BG+Es zYaK`k$Q&9-#MDHJxn^}jU%Z%6lauMg?HMur$z z*+Xf6mUdZOdE5~g7tJ8IHW621rD0JP4b$xp(4h8Er5;lRGO_JRht(;WoZ48kumvb; zr_H_U>CUyi@a?-wnka800Aik`Ii4^+dcu?u6XHf`=P)~XBbleg*u zv!U5pqSGndJ25154u_y9BKPkI0Z*;YyJI;7HR_Ovc*Z-RNr@CZt$&Pu=uwAe1T z-ir&W(QgLIHBG;GBy>CH$9e(?Lo%7CA217ERt@S&NzF!(&=BxIdwv+dbk zgFP;Zu^Vyjj+4!%qOuNKDPe6kOaswY^YF}-ybKW zBpTwz=O*_a%w1Ua{y1}a;&f#VatP!mS03y#w?3MgBbraD^QRum&e>`aS|6P;OSBYQ zcNr;n1KJDaiRzKEB?}jCnPhE!blwxm~35mSHjGrmzXL9^Z1wT{C&s6a<)%?r|ex`<>8OhIDj->drmH`KAYtqsMNbt1w z+l&YleN*C6`kmB!UY2>qTx;tzdTDy<+rXZnbBQzVmwZej5 z3JabT7W_h3utwOmU0Cp&@b_&_VZpEQfD$rZ_{6g!4?nzr#gCcz;XjWb#pKSUA4PoO zIpm^R@OaqwY015MzHl~=INTL-zHlzB#@~d(uLO*{=s`3T4vxn?@fF`@phOZYRAlaPqPpFMTu!jr~Lr)0>QpNXGp?DO<{LKtiy zDhfXz@?g9uR1JAxG&t3sSY31-mf^|M4GsOZZ$^XT3XNz*^2KA#3u_NS6svQ^7jNsx z=9d(Qy})Dh&VkhIq~pBq4*u1vwR<}{_P&~I{6UuSKo=R3@o}bpO2ikK-z6gFY0LG4Vgo!IS)M2OKNHp5b`tN|D7^1 zo1EwTuEI}~-$Pse1R9%#+XBO&ejR_PZPXkC<*K1$5DDhDjZIC^F$(mw+S{ANOS&&tlR6Mj6Q^Y?EwYxyWyeOVgHOntYHj}M1(f}k)ba3DDd zBqQ`#=_~~4L4HF~iXdE!ixJ+RuIhF} zmrJ%)Kz}PePkF49pQz2{j%90=YTSHK$Xd*8uR(=LTS`fYlKnPHiBx*!Mq&})YERGJ zRrCST7huE5;5oY5w(M`BI|^l0MZHb5(hwSGNAVoJgzOD?wmWx}+u7}I^Lf}y`c`Vj z#v>@k_dbYVuOakrh39mU${NdMTw1*E&fc96v5Q|<2@Aq41S()@od?+{JdZAeTxr!q zT+Wzj6s)xKXh$RO*)*l}A<~ObJ{y61zU2^!)FHt1*m>xIb~Gt$qXmW0uuv()>Uv+N z{fS(Km>dHN8w$c(VcnsHV0|F$K^gilno%6=KMqGn0{52GA#r99PeG48kAaP&4&%z; zt1VWRDIzaT%^GB`jqAZ&*bfCy*ry`8n6RwESSAh8(1WU=*fPnjibSy*Ss55~7d;_v zOv0J%&ix%5Uv#XNU{P-dR+7;BJ9T-wfi@q|8sr9Fh^>yz0e{Oy*UY_cm7oE zZni@!97Qx5{8o5+e(orsKeGP3-dy@ibLo@j(qEWM*Pu&juHhW7RLX_-2Iy-o_N1b z=4ha9)h0zzh(fo<|NH)1E^hQ78@Rs@zkq9QrNHZ~oXqg;D8uVA59$ZSaf=f; zZ^=X}SJE;Xs?VWy#2`wcOeY8>nDF{S&%xC;%S2E2cvD~h{POiEYR2dJ@BT!96fVnq zTP3Zoho9-a>l1ocY?A&h^3MH4D4Qvi6$@oW7;BYkR&0!*kD2!Etlw&Yz3qOja&~2q zHVP)yIF-Vwal-h--hMj7tw`i6l4e_HmlZ?Au)b7yEHxL>l7zBAI_~Kg@z=zKXbhwU z88F_H9Rx~(w=6BTT+pYz)>{eH)6W)-YT~@0Wb+Xqu-I4;#P*w-%-onDnf3fYmZh%A zRhUomW<{>_wC1}3@r3*{&D8R7QFE$ym8ia4P4%A~*Va?bPiFhoZN9p`*?C!G_H}K>#-FPr(rtest6_(!ne0CVOV<8)ibS=}`1&;M!%gu-v9Dc}N`d}$eO+CEVznc* zNrME7qx*wO&?9X(K`NHOc+%wc`~9B|1Xv-mDISD+IVX+lIl;z^wI>|_Ttp}48--Vt zw%7YJ6et{onxc*$(V`38xpZdR(I0qdksdC=L+`7>hcoG+hfl9>cH}WiQJ7J(HfU!P zv&KR}T}=t-Z~exsFEPZbVTCjMJENdueWOx5%?t5~78E$`H!lfyW()DR+P4rVvuG1guNao##`z2IC^abiv9B3A?veBk4NyKCNm=0>f0R)Bk?rEghV<(=vZwa3pOE}4`w?)o zl9vSg2I#@obiv%c8eFmeuXjb6=6$Wr-Jr)`?dR*;yQ88{M2+|?fwb!Sb)Ufj12XK9 z)8YQvkBvy@JL*--dW7iQehp=USHit>W}rs_P9SDWRd_7z3|U-n68T2Y``D9nZ9 zrEn@+O8;p&s-R>gVIG;T1yPY2I|j!phIoYhJXIbK8+o;D@i(REGL!H%65By9wrAUS z6`eA>6?u9{rN0m6>;gqfem(fbL~bn|nlo>f_72EpljeRnvyw8j8)>xH_nZ&8vfzqg zZoe_1!}u~w0=v^i)E)5uJpyqq-?&MOKc(&!?|mA_vGlnI1w}GXqUi7l1Tz(7g0bKfJ{vo5o&*)lmn><4d%v( z0<+gBOPc{fV{V+Jkz@#$)46i1Wr?t3Mjpa^XsxR>QVT zX|psf?hn^N2K5lE*|f_!of+c6E*OT|Z)&qmS!>rdD$KjI`FXC^M;n}CT{Thyw8XZU zb64lMVhKa~Jox{?zk#!$=jIeygvOs)Ps^>UspY00TO-q~MYL^6m}6mce`bzlZqg!> zZT?5V6$WsHSufAoKgv_Yx!bBdMHKl%x&6#Vq$vhRjW*<8WpCA!Pz6O{x5xEXSWlv} z2YW}C$ESw6o3v2+DEDV#Y+Tk|>oRkVnYmR`kpQ^6JY(ZF7q5eXe`=gHe!;w@MhVHm zuRMsInJB|+bNqtLe0&=yFyLPXe97q?z;~vM@SRCRse#Nh&m0`<^os#}+1ub4Fh#F90fJsWr%1385Q&cjKEkYAOMz%bL9U?h5#saiePLlO#0Rz)uH#C~nFuq-gVTmg zmQHd;hd<+t<{^Aw*2l0$;m5XSuDfLg>^d2Rrc)};&jvCNB7G}*&rm`+GVS^p_3KKb zZp=6Y&n)=VG%3i>04KVCnA151YM3ydYG<0hp~_q31K5WZXO+y)06GB_?{goE`o|4N zVqDxg!%LBHh`@1Q{6n@W2jNO7DF&WcuWXdIFTmNqmRM9 zm8Kv?fLA(ni!I+wF|UOYQV2j%=^bv|-f8%}8O-O<%&IkaX88?kXh z+l9iZN&2q#&9{kvcXw8hi)c7bB}!+fp+c!ml=?->@a}F+{&jeFZ?NuKK11v9-rxp- zca7wM)L*df7HaCiNpC(xHitPyZg>%%sBS~NDiB}VsR_iFrlB}bv3KpqElVlBbnVBb z2@zJrm);(M&FfobX}%geS`{S`T}q|r&J7?#yvlZXfFc=54yELIfBA7~vx0s& zKW5@aGk!ndSYX+h9C*lVrRu@{9Vw#uK>h1jyW8CkIu4SE($Vue7TMj z4p0LM}AgrkZ=51`Gg#E zgsdz=j_3JPAy>;HxQ+;g{eW&Ig_&VzeF;H!|13+;Jrv9JoF33>wRe~nD2o3yAS-?D zTQj%Cko_%Ai~P!dBH=CO0#fL-k3tpp_|hC(X*{_dI3VfvrNL4n&is+WoT4f{d84Lh zpiH6k0Hb!@GSt^__j_2&lGR)<-Zy}W64SZT z%d!)0PI_)zf4z9`fQ(LGOsjA7p4Z+LXkUH3xE<{)Epy6N>dZ^YE79$X*S>5kR;YI} zK*8y;m)pzc$KrhulMaQtOc8+z+Plv#Dm3t4;CEel*?a;LY*eO*GAp7{0ueFG^YwTk z&EB&EhV;+PQI?!BTyfoiS*PoLk-9zLzf)0MGk`0bBk0d#{^^Puk+7h@J}^yJsMiK? z>c9k{5&|Bwe5ZMfsih0zu)3v1y)sR4}|-Oyxb4S5ma z(r5xN%tKy8x-?ON7uk4mz}fRdhDt?PD~8I$cyNcaIG4R$IsEOTLmmLp$HE?jmWA-j z8S+By(qMhq9BX9KzgQWzUWoFP{@0_4a%r$Wtd%y<3M<1}-7?r}q)UVKVXa~Ut*|nz z)j08p9ljuL%u}#TzrXZ7TQqu2P*oS9AlAG=y*mDLv z9)@vea!Yh~&$W*fU0wa1S^h7s7q{IYKFihq)vH#hy*DHaYSlYNIu-Yizh3OV0l_5k z9TS2$?UDGOcs`uGhX{kDm$S9%vVw}Tf_uvf?kp?FFJtUj^BY;2LN;m3vSkl0L*C}q zTur;o@rA=)?ygX~aRg&P%P?%kpp>V+824qXUtq1mxo=1-#(mi}&$3qG=#>H15bneN zQ8tA85UnO{2`iltx3Y2_{R>GaUs+K$$bF$<(py{&XRV?GtwP)I(b7_VN+MjOt3Y_#Fr$3`2@ zeOT49A>1b_R2Vk8p~(*CK8V>eg(mPKoclyYB&Hznf^lCqE{)J4hI1c7g>hdtd{*=} zocq|@aPDJ>hI3zNSqQIi?h8>O&9NphFW8OPdWE=8R790wE0R`18)$`kCn`pk zDX>0ly(X{s^Zs?SE(xiJBX&e& zHddD%yf!^zS#EV^p7DuTEwR^C?{Tj9-Rq3klA`^8;M7O)2aZSsG>3hb%=+Lq4<`T^ z8)YmwfAT;}yQFaxzkOZeX6%beiQZ$J`c1$nGf@LPj9Tc zv|ctrM?I1kg4h$$O0Bl6BKqs zwJ(gi68Jr#vp->{%&iAC8v2`7Fo(0I;&UJZFxg8 z#ih`I45fN$U`JLj4a@D6*KH8XCLGJoOMapvN_z)9DZjg3{MdC$gWi6leCp`lKWXbb z;kt6;K=Zb>P|QfVyFn_%5S=ZRUgdVEDRovzYxBRxNm`rwp6iv%<&wyRW(AMAzwa9S zw##LedT!$rYbv2ldZ10V>+;*7(z&O_x!tdq$8yCfGVhfe_eGUn(FhT0a|9KOW*$c& zLSxk{N@uFeW0zYGUDA%xs;8^xcmpXG+^}HhELvb^;DP}8K*unWMsJ5HO zqn7A6x}=nHtH1uEG$n3XdH7pRkAL(;0$1adC9kogPy#NmByX^%x7)1W+;S0h@h(1v z@v&cDNxy^$&J2w=h!42~hMBq%%CZPjoGqj{ixFx8=ojhgir|~tSi2#srLOXfT*9j| zVrqG6)arx@i&b=Jh*@#}aMl}!8Lv|%c3VG^-uJcxhd)R?Ya{j*j)$8QbZ=&sbZ~GY zkZ|JGAjX?x7=yzEeA6AmyG!~-0ZCwkj${R3d-JgSIo=Gsks;~|MWY?R9sGOYU|Z8w zg7@ptJM$sJAn8)hKB~o;HQ5eF3LfF`r9!vzVaFZzy7CIOL9I62uBsS4q4e&|6&KI; z=$22luY7dn@4I{BDbU0}@5Wn}vV$4(%H3^-GT2c+N6xLsn2o)BtbMgQGyCG%6}puV zWu@Bl%X8K5avg_P!$Yc&R$`-sOYd&r9x!W!4ddo=j*7k&dvceqEU3yYx>^63|<6epII_W&loC;U+Rk)HtDX8LY zdJtHlpPvN#fo+fT=B&T3WwmL?5i#BUQR$V)(r#JS`L%6|tSf8t+x=6&$@=qJI(wi7 zw#PoYE2>5hGY#JPpMC__!YfMef8kk+UW`@LABm>05pe<0YiS7=Tvf;WYuRl$st0?k z{}&%Ud0A=#6SsFD>klF5riVY;y>(~uv9%N@Kosqt`BCqcA(qh!(k7Kzn6Pj zA9XuL@s!$LZx@ef-7ksldpdR*_qT6|N^G(>rD)G>Yx|S<;ke}XwK#6)cWKiza0(P0 zPjcs4`a6j(!&M>s=aOkSXJr?_LoJ#y2J;DCbgvQ%bE)SjTkc0RsIps`DUZ2N-n^C_ z>0?g3RUfr+{F!m&IxM@jHbLu95%OA1vUBZVO>+In2_?d%B@q+S3=?v1x#i;A@3zHH zyEk%Me8JqmY-_w9)Pb^!QxF_P0*sD#jUHa*e+Z<&{^IeMiT=_i*v_(p7_|4FCQ6av zSIZjL8Mzo)@MMQEEe3S)=w&+}!_Ow01)JEjpjY4w#y28r#4R(uaRcs$(sp<(9A|#T z1d9xZA+CgZ2votd_vjfp0t7}3!Fds)&eb2n>vw~%v8Npb&5pC($MNtjnPplY2;%$| zI6=1JR6*1fq*hR%P*Nnj6h{aVU^IxR_+`#HuI5fS7u#HJZEYS`GYzMcPnE8g<7g6l z+G+Xq5ubUM;0#7--Z$++goEgYr+*j{qFWij;xu8gVF(sMXG>s8utw84+mC)=h*Bkg z_f#jReKc9VHvIsmyqTsPHK%QcD+qE~qkz({u>I&7Sa-h|h2segB1sf}=lR~F=2n?` zVKcD9;nU0;+I-ubAF$~Tc7;B`a-Wqv@rIBhy47OY9X8)zwZg<$94llXz-6ifa*TqYu}Q5$Q2I|H4NU)a{#Q{2olljZ z{w|%j6|t=zLpII8kgugl7q*5iY}-#g3)?*l zca|-Dschkk+B#1Ot`7}a-!U!X@2@~=wtAnc-A_lj;+P$mDmZnDto6vR@TA8m^Ne}E zqqTqc9cwzqyr6A)s|< z3?1v37px0+4temrb>WL)4?4!QbdT9_V$AcOjd?+$Vl1>*bLDF{_nGpkkGTKC*!RFi zS!MmtJoASE9#aMw5HR7J3JR&@`1a(X5?$EI_1padcNS z+MSsiMOI5kD|2<18I??N-?X;GY;$dAE33_1w=G5aeb0Sn259&FecsaXdG2%noO|xM z=bn4cx##-co=KQoNVl@^YIY_Jj@0S$cXMP>_v6^oA zfh_tbnjzOy6e~YVuKFNZO0;}U^>}3_Up-_Q{namYOCdSQNy}X4kdb&}yoyCOFX@?L zr7j`by!-p5i(RSnQzOD4WA534or>8}wPXuRC${BDElZ8mK=6OdNxPVt>LpHd&>(JB zX9x6?Iksig5##&eMrG}s1AD{Zdnz$KqjFmNSkHTMbL3>?J#!D;iB?T{$)0-iOI#z` zvmTPK;!eYOtQlJlJ3m$%quZ+=-tgEqIsb||`lVHs8`l1cGduXY=wI6wY-rpLA0I>X zZ*227G;ZY#t_rL~zG~Gwc{4KCr7Ve>6KHnUweJsH!6j~Q{($L74cxv>_q)O{YA}bg zWS)E`TVaOvJg%;g&E{p2!-w;oXJB2=CMc7>V&>kLuj8gM**y)wBCiac*Vo^fOs0@# z$bh&qn~tgz3roAFW=xoW^gV(@9$a`N`n_aG+4Bq&L`3bqFo&D&B~lOU`faXfNTLyh zibSD;&bI~VKBfJcVorD;F$+csT3yd|FdxJGL}C7DVLs_JMqN9zm=AvhEDv44Xxl%EJ9v-X){1!5#9x>h4^NUau zywt>)qW0oTskVoJ8COg(kYkS@-HN;5Dn^@Go|e}W8$|XLNu8tm#j*05;zZZjahBbe z%G2d`6pJaseNylpI>v8)#och7?y+MiDEKa)>y{jyg7a>`L{0-a_KvPZEkcCR3sS%F>G9o4ZC}W3M zsv1&q&(OO|MQx`z1R&cqH2%03)(gy{04?u5FKYL|&er63w=GK0cC^|>!FeNnM@rv@ z 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

$7Ms{EcdC1DJ#|PP7Vn(R>rajG&5F3 zWJ%jI>y5O&c}i)*4MI9@5Q6ZpVR#tIV?}*+8gAlJIm0QnC1%0ABax6~J008=V2I}C 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∈r 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 z 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 zemʴ{xC#PornHU8TEpksclgkLVUFGvo03C;fqDM<4tiv6DS^W7RL|BRRdCnUl> zjpqzY`de;;kViWqmOIv!bnR}c^jM+(6EAy6#?L0{8yPq#knz7K?_=Kc(z{qc4E+eR zOjMX3pFlog&m&am16W@T!g^_ec*T#`J_Kw25UhH1H(+^tRD>1z5UeRUJ7vJ`>{YC1 zd3b8@U=M{ESF}sJ3jfmyu?f=?<|V8cLWPE)X=BEWE%%mIM|%Rk1~cf~oYJVIcd}Yk z7*qavQb4`$po{7aw{Bh~{z&;zWFS&PDU-S@GVCnq#H0&?GFoP7z5ikS0*$I`p(Jwp zEN=(a--9n#+}wi<8lK~L18nZ=1gi62*d{z7T^{Y%{I*(7ymL(8KaRd5^u{Z9aV}H$3Cc@S_@D3y z=TKBM9aZY1PD5en5K|D!yQ!WH@jO)(s@@|UoLd@wJ6h!l>{3@3?_Q5{1UYfl|MM=U z*hbP;=rs6y)USdyB_)=b_CT@Vtem22VEn;(h$~;ZeK*nh#GRo<(?`!*h)AHtn>Io2tAuR?AJ( zbMbjW8IKn$gU6m(+8V)zHJvCv7jh=K{+htoUqOLvSZjFGC&eA%bo~{9zxh3)aQKqA zxv8KNoc3u8VdU{${&GL!>mXfe(i-38zxS@@({?c>E2uL|3H7mzn8E_A2oXMZWUX;3 zUrh=qjVOAfcyY9_E+lW6B{RyL88JN@ciAdBY`c4!7lr*4*6BcbGbZ?7kWuvq1*lt3z{Ng(H7Wk=0pYn3 zH)xpKl0diGY`bhaC#*MPoS=+n#L_y26tl|ME_F5IKCs>%!aqi0R&cK7xH@J6%TEyN zQ6=CCQrLuHynz6%-%jpi%W**E^xxpUA;2Hs@&`_Ga(Ux6ak*kPp38nMoB2Q#c4 zx^29g1jV_{hl^DnHB@DIuRJI4=e^d^pab|K=tQW=X_vFESO@r zBQt)|odLU}A>y8HyO~?fVD|bhLu_WUINgD8;!T%%GOR^5+g&drE zW;QrBt(sa#qXfu&ZX_Bq(eL1Cq(3AYCIc0Zp1mhF=!SSHk`0?EzxfUE$;rD0E840- z-ukbEb0hg{9>A{A*!C93kMu9zT)Lk8DtF={Fo4RWQ z|3A{+1uUv+{U6`6=K>5{9S}zpthsO*5R03Nqy=ar-U?7B^k@fA5W9WVLusWodoUaj zPcW82S!bA}@K!>dGR+g9%`q>()Go(5dXAc$%(P4~@9h8QU3-R$r>F1tdH(urX79D$ z^{#il@4N2rdRI+-joaB;Re2~nv+95?^wzcnkHMU2Fu7aX4{bis{dEDCqb9V*-_82V zu~Q&42kFt{+Kh}&Y-xTx+hLlr#W{8=hUD{!H)AvhH9|y|jnA{uj)uRtOEyjMn5II3 z&`RYKTo1k{2;W@oma~K@oMFmknAA8)e$OQ40-4bCpiqkwWfWXK>`bvXk>%Do+QOP| z(&itWfQfS{dX4tDqP;Dur7fYdS%?=(D;p-&#*F0D&a*(Xt>2yU=N39Znfx^R)v}II{?;ET+Kt2b|RPV8{aBVgU5wSsh z>n48TA?=YaGG7xzh!qxiWuKfS@ctboq!WgtkoOZYk*ci8TtZkDyLQ4a)TZS1L&c%5 zB6_aYU0UYODDx`NfKJmsuAQr8X-84oqRCv}be3eS4wG5*T@+25!QwAO7|oQ~7>}im z?a4Q_Z~CSzL*`Rcm!{o=p#4eH5v!fpBHA>V)fUcT4KkIsLWH_w;v zMT%zS{p)|{`y)k02CdOzdvMMqVu7hW5<7&@Lh&@k!R}`=CpaBU2J212YH;vhETS45 zbo((vZVrB`-lD-`1iYDi#n4jHY1%pYgw`>EaQcOq#ZMIv5X>Rmom`j6vWIUPmaiWs znV)(nB?OAnPJjoo$Pp#3^yjx6?K0XZOk_-%91t&Y>x$fu#D@Kmj>E%9^9VeBpy~gS z+CwJTWZG%&2F7E37K)iYyX`irbC zR6iNo*9e5^Y2@vCYJ%Jr{hr*aDeZsD&E%8YN{VK3o9Hh!(^FQ}4@%XOn3h$)NM*tv|cMt>P;N&CSmg*n>4;!H2*iL%PvBHMzv_Jk2;lj zCs8N24&P!-Z+qldqOjvUydAo;)@IP*14j2&r7&E4kdY+oTf#R)ZrKziAWE15 zWd!tiGz)z+!Vwjg)Ho|K%^;2=SQ>HGTuy|ENyc$&;!1r~KBFevo~mUf&eB zKN}-F3yl^nWLqVckXArV(PW9k89}n9POT$?ZqrngJ}U~lodlKvH;K15E68EH<=Bt= zE!p8)cz97FoO%LA8^?=BXW@-ln;ni_AsE|}`hYIR3xQ=V^J460!f+%tWWmKGt9)vT zWZa05xiRo|ZX~N_h&Ra3N;2EEWq8}oBlde*%n8v=Qgu4hk9PCjo_1Y}`L2$)B-@TI zPkUIqIjO~**wHA#dcxBl-fm85F(-FyAkpo(xqY|((VK8*-X1A#B--1}BUgKb&=zxQ zhezrWC%5cR@D&6epTX0Khg*a-wK93Wqr>|gJTqXQyNr$NxoNy5S@<;eue{a3W3MvD zM%)t@~ z`f+VSAO$(BjMJMa;&H9;Xdc>z;;nq19K3;oTlOSkWp@E_g4`@Mj#Aq8-77@Wd-O5h zrp3h_c)L$&dt@AoACGwEkf~!L=oyRMNWSqhZ>zc|UnS_5sjCMUsae+I8b(dPlF8`B zrcNYkaHgFa-BlDJ1fUW|AW|6I9bu=4T|C;0UhQa;%Cm1mMc0I*6K~J&|y3q@zNb(I6_+lM8`b0mX1CmXfC=A`0 zTH#Q%L_KieS+WeQcwWJA?NJY+)Dt8U&}W zWzv(~W65X!%&X`s29Y0H0qhgudIz7&|`#C0lwmG->S%7 zs*q3!GpQh&uQ-d!)6i)$O^C-vCqJ=I*>h`-na4Brk6AJzdj7)A3O~u!F6kU6Z6}^rCBLkpwPgC8cqRWkWEk%$j zqU_n+5;?G%0$bb_k;0Dm#RsUsr7EXJpB?3h8NdE2AY&%%f@X;hf;*^jin{{E2?SngKmoh;u0dE9EFB42ej7J-IINPFO!tc+}5T>`MiR zdbxm0^iL#c3Kr;&y(L)et8_x#vAv55RL4dMlVZOgxTrL9QB7F|?j{ZrG+q>O$m7&n zs_R8DlhF}K3I)v)(zdF7N^=jRqdUR^qJ1%`6q8`-+hEp-@+Ee?h}Az)q^#s^b4x}M>{l(6)-#5YFdS=wb~0O`wTh%Yux7T*{!_$oQDVGekA zK7==_JXBX_e<4>MQrTCJ_$yCGGjH2*m?>}r>hocg%0=m^ldb-`X;Ag6Ee$8y_ZW7( z-*Ji)o@Dh2T-d4}p%(6+g;|~!8{(!Y4wcVj;*KQ?(H&vZEG2c+T4CUrR1CpTUx!Fp zZY4Iwv*xie88syTk8%Onw`!cuXxzY8pGDVPMuD(%!+tZEd;|4sCkXFiqNa&+2sx&%;&F=c z%%A2zGR1Ad7^W4^V;HNf#8ZREjb|I4s}zUd6Zk!Z-^j)Ae~4#2o)dTsOR%PiXA7RI zc)|gfh9@7-sFNzV;kC`U?P4E!ENnFlUijNyfhc%eluy`MJ5G%CsJQ$(`BUFv& z`LE-#0jJzP`apz6tt|R<6xO>VYd)EW~BEPxCAmx?eHg3_5sdp zU*nTLkrMsmv9yswR`TwyU(LKG7<4(n1li>K#S{ zQ1EXB71H|wZy8w_tDK@EcvH!yno7%IVYl=2kBQ2G`T;BkKRh_ z(iH^M9PVFuzDzLfv17KXTVm6S-|9k>vPoArSkSk)xtb5wHm*~wiyy#d$~*aWRsGw| zG-g*93rgFLey7ag`iJ`+>>t^$SxvqNPZhev^(TPO^(oewPZ?b;(WCeO^HibeDs=ey zSvS1q_44+@743!3`GeY{(~d^$|JYSn?hmO;sQGB^k;3Qw-?ib__D0rCYAIaVUTEL) zk;i@dR72+xkBSD3n;LH^hW_;JVGJBSMkj5el1HdP7IV`crpesKWB8+ZX*yn2tlQTgtjBU9zb?LiyD1VvQFmNI``)j} zG(`Waa8Ls|G{OvDyoY4a{%J{MkOKnPUQ{Ty_XwcWQt)WGt8j&@M*wxlT0y zs9OMa;o|nI&g`PXl`aV2sLXwcL1w)y2IT2+e?S7*)F}Qq6Q7S`CBL{LfDPQ=3R;+uZSU!m%dP&fpLZ|H!S(HCf#aelVfV;c#^e%^stJpCZ5}}ermvwmxEA_MI2udN6G}JQK zu)Ex%-p)6^p%}dheuES(MyJPE+34igJu(Z4Oh#vmu@WNdILg~5=O;H997bn)vZ*0E z-r}&#DOEcPYy7J299*h#6t1>?ZS#jXj5YeJGfahlHZ{zNk2V!nn;H(pW7n%Hx$woJ z!ZoJCTDhnMZ!*5%&;x?p`TAN(F@yDHa;XgutxrIey)a znOpf5V|C-#{2DkhoUt8FD_ZtX@EB_ysLan0JVau2y&l+ZT;2NG+M1d&{X*WodM)h9 z^>A_DND$3m-C!G?>B}#*1$K!KlUy~KSOgr@CLCQ=IYY3l3K~xMUM1+`S|J@GZ~ps@ z<=^3S*sWV)9wk5~4%{r+rI!vaDqLN0o|*(M+05y`$fU#TMrY$8e%<5@@eheMZtO>luj!wAe}bglo^VO+i5DNdvBw)e0BaUMI7Lb@10X>gri zQRqP7+qWwo6yjdd#8b-g1bJRb_}eza6kRFaWX`9);(^XJoj9xcH=4sS1a~oXAYnvj z55P9}E%6tE)%=5l7*>D0OxWix(ZyJ`p3u;Q7Do#qTIx z5yMV1K4Ev_C|${TExe4E7>e=+BGZHznNPsQFliH%iRp&qyimmXIoJ+q9lL86pKPq$ zKhI&TOfx5rDlZL(;F62(C@Q-1guq$f^S8kJS#8Itw<8ZXyQIY?E4h++d__IyiJm6D zNB+gIb)0$wzn;tuIdgs<2NZ|RLH7fyR_6yS^0IdBhyTJWn>n{3EzzlHI*1>1h<28|>Sp#u{fvR~iPm9PiJzVFxYo!(`I4TCRWCj!QFQIl;=M<(3%hpHnga&A>Te5)lE?sU)? zHrjcNrDxx&cuWq$VTb3jY*MM&e+y<6S>kw-VBAQw{^N))wALQp`hsM=vkMroLkJYb z%XuuX+a|wZO`%?56s1U0JC*vh~N^{a;Ym$kxlQ|FfIdY+j*wJ z`o9WOipd-mqbpHQ;OpaYn(O7RiUcs%VH!N8xKf>0G#E_-9ol303e_#UBR!uQk`@ZL}9&qJ|2{L4S$Z;r>NzU_zyp00UjPh#J$8L+LPdtG2^Sp!E1rP7^q0R&*0d7 z9X9E!#zcq;;t`g=k85u!&%>Ww+gWM(MRA8OWdX-+Lq37{RXqut89ZC?AYUO|KV6%2 zRT|C5INX8uWZkhZ#GiV$*G~@=M3p~0Md{t zz3ppBbjny|e-LM$!d!YOqy3!8;4meMT0hMP?t;8~DkuY`{K zgS1HTLk8>i5pt2|+TeL&kqkW|XxN20z+Kag-(k>?SBaZgnzg<0&toaB!WPoSbCK7D zz*o{EMK^=1?1lThB+il{iTbI_7~SGJ2KT%V4nn?;dmji4LSE^ES;JtS>H}l-!F=q4 zS;=4??*lW=2h-_;d6vP=2G6qRtd`wFGqhxv) z27ta)T6q5+b!DApHq(d#Tc(sdHCG&jqAe`j~p{P-n#z~p=Nn=8AT<|*?gRGM`eRLUE zMnQe(`o>3B+Osn4gBc9h2j-9uW|0r3KZCg`fb#v_2eZWoqh>Ha^?~`D59YKF z=4Kv>)ZEbr=C3{&%W|2XOAO{%ADAsZn0&z0$#BPx=-&$v&oJP_J;2~)gAD8eABVt| zmJkSDxlIPoyRB}I&Rt0Z=5v9Dy0ynXGB^yuP4+5XM7=Fv^0fa;h>*wA>#x2QH%vUt zaPI(apYTso3sxy(mp9E%gBHUIMz>7Q9+qZnA9_~&Ha*L=J>-Og9NTA#+vw@+OV3t@ zd);mH6!)g5w40WZYO#UASM|_xRT5{*(A8hU0R+@NOQo={G{jhjX6?Q*wsc}zXu2ub zMC}u{X6@#31MPHARSBV^Q*ji4ec`;rb7-&epsltYQHZNpE{pr*k|F1UQRr2HAB{Hd zIR>s3D#-Gq_DXV29upoZ zE?~epK44UoHnedD8J^lt%k!`$#>4uwV=dwz82p4j1c&(uNk-AhV?+D=!2g*enVT@3;$z*KKy$l#8E7X;Wqp~lfyKe z+_h)i=fvaV_izR~s1N$nG9<S90v{)K+!4R)f|2tliMM2f)-xRWMAXc2w<-Xp^kzqdQEevC)vw?~w6sm`DA!K3W} z`t33yz1R_H0Xs%-j}R|0@Z$jYsmghxe2bi5LV3o0c04lfcJT}YKHLX)gA6KGP&(1{)3+w=FBHx%_7cWR+!u{<5SqP%A1tMaDF@VPVp}+ zh0{-AhM}PCxFkNr@XzCLZi;XGH@4evnaoOk5oZ~H;0Q+H(d%JzbJKf+PW@V@A86NL z1+VxolI{9+xM#n}UZcbUw0pDRVioSv8BEx{%e&*@E_ zUfczP?MnbXa>-$a7nG!P`4uWoAKDFb>KB$NgNgseVNN!gQ_h8ZmAzp+KLdu44E@=% z`&brcP57rbb>r}yx56`&In`tydCr1OjE<$q?;P$723Yaal5NwEOePoxaX<)}Zr2n3=tJn#C z{Kre&g3RFf>p*tLYNYSLMCMcuWQn%I?}Owq=*>%b4)xZbOC&wAqD;R7Oz~s zG{IgAFS>ot`{O0?M0V4 z*#TV{Li!ZmjmLRG)+d75_p@{NvG58F+${CP{{(_v=2QoCg&b`~Q-0@VU1_v|ALmF{ zqVI#|`*h`KcjkM~lCF5n{X5=+W{|Rg8_)dUfQDS9H7c{BF%z1128VS~14~ddzK3Fh zr%V^18-MWW#_82)Q>xLX;8~7m8=mgAv(v9{$U2KyYH-uAUE-^1{OfW7ft9&1~KupDYyKzQt{nkI9{Yp~kOU3^m$$yrjW zmzd09HdByB$wlW&xsTnnZBkc2y5e($H@B2%P{a5zz3qr3j%Ip?%OAw0EVh8f!c7Iu zm-b8I-7H>1?UMpVXwiw%fqf&is4TWXK6;j<-=q*rDPdb1ja-2i=|mGHLIVd@=_r!s zsEl_e92CvE)?yyxF{c%mNxApmw4J?CafW#NC3vS>1N$yKHF&!DIP?NAz<^Mnu0;vOz!qZ)*4x$*ku}>h~2xr9dJ!L|_bC}U;>CuhGFs2** z80?iBJ-UH{c?sAXd0W4OrYv@-K~%65XZ=gZzJBK;hF=H#Xh5i;olPB2^$}S%jk8gk zZfa1iQlb4f&_epeuS0FT&g6d}J9-TDJCN}!eaa4$2T<0)8rbRKapLJN_uEwNY3OgY zRPJvnUGpCQTKPpfWVM#jb!Shxqt&e3pEKBxdX@VO764ee2ST1hNS z>wKO-m^>4iJezKa9}`%&JaHO3U3`k5`pC10fPPD!V_jIA!Q;l$U9QDH0~+$w_M>ub zptQ|@?kN}KIhU0yuBTj$SICvMSkGX~dzB0F%wy#mcDp>EVDenUQap8=Jnv`tLwxdt z_+)ur^vQD^lP3)kI`nA0Z?N`EmTAYuE?bpfrX3NGH_6mQxpbEw>Gq(!+*;gEiDxCA z?RYNW8T%5(^>{F^md8|g{fw0E*#`YHccQ))GHR#v@B*WfkxkEvxukmRf=P{4%7>uG~ugYUK zc3kMHe#UtAI^7OJ1D!a1w$>HM{Tj!6V>p!R>H~}pA>Em4JaL`Ky$GgMO5!#mM!XyWzN8ji&etF&Y3=cM88CraqAfYs@t#_Hz9p-y%KXg_cpfkmPra199 z{cS4)ChW@)zh5C-RP!=eOImSWGDSz~v#z7R`=JfTT7xnCjqeO4qzqK5a_FbJW4*jP71-YVjvb`L;7y&-FfS>S6-c3?qIi zun>;%yghy`dfZXc`ftT8EXB(VJ32fXl3^@ApW)ZB7S)6i1sjr;(vYkPtQU%)(w}{819qSQ(9Qf;vzbiWztOT8uf1Ei~r*6N8`Y z!$}21W17I=2eAT%^&NB4F?}xja98)3v*}WCI9j0_6>MG-{biT!)$44GiPWt8n^EFx zRDMNwnbnjj%8YhZ*eg6_ShjZZMB0#f=p4dVXmfJP;KxfpG)R~tPN$#@dnZ;;nD>=3 zcwfnIX67+lwyep#gBk3@ek=mp6WIiu%uE!$=>AbF5ICL!m!HmJ!MGJIK)jbi3=@>?6`L z(p8!w@9l0>RA9A52*jaN2TqV$e?}UQ`zVYG;Hd%$-@p-6dE2l_A>RKBVmB)M+lUU+ z8`b#^)2Qme165)(5kQ*`doBCxT0binh8_*aiCnSs9|(tmv0{H6jxu~!j?m8~G36VC z!jk10*`P*SJDQIv)m19{YV!yhm@CW_a5Dp?~rlPN7uVO5~9HjR!`z;;n7o+T)D zgk^+wY!n4$W%ah_v?wg0;zraso5*^2E^$NsrLDm!d_GDe=j_cejC(+~C2 z@J4HY+3<-aUo`-o!NxsK2pwd(`VK#AM6Ucaze%^3qI!-#sNngQmyZUCpHP&nBJw#3 z9%o8+^g<<63d2#Idd^Y2=SP;9*y+Nt5|w}=cH`Sjv5DE4C{{8n7U>7+HRusHFubZY zTEtF$nu2_Go{X>TU=)-K8n-?rGMFsf>R1A7Zi=)0C1>RYjkPSwXTKhI8;w;INd^8* z8XXk-8#H3uak%(wFT6tiZFtLm7w==gg_riV(x`4UV4H55-lE-Kw}1C`%eIfo>&!Ll z%lC$h-~HS)(3$;F!)IcB^Tt|zHjV|up5_!CDYw89#_h4wp+VY6b+WP@tTM1?0@E5ie5Mg_$9FEF~t5l<9d2glVu! ze0M6|D#$huE7|%e&NlJ}To~};X@V%&)au#S$ee!*Sv>EaruhE)t zlH?RI$0Xytm*ob#FJU#J1P9szhp8l2M2p(fvarX4HQ&?v4aPi8p`Ly7u?PC&4~WMt3Xd#t-$+vwy?flL$T#m#$(dfB9X|Q~ zi6etBQdvVVFqn^^CgTKsfD2UPBXUw((MJ4}f)=IBo3a*4MB!5q_%#K-uAL*aPf{#T z5CX{zw|x?Pk2ofA?UR%M!`a${1Ozt~@H<4rr_Y=?vd()-Isut<;#ptM#%Jwtluhh< zgkbiX_PbiwuRR+2?MEMuf!`QX&i_o~trt1EuWO?{Kg9iLt0PF6<1}R9R<8-TN==b* zzhTu|nXn_MnbP{73B2`tA8cuedkVo8I1RXP4Hudf1u1fDhE*F(M??3U;3HJfF2C4( zOcMY3HF6$y;iR(hh@x6*|T#S>~v~U}Dd$%&!ce#yUXf`w0 zE!@WMtW6AdBe(HVMI*gx-iB8^U4@6s+WRe>DMYF#{uMTX2(vooP4uqkVzPPb8~6AM9Pl%3F!| zaPLa?UV--^UXi_*<9(?2IreVHdxZB{me&frM|zhL$<}A^KFs?hdtZw8JG@I6ZDn}B z)B8W{eKFn*-p9C@Qr`Lm-i_XcEc{Wto4h6Ly%g_e?>zQijQ1#S0edgPd$e~hd;cTe zW4yERH^DJ)L`6Pc?sCk#+iJs0qGMi?W(Ho89rIGWxp+x+%o|zpAYMi}=8d*a!%LcD z-WbgkF3UV;;)lF9n@gPGj+o#n&UO^%WzCyYF##ayj(PW3v+y$3F>jnE126YF=H2HV zhnEb;yi80*pg|h?jIBsx@=XW61%xlvk8f_)yam=IF3W9S^**mj=Ij|!wkW|fZ-Qgq z{qTeOYZ~v3DT{AT_E2>Oo$RCTD^nx9o?9UYeh`_tvwMpv1Fh%u-Z_cy*jh zrEn^6E5fVRiD{4hIx|HyNcNfTe6?H6l?++9aG(Y?e_obr-gqwsK$tkm$iXgl{zBJynN#5SRWrs9mPws<}Jr)qr@`MGjF&R zliHA~S3mrS*9?{_v=W>7pszm8>!+)>oDQBbyBymU$Lg~7bWJX&^}(z_Mexf9-k%#3 z?6eJ%Xx2Jcm7o&%hf>3VYp#6NQ$O*U$*8rn-~-w3caX-l+o(;+hXnvRcbXOY`cM6rYIrj)Z{1rCFQ`Wcjte|;u=CsXtLi5v-8`3;vLyvs zp2yTvcAtamvQ)?`^}q6(&+_`HCoe444(rKF!6~@0C~ppxIg`sW-D!*JM?|-MFf#igv)e?V|plBcKtWE{M};j_$-sbF`dk6*Q?~{3kEJr#bu4RAk3d2%QW`D zOZjUvPe~JBe#LtS3<<{_#EqFa7lO+jQojVJrUpKgHlGHqp51Yxf~e1%7hw$}W8~e7 z#9NaP&~Cc78dn4zG2PdUeUnGOLXg8We0?BR8*z9C>SKs9n5JhSTbxPwH#{m1yU=dB z2LldMI$R~`<1c!>)K9jUjJ9X5dv~)wGn0cAdW)N8DdJu^lY8(^NxqV*qMDh(DLe&dva@0Ks)Sqe|% z?d1miRwD1(|47Tv;N22rcj$~KD7uoZvk-3>tXSvpgZueq{DRTI%r}jPrKBU2jM4Bp zktLW%^La4b9I=sT#68Y5^lZ(x6-G*S|# zVS&3lz4(!IDo}Ck3E}SJAX%8&JI;!YZ-fDvFam=@OFYYh_;aU)7w$dYUzoaUfXNgO zWG8sEy3je}1_^8f`*s0ayBkYuJ>`5@=3Z|)?-W=d_$2g(e8S@6Gtr3*7T6&GOuP1YAf z{;ZFhG<2?q5hD=O}UigUX=-BmTNced2jZ4)~sL9$o2)chsM z{(`Z_*}CdoUSsC$SIvSd!fEd;$BlK|2gy-_Bld3I_`P)fqR{`sg)(8BMF}qT$6X+D zIW)Ae>r^7cal+ISe=~rqhy%eTCZq7;l_(y=*2$p9pLTh#w6OX@!dogNT~65khF#_P zj5qelW*B{gSa;I}ai8SbH_Tqu;(nJ%bvLyNoo{d8HAkfi_?AwU>q7M@VNj9#ijXFl zZmHRtLXrETFcKb|@6Nn}?Bk=VCJ2uwB}&3rV(NlArGuYw;c6?$a>TJJ(qDKS#hA)s zQHYB?Sw;&3goi=n3SkS=qXlxAg~(k3Q7$|VOczx%F8pc-9$y?n5tqR5AnxMlH@o9* zseRa(Zu^iykdWEy0gHnq1Nhrt7$#I>Pl>8TNsXZl4nRQ-ymNz^TT0Zp0C1~Xn1Wb@ zW67JSeBhSK8L+EA>TIOcM1;( zb3N`ye1ZLiJ5g2pZyg{cG@g}Me1EFDh!)mESU||?Is%1{eRX|-zpfW5&;1@Ti?3J>?V7d08 z)}i`QIH|+^)Sly8ZuKc?45F}l)4x;$&Ob&PQ&bcacS6H0*A%SO6}@XO*ko`w89evX zVh4or7TW&Jc=nv&3R>}GpX3TKuZD`)P38l;4W?~4I)_&*v@1D-sfGf~a)7_9LC1J8 zl(XM$PE*9LrJD;97j@2=fo}1_h0cUOpt@+u+V50iRCykzYFnk+4k_a7Jx6csuPzt7 z4)?9MM=90>gPQF@MelM2J9YM*h7<0x!ei1Qdl`a13ToX}Cg+8(y_yRLTAw+9i)9MG zq8{=yjh_sP49Yn`-QZ`vd)vK183(AZ`z+{fSA`!qO<`=4lJkgttW8FHhQf(|lW_Uz z{!6Fc<&Jo`wp~)oRw)9G0dX7PiF%#8-hfz(a!Lw9>dCiVoZ!dDU=Gz&<~=uovcPTi zlzDyN=)b(rbYJ9*QC(;Qpz;R?N(Q|#2xRCHE06M`u1G#xi6Lnm zycL{=za*@UWp3?CQ$?;!Ox4A_N7t7N-xto8gii%kvWA;uOI)yaVea}r%^43pc=N)T z%!#AIa$cyJm3hJ$Lh~aoV`a@G`q-aVRkT8po?L(vIA>`zZqd%?i->D;Cr%-~(>l zh0>D_TqPVH$PLQioDKG+_K2A|_OghQf293K<51-6&a9pq6FEYo=T7_@(hk<$nZe~Z zFH}fH^AeD04e6w=Q z)ms;YaQX}`zQOQAqCGk!Ps!!vVFs4L6*siKN)N(O-i> z)oKdiLNmD84LLs~w!^&r084+sK!I}6H7I&c0!ysX*tkNcWc@`dQephBvX_K(r*B8L zKP0x6u#_bY#^+hiJSC1X69VZF`@=>|`*i8k5d2oQYFa{YcEvSypxyZvb~~tZD`g@ z$OqV*!3L+!UPXy2nR5t2?C8(=;OiP1`cb)^T03yZG2B{j0-~eP0)a>_oX{EGOsp}a z(z~mnnWqGnV0U+dZoIDk9DJe@Sbc+dt&6|{4e>fdrJ?pReN_gb0s^%OBs)V0?v;j` zHxmtVnmATSjbpE_=2e}c-XLdXxGWFyW0NIWeVU7S(!0m_g23j6ZJ?*D({WvDiYCseBO1) z6oTxWDw6w@hK$LH_6a(yfzYR=0ZqKU8qiOeFL#aGKE99g{~Ch89;p$2yhC2~Ge`}ZjwCLR9LQPKLtP^l-! z0lx=205-5apu+Eg3f2%GC_$}muvaBkq63rvi)BQ8cA!&{k*%B59h@ao7S)igFsw8f zA0ePh9!|;=%OaLWltj#osQ<@%ymvKbZME~e1kGHHa1|g=2Q9xM<88KfHB9WPy}wKI zWS4OcCI5!a`xDVOrQ%7$GZs$<9*oU}AYfh-^vYV^o5^9O!&HavjlU`#{#Amlk3BCl zX3)s$#+c|iB_sI?xC@Bq4$bl@47!j<8wwstw3p}{=!o!%j>txOIZFjNyFKiXlR)zY z(rN~pQ=-cQC_Z0kuvZXhr9e}~9@qiD2RncaY zZoKVuB$x}rz0%;1*d>|R{x^j+VeEW+*ddH1(C3SrZeT9)+^zw~`#-HHKDkw z_#tUW$Bs|fdy?xx&hY@}n#Q@Na*ioDjO$>VU?0Tt6+5_L7pgo$#8pKVkQG&Rv`prz zHps}TKChCIwN<^iF)7k_p~%&w7VIQ2be^f?h!)v?Fq*e+?!k1r>Z>X*A$qgLT|~d1 z2zN&gz4!p@DtjRc}^(S@kK>BTdx@aw^dI zuJF8El-p2U1fI#^bu~&VjpDtB3LSNC61zK*;PoZ_#=x_(MPuCf7pkbKJvZGWjGCem0GJ8kB0>cd`r*+6sC8iNE(0t@_(t zhw4JOpo|MOwX0eN;{EX;PLq*XP>Zk(gpE|gtqca#1vO=;I6&O8UvcCh>P2wJ8$@f` zIAsA^Sz(kyk();T*3d^}t0$gTb%aXU>ca5n7pQnE=6CNeY10+8MI8Q2y4aR1L{D4Zq>!hL3l)v;^n@R7mHI@Dkk+VNZ84cUrKgL%TwlEMT(;Ui->^_^zzEG0l9-s_%><7l5Uz z9Gfmj9wGTQZrEykzRH-}Vu&XG0%}a}s5F)F-tm|<(@Fz6{R+jocy^jB-#2txVxe4oDU`=nHR^0pwx&$w=sNM9FdRE)>)xAq$u)a3Cs z#fWnT8Jq@V=QX_c>}Sv>0bA_sUV0Z2K(HLxuouTG9wD?^T+d$XC7hL7$A%u9O+oUI z+_8|0Ue;Cow=Tk$i7CD?K;9p~!kzH3yaI_(ip}!No-g--v!3dqm%Fl7DY4j}FX8 zjlvyjBA0tj$|xwKqm?OUDE{J+H?r8eTi!c9_e01cE0)X17&$4|FAM}_2V_hbIjK-Q zPYV`gLBqmwCXjYa3g`ux7EpLnDj2W3P!xh{pER>BF_mdzUzpk~Z%qoN9n&{Fv!OX7 z1vk^PnBqNHR*c>$3A-0&7Bz5Ix=H{M&H&fDT#ZvF#MfokI0<=WZzRqDSdOqj@nsK) zWhvGzlYbXDe`eovv^h@7zA`|pCLkI*uQWGwC%+589C#+nmZ!M&-AJxq4fPx7+6gt1KHJX~<+e%owuo)%y zRkz-BTLO~S!rddQZr$O=7bO$V9XJI%X#vJHnEc7{Xv6BLj$!;3cwKJ4>=Vq+z=>xD z!#w;TYWlTZN>Yn)Pz%~gMa^w7SHC8l`p~3~jTjD_`GyOUxbYg5eV=i4wKaeX-nnh3 z+vu#`=I)G--@gefz2JmZ!5Lp%?Qze*GB1pXJN`+{C$|N9Re*X=`JcIl{9y(G&T!Ms zwR3Ypt1FH(Wz&maF^p&lTwHSYbc7ZEMPX)-s(WwZ2ZK2V2|@{&CJ}-nM-kK;%fAQJ`4Fi9cUuBiDPuoW_?FxbVdjn9FT4 zx3A@h-ZN6;YYLW^_@ApNyC8t&ErE(?95QUYCYKvbBHqlsZeo2k@hq`bLHw%ik{k_0 zjK8g@#94C+zbZN2p%#V0nQ9_j3JTy-qi^0f0gp6zFobv+&#zoQz7x^XN(vQ+OJ2BC zdJhTX(&$&30GLahq?o{srSCy{E`$AsaTD;HhBi7CkHp=SMx6{yIwP45t0JfF^OO$E zH!o8*cSva|3oiLPJ+)G~P(5X)3{(4sl(!*mcCKJWInnWDl-={beJ9PImIZCw z)~TD|Zm4Z{FV!u2mIV5A&{Guy{K%I9$jdlsqdxHd9YwME{$L!Onnk@^` z9dPT8yPMDDY+I_!m}pqMlepQ_q2dFLSVq~Dm+bYF<(Yt*nojpmx)b#VWPEa~^h5Xh zciU#^GrH%!KA;x`b)cXg6u356Uae&moCzrUOn2hMlMxTwKP3{f19U&Rx1mX#U^u8e z{JNx@=|*VZ*0CR|NyK=28BuVx-=amGZb^4xsX>?G{$-5>I4lCfu`s9<+4>YR#Mm44WGwcYwqW8^w_6FfVFe3Jf$5BB`Rp9lu5?$gb z12|q=DnSyr4>oApJ;j$>b`a$@L6`9W%Pp@rtMg@6XD#G<@j5$T%F;<7Bw6mSfqYpI z3Lf!y`(upJK`1{MT`=DOLNX^4i3@x8`=u)MJrV2d-!MU|4jt-rzoT<+HRwv*hf^e7 zz5AQ)7ItyE^t6EV8@qXjk0zDd{iOXFg>DnEd9P~Q$GSy34YM@Yx-&Uxp-eyOPEILS=~!%_{i7P%+zJvPbxmC_kK^dW|7>TYF4>+ z$!&tS4QrM;CMt7Nkm$IAmccHM`Or9^mZRNBdin}1JCf++VZ1Cp{ZgsXIs7|};THvZ(=e%?WGTh~?8mAC~M6cv| zrvVcIlmIZ!!0z(B-K3Vwr>|5Q3vB zSDMs9P{ofDrh~|O1~x0~64~MaDe#Fmq*pw_j(3*X9n+EhHfKm}i_~z1SZ)b|-yGix zZcwCepv%I2l7fggZ`u@JhPHkK9-RAF6M#x31VFdp#bi?9>-@BU5dmXz7cQ>Mj32qE zfbA>7c_Ei#9{p07b8&FmXiq;FE11wpjZ>Xh;nwJc^og7LUEFgDJMPI1Wxeg`BG}5b6#Et`kvYXYQ)C11*_b_(j{w8g{`48O6Ze0f)8urOEE+ z(W;Lg%v=8^&9RNpkQ~7OEk}$kzmgqP^REClZu=E4;BFeP&*#K&e8yKF6rRe?GletrN$xd>QyON+gE-vQWV+>2k#movZk)uJ+)5;5d4UX_xgxRy|b zClpRUN1ecSe8jfR1~_z2Hr;J9-9-Tjt@{i@1U8KkK}pWh&crz>3BSW}4o&5-+=b$8 zRnVK2y}hn>xK&R%g_fb*@J%hVIFK^Dezu*WOgl4L%5MbPHCmnEypplivy;~{k8erfT3sSu_lfo^Y^`^1c0fiAb^ zsmh>7|GDa6{?N9v2&dR4?f7_GYnia{NVq}>JoKNkU4e%V%^;W?tLE|-2xiCMu&S}` zF|=+a5WfZJtbjs`-mN* zYMQBXT=oG)0mzlU{AXasBHFtxGVSV3r!Tl-cNU*rzUeCpRcl|uj3;F3YS=8s%S zH1B(UV4J$hHq#>lEbJ%U#Bq%#N_TgH84~GC4lOZg0kXC!kbuKq~|< zgV|;8+!A}`R@9T*aLNr!td!j+{_MK)emgrySn_Y@6z|I^KnQOSOL;wDYd~w=+Fb!h zRHcWS*4Av&ErrihRx0r=Umk@Wc?FMBkqU~bNFTJiSCykcSz#kHo}jX17@7-Ax_~0Z zvB^R(9omg%m2PZsy^r7181Ej#a{|v9d`pso!~KBG(9$_{ zul7UtK@L!h#g{G%Lop%7W_w(-f4F4{uz1Ea%o0I~@EptyU>6ers~FfG$i_d$JvWeR z8gI;B2E|KiyRn8Q#c@i1dWuvUi|_Nz*}9uR3J)}XRcA=i8S8&Fg~k|c6Szh*g2x03 zm)?Gp_k4Q7V3>jGj|(kFH}c8ttrnO&De~Mn8af%&;KWU^C19Ld{&F;MBh-%Ez)7`^ zT($&=&4&cOt~O%k@cQ~%S6jHpZJ#}9lgSx?8QnoRhgW5(Ftc(xQFLeXmOvaZ3dWS$ zayOcd$~IcQm)jR-8(NsHWD!l~P$>A8mNuQkGNWN5NxDv4zfg$3rQWE(NpwwngKC$m z;Y~>#L=CH88mlS|5C&wlmYpAPe8BbwOs$GyLSVMjvH=HWO9P5xa`7S7Np&JhT^d-h zz_?}Oc~!&9(k@Ny%Ovuv+6xzw@aqh++mqUk-Fx`Bt)WIj#~|LkOmqi0Eabk+u_xTM z=S)MDv|y9ko^6J?h?zsmU~Juh`UpAWN+$j~d39@u4LH`HFX>tlhW9@?)L2wBEZ}g6$VtM=j|BtX(Vt z2Vt>AYgs-czs$@V#)y}YI!*N(D`^&$xcOe+z>T#}sptbNc*3bKz=L(jqC%LoC_oW9 zvvC&+AGn-Xs9ls(W>{2~SE%=^R6fij>@LMhQ?xE}q@!@4t8nlbF{?0?$T|zh6fx#N zoIWa_%P*Q3Le z*j!~+;h^PT$a$gPouoUr0q4{bE~A@iZ-CAwo2mQ3t1!Ga=CY8U79@wHiRZq<2C!(n zjGdqOx`wpC_8~CCSSiOMEM1JaOu>6AyF=5&n1N%2fez!q+FerRFa82L;n_bVxlmVP zNf6FB3UwM9p}35CAw1bQsQ#DaLJSUcUL}GCCvB6QqCd!=zV4UcG2mfDipv;MlTza_ zhK;GkttV~c)Rl+*FnPwnm}uU59~|WhjY`R3>{r*8ABf$t9QS4WOmpQ)Pj3Ib+yM}# zKSlm8`awZ!lzGOGaq78&Edx2*%zh5{GW%v7R!C@JVBeY7)vd0z`fL5#_qo@oTODil z*?7JBI^X*8+5;bX_MJG$yFXnkr0Z`63zKm{i>J0fw<83$FMoH#$Y4>Kr*?pQvtgrv zGaPbMU2~1s4bu~>ocp4Nvk3)8P_?6R2<2bWICWiHM1B5Y%u3t*gknwKsGD{86>ReD z?)E0`6z3`<(!dp$F?5Xh3M`i@B=6Ibvn{UyyN6|YC~X5*dD7aBL9Po`+^s&mt?Q!O za;hy7J}LH!^&ypt;uXC9rA{jhU}hg%382GocSQ~Wz+Q2qVymh?r1)9hx=-R9h-vVp zZ8rvb3Ssb98PfPP@BIu1NH8uFxu-)|H%yKQW@R4pjizvK_PtV^Vpb9irE2eyj=1gh zN#7_0_1Lt;7s|&4E=c1wleiV?HL6+0X#p#g_A~>QX>woaTqI@&Ea+bsf)S@9Tw!lL zU4h2$XviU_8>9W!)3x78HPyNUOKPJe&k*kI?dGFNhhD024dGS|QAK=tD5ETKrMoV$ z=EP;J1T>Gj{Be=SgyhDW*JT(@#2WCYXL#B?;<6(+7h~2sqrK9e=yba*S~+oR`Fy)u zW&bsElVopH;m-#8^CtcAs5ZT87gbf8gmF-oL!0Iu&1|(tfx>M&YOV%euwRBDw_-ILDJcc5F|K!6OpsPjVQ7HV{K_>}>b=3W zPh6^5uiL9`PoPrQ2SZ*<0yx{>&uKQHDZrR{m*TaxIH2Ni2Vw5euH_;&$=jw8I|a5@ z<_P8f9v&=&dG;PUs1hvhz2!#~*j*H~WBUuAaJ$SOzN63EcP8uLnc$DNB;>fuG7kNJ zjC~7SQ&+n0&d!4XTSx*T0#5Vb5neU~TY}=a6A-c5IT#heY70~lt)7FHwzgxZNwg3U zTSTkD;+Z6ZBGn3LE%h-CsE8IjVx5+@I)k>fYOSJ0Yb(0%e zEbh1StL1^i)okHY6%`gY3qCY)T>nSt^MTk;9V31JB2_S+pHM$|X>WhETk4b(+q~`G6vPa3c+6;nfegluaEkc^MU8zKg6=!Al!YN|~@~L+Qy`>7ywoc_?Ha3Hf%7BV9tx*x0U+ zR2$YZV^40VF^d=wI&W4R*1)}@rWqFrtB?NP>nf=>SU_p3>Bc3#mo|cM@**>?+CbK7 z!^N)lF;g|FFLyz_rurG;fr)n}vt_ri-R;8t2nd@rR=$U6TF28GObAi=<8b6`z0vU2 zBZ=7*l}lO^S`2@Agw{E$a+yx5HN5!{CT(}ofq2;s~!o3Z(TZyIb6sx;I@%28>cw9YEsWangVE?G`kw>rK?`%3NHmB-I8 zrOedgtTh-LLB&ODa59ZQd100D_{^4|>GFuGH+f9@tECJERIJi6k1RuDUpuo_+H{CF zx!)kAlt*#=CePtgp z@)Qp@pc`i1Q*@Csk)v*j;xsoD&;6KG8hBl;SSuU^@QjKns&-fPhvqHn@ahjuTdk(Q3M!QE(8TBF#wrUFt0(uPcg^~Y(^f;}g*-7eui%#QJ)V4as#=uS!I|Hm zh#jwXGp%_l72LDuZ)vlmwAnciB{~R~QQ_H=Qg`bHr`RAnbOx}yc)4c)j`x5o!Tg#5 zzlp#m*llrQR@@GLo_kDUfH0yR_%_hmd^?>)czV29rkfb738}XX5tMUdlp$P!)sOqq z33Z9zbntp_Z^_L*uDg$@M~q0~EPL_ss+;3)>Pv1eJ%(p%@Q0A1g&}u}u*{FOUA(}V zzUIMW*T_L695z447t`&K>)z(>@*^j9)l4+HjH#s9Ds}vw+i->qy&|8g%@Rl{WRv$n z`N*g-Mm*;@$@L16eLMdE)up;6n0)a#*WJN6P<0(-j`jSG>mP+@Uj{tD^Jk*}G@*_- zoH5jqI(o}R&KeTDZs9T#*gLKK%o&obwSxPCyg%M#-bwk^D(dd%tgG67xaYV*61^`- z`4-o&K6j=zqdddi$`J0=eVJ>!%sKv>Lw&XKo1nfnwW;MraNH>NGfCD0J{0buy`yi= zioU5-QcfXHshonwV?vJbFY%ij-4**K*ZnTn*25L(I3%%O{>jKjLh+wQ`3I7$t30UG zLpxmhoJShM!ga6V+Pb)crx0F#2;mKOIU6gb*+E#J}A)K1e8syVQ@>KGhaYv{7EPaSwlp z$6k??MT5&4nwW6;H?Y?Ocnlxxb;xWC@z*Pp7Sbjc{7?N6bG%irndmYl+QISMyqyAn zJ!$-?pZOhVPQS^1A|B?2-apFQ+e3;ERVmwfj6e3{#a&gO9oi%6i{wQr>5dDW9%g%9=$K>y*wMiAVnjn59dLa<+)Og5*wOv{XLL1XvG?d^LoH#z@+k#K4p4> zI)?ts-Q~Eya-0BtnMEDE4R+7oM94I7TrUERLHFj4!B0%y#Q_v`o|wKA^*v0E`;<$; zJB$U6k@ZU+mGJx>#oNiGJ;=o^Ft=cR_&S6Grv#>CyqOcuyS+wEZ{1N8#mR_ee(SgY z5lf6K?BuP!Z|?A0eYp3KG{uTv?h{}9s^t0;?vx*6_6igW4w3+E!;6AP^F{Q-NL-Fz zB=+#2j1-AZXyw4>&igbYH<3&=k6nm|Z!__o#VgHBl(6m5K|E&=wfajlW)Cq{@EqrOhpRupnfKl& zr4Z-7CP}CzmHPUlwPNM3*z#MkRkC6&SG7Gc_+Ni zY04xkr0)+!_g=Zz+|%E~JqBG(3Z^spmL5uFt=EZk{$0IBWaZj%O)!ERfwL2-+w!PbS_>B;2d$ z;RnDvn2ChLtQ(4(pHBsSH^!_Tau(4+ANd>i-iOGnM;|+4=g?U%2bIpJw9t4t{s!tA zG;H=BAJ|_{BjYye#=jr-2QvRXJq+PVfuqF*c^nfG@iI-;I!o}nB<3GrLif#=!`1po zjzzS{%TwoBPhBa!L%PK(`r+f_-lDrcK}Msgu0fNp`?1~b$CKf^n*iUYn|nR|4p^`M zz@sA=y2N+lbOjnH@5cI(+PlOlu3VpWDUT5*n*y25^C4&gM4TrJt7n)3q zOt>M)pAY^{3;+41R=Ejh*8JzHY;q@mLCc&c9}E5hmdOa-!q088$}Mv=k9p=<(()f8 za# zXw#O1jP+LLxBhHVTL^pXf@r%yuKmrQwMU8B1(bx9 z-}h(J02}O`FxLX-ANaEacl}ug;lzli;r!X2STQ>oEn!)em^}wjdiQr1amNb%*PL^G z*T@^t{4dV3GO2o2}UAAqK) ziK+3iER8}tV!mjpW7YH)CiJ`B>s6YgRlSh-bd}&`dzp7yfI#i`!Asi* zZPHs^{N5`>FUt`>j0$K~@WGnNWtB72;VggjRow$Q9)HS*J!5KK*JyEHa|%6#Yq_qH z8P|WU{nW~vl=hkRxx~=9HU&d^>Uksg|y+W8PSqxA408B)8Cu5iqH* zu92!mlz^4Xo7bf&-B%Do=gugc@mksD3*bZ#`E7XU=bMr^-Udc-y zG=DUdr05p+|BWUog?OMJ@2b~X8E8e z7I==-pKx4*KB#zrbGHw{*Es-u^{)rqmKSz&;gOKh22y}D;ORVGyWIr#jI&K*-u5&m z1moVpH~C>}m~3VVbW}}Zo>}d;Y!tKEsMj!0q8^R?RQLCRc^SgX~K)zmS z)N5x(X!R*G*R<;;7QL)mA865!ZqWx->&IC1!A||yYJG@PA8OHuS@eo(y~?5wZ_!6o z>mx1ts7w09OZo|y^iQ4DKYdo8bXKp^>L(lZe@r=U)K5XHr@ZayQVFLyqn;&%sUAY! z;;BZxzFnW%u1~wApL$E5-lCu8)Mr@qq_Yh7L+Ckxt4NepFRE|iDp&5I`z%~3k0Os; zVBr)YKhOG@%ctX%d@A4F;#o3*(mpgN=6(6|o$!d_o$~s2E?cDdki#veXi-+l2+u^( z=pl(BaQN53qdwb7KJn0T55Ezg43f_`Kfxj8YlgzWF^cw|Tj<%;A(fLRlKTa>2h+*t z&Zs?J;AD4*h_z5QTJgzap(1`6#Il7t5bjd+UsKY{Dz%JH-|vG+bC6d2bnW6g?iS7K zUdOeqCn+yl?EF*a_?40@A37>U65Rf6yJvGTev@g2x_+ix9^Dc;e{tSbhO#J4qpf) zbb4I>eh+`ryz=J_A6{!0yO~qolUu~IE{?lr&fvPo-E)k)r*y9)%whLXCT1*{^`1M4 zn7Z8K;RfzpP>TOXCB{Vt3$aLphvKsbSk{f}4~}-P^N4(osYL0Z?qrA+_qc~=Dl>bj z+?y#<>KC9N0AEDE?izIa`nEf$l{gcHDC9#y6rBJc4tG1F6~o;yZ|zfx>s-f740Zvy z%BQ^{H#iZ}O<RACN#vekkq;~Hh*xZOrcsgU8X&cUZ_-sOc-oURo=~Gz zSOrjL>>6NVi1wWEpjj2#Y|5C;n_(?iL?+1@?@RX8HN0xa(5Tk&7V<9$7y2bjCwr%V zfK@x5OGoP)ZnKFJy^Ujs7!z)Jb%o;Ea9_0G0B!1Ri~8x70G=~|Tv`Lg8Nk!3Q_)kQ zXU+W0HB)2LXN^!?rBx-7-W#H$b-%zuI_@<0CW*9tahZI@)tlg|g1rgxJWC!C?f0|^ zssAWydfspg>94%PW{^gE?8=4JOaJ>jP(k3P*Wcz&LpeVaqQCPK*^G@xK308Uu;Pe# zk610Rcw}tRr-=+4ga}&okbt8pY|AK{zA!q72~i8wPEhvnN%VBsh{%ar0Bz;UB)FJV z#Z)2|sHUT5G5)#olG9N9Wfed(pb-2Li&~1BK!3ZjiPStKZY}C(VY53GXw2&EmuFa% z?SngaiA=dA5CNeq&Uri4KJwfWU!or&>*((~%$KXELY2HQ74m4R|G40DnrGiJ8=B*h zHzauPD3#M;Q}QTMt2=y++gxk6bgyq*9S0Q68T-nLI*H;@I+Zvy^U$;^Agc2<}D83&=4K)xkVG4)YO@w_@c_=wVR2OnOIj8@k$1KT~@tl}{S- zMnU$>m?z24BQk(?`5b(N%c*Ag+B|=GreHq!cY4x7G9oDGnX1@y2p5iLZX<*tF94A+ zeIf0M$|#6&l74q5k;lxfCjF^SNlZ zmo`tv3{Cs_3Tg5NWnN$@kIFC`6|(6Ym<%PZ%V6DR+fd$o-n|JXku3@-b5d)g`V*y? zaFjM)KiXfZs%ai>uZ#_$Y17RHI~BSHM_ne@fX$1EfdEgd*^))N4y0;AEh9b?hkQu) zfKNlWIfeA)_BIJb&%Ig{j73d8plo&2HneZ%wQQywb)5O#pFrxI)v9+mICCX&SiPJI zfkjO|t+un?+qNOgTkL*|TD=-(4Ur=*mp+Yf4f^3=k=2R-b2V3GHR0n+7KOl6Zoxrd zwIZ+|N@sA5+SF`vPpXfkQNN1Bd7Im6MHK6-e-lILLS=}ca|3USNAe0G>09k4Yd;ix zR4e@cU+D)U(cxgWi$kH@X(c4T!L%2 z%-Hn;=$xKj~QNHy zPU^Bh6LMO3Y5eRKh3_pqiXYVwVcl>`F|Mp}^m#rLU=vzLJM(0aYK7n`d55cP=B|@A zM`$^|x>WAK=%pxfL1)0~m}bL`30~D}a!B+|tM+2lCbzXvm1a@MmJ2H;YW4~zPPB>e ztPA}ys<&pae-%Dc(;8H@L4n?IFoXS6_{_nxj#6!6a^}1 zT@}8CS)~ID{nPE#a(`Wd!NE=2=$FAu+7vmHU#*Bv_J+u<;X`U#fFOg15lMU)?OvAw zUIO?0Z&XBUCb*J?i0Nqtot~s1P1+PblW#$=U^MYi3epZfMSOga0!e&q2aiHzl2~9+ z%*cs^TGY^{RAypM45N2CL#;Qf6=6z6s8$i3(PmTxRA*DlY~FN!P5`>O$f*d>sxr|i zJC*++Ze$6!Q%yuMc1%0wgEa3@`rx|c|rUz z@iblvc&26i4577cS_3bRZ)@9{NQyX8KAi{wNQ}`#X`&2|BMq6pRrH9AYRLXC+;qiN3Q zMrFB&*6;w*Mv}53o-=~yju)mIjcAWXGAR5!v9x)9+U*ZKF(C*YnvHjwty?oamGQ1h zn{BiZK{m)4S(E`aKde1Vc1jk|AG|(~W`d9@IfO7cF@s457UGD;c4&_o6pXbC`zwnz5N99Yu+dbiw{)Jc@6=blr_Z!Hou^JzpFEM-=!Cy%jo!Xp zU$s$hYE>ESZ<$W1Okb-$j__h4=Ec&c%o1bj925*bm+WtysHfBaM8Rh_Et*Q%GfPTS zF~|Lr>HGLYPtduZpeG`HE%s4HyWfch8ljA-L<$T^d==q~$nmnOOv0d|EcUl7soC(t z9?9so5MLU;qBYDBIYTj^=oo4@-(VnP&2ze1ZW*69>;FjD2MJbIrgWUk70 zY*Z>JWjkL95qu`!Igiwz;^1ZIFJKJy=kGE8r@gEKaythCd`!s5zU1TvbhwB6l9$S= zPyD{K-V5?Un7JuxXQWS6afvV9S0!1_dujo0*5tnSVrU}6oK;Z8AIqI~69%(Vxd2mn zWGY?y4Q>@G-8+(m=dY;w2~X!iC?MgvE7AOM{b#WDe)=MX^#|r9L!QJpjU}7B63V7Z zzL;}!cs|hbN{qbX=oQ8Cf$80hU`g9@L3wk{hG>1VIVW#8(26yer|nW&+o~0kt@!4; z0sE8*DtuP}LU(eND@7Hxolbv=N?%T`7c3X(E@o_aMg<*hw(cCqmT<33`9Sn6yy|og zY(kVYPos1#%{LXQl4s%8kSbohUbNhM8-Fs5xA!(WI}hWyVk&MEYSL!oSM6m_OT{xV z{?r_mQYj@>dKx$MS`=QEJlyqjU(Jazzf9^?jrFBc`8?_--lrAzme}WeeW^yLDMmFz zDOceoj+LftvxPFXtFR*IK$Fs^>4sT$_j)p{BC3&2*Hg^Gu`7j zB69434pvWo=KYtE71AN={t)^0jW{+7I!IAFRQ8<;d^7B|s|%U1Q_c%~`}sA#pFq01 zY4;lY9&(W-YoefP_nN_PGEZ%+4BJc#jK^!4v6&k;V)O;QP03$S$mhC#?Mswr4pbkf z!B;W8Z90%6l!MV=b%hp!ClR@s?l{0L7qjw`^?Z?lT8?kXt>=@Dvs|pSFIvyHH7|SH zcRFfIcN3M2#>rI9wzV~EXiSEpmFdmORH|k}q&MBMnM<$abZv%XpBp?3v!O!;_tuGQ zrN;G#SxV6#msuLjL0503AHm=$BKN2+LJ{Y1rvSGJva`v}rU|NK^UR~uH$?68OHndG zN6GZd`w{#JChP*eGL>4Xmm+nXW%XKTQ&B3X{S6GBs76%48%mE? znQD)lZ=TJQT)Bv+I^v@iIC)a=E8+1;8z`4APWEeUv%gQcL7g`co@R(6?2M{L`apdt5GTv9-yFimVXT~iM z?cC9rwet6To^%fbW<-8RX|8kQa-Xbcelx|b$+~nmXq;CHy~WAv+Na*Ix>P>NrL+%r z2yw#>R?U;biAuRb;hsdmZRjtQChdp?e*<)_Mp06VWfar_XObk0BSPlqW)p!9H}?C?o0sFCMB|W5GQMLsNLj%e_Tt$x(5i#*fv}A8*#ScNBW8x^3FekXF5OO{eFXzY7d|c;p5300}KGSo9A(7(9Qr@Q{hGUR&kfz ze5(xF5S~Ord!v)+^Eh;vOKp<4JxrJd++eG!`3H_%oa$@ls(BLUNsZ;?07~X`A8CgP z%JxqR%c!!su$iJE69@jdA-tgN8?M^jH%YQ6R|fr9nbdIdJgfu4$9M8in4KU9~{N>&e!K{=Y)k4RIx0TB0(47hw$?E&LNUZNt!Kh;B6*ssJ znp*KQR~Qf}x<@Lfr7dWWSN&(4Z(^eo$)LWo=2Q8+pvWL$R=@*M0>y|4)dN+%17|*z;t+}oAsfT~>r%~H&2xV& z#VyS>Q^H;j8y{A|B(FHb5${6B5yy~Eo_4~AKVlSE`FdT(H0z%t znjhfn%S#I`LmCkh9&Y1c{f}@t?S4=Mr1<9#gpEmfam-Kdb&G=ThjhPE##7FIfw^Rv z{rq&kGIbWpPc~_>XyMPY7%791>|8x}Y>1TY4;QE0zC};&{^M=OA8(td zkQ=b$`VZs$`e_HHxBkfR6-R%VZjMyR@8C^5dfrA_R7j=gpxlLtbVoi;4GUB0^gOC` z4#hl`{sK7!xiz@lr>_p`$=v<_+Z$j7qpu;|(;_AoRICUHZ`ge|7~j`@QVS<8eW{sH z6EyC-?*)@x@qm@?ZIn7sWw4D^I2lwYA&y1xlBF}oq$x2Uzu^q#nZG1w-|Kz$h%9+N z<}ZkY@pcauTz_Pi+pVr%sAgZ|!jNIYFy+SiY*Bkv+gFuE^R|h#c4&g2w0XFH$ffvT z*2UsrON>w0#4RxrCdxe3(5J8Bf%%miq=Aa)_FyVMa(u4{pFd<`i_ktE7ipg& z+7kIBaiU_?XdNch(>@~7K1C1P$9YPeADM(CAi{-q$rrq2{;#2?5$1Qqkk)yLxWV>h zgjNT>B7&y1?{MLDG%tqk*vpBUxj39xxiH`0IiP_Jx}<;wy+r5Kzqm}8SidIx$|?6g zVZf@=qx3JE&pd&XJXR@ZYG>Vqh6*fZQLT@OWvYen)=zc|UJ8dB4uP@-iawnA$@ARj zSC1(z#0lY_i{Ld&@B>LrG#pDU99kITYa42EVXpSf5iCnz@=(Lb^ijl@N6O9JWbSyZ z6h&f%_+5FS1ez@1wPZw80}d;lH)&dK5t*AFlVJnBjmx!4@Cz@?V~0U%kz5^-)lMWA zts>E)hS(COAo#pUYCANXmz=fp zKCYwB+NrO+MXP_SQJ0RzYUkr{EQWBx_LcY8X^lblI@ffuy~}kn*rp45U9h!rmrf+X za2T5u1C>Ka1E)M6tMC?}c6u`(hkG~ebDcW$NwCO^+A?aa`8pY;7ldtB#vk!`mwdt#+mmYRo~M-jKUhLx3Xw6q7B|4HJh zEm^V$2(dvr;Z40tY4mH+Ta@jOJ<-@Q zq89vFUix^-6)Dw5@#QL$Qb}jN-PEg-PMnZDuaKrYBB{`)lD({plUn_{w~lYyI=;nT z>)1NJ{(SJ6r=-ba=C5&w?X^hDqhhSRt(~Es=Q^sVY~g)Rt6HZWGre z+Qio2it_SQ>zMhv-tBndNgC^BG@93uV7jOnRj*cRUORrGPRW;6p3Qu!sTUO!&hV4* zRcgu^C9MCF%beTP8zGg4n?SW>dxaJ%qXbb0Xwly}-Qsxxe%-H(Z(E5Xe&|>+zTj-I zq5yS%_*VCd@omdM-RD>~p2#@ z`Da3vWP_u$Q*y1`7$qv&l2JBK>+1TVd*S%Dc}Vh8$Gq`?+!IipE5Mo_dE z_ovu7q@*#k8(u+QJ056GC4OD|73}zII%iEXjTIyIP3L1&R!jNYIhN40#S=aw^9jZt z`8v)vAGvLfreY(ct#;z1BOb(UKCEpGhQ_q*w8c(g6`ZxiCrjruD|Wn9C_)dn>5`&_ z({|AqnzoEB+le(@MOm#`84u!~F?Yu!|Ajt5TZQd*2G>x`R|z5csp(Ud#{;3WGlrB; zv)_fskP+*yS5U=oCxvM6ndv}6P=t?1Ff8pMQsF;7gFpT496ksNLSX20a;B+t@X{e@ ze5=;7M`+$p(jV8abU+xw{X@PYNZ@`(Y^oS2L^od$4ZBAC?C%{^M`mH zpAnFH!9^Fo`4>`}$_ljY9b#)t)2+!$eGu=S!U?~K6osPttEHiz#MYRv$D2NAY6t=U z&Q#uH4F)T(tdY0P*L*qNq-<)X8)TpGc1hvYgSqc(`lRd=@vh)_Z{~7T!{MRlGs=X_ z_wy#u=~{e_*y6(&d`6klq^2~v#fS1LG8P7hT6}m}HbJ!yz2I_LjlP;56(+{qY%z@L zV5pSjEw-R)A6|;Ctj6yVFY-9dvgQ-<=GVznbZvznWA#L{>=2g)s?BZjWr33l*UmQZ zKT2BkEOTyNUB+sBpFARz%DT!YA1dy1P^FN!a{I^2+vWJ&S<^lfhHFHkS2}n-2K%Ua zb%8B=Z|$M$#~=$5r(gxYlt+7;01^1Vr-!#vV7f4Ef+;hb-WPYXAK5}%peo8sV0L_XpjlmM3dGCi3E%m zBGW_)<*wg$jPiXdRC>Wp&!;W%-0gOrhZfO4LOZX`qJ6uk#kb8s7TX-@@k9v960D_} zJ769vsP6RmwlsL{a8!~j(tzXHw^N4Sewj_xeLuUOUK2vE|({}9j`f&Ee2-Cd~T!`M#JvP2= zYz(pQV(ufSUDFTvEMX_tm(zJ|y;p<9u91Q7|&smlcwJv^nI2 zWM&3d{-gV1T-&z@7vVS?S6>iplVMJopF>L16W8_+c&Hs+aS@9iDa{VBB);X+!^q=0 zkB6>qmp4i#y$Ic2F^%R~q=@mD|3${*!Sm-&n!CCqcdjIdJiB(j5Oci`N=qa=6`#g| z0qc}e<}^=~!;Oq^I9v`11)d~Dbsvgr+mAxbbu`A+KNqZpM48b`Yp1jZ98OWmhGgSV zZ$?dc+L#R0598YQBGRXhZE*$J!7Vi7{OmruG$VdiY@fN&_x-BMjb(y>THnZ6zwY|D zwmO78>Zp#ZpBvmF6MURVi^fq+M_udrn86_Dk7nAiIqt+RzwYumR?xV8=O|JLzVTwi8zwM`F$x;!%8-atSk)zao*_uf!w4yOlMI|ttHtOASN)rq%X*AGxU%pYYT((V;;Z7bqhw#PVf;>hru7F_Gy z{hx7d%Rq~D%ptVCslk>2Pi#^U)IF)seR47}+{HIv3+`YlBs2pmQk0torDtn2=^ODW z?8TeJMw!46Aei>iD98M`g1-hU?Kj;ikd+?_klEle1PF6CxwgcJs@MTC$7g1^AidKd zYYjLpSbAuFqq#R09p@SHLHK9V*<3Pl&D-zSJuR+n8j9#}#K!eaLivP?TczD;acu?= zosLLS?t+QIWl!_*78Xr=PmX3l@r-tAy->b(jb`eaGJ%gHIWA(er$~%2Xd@4)kh0n& z1{D=lM>(`{5u4!s`?&s~79L8AsdAc4W>8W=$0+1mQ0?)A8XVOx?g587K-n`*16|dQ z@VJ61R6S}dYaiuM#1*`Y(B#F%jAp!+d&vvdXy$FqohyIsy_|(!Q0h_HlP?o4)`@f7 z-Kx}=g40y!%FP{Eyq{(l$y;ToMHPqM*lw;R^)WvS^|2Hj)PdYIQeTW%O*28{1;Xyw zC||N>XX%IWSdToM;}E8+-NB2CDDylp%GI^c@gO#$blANTPxtXC$M3OyYe6DS>MpBz zxtNqSo0PTey=Bvq{&TtDO)(_5&(q!gv2FdaEp=IrQ?aDJRl%4c7C!}b7V^yF^5T7_ z2AR2-ls41-9B<6cEFMtPS?Po1d)y1@+}RtK3)y+DXX(t;jk$~DQ9;4o7h>DaBgH(& zN3jKe@RZEmWjqgpbrPQAG%vGh0Mq*yB#qklY=B;tq;;g z7E!H?I;6sa6~`lU3n^2Hq)qM#{~-xqd9~UdeoL#!7E)1e$Uu1X4Rb@RRa{C`q1E1X zia%m?3L5+iNr*doxyX)~frYJmhukc_ouEwtIF1fA@UF zd$DSAk*}7nraxk`p_Q~STV$102IE#0YB(Q@6n9k5ywQpEdcUbsQf=?uV)HVWp%hta zk$El54m?~>i@PlEqbvco;L0mKMOC$$ue|kReiGPPw}d5I)Kr%Behc;>c(we>o!_ch z1>WLraqVTL_#>};X;gloI{3Vd5o4>e-baLYFC%upX~pqSn}IUduBqH-pF<_;BEIxnv|EUs1ZI}wo*tHr|Bcpyh)a?bE5Yk_fkBe_cf_gNE?KF ztYqzV^7*Cx*w`cZ|_s!~||O@%yDp*(-7 zu;rQXe0x7W3y^Q`UA$=mRUI6wKF*Jh`=00`p&g)Dogc$h|Lf% zqI8PN5F~BlWeBqN4>Cb$Zwzq(mUF~F!Y~np2|E9Mwa_~(xU6Q(8}C`X>1uC2ZqE=t zi!64FjsGkrz}=hknAnD_-7!b_Wn+s){II=!Lq&^IP^#DHHjjJ?cM`Vr3H)!Wd(C<~uQlB1&7t%TebG!E&6?TPV%X z7Lz4={T?Q3tGKu+7wJC7UXbv0j8o-f{+4{<(_EqNlNG(2DC6&d8$-5%3+G^Sc%irh$JVkc8&OcVb#ACN zcY}V5`sZ{W6*e_z1tScbfim|^*_)Z#e8R^<87EdP}+( zYLwEwP32M>_KEWO*^q=!mzZoN)#*}G)$QtZnW^CwXLp^ zRhw+>j+`Sa&v-Iy-2q@_T{o6=#-uCJrjIgd zK=U(MU$Lb7w~Lr+(I|9Q*C%odbf!VkEbe)U{5_YbOqm1o=bKEoE9PcuZsT<~KT(r; zdw$~T+nT2|Sh8!=eKb0~Hr*FHYkuyzUrUdQdeIy65?M+`{N$${lNB_Zhc(N*eg5n*IYc4Qm0VI! z*eK;`0SStYhMPe6GMH%HKUfpxVasuZe_CK|%REz(+gnoH4;@col_iyl)hepXdq(TZ zJbI;K)XF?wIj_FQ^X@_CMm$Dbt|*sU+sb)}gP4eqocN^Q{{FuV_r=3-W}G<1&0sMY8M=oTVA2Ld%49sz5tcsGTa( zPW5UC3F~T=t!p%!$@kb>hTEuV*H9bTA8Dgsr0yl5x%lKESOF>xn@?pO-0Di0dSBdz49%=|^PQ|&`ubrqgh z9W5%L%%4ZMip|~RNwSs(V~ukMA0=CWrs|XXSH1zhM4)@6(_(*`RJVi+YV>N62@dXO z7<|csiHZ0F_oh$KH-UJcuPZJ4#IO5gblb`37W-cv9nl4w#^iR$A+z5QVt$%rz+$rV zDqy(EZ@Sx}+gu1%=QteQw_yy}UFdXu&vJwt@lE%k=(bjPHab3vj;I=gqWE(0ULr4a zhL*jjP>cdG7j%{CZi#N&i(nr)K8UVgKW3$pmwSM8M-fSXcXV3={62NmMfa^6lOfC7 z6rH`pn8svUODt)lGEJ{o()=>BUoocnXJ;AHB$-7e`DxP3+*k6`WNvZ*BQ#E<^1W!I z7vD4&M`iNWuVONrcR>0+S!o-m(V0;1HjUo_?xXRz_)*g8+r~68qNn*7(|p5bfWO@5 z+|DmF(xSgm9TuvAzhOxTFH2 zq;U2^d<%fQhLTki8=O9?r!CcMj@o;7OB)-UF_N9{C-%r5x}`g}sd|(T-LjqA0@{^) zO`;tv=EeqXOh8gC-7y!pwlVD@#T|(|vHrSzR}o3d;ywD&vSgC7{09|e6Fgj#{gLqo zM-G3Vs1A0vGpna9Q#5^R?>#L&)!7~=Ik7dMCjcM(>HSRV>NK^)Nk863cT5_}>=V_F zNhiqit@C#*alm5h+b=*Dq$a91t7y&ks@{oG^SJ1VIvu}OWlOERQhCyXikYp^p$h2q zcq+&!Zl${p>116m>y%xII&Dy@SHiDqD?dGi3d#_XR>-N^h;?HQ>I-^Zs9mZ?otD3P z+KZFzr|i8c(uq2)N|N;clRdJBZfVlCCwi0*-Lj-@{+(KTqaCFo;RBMwo_bhUACR@` zZ;Ef#HhTB;-O);KtT;oXE`^|;gw!@MSOMF}%XFIbTea6Ob{!ZQW ziNyS!y6k;FM%)oVR;Dui;2_!DtH!d~>Ew0>UvWCPowldbf8#2g?$%bBI^C`9Y>$yR zzEInDOWMw=Pi$pOJ@(%9QcEXWp#H(brW%Fd>@jD`} zus}wz>|rL2=ne-aB9mSu9N8%|Z*}KTiyU5K#7D&GI68w-I)=I+9(tJnc%*Wi_Fhy@ z;i*YopOL!RgCiBTv8BU@YVh4zBfb>NbEi z2^?;O9(kbkZxnlOA#{|%jvmYFY^PZJIhNSzW4qWX3mVxeXJ7`x3}03tK47Obz;6}IDxeNH11tkAa5p<;HOvLaL)Zz3I{|hb zXq!lQ#BG9|g}oPMILvEEQw(zfPzBnq2Ppe{Vs?L(nAN>2X6qa%AIH7*{qy*q1;X?I z!5tE|7w+>ZVm9nUq-%#RgiT_$bv^Ve+?24zK=`i`_V6hQYXxk(2B*wHINe@$N-fM@ zVCFH3?LQ%A2arxba1F?Y{{XNG=mj>-kg#0}DSH@gAZcQ!w1Ospx#%+qdmi@7h$DCb zcfF84EukncKnRcn6EWZeoZH7v`Qq7pNjT!A0q0xLZX_+xi(w8Tjk~}x*k^*4MlP=) z%`crXV6_8{66bZ?3_HK9Mn z!5#P!0JH84J0%YG-Js8b*$Q)&x0GE4dneLpfY}7IIEbQ-!CnXZHJG15cxXSuHUN?X z?37B-budjZb78K6X@$8A=5EwS1MD`~&%vZV#tY(NA10-z4*SYfsTy@0qCbcC0~ zOabNq6vE#{xD?R$AkAXXdSS1{nE75LWvL6xsk`Akst)w9Ta; z1tvTrW#vFW?ENm(J&+5m1$5|Na$q;?k~WNC*uO8pJof?Sy{S@m5ar43lCa0%KM3H% z-)tDd*?|SXWrXbqu8}x1q-@GeDXRt~z#!b0fpdTh*bUeKJK9x%^mikENjvHkW*E#$ zKm+6gRp`G@C9FSSgMFX_bqF)~D8>uW3wJKeE|{xe+F_zr=?2)(1L6~i12g;>>Jcab z_5+>301$T^=>V;WR|m5fxC?~CJrmdjlmL}LU?x6%if0Q%n%6o}KA5Wj@k!JlOdBu& z|5ljifWrtg05c9|3Xls>a@;+I*#xK&@ABW#ZZMmGW3b;Pc9;`Rq0N9=*w?~52CRZz z@EOVmqyd9)FN3*>*pcr!m}fxihbieonPJz#w1F$bpbiCvkQGILmqcOiL!Ac#x$s{N zVE%@nAl^-|>kzLMrX1$(QYkC=9Q6YCHGn#eb_Xc<$ze_aGJrt17ZG(9GDE;y%>i8t?NcR08PMUKzi&Ux2TFi* zpGa9UKc~P?+$?1`ftCwS`t^1{HF-+S>Qnm_a;=bva7n2Ug9oS7CO%v#v%fWtsP@G{;P|B;G!2A(Ga{$b})CqOPx0@#2C zsKcT}ML>dDPQs`(RV?2a)VP2|h z@w~r|fwmh+1G0flz_~gpt3jLVfH)u*Yc$G)BUISyFyA6 z!JYy1!aV@&hW~=&QuYi?YH2XVjuEr{u-_%_UOWd749I~vp#Pbf)J(+B1gLf}TCrYW zK|kMxHl6BJzTL)fkFRfqf3rUGR6zhfDNz%=Yau0@+0cQ{g=aPV9x}KfJ&gJ5$i?3b|QogLlvgMJdfv* z!z}5b*kgr4wx=_MeIH?;TCJbb0JFGO%x*d^W`m^^n+dE1T7jxRKs@OP#fo84SSJU< ztePTby8zpw-=?ervVjn?PV1+rfBnjFI)ssL6tdzCLbmHL#db}`dKB&n$O~etTuQl+ zZ5oAs1oSYNXDEzupoxb%0lq?cz6JgTdpz%Uj;Qv*&Meyqt<2e9Q2Jg%46d6G5sF=6>@gCsNVX8fD&?H#d z-<^_|`d=^ZEIT`8UuW(*bw$UNd$0dBGa&7YDVg4w;{b{Z$8&}Ou0gCs*e4mk^g2h;u0Rq^IU@|aQqh9=BX2T5ubIJsF%2m97VbX950Wt94I>-6I%)NrT1vUXv zibo9`r`T(M7qTUYv)~5W6Xs>a-2}TBVa~(-{dJ7#ROo~I3F8L#Yd_;X0K4QS>J?@Q zU<1txa}#i`ALAHi7l1mO;){H}0Y9K0v{mpgnTq~&4PzU26HE>AWsCYkSQcSs0t^rggaf7`in7AY1~wsn@gJ;@| z3j`xi3hp?V1Hdxi9HHSU8PMyH?^?L6KqYV)*bmx%#O;K=0d_mk0C&@GGByx6b63WS zfy>BqCd?{?s|A9Q9#xFmL-=FB?f{BqK}!Q%z*>Oxi$T==s=B3LWqo|&^0&qE@avx+ zY1`|+`gTl5*|dOkO#|<}^!q(F(~`Zvrmbs!j^qCJ)q--RwCbgeD{S}QNqv2XLcD)^ ze#9T{u=`lotohGJHl8?eWufHBFJ}j)(dHi%N+Af4IBa`9wk1?qg}n=z%R~@O{O$R3N2mPilWx<8 zqo195zaM-%I0W^_cF5dUR|6{;G(8P0cX0HM?1I{CklW@lX zI`}OFh<-xa4;R7^4G857BYir=g}ZIrO3;7wcM5bFcs~n#7wFO3ax(Cp>3}@IEP&=& zw6iG4W`J{IgaH&H-ey1yV6zzMLD=(vQandu*oj9N4L4`DB@*d_yAWZCj5Y%LK0qsQ zg}`;eJqZ{E3S_9)zC zcy9n~2K3__8eY!q3b?6o-v+J%Zav=jfPN#M8vqzT*?&8pw*#61djOq)oZ08# zQhXfMhdA~iediHA0q+@r>B#fRaL^&&m*5`@w-oqQfXx6W;2_{6;2dBKAPUKueF?mr zgtTY@qX;((@%{wrkW~1sg1Zs!TDa|S?V!00nsaz&CLvucuXASq8U8v!&g=_>9JezjsiyTtOb1E=O7_;BEvskj4hUR)7v+`vG|X3;djbgMi}zDgu2BxZVuc2|i{4J_f#2 z2tR-ZdHe$5&H=U|u9I-j0^UX&W8lBMLZTa;Dba2Ifkb!rNr_I1G(`gP;5UGH*C0#< zi3_;xc%F}X+>G~Dz(K%Kz;Qqy;4I)g;2_4q5x5PAuk@GDuQ~)eJJv@wK+pIh(KW&^ z3u%}INDV_9h5Ia^6fhs}6@XO$I+>!@!A)2PzQZpbV8^@s*Am^r*YD1L2k(agzXfyx z>fu-T`rX-UG*aDsxXa*oi#=twc1&C`q+`ee!o49~s03$)40wDE00d6Xw5b!LZ z9^eGD1I_{N0^+6kCWp_l?~&+EqHGfIt^+ItEC;LsYz8y{`r*$-dKf@D^0NoHPCy^v zV*qKV8t{xmF-SYZ;R2vB<_M5Ris5tazUlLQ1CZi98{ubTejJH9Sa3|D8vyQT4EhZj z_%S&~H@zum_EWPTnKmEqr2spi888ds`ao9-KDXn2IpH@z2mE~SLBI#T0#*Sw1DpT~ zwlisla8xN3^`U@a!gp4PoK2HbC0?Y?20~8=Uk#*wZpl^nrIuG;XyO=N90j2O; z4w^Lpvfh%1cRQZ916+W1KqufhpdWDUn$I^3_bxy>73~!;A5a3Q0IUPp0nLDRKo{UF z;A6lrU<@F50BHprgzP1Ss{!Z$g@97Pvw(Gg&4BHIJ%CO?A3%!oItzCg(E1yJ?kM88 zjc36$0owt400#kT_#K7Y2Ou-avv7w2cL9+ow|D^2b>L!;*;#-B z0MT`n!VT&>D)4LvJgY)oft!JPOmz9v9|+eiL|WQ`>jMk}ZUYzv;sy}i3DL2TwW@f$ zYXD^GO8QLF-de$XqDz{Oc;CJw(anN?Az(RRBcK65#)Lg^-v;#O{^K7{Bg}C;FGC+S z0Cxl+S0YSGxNZ;P^s&=ric^R->Y5s^vmowP5&7(UI?~=|C5P)s zn>wlu*A1gDI|rH(0F?m#0~p{*e|QjK5+?g)>jJb73;Y@Y>>M5S--Tx~U&=uIWWGf7 z5oFGkiuZMiIq3g{=>LQqG8T13Np)O2ZwI~^a2v1(&?64J37^Gdie069Pd$N=a71%QQsWq{>?X8~&f8v&YW;kqoOk)m$= z-sjU|!q?RWwE{)Uq5Fb=GvFN79m(A4ES^Og)LQ^}jS?RFJ(+9b@8HK)Y;Od903c6h z{b!fJ?E>5dg;s2Cxb+3*X-Z_iexkfXq2Xm`9TNcsqC=>HBK-z|dE- z$3Diq2DI|&XfJ^I0J5g30Zkr>1MixL5D(nD05YeI!8;lA$C9PG0?@e9q`EBNmf?96 zZV6oKVese?vl~#? zMsH(H4BS6R^pk+YfPyLCuxq^Sc{Dh z63?mV$NPLf(r?;*823O+`eD*;$Ivzs5guwMD*X<47KLY`>zE9P1wem2j4_ssOB<1I zdpgP(t_!Xx4gCx9LB@}Bz^wwV`4-x;7Cgf9tUipX0MR_iNbpB&R3Y#>fCi8OzuTbA zf~x~`&6nyZ#5n+5B>Yo>n}zsEA4$fl<9~?Oojnn)I|{$~h?B^DWZb3x0=WXTwN26!HZYiZ-)7y++bO);r%@%rGd zjfpWbv53lImUl35)O+I6AK_t&LzyEb6k@ATx|1H1H zBw2j8MoNC?FQS#6{45hAurZ-v2eIO2gp}Wkn+XfpBQ7#AA{!I5@@9fo-b}#CyV7i8 zB5e$@XJo@i1;YpJ8DB6lQX3N;^p^$wCkNu+;>k~#`)D>VJNjVh8l%g%c*kS5H#l`K zi(*B*=XjRNO|S4x2RJL=JGf+1VTru{MBjnpUs6S@#uxvF<|j~x7T-F+RewPjzbk;% zmx|QM*SMm1SuD>8!zZr+_LX(}SresnONDD-uefc$DJ62nF14lAHLy~=veJ|&Uh&#w z|JwmRd5>E0>yWleW1?j7G#zUrV}LG5a5(F*^@&@s5h{A(*5a6i`ud`$ZaH}(5j>rt znT;H0XmRarSen1aHP9pty-10}MHM}Kt7K6zk13jdtHgYFOVNY3N?y1dU6g#QWXniP zQPQo77NZAQmK7!3syIrJ`13G0igm6V&vRc;`P%%{o~ldz?Q9 zI|WQU3daFXS=7Hs3?s#@{9CqILERSH5&=v^7k9Gz2VS^qSc$fMu+;J%Otj5acY9|L z#(pR4t()HotFF3h_|g5aEzjTWh06VV!VZ5otoix7hWYoydRN}>l@gIb5MIYSsv#w=1_%^GvMn+d3^jY7(+2Mp)Kai~X{M(_$aYC5g%ciWz;w6@+ z^~O@OT5Dwav);+)sF;`9t(>zbJ<6{qdG*&`7Y_H}i*IHb&{ zAu{!k?kZlrNp`%!Oke9a(>G;TW!thn*&W$E*=LA(SKvHxztKKS_Dy9BYqO7?AFRRt zJLBE&jCbsw>3(Ni{dcMC?WpN5!^qZnxA>BhHK%vDl88P18{^&WAe-ZUeZ1wbQllZn zsNfk5d}9J-G{g`?T0<-`q&375i&?`IV*1yE=Z5=OcleZiX^B5=>v6tt#h`l_Fp<%Aig(be{!?Wa!s*mmt z5PN)vnARG2#VRUo(ajRB(I8;s4Q1mMvhjwMNQ?&7`q#i({~B29UqeKR%4mpWsl_Zc zYyE4GWTk5jQr1#GnzhuIv6lLi`3lUpqHNq4BR9~M>$!2*F;luwuIEm{j+w$d`CN{T z8*k)J^>_7p?gK&pX#sz+jVm{D6+wSx&|eksSD3g7dal|Mh&B=ah*rx@3YhArJqdes z17@|Ui!Dap#yRFiwgf8m8P`CuxX>(Ly4a|WTL8HcZm=E?#rfK&d{CBkDiPQV2%(> z?9OJ@No4@@4#6bvY!-JCL)`u*vHRecO-;`1om0f@n1S<}L`^%}_OYAf$gVEdzV^G{ z+Vh=n{pLI0+V!1p?fAca3qqh%)v({ypCWeGewmV@p+{_i*J|<_b0sH74ypjI$C#$yo;bRV2H0V)qMQ*45da^@4{&{iesY$Zt*CKakPD z9yZo+m}Tnd0GPUxWMXb+BaCj@_j2;Sq&@j09YB}}0$dk&M!DKX2f)!ElU&B`obqIl zqkEUU0kdf$4pUUEs%|$su1`Bj2P|H96N}g8h|Vbg*%NKMZ7JfKDUx9N_GW#+_JzUi zfsh4ZI17adc+}W1uwT4Y|7F{Lr?5S?KD~ABzHL)*Y((h3UDD2|*4TZ!!aJ3%$@_Nk zTeT?UxQKg6%KrU?A|`bbWenl|e#WOGU!B-PymOZ#kW&r8#5$vP?urQHR7G++H#7Er zv`dcNi`E|}Mp2~m$SAC$4^95E?e*4q&BDN|^h?+47EcPVcxFfd69IzkdG*>(n#e9; z4f{u7D()73IdkR_F0fG(u?)dVfK^V!`o@4&)oV{`30CC(dJOfVp`&Zy2jZDCKS+Ow zix#DiVJmi!6+=sC!zVsA*@O>r`5JP*zcVw7uFj@VFFLuTvZ3k>jn&m1S!b8nV+K#g zG>@MV#B>N^E$@l@KazU{aa5bQ>s>tHz%|anHaYpc@X)7Y`(JOLbVd;0A($GZd>}|U z%}-eku7mW<*#7rOr1B1dB1ozXlBy;~dU9<4N6q6sf&`C1Z3%oe5tR6{(W0eW^bd$@6^TR4L z3?bCy<&$%szfVw^Q1~xy-rf3q`A43L% z5OWhYI(a|(8v77&Kpu^q6MTJ-u9w8|qp`H&F^JPkxH$emvP4z1cx*{}+M=;cX{;8^ zPfvYDkqYK>MKOh0+g7HhmX1|Zl*vW01ponVtjC4RSkz~}#-Tg&1X(DBEjFANDX`_@ zxC2`*ZOi4_av57L&z8%#<%U>ikJU(HTjNAAws`{6ywD&+UT?Ez5`KJ^KK3co6O9ZN zVzT&tm?xLryOqmLOC8JH&WOUm<6}%RCy>4Fq%qK$>&aMmfY)*iISlNVBlX8h&CSsx zx664|Jvt9p`Z=NOtH=W6 zrpA^>a+61LlSkX~xVAjTmdCT@@ojk_H4-LRpYquHl*iVmJhndNO{hr)K#=+MW)fnB2$v=wrOg+)qP#WTeLMTMmSI@>u@nadXbzn6nf7 z1)H!RQCUU>D-ibpA6uLc@V)y8bJ0f?M{!R7=|=aTZglMZo%>HW$d<+wX;#$T^wXzq zbbko!@7*5|tXCt=!Wlw1FXZ$eZgd}q$NTR0ZfK*sU;S@Mav$OrJH8=h7U=tM zFm7W_b{UR`lRMa+qxD8ztxcdPKFb6Udw^(NCyV2lZ}|eK-vA{FZCvMm?Z!ZdIAs@l zoVq%60R?hLfdU={jm}0vV@#ta<-vZN_#r`EU1L_@n%6tQR{U(O*{Z9C* zVEB??_~$2tzxuz1HwD8N1jGM$LijKKHT=fA7+|nd2*dV$fvxC9(=JD-ygXSRkj|cD z5sJP$e%TCyMdKfia8HFkgefEkGan449#`njw)fT!E}}dt?|F9D+&uyCF$8z6zZ)8e zZDt_)*kJUJeoyq-Z1n6{NE85QjYw!$y*&6S*V;h?KBfK#**)2Wk=)h)viOkdM%~MV z`7w$BVj7E3oD=wmo4S|n&Oc-^rv%tQK80*Onhh*@wE*+U7+PtJz4d>VM(p$V6ns2(MSCW6r&@)MDJDP-$|P>lJkd=SKbbsgAP zU|IPfi2agalk2r-S@|G*>$U4RO0Mps{^{bB0DGvi-(9cbYfLWRipgZ}q{$T<@PEed zZ(?Hmv5CJoX2m;1Ut?lBZtCT?+rz3DfsqNtyl#~libf$6jin`c2!m)*XqU6R7ZmNi zUfa_AbrmBrLdnLGI-q206qhcMJD_B1Nb|r!$d(|DP0Qf zr38`2$buTi$$kwZp$sdkxqjp?A|CD=!k<~S@~2fH z8)Y@3(q7lVM)8K9RwYHQWzVv^j}WhorK^*v`-rHuakN1_0U=pCg~q&iWiHwBy7AEJ z>w1rGZkULfJ0)k;^|=pXR=VyCx=NcJiv6tqjaY^Mwomwh3 zo`@`a?E1=<9_||*$K!C;VcvCg?$sJxskOcNj*StRP@?5x%ZqX&N|fcT5hc2aQ@V&{ zKCeuBeaYVTP#YsMp+EzalY*2HeoD6Nd1Xo0mmDUMMw(Ef0n(@-sbpfLQ?D=SC6rPV zN;E(z3sO$L7pc)jl|@}QmWR8=*VR$MtiC|@4`;C)S*jX%LA-Qr{|fPH=K9JN*@o3I z*Vl!t-=PO1&PNuSUHt}e**Dkb8T5?2T>69wXZW~cS7ZoCd&nU5y+g^-hsA>P`r|Qk z4wH7`)%x3kKd=sGg&dD`U%uA1hp_OYIM0WS^~N>ua3CLQ3rl~7ILCV}HN&EJ(fV9@ z)=&E+hST%`o_Chd@FyDIGrA_Pc$EF#LnPk#S693vHXe_uLMvMeC=mPi()p6sV?0+pm@ zvSdm*^eEJes-aA}`nV4{MpMO+D8)O-IUVXLY_XQTdaa_k_>;)8ZPzNwi;E-6wqC1v zvG|jSvR_@RsFuArsd^S^;4i2)JY(W-l-)$t4C?$Vf;|&?AUzYL^;J9X=U+ziHBdGO zmjDPAId%e6HuO&aLN2b^vF84A03jhPU}*^pz7=&;&5nZmO9Ob0dy%Kqy}<*U^&p`a*lIotR)s6N@p z9;ZV2(|}J8RO58~m3Dl4tLoZ@_1SamoR!YNC#FsKL?Zb_(X?y!MYSPzbM0jN3$;ll zTb5*s@{M!kC7hLJe6>t+ZE10t9$)>xc1~f}mh2_{$p5c%V))Et7nPGdMhiXL3a>p2419aOEp@ z%%zOnmcx&R;+!A_;bY%Sj3v1(sc*^M{}?r&XA2Qs_&elKHTT~~&8vew-K*&7ycco) z7%795Di6aqG9earxz768C>UD$VgtsD)h9;_7h61L4jADdb}cVp44s6*bQKv)Bm9G@ zYy)L}T3B>?bUzOrzkeua357wzumE8jg;_$&Qen{v&{i?L(&7emcSUcE&daaL6U6hX ze@;!>iO%@ z4eMG%WGPdsgrtgMU4~S_w>=+9;f4H+R*P5K3E?&n+CxOim@2FbvF;wV3u<@v{+Mzw z43c9B^lyB0Ug+OE;7J>26%^`E39I(__GQwBh5rkscfQcGptyP-*jmMKskN$4Zizj| zBb&dv-{X*)FVNVr*C%MdwK< zDEG)zKVsRGrb4ix__M0R58iyIH&p6IOjPY)BKf#A)}y$ElU&F!ioVVtQePbR+Y2D2Yv~n?_ zjIRP$0+bH~DW^@O6pU7`Ae7*+B1owWQmQ6Wj$f@@ODGenu$CN%Gcib+Vonhik~sqck=e7Heu{VfTxRu-L%Wy!=un(v{Szs7Lt&r@klU5H}u*$_qvcKmo&135YQ})W$ zxz+ApUG=UScj?wp%T=Gu;NwIY|MQL)c`xw?%EgtO4b}Y>V(ZVZuB^y5*f|@5!_xYz z_eVadF-+zC2MzI-G$u;(0aro~JjmtnBK_w&2)WLB23=F-|L=IRk@Tu6*7c z2#qsm>QyzFoyYA}5Pzm~3fb3z04^U4RD_7Rd_J zSuSvkp17L5h)^aNQIi9di9t%ToOX{g=W4c@P-=`!a*#45NcrGI${AO)Um%pzaa3rK z^5G!mBYsM>4lPE%2d`?)0{6pL&Hpv-N?k)OP<`?$E1>+GZ5~xY+Y)5J$nYt40QGm( znAmy8LaB6B&Lda%W$>`li5T5US8-%cf37$!>Z&f+;#n9;07}*jxO^ODpi;?g zuKohCRd97)0c85a%V|FDRG)U$lIJR5TnrWP=D^#&{cu(cQAEuZZ~f-Vyt#Tt(YFS1 zde4mW^Qo=3uMFtLDSP_g6~B9AioJH1DBklRV?I32e>@n;)hqJ~3f9Q-NR$7?cp&CW z1i9U|dw5P(%+?EmIO@dEbItS=$Z;0F6KAE%l`iPB6#u+}vm)DLQu5|HF&1w9p9$0j zPUY_5l!RobK^gqq$M<87+uA>YRed&k*pQNU!;_M`;5 zcehU@tPY{56qWUjD>xcIWgA%e8bk8mlr<$Gc^j+3fwyQ|((bcZvyJl?P{RNUXgA3X zBa`yvHun8DKsoU6L@I@raSpdx6CK^vi!N$P%OYt#>KBkw;-VVFQfU!ObpV*sK>t1@LUnNd; zbdk9kl%kCVsoE}FIPe(lD2U-dLiKMGr#2GLtxq9gVantZdx280N2U~#^d^h9&byM5 zj6BHY(!?mbS4kOQ6zNbkk@KpG+xVyTSNh))r@r1bkRncb=r)Z7!KO(is)`AczK{q>3{@+x6pFAE4lV%J|fDXOr|FSP5MoFcnz z?nWCOgG;TmXkuwdncrF(cP>=vMWSg9){wYVvW91`{2MP z@yu2%rZ#Q&BugAFUqh3;@dv4P%Yakt`9SB|V=@1hO5Nmw@~-0}U5|@%@NJ83k6gWe zd}fA?yAfw5=Wb-xZloM&q-F>wI{)2=^EJoD6%ki7G!AFg(k-&jIa>OikY{j$`9_(F zwM{7}0zltNc!s5G^({DK)d=l4>6ZisDYcbzMTy(BiDp_k7aB{|UTugdRPps?hn`*M z+~0swaR1{nS+j0FgY{VbzHO5OtF(W+j8)pW`t?d$Uaq8jQz-ueqy};9gJw92+IsQw z_eFmG+mZjlA9ms658QN=di{b&!c>%?0>{@!T+$VRJC$(0T0 zB@~A)H#sz+^~UD6H2NgTl>3p~UneH3ra?dvgC`|)&aumShSF_kb@IQyTvv-L5?;+} zjS66z2qvbcDX~=)8!^KQarw-(I(+GKm}#NqE0Khenm0)a+{~+W407iR687$B9)XaAGT&K zkSb8(z;=Wv9wb=gPmx3tdRlmSV6%9hhGhKd;rv6q%L5;Z+otzB#7z%gq@9Zzqe{$6 zl=BMu7s9{bg}GW0qt`2-#g}OH^0s!U+EX6Hg1;$LA!S*C)M&(MUyfiT<7VUPaZ(uH zJ{Q_wuZax+>~oxRI_YWy^$KemN$CZma%m_|sVne_m};UI;K=g$STO03Fdi4J{_4(? zLO%A>Ia1hcV`%)_2uA6~H7HZLz+|YG<-)yF7ZCV#Wdagz*kRlWlU(==ObFxB#(r$el`M$vv?+##N}TK zIX2R;%i>($e5VtJv4r*3&XKm(BOB1K;>2+CtZ@?TV-oCW9atco8%Ngp^e&>^d}Cy0 z2Gp9l2COGMCa`mh?Y{k7VtGOY5v^FUcVwn^|4#|x0HglroxsusPI(WmU*wSHdn{PQ z*C8Sjvk67x2!x}U$UaAXu2NDA6^F8gm{pMeqm#BC7{Rfg0Z#l9oPa6Ku30dJ@$;sR zU}AUfO6gPvFk1*FdFQT}PHg~VC7A4;yZ9FWG82*f-VUZ>P=wcjB(-+LVzYD>C>$d; zGz*Oj)kv{=gmimJyPhVCi0DP1A4y5>G+LbOOC?^=26pKJp5?^T6!0_=Pi4|Bc0m#$ z|BHB51w4O5Jhe&wG~tpF|H=@waqdMUmNtue&%N}~Bz-n^dFh8Ea*YL}!(nCYYXXcT zZ5>!@gOu@LM}hnyfpyskbR!OSEIL3do*A*z`}=v|gvkPQfUkrW z50BTE08eZbaICuZF;e7UI(Tj^9 zUx_!qtUi3Fe(3?8y7LZh9E;M25mN%wM><4W7CurCt%Yd-R}0es{LtDw{4&}+o;HuK z%?o*13yTo8--q46_uB@rtAOzRe%k=O0V#*?_uB>-kp`QKvVEU%K)@iWUWPixhobEmpDdXk zW`HFUy=&7PCtW?4>Mf+Kzxu-2 z3URO|mNq;_S?j;BcNU+WWUc$cezLe^Qjz@&n>xJchcAS|A!|Jetk{wD-~fkHN*24wL> z=g&S6oj)Ns!4&=CixM6d`0de|&J3s8`tvWyah^DEG$xT`rZK|)XkV*6zpui%$hz!{ zn%KyWpxW+WryNDv>nq_E^X^thqQt2~PkjMJv-+Y>Hj@iF|0a!tZ^^yy`wZYcb!ZOj ze*yj+tuVG+5{`*FXc8 zYZHc>Kln&_GcCt_HYOfIbY6U*UIe;$Qij-MUBDP!U-3m$^PrvXJ86&Vv)h$@1vVvD zb{2PFK@PX-Nab34NraCxEw_BQLB2R2N8ICddvaL?ThB1mk)HbRNX^liHevitjoK!R zsW0eoZ8rbj7pSknCC^T=_I+Ai?L4e zCn*x&MQpg<0Ap-@v}>sx$=V!97RjF?{0rRUhjH8%6)qd**iQOzs=Cb>jywHqbZmKy zh_H%QzvF{JnLai+KXAhwVb;r{xR&*I$XVP?Q%$%R!j-uqYtrfQOWos_I^0V4_$BXE zaYdXFsvrYLZ(wx9@|>q5mgjt3!3%l=4&wMg5<46L8Mk74*KKDTYm(SfWO-)kZJ|dL4R4$e{#V8kWmn$g&kxd0T3ws z;im-rbBuy`Evz2{{tpEGrv?0ri~_k9CXWGsWzb(0@Gmn860|UM4EQGo{gVRzt2?^M zbT5#0sA~7Zz^*1Fmro98UFCKky9*o?_#{SY^Y>>ZPsfS@d38qDx*XZcR0^Q zi1xe^ahZ9Vd5O6rHl$L=1eVqYBFu+fYHI2Ul~TV}IX<|Fb{qa&c*Dv~T?e+U5QbO= z))*4dcgy+&edkWom%3?m3lF%zzG!|!+-z&5EoU40UlX7H>SEJtka?RzEacJ}(3i*O z9(71@tjbZZ*Lshx;Pvh#zM~wgR`=H*ySo zSQ|`_4tRg&_r8_QSPIvC6Uxr@iP0ZzIOUuC4BeYaQO~Q&ckn_!r}?n3d0Zvhk(n4W zP`HLn*C^^ymB|&FnW)50iNgE_GIcn05rz?371jRM=|5iVK6SCfy~2IsqSqy+GF75i zGu0uh3fB;kg6Qw?-a_-0I45q6XxrkqCY^r&Vs{rptal%|=zUELvF3B1))h*8j$Z73 z7d|h!J1(l5#f6W`3(XD0&g0NUox!4Kq_XqW>9;R-9|FxU-1{$j8*!Ou1x?a~X=v-k zl!VHt)bs`@-_lwxk}03o7+UD(X<+ig+MP`p+bSeg^c#sQCY^R&>~-VlnLBglOQwZZ!gR21$r;vL|6aeo9R$2iCR zM#w01Vs@g`SbcG62{C7uCaXoy9%DXgvCbvYKvZ26iX*u(0Zm=d(7#1owBn*=i=|Oe z5@&sk5WuY0_2!2?h?iDh^MTX!oz!ilSrk2ev2IJNpm-)L2L`V0Vx5W4_vQ5UY1y2) z;w6f8-Fk6c@gQ}2$;Iv^7du)w?t+UgRxvBar-){H1w@K}H(X1`!sJYhg+&*;p8{RD z`|*qFUx>5fFfJ#PlzDQcq|?ofhH-G>@=2$47rXO87w68n*s@V9T7HV@RCwN(StAHB zUeY}8%dH~v;^0#rKF5(8@8Hv(+^Hr$*OB{xDR-JJgmQ#%Y`KZH5ZaNOR22dnXiZga zGCIE8Ng|mkH$qfx%8f*+=8E;XQKC6jxe`;ZNS_;y=*5ta$A_D^y+)q3C}AEt zIcP3X#ISkxUb!8d{9-&fK(l7$qL^B7Hs_k~;uC|PhMi*6m;HNyQ1wwCu(lCKPUrV? zeXDPn)!9pB8cqQ7^)S(nB{}Jqw{VkhD!UJ%^A!42D}|fJe8Vjth}kZ|DCL=4$%|*; z#2LAH=r+cS5@{805_^XcSw$QdRJ3BzPrOhhjMR97#u-Oef-P zy!a||4LW7x(^WZ~Dn8eig9mQai9`nv+~YWM7)JatTZD-UvkH(W6gcBA@MZ)&C?# zjiLyYHO)^%r3j2WTTrkzfm9|CkYT5hj82x}x<*?p+xw2$mV`Ro57uN$U-j-F9|x{E}P z3I6@Jd%>_dPh7643Xm)yBr!;Ae9e&*-R6e=POp zNrFU_!yR68NemgX!`b`ac%u%ox^vYB_UC zgubh*$HFROTY`-WX*apvTxmK+qf52UAf;9u_rN-?(FH@9NE@!ZdX+Z3K*_dEmHl?= zDYQ@yG2hwbbFErKEmrL~5nuQ!oAasuoS$1a`l@&-TRJf$6|qQsvPKjKfzjil0<=+q zR$DwwomLKaD~CJwEOrZr)mpL5h1o1eSG&n&m&2EG{ zM?S~kdHZ1KA7qWH} zyNLtIGDID`(EaX(j@`d@|K@^uvKSX@@4C=^7>M7v zcU>^c#OIjPZ(r!{0K(*$Y&ndc;p%gEpK^L}AOvNPYBgDEQ}+oX8yd!} zjTdTSLkc=%Yr^zB)2&-C^a!Y~X0|r2zu+Gi4r`wABm|Lb2$HO&EM#Z&#{*TN9%^J( zHhlI1WWG@8;pC)N#$sX z7Z|gtdKGJy->_`QBStA=L7 zf{PRVpYVT%;E)1qe&Ch7lfiSAC`=S*U3QTDdVQNeTI=J4s+DdQo=X>ni{g)kTkFYZ zNOk#6`U2@lyZ;^QBjou>Ve<_{$2}HKzPr(%%;{DQ@zbSrwd+Yv?qzR{-~WnL9`LWX z`EMwnu&0y66CL;rn;)0RdU1&T)P7nv4@Wk1xERPK8a6k$GFF>HE*!P?5*m-o2jw43 zmc7HIFO@ZMv`So+WaW?u!QW#6A|iz2{!l1&iJqA4lGp|V`6ZiUr`ZH^S_RfG34M9o z2wNUOKk$P1UGe*UyG+U`e`22&_DLesBG?K(NNX|LYx>EW~XfeL2=ADA+w$e z1g!rlA2&HmdXXQkivvF5d)PAa5Vl?*U&pve(IGjB?^HOxEB1evVS5LXKFC(q_l9aY z*SjMz3uaF7j^V~6x%E#0I!z9kK!{PN+#N&SGc1GaIM%nx=MTLxbUEx(VfPzDq@K$U z5LEk+yM0K#P~n{tT<5TQ2yIY)Mm(+|b-(ZaU7zmep_Vg&vDo8ctUn>-&|DNZajZ@3 zXI}Mx#yN!g974W=dq4fPdk;zHetIMYtuB|)T7Sugu=_*2OhSCs4m`;NnR09y0!Ph7 z3L>c>PgW~=_dcm8PNCGd*&8}pJUR;NOC+X1o6JJjtJDb9w}F^B7!nj_tq&2z0QNbL0=BH}Q- zEhle}jiTO?p?m>(!#5CXj}H|%oV;V$A>}}1?PE~SED=9ZU8{(%tx0B{<3U1;x3AD} zryD926&$;wuG)6;?nyz*t2ANze-uXD><`1?EUQOOIMxF8nM1RV9?BfDW|IhP3fb1QA*^p{co3b3 zDk4v(4Rt>6p=VmhPofb zXP$GX40+okor0T7%H5hFSEI`r>H_mMF|8Ves=nrNj+1>VKfg0&OeD`i>Vg)#rVI(7+rb82&&I14|F;v}mYXgim+6!-mwmBT3yU z;t!SZjxH+towwvwPc&scMnXL;Y=2jzsfB=$oicakF`@e#ulGGNYRIZM5V@NO4cpHK z^tb*Ow$7ooJGk%ITroAF;oW0iq`l>if4u3w=7s!o+yBDS>U3+0hP*~KCELOj{TdGf zl7iPr>`>}rc{9tOg!(;5!a1+^kdHI~*Sm7}-@M+AKzcBXv%YvQK}42-Nn2o`L7gdK z&hbuv?Ct*8+u>gA{-YPg)UqwI=p_5uzi_Z!mjf}Yj6TM3zwd2%-G`Yq<9*HN*Kr54 zhj^?=8}><>@~OgQ2iy?9!!#VFH8>QZNaeUO%~uMTQEJ$ z{kpg1*KF5=&76n4-G`8*%kKT&mb%D6SJdfWJdXkV&;hUe0Lh%kF4zx1Xg?~igy8kJ5}qc$r&8yat1 z)Mm+YS<)L|{*+ejO;I&Q!Q}Nm$_kW2uTe6HF1eF=jf+*DOKp3})UE1k^Fro8*eB!XP;l_Yp56YD5H7ex(rl-lw{JQlWTgj zvGr1`muCA<0CLoAW=mJAN8MzLk?&wtb!>eeIFGhuv2`7;5Via`Qt1j+u4KnHNW7N) z#0t)R<-AL2LEl$wr_9SDMUG@)pl-7|2%M-?S73AbYPQh^F(*?aDSw9McTv-w1o2O* zSTe^@PuX^J@Y*{@Wop9oyQw*N9-v?WZ`(}+UwxahK0K#JLi5F(w7;Cs+)f+*o0_AF zPR#q+&_aGss^6{oygZ7Z%p+Mt z{*$q;#)hfB0SQlbW|l@N>zSpbH9CFdT$YISVlq}&2iCW7Q!QeMF zwKSf|%m~Zbc3zk6%Hpz>c7awOS)Z=Xjm#Em=}0|RGq!Oy-azy?lOvMN2fne1=6^ua zsMQu!DYl%KCwSzEImx_(TCqI6ORgfOD5)7;2VqgE>`K+Tpxu3pPL3v_*}%Q;u`GMI zz@~WdKMb5pSHD35J08?H{5fZ{Y8KTgdW<^O5yTPxt#IS9^On>w@_(I z&Zp+NvKSZFUxIuO30$Q?X_z!hI%Q(Kzb0O`BzRRNDe2^(m+a4p$adx;aj=fwBs zD{;PtKd-qoZc7KHRt-v(dIDv&gVKC{FFI8Mh@ukk89G5rr;2R2PPN`9iVDO;>?iWc zSm7^UJBjkT0#Sahs9-BeBB^owEfg|n*g`3k=jC}W4dbFIr9>f54CG#^df5L#t?FUL z!Hl5b&@s#HI*Qj!&X$o4_Qo+1s%dTyiV;jL5|I>E7j3*7up(G{`*B;GHA-|Hr$;HMHR=f1;~@ND}RkAnHw$ zdr_aEtDivBkN4?Gg~vcIdBC4x5iEL$-0>V4{P7cSx(@;TMAU!!%*Od2#Pgq~VPgE> z2^&o8_k905wEvCYXA?cH8TSJ*2BNp1Uty zn6~!w)HYX^5dDqT#Y49uOBbl`Mrc=3$~Q5D7&+6+&5y*NFha-BV$9)q#4*;;&ml5; ziik8Pwy&;L*sZl`_N`E2yK9Sj(dA0$~>oYWf+BZ->}W-9VNm#4clT+;TUc~g|iMLbN!@EArO`H&xAbgo>)uMR;U zL0lgD9s(WQ=^3AQXMWzXZ?SvE=jIC$O5T)W2aeR0t7F)YDzu+N371Z#rG4Hdr?R+q zWAQqn?N#317)__L{beinbI6d@T{kOKuL*wEYH8ZtuuVZU)D*0{YyKv|*-;F1V7-`z zlk0h5c8rw7IHLLOwIdZLwe8cl-WYU-HtguSSs8O6wBv)2hSztyb}QQ2JwmFXAz|lI z+UDXoqC?u(kCdF$x5sb25G0>`AoOQPzK^JNRe%{X(NELw-Mc?9o?9`Md!_npB*Uk$p)2ECs|4E98x)%GZ99F|3UU-EhM(pHms zfW5pL^k$yVwNjpQbx_Yx#mhNH7bj0TrIX!e@P|R1f+g&`WH~uHa8%s={@}YuJHld`e>O5N zk%`m2&C>i1G#+8x&Y2M?yC(&rXbjI!3dkV(q+p7DZ^h0;W{Pe*E6u+(NTm6`PTl6w zffDi3CCNM_6Sb%1t8tlH(7#-)EAPVD1!emO3yUo#7gZT;TEv(Z@k-dvT^(885wb!e z6h#vqN^~#20J{jR>FUzS9)+~#LAlCeH1f5uE;5FoJ!$n*uo*zBkAq#H#(2)8%NPZn zvL`Za>)=e!6K&ou)`0#)#fyU)Iwb)$I#~U|&ypxC5k=XIj7=ZuQBpN=w0Ui~_X^ZG zdVL&pI;aM;O&ToM`bJ2_N=Hr`Ha4 zuNyqHZqWVwp!uB$xx*!gSv^)pmkri!DG@B*_W0JNgRs*awTn|Kz|N&ha8?vA#m;U( zh-`XKH1&xSFTdBycOrEn?+P{%HuB;W8B~i+ZT)ryvtz8kz)AGmE3xmY0MIJ&&W9IheGa#&+*H%1Mcv z6BCcC67%TZd`>l=Qp^}klCDu?5&~>3P-yW=^JjCaMbu3LZFro6G0FB65jCF5;?=*U zr8TK}a=l(dhQp0Fbh)VnlY!D@F*mE}>I_bSP$qpci+5ktdPb~?PLmI&D#_rUl9;@P zgr-1jc#seupZ6W&==;Q*2{B2Fl1)oN77vp*Hau|C2(D)i#>}_o+#53?V#RYby!tbG zZmK9so*-A|rjihN-8cwAIPgjYF9|12IGCCNK@)-(K2jY?B85+n;>L;Y2H-w|)QOex;gy^tAr4hC(vy|O&G^D#s|_!uJp^JBq~i9KX`fyn*&v)#|15&2t#BSiGMsrY8~ z3MhK9X~v|YWi$9eQK$U7KW{QumHyJ z<;R$RLNJlta+cIP3G-sKcAP5KBTN5*()H5!q?;nF?Cm4+j4~aGm!wzRmk13X5{Z!i zA*DF*Sx_QGVO`ft6!U44nFTl|hYV;yDBt`&DK9@p!&5%Ls$1Ipc0lC%I)xOO)U zAG96qZf1^(=Kp}|ZD#XlXeRlilh7<~=;`Uxx#TPs{d9lyKxp6mC)+SsjOhA`j>k2^ zqi3>|NB#hUTaoo>cA9oKH*@=xKut4$ zI^N!Pj6*8gkH29nT5m|8o~c(5M6jNjhsW>Nv$v%GuAUM3IiJ)vY}iC5wPIvaCBB!* zGc;dMX?UM_h+LEVxW8;dOmy#KM8L^KiD;DCXpB$~5HBK9v+a)k`4+z?^8VjF-w*ol zC??|no!t68H2&nUzY~3f&)@Oz)BEQJK_cSbBV@-hBGVin==#!5 za$s%Dq|>hqbl1XT*u8#0ofT2Kva6q*lfv$`G!Hb{ZDo<_72{4$XJzTyu7MiyOMeGmewM^eRPU<8sP1 zAuu7s>F|~Dvc*}_ZJN%u)7yHf_tFGcvLW-ZDH)DC}KJ>60= zb26KJJz^o28R?eakxKXNxg9m|FLS$}a?B5qxg9&Z`Zx0}vWReW+%;2)`>^n&KEQtV?|~^LDs!0P^MA6HnaIYZHs?mllpL>& zlqUOK@p@J{@Jo3z+JB>LS*za7pwbz_O{Fqve)}Mo6n~EQ|GX>{r_ay zOY#|*JA=Q1|Bb)M?_QGMln|S1JX0eOg&llr0g0o-+|%g70{_-cPr(0>F{vWesMO$yH9@0IlZxdn%#EtBdp+=}SnVB>5&O0;j zyz|a`(Qy65ISSAAEnJ^-g{W}6`1O&RNR^uHaWJ@Bkze2uNhBXia9$V~xYGuJD&!=m zf`W;cwKLe@`$8zjD8d}9A1 zAty=83_Iajc{rBipO%NjWadZ`)1z)zD*M&*5)1T#JSFkVfNrYi$(6g5tSae=9ZvXi zed~Je)2&RCIHK<2*fA~}O1VX!gnof`w7$$w!hH#l$+oPv2;yVHsg{=ouP3Jht1;me zp%AR4q835{MJXRYKni(>!l9R^I1!H%s>e%x7`scQXn$w*E>&_nf@J(U(K1iA7W!KE zP>vnak79R)CP1}6ygbelQr6;oE00Z1U@OvInEAm(R*>kZzI#+BG;AcTP)+np(_Cvm z<_IPqM@&_dpjp?H+-z*pG*>iDY@S#52k1x*sB*jV^^wV#p? zb$^J_tc@eyEApyr-o%1?@#Zd{j`^&X8YUp9sD z$QY>3z#gyAFp0#*FeMU1G|VtC-Ag+lcaB^$${Q}2p@%sx;<=<`oRCj(?<dAz96eOO{l=Rlw%YGDrp5~yo5$I)4&)| zs^>m}aO0Bg^96}!@vvsG@ljmDuy)A@zhN;-;Ux*bVWZp`X&otl_z4)$8(A`sH;G3k zWa7YNv7$?~q$_D_jQ!DDEI&29$y1!_;ioigVvAF^#snU}ML>t4+vB%xNFy;wc0gfW z;{{zn>Y`gFerj9^lx9rDsTO{UBYEPb=gj<;5-Vf!UWTyA@wQl!zLg&c43uJxVje;V zF1%rY`;^ohsOFr6Q(I%g3nNdYJ;-zkc)|#Mio$2R#R>_0rKuhvfv=Rnw_pgq1-FK1 zmL|x-X8#>2ALk~KeM(dH!W4&m;w861*phGNn8gW+j%`qW0Lg!K0Q3W(k-L#s0UEvp z{sGZ%hhWo0pE%ft;qT_HVfeHD9RB7E!8hke__NQ6;BV%Ci@#OF@z+T3Hxs}C0W*eR z3{Q_dMe%pVOI`lA61Q5BeK^q15pqI{j8r7=@+Z-}@RebCN4(S!{R(_OES-$U*SE;U zQN759`69GWy~PU1cuYz42vQpMvr|&H3Ih*t{iP_Nb=s{+)0zpSuR?n%DIXb+DXDrv zbUXw<9S=d6jgAMjs5I;V_azw*VR%ZkuR=}q>CRjUU$_NRMZ_tv05(D3m$%?C5wMk{ z!b>3LN=fQgLD(1>3xVBui_>+UMBsv_T~amzS4pa#iNeLS6b~IL9NWkoX6%0)8UtMZ z1eOnQpOV`H`~6Y41cCd0GzNrTof(cZ&AmUu*(MHWc0&X%VYmPoix_=qBpl8(`Tq;f zito%}0-GT4`ytqf0ny_?8a@SV!hn7VXJOq>VGHyOhs{3jN3cc5^X@z2Ieut7KgG6& zQOWr)VS}6_y7tL{+R1?CaIl57L$GP0Ps7HuV>oO9_0PZ-&b$qqCNm0K09tZ@Eim@K zgiZ6CVX)bM4cPE0!JCHs!D<1pV2Nxu!7J#7eY9L*GllmAQD z?3Q7$1u6g=J|(c($sZ23K+-VS2*-evsb(7?N;@M&Q#0ach>~3znQ$@T#9KooolI3H z!Cg!^?!Tl-cJmN?#Q3EQGzp&qz8E|CL*R=Eh<^sYO~c_6{2Y8SL+}ZQ!xwlY0w3?c zh3^-`;hRk0<3->je{>{zd`}KQd zzh(kgBe0R{=_@z!tNHg$SdtW{Y-PgV+}ujrkCC;@1imKUM&RVOdq*nvMmN93Jai6l z?BMooP3{n!7-M_R0QV{2gaKj{PR4%eM{sK7x9rIR*UYmxvP6EvFT}cLkXQQz;-mrl z50NXBpAD6t4SL`6m7fh?h&S|Q$+LSOJ{x)fX*+!noDKBFyB;{}tnq?FgLXL-?5C0{ z(z!@H^6kZ+awCYkByc%$2030|mCJb6Ss$#gcaB$iU(!L9PpOsS*ID20)MluUv_mlA z^k={!N*v{yaMt;P*9~7H9mKrIlQMQ=b3Cz(>{pqW7X;tHfdJk?st3~FhpcJ)1BWB5 zF@arTt?P4X&$>mdO*RAr>CdRMp$x#@;~RB0d?KEesn%Z9v1Ww`cibaVpe1m65iNo>mU@_H5YTG&pi{D6X+YeUUQJiAVT}C!rtp0%h)7m?ZXHI}^}?YlO~nAFY*?6#Xl)`(a55j#rdq zLgl)oz{SDJok_JWimJG9ru=tatH3RQD`X&XZ5rKCMm7A|BGP8t$)!uf(yYhC5($`S zm;({^c9bNwu{#e2LU0ce-1|M$PZe!zi2CW;7Fsxo`oQ3@>sk!eqI0FyDd#GywdWkw zhL)!!LLB!X?t$P(*a3wCAp{smLw$;tr)sOH26wfndyPcFwWA>E!b-)+52iaF%WuiA z=A$AxD#|$bRCRvK8dO0lgA@tHz{KO7)W&rW)ph&|P*?M#)p61#Qr%~=S+7lT*a4cA zKWj~Db&6F!Yt6`NtuV^_S#Gev>k{-}g4fzH>sgbX@QGUx<-I6n=49aASQ_rU~S0W}ZkN|Kx?c5J8 zfz)2kYMHZN{okI+`hoqFxv$|l-*3;@=>&4ja$w?BU=nJx7yQ9E=Zu@FO{M%PV?DC5 zYuEkSBuezqiECee$g$wwCXtygYff!SG0V!DQ<}79bs7Ba8qE5#)FcVhK@bIj3qcnV zmUIwI)naj*MNM?$%k2_IlGZq_1}7ELF{bjL5)6a&J7eIqd4fNQa&0&bA_9@_<~aAR zx-M2WmYp*esz6_|^!@C#`&nAcPSdh1H~avO4AOP@=UV`6QpU!T2D+gu3gW^jFSy1*dH(;Er0pwN8sbV05R)HQMlx2Phv z(`$s>nNeYZnHCRj>I2{RvtFuB2HT}1f>J`L0sB@O2R(HzWxq8DY*!X?PEe4p%RFr; zCZ?zvr0`^MOWLRhKcro;q&W3^7Z`q`UDBhj8RC)%0HFrUBRgoOX-ghRK7>W{)YR>7rwi*hACgg@%@$WZlMQ zyz|LBUkGFCI=u178?Tn89J6CQG(+APOx&g)TrZ)iTF|gNZNWt+Ac?f~{7(T9l1w3& z$>GY~=fF+o3#UUboDRNz-1qot`y=ssTkf#D+S8$0_WtQ~=ufAE8>PP4+;G}aVw}k|WoW-_?USTSM2O;aV6~^~dgBYL zS4!@CH_d=C(KHVF)!K%|fsgwM@zMI#+4g@9>b;cSmc8NzYZ>QPYwQ=$fdnAPKPW=eAhRggLh86V|7Ar`RUL@NZjGeJ{_1HZ=*{q%1&DZ)T}iEZLs45 zT=bYq9T_4Ez1T4kA#*4j9vrkVkFwBv6*HN*nYyCWbEe}1J-uhvHYPn^Z`#8>lDGz> ztA~XU;Z^R8CA}kAd$%v8;mAe5o2NJJ#Rfurx>#i6oX=;hu~L@3Jd0(VMV+OX8N+(U zSv(VFY5$Owk*@dX^YT>|Pk!OV3eD-oc8idrl8dN(pWZS77{n*C61}W2Z{qwsol$SO z&n6px8F6sS`)6&VEqJxSr;vS<5Stb;v4g6f5Zg>LHc0GVn8%x4Q1>;8Hw?_T0ZaOJjGE{q9w;1R%KN8@U? zah+4Q=2Tv@zws60%J zE|*tJ*BV6jzegvSq0f=8aJ_ZPjmv2n1cDx~cIA7~9!X%vk*wPstso!0yI?tz6n@*`|u+}}}1*OT9HK?acI9DHfQ;CV5QkH)&rh}=(__tH= zZKzj|YuE#Ys{sX!d=z=f< zbH#ii>*a*rhEt&$^kk*)x2Npc@y2M6cYqEL}=Ov z6-Ri+#VA*XMfU8e&@z1fitpi5_KbM*wyD9=7|J-G~86j_6e4K(_?j3b>2WTU<+SMZMwwxWc1PJW4 z&>^66wvqGdyMyivP$Q6}Jw!K7TaBX-Zi^VXTCR$*#Y?ofYJyrBIrHQRwHLBvaKi)h z&E6TOLNiVUH_r2AkYTf@#H%y16kyiNPlX;vy3IG58%_n%v*9=4fm0zfk{9?!o(d$# zqvZ?g>0_gNkz$*~(C5JlNtcKrxoUi%1`7noJLi4mPGTc8G;=Xb+KsE@u&-hxghLZy z7M%U7$}UKI?>!Z|_f*g)_VKv(M#TT;q_NKy5+bu{P$$JoTj?P<;YV@e5n)0O#|eK@ zP?DlcImH%(NIHt;lJ%4NbTq!J3+C{{aB>JfO_zQO*Gjly4u8)FbJB?OFYTJlO-AGz z`nK1QSW_<9DJQvJ_VNMi*ex}>3n$5fNOf=1eR{HvU&~PLZ7V$@cd%|7Hzt!smAeNB zsV7rACsNyF;>U^NXyoWY9R7UAPTKnhk*~U)pGFRazB4Do=Ld0_qWkhBAV+sysY4}d zrJMwLP=Fh$%JqEY*>h1vIAai}Kd$NlF6%0U*#Y$+2p)=rZ*pndDApTW*N3?!;g9G0 zy*%&|&K*kS&ehcFjK=z!cSZ1a8BP!qu7LcH@)qvCtQ0YhU!z2kvz#Oyw`ZKE12Qi` z6%{4CU=l+n-y?%Kn%ke~CwQf(N(Amf;t!-S&>Bf3-(dVr{CL70YFTw|OA7G}fPVYc z5=?%wZgJ2c&I0JI@nIOWdY9cyo3-GVdYRTFGnC26mSfTC)wvB9h>d#mLvF!CJ!6F> zdtHj!dkp~KWky-r2yC}%FT!V$_R0T9CV@j&cM{tv3NJ$tT4_)f2ISDVj zD^q{Tno2PAeo zjK1{CK|>I3)^_125n019$X(?+$-*N#C%vCa#Z=Q87TWfJg@ulC$~47lnjCb!i4j!8 zG&~*S7P(;9p!fPT<4%t?@W@1x5G2tCz3(1Yhsc%G#UTPfikykNYU{y@>n%+vxXO z`L$>WN?|ON_M64}+_=EC!L8)v*}AiGanvvDr=;q*t#PG7s_9~Ovvk$|+cm#CiT@$$ zWwmjY+5zAx=%qCOjMnYyKhY#o{rv>21#)uWVV?K_Ru(OT8GWF5P|u4|dq)%mA5`CWF6)nY-jOL&Ew&{9v(d-tdW{W<9%`X`XIp$$!8jDk~!gPgF+tM z+Q3WER$h2AsakTQUPtwM;UZ?q@A!;3;vY z!vRch%30BGGUb~5DJIK!$pVvQg2|GPB+EESlF3qN|9a4GQ~GUV{I+zzO=bMU2{U7| z$&3vrV4GsXvIfiGKVh=va=&*QeR#e{^0LX62WAUcjSwr$g$KpqFCYWu)+hvR2z$Un zq){!weFne}XI~?C00{5}N*DI`x5zp1gycioL0kl6CQe_dtE=7y_!d^un2 z@7jaNE*)g&_II7aqcV4XWE`P(096TS``EnHi$dk|HP4FjDpx!0%F2$rm(Yn8e&Q^| z278ZM-q-N1@2L~vAD}gG9iLK5b|p28w3sqKs6iQrJ%27AuADhZ2jY1&OpL||ud_8w zaYtk$qPiswQ>+o$h+sAg*%M?VR_+VIY>UaF{J>_RQIoDkZ>7&ovC7Wbt?F}6TJtrIp;h1Z@gS8f58iUEk3~FGlboVQqfecb=!Rvb|g+Qbz;92NQhdn+B4iLLm z(zUr_G)t)Wt|ZM%{kVB($!1ZaI=&?tWpMp8@mejB**yP109&er=uJq(Fr|emO!t zAo!_VH$wOb@DK4vb~S89C}APx`s{dAbXu$DWPZtX$31vZu7xylJmnE3`su`t%?~;j zO>BkeW$n7u)|4jM+I1u0(^p461T3{x&6r!zIBCv@C>42SjsQ{`dt+bc3 zOdsWin4pocr>_YW?+HAjOh2sWn;&v4x);8nVJx54T20L3Q(Bi3gLp-&o0!1Eo*crU z|D|s0kk$L}x+_l;VNlA|^!G6gK`;H;19a`)!NB`)$ZxXAu{h#3N0tZpFuf%QyQ;~S zthbct{V96OctUmk{uF!9pdTwtuD29&#qKlk^tQVscVR31odBA>WosUjWK8NSOU~8( z^*F~9nYZa$j!z{#k$GF0M`R98jq*eccp|J|Fhx4w@rdLthi~7>mn7-lJZ>rm;}xzI zjEBtQjtq`y*9S>^B9Z~C`>)GQwz{UhN4sO}) z=5KMk{&XDDi5S8&`$dUai{&k%R#8LO4*K17qE`MUkwok_ClU|vk1j*&xfRVza&!P?`1!oi_F3SAlBzjJw!!|3L@H-@E z>6>))_1EN8c8PfIC&g!xSM|9g(bpN|Ro|kQ$Vx#ZWRU*gw-(DlRth4)g)SdzXex>} z!5Kfqm$|Ez%4OXwTo(Yx9}V87y{_fQ$X=lYy94glxuebbejB3iy=6E~j49I`Ir7_S zzWn3x>5wW}E8EX8SKH0F+u-KN(KwDI|3+zPQ_gH7;TpBai>5d&J|)7`Vl%MqxkdDr zV&=wFSyw+Mh@0_HOu2b=nJ}SObv&d#9$fG8sg7&PBzL|~IX-O)KA%$}NrrKwa3m(< zolNQfT6xV-aajG-?fMZ}naF(=6g8K42_&;|@K}A_ zDUl*R`abW6W6;1Ci57b9QQF#+j<)l!BYuc--nCcQrSsGMKjupfTD@giu1<`C+hiWj*M~73W^rA6`@`j z@y)Uc#zuQOQ974jSfJ;REm#vfr$AC-Djtg+En4L^rKwGc2~1qw9xI%HQrC-h6-SOi zK^HpXfxj?+=sboZJtflI3FqfaNwB!F<&|D&G6`}s5m2kJKw?rCkHy?{Q8`AXzD=3m zMyxA$9?Q*8)9Ksw(55^VYCjhAf92bG%syVCGbqjfw zUn-8iwvyM3bL*9AFKKjwHowJ$If`?Xgaka2&=76l9kc^;7zZh?nCjJIg?dB}pe0Fp znKhWVl{SU;4vgwuN?jvL;3&V2OkRJNY?qhvw)MAfQHD2PeN3!4BgcUmesFSB_$-1a zEcBXVxtV^M#P!xu@)7heWojd>_Cb4+mUKhaUueH}6`sxaq+@Rfbl9&!8F%r}etP~A zL^RoVgova#CDA9=tzP>=U-{B@5O4-E6njj6`mvs#{wLb|i7#Hwt*g12;AGNGgx7#% zB=9|StC_9BFw=jRTG`V-tT(#f0^@q0vQP~XjA_>`$;ioqqJo--_;LF2g1qb+*saZy ziH*NKW~v~UO#q2NEaZM;c6k}1d8)a7wc^2J24h|ZAzy|1^Ti-vCT6Ve;bVDl{a`Fq z6XZ`+^V1^;zJG4WbgZ!ZLm?D)!vzdZGw6fng{zUn4A~C|C(P0R?WTlYRG)tAuPO_pj$KWZ@ zZ

dpunNWoGwZ8n@4%fqp=@xEt2Y^-`bcSbaSN-sbc>&@zD5BT7%N`^@l6By8GSyko?s zInl9rb~NGEQDO*vGa6Ryt?$Td+NGi5*T`$`xiiti-;meBmT3|(wqfv1ka$VN7$Up_ z7D-y=m)AS^AgSK-Z%E(zjH_9(^V;hMxFlY9n9J9SwFb) zy%7gRZ#5l-VEP|?2sJPee(w#cKEw0ojkPJq6zfQJ;qjbMN+NmdB@}eMM94v8=97Jz z20AI%U(jjX@i#0VYWUK1Q%c~*pzDt$!(UCIDwpf1+DwF5lv3Mh1Y(=1G+f6(P zz3TC!jUM;rpn-Tv0h^{#d6XcisN0jPXPtQ zRV$qR2+s~mVkA?yV&fJj!f9$-Prh_c{`sX+UEa~cr}Z&uTaG&NGmu_h({|nWoFYmDrJV~%qBU{*d|I*w|b z)YgcNXu9+dDd^JNSfB;6Z@8i+R3w#~Slvx|>l@*HYh6BO2W~vj$oArMdYpik##oAB zM!;js(p>3BAzot3#;_-OHnY-J96Obd{>q^QUo9;voe$L;+P_cf8cXKRv@%S?5~b$+ zpucSF_G$6zvNY@;{3sRFiH_dB5Q4@{;D5l^kr3q3Z0=9=8S}@shgVhAA33br*I%70 zHoe(iG!5$c%UEyw$|S=>!dfBjd!ol#jqmElH92HU?@w39&4i$@GI=0f{UMR`+5dL6 z^84?Rr|c&aMK#bn`m*XKez^IcUW{)dzEfMS>fdb7D@+6;NE>qXWCo-tf|`Cm1Y5W& z5)-$TVBXhVg-3Nzh{;TP1~w>E2D^XQeMr6|zV^jDcpoKOA*1=z)vV3nCE<>Qa)o<= zBzVyH4ia#NyReRm;|<(8ABCwF7HoZF;{ru>DZWG!qSQ$3MTO!%yrWt|A63>=@~3oRL>6o+xbvm|$bXAywe zwj#E*_k6YV4^QAzx6t`~yF?&SI4f6U2s=O#AYiCW9v5X7E2Wmb%3WS?06yE1Ih)}K zbgp<_eec3`bm>OwBeCScV2CJL&A)1s#%Eopg?>u8q)mxM5AZ8d{}P|_8OIWMmEU(O z;^xZRRI@cUZf#@jYG=K2VM-h;mCUO=vM_}%T@5znmLydo+$wZ#S{?WF6N?b$K?M5| zQf~wGz|8Wt{ti2Fvl2K9DA4#8Fc6I9H)uNsWol+iAPWm<{TakIBaN;Ju?%pFCx5@6L zjzwyP?#OI@)d?VoAr_&Gefm`t=$R?aok`ea1&YA0jhuw7PkLY*_yq$A{d8fZa1J#u zm2|px907Hn>Igus%^3!2%#o^vP9X0IhZDfE9k(Elk1%jGaZizHR#Wwea;;+78xx^= z&}s}nN#7o@c{h6JRBjSfh>vW1M|LOmDpKbOjw}-79R<9J5qQl%g7?eb2)tI;>|%*M3cF@JfjvVayo>Tn#jX)#A-u79^E+*A{c%M9p<$^diJA32EnGWz2T8|K zBO&hj;3V~X2MB4-a5yw+cS;-_DuL5dF$FQvove=DyouaFEZ<2m2x(*B(v>@Bhrjn0 zPJl44I1RL69+*CEhq`X2g@QpMR6+DFAY3&_&IcK7U?Nq)-a39(|Ao#w`z4e=2ojvFv7p@QAj^~eh@U2ICed~J*H@iZS9FCUZdkMc3 zX8_8xdw}&~%jV&#B-UwhW zXWwLe(yJsD@OieYvtY{R}_PR2KP!>*jliX;!;vAGQW??WhHkH*+>Mw z8oK@!@L|+zG;U=owYN|X zad)HT0$YV#Ic^?ovAJa=^x|_yNGQ3zEs%O0hZD3At#!&(ymEUlcj1Hfp-VOHi?xW@ za1XUAtH%>-z_x)XMh)u~wm3K)w7~js^yLpsj%r9u4D`8TgY4XNgZkW3gTAFkLhcYG z@>1~6e8Rl*JJ4y&MEuBGmLjHc0}C(mt0i(Sor@*NuiPeF+w`cTy4X$Y#65=f1x;$V zOeg9wY%6FQ?N;jqJ%-%{O{oUGir=F>k}Xfd5f}B-q<)&Khx0`*yA(vP47BRI!&-l~ zJcB^VdEOrSD~rC9zr)gir+L(4wCbzFYTA$mMT##D@1Xr^v1=5W>(6om+!%ub42v?; z=&;2?8^~FbQHy?=__26Wo$Y~hV|p%Knt~x=`FUkcGhqh|c0=>kpkf`vX2dHDj8>7u z>pgk+pb&1ci7PUAERKv>%fR|+#kD4NcBjqWPT~&+YHDB}BD=j;Tv9csB{Kl2Ju%%A5$(b#c zAM!OHU#TT@q`a+)T#LSXMFH2e{+`hKo}h1{?{7U}W!zjo?o!c+!;t_kjZ9S^L58rD?`IhZ!EZo0b(&u9gwG$0<_Y7<{Efwu&JER1ha5aB@JgR9Sq zYxz_|?E_C?rbuE?aEX_yjNxFpo4^uojKHGUz_9qTx`d^Fp}5HZn)xVZmz)XGdAOEa zMf)p6ez|~^jq!BSYd0tKF6ar_fPh85-}QtO<2)HWXPwi-llpmyelz7U^A!C&uC~-8 zbZ#G=bA`@Z!~=sIvsIw6lJzGPQnzz#xIfvWb%PG77(b8MSdonrd`U6Rk=kY3Z$g3&nOO)z_)Hw$htaNj)A5 zNjUft^l~1%@DBS!r_=>x7QnA{-ta)2eiQ zQcS;_b}>C{3OsB*toe4(xmoJX>knKX^sZOpt}3n&oB$hm6*qzYKnpGgK&9{xW?0*E z$GWZ_)~8T~oBdq_ek-N>_hD8}>ApFPN>N;R;kMiccvf8kk)X2s{yfrVQGI#XqlW&X zTnQ!4iwv8l#i1UZ_$fRsj~UMP=yYw)f8ISqxJkdtsDPwIG98kKRj&8-K^yZzG98Al7Pz3(gIb2A6Vx=KBuY6QqZ0M>DeCF>9pndhC;8>$HRA^S)5njxiyR$4 z-~;vWs2WG8;B{iT!nc1;(xSTwMuWS%zjJOioBXiOX5yVCQZI;Lh!?YX8a^t&geq#9z1)s6t zyZa6YGpV+{u)ttEV#XpCIA=;5pI2JMLTaYeIaA3Zk{x26nw3SrX@5OAzOAIasI5O} zVOnLH>MO)SKgI}a)ZBNyB%$}N!=bwl2iG6>k7>ui4I+#X)#q z!Q08V;haEs`u!6+MfDgw7&on_{mY*{9m8Ga5rxasHZ z-}rVy?>mP=!9&3fOMJmYVV~F}D{a|h%3yvpzgJ@pi;!d5Gib7u`ZIX0?W6+K<=xQk zx0uPg8FNc7GqaCUurRi7}T9hePuM&+AQUD1>1Ku+N~I6P-raArQTy z{Pxe_%)4U{ZFJAa4rUow%HyVoWgIt2N_2}4>NEHXx!CvULHmRo!Ynd=z%z~kukvfv z5fo_%iZtC&*O(f?(~4nudgM^38lBndt3G6Z>1Xkzas3CL9{nkvG!lX*#cH4^>s)>m zPcsjNEU5ZjU&Wz79q^=4tQQ&|ARP;04aYHT90VxRMuU=#Bg;PzqT)D$Ehn(`EN`xu zRcjDL%5CL{OWIFN5E%C#G&6Z14MqKWncg`)qkOswIe2w0$Uv}2XMTp>qCZhd6%|z> z#UjghPRS@TsftQTnK>o+f%*$Hrg7V5nLx(CHd2?&Ey)b3BZVf4V$0}S1#MBwjS1Ws z+S}u5*EA)NVQo*($5O_<_hg}Q#G%%t?lZj!heEN3f`Me8=#c$su~Bkp;f93XxI-a6 z5*0rFAVCZw?iP)N4!EP*bo%mt+=Elkd+odm&UR(7XE4Us4hEALe#Ix~EM1J_ojSWiMfn91J@(`XKBfR4kLs5F6i?w|9!7`jPUUW9-lGStrFwy6 z2|jyTnpZ%!@fm)sB`noe3_Va4==`k9o0 zfmG6OEYtn!pbebqg9i=#LWdO&PZ?G~mV6$TyntKs9l1s79pb-a`bh&lEra^i*#-i#yB0k@_Utev)Vs{l9HBc z%x|wS01(D7WjNl#6K?ldv7V~9=b%2BiOWZ^itz`7$&6pa3xvNxnnm;D4(fh72P@J@ zFDphKv}vfS`A)7|OVBM2aZAuG?!kg?&E(}xR2C=_deaYvMqpswz7YpClf))lwl4Od z37r!X#7xlJzkMgWM!%8a5bX55mg` zqZ{m=D%aiW{>k*n!t|g^jg*mh(85q~8#+;`hw{W^s^Y6|lO0}98Go$A5<4`08C>_C zA+l;Ak@i@;RM8YCs26^ryJUkdu$-|L4(}|@9N@22SaY_j^-P|EJr86xvj7Pd#nT9#xGv8pRql|~U z-$PfY%FV?;+A&iwt4CIJcH0EhIHssnX_^AQ&QSv57c;fbltBT-*u2C3n`9By&`rgr zSjG}dIL4yqm8MuB1%`D79%7s&JlL_KyR%-VJGR4M3`)o&RvOkN_7z_}=GeOw0E0Z+7SG(p23A@hPgoGNuaA#$ z=JTBS%Di8+gJi9_AV4kY`Jc%veUEo*UcL!y|FqH7Q`ACc36|H>Qf0Ps36>Z45LsTz zEaj49=9wk)=5$vJ;gj<9k@3o`b|u*BnM`Z4Cisos9=*#7+y_t$2tZw#pVapE_RrGk zj$e_3gB}Nm2tm3@#Vn?UR?7FQZhOPcO^jkrGPi_mSV9gdjC*WYLfpgcB?SB|o?mfa zH#Tuc`|FB$Y@~T;dj`{*WZ(Ra?%r-fDDu0pmL}RbayqB7oa3BIe*tRrll9S$_9q!I zrI!qm$tRX75k@_Hg|c~nQ5D%Bau1LV!u4QY!O#XVL;|f~yveF4ym#J6f($HBP#PvE zXIkX}-#2FFKeqtQ*A(IJ$QDpYPW8svZn6W!bmJV95BjeL{a0tpAMQ=;4hg%1ug~xa zx&zl^am57Z>O>Iv5WjN6864l}@GWwT(cL&;z`;OXUfjOs7}*S`O(Aq*H}7>h__y1; zZuG3}x^w{I)a>e|u)53{0c#-FR|jBFnwA0ilo;1~cnPZIZLRHV=J5P7?dCVUZrF5= zfF>ANiikEr#BILf;zN~RP`&>;5c=1Fp#Oc}xdZk~v8z5m;Kyy48&^>5R0=BfD-ea0 zn2xKx?Ht&yO++5dV(N&II*|oH`~_2#i!m-c0AOu!z|NXFKWiO;g!e5H$fLC;-Ec z)g66^@{)m5RQhJuR<75yFqY?$l|d`SQnu>#15L5%oBTvWGa085*WV7bidb=iUpyjG z6>BMBEmPu}J+`qDb6p?ewC+ms%f^Q%-hw;^=S0?W-{o~u)abn{)LZS&# z?vQ;3MnFu=E37Nm(ZX{CzdyzyrCN4CO;crkbjNW@_4@-qC&O9w_<>+5wdxUcHY&)O z*A@D07X&%g2mER(oCZCo(U)B|GEK@Z(xtzo@a)%8tU4W@57^GZHRd>0JqFLO1KrTI z_cC>T?jzl&dY?EDdh|eWeY$VN7Ii`v%Id4bV+sB&*LMP!$dCa%x~5k6M=yH=Ei_)3|Fptg)5dra`o># zScZ7k!fIjqut5d(EH_>6bPkHBhB8fdrNvfkoxQ-#jf$It> z3dGhzG(4_2O;#>i-Y;UKs}8Uxwhj5`_<{IiC->_C^7M%_{+DZv-IRl7S8w zZ@QM=Zs&>rqn$quYsVgKC;U~k9WrL;2V8G(4OQDPja6@SLDrbvG{^N`7vytlZ=y0s zsWx-v3GRmfC$enVwveRT55x2SuV+rygiE3Nt~$P6CKzQXfL>fKt^4zSJ>QTuU#?rR zKbS%JGsLbp_hYYVNGr{tbx)H_$9$>o$^9n2R_`4wcsaFnG!ZW9p4jhRPofDKxaiTi zRUAow`sn`N-|ycgVIV)L6*zf1u=CQjQXGK3O(5s^tSru zb_E(@-E?INuXjmT=n154@>#oxoe`Y1JlJKjQUz}>F5*s@7;8Q`V=n3nIZ&?6_b@3J zaK{==T`a`A#a*T(%30D5CwgU@=-N+tAWEKGo^cZ3auW5S{>T|NJaD<;Oz*6&&`i{_ z(|3QD{kd3^jKSewZ()F9#dNy2qAT zy3J^ope*BcFJp@ZUgwi+vC!+rZ;UR!YZLdeh{f$2$C|Nx@zBR{QF+JX_*le!9Ls$y z=01+o4epP8oWSx&L}1cXqi6yL(+C37ox^XyL3z*5&|Ti&R}8j*IiHsVO`epz7i*>& zjFo-^!mX7TVxn;sQLt2)jZ&pzE~ni~R&$zmIh^Nqgz8(9Qip?-}1eNuuWQ zSYpaHus`%I63_ZR-XDH6c9&e~I<_B{0G>FCjf+aSSB|1Prct}(V?A*+8%Gcb>>#mr z3NW3ys=d<_o4K}WE^bZP41w{3PE)3!tVwO1Z`|2wUQqVRXzNnryPf7`Wv`@KYmD!7 znx896Mod?7r6wA>QX|)CxKm3Zhrj8@EuBp>8k>k?j+Dmdh}sZ2j))Y?#n3}{ZRli0 zhLtb>&auGc<{N#T<_)AVx$&=^=C{jU8Dq^bwse~JkjCY7JDmO37wMLENI4!8c{Z5o6?c_J_6tOBZ~v><`R| zZFp_!hyM9-M&o|{0%D=DI=T0M_J;x}@Rjey{Q+z2N5t~D`18vAEM38VI81qvRLEu| zWHlx9ZrC4s6(z6v*!|&|u|Xhw`F?E59x=s=hY+5QNGg;^K9&{JCNV!Egf9a{pM-nf zOxFTnAamu*zX1j;KzLQBc}CeQ1mC~CjqhLI#`o+fzDe()2#+gF23MH)CHPJPzRlAs z$~)aNBN#|_PT?>>3MgKVA^0{&@cnDY0;830oI>!8#^grRZG0Eq#`omg_$G~&LJ@&$ z4frOFm7+0z#e`0G;75(&+(>Z!Hm*V7*bJnp{W4A(+bWM@7Yx`$f%G6CByt{B;A4a~w_ zep*Fxr}dp#xXaJ2kab%3&T2|^7gi*8T9404`M>6*xFV*rDM02VLL)UkUo$i(D^r9Y znVeMFdxjT2O3 z>4ZyZ;;z&)gULx+b)mB<*0X>yUh8BRP~^9SDtKJX((yR);-1U|Gjwgs5g`1&n}iF6 z#V=iJg`01!f~8caI&s}ssZUk~I^pGq-0@5rL@D)~*H8>xh3eBzu%-pJG3t!*4VD!T zwC+AnLqWy&Y-b?$Ce-%-z7P9eM+qoKY0D*bMovQziUy<%QBpy73F8~7toA-ib&yn6 zX3K(seOaG`RB2mrADnST>a6axGo;QYN0H5by*`JM~~8hHn5uTn;c1 zvEI%3x<@(<{60Qy!fsX~y#l>4Y?n&bXlv8W~R_gt)Hq>TO%;hUrb5su5+}w9k_XqYpS2UYVK=4K4)hx=H@n zAK(!WT|y382*G3|99a@ERJZ?YuwlKM-%#BxXT20_n;69{6i8^-*iH-zG-PPkXzq!q zgnb984Dbn!3+QdYr)&4g-jSW5k)1*BE?;72_}?ND|Ex}3r>`?Tz&04jVH|X>&Q`ai zj;-^syHX-)TBHT*cGVrJ>tlC~i=^ETWtRjB1_t$Cp8u~_`%VKTWut+d% zkWBKJ0<7&G)|SWGbgWHpvuRdc+Gm4h|Lgv#l+CoG+GVq;Sc?Ob76#Px`4~bz&dr(k ze#dg*AL$&S4YS1&3lucL#TCcp0}rlq`#2R4GRHjhJ2793WWCUbQG#9rg6wKh&`Uf% zM2u3RWfqNyh&D`^ia>MVQQ|QKc?weu3!hQTiPgjde$8Vyx%mloJIsf$3nlGuURNBU zkQ!4RP5qwuAA%{q>)8$r71v?cyZgwYFGeCJpIsYtz0g746>eHp*HMS%&?LecP)l=Q zb7w#@g_8RK!2u#4gwB=f*Zb7-;1C=){y7z@ z*Y>$y+gHc?X5BtX!jVu4VsQjRi6{-jK#V~mYm-7Q8`GnFGwfoTP*z5zVj zFL5GAv@elB_9e*;Our20XX`{RJD~}z%u&B?Wey{GVeK0dOz0^%Kye>{%Xa!L4opO( zK6e?;H5!)UshIPF!MS6hoVW_epem~e!`HuM)w-5e2o|u8m+lKK-4|S+=3B5Yyhk)u zq_+{1W0OsX2m7^ecX>IF9*^z|XW!t+2hMJh76BugBV^)Q)IkP^w@6y}>hLs|zQf(= z2XWMqfjK9x>=O1`_l2zcg1&h^>puI3WSxjf_;}sSeQ=7R=e^(oY zHb%;Bz#k$-dMl5V2waKaKoaY^YhN?*V!-ts**W|C>o0~c58_cv9yQ!!7J0P)o1|v$ z^ZWV(|00iSRJB0EJ*v0@Uz60a$mv^cK9&xg{c+(Mdwq}e|kN_&ZXJJ>vDK z-Q_MUXv*rYGl*5EIwsK_h*%=diPegs8=B^pvES@Sd=UNM0Pm$Ub{XcN- zH#)u^q*OaQ4766By;JB_x97--T!Q=(T~Mso3QCEc|0Ny#VL4wCtVE0enqrN-xO@^{ zzLdz{JTj`$?bPocQ17BY%eefyTmbGxZKTvvs-AT!ufcu&?Z4_4v6Gb|MYr#%JawWH zrixl+#8iaP9ElJn5mZnnfVVu&jluHGPOtNt7dORLCo2=gRHsT(s;b+eW$k>PRN~wI zly_!gxz$*1Rch%<%T0xX=d?>W|XvIOh-|M}$+1)DiHukS`ljo*J=e0)i;_Tu2^ifeeBnZnuvm!3c z0smGS2}qX2zZj3R4n>{+T6+E!Cq#XXm-{cfosEsx)-`?knLELGzW>W+r}J8UUHV5o zJv)1nKDv+!|SXN`k8|8jX?}DRx4K$?c??WMd6qZ zks%@-YK*K)W-?QXQ1(N(#l+2v;1)s$26<6|x<4qE`O5ef4O=c(0Kbu;0anD+~I=Q<;m-P$1g>sDt3F&~L zNlNOfoDNSawRT-Rabw%BT4j4TxEFjed>x1eRO$}!{}Jg}WFJcOc<+W1Hgxe;?cEcM zHM|RPF$4mg-yiYvz!uGoZJ%3H-oDIFXZpLo_rAtCZ5@@+E9(f!I)dJfK3Ru-p=b-E zU`Lo~#j+8qxA$oM4w@F;PZ{PbGxG{qy0nnn!9TD#;D?oHa!-dQ_xz|P_v(lalbl?Q z57S}dll4VZxrO7Xh9$RExud#Gupx=nHSZxhG#4o2+C3gdYeM|@W*WLP-B)$1_n0}U z+k`}u_k5ZBPwzIZfc(Nt>t5Ugt?!pJ%ncoQRD)6=&oQ9d$5!;u@=%&RHET3k+#f)qp)|Zs@cJcr}yTN3$?klHdwjjN;f@TSSe#F()U;=Dqi8e zm9_^*L6?Ex3jE`WYu=f8<+GSljFw=YY)|#Q=bp04=Z)A?{d$$17ss zQ&NI&-teoa@Z0}}fO6j6(7e4t-($Yt?zI<+6iY@};QJ&@cjQx-zO5MCZ4tmjvAp8e zZks@B@ea;X(52(4Qli^iabtIN08a19D-&%nT7xb_HdS$Twh3eS?bc8Ji~Q|5Nrh;7wK8-uTJM$w$*r znzRjVK}}LpTEMw&ijX4AwCPt`L?L1+b)12g)Pmy-RuuFy?`;CMDa5%DbV#v|Ie|zh zUu~cz1&U3<3R)bC&Wz45cNC4|ARt9#6v4i~b&>+k^}hH2=Xq$(*=K+6wbxpE?e(Gg zEmyA_d^J>vj`??gq0}tXDV6o2poUXcL_%LYuGqakB#NB>g1F^#&fLbRs8;F^eBm%8 zf2JCG|JW(%ye_TJkb)_x>Z-iw8|lGSHCdoliS3|`u4FC@IU3#r+g?T z@`nIXuL2mE%1Kh)v171MsH;iUg^wYSuYR9sGQgb-`ZsH}E1RS^ryn|I@=>6qyhQyz z?d@N88+H4S1=aEmhatK}OhfM%Sw<+c&Oy^PSFw=Fd-1gW5?XtOT7%0ckxh64el3Xl ztF|6j!k5eQad7aHvuJbUL*&J#sez0PPQza{)Q(m#^M{W+B`?cMamJdI76Xec|;--)4 zv+z;g(DD4j73eUK$t5f^(dgQbHy;#~GiD9>se2{r!9r z2JK9=AbBArUti}Dt_dbg4tSG(62CCNc^>|fJc4aaTr2A`c?5HsxK_2x;>l`$7`LCfaThAISf z$Q$dmTHD%!s?CcZ(l!GmmJ@i?cz;AjC^9laX?m2o-6X}v^sCbbkKl06+CC7hYTHwT zUODVhp8BHgO{G$~0rn^k>@UsoaaL&Sbip2_>kFxHhJRda)kv;BmoQX)JY0P|=)1x{ zblmW@tV-ikr`g9G!$$L!2-grLqClZNE}9_RK9nGOoTEhQD3Jm2&ZsYHJ1*F2jB~?P z@IKM{R>&LEVJ%1UMk%Hdap2%zw6QhOu}^#ZN0-Mf9iz11r0Xah&% z2$nZ*C4kt;5gKzQTK8#h|Kch+&EAJqh8c;5V}E-Hgu4V|6RAx>1|pYyD$(C&XdJ4t~G`SY@*Fds#tdMo}|A&&sH=SgOR$ zC2sLNeq_5allQpJ!kp&>%z2zJ=dn1AXXH?Em(A^eIHHPs&fT5 z$U&$}51XE zL1a{z2%|j_b;b`LkJOpA7laCu|2y+3h+>mCk>Z4c4hJzU#l2Rw4X{!b9^SuP3lO9yv_p(}$h>`i zZ`m2aQLLMt=_2t7p z|Bf~&X<+}i3j6DoTKS>JO{UM z>1H-ZSwz~i=A7K}VA zfiPkEiix+*LAxQG++A-^$MQ;L`^N3qXPU^NKVlZFF{DFne z`rf(@(kXAWXubDscE9xv#pmVZnNuX0_p%VtYs7I5b=iy%d2cs*8*$!&YH@6@L-*XF z&UgD?g1*ou>9LKT;8xGZt-3};@o4F5-X>df0>{u9A=Q5`s@X;=>y>N8dg%7oh==~! zAO5;O$Un^gv)}eR8GU+?!6(gS(a@Ft@Gw68jK9?HZ^i1GH;$*$3ZRD{NPkf zl4gO(Du%d<9Vr*Z1@rXhY_~1a`JCPpenife$I>T-mLCZ&jIQW=YA z(xjBqEu@BSA*FQZEiIJ+N8Jo_B7`$(!gny9(O|iZW`H9LTC`i2pt(l`<1<7vOT07y zzSZ^O96xfB`8fU2EKjIWB-Ruq;%{A@x?ZtNT%W!ysebaZjQW|&@&*vt1W7d+ZsQameC!t^eWge6^_#Jy)X_c{Fgej?L}X zz?7`dT`BRXYtp#Jras3a4uLhyEt+~Wc&E}tN2#jb98iO+5%;HaL9aCO$#=feL;}lF zRof@HF|S*i7EqrSPd+QohAW<5^&d;_725)r0ncEne0ovz6MTnW_DZ84chm7H%5sbn zbl}C0nEWs(Nx2=|kabBS0A;@1s4g+Xjw!dWAg|WABo5JZ%uC?7Uu4!L0?Wf>%eZ7r zjZQiEDt|T{IRNA`jNK8`$sr~(>=nq&%-KM4#wGA1ZZI!NK-iW_Sdlb=CYU~|7guJE zRVAyuQ3_WkFt+MAlRJ&*xDz$i>H%LXQJ}SjgS_(&U z!$y@Hu0~|f%W_&a&z1*3o(?DWij@`qc1S8znu_eI zk7`mRR+YTEvi>7$rR0>@6s{Vs-XBP}|63n0R|UE7@aa_cV%k?`ow|KHFpzJFy6U4Q z8DkozSlcS8gq}F_5*3JU)ki>~!?P(J5BwgN$Pi*St{I9^NissxM4e64yg9$?`!{J|{ zifMdp*p@H*wfGbl2+uqeNU^ij=RFd88uhmQRqx^}w`kZyVbHLRp2nL*?9nW_W8ZZE z`lBI5edivDzvJS-V(`*>-B~a5&by7L5_*L@(U%~f(O`_%U@9j zix@-}S{Z-^g5;De6s~BupMH%dIY~kvCAf&LEV^OVC6M~FZtToymXBZ>V@#GH1D#Oj|Sfxni39YAZvgh7q(@}f;yGy zBUt7|KDdZH=!)|rn1lh(R&l0}28(bV2tY(lH84fg>uPlJ<$1;$ompMBxEQ7dWk#La zXtlIG2|9iz17v*g^iXm*9FO`>@gsdUtqcxx^#)FJ7JW(_x0Eft6DF8SGfNh&*q1)9 z+`fZ`8MA{i3wAJOc;d(ItnZ{*tnV~O*%9z+R-IL+a@_+=_}h!F>3gJ+wr{X!cMHaY z`&nWzeC*JbzVPRLLEl;aZ+*5@*(l3KHPZhWKO_9ap21T9Kjai7pW%i+?F)a3!Z-ML z`Uo78WmbXl@%dl!2E6t+5UPyAmu(fomx1x|%hn7)%D%8WN%nE#?fn$09``W^Ob;Bb zaZOj2U@%tPC9BIc^0B}kko`bI;UvS&q{O&$~yzGJ$ z(3o>f>pi3ekNxDx4-~Dcm^UxEO)_+_FMI$6@8N$(@&y_Tzf?F)#)Z@IIsTZg;X79-x;_hlpF4rL#3+v9qW~ z&Y59VTdZ0PgB@7a7OP;e6Sb-ZKNR`%4YPiHL3_=!t7jkUvb%U zMWDH^16ADhh!xmPeRo;cy}&R>w!769vpOG68XDJm3qO0Uz!I#m6jbXPAIL2z=_||5 zfZ`lkE}OD5|!NGb~I!5ddr?;OB-RvlsR#t08v&LFA9e3 z6BPEQqlAR~#8BS^DB}MlX5ih43=Dg*I>h`{5wD=R2K7(jj3jIa!Z8-I0H(SXv@*vL zSlMjVxidIePMBdi5i^Gxon6>PwTm#jhSw>WC1Ks~0luLRfS>GIu1t@OK~d4}^*5UJ zcY0y^IT1!nccP3n<9mj5kt0+HPWG){5g{GejcJm{K&?fLxgK1KKunK|n{t`|wNH`5 z)TdA>SVS{e#A4OPby_o6M8O3?)P9)w^Kvs}S51IAFo$RCRb_?g>cQ7ZzMm`{eyMyxaSJ`|LG~q#WLKiQmqbJ}$<_pjEi{ z8^ExpNbD*4U*>n;E$H=bZ`?71Ev zshlteC#G2!e+_OUu_hf#=8u{Zh8}n=Y^);%)`D00VU; ziQ(0YaMt4EE=c~$^^YS}cA0I;EkxDUWkkVRxFS;i3R)`OkyDahj;ysV4wpi<1i>Mg zad1GfFF4qKd2x>{a_2<>=ePk`h&mRd9uB>s1y(ACL5qXp#+5ttnT{F*X?0~f*yR-7 zY`ME;9I$Q|sR59D!wM|$mCPgoaGJd@RG0xru-Y|Fgo_t0D44Jt0fJE@JAh!GitxW+ z!Va@y!zRS3Jy8NT7yl19iu~q=cN@WxiOZKP;!F~p42T~>f1uH}9A}4`anW-!daDU= z4)|O6tQdW~3L}}BZgp{Uk7DDdLbvta0YWE@_CgpX`PBE4y^Ke-AUp67>0e8fhde5QFxjM_JeuY5w&W;{Ag5uq4#qn*LFO>-O`kJB<)<6lJue+4vv1Mr$WwUJJSc&qHnty5I3J@e^6d>@nQ%5OQ|*=tOE4aDm49m*k;#9Q<`E|w zVIKeGTR+Vs;FTtki(I(yJ@%4d+y1koPWdDcj5u;1KH4J2v1st!q3WaI>Z3uvkgq=K z|D_ZjXn-2*?;XK_h5a;XbHdPqqu~Wd>AHUYQQI%1Z4X++Wr#;M|7iFDr0(SB93_Ts zxwIbMARHWL<;dt3S8tVm3CxiloCp{dY9I~{Za?Y4%t1MoY;eof6Ykp(3~1~}s5xjk zN^O6?2zmPuO?P46ksaF;hD=Ap_n?&!Z#?Q>Duu$y9;xBO3#CL&Eb68thN+n-@<|zo zlv*KgG5`R<453CUZmbhQhJb0a_fn1C=NdP)A8Fp1FqCmLtVN|K_&bi;elBgNyVgCN z|IZiZN-ICPCdlwFjOfN6)vK9>!Gxi-qu~_few$Yvwf$5&Pv4iDd{qA+b2mjM7I21A zQYbt68Kg74+~cr>m)^yE{j<}o(v34ktLmMTTDb2)pZd@_IPno&-88>4?dxBjW)Y|q zinGxy>d`Doqghn_cS;ez(ZLc)5)3QS#}~WW9SL{26?ZlF#5F;;TDm7;09X}2&V)hv z1?l4n7vz=S{ZmuHAgWFKLrTpIgGecbS`M@wKb^=ryiBu{ZF+Yk+Ihlv86uyAHA_fe z*b4wFM5J-1v2mK#qJl0y;vp1(n=ZKGlSl>I+^7QpkoDtmD1A0V1m^sH#(KZVdOvHu zU+lY|^HvpF@0YX}7hJk>`F`moOQHFGnMaKv!ea)eGS0MqITr+LcUaYTSbOl$Lihd5 zMo8xF7j1-O?tXS7gm(9fkL(GKky>HF{E({SA??CL?7*)XI9hR_oB%)n>|#rwVT^Mb z@?HWKSt_C)zP%^ zxGXs>NBAKTdi2g)T9^+o_|k(1abv5fqgDG?d1cF$$`7QPF%rjUrvTcH1kRm6j*Ng; z=~U$I4ZC}T{7byE*DzB`U4tkRU4tkRU4x^Hxng4i=Rgs`6T*xa(@Wt)PmS}>bG_lU zD7l?~w%0#hip~SFIU{?g>|?g649Z}tDzzq}I+0==r6~}CS0<^935+9wK%TrPBoN38 z4`RR$9!kgJUN*^?Aay6uP;*-0ZiS1|Es(1jt&@DCMm%IR9?yb|kH-4uYTG$(2fRq7#PA^b^f3g(avZ7lL zso;XZif+Xo#8JNp(6TsgTjWjAcMzerz3TM_oV zPT3n^l@z_ep}5Nxh<7?F?z$TqfFP8{$wVq`yGKCSDzC-vIgEOdS&W;eX&)A=CX_6M z0m?e)@Jr2N_#&W9XHy6p>RFXf9MjxKVnmLZ^-RIMY1$GTfBHULpn^^u@Dyurp$U0h zQF!@?IhkoMRtCxfX%rO6b`YK%#}{6p3y2XT&$U&EwP?C^k6eYE(e92O`IA#(@h0-|-S2^)o77l}yXmzf&`n!k zSF;Ef3(|!jkFDYER3^bQfU)?_>V?(?2{@>7VA3?z3Hsy&eSflkK|)q?z1k>c^uYXj zRgP6_1m@3E&C9?8!Lc?^JHdR4-EaT|Wg@lVOHQ!o3J;|*9vH~0RBA1iSxXhx(s(o> zwLJ&M7tAgM#PM0lFzRT?5C!+0$J{=BLAXxsxZsd6RvCeKqfKj+QIm@w!~-=sFHc)} z?0W9HBO&p@7X*R4DSk$>qE}q`FlhsV7XdA@HB%sAd#V7{jw41u^)`ZP!MB91fdG3W zZ~%#$82ISUo}ZsvZZ{@XW~rga?L(MDRu)y=ihO$ATX4KwrCWVOD;#NeK2bGapTg<; z&qH0Z=GggVy17#0u`d@FZ7V3cQeHTr2(jaS%*GE-$P=$EzVjf(dPRS=R_(ldwEd7vNTA@b@&dRcg%XmWhIDR~N4#3mCL4PANciC+ z!EFp*afA@SIm!E?Q<6}6V7|Zmf=SfA4Xn~m(S$jBI9tsH+(B`+r5GRabrZ@UQd|;9 zw)Y;w(wLGLzpAyLq(@(opl(nkd)AM__T$ksVZn;TkmeRCYKr1}>5$@Ie#2KJtW{Bb zeXcQ6f5HxyRSJzHa6gY+0G-A(SX5Po)#L~*UsY)&)0SI&CG_akiYcD^Dz+R-7@B+} zJmpBx{~15|h~d8^0WEImUzs!vYUj`RNwlwW-2Y<5R|_!zqu!2NOdHvLcx!Cl68ru>44H$DeqHX50oZWT%lrH{hlw8>lEk{O z<{JzFT0uAacknyLW7`AaE%+2UHS9`mlM&k&56y+7l*@_4hQ|0_)iY|2XD>G zQ^LFi%x=sJ4jBr2&tr{i6B`?!LbQkSOSh#T5YnA1h4deq$3Y+e{^7_(h~wz`V{kM7 z$HNAC!v%L$9>j+49uB{IIJo0U{y2@wc3e_bgw%Hqhu=o(O8zLN8jeX|lE6=c^s?f@ z&OA+fx;0(m;PV#ZXgqK@d<;3)@COe2`y`pu##zORNlI}BgnM-Nv?7KyDH zVuwNGsO8{G+rl`DtQJvKk%QgqC}FFLNEJt1RTL2WJFfdmI5OHTfgI4(67MVmda)?2mN8aKg4HtCar|p#`s0$u0$XmK>_xqiTBQeR%*4me7xJRGh(9DG&Gn+5RRCdqlTwr}3bQxYYN)*}NWP*GzL zgdxZY9vDuJtGClXS6t6UF|S7lzXhU69;2JAC3$Xj*RC;egoSzJb~=j~F=x zDVGW%T#FS}PI1*X*66*)q!b{scMjaep{e=thmHJ~Gw-pV?rB^bYq*GMo)0sXV} z)X_kmA?Lyc4xN1EP$;kP(xCund-VoN{Cxyg@Mh>*r%D_rM2;ebTdYvNuw`0OM+?q3 zeH%UAcUn}91y`gb3n={Lkc0nn{kly%dgxy4#h7M?K+_#pZ z!n@WsuG0=$GOO9T3Jsv*@`zra=?t2-k%@%8@Kuwj#r?fC91ma<$c}Ori8~_Q!dPqK zXslQdKDu_cmq(QM&6)!8#G8HqM>Ymo!fY!faF^F6{EKR|2jJp>EQC$YwncYk<|w|(~gHLhPB zUE@VRxW<^b!rvS+bFAh)vH4hz>x$iVD3E2Sy}t99YZ~OsMFl64g33gD^5TQhg7CHWK%;X@LMgEt|&u zPw)f8A-0zby#_0~hc#>&!9_=9F()jx*l(v!8WzyHiv7Pq9}Ug7_tBRj_KPkIPw%Ii_lN(c7Qri+oaTJKPQ;=5606Wg652N*#@*dS!i1sJVw&J30J;f z0#V8c)JgsYyp?gtAB^HH6dtVQwTJwjcn4bA=Ez9Sl*?Q851Jg_)h+uS87Z0agqGUD zD(8N{JUkZHwybqzXfoxhmL~_DNL*Xk=)BbOr1Qy^&7NB4lg;@usIuW6uoet^ysO@k zp>7dDFT^1(W;_|cZDkzZ5hy4@^a>57*C2PWvxlMzON@PCs72(+NNQ0He(lasIYrPv zwOc|YY+NFmGjs|{BE?{K{SRGN?!tI4_5ebR8RJ}eu-YWW@#tK1MnWBb(RRE=273|f zbw|cH!JZL$gI*=z!~P+a!$(^HK!-B+k9**&28jA>Pxx$4(0hgN?TMHrLfEiPXL{h3 zs`3P*JKY1XBL3gpz#I`XP38VTz7X!R9YxxJx&Z!wf>Y-u-iM|$o9kYl0OkhR+DJptB!J%kQ!>g{n* z_-Qmx-1|+sW@qx}=XUnc-eSx}B6AUIE)tuI@G3DENzFwvbCKL!6lX3{SmxvQeCh#m zblJ&R=9`l9)eVpive{2$FRAffDkXQl`AZtS=WD#bz+nd$DNi(be=&8SYCed!wyqC6 zymnRJiWOII^8t5q`V`5e?!Rj!Sy?IBg-uP&lu{@$jGyjKk!;zf9Pcz0u3wAkAi8go zxN1#F4lz>-{y;u!|D^paoImIOXHSmao5gxrCcX}JulZ8RKF>BmQ-Y~O?6oY0clOv? zBr#n|rW?^i3=F@n$KZ^mk!S1LNhVgRWBC8m<8O*4qbv-y`Dc3k&)qDWnffb!RgZsN zEFm+so`15(zxLL5%g_18d;E^k@0KclS&!d-+xG`}TaUl-W&-sUp{wqeD{En0rF>Fp zCPyD@OXDdi56lt$ikoD@ZxR7F-ZN+}@LSXb0@RqLHF}|s)QFK!q2X)#;{Zw`Wncyb zKKJ#6=k^3&-NN75V;C>7&+M7$B+&B6u9{`qz9gTQluB$VE}t zV7FjUUbo*31nu1^*Y{u7YFExFrp3u?`uj+oSqbAF<@KG>J;!9K3m?&C)&vBoi(239&9n-uax{9FH^PqMFZ zQKMBdVIk~N{td3vM2(Frt>V24Lu_~b-+ZG!Ful)dt?-g3$mM;)UGF^Hn11?g6-(uG zq`wNX-6g1ZF0!N}$jX$oU~{RW*_?g78( ze{p0Wk@{0-o8)8Tf^Sl6Uistlj$f>e-%4CrleV&o$*f@Os%6OS9RVtN3UEe8uiKDbX{gt~J38ty_zrbN(cSGo*8| zVh@~=#rT`S8onwNnF(6!K)V(Zs;Fy8aN{m2OEsgF^sj^nL&BLp$_qUVN;i!NLX;Qs ztNw+5zW!a5fBxrp!YL?+m><#Yj0O1THRp+c?mw0T=0_U>|9lzuVv)R?%+LSCKlk0n zKmRBc<)8o5{Xg)}LGaJJqWrTL{PSC*{BvsE!)X{7xMvJmpCvP9D4@Np)fK*K6lFVU zKZBNHUNj+FHs%HMyxR?*9q@oSCKOhOg8nZ4gM*Qi9L12b4omXPyR5$*vv@Up*MyHkI!=2v~}QIcE|je|9i@3CVZ!2PoOr2jQjMmFoZZ zk$&%D^iXVHNwpdN4}t#qtw0Aw6yjP(uWi?`Cx#LBk6=OQXpE=}Kf)hDm7DMyx~thX z#w;#?@kQNIwdGj3$ntKv%JOl!&hlk>?f}D35~kJuHqFRfh0u08J%g$oYk9ZjxvFx9o4(*0Q-}ZSxDP^bSV3CTdOo`FF&$LO1xn zpm#bz>5t!mdIY`|1i~MGhu!v<@4k07vsIoahV_&vlxJ@_2>(+4LArBI80lQweUlBd z9r_l0T3d#|rwMFpbo|8FL|C@%`==YD;~ZcJ%RD9tpS)3 zgR{K|=MjG8$N;Ra-C1#(G?DM*$WBjP8Y%8%j0hXioh8?tWGLNPmqrJ%Ka9Y#xrPj7 z(9UU`^~M0J(A_GqG`vN0%))u^8ex{TTGwh+FQp}7>eAC4V-#2GVXuPVWl@RhrzCFm zb9k#;uc5D5`06jiJGxdO6l3aUsz$#=jKUYch`!JmU&R;)aB=O{XSVHhq{Vk<$szDx z6c6gh)TNS}&qaW9|5wyuHw6CR*WE00N@PCyPC>y+<%?ywt@;mU7FX747$0=ANOvN3 zo&>SOmalc33^YO#RHAjg=VsX{`Uzu*t=j`&xjSC@{Dm=VM&5a?|D6%o(D+Wi1AtV% zuw&Yt%?K0s3+A9lvST0Fu6^iq;GX})JLC0ew)Cr!y57fe+xFs)F5GPu%v)(b`3iL- zy?dz$(a*dqp;0vWto7t;gt~1-6J9L4N8S*zx)!m?RxX$8}QTTjuP!SVXi*G7O}HTe?#$qzAJxCho& zZ@yb%J$Yqb#pX%eEbGauO7?Mf9zs4+C%-HZ0+sK+XSZ5^@}G|=l(Z``;NzLm=0>nxW^oZ6>_I-tJW$~I}4!fV|HX0L_wa*XaT-OWL^bTX4AGUM=d zfNjcR8ucQrQ(KzO=%#exBY0Gc2z$2-`7)R+6@(^}x(LtUPMXoHv=g<+4fi(4(rkRH zO0>|p(xNIeKAEL+BWM1vaFqqcqk> zcg$8P99B^HB*Ax#s|rjEu{pqF_A>{7cB1gzofmKaie7Wt&jJb%p4loJM8FWE6~-EX zfB3k{%u1+B9p_NXG*wK_#w*P|@xp2O`UnLv8AJOH_|LKZ1;>2&N^#7OgFTDR5l(EO z=(hi+Oiq_2=v4l0k z>~aIdc%OXhD-kXoO2qH05f2TaQ6ak9!`a^dJUVZfm%7v>x1O~x?Ix$LX|kXfA}5>R zeFgKj>F3?{N4i_(n|{`9Ux?r6xC@!w2fGpBTp}IASj5hxNuF%`1KqHQ+sxVLc9+Xt zl5&Yd|8Fk%(hVL19m2YRLam_nnJsxlJe#Y0@;U(z%^~V4KwSe;;NJ|IdLys>9y9|;Wjv{qTBU(3So@~SopN}V6>$2^{^5{IwEy}@<+Eb@ zV+Wie@{O~cI1Fvvs$J{(A)|oY{7JQbeq_G#ZHz8qCgbs58CaV z(2e?R*G4o77T$6l6=PuLheL8jBF5R4s+`c7+%1fgx*?F%(eW)IZzESX09zZvm~^XN zL;=U%`qotq?EV^3qQ)-}eGXE}QKUe1VM5xL)G-rkXTT}NWJdZUOce7zSNLt$3GR)T z7tJYw)yHT=f&!1$48P-1Z9)mIV&Nn~d%f5!5mhc=%wC1LL{#`$mxaRwJ0^;nHz&C# zvi8rqVv8-IV7YIP;P#XIt~8l3zs_k6aKX{Kp+NZG>(*>%-*{PGE}}C-XyBT@CK9K2h+;y8QncO^Pll=^a;Sk38#8j5%MAH5fcWfVLW9YwS%d zFTj_?)dM2{9nN-i1oEfiF|hu`S`{bWTpR)J{-r-VyCTk5e|Vuk@%*b@k>*%`3jes@ z!uh<{h=w{i_;E|8sCX`md!lHICjos!tJqqgJC*AhOy>(XZh{cOxJ686&Fh4*rz-f3 zT?R+AVtZ2;_RR}Q{`oG0J=WIf*ju_H{}D}!f%ET$v6F@A)vOGMLg_M1_;>$7@V7Jr z%GeB$#C;dIJ-UAdS+5XA4SY#lh%oLdVI4{Ycf44K6&-;vzW2M@gG7TlxVGDQp3Q5QA~H# z1$o+hwMi4wckJ&Y2f5Nn%ja-m@sqA_L08bbo&QOfA%TOY`W~s_zRS2e|0Qkx+(-8B z*p@Jq-xZ#YOzr&iu1Guwt)M+pTl43H4>*&civ?w(poDQqNHK+UXeBXSEUSbxK%h56 z(!6S_(Yvm3Q`vsf#hTa^)}hivyspbHg+e#PAlM%E&u2?2KfacGN0&)F!<|&c=8o@L zB*@blrb@g}&EfNdBd!btr3Coev-YD-T~Ze`w#tGCs?ilzqRt^+*+s`n5m#XD(*H7>hc%+0Himy(+bNoVDQGmnvomMJ+6u}3 zzh5({tL~YX*O$}YM`2oy!H^7h+qv%^AgWSY%`iTWb8r&UyYOfmIEv}8u^A7t##N%m zRa$3WGlC^Qz&!Cm@WjGUhA&?3h>v+FZirXJGRMb9Gp~Ys-(u#8w}U4h^~Eb4@j^T% z)Eb{KnsMySj1UVxaXc7U)exWPh*zQc6_imunlUMsF`Z(-KXEANX>N#5cEqPp#?{bH z(lD`yanMFV%BnOLfvukC2zquj#HTvq(?&C8SLPF&gYHRV8saB9;tiwOGDovb8toeeITcst z{i8BTp6d%XWQ_H}T$c|LT+h^2Rl3FJ(xC99GoD;8=i zOGYN#C!7J_qdW*~UX=7i%>k#ZMVv2tq9M3?#xofWqf1Fsgr$s*2}>zV(KC5w4gzI$ z;X?A&`9AtN?u<4h^%Y};)yYZb70QUBw{R*vLp)D@z6+! zyi3ku%yUHMIjnh(c+Gl?$h)1QCHdxXUTE&kkyupi??I>a^c?9s^e$VS1bIOm_-o6! zv!k8+5Nbe&=Kd+f4(w*y;t*-Y0r`?sRbbJUL3M8j(=dlwVOfb*RunvihE`bcSKPKt zU(RTej59Hk%ULaw%SnGPI|=%G2og}*%ADn-0^q7XT%}!wx?W&h-<*w;HlY4hLRzXw zsXRNXV)`M$I~xNy>>~l*U*;+&eO373 z4K3Ro2lvu1?O#MblFvwny!*p#`-46+|H6I}=xh_4GnjHj2e!XT)q@y>X+srm+<#NG zDx_X~SRi(+Vf^Q96+;{Mhc}>xx%|5QwpZw6GXC=@(+S)@msM`SgwEQz#UqJ7EJfsO z--&mW6F{hytvjG_t@NFEMVW@ztIH8neq&oA&ZVxMjuWrpG|^qpmQG{F7dtpyKz*xJ z%vD@a;IvA0Ep6K@TRJx9cV1^4^x<~KjlYPKK7*(wIY0C6l#DO#UdIlYAUF`s3c%-t z6jCpiodw6#LWO#%3>?W}*-~!&#ZtJ9sLlC}7jnvaG)3j6GL`Y)L9HX1=|AyKU*F2p zCtiW$I^|u;);D@Y%CX9{?#HRCuV~TL!DrkjUc>LzWz+lGRmhPqh3sGe=Yk2Xf1>A| z1H^WmIN2T`I8cn&17*-iyyvtImZ?nrvTdzwX+q9LZ&rfWr`?%={zS)d(YrI@OwoXZ z$+3EU1_;!y`D_eaAvfW(lI=GCJ#*z)n&t2Pr*mx~W9z%@tC2Y-GlM6FChreV-v86b z_{sbI&xyTnYJ>d{_%e|%$R>NRTF(jxm76>nPr@_s<_i9<{r(Tdf{f1L#Z@NL?2hNh z@3;Mp(m;wmIDA|}n3}p!g2g=eLY7r?dW_)C0kSI&!CQFMe*YQdy-Z{q6Tm8&K*pM7 zTiV&uA2BB!y&_+KqHXKtIt5!gg|P^gtwUwSW_Id~rDBWd%=T=ZMdVs)PUgxBF@?Ao zDJ;AZELY9pBf}&3KFxGivrUF$omT{!kK0eZ_scsjAv-|KDLRvi&tfUg!sEe=$3DVa z|HWYVVle2F@t+2XUsx$NXE7*a+kV-hR}{d*s4uepvh%FVd5Tkxr+VcO42=3oLj8AR zy7XRBLyfj4Gzz}NPWGiZKcR^KE)gQJYZOvrp>ih}iD15HkI4Tiv8I|soJmhgyT1>H ze;*8bpXFZ<+I}H6nPE0C7!1FOq<`o8f`-S$CM#t-5e&bMv|sawgOO!o%$UJ{87nj-cVSo9}4bT9|BHBF3ecjt^#2 z`+p()-LI0juN(|iH`>t-8ys%#{hn&gRpKN>Va;D-w z02fY30$4(huVX4d6KR5C+nUQTnr8A4(C2D%2Dj!xqgiQKb6E(P;#k7!7NTz=UzjuW zkBq|OO;8jv3Fj%7dvsf7hQ{zYLI3ufV~m~K!Zft#mIN=2u^EB}Uo?~1%b07KGHi2Q zFyf7k#HbvecK%*z*YpA!ACH;QYpyjL2eOqIqVm7 zh+=)VGi|3w$5oJ4+i`&dbMjf>XQN*}|&)oF9Y3LoQ7cKYo%hwlidI+k#baB@qoaft|1 zW-gRRsxR-%g?K~6zt-u0PM{y{%J@L8ZR%ycDD_sq3Yj)zfOS3V-+B(jMBM^6Pxcq~ z2`~ZLgyR*ix;i=|&x-H3glrYS!v@c}elIOI6i&CD+sU?Vg;q3a1?=by@8}GASMxhM zBWdED>a6rAwn9A^yRXysG%CSd#Om>Hj{D2+(%mG}?}b+q zs7g0brvlRqcR}ha>>uE8!0c~2!@uba^1J!xJBc4si>+S9TEiO5m$4}$=F1lKB6ZbS z*HhTVb3j}q3|^j#+5FvnQ%)i3A%XcLr+E&tAcnAa_GPPHGWwcq$hz!4J_7m$tn!F_ zg0)kX88N-OtaVd5DO_n41SW!*j792l!G-^D|tKBnp$RG%N<{a8EvQrl# zM3ZtKoW@qJB`yBQDoW4IK#J6t#MpJTHgxz~4n0o8)A(4fC{N$;tgEa+lGsp@dgM9$ z);*f{Yl*AGDfr?5tYx^$oGI9i#Kh#`*${g!a?Pl^rxeMOMGuyW8CMBTj>tvpTFcfv zm;ep{z=suzBoJ7;mgB(pE+LYL{<0B#L0)6N&z5o7bk?;Nd_g>|tl*}T=1QYhR+%-g z$J?}*t9%jdPUK(z-w(?m9pC3Ipkj^YqEK4suzSqG`bX268Ik*}~DeT+pT+lMvxwK`bb7f0~ zWnFnSxZc7;s6}F4&Kkuz#)lHj8m?DD(8k8bB7rjRfRus%t3W%Jdv6CzN9W>gLR>gl^Z_zr>~an*E7DUtY*EW^H_)dI5j6t zVr)~t-I*a&Cg(h2qxZ|4{KTo*TQ(!ay3vwjVo!-XLmhz(`$_^1sf=O#Iag5^_*v6r z*SqjTPiKHN+l*$?3#57ms}S&;-XQdJ|LXCcmNu8O8U_l+> z?H$4GZ}A&D4DYh0(`WLq0VhQghP)l&-{He4etn03h;^-nrkUwUr{GX2m*{Se5cW)xOO`NO9v8*lVTe+rZ<4cKd^VFAN1F?Bt%q?D;GI?Ib z+P-z#9jOUJ%^l%&Xy(uSiVnkDAU=$vW{jgo)T~bNUmGU&*_p9sX;~JztTHQY*M?(! z#1ui+T$x0&eE;cTJy~%PZwfjQW$Oq=N#~=gBfO#``050{s>AR)i!o!@KHd?23~6`p z4|YV3VeQ9Mg6W*!5w1hxo&5bB{(jb?hs%_u9pNQNx{ELGAZ#6GtNJZ@W%sCte%=v& z7$0$mca+WbZpapILWGm9^L6shO>YD;rhJB>3y5V?w!%2M9Afbv>@2C z$q6!uNkH#TFPqVm;##SR<7USV00Ks{Y|PiLUrYYnrgwyM(apJhT8FKR{i_5HRw9eO z_0C)Ac%8I+x^W?`WpFNolae^}VmDWRx_sx}H8Irtl9R;?9DdIzhU)URz_H zTAIRm^uDyRnza1*rcQ0gqlYDnI}6dD&T$=$8;W)WCb`orCH(v|IoysVt5h@ z=p(Ov3k0G}V%7_wfD5*qf|bn7j5%wela|()zZSA+O_9`e8j6g0k0>6G8-OYS!`zcG zJ`b=ceOa0V7oPQNw@9Z2^oGN+x|UO2nN(NKN~R)X&QfT%r7pItg|C#h+M88TB-7}N zQbT>0YF@=2vD8|NIIuLQ^ZWDFGt^0jcZQ=}?3%hqGgvFA|`^_+<%`Pb}dd z_l5tsFSxCW@7@QPv9+-lmbTEe#7r0^4DAd59v>I+d+DQpD*z1 zT3M4G@IG{6U-&rE9_F`G*2orCAd&pO@M}o@DgV2D{@=1@PF}ErQyS(iNX(peciS75 zk86&9t4!_2c;z*)A3-3p#pP>pO$G2gliXHfMp&ayQk2prTp=kn7<1HNn^afR_!GIT_|Btk||n$b)Wfy@JA+Vo!uAGXnlD78mwME{jWD(Z*v7qq@?1|f?r z<15zy-d_013x_adyTHtQUAy8SiS_+EDe=fOW?e>|JP*J(?lYsap+)s+Drb-1*P^n8 zhMlLKrpER@1Rb1w*X~T*PagUT>&!ut27jT@ZB2z3LYZpzelvOi#G7Wd)Op%eZ?D|X)2tcWqOU*OtdXCR3;c|faUCSUCyqt{d{MPt; z{sd3{pGEUlSu7fwzb||r$|dqs_C=myf!a1gkAqPAC{D}R7p~YB zm}Sj`aNa(9qO<&Aqb5p+YI4gQ1Ll9lb?w?3xu!w~&J{Cf4tWl2(|~j zy96tW^}>FxYTlLni?5-v4Ltun?Cko|bUIK=ekjJ+Rs%(YY~I4nIO`I6zO*--hN1kL zzqHrz7^|s4=z39I5)|hQ+sUp)hOrdI#)42ZKm$LuySMp> zq%ll5DSUaacX!dj_MiCDEHUq%SN1mVOxiSNZ`8-)) zYZ*l{_00m3L4vE;n#^IWpvb)(cpqECFgDNmm64`lldn1t+*|Xo>1^9J7&pZOh{X(c zhS_@!vNqIB3vKp}5M*Ht4p3e*2fFUaVh2r_{|4M@G8$+YJBHmzjU!4N+;{b0mc#*H z0_94-eb}d$Myg2^fbxY6yUi12#M3>o8*q#(V$HKssTPW!#_|1hmXq=a>v+vG#ez2PRLe#KV` zt5eK6tw>$BH*81h*Ze$6H5AdAZ4%XrIa$J(%-6-Gs@s{Jbfb>Z91{ift_p-Mige?O z(SP_KO@iz)AVL-XyGD%tQEgt^aGl~9;l*c$0Xb%q^~_o@WTfYNZ6uK4s`mf#E8^WL z#}yPxrt5q|4GR4kzfV&cYi!R0OIKMnuggMb1FY>IKh(d8b?x8|{fS=<^EfG@IWcuffKN`p5J!-gU<;$Z{Xn&r|^ z90A$}aNlDy-!sas|a#BXx!^2BY~st=6c^dGxCXHfJba>o{?Kz?WP@K#-DSWiX0j0vXKjy>}&p)v%pn$R-f(+ad zji~}uf-G(M4*ArDpCwHF%yD0$hxKGT$|rU{xEm8J%;@dLD-*0<>WVqJ}@Vhr}H{ zeZ;bNY$h$tQUTWDjDWR|EnU)OTg}Uq*fz=@81!?Bfiifm(lXl)`1v^Iv%E=6hO?Q0{$nlxDeyR_%(^T8f$@El2V z%Tw!?O*LityiDZO*E=@rOnOtEQemLy6g(I4>)UOEc##Wh29pkEO%^)gWU;;#V?1&~ zf+T`?I`e&YAP1Cj!-*q56>80Cn`O#6Q)DtB0+Qv-lcuV+wNWgQ1}uRUBqTvhBvua$ zbs8XhgU8k4$r^0MO42Da4OqerXD%lhL~)J`T*Z8sf=>y_ZLbQ?!r{xQ7aGeBWextt zWE%V!O^MM|61aV3JT{Rset`JVcmjg)gS!S$KFf9Q)XxvLDnfFDoHj6WolZ^Ia3Um+ z3==W|?0ZDEZ!Wn1Da>yN4#4FV%vNV!fmhkek8hY*&03M+%S$+$ada&K;bDe=vx}Af%a@4X zc`LSt0^kYLeGb~_fSl;9ARGDoOVo-z@4tAfr?>M>hKp2>?TsIR1;YE%@k~J2om&&@ zdVcCjbuC-dgJe2-XKC_ra3hfRyg!)jInfq3RJA+2cz5vC9$vc}NXKwcYifbcwRxM~ARrttSGk|02}A1Ux_(h3E_6lTR+)PGLv+yN`wO9=X|1XO?EQ z8sQ8yX`DyzkS99Ig$)ZA{dLPS5&2l&66e$tx$saQqfgnbS+S@5R?~nA;seUo1VsbX zF!5#$6Qea$-K=5R%^IG$Swl;!37ZWyAe%7zx6ozgiHU-!?P;kR@`^-P$Z7OsyW?`) zRSewn3Ol280`0Mz-_p|P+c?IV?Uv_E`iCrNVGdF+8x}X=8x{eI{1Gla_qb8h+==t@7q5(zo&%x zef8%2exLrArqP1$l#FiWx)WtHmTBQuAOw14^uO>0c0_3+C}6;7c$r?H2}~ozN#cDb zsAmJl$g&%hho~e9tfm)es^OnNNidbS_c3zphx%wcMt$_R#rkN}b7xt(_Ov$q#;%YW z_&D;TtG*(}X@l}Z#{8an^S`NsuVl%;)91>GfuiTkh z>G{s7ZkYhn*YceLtrKodO6ghPeR1!$cbA1L7tJ&(tCfU7iQL?EvYcL8rhPX zIV*b$;{O1bSXok~Q{FcvxJP8)whJ{t{d^|AC@TobBoD50u%ao>_4*mcBboQ4UM-Pi zro;o+XO?7TJ~f4KUpjCfWQcFxfWMb+eY$SrE4&`#Mb|Q68 z(93JuWfDW5Bg1IM$=YZZLE4Io2VfwIyJO{e`!2hI#^bX}+#<$pPIQYzZnMfQV%=u7 zTO@XyQA!B~c%wPNXdY`cCmYQvM)Ut=@BQPWsILC;*~$J$HVY;JR!CyaOtMKpXv2b% zq+pXFZbE=Q5FkV=Ewi`@&{8#O{e_Rai*7a~LRf_S5Y6tu=9f}JtcnWXCQ-MD!3tWc z_@gu!iazRth!!c5&-={mZW06p_4~AaUJrke-PxHl=bU@)x#!+{&ifk8!sTXRv{@Kq z7UIo9!Yr)1NZsQdHxR9EubsaA%CV5XnY|xn^WDBoIp!}?u7C-~yv+%IZkz;u%wAkj z_KdK9HgOSnma9Gu`Q?IYqKwf<= z=GC!|+{a-mx}{SP<*O=VE4f`NL%eNooSSR9Bac%iX&0!&lRcDe?XJ$)XjbWO|(l#M$-3fq3@Wd=eD)MP!(&;i^a)Bv$nUjN#2jVlHK8LLk}q~Ovv@O zm5jVkgFj2vx%F+!fM1?l*JjOQayPUgZTbP7y-}R z?60M7J3bbu8T8GI+@VcXFlnuYHN*j z+}|cGWr}~JLLL3WDVJ^4nI_V&87Jj46|u-#Fp^x8w)m!#S{0LfTif;O-1{I(?mcY< zDGPt6o_llK-I}?-ZY$9&{9R1$9S{KjU5`$>NNq`AfbDE-0b7goiSP}M`Se+|wiRe+ zXhK4qY{s<$)r_kRs~yqw`)vL7dV}un_+5J6!ZybelBz{3{=98zYFWcD@y52hjN&2) z7QnpCmU>d!qcWwQ6ieEqQbwHBwp4rT{IdI_U7C z5)LvuE+ZC9t^JPS3NN`TaKmF)W{Z-ce(u)xEe@8B3sV;*8EmiM525)y{^!-3F$+fJvyw z$-G|s32CIJIjgTu{lu6z$6(@e?weZFQao-u?A#V(f8Gu(A(#melv1-}Qw!ru6f;-U*^`eN;fgp`kv{& zx>o-pRqn&BZZ*!GU-_k@rnNrO@nCBfPW8iC9uwWI?h*K}GGf-$nH??azPC;S>Z7`~ zMeR^gcZAu{S_g7E+^weTsS=N-xoJkd%27&bNQR z{D*^{|C{_gC3vUDCE$>c+i~Xd)2mq1l3*Qc?u^y~H6mfzRqkTpDGP|oJ8c36VGU48 z7(v7G(^b3%*d+K6L3N7-Ba7dM^~mx;-f9odrq5}W;Zzvzu4a6jDu2Uoj_lU-$e>@EUX|^BtF*1Z@0hWMw260i-~_41lT3Fq)gNMxU3lfnQ>OnmI#Nk4 z;$DvPFot0=E{RNQEYjNi%;l%`P5fmuw;SU9$BiEq8q(pxG1PidKsS0vY>UcPE>p8z z2WqwtjgGhwHH=rr64NqDPoc&q8)@Z!SAz3g^FE9Q*sW!3j!$^C64iCuB5yIZ|o z*D7(0?aXlFY6d^Q6}+z5&eHY1)5>+zo5Aba?O(Of{r?Ewe;{~WxBVnt@B1=%|DWXR zbmtoYT~|R5^ggA5u2CT{vv17L%&mHMh8GDvGbB%JG3{0QW ztSA&q;=7E2;7%@0*WsJ&Go0J{@zJRo`}O!?f(+o4vEw8h9hG$}W(D}1tjW3+ZVuC@ezT}EbCFqG=B-(=nPQeow#^B$ zZKjwmhi#@f){}uXHZ0|78_^7!h(((5d zAdwpXDuxqM8xU=&M$J}jOdZjpeZQZ~<_mFSA^M3Ma_@sTpHfJzcl$;I;cv?+?6MbQVYDcJ7bOV?~2`?5#isS~u3md+*_M z$5-Z7&V_HXJr0;+ZF(+so)?;d>j7L_UNtfa)z}3Xi;{U!2mceDj-L008SC@OPBBVS z8IeT-aoN4BEbdniv5L59bs7c{DzApCYIX3c%Vj#_KxeFvwmC4Vd7_yY)x0-?&mGBo zRebK{nBeCc`P@-p28e&KLNbKgti9gL3?C;N5)&YEo|W@98!r3nrsl+tySz({Ux~V}jnXzPTV>?C?hUZfowl%NQJMeYZCE zy}~$dA^Y3-A>+82{JUpczvEZUo~5#^oC@%oW-PUfM%a^Cyc~f^S+nVRrn+NF92@Yf ztiI=AYs`(>iPq+ph$n7Xd4>!Ui9?PmA~x~HX61_EXHqibaM3j+V?_LQVe@`3vv=6` z;%48%W`~2WPt)hlZEjUNPLQDTQ+lMMM>y`LAALV_76$cgFb& zoBMu`qM`}96}oA&1x=K%&47b{=is&hms z7hyf1Y5W6Zv}MOY(5qw0y^Q0PCit^g$fvJ7xo&q;Wz>PE7~jFBJ}>F#6T;XY?)!6- zX_j&OpPLo~Q~C?KwYZJ(z0u@-g``kAH0H+eG?%k9O?}84Kbn z9Zo~@?P=I? z#@g0=n(Jt4Rd0+R7qZ8SCKD&yWA438z|uVO=>h1ZuF3Wg9<_L(|G9no7=KI*#xB^? ze>U}15zPj$Z8DNAVx_<~f^6}wCevzqW<8U;w5cOSw#7Qq<5peY6~yzzon*^4NC1;LpRUXE52E=siyGHI!A@_a{zA^6q{h_~7?0#)6x+lvj5Oi)#X!*DjC~tNA&1ImZZehQ5zD0T1GMS)&Sc+&CjTus7I6&d zEF3vJFpk9WjcuasrJEUvLzGVJb(xy>nVS6UC^U5Y&p>yKBZIE*)xR6P6^Yn3Zq zucEuT(H-0vUt&|=qA*Q1u%(|k-!jSwUuGn+(7~|{i7WET_1LK5>*vj4S4~-LO&(q{x zkZr5Z-GiGq9%LLZ)0LH<=LY;mnAk6YshOyYRF}fvB-1D3-^fBuUtkf>_UUDz;0`gC z;|qGUCHvD){XLWM-|Wk_AM<}4@h-bpBZy3&nsNL$-GG=Tmw8uhFen8{w$uIi?)V%1 z6sl|SF}+e^hX8uD^Aeewkb|GKfmaN<_0zirYiTw}g7wLNnwK&fMXQZ=^Kho{9^-t{CjpeNUJ|L$! zUZG3V^al>A6m1w->BSO$zSi*v`oR&P|0%X~ri{@Y9qt^dtvwovI~-l~gL%Gg;?w@3 z`P!_9CqCt$@j%v=iNEt_{f_>7u>#P16AX0JAc8_u1kS)3GeNC8jN?AFwTERA+lfRl zW^hRKg=8?D=$B`WijQx$U8Si5x|FI4gIk6$;3B|O|(YE@OY$GengJVDF#m+rB5~8mUvU~gIeU9 z$WPhnsV?_sP`srlrh1l;Jj$hJcC30=BPW~A)|cwlf&0OG(FkptEw*IDoV?DG*Eii! zlpKRkSdg7!Gn7PB-%*~dz6G8o&+g=643`(Woj4^}oz`q22*M@l1Gel z6w|XFF0S~7uR1st9zlB7_E)z&(-4rhFw&BdAY0Rr;5r{O(+SgMnfM`^W?ZpSLa6(GM?Crb_bsD#!2gmI6!>vel!C#qbMV{Xao-0}LG zBTi1=6utYi-sG5LD?1N9aErV1!#`M9W_QFfoFe={=fR$ev9tHwb?37M_R7xH{q~;D zFC$(au_;=3Aum4x#2snGKNfIb7e;9LZGTBhiQ(sI4b@m8df`S#rGy{(akRZK~*PJk7E9(?v zNmquTuAE$K;CHz2)vsW9><~E!1?+JLBp`+?h2zJ>ni7KaGvJdxYy? zzhWOJY1FCS1EzGnIBuoivI6s5vJki=+EzPAWZoDATi*1%%?gbT!ih(!az#chR>U zMe^r68DG4fAKl`lUI{&th{HCz5oq%USZuKM+k zWIlMqjdX3te);$7>2szP$=i~gGTgymL(=+>VFCCWhsr9Zl#8alngb7G1)wU6C3nX- zCE&Gb%_8P;YUhhc+|F6G3cIOub-iA@+3WrAui5(&FT;WtTgg?y{VZOp-{Xb1>MLN+q`ylZqk;tK0d~+r^{%jTT%2Jo!!yQj@b5ppbT~M zspt1R-x19`8@v7R=2QRJ)8BC!pds4ZZ-2Uq4eVsP{<69AdGC&BFXFF;z*CqIEPrNn zM#YbZ&3fgT(a9a&rO(uj(>{sIw?9+I2HNrA9(-{979VbXX0%R=u*{8kY<#5s-6U-* z)1g;6y}zn>Bx-y_#=A*ZWm~o|iIJ9*{R-a2)O(VW@+z`Tz85y5)W99-MV!8Z)xOCr zT)_t3V=QmeSJys9`xYc+QloUYRC=$E#MI&GJJ`TF#_{xK`-943B`JySnH%a;5~Rg^ zdu_VTJrcbR{}!f4jKA*s6t}u0W#yMQl;DsQ9M!^3z!~fT2ZL+wdl%Rj#8lzQMEAL# zeNcIpo;+DM%B`tKdGE?E@w_Q;E1nPB|oDHEWG4rt_~D_C)uvU zVfOBnm8*_txAGM8^|eSocx!&ADz>^kX&dc>%qA&*wfIHqxy+l2WzHt0@G2^9{W=T?i3nK_i+ z%VBz_u^Swn&|mfZ%sWd|(LYK9viHG$_e2C{VoxG z<`>>BPVRSdKKs?3NJtU5wH~f9J5LbT3fvmJH6gDuDho>iYpe&^BM(GX)qBK7d3~W< zn%n`2xXm#=c2gzrMH$ye(Sq-NYgbH8sog3zI=SBhxL^D&Uekk^F51%-W6%n3A@iun zphbR_=(mbb%+^{(uT`40yfWeH`&g$a$!-E;W(!Vgj=i zKfdy`mR23j;uBV`>Bd%b;Lwz3S(i8RwMpL02yX;4@joTA_*CEu9p=v5W`|2|hImPQ z(y@e^K@!{PvR%GB&dRk*;#Onom&Q{k&3eYT{-k*e6Zky?X3bzVqNw;ce;=>aT9C(P zX-5;bSP>xAnFFs)0VdZ|(H^b^I6hg{z-!(%Z^ER-Z8gzLtO$<-uhs7OV0=M^k+tmY zAFpk0VlDn?D_0xcR@N5P+ZA)Dtz8TLoLwp)|wBp<;n4hl{1^ACGpK;HRZ`;puRiD zs>kP-FNrVbHkrA{@UrYF<`+(9MjUdtLuXl$S_8e;{HFY@duFX?NqlX3=-Kqa&jugF zQy%V#`?LpMK2lS&*dsn+m~L4?G{!#-D%R;mfrtB{2rCZg$g+w}&lr(Mge4hSSt>)F ztPIxjYeiXC!GKy6eL-7RG;yg_Y>6%nY3;DAHSPWV<0G0kvw?-tX42Y}wn)6s-qwyC zD{304AUjJ@T9)egTdI$v_PmVsmHVMIN%U(uESki4t+KxUUY3@V@SEPQm~yeU{5{r_ z77t(fY)4uAGvhR#G}2e?IQ94$p0aokx2c?a3{T#3cljSq*Xg{a?H+~au_cGA}=-(u#TuoR-w$d2>6j z)B4A=QzX_kEIK;bFw$b~H>|>>61q2gm%>)3Y}5l}6dg!n0>hYD5!iakC{0423#6gb zfn2wuiCNF+h^uTn&Ag-B8h>Z1ridr~E=*OAzpls{U&L+VxyP(sF*H`dw=bU5J~jfI zSV+2X;_)|8upXcI;LIgfYkZkWW0s$tVp5NvZnmO4jh-Esj0eFjSKLFACg6ICfqeN(R>C`NdZSE=6lCFC4}=9nW0FAH2W5YikPrULnpsN|Bq-yj zCZrCQ0Bvv^wVz4D4`~Bl_C;Vk+YDb+65&m44^%Qip0%rqg|fp`lmRYw-d-jRQ@AMd zFo0uc!mKDd-lYk$r0BTsC;deYjMj?#oEWcU{?cwI=BA&AIUSe_>y=F89PC}s+7~3d zR)l!GIQs&>fyI!)i%wE|gmq;wJ8zmI8Ne2lR>U$em$3U9BnvsPgKzD58TNuWE7(_{ ztb}|o-#&$8nF3jodlgf8Z%9Ycp`*yMoV%-(u#1ynA*jX;AU_F=Ty$RnyQu2cPGELU zo+9bd$Tej077U<@!Dpip4yr!ZhvYc;-kw(>KpG5wHYJXN+l2f>#Q!bC|4+`-(JzjF z%cb@65_Zl{CfF(MNs+awO!ut*4M>5#Ws)lIB-1Wwob^0 z-lm|xB%{Af;pZnLhx-fs-MzMz56&r$sUoMB=o;eo9xMvEy>NW2P$ssL+nrpShkLw| zt&g)@MmBYB52A$!fjnn95V`YHz^xFxPc3n69o*xNX%ruo#!u|}ta0D*M&)AP(<88* zg%^x}UGbM(GOW9a7k#tJbFcJHk&?-%g9IiJfsgjAOQc&oqL26HPvJGWmwPEN=Dhs2 z`;!(R2sC6CA?On&C&p?4i=|Dp7&#Vxu+_}9&WcN0|5E`1y}?dJZuy)W9~540G<)yL zxq3ZFn1#6pK50P`##Yeay-UiZX$a>Mo^}jVf;(R^_J=5HHjmaOB`5JE+JGg>!}$&R z)ToT+`bfNif8p8YxF69jmxN9s`0QwRgQn13L>&1jF7t3c4?A!;MAU6(-sxu^fFHIX%EC1iDMPCII_7b zrd!I}vu789>hx7abu~2Z`*UO8FGh6LHSVizoUO->k$>F?)Mv!;;s&Ts+}p^%(CFCH zIE|eEL-k`h$I1DkH+EGw?%UHy`$z>AacQ;1YZ&e5BRMOq}z4*B=yKZaT*AaS$ zt%`m)5`RV4ipG6U;3|#jF1pqeuRE-p5II$YW56J8jlfZ*MB;|PL+O5)@B9V1U^B2#xUmpt#SUvZ8)mK=zeV6rL6^Umh z80Z}f>ou?$Ag)1kxMuZQa!TxF^(lyX5JVN1s=6{8_hmM2MJ`g`-6N`(8;m&?ynlnh zZ75vOHL-Eu#749hHdFfU9AWlm^n6$()&yukP7nmK2Fdq4SF_OkDgHNez6`#T=3rpE zJni8`p4+hU^(lO05$DI`Gq4Dw0s^-)2;UH8Ik~1;)-(W+UWfHNTZP01azJVWdO|cW zZ2JogAZJEQkvF#{Y)JDj zGD}l>yJAF3WA?R+g^r}P6LSR4p4XZ4fcKa?)(+0PGomN)SdLTYo8HBz7c=lhkh1u$ zm_nhbD`r9jC}dx4VNo-LHYv&j{^=t16!S4Tz1A#cS-WCpjmo&jj{Q&b0aoy42-CC7 zQZ}xDbizDPb4vNEIS+>&!On5@H2vh75kDW{H5lA=OLS<;ggim?lOK4zKgopoER$hQ zGK*eA#G;4^5tc024P1e@G;L!c8lY(;=j8l7Ego+v&v_9t>#R%6==I*xgeA-KilE1l z^nkx7;PjSyIImM|GK|zM`w7qa&EC?h1WXw%K$yiA>xLq(d0|S7)m!G|;C7mHOXCyr zEZ8fJOWUI1y=)HO3AP&q-do0tP2kVWZD_U?Oo(V2F`amGdiz~kCao#S!);y6cUq%V z)f*G)6Bc;HtuC^KNw|*5PsPT!om_ji&0gyCa2ArOUhd1aCwykT_3#y{3N6ltwG(LU)+CZus)NqgT)3{*xj zL>Xd;RN@HXa)>D<*gQ`>2eX#L&CG~7sqI-TjRBxn~i34&Qq8MR9p+9egtDYG6W zvQz}oA}|dN*8_2>Gc1QaC>%M+~ef;{_2e;uA2Q6&k>FpF+o9ka+M(}0nR_iJ zpbMuoN1-v$6j~I&2K$Jh2=E3wSO6^qptktl`L9>sr?Djd18so`raTviTUvOO1-b>9 z*ZeZcfcBN6ZS2f{9FDicorR+Ag9i~xptG26IYSdn%i(amO>?s(d2UvakP1<$XZ zFC47%P~5rF42er9lzo+~6;l7ya%;%E&+Qh3Q$ z)GSYJ6eR<*ne|_PrYN47rnOWu31t<{!+NoVCqFn%jXWlr%1=*7AFS-e2WHMg0KYJ0 zz&8cWS($4J;i+&A&EV(Y3~|iQiqKqtlKoTY@lYduy)S@kL&SYr?3+Mm7}qf4Jjz3 zQwvIzlNTc(zG1a1;Yg@+(>Mra%n44VA>5!*{j7Bjn>j2GEt|@{ca>Y_LRjxzSg{nJ z62vA~E-MR4YdDIa=`1h$Tvvtrdf1H(#4qSy$!BQk*5~2|`u}%Y!@*8KDwex_81@ka zUW&XjzmN%Y!U)Vk5x--RaN~8X#Q6v^%yGviOtE_6T^_^-K0_2h_aqARq!m%xwRDpK zb^8st1y}jdilTNkDRHQ~N4X1G1lc$mGwALu-{kINWq0p7EXyRXul%d|d-x&sj_f_Obc8(Cp>l-%y;(8uP@lWNnj(xcxTc8VDgb{^Jp+q7-_hTn`s#nF zzyJ8F|26*p&{zLD{vL_A5h_Of#UobnDf9q@bLZ~gADtCv1Q$`m;oR$xDKp;HJG5VX zzwz9j^T%@(ZXoELg5c1b9v%?G5utXc9BZ7re`7sg3dT@DsSx1}mE-YHJohd8w{}ga ze_PfJ#B(ovi+FBluz$PdcrFz8#3Am{{y^EA$vsa%7oMYiLpmC@Ic!KH$tD#@dd)UZPdL3MRGJ3ic%?>3tSqWkBdbGSZiaTgwOAh(4s^r9;v6m6B zL7rEH_2-SxVz~DT+wRXPjX?~Rab1$ti~KJp$F<&$Go~Lvv-|Cq^~RLTu^^oqcS9-9 zB2@{}7tRn~yh*@XIu?ILKPh8UE-2!BM|1aUhPaHB zRoELf9v@i*ru$geToCt7Wupu5NI=89v)SNTXf}d&(MuWpTdKktMZ#g>#U*%20ErH) z)mH--hPBN2Qho~~1a3-7kHJD0UflJghJ7E^N9S$T?25qMj!6{gVC_uWlaWv_78tZB1}DyDn?kx3`{N?YNw7TBP?ro-{4G_=Ycl3#D|7 z!oskw1nwzWU2~EqW5IzX4a}LJ%NH;?$*MU;Ng0!K(X7S7R~9`UHT&$)Ms`rs?^t>0 z%^I7LWyd-v6l8v3i69(CG)d-zEF8`^F4>^T;XASXh)n}t^iR_SVn7G$mp#V7l@Vxr z{!NutpiSmCfsIMq%vjb}!o+D&i=rk(Iej&&9Zu1w*q($)Q9n()NIO9TTageCZk#6^ zWIbZ5Q(a^j)62CQ)b<(c(JY0Z!1N3$II+~}eW36Y1&2;yo`Tc^hdxYZ9QwHAgCkA;U+`F!@?a}qzxa%8RwP#U z_jAu6smJme>+!u$9JSdcB=zh*w(hs}6%)L@Tq7>l5BD5I(7U$s2dh_CKI?8xa96e- zaqFr+=@lC>W9vnCky4a2A^WTLK1(Dh2HsRrw%i$!hLjnjk=S$< zmY*rBiI$<)9C<)5Kn?iVcs9MMGQFo*Br`d&0_(Or#YU{?rhdR$#>3iMo!k>O1)Yge zM@G)qrjwp4^!#u*(V-UOeVl zSf4+(8I3e!OeMCi*1`jvlW!;({CPqOuGww(XAtWy*IBIl6C-O%JC7I_Skh@>JeFbmUFWD~^i%|so|mm@cyHE=BVs`|3@W(YeY5_Ff1UVaml zY!%m@t!MCS9c&N*yWb@9d&3Zl0_UxGe;m4jm0QbmYl>hKoUfrYfv?omj{;d_yfryl zSHG$XC0&g!HKtZgg4b4-!dlj-x?Zf?_d=br9qE53ws=nrr>O^PJXKDq_@ycyMg=!Y zlj^@*Fd^e*ly!{`t*^-AKnX%fVpub8Z_d>hEIA@ zu@iRX)qTJQpkxl>Y%_D)fmOwVFkVtPRO32mtSS|IDq-5lA?#B}7RUbv#GPF+N$Ga% z!Ju*zJN8FLWMYYpbh36vT+vH0MdI2bZcP=RfYx8r^x)_)4e-Z+zgs~<0)OMoFC3fu zU|o?F3(4Jh*lbm0Tn$~5CVLT7kS2xq*ebqhRRT|OYtT<+ciT?uitkwgG6Kk?!1yp+ zRkE%dRE(8tUMx&+8ads{!7DY=9uHc74YrFDO6wzMjJBe2TzZm@v~!m7zR(rNFSW|@ zEhn#F&@RrKmm_p0Mjjbi6i9`L)Hjz!fp+B>YXDIK(Wdk`5H*B}(mL26nb9?EpX$&x ziwmtFj#ghzDVlI2;&pZT=}&;o8Kak>@2)K@5C-@5!S2sGv|HLf(iJaXBn;~181k$f z5dQ4A*j&nL0S5UCrg~EJBnyqKTca05L!zx1&>?}9d$MxOvM6xkLdE>56Z#SRs2bb9O6s zs2B70IX6$7Q`))F@7y_;_=>`;41NiEND($RlQn1=U1>fTHFMjn+_tRI za2pWNr?pnADaFijBbY^VZaz0Sbo`E+c z<#lFU-Ia{$&q4Dhgd=7Ir?ba2K%i?7l8b_)(ut|CIKpZ|JDY+BD6S=$D zfrl^N*`3v&x?nGp6i1g$FCafxS(}#fTS0MbBeT>3w-&+QU}qohN3P$XA1Teyu$%I{ zpjJcNk(8iwcNL+t)4(&<2#G7TXN?&e*?kSz1o^KW;Ab2JmSpF{ZKtMS(G+lop{AGt z_^5%Vfae+Fy?&=F)~A91xEhz<6<512wpJO)Ot-{(FhFD(8`N2Gpoqqao^-<`aHq6z zLV@`O)eII!PL2E)%Xdc}S;YpfBL3ogl<>>64egO+^_^JGxlH71p#Blp1o(^btG37C z4-$iIIhOqDk7}=Hr=+|9x0)4~eYL^`)1?>AXy5VswhiX`B_q`I%)m-2~j8}<7#Q2i`9xJT-FnKrk1vcSWD}PK-&qbMZ;s? zqUNf4qw}nqEBD5Mnk(1FbJScty78Y-bLH6ht!l1r-}rwuSLdiF`xmRZ`j7Rn`fsec zx-N9rzhBMO>l^;p*IbEAOG;06>qyi}6eW-Ovn_Y2jP+e&bZh6#%{Az>S~$ni02xDp zs>)Hb0WIzZ&~>UlCE?D6Y45vJjxC6tQ_^{TN>yn~O7Zg3So2l@CLC6}7xm*QV@E2$ z3D-C@ytv7U1a`4b5bKM?hppme&Vu~Cy0m&7Hu%%yEVv*b zjk7LoJp$8B?sTVEr&TlDwS#Ul^I{$DkjvYL^I^mUGf{JLbrauO53g(&l9Q5SfWG|> zi(}Z#C0Z_PgE@T+uJKF9;DyMtnPQDdpK&^_gR7IcO^%<@<4w_9d5hBCx z5=R2vAXk@R46Nh5@#Znel#MC%Oy=u#8+%!PEXwVp35Me3631n9^M3B(UT(v2ZeurB zue`;iVu3|hL*q#Yq7L8t**``(8kHpZYT_pu*p(;DFWf|d7geX#plpp7*J0G=MJy}& zur11qkD0~ITuZfveA%(rKKByvdk1 z23+e>=0ho-t{8>2JujQy>#vS?{az>d-p3e7z%R8Z&dJ6^>M^_twP@`+46iG{MDdbA z;}IWmN|W()(e&)q^#)Bs{xr5od~^kVXmDZI9)Y1)kGeIkKH&kUSpO-r0V|t^hViq; zZ(VsNApiWRu=~)Bt@+Qgt_JO~Ja2*8t7dXfJZzbuq4qfPFf`bL`ZLM#f(IWZ(MOjL z$(P3=hLc3E@#vSv=e`tBe>VS1VG9%3P7A*X?rdBLn#WYqvas7`5I|kM|3^ zU!&Kp(@9{f(4a@TCe@$i*-?M?fD<+EyI*_e*$>9gs2$B(Uh5wp2{1X=y*ekiF1oFv zEvlm{rd_E&!&{tE#_Gy$DQ7>|P#G?z()Bq|O7&2LBt8o114*>$;6?ozHW5C{PtHr2 z3=(E>o%wCnlN=}4Q!R<3daC4Ds7$G+S`z2s9yW6uv$N#lGqd=phkMkFNk(3Ky_)vq zK@#K z>M?~4YVNSCIjy6Ayt;V{tDT?|NOSpZk$72+T!RMr1u3I&rlPpxZ>v6z-t)=~)h?aw z*K!ToBU+9o7xu5!?5%^$5@fELxu<(c+#jyeNV3e$SEHQ4WPLm3XDd*@R^VI`=T!8S8PwM!Xt`-vK73^5iJba*FmuaK`)lgGu%7n% z8tO&$WF^o2*CF{wC^s;xU+~%kNGnpqo^tZM_Pn9G@$7!B_PN7*AZ=W z3eHB%?1!EO?^4XF^Xv4q%3LoEU**?Dht!Rfddxwze@6}N zc(vto+_P?HX?`em2`l#K*{~5(Gg6l(L(}1$EJ|G3rSmVOx-zraVBwgACD682Y(O$& zelqH1@{x~4E`i(*<;cV#^>vlg8ds5uoS#@N?e|PUULv-8Fwc0H=QiR^@{UhB>&0N%|fI>o_uL}AKS>;*nCt^~MqFU? zfZ!KJgXEV9ST@i+dR@Ma4J={Gu=9j8(`(SCP)rWr-s@pp%NgPuZE8{4^kXe#JfNaV zu3eDPmfhcrS}u`EScTSeiVa8{$xptG8dOL~fqJMxY3FaCL6L_Ri{bmM_C(9ct#XuY z&ujlcZU02Bk@i^03d{6zAz%XSD_L z&n|`kqwJyon21WQ6vp*)^`S$H4H1XT>oEp6X)Hk{mt2CJ?OKR12d0P4g(^Z>RF9lh zC1=mWaL(^XOe6Z!^@}1X-yEDK%xfo;3&}~G!sHaAaZzz&9CDk_?L%M`K_9YsvXVa! z9|!0eloG1Qf^;F-Z8olB!NpbfPHT`2NFDzEHi^Xk%pdwZ!3cj`i~an zcPk<+NeHW!mAgaaR=GDEg4E1A|}5(9Y*a$7(! z5<{_%kZFZ@88SFQ;GkjE(BOnT28b1OgCR$TJcig{9>doggK9G#L%EWiH$UJ8}x3*3e~=>b_F717#ae>U`5+Sgdg>? zC>WE`Y(e)Q@|)Y3syn z4Hwt1kryy9pK&c^Lyj1AOXzphIO1L! z2NIS*ahS#+Y>}rikOF@A?Mv~)VIOKnSQwnf?4b!6CSr(n&i2FMNdr3Wxg0U_Tp=EL zVw(GJf{%=}%HAa4CX1xTExlM-C$+`yyW&4vBJPM;o9VoeMeZt;im0vf0AE+EwxYkFO3~y06ww3j1ox zaUJ5TQ7QcmzS>kmzB(}PYra~}ajoEyxI0Akm*}hE?JjA45^~m<>JE-Y0<D1*iv|4hZlC81pg{54@beMf(d_z)I#mcKrq9|#&AIc!6mg;nMLVJ$Wh zF^$3+g$G90R2$0MrEYEc^g`Vl@qts^V!BrD+Ej~yc98paZLn|G@&({5VeEJ4+hdg_ zidU7z7WN!*nig>yEeH$^)WQxz+ljudL|JF`ZC6!TI5Zf6vS=R~kb(Mkd#G=deh~~P z^N5O>>pj-E+O%_yK|%eR;g;mS?F~Am!1`d{o=<(-c#S$g9I(VOv!k@Nq&)I7!Nsp3 zi$O{t23_0I&L9v&I5s;ffKDaHV&Dx^SPJGQ%j_Z+!`q47&@5JFH#NlWkXQ^B8{~L# zC>G0={abkI_l@f&h{Yzu_F+5}i%nv725P0@5C%RTeFbYO_y-;-82e=~7>mXVDotXS z$&)|G)i;LvIJTy>3m{bO=3%5i`T5yextrIbn~xO~v1AV)UeOus+6UJ62FX?5{y~%y zlX>ubXh!>uVkt2hEe0J3%X5^)9Q7(i9(llr-Oz-5Xh$b`402zGK!GdK+iOEJ^8k)4 zJYI`>@Uvx6f~<4P0$m2%$V;+dE(LX-)!jplJ0vg-K1F>!=Z8s~1f7jAZlHpxTC0Fl z<+EgHm0;Y)<25)H!U~Kz3$O+o%-kaz=i&U+`!g2ACqPJ`Lntf^VdmXpZy&qFr`t0c9=e}^oF&^llzWn8zkN|TCiRj5Z%Rm$P%%S&l zb5c}?dXsYUa?upU`@gd2s9y-UKd=17n|hAxY&3tF8o?jHk*tTyUt9uFdF~NlemliS zv{AU%xZ@{s>#3Z`GgqS(1%cYh5QjZDUVJ3`Rs%xQM?fUUJWn{lTGiQxF$VSG8S4ut z8BzuB1B-1jm<2AMRD3&jC?CzJ>pU`sMH*t_@cmNChrWXc!9Mw*4mrX5gV8vhq4oKe z$E(~4ZLNGnv|Glg{(mdtW|oO?Lf-(=!Qq?pQ~#F&HDPbrpiR*t2o2^c)R`Fnc~%xJTjRY%1x^UJIEE6 zqOy(IYEYA;Y|v_ZyfxAg-#WVGS(&$ITUry^q-FZ1)mMNVG^8-v`Lf-g2zoypOwVW` zG9Ia*L0lGTNL@DC%B`((Uxl5*wMf0R22{wsY;s+Jmw;5~D|T$$ftqRbnPUAotIQY7 z0DPss&swg6$9ptmM(2@{EYhqKhatc3ps%4p3oXKt)h>$!?YBmU^E#coBjwc2CKsO8VW5s04B-*bf$fBZ{1B zY!WGaD$3pSilSQ^d#1Q>BroUQCgs^73|dgY_8#{L1Ww;#gC-8S`D~!g4Q_G*x#jZN#KcDHtKfWi zuj9D}=tn!{Q9j(*-KI~zGG?DKe?7Gz@gX=U zB^jX1%4*O29c#3NEsh8zVHE{951tITPLc_%OIS}6vR6+A{)q25(_@C}`dF*TI{K?Y zV&G5>yef3QL@w(YpJ-!6o2}wBr#Q~( zwa1j$rI$*aBJUJU<>Iw*Vp5!#;uudn?&qfVa?_4;*LHaAd)4vJBU=93SF`mS<5jq@ zm5qPi@hR~Epn74wGuASTO^b|lj?f|#9Vq{j_suq+<2|}zf||tp*7<6Os-0)$tG!b_ zkgs;I`W*RcUseAT^40!Y{jKuV-l+b+e6@f5e6`J$FywE{SE~=*_3xLjHmUl5eZJZN zMz|!1z5$Hzzf_@Z6^!tm)PM-`fDvBZlD@RZx;4`A4E@Y)t3pn2T74AHZBC~w0S3n| zR+({$Qp+||YMDf-Wi85W$Uobhj?^*U>;bwVlv^eZ$}KZfZdv!x+_Jmq=Kb8JUhdK3++*Ex z1%=5sdW1iouDC^QN&$WxA0n&B>%=0aPR|sRCm;d`?p2PILmxg+- z4Wgb~M#-q>0i4uuKGbs@@;(Ul+;R@ob0o;hsORG&FvnLw&s{@6&$SBZIq>qLC3zVO zvv_y|a!v!le__z`J+BfzYRSI~=J}Q&=6Nk=LcoX z^RqVDgBy|Ofjq~$m5lv21e6Y1r=_dGfaif1NdF3m)!DG==cExPV0jAmMu_MC3E#Bo zM41#N$a^Z<2jum7YSL@a!3dqof=luSWC-)zkJY;Ggn90k@le3Fwvw1AJ4~rD;6ujw zQ1~Fs^Izhi!6xbkOVgY}tZ%yV&oyEJScmSIu!+rqJb2fTCe8p4&N1ey8hCr&vZ z0FWh^s?x9mr3S%1WkCi2&uys+;JGDbA9Ddyz@`pAOO5`9o;g3cg|K)kk6fscfQ5>ed3+(qjyW9 zf_E+r!aLW_!P?-t@y@qkb8|4>IXD`?JKutV&;Y#iEqoa7e9L+9&YRtrgm=CpqU-1G zeUG^NYKC>)=-&4;w}N-xJ!}x(`3^VXoj>J18}EFMd*2%OAiVSHVKUzNfnmTqFCis_ z@y>4=hC2B3;+KE=K7H=%dfcG3@ocRta*?-pF8@%$OO_AiQe zej_qRTVV+ogLi(qV&CZs8SlJp*x7jJpI7YrydsEq-ZJdF;hp~+V?xu{@y;zk;gIpp zbFqGT@p$Kwf_IK=GyDrep8q@uc^>8dZjk3R`NBZ;f0*b0BbetA8iWI3%yUK~$6|;y zT?*N(|YBisnWo+CF^K5GPTq0r&2A)&*0&Kg1BA;%7={rJ9d&nK5j zdN60d7~FIJ1{p0J@_->Z5-LjzVV?DdBB8&YB)ugGJ($65x#;6@;X0p4)9<_rMhw3rNML({W!1jOPp+w_V0Or+)F)clPyuK!g9U^!27ggE7zlt$n?X@WKC8&bW{<&&3%J zgdxu@%8>@QmxapO=?oax1tHIo$!rQhrhg*lIg)I{hc2NOBsidl_X{qBd9GbO5I+Sm z&n>t_!B_ZfhVP1b9tdNeqa4KfUCyupHn`lszm9oM0Gt2JSZ)b)2GI~J;0zlo3CSx9 z0YPACMtdU#sTTk}m*oCkg#7oj&ahFi+~sYNA>K7~x=y(1zaf@$T_Tpda)b@l+*9ad z4Z@yd&k&xQg6(r3VB_B)cW#S(-1k2@j{6_QJb&L9#yr=4N6hn%5a#(D7}P~#o?mxi z%=6>UecPM^nCD+O5$FJp@q5HP?^Q^i3-f%xb6<^9#ymerHx0r(A5ER&TL7LD81;9; zJE#4DA$aGe2$=PG@Xiq;o*VCc%Rd+IJeb6z;GLU({12?|D|qLw(_h0oU+=8AM7(pN zZhzJ8zxp2pn2jn@83y&c;++S1Hf0c1*Zv_?zYX4bh~8B)z5nkl(D3gC?>zVl0Ot0k zU^P(&l;83-yz{BfOT{}Uy1+ZPT}iA5)}F=sx5qmV@(Z)*8$&h$>K4?<4njh<0`EM= zd8v5kMAsg$+eXU#E*U~mAiVSO--vgvVHLb{J@zZYi06TIsxG%2ytEB76t~52 zA2^)cg%HnmGIluf*~9s4gzf#0>Uhhv3*nuAq`D-$^PnzG8d>Jl^WmKz_%?XwLE5(d zQ`G*KeGTut#X)%I(^LYTBg^! zp7)e{6wGtKisu?H3G+Ne|FcuYjDJpi!jJcLL;id#`*>*6Zp9b0!t8h9FBjuc>MFAK+>t=8`3}k zO#%G#{rB(NcYhH7+>1QgOUFN-K;s)hgcJR~O=u5J!9PzU6D0ieYXj&2Lwzh>uK3tD zzvg58b*G98uTYvaX{_vHhuaAUeJ4m<1P=PU{oja#{`$AaK_?+?YcQUS0EcF%@P7;k zJ=lCMw14zj_W08M-(Zhn9CRYG{3V<76mZa82{H~kvX9QfK@UWq7!_|`bPEn% zQXuXH2%YEn_5GM90m2}_$T;Xd9z#SCX5Hc%OngGMcl5G70sp6%GW0I~s+w?_E)$sz@1UdB~-xUI!^F=I~9Kka8y&6;i?%x$rFg;T+=<|VOIgN?VJM?g@^_7tg*OYgUY^W`Xa7QI9m{Zc- zJnHs$b$hiR>rWbH_8haHnB#UHJN9{-drrU8?)|)N+sR>e`-x-6PJH;^_BEYHhqcBY zI`sJms-v-9@8^e(oj9sGcBa#QXyS+c#|}-zjZA;6eQi?Zu$k}v;mNJ;sCVw7JKLs2p)e8Q(nPI^B;YO4|t4#s*E%OR8I%{~vqr0@u`)?T??FJV_3g@Q4W5 zCc$7porYi~Q0;_(JnIb5ir`cwfgs?cXl<<)ot)T0g6UicRs+S}li0|katmlJK9~}; zlv3yvooQ{W9UqO;c65qXJGQmvxAsXu=-5s>GxvYz-p{|E8qQL^epX3V+sggJ6?3Ul z=IJM3pSmCgj%SUJXJ=?Q5XYA?Mg6x@Z+hCY<%t*( zeDds5pu$#bSy)+28NV#C)Y{EyddegsL|CXAE3uoy%Vq(X^BY*HmEf5M30IjIn2!8(^r zK%sJ*MiMoLITV~afNPk{`ybjKsg`Zal|;dDez1N}!pfDfUFBOx%C-V#TMt{7DmXo; zlguCjW8VgfQPCX88=86um%P0-nm30DJ20=hSOMq6>f_=w09me|&S+g%IM>-!^eijs z_}1){fSlL2X73Pd_Ay{*I*Sv4r3+Pz+!vLJbC*6en`KJMez6w|Q)4amB`*d$js;?T zwLx8%O%x#WdbrCWpwS^I>czbUS_JDS;pnu%8cI|>H!5k@)`28-ddI1p7FKt# zbDm&jjK57wumlYaT8%cC!@vl3t~NMbNN^N$dj)X`WSM>C9*)9LXttM;D(%iMuym4O zC#GbON^L;F2rSYpwVSjA(@+8iS6F6m7=h>ME}}jy?w3T+-eQjC_{|I#!OV9>-4}Cl zp&!91yAmY};RrF4D=OWOnAUJ5DnBIEA5N6cxUzR@@}_f(xcx$~4tBwnQY{g@xg`9F zvUBRRhpGsy@+%?;?8%jIrQzHbzla$eF664bPH-}=6r9__j+mj-(nqZTTHCoTyhS{t zR+w*v0z-&YFmF@HXo(OI;X;i4!PN&wyF;MvpTp9vt?YCb;m+tJf;YaxAXw_S08!Ds z`8nxHx!S4upcK*Gkkv^UTeB5&)o~prrY$IYu7sG8Rx~4N;Z}!4H1PDP9bJ;CMs2uN z8zv(lGzc?F!WD|Stx1P+h`BlQw^nh$+POsm1ME{F$OxRD^21Y} zN$SoS=GDG0mhlArfe`6%G!$N#T_{?}B4=&QE}Uy9>FA5XPKls6C@TA5iQdge!J;SOXaSZLS_-vg#GkfB zFUL*^9Dy7TOuxGn-#1fr?qU$0`V{8cxn*R^)_g6^?niuq9+eiJqB_?PUP8No+s-0) zZvnF#NII3{Jk592Y#Cu~)l>W==GM#n!ztgg^7gP?&ukgNwzed7N!aJLp&IQp=YIZq zN$45Y*|)_GZFrY9%sItZHay-NhI8&^Z0S6{#o5C5rf}XR z*cmh3)M;4Q8$SabA>;bxmXSBMI3#e!eUNhqfWlF6h_Wkv%ZO`>^DVk^0B8n^><(^W z0b7IobRS!Z4}DW{NO~kl*bf$JLFWRU`W?#&;8PM-Hp9JK2($|nVOMQkdw~Xxg#)NOI%p82k%eAVz+Nm+}B|XGBF$KtP-J_e0LKj zh*!jmckaPVNw%E)PACJz^0@c9_*+Jv0akfk62App{SiL0j741iSNwN3&*2=#umSQ^ z9jaBI)xFP`F_8uYv=za-@Wrxj*guLa5y>f7s5|Dhf?B>V1uN|=T-ckos~o*@Z{nlI zLu-SC;(RUdx-a+6M!bdWuA|!%G?TpYEbfJ=oY@RhXS^-Mrk&4%!#%W6>8UKNOgn!E z>SvLbbf6{C2O1^@M@uAQ95KW7hsu#(Y;pe=-*vKbR`rcQ7Sk zM56^n_fq>J?z?GNMM*CK-5Aj3sTUhEO+h)FTx7enMM=?y_TDxfZ*nsBFn;ekLU6T4gi)u6(BBmkc8%A;^0Yq5S z;~;>M!i-w~+(?#UG1angHru%bqny1qvayY#Qko9WW>brM_b$FG;&phMZ*MDUTU=m= zt|e+=P&?aXcML|fnQWxlPL&wi8XCxa``!>i_qt)|y=9v)hn8z1_l6QZOv8W}@x2iO zL#rfs-={6>dYDcF2A(Zn+r3V(nD8g|fnv3KHD1J9T`b<0 z(H#s0&Bg{&*6?QyogEUsb-*!5kQJN2bMN1`mlhO|NHWyjEcO@&68Pu#VhOvekxux9s&n*cJG`pT-=JTMLfgtN&_gJ}D^|UW~(5NFAYbvok zy)u}CWRV3!MZ?h|K?tj$OzUls&OjLDanRXGGo%Y4G>8h1jAqF@oAL@c(??CNi*md_ z+ym{D2x}PO%<^F9fRTAgSS}OOQR`QR%+OIASBCiMDDBGU?yZ6t-?|rrv$Bl9k=4N? zLZx;dG*80sSwBKE`_+L8NQ&rpO zbDevo0cTAC??}a?CUJP2gNfyB{u#UEF&g^pOKhu zHO;jQq+8SHs*|Y}*6G7A!#z8K$bwPX4SGm1H{Gh4!OT1GEh<;ek7mIv6A_LDsj)2k zuZ}~jfRvX}O3~oA2|yH}aWbP5$H%VY<#tal*K$E_O%IYQ#VM4W70px@kLjs2nV8mf zEV!`Yp(o6dEdt7LO>Hv55N)YR-DWgoUtiirWnV|*vo;~%01L8?99^6qnHDAQ4r<4{ z-eTylcm|T++COUuj1HJX4fbhNGTj7afAuV2DWa%?T!5NPrbixh-PHZ|sqN3y+PVz? z5nEd)F_?Rase}M(0UO;Y3_nsm^RHkSfA*9uB}8SJ#Ll$6k%dKuEgW^6;RF}!;hz|O z2YIpZjk0T=_+5X_oTof?qaVXwid)1{r1U~7fd5V~ZzptK@r1`E7B7kVl-3f|jo2ub zyzrEj!e*M-m`P}*0wfOA*8N_qxYnI_@xDKYTamd8|ga<@sE^y_{uC^<42H_LIq_DW=HsC0&t>B`u6_IHyPdo~LUtxWi4&5kRC2IyU23 z(myG0D31kejt47dQtA>ano%aCK?wVTG0`KeEdq$3K|7_q8{EQouJxWVj*71p7G95; z(_3O}l#bS3Z!8g`pTgSf0EC2<2*pw2Xs(>GNs?vC+Bj47`YB1n^sB*)qo11uXPCnR zf+L-dStA&uQX^PWqqV#YixL`)Vl!c!&X7jnqb4IFZ;~_0O<8BQ5Qf6*Swk}yylI}A zm6CPjl<>U+c-1Kn_yob?y&>H5Z{L(p5lKA-vkqvq(;>GGDNmEJ-JFo5AVK$6I;UpwaE4z$eb=89*6Nfrc zFP03m(v!P`G8cw#D2)WIhaZ8V*TyI?>^B**-+E3A1`~d3_&xs5`VBC^@XdnohO8q5 ze@XPU?quqjhpfkfd$UvCF;TTgsOFH_vx)4X-cx>;d02=VJ7cHX#jU&+zpMs~P*YT0 zmg&`mbF)%f@1{1?gM&+l7a2VC@S0!=boQwb0{qr92b?8sLne(axgD=H_0Hj4dh)Cp zT5K?wLQPCf9PHMGxeyy}VpdP{tGrsB;78l=%tSYGMM%%!qnYk+Jj?h)pY=c|;q3GP zR&i#*(yEyl!CBenw~R@Mzznk&io1iL2X?*;zCjKXEWuZg2bU!(PE(^&$_k=S>1L+i z1(P+OeWHdLo8R=pbdCD#^|OEOHFU%t{%yzESP<=q5KKk$=1s$PahAu-%8Hx$^MN^j z;4QnES#ce;*FI~gHN-;3nj?_Dw)PrisC{1C0LHxte=qKRWGq84@|Lqixt=$@mO{%< z)@-h8+^kRqG;UkKyBHd5Fccb|j+IhD)l#DFh0PdGU90Fs0viV|MSK<;yqTC*9m9|K z+ECMrrgj?as5OEvp4902f(tiNnm2Cdvu5MjPO<*5hm!V2GYLoRw}SC2VRmF(`E*7Ock7?Qr@G z2D3Vbx`bRa15}xiYhu96!wkdRdb2J;)6c}(8L|$Kis2X(C*%@A2^!0F^~ z%zr4AgM4t#qRpC@-d_4pW}A31)yipE+z}^~wRosKy{%kiPg*Ri6a3SkJ!_bY_zMKf z1nrz2hW<0p7W|V`Q<_b9*3{eaiO|Ft=0gur^P4k*y`kJ*6C*Jn1c1MW4|`#{3+)AE z@!@=$1p=>)Mm%P3-qabgd1j=4Y{X_bqf`|rN9K#U9GgbMHcR_F&U1cwxCgRy+%NX# z5yUB;k+h_Qo2~{TP-3*VW1!h!koI*1ll52C`L4BWJcq z6^fLmW3_Us1;?0bN?eEfYo(nCjBmV$13nkd!-OVBp(#epIB-+W8_KOtxQ?uhZeoa@ zVn1@ZiVNb{FP~^&)p<5`Yzt_|hw(Fl>gfB$Hu2Gdx-*-qqXS(Pn?}Ccr2m5-yjQ+F zcv+CZQbG3-Yu$%8nrgPiezD2SN^0JucpyN%UyO!`bBG20i0OY6BXrxQ@1D8#>rJ=M zT-&ng4ri{N-1I+i=Gv>9{-HD1+BO-Up-eoAhvm@Tncc}93w!e)%3fTX{h#cm1>rkjnzy{6cJX7)<#SOaMpmGq$50r=+}+9Wb;AMY zV-`LRkGg_5j+cH-9SLwy1~?7a@es!*se-+BD7+*0p-j8^r(?PyFd{YRjyRry!*>t( zuOYeMq09#OkkG&^h}_NDb&#=}(=BXa4*NAo$QMvrnMXc7HG4CubiQzUq(TeKs1u2k+BHyF&POJQ43RgX8Wrwu~I>VG-j z=Zm)i1jc}J5FEnyVusRtqi8sgope2>>2U}XS9C1MExqDR`e+=z#&W0uCcN`b3(8(9j3Nod?hg=(~SV4q2=h z@{_hrFLbF_lrbz?ux#(#t~1hjxoHy ze?o@Tp9X;TqcK0hi2zhhDx5k8X2ytx6x1W3*HJ=~G`;>hPd%XWW@jmm${n?Me`*e=} z``~5%BY2PWN_`)-kN+;bPuJgepU7?e2)xhzV@OnN zaAY*zXVo^WY7Fnwf?6@)eeV7z@je^Ai}yL!vC(*+-%;Rq0J#x{+_7;CxzuXV<9`F* z=f4<3uIle&$Q`8dKL5=y@qf|WaAex^dN?Ck}91m#W+yv@%K!G1zl2HpHmz{fJe3(UTZ3rm0%_ zPhx&<^*ZDKAM;Zx*$E~&7UcgB=I6zK0Q0kS++SB!f5%<-d*PWi-viHl=Q!6f&gvLG z^S{_%_y2u={j2{Yn4iD!`nbvd`hObp6HDSh20Lb8B-MW(%>C9K-8l*Llk2H~##w_<(*g5#v&-`@qt48#B`009Uf%umkTe+=_8;`=c_ z;UE`;ld1U|oJ=og<9=&WT%sHITZKN%Pl#%Mnp{30b{NkBh^ap~LKv4L&`&`7LqWw4 zV}9O6xAp(Un4dPKr1ASPKN}I|=gFXd9P_geVSZLEyp8!;rTHPuPtF}MKew+NNndvx z^YcIGSmmF_{M?Gj06c^7doe%PtQ(1;%Oy9Uw6`%oVJFRx$Na3~{9VA$MjG(55zU~8 zY!A>=GL!K>Z9cruMlarHBN+XE7v3lO+BOmI(;bZ*kq_@PW}buIxjT;cxp5sFH~J&- zKI!jx1MV5O@(#yZX)^y5-X|glc%SZjfZpth^Z;fVn6iEk-e-8po!~y7*M|cnrCdj| zRX7IsSrr4$&Ik7i%hAT+K2wDll<-}!Pr%Rg(gv(g#9Zy0KCDk?h);!iF;Z^{<5-{a zb!l_<|3s`$T95tufLnQq(={~1^nn6^_1Wmd`ke8Tus#tz8tYRgKz!zXFx5+S9P86l z@jY0d0Q7m$$fZ#}`?<(f!q!_K#^>{T4)BL|DQn=YiWI{*#;5#6Bfwrt0D6_i_(b@g z2W~c z{NKU%v>|-Y`){C6UPv{A-h!Ri5WZ(B8v}Gt%hkzhb6@>dDR~}nOkoFdZ{ z?bC&+BO1JuW4%#Te*?_Vhu!(%jsDX&=(S_^ofV|50{oQZxr$yfCdXrUpuZ}ny|#j^ zM=!kV(vmC{u+Qu_=mA-SQbhAeGy0prgXd;%LRdRSn$TtJGZk{CDX2|K1T`xG8ToMc z;W#fHavS~r*C?xrDK_;QejZE389Ta-hxbz|BV}^bY&ZO8Y|@hz>WqNIxkOl69E0E+ zY7B~Wp(5^eSPf`Mj@4iDC=v};iqQ-&{W7=L90F(p=XFnPIn5c`R*KfKNlMVIcgY>P zCyPF*+LwTa}OdDSN^H?&i!VqUP zv>FX&N6j`>pyEGcfqf~RQ%Yg5R!*wFgcc(bp*~vDUPD)}^Aiuf+Le|C79;xh0fQWS zABDo)6gJTolSrt`&Abn^&e zx8RL%Khvz4p?*YY73@9W!3s-)XG!m#R&~RJS>B3xu$@VEq5OyyNkj!wEy^DoUZG+V zthAuO9^4U$lhhhWV`(HpVY%Ws8I>xi|4WZ|vHd(drb!Z$cU3s#nCLJ@_*dTS@h5+F zA0o{&Gt9ys2CTsR(sQ~|${H-#*&H zv$PTZ!~Q^I5b;OXxwnijADvW2$mB9)qrNh_d}R#ZMVBGl4dhdC_<^s{P|C-Tk{?ej zrPEsqk|QU8JTtkBn{y}0;r?{IjC*N0d}X+IPA=oEN6EJ)mSMYHhL%SjM`c(JBUQn6 zA@aiHGMpF2%lM^NR}a#1IBO@D(e)_VHL;9ePb%Z3$z=>qE<=CjJ7xIf(AP{Zqv27q zVPY92zA{LRte>o?uJ07^p67HXanEIzuc~2Jq`Mi>#^8s1dLqr7+cdXMrn!4EO;~I{ zMw4b2XgVF^G#{NvbN+3bWs_-|Cew5eA)5ChKF4V4X?vmhTso2F%-b{{o=o$x$uymB zAez6VWk*#9e9CO&d@h_wGw?RepHHT_d@@aa-#E=NKHb)Fnu>`uzgEBFlTU-TN-PVDC4qZfxBm*+&oTC#qB%*2uB%1>nJiu5!4c0|txfBL#?O^?~`#~r~^a}G* zTkMs!svrxqASm`PYtw@=*s$C$q##JeOsi+bezvxNne^#e)r|1Cgc;yKL{1DA&&w8K z?QH#0SQw7{>xH#OIhJ<{b5IQOWyB!)(b`rXd1kHG0nsY^HV&S{CWQa;oc?SWCuR|0 zvVOd&raNXJv3Dq`<7g6WBDxCx8_5oHrJx`?n;b?I#$|7qAiI5Ft^S73-J`YXWZ%TX z&ie{$h7_W&IfADNKO(~LX8jok?5@yZc`+OZ6)el<5=LbPWaczbIp!G zt6lZcAUd`p6P8VGJaZ%J=JyGpT!t43*nz+}_~$V6Pub&t>9p~m$$JsK%rRE+PN3)^K( zOoOV!u&ws2N|-n|K3JeUcEE8=?ap9uZh9QYZ#qR>C50(<{92$1F^AW!Ir;)*6%0`$ zj2M)>q{OzBIHrY}WF@kD!&nX&|NSt)RGOu9z&dp~H>4GO9uK#?F$ z;3*lniG%}=$^H*KSbA{Pd!P?t3LAfF&AXc;n!A|Q!jk;;x zAQ=3hLa{-u-q50%!*3cy&GB3AWyTpcY6bdsY$y|TM$<=I0#pC$k!)Q<>)qwcW0X#d z3dK|B(XBY^%2+n2=&wD*G(tcfswW>`Q&U3_;7B_x0cKa8TwuyIk3bO|ZxQW0*-DID zy{5YHzJU?j{K|pqY20=~AI-=cAWZo+p@Qc2|i6!=Bk2VQ%5o2Y@brsKG8(p+@qc*{<)krBROmOsBN7&Ye+dV zeJ?vL4E>v!WYL7ftDmP{!a0HK2+M5us$;{g%C{@5W$)xOarGsQl6E;A-cX4_2Wr}E2&aW zS{@e;Zb-s7H$3Rw4m?$gU8NWS=OCaTz6<<2uD|HXYvZo(OEEGqgFcA}M*G=P>=h-j z*SYeB+N7v>GC-Xs&foxf%|hsVBV-pii}-L34Zk2v2SsLv5;uF8V6=@WGRjSvs=B%) zh>;Pbx|+ZOlMl|gsyd$+iD`6GlwhB6N?iaFTk_Rv__+Z;bko74tWem;?bFR);IX%@ zdF>2rrX+MWjO>hB9^Ha`c7V3Ap01ft)1)3nmngI3%s6S(W+%{*-+_)B#i_p9B%S-l zXberJ(Xj!#2b!1ZUK#;c#3Gc+g_5?;fX^o(bOz5!PFXf%vm4PJS}s9|n* z?B)~c7F*@bH~j`pSq*S>m9;OFkWYGI`4V)>Aybh?364$!n<3C29^FSpShBhtFMGUW zK_o4dVLBflDja!vwd>{8UG~T9|Ft?mD0Y)qDsPz2cb_m)TVL&F^zbs1Up4m3{AO*{`ptcO2%1_KnB7b|GrKR%gR=+l{XqZvTG-~0OWfsEb zz-yk?b+d^cMvIiRAlU%hkY`pR8Q|{;X_J2=AxMMqqKI$4~-SM~+h#HpAGz*bue@n8?yzepDQ_+ut``2(9pdOl&Lwp1UQ zGE%tORk*r~I%+RmtzUJeMcRSrgJ?|0pqgAv=iNLe8yud1cS-$Gzw-qQ;!NjDcudm? z^Lb<7-Qcft?>3!)?S#)GsE*&)D467p#LyJ?K9YyV|8fYKUF!)?QIRousavJK7+`rl~Q#y~9ME zkYmLC=I6VNV%}SnUdf$Ls98)%yG^ z`R7a6!jaI`t`K;(-p)ix-Fa8k`lP~&YdJxyws)`0*j!b~agva$AbQBPr2z9Mnf);k6SK z-qCM>=KBf6k;=fk6F08Uy<2snyr_(>4ym0nUMJ_U_1XZh8!;(GpNL9$TnGSv=gF%P z*_6-)HQ-hGFjyhymO(khjplAVH4ig3_re(zySnkJhcWB%KN8^tubo%>(ze}v$MM&w z?c3mFh^A2M8~3c{8O#AE2E>MEk`9|7c!sI06O`CGe728*DYqVe?a}((g0ADQb?mFB zs0|KnK(k-a>}k7#r;H4(at(n3dhK1S+?p%46D59l>isZ}Wu>-OAHw?+AZmK&4;vt4 z0n2oWWv_Z>6N8=Y3{s5LF>nHGy-)2vf@y#`CJ~~(uO3d~Nn_3!=Js$Lu252hlC?AR zfs9sRKqm^8oxk&l%Kd0V?cug_^dWFe-1;1%@(X2-e}G-=ybDsI`6Jn|CohIuabFVb z@3riQu?GibKI6#?<0#(f72RYL&n#kCoRxoFp8^~B!%>u^IA{P0tm*jl&x}=(_c$8#<*ROn1=SK$Oq-Fa^m(2#f~He?Nrs1oT_!;*1>3SA*)=4tGev-?a8ZTGp|I!f@mc+3?oO--CsdX zf_8@cYb;;5BrJwNex*;XZ-EWr^!X_N<ULte41DP^fhAs^LbnzFk(gDk7{p!7Dw+6-;l(5axQ0VQbsJ@kfo<{X+S+TfCC zo;C1p>zf{H?%h_P-C)hVM_}r|>?sMks}FV}dk0K=JsgOcPK@6l@HBnUkLCouYC(U; z6U$!ooc@{!(MYGH)$_AoM^ge&vpYPA_obhRKfq6*TN<4eX%%9j^z$VwoHHFuk1Jtu z;b;LH%sp_18Qte0Ms$1fGC2b$!EBGIVRj7+jp^JA&)7x=o_;>b;d`5BVy)d}LEIzH= zlJDo`!tH%HoP&^mLPKp`a)7anrFogrLS{CCSAY}BYTv5gO$^vGEsOYutomK7$J6VY zgDW(BY7=Qp!upaJ1kad+LWm?Lkq*7AZ9*?g$gQr>$^EXat|=N~2*2%iaxMy0QSPa< zXTgj~yZ{$n4J>yJ9N?s(wlp8$NOpkW3s_6y@YK1mk7cZ5oifr??%G}6MMc@0%AGey z$4wgI1Zy-lAyDY6c*9$_`nNn28W^0#sec+#oWYwF{9VQTfNe(TSBm(~2c1Lyg_YM<1Za(TD`-q*OU8 z56(bhE@Eb!`2Dee;w6;(c+wi7p~#7*@r==_Sl;K4Rhf%I;v8LLOw!~;X* z+hMspLtZu%8%26aL#iuA zX|Lb5#~byi$?K?3hgj7Y3o0d86thUz7YsoJwDMQ?PZ>E`<~j-4qwFWk^n;@v4<~g% z?3pYqypK}CSsX02LIKVr7Uv zN(cn^GZrxkX65y?IJ_zi%cWzzc!>25mbnfhp%0eHj@=eIyMZ!7!yJ=Z)a~C#w|3P1 z)=en6w9erYyLVvCqCnIx_4OW6jbKbfOxLGY920lB#O)keA_f#-tjKYvVLFDy*gvVc z>iYj!2+g%{!%(Q`AX~?fKFchuH|*-3YxPFTmNM6~v}!D6&hAmeak}4mUzj~a*$B*k zyxZ{)H>FCwCLxT=GmD0VC|MQs2*I8&c+$@>_RE(RUC?D51m26agSmK=f8-Skg;;=|atqkGLU z77YG#DePIcx@wz2yO5F=d^gUSfq`Mi!}uw$%$0}KpI0V( z>9+d8t|zL$ME;1++2Za^o{0@cBVnL;sS;}r_Ex}Co_$}B>mNq*_|Wf19w~D@Qr6{o z(4JW4esOe|31N`~dUr8;4JTg-;=q>Qr(6+|*94pL7xX%(Y{nE|m7GwFfS__@DA?R>DaZ4Wt*PBx*LYg`J#AC{Lu zXX0>=W8&1mzzOPHkWCiiX%6BlUmi_h^uu9|j0B}hn4p1Xd^{~k z6hD^>ex*LFAIDI$=0q{4qL>18#jkp#6jlo(5g>}hLjTa%ODV7sVU-{5Is!4V6}n#@ z5nj8!zM03BYv6nxNF@1VDf0DnT8PgRG+w1hurl-*J#Udx`;th$Pk7(h6FJG;yTQ#E zU-lSvQ_LsKN>H*MPFO=u-A6C0o0v`z3y6*d_25OV1NgH9PpT>&Ntbq*T&DX16nu7<}@KpS_(rYm9*)kDNrSkcr!jB1Wv@081-@(06l~z%jV{*;JyKd=tg?MkzxSioslBpl>cQ(1gQWB5snxm{e+5?8{yd=l%LH zrVk*RkGHc$kFyEhFwYjVtNR|xMp^xc_y#{XaHaC9G@XD!7Ug+$8iR-kH^E%hrPZde zWfP`paf^zcrkyC?5jN*D50)QR^@+!Fe8f@ea+E%@%I+wYJw6I0gD%@y`Ul}dJDhhJ z(2ehV3l7|zwX0j)K^Hy8FFqllV}Kf%-#d`>MkBkA^1RVNfLr;}(;dzMy`l3FfQC}a zhT}<SMS;?zzfEZK%5sD#gN|T>$8n6`#!{7!b%qRQ7g;`_D6`0Jqra*em^*ef^ ztA=6J;oVjsbIPN#!gn33&+d|-j#208wINlmC`fQHk_Z0mue1#iOcM_7jb}M!4ZUaA z5#|Co2i6qE`Nkvq1`_G7L)^>D4}|kHgYHI)D&F(t@p(OP#Il|qzbrBP+ELxG^$)+B^OpG#Lg~Fi}P2{?NG=h zU2Nz9AW*ML#vD>k_I(}Mz(#)qHL)b0^CWoyDCnMpTT^oaDpm2}r?(z(^nd)q=YWUd41OEv99_WM!9WqT? z{{ag(Qm=Y0#nHtCT7q;%4ER3iEhkWg4>8Mdl@#hqS`~s}PwL87ZegB2sS2d|xpO)J zEGas@KY^pd6GSQ;5+V|TKnM&15lUrZWkF@!O(IA_KL}skf7k;u;CaX3GYFh`>wJs0 zUsy0U!y#qBR~%6od9-^Hk zn+4Lt2vtQU-j_ha>~s|KZif^Dx0DtZa>B*yV=%fHm>We(EkRWhcmiYeaeSeF6e~Y|-9TXvZ z41=$mq8NtzH(0B5Xb?`b*=nZmMP==_B>D-R09`<|Ap^S@d))25w4b#=O1vB>E0%fO8$RD50zxYte|7 zVq_&M2}<1TEfJM>g7XMpR*Fg#m2=Qs@qW=D3v#+kvDP?IBNMVaw_>fy`x>Jkf^T0% zHoSpplQslNrGe4M1g~+H>(spg^FoXrpwb=`Jwr2Q(sglKT1xNq)#F4hj@sXRR!)KJQX+;Y>$TW zzd$3yZl>ief`GeGbcdqf?jXx{`pG5qq)Ud0zQOutV3sC`3|=dQH4a=DLdqDTKf_ao z`7L=ZwJ42N8c1Zz?Jc(Gy+Cz?@zuS|c8Gc@vOSLS02-a_e1MJs3FsGW- z&T;@cq|g+ zpjz7Y==nts`#aPggMRfR+xNKtTw_{Pg5WLVbv#mEx3Q$LvDQ+*#6&2mYl(9qB02BLJN)hGMtPSU)?om#3dCeM`E@R;DiWPeyDXAku`>?$%9C2D1h64^SKYXa-jpa*mK``YMlC319^sR4#lFoz7& zzq4$Z(*tz$A-S_z04P zjYxsnAX#ww`a813V9qIzfFNB&4H=9QfE=6I;l(hQ7JzQ&@Q?CoDgLU3JD(ISY_eaE z2v0dP#Vd>R=@qmrpQ2Q>EHb}GkSuQW;Lfs;d-MrBpI*Vnq|~*THnJ1ZwItGQ!dE{F zaOBx9BSLckO=*}(2*?=3n=dah==>H|AMg9jqHB@L15;t7=Aa;{jE%KMTA+`02Vt#2 zrxRNuozTlM$zDVW(MJDJ--Pta*MD=n9Wk6CVD-3@jl3{<0Hq%*s|Hq;Kv^{w7=xI@ zpe#4(aTGC(kqlT5*MoXJVE;2HrTM$1cx{mnE2UA>f-+5kzD^Eo;Q0w!pOJ1ccK{1$YAj> zA0{XTSyiyCoM)0&H{MXm6Qtw^g^-Lk-=+)1 zAUTR|n`)wAk*1s#9n;F9xt0P~!1i&0qd?Axol%si%xNlKnhVGaGRzo+ zNg9i1hN3yg*)`;wh~^x=DaagSiZmx0nYfv6WHQZRrpF8hmN8R8))x1|Rt}!w>BkAb zeh3h`r95DiYEZz(6a$%*cj{JC8Dz5z*qG$UMexbFPFuXo#v($E8c784*8V{U*@}WZ z_*kS7551VQso2CaTccUva!fnmVh7CbEy9-sp>x+;gya*5aU}GZTuHR=dIs_7tLLGs zBWsFXYl|QGm3>VyY9{%g!^BJ8e%gV2OItRE*-MMb4^X)P6M@kujl)rNfmX`1E0kpm z+GU&4B5jK4Iu<~dBaK@&tLkAUQJEL_t-YX_97Y)t&3Z)B{a2bM%rZh69}i?2RKTTt z`!9;gUX++jhWnvXIG}wQ+QR^i-JVuV9zn12*bE3~=;`na9%y+;FeD)DNAu2OBM%h2 z9)Py=raiIPo%Oj~gI=L_<_&_ti+u$i%hE;%NHE6#3q*R8@+*p63dsLEdrYxA?Q@B$9zmajba1lB^?p$obW2+|Rkx?8)<%Ihu=$mI z1?#UF;U=4~v2mCDLmyukbv4Gi-9^=hvdE^Qnew2zrlLkGxo1Ui@E*i+@$DEG#gKH}K8xF{iblJHF|*EE zp?o;*)-O7`X8T#hO!PD_FD9kIR0~gtp>B=6vZ%3*+=TQz-fqaJkdUz-u7FQz%|Z9X zZh*?9XBxyGxz-oKn)dZYvaKIMYn%QN(%E=E5p>~FTr>a?JLGQ-w6833hJWOfe`Qe% zPxJw1E^JVVBbPMT@Pq0HIKqQB-3#@tRcRqM{hUezK-x!+2*_kv*%(nNE|L zXUE7?l+Q|G@HX!}i%dc!A*!>OY@y`Y6(*RTP7q6L&l-i2`-)=Z$T4F^4eTw(VJV?e z!!l~vMh(ZP;TkpY%Fn3b8#MyL7|nn+J5wG)vf43GZU8x}2uKCq6&qcoii{7$tL9@w zOe*x&{Lva=Tl(3#!lda%nQ?8Vv*|)Iyr?FnJCN)}r9Y4N&w|Z?)z1eE=uAP?O@0Gi zrpW3hJasmfWgLPH0;7$>wgx1vKS+CsXY32LsJeBC^zBz1^eWWYH`}7Jb)i>&s8rKg zxsde0p~el;k{Ch6`e+6bC`}50fjoh(akwUiV5|*OHniJ^_#7TdDMH+b)){2k$KRy*)l^OfA*=0tPj^{xhVOb;2NBA9s2z7v4Eq~8=jSMusD?rM z(aDB&9e)->x?z-V7^Q>Q0qo&*#M|jpBu1w?2E?cj#IAmn>KIBz)*xj-Fp*@=G25fp zCDdh*WUtPs<-itISaVep#+K)x#z%yH3EL%k@PUeey&JHE!C)3QLntu^YuY5v2?JQYOepP<-gBPuKB1zmP7)ygKDP||#!Xd#bS4XSrgFH=qf z`5#E-Un=>rcAY{=-9VH5#9c#w9C<Q+lIUO|Z(~+@8okB`=vs!TH?=KTUu*En5m%Z){5+u*);QQV- z_(47%f-P^qJD};#ZBfFOP2{=3-_~u@ky~^PJT!L-(X@A`CVIYA2QoE;($B-7zogTX z7+L1i_lroF&XqoWmm__zr1kwXq;De(2(<7&gI2pXI+k3mGfTkS4uZm&a^dvRgGxL# z5+ievrogjo=2I_l} z1r8s(QA~f)E$i~dRT34_nVK#fbkL%NSh_XP+d0C#9t>!`wx*|Lm-}R&g=DAa56I6^ zB=@(n-%HC5)BZl$!NMUC@c#TZN8c^)vc`SsnqU5$K52) z$FlxCx2)M$zf-+BqWOfe-~>KnF`bf$ojyt4PxE<8>unPZ#OEzkJLKzktj zD8x{wU0ZVm{Oj&zphPb7Y|9m1HyXSWM$%-y_0Oq1Lk8508?T#Z>C8ck20 zN^1VD4713MS}^-=yg6JZ6}-}%8)+0&&c|ok?txD(Z>d43(lMdnTl^D1Z){r28=9c` z2t~yPz=?tNY3}wnSd+9ElXIf!!6HPB@DYkkA1hwU!MHje^j#^milJZgUcmFI zcX}Qbh;x!LNj54JI_e~> zu$KZ8;jl?Cnh`CGmh>=)F!y;+3q$s}dk()P*tx;IfbW=r%Qm=)(D*K&Q4-T;9>yUK z*=3T8Y2O7WUooM@jfFC#1b{=`bbSi_yoVm3_9W%>$r)X8fvhe42xFO^xqKR6kx5kR3POE3+V zt~gu@{Ws?$9_(@{z)oLy1k{A&aX)t1Q4A)87T!o&y>hf55%$v8lV#9*hsH>TB#d+x z!UPAs00-`&U)kZ4=XZ#9r`0FVb4VU5El|v5zq}Qch-d0TD%?T$oc;gsyF`@z=4t#1w>$=DXeEe>r z`JM0M_veV;`82=Gaef&_EpFDD*F`5Ko4_}T<3|N%TQDIfEkNi%3e3P7B=zrat5Y{<>qd9Tj#)SUf?pFxQfEswV$OgGB zs3DXT6dLHj=rcb$EJDjJx1Y>9*28osyV16Y$Q7${!I+|=?dE3g=6*(1`UaNc;dtL*1lV?+W1u-iq|2ugm^vnofULw z(p-;oW?`|fdhfvY{X9gN{>XXJ7hKUpY$Fre#xEgc2{K2Tu) z6=t9Aj-y)XtoG@y2I;Pv*4;1eth**!cd}czd@(5Kj^IsHohji<w|09Qm^Q} z25UIThgUe{nEQdHbiY9R#M|!{!8?X*!Gw2YIvQCA29v2POrh0*0c6Swlf2qW5K`1M zk@=xn45jxQ2vpoMp7`NyiuC&I6mj*Av_7h`2PXf>YNW9AtD2&_2{xKH9eqZaZ8MzB z5UP_6*(Sqiw~$zUxC=bI3?vH(w^s8yIlc*4hf|e2aYq_ruis(9s^3_2! zs)H!H4lbjPX_Eay{HZ19d+pZ^b-i6jqIL^|(iaYwE& zMn=wBQ6rrlGR%fiIIOfl$-EP9-m;~|^ky4O!ba7=qx^|zFQ$v zL(hy8V(p1+1d*RDr=4nZpubca6U{`vR`U6B__+)}blxwO0pwY4s%YkrQE~;ny$C-@ zWk8$6k)42dN0VQh4Ti_jKC6T)urUN4z{lY+9>^PBA}HB2)$CoAZ zAMr-YG|%Y$AD6q%!TVABAD8RT(?OKC4D!9@pllN_iZ^BCgXOLdAk8cGcbCh~UMAl` z9MT_|Ar{VH6bN-%9FZDY?m7v{zO)Z5cb>Ui5=X?ovmDOA#j(6V_Vm$`

    4mMTFK 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�kD!IF@%OOWGu6)*!Hnxc)bza{BDVCpG2{<81aqw{D;V zOS825@`>c9Rahl7Ycy%8=3H8~WJ=w3b*viaVXoU%E4;d)YO{TI?aPv>FeaHb&Qx8D zwZJqY&+OhbYutS(`J9h%k|2a3=QY77!g~&jw1S(px|zkYby?-+R}E>iQu50AUm2?3 z5esu7P8u`~B9w@0Qm`1PJYf@r^=_=sW6c-WJBl_IcT3a*o1fPmjZ(fBhT5gQBZ;_b zQ5IOtbsav9v^;Lcoo%SeD$lQ~ov%=Rh8rt`afQPJ>S(ocvC=-bJb!lid~Jt`RD z2VzY>K*ZoZ<_ES<{P@&66W1qu28963)+W$9Bovcwg;jvV>|xG(|{A2C20q7-S?EWNKZ-Pr-{88`8}-=)5YN zyWvu?_U)QIy9|Pq!;-PP4i6H$lg0iAA(_>c;2K_5r&Ltuf-mz}wY*izxUgpXZ=yK$ zO?sD93Aq5nFQDj@N?lSJLbtzbc>8ti&TF|0p83CVwCO!kDNaQM2BIdOt*R6rU}3}Y zM~VybefP%XZoG(6q}F7yEsml4;w@BGf3>ZsUqVIsX0*6Lp7Xt8dkD2*>ajsuPzgxr zx|=kMMY^G3D1I(%912kxa#|RM&CHyGGQQbhV6CddaBBHI^6nU>P{x>Lw7#7`!;S@R>tPtu+fH$ps^%9) zY2$xgYSk8YM;eN2%(-%Rv%7DN=J8dR*Q_pW%-mRfl1)6y8s5Ww!%cGA!sNB8Ocp79xiV5k^(IDg`VcAnq2Ehq)`#Fr&sC4TBilr`*#j^K#Z*mPT3Jo964(V!|DwIQa*x5O9yAwIG(7+L9D(!CMju zOFud(Bw8ql5el?IfleqGhaPQ7Qby!u%aY_^*T)Z4eqQ;FP!K5;XoP~O3mwLj9R}QL z-q}&q+L4bEnTsuSxm96wJJKR3dp~>!+MBkt?daLt-!brk_c>0dk`=Ftr0|*)Pe-cl zPh4&sqrNZqc`0`E#W^le1Q=GuNv)d5LXD<0F_v(pk`gsQ-*CdL9FmyMdy<+KA~iV_ zh1X)$(gaxrrtV-^39}e!H@ZC-U)sCLN9}ERrn(5N;uAsuGdE2n;>%E!@1Z1cq9=)f zzmn-Z`Y0+FtynJC@{C5a#AGheUFgU<*)i{EM@nbMveu3qWOpVh230t`4x}F<>~wsp z=4N%kn9=qf)PcOMICP_6TtzA-a%C#q1`Sno%iiy>S04R8?LyU+sDr*OqHhs=^^8k1 zk&bJb!UVs0#c$AG>DUF$1o}3CIog3MvlfXRndu?j_h4qa7Bt^`{R`bLPuuh5-RExRNHful?#cnClmFbg>@zdT1nfa zr26or(=rb-0Dc2|;J~MY3in&JmLr#TEBIZtZ>kg)jmffPf}CY=ZH)IDOPJIG-aBSl z!4)Qs>xOg<3$UtMua>?j&94KW8o;MnwcDhr)vIwF$T~{d^6CbDo;}bdz9{4CY8NX@ zUwvxhuh-?(Zj;4P1x`Q(Le22*C4(C3Ny*N-mGt8R87dELMeG)bIz9Q2d>xUFhY2qZ z4${VwHKH~wA$jxjW^f6;JufTlhK(DnSrvs#un9t~+^x)Ss$Ex!LE)JEZUe@Ho(`QO zi%=Z(prj%{?FZr`Jz`{RhqP&eN`Bdcp6KZi8p8u zae*i8uD(^8HIJGbGt-JsCb~Zh!&pKJLu=c`No!TY;d22+#J;P%^wrx@VzbL%mW(Ov zh&2C=gXAlm`*5M#c@!qQ(^?aEcoID}FPV)Mx;L5KQL~;;N7l^!9L~zfogq2C6ORcq zEprQTB9o_Ze;bPXVd`L4kxiM|?VP0>d(zF~x)t>2R2jZHk}HmD$6fl@_Dk^Y7{ zxOxc%cqxhOo9L33#2unJ;PX_43{*BNRJP?B`*J%5_tt`!rmnCScnZ6J1PUwcqh(|t zec}mC+WNi~n#WIFTDgMc<*zU@UWe|tzQqm!&a_mSd za92!ZUf!DHQK(y{H0i51w#G4?i7&l#_ifena5o<4jAP!MHhys9L50=*b+?is_w(*B zxY*xR;8y>tTN--)2#sUp#i^i{LJ71c?rdrE=)+!q{e{+oo!ywX61`mojnJq9&xD$E ze32fUK~u0(_r2WH9pP|OX}dR~_mT^VJ2A|)*BR{2G9jC-vHwcQ#&8|KlEQ3hK89`C zGD~(CPY()^-kGgzr)L!oU{CbC-R!6&T!PWkTLSy>zealsEeElA%Hn$^n)D{59)=cA z?(;&TTbCu(jgz_(cf?l;^W{RAv@=WwBV&87;Q=xYeiW_AU`q3+%y9QTp_yKKY2y>- z#*(!4>Im>z81;HCn9`f>@ta@0J?&Sxf!ximOD#vE?o4#2JY~>*CoPSth+ki7t+>Wn z#Ugzjk){0{Hcrp~1&!qrU$QJwqCK1EKP+a0n(zt=7i9lNPomfME3R9Du@G@_r&~vT zg6%QR4E04a=J;!t!{4jNt(EYr%NNTF4`0lmRgM!is^>zxv5MMFK>rpMjd(!@6^6AJ zYpRODuv3=@G!S(>m5X|zTAtgjs`v>?$fYvr?pM0vBDd}1Rki0tVBedH~xfY`tp|1~x}?^I*gsrQAI8 zPRpS`frYGYCdX#rOKKO(U9bM6zP9F>^3}*)DwA+(el6Xyhoj=5RfrO45%Pf{R4v`d zJ}WgLY1Q0IPpFC~a21J6(%kvu&nMLuCcX5Fr1C`&TnWz2(Z89MIu`v&^rD24&C&Cd zUZeeQ=xU7!^EY$RYaBlsxY7j#7$L4+n+u7NyIB(_&eb)0tbsG0kq$p(jaGZQv~Ks1 zBahO#L#5jv7RVi?qAmfof+R-B)(J;o$1X%;cm`28&dFj*lyyny1n4?8zLGwL)29VY zo1`bYf5O0w%X6Wn`mWG)Xcf%whmfogt!{R1Zj`wj+ub=sIDPC;95!g*MG0G?*zDz2 zqD(Ar>}?+M911_*tRd2-QwZe$TCukt(WwVO8xHgmm#Fx#0mp zTO$<};*Eqg4kg9LrV`={#Ky*oYkW|^l;S@TTt_>$ks5k*NJUSlSnOAZC~tA$0?fe? z@e>y+I2LrPw{NQ*JM{$@m})X!g#uPMGR}4AB5tn;e=oe|z1kPmork_{KUljh90!Lm zL|Yb2y;(~aXF>2D&T{B9IPcQLC~Fpzlb2x?zfR4>$Ei-WR#Z5juWe)ZknEa)h`hCZ zwRcQT{*c-=sa8HUsYhd6gyU<_ou%#90GX^_t=-N~8PtH1p*cnbM&4g#E$^{V%6RINFEoRe=+nb(wPVTIDzp z@;Vwr+SpMybD>LlGDgxF!@BnyJW)#DY4L~|(?IaRAEr|(X^mk#QqI>i;sp_H>!MRd zARh3|+dlGv=2e1oE7Eu8piWQ5XUZs zR8Yt^$4Vhuw=TpyA$psyG4^u3`gnak6lT?0RZU5GPE~Eb)9|u>q0n_w9seRc?T^-a zy8h(;L+xtiY)qpbXVF(k-y0)NH5oW;fn#!f2C?sD$51!aU)kTiAmbTRV-xY z=}Af>#%#pULr`z!tO|rThoZ) zv5`!^TWZ@Ih=TK~(AR6ZdC(5j#am^-N8K!tJc?^A(KCyPyC-Aw1FBej0Y&&bstvM8 zC&ErsTsW*esgG%)qRSGyBA_mUMein7>~ViLkON6j=2)UROP7M5 zOZ&srm)~id+u3^=df>_4;nSy%j$wo`EHwM7&xA2FsaEye(J>PHXY9grpY~&1gDIla z@eL}(4DXFUMjOkdq#@eTtBv$iX!5$btT2Jm4KO%}+w@~p^-4?yNlecc;UwQqHr)+hz-ijhmwB&A* z=Z@Zss7Opss1(AhN1;&*I9M*5y}MqBMi$UXa5#pWn78UBk4ovGGYxR;U$o@q!z zZ(hdEilq|kA?49%NfUSXd!K%U>`=`ek=bq^->}gdE&0oG>r$v7O`PfRBJo_dM<+oT ziCJ(!b+Y});*>(i%R~jWX!M&_BhG?NA>}HA(?y3rV9VkhQ2#UcwYo;W41GqLKT!4$cq^5P0t!fI5Upt}dKnK6DkG!M+K}>Y3=l8opYrfXayzNh`ooMf0##PFx3CtRTEI3GYnt ze5L|4NCt~n*ma0abzlhFZLvnmhFyqESg@^5x#DEF(fwRNhW&0t)X_Rz7G{Wij~3CS zrtPdBH}WormMrx?QgmsR;?fLl(gZ~}_F%2boEHO@@}9u4u~42b-8mk~fH`bMMW3-9 zc^6xy;SV&LN@FigQL3Z6L0fbMt+g?_S`K^3&{pr~Dv%F6qi(!;9G2lKzys(SXs;#s z=OZA_{eo0zkW)|u4O41bT0}G6pb;g4i3)5A#gHhA1#4{#^X3;7ui+}j`P$&~(rh2fC0Rrjc7Q8}L_uK90XjAXaIT zn%P+}QevC-CsF7l8dOax-&qXi9WfLld`9jBXrSn)f*Xv}SxkE4PBdtpp?yMO z7qJIOdr_RGI-t1b&ys&6{CgA)4Y+e8rOADwO0#A70=&cFjf1!p%n7x)bE+&*cKga- zMq!z($mmb7qfKhdDMDtuKxBnTr0so?$hanz_X{HO%mol>KIG4h29;vFw+%5^EY)pf zal9<|Y_sEY3UN@fMpL!R5`_~tpcE00OA}iI z;f#}JD({fu=wywYMvQPX+AkO~+t)X8^M1@ZMXLr#YZqQg^}nQBE8qTb7iYCT+kZ?T&31Oz8-1 z`WHgmzG8G<4hlgcu5v%Bz^-iH{wT+9i6oO#O`RQ;tsAdnQun#8oPG z!^BA3Hj0NyQnsN)oHCYRl>=9FrP^w4!~?woNPHhMI+a96S{KvWd;X{!dvfnk?75@X z)%#=3bG4f}u6R+bIQ2|xokvnlf4mM)kfy*m3)DW!>eeW*+w-ru6AAsrv)R@o37v6z z%rHp3N7=JAvZC+aoL+sQIvv#YVBzRtLSF*X)Wadt}XYSrU7 z1+>ia{l)G3H2dG&arXt=KbX#FAS0185yQ5YBi=bUfgtg=U?q4xQI7Fcc0?AV_Mklg zjP7ds!D6iFEspb0dOu@P3BnOSMh%xXWVzGau!ESczED*zPD-0`4($Z9yF4weeTF7O zeu1B1M>~tVfV#ta!Q60z(cS0K7#sO1&DqViF4aubypKc~Ipz{|ziUJjr+XUWjsh{SD$nRM>txEGiXPdN%zTg{GyY zpEON|@0+xlmd2v&8J=jyd(m%+id}Nz8*sQ;Yn(MxmFlZr`fRIsIv_;wjx*nwVu~O$ z4?xP>{x@(87D^>h1eouaiK7%66B#ySkO0U*o$Lk9I2G>s)hqwhWx;%>R^ zb1ZoWXf!mH=Yz&%!!}pSw&u0(2S7m3VM^*FC zM}^sRKaPwm#5@TheT~Msx^k9gg8qlmrLhP)AWW*hC983jHJM#sC^{ zf8S9O_|$9M1)1zK4|{Odv?RPZc`>a*JfujuznrfuU#!SUHROJQ_W2d`HS>;hFVC2b zl)SUq;gz8LUiQGsWR+P%8)Px4&7O|grD?5k(YVziEi?{#W>g)B<$;O_j*p0@jNqu& zfZn1h!}c!3D9UjfE*n-WpHt>MTmF#J{Xn^WxnbM$8y^Z^tK=UoN5^t$6|0t^r_bFf z&;6C0bh#83cc4-!%%tXrJ6)_Xs_HkaG2zv=;t3jS4AYAvCQWnLAV1Ljo7FPiY%!Z- zRAy_8IVK!ysTgCB2H6?uNTe!;+^I_nFm|vmkpZH86ffOC|3T0XO~GflMFud`n8Iws z;kr|p@TDMr-*Phhq4J!_VzM0MO{TVdTB$Z!v!|Q0%~mO6%}&8;*-G7|RSzzS`X*+^g=-Ho*O8}h%K7I;yCk+;tO?PC6K z59a?)Zr*KT{$o&iSadSQl3Ys*GrA>UCKP~CsxW4!(Asea(Y))=(vyNeq08Hu2Rn7mu!^qtFzE2TLRhP{JT6+xY2E@3^QoNkFX(8;k*w? zFgyIS<%^Z>h2{24!?vxrgJLCn{4})P2)5yf+5)0!>KJNPt;jY(Ub~K83LxwlLsOZz zUevhaIHStm!g<`MnqTr3|L_@`Fi0oQnB*kl&>s*{BARREP2+aaP{g;Lj80mzJ#mWS zY;9n&)wEZ7e1>|O8cMdW6w|_3&7yIbcP*aL)|$Ass2*d#dB9>?j?=D}{N{YOoWZ#{ z)%^+Tg>NkMIR2XoR(C}foEye*IVTXT?EE~~7$e+p$s8~d7SSK3aAKf@Md%e!zK&(& zWw|dUp%)$c;TT5_y<;BhzUegZxQ6ge$_jxfkID=d12uuOR2;)ca91lEhC#lmnh_?* zbZu-ymFH8oQ$@$BTwrmzrFy)f*8rtm3gjME9z2&rK2Mz7@W39XBdoJSevtJ&#^g@< zfvPk({|ebFu3?gijqgj`)5YlyGoQ(+5B2u{K+?51NeeXvBaOa;kjp+N8e@Rak+Ls< ztSY1NaVbQD_ar9Wl)5fiZmTqK1c=X0^#Sd~yK~iX93aS$s>d?kA4w}~W!cuhu(0rH z&0s4)EXFTJH>KVRJvFBSjDi6q4}lEc zz-QD~tSduL1yv3`6}5){BBH2+*sU<^sznF6RDN>^X#XPLk<2PH zl#1otO?iWbmTa-iFt^-&XD!yGRz!31nM}sZU*99c019(vQd70pDxJ8(CG*5YdJAw+ zAyT(=CGRW$0>a)jow2x?CAD97-^Q3f0^xGqDmjG4npF*J!~&O5cVG6yZkg$sRlRAu zW!~LCs1?(9d|iPJpDxKd-FD73fpsZUwz&*-64xiJM;Ye&2p(bE>c@Hxm6=RGz%-(d zkxM~~I2-M9*VWHZzqR?Tc1srvhBWVpOj&Nfl*!HeC&qWCpR;K8>fJO<7n`fxQA%|~ zjR9pR7`43v^bAW_-&u`gHGRXg_n#V=34$-l-%r*ng<1+mahzOl53X%8GTze~#{(3h ziSr)U==Q^`5XVCeBXsagF~V=@9iT~dtY~__&^Ue`z;E$>62foseJ|p-AQ92LNuUKl z$b&@7*W$2en)h#-+?BG#dq-Z+Yakv>n>2T*=0#Ay?9>P<`5>%mgGRv^+{~nO9OkcY zvI$0sP(&IPIW#Z3+Jog_FdHz{?3hB)z#P@5XRDw$8xf!MX48kbaY)QN&h+2tNTg6` zL2F=vEOErr8xFnG1p-gA^-*AyQ{o+8W6lcIiYr3eaYe|OuVHTO9mEwOO6K^k2i1_B zoMSA-2IZDTI4Q<-PU9(zgnXn`24iQ=KIfqjj}AG0JclEGg=7=4GQx8Y>+$!-cOa1mi8 z5zeS;Csy9G9VgF$#AGhFkR}Kat`}M)>NC=JMC157eZ#Z&K&U<=eaAJy%=Ob(v9D1} zr+;;h#_^b$#oX;71)9I(3;H}9hxUKjFGr?uCYkrJ#?dX}#Q9`zj^Kp<$HXJ6B863& z%8Qj>h#iReP|m(hdjd3}4e!`@PH>l33GJBZtiqy4R=6=sWxxo^rKzu{@!oc0EMv@* zTC(WmVdO*ilFS*^TQ}P{JE}6eQqmoPTRok|*$StzG8!x_nQg=*dTX@QrI&7dTUV#A zo;_PRk6~s<)#_@gUiOr4~6d!;c|Os<<{Dr23|sgl_W5uZPZ@2+e30wOPvs$#2mkv}=c4oV#mCMqy8(pTy{MQ*eZ%NJFpYo&+X`iBTd+hC1nncApL$W;>7G;5R@8nDfJv$10bzQJ_PKX2{tfA0=tfA9~ z4)P7|jVILg;ocwcs2)dM9?VC`FXpj_q=Bp_YaD}TtBksjC4nQaILEoO$UY7%+^GqK z!1kCg&TibWD-8B1UX5q9R@fo0+Dt79Co+dsZMI}F=K106cWPEHZTD&(Qcdqan?^+` zM^XNbaE&lO=!1TW>)8g+QgeTwzL_m*T4A2QW>{)6eXz9u3n`~fC#-iIY5NS=$Uwj?Ga6GT3AM9@YPhVfkBZ^N1QF67fthj@tU=&JQdALqDQk6@@pzP z4BK1c5*8hK1D~E0KS|o6dnWYH7?^81>#ts8)y6m-o3-PhOlpC0cbG3q^YYeRchJS? zVpo9&%oT#BB_(IAAIYpH6Yi%9tg8WK(eF4L3>#Kl^|Kb(L_JWKfq^sQX12O zm(qy7qzSU5*Y3pV8b@Ekekfr7Ts4FC5=o~TCyR#)S3U1hGFvjwR#A_L2^gC)xKvMu;Z-=%nJhJSMh3{~oiHL419>8y+qLKXcFmMs zuvOfx*c*R#zq8}&;1TDu&gO<4`m@cuDpmWp*L~%Xp2f{0TeN4l>7@yS71YJb48k5m zat&q=6C=;!(u%~d2l3nLw*95qw*eOeQJEPF;}ZtqMW#gSLw@%na;y6h3_>BDOuxQT z6VUmr)u}Lp%d#JJ1N&_l6g64B34wJD0}iI+DljHAxI|OUV}sXhZd;myp6`pEMUav> zAp34Dv@PUm%e$g4Z5GorZ?=U6q?@oWK;L3+`n!W_4*i@UG37Q%JKf2&&?9kl4pKYQ z3v*3i$u5QGkkrveUP6psSUN_K-c_CD*iYr)I65dS9V^7d3QHq}m^fjn#?qC#08A4v z*bQaoL&^Jumnf}~b+DB7GAvM`!&*De#WHiUP^wrRgYJAX&T}7QWU12(gvYd#C4)0( zNUTff>fcs3OXHdEu2wf=>W?$|uVT4{ma;UuTQ7A8Y-t*-H|~9AaKG_cV^tM4G}ZsXQ8Ne@QZl_+)MkVI2>1eOKFy~7;Kw}%f@-?% zG9ye;R@cGG3L{wYylIe0b&RlT1)3Oi&^`9%8tnVq@z@}4s{36)4Q+Vxntw6*SCW4$ zGbwhA*cfP7(M8FMqb|aiGL!;yCk+37@5lI-I{XVbo3cBWvA6B9zg>gvReP5W*8gGe zuLrTiO3CDIm*T_uw>4E$p@$`|8JsftgGGa%B8T-ae!h0_^jGTJFZ_)8{82oaA7-Yn z8BCikEM=xYGMKh~m$K?FeRDKv_c&G$R?QG=jnrZy$t99R`O|rDt?^EpOfwrLS@A~W+^q5E(=38Ct2*x< zX}D9!#QUw{S^{xRZxmL)PH{I-+zkjzkvEJ)hKE@8W$LNWR%~`GkhZA2RfS2}w~J#y zT9UMFy@H{4V_`2G+k00=x(czL13D3Cg{eTAASiS#ij)a^Qd~8ClQoXvGq@!#aj?pm z%o({9jIJS0DYiHc-BXH&52zax3gWa$Oxy%Loaehgyy71PBuwDPw0unk@p_G)IDX7+f&oG zUz7OlnJH6ue0-)EwJIo7!d%Al3F}fxkhIQ7rg8mgE#DvwQPlo!<)vRZz6ki z+kOZv%-z%c7hjg&K4e|Ob}o^WF5y}e8);hp^)sk{OsDVx!wKI9R|9kAcV&OWnoTE&?^zBI7V;b z%$9-%Xd~((a$z$dx>$TBx5+u~lvP?=xi0z4-+`5VKN~=In#U{mV1hc(oWm=!5iE>NIIjVt3A#1!t-%A76Jy z9JW+%R;zI@Jtjqb*qmeP49u-q-QlzD6w))9>3?z#^qKSqq|dj?ZagHuoNFQ z$XedC{*CRF(d1&v(wdZK+$Zuhj>I!7^BmL9R4w<&n5)tO>|1qX#*ste2Af;`$icDW zsdC1j_s%g=(b8TQbAi@UptBZ?D=g4M4i_88bZVyToqYznqi@!S2vux}=uFh^y_0;r zcfqH)bwww;>L^=yk}bHv<{Q~x2<*cy_8|}Zpr=6MD&Q(Lli9sf#PBmd>|`G}%C0=g z-hYA3GqNiLHrK^2Z)KOgHGO-c7%=gSu_LnCW10@s>fyb&Q9Q@F(;}VF{nm1%{e5#9 z;|*+ek(p47I6nVW;nT3%gf7*3SPEu7Nx_@sZMvSM{<{X|+2;FOP6s!e|6TkPQaio( z`5V$owPWUQ8`E^nlWy)1yLIbf^tN?@vcVWflJUc7ImUB>R0pdUjKe%#k&b^7#_CUl zGiu}Zm7gFnA&%uBPccn)?lgwvG*6~GzJL?}ofz{_q@#^uQWq25da@%mPE$%gX(h!gu2NhNI zE~R3dHf!)*7aFSDKYzPuc5N|JyX|5v7V{p8iAfcXrr8nq=VIJzI^{lREu|O|^boHB z5lj6H+TJ<;@ii2HQevuSi-jh}?uKOIp5yj8Poeb0u)Z_?hSTVEF$Wk3eZOmNpbwxP za-Z`nF(Kd*?>{iQUoN2SQE{}vh`=7!W!m?&3A zk(B0=%Hzy3=J;H*OaYDhDRB+r9%2Awm~xIX0?Ck%rbqmk(6zdm>G`KI6tGBixigjW zB<5*pb~z>DWcXTCy+U_CZYW8P--N=$ylQwI*_bi)wW5`oSfFQc(N=Fs>mlUbn`hXF z$cT`!@d?aH%~w>vP%1Z9&o6z)Upmh$B0(XR_W120?sZStUGsxCAUOw0C5m1Wa)*$2 z-yH^Veu45Ny##a0PyF#Xd;@yvxJ%D)-5-wF;dQ#(aCv&lX@@kJN6KG5&3Pj*9m8$9 z^5fIAV!aY=v*8P}#lUUiSTd5Tqu0&E9;F02ogN#xax{>Bfo1|VlW-qByuK zNH;~Qt`lJNjN4PmzCBwp4d+ED-#$VH=qj8h0$hSyR^x293wH2&IBK$6B)^Ek~jXvo+{srC64br5M`{lk7$;RA#~$i;d6RxoRMp#Y?irn8^}V z-nAjBf_eQdCEcPDcNYY*T53efuozb&U5aB{Gdd311jYgopYhH~$ybQ@{~`=9emWwX zmKq}8IYK^=Bn+#=u|=tv!Ub$0QkrTFw0H0Jgv*oK*gF(|*=o!ThbZDi!%QYJnz-7)BC%dv??mtE}_os?St&8=Ub5j~3YL$q3KhViSsMS3o%*i3lVg)Y> zAt9Z^agA3OOb501XRPDP7Az^%7_1tjMKe**B!P7`$(0(+QdTBXPRnp zB(Vh4$}RXedAc!stoewBxH?kog}}geFmRH{z;mf4;%DqE8Ax7YoQp+3cHM@I(z%>< zu7oxY%#~W^%EbL7a_k|P8^#08Tm{&Cu9DixTvc+Sac=lxPJB^QCQbK_%4CrD+llP! zc>kpFdfxY@g<=Kcymn)p1T>ZF+smxcae_SK6-#KPRNXXELJ44%U<;>;{>u@t&2>_x z{1#HhJN*{8e|Ix(RPg_2+`g&Ta9@*G;8)rif^#?o4R+g5ZI_Dat&t-KLGhT78cJ{A zmbDFOC9-a$HCsdVmkqHMonMksm>pA^t);5X)b;Bu%4z~+G>M8fcsgN-C z!}d-!(>Wr4)We%w&WPzp-H<*d9wjDTFHOh`CEgTDJed2x*N-F)T?F#&(7(a2z6Jg( z|Dx7>L;1Fiq=3oGQSDhQUquKB)zkmUJ70*nSB~Nx>Q(Wtq`gzOkQ4tuI0t%w$!`=@ zs*Y$if4YeGUOv$6mn~?av2q6iz_duUXg|l45M!lsHl{eB`8bjzx zMxz_8CItkKn80VF5;dy41}#}+n2$##F``cjI{5L4e-gP{M&Sr_#9cB?$l+ zlEG?jq^Q*kT-gd&h!IWi-Vkq;a*NJFEYtxJ%@kRJB1AR{GFYgzFHuyZrP!o`GOfZ4 zB_k|k;;6mSdG5VpB^9@iji!AR_)$ z1{H3E@7h8H*Hf3PQmf~oe^KYPkJKP$0D8e=kDXDg#YD&Ai@n@#gss2=rn49Pr@rux z=S#8t8*h>310$KamS#^V&HuFg|7R59Yvq(FqTVl05X%Wn$q^5Zls_)tyO|$DH?vvH+&%k_8z z<4VFFLD&yWL5+`8*5wi8H!y!dKoFJQ>JYYo+#y6)e7ETT^&_}$(f>O`NN#MC1B7aH ze=BN=qFB9Ulk}E{PzCA@@)-&!QT35X6-0FZNd9PK5t1fNx2V0*(!{cmwJzjH_gp9u z$NIrJ3qt+BBI?oOeXz&~>i>}EOdCR!kJeRRzExSajUd0dEWJ;RLKD<^gSyM}HmR4x1y*2|Db102uY}JsmLC`6`srg9*+s;5;RvSPA7))g=H79ZXXu0 z-PpIYgw9E-VaY8SIHVei?Ja*)0)hOFjJL&|?VveROeIYw9$665AS9twQ0LbvfT4+& ze>ZdyTTtFj=~DSjzD4;E+Xpk0JUS_n{AHui+*CfgTb7S3gzi5npP!9N;2J;pPu<+s zskr|go!$kb&=8$L<~%Fn!8Oa*WUI*K&VT~7;TEkkBwK@BkZ*1Xb*TQRC_ffaZbp0D@H*b@yj7k>-W3rhk48v%Y-u;)3C^1md9Mb@Q(v1W zq=^=#&ZB(b8PGfRnE<-KS79EfI64EJqS}awx+xQBo-S~J0nOb?cFy=xEvX28z1ukY z`_36(J(_7fd<7a|w~{HIFp=gS)z({LS@q>e(Bm?gl+=$TvpwEP$tYJ$K7;Y5*)7Ep z5@t7R77GuXpio>m={49y#qt-Gs`Zq+o94R29FCsrG9{0W8{~-+v1CT`1m-uvSyVi4 zk7y?H>-4`HdBSTPjTe*g4m%-*jXuueK;h@m8|EHWGOPOs%t>QA$`OTQA^BRDVMC8~ z8JBRUHB+HJY|T`@z4fVQteGmS`|_+e*n4Dwak(cj??)TK(VL6&jq#(?q*U%Ae52=y za5*mW(P_M<4(mt93C>d_Q?wh$(aw<)xLNl5qC-eV_*JX}otXTnF<78?qGB9f2fneP z=-0KMFp-Sw+YilA1S;bHYCozF!V!9C4x38k!WWda8*mQ%2ROa5n{bMG{EQHe<}-0x z;3huvvZ3h6BT@3cND2Dxk`c9FTGj|1V6xPJ;1TEQZ#i@m8~Cs|{U7L@0=ysSJ1BuS zZ;{nGkY}Tc&zv1D_7!SNc7)hhVD1Q}A(ui}ueGO_L~PA6gHS`qc@GiMq_NN0h2fR@ zT^eBZTm{X4IZe}n5inuvd#rip+_Dt|BdcH`vMtJ|U@NXNTf(6M4kn6gU4gMMBn;(wqe$g`DZ&PI z$!TqrW0Wkl+`3VP`tJr67!O+)aboFy86pei5R?rCVhW>W!yK{Nf+?VUX^G|klnuTU zqwx~iiwNoHcKRT#WsGj8-p@wI3DR<}NXtsuwdJ1P52t--&Q`oqg&S_Ol~D1g9lG`! z-=kh-&VnfYe^~+Y{cUtwMBhX)p{lTHp|Q;zMW|S-raj_9ro-pac904^ z!iuzv)_LcohG_W@bzWaj2q!GC!a&51e?kG9ANX${s4RX?UFcke-yF7SP+&n6c8{>N4 zx<%YS-4qw>dvjdh8>8bMBuiF|ZtmWM_KAjNF_{c(9o^Tq5dicxCI#8*Kh<|=GKq;j-XqEr}UHmcU6cG^- z>F;}95-3x*A0G(Gd-tAu?!D)pd+xdC&$K!AY4;%~!?XpSY4e=Z9&%2b%dha1?o~>U zcm^~nyDwuS^4)T#e#~rTz_Xj@+~do|_Zj{H&8@x*FOB_a>wxF@<~QFdYs)(G=D6Z# z-q5vK&+J-fm{Aye-xzI`ZN}TVo@w{l2Ruvd40z5yZJvEVvwhm!)&Why0nc_1Xg)LG zxiBHnv{zp}@8!;DA3x3oca5VyhLQ&f-UULb*N^M_HG?omM%UlcBlZ{3@j_s6FS#wc z(r9!(36D;Ir_pIqN9P=c^kbN|Z%@EhO6uI}peKfR+ zwH!SybSDa2Euwf~C2cxz8kOa(r$LtR($j=K00~9!N1)fhMR4R|O{oFFv7m^7na4Dj z*nh>sjT9Cb=)f_ey7Lxh!T+jpB-Mv5iboHB1~Ir8@I#MWG|xkXShgJl;PjGdlIzWj z@Tf6=l4yJTwDdt-`IA{%#0k3)16LzB7S5{NeA@nDT-6`4bg`gEs>Y1dE#!9a^IL<9 z{cV}@uLxs#!)fJEoJX&~Rz7W2;~Fge6>ZHgI(t}W%*f`f)*g1DF&9<#jG!uWsR}Y? zggOVoTBd6WQ2#B9pvQ1Qcvp8kR!VNFeCG6w6zx4)I)((KH~(Zd02GyEMm5Z zUXAEveZM*FKaz-qEq{3FH_^iPL8Xbe0oIOW@#55JmIx|wgSw3qBv~~uYEuZ>!{{Ml_N3liJu2&uoECc!W=fhmMw&X7%2(cU8hOam$?L(~p;LfzwnG8Rsd{1hgfgUSVi=|W zgyz()i~j!Q@*o-tPwLpFCQsE^=ky8gC)1ZJ( zwGN;AF26G1TJ$v;ZCy}&eB<=ZC5X!xT_2q!9*YVRF%tw@;fL<@n7-i9(FScwXt)jO6Z{dTop-*!P0YuODI?qsog zHcAAJr6Z7$kW*B*9po<68la*F98rBb7q7ATeQbVkj+ELI<=mf+c#4c#aJ%RM!% zh+ukfl}8bL7jo8FI!|Q|Yt3A4S#@iEX7)C>U-2#;S{Mgvb%rTc@RB9DDi?$gG2uZ3 z|3pu$JJR7FM4U0SlYwzp#PJ%@Q)>{SYW7%o$Pn@~JAF`9mH0i(ZSS z2gOQ6>wHM8)QF}9VkN?;0O5^sumh&JbfWz}$v($!pX;>Gi;S?e7bE_w-rvB<73|0i@mP@r*!A21?T<@J!oBPhPZkk5OIRxku>g>oV7LB3;Xp-#ZuJMVCB z7qxqrp2-}XD3tDP=a7qOFP3WN;7t77sC7Mrh1}c;R{YO!TRW;;Km8h`5fvNM|FNnu zzUp}=N?@=6dyE2Q9MN_?ELA^fuYSl`y+GpjF5Oc1WFq+9{BIzOK(vyARcNL1Yk3al z%UwlY60TG5j}F||>+ZyVe^;AD`(tEC3|TLs-Y${u(+d9L=(m67+_$rLZekMF{LML2RY7(S3$Q^8gobYaSW?9j2dto_ddj+4bRGissiUav`$6bB7`N8Vq?Tu3Pqq|BE{k}W^peV-pPUe&=v2ph)vc8b zF~u2ikY;eMTK{O^5G%$8-5(VW5VwE3c`!oM$QfZMVLp*xK~s#Gb-CglTVow|#y91p z%kXu6Y2>-}v3RgY1Ox!v2>d1<9A%@{_3L;FLdu5ho$o_=Q62&*O2{AVL~>GIaSO(KKY5tdni| zC)H&re{}*>C3Gj}-*Qs4m+=Oe(Wf`I`sTmdpm<)$Yid}XezK`yPs6KQm91}iUYOGK z_6lQqOI^$07ndBAQ%-sgC0Z;eg_%0xP(RgQ-a%`Y9|EBy8c`5b>aOe_{C z6BqcsOlWGn-&qJORNaC_8^!Xecxl2cp83qrU@L;{YISrD;($>sum;o=Ef2mGL6e{*+7z4|w9L>Y45nEmN z4*BB~7(ub>K~)$8R)L#Y#Ke+vVw+QN6WlB|q|}zji_=QcP~?27?lvmU>i)ZkybFAx z6Y^U$dggfu(1+c3GR2O@@xcslv9#J!n^;|1xb@0wfj5cFa8hSr4yOo^oOsb*stCre zLR5MKav}*z0?B}u_7lAJ#nPUr&OUN(MURwMV4;%e@osx2^=8DpIk1IPh4Smv5l{Ky z`<&SJY7?W8qFp54pL3 zTmBQqx%0}b<>yYpwS2`1IH#>SLC$Gre}dI{5nFR-!sY@7#)jMwf6Pnb z3J26qjd!-^E~xbunu`un&u7)1J9S&q0~*_XC&rAjjXhBTE^sC`sAfOdwRodWWd)f* z+%=&6Arw9E6D`$gPkMm2+Z`1QA`9%NkJFc4xwS50F?1t8hg=S~)%B(-0J4NYCP9TEk#1rHv)wLe; z5~q$a$T0NNi;g42A!IE*5-89kg~)Mb0bTc)hP2u$h!FC3$7vo>zShcD=AOXWz^+?B zBWyQ#hki&UzKWKxdvT$HzZ!dcZr*gS-O4(i;$}I{o!XgHdH#5HS7pYDYGSJ-zC6lw zK?ajQj@HF|ppxKSZxRe=-G00}8GVIaBydJhW6Nkl%UMCgxVy8HYo)mC*SaK>iBf( z6QoNz8Jih%wMN;I>uvBBrf&FXvK~P+QZnw9s%KHFTkAbq7=KomqG+fA14mLwbVj28 zUtil7lvq!SOhK1g2FHEZ~NiN*l^^xnb8|J%@Ji4fI z-*H5H$%PL%=-*iwpwBAn#*0B8#e31oYt->0f2W;`<(2A>R0R=|xMBU5 zo)@O42-C}EK4Nzz+g<6F&Btj`n;sOVmn!3*5XU!4euS`gccxD#hF1FG_@h+ydYp~0 z6zGC)GMw)#8UYpSL0)#8IF(*yQ1~6@uaP^8$pjGbv#>c-b9#P` zQB6u3*B;9RO(~mxdA#*#qLQwwbK@Y1m!5Rps^-jak-SxlR=(9*&a8ax)h&x!%h^fz z!A%PP&ISgyT4n>V(W>u?G|NV01`C5f?1tViPLMo7{`1AbkjnSIdvkU>IL za%}Bj13w`K)rS&&E+pkEJN!+s-1EH~E{hc@2*0mhEA`(z)M!_;9jK<$12#|4JIfie zhbw3I;>LhTZYqhOG)9oy?A#OfovdAY0wfP1_N$-YqwVIN;1RVCzdr5V(CFz*IW}ZD z?!+2jYc(>hVQVJBLGdy(vj5@j%xooBozP@eu2sib;+{x{SJo3eotOjXeog>4sCrP> z{~}BX=)EE(j4bpp(i(o;o!|O{g|1&++^Yq}a@L7q{Ay^`}LCmk&g+T<6YhcHjId4n=$+Z_M<3-SIJ__lzufx~!5rF8SscmnjwF zoi9w8S6Z&Mf7nlQje;_$YTAr7LwP07D*f(+V9Le%zVt;*>k7zDN+ez`}SCI$+lv<#dhUb@pwhrQ7lbO9QLqtc9OHC z99h;%KE2PRBc^@k=isKo)I0Bdl6vOfK1F`@7zj`O;caetUfw`ImtK&j{z95sB>BD4 z)G5-`9BL#WmCVGI^y~rl*{Sx~15sx72x)ejH2W55cKX5|R+uo`={+}Zwot}khZo8? zp-dx`X@xSKP!=PU#R_G5p)5|AP{U_AC(LsCGUm^JE=4Ol1e_4fOF}+()J+`L1$mg0JyI^k7xsDpwSAchV(lq>~`gK3;Dpk0b3)bq*i?kB=a&5}^+T>Wp+Y35V7nEd5 zk+3YwZITTsez|ThvzO(^`tCgz`t&Q5pO8FIlwJ;fc}<>*HXr>T{eev9Zsqls5*iT2 zj-cOi@iA!JER&B3Rrp2g9_z}!{fe?ZJF~&tkm@Lm!?H6XGrObEJ1}@~~fJn`$Ku?;K{PBa}7i9xgxiSkB=5;m5`Z zf{76vuSNSq!wh^S&MShK4%R|DDtU2(iPTCMukE?O-;XSvEgHKJKO=2c_z6;!riS`4 zd23X;hdlh3o966-D2z}8D&#M)twxdUh3_nKDymOTR7{EE zzJcBq`-}hQ5PBBMuN=j0s$`EkRw!?zufm*B!kp1~WnbY$%p7b6ic=@QNUuEEqdm?T zd=8tb7EvUo`FTid&32O3k|3=)alP?RIzIv5&|wHTz?UXC*`#2mUs;}4h^35qE~6Y< z`KymY-z;ht;8EG-UIvp=dy`?(vKPyBA1~%&tkH?CKZ=R|87BIY-rO5IY1!Lr>ejxt zYK^7Iw;8O0PZOl9~D#C$Qu?DB&9x3@VYL4>``edD+L!r%F_C7J1S=o zW&S7{a;2me1l!TOz7=u@{sfNn`URt7Uau&y(Ar!atZ(IlK+}3CO%#S6TZ6Ua7lsCA z@wdYj6yHKJg{b=ch>H49>(6-eC*RTIl{}WQbEt~>P5A@W*-aMRYm6ghv)YX+G4#My zmF+Y6N#WO8^Yh4SASZ<1BN+-K3KsKgVY;*Uy(|t|q9A@c6-4D1#L#vg$_^!mHE&_~ zy&X9~6lxhgouuSFVT4527T%om9fTK@4;ra2)uu#!Ip-2_onkV@A$g80Vl=g0@RycU=q$s8&H6=@bg@X)k7EFn%$JziDu*Ui# z0R~*0@#K|9!p1h(&~av{@TaB>O^Zk37Hs_uFHZb~c9d|?N-B?}1y{%`9kJcP87mqa zwq9A>kOr%&i-n_8OF8fQMgCF^Zd1il+`y>W z)k-z(NIIyPG<9_;U32U`tX+3+SO417j4-(2(+VF}l2h_akK`3*<`pi&UJYwdq#{d^ z#UtP=_Eg=JnVD#p3VM=L#8h2g5em|#?wXAD`$yYP@Q-Jx{qbtn6x{P5R!|s)@vPdJ zE2Ks?v7}CpoENb1SQTC|Jz}nk_i$&;MX`0V?WHZ;@_co1OJ@}!$()KPq(-w|m!ELN z<7GW15Lo=CL@a2Wze^y;tzU>;*h{P%IgHE>x(_!l z%m2sWF%5-!^TQ1ANl65o1INX|OpTrsI*$E?WRjPn1Ozq>x}j}#q;ayrp3M4l24He# zjM3S-U{?PW`m}OoH#78VNUHkkmy&71r=uint3#4)Zyd%wusvmLIuehJErT@?!&JU{ zSn99AiEg?ETMmUDv6q9xNK?ZH+%(Jj!w@wkQ-QRjSF#sudhalJ<=4jLMGRx}9~M$r zqaaLUH@$V3R4NyZ%aJS#Xw+Jh{6mOvZR^5K7T|E~A3~&Ld-^cq!y^ro(s8Aw!Pwwk z-wkOESav;)(}d*V)5>BQ=A}3EiWdybgXrIOQ~8u9x4pDJw$6J&E#jZ5Q9ER{$r0$@ z>D%nn3aG13+m=Q;SzS$?j6oL{ql>J!bel9CbULByUUayk0v%RN<&8)>o1RpA^baH~BFzu+6DgBVCz0;_)!Qj=HnsygaEJbW^&Z2g)%;O#%a^Xu zRLw9Y(21r2Z49sXza^>Mwb`Rii?C<_bS*VlwgR+MgjZQa{??o3EgI(1{uG!}TovKwq(U z5&K+E>=OnwuGa_g$uXrwFScPAUcs)dk-P~L`s;03^iwRY$sc@J>=8swjcA`GdUY_y z5HYHdBCrK>kGnn{RM^^8A`0>5*9>7YZ5I%xBtHqY5~Y&bRxXGg(p8z(jtK*Iha_>> zh+STlHLTx4!76`nC@gEZJ}{b(e78KM&vJWOqX_Z!DI-bHFGonTLlx!n-wrjFPI|sv zdqzDKTod!PjD%HM>Rq1_n1o1kD^k)&#?bi;6Z7K84barmKKx{FR}(r+@^~`#1H7Xp z;fzNHRqVL4dZXHB7D5W27BKg^$METDrZch~pjavwDDueYG^Z_w1TX|XdV#RV;gJo! z4|*|Q?w6gGB_^6T_j@-6n^5R%L}7-^3j!PCkm3Zdc32ueJaG0Zj?{%05FGmEGrGr* zYl5BQT065gveve=@U7B$FRQ*#Ri|v=f6^>%hmgLg)ifS$SH>p=vp z#r6w*-^+iey=Q$OFqt*xukT)+gECWT{p+dezzn%TkRO)W_@w zQ_pK}*H%7sXoPk%3@LHnkQcGK0kwpUZk{Bgn_)=&q(Ia5%nP9|bfo5N zouY+}O{_3&0`1m_MLEHJwyWKrQog$MkTOuy*r?3ZIHyf;FN1x}vcj|GWx~&cH)piz=6FFsWDPt};Yti>Q1)R^gyJvDas>x;q=T zb~OaOi@^h1Lisf1q>rKF$Qonwn8MaF>@9)?C7>spu95 zesAvT6j-L#ZY0XOMtz_M^uzqR*8Q583>zti@4uY*Kh`{c*zrkUG{{FK40SadMQkz2 zDrbx5Q}RzARJqq;OeTJvI4G6q+ff%$0P~L?6g6>r%C<} zdLkwln0sRK_Z=+oaF+IiB2)nyoyd6{&ua@!wI$=J(JwU^Kg8*G%+nA*tus2dveb(w zjkg=%CP3pCFsjxKOH}>7VcJlK|3ux-f9@J~3HeRx@Pu(6#kJqYV57|vxaFhZ4at(%~U{tH)LvpJkqPn-&oQ7;F^mShEhI#o9^?{I>KR*J&-J{O*H2^zk z^yV9(*@=LB9k=-$jMw}DJ*X0Nw8iAv)61uBR_$HOsifioVue?z`(?XykVo?{BX*n6k>bvZ0KE~pLus*{aJ_Lm>Ul?>Qs9G)1)a)hI4y}DB$G|^IS2hvD zj6FVL<|1;O#A#qSl2=*>b|?h3knXHQ5VF+Wq~zqf%So2T_001L%~KT(%w`hhL>dZD zYC+S}o~i;YzSaCeWgy%5q%sp?;snPQty(Tyj!}m!b!`3X3B?WDR&xhEhZB{VW1+g? zCa7Uq5?!d?miamRW+>R%s9cwjw zYX0^E%G5#pY=rvcd~FBhUlQD)w^zO3)m}Z;ggj-x_H8}jGFiZ02c63h`~0&;o~^{4r=> zKz$LFpCTO1RT_C2zT8%u`U_dcmvJzE1vt!z@9_h28NqW@Xnji#U}`GH0oo*}uh47x z5o)_Ob(s8cxK?JQ)`A0aky`5$#y9_3t)IEBW~yT)GZSstL4g}kxL2)OejnT#W*@-f zlXKLX^K`TjpZOA2id$^3KfdR{n}rD5N(LVoL!=p6u_m)H)7*pm1x(G<1A$8_Y)j<< zp_>!98MV%S!M4QQpZV@Q5W1+oVtkViSbq+@(RZ}2czJ4myxRPnTY>qe619DUI(|o> zNBaGj&GX#Ps|}1j5I7GgJfAz(S9l=w1wjOj&-yrX%DzR#J2E4Q3X(11aDVg;cqm9V z!L?cP4m2tV2{CjaZrf2$rAr%w7{S8R=q;>QEW-{AP5p&%7>G|BdL{v16mB}CW7zDN zO*-}Yl#6yrIgH$;l^3gTSK^9}EzU&BEmdx56y&r6IoU0Opql40$VwP_(YQM0K;w#> z?C=X-KnFbGf3!Y+oAbm~UYscj zT+uN*z@v5i&1tY)`LI!GYC!h}om;go`gqvtuRqKgruG``DUpBD4ek5AS@N?Vg0|?2 z)=a*ONG7iy*y*D7e`Y7wVj2LcD6*@nf~ML+^4qF*^2(G54VGjr*XT--`vzp z{%wfS(2)K%1>^t65A-QhoI(9%=*xH$@>JA6sx<;!)d$}*P7aRT= z?)7VZ$0tiJy^hPA8*pjtTl>dw86b~R`&~i7Ap47&f@r5jXmb0^LzbMQwxiBrdAJ=? zy3iax^k2p{OHRLDxA4ZgKlzV!!3HuqWu9uklOw3}FK8+SC{{I75m!ynOcyFr1&67*R2n7NcbcNGiAD#>A5mR+XEpL`#ESk>Cneegk!qI5FzM3* zI>Y)g&=&Dkd2n}a!LdX^=-82ybuZ37jTyCb{4!XTs{ATbna0c@WP1-dH*2L*)?X zNv%NuNKaJ_czx)l?~WN{HuBiG4o}q+gh}PuIP-fK3EqB!jp5I~B#M^a4>EJS+1!R8 zGO0iJX(4$hhBk@B`Oalno~m7~t#qAh4Fw zlTmrxROOLJA*-fDfn^F(qG;%Z1D0IFQgx$m*9U<=gyGwma!%xiL?w#FG|CfkS1|$WlRsBJ{C8%}%0_g%2`yetU^#`r4he*u50^?oRWx6}7 zVT0a=Rxd*YRztuG!P^VbArCj&W7Bk%E8Ojhja3=#dq^08J(0F@G~@R+czt#9PpOi^ z6~P$=r$w}2y>f-N#!J2C?cwe>Y~92!fnHS|FB>x%vFFjHZN_C}jDDsb_e_8IAagM0 z3O7g`sIj?1_IywWGhhwWVW`&ygCq64h?!Pp0~?dEL>@)$HZM_^KbQ~&qTwKFRU?oV zX7>p7jbbnZad^F!S1I~w1#=SBZcHzj6HAYg{iaGef=#B%y*RYC7m_IcxK@Sla!7um zJnEDQqKyUR1d3DmI2>Kn_*m)rjTCKIk;wg9cyaDO6qbIdYvJGOg?^H9YzYvjuv#}( z1EE7CesS(c(aQJ@`Ut11$hB;;e*o=K=x)XPw?<*pln+3up}Uc11P6LKjymto=|lfM zM#89i8^?^w(7{&O}uPXhn!Rlg)64t8ts7s22|iXS?Y73_Kcy_e6QX&cbpmgx8X zxy2uttcoS*J17;D2eE_yfHDUdKX_)X9y_m%DT{^vMHL93kij(D81NPK!BpJO;U~rr zm-?P=R+;!`3Q8x9Qx_rzttK<7Y@qQaeaWJWl1~1tM<~BdT{3tk|FcKX(=U97?B(HZ zvvWoAS3Px4c^mW>C)Q@P6pX3yo$qNGS+~sF)PVSH=42hSZ191#D1L9{KYC)Yr%YM5 zs`8VbDeJuUVNBl0RpR#VkhIUQqae#z-spiE20LTmGpXj)r+ZexGDJ^CU>I#RQugM- zCsdl1kM^{ta<8r$)itr}*I-7V5l{+5O7m_SSW8b2GV*P{d(b({{+?G~9fhQQ*7xql z+^y$aZ{R8V=!5cOX64M9nZKMV!%`J#T$q~n9)A`yrC}RVskOGHK+60fL{{JbtqG8eeJcSFS-OGDC%%7*;8HFIn$emPfGgIG_QbwPf;2gkbmw!8vf z3B*jt>>0-5x3}%pPO@xmg?@OFN^;S4Dl?P(3YW|@3_g&G>sQz2yEg@Tz-U4(cQ40c z1EB+Bh3!WLs#s)Rf=c!EyEirWfUE-R?_N$iAUvfSt#?Ph{HvGPDD{!nSq-xyX@zA) z{+YJKjCc?=;XkF<-3S0+KsV02{8Z0+JyI?VCLCp@hmTvQUzbXAUc=y&47J=$cHxeG z_8m7ZnDN?_X%`$;sGituk0ik+8VMfdRJGosp1GS@urnqX^Gr9qlb9>gSxmy;r)X6$3CQYZkMS_~f*#ng$m?V;MyE{8rEjT6bkN6^)suVHt*4K*^wEG1&z$Vlcj9xX`kA$Q624p2 z&mpTT@O`lQDXgA|?-unlZ*@7o->QDzvU&o(k5E5zSC`@YaP>21^>}5;Z>u#vr<@e};qeW|eL1X)( zThiX)_`AmTc{i?SO7Fmqo_57wS|onJ@fV#Xi=8EpK|@?J%~>+tUOJBFGlp-}S_jca zY_B8{V65+Sw>5))gHHrgxRqU#UJUEuGCV&-ppyBhwbpdI6Gcf8}fG7LOpH^EO4xDJ5-txp(Ov%oPuZ7I_AN1aFd6 zb(oF!*b->*RlJeq+QPIL;gdNpbdj>&5|7=9{xa?@ zmL1(V@3|M!aS!AU%)u|P2IY6@J?@1q?@$59c@3Wvdi#qJ23N}$f8pL)qV5flK8X8k z)NuCk5H&X&Kg~g|(!YMue3?(RZ0yD^OfUr>F8S3D$Z3?hE2H=2geddeWoC?bdwG&RQ zACB~|e1SVW>z}^xJ3*Qn>n223r!C8djq6%ZLVq!SS^>`fr!O|7p(jhCtq}hIxi1f? zeOauvJg7D)YT;zF9-RvP5uHMN(Z)!2yWX7N_-Qqod*+J`IiU?e$Z}7##sAozjd6X{ zTbq**Dv9&wXmC0}&%lvYe&u5Vr}1u#IjA8;$v68!Ho5wj3P-CLK;BY2{4TfBCzldQ z@$tDCShTFQ$#|@qAYAKf!D6iw)7Z32KMM&9Dn{(R@Ac%Ge1lBjD8hV0;Xrj$-O9=x7L9Z~v?F%r& z#7iK<_~1S>um|vR`@#b>h%0a-%p92sAK)ku>r)XRVcNL?FTkB zM)QHTu*tgKMsxYNclUdl=L}QUE}PZ32L9(StrZkA^HORijmGmy(TEMmGZ7fkk5pdj zXz~)64gQ6BKp19t=SMVkrG^Q-0pNvGp3F2ahSHTcJZG4-cG-eR1H+U7Xkci#foM<& z7>S?_S6-hsz|8u#6U80v0R6x#Xknyzng%@}_zQQ%k;eftpl3t*2S z?AJ!YFIc;5i~MS&1KCPCI*=7^;5%dAG5XOaXx)X|2>VIU3_Oo!vS&S&>BwekM-6F^ z&4mb_L!(}IDYGxoQQsdFRc^b6bKp-j7=1|xL2hoO9H~+_GynQ}oAKjo1LGT52Y91z zfYHeC0d+;8&jz0LgM9@4b5ZY>zHOq#T)2Y}?jQZF5AFeYvi{Ki1sTQ#7?vB_ zw)bhHiLZcyb#K(-&O#0L(S6pbpt$bU>_( zrRyl_Lu+41F7prf0r*sX51$4A;^&9)@%DvcHT@7ipqFWYL08n)h2h*v;ayq9HDt#- zl}@(zX8fbRXk=K*QOSkqe3+#ue?PyE$b{q#mq z$yyGu!~2p1l&^%LWaEo$`#(|vZe#=OkBz0Zl<>L%fF1yfY|%NHe8XsdXZS(7qWN9q z`UybYFu#aHiutvLoe?p=WBS5!UHT8O0%N`ht1t{}A}|Zjb5>tyfiDgJ#$=*&w#$iSp6(b{UfWC&J z$_=~$X-lrJiKFlL;SQlwKQva5{|5s`0tOeNDo}N|kS^!Cv>MstFN88t?BC>Yu8$lJ zQ+Qezt|Ny3EQh-?0Oy(_2>M1{oOxapJd>$yo#I- zAp>BIy`e|z0gFU290wv|iEg2dw^zo_weA1s`;p#l|8e*ii2dpS_SzXk9jJ~lieja1 zV*dWa5jdguei%*-jgyrHkXx1DKj0GR@qJcblpVnn$1pEgdU(Y6Ty?m&8oG|ChbWbX z1fMo~=mXu$@4c_+-*8_2*;bomWJB}L?8zc)orq<55yaVx9%#-Nf=p`Tbm2fb%oWF5WS zs0%EK)XAujwe$$Sx=R$_IFwd-M2r0GUOX)--KY&cN<~Rmf&63(5bVu@By~y+^xUJA z8rJVCmM>6I#9J5>7xWcF75N4IR(v{T2D9=Reh&2Ge*B%t7#q@s^mPt>@62bM6S9%l zX+lo(A{@vj3>Pe%Fkx8Gn+VIgT}kpW0$_fa6=2moA=j=!az)lYAwkq|(u98Egv6lt z8(b9mca4w_P|2V-m45oNT3(X7>49*NEld)nJ2u8z=STYK_a?}lD%c}hY>yR40fGqc zTBQQf(qoj0Sh#y59w@@gDiz4I#w!)^imwQxv9gJuquNBZa^w-Mbo3%w3T^@&hpxJ6 z`%D*&KNk2ngS?4axySGhVgzC=UZ!7)ub(oVk;dn)`~yD+=7Hhi=nIPiV)%C^%Fj`8 zOwX+Fn5%aH0PFWA%FjmN=424uwPCo4fcv9B#qs^5@d+Dsp`QU7@WYD4bgziONu!MR z^71g8qzIhv&y_en!JRC*v>SD<8IiFhI0pGqsyW%Pp;N_YQ5cR%nZ~Sq`iJIREKPt4 zb84S{0Y>c&FlL8gB>!g^p`TudaXlDZ#yr_h)qi8yur*^oIyNN?tUriQrRbOBGI}D- z(2Fx-?K2F{8F3(wiZCqV6{IJzhlzZ_B0HOB2XT8dVW_DXE@8aB zX!OMKAmi~V3&;0IlDY9_=lB8H`-izOfu-tL5nSSBVb+iJGnb_#INqD(p#%s{xCSi} zQ6db>kTBp(#lZ*;t?1B6Wr*n)59nnH3(NWesw2D2-R*Br{Yx3Y^j%I)rV1NltaqRx z%q=F?L{HpD6rTljJ1l2nMbQ}Rxae5ny&?Ku!25|6!*cL`OrQ5$^!?!L^$YvFzuXmp zKjeD-+oJC=ez^wuJQV>eX~`uT{hWR&J}c%^DAjjyMT42 z9*Jf8iMQFy5;w*K21a3o=dmsVV4gaUzX{h*Biby}7u`0o%q`Az;EHHw?Zy~#K;cSWnG^zI(xkoKl z1*LzJT8hT?RT>+)R;ZNj(llAtjEkdV+&jx+04{5^Ax%^2AG@R>xy?_H9j$r1%b6wCoB4m~kE^$dz%hn!v@w>YT>>}A!Lh!jU4gN5!{AuL zSQdBTV)$41zT(^k+SRpct#@tQed}TrTkmq*%BmiI8Sr2K$l~Y{gk1NTj4$g)CSaT@V8Nk^Tdfeg z@DF&xf*A+s&?PhU+7!a-lG$8=3(wFkU+@WG8|hQOTeWX(l3dc&xMEVn#t30_w1O~> z!04#{SrEp?_}}tG7-8G~rI*|t>7SiCbwR$Z>%4x$*LS@0^-b1OpRL+=OOl-5m6Huk zy<{GAj&4|od;wEk4q2(|5Pc9*q_p6DbG+LP&fSVgnWu)Kn^-&a2h~y+D!N1lk75`w2(jCc?%^ zN(dv@5d}5x2SBOFQHPbQi0X#1%7!}C@^+*Oe>qa+Ka5k*mn^g;b_QF0DP)%r$T4ly zxZ=JrSFlmE%<^B=p(7gu;7zTdEwhugw&`qnMkOooSJ_DIfU2%=J!dH*peMoDNQdj+1N2%fHAT^S zbyFQymaD(X;-GK?J16*WbIaFb zFn8**Pg@R5_^otT2A=Krrpk9y&&`dz0z)e#P>AzX7&ljO%ZD?oL!GMek{9Hfii6wH zt!qu{*&`Uo1Sip0BWol&qHtz4lz>5~HXxwPj~Bz~4-p5nC>8^cQf$2yaRLWZenVLz ze&U1(9B@cXM%)k+@5EMytpTS(mFuo^aJ{fr4ZouGrM?n^y@uR$J6opf)7jTw&Mh*hR_)y2R~#oOsAe?L+ldj$>>#j`H(sZ4S) zQ|L24MQ25ZQ%B5@(SL?1d$MlmXl+(2VqRtpnP3{7F=~PdrdZ~RSRqZ5S)1vs*4)1} z^Z>Rbb6Sk>N^h~0M=wefrD{!UXN+~ec@=S?S9!TM{GhAENh|L;0ajtSgvQIOfEtn^oQV zRr{Kfd~-WjHPw0I_}YOJB2Qf5C;ev39bLC&)xMQU-om;`BikP6gcFO#T41hCGlCj~ zswbj8w@hA7W)L@+#*DPkzhHZ!$^#@s=~vr3J#ibJDfEQ5N5aE4xl`0`uxmF?nYs;Y z!n`v+e@17a1~P|xjrajp5#xSsvo!%ev0ayWGZ+*fL!e?{g`CAq*5s{OwGYu1$8|QY zQ1pCOD!2S*Y>Dc#0`*y1ZR!J`nj?=y^-+9ts(eRhgI>{dFc+lR-UZObPph?tg^Ofm zbDOQBvI++|{A_XQs(mjc*#>tOx6}p64{1_MV5k}1kqje`=(G*$RPJ3K^j&}kYIvt> zUJPRILFl&)=#;b@CcMVQ9O!ji#FAk{+b&}lNF%!$`i8!Pc2JVep@Gc6an=#k;_#vv z^jXnWH9DxC=zpp5t23h%boG=7CaPRIhi*q5l@BS zWgxU!h~*80j27j2AnmKia%vh5q3?J3Oale^C;Nts*f_Wd=<`&Qkn zf6Z()reS1)X4L_eA4r>t2adwSGUX3;EBX!f;vVxvjb;CC`OI#`c^jC6vnUuihG9Fo zJLFK;pQUp*mYMXv@7Qja90UHt8zEaqc_uT=W@+0kaGyCAj!Cz43p4)a~(IV1kPSKuPc!;VJwTfjYL>+~4ly*0XXyYN?#fDV1s%>6H_iL$+avFA7|HHX~UW`wkAu z4TPDqY3;$QQ~su_?%LL7**0a-r2R0`Wqr-NLo=$ga_)xbL^5c=+otT^w$AGrxVd&% zp@-GZc&oUBO>bVu?q9n5)Y+uQKkcKJTRe9%;m3{d?R(qnN#8=D67OVCA$^_4rd3zt z=7v|WTj39%gI=DSo`iT4rHsFnm00c4uZqX#We!;t#uR~Bx3I$}O=L;-(E5W{(cEi)ZaoVcs-ZQ=hpG-faW6n%w z@a|v#fIB>U?Ymva*(W24VETuL*~ZdUrCw>s-NogPNaGnmL)43F7<>5X%L(K0cz&uh z39lwGc4P`=wchbbn5E1iUZ5-luZ9sX8_HZ_hu;-J{7mrbQR&p*pFj2YMSOgWnb{k^ z@3&stExU^wyi)4s+Serj{ohf!ybGJk7B+q53YNd*UAt|Y+iSB@p(aGmT+q}2eyP9< zrlnmSI|F~|rS2Hk)T%I3w>$!vt|-jZAAtEyN4d6q)H~YE;w=%Jtf(LP z8o2hg^7D==UDaqTB|H*>-vKE%;sK;f>J&(@L=5bJg*aru;eO;AgNRZ_@=eef5y9S8 z)zGb+-owSU+F}$Arh~DN^zd`O9`@dKPvLIBpl}I_&8TqciVfk_(iB^w!VOex$vEr^ zwv?j$z%Nn|`L6<}d(jprzulq6{-@***vJ);jdPDADLwPQ;_+kcDBK{$mZESsDK>QAzmKuNWe7G?QGUolxIiU@qYaRGrX#8^_&zo&f3^I+!!NMb!6|+xYd*qQR(23K z%upoCc%&dMNqvXnX))LdR1AU6)x zrt#qp5N~ri$?#0JVCJ-t?Fmn+(f6krPzI@v zG>ArLncM+3Z{`vqEwrfEAR0tDJ#*V5%s+Iw*LQb^>#8p3yA!P3SJolFN3f9W^9T|{ zT5cy42c63@afnxEDe4e~T-U{3(V2^`N^qO(2wbMB*k=klJ(z4IJ=8zyZU>kAEx5m?OtXUwEcd`@6s5`M%wV__A~h01jCbETcLaIDe`(@W1^Pf$^tmtRJ2OV84m8q;&Z0kGl@`=b^6ljpzssGW&8n zTyLGjr}e7NH=KGGnL8noPrdt<$8PwF=Iqz4hyiRG>C-iX+o**H(VCE7<>!t^J?zn^Deh-LuROk!d_@G#DO+e z-na{=uw&UYc74xFv_BG)ax`3}Q(cVZ`CaOPD5FUwQyORU!htJ=-*Wuy$)rJxD0@bd zvd5w6rARHVJ^f+opoS#s>~G#0iy%}3p#@SEoxk5jicXyLR7GbWeOCN+eU=s*p7ctu z`#gO0RfJj{ej`Bp7L1%L#`+_tX-&qQrn?O+R^%xjm&!ezwv=q{2! z2e0BalQl75w7iB-QTsHQ*SgodtAX;tYE5!{!Z?7S)Jcu6yJ^TgxyAMv)utE;%1eq96T4F8j(y?MVzjkV!3O*7=^{hxzh%dDnXj z4S63f;?w9v*W!b6C-1noFy8xo=3nBMez|H*-m2!rb)M_TnhuY99O*mX6uDsvmjgE= zPuv}z8V*;nVhwYqEwS5|b)-8O9D(42Z+}j-hJ!aW@x4G3KhufRhw#KCq3rV&r+pi)9SKQ>dx;vNo_gqDkjR`9f zjmsiWjDMvEaXKQs-u}44#l9f#ZdZ>APloxN%(Zd}j^S*#m)W;B^WAt1;CBhP8|d=) z3~n2cGv@tF#P+y^XY$+aq)q9F$x5E9YP;a$HmV)mex*R_6jjOnZ@Ls>w7Wki9qiZd z8lYnvOvPzu`i>u{KmlHE>RNVt+z7o#N&=}->8Gz+eC=QZ6tTt|*5-h(AY^Y-g8VGC z?>@UZhbLQhhVDb+053A8D@7cZTl={$^IdR3WMw_IMeC9_cBKY?SzO{{-Y)%%?G7de zxqfuK4lM%fN<5tz?mz!Fo;-{vpdS?ND(AP-zBkXiC+qw9yd3Zx$W4`)E=|I zIrPWmznI)xE%&xx7f#Rx%dGZ@Y;s^HO8uK`5}F^~->8f0<>~DR{aQ$52}w-F1v9%n z+1&`zbc?t!s)#=Km^6xCUq8?&m$x_QAre$X#}qn@lJ>RP@;&YKaq)67MxR;Pib$V$ zPa@Lmga&S2{V`D9D1I1fXae_!WfpmKdqcLnToEM1CzVCOUD>JzaglFrhu9?Oi*ava z$;CvoW|4E%s^?$EGPGUkW(jATY(rvEcF&xf36A1?~DmeNX|;LKp*s(it`w?k7+S|=h<2Y zr1^pJ+tfo(Ir6>8TXxb|U1F{GB~wpFsI|6oeQO0I)S{PG_2nlZ8XC4R>4b{aaR9C_ z?o?6@pj|`gVibSN%$*c!5c~bJ-@uU?UqVga@CK_x2lmQud?L-`+2Ri}X+WU=+jte66QX)(%he#4+{#f5 zpD8-Y8i9N)rVVvXtkFocGZ?d}n$Dce;lBQ`|NdJV=7D=8G2o*O8s0IIwK0qmT zG8&-NPClcNRK!11hMQyh`Sb}=LWvs`oq*LP(MTJb{s~%3foW2xh{aLdA7nU@8O1-_ z01*|1{NCq2X(_tx``c@lJolb^?!D)pd+xdCo_j8rHVcPNiz?L#kvEX0Rkok@1dUVB zz>gJWt9Dij)~+WKC&xXX;PfzwvOTv3iz!p+VwJwd3>^ z#{H5eOxyeLl8n>yj32*$c%HGw0Q3fva~4jXowL#(7YxhpQ})KBQkD{VJo&XC&uN#j zy7q9Xv4*1pfW-qqCJ;=VmFMD4w@w%Jno-WHu+CKG;2j|PFj5Ctg!j+(6%`i1wm-sh zW*<@4IR@0N26eSRHKUg@!XeBaXLb#85*lQ-R!%L4YTD$U1*XGRbCPn7G_8fwQI;)vWIi} z*!>>Gj*AfV8xOBFR=lyVVXZ@Fa+K&0jE|eKaO2^iv7&EZbqMkQ9@}`h+gQE3z(6la|dIXkFL=fH0zVLQlf5MD~wB*SjojR>e#Eq}i>E_{Ne5 zQp2XlI0QrF{T%(?|;64#edYuT28LSISo{V>y+Jei{3DzG>f~LxoY4< z{(tt-#0$iX-%(Zn&5?Znm$>v!8;FX14QuQ$)n_GrHE!D{39WN}&^+grS+|Wio!EHz z2S&MUA9-qc|Bfh|l488!2%mlywnTo!7ROfOdetc@I8lKCeK8~=Z?%jfJ7OL!4SJj8%~S}4 z_A2@D4!ElPxBQ&{ULH*HAIeKHo#ARkH?c0uzFEH~&m*~4RDgZLYU}ioOY~(@)B93Z zu>X(2$2Cgq@xX%T0}FySDdI2d*@;Kb*ntU+-%4;({L(1uI*n_i$jc9c!jrA{nP6W$ zVD}#H7Mms4Te*;M1{PmHKR(YWFYk5RCL6|pc)mn9osA_cAHUm#w{@{QG~KDP-fh~x zGnXgjfVczgi7&%>65(sw zY+VL)qmN3clP618{Ow$9jtu%fY8XT=cqxhR%UpTJmH3n$0pa_J3Ge+8zC!CyfG>v- zz5Acr7XK_)zUE3?MM~SEgInJ~R2!@^xs7V?7LdyBy3auJ-vBa=!{)eV{e$aeijT6s zbA5FE0NGaa-8hmi$+g)7(OfnVXczXiaPAr}W}UZd#%Epy3XOLd$2$?|7i+Acs1zMt z0a0wI?jzC}@+`VuQM|@$-+S3#fX=t9^U;u06LfnXwu96duRkIRr=%|(9_M;h@J7QS zy_RSn1E~sh5fLZYyrMc2-_s`hhbXT?9F()776JxhhJ*@`xn}*FvMN_nKWAlKWvpy7 zhl$~u4{(rSSVh|48K$E%*x+midz8%+V6XTNxPX{1$@v&o1tmnH)iizirQ^MGv7>f$ zOJM=msLa|ty+^X_i@BZO1Gq=>9ysMNj6tMmK9%j)hH$uUVK|l_kQ9!zjzHO5kKOVT z%6@;$X^-8z1<`H!k+A*^@-u5|d^#00odQi#Pq~k-+!0eM4}NY${7#SC5(I*4fxry} zV-7Szxlc}rd}%0ItZoau7~_C}z*qmpmPtF~wIV*x^JrW#jazIC8gF>0yRT!9u~+ zc{VmYHk}T<#y1-`H4a0FfcJ&(5LPA=%)WEMADzYr+5#VH*L`YJ0~8aT{KqH=?Olz= zi}0_wS6y(yx`G;@z{OXnD;v1Z|Bazc+^L?Vmk$s;xhYrtGUlk}yb*Sx@}N%sJ!O!a za&URFJe?neft8eAG5Rj6v5id`9sd#1x0cv0m278PjKLEl7D}u{2XP_wT*+Sn#D0ED=d|dOcr~J71LOMGF0z5Tp#%@ zrBb_YW$mgKtV^!Q|Mg)0tik*rU(N?1>M8#={T@B@^Ibz<6*tE4qNBJ_@P78j^DW~* z89{!SG9XGsA15y3v04Nx2@TPA{-4Y<5Y%y}nFi-NB?g<~d+n?d95uXDqnf5NjQGch zcSal<0rNDT)SfYD`*YL?QVlOZ6@@{{kp8ynV){SQuYL6#o{#gLv)(cs*UB2fIUJV; zxbC4EZ&YxVaPMelyn621j&oFWEhVCD4}4)>dg9#t!{;bVX<6cH=+_Mxi z@ot#M%7@v-_M#$iycHz1_UD{Cv_UHP1=j2oZ!(E+&>ezmGo61`HmZMSl!HbIpx|4(Z5gLOe z&M`=H(jAKt8i+v__dVH@6!l?3~Ao|vAF#ni_b0 zWGHC37c=XxA$c8D(Z6E#L(Wl|cV%ZXzZ{Ibf$v(`3k>XM&iYut% z6)R6qFh0r`Es_>xB5ooMZ)(ATRH?S>=ib_%leU6Z;5fopr^tq6KUbx=+Eq(%hz~F7 zdPLjjxXax{`%FjG$zHO$=22bWY#RoWo4M|ZBKzwjr!RWrI@lU#8^qb^;_M7@_6TwI zNO3mq1mQ7{EZh(hXXnr|iV%G(n?&DQY6)u&{xG^@?GOn&uKHD%oOl&uNtY(DUW}$x z7^D&iy+h*@Fv~fVlq?s4cLHBf=P`C{F~eVg^B56?B*0%)7eX9q_zY_za2(*xg8-I6 z05J(Lpg|BnRT3fa|3C1(N#LKqGOT{pRP4q)jeOpu)lW^oe&g2DCt8fY<~n<|UaC%u zl;b6=>`2rse@JEQd_JC#mGbR;9{rm~6cK%El7AQ-B81O$K$ApxJ0ZN?SY3rq;sq(G zKw6}?FET`C=Wl`IXzq+zr%ya)Y*;Vlrb&y^3Vw*1@Cyb5fEUq-B3WtIgHQdC>b5$mX88)4@n#w$Lz#;_KY0^Rv<1Lov z$?>h4NA-vg`Vhwj^Xg{7N6CD{i+tY-JlQ--(&s8E4huKuCBF22 zuFBHC_J*mte6f!>K3{Ze^CfKofa(^S1KKfM$T+_oKZuEDgv_RDQ~Xg)<%OK#U=qMs zHA7(WjhYr?sf{oOEGpNN8oWpE)@M8PIdzMSb&Je5AmaH|oJX}7w;FCkrH%T0hrR%L z8`qixdaAUp+8j_*rSnm#UK8J-Swe5ghc&K^nnr!L8<-e--%y;o1x|;2-;F>M*2KMl zi>UM6>cM%S9-IdZ8_ffcX8V&}%|X3=@ulmqgQ2-X|6MP0VvTBU#oZQ@`&vi?>oQH{ z^lL%!xGTvUD)jSV#v2n$N?%gA;}H#Rcqn2^Fx3v)i%21vqW8wQ#9V1BSd zQ@J8vvS>`tXAK9I06fbG3MgU|BMX{hGL=r}mcC#PE+6mbItHOyJ9*lE>35S(az*NCHbE9C4l%bU;~3w zg4O-)DG^+(*)n@7FhNy=_m)rDcDExLfvmxPV7l2`#iAy-dC~dULyPT3z1x^}L$Lv|L=l?RI`uOaJd894woWSeY5sp-Whzp^le^ZI zbw~{l3o^tEgJsGFh5~ClOx(&gDE_$;Lk4L`pk2?*f|yTj#^&rCE33fo72HC;d**16 z=AvRlv1lX_&)5m3k9ENUO=W|wOlqF$nv5~*%csG<4w4urcY5jr%s=HCkKLn#5)}(9 zhc!bbf3g?!!(|$G1?Se}xJ&XHHKW`b1Z^j+#a*Fl)Qom(@&-Tof;;wV;45*IN>$mb z;HQl6%^Fk`yarWPNzK=}uGTNV7f5SRVgU4uuy{oBF4Y~$1G?mr#!&Qj7O7*DKYQwx6<;HT#+KYRJjr!4U zthdUl)SVBIaRA1GZ2`|78Wh>kg7Ffia-RkCM*Cb}u}8D2Q{DQ}b|9Eyteawuj+wdU`42f}jy6}}FOJQUvwZ2oSUAymt!NHtXl>b>VuoB4SewUB;QPME6<|X^CCM*0ZCI;t^GGgb&C=xC zH3cB}(wRU)tHg}y_(7}0wIQ>2y6azRZx3|bn}+JQYw{(Oz#BGG%{aElQh^^sC4!%+ z1CohUJZTiEcv7wp4&@R?HD7{uqm+VnqmKpJa|$htwzwq4Z~J4#}`<&k?3q6X4Q#Z&H9M=|~~6 zT})s@-lKKv^F<7bXsmOXMGT5)oDWt~1_g}tz8d;w3P;b* zu9NERPyU__L*teV*vbTA z>A~gfy~!wNuhB_0>9@Z}vTJ9e#czF0-4Qa%PZEtf9OK|uWIOl#j&u*Jy2j3Ddw&KG#?E>&>caQ@$wHq^^7o z`!LsApjWfsI-uU3!}qvm$yWlr{nA@{*oFG^YRW$;Y5woB2I)Q!4?f&TdH?e;m@+8MQU;~jAXspZ`aXT>IMO?JNgEwJ3F@TWv4j*^>;0W@` z5!Ae+#*^f?HlMNnC1E=w#>^AX*nznhE~Un>Hr|Cs{r7gqBWltQ2NK#42$7s*kk`t- zjuC=MJ`iHH&AL@xnP-zy^2HRIizL=lXfBdiPf3DVTQM@a2W~LeZ@`e~TpdIVhdx^Z zF_dmt^t6R>bIS+jbP+w=7+KwLdMxiut2B%QHBf0y<1|(8d7nI# zg2z2w>%jbK2cIp0PzqMuNMHgIG8!D-vzs_vZOC{h8o^181TV#ijFABt1^Chz= z5M#{%V+l#da(UD?d3z?`cXy(BlXbniWm9pqc}l!qUABo3B`!HFISz|>w*~{uBnC|_ zWi5e_f?Tpb%$Y8z#3FUG9ooXZYHv9tES$xZQxMYa-oMm>Z^b^%1RJM>ti?j)TE!vc zL|J+BRPS^gF|o2KV@}sjxuw4nXz-I;+Qn9^rbO%X;WJ5Du4sx3EmyVVvJb7c1;ysa z%||Ry@VUK0^VImoOO(di9p)Pmr^{FnQQagt^bSXwUCNC}`G&NJG`dmBb2~Da)l5$G zfYn)Pa%yQ`g}VU@+rpo(Bhcwh_pCnumV$< zjuplo>dMuH4sE_2b}a^Ghrx=8(IK$73vyly^%mB%6{r)p$7I%lK`FBk_A67Fzi6C6 zJ@>)6HKf!qf9e-mqt%Br6h$QXQDQj91;BC8DIxj?InF!XTCVm^x5@S6xZ#lB<<0mV zSTF%+B$HQ-I@unWNffCE={0xL<>t&CY|cidIR`f3;0(IXi9}cv{4vASDCA3+3bTx~ zsYkM zNm)7A{0A18?PwP`1HxpmT{zW)3@AO8XzmQo0mGF=vALbCF7Di(#n&%QH2dWn2r;w6 zI|?1Ta^b}HE zIZ>^v71ILa;0LDa2-R61JTHz@JAAxD(&azrT9fWw5y|G7XT|#xn1Qq6ze}ELx`hJ7 zj)N@$+ji4Yz8Ozvj%GJRP;s5-G+yW3)^Jjn|Bfz}tB>T88*FZZY7Np8iD)$f61ZpP zDylJbHsxHwd@knGAPrjlxl4HS74X=lvb+HGHHjHF_ECM)!zWYo-${*))<;GY{!9h` z*MR>ve!7(p`3ZZ4a{nBpvX0|SD^!)UU^cXPkM?IvQLp{MqaQP7VuIr#F3+L~g zR`Nm*+y?B09Ck1W;X+xb=+zbFcl`59L%)NcQ#w7kMCXx8oqWufh$!z#9omI)V{5wW zUB&OP@+3F#o1W-zdLsUv{@?Vt?(7SQ+Tb`^24Ql>0%o14Zkq1S<2J4Cd1{NMQJ+43 zTK=Yod!EW29TtLCf`A5qVK~?A?g2s{YZhK^H)7+uiQd4+a&`XCP=s{LAD_> z46&f@mt&~rrfkn%{upzgXYKD=ItL!M2udO|IY z`V-!1?66O{>s|IPTSI8P$*;kn^WW41N7qLE*gX@sOm9R5Td!`^>*j2=UVU(H^4`($ z7#=S91dqhM+?1BKb#KO@bi`LeuO9iTDV1Rj92{rZwQkogM(05rj`!y#OpKI7pEpEpFn_zlQ0Le^6T+pCyULb$kO+1&jYr!NhY*NZsu6rhzzZnrV z;YS_duZRhH4K^{XjSAn?&*hfr>bg5lJZq;ioma?M6u zmV8g;`Wvbw;sXQgre9Y?${sEs^zLh?(pD+~(lkhGbTwmr;3eyqP@(<|uUQB80D*`q7-~9&}QUlpd-X=$) zDR|WFp3ZAwjmbJ|x}XoJwDC})@*sreJE^ZA^xDSkMX!xtgaL*wX zNdenggp|9SZ}y!oG!_+|%*-@o&iTFao-Zi% z;Y+;T$KAkBI{c3B^y5Z`_KjkA9+VlxvUIU5Lo6F1mW>q4jAB`)Se7N0Ws7Aw`CD=8 zx({%iMnAqa?Gz(+Lmpsa!=McVxP!@@J#VV7R28}-Vim#{{;^r9gOf8KhX!6o0{P5kmgBbs)=spIb2 znwGZcal?K3$|sq)|NQtOXGTiePZn1S{c1y|GeftyQeB&^GGr!c;P$DyZsoC{k*J0h z>u(r(4)Y(%7~7Sug42?R-*aG49=Kn|M4-9JYcMMv6{?jLT4za`Vfl|YfhYki5iEw; zEEYh+#$%QjVX`VXF*ks!jG-bm{HKJ=&1>8c6BW4Nej`I6BvDKmLNRH&ftvGsbR18e79h&>G%8xQ4TvN*}X9!x|n|ZYtFeU&GJ- zVbahVK0=vm*xg=8R917O#46TbrjyX;S9sdYs7MG$(ffQ z`I?T1Thtq#3;t0h&a`1W(~7}P`UB8dji}ASjSr~4z$Nh+j+oBLk32*+dA0Q}U_V}s zE4lO){By#)Et#<%8MNxMcGzP&Y`xDX0-1t!MWTOOj30@J)O?2P&dc_6NaMf(x@Dbq zTbl2OYZ?!H^LW}u@0z;D%r9@ru19#z-@n|j6|`<>1e4@@z{Cb!ZTBe@8(%hReD{o6 zo8-F610JoMWLN&dQ)**rgDUU_!?DP&Q##RRV}(a00ZYLmW`V^=uIbc!!U3I7d62 zc@Ag3!&%^Pj&b^Ur^7C{bh#Z<9nPy9&an=s+2OP}oTAfllYH;XZpSSSXQ9J6&f&B= zoZ}tN2~J08#a%Bu9A!{QT#GT@Rnw1aUe{5<9k{kB`0`%)+z4}D-~fQybb&DUs^mNF0#AWloO z>G~9G)g7>nzz@d-lL%{Ub<#F6AC2wN#AgaP%+>-SnPbY(Dy6Mn&?H!xsMM>87_$Ks z!6`XVDL!~W#g2m&GfN$8ttGjIXR;PSKm2M?(XSL1hl-kCmPE8k<@V;Ber7GZR* ze>3$q<(d@IC6Fw6vsbcp3c8C_18BXhBQ}L5giD;v%TTyFBqv@%nq!vEIV*MUV$0iI z6DJ%%P`z-9^)Y61kU6%WgJ@obc-nWD;6xbYFX6mT!l)5R+((y7xXPEJo`w5Y|( z)Rm@ehm)XXvLlUK$pExRrz;r;E}HA|8{l$ zUzh)puK4ZyBkc+Q16}dCYP*Qr$a5WYHmCaU?F#;odF)EPHX9ki8PGDdq>24i^ChcuoA?Gcn&Xy3{T&r6j2YimwPZ zTL3*H?}Wf%g|mKfssDn-+9mQ_tsPNrEQMW&BFf}>v(xn%U)eyrbDdyKhjcOZsGFsT zk4K1G>zAJ+Ji#F$f&k!rd{F_JxKO}^J1GUNGlz5*iRz^tR)MlRp-lDFO|EC{Y_F3_IEm-_r^3qiuf$4Uok6Xg!p&G{p7EHk&f|kgZewGeJM~1REzMM` z?@a9qYlGLEnX$_Ez%P6!))^bzfwK4Teg>dVJZxOO<-}ZLxdbogStqvqtZ~^5s~(L7J$4Cp2K;c@&aklw2pRFCm%yc_2Ekp#?XeAx z{Rf1@Eg;eww*j$!^8bU5Sde!azhT5l++5A%u8!>;0XLEbq|y@aorQM+%ZSDJh;J>f z&{fdu@+atuGTGgvUPK?F`4VqELrxTXQ+?f=&Fj~!OB?Z2R(6#=qS3hCUATnZE!31U z`a?V1pyOJs0BJObF$Ybb5Lpc0 z8~FW;hY&8@HG}E@U{>gI!ieB2Y)CG^(Q9Pumm3zu1mj)}rGI_N+i*zOt9BJq!+`-L z7zn?Jx7kq-X-qc~9@tw2x*Ks8ADGkj_O-Ngi0RNF+)IP{I3hSYfiN`Kozw5kGv4W# zT2S85mF`RMh7gMo=o;Z`lCc+nL(Bp*j5JjVF(1DHA)iKAcVF_ZMpO7;9-4v#*Nc}- zAL9Uy!)-dTeJ#X;O+SQzwa4{^(jJeU^f`p~DBc9J`iCB(pC zS*fJcPa*oCKgOcJmg@qpM?K14GI9LI3SA-)>%qShTori)(Td5S`4` zb_rCMcfYurWt( zhSMFmx1rW);+z#i`RylyMn_<2HKgrc)f*xBsa>wl&^@R7sWGRaC2yt?W^%`lrKqsl zU;m=(kAgv<4dbW|m zbjlHt^=-z>WGBWe33bgKClI@N_KVxLHBS89gstP>(c{U4hL#gO#-6>gz~cvZ8}xx& zxrVJcA_#>W171`C?-X_A~@Cx%eZeZ_^v#N4r-yqi1tt`|52^ zY;4&4vTlsWv2JrJj`tiSbL0dB%Zz;xK^l|^j%5P?x_BH2u*8q4?bdoEw@&9>?vWaG zy4q>WNY9bRxDj&TVQnMS(K0h~%0_x5!`#L)9nAxqu30jq<%e9m&ILp@ZWe zEd9qI8X|CZ&E%|eDIvmJOi#m(sdjxxM@^)bN>|aqV3|f8Ivv7W*+4lqRyCYyii)E8z-t%PXR|Vg)>54GA6M2; zNOw_#pbSLVxp0BL3IeBT3oc7{Hy3+XTOa4Cy<3Z$rTh?`!_B$mk(zP?HVs6*d@4ec zkNUG*L!*_O5%Y1K2jLHAj_=6_NlicFfp@*5S;GDX3fq#;X$?~JwVr&NV?q`J^T>ZD zG$1n8bLF&h^Ci;?I-?opXuZCMnWa^dpp!~CwqF8|-2)zL>LHHO5l4Z-cMLHUPYiW| ztqV!K!N;M&Am-MKw5H zWjq2K9CJ>zuDfJvKom=|peLK1l>(c3EK3)wzySfepo#JzTi~8a)p`> zVdwI&O!Vmhj4esUayQ+b+ATOvj0W3*w5)R=09xNKkBI5V}@M&~{}0(kbZdquUy%J-)U zvfALByo`NAtoIT7akW*c1W)|)Spv>vwOK~HZ=_usLz1XDg1)&{vG=AR=X!PE8LN%y z$9cHJlCtNhTW>tRygr>yv%S-{ls}c3&y2=6p4Q@sLWc)IXni|@Ws>#|Zl4O#dfz+}PQ<_zEA*D1N5l$4#H5C5<(hI4 z_J`@2xOgBJ6G9$M(Wt2+=GrD~2^r=Es0tD#ehgf-S5 z=T`}>PZ~70`)}_w+#A`a3Pg+K1)Z1&Wl^ajyI6=sZFq}^Ud$Riw;R-#8hgLO6IL)l zZEpM%@1DENoh`T*X|4`l-8l442s;PZ%FY2|*}~H=z7dpfBHR)r@*->l*#2K*2o27G zlBC_(k*zusxbN^lT`W-hY7|=6y&au(SX3OR`;U$P8DIZ>j$Gn{6A-Y%Ilu?B_r_0M zgk`KUPla5qP06)VI1AXF0<}I^6~DQN8>p$K87YM@Z*wBe4feE++p{ zG+-tYF19u}aR3m&MW$zl%%$vM#$ECIYkdF=bux1NW*UK0X#T?-hWBak_B`G3xna8|I~qzp-0|EVrT8`469w!Ftb=YSCs@iVP%Ce z0k0>OsT})MKt`7m{&KOuntsH;R1|G#-=waYZ?m<=g3YeM^@oeFOSs$DV(Wy@K#9tP zfLT6OOh}Iu@~&$x!I|qoAuYLrA%4s0{%y1qV{c?(?+=lQ4Jhe%zLDS%QAlrfG#57Y zxSsi}Hm|@isk@L$y?L?!0{ay_O*Eq6=j8w`SH@E@@VL4v-{0A2yJ^DhS;u*I zta#H325m#oNeXqu4mZ2RV0fb^Gv;%pp-V5){-^1cJ3w@##E9KuO{ zSo1rh^E)Gfa{v6!xPIRw-@s7|5pRRD24Un|I}ugRn#KFeJ6)G}(h68v@TM3mmT&H? z6MfS}rH#q7VoHPZMyU)Is~QfNCcV9GTF$1)3PrqMdT0la)wHO{0oPJu&khaCEDo!;-p3R2CLl0Q^!rq1BN2kG>(p7ITPZ=Q?X^9a9urXygx zsdBa8)_pMEHW^{su~u=TXK)^WU4wbkM;-3FZz7}OrFN9u(}0~0q(>&+E>c^`vVx^8 zQ>}!tUhnVxTL;Rx@3{$SjR%T5w)$)ny$;*N%WtXBzV+O3e&D^1=zATJfW!ai4qAXe z?S*~*&mFGgI3AbZ>S)$k|EfBEtm1G-mFB%;9cSL|IK+4UxdRaK3;ZEHE}UqB$5sB< zJL1QA@Q2)oE^w}oRo))EBV(@pkb1_uljFSNLqt5aza#oOYFq2y-4TrUqKY0?;6s%+ zFRr6QPtbwjc6UTy1>81&XNUFg1lNJ4#NP*Amlj4ROKV3nAAFb23u#==wc4rwoa}>< z!UyZpSMswRMOgp3y;Yvk-dxZtUnH|c<|NyM=A#6Qa)C^>^_#?SGB>s->egTD|4m0@ z(M=mYBi$=*GIgs!VoWZd$LF!_(SfmjqR%EK-%Y@lPhQi}SoQ&p%N80J1XVMX4Gm22 zox!nP-61Z&Md_dX3;dp;{8k=)lvj4R5nit99ln63cd~u3SwMY~@9CJn#qBp>`9`pi zG(*9|u5rG17j3 zvMi0gig9I`A6;2SMPlp9LpCrqF+#dZGfV%u2v+}LI@~Oe{AGSwNA?s!T-`nG%UitlG z?MnH-Cd(gdkDdTfyZ;y~-`p!79W4Ks_UPNl>hQnS9)F=%{>v5R-$<4}*d9Fspl1I; zR{r^3`M_ZL*V?0RAgjgS+a3?}%CBEhes{8bPkVG9fCBy=R^HbuN882R%QWju!gaJq z_WD$kZ3EB~ejh8pwO4+2u>3Ra z(e223(!aIcwWU`M4li%n)Q%G|h}n(pQ6GSQ?cd1CKiO+}rd`a0i!h{Dl3y+LN!YdR z(We0G@vkLV>*ij|6W@lFf0b<4>h|cb0W14g6Rc}vul(>}yMECgU56~U|7Y#-U-!!L z@OH`fB+IX8kNzKke&t`m%6og|UtR%MlZ0E^9{oAsYW+)D``7nc{)bvivU*8-^ry(W z%YS>j%hPMQkJ8QK!NtU<70L4R+oQ_?w8}r9m0#OynKxMew)SWZvL5o!ZFfD^Ygxj| zTax8VlI3T#M{ftvef}A&yxeQKWw89s?NJA^?)Oh?ch&V;Ze!)G$?}tv<*#jzmIG+1 z|5{f5(O&s`SMbvWg6lszFupxn0=R1b`1athdWU?*wz}@6O-$w2GX|H7jYu_L}|3Pr*=cjGa z5rDhi|7n}`zG3~0C-J=B7S$pDTL1fmC%&Rr)?7iazb4_1wM99=P4pjQ^)1KzryP<$ ze`$+;)fVv=`QK`b*Y;YzXiM_B+@CD_MqBhV0EqrKsBCZ<=J;UQ18vbykyYs5*Ji!5 z*K%~I?A~PAJ#EoA01EtjSo@at$|u`IWm#gfa%U1Q(iVLOa5?@6Yv2F$zF^N7K%#5uBG9s)KylG(40$I8ZIcGLV8ZL zv8{7k+fc5@W(eaNm@g4{;b|;$NVonU!3`^4oGkw+rCU3LmkT$SDOvGfQPy>x{$W{F zN|tr?DG%={`=Oz;p$+)4UY6ihv9fW+Lh+qY3is`%iHe)%VTY#h}WhjuW19? zpD}jatUoDfJJPBz0WeX&FtWYYpDctB0ZeyMosG6GGc)$w}hmxx1WJ%hikmlZ!y$K;Z}lQ}B*cmI+7~MSbV_ zFwt0t9&(GFr6psPddH$(ht-JI2Yg?n1AwvKe#(+J$e>Dx0)-=$s$GkT4-@{9^=3#;pi!(9rd3IlXxrWZR7nI_ZCxfP#6w@N~UL^fFI$$oiO%@BC|+tdn0RpkuoA zDio)~%>^(;;#p3CVM8Fr$!~?x>8#}I@vLt+#p-;M$_CFR+$cMflV1KIxGk12f_J2w^TEo$H;CR~qTsWTgZ*a`9eLUIsZ5)VQ(-|Nf)>Dc8V*^iz zqdwqx+}{`urt}UG1*XUaoL$euHGA^LD^QTECR%JJ9Pz&sj)rh_6L8e|<*-ZWRfsd$ zJ-ievqwn;v{+~$f=}~|%08sd^4oL!c*VMuRIUIEZ&jbFShU1rFZn&*`I<|QvJtviM za3l-S98Y~=eSGpg-@;9FS;g9O48D)5f!c8N!SEe_^)Cs#F2ue|TcS(#a1=_Pw4E;2 zKD_;Uj2l=Kjyl74r1^gsww{mucuMl%1q5ou%^OeJl>E>O%TG_9dj%Q=kFIkO;jtcJ zcxHy9j_?oD{L{n1Gcl#xjp()>Zo1%H_X7MB+%pj+1CPjRl4(Mt9w9bTl3(h{-ydEJ zqoty=qTd_873CdQZXw0wCK&B#fZk-#k% zw64n>Ax{ji%S@NkTh}$FF$Zbbe+<~NE9w>X6Ps0-f~0nCM%hSM55GysR}s(KHbfdT z`B|6&EvhhXo5fo> z|D{%xoiWZl=5)z7t$}fxU=z1}^Q-7k)j2nE%ulJ)zG=uYbrM$Xz(;=#xJOt zF)1MOE;k2zbM&9B18Z9YqAGYAqDtjv?_(ZNY#PkAlowC`*c+0Mw+@^Az#Zm6EpPAS zKev)pfy^b@7yO2qfaoraAswYv@?Tn;b@I_x(5*J_6SsxKOX|UcADS*)l#c*mvkh|H zdrwu@>E9EIEzh#672R0RKXM_?sai5kAFDfewFb{~_)c(^NNbB|x*&9RwFW=uEN!hs z3j<6Nt_Qe)Q`5T5-`wijsd}%a^~{XcXt=ert<~Sw3defObFD2>|HqG<9dmm4f5bXN zbcO>}r>a?u-^=w+Zx(|Oz*{=Lb7)@izN?BEitYkp6w>txcNWBFeiI8y^>sc(&ls`#gz<(Ej| zO(D+m02S)a41NN22x%JYlbrv-R%@%OSqi=h9#}6ae2D%1FIvHs)~^%tebhR#Q^`w* zemzJ7_#h3Syo`SSlzy^xu7-p2%QgB+Jzf`z_(o1@knd+;KW>F(6A_!wI9m(uk1lKN zT-NG$waUv`=E7F2FZjQ|hJBV&Jv#qS=mYa(5w!%!aS4LROnfBIZ^e9S>L!eD8xO&l zZjoA>d4QtG_&kK?1>CUv4jb(5OuhjxdvJ#L=WL$t(D5ZxTW?oOIw7D_*M*Gb6e2VJ z8pZs{(^M6CpX^334l`7b`jK379=t&J@~#6Pl2T_lHwRa{tsGD^>V%TQ)~&!oPJV+} zg1x}v?eR?aK763OyBZH3z}RbUbsb1lhE*@;5t%*6(5c zZOnwoX#@dZTcath5r3Xv z+iHC>=KB4I5IY+hiG1rDA?I|YNw7t;C2Qh>idRAo2O>yV-rLcf8EnCPvVM@bM%f=m ze7OOiN`9CyoAQKzgQJ?8Ry23|#OmA2Cx=7OJNN1>e*hk95O{+0N+OfnutLbe(7MJE z%=Igs&R8!bv^br`nUbY<2RPdrpaRN0r4r5+&Xc=#KoxWSB~RYTerWUMJv&--uI&j+ zWCx)oxi0^KNTb^jK>N_|{vFXnJ0iX}{QWzEYhw@rI7h0cciF^hM9@mM<;LeA|8X2< zwv~wGsk@8p<$AArqB@z6nEi0H@ag<}c33Ya8gXesGx%Kd!y7%Xl6xC_pn2;H>pxVA z5HF*DFn6<(YJdBV;8zJq#QZH=@%kBJpVAMit&GEC#qRYg=%Ba=W21iw1^S`rV#)YW z`1UW^5xkVVfK_Y)qX=oR&{yviLAo&O=vv;)C0zLTfKC7@eptko(0(jC^n zUD4`)Gin$<`!qPg(>US>1?L<5?U1-%=0yx$(8SIMhU?|aFPKy4U zupr|*9!$6nkTIElA5O?NVspG|h(Z%}@lsX%n*^;wkDN^Mt@XAqFy_J1!C3aVh3czY z6>z|dB10Zc^Pm_MzM{;(LebAdcWm(gi^^DUr7}2UqB8#s zMgJMP<7xj#q2Sz@EpxC8*#S?6qNhR;-)jHKP<&48xG?ZRDEdAUe&zogp$V48JQCh- zY(T%8wt4vV`e}JBd~s&K(30s95g=7$3ksw^h)R7YoQFcuKLN$#{zIXl6zhL$U?3D7 zK*F#6uZMyqml3wYNs$m1XTpuFg>T6$C0~!0D^VwP2EzMtDEcbU9P_^%vfhlo57LtI zIzrJN_~*T?8O$+Mwo5a2)X|27n#8pC379%~wW#mQ^;LSlPXHhw?`P~1vnZGYke z))Jyok~a0B=#xNj)?XirUmL5;QVsk%6y1cB&-^kY`1fOF0-il7Zq5S9LHpdWfFH$T z+LUQxa{Zt_tqMgSL#gNdt3s|xMB|4;(K;kN?|&fVg3~hZ`b(m6o4SfG%bBy;#E$I0 zNR(w3^EW&JHLry?*qAAY2;fb8vGYxs@*AjJ^y7I+~ zWM9$K-YbtuiDX|Egrdt(Wz@eQWE~f4=5a)-L=&-|NmNcJ7bxYi?m?QG&T_<)-z4DF zHncOojB5dKeF9vrv9V&&GZQ4BH$goM@FSB*aOco&9A!)n@^f(gErCT?o5JXS5|;@* zMV^PT`ZeoO;P?vYgYUAjz>(heClI#|EulZxC^4mOS5>~n4NMC~r-g2M!+%{UJ}TB9 z8@M49y)JaqU;UFqaZ{}SwSlRj=wxDpYeMmySXIg-J@k(y`qpjJrq3-eR!yt^<%-Jj zT+R5<-49L7DNZ>NFhaR+(exj)jbcwaQGG*o;vVdWElWQzD=&SJ|J2X|k)*@uP;@lt z@GHMD6wiox;Mznq$gB&UwDIPU4~niHeyR{AS-!%}MA&4xv{2N5a`k>8ebDB zbu~i73So`wqeRmR+)dE9jwX&zANaf_`dLfFx5fWaOI#gWE+S^NxZJs1YdCm9%Qa1( zrk|TPv50}c!WOc@-Ve3&y_RSk2txk1TjE@-%nqdmrZ=~U2>T~Jd|k*_rbo4E1cmTk z@QBdzMPO404-a8W_V*7h(LVyuZvSg7u5Y6MmQEOSZ?!FtaUZoqX+wY?c(o%%DI$zv^1842tB za*OMO=p$d>8nBN3P>LC7#})h&#YW?;eu@Tl6mRfZO&<=@7r0ioL?1%Yr~E5hf+tZl z5YxGGK72!>qShm5MQ{_YOT(v>x9%hif8>BX^TVP0)26d1w51@J*Dn z{yJF>G46nB0Of)itlSlRW?IQ7>0*5YrQ-FtgAMXDfINLzV6fdMRrwHy^?HZ~rc4bw zhwVQ}^4D1Rg1<{(g-XNTH1)&dAF~cOV^oe;5B#7d`U7ZTPZW4iSQ2c-loDMBe_B!RSP2h)}f zD?cU)S`o?zslF#7Y>Hk6D9#}=e*pPBU-zb^;@+Rf_m8g+Y0iC}*Lj^^uXE1pyw2;q z&T(r0-1e{yfCRs}-SvOMWOqBjV`=T-Ohl#n)7pc*VK6I2QeT%z&X%u74GIp8?7`Hx zQh`m8Ykd@Kg$8>85VVH}li_*%wnou@(R1j&=((c-*8yyPgwi(5H?h1j*3dTPUV==~ z?W{lA5&ScgQ^4zjPej`lE%n%3ax=HPuAHk&@^nMi=5VL}%X7BO-UxaREi7J*N}82{ zex-Hm(@^-UP?!HU|ED4GU>LUz@^9)+TPm?p&7df~_Pivo>_6^QCr$p$QpU?T`N z@?tZraRqCCe1#-?{38_p2k6iC|05*s4f98_gS(9|uzy`1m-j&k4=CX%DHJ{x;*Yw1 z6gk79;L2T`_2c7te+x}$9*Qkw0^!Sy!FW0V;QImdS(tYWgL%hWq17xIZ(O;gIPqpE z{3eK@nR9NE`}=X>P-s=!a4G$@))>J$wtk+wmBE7x!}o#iRf5x6M46#}7~tuaygi|O zXtfzwS;nywE?nAaLnSk)1o5~-1C;oVwk{pCi1jP5<(zQ-Uoed?k@ZjD@yF4_MH)t0 z51$0HVl52hGD0AP^ewrVSAQX~K=84F^-x+12kgYZLz?}$p)|1?BMs{+x)C(T=;;0& z=rl-lN}#$~g7{F1wL03?cynFFp3Ne6!^%*26}n-(|GAJW5Vn|U&@YNUM;;E-q*oM> z5(b;5i!AP=Jp(KbtL(!C#@BxK7w$B7A+PV^`fh^X#5EVJT zOXI3Qd5YPP()x2qVJUbjLW8L1bop#ZAwCp^!#(xcXu3rnC)kJ*V>ij9ThexMuGb-U z`X301&S-lQ@$1065W`(dxDYj3AlL=NOgpasS@Dxh64?N*;VjsaaXm>U-NNrEMSp%u z%I{f;My|yMF%+HvzzYAUkhnH{ zT6yBmP*cpDiC=K}i={`8Qzn&??W;Vb~Q`BOt; z9nrId!WIC0e!WC*)d0P}N8y{FKfs34gmmineAcdDdKZxdNK8Zj*Q#g_bmv=O4mnG&`uSltA=zRrd-dS=xq!Cy{*fC z!{19K7M~82xc+uq_zp&<9wa=Ai3Agdft8 z$oiLP*OA4<4_^}uo)9GWbyJ&GJW<~WQ>Qi~*YhB5L~YeAY+3=E{@L}7urz8L&K2Fq zP~1G`lI}!DTezbQbB@Y-HVm6%$;w#VcwA_0Th+{|XF*Y&RL8Ea!2KadQ3B?xt!=B> zCP(^eoRY0}T+*IsZVNZd>Hi*Xax|=Nc;ay48TLpI?Gs$yA z-Pq5Urdx6xyOhDsXnQHnC-4*+B!Gsl74Emr)aEvtMw!~YiyrLC-aIx`Dtt%@=j3M9IkLNl@_*c=6{;y+dujQSFFjSe)WUko+Ors?e?ba8 zjQl)O$c5LC>M4Y|8e^-EIkBKEyrAvDnf}5y>)fy_OpLd)gfu5;#M0xQv;k1K!B=HgRBYBTF9w~jK;*lqhsXFu9cCoJB@Fn$tE&7pueIey#Y737A zl^g!lHnEt-sktpY8i1%jsZE?7rY(tU3;dkWNOKLxFc~zzQTl|ouo>(h@7J`6g_J(A zEj$7M-mhpA3#gn!+rq;E7~;RtN(00x(X?*FbS~TaSvSKS1+N&Rm~C6(ThVB$Gfik3 zg6vY@`BK_l%2FBT0m|=6Ygi3xY5q@J#VKKwDN46UAi2fjKWhy~Tf6)w|HrN3U5K~d z68}wW_#4D$`9EkCCx#)v-}rv|f47D&BYw31omO!I;)6GC;5szX7nqz<*nqv;8vYar z&-#x_)wv@K9m(m|@HxPq^Y;+UH9l-nNE61{*6@db|JHwy;G#V&PXsr1fNS9YgeHRT zDBNBVDz&cdp9iiI2=joR*UZw)cCPScH%_&fp3&2bIJSysyj;;Dx)PU;^N~@4-QmgO*(a#+hN)3K` z0}`+fK3H(q@y7WypuZAB-x{9PkN!5Hmy83>XF$iCc;QByw>RXlQfkUrJb$B2f7_%i zeh2h)>El8U+-_@k*hT5p4-ZCs?u|ay{1?ey){28ZfKHjbX{j zeFcVub?R|LhbF`ZO~=)_jQPb@Q)ZXRW*+;yyeDc7!iSpy^9yr{JMoLw@Gp=$RAFrl zPv2xRIUAmMJ@G?l;#B9sC*Dn*HRRMgM|!#|FuLwKUPMOQGQuprua%J_f)kH>>JguI zT#fmVf#HkEY07?OJ3v1=POq1k8JF=myp>W&Og#>FG{QP+h=p*I=b=ETLa3)-+F406 z#VY#p(5&!0g=`g`03+?#|WeSDS5?oILn@@EqyH1UJ5ak76FyYU9cSjDKjWcu|_@ zq*j*Z2eTG&y_J4VEBuJaCy^3dP=J2+2ZF~tzRFc6Xxqdm_!KQ265t6 zUd%=UZ{uFVm7tIy6?M39CAe9OZz$rWwl@Deh`g~7d=U&^4nn{BMKJiKMCa2Wq%rgP zpv8jw17p$qD>ZlwvEgl8^!hMZzq(HAIV^wrPY3HeT$do4W}M6peZXtY9|Tu({ttq# zk13A|ru1ZRzN%b=VO}tND%j=o_}>e(ZAPy7)Q-IOcjS~zTyQ`~S00a2uX^g$Q0S3oJYMBL7!00{4#-}@{vg^0 zhJgEm;V|-h%fBz^I!F2K3F46uVK=o+l@VJesA&A1LGh&A7I}XP<|{};x+@s|Gt#~9 z-xUDCF5o(+MRH!$*oi}&-N85m}k#I*ZAyN+RdZ8{VxPvZ=)E*>(q;D zg2AIvVYOV+Btsb+;#!snD~RgpNw5yeNS-ZjPi0YqldUwoU;CiB5Q)KoalD-!Id5ddUG8zzM&j@D!cr2o^t1__dUH z@cyF3OG6q*4CY6J7%jr5#AjXi*CN?Kj^xFqi1TiwD8Jg?^VA5BeWgNZ|(-zF+ zxb+VN8|q%J)9xbkf7DV2mPtt;+5~*^RhD5>%zzKv+F2`52ZlgrOoO9&+ z{8Th}w|puf$r!TJ(1=fefW?sNGK!PW9aDDxYX{mhs5*x=T-AAL$1WDR`T_|))6xuZ zOXoR2tf}Wrxe4Om9Rsy@moO6vkhiT32 zW5?PC&a{HV&p|e`L-{ku)H71rjopsM7dwo-^^mO6Q5{@_vWc0HYxTgd5kP-!bMm&_I z2qvOEdZgRU_(;G9?bp)JS%;o$YwWY$c1~(vYE$YgYm+gn&~$ZfTvoC^YvlNqNeq+q z`pB$zhgbc%5K~m=^E+@Okdc1XOy`OnJxcnE7{J^+is-0|>HN(O90iO$ga=Zr--_Uo zPouovlqvV+fDSh+Gw13!bygC;61u0X0zPX+A{?W1K1n2*&YB&V%kcZ;4ovF!eSF8% zcTJ{<$^ZBc@d{{SW%vQj{yKrMKNsk(%O|}v0k;Sv-G@rDCj!l zv)n^h#xtD-J9^MOg*&i|r!di;y2FWM>=V=y{;4~}Q@7F*7>p1wGIe9Ev2zqL>zkry zZ>Nny*HBBaF&M8ii-h@WT>3MZ&)-!ILEXgAzPJ!oNar_}v>A3?%1a++oTnjg7tF)5b_Rx%0+$baGg1 z$?g1ZI~DTZD8J{OV6U`8lqNg0nk3Fq`kVEA(ufiNITE`LP_yL52KqoAxUCK@{iV_T z$#!HzQ@OZTtSjY5*Y=tYaFkP6^ep!@if_m{#c~;x9@E34QW4)pF5(_>=P6rhl^w3N zI^U);9}ri9!Kz@C+>1}z(}^NZ)D2%U!Gp4fcW~(kmtAyG*wJ-i>VU-|cKcRh4a_G`xq z9ezyz*h{duCKrAJ$|5{6csjLbsN{OEfLzjU#wiYTMQ)$k8-BtbUR<7k!>(e=zeMwL zaFP^W9K3M_FGx;f$WRKOuCK31UX3x(;a|*+3C=On?XY4t?_9eb&1?;dhEsS>%t(w_ zW#k`mhmC>oZQy74deM>}T<=>^_hA+{;4j>O-+(~aX#F_q>459@Qa*#eK99mR4>vZq zaSC^qO?HN@GZHP~kvZ&j#o>yRPi7nyKaT=FBXI!o8{AgCbSrGM4$kMlj|W}75)$zD zfirQF8q(_bfoty3;pqnpYxPtPbR3w1__l&EmC*!lhq2nbVsJkO7O(G-CQ30P&eB5G6TTUgNCCMa*@w z4j}kPtWN+?JHwXZm`Lpz224B_gTe3x$;6`~rWZ-Q>3WHxk5V+H!D?qcB1d8>ewD}_ z>5oHN*I^M#7pw`#5EDF%7^DGQ?2+LZu}Jae033N)-x$a%_zuOsF__*VIh`v)^bX1C ztPujD=;G^yAL+-(`uiyW$kWd_;pDM`n~^ueF{5-w#f&GN71|l=U4IqDRy3!2JQ_WI z&bcJ6XB-(X?xd!hV1y6!HQ~;G2hfWCRVW$_sFA<+KHs54-YBPF|cK$ISoFSY(9|ku}4waZfe9_ZO2(2K7<~iCK zh}eX8BwEjb)+h}4KSV$4Af(I~5>H4|g|`UF&Suyvli@icJR%U8E4)rHOXNX_KwD9v z*>{+%TSRC8dftj!J4IqI@D%1o3mEDp(X|N`q}OcebZDyxeY!Qr*pdc@`bz)|^-IyS zpqNcv%tC#y2sQ!NwGn)DBDhm-Z@wuzKVCQxsKpg^Nj!}0rwJY>yh3m~REy1_@O7id z<*i=5)kl~0(Eq|qfwMlw)Mpxd@Jg3a5iqJ;u2gBhb};4;&Kqr?bqTG39Bqy<$Ci_y zQ=BtDr#fd@PF+qYr#t5`|CV?Dkj`xZ|F%Hz?o{GKi~NMFM7t^A*4hkptgtcQCHGkD zSs%+k4(|{z1_D|p=%fTxhIJBNH*59;0(#cToBP9yp@7+DKLzpe~=rqQwVsZO+HLl*W zLItXjliutt&IwH8yeg)lHo3e>DLjCxjGBI)Q|B?l{6Jlk;c$Fiv0+&}CAGzpmH}Q@ z98oDo^>)2M_8b9vu2xb1dtZ|yP^|P8t5)J6YNM*b>oB~p5sHYUrh0-r&x-#$NuUI@4B{h+X61T#y z%O=`B(j01WV0~dF?|zIZ?c*Jcm*a$CC|mBT;apE4t`Dr|1MV5QZjRMdXVh(OS(cyQ zGA_a?x+2N|M|Y3xoMJ*6r=G+BCAIpFJSLFexbvO-f}M@Piu7__5l%*QbBcPqU7>{k z9P;%?hW@oHOskM~6s4U|tpy&bDX&KHIla0h?~>n{G`xHR8{pu|j4m9&vvOdLQTU&2 zs7d>7yq=x+i9fVk%I8K`L_M{mRyaa&PEKJ-8lF4S61icSGaR+eJ4K{+zAGWm>?-LH z4ia7@$=JOc94)TJ_7Iq%-NHVCW3RZI+6a_qb|IdWq-$VgVSdYRF9W?h$sf#8{_AYK z3VxUo-t0Y5rhaHa1lU7?>y%WeLyyBar;F z-|n=*PYafJ=My}hl&!HlpW=t~Rcz*ay8?^h(IxOihhH3qWb*uEsbF)UG|6$;3UKd> z97gLcrHV6fUBbZKNRrxR!w|L=IQuxK^5=%}I>#1&@zT>H13MUD6;;l>$=_bn(t+2F z;qHbl+rdn~Bbn|s6;8J%^U9U99e4U_S8@!$R2Kf7z9Dd>-X;5`dWJ}J7g*9MXG=Q# z7AY+0tOc&i(z!?X!Cl!BLLi;KRG8rHspjAKLp9w6&U98nLEBdlN`3)6!WX+Iji2Zq z@kJlJp(+@7UZL`5q=pLYX^i=CKZ=D`Q$N9UrE!mTSm_B1V7`6KB+(X!r=khqhf%LH zSNgjw+E9)7PSm^**%?k5g&C9!8u&r~#2RW4YOKgtdGr02Ie3%Fu-gz?WLRPl?j|%i zYD!|wrT#z}d)dc)@h?-KPmAZA%KYMg3~2WxwPUt_x?UswwczdAB+gs}R^a-P^^ieJ z{FoudE5L_{4}_lpL4kSv!@rxth5jyIB2A#*4Mg9GXeC_J0_swvf&u7F6mY;(c4rNF zgZv>61pfsmI%b!GUAfK@&Tz+2yGq@%h=?lqO1y*s=|S~ChwwMT-j|(kZQ0Ie!en}s zz4#8NlRbP#w-t^7k5jDej@-=rX^0;u$IqkqdEL_x|E3f_5AiO<7s&BXQ~cB2F2uhk z#XpVs-?zNO&ynL_r1%%RtmF(#*dt-QXv(a$t8!YBsC%G>usd11%4TUgk5^ z`D|KDt2iW|7o(sP<_v^p4}^X?5Slp=e^5q!Cf z|8p6C1i?!PzLepYTYnZ^t1~ob98lnC6~KNe;lfuXj%p3L>0LesUVs%$&m$7t^?(HL z7*6md1YacM-!J1E3BH`*56SrRWqbp{>j{3Jj9)I5B{zl2(oFf5%J}mnct;Y!I|x2g z#-AhO>j}P>;L~LMG8sRC;7164w~Rkq#vexTQv{zVa9S`4-$8KlFrTp; zU~K97WI4+LvseqKsIrW=3p{nBy* z-fSY?%rYi==4aVb=={%mceF@@tQqUHsHFH}&gLllauks`ZC9KUj~a*}asv4^6#}{r zl2@SWSzY0FWSDA`JIHcuI^iW8YH*))Ptklw?;b@ zeUcOLA=oF@-WuuC4oWNjwm*6V2}O?EpeMmj@18W*1W8UBoM-BwbgthZ9V1owJcKv( zT1Kec)-Sx7OSjp)Ef$;JbM|aFqc2RVCfM95KE%U8W|d)$DPmTi%iwx`hwf%Y@&P`m z;$F(-u>*=Vej$gtZJ>dc_Lp>^5p+PEXr7UGqHvqsh}N1P;KcXi+!ezSfB6F(z8}XP z!wEkA1DqlKI5{yK*P}nc848^5b*lA|AK(nT6-TTB&dvH~z+X5Ku{dx?P_9*Q@eimZ z_LoN8Uz*Av;DFiW*17(NSnDkO0Zvjs&XpLB_|Okx_wFzcKcMI zoWtT#78%o33{2#GE1u&~3mx|L)0@^$Z%`RSpycK_xT`0n!51hg|JYq!5BPs z{4Z&{WA(d$R1hgL0aS6~ zf2W%w({+79&5TzHN;%2b3*|!eq z%{Gf7DJRdOh-WOBITaQ~VvfV2(C3s|6v>u~RLlbvMvDT&X)*lWS{$y3?yil$gF~OtdpmI0}*Qb_P9ii|1e)EB69)$sPe17(--ygsEDy!w3} z42~djQh(ptW>Ak0ZZm5-(SzQN^VAEkQ30_ua>OgJ-L~uK?sYRWvqQX2cIVfl`R<*K z`ANLChhqYV$bEqQkap_xru5>F8wP@#j9mGm8^HcH8i<&1?-DD#l=_?KngFg{1}t$n ztPC76ieCd^BraVAB0QF5c$N2b1db?O{{bMuioX^WPJ?E4K>rblBwMdWLzTD_hwrcO zZ6p=M6$CO!Ln8SR^+RDxTNGTyjQB>wR7D{)P+gpy&9m59kjq<(7}!lXIo2>2J9>8N zJd=~-JmdN25h~WVCMQ>0S`EXdXYr%e3lTSmDYiK0u*G)I(u%vbN|0oyUc3L@;Ul%C zvbe@DR|zUr1cE|!fAd1@1sBOQTIw^ZkP?`cg=|F6ch?B>DTd@4ob#7c7^(>tf2dB% z{fj|qE9u(uTT=o7SC}PHHF)Y_F`yKR=nGV)(XUgVV0eC5vA4W% zsCqKf?Jd~{Ib|;EPGqu*@2`SHkj-SlE%jKYF7vZxAT=qLNv5QMB!f+Tf^Uc8i;hHL zyqrsQX0@R%v&m?9OM6dT!#oqNSf_8sb$53nhd1d)RpAMGhN&x%sAW@<=XC7_->3E= zsF@^csmltMrPdWR8TVhv7)-1#akXaVGf>&ojr*)PBTYz=u*bF33zjXl^Gq2$yrmvt zg?Iwjjibi|@X~Dp)Hl5HIpyO@w?1Lj4sPY4s7<(E;`0hR^mgOk8~KkoU2V?VdW?l_ z2P{9ymm`eLmVZfO$!y+=`>}|?a}aVw@L7t0?yyU*_8z^4;piW}wV~k(_N*YcK6PvJ zANe>w!`HF`dP~>?8??HJUgPb(#vA=ZWkfhBSU+TI^G@K6@NMnKtJ7SzupqbRUW!+3 zZGP#Nc-2`8-m>2FQz@V8EzN)WUi|*LlTO5rp~PRcH19%WvTs9-cuRLNcXedy#KgBv zOLN#SzF7Lv7yGPt5>vXbunL-X|AxZkvkw|b=Z5E$IocfR#u87$@AYr&hC)8X^cht~;P>Nmryh_T`M75CNI z%Ji)JjSsy(*71K@VBx%KJcq0tM_Nke5zg%5#!b)1@j7Dj<;3R8i}icvvi$P-HG8Jv zr?`?|hG!S6mMJ}pZ{m0s>@UEMZp0T6pSml;2f~TM>Sl0(+k%BWA)rS`v3;C2!YL=> z052hjos9=zKU^A|CzTs@A-}tfb7k5B$OnF9iNj>4u9BxwtmjF?M(}|ed z_uYhiZANH9cbpp9&Mx0~C}_sM;8Rl55MLN-R5*0;MUVJ}$EX~bSs|Bj?w1a_Nx96_ zu1@g!4sL47hFrp75fFYwSS`!x6UIF?^yO*pT-k!Xi^PN(9pVbw!yumyYb=EFV7EqR zaS!#EJ9b_-TPg_RW8ZW7zp)=%)E~B6SPRrGzVz(;1e`{?s&1^+(Z+4?9XU6r;NRb5 ze0w*JENbhSP5r+S@j_#TiJ}3U(@S`kwPFMqW^ z6-nm1MrwqSQrreZL=#9(kiXg+BgqNf8-x)QMRhb>QQ4G+fC`f*tbBxYiMGPftd!I~ zNiy309X93u%24wDTtR}gD|XgP@$quJZDfnvqM$2Qf&^*L#G4vi_eep}pAFh4R=@G6 zpXabtKjWRKobhhdOdqPjF7%ttC{)Oc&{Zi^w)3KJg+dYrw^Jv4ar3JsSGY9rWkH$? z@)vljBBob)1bP+qv&{O$mVT`ku!u+4if|3WaR|F!jjEvx zVVJO{rBl;_OEPandzKKuuWE6<8SQzP=~PhqH=}Bo1ZG>X@m5zdXOq-@NvcSavMWge zI)FhL0y^JrkpN;}v}ZnK5z+_1_CVNA<@@s=ilB_xYA| zJWa)j=P&n^FrA-n0nJY@tBY^RM@;!rT>vS{_3>r3LrQmcOLr2A{XbFl6zTgP1K&`F zV3b2V2j90)_IP+Nd~ypNZMvLa7Uf|L%2(`J#6c6{cxMZIf9ETF3I>OC)@|SR#>BuyIAY_%UFD<9S)Ncf*unB&-u4+5jmdL z4+rLjGg|dsD3ffX+w2Vt=dyCSo;#TCoIpI=70c@@5}kKAYnY+il*SdAnVxKlxe%9r z_+W3t+bxMwW@nGw;BTi_Z9lxXF>>VE!PgpJQF2v#pR3B97s`R#tALKF-JIBgSG2Em zF57~42bVcO-_YVGP#ncW{d5Owjv!$aQW!#fH%l~A5u*m<*{@~sI$G1o% z_T=QJ*G&k~8ce%H=|GlDCkJ+Tw9}(+Yy+iV3J>}x&CM3fN&S~_#>$s)nnq>x9#E2^ znx~eJxA6Jd`Kf`xLixMBz|$NFEbJ~6loU-Xw$t(tam=`p4M1uEe-ZE^-9=q3E32d!;*d=9y@|W z16TksZ|&xW_>RE+Y9MThrBW*yVfZbH_;hp17TmZf`B+*eP9$xK_%h^S?Rt=&+d!RJ zdqrAV#c;c1GU6`8ZK3yVa6^pjeV-&?dh=TudPYuva&h#d+<%b)o58bhpBxgvHlr6uWgz(mTWjtG3l~_{bEKP&)8|L7?vK3fr+k3wAM%H=3Qw;pKBV+&@x9 z%)`6F83A*e=t$uWj=wfn77h=XjjkylmoLbc+84ZQsbB&=PP|NS7+`G~Xs?Lx6Bwd* zHVeOy`6pKXk&$HX|JU-D4k~{u<9M;Z{6hzq{|+kuy8iO#q5SmB3pSzy*kIR=B8mLJjz_^W^yCU5%Kc#rCL7C!I zVq=z(zGz`p!`nr8(z7xdS{bdo)ap*wxJyTN541*tJD%~P-!>=0{d#E{d{b53ljV(P z+8muPr>4cVJeE7D-E0*g+tL>;|3S8ZZ63DujPc1BzW%sOF6&CbDwOw z$#W|hxsYeWv-`ruk#I(rIelTPNz9=l1`QvVcVOrtNSoe-kMVx)ecR!=HEO=C*;1i~ z#bM|0=12EIsdb!a^0}@fc=P6md^oIG=p_VMuBY?0>vX=>Oy_HMI$w)#?w3RY$qL~h z;kIWQbn$o+2GUZuoYpqpa5j!6RO!2YoIw{yGwOKZ;DIWw$3UW++erVGE5}`I0UcR$l zc&fv6VH9;x_sBAM~NeW z#Ye&ilsHUMFmySeIh+*B19gy|vT`dl<#pIpVRB`yYcKO-A_|Qpbh?sLR${v))fjJj zq{6wJmAtFrT<7MQr8=Hn|G+>$Fl7pedoWv-PW?+cny)uqhvLPsU@8nzRXD>`GDSBC z4U6B#>+m~p#z=6Fb>%$Q9s=C zP#^i<%KbX!Jp61B%(YUIH+M+#>$Ug={AeTCe9qb2+j z!vE7?WDeau1MdVfo==Jwd3Lyyba=*Sh8cTx$-1&s0UE*INi@=I5{(5!V=Lt;^_E8J zEi@@8shy7D&Lqz1Fm@f%KI(T(L^p}Qk;*$#O1qrWt{X_JmeO*RHVG6cFL9Y%UbBQ> zPx$UwPPbwsk2QWPPGNI{Pg5Rgw@GQ5DGjz|QtAF{8u7=(;Wd=z6zn6xJ{^>%I+jK` zP$MeOFXi%JzyWVB;r;Bt;kh1{@J^*jct;3t?tjA*m&o*zB)n6ER}yOvcM{CYh;vCR za)=FtIiZjk0QGxVsvn+`LK!YnnkiJhfdqJsafX?AozhH@)3_E(_2Z>9-%^^fNJBk6 zgGKEtDfV04F?RM}O!OiY;&DbzB_F06k-~nxRbEvqrfyy zT@T6ir+2GU_9(*)SPPOWOk34W z4@1%3MS*FS#dCJJH4rIdyy!Z7l51={UW>N~IlDqpJ1((yoJr0K?*Wp|++ER?@r|rcQ z%^>TUyGI3t7CCFGqnuB&+o{LcY`ZKRn>otz{ma$&rkGy3Hw{eWSjEe;3 z2O@F8nivVGKe18tHJjkBp?{}14GVTwoz~*BW*fPx{5x$U_v`EQJ5NGK7&xL8YAJDh z=9=7`w3geFC>O6Oaa<;p6)pphF%!BZhxo0l7@=hkNYtz_5U%nCwjoG_vU*4Da@+-AX@v^G4 z(Otwi(-qEg)|sw!mUACKNAEfnJ-|NNDxQy4_88O0_0ag@71^2L5nl|XccydBa_oe7 zXOWb~`X18U)fyC$#xN+&u@PS^*o`drz9OfP=)VixQLW-x;3mghYGr4>M~#0geW_%W z#(Dy2X0`_ZA=4*5MTw3h4eIaq;UJcA(`%<(=dw)@cwB$G(tuK9PYoS2cGPa4Lf%rJ zcyd!DP>l^Ms`=!#Sbx)z>3cDI@UuRykK-epwkyH{F1|;Ez$fUr;NN372#f!a!pNKB z4EbzV1d1iG7iC18^+SroW4{QyWIP!Ea!P22DfV+IRw_3g*fRXinO&p&!hbe^CnB6t zA|YOpkdW`qbpMK_b1;{=g!7g@JsaWpE{nD`slD_#&K^k5Q~CicHDMur7e|@8cqtLuKcZL0S}XA@Hx4=^ zR$T2M3m6>b;?*r2<-){uQcxY+JK(u`Usi0-KRCTB8>g@xV6ok3q3>AS)>vGcQjU9ZAWk7{l;d_T zkasETVo{)}5MGeup!1P-Fsu6G&_1&LP?LoZtg>r(Z#I>P;k&Yp8CfCgh%Z7p*aJK( zV*lnWbA%OuR`y=O+DFbtcEE^QZpmfd1{@qc2dK!d(|mkot3>DOBd$RVis$yTjVx3(=YX zzQnFMA)j%GJFgVM2JLcKnedSbwpTc&!C}WAQ6f4M7PVBOju5-^TR|z82o+v<&eZ2) z_#%zC%7D>)D=nw$fXq*ca=_UN`D0#%dc|Z|qy_n$Ms2VS$yY@#(=)w1aD13zC zKkIAJ9u*_L7Ntf3!l5XgR56kb|M@H6!Q;}BN^@Pl9=kM5cG|(S!|EsTTF2<>O)%}h z%n1C(+SR@~tq-JWH{~Gls;q(~Yv@w!ITXRjH8Rmmn=}(!JLy@QBC#Kpq7O>Zx%m+v zbnMbQGeu`mm}82WFrKqsyvNC64s!kV8g_`M?vQ9q!uGJ}UC0G9l>D@nkmr2yBqCx) zfdoh*q7p(5CQ^4278sR1NntNlBPZ)#qS2g3G~mw@G!9X%Z%Jy0d{hBxP+@&VDp>Q6 zq&$xh{wx0l8KyUrTz@9Y-;SCYCg*BCHR0~Om2zy?A<3M|M|c0xAABk*)h+lkrB1U+ z`H)SjwBL!<|5U90f0F8Nm2k*DwP?dY8;S49IM$s~{W1w>bO+(AxwQ<+G6g5~4QDTf zjH?hsQXLnVB)ZL%=C?m+5>DD7NGFkZ5$BVQe5u+ASxdRt>qy3Sz#W)h`}`v8c8?a! zaP6~RJz*pt-uQY}A8 z`~xLkV35j}OKBm#kZeED*BmUScH<~DMH-Zof?Fs-Ns`nE)KKb@|5s+3SY{I){3L6W z)PBR{f)az^^d(l%q+1Ib2xg`=S}vB6a8qKq{9_Qw{leema#%e;+}|wY4I?}#O0j90x)jYN zkBivQR4DBZ9d&;lQh1h21>cJVm=xz?=wpt;nFj7r`VB9-b<++OCe}BbMw%=$l4myg zHv1+{Tth$i&q!|)hP_z3x~o<&H~cuyRClnp&R4topu1#RKMnbvmG!C@X_Hi(J-jfz zuGRLh_3Vr8I9GkUrKH$$IH3Vo0PVP2R5I6c*wkQYz|D@b_`u=hh7KPt8BM}nsFze7 zcoazKt2^kP;i5IUOj^rOMwms-p1qV;s}; zq?ld4LwJt9pm}_je$6K~ID3*!g}yp=_4p+q0O>vx zQaFFLA`n*y!t448zn1s1%mhTZ5Iq%>E3!rpw3qS8Nb}`SBQCRa#P2 zn*NM}pPcvXhHeF40?)+#{VOoAK`4V*EQu?ykaRm>uA#={PK*6j>yR_-qv4~SGyPUF z^>aS0!^RXE0eKXIvex%u2?krmXShRfSxSiR8%MzuEGt z^l^Nq`N0hnIV{%nsm6V%`|%lI)rKQO&E*>`mNbKXD9#AXj3m2K#H1nS*-}J+Kc?lY3kF0`m+cmsV7eDvFUx)0qpT6z;fz6pRz3p4U32Y;cauFkI1KV(U^Ux*V#A zg^lzo%m2u&`KT|P@IV-sgq3iE6Fk?+kVnDSg>zX{|feyC#%d*iSpwI=GI!8YW_3GX(RRi{-}r`J?xl$rUm>Jczx zs`M?+zLVuuvllMKSB-D+gb8HRgehruxvAW$F7qv(e#gSnHyW3zc&NL#YM*#`YSyoWb&Vk{&fDXU#rqDg z@E*C=u%@xrV|t~DtD2O8n&HN5RoYzIH{i}XyDQ$+92MM+cwyIG%{i+TWyJ}V#ffll zsEUc{r=+@C&uI9Jyk)2>BrCd!duv_kJH~&(lvp))ra@S|8fQ;rTXyq0*J=2Wtx7ZC zf#%2fyLQEk-l*iNG1h35nC2!wyd!AQWZpja^X4`} zEk@Vq6UsB0+ObN*c7;6>#rktK^Nwx-{nQZs>{}`DGP1^~I~z7&?BaezR~X&s3Vg2s zQjKD@kP8D|7q$IaFQC&O*M&H+p68@6u`$OuQF`sCzagmX5X!lgFk*`&uO9;#-DO=gdaoZHhNr8zInhq(vk;xO<~#GvcyeU3M1N zu(hmL%i+MaxdTuCF!*hjUJqhB+PkzWuU1V_`@C8WMQ!QQYHRngdtZ%cX`&68p)wDDT z*S$H~6W6^w4+}#7HLrCD<^{anj`9-EOMUNPJO%4dHehC0ugA+hBc@kRbL(fViYst) zTLXu$k+OD5yl?Uf@8NIO#y5CY;3D-a##{^MyIN)w!VT_|8n?F3Wbv&Ry}3E{77NF` z;!PTZWm~d0!A`Az*G%8?I!2k4Njl-LqlS7ViNz7gGU`{}4Y)`tT>vf>K%Bwq$-dIaD>h z+F0AXV$&M9j};Dhi<0O)>V4iK*n}YPsu$;DUZZ-#=JQS3>6<@mGTt|Q9N@dXlH)_8 z=9wkNfKlDns1Iq|HVpCDL&mlgL$5t#YfDK=-|Rj-wRQDLs^J*z&41tp;WsD)j|a+I zv}d`keUY3VXT~o4k zBj}ja;Cy$8Q+bc`^=nuUu8tp4Y@WVY>-b5-)Nv+s+I@>O8A>_m7z!&{_M&I&7`l+B_v0f&cy-4fyadH^tLjYIJ@fStx=Mz2pXoy>T zF9ymm3i5H@;(G(yd)!B^W2R24ZEtj4zbI&Btl6Hg1$BcLSh~QB*#WJ?`ac(`zp(q_ zHfH_a0CS|2iYnJ_ZvD{d#s}e|(YcYFUAgsTtCCBl&y}PlK=i5&D!v-yjp6Hn0{~g@nqsDELF&C;P|ld-JYt$r;#4ut z5|h0ogN$V%n!Z3t2h+4Kf=8BMNE4-QHUP`pCw?)uwEEMippf?HoBp(c5XcDqZ{q~=mSGh zKi3j!RE@`k~hHi%=)Jp{JMAP}^5PZ@blf z_!|-eY_~^*`l>bl~C!S$KK=EQ&Jkv1zNOn9=;3 zs?+Q4@GLu-hzVT{Iyjjuo%}-C|5yUnjNk{~Jke&dKJyLS-xU3Wwii@~o98ukm4;=k zzhb>>#OE3Cs_tL7UKm1U=}i+E-b&I&)Ix7nAdeDsgv8?zOprt{yx`V4vW-K2AgpX$&L&;76WjOWKI( zmGKtcRH)D-_+*_laV@S|HjjS{X7&E$^}=gZ+HyEEFzy-2K@dY9 zd2z>K4(IhTo3vwu_ttq&YRYE3W1rC{C3b15b+czH;gx2dY4+@7`S~45R1WrFVncq` zzKez>XjlfE&Cuin7#iNS=OZwYt440c-sSvvPg{HiYbr1oZ1uiLr zujv6ZM-YiDGJ4?k`N9%H4=8Xn%LWR621Spz@aOizg=ox~ms(1C=RpO#_M?Y%o)_(^ zZTE1dOp|5WHjqI*@*0V_rQjav27&+e2H`=XCEQr&UX&>Hc?IKI{Bz!MIH&AQJmtXfm4%z&E; z6dE*zD$1hH*84Rq)+DNUad&gN1#=o@*IIo6!k5LNHb1z|(l^9rf#kG6mI?h#I*!Dc zYi3mm&ZGqo_0lDM^tcOFJlA2IotGziI3FCP)?auhf*k$0N% zP39j_!R<~Lo%Wj|v~k1wC$1hejwqKCA3+Z;WX9-L*+vN_DQrtHe9a0YC>&Zw>sH{1 zN%&?hy0v#Xb`BpA2SJes;gjz=lmp&)UxE-%i@&=>l>Z^~De43P1qTt<=Rbm%+`AiU zC5gqpU>GP`dsK#8#=ZbE1Msj`m47)*T7`^W{ZPlXwbO?W!+2=K3&cbDaVvj9e4lz= z@5Dk>=+)1fej%l|(5au5`pJ-gp8pA;*Ph4MKNpXq#FvmbcY1Z|KhGy);ezL2JE9h8 z?Jpf0TbJN28-Yr!h?eh-16|4LBl~<#Ki&H-Xionbl(H8ah|(!g8iHZ4DO#SU;m46< z0z^K%SmoumR;^yFIX@Lkna4Qc6Xmt}n#JSFA_;KYWc}65^5vY{!nm~w_r$H5m{I$p zWA^>NChWNx<5cGN{#C2vP_;Vj%dlY*zI~y#Fu_?iYbD+uO#-j;NzfkRFNu>$MYuzg zNn1s!Ev5Oo<|DjrVpz^rC275BLxrxjtA@u{Wu|!zWx`8qS8Yx-T#4r&hoX?~#(-KS zOeLTZH;l+WudT{7BG6W?H(ZIsvC{w!&G2=G-h8)u<4)tC8O&9Khu$=X9U6YhO=L`9 z&MLO7it`#~@zvz(s(cnE;G#_^1Z66Iqi#8cNjaj+p*J6bw<#Wy-U?C&KZ-u2!w|rK zyet0q(&9IA=UgmfhBKyJ#wOzj#6uCc)?*Qeux>Q=u-a(9Ey6-vRELSSl}L z)*YCj&ZrMR*2wPasv}x+~f)pw$_7s>WTRbz9l;Zbo=utvv1w-Nroy8E)0KtZqXFT;U~P+DYPy z3h5$-%4&+1A4%9h65BhocI-sjOc}<-SMAmkJItC{enjW?jRiV9(Z?VQbao$04l|fK zp?2&@!*+F5CZ0lr`K+}B_^PU;#9b+JVUWE4u2qWgAX<6Da9>(sp#iRUh$dY9&M9=>tVPV*HY|OZLO*s@_pXr zlTNSj6rw#RoY(b!Qj@CD{8KZKKB-K#(U5|Cs*=*m%*kaHIM-F_CXlvGr^qQ0r z(;wDg&s=4yoVJZ7k_p(OjgXY8QvYkB&S{&PDmJIs&B+t3ShS!0SlY&o0B>|j3K(;- zV<&uGznXGJhpI?pQ&IsDd!s&7JQ8;$T|xz8KH$L=Zs8V}pVgT6%HdKd4i)BC=)>+T zHUAj_i_?-(K2n7jwM)J+zf6EYWkyi~4Y7247ngy<Z1uhO$u4|_1xV-St`22V;a`A(X9gv}ld1Fv?mrFe09 zjlzF?o%rBc^9Cvl#=g_#cFr-sv5t?YHQ=>RgSSP4Uq-D(^1VX9gmR)e;)~u#_;mli zb-@Fl3cn|U=D)79RGT8c%r2k7zjvMM-m@g&V6L-3s7^;h*DIgmL}*D}8Z5#0*rrSF zRav^m$pu4*G1M!B8X{!Tx^Tn1!E5psyGXUCurB%xtChm#_>2a9z{k0a8v6SsJQmCQ z9)e4G$?~AEkmz86&C2K0ix>z;o$J?8(I-*S%R5pLwx)md9L`k@@y}!O;=frnQQ7-q z5vJ)m*cajN{_T195@R_PuGCL7{2XvV)f~LX94CGnb^3k%$i?P3%@ZoA$-PNzGgY)t9%@XCfJrmDWrjCF(cPDN6?e~q~uTI~i zt$2LhLTtqE8_bNWOG z=PLigb;74>P&>H1E4Y_W6S<4vpl7c*ofQ^^>%K}gEG0jLRA$j^dszA)5e*v=QG^Mo5R|b8?!Kjk7Y13&AVhc z6~FQh^m^Vqgk;YgK6dQ$UcX{fqYjt&paIHZ>;chiJ~BxrLt$Mojo*aiY<6SZKS(UT8*;n;o- z^Hd{chE05>$^XV$>xB=e=rC#VA$aOpIe`(5tgVeXCz701f~I*DC9rU=>1S2`SJ%2q zE}(y2jhY1sY+($2Iy{ACcQE`~oTtS5UtTNo55G2YXmZz~tiYidLm{qxZ7?c}o_#*3 zx)}2lAfoBw`uu^l!OuY$PhFxS{%vc6{6%8d-89Y&dzF#2px7Ib`{C)Na4m4TJ<*o{KxsDY^QB*+d;#W5` z)8r^*$I?NI3jGZ9-Cm1c^Ut&K{1B{W{E!}rS4O~vlB_2f5W_HQV((XDNC(G?4bA^5ND5&}0^~8mb9nb_KRl*(u@hN3aR|Z#{Xqh{!tZ>umUxDTE@p{6C z^Ai_X7L?Cd-Or`hQEidIp8SuiGRqEVLWwTZN47+}euR0%TFhzriIzDdP$li9jI!)z zv-u=t0TOq;$CZ39|BbV>T46xf9T1yNTBBvjNDOI1X`%oO@E?v~&KYF(0G zpjKG1x`+z9Qn0dE|GO4-5es59$RaADvaAC6f6tv1aDTu5-;bd)_ujeBbI&>V-1D%g zP@8+%zdPE%rktK9s`Jd|GLJJ$ROc^t4Y$12BJ%d$0f59`lq#mf*>gQW0u+XV3YqJ6 z+Ri~rwQY?sK;594MvPWD6vg$mYcZiD=y$rE81rdUvswY7K#Y zJ{A+vQPXQFC`WEOZU-W(Xdf`P9mA%fvmd?z%qRfUy_ek90^k0i@?>je6*s&loem}{ zPG6Hcc;^O?3V+OwsmvMEz}4p-JzqVKWVE1&xUz@--^35h?~&fzM^~R~&2`f6S^)AO z{tLKO&f1#j9y_@r744bsj-0q zy6=gaM3wM`rJTM1nMLtPH;MxWEfZt4D1;Av*v0Dk|I0uuqg!l!dYihBRC9o`^fo(U zw73ru9%ifSaS5XFsa_ZS{Zwtn8adRPGLuMorgW1f2Q3nhnJebx%5fJ$xD(bifRb3Q zQ8L`aT{j3e@(-q+riGoaaPP}geXx8#*NoZhe?!TlZ{YJqNS&~zfzGWc3JxDSa4JV& ztR-HlXWRchNjN`og{SwvR%@wu0T$(4A z=EGs2`!`YSqdZrtS^hz7<%_-$#5zXMEkZ9~H+)s1N}nrE zvm6*4f@_GVGMI}rf=I$NyTP(o$-&$hZ7PgJN$yh_EN>!5-{&~grP6gd`npwm7AGO% z#mr!Dk-(~lWKD`7OA(Jj>Q(a%C^xC6@X%Y=i#+VW0T+>%kB>4+Tbh;qabcIVnI8QI zJfTD`Gx&EK8Sx*-5s7P^}xa689-9jPbx1M^Pe@BlZd2n(_yLu?1X3MAr#mmNbgqLz-N_CNG3((&YQ?df9H6Ds=6i0GG%+C>v{^ zYx{LW2AEe(_=f0Z!xisFudF6RUvIOQ*{-O@kF_mGrVH2U#lLB`9n#C{L$ZB_tO?3? zC)=DeZJL11J`3_5nJEU5<#&?td22MN1L@ET6`<&piA3BlBsiya?7dnYncM^DEQ9R;!4AQ!Tm>cY#p~ctZb2?{uLCWK2?ATS4~XT>Yf7FF?GfZ&pYf@{i6|r z&t3(jDC7{6IWG%XAd$B2r1em=Fh(+?!gX|}D}UTt`x)|#bfBW8nDDrCqKTHms0!Zt zczF3|4*qFeJ_s6Ye<20iAOB*Fx@nE}Q^63Q3+9T}h>xw2bgl_-)0FR<3(z3MZYtv) z`@RlA6(_*m88>m>`e|Bu->F;TyyMr;QO9*B4Ha$&-MQ>9?(&|wvS~>CyQSt^nw$wV z%od$=lo}bEZ#twE7QUy3#1)y+rvJT1Q!~4|32L$lYM?r3pA7UZL@m8d3?HDID*(Yz z-ETAZ?VZ=Xw~Amo@*L4jPWar?jbftBv0%H(>S8z_XPrINyqK@YkTxFPxEy3|C=Okj zg3+pvN;}yEAkv$#>gqc-st&xUB1guEufu+jUTkt69^%xxu`dzTv+};kvpUnFp{|sn zi~SnGRDllUiXYGoierMTA=;3iAeL>iJV#vzZ7}&Y;(of|;)CzCNDtHaFDyZ%OMgn% zz2|Y@l4oT}ex*C@Co>;;CRwkK7==3tnXh82`E~dH30?bh0msmy-EZy&jeNx%3Pjz1 zkMrb?5MPRlvz*S9Eb)b?*_t5E%EI)OZ2=UnJS)x`iVVx{7A3=}c^XC#PYw0tY6KVc zTL$MvazbLjfX}Dpr}+8=?QJQ-_5(R&vA~c9<|8H`bREZai);UJC?nMd42xgW-KSA} zlcj`{FXei8SNU_U)T~T{w*g+TevoHpxwPYI1H%@V7+jD6Rr8((!-Ce9`AufZ3M9D7 zw{!={eQxOO0%-)z%Yx}mu8)Sebc?o`*nCMX(nw10U$J1alH=B&NJgwnL0^GAt*1S# z?*YVf!tnMF7EDAL!Ik@~Z8r^QpM$*X?Fn6P)3oVWyfyT})$SMGNw%D>XV_ z4}A5pCPHtU(Z&Kxtoe3b?-&2w0elZy115!(*cb54#S=&gU$%p`Ks8S-B@qDF42w+3 zdJu$CMC6jbZp6q>&l8@UwBAx|Yyv*(QagJe$JzOwlLV*S-iat?btx~NZ1`$W!+j2& zrPWS|d4#s`;Y&CHP5~U>g+e4h_~)g)qg#s4H7b?S@#DA1fi%Ai>`o@G$~Q^hHlimE z!=lssrx|DwLI*rj7j;FjI?LRb>Dj*jrf1S;%7@eX_uG#(IyCn7GNH}=k4t-pwG{2_>${gw|#y6bC_h+i~g3*4ckyI{nhTBg!PFicU|D9ePn)&UEocnU^!&+nw=hCR; z(p-mzca`QjO7o>2YN-ncyOI3fXfs9;nQ_vxw-MXT#>1Vt(-z=tj+q$$0m9AFn^fFs znAZQHeHSVh967hP=Qz~Q^p`o*c@rm=d1eU?93U3y(8Jm2p$q=W{)B=OB;G&cI_1oR(V{HS2Idp=r0CMnx_`ud-rZfg;Z zPsfXNZW1*>K2=X!X3z?TTzYAJv+RO2iO;+z=x=uOpDAY;=)q2`gY9M-bl{SnNl82) z!ZAVsZW*y8V1Mx+QZjJD$9rTGbBjrP4j)x_Lw_K+qM1%^i?qIjCLS^)72w9bP}^ID z)X1$mlg!h0c>hzNIEZ_I8y@xuF74Bvn{?vaW}2joCRcFclG!>?S;LGa&BBSsEr*43 zi#L#dsOc$ft@i2uC#MRqsC#>Y^Z>z$oSG#x%&#%KAm+wLI#>AwR-qOE<|=<$&{gO; zd2?Ay!@8tK(!@^l?eh6ABQ1DTgwp%51{@klkYZ!XyMjii=WLtH#*dkyZJZA0SjoQ4 zK6&rt<`|okQMM)LQ>^iVOAQJl_1v_`1O;d!KG!!(ha1o>+=p1sH89%b26B={Wp3a#AkciRFT?~KM#wgBHV}po>BxFd4V(vcPCuLJT!>1q z=S+ShYbv=}+QXV^i?e(ZYihAeA9+n#71J0}kHJJS783xK)Z|U&>97L*^dj!NwMOm-!HT3$2G!vj_kh-ux*pw*C8#(h>YV zL+d^Dp?x3W2o9p^t09Pf8=nd~%WCSA%avelySO;TVp+jndAHy+=O%cP5?m?N!(4C+ z(?Tgj!xv7Oez?Y^*|f5c(!jg?P8rgoZTtiGG}QicNUh$jUz`ri{ajOMzgeoF#r2(H zRG26*pj!`Cr8b~4*;I5WT+fP4pklr0)}@z3NPd&XS>{r;O}r^TjpAwFr!R7?2R)vi zS8twP_wdtv!#wWcr+D3M2pgxcJZK9wU@knH1vw>4aDlb*xDa;MQb9FA^fuso`|85b zI>41c+0&*;dS}Ws@uhDW<1@{)o)`ChEtmxD6Iye_`cVekzEefj>u=FEt|fo)5Gj+S z7%NQ+C2BfMeLSxF-G91hs^V=aS???~SRQD?f_l1BDSh2V=(iDzKzNJ{A`+W!jC048f=>9a%b|M zdPDJzO+}&^Ip}uy;>F7#ripYCh!KoQ->)Uq9pL;mP*!mNj6y?6V_o{1(vi}El9ypo z;RM}}5}E|KMUu4yi)n&xkFIrBeeJ%FmNu;4(PUnn2GSO8XR!FdCu;#guEhz9pW-Xr zoRGFkS5#9!v9aF!P{QtaT&ZBAM-r;^09E2D64+AKj`IhGHI6gLU>oQ1o~GfFy2*=+ z!`WFqIFqMlxwdc$UY)qm+<$^qF$Bpgcj7klN}(5{%4=>_vMV@sey1EdIDNruYnOCB zzJz#27tr=cocxh$;(l|NVbpeQ*niQqMdSKN<LFV2owcQAS-x&$yPP=g@_mrEfE)$F-pDA@z+){Ck87HwV?F$>sO>O0)Y$q> z7vT>HfA75ronxSkcU%Vh$Bht&c)G_?RUM-Ch0_DTzL7V-!j%L5^Q4#^+ULam|6%kp z#Z#w8_?hzOh^#pA7iiCZQPe)2D-QM4j;1QW&ljX(g=ssKKW%!2@Q&~z$~}%XA$-$+ z1sJr}76Jw)XZ!&R481PgB!d~6|LL7Z>wDVMKlVNkM$?Wr>~**?@T_G_<|5OwTNS0R zXBs8@S|Tk=ZgCeA^tw`=B~R;wMs$$S0=Hn^TF@goH^~p}BTtg-R^z&O@d>^n8>YsXzqv{IE)1nN0X(;7`vq9?ypeCe-d52kk$=C8z+ zZn3WgLb$EAxVdp$pCEv9sBa9fK2B$GoNBH4VBv5V(qV}lRy#k$dWz)}fG0CLEY^Sh zOV)03z4TXtmGVupcB^0_*ec)Z`cNeYIJsiNf(N!JLzR*zJvyR_U8gIN$hW zwIs$mIH#t{_R^=&ktxoiIg(4=4!RaESp!ZeeC;JB3+BWBV3$LloA`zoI7>2h-09L6 z-`;2=u7^Y4XEjD@kE4G(7eC22VBt)3(9y+!HZtL&X;HE%R|7Ib7>?1I2|PD^B3Bz+ zd3I@S5vIiaa6;|uEL^XoU9$YVhT%$6H@x~@O#@**Cu*PDY2zDmaIXAW#HB}3-Og+t zFhk(J|17{gZT?sS_X|#O|4Bi8pW0kgKcDiBARVRq`}$uI_y6-s`X@?yud{b_W^LY+ zUzs2C%e{6nUy;n5%_u2M;Cg?`# zia<7s>cssQ=2w`_lj;Gui`VmuQ)mji0;Dz)z5`&*-i!qCw-bybD*3JK-{vq6d@s~_EoPid+ZMN=L;$ivEzZswtMcs=7EFrbqrv#BpnaJ6K1OkwY z&dw6G<7|Opd7}+j>Rc!9krORD8mNqemBH}>V1n)NN4AeNqV}0~#*egJjUOsw_(7^! z!}jV_`M?F--=7U=640Kh4%+SUMY1A za17>W1s%t!4CdGLX?vAu+~;$M=~?d#48^~b1_U~`uyf9!rUKEqan$#w%JyBkNyBn+ z=7?`Vh+}U9Ls2g;YVh661T2i!wfFgxRMLuu#*L|hZ%S8id4u#_J=(@?{?9ZOoK)KY z75%xKe=a%r^v_lM=W6_Owf?y}|6Ee)M|<1+RL9+@!@}yA(jXnDI)a{t$d@O2-jsZi94)eKW5i{Kbj>H!QOnAZBuMvQq^III>eMJ2kRXD?4?v zbI_K+B&w<5U!#(O;tTbmLwX2VrgVvckQtEz-(tf^M<83v~u z1o!aWJbdRKuSvW+vBeW;NL&!#u%t$MwZ6sE9h`_OI-RtdD(y&I(H3YfnzCr;Q&d+Qi@ z;>0O@*;vB&9Ebve)%Hw)xHP~)k3^b5t+&4dk$8KJ-;@QJ18Eax(K(c||4!L9-Bu_u zJ1Vw1E4sj(gMbmAvc)S+pj^zHMcrN~>bk_L3{kgLtQx^~4YrVS4+>ZYIoLKjH%XH# zLL+$s>JDyLD~+PB0l3hYR|o&JRw{_SqkJZe1G}X=>!GIn#x96@#8?*X3(5;g)tB=! z{wuFb`pxCMl&kV^V+n@STBE^@Y5NigxP#Zffw1sWJe6UHXN*`z{XrW_S+|>&#aeX* zZ)9b;%Vlpy*}-9gMZq`QdC;@oQlJIA3(s0_i22?^D%uVI{TL9EkWuvb`dbX%9d+&L zklfos90lQ>m-U_oSZOpqKs~YYy}vB)`|0ZPC_R=P3Q^wQP3D=}wTk^_Yn`NC+Y-Wh zXDAn|rm;F$c*+4)@WL7;-T>TrN*?d)*^J+D{eUli(F)AH(7g_g(pd(L4HFW!Jqxk|#pq{?-;_&Ibd$9a;cI}eh!Ib_zM)NB_)M|X3Z~%w zC3=@N>9rrJ_Xz*9=&wwNGIzn7};rzq9PRRQcg~jjbo9%lH zp}?zX{SQj(333GtWA`bMtSk1tr{84{^_Zn5%Edsp9;=vuAxwES6!-!k$;wA5tjpqZ zO|54#^>xyfzMhk>>T3%1b?0DT;bNbY;s*Pg%Vp}}O$2lE11i3kRSZYh)qn77k|9g* zSDO8rB-n*^>-N3%j=5WziDUm&d%UzMRy&kMq_bEeHV^QRn<+f{YAC2d)w8K;_*$>6 z{)4R1v7TpB&#Tb$sd}a7Oze&K>tgTi?ir6s&JTyoz0vpfg7uN^8 zb)o%l1)g2s+FIuu>l@+OKdukAk^9Wh;O60Z(6;{)G+^k+wiZV=dH?Zgytll*XqGuI zb?A1TwNs6AEc9D|tfB2f<_O9@!S=uH7@4wEZBghD66PMmeT9+UWBWm&tJXOvsFjUR z%LmBz?_9pY7Es$5-Ou|R7H0%GmA3S(tqb+fEKCtf8?>CwxKF=uD9kBrMsp9*0Wt{@ z)QzKcP&c42Vdcv3EYq{14LAK5q+1Z6s0tGE(ih{NB3E1}L%}{@0?Cw}E8DY=Y9Jz0 zh0>kj>rb3+5p3j@3p-fv68i!l{NsqXJN@@v!IT|ucu~ZC-HGa-U^qdGB_uUKWMiWa zBzck${rBnKdNf~-TUe(1rQBE8$Zro_lT?BznbHlO(eeKDY0@;An7et?a+3`vwSH%5 zdP6!_jhiR!K7Gy5?f|DKb$_oYf5C?KKEuQ%_0x3m>swpaFE&^`*_u5@Og;2A;hqCi zd@5>FfntEL?h&wjXV`}{{wGd}fz-UVL`Vckl0-NOcydrTZE(%pw;qGCh*9e_K23%v zZo^RDK2fu!w-%S-B5%PRG*B&Mu_D5{h`h&ot?v~k|Ik<$UaEjxM$~LDg&>#0U5s(N zCb9skq}w{5k1Y6Hfq~e1kHvax{OL~VZ{DuMasJy^b{#>S42yi&*i{La4P-kK=e~xW zT(HoS7UJ0b1LhsEj3SvQAcor>M-wTc0GnH~rE=eJ3_PTQ@TFJ0sLC-{g{WETU_!n0 zuov5|JxPT61Z)Y1^sXQsT5KBSAcL_>Tk*w^rm?>B&}rxfE3Lu@AO-}}&{LAts@(j$ z{Axb)Ff;3@lS_FqY1%t3NbJC~(3_gq55S9&T&j^vwcy-6V+DNGTeEVPmo%cNK*>NR zbOV&Pm;Mbu6=s-Sp}bm4$_1rbX5)aqtcmsI@Kt@GyvutA%pCa+0Zt_fk@(OL>}bl}w3qz(gw#A@oK#Va6PH?DtJd6J z@7xOwxE`JZ3GkP58D;Ua;U8(ync_dm*a-dEJy5=O8aQVuWsQbwT+Fp?Z-$`Rvgk|a zUJLuwhEvW}pW@YFpx6-O%fQdt4DhP0_RdZmKO3yA-=MJ>-~~6aZ8XUKxV?d*S4~~O z9I~Su3{KbHgiv5N2^)TV3`4~$=4#oo{wf?I0^8o`g3Y4zE#(N;>U3Cf(zBtoQ?WFH zgR?lAeQ7?bgC|EY9eWepUq+s zo21%B^X1>0NoJW}`uB>0p#hmJUr|p|>N-8%uS!I~DgdqLa9Z(iWJf9Y9{=*MWz=i^ z-7yl(a1A$*?v)7F!(w6!u5N!Q*ek06uIj;e04nn^4C@P;+xMqWfAtpqMdN@f0S;i` zW*v1w*VHpSN&4t9*Z`CNf~b7hAl&V*DehAxG`-)fy2zj0+r5`exV7$8Uz+x7y7mso zXA$qQ{LhBFZl$4SQ8mks5zd7GZ$h3aDHPx$Q4J2^@!^}*wSi~_^zzk~J&!?DVRJxR z720Rk@su&Y$K16y5hvsDvw9#04*MCLrs*ssOkDV9&3iml!~@aD#+VETd8A+Z?NQJJ z(~+TaK%n@!EcUODC=5f~`^mnecc@6kkhqCLf^6-PZ+h}}@k%kqfv3)&u2KjXY3SpsK+DS!JsBhE`QpubIUJz3BOmkrQbh>4OuhR_mJX5=eUmZ)Gie@oJquZ zjV=xEJF#Fb)l*~gRiNi6;Olm2xXdRfnY5u)XZTnD!c|?Dgwru=p`VVxfoO2MB$ZQ( z#Sc9O;WYHmN*BSXxmU&(E`J)=jzwxQeQZxnK3B@K*9YZNwJo;_ zyB7Zzjjgklt8AvHY~?(Aeb82}9(Y>=3kD4|(up66TsQ?Yrg==zQbl3phf-5LfNeod z0^%0MbX8Cn<@l z!jTPl-d(0>p=0bc{{Q{~UV@KHkryKhjp`2x+vpr5om!0=oEih}@}PoMW?-FhsST#; zcqeZ#-55W~ora=3ihfE(QEqmE6Xi&fImt6TR?T6Sci!8OAS-#W@oZ{sX^1CD(1PDd zEe$T{ROY7S-emEZ7RD-kmp(!@u{z$NS85;C!+WMHiJRZFP@cv4lU1%H)%?4cxn`*r zk1h0AN4k=EXA(cXdYN+;Vic*xB(*tvnK(;Lo%-*AvyQU;(*A)Tj;b;IT(u-I6 zTyDU%IoDezlz`3Pggn7`pAoxM4jk|{c-MWry0vMCY%u6+GUq=XIMbZy-C*|Cdy!(Q z(Y&W^dnIxzy6x0Zsf_Ap=;fP7Y3O8NJhS zh}IN5;LN}okP7$lor$h+>ykGYytsPFn@3geX{NkMywSJOkliqT_VKlecN$tea`-R! zN5?g`U1#bX?oULZq(G6U^>}sSg6CGxt9FHVFPZI3<>rh_awV!3-^jz)r7)raEMOeL z?1(F+{jBs~m&^tQY;S3=xsvnvU=Hc5T~+_u!E~pVGtK6l0nTYR%4In57?> zRWyfvD#Z6Ba66t2?AX`}bHH`uRzua;AO1^g6CjS`He`P^j^FWOU`J=`aR`cSt6ST= zq3~ZiH+sE`vrbxwE?ebP1@jYhk@u}a!ppn_uR>u zl6Yr#G;+tW1#7(XJT4u#q|;^OB-uNCt{3Yxr-5&nebpMKur>S(U<7%7r)eNLq%lC( zr7&Te&7Z;*)dz~2S|PHQjH{Q_$l={B9+!z*jC=7ERpU*34`ft*zbMB2q8P8cmAg-$ z`z3?{I^s(Z&Mfy!F!cw_x!!d@u4)x`h`d2RFx2zqotCq!lVbzA)U+ z80S&AlPZhnL$NY3YkS=Ove-jUrp?@$AIn z-c^O!w(wuZi)1Y{+w633w8RscAHDfo%+|M+qmC2HUW=atzd@Xha)1HwZhwvDR%HfS z0)dX!<1LAnUFa5|psh)S(3nJQ%C{&hy}U|3tn(Z0%>7puFjh-*aQmtNLs-LW5-DM0 zVB?OHZ1WDK%{vr(SVOoCB|}sa+)Sk*W8;>BQ`>Hp{z#R{hC9wxriFr215L7gV0v)F zDohmu#S8a*)p>j&t602!Gbfiq=^g=3CyPL#u~EuF=WuNvQZT`%~O zgBocz&2M22=C`F@4F9FD32a$q>}(G|k&^dvtM~N3hdU6j0^KWC!Q~qPw=fS1|HADI zSKhPk!Bzf`b=`4y=AOR6A2`s~9$dN#L-fZPhTnY+b-IHTCf41vs;!eo+1uK?qbXAm z&~+Zi{mjG{~@9Zk(hoZm_;j=tgg;mBa*c8)o8#%RTylmSyJvet&=jg}l zn^p500%w{Mmoy#Ukl5Bj%dr8GFJ4G=Oy>OI-EB?Ix!hNyA!~;v&{tpXP6xG^uWaJV zRV~eI^{|EMEO|8E+YfhemlSt!Prx0V7OuJ7&VRwAV;FbgN$-Zhnb*PY1(vdjXnQs| zmQ6)FZiM1E&xjFMXB7`-5nD>C`&-8DmMto7dG<%IfiZ&5Dc}UCoI`JKIJe``z>bGo zk1tMqAbZvP#opTRUzd8k*zcyD3hr<}8`b?7J6%<^ME%7p)B(Sn-fFe3kd% z9kqJH@WrVt0dLEPALT*WD5BwUJ?H9CZOQGU!B-xAkKbeLP(?aOVSsSjMrr9|{z@Hz zZ46#;OkQ{IV{+Wuw?-$nyl%#w@064&9q_b!+jz&6m5S5dyT`vvDUUGEyTyU+R&u_Z z!<_G~W%~qdqTjHlZG%59rS(a>zZ6HY*jwuuzk}YUZ1ipnY#6r@{sLLfN{GPm=>J=a zl8%kD=G|BsJ)Sc*wmw$8bd_}lLP_Q<-T0Qja?KSOKPQXQ#K*ibyH;|s!uBrhW0$fY z1sQ+oXJh>XY*DzyTxraeuab~UU!uhS`ZXVGuh{z7*yNu}w+(<#)In~^LFfP8j8`*4 z(o-t|$?Xu!Vh(>UlhPlP4Z6nB{V+WSuDnGRnPYD;mrfQ^_taY1^I@r>w)vWgi3Er4! zjo>5FAKh8c!)O|UcR9d;;VOd7-oBretEK*3GJJ=|-52M*r+z*pd;5NZcP&WvdYgP3 zK`>x*f=iVEdFu*)742P8?cg$=$HlSfphiaTGufB-)^~MZ+R?J&!)UTa&HEF%ELUJYC5}D7}#q--~}ZW;cuO4oLE&3 zHN4(}|H%|pD#UF87i0;n&UcvnaR(A{3!-6W4xGnfh~=9(*b~VIE(y*?TUkh@iu^Nr zpYimEI8!~fI{4ITNvA9Yyc`QSKWNv+mxg;S|Ertd+_9q$9qJ0G z-*>Nu7%;eKwflpkx#LqU^H*c7C-V*`?{Mgt3<>)&CTD^VG2fW?2p)h30ZS1220mF2 z*TarLbW$7h9?Vb@$upEbL+s=$yN|xW*nMMGX)5rbH;pk(=0 zTO4|RQugOJzlu>}yQ{g%ysJyG+^c;0)Kn4L&r}NzqlP|Vs=|kWkr+5cNYA`$a*|c zU8SlXoK>#FDIADhT1aCbSwE8cNo|DChD`@ezsj2m%WN9XR!Q}W

    Ych&aH~4yJz|oW3X55_0ycnvAiTPI9M|SsDG|~QyT)7u57`jk!dtdZsH+Ona&x&|Da;3M z;f*%6!G;MJGddY8^EU^D@AEdF$Q(2FK?wU<8zX==Le*2|eZ zR!)UNJd7%M`l}YJ)FiQ~Ye?WcUB4pP``8ByN88}aR%wy;CQr?M>DZq@<#b$kDi2td zUS9z~MdO9^c@H{_#d&`Y!2uZl;Otf5)}v&=KK{D)8+U1aKMN~^lUF_7DQ%(82qPCy zSp|QPYR638QK~}%4VK{)DF%-Kj$Dzim8XBen>q5qFUmp}%(^5BcZ%~*Ai9h&fi)KH`$d^4sBiILnfnGi^wKZNJc|;&Z5ka6;cXfN+`4;`$Ju$>uKVgrN`0 z`9d1zjJ_#Z*^vf23+YM9fT`N(l^ZFG@^VX4b6=V6$wmwiPUJ6NM?klN-K5}hXMB^5 z=Q;cx3;gF5RfXBbyB^6KU4=^v1X^Tq9`jc+{^*&uWTt3G^I#BOZ+!iD?1Fe3?qG)X ze{bW5_J1z(g2)dUyyn1(1N{7d|3G7Nlj3%Va>e3`RE%F%lQ&RMS=^EM?PTbAb3OP< zzX4lKjXNnnww)c}E`|F5dGD!(`#|%sDf$8+RI1`99&b@9$22#&EEp>j+i>kdAeqzRg;%G2aXz6cH^QJ=ET0I;At$!j5)`ml6SA11gyXLCND4%;}OWG zKqTcTNC5x|L{aFD{iSF6VZfJv05*&jYmWNB@4MAlz#+%s4Yre))XHFU8?GJmt(Nv++4<(vnm~^lHk^*RDGqsOJ}dt_bq)Ur{z(7KPmOOC93aVN_~0% z|N82}|2d1G9-bs2R5%n}B+Uo3>k-pJg~O=J<5kul``gn2c*`R=&C)PwxYRf57tdfD zn)%XuN=I^_?(Ewv9b~PiS;d*0^p5guR`7)TOg};?S@td$`vjRkD+Ua>A~%Uz%bw+O zpFn7*@~jB+KZEQVZgqVDmu5U|b({2OR3pfSZ+r)&E_(DEzRlR^ul!beX}SNfKtiBz zFctp%45Zd%DE(9B3;==qugED(8;dK_f_(%ivvz8$mkbGRS{^!L^ru_oKSfCcp!Eki z$a&=i=t|1-SfZFf=bP)e$ceMcUTQP;sxz~(mC{#uk_w#rzQr}Qq%I#Rh+r zjvs?hTDQAmJyO=~4tf*QvT5CJQ=To#x=FL~Du{-&v2P=X`b{lymfu`n$D3&#yA35Z zyw1W|CSO@if8}>rP+D2naKFnW8oqfZDRqZ)`@w(q|QYO7R^GBGFzg;Pw?|xt2YIjPCN65Is--1Z%fGivo`l_9zo1z zXqOASVbr^F1vE?#J`4&;HIKv8I6pKx+$NiQxDBVm%9A!w#LBY{{2M4L(Nu^38Uxz? zdBs0I3=-p1_d8zt`^54DM`^z>uOf~-dUWxs3F@NG1iE#3L6e)FSbXZgi&BLMdVx3# z4vw}{I@$qHnHFlHxZo>2H`>{NgIrE=KYi#Z{jLFr4sZ*_hhy*5IR}E3YD2un?So&A zTwK`y<6$h8&G8+RK8S!T`neQXyILZltijt4v&o)gs^o(=udvR$2rbFrxD}Ck8mNaS zWt|D$w8C2Zh3OR5o7v;Bnranj#Xeql!wSWjff%>cCq7<)s~$*2fAIgUZs**u2Juix zBX*yca#ncdx4fc7%Ep6?Lad}W|BP1*91kU0u31soX$d}D*cm#Qro&m;NEJf2h7}7P z9IOyAm1FXh;^Y+&16a+3{|nRw$pzU3qYFw4W)>_gSXMlQ^4!-P{T~_4G0o7y|pa?pc&hbg4%xKkse%?K@PdJeJsf#_wX-1FHIs~>m|pKWlKr;_=97A-Oiau zSY2QcrMsv)Z0l-XCEcO)<(ujaT;wNgBU(_7{<&!ZA3XF(L^x`hNoy|hXSYG;y?8o} zP%b?i6C|ctrXtrUiY8yT?R^y#phy)U2zi;Mf@Sb?OlQ@>w;pjDj!Jg4WyE}nm2-+; zdjzr<$XrO7s#GnO!X8NrPcZGGu+KJw+pa09zZ6N5Sw(|xHeJ7WGi*it(a1Dn_&*^B`6SX-JgWF$zZ9UP6(%+icbd0zVdA)3*H8#Gb^jX}=OXdE$_P3^m7Qanpa zt7;tm56PfBPicJR`eH4n$|z@NG$Y6&tL1N0i4sm7`!`M6~oPO8~F?hDuJ|d`f zdbXs#!}MWjzfn3wU;2(*S>0Z3OG%i%LA~{L_4c??YPK(I`>-$evCp7VzUlH; zA?X?RoNRL}rRGR>WjXi|pv1|ag#G&Lg`q&5K8N3KDPO z^HsR~p)s0VY7;_NaGvbN9l5SR-FrIlgL>&P`WDX`=*O&#J?kM;e}tZyMgaOY$M%=X zMA|)^-HJ&Yr;4|ZRpn*-@%>UNr@%Xt&q|?(LWhlxLK6Ug<$sFC6@iwtA`DPvzs)$^ zlRV4@I)U&^@{$qqk~Fz$dMKa^Z&pc9J%sYeGkveChDld|;n5DuA84qu+|Y^nyV{up8~P~^$8b8U(R?) zNS9J+%0sR!id_<{mYuhtif)LaQ44V8E1$!>Vz3WzNpXTvY`~2);UPchX+b(hD;vJ` z?TT+&SMremV?mz$E&Q>Lp;-V2Xc`+Y@|@4bA`3wLhFeuTXBnkT{&)Qj7||5c3-}9D zGn~L3XZ8%TiZiA0mTb!D;``a~jp1WatRyiajWds)XIu+mPGc(zP?i5$26T5BV`F=Q6uAWf{n{zFoDXk7K&UU6wta?t049w zMXisN@!L6)HrxtM!r;kC>0=INNPo)x)90otJv&c&QkL4ke-KQcLo=s(jn00Co?VOd z(1ZkY;a)Di`XKEUEd-;U<>43l+w1$1IeXUfiAT-<_{R_3YPcjKrKul3uTXPJ1GpVP z!VjOfpMo3C{s#%19CMVjs|y&!hMyBZQF%uH(MR+dk&m&qT?a{zrz^mDas+?}jpd(e zqM1dX<6NBIO?4v*B&85u;F+;foz(px&}PkY*)RvzNTwtedjIlG%ZV7ZQ}>}+UhOaj zZOaLw{&~T7F!OBQQ- zkt}eB?3mWcOd2Eid_g!L_<1x$_Tzgn8Ny=WA;^|!u(*3daXjV; zH{sx08_>7{kZ|CVj1S*Y-un|C^^lt0US3;XQ3x9BF z%52|~Jw|*C|JE60|Ml%*<=aebCpa^QZuY6HGhKlMI=cPi62$VcPZ3#?Q7GcMd8dk- zWBZt`NsudAT35_H$XJcxlV2vTTYVN@57+P&&qKSI8z*ImaP4NlEhw07TQ^PH(@vhL zWhhOLhQ2k6+%iK@Z&~;+Dm%l;t8QB`($+f%QnYcwn{AKJ5O{zd$+YMb5uc3SVmpKD zRYebSIin}-}Afyr< zat65SL(H$^GISEsB-{{fNS1cg#rUs{dRcApq^WRs`EZk6E;Tjaf>91Uh9{G0n17$a zzaTDT(S}NscP;2DO=$|srK#k5vot|g>E+TySp^<437pl22S}%Prp7(yhZodnVZ&ex zBZf#%;Th-7lO%OG2?g|05e5Emxxi3LvJf-+08KsEEQ=ETtJESj)G@l2u`!uZu(Ks6 zt0jr5lMTmA9h!Bk>pCOjbHshZ`^4EVZidwrP|9y z8sk_1jnisj3G&<{RD?rH^QTvvO&_W~c{eyMakjS;1Z~qgg!*)rs+^^~vsCRY)i_JF z&QhJTRKLdn2>x4i4^Q(9-IuX1`$l)HJFbTIK0to1H0M>mVNr~B(S99Ke%;}%V@D|4 zRY;>f-Vt1RKG0Fr#0NSOXvZ?1!!o&U@4F9yHV|Gy%crd@I4$qhFs~0-*El+ zh}?jiKZh$)5RGi+gevQj|5)GsB=&uAVVz}c9ZKUaM@*08eouch-MMs}BHTy18AWxD z58^^O7Fpwi-tCzUiJ&CVhi--8{CCUHqCZDOR!cMPXYm(;hB9CH;CG?IYru9PAQT6v!b?;A7B4x|@VpS8aBumn= z6$BIBA8Q~`HXs>T5rePs$(KbI4U17$*8gHv9ZdTDYM-n|Jexat^HGD##LCWG-B@2^z*D>eQ~*rhyy@s&Oi-aR-z^%FF{(kHGu zPXPIb--zXJ?J6+W+s)>jb)PQte;ns8u#%Hkpx>m4Tz(KL9p?NZIgazfsAcjXor5SY zo};f?bAszv8O@iFWpJKVaZ6W?m z5CJ06D8gtQoosoAB2Gn39QOpR0~DLIdNw=)mi&2?*qwg6 z#Ef42Fqwg(Kv_Hm=~{HA0W=u4%akM{sjLSmi<9?i0VrEsk#6u1D%3S!*$)zD-4vTh zQ;XjH$Jj(5;A~gmRhYT(uUJ1DsP5DVqj9AMhkL4xi5o2&i#OVZ(cmC#{43xmMizto zE0^kC*h3gzm7zHHHx($u-6!Aw>_OaYJRbb)!SJ6xxy4Ahz!pHjr9^0+gu2a<1JR;v zGk8E34w|HAh5kG}*oRKe`sqOR65Nv_=gMs+>~bBVoqPXXsyQQg@WDvOC&V)_+ApC` zZwy~}S9slEE#qkrm1tVflL8r=w6A^Tb7O2Kq#ubmV3p3eh-o$9$|1;G) zGWhC)?#<|N!<7zesl$7I*lBJxpB zQnLHB+LBJ|>*rgAN}>mjR!b@p^m5X@V(?6!Avye*+LAa}Bwr~K`A!9pZts-hsgaPO zRT#m!97TSsUJKQkqxbRHH5w+Z>gn=wMxqH8b176we(Z$RnH2zzg6Kv?MF&O zM^PWXZ<>gkXzx0V+DJc;6Qnv=zx%J{o4TbVel-o?*G&RfjHteMCwqO zaI2|}5B{wd_+jOFb5oJuxS_QP5tHiVstxU9`scd;jT1q;(f7IgTUH+^2AdycZZIzC z4K`B426KT~tlUsNP6ZE;*85|X`>L$xqR?8>|*4D+pLauMsK`)h%r`;8<+!P`uFbMjqI$14KglTNE~ zMN>ji2P0(~cxSb98S8p@t|b&Q?hmopeH(?J8auzqc)`iP;)LRF9L_F^eveGM^|F4? z`{(N3!){3n{#X}Y_6fynC($^>rlwkOuP|D%{yqv9VmNBUL<2Mgsw=pNJB3I`gmcg% zV*{N7j9^m)BhU`sDK$NIP6K?-i_NL8o=t}Pv*@-K8FN=N0uu+6Ky0or+S^IGjkweX z2l3~qZ{c<|0rTfr83i^XGY3~>iB2k4rg%(sjmGVarArfI^S*VL0sXX6=pBqeMbAg* zAniB4(b}5g8Aq;Ok0FyJQFZ>{#J0`~cpnIG!8(Mh9NPH$N9-6IVFziYZF5nMZ<)E& z4!nx7;bFJSY->HUIZ^ud0W46lr55Biw9taH(pQuaS}5AGtq8<|p-CrLkr7G}t9#OS zw!&-S7D3IqcSNOR>a$qM=n2{ay#Qlgyyz%C)tD!oSyx$T3~ap3_}9jdH{c?`sj@1K9*ct>K(8-ZsLvHRsm>)zPd z700bS5_mCzK?`O=_*diWhuJ=`a~(-tP{1^*Je69-_l_rD6aGEs%rjOW_S3{dv@w@= zKSht|xAYlnEZ;)+(Oan>Kr#K4=C83xN0dyFG6S*950y;OebaYx;k7KLkn|6woYnV} z^mMG)yGk)@tY0x1$E5)*C$$T&4({3`FwjFpw-C_qYxL|uWZbe`TlrHUlqAAFH^vg$ zKXiKM4!Ev2zqzA3VCZ^x=qH`hN@{~KrX^#JkVA~{jGtreNZTLqAJ$rIb>eO1@cg~< zKL~8W2F=!}?(|uDkw0YSMKvT!eJkvhyi_0Tizsr9LExqH%h*=(A6EI}@_m#2Y24NkLm0#34^D;6%1+1Uv3>yv!WW|Fs&0_h zK0tX;&fn$r2UoW~>xIV+XwV0zw{^C3X8Oovz$8^tkFcLk5Qt9wuTQ~Hv zDrC&}RfR@ydFhF4H$d~hbK}lRcJSv$#j(9-s@2MTcW#>5SDBkXngW-T-7CbW*HP^v zPd-fupM3pFmvtAjiT$UXN zrmx$(w5{x`G8l*ir8YW2A(nE6_x1H4D3O8FOV+)mcg$1amMGh&Ih#{Cad`$j4 z;-*5)8`edjL`6qTIEo;CIrR3bCbXg(xs`l_$k{ts9fh*_RW^`ky`ccJ$wqG;rwTvN zi`~sQ$vHXOcG=sOGPi#fC5z0$7>Av+KZOLnUo*{bH>^uvwlUFx z@bq?g!o%d#4$r6KO#2GQ5tTzT0V=YYHzU@Bb-@4}U6C*n&MOJV-RF+L#M5+Gqpvae zU%CXY2p(dPGQ4J}-^eZg7ZNXCPK2NyiQLBQr<*zdOFv&uFQLLJJr(}9lBiHj_sdb= zk*;Jel+IcIIS}*nL+g+AM%&mz?r)ChU7D3Aai$yYikH#iNv-_SMZD&@hTxULhF5aT ztw9OptMrurZ{$nWOXb5_ac&tf?neWxzAnfpc~yuf_WwQckXEIH#JFjlEh>27%p zw}3{+xQb2D_BPwR1`)u*7xas8!;lX4CldcTcp2IkG+#V^NoL3bLzlu}E9hlbO1^OnU9mf}os~z~9s`~%)-FYe5}Vq6uGS;@YQ2NT zG-;OT{Sb1M9gfr#9#t(ZyB`~s zt*Ny6ey|6kfiVYIOQp}@Rdk;rrc=an%f|b!zzuL?*bDMKgs@SkEUmx4v%@y;dK6IT zAJAuS=>k(Nc)Oy7V2wdkAV|H_*xPCH55e^%AASN@N@_r(da-h9b%>Yh>Df^^4b*b} zPIFLSD^*bMKsy|j1-(CXr8e9X4u22@hs)4O0V66SJ!7vy?L<6g4dB=h+JN)6SbiN2 z+2tdtzY23R(la-n(G3WGN6O{bDfGm;Hd^ey-*!mr%+4`=s48~Rvn{!zWMLu`5IF3H zyFr`@pJ}=I(5w68V{m2dE7(4P%efdnOBodO zO$zRPAfovMEWhkdYBY_L7f@u5W=nH%vz-oAqCMR@V9%dbFax7gu54)SBnz6>$@wL)FQW}KG6*;(I@!IK!nR@GyGQ&C&H(=Og$%5& z;v(|)|I66hz(-MC{o^yUuh~p6*@Pt|0d@yA+3?bbY$5~%o85#EUTnz%Az(qW$u8kd zAf*MZ+MNj|o0vXL7L)|z)7{0Dm_mW5ND*5SFj9n8V-=yIh~0`7TSSVAko>-9W&`N& z_xwM9KZdre=xTxm%{2b$(En_Re0f&9i>k3#PX=Eby?)^m{PLT+nB7?$UT1El}vhM(ZoD73_{Xv>9)gya?s;*#M zXv>D^rL)l=e^iEe@^Ru7`WUDl8G4K$z%}DwNveOaZjz5)d=Q(KYs|>d#tqgl&Jyyf zM%Ke)yTCwH=EM!twx2nJNHFzV?{ji2q-9XWEy(o&@nnYJ;O^7!pS}T_$->`QfwQ%{ zg>)usD2aKM2vup{{#E zVw0R7a<0LfEOK;(vB>$ugZ8(z&e4-Yvo=KjAp=@Dxjw~>yAAms?8hVqA~6;l0Elf# z6We_7HmHEOf9M8S`q=-*+Eupp`2=8FBEROuD+J$qxjoz!$kbSYujFklPP}1E5}Cp% z?f(zj$2}Yq8n+?xfzm!xpR#PQ{WwT{k~QsY|9 zciMjE`)v=>AJ5A~GocFp>>2pSrQK;7>12X{3SenuhFe^@-dF1jfX4|k_i?^iTZ4hx z?P?>ryK*POAHK?Z_M@gwc?H#A9?&1=Lu@T>l)dhagQ8pUSjJSSK`{HQ>L1B3!LBA* z7hjgfYQjN==nyfix!_ZAP#bcgz0(dB1~(hy?W%F!!JF@=-SN;8q;_JTos4t>)8uW8#N!kcI9kve7Ip z9Jjh_k2*Sqj;gd)Et4>X1iA(Yd_e-NPK}htNyp=TjlTOsd>n)*UGV)w@{#yX_##?) zc@OL9J9D2Q$A)ngFbhwZ!$-@-OKYinN0$YTWg-rmQ=JtqTxO5soF%Nigu^Cfh}J=4 z0s`SQYR>LlL(LPNlRGv*SlH z*vl;C<&!9j>m_;_(8EeyTOT)GE@dR%>mZzdAi@ZvPYv0xF9AKln`+KEw^n+ad|nej`wjdJV}mF%)iV2q^%yYgf&l=^4-b@#75mV% zCSV)0`+1TyGOMMAq;I8$oHwKf3wWVMslg!`v6ma<9!wA%Cag4wpbRi-QQ&u0aL|#3 z(|TxeuS|loE4pU(Xa-E54J~I~*oV)uZfAClbHaYr`qiDDx$-=ak5IOvu_TRG}JMmX%1RTSHjN3_~ zzo_blDVcSv7^jML&w#EM=bVvXpE1N{X$sHfU**1yh|8%O@30}*bv@sHgnvmwdhMeQ z*6PLVf(Zt^*aYRkt?t+Rm*;QIQcdbHJQ+U?wD(%>xHnHGb)9%L92yb?ME6lucJ-5h z!0yZ>Nnv!xb^If%gogD0d^AU zP{lh3IKfQNsGRG^36KPNSa;up%E_tR95g&Nq(t-yVB2(U(#BT}uF%|ho#gwVbo|;S zoloG{O*;@H9WxVq{hx^dz2Y@3(=_f$2#IH4v^*w>WMxf#Sp5 zP|B3`F>h^M*S&S!+~0i26fxo|HIsh0Qx zrD0d3vix#g2NyMdAuo5FX#j)53`R!8gNUL9nYKayM%+mCLDTwG&XcBS^U@heDI>03 z*P(Apvsy^&3A9IE@?te!BBbIecK_OSR_hl6OO#2j4+7{g#&`SxdAE2m5E2_smC_uB%d)}JWLN4O1=#1FG<0H`W*-vD89S~j>p2YF3I{e zDP`p>ItUqMpT6M8k*m<{@Vs-LS{C=j-dg_@qmdXWxFlUo}$bU`PXlqB{ZfnTW1zF|OE^k3(JEteXXlq>?3+lvmN zJt6p_d5ljHcR_;uAmQA!1Oou;c1~O+KX%69q^gFOB!pK)acJ+yN~4*k&O2I(e^q7u z7c%t%futpZs|9#1KusF4oN8)+7y}FcYT^QVYT7|@pw%x}|Ebjb$j4Cqm!X1kOjoxK zHehS7BOWW+rCUEn9%y5|V8%oA6Y2=2v&0A)NHYHv)WM}n_f4Fsj5FzDZ%r{z9>e7Ea zD6dDihH0NfJsB4f1?tJkCBh7xsTro}fKuT?cQ9_|fp;^vB}1zRnnp9o8!~0@UybaP z6Lm)V&dcOM-j_M%eZA+@zr$lkfR>2kX%2)-#>;Js+4LmPlUxplHf5hN;%Iss(2o!N zX&_KCUNqCA|9DdgsL$;-NT7ca_y4!@LV7V?92(184c>?&PHC`@;t={$;`gdKXK=X~ zPfz8oUJW};+QU6gL@E{DvuviFvILD%mcPs&aM{D z=5mhz^MFRzNOm6kntQ zc71^E81^_2yNM4*lM@DLRH5e$}wSUL$cPA(7XH(PLdn-_U&07iLb{Wd9+(?Do| z)0}18S}{Zw9Bj>u*X%2xch2BMv7O#Y`c{*ljqbv{B3%UX%5C%Inz5_%6Nq0;K;}Nc zL||ze9D#6oTMnY&9EXlb2RtIGE_9n=P)e4SPn~~%s-->#4pu7JU*ysH3kSK#zsb-T z=n)@_^~5WT^MuZa5yJ3a1D1!Vl*HwcZ4a~`oO#F$)DV*I_)~DJa})258{1)SJv46i z{g!k}v)o*C07VpBw@ac&>D%~|@0s$zCm}*Bt``ZqgNDsL)WJ+jdcC=c+D$tX@7tj(5UnLz03 z5)8-_>6PoHuA%SzZ1Kt}EY@rTVq}e>5*-&KuU%GXgqfbhwjrKVmq}!0U^@(vg%>6m zAThc?g$9A4dSrsQQ_9MJRNCpQhjX^MV1bU*2RQ9dn5_IfDcGHrKTHZ9!Kbxc*E^mmcB9PelxZm%y+_)4R4I^^pDyj}rZPngd|nn8BO6r#mtydYfQQ%U zVK&Nebu*aW+0^#4g<1J&(z6BBwiQ{9Qx*X6EK_fMP+P)?o7dKNalJDbanstYgY(3< zSJfNcS|UTPwBz3Zc4}U;PZFkiM@B>{oFg!!d{=!7=0M5R8C8`-w!rG?*}^|r+ef)8CPyM zCeQC{^QVdv*7^|VQ5A$RiGq033=anjVyW>IBVFDm!(k?t%ouzpuSI2@JiH3?(rn%q zNPW0jFbn01HF1n?Ud^dl1)^Zd#!@0=+;B0EWOA$?+wL%w`0E4(2u?mJ16yzVNPwQ!@%o|FXb z-}r~}#Liotu>%b;eX9Ty)^yxuoA);^<`dT#h0u3i6-*)&YM;ht4Br{ijLQqAlA zI2c~b$`AKiBk#QTsA2aisDcfvw(zqf=Wdc@>BU1YW1W7r66@5idjT5B5M|E5l7%WX zbP3C%pI;pLjHUMuo_PWgxqZ5SPE!JDOVYfWWO=`tsCS}RjLf??pgjDpFet!iv& zd2kKR3#rVe>eATTq4c(m-s*8jjy1wH&W18A2pWG zuKHwfvWpP1;x&;0HnO3DY$B zRuVKwyt)z`vZO!XezE0?mC_j^Jxiby+@IY46iJN8cNIe2r)C8L%h;?D&ceti0oc!U~nsh01&7U4EqH z9pon?Na9fRfYY4=o(au(MxXaw8)zyD&0T{XLZPcC(5zmvjc6(tN*FDy>&4fUH<@KN zM5bNSvT}_NPR9N;>K{|mMemwG@D67KZ6$5xZPkJDA%T*SWP{0!>macM+w#)Nz!`mb z<%oMagc2^iGE>|~b%t%3`xma+*LeiD8dml^6cK()uZ7fnKD#+!4wUBuACq9rZHB+Q zt3APQu-U+vTYQj)2v!3#53={^;kH%-$Ff!Q4)>6$1r4OYoOMtQyHwh15_^uZ=Qx}= zaA~aae0c+Y-ZT)nJ^8guqk$NI)o#q- z_itF)^*6(6a&jt88l2lSM^>Zz20^byTyLS0;HzNF1sg>VUdP$1M@7=W){q%AfTMf! z2k5H6Tbt${bLH#cpqSDD-YW|=iuTry-dDy3)KDyKvw({v4Dx78zcNOkB%s$+EQ=~XuLr`3@r6%E`Sha%t*bH%EUp~*B>Cz=$z zWMrj!GmVDbJ(;-rBF`lt@zI6gE#bKo|9Ml@5FsuYAm=lz=U(FMVU9rWVV&-oPx-WR zK3j5(;h84q0U40JdZaZyoO7cZlwByyP>xcxPO-uwKOXQ*9EkkxLwWJyT@SpDykN#0 zv$|t*OokcS_K_R^iW#}D(uo(Vl~eP{>d>gwuNsP3CiHRj{$H);Q?Fsq(_@AMx07Gt zu>7|BHRAi#^;;+7TaogOA3pQY;HP)0>$hcGvkn*kiYj%kl1ujLsm|&t?Iv8VQM`6U z*YWcAV=BsNtOLwBGsQUpnOhIVzY3;?ofy3`2wP{o*o}%X?J(7hW!D(HCBZb`fHUrmXvi ztr$m&C(Jm{N?E6cZQABmk9E)B?pY}BO>*jycb9KU%;?4B$+$+Uj0cLxzPus}mrgU7 zj8z(udzYIys~||&wGS|()RY_UukbYpg1sTW!4HWjy(Pp(?t!G)lH2Wf2t{8^Nd02 z?cdd*^#!l?QX8bgP)v74+iln7*2v;tZmn1i?|iMp2f+h-h4yyYJ_~-Qv2W$Z@+Pmy z!3_yu?U1oE?m)SkFOiDINw2AJWf@kFv;Kt*&*0p>Hvyt+?^p9SC6*^$o5U55VOD&? z^&+_T7Jcg&6TAk;K~+T8I^5KtgDYR)W7qQ;&A-;{@cTrIZ{JmTWQE2*+CgK05-{HR z662$wHjZf>(=i;j5j#4=1|~d%=@`?Iwqpk(>@~MK0y9{dj~llTelK30^4CYc-gj`~ z^3}~U^8Sea5M1M#nScw|Mq3Q6MW!hR8Ll{jD-QaJGF&6m>zW&0@JR&M`9Zi!WDt63 zZ0~$su0R%7Hv|eNMIEW+n|KhkqK-6513zp>EX@H|a=KB{t1!XfskC|HoQ2K4t1svO z(fmZxzJo{3KYIn@!!-xf63h|d&McFsSG@5$1$IL!qsInraVJymFd$s!h@giFy$5= zhTVaO^d|=~p;ZwAZa=3l&iGm){a*M*^jCcs166lmAeNRfKUp%gL zMK-6+VdU|T_dRzce4-yq2szHMt=Ik;Sj zn(VS&qILn>a$n<-J7x=Uyr2=@X^U1&Ia~!toio4`8qt6RTM43Ti~_2p<^TsAdCQL) zckgw1jeLm0uGh3*typQQ()zcQb*SrxF$Yuk9oi?wv*TK~XBNqbkm6CUNvHzQQ=!$s?( zgIg<{DawJ66u)QLr9y>PC>Bwpd#{0Ww2E6uqS~p7T|*r z4BkqHn(<25i2%F!U>RRM_yKz(?ota1QchmgeVhQL2)=M)o*5>=xKhTGwD()zmPE

    Kv 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μeK;&+GR*M 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

  1. uW_g26(>Lc`*rg}+6-MWMwji$RNJixW$bC9x%& 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 S4a|K1gG2ED>yyN<>Hh&1pq$SD literal 0 HcmV?d00001 diff --git a/docs/GOTO_NOTES.md b/docs/GOTO_NOTES.md new file mode 100755 index 0000000..5a057ba --- /dev/null +++ b/docs/GOTO_NOTES.md @@ -0,0 +1,514 @@ +# Goto Notes + +## Purpose + +These notes describe how goto, sync, orientation choice, and target-limit +planning currently work in OnStepX. + +This is a workflow note. It is meant to help explain how the system decides on +a sensible motion plan, not to document every goto command. + +## For related topics also see + +- [STARTUP_AUTHORITY_NOTES.md](STARTUP_AUTHORITY_NOTES.md) +- [HOMING_NOTES.md](HOMING_NOTES.md) +- [COMMAND_REFERENCE.md](COMMAND_REFERENCE.md) + +## Quick Summary + +## The cleanest mental model is + +1. a user target is turned into mount coordinates +2. the system checks whether that target is reachable in one or more valid + orientations +3. the system chooses a sensible branch and motion plan +4. goto executes that plan, possibly with waypoints or alternate orientation + handling +5. runtime limits continue watching during the motion + +## So goto in OnStepX is not just + +- convert coordinates +- slew there + +It is more like a small decision engine. + +## The Main Distinction: Goto vs Sync + +`goTo.setTarget(...)` is the common decision point for both goto and sync. + +## That means both operations share + +- target conversion +- orientation selection +- reachability checks +- axis1 wrap/unwind correction + +## Then they diverge + +- goto moves the mount to the chosen target +- sync keeps the current physical mount orientation and reassigns coordinates to + match the chosen target + +So sync is not a separate simpler target model. It reuses most of the same +target-planning logic, then applies it as a coordinate reassignment instead of +motion. + +## What A Goto Request Really Does + +## At a high level a goto request goes through these steps + +1. make sure goto is allowed right now +2. convert the request into mount coordinates +3. decide which orientation options are valid +4. choose the actual target branch and pier side +5. add a waypoint/home step if needed +6. start the slew +7. continue monitoring limits and refine near the destination + +The important thing is that the target may have more than one valid +representation. + +## Examples + +- east-side vs west-side orientation on a GEM +- axis1 target plus or minus 360 degrees when wrapping/unlimited motion exists +- alternate orientation choices on mounts such as `ALTALT` + +## Workflow 1: Entry Conditions + +Before goto or sync can proceed, the mount checks a number of ordinary +conditions: + +- startup authority must already be trusted +- both axes must be enabled +- the mount must not be parked +- no other goto/guide/motion operation can already be active +- no goto-blocking limit/sense error can already exist +- no motor fault can already exist + +For goto specifically, date/time readiness matters through the ordinary mount +and limit logic as well. + +In other words, goto is not treated as a way to escape unknown state. + +## Workflow 2: Converting The Target + +## The incoming target may start life in + +- native coordinates +- mount coordinates +- equatorial, horizontal, or `ALTALT` forms depending on mount type + +## The goto code converts as needed so the mount can reason about + +- target hour angle / declination where applicable +- target altitude for horizon checks +- target instrument coordinates for each orientation choice + +This is why the same sky target can still lead to more than one valid motion +plan. + +## Workflow 3: Choosing Orientation + +This is one of the core pieces. + +## OnStepX supports a family of orientation-selection policies + +- `PSS_EAST_ONLY` +- `PSS_WEST_ONLY` +- `PSS_EAST` +- `PSS_WEST` +- `PSS_BEST` +- `PSS_AUTO` +- `PSS_SAME_ONLY` + +## What these really mean + +- some insist on one side only +- some prefer one side but can fall back to the other if needed +- some try to stay on the current side +- some ask the planner to choose what seems best + +## `PSS_AUTO` + +This was added mainly to support automatic meridian-flip style behavior when the +mount is in the meridian-overlap region and can legitimately continue tracking +on the other side without interruption. + +In that sense, `AUTO` is not just "pick something convenient." It is meant to +prefer the side/orientation that keeps the mount on a sensible continuing +tracking path when overlap allows it. + +This is still not the same thing on every mount type. + +## For ordinary equatorial cases + +- it usually picks a preferred side from current hour angle +- in overlap cases, that helps place the target on the side where tracking can + continue unimpeded after the orientation change + +## For `ALTAZM` and `ALTALT` + +- it falls back to `PSS_BEST` + +So `AUTO` is really an automatic orientation policy, not one fixed algorithm. + +In practical terms, it is most at home on GEMs, especially imaging setups where +automatic meridian-flip style behavior is desirable. Compared with a fixed +preference such as `PSS_EAST`, `PSS_AUTO` is better at using meridian-overlap +freedom to end up on the side where tracking can keep going cleanly after the +change. + +On fork mounts, the usual practical approach is often different. Users commonly +widen the meridian limits to allow much more freedom, then keep a fixed side +preference such as `PSS_EAST` or `PSS_WEST` for normal operation. If they want +the mount to use the other orientation, they typically change that preferred +side. Forks often do not need, and often should not do, automatic flip-style +behavior in the first place. So wide limits help create freedom, but the +selected side policy still drives whether the planner stays put or flips. + +## `PSS_BEST` + +`BEST` is distance-aware. + +It compares the reachable east- and west-orientation targets in instrument +space and may choose the alternate orientation if that target is closer. + +## This is why OnStepX can sometimes choose what looks like a shortcut + +- through the pole +- through an alternate valid orientation +- through a less-obvious wrapped branch + +That behavior can look surprising, but it is intentional. + +In practical terms, `PSS_BEST` is often attractive for visual use because it +can reduce unnecessary flips and choose the shorter or less awkward path. That +can make the mount feel nicer at the eyepiece even when it is not the same +choice an imaging workflow would prefer. + +## Workflow 4: Reachability And Target Unwinding + +After a tentative target exists, `Limits::validateTarget(...)` checks whether +the target is reachable. + +## This includes + +- altitude min/max +- east-side axis1 window +- west-side axis1 window +- meridian overlap limits for GEMs +- axis2 limits + +These sketches help visualize why the same configured GEM limits can look +different depending on which side of the pier the mount is currently using: + +![GEM limits example when east of the pier]() + +When east of the pier, the active limit window is interpreted against the +east-side geometry shown above. + +![GEM limits example when west of the pier]() + +When west of the pier, the same ideas map onto the mirrored west-side geometry. + +## But there is another subtle step + +- axis1 may be normalized by plus or minus 360 degrees to find a sensible + branch + +That means the planner does not necessarily use the raw first axis1 value that +falls out of the transform. + +## Instead it may + +- keep the current branch if it is already best +- unwind to a nearby branch if that is closer +- shift by `+360` or `-360` to make the target fit the valid motion window + +This is why a coordinate that "looks outside range" on first glance may still +be reachable after normalization. + +It is also why wrapped or effectively unlimited axes feel smarter than a simple +"move to exactly this number" implementation. + +## What `AXIS1_WRAP` Changes + +## If `AXIS1_WRAP == ON` + +- axis1 is configured with a 360-degree wrap +- its configured range becomes `-360 .. +360` +- sync-threshold style coordinate-jump checks are bypassed + +That does not mean the mount ignores all planning. + +## It means + +- axis1 has a broader wrapped coordinate space to work in +- goto can choose a sensible branch in that larger space + +This is most relevant on azimuth-like axes and other mounts where bounded +`-180 .. +180` thinking is too restrictive. + +## Workflow 5: Waypoints And Home During Orientation Change + +If an equatorial goto changes pier side and `MFLIP_SKIP_HOME == OFF`, OnStepX +does not always go straight to the final destination. + +## Instead it may + +- insert a waypoint at home +- or insert an avoid waypoint first, then go to home, then continue + +## That is why the goto stage machine includes + +- `GG_WAYPOINT_AVOID` +- `GG_WAYPOINT_HOME` +- near-destination refine stages +- final destination + +So a meridian flip or alternate-orientation goto is often a multi-stage motion, +not one direct straight-line idea. + +## Horizon Avoidance + +There are two different horizon-avoidance ideas in the goto system. + +The first is path-shaping during side/orientation changes. + +## When a pier-side change is involved, goto may first route through + +- about 4 hours HA +- or about 3 hours HA + +before going home and then heading to the final target. + +## The reason is practical horizon avoidance + +- some otherwise valid geometry would pass too low near the horizon during a + flip or alternate-orientation transition +- low-latitude cases can make that especially awkward + +So the planner uses a small detour heuristic rather than pretending all valid +math paths are equally safe in practice. + +The second is runtime rate shaping based on distance from the altitude limit. + +## There is a runtime slowdown heuristic + +- in equatorial mode with `MOUNT_HORIZON_AVOIDANCE == ON` +- the axis frequencies are scaled down near the minimum altitude limit +- the amount of slowdown varies with distance from that limit +- the code decides whether to slow RA-like or Dec-like motion depending on + whether declination is increasing or decreasing + +This is best thought of as practical protective behavior, not pure geometry. + +## Workflow 6: Near Destination Refinement + +Goto does not always drive directly to the literal final target at full intent. + +## Depending on encoder/tolerance context, it may + +- slew to a near-destination first +- wait to settle +- refine in one or more additional stages +- then finish at the final destination + +That final approach is not only about positional refinement. In practice, the +near-destination exit can also be used to normalize backlash on arrival by +finishing with a consistent last-direction approach instead of simply accepting +whatever direction the earlier slew happened to end with. + +## This is why the code carries + +- `GG_NEAR_DESTINATION_START` +- `GG_NEAR_DESTINATION_WAIT` +- `GG_NEAR_DESTINATION` +- `GG_DESTINATION` + +## It is also why encoder presence changes behavior + +- with suitable encoder/tolerance support, more refined near-target behavior is + allowed +- during homing/parking or on simpler cases, that refinement can be reduced or + skipped + +## Runtime Limits Are Not The Same As Target Validation + +This is another important distinction. + +## Target validation answers + +- "is this planned target/orientation allowed?" + +## Runtime limit monitoring answers + +- "while the mount is moving or tracking, have we crossed something dangerous?" + +## Runtime checks include + +- horizon / overhead limits +- meridian east/west limits +- axis min/max limits +- sensed min/max limits + +## Those runtime checks can + +- stop one axis +- stop the whole mount +- abort goto +- trigger automatic meridian flip in some GEM tracking cases + +## So there are really two layers + +- planned target acceptance +- live motion policing + +## Automatic Meridian Flip + +If automatic meridian flip is enabled and the mount is tracking, some runtime +limit crossings do not simply stop motion. + +Instead the limit code may request a new goto to the current sky position on +the opposite side: + +- east-side request if currently west and beyond the west meridian limit +- west-side request if currently east and beyond the axis1 max side + +## So automatic meridian flip is implemented as + +- a limit-triggered alternate-orientation goto + +not as a separate completely different motion engine. + +## How Non-GEM Mounts Differ + +For fork and alt/az style mounts, some axis-limit reasoning is based on shaft +angles rather than GEM-style pier-side interpretation. + +The limit code therefore sometimes normalizes the current axis1 position back +into a "normal east-like" coordinate form before checking limits. + +That is one reason the same target can feel simpler on some mounts and much +more orientation-sensitive on others. + +For fork mode specifically, this is why wide meridian limits are often used as +a practical way to increase motion freedom without constantly tripping a +side-change style decision. But wide limits are not the whole story. Orientation +selection still matters. In typical fork use, that usually means keeping +`PSS_EAST` or `PSS_WEST` fixed until the user intentionally changes it to get +the opposite orientation, even though the generous limit window would allow +more than one valid branch. + +## `ALTALT` And Other Less Common Modes + +`ALTALT` is one of the modes that can seem obscure from the outside. + +One useful way to picture it is by re-aiming the primary axis of a familiar +equatorial mount. + +- on a GEM, that axis points parallel to Earth's rotation axis +- on an `ALTAZM`, that same idea would point the primary axis at the zenith +- on an `ALTALT`, the primary axis points north on the horizon at `ALT = 0` + +That is why `ALTALT` is not just "equatorial with funny numbers." It is a +different mount geometry with its own natural strengths and weak spots. + +## In practice this means + +- target conversion differs +- `PSS_AUTO` falls back to `PSS_BEST` +- tracking and motion behavior are not identical to GEM or ordinary alt/az +- the mount can move naturally through the zenith and celestial-pole regions +- it is therefore one of the most natural mount geometries for satellite + tracking +- the field will still rotate even if the mount is otherwise tracking the + general sky motion correctly +- the geometry is weakest for targets near due north or due south on the + horizon + +So it is better to think of `ALTALT` as another consumer of the same decision +framework, but with a different singularity pattern and a different relationship +between its primary axis and Earth's rotation. + +## Special Geometry: Sector Gear And Tangent Arm + +Sector gear axis1 and tangent-arm axis2 are special enough that ordinary full +range goto thinking does not always apply. + +## For these mounts + +- target reachability is influenced by limited physical travel +- some checks are relaxed or specialized +- origin handling can matter more than wide-range coordinate elegance + +## So goto on these mounts is partly about + +- choosing a useful target in a constrained motion envelope + +not simply navigating a wide continuous axis range. + +## No-Goto Builds + +## If `GOTO_FEATURE == OFF` + +- real automatic goto motion does not exist +- sync still reuses the target-selection logic +- the old fake-completion paths for home/park are intentionally gone + +## So this mode still benefits from + +- coordinate planning +- orientation choice for sync-like operations + +But it is not pretending to offer the full automatic motion planner. + +## Examples + +## Example 1: Ordinary GEM goto + +- user asks for a sky target +- planner computes east and west solutions +- both may be reachable +- preferred side or best-distance logic chooses one +- goto may go directly, or through home if the side changes + +## Example 2: `PIER_SIDE_BEST` + +- both orientations are valid +- alternate orientation is closer in instrument space +- planner chooses the alternate branch +- this can look like a shortcut through the pole or a less-obvious orientation + +## Example 3: Wrapped axis1 + +- raw target axis1 value is not ideal +- planner shifts by `+360` or `-360` +- resulting branch is closer or simply the only valid one inside limits + +## Example 4: Horizon-avoidance flip + +- side change is needed +- direct route would be too low near the horizon +- goto first detours to an avoid waypoint +- then goes home +- then continues to the final destination + +## Good Mental Summary + +## The cleanest way to think about goto in OnStepX is + +- transforms produce candidate target representations +- limits decide which ones are reachable +- pier-side/orientation policy chooses among them +- wrap normalization may unwind coordinates into better branches +- waypoints and heuristics make the chosen path practical +- runtime limits keep watching after motion begins + +## So the goto system is best understood as + +- a target-planning and motion-decision engine + +not just a coordinate conversion followed by a slew. diff --git a/docs/HOMING_NOTES.md b/docs/HOMING_NOTES.md new file mode 100755 index 0000000..d100045 --- /dev/null +++ b/docs/HOMING_NOTES.md @@ -0,0 +1,461 @@ +# Homing Notes + +## Purpose + +These notes describe how mount homing currently works in OnStepX. + +This is a workflow note, not a deep explanation of low-level input filtering. +For the shared sensing subsystem itself, see: + +- [SENSING_NOTES.md](SENSING_NOTES.md) + +## For how homing relates to startup trust/authority, also see + +- [STARTUP_AUTHORITY_NOTES.md](STARTUP_AUTHORITY_NOTES.md) + +## Quick Summary + +## There are three related but different ideas + +1. Return to home + Move the mount to the configured home coordinates +2. Sensed home + Use home switches/sensors to find home +3. Reset at home + Rebuild the coordinate basis from the known home position + +Those are often used together, but they are not the same operation. + +## The Main Entry Points + +## The core mount home commands are + +- `:hC#` + move to home +- `:hF#` + reset the mount at home / cold-start position +- `:hA0#` / `:hA1#` + disable/enable automatic home at boot +- `:hC1,R#` / `:hC2,R#` + toggle home-sense reversal for axis1/axis2 +- `:hC1,n#` / `:hC2,n#` + set home sense offset in arc-seconds + +## Status command + +- `:h?#` + returns `hasSense,axis1Offset,axis2Offset` + +## What "Home" Means + +## The configured home position is derived from + +- mount type +- configured home defaults +- site latitude where relevant +- optional sense offsets +- special geometry such as meridian-flip handling + +That home position is refreshed by `Home::init()` and then returned through +`home.getPosition(...)`. + +So "home" is not just a fixed pair of axis numbers. It is computed in context. + +## It is also important to separate + +- mount orientation +- coordinates assigned to that orientation + +Without home switches, "home" is primarily a coordinate definition that the +system returns to or resets against. In that case, home is not independently +observed from hardware. It is whatever mount orientation the current coordinate +basis says corresponds to the home coordinates. + +That means the practical truth about what mount orientation counts as "home" +can shift when the coordinate basis shifts. + +## Examples + +- an authoritative reset at home reassigns the coordinate basis +- sync/model/origin changes can improve accuracy by shifting how the system + maps mount orientation into coordinates +- after those changes, the home coordinates may correspond somewhat differently + to mount orientation than before + +With home switches, the home procedure has a stronger mount-orientation anchor +because the system is observing a real sense event during homing. + +## So it is best to think of home as + +- a reference in coordinate space + +that may or may not be strongly anchored to mount orientation depending on +whether home sensing is available. + +## The Three Main Workflows + +## Workflow 1: Return To Home Without Sensors + +This is the simple "move to home coordinates" path. + +## It happens when + +- `home.request()` is called +- no home switches/sense inputs are configured + +## Behavior + +- goto must be available +- startup authority must already be trusted +- date and time must be ready +- the mount slews to the computed home coordinates + +This is just motion to a known coordinate target. It does not establish truth +from hardware sensing. + +## Workflow 2: Sensed Home + +This is the switch/sensor-based path. + +## It happens when + +- `home.request()` is called +- home sense is available + +## Behavior + +- goto must be available +- if startup authority is not trusted, sensed home is still allowed because it + can establish trust +- the guide subsystem starts a special home-guiding mode +- each axis uses `autoSlewHome()` to find the home switch state +- the axis may first move off the switch or toward it depending on the current + sensed state +- the axis refines through fast/slow/fine homing stages + +## If sensing succeeds + +- `home.guideDone(true)` runs +- an authoritative reset is performed +- startup authority becomes trusted + +## If sensing fails + +- `home.guideDone(false)` runs +- a non-authoritative reset/recovery path is attempted +- the home operation is marked failed + +## What The Axis Class Actually Does During Sensed Home + +The mount-level home request is only part of the story. The detailed switch +search sequence lives down in the axis class. + +Each relevant axis uses `Axis::autoSlewHome()`. + +## The important sequence is + +1. Check the current home-sense state +2. Choose an initial direction +3. Slew until the sense state changes in the expected way +4. Decelerate to a stop +5. Refine through additional slower passes + +## More concretely + +- if home sense is already ON, the axis first moves forward off the switch +- if home sense is OFF, the axis first moves reverse toward the switch +- when the sense state changes appropriately, the axis stops +- the homing stage advances from `HOME_FAST` to `HOME_SLOW` +- then usually to `HOME_FINE` + +## During the refinement sequence + +- the slew rate is reduced +- the axis repeats the search with tighter motion +- if the switch state is still not in the expected condition after the slow + pass, an approach correction path is used before the final fine pass + +This is why sensed home is more than "drive until switch closes once." It is a +small staged search procedure implemented at the axis level. + +## Timeout also matters + +- if no explicit timeout is supplied, the axis derives one from the configured + home distance limit and slew rate +- if the search times out, the homing slew aborts + +## Motion safety still applies + +- motion errors abort homing +- motor faults abort homing +- common min/max sense conflicts can also abort the slew + +## So the full sensed-home sequence is + +- mount/home layer decides that sensed home should happen +- guide layer starts coordinated home-guiding +- axis layer performs the actual staged switch search +- home layer interprets success/failure and performs reset/recovery + +## Workflow 3: Reset At Home + +This is the coordinate-basis rebuild step. + +## It happens through + +- `home.reset(...)` +- `:hF#` +- startup reset logic +- successful sensed-home completion + +## Behavior + +- tracking is stopped +- tracking-rate offsets are cleared +- goto first-use state is reset +- motor positions are reset to zero where appropriate +- home instrument coordinates are written back +- nominal index positions are captured +- backlash and slow slew defaults are restored + +## If the reset is authoritative + +- startup trust is granted + +## If it is not authoritative + +- it does not grant trust by itself + +## Authoritative vs Non-Authoritative Reset + +This is one of the key distinctions. + +## Authoritative reset means + +- the software has a good reason to believe the home position being applied is + truly correct + +## Examples + +- successful sensed home +- startup reset using valid paired absolute authority +- explicit authoritative origin/home workflows + +## Non-authoritative reset means + +- coordinates are being reassigned to home, but the software is not treating + that as proof of truth + +## This distinction matters because + +- authoritative reset can establish startup trust +- non-authoritative reset cannot + +## How Trust Interacts With Homing + +Homing is one of the main bridges between untrusted and trusted state. + +## Important rules + +- plain return-to-home without sensors requires trust first +- sensed home can be used to regain trust +- authoritative reset grants trust +- non-authoritative reset does not + +## There is also one permissive carveout + +- in `SA_AUTO` on simple mounts with no absolute encoders and no coordinate + memory, home/reset is allowed to bypass the sync-limit style coordinate jump + restriction + +That keeps older/simple mounts practical without weakening the stricter cases +globally. + +## Auto Home At Boot + +## If `automaticAtBoot` is enabled + +- autostart requests home after boot + +This shares the same sensed-home or return-home machinery as a normal home +request. It is not a separate home implementation. + +## That means + +- success behaves like normal homing success +- failure behaves like normal homing failure +- auto-home does not silently pretend success if the sensed-home flow fails + +## No-Goto Behavior + +## If `GOTO_FEATURE == OFF` + +- home request is rejected +- reset/home-with-motion request is rejected +- sensed home through guide-home is also rejected + +This is intentional. + +## In no-goto builds + +- there is no fast automatic slew/home capability +- home/return is not supposed to pretend to exist as a supported motion mode + +## How Home Sense Offsets Work + +Each mount axis can have a stored sense offset. + +## These offsets mean + +- the physical home sense event is not necessarily the final logical home + coordinate + +## Typical use + +- a switch is placed somewhere repeatable but not exactly at the desired final + home location +- the offset defines the difference between switch-detected home and desired + coordinate home + +## Commands + +- `:hC1,n#` +- `:hC2,n#` + +## Examples + +- `:hC1,120#` + set axis1 home offset to +120 arcsec +- `:hC2,-300#` + set axis2 home offset to -300 arcsec + +## Two Offset Modes + +The config option `MOUNT_HOME_AT_OFFSETS` changes how offsets are used. + +## When `MOUNT_HOME_AT_OFFSETS == OFF` + +- sensed home resets at the switch-derived home first +- then, if offsets are in use, the mount may perform a finishing move toward + the true home coordinates after the authoritative reset + +## When `MOUNT_HOME_AT_OFFSETS == ON` + +- offsets are folded directly into the computed home position + +## So the difference is basically + +- separate finishing move +vs +- home already means the offset-adjusted position + +## Home Sense Reversal + +Each axis can also reverse the meaning of its home sense input. + +## Commands + +- `:hC1,R#` +- `:hC2,R#` + +This is layered on top of the usual home-sense logic and is applied through +`setReversal()`. + +Axis1 also has a latitude-related reversal for equatorial mounts in the +southern hemisphere, so axis1 home sense behavior is slightly more subtle than +just a plain stored boolean. + +## Examples + +## Example 1: Simple mount, no home switches + +- user powers on +- mount already has trusted startup authority or permissive `SA_AUTO` +- `:hC#` moves to home coordinates +- `:hF#` can reset at the home position + +## Example 2: Mount with home switches + +- user or autostart requests home +- guide-home uses switch sensing to find home +- successful sensed home performs authoritative reset +- trust is granted + +## Example 3: Switch is repeatable but not exactly at desired home + +- home sense is configured +- nonzero offsets are stored +- sensed home finds the switch +- reset establishes truth +- final coordinate home may be offset from the literal switch crossing + +## Special Geometry Cases + +Sector gear axis1 and tangent-arm axis2 are special. + +In those cases, homing and reset do not always follow the plain "reset both +axes to zero and write home coordinates" pattern. + +For these geometries, home is not only about returning to a meaningful +coordinate reference. It is also about resetting the mechanism so later gotos +and tracking have useful travel remaining inside the limited range. + +## So on a sector gear or tangent-arm mount, homing is often better understood as + +- mechanical re-baselining of the constrained axis +- restoring useful travel for later motion +- re-establishing the coordinate-to-mechanism relationship for that limited + range + +Because of that, some of the ordinary coordinate-based prechecks are also less +meaningful here. On these mounts the code relaxes or skips parts of the normal +"how far are we from home in coordinates?" logic before sensed homing, because +operation is fundamentally constrained and often more manual. + +## Instead + +- origin/position handling is adjusted to fit the special axis geometry +- successful sensed home may set origin more directly for the special axis + +So if behavior looks a little different on sector gear or tangent-arm mounts, +that is expected. + +## Failure Modes + +## Homing can fail because of + +- goto disabled +- motion already active +- missing date/time for plain return-home +- distance-to-home outside the configured sensed-home search limit +- switch search timeout +- motion error or motor fault during homing +- reset failure after the home-search phase + +The code tries to fail conservatively rather than pretending home succeeded. + +## Relationship To Sensing + +Homing depends heavily on the shared sensing subsystem, but that low-level +behavior is documented separately. + +## If you need to understand + +- how `HIGH | HYST(20)` is interpreted +- how analog threshold/hysteresis sensing works +- how runtime reversal works + +## see + +- [SENSING_NOTES.md](SENSING_NOTES.md) + +## Good Mental Summary + +## The cleanest summary is + +- return-to-home is motion to a known coordinate target +- sensed home is a hardware-based search procedure +- reset-at-home rebuilds the coordinate basis +- authoritative homing/reset can establish startup trust + +Those are related operations, but they are not interchangeable. diff --git a/docs/PEC_NOTES.md b/docs/PEC_NOTES.md new file mode 100755 index 0000000..55cfb05 --- /dev/null +++ b/docs/PEC_NOTES.md @@ -0,0 +1,420 @@ +# PEC Notes + +## Purpose + +These notes describe how PEC currently works in OnStepX. + +## PEC is one of the harder features to reason about because it combines + +- persistent state +- a sampled correction table +- worm indexing +- tracking state +- guide interaction +- park/unpark interaction + +## The implementation is concentrated mainly in + +- `src/telescope/mount/pec/Pec.h` +- `src/telescope/mount/pec/Pec.cpp` +- `src/telescope/mount/pec/Pec.command.cpp` + +## Quick Summary + +## The clean mental model is + +1. PEC stores one correction value per sidereal second of worm rotation +2. a worm index event establishes where the buffer starts +3. playback adds/subtracts a small tracking-rate correction each second +4. recording learns those per-second corrections from accumulated guide action + +## So PEC in OnStepX is basically + +- a one-second-slot correction table wrapped around the worm rotation + +## What PEC Applies To + +## Current mount PEC support is for + +- axis1 only + +Although the implementation and terminology are written around a worm cycle, +the correction model does not technically require a worm. It can also model +other repeatable geared error sources as long as: + +- the cycle can be indexed +- the cycle length is stable +- the cycle period fits within the supported PEC limits/buffer size + +## If `PEC_BUFFER_SIZE_LIMIT == 0` or `PEC_STEPS_PER_WORM_ROTATION == 0` + +- PEC is effectively disabled + +## The Main Stored Data + +## PEC stores + +- whether valid PEC data have been recorded +- current PEC state +- worm rotation length in steps +- the PEC correction buffer itself + +The small settings live in normal NV settings storage. + +## The correction table itself lives in a dedicated NV partition named + +- `PEC` + +## Important persistence detail + +- changing or recording PEC data in RAM does not automatically write the PEC + table to NV +- writing the PEC table to NV only happens on explicit user command + +## This is separate from PEC control state + +- arming playback/record or disabling PEC updates the small PEC settings in NV +- but the actual correction table is only written by explicit save command + +## That means + +- after a recording session, the in-memory PEC table may differ from the + persisted PEC table +- if the user does not explicitly save the new data, a reboot comes back with + whatever PEC table was previously stored + +## This is useful because + +- a bad recording session can simply be abandoned by not saving it + +## The PEC Buffer + +The PEC buffer is not stored as one entry per motor step. + +## Instead + +- one entry represents one sidereal second of worm rotation + +## That means + +- buffer size in bytes is approximately worm rotation time in seconds + +## Example + +- if one worm rotation takes 720 sidereal seconds +- the PEC buffer has 720 entries + +Each entry is an `int8_t` correction value. + +So each second of worm rotation gets a small signed rate correction. + +## How Worm Rotation Length Is Used + +## The configured worm rotation length is stored as + +- `PEC_STEPS_PER_WORM_ROTATION` + +## PEC uses that to derive + +- seconds per worm rotation +- buffer size +- current worm-rotation position from current axis1 motor steps + +## So PEC fundamentally depends on + +- knowing how many axis1 motor steps correspond to one worm rotation + +## Two Ways PEC Gets Its Index + +## PEC can work with + +1. real sense input (`PEC_SENSE != OFF`) +2. virtual wraparound indexing (`PEC_SENSE == OFF`) + +## With real sense input + +- a sense event on `PEC_SENSE_PIN` defines the worm index +- PEC waits for enough worm travel before accepting another index +- this avoids repeated false retriggers too close together + +## Without real sense input + +- PEC treats worm rotation wraparound as a virtual index + +## So + +- hardware sense gives a stronger physical anchor +- no-sense PEC is still possible, but indexing is inferred + +## How The Index Event Works + +## When PEC sense is enabled + +- the sense input is read through the shared `Sense` subsystem +- a valid ON transition after enough worm travel is treated as an index event +- the current axis1 motor step position becomes `wormSenseSteps` +- PEC marks that it has a valid worm reference +- playback buffer position can be realigned to that reference + +## This is why the sensing note matters here too + +- low-level sense filtering decides whether the PEC index input is ON +- PEC then adds its own motion/spacing logic before trusting that event as a + real index + +## When PEC Is Active + +PEC is only allowed to do real work when the mount is in an appropriate state. + +## Main requirements + +- the mount must be tracking +- guide state must not exceed pulse-guide style use +- the mount must not be parking or parked + +## If those conditions are not true + +- PEC disables recording +- PEC pauses playback + +## Important distinction + +- playback pause is not the same as losing PEC data + +## If PEC was playing and the mount becomes ineligible + +- state drops back to `PEC_READY_PLAY` +- playback can resume after re-indexing/alignment timing is right again + +## The PEC State Machine + +## Main states + +- `PEC_NONE` +- `PEC_READY_PLAY` +- `PEC_PLAY` +- `PEC_READY_RECORD` +- `PEC_RECORD` + +## Meaning + +- `PEC_NONE` + PEC inactive +- `PEC_READY_PLAY` + user requested playback; PEC is waiting for the right timing/index position +- `PEC_PLAY` + PEC actively applying corrections +- `PEC_READY_RECORD` + user armed recording; PEC is waiting for the right timing/index position +- `PEC_RECORD` + PEC actively recording guide-derived corrections + +## Why "Ready" States Exist + +PEC does not jump into play or record at an arbitrary instant. + +## Instead, it waits until + +- the worm position is aligned to a one-second slot boundary + +This makes the table alignment cleaner and keeps the one-second buffer indexing +consistent. + +## So "ready" means + +- the user has requested the action +- PEC is waiting for the correct phase/alignment to begin + +## Playback + +## During playback + +- PEC advances the buffer index once per sidereal second +- it looks up the correction for the current worm segment +- it applies that as a fractional tracking-rate offset + +## One subtle detail + +- playback uses the correction from one second earlier than the current segment + +The code comments describe this as a rough latency estimate between image +acquisition and response. + +So PEC playback is intentionally shifted slightly ahead in effect. + +## Recording + +## During recording + +- guide contribution on axis1 is accumulated +- once per sidereal second, that accumulated correction is quantized into a + small signed step value +- that value becomes the PEC table entry for the current buffer slot + +## If this is not the first recording + +- new data are blended with existing data using a weighted average + +## So PEC recording is not just "write raw guide values directly." It is + +- accumulate +- quantize per second +- optionally blend with existing data + +## What "First Recording" Changes + +## If this is the first time PEC is being recorded + +- the new table is taken directly from current recording data + +## If PEC data already exist + +- new data are blended with the old table + +That lets users refine an existing PEC table rather than always replacing it +from scratch. + +## Cleanup After Recording + +## When recording finishes + +- PEC automatically switches to play +- the table is run through a cleanup pass + +## Cleanup includes + +- a low-pass smoothing pass +- a linear-regression style correction so the total sequence sums close to zero + +That last part matters because PEC corrections should not create a long-term +net tracking bias over a whole worm cycle. + +## If the cleanup result looks unreasonable + +- PEC invalidates the recorded data +- PEC drops back to `PEC_NONE` + +## Why The Sum Matters + +A PEC table is supposed to redistribute tracking slightly over the worm cycle, +not permanently add or subtract motion over a full cycle. + +## So after cleanup + +- the total correction sequence should roughly cancel out + +That is why PEC does a "reality check" on the residual sum. + +## Park / Unpark Interaction + +PEC interacts with park in an important way. + +## When parking + +- PEC is turned off +- the current worm sense position is saved into park settings + +## When unparking/restoring + +- that saved worm sense position is restored + +## If a real `PEC_SENSE` input exists + +- worm index truth is also recovered automatically once the worm rotates far + enough to detect the next valid PEC index event + +So the restored saved position helps continuity immediately after unpark, while +the physical PEC sense can later re-anchor the index automatically on the next +cycle. + +So park/unpark is part of how PEC continuity is maintained across a parked +interval. + +This is another reason PEC is harder to reason about than a simple runtime +feature. It is not independent of park state. + +## Examples + +## Example 1: Playback with real worm index + +- PEC data were previously recorded +- user enables PEC playback +- state becomes `PEC_READY_PLAY` +- mount tracks +- PEC waits for the right segment timing +- playback starts +- a later real PEC index event can realign buffer start + +## Example 2: Recording new PEC data + +- mount is tracking +- user arms PEC recording +- state becomes `PEC_READY_RECORD` +- at the right timing boundary PEC enters `PEC_RECORD` +- guide activity is accumulated into one-second corrections +- after one worm cycle, recording finishes +- cleanup runs +- PEC switches into playback + +## Example 3: Mount stops tracking during playback + +- PEC was in `PEC_PLAY` +- tracking stops or mount becomes ineligible +- PEC falls back to `PEC_READY_PLAY` +- rate goes to zero +- playback can later resume when conditions are valid again + +## Commands + +## There are several PEC commands, but the most important control ones are + +- `:$QZ+#` + arm/enable playback +- `:$QZ-#` + disable PEC +- `:$QZ/#` + arm recording +- `:$QZZ#` + clear the PEC buffer +- `:$QZ!#` + save PEC data to NV +- `:$QZ?#` + get PEC status + +## There are also read/write commands for + +- table contents +- worm rotation steps +- buffer size +- current index location + +## For the exact command list, see + +- [COMMAND_REFERENCE.md](COMMAND_REFERENCE.md) + +## Things That Make PEC Hard To Reason About + +## PEC combines several different concerns at once + +- mount motion state +- tracking state +- guide accumulation +- worm index sensing +- one-second slot timing +- persistent storage +- park/unpark continuity + +That is why local code reading can still leave the feature feeling opaque. + +## Good Mental Summary + +## The most useful summary is + +- PEC is a per-second correction table over one worm rotation +- indexing tells PEC where the table starts +- playback applies one correction slot each sidereal second +- recording learns those slots from guide activity +- cleanup makes the finished table smooth and net-neutral over the full cycle + +If you keep that model in mind, the rest of the state machine becomes much +easier to follow. diff --git a/docs/SENSING_NOTES.md b/docs/SENSING_NOTES.md new file mode 100755 index 0000000..2ffcdbd --- /dev/null +++ b/docs/SENSING_NOTES.md @@ -0,0 +1,401 @@ +# Sensing Notes + +## Purpose + +## These notes describe the shared sensing subsystem used across OnStepX for + +- home sense +- limit sense +- park sense +- PEC sense +- some local focuser/button-style inputs + +The main reason this deserves its own note is that a "sense input" in OnStepX +is not just a simple digital switch. The same general machinery supports: + +- ordinary digital active-high or active-low inputs +- digital inputs with software time filtering +- analog threshold sensing +- analog hysteresis behavior +- runtime inversion of the logical sense state + +There is also a related but separate `Button` helper for more button-specific +input behavior, including analog range comparison. That is covered near the end +of this note. + +## Quick Summary + +## The simplest mental model is + +1. raw GPIO or analog input comes in +2. `Sense` turns it into a normalized ON/OFF state +3. higher-level code decides what ON/OFF means operationally + +## Examples + +- home code asks whether home sense is active/ON according to its configured + `HIGH`/`LOW` meaning +- limit code asks whether the min/max sense is ON +- PEC asks whether the worm index sense is ON + +The same low-level sensing code is reused in all of those cases. + +## Where The Shared Sense Code Lives + +## The main subsystem is + +- `src/lib/sense/Sense.h` +- `src/lib/sense/Sense.cpp` + +## Main API + +- `sense.add(...)` +- `sense.isOn(...)` +- `sense.changed(...)` +- `sense.stableMillis(...)` +- `sense.reverse(...)` +- `sense.poll()` + +In most feature code, the higher-level subsystem does not read the GPIO pin +directly. It registers a sense input once and then works with the normalized +result through a sense handle. + +## How Sense Configuration Works + +## Each sense input is defined by + +- a pin +- an init mode such as `INPUT`, `INPUT_PULLUP`, or `INPUT_PULLDOWN` +- a packed trigger value + +The packed trigger value normally combines pieces with `|`. + +That is the usual configuration pattern. + +## Examples + +- `HIGH` +- `LOW` +- `HIGH | HYST(20)` +- `LOW | HYST(50)` +- `HIGH | THLD(512)` +- `LOW | THLD(300) | HYST(25)` + +Combining flags numerically with `|` is typically the intended style. + +## What The Trigger Encodes + +## The trigger value carries + +- the active state bit: `HIGH` or `LOW` +- an optional analog threshold via `THLD(v)` +- an optional hysteresis via `HYST(v)` + +## Important rule + +- if the threshold part is zero, the input is treated as digital +- if the threshold part is nonzero, the input is treated as analog + +## So + +- `HIGH | HYST(20)` is still digital +- `LOW | THLD(400) | HYST(15)` is analog + +## Digital Sense + +Digital mode is used when there is no threshold component. + +## Behavior + +- raw input is read with `digitalReadEx(pin)` +- `HYST(n)` is the required stable time in milliseconds before a digital state + change is accepted +- the new digital sample must remain unchanged for that long before the + logical state changes + +## So in digital mode, `HYST()` does not mean an analog band. It means + +- how long the signal must stay stable before the change is accepted + +## Examples + +- `HIGH` + active-high digital input, no extra filtering +- `LOW` + active-low digital input, no extra filtering +- `HIGH | HYST(10)` + active-high digital input, require about 10ms of stable state before the + logical result changes +- `LOW | HYST(50)` + active-low digital input with heavier software debounce/noise filtering + +## This is useful for + +- switch debounce +- modest EMI/RFI filtering +- noisy digital inputs that should not chatter + +## Analog Sense + +Analog mode is used when a threshold component is present. + +## Behavior + +- raw input is read with `analogRead(...)` +- on ESP32, `analogReadMilliVolts(...)` is converted back into the common + `ANALOG_READ_RANGE` scale for higher accuracy on this platform +- the threshold and hysteresis act like a software Schmitt trigger + +## This means + +- if the sample rises above `threshold + hysteresis`, the logical value becomes + `HIGH` +- if the sample falls below `threshold - hysteresis`, the logical value becomes + `LOW` +- inside the band between those two thresholds, the last logical state is + retained + +## That band is effectively a deadband zone + +- the signal can move around inside it without causing repeated state changes +- a state change only happens after the signal leaves the deadband on one side + or the other + +## Examples + +- `HIGH | THLD(512)` + active-high analog threshold at mid-scale, no hysteresis band +- `LOW | THLD(300) | HYST(25)` + active-low analog threshold input with a hysteresis band around the threshold +- `HIGH | THLD(800) | HYST(50)` + active-high analog input that must move well above and below the threshold + before changing state + +## This is useful when + +- a clean digital threshold is not available from hardware +- analog noise would otherwise cause state chatter + +## Why Hysteresis Means Two Different Things + +This is one of the easiest things to forget. + +## In digital mode + +- `HYST(n)` means time in milliseconds + +## In analog mode + +- `HYST(n)` means an analog hysteresis band around the threshold, creating a + deadband zone where the current state is held + +That dual meaning is intentional, but it is easy to misread in config. + +## What "ON" Means + +## The subsystem separates + +- the filtered internal logical value (`HIGH` or `LOW`) +- whether that logical value counts as ON for the caller + +`sense.isOn(...)` returns true when the filtered value matches the configured +active state. + +## So + +- active-high means HIGH is considered ON +- active-low means LOW is considered ON + +## This lets higher-level code work with + +- "is the home sense active?" +- "is the limit sense active?" + +without caring whether the hardware is electrically active-high or active-low. + +## Runtime Reversal + +`sense.reverse(handle, state)` flips the interpretation at runtime. + +This is different from the original config. + +## Config answers + +- what electrical state counts as active + +## Runtime reversal answers + +- should this sense be interpreted the opposite way right now + +## In practice this is used by code such as + +- `Axis::setHomeReverse()` + +This is useful when the electrical truth stays the same but the motion logic +needs the opposite interpretation. + +## Where `Sense` Is Used + +## Shared `Sense` users currently include + +- axis home sense +- axis min/max limit sense +- park sense +- park signal monitoring +- PEC worm index sense +- local focuser sense inputs + +That is why it is better to think of `Sense` as a general-purpose input +normalization subsystem, not just "home switch code." + +## Example: Home Sense + +Axis home sense is registered in `Axis::init()`. + +## Important behavior + +- homing first checks whether home sense is already ON +- if it is ON, motion first goes forward off the switch +- if it is OFF, motion first goes reverse toward the switch + +So home sense is not just an endpoint detector. It also affects the search +direction and homing flow. + +## Typical home examples + +- `AXIS1_SENSE_HOME HIGH` + simple active-high home switch +- `AXIS1_SENSE_HOME LOW | HYST(20)` + active-low home switch with digital debounce +- `AXIS1_SENSE_HOME HIGH | THLD(450) | HYST(20)` + analog thresholded home sense with hysteresis + +## Example: Limit Sense + +Limit sense uses the same subsystem for min/max axis limits. + +## Runtime behavior + +- `Axis::poll()` updates the sensed limit flags +- `Limits::poll()` reacts and stops the relevant motion direction + +## One important special case + +- min and max can share the same physical pin + +## By default + +- the axis notes this as `commonMinMaxSense` +- the higher-level limit logic avoids treating one shared input as two separate + independent events + +## Config option + +- `LIMIT_SENSE_STRICT == ON` disables that relaxation and treats shared min/max + more strictly + +## Typical limit examples + +- `LIMIT_SENSE LOW` + common active-low limit input +- `LIMIT_SENSE LOW | HYST(10)` + common active-low limit input with digital filtering + +## Example: Park Sense + +## Parking uses the same sensing framework for + +- `PARK_SENSE` +- `PARK_SIGNAL` + +Those are not special sensing implementations. They are just more clients of +the shared normalized ON/OFF sensing subsystem. + +## Example: PEC Sense + +PEC can also use the same shared `Sense` subsystem. + +## That means the PEC index input can also be + +- digital +- analog thresholded +- analog with hysteresis + +Then PEC adds its own higher-level logic on top, such as only accepting a new +index event after enough motion has occurred. + +## So + +- `Sense` decides whether the input is ON +- PEC decides whether that ON transition counts as a valid worm index event + +## What `Sense` Does Not Do + +The shared `Sense` subsystem does not implement every kind of analog input +pattern. + +## In particular, it does not implement + +- "pressed when analog value lies within a range" + +## It is focused on + +- digital filtered ON/OFF sensing +- analog threshold-plus-hysteresis ON/OFF sensing + +## Related But Separate: `Button` + +## There is a related helper in + +- `src/lib/pushButton/PushButton.h` +- `src/lib/pushButton/PushButton.cpp` + +## That helper is more button-focused and adds behavior such as + +- press/release semantics +- click and double-click detection +- tone/frequency detection +- analog threshold mode +- analog range/value mode + +That analog value/range mode is the "pseudo-digital using analog sampling and +range comparison" behavior. + +## So if someone is looking for + +- analog value-in-range detection +- button semantics +- tone-style input behavior + +they should usually look at `Button`, not `Sense`. + +## Practical Rules Of Thumb + +## If the input is a normal switch + +- start with plain `HIGH` or `LOW` + +## If the switch chatters or is noisy + +- add `HYST(n)` and remember that in digital mode it means milliseconds + +## If the input is fundamentally analog + +- use `THLD(...)` +- add `HYST(...)` if you want Schmitt-trigger-like stability + +## If the meaning of the signal must flip at runtime + +- use runtime reversal rather than redefining the electrical config + +## Good Mental Summary + +## The cleanest way to think about sensing in OnStepX is + +- config defines how raw input should be interpreted +- `Sense` turns that raw input into a stable ON/OFF result +- higher-level features decide what ON/OFF means operationally + +That separation is why the same low-level sensing subsystem can be reused for +home, limits, park, PEC, and other features without each subsystem reinventing +analog/digital input conditioning. diff --git a/docs/SERIAL_NOTES.md b/docs/SERIAL_NOTES.md new file mode 100755 index 0000000..5efebc9 --- /dev/null +++ b/docs/SERIAL_NOTES.md @@ -0,0 +1,314 @@ +# Serial Notes + +## Purpose + +These notes explain how serial interfaces are used in OnStepX and why serial +configuration can be confusing across platforms. + +## The short version is + +- a platform may support several kinds of serial interfaces +- a pinmap chooses which ones are exposed for a given board +- a feature may or may not be well suited to the chosen serial transport + +## So "serial is supported" does not always mean + +- easy to configure +- portable to another board +- good for real-time runtime use + +## Quick Summary + +## Think about serial in three layers + +1. Platform: + What the MCU/core can do +2. Pinmap: + Which serial roles are exposed on this board +3. Feature: + Whether the transport is actually a good fit for the workload + +## Examples + +- GPS over `SoftSerial` can be fine +- TMC2209 over `SoftSerial` may compile but still be a poor runtime fit +- Teensy can expose extra USB virtual serial ports +- ESP32 can often move hardware UARTs to different pins + +## The Main Serial Roles + +OnStepX uses generic serial role names instead of hard-coding one board's port +names everywhere. + +## Common roles include + +- `SERIAL_A` +- `SERIAL_B` +- `SERIAL_C` +- `SERIAL_D` +- `SERIAL_E` +- `SERIAL_GPS` +- `SERIAL_TMC` +- `SERIAL_DEBUG` + +These are best thought of as roles, not fixed physical ports. + +## One board might make + +- `SERIAL_B = Serial2` + +## Another board might make + +- `SERIAL_B = HardSerial` with configured RX/TX pins + +Another board might not expose `SERIAL_B` at all. + +## The Main Serial Types + +## In practice, OnStepX may use + +- built-in hardware serial ports such as `Serial1`, `Serial2`, etc. +- created hardware serial objects using chosen RX/TX pins +- `SoftwareSerial` +- USB virtual serial ports +- internal pseudo-serial helpers such as `SERIAL_LOCAL` + +All of these may look stream-like in code, but they are not equally suitable +for all jobs. + +## Platform Differences + +This is where a lot of confusion starts. + +## Teensy + +- often has multiple hardware UARTs +- can also expose extra USB virtual serial ports depending on USB mode +- some pinmaps use that to expose `SERIAL_D = SerialUSB1` and + `SERIAL_E = SerialUSB2` + +## ESP32 + +- usually has flexible hardware UART routing +- can often place UART RX/TX on non-default pins +- that makes created hardware serial or remapped UART use more practical than + on some other Arduino-class targets +- also has optional Bluetooth serial support in the HAL + +## STM32 + +- often supports created/remapped hardware serial well +- also pulls in `SoftwareSerial` support early in the HAL because library/core + behavior can otherwise get awkward + +## Why ESP32 Is Worth Calling Out + +ESP32 is a good example of why "hardware serial" does not always mean +"hard-wired fixed pins." + +## In OnStepX, some ESP32 pinmaps define roles like + +- `SERIAL_B = Serial2` +- `SERIAL_TMC = Serial1` + +## and then separately define + +- `SERIAL_B_RX` +- `SERIAL_B_TX` +- `SERIAL_TMC_RX` +- `SERIAL_TMC_TX` + +That means the feature gets a real hardware UART, but the board still has some +freedom to place it where it makes sense. + +## This is one reason ESP32 can be a nice middle ground + +- better than `SoftSerial` for runtime work +- more flexible than boards with only fixed UART pin assignments + +## Pinmaps Decide What Exists + +The pinmap layer is where generic serial roles become concrete. + +## This means + +- a feature may request `SERIAL_GPS` +- but whether that becomes `SoftSerial`, `HardSerial`, `Serial1`, or something + else depends on the pinmap and platform + +## Compile-time validation catches some problems, for example + +- a baud rate is enabled for a serial role that the pinmap did not define +- a TMC UART driver is enabled but `SERIAL_TMC` is missing + +## What validation does not prove + +- that the chosen serial transport is a good runtime fit +- that it is non-blocking enough +- that the underlying library behaves well on that platform + +## Best Uses For Each Type + +## Built-in or created hardware serial + +## Usually best for + +- continuous runtime traffic +- higher baud rates +- frequent bidirectional communication +- motion-control related serial work + +## Examples + +- shared TMC2209 UART on boards designed for it +- a secondary MCU link +- frequent device polling + +## `SoftwareSerial` + +## Usually best for + +- one-time configuration at boot +- low-rate telemetry +- devices that become less important once startup finishes + +## Examples + +- GPS +- boot-time driver setup in some constrained builds + +## USB virtual serial + +## Usually best for + +- extra host-side channels +- debug, tooling, or auxiliary control on supported platforms + +## Examples + +- Teensy `SerialUSB1` +- Teensy `SerialUSB2` + +## Why `SoftwareSerial` Is Tricky + +`SoftwareSerial` is often the most confusing case because it is sometimes very +useful and sometimes a terrible fit. + +## General concerns + +- it is often blocking or close enough to blocking to matter +- support quality varies by platform +- timing behavior varies by core and library +- library code sitting on top of it may own the actual read/write behavior + +So if a feature "supports `SoftSerial`", that should not automatically be read +as: + +- well tested +- non-blocking +- appropriate for real-time runtime use + +## Example: GPS + +GPS is one of the better cases for less-than-perfect serial. + +## Why + +- relatively low-rate +- mostly an input stream +- used to establish time/location +- OnStepX may close the GPS serial port once current time has been acquired + +So GPS over `SoftSerial` can be a reasonable trade on many builds. + +That does not make `SoftSerial` universally good. It just means GPS is a +feature that can often tolerate it. + +## Example: TMC2209 UART + +TMC2209 is the opposite kind of example. + +## Why it is harder + +- runtime UART interaction can matter +- mode changes may happen during operation +- status/config traffic may be needed while the rest of the mount is busy +- blocking behavior is much more painful in a real-time motion system + +## So for TMC2209 + +- `SoftSerial` may be acceptable for one-time setup at boot +- `SoftSerial` is much less attractive for active runtime interaction + +That does not mean `SoftSerial` is useless here. It means the use case matters. + +## Example: More Than Four TMC2209s + +## There is one place where `SoftSerial` can still be attractive for TMC2209 + +- per-device links can make scaling easier when a shared hardware UART bus gets + awkward + +## So there is a real trade + +- shared hardware UART is usually better for runtime quality +- per-device `SoftSerial` may make some larger or stranger topologies possible + +## This is why the answer is not simply + +- "never use `SoftSerial`" + +## It is more like + +- use it carefully +- prefer it for boot/setup or unusual topologies +- do not assume it is ideal for active runtime control + +## Library Ownership Matters + +## Another subtle point + +OnStepX may define the transport, but the feature library often performs the +real reads and writes. + +## That means serial behavior depends on + +- the platform core +- the chosen transport +- the feature library + +## This is especially relevant for + +- TMC driver libraries +- any feature with frequent serial traffic + +So a configuration can be theoretically valid while still being lightly tested +or operationally uncertain. + +## Practical Rules Of Thumb + +## If the serial link is mostly needed at boot + +- `SoftSerial` may be acceptable + +## If the serial link is needed continuously during runtime + +- prefer hardware UART where possible + +## If the board/platform offers extra USB serial channels + +- treat that as a platform-specific bonus, not a general Arduino assumption + +## If a user is choosing between "works in theory" and "works robustly" + +- favor the more boring hardware-UART option + +## Good Mental Summary + +## The simplest reliable way to think about serial in OnStepX is + +- HAL defines what the platform can plausibly do +- the pinmap assigns generic serial roles to actual transports +- the feature decides whether that transport is really suitable + +That last step is where most serial surprises come from. diff --git a/docs/SERVO_SETUP.md b/docs/SERVO_SETUP.md new file mode 100755 index 0000000..479aabc --- /dev/null +++ b/docs/SERVO_SETUP.md @@ -0,0 +1,496 @@ +# Servo Setup Guide + +## Purpose + +This guide is for setting up a mount axis that uses servo feedback in OnStepX. + +It is written for users who want a practical bring-up sequence: +- what to configure first +- what to test before moving faster +- what to adjust when things go the wrong way + +This guide is intentionally light on control theory. The goal is to help you +get to a safe, working setup without having to understand every low-level +detail first. + +## Before you begin + +Have these basics sorted out first: +- the controller pinmap matches your hardware +- power wiring is correct +- motor wiring is correct enough that the driver powers up safely +- encoder wiring is correct enough that counts can be read reliably +- hard limits or other motion safeguards are planned before unattended use + +Important safety note: +- do not leave a new servo setup tracking unattended until you have verified + limits, stop behavior, and the direction of both the motor and encoder +- a servo that is "mostly working" can still drive hard into a stop if the + setup is wrong + +## What "servo" means here + +In OnStepX, a servo axis is a motor axis that closes the loop using encoder +feedback. + +In practical terms that means: +- the motor moves the axis +- the encoder tells OnStepX where the axis actually is +- OnStepX keeps correcting the motor so the axis reaches and holds the target + +For the mount axes, the main items are usually: +- a servo-capable driver model such as `SERVO_PE`, `SERVO_EE`, `SERVO_TMC2209`, + `SERVO_TMC5160`, or `SERVO_KTECH` +- an encoder type such as `AB`, `KTECH_IME`, or another supported encoder +- sensible axis scale and direction settings +- usable PID values + +This guide is mainly about the built-in servo axis types. ODrive-based systems +have their own workflow and deserve separate documentation. + +## How the current `#define`s tie together + +If you are comparing old example configs, this is the compile-time chain that +matters in the current code. + +### 1. `AXIS*_DRIVER_MODEL` decides whether the axis is treated as a servo + +If `AXIS1_DRIVER_MODEL` or `AXIS2_DRIVER_MODEL` is in the servo-driver range, +`Config.defaults.h` defines `AXIS*_SERVO_PRESENT`. + +That is the switch that makes the mount axis build as a servo axis instead of a +step/dir axis. + +### 2. `AXIS*_ENCODER` selects the encoder class + +When `AXIS*_SERVO_PRESENT` is true, `Mount.axis.cpp` selects the encoder from +`AXIS*_ENCODER`. + +Examples: +- `AB` selects a quadrature encoder +- `KTECH_IME` selects the KTech encoder class +- `SERIAL_BRIDGE` selects the serial bridge encoder path + +### 3. `AXIS*_SERVO_FEEDBACK` selects the feedback controller + +`Mount.axis.cpp` currently uses: +- `PID` for a single PID set +- `DUAL_PID` for separate tracking and goto PID sets + +That means these defines feed directly into the live controller: +- `AXIS*_PID_P` +- `AXIS*_PID_I` +- `AXIS*_PID_D` +- `AXIS*_PID_P_GOTO` +- `AXIS*_PID_I_GOTO` +- `AXIS*_PID_D_GOTO` +- `AXIS*_PID_SENSITIVITY` + +### 4. `AXIS*_SERVO_FLTR` selects the encoder filter + +Current mount-axis choices are wired in through `Mount.axis.cpp`: +- `OFF` +- `KALMAN` +- `LEARNING` for Axis1 +- `ROLLING` + +If you are starting fresh, `OFF` is the simplest baseline. + +### 5. Some servo driver models also use motor-side scaling + +For stepper-based servo drivers such as `SERVO_TMC2209`, `SERVO_TMC5160`, and +`SERVO_KTECH`, the code uses this ratio: + +```cpp +AXIS*_MOTOR_STEPS_PER_DEGREE / AXIS*_STEPS_PER_DEGREE +``` + +That ratio is passed into the servo driver in `Mount.axis.cpp`. + +In practical terms: +- `AXIS*_STEPS_PER_DEGREE` is still the mount axis scale +- `AXIS*_MOTOR_STEPS_PER_DEGREE` matters when the motor-side step scale is not + the same as the encoder-side axis scale + +These two are rarely the same. Sometimes the encoders are on the mount axes and there is not reduction and other times there is. Then the encoder has a resolution as well. On the other hand the motor almost always has an associated reduction and full-steps per rotation and 256 micro-steps per full-step. + +### 6. Direction and origin are separate inputs to `ServoMotor` + +The final `ServoMotor` object is built with: +- `AXIS*_REVERSE` +- `AXIS*_ENCODER_REVERSE` +- `AXIS*_ENCODER_ORIGIN` + +These do different jobs: +- `AXIS*_REVERSE` changes commanded motor direction +- `AXIS*_ENCODER_REVERSE` changes encoder sign +- `AXIS*_ENCODER_ORIGIN` is the stored zero/origin for absolute encoder cases + +There is also a runtime reverse path. + +In practical terms: +- `AXIS*_ENCODER_REVERSE` is the baseline wiring/sign correction for the encoder +- `AXIS*_REVERSE` is the baseline motion-direction choice for the axis +- if the axis reverse state is changed at runtime, OnStepX also flips the + control direction so the feedback loop still makes sense + +That is why direction can appear to be handled at more than one level. It is. +Those levels are there for different reasons. + +### 7. `AXIS*_TARGET_TOLERANCE` is not servo-only, but it matters a lot for servo behavior + +`AXIS*_TARGET_TOLERANCE` is passed into the `Axis` object and affects when the +system considers the axis near its target. + +That is why many servo example configs override it even though it is not +strictly a servo-only define. + +### 8. Absolute encoder authority is inferred from encoder type + +In `Validate.h`, some encoder types automatically imply absolute encoder +authority on servo axes. That affects startup trust behavior. + +So for servo users, `AXIS*_ENCODER` is doing more than just picking a driver. +It can also affect how startup authority is determined. + +## Practical takeaway about old example configs + +Some example servo configs are older than the current code and may not reflect +today's best defaults. + +Treat them as: +- examples of working combinations +- hints for starting values +- not as an exact description of the current wiring between settings + +If there is a conflict, trust the current code path in: +- [Config.defaults.h](/c:/Users/hjd19/Documents/Programs/GitHub/OnStepX/src/Config.defaults.h) +- [Mount.axis.cpp](/c:/Users/hjd19/Documents/Programs/GitHub/OnStepX/src/telescope/mount/Mount.axis.cpp) +- [Validate.h](/c:/Users/hjd19/Documents/Programs/GitHub/OnStepX/src/Validate.h) + +## Minimum settings to get right first + +For each servo mount axis, focus on these first: + +1. Driver model +- set the axis driver model to the correct servo type + +Example: + +```cpp +#define AXIS1_DRIVER_MODEL SERVO_PE +``` + +2. Axis scale +- set `AXIS*_STEPS_PER_DEGREE` correctly +- for stepper-based servo drivers, also check `AXIS*_MOTOR_STEPS_PER_DEGREE` + if your hardware needs it + +If the scale is wrong, almost everything else becomes confusing. + +3. Encoder type +- set `AXIS*_ENCODER` to the actual encoder you are using + +4. Directions +- `AXIS*_REVERSE` controls motor direction +- `AXIS*_ENCODER_REVERSE` controls encoder direction + +These are separate on purpose. Do not assume that fixing one also fixes the +other. + +The practical rule is: +- use `AXIS*_ENCODER_REVERSE` to make encoder counts agree with real motion +- use `AXIS*_REVERSE` to make commanded axis motion go the right way + +Do not use motor reverse as a substitute for fixing an encoder that counts the +wrong direction. + +If the motor and encoder direction are NOT in agreement the axis will run-away. +There is code that attempts to detect run-away, or oscillation, which will hopefully +shut the axis down in short order if this happens. + +5. Conservative limits +- set reasonable axis limits before doing long moves +- keep first tests short and slow + +## Recommended bring-up order + +This is the safest order for a fresh servo setup. + +### 1. Bring up one axis at a time + +If possible, get Axis1 behaving first, then copy the pattern to Axis2. + +Trying to solve both axes at once can hide simple mistakes. + +### 2. Verify encoder direction before worrying about motor direction + +The encoder direction must make physical sense. + +When the axis moves in a positive direction, the encoder should report that +same direction. If it does not: +- fix `AXIS*_ENCODER_REVERSE` first + +Do this before serious PID tuning. + +### 3. Verify motor direction + +Once the encoder reads correctly: +- use a small manual move +- confirm the axis moves the expected way +- if not, fix `AXIS*_REVERSE` + +This order matters. + +If the encoder sign is wrong, the control loop can "fight" the motion and a +later motor-direction change may only hide the real problem. + +### 4. Start with small motions only + +For early tests: +- use guide moves or very short slews +- keep your hand near power-off +- do not start with full-length gotos + +### 5. Confirm the axis can stop cleanly + +Before tuning for performance, verify that: +- the axis starts moving promptly +- the axis stops when motion stops +- there is no runaway, buzzing, or repeated overshoot + +If anything looks wrong, stop and correct direction, scale, or wiring before +going further. + +## A simple way to think about PID + +You do not need to be a controls engineer to get started. + +Use this mental model: +- `P` reacts to present error +- `I` corrects lingering offset +- `D` helps calm motion and reduce overshoot + +OnStepX commonly uses: +- one PID set for tracking +- another PID set for slewing/goto + +Those are the `_GOTO` values: +- `AXIS*_PID_P_GOTO` +- `AXIS*_PID_I_GOTO` +- `AXIS*_PID_D_GOTO` + +Often since this uses feed-forward the goto parameters are less important. Also +these can be changed instantly at runtime from the SWS or Website Plugin which makes tuning far far faster. + +## How motion feed-forward works now + +This is one area where older servo examples can be misleading. + +In current OnStepX, the servo path does not rely on PID correction alone. +The motion command already includes a feed-forward component, and the exact +motor-side behavior depends on the servo driver type. + +### TMC stepper servos + +For TMC stepper servos such as `SERVO_TMC2209` and `SERVO_TMC5160`: +- motion feed-forward is automatic +- OnStepX combines the requested motion with the feedback correction and sends + a velocity command to the driver + +In user terms: +- you do not usually "turn feed-forward on" +- it is part of how these servo drivers normally work + +The main coupling setting is the counts-to-steps ratio: +- it starts from the config default based on + `AXIS*_MOTOR_STEPS_PER_DEGREE / AXIS*_STEPS_PER_DEGREE` +- that ratio is also a runtime-adjustable axis parameter + +So for TMC stepper servos, the important question is usually not whether +feed-forward exists, but whether the counts-to-steps coupling is correct. + +### DC servos + +For DC servo drivers such as `SERVO_PE`, `SERVO_EE`, `SERVO_TMC2130_DC`, and +`SERVO_TMC5160_DC`: +- the same upstream motion command still includes feed-forward +- but the driver side now has more explicit runtime coupling controls + +The practical runtime knobs are: +- minimum motor power +- maximum motor power +- reversal protection delay + +That means DC servo behavior is more dependent on the runtime motor-output +settings than the TMC stepper-servo path is. + +### DC servo velocity control loop + +DC servos can also use the newer motor-side velocity loop. + +When enabled: +- the driver uses encoder-derived velocity as a measured feedback signal +- the motor-side control becomes feed-forward plus a velocity PI correction + +When not enabled: +- the motor-side control is basically feed-forward duty mapping + +In practical terms: +- without the velocity loop, DC servos depend more heavily on a good power map +- with the velocity loop, DC servos can regulate motor behavior more directly + from measured encoder speed + +### Encoder velocity support + +The newer DC velocity-loop behavior depends on encoder velocity estimation. + +That comes from the encoder subsystem itself, not from the PID section. + +So if you are working on a DC servo and velocity control is enabled: +- encoder quality matters even more than usual +- noisy or weak encoder velocity estimates can make tuning harder + +## Deadband and reversal protection + +Two settings in the servo path can sound similar, but they do different jobs. + +### Zero deadband + +The servo driver also has a low-speed command deadband. + +In practical terms: +- very small requested motor velocities are treated as zero +- this helps prevent constant tiny nudges near standstill +- it is not the same thing as backlash compensation or target tolerance + +If this is set too high: +- the axis can feel reluctant to make very small corrections + +If it is set too low: +- the motor may keep twitching or chattering around zero + +### Reversal protection delay + +DC servos also have a direction-change delay. + +This is better thought of as reversal protection: +- when the commanded direction flips, the output is briefly held at zero +- that gives the drivetrain and driver a moment before power is applied in the + opposite direction + +This can be helpful when: +- the motor drive does not like abrupt reversals +- the axis has noticeable mechanical shock on direction changes +- you want gentler reversal behavior during tuning + +So the practical distinction is: +- zero deadband suppresses tiny commands near zero +- reversal protection delay softens direction changes + +## Practical PID advice + +Start simple: +- begin with modest `P` +- keep `I` small +- use little or no `D` at first + +What to watch for: +- if the axis feels weak or lags badly, `P` may be too low +- if it hunts or oscillates, `P` may be too high +- if it reaches the target but stays offset, add a little `I` +- if it overshoots and rings, reduce `P` or add a small amount of `D` + +Make small changes, then test again. + +Avoid changing many things at once. + +## About `PID_SENSITIVITY` + +`AXIS*_PID_SENSITIVITY` controls how OnStepX transitions between the tracking +PID set and the slewing PID set. + +A practical rule of thumb: +- for many DC servos, a nonzero value can help +- for many stepper-based servos, `0` is a reasonable starting point + +If you are unsure: +- start with the value used by a similar example config + +## About target tolerance + +`AXIS*_TARGET_TOLERANCE` gives the axis a little room around the target. + +In user terms: +- too small can make the axis fussy and restless +- too large can make the final position sloppier than you want + +If the axis seems to chatter around the target, this setting may be too tight. + +## First successful motion checklist + +Once you have basic motion, verify these before calling it "working": +- guide moves are in the correct direction +- encoder direction remains correct through the full move +- the axis does not run away when motion starts +- the axis does not oscillate badly when motion stops +- tracking starts and holds without obvious hunting +- limits and stop behavior work as expected + +Only after that should you move on to longer slews and unattended use. + +## Absolute encoders and origin + +If your servo setup uses absolute encoders: +- the encoder origin must be established correctly +- startup trust behavior depends on that origin being believable + +If you are not using absolute encoders: +- skip this part for initial bring-up +- get basic motion stable first + +## Useful optional UI aids + +Some test configs enable extra web controls such as: +- `DISPLAY_SERVO_MONITOR` +- `DISPLAY_SERVO_ORIGIN_CONTROLS` +- `DISPLAY_SERVO_CALIBRATION` + +These can make bring-up easier, especially while checking direction, settling, +and origin behavior. + +## Common mistakes + +These are the usual trouble spots: +- wrong encoder direction +- wrong motor direction +- wrong steps-per-degree +- tuning before verifying scale and direction +- trying full-speed slews too early +- leaving tracking enabled before limits and stop behavior are proven + +If the setup behaves strangely, go back to: +1. scale +2. encoder direction +3. motor direction +4. only then PID tuning + +## A good first goal + +Do not aim for perfect tracking on the first pass. + +A good first milestone is: +- the axis moves the right way +- encoder feedback agrees with motion +- it stops cleanly +- it holds position without obvious instability + +After that, refine tracking, slewing response, and final pointing performance. + +## Future improvements for this guide + +Useful follow-up documentation would be: +- a separate ODrive setup guide +- a short PID tuning cookbook with symptom-based advice +- a checklist for absolute encoder origin setup +- a servo troubleshooting page with "if it does this, check that" diff --git a/docs/STARTUP_AUTHORITY_NOTES.md b/docs/STARTUP_AUTHORITY_NOTES.md new file mode 100755 index 0000000..f7c9a77 --- /dev/null +++ b/docs/STARTUP_AUTHORITY_NOTES.md @@ -0,0 +1,366 @@ +# Startup Authority And Coordinate Trust Notes + +## Purpose + +These notes describe how startup authority and coordinate trust currently work +for the mount, and how that affects automatic motion such as goto, sync, +park/unpark, and home/return. + +## Core idea + +The mount tracks a runtime trust state whose only question is: +"Do we trust the current coordinate basis enough for coordinate-based +automatic motion?" + +If trust is true: +- coordinate-based automatic operations are allowed + +If trust is false: +- coordinate-based automatic operations are blocked +- manual guide recovery is still allowed +- plain sidereal tracking is not gated by startup authority itself, but it may + still be blocked by other safety policy + +## Two useful distinctions + +1. Immediate startup authority +- trust is available immediately at boot from an already-available authority + source + +2. Deferred startup authority +- boot starts untrusted +- an authoritative startup-time action later establishes trust + +Date/time readiness is separate from both of the above. + +Limit enforcement is related but separate too: +- startup authority answers whether the coordinate basis is trusted +- date/time readiness answers whether sky-referenced operation is ready +- limit enforcement can become active as soon as both are available + +## What currently establishes trust + +Trust can currently come from either immediate startup authority sources or +later authoritative actions. + +Immediate startup authority sources: +- paired mount-axis absolute position sources at boot, with origin(s) + established +- trusted mount coordinate memory restore + +Boot policy is selected by MOUNT_STARTUP_MODE. +Default: +- SA_AUTO + +Modes: +- SA_STRICT: + boot stays untrusted unless an immediate startup authority source succeeds +- SA_AUTO: + if neither mount axis has an absolute position source and mount coordinate + memory is OFF, boot grants legacy session trust automatically +- SA_PERMISSIVE: + boot grants session trust automatically even when stricter authority sources + exist + +Later authoritative actions: +- authoritative set-origin at a known home position +- authoritative reset at a known home position +- successful switch-based home +- SWS v2.10d or later hosting absolute encoders (for pointing correction) + +Ordinary sync is not used to restore trust. + +## What currently revokes trust + +Trust is revoked conservatively when the system can no longer honestly assume +the coordinate basis is valid. + +Currently implemented: +- motor/encoder fault +- NV fault (default behavior, because NV_INIT_ERROR_REVOKES_AUTHORITY defaults to ON) + +Important non-revocation note: +- a motion stop caused by limits or StallGuard is not, by itself, a trust + revocation event + +## What is blocked while untrusted + +Blocked: +- goto +- set park +- park +- unpark +- normal sync +- home/return unless switch-based home is available + +Allowed: +- manual guide +- plain sidereal tracking, subject to the normal tracking safety policy + +Important tracking note: +- startup authority does not itself gate plain sidereal tracking +- however, tracking is still subject to other conditions such as parked state, + date/time-dependent enable rules, and limit policy +- by default, tracking is disallowed when limits are not enforced + +## Parking workflow + +Parking is part of the same trust model because park/set-park/unpark all depend +on the mount coordinate basis being believable. + +While untrusted: +- set park is blocked +- park is blocked +- unpark/restore is blocked + +Why: +- set park stores a coordinate-based reference that should not be accepted if + the current coordinate basis is already in doubt +- park and unpark are automatic coordinate-based motions, so they should follow + the same trust rules as goto + +Operationally this means: +- a parked state is only useful if it was established from a trusted coordinate + basis +- unpark/restore is allowed when resuming from previously trusted parked state +- unpark/restore should not be thought of as a way to recover trust from unknown + state +- the legacy "unpark from home" exception is only allowed on simpler mounts; it + is disabled for SA_STRICT, for mounts using coordinate memory, and for mounts + with absolute position sources + +## Workflow 1: Boot With Immediate Startup Authority + +This is the cleanest startup path. + +On these mounts, trust can be granted automatically at boot because the mount +already has an authoritative coordinate basis before any manual recovery is +needed. + +Current immediate startup authority sources are: +- paired mount-axis absolute position sources +- trusted mount coordinate memory + +## Workflow 1a: Boot With Paired Mount-Axis Absolute Coordinate Authority + +This applies when: +- both mount axes report absolute position at startup +- the required encoder origin(s) are already established +- startup reset is therefore allowed to treat the mount-axis absolute readings + as authoritative for the initial coordinate basis + +This is intentionally stricter than "one axis happens to be absolute." +For the mount axes, absolute coordinate authority is only valid as a paired +startup basis. + +In practice this covers the supported mount-axis absolute-authority cases, +including: +- paired servo absolute encoders +- paired ODrive absolute-authority configuration + +For runtime/NV origin storage: +- UINT32_MAX is used as the "origin not established" sentinel + +Compile-time configured nonzero AXIS*_ENCODER_ORIGIN values are treated as +already established by configuration. + +## Workflow 1b: Boot With Trusted Mount Coordinate Memory + +Mount coordinate memory acts much like an "effective absolute startup source" +in the trust model: +- it can re-establish a coordinate basis at boot +- but only if the saved record is marked trusted + +Important assumption: +- this depends on the mount being moved only by the drive system +- if clutches are present, they must not slip and must not be disengaged while + coordinate memory is being relied on as a startup authority source + +Mount coordinate memory already uses: +- alternating A/B records +- CRC validation + +It now also uses a trust bit: +- trusted records may restore authority +- untrusted records do not restore authority + +This separates: +- storage validity +- semantic trust + +So coordinate memory is not just "last known position storage." It is also a +startup authority source when, and only when, the saved record is trusted. + +## Workflow 2: Boot Without Immediate Startup Authority + +What happens here depends on MOUNT_STARTUP_MODE. + +In SA_STRICT: +- if the mount has neither: + - paired mount-axis absolute position sources + - trusted mount coordinate memory +- trust is not granted automatically at startup + +In SA_AUTO: +- if the mount has neither: + - paired mount-axis absolute position sources + - mount coordinate memory enabled +- boot grants legacy session trust automatically +- this preserves the long-standing "power up and goto" workflow on simpler + mounts + +If mount coordinate memory is configured but the saved record is missing or +untrusted, SA_AUTO does not silently fall back to permissive trust. In that +case the system stays untrusted until an authoritative action succeeds. + +In SA_PERMISSIVE: +- boot grants session trust automatically regardless of startup authority + sources + +Current recovery model: +1. user manually guides to a known place if needed +2. user performs an authoritative action: + - set origin + - authoritative reset at a known home position + - successful switch-based home + - reboot with a valid startup authority source +3. trust becomes true again + +Important practical consequence: +- the default SA_AUTO mode preserves permissive startup for simple mounts with + neither paired absolute position sources nor coordinate memory enabled +- SA_STRICT remains available for observatory and interlock-sensitive installs + +## Workflow 3: Boot Untrusted, Then Establish Trust With Auto-Home + +Auto-home with switches is best thought of as deferred startup authority. + +It is not an immediate startup authority source. +Instead: +- boot begins untrusted +- switch-based home runs +- if successful, trust is established afterward + +Switch-based home and auto-home-at-boot share the same sensed-home path. + +Success: +- successful sensed home leads to authoritative reset +- trust is restored + +Failure: +- coordinates are still reset for consistency +- failure is latched +- trust is not restored +- auto-home at boot does not continue as if homing succeeded + +This behavior is intentionally consistent with normal switch-based return/home, +not just boot homing. + +## Coordinate memory during homing + +Important edge case: +when switch-based homing is in progress, mount coordinates are effectively +arbitrary relative to physical truth. + +To prevent a power loss during homing from producing a misleading trusted +restore candidate: +- coordinate memory is marked untrusted as soon as switch-based homing starts +- periodic saves during HS_HOMING remain untrusted +- after successful authoritative homing, trust is restored normally + +So if power is lost mid-home: +- the mount will come up with coordinate memory present but untrusted +- automatic coordinate-based motion will remain blocked +- the user can home/reset again, regain trust, and continue + +## Workflow 4: Date/Time Not Ready + +Date/time readiness and startup trust are related but not the same thing. + +Trust answers: +- "Do we believe the coordinate basis is valid?" + +Date/time answers: +- "Can we safely/usefully perform sky-referenced operations right now?" + +So a mount may have trust while date/time is still not ready. + +In that state: +- the coordinate basis may still be considered authoritative +- but some operations may remain postponed or blocked until date/time is ready + +For mounts using trusted coordinate memory restore or trusted paired absolute +startup position: +- once date/time becomes ready, limit enforcement can be enabled immediately +- this does not require a later goto, reset/home, or unpark just to make + limits active +- that in turn allows tracking requests to succeed normally under the usual + limit-safety policy + +Example: +- unpark recovery may wait for the normal site/time flow even when trust is + already valid + +## Workflow 5: Losing Trust During Runtime + +If trust is lost after startup: +- coordinate-based automatic motion stops being allowed +- manual guide recovery remains available +- sidereal tracking is still not gated by startup authority itself, but it + remains subject to the normal tracking safety policy + +The guiding rule is: +- if the system knows where it is, coordinate-based automatic motion is allowed +- if it does not know where it is, coordinate-based automatic motion is blocked +- guide-based manual recovery remains available + +## Important startup workflows to remember + +1. Basic mount with clutches, no absolute encoders, no coordinate memory: +- common user workflow is manually place at home, power on, then goto/sync +- SA_AUTO preserves this by granting session trust at boot +- SA_STRICT intentionally blocks this until an authoritative action succeeds + +2. Mount without coordinate memory and without clutches: +- mount may power up far from home +- user must guide back to home +- then perform an authoritative home/reset action +- then begin normal operation +- current model fits this workflow well + +3. User wants only sidereal tracking at startup: +- trust does not gate sidereal tracking by itself +- but default safety behavior still disallows tracking when limits are not + enforced +- this is intentional and should remain so + +## NV policy + +The compile-time switch: +- NV_INIT_ERROR_REVOKES_AUTHORITY + +Default: +- ON + +Meaning: +- if NV reports an init/read fault that may undermine coordinate or motion + confidence, trust is not granted or is revoked + +This is intentionally strict, but it has an escape hatch for expert use. + +## Status exposure + +The trust state is exposed in :Gu# so clients can detect it without extra +status calls. + +Longer term, a small circular event log is probably a better place to record +why trust changed than trying to pack too much into live status. + +## Open future work + +- circular timestamped event log for trust loss/recovery reasons +- possibly record a simple trust-loss reason code +- maybe future fault-tolerant KV/partition design +- refine the basic clutch/manual-home startup case so normal users are not + surprised while still preserving the stricter safety model for systems with + stronger authority sources diff --git a/juwei_gyari_backup.bin b/juwei_gyari_backup.bin new file mode 100755 index 0000000000000000000000000000000000000000..4147f7a2dd3a71a8a3daf46c1ce404eb50863e97 GIT binary patch literal 4194304 zcmeFa3qVw5`ak~8VSoWf91!ogof!quG>3}@I=590Z#-x5%5I769G>IJQ46jz!QQ0 z=@Ix$&CS~HqY=JlLoU@g=15S3MfDE_-9-ucvH;luU4YXpTkUuPM7XK2y4qA-Q&3gI z&tJgHNppEIL~PcYinZohRqM*j%~iA3S5)0L%UoR<9W}F{s(4*#dBx1K(!!aA>q^Ut zA^uUx%+lhLSw$6VD=W&)p=- zK}~_XgHl@Zu)30;uXrp~fP7YXE+g;?3Q&z%N;vnfd=~EUF61i!0V58g4$8l$Mp5WC3Hz1!YC+$_i>w zuQdhLYgp=rN^{X*im^4wpv?ULL|v-a6iCg=qy{Q8m-AtK48LFjZ$ukZ78IKb@2D|X zyD`!2imOdjEz~ZIPs+?nUSwLHm6MW7R&$KAVi@~z9V4?K@Bhr@7I*j`HG7V!1bqa7 z#&xBPYR1^&6&cAS&&bWqAiTV^JgEZ1YGDdvD;7u1zH#ZCm_+a!yc`Kf7|$H-BQ(MT z0G}ps9%2G}V~}G9=NoVwWst7`__c#`jIDCxJOK_rHqPPbfxL_Ip;Dz;P(W%1K=o(4 zuW%9YF5ooa6Tnx1>avRUMP;{{itZ>XL-6PG(NVE;V*ibOzPh4Fo-k%r)fAa(O4pjD zPC*IDkAgB&X?cygs=T0#YQZeNLQfcDyzzVjYUBk@S;Lvj30nJwgjEgT{nFuJI@I<% zhocy2gp;iS&I7Cf0dEn6R=j|M?nK>Oh|Yb{A`sY;bXum zK+26?s~n>kJI>A}P{(YSe4)IgZpzQFo=@n4Y{shZ6L#S;0>=R209wcx(=sMurfHC| zP6ydN7Wf2=a#6BBwS0f)x$_AL=Ojp;L5)3BFN9(W%z_H9B6 z=zQ{xb#*x;x4wJ9;fRuobzH;Pu_H`a(a40%mzbbIU2D6%g;36sumSyV25=`}rxEsm z2EYS=e8^q`KNR>Ba37$Fbj~prf;L1uuv+-e@f2AHLIEAbN(;SJC=a}mjGcc0zIH*_ z`Dc*{edHYa#f3Is0X$VD`a?%HV_$sXaMZr*E$jq@{>@uJU!Vr71k_GJTLR|;vUO-r z2I$oL2tB|(kj(&A6Q8LWujwC2c|upvNIZct>La{`Vc;>x?|q>X0Ue@tzcB)BkGb^U6M+iPS))j!&8i(uDiCGZzkhrjW#MR zh%tS*Lpx4UU5?|wt_IY4}ke6}4QXy~9wJQlF~ zby)!JAnTPYSubA6dcnooA+>IRZI8tAL;YKJ57@2lE%4;9sF;)4Bn(xCzE={QDt1bi z8rxF?4LfvjtXV@L*4UmvTFP7_cE~EVuMW}BPID?uIw$^4$)$c+E)ThKX;yNHADYWn zS1yWA;kNrERX=eXxej->`q{S1tlDEv&ZKiTQBf;*saX`YIF}mgDc(tJtLAvr3_ofBTUp>GV3OuhS25c;iD!zT4SWfL_LkV>{i&fuX(4os&3_*MZujoDG zbx3`JGya}mHhTQRXzr+SBW`so&92T#P2mQMZxzvE1& zaGvit!kUA+j2G;AbqyQ&<@$uf4wTd2ZkHJ^@x}GFEqNfOP~}rt@0=v<*lfkI_yP4jyUf6^{S4Gr9{! zcAh-1o!~Q>u^H-ylrA=2Ulrby_Zf-~}5oqg#wIJajEf&RD)a!t#Pn@2WEj z7qU}$k{)S!^yyItQuf7gkH+`}e7%{9KJ&+c11a{DE=%4SOUe=Us~{tSu%NDCDIfdH zr~^y)&E{ff`vjy&x=Ak$99YVp3^LB{5<2*q8h-m3K3WQbaN%TbUBe~>VU!XCpMYq| zChA2c4CxdGmJ)YYW5SsUHu|rX3)hT{ ztKwVv?taIk+cnx?XluDi=LjJ0zC}}K_rWkJiO|>C$5}e~I{Pa6Y_Z@|ON{Q@G??FZ zQ>L(mjqRy^j2Wxnd~KI9#k~2r#2K;Ysga#lU8uh@^^7335w(5|R%!T-5Pwfw z0afjHGrbhu@Zd4^N#Oy>4s&q;s|Zm~>8mF9?k30v4~*dZ&#?7vatJ$hv;x z9GxikTQyroC20LYp`O4N315>L_`cWSyZW^Oy8^^oV%5I};ax;gri_Wz{qblM@pfVv z=X4cR_TL)4Mzw0aJY_xQ0}TSWSfR5`V~R7uQyxn(2>x ziix+2Gk@ox7L?|o#8v%CYPKxKC(+a&8&iynvZ=mIgfdtU?7MGu{xZ_?m>y)+?-bTQ zT&!~n>zhHA_?5)cXfqmqLw3@geZR)`Szp6JU1KYAau0V)dfLXPz|v{&>y+!Fg~=(c z?Zdu?_jUC7kdy~;k7>&8XxKSep<|jEehtS-`YMg$Q<}qn?&~^1;#V~vy+wJS3OxK~ zU)TG(BW+BX0Rm;k6Ht^5#n&Z8P3@OXQ)nF1xaE6HV}F8lm8qih041K&h<_l%c8#-* zs9C8GwX_o7>R)zAnS}hsJ;d3ssr}skIC&>!v|rQu)Q9$ilzxu9Kc=a@3$v0lxnF}= zNeS^`+1hE_(kP|<#or;|q_Wk&<(CTUH!jva#IpK3eQ2>ND%)KuKUY`{gRI>mvDyPf zOCPOsxAiGKGeF!b=~9Qg+O#RIlI%1#OP_NlrF=BDn+Ma<++Sxgs(J%&Y(gDsdw9ea3LzD&zSzs=0F{Lou|^vQ)P9KEX-0 zlLl=iPODudjw4oLI@LB#T~^3PQv<}SBU6c!G@0>Jh+!zAc`=Z5BMzVDs9zK?t)^e| zmF9iT3C$tRF3n~gW7jtE&7E=aw%EQM+Y{&XJs6{FJT`@IwztPil4BW%ylhb_fhq5jgUZ_-*4J{WH|+P01^#1h)tpdi zC$_b+W&WC@6W~whwxDer8#P>gM)>#}j*e!H8n61B!e1SE)SI!Uan^`t!`3JtxG2#{ zTXTFyu-bsm=X50pXEZd#(9>P#eyBY+ZEJj;A$+2>t}t9`C*-rN8PlYyE`n?3wgyk^ zu&TC9Z`kD(*6N_frg>hP>kqS50~_m6fOs#*{8 z=Jk&H*Wy&^qA{g9AVoXM$DfgSony=nmZWFIO7mt=?5=T)=>SWU^pXQSOw(RFHyRA# z{FF2DJ;LzRLzB))ALO}w4@Ru%7WD?Xgg$kGaO>~SikpbA{kB)E?L|Lm*7#r_Vom{9 z`|-lgV3q z(tXAekOGGmdwrt*%f#d~Jfq9nYDqgTsQyJs`!z{B?6f24B^3e^8*^&UVGYXaJ|>rC z{=jjh1$UqOTEvIRzp(QT^p6rR|2RWLRJ>|hkdKztp53zDKQ1XEM@pkoJ+X14(X?Ck zj=VOSkM6Wij)>k0)if1WInzKysN#a8F)i9CPyH`?wVJJnk2D7^dyBnU-+Q>eH-BDB zeXsdf8i5ZP1KzgY!&`du7qx8Z4SPT%R3)ZOL|@cfde?BPR>g#RuUguby}U?YN3o0G zmL)khdozBsCGqFILb}~pXK#&Q-7_7n#cZNsc~m!)5`Wekp`IQ#O}(-tdwrL2w!P%p z(2_kPwITXy$|HmG@j?L%=}I}h%=eN!PZzLd!KycldJo^)yT@*6De6UQbZ^s)`FlWO zes8*3u*96U2FHG^ZO0P!(Wab7L-LMdJioRP>#O>BZ2Uf$7IXIHhHyZqn*uFlRZ4K?EDm$w;+_u1vCGLNs}r{T#M`gN04mWGgJ z&#Cl|%Uhx*7$#$Fi*dH|1|i8P2!HUID9{5?gpom-E!Q z>}9&vDa>N-(oQ_WB80|c>x>N-jQbNCb{adIjmCJR(O83>9KREO z_Sd%?tz8TJEc3Q^Me`4CpZH*~hU~Gz{-eX7o>(88^D>`P94i&9e_JUx5i?tz7cL=)5hZ=mt@W%sxcd7$VlgB%bPGWoPnwF!N&3O*-rOR~@ zY|NJo(`cAnqEW7<09pdii>@tA)?ja#Tnv|h&Ca7aZ9?_-YLJ1_52we>mLy$q9M zr*|Aux4w2dEFN<{mg*|;K~kORzteyB1DA2Xxa`>F)qTA~Uyqt2dA*c1^#|NpZKS%u zAM@r1jxRgJZI`F+pIMR{5ox_VH%eS{Id=awky}8kp}Sd70-qmQB~zua{E3ZF?PcQ&?Sr%CdpChHTZ}7yZ8X z3GBJFtJ?nRSoXQ!3VpT^QlB@b!;dnnf3`g+?0ZN34(;fpDwN<&1IGLL*=vHV`fX_i zC6^b5YuBm@-?1zVuSoMHAI6A9m$yt+X?<3$szFz_{q*v}Y1F;9Y+l+uhh~a3`m_LM zw46_}vqrnhlCix`&xG_YY(lI`De5`=6$gLl8OIm%`ns~pjuz90#^>#}M zzkUq2xtgsR^|RQ^tM_qfh1iS1{bZL~)KN>cdp)LJR9tG)P71AG^(@~V?pW);?AWMqYbU);{+kecR<3sEB+swapP`|FSvz!9|?3eldwsy7oBq@I$lB4zx)hyr79nEGd z)HyGYyUC{YK01OOd6^TAcNQMjm8$xE&x)s7UO&Fyw#(c6F6)E@|?%AS9D>>g}pj({IwJ6{fUU#Vanmw5jj(0 zqb94cTeCTe-5Hl`j7p4+ zdS~KNsbd+`-c!S#qCB;}g)Ll~7t{Ju|E~QW{Tl&3KBnLgmj-b;`m(cgrjQsg6)(D?-EXLkM4?BQ^nZC===+@&)h4C3@y_3sDva2io{$X?zm)W z)NN_5(NDdE8%z@?uDoQ~Dm@f&a(X+`Jjkt_jUyGSpI&u|x9arwU&2-@7}Mx|fz^** zTY%fwW8m041NP^f?+t956tfUAGuXdynoT&C1W5KKU=Kino<1`S16WxscY*|W~AIfDObec^%_i5og+kQDyrR;sf%l5M+DCTdF`TRXD zYi4_Fh;93ownoLai)^*-w&Jr=lr;L!diZJ7hSN0qCd%NwD2kptKWzkcxei7DCFn~{ zsj+PxQoNO{1KevaKBU+LT^h8hm2LEQNip;r>=!m4#noR+u12|4Q+l2ow^b!p_S9)q z&yP#fVRa<-Q$~$zn60Bn>?OKcBVLj+*DOnSh!==#(pYoQL$|7|D&MoOZN|908AIe; z4~7D9&PAxEc}cxrT8r%B#LvkJw|0wV$}){ZJUb+*+s&IVI>t;;?r74OFy3ovG^n;b z$8C;gm}ju`IeHzUHNR(hdtPIULp((}G;1sygKX~*i4CB)d&Dy&{a1NcFFxJtX?i+QmtPp?{-KFThu|Uk zU|_m)TpT*x#q|tMcZK%X}XKP7-cLF9Z2$|K zsvlf*2C8Mc;>||Mn~{Uw*rxV~Qg)%d0XT}AH(R)2gw3x<^p=ap?f=s?BW*rCqDp2+&t5jK9#B7|-lmN`SA^^5jrI>v#pN|m>KI~DMZqIiU4 zxKBQFv3swh-d|atCo=tuB(QS&BNwMzwVZamW!iRHu1L>?f4C?fly?HObtH`sokw76}KuYGUp;awNs+;!3Z`?~IF1Ivyu{o`cNS}48Q zDGAo<+bR7RR&B5=F=+K|ZfX7RT?uJzCHslB{r5?YB#K9Ybe`Rf97|eK00VYDmPMVq$QM&qlZSM5qy;G{x;36}PjagNDRMyk1ebK~dm` zDmd%K)EeRBIL7GQk96(`=WYb`xr7uzIv^8}4aftm0OSK!0g3@-fJ#6OU<05QU;%6b zSON8bP)28d93x-e+iE-cOD06z&4l9(bnXZpK?h(eMrVQOtXEu=k96LP&U!^mW~}(! zg#AV$bf9P<~`71hO zMd!x;?ynI-$qxR|S-1I+8DZmKIQ``K6wvFSGfa3pN#~|u?RWvsT7Yq0iq1TN!dWi> zl2YO#otvZcO>`day-7X-ofg}Vb6GVwcLbeP07RPkARDHmvsnUC766W&F(YGf!ubS# zuZRuJBr1bd!mbv8lg21UH9#kqQcfcu9Mf~W(C_Gkj8xS)-=zV_*<(YLopVq&=Q21p za1T~FI7jsoAP=yHV);A8bB9zP6;k(5-=JX^sr3XWEAl!7A_Y?Lw1 z>daC&*C}|Wf@diBS_Mld$xz}nB^{yQsWMh#B~GPEi{a9zo(0* z_3dfCEIdvZo*wMu&9uSfL=r6$v~`S!Vr^#~SX3hm>4aI^qnE-CUDDpA^>2HT(1b9cMW|6*=cV1R4QTz%9hc0| zdE}CKjLtkYX>6|$#+v3RVcbz(9y~!6w&qgXbvQaApyW0$J!8$?5T*&^*ViYzp9 z_rU=?E4?PwLW9Q>U6Z|W8X`E-{#mw>XZF%;hGqRR)w3%;7WWL`pv_rg^J|FB7mS*z zvOPHt4P*S53{bVoRO4-XuEXaMgv9vWzys%mK(INUT~Ki;Jc5N}mNyhXwj#Cw&rj3S0?gw95?Q<>llB$2%;PZf_;S`(yP7fIVgYTwL zj^!7ld8_JlXHe&!M9V>b&+Gjy_Y8>lQ08s>FV;`M+=Q1?c;*pvq^vdKjRP1v;(AJ1 zH5bp05^tADoMs4*@Xy!KGh4m}J-5z&&Q>{qMPbwU$5hQhjds?EV{1)8;%x)%DlEIP zpsy=nZC%W64>`F_Wm^q4&NJX(&ts~#m%&w^2Di|SyFaLHnR5;lZ=quMN7(WSH%H*3 zeS>YK^L*b1IlX*XI?s9DPm(v;Zp869oh{qRZ6d2C+hVd(9{iiMIM|xKVCDo9>5+2jW3Npj+|-VV@nulXwr$-Q@2%~TlQ%EwBv-WluvtA zc9Tksa}!q8KM;^2Mh;j~qBQFr7>KipH`dVZOqdRfz*}giYucvG=ud&9pI#LiIADyS zeiL6s>AI+=n3ArG^pRA&^g#ps6n?Q}>LoH_S~XL9&g%#07|C-~iow83>*}}c?1){1 z4gUEP!lW4r_l39Ynj?1B^*ld+B^Gk7XKqPX2VLz1bV>OhBI_Q~YFCDxfvWa?t@e<1 z{z~&lIDs2vr$Xd=)L=Q<32h$^u|+xBmCDBCpe_#8o;<|Q@92Kd5!um?XY3J|v?H){ zk0I3dH@rIt(;|Ih#Gw(|8`|ELCRX?@bLMwo2fyVZobS0LdxP9hk!w!Es=#H7^q#V{dd?0xAQg35M;Nk!`7qtL_ZE-$kBn{ z`l^1c2)YM)-ZHS0UF%MsJYQ#Ln{lq1S=u|#?FedV>EE%V(NF#0&d8JPL6!~+cpvTT z-|=Em#63Up>TIa7GzXz~ckWMY4b&j?ILFfPknzC)Z0bC_V&CD0{*$MIw(Wx9 zj-6-5`%o)_C>FV~KB#_qMzr)b&2!>Zi4IsE+sroj%B) z?BK(`a>h)54+W~7)Bn652f_J=MvHgjfRoO0?dZYlvEV$i`SEM9Wu!ljaD;OLi5tI*8!gYRY-QTs`D|P-x5-3RoR<(zE0g>RbeX8^Zh(Nja1CwdvtR# z>o(&QInz$u6@W!w+f8^2ffo!aa~up7MpI$T`46^_JW&1%sG-v8O z-HhOUdwgfSwQmm{+YD`$-*nEXgMTe-niy}>ODEd!3i{g7CBZ)0i8Ho^?PQVHNU`$L z{{-IX464ce;0by!+gM5FrynQFrkpdVP+|D1?4j#}Nf06OVPV3cnV()d)Mn)(NAw%x zq*;t+9i;t{mS!o=pyK=X=zS@B_+vcJTQ0;l1q2vs|1@>4zm~&|M}8w}u&c(@v9>#D z>2@@bb$^9H`}~A7JX1tUXV>Dqj1A{;ICe{OKtOcuso4E~TCdI6{-X1n+EK^1cYp5i zQDM*^9O46XVh1b6?R~iGVXtrtYdPCzZ>3O^ z^{}qZ&J0H!;s<1l-LuRd{rg023o zPA%rNy7=M&VqypHxjx(@`Gydq^fDei>7d>UjcspV!>_1ioJaCINzvHwF^&>D9~W-i zPMKJ}vCIfJM9`b>Tm1N&H)1&gM4j z*^S$zih7Ip_bH1XZ}`#VE#@Lk72oQ;%S*J<(JNXbGZqkyHPt3ci?x!=SlV!(jQUh8 zk}}fdJn6{33HRV2oHB=bhNdJqXfYkgTcI)Ra^MyVa++qRm%fVh(LJXoqLFB0h5&Q3 ze6FwVQcUXEN(&Qp` zu<5xaOR6K*WT;=JRKFCZervvT-c!X4rR?-!d8I0OIa@f1eXz}teDJGl69#vW{KSYpyd0S-JG_3w zDBEONN&KQ$R>C%;G8Sy1if9r}BT{Q@^`qP79=p2LULuaCn$H-4hc`TUl!&7#`Idc$ zHdDH-mWV;bz{21OSw2EZ9+#7TlvK*WJHIh!u++f}>xIp&FQxmLcu6|OqOmd5Yj8+J zXl(s-tVN2Gv!1ZW8IUo-KKc`6)5O(1^@4MKuK$P362I-mog))}!9+3J%Iz$QJWLX+ zm*J^<_z0=5dEqG!6WT$AZ?`D#oxJ8x7vG|zR(PTRGzsH4WVBJvNdK-#o3xL*(doCoMV1**(hwo+#2q9<-+ifVokv6X9WnIS$ZdrRe8iHpH=-DqjdbPqVfCrqfnGkm)LW@(h_8+uW# z`|&~ffLte$W0(&ft7Ei)+I^dSnO2=Kn0^JW57l@jbHNdNfYLLo$gj8To3uOSzE)0YpDAeD z8&ef$Dh8d=&J}Ma`Hwjjdh`mX8vdzM4cb@UvcIT(UiM+J>{E@?rwmFrydBhqKP-Bm zx2ND#AD_ZkzRzoC$Oeg|@V<|BzMNbjCDqz|IT=q$tm==?&8Ig^t#-ROomhHfZ#)_i zRi(BMqS{(H3xD3yaA7KL%@MVKo%)=gmfMV5v$TB?Twkc4*^B<~JdQ2Kpsa;W=7)!Q7@|6zH=D2 z9l=xX=3o}Nn+zmT$e1Ek_$Yn&lNx^tgICv<^Gy1yFYyHuPs3k4 zAU6DrM3+FS0}13h;hphEbSkIiT{6I1swe1uTfjz(c5P#n@iGESpEb{R*X^*3DRC(~e( z3l|#{;bBR5i@Oj$Q;P*jEr!o?TY`18nRx*V1lm{7jz|A#v~%K3ln3r`Ewz#l{^G97 z@Lp`YtW0SBE$bA)Ba)!qC3xhr`D+}17F((IW~=jg1b;*MkQ9$Kiea;4ID630Ci&g& zM}bmqFfI9t?){Q(!=P?U?q&Q%iPQ$>w;YiRf9mMAI7&uw<_1TU zfi3$J+hgFKy*8pfO5WWo88x=M(b4vE2hIZG=yUfoj#h&gUS&7n&rBzCVHe108Z&Dt zV~iQgdBGZ_|Jmi~R$D2$MXROmZT?)9gpr zT_415acJV+GcF7`ao@9X=dm~KxjYf@M8FdPPXs&>@I=590Z#-x5%5I769G>IJQ46j zz!L#a1UwP&M8FdPPXs&>@I=590Z#-x5%5I769G>IJQ46jz!L#a1UwP&M8FdPPXs&> z@I=590Z#-x5%5Idzi9+IvQ-?z;bWG~So!VM?q`W58glxTKgM{*DrySkA0?9{@&|q^ zNk`vnf?r@_1(lUXH<3g_j=xeJ?UYAeDOc4oHVy2t_|3i2l9FLA(C;w0UlHGC`lYJY zuWIr2x#hV#!+hOk9@-NDPXs&>@I=590Z#-x5%5I769G>IJQ46jz!L#a1g;(d`UX&X zCdUs1UvX`kdEmK@;g|9NPv5+W>l{<59CK^u=quOUA#;>Z`l3y`R7ne%CMEB?qJlD$ z`{qFF8cB5E;>3| zrmK+W!FixF@v{h^Q&L>?iA)#0bg7H};1(BMQsSb&DVOO=tm7rp+X zi^dm>4C+`lE;=a4MK_Ok(FTJ|--fFSzNT$>Y{^eF1oqdMH^aWx`cf0aM96wUG%|&E;{8UnJ$L@ ziQ_JM>Dw;)gZEu@$tN!Qo3CB;`im}_u_!54l&4iA(}kdef}&VDVn}rJco%Ijxah~H zyXfd>7kzM^i%v;#(I+xxdKL0qx)k&c_-b0vAKc=iOG;eyH{~vR{dyP8EH2t=bz0)=6e(C<{0qNTG5$WU7$EQz7pO_w+J}EseJwAPI`n>e{=?l`G z-Z=5U!xxsV%I31Yvent%*(^_$$K`qDu@$Nn+zPK1>J=-%yDL*bhK7Vfhy!`q33-X>XxiZ?a-` z3iR9T7Qj-pz@Gtc{s5c+{{-6SDBur(CnY!!{H+3CyU`aw_W+#uJJ8<)Cab<3gmBQ| z=xqd@-%LgC{qKFrcV*Y7DqZF9xft}=mG@`r$#nnbSlYI?%1OSqplGo2^iA1|*`=@K zd$%jU;S}Y+^7h`Bue4Y4SF0Q&XD<7QK6aZR8wYFa$=@wQR+>mjGRUM0^S%?5E&moC%&j?&g_`T;<(6o zbG$hwrYL5Pc}{$MQM|vyLFG5++~9L%{wUu9d6G9<9dhjE;qsrM{LdHW?)cA@Kg?&i z935R^jx@$b7skXz#u!)mX*;@4GfE+jU@k!a%|}!2h<|Q{BJP4kVNXqyDIT z4pvlj8K(vdUxo(@M9=UaNFcp_-9SPn^k}j5f6#>~tN-;EJ^w$9C|vFN|MmTUa^3K+ z9;tI)Nk6w-9CfaA`1rPubT}5()}Q-6DL;8`z%1OQ>5KqfU&oHQ0ds~kDe>;Tw>eiL zhI~Ao#2CTVuAA=ojvlSpHMPH(^ZZ>4lD2*N;9(pjxcX(eIvZb}{T~*<;M_1HPkLxT zJn`_v!#x6?{@@-B&-~%(51#(u9sy5(aF2#(e(>}MPk(TafTusWN5eBe{O{-w&(Jr= z|I@34uD-_w{9L8Ok?D9E?_+TVJ|Qz6ajaBw$QGpiHqwx)HC}P7{{EZYH_tAbTM|7t)=2-0i|0n0agw04 z{I*5rJM!+RG~-okjDL1%d8WC1bg@y64QANeGOG*mj=M=}7 ziwX)0i(;dSjsE^O$HvW#E0`NMXKr-y+~R1I@E^!NHYzfvxWsIXiHeDzU07TkR~%PZ zQfQ2wQ(PD`drstRWdEN!{V?R6Tn4>X{->u8hM4?|Z|{fL{Kwv2%jYv5_=7#}%Jy@f zZwR!M@((3mDfhJRkih>x+`b`gzxwNy?I)k#ke^~apPmSKBH)RDCjy=bcp~75fF}Z; z2zVmkiGU{po(Om%;E8}I0-gx`&x`<_|8K)~_toD2fBF9RX9jn|6@p&gZ{2S1gF~#N+>BJiLIJQ46jz!L#a1UwP&M8FdPPXs&>@I>IhPXuVE z;lGc!9#1_H@I=590Z#-x5%5I769G>IJQ46jz!L#a1UwP&MBx7<0-yPCv+NNX;p-ts z4w#B(Lc-Z~D)tZjVZbBExCz*)LTM*`9tQ{r0s-`8gKLyD@faJEEQ4L}|I6>^5is31 z3ngG5r7~tuB-oGN=^{9b-`sM7oPXCnjQudEEJOb>-B=aV1;R80Ksn)Oyu3Kc6CdyK z{G5$}!k)T7K?h9qO@P{A@DAh#H~ESC0)-m@?Es>`1%%WOg>vwobCXlKxGVrWpbKz1 zBqYQa8!aFiqo3*eA&{Jvw1#|GoGG7^ZzO-wpLxAA4J>%=Ka(J*&ndVkp;vzi;3w4n zHCX7?j~DK|^%~Fy;b4Cl($j>wX*0l^CFC!R1V2jHd0Px*vxUF?G8Xc9VdB$sp)+4t zd1?Xl5`@g33(!pz%5+K4PZH`|lVOu0JQ0%$yHw%zqiL{RD15OZ9rhW*#!Ia%Wl1^f zn>L!gxqK>nKjs1}{96~B-~20<*pSSMZX93-KX{z&D|ngBEuX^PTAai(d`>gJ&#z;l zjc>9qCJnG@yF=O8>mOwoX4kQlgV(X0pKW4KhgY)1pPSe_ws@AiF`n%_AJ6VHZDJ9Z z4zZqV=CKbP53-R>-YjU=H_U(KeQfPDYuOt=pTqoKpUTp*_OaiVB(RyEo7jP=>sa>} zudoGoeakM!`?AKIZLIgU&)GG*O-ysk{mkgKjNR3j#?C!{8{?mUgUva=gZ=%nN$jTu zHl~^Q3A?x1%i#|lm`(bwbT$V}9T`7y!sr`8&zNT! z?z#5P`M&uf(czDX^AEj#?oO+3rINPI&pKG(z50pw6UNO<$?MgBmhhYJ#kT^gzfsb% zANVyDj7z$VFV=OA6dnL<1?&O5prnZ(1C2lSIvlUV0cXFQeH9+%^!(OS5AJzu=ltkL z+uxr2eMbC(N6)A9k8F#2=)w9oGzV@DORjjLIKpR5kT-P41MVgxT>qNgF@I(`9ec-% ziOFNjy`Onz|Ms*Cml8hn%8FYYHOY7>eSO`^`7c!8^M2Oob#kuGaWF-Y(>KXj_@#`k zFUt7V9tm4EU6;skoeVCL@TR{!C}H!76NGt_ougkNIeUA0EaBD%CaeV(x_25|fg67E z((~^C$An+FO`GiWli5$*yFBLhWOi)H>a~X-Pi6~jt3F=wQL<3~%!Wx%jZVq_=FB@E zPgs=F`1WF-H_lm7zQ5t4SGbwaq&)r5U++lX@OjERe;O%_e{-bp6Tmvaqe!;_vH>*! z_V!5OG4MbC^GM+WfYMGN{tp4^y30OP((e3U{D{5N)>-~T&?S9m*-rk|@}RPa?<|w@ za??e7gcfUw&t#ka9_efWNqC;&r*nbdZIf zlI3H8rz>>TUq=cX{snNBaW#DU13BN2cSj1n07^Syxc<{9%gL+!%taILhOgzc=^GdS z8Mit(?S^Cb@_qj1Dx3Jvp*-UGz%R1ZcQ0e00JifPTO%q-O$7X>>v#!0N9PB7Jp274Y2vN;`r0KLn)fE?cdn z-T7mF#NKJ^EI$mor0*=-$-i12R2K1_Wl~;F+FhUM?*WSeb%5!p?@s~01sp+o8uIxw zVnKKSn1JYCjL-?Yr^@g$qUVYvPuP?nQdo93d4m$OJtug-MwUvR5~({4C+FF$Zt`7fe8;*ErF zWOr66zdlJPY(e?A-Jlaxij2zNjPk17%3qW%+Y$et_1}SYIw7%IC!_%$0=$9r3BU%x zPC&$Zo$x03!N8LMly(B~e+Wp|UFNH#-TBY{h`rO+S^mq=C4FbvPX5*Mpt6YXER*tb z((d|1|GGved%Vy5@SR=IbN| zIr4K6eG~7XvbPUCV!+Cq9+&8HT504YV}pdkP;mk30B;{vz#tJ2-~~>AbPW=6(pv-N z0AD2h$cmW$#E~y2;pJp#WWrfA)BKamSEKRe02+;tug2F~BmM9={rI>_F~o0)(?uyS zjfOBdG9hUwaxb+Ptsh#{-kQY;_8K+X=Dc28tFSMshQPeT5 z)LzsV{;+Y?%D)A~u8M2B&|%wXEi;$Z6e>2VAnfxfdAUNSQhBLVzFyuc6~}R2_$hX8 zgheg&5A`S^;gm@%U*r8CFv@3{1mMb}oPb}sXEk?nLMZT;z>|PC-Ngw%0Y3IJ zCtL&kd=V$`z?Nc8&;x5~Il%y&4@~vR&X()*JTTSgfwOXbPTt5#^+{PN*JnR4)u-lW zPN4A@@)9RdTgM#X1b^W9hvj}1a`FN~UkDY~bJ$itt9(kx2)x!!r893d{2~&V;fy02$ z0fz%umT@a10H;603DbZZR&&C1;FL9-a4oR0loMtE>u%+QnZS9#*8x8PJd4t| zae@)}IB+EJrZP^50)FXfPKX9RwU?9jTaJN08)@xYPM8Cn2^tR0G)vM0Ov1W?q^;;)bw;!nX1;8R+>u7OKW7t?&s1D zfBC`wfeho6s>eTjbmXU&o!#TT^~EGTHT&qwPq)wQSbFG-z0YrMy1mn9lKK12+~e2J z|Kq$xtKOPQ{faJsrlLCnQ!{VunfYS=@B=RZGsy@R$VSpv2e1{7jzhou=X%!|MhMdY zv48{xvVfNZOn`-e)qo1XJ#Mfbw8>OcQEtwysi+V{van))2}@8`l025XB!?|b z%w);n=jE{M%tV&FIFBXf<}vor^bx`z6?j#_7B?Qr?sZFdfPM+^f*X%?4gg;B3KT8_ zrmF*mm4I!41As38oOhrQ1t^Hg7pvMg#Cci01fz7@XoCY6l#zTDL}bV(J?GF zH#<6tRaaJ;YBtD;-0W;QFZ#^8F;FN2tm+ykoLw3yoXiOn9>@+9Dghh7bI;FdmA3*m zfb)>o13Cd+fcF3~;Je!>->YHXP+3r3%&rN&<|p_keK>Q&J^#o!VaiWYM?eUm{gy!C z&w!@^=K=2dIjwZCdBTLc0=mlrg`I#F1s(x@956$Ld6>h!U5)!X?g(ADkz45Iy9n@W zz(+_=fzlDcCaf;#m7WHx2ztlIhcbpcVp&B+WnMw`ZOll~oINKtF210!sMuV>$_vU_ zX?Y2bX3b@#_m}iq;fYtmao&)bKS`rK?w)tIWmM@p)^^ zd`U%FS;hL&^3^=$P|X*Y7W3s$t1?%cp$v^d>(X+*rgW`&u0M)nZe{Q@Q51@-o(72< zKdgFaIyrkOA67gU%0u~yg%wpb@ZdVi*j!C_%9<)u0sJb8NX^SNbJeW%6;-#*LW$8)GYhJU*Oiu6%q%M{oLRW8w5%B7AC=53EiRc= zRI#=acZu?vYFT-fvl*@{a<5BCmDwEe!#+`+tIVrQt82_vCep2{si-!U!e7&xii+Dz zB^6bsqRMp2P548D|>Xi~hKg_;VAr8NZQH^@_#9eEjxQ*%rixu(RlJP=vSQghNW zvzABXq%Jh&q$Z|Bq~#==WToV+rAzX_To@5KZ5kEwZ;qMdE;?3~NeZ|WIz~OsR8T?@ zA+oTb+H6`^&0o(~OX(^kOqCE;+-|NaK@X-_NH&s^kq-~&4dv$51vRC&oB4v`Th~?B ztfh96I(PND%1ZP(tOM>a*BIm&N)D8+tt=bThsifrcjQY7O3PpsVcZaA+(6x(Io+u# zExJwi$mKvmWg#`^&-gH2j%-TCGJe4VUiL0AJBcUhI&*o^9eiJ z-(FCL;W#8~u-2Kes2_C9TwYLEW{z_$8plU6}R+1@mjHDfroV6q^W1%T8F?W$PJgJIVOY=;*7?V}&Fx39t z{RTtAR9#b0RYN^yh<_Ld@?bGaV`Nsb`Sw}spg7COsG}f2)C{;QnX(p1Jta+U*P05% zy|jj}tXWfKE-2>LRur!*GwTssGMgVGoSD|hx*kNnTpD8Gi|6TD3dy`X|=f~Vj8bsz~|&8n^xo{W|~meji$t50`iO|zi)UV6QdY3KI(%7ba!P7$vMDXo zl$)NIlbSLuJpAh7C0R=p4U91OF4arQxVW^MCM1Nw#iM%~(xug=+s#Ea=xo(Rn7<{p zlG5^GnL&5C>WXz$MUpL6L()aq3B+*HPPwF{@SQYar~GQznFp3-L-M1v6Wr~b`joHp z8qUM2ZP3=4uTz(>Ge0Mf_KE0n<}=*h8#1Ra|4M$O<9_|KG?nKpo9rmhZQAmvKwe2OHT~)qdfAFCv6$0=H!@`WSJJH zE_S6emMlxm%t$dM=HRIqcBJFv<>n>kr7C$0;b*KQ_MrZftUOa17C|Y)c)3fnv$JyY zQr-E=U2o9VSym1T#~2xsuTz$slYE6f)?>LDS=crh=JVo2m+q2fxu&GVp?MOI{LNUB zk(Ys*uY`BbJe;yC>H?d*o3c|)i!*W;C*~!myVnykS`V7CmSo;Ej8EmHF3DQDFx`}! zotQkNZd8`DeoGP;|DY^AaY;%hr0zcEq%OvKRBGZOv86m0rQT%9%gQokW-VC=cZS$y zCoY5)&6q>^PCtgXx4Vy-sY@2-q2lg-pfAyF)I|B>7BWPJUbQsU%@cRK?8KZrsS%Vw zyUUiOE;lJ{du5+O{Z`-sCv{13jh5uoWlCh+;;}pNN^PBoT1mre(APnm+`O#p?5oH!(uV3T z&Pt(yJ)}%!kPYD>Y)gjgVeo-9)Rrc<;k?}34EOm}@-aIxH+Okf&J}#;cjYS3mk6myj>3GOS9-Od&<{&>lm(& zU6|CICD>;kW|O)Cm2{7v;v;&J%a_He=+jjSBp6o=%8C@)={ikwr8cyv*rG*SYqeNW zv0}xFiWO~bgJLg=6)P&%YSCiFS}WQcwzU1fpEEPNvzu_K7QViIe<%6ubIx;~bD1+| z&YU^tInU4|Ev;S=E8j<(Rq2BA^g@9Srs zOC>!bNvcs!Ox)!as^?QLBJt;BhOtmVTa1oXRGO>kF3I=OvSlU9FO91U)mj#*5kpK~ za?bwBl0c+$kBeu9_qt9imsgiD9I(==F0Lr6;GyBKkg2WM{xvqtddg5c{-rVfQJmZ& z_3)H|knMWM%9JcAt|*o}ork~K(c9{)w=6A7rDsHui`;klC0(1W*)#Vo8@ZiNmzK2Z zNDptNQ$YpB--C)5S4A=MW_A{DNp*GPK_A0g>R-hmvZSoi=uBh6`sia-I+s?K(I89w z)&9u2DE^{S2B?80T!~Wqm_UVDWu;qP#&Fwyud8q~FMC^2{8Im7e_6Es3XjKv8d=-R zS`siutCdy8D6`M7fa>yM+LDo;RX8R~Z0*7bk2k+xx1@%H>l3vj3`QyjpJ84nR>z z(GEeK(4$Zn^aRumP0iC6BtY|^iO_k_e$Z-Y5;O?y5AB8~L+^wRfbN279@a{r4(K7M z6M7u#f+kHMeP}K;0Xh$w2)z>8584Gyg5C-358Vw-h8}Va;Bra^Z>)1gm5GoVMInNas6eL)s97n%)S0@c#cbAdXb8=y|;-B1^F zFI4n`4nY&3$DtaEEvfm)Lvx`{XbIE>4MH_9^(5iYJ0%>tTlfW(NBGcZg%5od>Vl?D zCLd@%Gyysfnh33c_JanYNzg86f9MuyGITq10CW#@AoKt<1$q=Z2znAa7@9MMdV$V> zrbCxNGoY)XtmA84&>7IJ(3#Mk&>-|-Xb5@`S`R%2T?0J{ZGdJ>)fY5E^Pty2OQ36^ zS3;Yh9Z*e2uLbIWZi70Zd!a7qL8u#g44MGd3OH}*aA-g19B2}>0@@$i08NH=LkB?b zh7N@8fu=wYKxOswD0DE?T}bd>ZA3>QFbd37P=C8=45+5A6p%3e{GlH#431P%qR8od?z0I3M9dgTjY)LtW6j zp>F7IXae*AG!gm|v>((xgZSNCPpAW$4|PJ9KwZ!Vs2jQongHDnO@!`+_JbaTCP9xu zQUDYBl@R1@xi zoa;Hz$Wn*QF3Y-6yFRwf>m6G-t*I$!QENR?g;OR)&B=4a-PjUlvF<#SHz;%5fttFy zP&lk6#1(^#!oR60(8{W=T2KtA8EH*RNnY6AdRMxK4qHS>kCy27g|%Z5Rg9m29cBg0{74yTo?Z*Oh( zE-b%zy0^97Te@gPRjHTN$*?T(u;kQAwOHOF7Q&O?Yg$YjTIq!9J6R8{Yp?UNn#fw@ zv@V~wuBM5l8yoAa%UcjF?|+&{b4^{O+S+Q`YnttqXRBk8>sa3wlHkS`7E;=2c2Z!v z2Np0jZQb-K)22+HTsUL$n&9-%%vsYeESN3z&snmFpej|lNl0sJSZ`fYd!35@1LBRf z?Zz@&u%@F%UDvvX5IvExmOIyrS_pZwsw>qfs%m}yVOUPC&{h8A(}f=PP9~ z7mrzFWJyg*rUYdz*;q=Bmk)CvvSb*421YVwwD@Z*`Sgw_wH+5Nu57*ISWWf4#%oy@ zX7#eUnPt?tsIljV0z-?jzHO|sdR23w`)QXs|9o$_p|z8)7>zw18BI;0c9c!pp87d3j(6!9*s_SR7O z=3*B2Ds3z_-ML<7w7d;;lSZl`)^S-oZsc-ZFUmE=6xvH=1Xx-NH>mbW-Yjx)Lb7Nr z&%jF?7d1{@SS<^@wlW*l=B1q|9T+KKbEvtseLYREUCt)HNk}8;Gk$Ar2g|+QiY1q+ zvU#OpzL&f>X?sM~NCH;FMe#Er=V$c!(%wb0AQ~*aVXT1k!E&$mEoVH-xSVv!;U;vp zSQfOjVtR)~LwbjWx(rQQ$qrILi%*AA@Z15Dvnd z^rlzNQ;w4--#LE#_>m(=a&mH(Em=5k&J0xYQNTBZ4VnMs_qxVZ)oPo`_q@ zXpB4RP*3Ox<&86Fpr(CIINzHW4L7bypkv~Mae3$g5P$M~BPOEfMW?63Qb=h+38!wo zdIlRMu-zqQ*%%7g&Q0ANf!3C~P@cTd$~$PKC5UPXC&SvYMCla=eW1qHU?W;%XNVUm zoT1zjvinI~r5)j+22FjIuO6vjJ2MJ2I(ILLT>|mz<%&B*adb2;YqkqOGfBklb6Q;y~8`soA-grDp3UU zS24G@l<9;C6O{Ur)XzCSXU1J7busm5~QTQ+sP`^94l(=d+&VQBt!eG^I{zO7yYNeX*vmWSQ2! zw5!!MbhfOml82@=KdHVcwN0(HWm3IUqJf%R@G73ZA|?7;;+E?m5BWyM#tbdzq2$>y zC(tq9n-`5Z!8-}fEb>^^*&NA1F;o^>YkfVfO+u_3G)?qY$|y-*OIQizt1!9z`QEjm z^$ZsgsNfVC=OCu~E3U%2$Z4z$wJ%rc&YjEpaG-$Y$wgJA)!q#ocr`w?T%jo^=Oz6; zbr z^?5c)u4`=!l5&`;4|I^?smgd=JJq5pFj6#i62g-EIIg5dvEvdyZQ5s3*gjJ2t5PIe zqpqZMbLTRAUny#sdDY`4c&|`Od)2&%b+&{X*R=2=A+>uI*M}Cs{ZF%LUewqg?pVPc zSc+=%dbxJz>E4%~pv}6`nrVCtCMl4#3+0(R7kxpS>WEq9d0rNeDlcO}6jfl2aT9~j zSl;Ipb0LsHAem&8$RFsOo{l zC9fvh*y(8fLsx-Iy)EIQvC}%$+rM&1!HdRD@04z{X!O|dXrnJK3wB9LO(6nF#%#Ns zzpd?BCq}yUHBHRgh}QRt7Gv~lzTA!O)dxuebLZAH@iL%lwz8(hyc_b2Zp-Sv%)Y>o zk6t^~PpUqlIPzpI<-uAlO<-QNJY(62P}|tSnA~{S&!0P&2S_A!B@*d5M4sM5^?vbL z`J$bQ49QfY$WH5w50EB+VzRez+APA1)3A3*#J(!NFOIJV)i5K4?6W)*`c5M{q*vqN zxPIBlr@5TBLsf~YoeO_N$Sy8|SaCld5a) zd$>@d?rg?4AC_hh|9^a))Gejz&)*WP;-0Zed5U`c&mXY)Uh~l`71`&tQhBH{l`!jOeNo0&rEW0(hNzU_gwz;N-qO=<))GWo4)0k4r(oNokDHO0ObSOSkEeJnN7nmbo*atU`VGtN_W5q-6%h`h`XsS&F*8lx48OXc&?z+nAW@YL0V^`@;6ktfl!A*vC0GTn20?HQXanm2+efsi zgH&&to_9LU@7!Ihb@kz?ARv2KcpH{|MxnI<8D?HlAG}INIq2h;YLR^| zltr$GM6u?{@IwzsGZ3y``?XEsqyy2C5wmtdZ1* zC(jpWfP1{Yv8y*Hz@WgIi8yEX2gQ&&m&u2Y_L`P(6OS8JLevH*x2zL*p_fM2jnuxz zk~sg$IDc83e=O;<@~ElR2hwAD8*I>~;NAeDqZv9;Ud-6p#oCeVD`G|p*9DBQ&RHGE zz75%nIF(ImoxH459u^qLUN(D9_SP_`z&p7yUrj-}E)lV^up)~(o0=9e1zc8DNi=Pp zVwQxOnBfXRvDRj9e9t%3Q!NO*P4 zT3)z2LS2-slf|iZ>KvnGJ7t)0K1TAf`B%ye7-M%Xf$Zy&bG6O!TWoK&Z15c|qh@o# z#Mrzm_iw(}+F8pI#dTbtbKg#6m0C3uP4-5Wm8h5B&aTPxSzb2gu+L8!nmfA!vafLp zYl~AFr0(EMp05^(=&cL73Jd7V8A3<_&7$%mW-{a~mabT3Yz9D?TjJ-PB24u|dA8K$ zm6J}@#*zFMiT>+4nL1_{bR~CznxUb=l(8qZ#Mm+w#2spHsi6lwvutS>y%IY!tu+00 z*LF6x8;$TxX`V{fO7q-bqtH6WZhZR9K6J6X_(nqC9TYg}hL4k4AaL z)MC5Ajp0jQqS)vDJY<)(aRO!RYLUr#>w5gRU*j(6I4W2#VIFQh4Y08Vr4W|Q6u(#& z$QQM?SF_l%yi@77tP^>zg2__viqcM%d?m}1MsK~MrL|p_?Skqu$=I>Cj6FzG=~gt= z)PiT4?wJipY(p~_m;!lIdM1+Qkuwpsqgp^h?k+si2~QFa12 zckWX;zqUHzA|Pa0O|$Cr#Z4JIn?wF4?pC92WPZAeHxbz~+-{cJtY7L)(o%A??iywQ zc@7!vyt;Uy$|vG4SAD%DE00TL{lOr^XUVs^wUUw8db4WJL!Yiz?NlSLZf^Hht*g_% zlipvqFh8Te{x1Gm(0Cr@wptSNrHw%;GcT{|$!nf-MSH8LG?@?dAn)nCfdskFiED9B!IkRT;7Ih4R(MB8+m#Jg8Z=mSEjcoPGH%L7A)@r z=d9n9azyJ!4HV8$CI)X4G+EK3Xsk$1w}$=jWHva;k)*APP}6`ic4gl>5qWF%wzaC^ zv#1-P<`!-YhP)~UN**;~nLFqep8#cnWWt%_wl)QgW@b#kVrPxA&^t8Om^vF=lbYJb zCWg3-I7DA-&ML8@;`RDF3~!grbIQ10N-fmV{6OIdGXz{PGeFI!@{ZueE(62n4#f|! z8iqoX70vL5t>kQ8HHjVdOJZJcwajdX#m<_fd!_>PopG|!j#b+;E6%J_R^7M@BvtfM zrOl}`6WtNj0!776tKsRR)uXAQwPDC3d@UN4teb3{j&~16|{N1AQuN zaVSo{w}}Bf=Zm>9u`QEN-e|w_o~dIA%{-30sdT6 ztKAhkvPBhc3l2(em%~=I?mr6=ieUZ?}_stiSujkC>?8uR8Y?VUDIv; zZv5T&yRALm__cSV{%*9XyYa(S@pb$?Hoqp?*8Pw%_PA?ubjSI%Bwh2`!o6{RJ)FyQ+gX0N!-Zf2a;Cy%WMq zj^(*2v*hcB?WF8-q{5SY?Y!aeBwsr(51!;}=goj8`PzB9@W|KBD;Hjdkzb-gw7WOS zJXn%!bD`r^Oi~xKjZ|8<@^^~?2st0ISvo+m-rJAt)!BA7`A}FZpMmc!3neZ2+<7+n zaB5aQ=B0U0xk*0nDFVX(i(}Nm&a=5b-sts_=jM*Hi9?IEuIV7+>^hq`dNhvQhTG33 z4tIx@PYQ9~>+!#K@ZWzgY*OvOX^h#VHyFW^`DRcQxezghay&1Vru60zd+ z!@c`#+FN(Dy{SH$c<<%-Z*Ol~%zBf@rdOSq&TqHv@gol+?9#&>0z}S;<38>6krA6! z*HZ7@Dj&@|6u0$YQ%+-OM;=H8?t6y=MhZ#ql;KS?qv0XYc0W);iOMrR?hJU`9o~ zpIaU&nQi?cu6Rmoh#d>9#_M4|@66$FBkC|-%RZw#? zC#D7ZsxG5Il!0)WB#AAqR3-;&$n7Dv+=N)1HELR|(xM$oSZkeF{R`BrLpfNKngZt8 z8RZRYSiaGg`Ip)3(fSu+Ic||whQ(DTyw+>WYA^sJ>%)?lt=)_b%N`xm2CRg8gYB%A zwHq7TkX38Sq7lVfXDjo4qw|VuT4YTNr3tSxOjS`@Stb>zcEgm&u76dJvTZD^q!dro z)=L7G?1a%WCzOY=J2?uvrq|cckgs!iCwcR%94B}uQn@S)8EkvNd~cz50f8Y2o9iv` zPT+46i~P3)IQ|OEQnhuCufY47N&FRHJ`1HMFM57fTSck8&F)9Dk~YcR!*sMI6H}kX<)!}0 zNF!BSEY47=eZ+{b+4rk$PdhJ-+sLJN-Nw{YY*RWz6~zk2*3SEQ>#KsF>gIp{^NFva znEHw7>&{R;F|x6>^ZxaV|3z(wJr(ci4(lcV|7IPvcX`EZwzrG%hgdrfH&{Is<1{lY zp5JgCn^_r_cCb1Cq_25cHZYpDw|}_oe3&A2I<0VP}jyASvCbIp@ zeAh|VLd|U*VjQAF>~hHP0VN1)JkWviCAJ|VFY)d1e)iVK2=Lxt*9R}|nXnkcyO>%m zD=jZM!T$gPuOd8Sk~l0oBEvMR}E+y{vhs z&H5DG$r<9DMS10(Ka1jun7y>8&A87glGDeCFX?$`3z24e)@>msMtq5T^}FwDTd-$+ zwrwFc&RLZA{b~#LjL)tu#Ked%>G^02k?!d18$(Q#GnV;%>=)YYIiGc7h>di{^1g3v z!Jh9~Hinoe@g?o!K70S46Vb=hS+|GSDDkE4)rQ~4_7Icv*|vwcNM|hX`_&#|@;$ru z5E~`Fq|D12`zgE)*Qq%UHD6(x-s+UEF?qw+$v)GL_SPn~-r$uFtBLllIe;+?*R`;L zNz-aO>+4ybP#!fFQu@Tk#E0^$NnleJ)yK8AagS}?gZ|7&2^C&Z^;8MSB92Of2^TXT z!muD<1n12!oHl2ICDUr~bN*}={!YuB~6ijhz;At*NCEG1l%FSAd`u}^myS@4QnBDtt?olJRi{2RDd_O}I$t>;!+*Rk7# z&sqk8^0in~UY69bUepz+Z>(=U4bQAFSqyDgs|2R(srZJ~I=i@WKBwZVbE@e??^bQP zQ|BoqtBvD{991m~cM%!8U&3W^Bfw$@^%{|h=ZPHOR8&ozW*n(+$uo}s^p{fg*}w-D zfD%v!mVrueDYz2UfO@bNw1G}=J(vb=0-L~QumyY^+y(9dp94Fv|57jCEK)YOmt1OmPteYc@RVtLuY5tJ zx4bgvQd;T7GP@NRi6`H4t1OkzuUJ7^BrMpt4vqQti0VA|*cH?Ay|ZS{oIdL+bNSkw z3y#F`m-{QDMK*2csvTcO`!(7u#;@56ti8Sf3o~kOgP|{uTDZ9!oyXF%vC5q94!5PSTHEm874@>aQPx9=bnO-wt-*J|O(Br0Na$_k*qA z2>uG_ZqN;K!5-xHz`ql^71}Mpy$Wo9MAMHUvlm)|f5VkY`W)yc=(8XPcf*fz^m5`9 z;HG$5`Bzi*rrF4XyLS)LH$(3PUwh>DZ)%zc<(O1akLeEFGvlqz-{D?0VY!7`kT8oc zj|@>KkUY-W`n6m?9wotccD2Zs_r|&qpJ`POd#;euX%UTv$R|K4i(#i}9=2iG^I7Vz zUV*kopqNkcRFxGQmdFe{NNwy?md88R4@}EKvVUD3D4lI`PSX9EHiMO$wjm3^sCXD* z^=u->)O8po7`8Mtvbt{Y#galGK9IJA^(d82B*?5g$tUI<mJg+btQrQ10 zJJuW9Wn*=eFFTa69o)(naMcEjuq~{y8LMG6EumJvu1e%u_FbWa5s51oki=-p%^2?v zU{#6Rkr9nmKzsg5!AJJ>1vwMho4P&_uH$pXcA0i+At3g%A|lidB@i7H;}fmnXeL%F zi15u_xsf6=hS6ZGhGHHhz^%yTReQwjd6{(=i6a%*hFJ^hQk{o!nWAY*c(jt_@o0=h z#H0e_0NL0Wn-+R37`l}6Q|+M6Fz>522H7rn?=Yia7T+wAvOr@slfJ?vmhh#R;ZDBj zjQ)#!NKt*pQyCVP@r&^gK7(9GmppWAvO5g|B)vRp0jARDBnifjbo(euVxHbbvV^6&(M5s{RDn z4!S@E$OB2>$iwi#YTyMY9-==4Tfl1I1xLOI4|IV!-~{>Y1x1gFCa0x$o_JG8?Od*t z)lYWpEh#R;M%vP)eAG^8MR_UTFezPGeZKm)hPuY7z-q`eQgpdg9~Wt_W;2jCtGp<) zc0K(?;5w;yZ1%GCH-tVD`^@M7ngd3l`uMVX*0#1;=WE%@4j3%j1RHfjSoyZLAZinB zouq6wM03&X9VjHN)M!=g}Vo}#{0T8r5S*yL)1s`rfs z+QN)9%o~;)1)G>^qiIx_bLl1DtAmS*8?tiusTz!H_NSCP&ACR>ik8yo)}x6<${3N2 zKQF5%j)|j6Xr8g0InM>|QFc5srXxwMU_bZNV~ksY8}$5$`v(jM2MOB(mVklai65rw zb<82fbaZbR!^(i-ld#moB`uR^?UvFkC?9?s8m-ntLa-Zb04ve|+Wa_dS5>O1Ax zt8^cqc$|Ct3C>M$AXS&q-1#l1*~{10$hQ`hapY#+WzE}IOFBsZ^E0l+(~O;do~l2K z{}}$m;0e%!e+SqMDnJg{3x6lL8*Bz$paH!4RI2_k*bX)UqZ-cl^=S<^PBn6t&dG31 zo-gfkJp=xhKrPQ&HH~0~1!|-%Nt-fc)lH_Jt@8AUmi~P8vr>M^S#_=21?myT*NoL7 zSf2P)KPh%w11<7sh%|pgM=Q4bd3KHL%3a+6)HaieQWiN=&WLL-BRjEbZSWb@aqdw$WB+&5kIB23@Q4|HTO8wE zdZBDaFw8k<+yB7a49DFs7_?!&M_;Xb^uy&I{qCh6J*nEG!uL$~=(#{-?MF|BN8j%; z_(%RhAIW>Kgg-pmqn{Y#(FeY0qicFms~uLPfr;4 zeR*Tc+KWT$HIs@>V67yyu2|murCur;Tgt8XGxIgm=ntaRd!G7EY9rdF=nloKLZlnD z_w{1mQ|1hezzK}(jqg0l=K=f+%S%zH;6tTV)m3tSZE+7m)q_bD${3w+OnL-@%^q$Gmg&d5%!h1@D~XydyRJha2xm% zcobYn8n>9~tVHIAaq*7fe-OyMXVkfTwS)-^zVjj`f2GZQJc<6czeleEHzj-Yhrxz{ z9{q9n&zbIbp_dLY_!1`g9R3{WM+ehygJ*!2>d_16>n)7KUk=*A-QW>$6j}*&||{}+#dp4!Dqk@@BpyO?8ScsoB;FEJbEe^52`^E*aY@~1K=n)2{O_>`Xr!( zRiF)Q2HU}2a1a~=4xV2_z&7Gcg_eR}f#<+6@HQBb>Cv-6(-6)>DA)!b0Y`u{%cGA5 z^TBFxH+USp0dliF`Z90>*a;4Uq#Vuz)Pp-f4|ow|lfL9(M+yGJJWHPkFM?OVo501h zH5sIXp<2#s&w=gWBp5c6YXlC1*FgR(kDdlzBCHTP9o_cf-C$Uz28FG7`Pog3hxbQMKLnqFc?+h(U*gpz}LYMFuIhw0d*jM5pB(+;{H4C z&w#gP+!N@Q-LU4y)mO^7rohE`D;cDNpke%L-@=`{+@puVF)+Krqi+Ecb_D#f%D}6YQTHmF+X@%@)l=~8GM2lQeET7v zN?y6dT?_63HS6f3!X1<6vkYCs2zL!n2w5GL{_6Zax6H@#)Nn^|YR$A@n;QSstm7Hh zSNSOAsrZxUGk+OuZRacuhjlXkmGX2q#y6x{S34yv2CiE~Gr}6+`Gf0f_$*V<>+cLU zGWYW)<78(o?Enl0Gr)YX2rL6tpbOj#wt(Gdi91ZWFG4N+mAvHH!P%u}E?`XK+MYfQS9tViFXJA%nm+MT?*EmvuWPvH!4Td9 zUN@<@?Z`0w8uV&V4_d$ma38o8dl7vW!dgGcWMJHQj*C6Ka#ehj&v?!CRo}7Va}J6m)}K;3<%{iFO3q zz;D4wWLJXYgiRyOI!PCV!42RRa2vP-+ylM{z7F<)N5GH4A@D3X3SI)Qf|H=%hiSLK zn&FS{>$Fsd$LVo-+@1taqNkrH$>1!0=o#cm^>{pKo=i`cC)<lx=6@0skG;+g6x@DzHqG*`MieVS*w$C2U8xc4?qyZ5%~+R1NH z7VtUnP4FXd7`y~N_#@gP_yV{c>;exxK#Folb<4+^Mcqm&5IK zrxM_BIbBI`b+>bfdpc;&z+4B{{lPZsg~5J5!C~ z@G-qq#icCd;dYU)L+nXmHiBQ>L0QN{!+3-t=QYBdNlqhQku!K$9OnYR0p0{}14)Ib z%6>?Hs6NU-vbI`VpgFV?lhgG2{4~7jrV)g{Q~r5 z@Ve=L2bxHnL1tVljV#kYGLF9v`Nzz-mTX^i9Py@@aX*0kgJ3@XMPM0N39bh9AU=Kz zymep}_&^`w@$&!k_pZbL)ye-mb@Ceb04rOzQP24r=dsvVx0Zojr$Ehl%4Dm!*Pw_f zv}szMvg0alv<=yF)1gf$NYl4ZP1EnUVGnNM+wlmz$4uDyr*b>v;-5+L$dBqb#E16e}D_TNTB~D_UmD zFYyckk*6K=6{99w>V}*>PisAIw9%x(vtzvJx9A0N;g+l($G7CJ ziiX-yaPgk|CxCY@u_Y3l3p^0kw`V0;Iq zuMmqT^}nKJEgzt0@vd0G7aJ^c&h#S6aH9)a_(Q?wV z;`ZVpx2Oy?oa)OeN&|efVMS>~woks5?!wDd6e(v++VOl-K3*>3kEB<=d||J&4Blev zL{;IJt|+fA(+nP!(Tf*J@Up<-O1^{4d690cJcYD{S;?!dB(^fx{l!a5j4g>~cvacr zWdR%0N~5B(6iwpN7+JYyeex-4>8jFVOW3MMJFn8TGDWtko|m99#gc)#P=RI3tIHPk z!RLDRDPO!C15}3m@(L8MN-(U2QTO=wH}8}5ry%9ur1tn%zLlnD{Dbj7nEuZ+{c*71 z^)&sSf2HaF0JGmr)0coN!FAxt*V6P!ucYahfa^f$)inJ$7zDoz`L7W7XW%vP{2RP$ zoJiBRfQtsD>#Km!zR*9#2)AfoGQ!J3ZXooVL(}zNfeFLY_0OAB+=8-U>H5ckxW8yp zE9_KsD6((HrDMtFn(2yPjDqP@hsU>(PvL1|AH;dE+=KE7?G|w z{TnDC&Tunc@GRq7a+2pK!5{xaJad}(`w0_B9+upFxLqUD^}pGWf%^)Z-yUXn-))oG zWOLhP#QiZ_m?gIt-qRpwRJ!iC@mCXe1DFN>Vq4g5 z)BRIu!dR}uI0GYXZi{E91@>^8`>@R|^17LxxL>k`<(vFqaw@-p`a02!WyeNmePl*k)~W02*Vz1~q@@=mU)pOI z5wsVsm1mI^-p*Kd4IdIi?_R!>r}Wybu$tgCf!5A;r6bweCLb{fN8(9Xb1U0KS_uz{ zmZBOUvvVz)b|il2S`=+#;Bd01KacHh>l7(JN#?T!$BgU7lE!YVwQeHmx84OhQmPOS}Y*NY8zp)7?7>&bc z3R~F3&?(9<*7=EATuWzL#IN3u%y$?|#{M1?)v~fRkpa*&ecBlA%stw-vvyD&bgS6y*Ki>EgeSqW1p8nlQ{wExVdvdym z_Q=g{I+V}d#H}u(#*Lr4l&+xyh&D(c!i@eo zdEehQzNF_nj`rkskM;ja8^7<*8(+}JX`}c3apUv)7{?!aF6j39k2tpXtnRMye_pHG z_r;B0&}+5&efMqrvcAUgrJhiC(7!`#+P7=t*Ysw`*LzyKTl^0=?(ey#d#(SgTI0U2 zY}~0gXkGjEZv3vk-tkb+4c*uKzvpeWs{|U!kJuAB}^?yoRvG0=` z@6@Xu+j_3-zRLeuEwJx%8}HSx)-K=onT_}8S2#Z1b6NK)|J{zwJxjXF{2$RS-gn!^ zTlI^yW&1w1@pgT=s45$Wm}QAq%mA4R$8S^v&>Z2Dc^_;dZo)?e{nPSiR?a=@9?Ov8TJu^$zXRPe+m5e z>zC;6=a!?Ncp>~H@Sm6{B61{(SMCbgK_)*gmtmoq`E0}Gl8J48WUgGzh%=GyGF{ww z>AGM~Yr5V5^1$JibUg@Oy*6Dh02#OsHK*%$Bexm41e|P2*UO*E(U1SsKnd=%MS&?R z@t<9r{%=F;*U!UZ%m5Z)oPHeJeylIZ0e6B7uoWbM%|L2s1N7vR`hrA{tDnb}+L5=~+?M|^ONTkhUTsQ-m{@K^0QUU`rxW230UkOBkqOuX?b`F10>O-+yhEelV1! zpSU4Qf3+b?fA~*1dfSaz`gXAD16g{(HCg&eWDYbThyTjDEd9uaEZy6lrOyDr-I>Sya4>X$YiNoqH#h!&=t$SFQ87$+t}8Lum6YpB?k$|_8m5@Tb2XA0kmF3r zaSqOLdUBitbDV>6oT)j^v>fNi(aup`mn+wqkn8N1>+GNFWWmpw=uFCWCg(acbDTqR zo!Pn0j2vgW!!?4?TxV{s^MYJ0Ylw3|t|KMak=yHkWUhlWd-G4lA?2LWD$QKS0L_u2 zktSu1`5)Pf>CV*>bG4*gEjd<_h?*2h8?DNT%!Ty8#f*D}P&*(3~3}3=bUxH8lPqjHBZX?M4JIa?(X#E>} zyqd+qJ={ts5^IVpVT!}d#bBoU5;A=WQ`CQ!PlK7PVqGvJVZ?0r7@vEn&plQBU*Jo? zF~R2^IV&O8=k{6uqvw#Id!o-hY7XUbyM1nc;bhEmIel(zmUvTq?qNRnaK%rsB4*BV z8Ho(^xd&Oybe}uZa#Nmy+3x;6H^uYLpnhCqe6FEB*HrcI^(Bn=xhD8rBYl*Iq|ATH zljn0y^tn`dTyCGM(C12%G%1fu^SK82Tq!=+FrRC zW2(fSNsH@ zBgu+IL`N2l#4$((_48@zK1Ze%9X|ibJ_iMx>(gdRbCUl_mSd_<#)enL?Z+Rq@k(T4t<3vQN9vrv<;vJMf_#y&HN0x(zz; zmpS?#X!UoQV}LIC8uvZe0bT;D9!S@>fYk3WHbZ6y?nB@>82EK~APB$wd+B-y?q@*> zIE?%%=^FRgY0K33ppnse6z-F+GG-o`>GY)iv49dC}dKB!E z^57r1mv9h#m~hH52VU;SnTxrbvB0O9(*Rwd{4?qLhr!2gA2%|0{MOMQA2arL8RmTK z_7NjHD5pN{;rX9syt*x2 z7dpeFhlwwKi|#P}4MItC@28lTpugN=QgO#)8)5eFE@bAw6Z-012E7}%_$~U<9R~jZ zJSW3&ZH#B^_;GpN-JBnX>s?1brGFxBQJzuU!3;E={RhZ*jT&Vx!oRYlI)KHGKy`7T zdSSW9oXe0#sUj&=_E z+}}3zzx%}-hJWmI_t~7EGgXnbaC#tA744< zn?09IeCWwllOKL6(DsKroY%c@XTk^m{@H=+k9}r9)7!U?T>IwcA+@h;ObxyIq3k8U z`Rd%|zu#4~=+|GG;Xn9=>D52_&bX={?7ragpL{p(ssoQqJ#ww<6MtUk{^ZLyrEL34 zSMoh4n@4@@t!r{V^3OU?_iMqd4<9b`-T&OOd0+e0;+Z>su21{o{uSdN{9&c{8$Z5c z!rq@=Ipxu3Shp40f3K=`rH{IbDAoWWjp@|6PAe*PjDJUS_Tk zTnGA*?+?HI7q$_?bZJ7d5QAosF-?$R5bBMc|@~L%b4Pkk}>ae zSYJ>Aa)BG9r@IEFJNe~5HQkkv?n+G8l9U$?=aKFlILJ95-I;jt!+XkKmC&BP>$byH#m0;@x%0c-LK@Z?h9Zx!7uOKf& zKLKVCwi+biu0Xb$bT?4uO<=>XbM!-;3oysoXNXFGT{VB^>m{Qr6Ol%<$Wres~PfooPd<+mom7D zq!cd^7a<~V$#t9cTo6gYs`2+qt&|wtCA_Ppz3Uk2a1MRfHSAq?`nw6E-c9tr%eXAj zG033}a%zL#aSqa4+3z}#lOm#j&nu9Z6)+|kc(wx_ECChZ&QqWb{taLiSPdG$7BCU) z6>KGqk24PW1Y?Igpm#DR0$Md=4Z`19&KSqUv(RJURghAZp--;N&?~`p;2?M%)DrIy zXfvs}PlpejB3y?*4J-#c!GmBN*blaV&wzsG^#udLu|G0*2Q*iXD}j9%{ms8js0ZY@ z5?xvBz{qeh5_jgX34=LTXNoh;ne9y020J~@bU2C5el8|r;jkXW>X4hQE%KM+a49OT zL}w1aIfQGD98LaG)n5+Zp0-@bsE{0OYa8_dR)Jk%#$v#Yd&_#po?X0OT%Vz5e1LlH z;2MJAHz2ctG2lkVnKx3Whja7_Xa?9#*c12vQD_^1yalolSY*{JaNC z-@S&99;n`19CgtzLK=Oz!EC6Ben-(Vu*3t%GVEdAe(`!~#yL%%55?S`hL5w@~)S;_LsUVc<0jqs(V)qX?C zRjk1oyvky%N-nP|RsNOumRFQ6lQ3~Fty&!6FI&D$grp3nh;mzz{S|?#YK%53d2uhV zFv}>4k!40Y#I2~L$i?W|mR_R5BYp}gXbAnFE2CkS+ZMK%#5o6Ik`CdfUrC5x&RL~vxovUPi5pQ>T*Ge& zNL;Iqlv~vXn!{W(@mG}=uc$1mzRcjn@roBMmHHGpr7s&W7%JY1DoTWfKSab|S!&je z8An||Wvo}OB~y0{2*GFg?&(RwXL`*ktxN@Pn)%l(%HDl3ro7mG5h5ml~F zsWPi!v;#g?qOMspQ{_TLmBDI!QbyJI;CC82-dgv48T#?h^WOjE4E=6rw!ZVT^zp82 zeUG>kvh|aR+4_NZvh=nA+4_!qd1gP8qi;Y)u>UXmg57|QgXfal(a+HzJ%%KQ+>bKT zB!3CO;Yj3{` zuM>B7hW^s`k$V(5Wb%k}l(2>;kvl+~rx;HipV8?^STr`;~;)^}6JpOL%s@t|+g@wnwEVW^c--mslqUSAr!VF_D(Xepgpw zqRXAAG4i5eB{~z;zbnz1p#EWroP$A^$Y~DPBIkgOC=nCYzos2~k$OJN_(|{**9BS) zGyzBc%NhDd{>FF^i2EBR6}RB0rvIPNt*;w#HcjMyp#2|&Zkm*>9|U{yv-MYjHaS~g zG9_DY1AC@s>%$AUCuc$nv-R$2+)E&JMz%f=>;Q8JyAsTqm96*8h7UFqXT}`Ta`)rC zk~@_pe9r|Jxbs=Azku`H^Csgt$};RN+8USx7J_oH5_EuhFQcmi4*gAEupJB;;&Kjg z4I1LY5&6#;q8aX#A+8k59SJ3jjEUoP4{;@<9x%iSN5yew4soI|fY8sh9f#F;b1 zNgUa&JcwV($HD*Le$G@$TipD6hB(rOIMQt#nb39&(GnyWIr&fQN5ZCC70h%;nA(hz zY<(Lz1dd#otsjTxmu6#MBU{f~kge-r6F33fI`s)XurOPHcu}@~H!^L|)r+(BEyUf4 z`v5qEe<#RYLYnEBdP?%7;w9xJbETaWvR5aC4lyNpVY$Ef;_|Yp>QWwg_?IpB`j=H* zT3Ttii~W_AWq4GWdhnQX3s+R}+)qh1cI2cat4FgowsWk~YbCFRD=YmfFWf5^R}~>E zbgn^{n*OEAU%a%`Fd;7yByLq%r4@H!u@PrsW!0hxuex%H>8>nW#>0&`#jJiQUjFE@ z)2Cf=_2{cc=Z|gZ%$FZksQl5f42e@-T&&`VU>wXi_Oy(1Gt*HXDQnrX3YA7A+mvK0 ztay0^h36RC(9oD)K*io2|IrI8NBl(UiVucJ?> z<&omFImXH65i;?L$@y1}?VKUw20dDJ0A9t)*Na-OtRE8a53 zhSvE=Te9LUEb|v}Kjmw+@-o?gJ@&>mEj3L_Zgs0bQ&BY?19sSpDM1zy9>Moyx@>KQ-9W#sV^CrsaGdw>f27zpX1*IR)Kt=fkVzr zeJ9ue=JiJ|DN{e$FH>I)@)I-l+=NU$hqMl8nfhi>0^FeIUB(Qgz2%>b^AeJ@I~DDx zZ9k6Rk)&-Czav50VbWbfncLVa)Y)JA7k!^QBa@{t(gzd4G%yz|1Z7|)SPiZLH-K(% zEBFKu`}{U_|MRr2ZhnWLHYnMv0ZV;jdyFAl4B@r51fwMrqeD?2cDCE=B3|_7F}E4< zYO>dI?x}ugJBB=({sE%^(whn>a;SxC`ROCz^W>9OI*luv1>dUg{+`w+(h8a>} zrmab)@F|n}CX=!s?-hm^lQ(&FeEO$DF)1sb5RlCqrp4WGq{75z^$gyd3@gmahBX#~ znlN3xj(K>)?y&eeitjvCcBujGQ|=Q*X$jZ9|V{W$GP3 zV+mMG!;FgC(I)>86eB8op6r)+@H`4VlUF;dm!2%l7`_a@p_c zUn<5OtI95yISDI?0JeVk6iT?QhVBf0WP?X2He~0BO#N=456#re!QNq+`uTZR5Szfv z&o%Ip&}O_NC|`X`Wr9mUKiw&Z|!B{CBjA4PYxgP>%`L8g<%Ho@sA6 zBEviq(WBw)e3x%l82K5mCo$oM$=s+s35hAn7#YmwiV00V#VU^ut-ei4T5z7)k<=%B zlwop~_bjz5N|kVIc&vIx8MQ>Y=qfl>ZE;g;trS!&ii#0ed%aGyGsj<9Fdq3U#)hww z_xiD6Z;^LwSiSbkJ|-hq<9iX7n=gHs_G`t4sO*t4?8I8(7Ef%%#_^PW*f?IqHmu1v z%`_VqAeLulM>!*Dn6_a}zZ5yrf!cV=R;=ldT-~_yqhVkens2m)xv5N9^{D}}v;4|< z@~JmZ@aQJ$LIQA~>$nZ7hcwOGE|jjtvuO@4HGGgjW@_mWrBolIfIN4J}md2IV7T;gN zY;0+DHE%IisUvBxTwcCnX=LgTn+S$+y`Z;Lz9`}?v(BNSWJN&U;8ewwRt6+ZiX|^? zDy_c4)h_y~XgCw90j4_bNf;IpY-v!=(}qhLQdhPj1gc9{MXsHcBTmNH%x?%q$|`mn zDwoQ9u&Q}3aV1$t%W8((t3I%NQ9x!-BWXxJrRAkdX*#{?!YYG#Rj8(DJf=$JUAWRP zFi=+PuP$58gnJ}i(_pboZgS05s9>42x2NG>xV%zLf5u8g(vW)eFRbF~vOHj1WGRDX z^MY#9#!i{jHF@lm8L>Zex`ZXN4@}S0zX^WuZ{jgC-Xs5J{C_uJE8h3sL%t6p`$zC5 zcn7>-y2T%l7yIDF%UJ%Gk^Lu-v|k5OulDbhVS8KI;Px{BR}MlM)m&V9S%A6y;)q-B zLyKQrRVhmpmcQI4S8j#*J3AVd8lPr}$eC%BFE93&s~pNICCu)((v9*;mh|Q^RpSrV zwDG{#j5i1|o^5=?6l^r-S7k_L+NnQ(=fSRH8FR$hP@NWR3xwIMU1y$CO-;4BCl_}3 zrv4^(Oi~Lh*~W#{Y`?WwBLSj8Ug} zsL^O0h~ZY_D=)FXHgrrr-)4OWBA;2L0s z--X-InNi9P@)L9X;7R5-p2*aH0v?XTP{Jf!_(BEW!0mF%nw7&TO9Fbgr0CEd{uT2i z;4tU``@s|705}K+{hB@tng)Fx`X+b>IPoWfWN`n{O#Nx_kcm%2Z#MBf)GD}qrbWK4 z$y*u2#>l7r&eQcbY%SDwh`Jl^RCEEgYor)PKOvJIp)hMReU>rMRCB%PzZvh{eae{M z4ERiX7WUAy^v|0RzlGnA&C=%qq03FW+N5`ww9Ta5r=V8&m&|ZUOR(FdKQ!qtZ1lwB zEd5@v3yAwslZspLbe!MfTl7zahYDD~oSLPFfw&8yv%q|C3Ah&C7odMN-Cu$327AFz z!0!sP^pW6dAa21JFbT{DZv)q~EWJM%3^KtmkPGI36*IH+3KN!Fs09hL+*c)FPDAa*75e6%86$G-ycC;DVx*$wh-SZOYV?sYT5E z=1(6urDy>ABPI>Q1Bqg3Y z*iCOg`Vg@vVMbD{XhmQJz1NT(=DBbWoj2%$BF(tRj2moB z5$B4aHp1a6(uNgja+f6!)7-CqpBCVvgxZ4@ukdN3A>BcX1 zM6QIEgQLg~tjf}tNPeAJ`f9?4Ux(fnbQQc;Nk2cFrEj}DOK-qmj=hqjxC=UnvocHX zfgS|Mz;5DqA+sHsl6Ax(odZB@mXw2%m{7sbC`56^Fg}4}wos8~7Gf@GQt) zVW0piSP2T-nmeRU+iOE=Eq9vf4>h&d3V%p2OTUA27iz~ZY`kZ1zhL^`fnH91-2^@k z?gLeQ;C{|Y@D~$V)YEbk_dx|29gMT&1G?Vj%NKevHx_JdZoHle1rBAXD2}~?`VzE& zO<*g?tu)%iCg`Rcvh*))`t(OrzWn56PY!r#&D$?N`o>*X z{9yP4*Ie#*F2C~C8A*49s}>Bb3|*b~`N7}rKkJ^Nag9Iy+^~B)rcD0k%Wu8DwC1TB z=3o1%*BZ3^)uW#H+ars9bMfyF9lL1l#6M;I=+`Um{8?(^#^WX5d;XPodT#yN!%N)H z?dz;77&@rAJY(k6KYZc9g_r*G=Eb}IJn56$@BaBs^&j}^EkB;{i+St+IAWb|<+72# zO>R1RRmCLEKlYcLUv6$~&;7^amyFr4?SkJu`=JkR zUAX`L!wHVGF9!Z~@Z+n-e|Jv$x28YT_K`0?IQkRbvUj_#zx_ma_A`Z#?fv2I>pVX> z`K!5)op|~6cYpQ!kFRzxBTA=|HSvEz0fn{-Y=F^`vz=zd~M#BAI|#PZ-X5fpBT7g@8`Z>y#K<& zU;Oizx3xUu_{O%f!@FMj*^ggcoZ5Q)qATZI8vfKzK7VZfT{S6#k8HU1z}Cb!hX3H2 z2O6_KJ$L+X{yJ&&(_iT~ee%4_CqI0D#g|-{^&cAg^`?V2Pq=*K4Lh6j>o#0>!#~%y z{;0sQX3{&q{_46P-~8l_Z(g?e_}317;p^LWwD)}H?K{TJTJXk!8DIL-KdwDonCX6e z%nx(!O888_wC+Ftb^JFw``?m3bXd#f+bey)`qqT!r*5kHx%M~j$!}b7%}*Y=@S^fn zKRfvM``;>FI{kyC|8m|`G4FFbFZrT=`zJm-=e36)eCC4GcVBt>rvuYp3Vf<0d;ga| zP!zmsNO<+e<a#>>Tl|T5!uG)`(^62_MKQX)cqrY7C zm8O-iz8Jdxfu!#-^E&*#J&zsxUB{@4zkl1UZS%ifzr^+WpqiPNe)mKBM%?>{6L)(W zfAg_B?-}{wzdW@f@3}3X|47QCFDz{Ee|qxZ-PI3ewaIsYY>QdvXO6{q$F5n|UdP^i zrqpWM8hO1|^Uz|ycj1afYK@kq%sj;tcaafX zgL|Fn-vX7eQ{gVc9tA%EzXs2Pzk|0xzi;qfZ9KI-vd6pq=UMtypb^{*J^}6r-#iVL z5LOA2p3c(OgAz~=mVq!3o`oMHXSpr<4!n84$kLxc?(bkY?u$S*Xg>u$f!rSO2v~QB za|gdU1$LYK%b`tRB-r{(<`lraU^jRXya9yQ7o6~O!4xp`S6TWvFb&KH7lD;v{}BIz zE5WNd{smh=E_gWGzo4)%!CjcZ@2UO=6>9w3LkHTT5I4OrVO(F)hudPILs{rn`M7cP z`R^=r^FO%IO}sSqJF3v-wS+Gybf;TxqK_$b=PK{mLicFpn4*3q9~b4zDs*KRx^fEL z35Bl2Lf6Fct|5gkg7|l;f5Sb&V&WZI=o(h&BJ=b@S8}0iK%r~I5Z6d0Fg{Nr5;VEc zHAQhGA1C?nYy2k^Iuk9o!AU7}It#SHg-%alLYn$bVn>-RimT9(T<9ENi@{`z&Ciyr9SR8v0 z?kS4T%~j}h$OSv)zq636P8mwX^wWl_lx;(FV-GIx5gFNfIv4|{gJMtxYQat5&YW!h zB~UmdTMw9cdQ7(dB@^wr=vw3cArSY|dFTL7$krRc9VUY4YNr4@^_YH(N?2bQZ}Mlv zQA>7-$rpOjN^kizcHT%ojJtw`O>wHjI^U#zcX|%!Cl}0_dUAoq8&br%gHM9rfxP+I z`iBGPTx;*0UKKcyLSL4NU z+jAmonB!c1G5Yr9=yrEx>lv41>*W;&iuo35d*hmh4)3&rf@zcaneAPU9-6mI^nU7V z>O$USt?eBRUO&6t8|!NF38$-z)cDa)VrgqQQZYRT!5(jC6mAikcb6~2I&v7}#>r5D=^-Faor8-kn9RpGw zDXDy)%jM!jUn1{FO65~x@U;{+il%Dtksqwwhpx)jlU8${AouEQeK$A?^gy=0zm~QH ze-G{qXe#`}xcB1TemSy)yW9@P@jCcH_8f5ZgwT%%1@-91o4g?IhfVkSX-n~AF|0IO zV=<)(bEW~Acaql}l9^v&RD&`#1~VBl3LDv!t-p0mwmxNTw*CrKFcr3cLVb2Z^MU1;&DDU?DhN+LdPrKV4i2s|D@@7Bd`IK5s$;J`{j+Tw?|Z1P z`|usfIC40&w{3ozKs$K`zhxc5NXMbY({pwopncZVSUZ(Dg|%VYyin|j^Kqc|knw?^ z#yUBzfC|6@H=2MQO;O$3b5^dljs{Ubm}*kV9~IsheT6=Q0!BQ(^4b)_dUHfwm~$}Y zwNh{1*x&>-66bms)u2KU^mep*l@&DXJsWHP>>CbWAd_yVmo-!LiXyQR?_0i(Gci*Z zDWy*-7EMM+vzO}i8buF#WefQQqtD%Q)GW4Dw_Nr<%T$jM6R&lO=*W8OI@__6-=V6A z^4aP}>awM^!y86No5xuwc&hVMX-3jfml$0+5{s>CNw2JBT}@MC&>OiHebrlMi>kTi z&W=!*q+%8~pcnxoRMNKib@IhqX7vh!7Z%PaEYPe>>RLlx)VjCE(9iMKceW@kRBv-| zX1-UAEKt&&OQXRTtQUuxlRag;#;~OlgP!Lp(#Fu1yOYBfr z8%nRCV7|Auv%}lSf7m;=OENuWdd)R!8tbgomMYJg(wcqYg|kC5YOOR;HfUFxGiDxq z)V;P*o`vkqMDLmzg*746g6iv9I<9EEO7wmTyc;%n^Jo?A>*XU0!V;nI74qBCdX=eS7mkof9~av7kDlpAfi$|km$vzE@%d(-3J7OqC!Naa^vqsC{)6$QnT$|a(Z>N zfmva>?LtyyxXAo2SGJ*U9d;MO& z9{AjI&gb9x|Mxl1IpVt2NRC=_1r=PGv>*YM1#u>mf3^TiFuqAxX%-VI=3y8|i6%2) zoXm-kbp;V6mQ+%DxZ%_^r%yE)?Wp*VwYM%$Z^r&)OEvAlrgotkqtsGt5_4M~L!1-_ zH>7zj6%GYo%s0muV|99^8R7P%$s6fCadfi<;w@(uzSEGaubcY+jd+*i69BXOxgc)g zDX(2eW%tHp%7-@PU`lE84sX8d*40|pqC14@wfvh7S2QS2qcZpic4g%pOr4D4 z4I(hfiMJ;wiYD1QOElIegOmuGv7VS`#ew-83PZ%`~4c&smwE@f$L;Tnv?>eegnMRa>8pInUP<$P!dvk{Ob2&RX=CG^1$^en70mp@3}Wmj9) zW|}KY*VR}!9!oBSzI)A*+8XLJ!3$l4Qn{3HsNo$&yUSw@X3Yjg#TfrG9=4b>_;-t3 z7cKLU2MXHVPZx@GjHb~j+C8ln@|gnC@Aci2rAGiy1IYdXfVF$V7T}(Dqc5?fnQ{Fm zzhMe0SmDj-rWgS5W!T8gXE=o4WW+u>;0*wB(=)$wvXl>~>5t)X4)$2s8)0@54ff*V zm8;hkm)F&H80~l4L}7z#xQoO3+u!H z@ANwR3f8~?`vDtjOBo=AWH!{UWouVqfFyqehVgbC4UO1pvnAD-g4Jp~%9xv#)|Jy& zj{GQ;jKa*j#DaV75|?EaEWy_ZUT&PK&JMWgXc_}F@ecehiB?W7g$!TL`a28P(1Tg!+lt)&W&u@Ok6|$+=sh!0K z8R9|=wAW(#kx}SE<*nHuW}%j^d^ngb#3abo@rz{^vAj&I#OxbmWZb(%BMuJ@D$ZR+ zj=8i}#7Al3{Ry>SOA@&=>+WUl&b#j^$SUNBVDW0tQsjgme1J&?{}7pf z+sQwYKnsjE)it=KW|$mCepUeOmv)hA%8P4O)#BzfC^FYr=!Gx34)$P;rHtLZ#x>g( z*RHOvtQ2t)fq7M}#gI^+DAv%yXIM`tU5%klc6Jg{9*5Xre!HO>Yt4iT{?{}Fvn3C& zE*JB#i(kBZ-KsKk-Tes_$b`G-O9?)b6kQCMBIi>;@23lhQ|s{!C?dkch2O-$(M^ib$(+2vPOwhkPdz&nzWJAft*H z@HuG)PUtJj%%ZdOva|6yA!Z!VL@7cYW^r9T&Vne1<_a{3voJ@(N4D-l^kF^^I6ldy zkEP``H(3f{AB$LNwp1DtSxrqjf?7jft*4fUJ}%!-ig_7QmjQL-?Htd);-FI%aH$;% zktac^3oI*3q~e=Un=9rv;vJ_ElBGwXzPXhUk~@(TAtP+M2Mrh0WbW|FlOj^uG_ zOcu@Rd=!OM)vHOvRSHpZwr@!#PgLn~ijvWo>`DOlVB?Sp`4kSdrjILcqzSBhP3Kh; zSAex}~9e`(VU!gW@sw0sZ)c@ay54H5ir4g+R*}5vy+9 z>R^VhnOatymq80@Ym2d9kKr2cxe14ZJ_wJA4HnpN?#${6QlN5}6Xf%r)?hG!1!GK` z=s+7pWG-K5UbPNmGQL`h!I~NC$Lh*znVAkH5jWIfB^GA`Vc1h`p|$4!*cuT9Ze1;g zGUl6U$$-MUrk36a%Imj^+x?x7x=216XbWX)5>ig2wSE_#-jvi<;lRc;SwA) znw^)vB&T>`I#x7O@^kK8QY@eOin5?4ox5L@4rczEjj~4Zncjs|Q@=(>u~fLu5Bj$f z*6m%^J%#CFHD0BdvF7jc3&oh;t(0NfkGCDls~HSMv(l2pwWS+iqXU}~DM;?&rb5I& zspi=$7mo3HkjOla;BX5My?DV8TPBJ0%`-}@8{I`xl7(l0(nV25U^mIywd+tDS7O3d zjNoWIHu~2w;RF5T@Z1 zhZ%u4u~e7}j^l&jj)+QRvt_)V__70Q*=G8XgapH3&J8SLt7Ug6ci*{3!+xf4goe(* zIkr<9H0)^=Lp-x1K84Q;#y>)q=GtxzEMe#ErX$hz=)jV>Y(pXLdSeT#A){xQOd zX`0*JaT7JVz`%)`Xc;GAU4m3_-oSW+<|cPu$VUav)!gQVyB6-0z$qH?hayF38x=So z=}F!~*A$K57bIvV1x^c?0bUJ-=uu9iALSTt=J!Z`9@A{ZoliTS$7+T^;UJm_u>2Hf zz{2FaoBaJ?3l)hrA7BUVMjx~y;A+Bk(&Ij8SbAf-;`CC44_Xs&U7(SEH~);}?gaFJ zmf%U_Vd(*`544G%G%j}*xLxsjDch6A<!lJOw9}x~gJ$$W z8wRZdwA+2qqEN(FAkCtE(2Ss2Kzk2q=N3O6mORjMB7MtMfmQRIPZ|%)DbVbo`HK4hXi~CX%JB4$%Y`FSn^N==ed*^N zza$_UXX~Z?KK#o8O`3!H=PAd-S-}-S$R$TMxsF*uE4)Q7wfd0T1=@~V^-`Bh4gpu> z4uF=Ks+ZzD<#-%UUd6w@tIz~=T~%qm)5QRq`fwHeM~*`#X#Th9r4PX%(|9=Zsm&?@ z?JQ_s;gpEB5j5Qby)@TTj;C1*XcA~up7G;4_k-4PJ9K)=@wguc?HFk9c+$9k=Rww`8QwCP!6+BzPG zBG9ZkdMOL-j9Z!Dd20c!=MKH}V;?%3KnpL`OLuwFxXw<{N9cAOCxC0*P_gOrWw!M4$vCc>7_v*I*)+1X}w-L=t<-8I|G`uK`#}c?7M}N z(?&qsu~9EQ=_$v<5)*`XK#%IBS)S?1<30zpqHpS@<51|PlZP`OG{a+K>L%A&16m$v zzxVWy>$HQGzez9AFwRXUr|kyK`fa_>aaK2IU7$7kkUI_9{LQ{;!=UwyLyN*Zpm2*` zvis0!1no3vzQ%lcpb2)pL?6g|$DsrsZK_@bPj-K1dYZ3ZgM=2!f}Fup;<2#`OujJnsqzMk`G!AXeXc0 z`y4Y=fOZ}n^isa3P9Bz8 z&m(F>Hh08U9=J@@XaPlGL4S@D% zA2hm4>-1^8bl#K3(`625Js*r2Pw@EVgLdGLdMOO;jCY#VfENClUfM|Q#Cj7BcH-mY zl34g*2d(jMdg-~lJ>?v=TGTzE(jR@$Qb8L4&8w~CX;27SetxLWu_jdg z+iNW)-7ylSg?J)>4bGc$FJ2*96)Q&=Nf5IIR=7gP^tepi!Sw zxHwdrM6|80eB}O}1qFt;@-3us-SP4JZE>DUC^fu*6+O+Ms0K|2SUul(%+t!f#{6Uja96@Sn=Kzj(L zTUfY%i~_7YGL0O{TGLf%saK&DUWHbB6o3u@PlE9`bJK z$;%U!`#D9SKKnZ=_l2PG`tp6xJfd>n16sWgomB3ndqX8Ojbr?ya<4w#`F9qCe8`C~ zy~9c6z819WJZZe1QMqpd?O{(Ej~|tL;l5C5wI_|sjkCtc16e+BR-ec&mM z1HfZyK<)0Z$e3^R7w8wc;)kOZUo)}ymxx;0KNryl66n#PT7z9*2Km9K7J&PAPh(kAt5-4t`8OuIQn6ChFrJ{!QcHclp3mTSL#)+Dup5LX1iR zlH7d25u_`XWA48jtq8b2(Bgg2sJup%hRSO}?W1iQ=^UrcVMV8n>MCB;S92W)c>lFx7@$c|MGA)UPb4>)Bg%e0I%K_8F}5IJX9Y! znsS}WRFN><@nhQ}nV<4jecbsQRU}LqU&8&}Jq9o98QT`gZU4zJ{4)OhIQX$`k<33P zZ~u+Hg4z>mi_}Msm&nFT_cI$q<#(TMZ84?$2=Fsu%GJln`+w4TwK_?3dbpp8$7-FF zDPw6=C)LMYZoKe%@FIQ2<2(0QsB{JCActShKZ;l3=1__Jl<{)9XTseH{5M^AnV-tj zjxC|`8Yxd7IUT4x9Rz+4@nfBy2@_oNerhYK?8-b$rqQ&Gr(Y+`BcN5lRODPVYAXy| zL!~OB;r$16avJ65SwItL-eZ>$;2pr{!&LOuj+Y*N;43FSB_5=gr^mKXsnCTNdHJXG z&^3ihe*>?~U&8T}9>Y(BN+vIUN{`eXq0&Mxd?VZ&f#>hAxWBUg-M}{iKh=w$>Q^W5 zd|lm*|0M9|fcK97dEkeA=%M-*^<=2@yqA8eUk8DwG?L>bhlj>uJ-}0%xZ`Oob{hE8 zF8se;5Av^44>)a{dcbLvzUt#o7XA~;X;j|S$D7s(!fr84eoy#cu0D;+jng-A+F4a0 zOmCgz^i2}QZ%q3ohm+IB>6T4E{%5@#C~{`X){r zGnR4-C(R8zq4OQm`CCt&Bfi5TQru~7Xo(M#c9R@HEl5P8xna!pVe)(4b1t1+j`p7% z01eCCW8}t+rQ~pOIof}sKC*x0lE(qG|3rPfY28<$(f*SjgoUp?U2=ufNO7QdPsgW+ z`5ZgZ{*wXF+Q8>8Na{K%4=3$EX-No^+tw%-O(LDN|3rPpBSK%zl)genJ(k(KjGf`Mn?LSc;Z`%K4|H*hdY5&RTang+TpQw*_SW2!!qx~o9<1I(~ zPtLjaBk2c;ACVdU2%s)C#JrDf%P}gLPOXwr?JBCYn)2yws8!9$++V@%dJYD^LUCp+>{@7;Q4!K zH$3IX2=K4NbWeB6j{~V;(he8i$n{v@&PxlE*E-$wP=53P|F#!D&yRUw(qCM7IXsjf z8*dAf46byS^NI3f_ku9_eFoPr`%C$84EVWTdMH2qZx6%0$e!V+{Mcm*ldki^)41lK z6ej)J<*%IIlpjqC!z3JX=~2!oKMrPw$?p(&c;s^9D?ccoc7Q)7D@RO3QazN{Hzu_pcMUbDzgZ zb9~TfjK2cA<5N9pd>nBWINCY?Q)(LuJ!NWvpsrfBPeSf`k|Rd9 z_))qHgO);QyGth@&r!N0?U^j^ci81gqkP*0T0F@C+;vjAbb!X^mu@tH?0CHE_CfGc zIMi}XWjYBk41Bg1J`--~C7h|?hNpa@=W2EPG-PIg$G>Yd9^-|_ALmiIQMl>+3vWD?IXVkNgsH~=%fzP&=Shs0pN*jL^z0dpE9oo( z^ni9B`2|os?iVR9 z>6{Q=-v3EBz{($<2WWf8i`T!)M{+%X(Mz#-Pre)PQ#aAOQM@0_1grow0SfUxs_CLZ#`ChDv9?3HzQ<$?+4IuZK$K-+(OI1BQI6z3IMZSHi^%`WS33$ z^2??Y;8IawC<#?wvJ<@{=raGtipj#03%3iunO?}?H+PsKY80LQi{sS$ACJ5iFVmP|o$ zcY#*XE14_+E$VX9;z?3XKJMIHK1qsNGD$iM`+ zKqx#=r$d1qF+@w2KgLM0GjPYxOx%euE1LNDQ*j;oh-;`!;6Y*?pK#`;A86fED4bbQ zV2Yoeb2(|6{JmV%QM8)?!}oMj6-)#VS62iC1Yi-D&Ne4iUp-%?z*i~oRSJBS0$-)T zS1IsS3Vf9UU!}lTDezSa_)3A!k7=%nc@#{VOOQ$PIWlRgMJCO=$;9$8Hv<)uwwe%L zrh*J}!CI$BPzjG?$291mT4k$@FW$ZvpQEuv}vL5b!5JFW?;DJfIIS z02l&X1~>tJQ(&SoBHzl&oLXvs}wnQ}7V_i1JEz{I= z>NDM6Q?hyAXMb1HZ4}S_0JCRG%Pv{R854KmWF*DEJ{6I!Ao3;7k>}jcX44beiR~yr zJ@34aRnjx^l8hh@kEhRc@5B9IHN8q`)l|boI5i!pk03nt1!Pj2PNt}sl44pFlW6pi zJUt{&56RO*^7M%O7kQzWR>kDXVJAH#Lwcw`B0W?-2uJ-D=^>m5p#Dq(5U&-$!@z$O zyFw!r$q*mOlbn0F$SnehPXZ7hfxDbHKhfy%#Yg(w!%5+`0(d!xAjRunm6sHGD@;{h zjT41|?B405#!KY~%a;!CmkA%~{q8h$J4Q_j=|+L##+Ul3)s_&S=3kNNyTI#{T5hMq ztwBnvZpH@r`mXAp4!0j~-{kU+ooPyabPu7dQ;jdDoEhYNl&ikzt(p%dVDjoPK zlag-LN#Ot;U^XoKxHADIf7eOkTpj1{f++wu0=`|a_uZ_MUjFIcKWa3_ zf&%C*W+E?%;4RNyU<@b_0Hgx^fs??O2S7HkO;usiic0MJS{WvF0%G8m5F6wlBn1BgRw0BOOM&lH;S|@J#bkZe5Yt_r#Y96LjPU);i8alIu z`AbFP&B@%PF*$d`qO4o`M@lZdfhy zyV{g%%V_@O%~Mu}vi4+>&|fegPs|0hf!YCr%{LqZtxA7`%M7ymjPVek(N{$-?#BqQ;Qd&uSgurL-% zlg5AHDf!fsnZ~j1kLnihma$?h^-hebCXIQ&%#;6?%w=5X$?YyrJmjVUT7EX#NlZ-b zG`am3o-dOha#^4|CisnYI3l*%LRS*v`0!OY@ifj?xso|ot*dt{Al_w4;W4j5;Tyx} zUM|#&;ppxhoGBa^$Gw!x+tSq!u3m$JUR^;)A*-Y>l>+C!fi-}QI?0_`dIa-Y;Lklb zSsDQd*i)6hWJy**Ve#_xg1d3KC45PwTMMbym7+#euck0Dg(*M1ApNd!xq{j9(z?}R z*nmVW4zWSsPkiwx*MX4Rr7%ql1_B&_w}qqiycRVM3iUP<^lA<8Msx$ zQiscyc^jt>)^j9F^>~PlHY*yf0f3O5)=O6W@kHWJz4fxw#y#NcG+XuE_*E7Wsk|eB)xzuC3{xU!iDKemt-mSWprx| z+4C}RBOD%X&$>I)WnXyD(z^>~e1W-a%^EuX`lg$1qD(=7q#I+*xJ{9cDn_ebOu3yv z`Hd@G*U}o4Tma-V$?2%%d18FR+IY1F1k<&ibeByqj&MewLbq>nC*!B#Ax^?1R=89@u_(xZQX3;%KbR;?agc^p^ zv{zS`&qS~cED=G-G?(GZ9@lkGD8i(NN`Ut&Mr3h~fK0OBw(*tbI$1v$myeQ+;wX{fjQ8|A5kcJHLF#1p-J=K|u3X#(3hL6; z@`2YCh`UEv<$uszx7u9ePQ?XVb!*CzW4J`nT?k&uC$EbeDsV9^ zu0&Xa+ftE$7`Par^J;WHzM=aNMdi-J3VzipzakOm*2}F5-Bk#6rRC(gxk3&nZ_asH zt1Vx^ZW3|&JwK+s3=I&Dn#X03xCxCHTq-R$iCOBkT)cd(Q`1E*3XCp|Roc(Q95P9bH=9*+z>M*+Oth`iCFO-AK>h;wX=8T8$GuN$Q`3rGB%sMm6uLBld zQ!2RhrPoxiT)hf6yfTIgCHtSBnT{(?Rj)^R^K-K^ajT9>;9&*Mo!O<=3s1a-c^P+A zua*5EJMMd{&cOw5MB|Zl1(4!_bWo6Ms;Y5`t(60(1cO1G)jn0H*+F0eyfGfbNUSrYL|2NFw`{%cfyKl=HI50LTQa0Bi*80_3w1 zQw5*~unDjOup7_`=mzuvP6Ey;a2_VpjF@5oNq|g1KA;3ZJQl@N`5WPO01hblV=zxE zcH%h?`v71B;IADq34ka-EMPjoEVqlbH8pgzH*X5e6>G(mRcqy8RW&ZwO%k!c58VQp zbUOpTDu@fl@nOb^w?n0Xqd1QRkO9a6Gyo0)1_3GWgi5pC#W%%(9|BGRLVgKez{7wp zz&`*t{|es*0~jr=&>t;)(L#s@z<=PtN}Rfy}Ue$p@mH)M_efS~^K@eXd{C|+4wO+6k) zbNK!NHwWMfs|~n}xCV)a8v+zdX}xU0jbc1GD{x(rYI#V$xwx*r`XO9uTxqFaASZQQ zWnKLOp6IGnS(!qj93dZNlX3-j-NEO&O58(R%7cUp$||`<5mE8nNntH4D(1I}6lbI_ zyc72-kru)&FIZSukXM{uSeSJ;;c)p9?uc2Gp37a_oteAHgATEbj3k~;!MNJ3*iw%q zD5l%fR?Fc`o;@$cIL}D0n%EudYQ*GQV~Y*_xUgac!~3WO<9L>h7%EEtKcq){4%PE-g`SjB9` zlH}q~sJM+}P^OJ36(aTRu+4_evJwTJ+mL*UZLL|c@p26!PlE{>zYxsO{roiaqh*@F z5agxsWNvqMsCTDuQtdii#9@92gIQjWxqdg^ zb*tB|tF6UlP38)b_|}|o>yTsU|1le)$R(l_&cj#?YH&5RiA3}@u!=E z_#k+#e9g{Ub4?}B1J7`}cyR%Zayt*E5bNbMgbupX%spQ2{1}t2#du2Op)pWAD65f2 zJhTwz7sq(Y7jD2cIu#FK(u$EgUsd4Dm;>PoA!=mgu_k$p$5S?+0yZk+iXlo6ZW7{Y z#;MRzhT*cM3UP8{hihzn@+j15c=_!}V|lXFi*YYU;xKf@jX5`l#Q)5qeR?+o6xY>!yj2aW@ z7PAYovThRZCbW_)+|LAz<3>woG3HS;NG`5kRa?VW;Z{>Lic0=4#+zoOI@M&eTu5=J zI<6lsuC6RzjT?~HuEmT?<|F?V7O#BED6OC}!sng|wKQ+2<#R?g{43Y+2`|5K%RA3W z)`ICV)ti4V%YAX(wDiAM|IvR{W1>oPBeVqGaiF`N8= zXV6W_w?IL!8(qma4;>_kxb`?=y@ za*Y>rC2MYeQ*MbPx3=p`2IuDx4if(oRC^-Gcri%Y5|saRP{|8HwXey+;eK50=Uwjq z2f5;3bB$l*N>Xlqer`!gZf$L@)tcMXlm^e?c=InI{reHt2&_E<@BjT! zDG#QIcf_eb2$fC(ihw)T#H1s8@hxOWxKvw)_r-hgF256J$v!z*+J(IZc`cKrP2fv? z5#K}Z36&&#|Jd!oUIfTw;yp~~&dJj0brep#uSVE*RYBh_dWrzKfMg;4zmPi&ta55#KY+fLmdy-GH$0GhHR4{hO^UyXm5%g0q>Ah+Mn!t&GJm|>>IGwa>%-W6p4wTfa`zXZ>!gz3VE+rC5xC=!8-Uz#z-~YzpdN5=8OlV2WTJh} zLJ{_mqE9#j9Ocmj*gJsR0hkXk0O|pKpq&OB0jz+#6Xp)UCO{S7*LRhLA4i!!2wD$7 zw?3Ui&fj!6XFCAB4ECvF-;d>9v=R47rbd|lFztZTD3g_y*h2!l?tTgFeRp0a>=vSN z`Zw5F;EezZBNEx43dS+G4*+%p>er)wLeK86OQr&BI2~4acLU!9*a*l2lmJozBESOJ z0sc(zJAQ;SR^UF5IK;q=1^ye@*E$0CS-`;8B-2^w7eFgP9m$0INdf+VHXppxz^em| z;&6V296vP<-EdR9TVPV0YhaF`ZS00z6l4aVqXM|pz#ypvxLZ)R8-Eoh%>ivc+;)Hk zfPT;_0eAX`ST}_GZTRUAcRuVdLgqBWbXN$@8iM&9n9YD)u+u$2R+y0p?+TbJVXgrr z!Tv*-4nP#_0qFNT(e`uzb_4nl-y<-)0QJSl3;09np96bQRFHHA<}rW+^!+gN0WE+{ zXsfIr;~j(ZvU8IT=@$ZhFvEjJOvA8e!dw9m1mpqClfZ3+c@XBDh}U1LU$*!4SkQ_9 zXMc(FqhQ+67w#s0n1z6qv^Cf1{8`Cmw5x!U3DAr87tBgcRV+Z-g)(BQ2W=z33h28o zp!>{q0jvr31Ly;j@V=l0b_d`LU_Sxy2VkB8oC6F4ba+of`%+S&KL=0&IB5uyYGBp_ zHlcopVQ<%N!UIMC^d6-V`lrLp1mpt>0kwdQfJQ(UU_am(;56Vopc693@t&m!>2V6? z830P5NdoLfTU`A1%$FT78v#~iYZJ^JfEK_m0OI^Tz&{Xm41X}NgJG2Mmt)B^F{cSF zR6Xn)0Z1sFbI9r3fp*aW*bV3e)DrK9(B%9X01VD6PChVXT56S{+xg)p;z1t&Y|j;^ zmGfV5+Bt6N1uph?R8j=;RU2b{xmtGRTNsvaCgc^YN!XO}KJcc(MS>AdJf*T}lSPoZTc zgQoe23q#qP1K1C|KXCBtlM1-m{v-Y(0!RCrn$V|&i%1VZS6rYp40G5BewaxBQTGK} ziSTY3jqXAp(1f=8)GYKDH>8_7VW&Px2fkS11;F*&l*q-Yg0=^co zaXNTDlkNF$zT5cO>EWp{@Hy+TVBKY+WP5wH>;5wSwOE zqmeT@M$C{;esN^4U;ClZ^gSc-Q4EPY7%#+ijKpi%GVSEe6Bt|k{76O=i=Tv^eqdTW z7~+>QDgIB<4PP9^tnE#0>@4%WZ1ML;N`Ekt5dbDj^qh%^U3@l+YaB`6NtzzoIfB*w z8S%P!fB0aD{?o*`CwU4?rc}{xnW8;o+mu5OeS4&GN@nY0qL^o}_q?NyPdI_{q`Uv1l{)`@!0xdwxo+iZ|$LAUMzl=h|arkM`KD2OT%Zu90`<#KV0*^ekWsm0d zZ1=pr33=Vy7K#DZXkIVid3{*U>)Xc7>t#HzUk{%sVjEX_%1CL-NP#~tV6sHNt!8&P zY2q0j5_f}Qk8X>IOH}P;p%2X*i8JuH$yvWRZUni%`3}|)z;iz)BHQSd_t$#m{T5uc z9n$8Q+MCR?elpMc7-W4$>m<_bmi1HMEGTC^@g1@sL$B z-d(nKX*VSA^~!jZ5@ft*zE5kPq2zlei~H;{q&l>{XOZs-Kcsv=cln_Y32E2HeM~0L z`l89Aq2WF`>yN%ft&E*g4;la4%gFfbSDi$M%w)v&visbKf=%+1Zq%7VNQ$x@7a}yKg#Y$S(;fG)o^`D z%~+9~-ca7a2h}Or$k&{5Q1m9Y&v+fkTziZ6aFl(a-dXt@48y;X2 z%0(e2_EPg>msy0w?5#8BQQNWg#XyYd$nyTtAU3&tdQuExo*j>Z3*LGcFSRIJcOqTM z{JC(4`BTOYdY*eX(4X|28N*eSL-`d)Y2IZf5F4A%@~$Xtm{2iX|GZ=|iwn=ey8%aCFf%eeS$j9GNQfhP!x8 zgpRKYRQeFH$rAhd(<#AmX@s|b9_Y`K>f;^k>C}mFa|qQCAI^d#tJo}x{)&uUd*~L< zZLr!4kK)7Fa}7r|Y}zwTO#|BtBAa$P&g^u2KE-d}6m45X0ZA*dqeE| z?m(?umUD#yI}6@7c5IJ`d@my6cR$f?{y^zh1zkfy)V_!aK?n?Fry9B&9mh{OS{6(@ z*3>d-&x_ly@q1=ZTR~K}b)YRG>b2AldUzY1WNlb#-PUcTI8gPoCqetRtycT>P$mRr z2eY1rrWYOEdmPWlB=yYe?wPcuGrrs2ZS5Xto2s=oUjKq&lB2O3{L^-BFPOAFV$y4A z$IuaO9ELpQX(eh_3egA#pUBBF9b7xrP)Cq><$_Q<5ci1(32vb_}zKBRD zUVP+Iwm++C=(^2OGTV_ld%2%}+8bS61B-6^RPf{Bi4^q0RL671zv>^?3)elWKe~yf zHgrAfFz$4urWsQLh9X7b*IQ;!%h66tZRm+Y@DPHB4LNCxU%rHac7CRqo0giE-g#+} z-~9BKE-iX&Zdofc&YfhOE0(@^XEjcWXW8I6tcj@rG{s==4lr8rY;fBKeJ>iR+ zFCj?zd&F+z00Q=+LAZ8vAkum9wo8uZMb0Bqm{saE!r3;5=GHmdHV1P!EGR9hX@{ry z8>N7EcI%=a84lzhZ;m`LVeOodV_ysFzVC_7c8WT@m1Cb?f62&|=V^%r`Ds9SH* zI_?k=&d2?PYg4B9e{F)X__6L=H0cjsDoT^G!i|(fBij~P<}M$YJ=rqDQ(d`BotLhh zwB)6ijB~^^q|&V|D^k;D_J2+Ib&ghANI6h2oto@|ipllbjJKj{D+pIKBme&Cm6Imd zW^&i`l$V+D7HT)srXQUq*FnxQBjI#(e?Z7=#3TDN)Z4xK6i3*tF?XHbmYTL4dGIag zv^P+8P)vl#MQ>;p1REWe=xu*YO^#k0uq!l2D^L$swA*-#2s5Q3I9l(Ysuid=%y~|n zPRPXPuIWqFrr$`VHKRPCNGm)>)OI8V%v_`>jG`T~hO`}<&rubp_Ay6WlmSxeexq^s zj9UUS+SumTnBWIg+HQk3Ig}KpZ3purzoep!%1M4g!o3+)+Je2#{Mi)KqUWWhLtB)3Xz(I=F{^KB_%D{ilacn=-jxY+3v>dBJOYvPT;#7La+Jy{d+pnkK|b^e z3EsQDD7EzCizQ3LyO%;^QR;*Xx93+)%3n5V`BNE16se8`N5Rsh;QT$^XkLiT`Oy>8dG!!dpZG1}$xKg`DD>evqoA|i!rpZ+f`+HoYoIWScv2$K-F zl?H8rgT{<24gS-1qNQ($h^W$T`N@RnrGH1C!Q1Wn=QsW)e>tTtrK*qsOZ`*%%Xu{Qb zjO|hH`n~D*)O5D54Vd0NC=CUzY`I@rm3A-1c+|W0C*euKk7&dNUuK63lRUhtf8OPj z!@AsW5{f0Idd?HEA=qC7+r3W&e&SqSt`lPSp_w`BWU&Fu{X%&#M?Dd~z1%O)uHCqS zeCZIT)mBpEt2>m?*q^GM9iCq##~)?yq_Eyga3=&;yUUX&+G3OZZYZyo>p3 zGLps@4$J(l^L37`Pe7H}WwCaMwxx;))vsQS=Eh*9t|e$Rhwiy};+~7PeByB7+rMz` z+Ba*~3n_t{X>DmipLxXjLdsA!S$i)#XU-dWq5nfi3R$m`HvZ! zEYsdNR^8CE+q&zq#-P0+uQy;azwF!>duRwma?Q6~wB15QJtfhA-*^N4rc@`Ay(&=@ zqt3)nG#aBY+{|z|g^bo4F1~WZ#lyQ{w2*{cd>6&TDPIRY=Xh9^UekFx#)mY1i4_BhiBg zZ12kM=3}7hZ9kV?f-Vs2?6w|-_BLpfZATPZOdyJxpxcZglDxzaZJ1ztQ(=7_tOd58 zkgG+Y|M8zlNLtYq%xofUYCvnP-LA*U~hCu%~mU?!_2EVY2NW z-k!rCb(Gq*6E6)PdTDr{9lDPwVu6PrP6``&PeE;YvXZJw|_6KtCZZ`V<}HjuSNXR{$$ufs1~ zNb%-J5#w;%ql(jpfhJGa4YFYKdY-OpWtWn!bqZ|_PuJB7ZA`j0TZVgrnk$Li67+P6 z_ULb%%`3@uE(kxvQ$Crh4Lso-Lc{zkXLGf}7OM?B=4@U%ygi65`}u_CLK(fK+T2_~ z)>A>vi-({7{&o0;YkML)ao6zEZ-zJDr8t}ONb=xMnit7}C$d4-H!qZ3LJ*aU<_v{q z0&Q~h?FwxQFBd^nE~cRI5rUqM(FVTg?2bP?YnBl6LW)Mv&BHuMuCGbM?cdcm&mL|_ zL}}Mp8@jhUG+V$Dr#Wt4;a;-VGuB#`xS5wc4NrZ~h+RA`}~O^(wmw5dD} z!4!w76o=rr2}C)dJ-96{XxN}#_ONDIB6}xg;)$@~Lt!Y7=UM}YZ9!BXMSHg}Wy^d- z;ay$R6Wu~&+`v#u1{GknIL5Kz4y_}t!Lh5&(b(|J6McIojwBw-jk_|mCFO?KUl$@@ zxJ@JY-57FfTENp!T=Uw2smI=0wuB}34$YkH|9Hq|EwlY;C{TmSU^_Du_u&vUZ`G>0 zTTcxod{58&rPkjJ_15c?|1y+vJzMq!YdtY!ejF66S-eLwIexO4>Sx^D?bz35`~6Ul zPS88r8f>o*As+7rH#jtlW@{T9w4NkPS@s>a>>KQrBSY`Jfw((nZRK|UyDRv_wxL7YhW53tYTY_ydxTS-b^CpW z+vVS#+%EsNkiGSrLkV{Wv_3jydy<@j{(a3Cdf{3M!l8$UUU_(^_2HrR9r_tlC!VMu zI#df^cC^+G*-D7H_gQ^=XgIHbwk?z$c3pIi)Amj7hy42}xAR}DQzq01v|1S=%fx+S zNcjOiFs)jI&d{b*%ONbdu!dq7k9WpDp)!YNFDXxs-VbD$} zOE7QI#uX2}t9>)LwRp(3l6Vp}Yq@*Hkgc5D?N`Fg8&I?5zwy7SQ8Tc zS{Dx`Y-bZbT^x7M5Z*mBGa*XCY!zkMRoCL~0HybPY~#nqJv1bAqht=zE0OOqRRrVZ z$C)=*>--_xEbQ_tn~ChU=|ku^qEB71%_nE?ujTc~c|+)w<_%fn8+hH0n>%FJ zuFzT=%H!q?VNH{&HH`<%yC=pOhs0SNLFt?{l<4XPZ8yLHPT-B7`571Z3tHZ%ijQ?Q zCk$a-5ks#S_&F{9`G!wrzUSj7p15x4&~-!m9Hp(-4cU$lf}Vcu&|d$9*?QYGLm00i z;w?I38YNAd4){g-V{K^kCR2u_X|L&neUfVDVU+zo_Nw5YtS3UQADXlb2TKl-U1~K- z_8-C`ev%$6n7h&-VyhObyXpD~724jtSmQ-JglWhddVxcBn#>Hyc0)w#@L;b&e{=%1 zLw4E{1|-pMTN%*TMGNc+*4ECCw?{DHdc-`XfI+buY=c%512*FQ!o}DFGO~2OU$w~?TO~WL(PNxo}1s=G-ykukl2H)HVd;~zvWqf zd(eccsV(;|d+~}8v)SJ*213kH%3DE)s6?mw8?+r-p@!nJku+puUD-P-5h1N>2NSN* zBMqAv-eI{#3(Z^mfzZ|m2NS08n7OC3^)o-~>{I`}h z=4?M4v%PA9%d_agMBUaptR|k)wnX&k+67q97E>NF4FycyoUB=kG&WsQcGx}EhZx4o{VY;>Aod+F#^ub^A`}Cyns`BX5NW zTU74Z}hkQ;DX$*U|O{-XF}_<7tF_mGYu1)pSiGY zXPPoCT+rA2G@JsxuX=G5_r!&5TM46kVSA)&I`}>EWTy_@4B8`GqwG>s!1is$H;jT> zuGlsc74zapFUW6z>{@xNfveXC*`WP#`~-~qHd3kLWkarWajQw#ppD)>A+Cn3@o1Uf z3ygc z%g!t4Xpw6zypV8Quq^?lLuV^;g{S>5azAJul+Cz1E+BtXBr|B6_=h1Vk-Q8-gpgcM zt(ge{o3UPSrhVd`vUz(@CSMGkwsg@gf7?63HcJjRV}J4k*RnGc^qPnh&WJ-&P&zx2 z%l_;a6vy`a1x;j!au1h=y;m9@FfEk*%}-l8i6nvocHtTtzw~P^F#m9NHd3f1e>9p4 zI(Ez`lu(n9uPu#YC;ftwHIpu|KS!?8JXs!=bxo))4i4Q!wm(vr9FvZw8a(0nZbqZO zz&?)D2p1ArT6nI=KJ&v>C5_#hF9rl$n<6kOM@(}`c7;o37B?^;iVh(%jTVREJ|{=2 zHu^cI^yf&;a!d)e8(IJA9Ic!DupxKjvjpB^sUhH)p1X+m(qTo_$1 ziS4(9?|beXsIlP*G2wFMSfCaBg&1+u6IRiJ9$*tzT6-VTCY*KJ?iy%5Lhn-0u&ZSo zu6>4xxSj#=B^sc%RYl-8W0Y=7cN6Fn8U9HD+V(`^kN4(}OC$aqZQRj;nVbF+m#Vnl zg6kh~a~0Rm$Ynm{#0=pbD&7gdbhdXpF}^;+UGF;QYtvsN-o(*a;C?UnD_-s&dAVQm za(8&S+Xwdgn}6$!f59orgLaH{-F!qm)4vavgp*F&t^q4&X{(^P$5$|O_{8)US>Mbj zLh;tgyc&s|uv$wC>unC!zDg?u_f~3!sl7GYKx_&_eqtnzLT76nkQXqOQFQ!Y6Vil) zkMOF7c-j|I8=a8pbhN#PI%xgW??&A#HuC5|NY_r|E8iM`Y47fSed24WAK5kzj1Ju6 zHV_vEmWf8HT+pS~F;q@l9VILE8Nk1ZcG|W^Maceg+=HIDS6=OhXnUjNFf}f^cWZYJuCAnm{DhW`)Ozu7Cp;F?h`utRQb4~-!8Z%>4)PgtN!hRs`(oAKcl{}a+h0MdaKF&)?NjXuuW}pLg^Ie5kKv(LELYMM`S)o*Pi4+yZg;k7 z2HN*HZJL2C+a|WMf!-ILaaa0h1_#AEGzc+`MK*rU{jo>HUF=7Xz{g;Zfd;+UG)9rU z;#?N2Inm#LsJ}n&+1CDkTN(M$7Vn?%uyffCjqxo}(062*A9Z%#_tE+O6QB0y9ed?3 z{q6I@5H}Fotr&`Y^hy7TkNfk^zw&W^LK-bMEBYIrJ7+9vFs8OqQVlteT{`i8|Dg~1 zSKQzFe!ne8@u$6x{K|^Irdnll?0iU-?yk!kn;o1Bj6D2>J7F|A}|| zS9HGe^Zxb})gS2Y{f9I9J_>X1D!C7n=Z&{Ugr9h;|Il0gNuRa8)o)884{e9~QSVSj zHjcch@6h#53z;!hYi41|2m4WPQvK53AT!6`_Bxq%-LW1)|E~T`z3sLB4qd`W!F&DB z_%Yk7GO;q|Wtp1X)!%kKOZYH2`x9QrZF~E-XeXZN>_4=(f1l%l*3N#LK)$nviPm`0 z_F}*M3m-<`N5r*rrCO__*D9Xfc+tAmX#HV;xTjmt3DX?kc>D<`U)gOcJFm!8btJvhJ|d|$w6NCq7ko2fGWf#9;OtoDVbZ!Fc<56*NK=l4?Ber zOj`EkvXP!cgU(kL_c#C8`Ccov(+x@NH60B_uyFi4-CtqZm&k0hFIc}Lr<(1&6OzY@ zUesWW+@Wdyi&KaJ(*b;m}a$=vV{Lb+uMLeRjqyFYd#rZ)Im`RDEDkYk+Ar% zL{n$aK!#==AT=~S2T07yI%-%}R4aog75NQrJ^j!=3~uYAMRt^_9V;EGOQW08rC_D%;n0Qjyz)GKi`He-~7^|BgB=G2A@zs%UK# zwNpyBN*EDs8dmR66h6sW7yZueo7$VaZYExF#jog|f5&Tv273W%{j3(({~Z@u^&hRc zy78WX^s`c0sUy=r%^sJ2Mk+c(HMLGdS$-P1Cug}vCKX-ou>_Z>gP1zP?JFE?2*hmU@_1;F~gCqarJ9MURQn>yX6ja(Z>F z*vv3m4J*-#S1C>`c)q(jPrOgAFR7aNE=m8rO_e@3nf5|P`&sRdmn$4`dF96?l&S(Z zP!C8rGTc0;375SG#9!{!hbO7_>k}fPsUJ|W_)$`Vip|=^;-h6v1l0?4t+^#sQ&?jf z%klzf1I8N^ymhgQPewrVSL2ueSWxc_AtYS z+hcEfaU;xnNxx(DzS|KHd^SeA#3l(R)mB?AcXzziX5^w>Rz6~p-O4`_j(^Fwd;O6% z9iRsS0Ho1? zJ-<@YD|B#QdpmPf#E02G-40Hj^B6y!*{0&0LegJD8diUrUUN=zpOb8VV@^GL!){$= zw4R7y+ataUy?g7JfX3(`#7}cf%mB_0xXl_}=;evToDt!+ZMYA%G(6R4^+*k9cB!486({ zNu?HctzV71I zF*OPGek_1*RwOUJjT;2ub74B0aQ{Yw4>%f6cTg&HHCH5bo7I~PWtS!N0^7GZDk=0z zs?ej!Nr|q^D^>3?Y)=t>@4riQ=2l6VO7(myHvRNjEXx2OUkqhju|xNKf!?OXR=d@j zg}e;gZdVwuP^1M)dyui)r=tRdA4yW-8^<~Y{ATw^X1R%GYH#pUNU&ct<&8JN^GCI+R==CT%;akV2Wm%~K#@-*rp z`1+9Q+QN)5=%1~gslc_U9LMu^^)aRWL>P}bu?Fq`iQ+a&1xrAku%d2^gc|$`WU@hz z^oZ9aWCw0IV@taHJ|XBoEB>0yhFD-VW9C>src~K zVhhusosxpDsCc6N3|c$UoKsAo*;XeEFt&hpfoMyoOklA}BAo%LnMgVL_psP{BAo>3 zIFT|A#j%O9$L~ODAQG>Qg^W)MzX_y$L>fG06l2DJz_^8s%KQkV&-fM1RTS!43tPP% z3tvf}fjPmU;jCDp+PFQX=yTkNL6gjH7jim-ae8X&ZUVs=jT?B_ty^| z*>J}cEz()+aOnAsAwk7uoIYV=h(C20dJBTbeD|XBjl1BFE;Hs`emojYfmbS6Nd!9Z zLf#dZU@MC6g#7Np#M-!cBNyRX!=rCQP10A4ONy~66}(b;({;k<*W-9wQB)^qiZA4A zIioR-@Asf@7?*UHO{wISs$1M&Mg$l^;u0NPL~WcYp5t%v0#2~^3jU{~e^>;Re0s8X zG1NR@IWQ4;0Y3q13Xlpkzlv`Kp;BIOd9!N$;yWc{hh)AacO*)qS6b1920C78Z1+*f zpoSs7mCU16H`QPI%s=~7aKbrfY=3{h8hs%qKiCJQ^QY})Vf^+N7TC_h^NX506Ca$3 zjC|sqLHa;^l9BF_%qOMnlahX=Uiper3lRxc-fS%lj)_??J{a1V7+$HPuLJn9m>0A( zs_+6#9dSfeU8k(^VvdzW2eIBj3>LRj;VtRDHTdpO0EZ8MGbqnMhw>Z~m@F zY`9Sz$?8MY&JfMn5M@({s#cd?JbKPqGix#{>di{0S%tRV?2m<5O^0NOe4KrSA*fl+ ztcejd?KDQ|pPJ--e$5~nsg*bfb8WKY%s7mvxU9``-nx6St+e90+!x$ov3e&L{rHq{*|f?mn+}D*^w3Sap|YvpE(oTFZ`uu%P5pKOF#YMK zou6##w^PBCcGHeVcKrv{YaZXYcfh-WG}i$|H%9la&X&xIlNEe2nhm>zdgiNRT(LP^ z_i@2p`l}n04CoGxff8oCn~Kp`wOSVbl3urQLXhpS7Z>wTo(mE*w!_q#(RZ$~`5JBn zl^y19J-vEdf+`M}z$@?TcvvcoUiq%l_?xtU&{-u54=?2Mo?n|}Eks8V&=ipHuCD1p z`gCXHp1`Jn7}<0Pyz+lCGzGGMO~R7$U;EXY-a9*$h1qFl0G>~PXEnw#9e_T+riaP} z6AVl*^eF4Fy|^;dKL%c=S}%`*a?2^8G~Zjs;urTmT~@22wuOUZ_E8a76^aqp7LPa2=D*>q>8lCAk<&B#tn zb}ei{-JDHDygz%I=ac=kQIN1{=lH|d*K8~;!aP<#d(CC4=6_-(Mci%|*2?)s^_yZ>ml3f-e0o8e-4!z`ZI%ly z5VR(GpD3PU;2$td`KM$TKVEp@UEP>LhknKOZf>l4u z4~h;QBg?9WJb|&OYjHp#kb?G^kMX||s-t$eaIZqKv7|Xix76i&aNyYO|;P5yu zDR;cPS;>;z=s(dvI5SwB&74-4mz9+luKd`37Y$SfzTs;8^j_paOa!>2y1xuV)IC9b zgBRCPL0^!lfg5PzL< zYBa?IJ`O+1W=F715ryx#a0wkLNvm{Wu7O?r@O}FLaTfKeA;`~T< zM!eDK*h%CA%0shQonQC^j%}{aJ98b2^V}~<`v>~6XQ`QUy1Az8VP~_0n+LHb7~KJ-cFLv=onEz>2qK-Qw* z5CZI%-l1T%5!HKKNQ-mcpO?=2i*;`V_d?#<2bMafe6npgTN<(W1ta%@>xF+QwFzvg zBk+?^%0qWEq!lsO4yZ#&TqzQp_f>s0Z!Lc4T4)~;gJ+s`VD87x2&W?7o7b4h#h_VUN zi|GaC(eYD_r9n?(SrTzdgMDc69x4KAQ^va`eOQK)Rbij{^2hfp^A}2o=3-u#K3dY} zpzFE}(h^DgxHSEVPey6D7tFJ+bdf*w^?dzR4ww0qm+gMW*KYI;1n85|xE@S@*__>S zjXs{M^=J2$;?u6M?f5E8C)u_8Rkr9kRSLvUUFgg({(+$ZRf>0&`qU|x5OI>WNulN) zS==d(kBDw;%+rVK?{qqzM*Zd$TC&w3*)Be)v5C{i`kd_7`y7C=G3XP*Rf7cZC-zbz z#m?Rp7m;msIyA4}H_A$M_@ocyQk~dEt5izUUGSTRK1Pi>?KA*siCWWZKHu|70QzYZ z7E-qMxcRb_ep$*sFHIRi!>YMc%22bl@1%D~*=Ho&GeF+SEA@q%Z)Y*gn=txj|5L)| z*~k#;kL()1g_EG#qL|el)e|Bf?YX&XiCQeV&qy_Aq&C$lC8$xmr1&p;!;^Rw8dAWQ_5saX&bkoFf%PgKSfHYJexwZw=ADCOz9dsonu&aTl9;i75r zI9h{$d=!i0De0p%2~!w&A2yR^I9NssYx!sI;%!{+%e{pt-!hhwt;)$(FU{8Up8%$7 z+cPysU&qnn8~*94_DW5Y1Dk9Cjr+Mt-gK$0LK9W#KP+^xJ^;&lCSGr|uBpcTharJs z+vf#{zqOTM5^-VU(8=lDZE16=mk(XMI5NEZ(bBQmU2U1#u-6N;{qbbCwPih3jU}Uf znAIAIuPkN{6WiO6BK@#K3Z~cQBaijNX3f&2x3pzy^6^Q)V;|uJ{X982`qWa5T0cyy zK)%e%?VUA?rJrhB8igYG&ygH&Tc{1c@I+Fi=xMX&SC7{r!o_isX^GtUkgx?lUgD3m zJ*m?AA-?Q}wuA-jrjvvP3a0~?*=4Te{r~vS+A360+5V%(abpyt%WB3)LU`$ z9Q^edJ-Yx(aNlXThmN@Cw#i4_GnWmBFK*MX%6u*@ZQ1#6u5fejIsc9(kU7l}MQL>&@4g20|Y0r|;@6s1^vy{8Dz=_3OyA zb0ZBc|CTfPfc|g?ozENp4PSpHzLMhO+*6axaX8kmQKc_xGjJ@8aZFRlT~OgKeqo#N zi%NJ%E%1eL7DuYukj*u!+3UQ%|E#{|=2?9l`*$?o#Q~X%FGBQOjq1Jxrcn8<8_1NZ zVOFMeNpVcYltbcbhTMO3)(`u~b;bBLp;^T=4&3Y**XBF5;v%rX;OkSzEAkc>Rfyn9Y$&#ok8 z+=Z^B!EqP6R7&L#r7A+HPE=}=mD)#?evd14&nf*^Dg)Lj1K(HbcPR&at{nKaa?npo zLzgn>kR){)2WN_@OOmpq(_e3q_z_A!CAMY_=#HN(da(>Ox1+QiRlK1l6kDD2 z8-`&$;87)TD%7fJf7*-%`nx(>Izz~sgKmIu zA&@KQ=n7;Nzr-ED$tG1B@3@H7xj>39v_ zu?91tb%93sHUYBd1~Xye7fc9Ws1Z0OK&~X@FadLc#lR}yAf~S*8*pqa@slJhMA*!_ z06-e73tS}Ev;_GQ2bJWLu7WJ5WN&gM%DVVXF0zZ*}>$R((odm5A{y}pgtOE%9HUBju9&dkjmasHpUg*j4 z>B5dVzqF6VzWHWn#GW4MA-H{5U@jZFyd8pnYT>ZIegDwpD{sGk!H~q8ULqdspTkXv zupIgdl);W6Ot^i{{QFMBuVzeWJFBowE+lut+d?_i32WodzV+h$lTkIn-vtw%hctzt zEMj+C%np?GcP;<=`LU*IQ%Uuo-wOXKROmd@@vnOWy(W!wRBlG{^~urJocV{tKQMjX z9Xew*xiDa%YUY@>lVKo78QS2EFb>r-c3H~wa7 zh<*CS1u2fntnh7t8I}mFdWo=PQowibFAf$qmC`R#$N($9qyCv#*+05^ zZZgTztp+ZjEWAKNW{+v>>XuIJ(1(THpvNIT#yI$SRyY@Y`{5R8j4*z8!}Fg(O{Cv* zvjmm}uxgWa)m>(sP6*ZDvjlz%fi&2bKdB$S20F6CxGMRAGF4qh!0o{WB^$}CXf!K0Uv

    WEwGSxATmMGtN% z`&QV4y@JPM#nXZZv@F{rmlwM&p?1l}9G%K6F)?EbjNz;DOA3rJX5$FEaTFvInD0?P z?EGn*ccPGC9InnUiNAYXf)eH)HatS-FW8XEWw0<}8j(HwGHM{#Xh?V7){k=|`;B06 z=OC1B5vhYK{g|76Icb(ERr%vWW@2)}oqNN5ZmLI0*-|g# zBQ;d?WTwI=mHTlAt~h`wIlz3QqsV@>k(q!H?vBe2cdGJG1p!hd3$Yj%zDOmnBOdKFRzX{ z6z)5GwIQS(6pj6!!#$fr_~)ycX))`j!sD<_Oqt^3rpxm>EZuR77I)0CI8NuVs*3K1pajR-9_D06pfYYs@sWUb>%cXC^6pZLk5$@@k_ySB7kWG5_sYEm zbWHT+%rCL-o!kf@*wgrvvB#S`R6Zls{WytkHu@t&{{B(A^Zx{@ z6ml{gwLS`EUTi>lP^~U=_97usvRI!dq+7{k_5i`En)ilvFxR zKSlLdNxrunmztg<3>%nY=G6*gTDIPLZFMMFRvglRND4VLdJ-u6IBNA1752oWRnL&sWz8}QtKm9@ zho{zzpWG8dt^Q81hfqH@?PZ=kgAvmmQmQ&o5*Bpcn*QjJ=m+Xm?{nu_KDw!~34=dXg z%D}|g$KSO#e9ibf;dcvv-5ZW#l}RXS_5MpS=VcZn422r5W}lUxl2t@OdNw>!($_+E zhCC^D`Y9C|V?}Z}*;tXf44bhZS=A}7t|rSbL~EG=BBAA%Q?!I=c$2zOb+XxFyqaAR zWigzUS4d9Dm`Ml23URS)2##45fJp~T?lW>Tt2ocf2^g}+wXF~YpV-$ZWQ7nBsgSZ^ z*g=V0VB)Pzu*_k5gQ#HBYEi^7kT+0t3qGwPzK3F`J3({z1v6YJ&FhO5pUkncYNRr$dEJ!A}bP~H(z)^JJh8_1#8+3COJ7{lyFDu;f~PCwf_ zg32+HN zQO<$=*-3YVgWIW?&jaf`3vrKZv`l{)9?wpKut!}~X5&BLEptkUDJ7#d7jB!Rk#6tqh0mDhB6F82sX^L7Ie<_MbAnqvTl|z4?bNUYLB5N z7QuAJL`y*woe?E9M^QOZlKv7&x+N+{5pF~M2JJ7Z3RL80JNVTHxp-C9rlO`eqI7PO;n3;(C(P)K`I22*%t-{ zJk9lhToxgqK`vtZh1N$e{!%oe_QJ8a#X;!^PJZ39mz;B9A@5sY+gp7n225QE%}!q) zg^hI@!7ELh6KZkm)i??SH9P2Md*q&%*YU0ewT-bRi?z;S{_tj;(^Rp;WM)AgG(Wt! zGmI*4(s>T`?`{e=AGzrFER$1Kr?s-ej!SXD7^--65ZrcHu!mBv_4b#!S{-YD*;HpS zy(q7&FmbH;;qhoNd;NINhqCesa{Gq^wT&a-S@p5L_JXH=JT&~06Ie7kY5+0P*q};? zc>c2hf1VU*vy<2K4_N?|MQ5Ka$1K5T8ZEj@HzdteiI#OmKX&-VRC<1js%nGBKHl)$ zh0X-X?3P|&L2MaWz(ewYf@Q6~f}6}k1vxOi<&b$2)jeSpZ_VE|Mqz47ATx!DvD>Ne za?`4k+Gg65L*=f$adMpP6v(86+*a&1Lt3UtT`&u)=fjI8YKl_4?59HZ#S0!gm28(3 z%NhCn<{270ozy%-?<>##>4Lg>M$$O7XVG}iqQ!|YmaNgRBKl5I(a#Os{~Gx6KjPur zCHY732$GwEmCSLh0U!@1Cou9|GeVh-jCRUcI)|4SW?e9zxR5II)S&%H)hMi-W`^k+!xF#MlbxDY%pi2xIW)Dwv9~bIKH{^xc{tmgm66-cqmTZ-H zYZ`nj!cg9fu@AeC3b+~3&(K|_|J_xvwz`(>CDw_(&trxsLKne;XAGW0=;JQbT>$NM zC#m~i+6fI-@4f(O^?g#X>E_Q-4ZLS$E_9!Vpnga5fMuQgoNzemA0JQCbsETq2pr# zDi;9l%LknL0N^rsb^1hA?iwi)%&rp79TGYYBiV!WDLLSvc$Njx&z5r=;n(pzS_i9F zPsu5H;e*gxNzYKvlDc=Ew@X{lh`KQDASUu-CP>3OqXJ~iFvEV_d(z786PG!e2?7Zz zDi!!~16Km7P%=c#qV;FXela=pPgnlZU3vbOZu8(|x~<c)6c!s7_e`vLW!=nNQ#@?}M^Q^fYDu>(%+X>b+7wVX$&a4sGH~;!^alUSn1q z8zEt&pd227=E_1sH>{fS2yJRd@ZtNgELjXmQ;AVyP-<#+P@o%5xpUZAX(!g>i0Kgu z3FcwXeQIClm{kX`Ye88L=aN-j){hQ=OnZ-H9BjRPDVX0q4z)Q;!X1i^ZYUz%pnJ|N z02uh&GVNrEE<``k@`MaW_rwsgpv=U0%f&;+*R%_E8iuqb_8C-B>S*l8`Q^M>Gk_(sXd|ev8-{;FL|;O;w;}fzctf|t*4M?qM4rH@l7(%m|&(S+I`99 z855aeq<4(qhsOwhX!cFr%Rpx;kV$jfY<(PV6~EU`Pc_fD*Gx}ycOji=W_r4P27IR5 zefKeE{-sPF-`oa<$sR&X8QL&Iv=Y7g4!)=^MWKZZS>L0%rgqibOCiB!5>QuN;cDv`RKwS zz$s?B2wXbzjAApr+(#D=0lwQzuYjDgdB)>rdZlN<9rhVZ%`=`L{WarxV9kKXu-<)ewa(@@hD<_J-sobadP7{Cc;KQ0%W^*42&I#s~Iox5v8D?H- zwDX63 z(|+^xmIMzYX=5lm$V`lssIN3*-?()PX2q~MU2{(Pb{_36zj@fVG~$1auuIkb+|72M zsTWcj|63mBU0XZ!H(|2riKjOwcxXu*u2P_BGyR_m#mv#n=|XLy$)1Bf7x=Sb$9bj? zVo`}vOLI)xYUW)=mdK__9+9!z&#&Ho9{Nz363SM09=p9Oi#ha=ZdBaYJwI8K-nI7p z6oq4lLQ0*H9FYOY#}D-G7;r@0JMjH?;I?5Uw$OVc@+~UN1~@7RqH;XM&Ql^!hoM5# zkG8a8!Pw-)9aCLMYR*qrT!$V}nBk8g)1zpsdos9A1IduLr zYaR(V>rU%lxMjl^*% z3#lD7s&8_C6`m;}sWCG;&x11h-{Lr;*6dOlV{UQ>&ONjKe~E*pMyYpgHGX)5Q{MEK zTFeK_dJ`_&#F&C^?ro526NnzE_FOd+2Z@>RzIlTFR6k(=x~fZ$vk~XOjYI1-NrU2G zz!JxR4tX%lC!*>>K`%DtGIv(o9C5ouK-ZYo{wNyCH37#+03NCJUiF1o*J#U;N(k&7<`n3Wg7bKnes9T*KEkk`vzh!4n?IJv9W(f8u+e#o!AD zg!lsv3dZO9)d^xri5H4x+{lKVOS+phd>U@3(cfj6vT<0JBI`Zit64M(kVbpwOODg} zC(DvfsZKT+Ojq;3%agQ4Q#slP+%E}08Ut{B>tHCb?;Z?D?-fbm;{v<&61X;1YuIY? z&P|rEtFQX`!rr2-IAro$y^(^uUMT&fFI&)O4X~X=iX%^&?w9-{?Pj5~mzB@AsIsdC zoU7rnm{i^#=Hw*)IqI!9fy`r(~-HH3SM52Yty{awwrVJikdb?ZfQngQHON zmvgNf0|!pRi))l~vVPmMLC!ew$_oW6Mg6=gdwno}!Y>E5|MNc~)|&m4z&$O@_p?IC zNg*$k{rLGnw-Z2}GW$uv_9Q?^`zHDaHamjjpgTR3JaDSW7! zJN(aJAo9*qvXeRWOcmStPY?}*g@*4p8-D4I+^8PwuatI_0BaMs(}b3}qK6h~n!mx@ z`&WTY5e#~=3MI;dZ<2?Uy-NthCY`L4!mc#li=oBYg0oNg@An8TpufG1=MbKwcs~2; zroa;(I45BWeY^?!r5!5n2Me%{9D^#y5S?Qfm17u_V@QC~NogOG%4C*?KOP1YwxP5u z$B_IiJ-3g^F&kpc2Cc?0{Fq^c#xPQ2h%GRTE-=Jt4DlKRd(5EG7{+Q0<9&uCpF!Vd zNNF=nZZq8NG2G)ZOz{{}?S?eFVXED5Z;oNw+zE4^&oNB*82%q;Zvz)qnf8yLbLN%d zh`fmixXqbya6sH(pqL@uWd=ep-33&HHd}@QQPC9f9c#`|I2i5%x(cj4duEJ8R!XRh zOgDy#e8J~g+}fvFdrCK2D=RfCEA#xm_n8;4=lB2rp5L!eGUwdqe!cGNy6)?~?(4p; zU(7k}vHo(-PId~LX1%w~n&-66tFY#Ktkzq!rsJ!dshvuyC&MPpX*ck%5;4ok z8Jgc?qiyyXvo*N4Gow+7v*E?5g@y8Bk^~JQgFX8c@}gd*HdKktn|f7URQxc0AosbmNO29jQO0Tfs)PF^e5v?Y{EeU|VwX=kSY2?4?jK zP;fcUK1vnWn8i8+><5;^Ir3_D0onP(e&9a>?QNCXyQGr#l{&0IxEYT# zfj`uFuoOBQg2Op0Y-_SGS1vg=G%6;G1(Y(VXP$NArcyHih05bFj)+#iYjM*;bdtegXC_H^q7q>vdoBvl*Y z-sSX5h*FM_`qL9$yVY&a-2p+fO>hL%!w?Or2Y_dV_%~QCjf331D|ezwPZH%bfOD=O zxY3_Pxp)4^e|>uw>OYZ2CJn_mGE)2a;L)Zq7-+5QbAtGQ6=(P&Ae=+5pO*2B(|C7( z6phOom@A}sqG*#b2k6ZoMn?FCar7K9=`%g2S)>th-ux9Fh#)@?gypX@{0lY?Wu3+- zGT{iN2LIPX>3>yoWzz^~;m00(<2LqSf=ccJR6j_K%Ft_;ak`sLf@?5&$cMs#u*-enRaG z+C{3V0jqSfj00?(D>GE1ibAy2s-##LH^%v_bmYA-E6c+-a31_;B&MM{T_zIJUcJfM z&wqEDjE9TEQj3@A|tUHZB>p=|LgZPClujct?#5_t!Q*qL4GVk>1jFo;8v`YB8Gp@^y?=pq~@eI5;YjWRu*T};yn*QiSUa*sl1r5oi` zP2|i(b)j}Ka7IZ}NK1)qw_~rOE2GRsoa?5`iqTn^Dx(^$`HYsxa8(@rL|{h)Tq`e^ zaO|sk>GxlvjJiekYVPkvPFhu6n$*;fwC&;iSC4bw2Ci~RN`3~OnLa!aL9TtJHU#c* zpamDx`XxM~1`M3ZHp9gLoIX@^R#1GBpOD&d74f!$f8Q*vg@h-Z7wg|aNo0u&9C7jS z!Ey*%6|}yUbOA-tpOcl$KpY3d#7ryH5xi!;iBCr*18Sc7ruE0KNl(;Aj&hDhF4c7| z^_6o-=ngsZ52vHuc~a5&RBG0_mh>x#kv|wAWoE+bk(S0XTk6nmKu)6I;`lh@*+5+!XuKU#T~|d zSJ|(>NvGK*`B!Jn(Bd%Mb~J;YEkhl%bgrvO7uZGL}C` z3wT!UQpLZ9<#f=?4e&!HIO}9Ue;8%ED&FbfIhdFX@Q%Uj&Jx-q$N;?VQNH(ae0Qk^ zyiVhyArh&J(3Z=+zk6se-M^P|_lo={myvX`Xu#_35&4hFi%aF<&jpMzw3{66}4aZX)dWw=Yd;} z^c;sSCqCEJ$A(~g(~`cZ1tyBI%y5?ov8SM~jSJtu!q|7C=#upu7j^RL0PlVnrdIq@ z1VUza^LlrM$aj*LeEz@SGumo zpNhW=R;j?s)HJT2n}XwOQz;G1gv5u)vscZ^p=mTkV|?<-#yz}>V5NzR8TscK>oTQ> zi?i^nt|1@m61`Mv&Yuxl5f1Yw))~;|(fl(t27yIpzY!s1W_3iw~sdjgK6GVb0 zDNZ*c`Vntp?s@GHj_8(6S}eu$aEH(6kRGe_xvLfVN*FhG$ILIl)V6VvJ>8x6q`s;U z{-ntM4@FN$);;qVWLvqGRx$uV0Et0(7?At4( zo80(&YV~Aun$0cF+dVm-&fJq|Ir5dbwrHDC z2!l_|y63buGkHp$2J?xUNf~l!^5d*Cpa~Rf_vWi>Wb+QuDYASo-sh)V)X0b0rUh!7 z3twEQEGkf$25sjWdPU2(s4(DAH%?g|F7|0SGVkemd$B&9-%GI*DlayAmonKAI6T4dr z@8PB;>KSFGxLN@mYg~b?Iu)Y-ytIg(Qi!!Y?Ju8Mb&o;GJL@xODod994C45m#Mhq! z-u4y_39wgO2}<;*o+YWjIwwE^BdJ9fKVu&&R?vx4*lTaxVh7mDD^D~yZfHy41rTo7 z;B<03ghi59a?b{rmPnP{w%tQqb4rO}QWD(xEnsH_bN)g~ye2?dLB!45(utuzyC9ef z<8J<@6P-b$%Zd$2XD2~*;I9e2CZ08yY2FX>|$f*eaMX_aM(EWn=;YfsImq$46DLVS7dnF)557AZtil0n%WkVuR-CgK$rpvk-t1!Xen}zuFrze6LSY@2QHuSqVj=9MXMGu$Amf{c z5cVB*?9FZlIf`?ZBI!R38kCwH)>2rfWN;ewm@}uek)eunN=Y(W7BZ8Zl1oIAPI8u+W*Aw?`5|%2 zXvXz_qRx2`o)bqTn-ssR#$OU+P?CCl+!z%7EzVhz_wQnHP6?i0GBA0=;_!Fk#hfLL zXYjY=CBs+4ULfm7kl#KeIwd>BMSW&n^Qf7@mcK+F1p_ndqn~~*D}|D1mC2CIif{&+ zz|JD%Fg0!Fx4kNR)@KhWAdFM|mtxzS^xDl1kBTzACTm$+*RLd(n4x!@dNUDM){-eU zACVf=?bvFxB}McLjH`=X%@ecRZ*60nH8e zkDV_so9)*HLa-B=|^hK$k!jGatJ6LDZN04D+ zykvotQPxG@vo@1}t+gi_+w%uQbr^S6k0VQ8;<;s1uyHyak#_IXzml%iAJFQFpGxrS zcFfV;7a&TLA=&KVp}EGWFt;2izT15Dm3sSwEWDOZO)C7a7&b$^N}wS!me zycf65QgavKuTdrB=Ah3k?uta<9^_)Z(;m@gk0cN|EA261t&+@-@qmF5a;#4GAjUp` z$QJ#x9_+S$7)tec9Lf6obbtc{bFBS)os?rp4~bzI6w91tx{Cx!mQ2_=vxk8$xn}1< z4{=!2&F_Ej9k;t*{83#-f6kmx`WogZe~PA14-xa@v-P_#?pkaDyp6Ia@>K0LZ^aXvo9IB%=F@zc3E9Nze zX0Pq_f4Aij+18IS)2}2rF$p!!Za${-E9Ia_-R-54Fl&^h?}{zLu~=WwTE;JUZRYc# zb8v1E&c=XqQIu}zW4u%dRFQa#JNz9k&R)YMmUO)iI&3?2(HoHzk0~m9%Xu=~bT4JHMl4gp(ua-S&a8&ILjR#_5z2dntw_x5QRsxNI%@>=j{dK` zTBm)|yB9vWI(Ak(q4CfWFMGis3}?klR|mXv!;HM}$HBE34WM#V?izjP!puL1G(VIw zw9mt+DwX>;3}>Uir92zC^v^WQq>KRl_oWoXRLDsdZjNkwC>yy?k5A^ld^fWF$KeiOvoD)`U(n`ojVhMyPL>INYIb3Q6hb^&C%lW~9- z0jRR^E75`dtW!6XKt5RE5NH^_Qxqw$&Q|QZlWF{$D4h#DhjZ#i!oPWni~J;Q#?^dg z2%cVM{G6->3TYu3ilWIo7HwL3_mKA-Jo5WK$@l9NZ8I{@^dQN){Z?!8cQEX@HVr#I zka^!Fu>;y>%>PAiI6;QWm&7(YJVE0;1=U{Nj$<|#XyLF41H13vP z4WzL_%X{X={Do-lS}bhmsmJvM^cVlV9JK!FzX1H26Ob1j_b)a4Nwg`-ZLcTe1Fp~v z{YE!9bYO6Z8@y8INYTGPIq$4!RP^NJ4AJLtPh4r2IU^}uB%NKL)h+rhd(pY*!2+2s2Tn|^+pjpI9@Its*14F{ zEr#c2ih2w4ycqphOwMZE6l}ZGu3ggE)m-_d)b(1Mpt5tH%u)MfiKq3zs;;&lsu{QX z>x#tR-~yqNN~~j)a}aivowB7BH@v7HS8KX<-fDg53UF`Q1l)5mXW_A$XpiE6i4a@k z+l=Ibj#0XxV`SqUJz7Chq^c;K(YTlodm=oi^PR@b)Sed4X*CM9{_2WTw#qY&cAiXz zZ8OZ#khn|Jt88+^vWV2`Zhhc};2MNuO~;NwLOz>8KH#A^_aYoLMYC@v%$PQBN}``q zAw~q2LaNJ2Sn3=NmhXMZnuM%<$&*=w#EleK12)R4mH3%_wl@?A+W60#&9{ z6rv1Yy}3|hsK3PeU&f6Wy-V6@_GAXA{@1DD&RN8 zC_q+9r>K+tPM7n0+RWqlAd6(8pwt=-B{p(|=2F(5n@||n zgLVGf4N4pyJo6al1i6g<0@aFMx+3vD%*<0X+qkhY#5oPV3w9D6Nhx}bO`GI)dp}|2 ztFXO8(Q0|k*KnqWr!vyvQknIIZTIOAOBXK%GOhkPp)(VFgQVjh=-nE3DQ)$390kBW zxmIa^;$NjokD&@S{QS4#GR;AA5-$1Pqth(|M5>ju;emY_493}e&?Uh$cqKUka>*>5 z*MNma7#6wvzQ5kO=ayu5I}{3&+aXx>cT~%%B@x0BElgWd@7C%bPPGufYy*;wlz7Jj zCneu1eUe{Gbh16v{e$E_?bJ3uA0#$k?V5VEU&{>-RplQ_=W+b~|04dE<^gD}a4BU( zzV3-`SIGEUpQuN&D`XBk=sW!h3B*$weN6f?ssFjjIGs(<_)mu>1-_GFlj=jDyvI{h zFqvOZioK&AJWH_Rlsb@|UqjMQs*fBGI0_DaLVCA4V6aBukACqF*W;9ueJb?L_z>5u znXw^kY$I-}sUftn>gN1`X^k*FYd!<_NizNyn+d5xX5mWeNpVs>ZAraZ211L9Ji&PM z3_pwHX-4R!VVcz7tHx}O8vaHk5lv7A_vC{ivH5xR-RkCJBw!4}4Z@gV>`(i_g4Q+h z{kZx{?iP%FEuKH7qmAd!vA;fZ;e8n*V9-h3efVNf)3Y^s3|xgN(Gio|%g@TtaQ8Z-RTj`Cr{ysp%SSdCxg;eb<3xa*joi$E$w|rp z7I4?L4Tr)dci{a7M{aXYsN_@9dE#eH33+?A2E3gc+m`mxwr-gZfd1+D6&cBYA(eoK z#PK2ESm*~}B^d~C07hINh?h@8wZp%?4b#6&1Mq2@;*ye^<~QBnw6bYy)6S;Ork*HoIZ>LUkKG*`l%d!;R0q!auUjtOl^umSo#} zwr&2Tr1=3ja`tV;$Y$nHWH8}@ZRSXe2DfPA#uJT9W}BQV*>;EtWJ_DL&8UypCFuhR z#^fY8EC6u=trl&Qh$L;{PjJhSL~v`~?YK2I(>KhnU;5#~&&9kkF={&dE!@I5!MK01 z&G3Z;Cyw1F(Jy$|-2_&r*-41F?8Dp2-|XjqzRjg(LwnUP#fG#SXHLUCJg_7-1ha&{ z%@$W&-VL!=9n&p0su7gj)D#Ie(yHCo6w+)?Qs>bWKYg37nhuPJkK3k$dBTvGWaJNT z1bDe=+q#+k-}|VdG67>DgN@qeK>*}V>YPB4nI4Oi(y<5PC;enTi*DyJl?TQ1J9TvI z`L_3E@JSvZ_O2g&BsyC&OsfB3EC0jR0D4KpI2KKy_|4Yad0b_bAH8Pzc#W0v#fCL> zOQ0kD`2_V$;CYq#`<*alx66E7ukzoJk^hk7k@zXVY6uIC<-Oa>cIDnamab0l%O4ST z{(aekgmHe^i=p^X;WWBCflqg-$r#@F$rubOKgR#;_A!h-?HhxY^0Bl9@rZ%@=Rlfn z$lT2wKJC)9$2FTfV$og)(`;!9!NYh+HJ2{b)uiLI$UI^@3l1TzW$@higP89*Tz7b} z>Ghi~8O{d>%@L^?j?8G*^x6^6Yq?_!7$r={J+I&7Q?^JnX7QjfbQ;z_Y{c@KPh_2f zs{y3Rx5c~=3imK}coKg(;$`}pH{qf;7I-S;XCq*23ysj*38#4%;VdwDl$a)av)?=8 z$sT?ONp#W)PFpPM4AkhPElyk9Z3$+lZQ6tcS5&h)DK?Pb71hL`-pHgNOLfUc)JZ|k zc{|za=%2al$;KqR@^4~(v{LeZWWLHhNQQ_}=@4<8iNeg!6Gdd^kyA z6=({tuh@i}^WA(XNn6M)jm&3nKH2Yd%XhkY50PEYzt=|JbTY9!I^vwP*v7=|Gf%B$ zrfu!mXN-nCBZp9x7{#CRM<(dR_%=2i!NgkShUoLUGXw%7K-oga;{9k#ztHIZXiMc6Dkq)c z%$bOnu4~O|%Q)6uYm%WKQI=}~#Bg04QClts-kiGdc$c#x+&Lu0cAk61Ba0ROU}d9- z%e!>9qecEJ70y)S6|sSo6*h1U(6bflU`-dhQmyOgXU{rsJZ0 zM4%O$E;jAd24Z}=VgpQ1O%<`uifNKVh$4#}8()Z6m9L9<0NtMx;Ti8!qsAQ9Y_mj? zd9+xYbCP7_DXAz>qtPC!OS1DR8vqw2_=Zj(Q)A;Mr~P3A9$;jf8O?Nk^{qrBZmPnr zf>H7*hkPy1HzXv6{~dtH({P!YF|^vB5HkIp_71nEs04SX{f z8DBFEi8|r2%zk<${Fq*mNXn=GfOXPz2Q# z&TN2M2D!6nR<(&q)wzG4X-cl0A=5o~bLLbvvKp>}w6cr&PzUEnX|?JMFe^F}$uS=?r5}^Jx;BmN;uc zasULb(Ps6bacmuJB8VS%CT$}E&*h_{l;}WgYwu#+gZmLe_C z4-=;`S<5CQ7>l}#bpmWj*xz6DE+*M9)aLS|TElx-Akx?^nVtI4&@EmyhIz@Y+S2u+ ziet7wtp`pZ$??O0o{+4Ku`zH+!G@Ktt8U%j5dSMMB62fX39u=;^_44VbJXYZ;TvMN z_wc9r1nC!BqDfK8;%$}{$oRTCVEFL2BKO&5Y!XoWFpWPT2JYj{=&lX^p5Cp)gIPup z{&j-zI0phAVlwRK$d_uOlc=xD`|<_N zBy#=Oh*)wu1cHOom(uO-dXO&BgqY}j%ev)%2yT6g=>nw!irRwADPg0hHhWKP?ss2y zzrK0wX%%=~^}6NHS7cQ}7vvN~LQla)Qm~>hmBS(wzv{DU;mqz<%cjoGmM3?=>AIVL zZu5?~NWe*I963FlW~_w1oE)EyVJSZqxpkYNQwI=mt_X=AO8^r93f?84M5XNs0;TeK z00lIvv#W~jAuIX_jgFJ&PLgi|d0yBqBh!w+^Vhs{E_%)W@vrN81#(S^Cd@>aTKE9g z6w_sJz_mOoY_xf^w;5wU;C^DW;SXf&sSjxj4cbzE>GPYDiPeDwfwJ*RF|O`)l}8aU z7T8p~IWvwK)>4g8l!ptu7LknH&WWL_OIuftp(iL*nNFANRAd!9>0j;u%-3%Au0gx~ z?&X`icBzUZlJBpQz%=|J7&6eW#6}l$p-W@JMyob^A4blj?guuH?Np_eY|d)L)!gMD<@d16xKhu_q++;RB*iNMcGa0(2RpG!XYR>G#M0YEr))2d>NLAv$@u{-ue zey)072}1=S5|qUJJ)3uQ&XLC7gz*!(%g0jj^%?Q<)^58W;6JJ`;}Wwq7@$zV85pqq zn@!jj`($nmN1EKpX$hncJ|18B2Op1@aGvyU%6R{r<4BJVCdM+2yC_Mt){tH%1iK_* zzQTw3hNncO3Jv>az-gy^I9vF(maGDhZ~r&}X`kFEA?+Y8s@O}^KSQn2Q=r^0Z*EjXMW89ZEjjdLlTvv5DjGYW>pxDXZty9t%!!^M% zJ`nPY3#UY|A>5QypJl0iz0kM38$BWSYf9t{yPMo zgrg1?UN?pI-Rth#xOMB=>fQU4D_}7JYjlOvt|FtuG7*@}?sa306hF9WN2l%Ny7oEs zCwEL!4<6Qb?VwA(XR#=C_0uKCSS(5s$f-aF z4z0dBQK@J?+DOJ5v%=m;##{=%zfS#Iofio$x8&KKzMIpfr|<1h9%qTd^JwKK5Ph!)2bz zUR!4a#sZs4sQilvoS3#edMd=@7s%+k)A;v@-1Af2UTJm5n9`TDk7ERl;Uv{f%r_>e|iW+4HmoeyIvU+EKObUJ70C z2noE2=zkDwMNy_H3o1a+SjBuIys|eTPoGxvDI`~M?$inWHeXvBMHd8DFY`4EqK{jm z3xWcz`QnJIASlq9Ake0pD#9h@Xu>8UpmF4f=yP=PSe?`%@)7ADZ1l-*LEfe$Q{f_4 zGj3yT;2e1zMR-OyIHr$gx|*;az?mE2c|hDIoWkAC+qz0c;zEs{?m77v;<@d}Dy>k{ zP%hN9og6?+(3a)~h*K|hGB3pvHeC3I6wVf5!XGE~szJLV45Gkxq`gMBz3XFwRyaWG z+c*r|^6|npZZiLFExHSSyki>EmFvTw;CRmYzmXjF$pK7|n03+rw&Nf=%=7~B@Jce; zbYMaOPG|xH^K;1i#PgpTM~S`@=&g&0BTvJiL+;6qKjGCC+~lG@(uZOLwKRt5%JTIO z2KzS3hLy?2)Y`~#$djI@G;Drzd;QH*A*WsUbu``-+lFFUV{`X}6l#AW&_u}}koJ(u z3LC)^oZ91w%$THGOlZEZ-}9Wv_mMng%Apf=UCWG(7=3o5_t}m8Zil;fBT>-Bsp@Yu z1yN|=qEmSEr2+bcdVbDJFJyU!Vx7YFc>|M14{Y=v*qE})ePCnPR8{sKYqlc;rqV(O zT&Yp&>=s8W;)+!nWd+x!Uy09cyyDkixGBDljM|4u<9iBIqB?A}b)&a!W51`t{p7~V zNLBr%CR2jB%{!&}o%-)R1%z5cUGW_dQ=K|ojSOlBT(%~wZ~j17PA1xEjYifp?yf81 zA$JOUMrx#6S6Q;Bc`Iht1YALoQgzcsC*bI8_SApZq3+b(=K^H?d!;rml%Ma%58%$2 z);BkHtWeuC2O>sSZ1k=~Kil1Q0H+mo5nDT@BLGs0*RHZ&{MO+@3 z!xQ&Sxo&d2+2iO>rrHD=ZGpx#6uUE>jKwUoqy=!YTi4UgE;!Q% zn^eR6J=eaFjTqw_X;=WXm4-f+*`*mX{uK-j>I#U1I5nkS*?NDb% zt3w|yf7nVWzT!D?d0Y~vlN_qL9H987AoN_iojn2Q-MyzdnRGrhw^uoQ9zkS$JkCmG z7v}C)jQ+U6`{RawVXOPI4W!4PDoZa`DZ)m-+u;2c$=lo?Z!mnKEWK8xh#38PgZCQJ z>fIMe)~u<~nKG$yp%g4Y4@R3CxjU2QH)kOT4Tx zMQXD))!sH;=8G#IS|LrB&P|Wc8BK5De9|hJS10WlhZO(2bpgVJZLe?IK~XMKjCop> zS`Az=ye^i!7u#-voYKK4D{zv|mynUMHx44u;cqGai`sT>A08j1oUgx%4NORHh~v)< zyELBHKM?*1>m+RlH`27gxMPoISLiT}+mr+*E^fcE?ae!C$dTo_lUm0U)_9kah7=H+ zGAZ$_p`8>-+P5c!oz_TG?OYy(KO^sswr}vZ1Ab@SjtyP^p=`fc6~Z*yDBQ&m9^C=I zw^r&#+UJVDz70pxz<=)?g!)Qh`@M5K-UR+G(&>{I`@IRCq1>_WDKj^+et|x7j|{F; zxd6VKxy$LeF|G7?Gx#J@042vBr4RWI{VGq2F+Ccvk~@iCcV(rMK6IhBD6al1Q&Bvi zh`fgSK;Eu5#FF{ywRc&Mq(?MAkMjW~p}TjGs7ifvFlLS_MPc(MG=E+HZEY@v!l6sR zFp1?&>QM*ju7ku6V};9$ptzC^!;^{h6h?7(Za}mxu6RQu?qqYu4e%(4 z-{cL$L|iBDaP!Or_k_|$Svm;{NLo|VCX>0BBrU@^XtHs(W3ofVFUKJt0SMS9GlBJ3 zOyjg8@x-vvnH#)D37uzd=sK$O=okz(wa1adX1|~%_*_emB#$!>oUdB1twobQU38yK zT2?X#qJVJtf0W(eWjA1PVKDcv`?kde-T;p#g^k8;@WyWFcNe&C)ft{s zCK?%K7Inre?MJ==y0T~7l@HOS)}?V-uu6qyGPmm^cs`YO@*dF^sSVAw-9|XJNDfk8 zF^A5T%n!j0e?*ccfvZSS!v(6C4!i%g(B@2Ip+v`%MlaNPFVvx{7wQZLm5!&a4zRD6 zBeHvhb`2Gp-O|#EYm-$;nl`l5(RN!)ZD z{`2btL(^Kx4EXhd{l4=H%u6##wap-yXtRd~$N@E1$(g(~DnGqSjz|WT4Pwdnq50Pc z1us+-gPXs|45v`VLHXd1b>2S`xcsrM>krDHd{B7X6eb$uORp{66E=FN&U>h?-|cqq zsvB!l#^)+O1NxI`l!L>)iB_pe!8-8{JvwZATsb z?)ti}-=U7B86Xb^d0RdG&Si9|vIk1@yO)HoHAb|h~ z`lB-IiZr4p;jp7FC<=hbM6b2j11~nZu3%l@CCyAKF%wx1*E<5K)u!TM>_b>M{V#mH z!2w67IlHsX+L4?pC1VoklHL01w0xxrV11q$Zl=uF<~^?_K)#E~&d`=#v|-3Ez+aT@ zIl7vg--vB+$cYfgvE3(&=GQC?DWAXlrN zeF=8NUSYix?`)pao6)>i5{9ZIVTet1dUJ0}aas4f*qe?4E#Zl3vMiC>a!{IV-YNvD z!kU4XA#Vzhn5bf3g0|i!Y(MydhNJ3m3V{FS%9kQ?@%>bM4#Zdp0hvd`M#Jm85%3e4 z=nk(Nt5p(_sXPNFpe-%|OF5;?c9gf4mq%A64y}EYYz2T410rNONe&t=pw=GLLMu`+ zlU^PdCDHvcF=pj=zRxgfq$*T&+b~&<5TB#v&kav$Ji{LdPd2o;v?JA6S@ts6b2OW6 zDrSBTwkreNj(D|GMeT@Zly8YAt z9r+7ZxE&!Hr%KjthtQ~eLtNnMF51x<+NP4BS|sHSiUUQSGXnw5UPCY2_8dLLsap0s zpx-;FMzhm*BrrI0L4o$79n)qlpJs$YLH3la+bXm-R6Iuya4T1pn;Z7Yer^)PYI`Ou zqkBZ|AM0@!&X{IlK;;UG>sp@&1rhi3`bOz&+p``-%AF${II^kU^9UX!R$sYZ!fBd* zU$IP;dW7h(+GvM|ew=@jf{3BD(=q(cm`l8RC{ z4Q65KRAR3|^+&{&Kch8-&?YV{GcKv0Qvz$+#miaTg9KLGj`fX7P=6jSxN*(v8^LNR z?$_%fV1OC;RecrQ)S?0chf)REpp{Fo^5WWa9So6q8~NhX^(l-s0pYuQQPfYG+cLVwth~{qvAEn>@*btI$0|tc?2+4;bd@o|e631G9}4aXC+rTe zNR6~Rv5;Z6Ko+w2p1hAmv#I_g1j|tV3FaLj|I7?CWb@1yCXL3d_r|Qpnh>+TGDDfV z*qWN1apmC%#}Xl50W#0dhV6cIRffWHF^`79cRFU$3|6;2^93ev7M1xz*l5^#Zx}lK zhC6J1WhxPx(<6if4oOalg_Kd*v6~z^lKqi#grdy$MA=5HNd8JDjeb+>{iYV}e^XnT zg5WRytyy8NfS``D?CjLm)YNE}9k>WxCKu!|xU-pm5f_**R_TN68v?fp(L!%q&P{+q zI)Du*G>(d;7fs;N&(q6ftgQYzcwS=xRWTGRjb_s5TeaS|NJrkP9n(t;4}jPcQSK6K zV0gIBD?uVABW%c<;FAX`SBTJQNh53g1CZ6msUaGUy-gjAj*?j7*h(?xSg3#Oy9mc8 zw1LPBV+btlg^~qN4^nOPblWMy3RSyQ*-thsR69?7;Mmpx<>rTY3^#i^b;iwWK(UwHwBz& z?6WP*h{SXiiV7JcaL}$h1ri)D`AW#=5F{saQneH24 zr?a?ncx3KwEJST5nO$tluH8_pz8TNF**>}dxf^8R=0vPVq+Dm~bl7G9_N0WOUpg0r{nHu@-)v%hE|fT=w99L-x*dHGDhybw%E0 z{}Ji8{}^wbf&GWyo&ZPbIw-t!jwSwT%Ou4d>8Q^fiL^lAg+{BHr<5_z;99~moY;0J z9UMq+=@vX1HnTIVrBr~@)pIWkM<(HLOPv55{BFrk6GsfgG=jH*wLV zdfNZUChSE5A40R$(_$oJr{=dt%h!3!*Yyi_clo-mzbMc<^sQH3xsl@ISHq9z0CV^Z zt8SmQZ$NvbU1$qoXNP23!jGI3PRaR)qMUzeu zqYp9ZWNms`y?RH73VW}=6NN^*$raK*EnvT93fQj&NzGLZ`?ccW%>G}&-l=2Y>EBrq zoQ#1s1TsD=n%iI#+UCP6?(?ZLOZ#KB&s(!noT&uF$HrMWBkSb@&6s;=l<*m0-@5t zKj7sB$}+wK-B%;ACj6PO12wO+)D}2{6*GqymC9h(e3xYksMEqUr%EpK(#TAKyyKlN#t@5#uZwBkwe!+LvonOj0}=Q2klgj(^RKQ2_O8|xXztq@ zx_GWCQIQJqS=JQQq;E>c{xhfkQ%_EG$3Hv1axQ|iZz4}&+t2rtQl{4mLzlp1aB0Ps zisMrbe{Fi>rf&q*vhpfn@a~A!vaGu@r%d)4LJ}4HaWN07G|wA1`A^oM0#<=7w6dJ) zt|+`q7Md+^E|&jUhIhL_B##cD6jMfR>7b{6Pt`g2gbW2bpTtd6;UfxTVf_uA$^EnlJ{@8Nv<3Do2AWnbKzxj zuJ?PWIE@}1F?_FV7WZo|q^})KUppjZ^xe4@X=9yFncal=1AVBD#2mQmzv>TItrAlO z2nwOSN>atxt&!6<`sZeMR))o`{08J+1=`g~OVRQuQ)xOD`YG`^O1wzldCr?LM9=Q0 zQ%F0UID)W3jhGoZ@Sl~BEH+1xrHER-o3+ui7c^u>YgiSTITgWYcIxrvWO-X2mFlZA zE?6fqD<)NTC7{ZMstHx*Vs=qwJ~LMylMz{(LHfcd@1^o1t264ymhN5ED<@rfOf1nv zl*+54o9|jdsB#6QRBR!a;wA}poh4)8mz$w2isQ!@^(mYSU<6`Bo{hyYWgryFeI@3Lu%eG zDJ`0@iRK?9kA&+YFPng@;BIBUoKN=iOQnnn_w@6NC*&jd14xa(o|xvdpJ{IM*G0}O zAbTASyz_OBICKJx_AxdWE{AU*ha8rxP(vcYG@m3(ec)G;e3HqQs}{mubG42kcT=Zd zA&WV{L1Y4^)&59Jn_vt{WYoJth{6w_xMh!MlTi{k*Zh4L`zCtq(N0M>3U!J=5vBC? zXx$L~j0s1NeDNbm;}=s3C%*h@;>&^wFI>SR-AwZ_zM4RrRdacdGzFO!m*e|p_kYWt z_-(H5+x`A;S@H z9&xEJyLcn{iREYF=X|&C$IK_k_0bk;u%!xz1G6TLa8FPJa_q$45G1+b#+Bw?krt* zcuCQ*HE^Rjg^J0hmbe|cLbbfGL|Y~g4B6VZrdw`ErsLCR>ifpdMDs_<3a=!f!PL!G z`DEb4sD;fBRq4sGGwyF3T7&ZrE#Pbx$b&X_=HG~el{8^Zn;zbVsmN?f?}p+T@w^Zt zT7AOb7`JatH`6tfCPb9h@!#rLv^=fl|4>0AsX$LENZa|}%g;>X{}1IilJa+u@}S|P zrb(3wg-!_3t)z6%VP{m5LxVoYI-+N5_TS$nQzTR*X$Z-WF~}7Y$R*J~%68Ec%l1Df zlCm37wt4HAC=Zmy86fhG-I7mi=QV2VMxR_ka6H0~Mltm#aSjY0XU;`L9}$@A z_O!%ln&Y1&CPgJ$eg?l>a5G9G!H_IUyd?$Spw>kozTh_*HFiz@fHR4#8Tik4XVDNI z9g{^5Ll`9>x+1l%3?tuNX^FAgDswpcfk5nJ1X2q!s`3k|mc|LSbj3%<%%=&uk!mV0 zOVz+k)mM#Cm1v%Fxil}7j444qUYCj_%o$G@COZ1cOH%bpd7y{JXza}QXZics^|2r3 z(qyB&^8kg@bofeXyA4XNH21fw54JPI<!z1h^A9C?uAoQv=73sUttsN)XL(?>{_ zUr?TdYVt6b@_0%~-X+vNHcJVzl|1R4A47 z&+V16BvbBJr3d&O{)?1%Hl>_F@*bCxXHxEC(nBKUep&i%pp+cKU=Gg&e=`G!Y(9?C z*ixKQP;7Ocj$${H@2=rHD7L*3W^Ubi(C#p zbV6)iG?idfMo|go;Rq@rzcHLjD9xKpB~%0P5;h|?N`ecA_X+L5?SyW)!%G+#R#6Ej zfzAop3z-K3^gu-sB9A<9CmIl0Bsi+)_A;*4fs6qXp9d^k4Is7N%cf&1*NJQap= z50UH)0~1?eLxKH}JZN;O>u6MSr{QR@N4jWcW`zQ!f;kMYM>QWayb#Pm`pC?yP%W*{ zu=hY+7pRRvZDW6r0Kq#)lf7Bi->a(t{5%c^Oo~ z#g}mP`F6(vrYX3tq|lIXbxpXWzJZgky?+VefDf{+@)&x8I#IjM(L#(mVqq zm>&TK^&eCNgZd_~9@dh-d3R8KZ7YYTQ+=VU5p1+iy?Qu~>YKD07}Td(Jv^1_3t62P zL-i?F4@Z*}7~1x!Rs(~O0z=!rC97ZwK#D=w?Nh7<2KC8TgCX|Os~goMMX93tnAMF6 zk^&4Gb5DeDzhENM{WgKd)=D7=4GEw6Zq)QLyuBKnJ*J25`?>~;1iy^DHXrNzihR4D zyqsSdqi1x2a;A(?Jv4pnkEnl=4`c@N%mmgRqO%C<1N$zJ^7Bdg!&!YFke592vj14$ zdGeAYz05c4le0QsWs>;hxP(zozfzU6(3N(d*^-vfl$oUQ zEjnhdQBEZ^?9j_na>lLk%n`0M=gFHp8`{-;e+`x@L~fYo=xpGRpc{zbgKiK3y7Ea3 zzBDj+uDeE(&ySkIMi16_51}KJ`(TaXaXI(d%A}|uT*&u7)p$Mlu5$mW#^99uJ`wun z>uRLsl^9C?vBvwyntox#y|-rUF*(1w22#J|KuwYj!bX2rPukhC#n{@dS*5tWjl_mrlFsAErUmw|jpzElfuOR8M zVZ7a!egfyaNRD4J@2=O-g;G+}Y+@~kHhEen?7{tb#4%y{7gmtcOKJi(qqu6msAl|p zn=hkxA@?j4Q~m-w`{yk55CRC zn{;i9r11CPEx23e&3K#1vL-=@OV>U>=)SAQprxP|$*394s2Mu&WZ%>pKAjAc3=;D` z=f+I)EUm7Ezq2OU2#0f&Q@__px2DvzhwK{&<7U-pU4oHp^#YVgenBsZGD~O!j+a9m z`$*6X_Pb0A?#tnb8;4FM2SagL)5%b^!ksv$#sVC=erqj^BT~NIghe`;@(4%xcL}i` zN{fkuT7>Kg_=p5{T>u?V&GJD^M9pCvT>?&0yZ$NZyHWSvHU)oVl}o*& zza-{>!u|Xz{skhLvmwJ8ifU(tE5-RWG*sy28rLl8`fc?1YT$1tXRT9;3RZuCV)+5|xH7t98K z-H)x}9sh^^;CSMqxLPx^l7-|!q#&Goc3l!piSm;5)B_E^G?!9U9WLEz(RdP*Ka}D6 zMIJ+)RlrzLdfEGy+Wqh<{$UAvGTdw-gDG3Jvnc?)yHfQn$w{mNQH9XgK>v#qXBFFM zn{DFG#a+CLUqtGeErTU|I$+e@=U%vq{}o9ymyA3V=u@duRjD~4_w@(cieBQTn0?LH z;lN-BKZ6cO21C&OaRlCxsp&1eX;qfFO~y3RRQ-2(*pGaNgT^SKp`qoM3dCq_UeE6K z)k2x$#@jP$R29B^Jt3ZC0t2#c;Rc7iH^l$qZ_99OVp~)H$89D5KeSc({KU3yuKb^l zE9?KEEd)slz!0;0Vdc)IezgR{9|#P8fRoNx7+oFty#kxJ=FLGEy6zv@9GEkN%vDur z2>6H|5b%d*F!JPndnNxiVG{&z&Y)%|I7T(5D$Bx;uJpi1u)`j21b*ZE%}9N%JRmN-y{~B1G$UjJy&L7KicoZPMxdj& zmH*RE`v}J(|GPdKp7!^#>wswP`oHMoVGrDWNZy@JOyZ0E6WTg&WlKA5%QQE&C2`G` z4?{4^I0&YpR0IC8>egSZ#L{j4PygH>cA}0>Tqei~l+W~+Kh&0_YcA_05fgq=!)&RB zx21KyF#>Z!U1^Jme|c61pT5%Z=Of*5aQf_MI^sg`bL);C`l(QU_DYBD$N;eRc?YX=e9PX)UwrR>Dwt(5pmlKWg#Vd0Bg z>6tB$Zz1`|wT(ret{^_1AQ1EaT;X{9 z$O)!f%}*nF&hO+tSfR~5lA1cBG`ijiH+%4@hpXyDu@j%mzrO+ta>gltYj2a*M*Xc3 zUf!>hdvr44l|lYLSG)u>=D)A-{(VKipm+a$g<(j>zfH0pszuk3m;2iaBQva|aGO+B zVw6;VKZxD6&0G72qWQBVr_oswc?)ynrv4XcUmq7`l|BB8h)MfNAO#)OW=YRH<^NeNo1rs;V0y?tZA%rG#LtWT3r9g$w+V-wl= zePiJoHp~Lhx~c4n4g^|9)(UG^>?2vLRpz+_jA{4E5 zuK=jU@$1#NRrO~nTh}+%rE$)v>Dfb8AQiioAqZJBr09BtWFu^e^3<|mEwG-_!d^}+ zn;R*wiOh&EjCFyJi`3Qb`ytCFN8;-7ozju?fq0mIK8$=|WHp6wfj4;tQXG@l^%%(7 zdjTXCvmAYmyJvL~T?}(7ly&W)Q!$~|y2huA>w;6O7k)6Qx8VG;a<`Ig+oapP4eYXD z%7dn2X75%ew{2=}el-0>y3S6)URA+Y%7Ou9PS9#Ac4w+BAwF83-c2haskV&P7cmG% z6sxr$88I%%_WC*NvP<037iGR>7Q8H1NWI*{&8iXFQ0y11bh{ z(aH4%4q@UjhW#^8D`$M*TpHzS)HuGYv23<9xyG`^0ut1-um4VP%fIt^ zYqZ5`hlV3(Yc}`buHf>X@QdP19u`Jl)_~GTJOHlRrq?mBR?|J&Y1%J&s5&HZE1e}R zr>nbhOZ&thr0!ES!l{~G8it3@DuG0|t5Wz&B{_%TbKpNAiP{n83tFih4iN|ba|R(n)PfIObm??P;)7QiKZR+#d zjXzLc$<1qRNN}WAo_l|du)hZ0rg=#$&sHfkSCRu5wo3K}>Gt~14ascXAq!qQETa}b zV9a+hbEuigRIwu_zu|Ss&ZQy+*@bF_gfg^NGV)%S#4b=SQHkRoxl(CstQf(@@1)bbsPF?c^k(=o&!x#9D=i0guuOr!vvx`6>ol0|`|e{!`Tt+rtX}H=eU0#Y zPn)d~>z!9A)l^=Q)QJ}!LQn+pgjqW#e^bj;`%R z-MgK2`z4!4iK@!sS99721R^ByCJlZ}-;a(su^*1729GX~x)yAjd&zM}O-Lr3Yqr~+ zn>V`#U2upNjyQucHsq`K6CYe0*E0I``!5C@8Xd)JscjA_BpD37eT^)b^Uqv2!SU^} zFt*ZL*F*2T+RAGjvbm}HiSqb4&FVz3!29Li5bMfC)wq4>YA_%4@m>t z6y)#K3_{`Is-%RC*Igqz*CsWXj~6d#?VUT-LEBS~`hxiTV*eaPDnQl4(&xv|N3r@Y z8=gXlWac*Sb}@6Y7P}oW(O>pUKHIeMTh}`}@Bu#r$L%~l4c3Z0MP^mn-l`V+nws%- zzhDwxFkuzzadXXfpt_;kZ@RxZu{^lOD0VndLf}WLSz>2@?r?rHBDDUe`k6b;7VL6V z=Q#=3vEdIOf12uk;}Y_`3A&%B%QfR?q~kl2ZRZpnce*#4gpDE{!+0dbwjJpBx!*r4 z(&7DczYn)c>~`6u9u0G+{TtU*|2IE7RZ);n-BV)ww1wQ)I&Z$?k0xD@`owB#w|Jd| zaz0`PzV|gdH~!RoP^UYnwm;9})uSOF#SCikeXTFenPz|ZQRQhkU`W;=4OqF;($B3M zzlHnrIyh6mNym<;dzqmble)|yic4n>#n)74DXoffRfP8%k#pdaC@=;rpuodxwA)}3 za!sTf^V}QsAQO-&F_c$3%BwRqj4av^&1I6roJ2ifMk%`a!F5$y9KK;rNb=DXR`3MX zd6!gc=c1M14JvRw)p@5B0@2D0zG&S7*%BC#M7sbOvA_j`r}!oiUsSi~4-Vj`!FD_( z&2$$F<9jH>lIn7m6`se)QdW7>X^~WydqC)PPXs3UAXYepc6z%5OoG1&zYs4R#ZO%j z$&Rfq5;8RzZlKu!hlNN6c>5^M*%bh+64PFw150j##SZ?W`NVbg3d$`p2@(@BjVO@; zVgNR+I4ZN|jLnwQ-p*La}zi0_}zRFWXqCT4AT)h4-d^8{B)lIOd#C3swGq{7ieiVSfCksV^ zeP0%Sf_A^o3$OD_;Dt$8nv>6Y$nV7FyO_YOw61=eMfYgnt9R;;S4ER3ccKRJ2jW*t zJmio1rOl)ad-F4ekKL#D8V5dKl9e#`s{Lv3tVg3l3$`3p^A% zXf`W?u#v-uY3QNg;RX8WRRnU)ReD=h!3Ei{KgCr8l~rytFRT)C)AEW~-ivG&^HWOQ zD|umqC%;Fh^K<{4-xva$HgoyB{*hHkNtB{WTL7aB<<91XY~I5wvJ{*6No7G2yn8kv zjK4`ook_S1b6zAgd@}Z?j7b3rsJTr7Hi+%c{fgHw;fKGRK-sSlSp~iO4D8pzwwkAR zkB`w}?~dXV*3G?ynT!3~Eq1W+$0dALRhF^~bj?=TZdH{M@9H5tI-i~Z=LRH#w}taC zVGz4=qq~KlL6%{?tnN19M36%4#OYPhhD=Q~$H<}-9@UfHqG;sX*A2@lF)3(9au=rh zr8bJ4qW1*QJFShz|K_3B%D1h9xdTuoU*NsO2Xzlmt*hk?&zg0$>NV2ZJ%xtos%5oo zE&KH~_ZyYMTW|{x$2kp_m+u(l_ z;YF3gcV_bOZSapo_+_(j*}PS`8?J{9$s4(LJvl7GFPepmW-@Xc{yQT4E3@#GnYeF* z4~g(`voLNZZ`}qzAi`fT3a=Q+>ln6jZF=M}tOuG0S<-pkUVY6P*6y2-f>F&mSO#^fqCyGw2Sz1%s| zY_DQ<+t}*+G_29cLfDFMOBGvv&>uw&22UK1e_9Fo4(GwMq$+cEl?5^=c*8T17>}Zd zvnVS2Lp>8=d|0jfNbag)*%9{C4ac)4=d-4&2zvMd%F$$UK4Yp{L=UHkBq^@0DpfDh*CgZ7?~Xz+55f z_=Cy00dq}T07slwIzL*8PA;RU`e^Dvo5t~blk+j-iEbaq8k6(KRcT?A-RiPDrEjq> zcGQ@hzcV&Ohn;wxYI)^dN6$)U&&t-QnH~)#a@L78HfPi0L3Bi*cSMBd>p#HINO5nh z>}$~t`3%E)+I@JHFusbsj+og09eE~ao(Xnz-G^2Q|5!y{!4K{%lkjU3*^gmZ7&(@i zoIR^xiS5|B(z$izRMX(v(0yyA@WRUMQMK;0I=PAMrFYX8Wyx1r-5TAl8uG%b>L^XJ z#h7emEzioG`&PNEY{S7|QJPUhw@gt%>M*4EBb@7>uX%qjU0+M3!`YrcQ0XmneKtji zsX8jE|D}sfe}Ks`r8)@ffpbCE6!5~$B2E8(8cYoUi_@I*zovli#y$Gj{gR|N-;at~ z;(HcSJq$BW)i)jlG}uzvi#2EW(*RI?GnvNqg_!1>*!^_;JYQlqS*p}vbhFg6unOzj z<_h_?H8iN%V#I}4l>^oUti@)uvKVb~q)Dl|m(KQCUFd4A&cXO-_tTMg-{D?i$}Us8 zOIEqwW9wlpH+IDpa^;#f_)@l!x+|F)bx`u;=t*YiIwh6AAo3P5<>Q%@7A!kqbb9LjAplES+|LfVvQIn9 z1Gn3a=#<&&Xl@gi)o_pzDz(#v>)&SQ))~hV*ahMgWlE6Xe$++TZkge?D{soz$g@|d z6D4Dhv0G`!l?tbH<>)NMZrU+>6?kP%kAX87_D5Yz@M&i4=bP9Mwz-~EpNcGuQQJFR zM^*Osw*`jKV}INhctE1}UFA4ik(A1YvCbTy&?pv{bza;xL{Sya6(huz87BB02!Ua~bF}sbLl}tV1sBMpfWhfJA-{fuUjL9wc@7E!XBorto*QM=v0xfxKJTV3s3J!~A!Kg<>U;Jxmv%G&LV^%p7~Z&xHO z1ly7GLm(%uhUPLV(>nq@8goYkHC#zM-l%ZCUQy4}Cl*a`hbwx0*}v!%6*RT(P(|(b zKe`P{ft2?pJGk*V- z8eRs|bijf)1kdt*S9t%<88kc~c$V|K!uc0OdD*V;>s*!aq}LPeOvq{P=2M%FH9uO= zNF_II0-JE)Z25`rJxXIsg>!cW*tSuwxc?)0D1dPwc(ueyUPk5+U`1~sBKeF$Nqj{Mr_ z+*3(v#5m58R!x7&tZ-IV5EI75u@}C=QWa*lz~UBOO^Wf0_~N4)a}r1E6$o>KUA3u_ z0%#BaV~K4$ixu^MPlqNzfF* zj$7qUb;Vefgm_JXy3Y(=7H1#;hxLYGFvn_W%fZD6_c#yNDR^8~uyHJRM`fcVCXRel z-mdAAJhW{N)1s79Z7U5@3 zUM3gCkl|!bHyN~v>)i7QanGw1=79jg^!5ue9$hI!SCX?BW<8U|zl-qjN+G1(xr(gBu+`1GpzzIARz+Lj5)biE%|=5DFDF%qA=a)E zLt?FX40Z7s7JF&MG)}1)!qzAju~7$LyX9kSvPS})ZCrw&iYAN7ZRzFkBpgoNN9(xQ za(!ocG?%DnXn1Cp?uAMHrTf{*KK+20GfHwYhCCYJD9r0o4|!(5lR78?zyF&KT8J=Q z;iKLW>u`?<0Ud+=P;3u=U>%7;sNug%Ye2*ns1EEYGi)@ynQBjEn*!=*Q0|o`VS}lQ z@8`S-i$amvjahE9sVIEn<33&uY_XgFVeKEk)#SQ3*20?DMNl=><9q>Y4c}|t7 z4+i?qrG`~g1%bI)?6KaS++c9&;1pQo8SL)of@Zr*O+u+Bznf*4U!h4TG%22;3sm-+ir4z#?j*le)+eS8%7x7dH6acpKN6p!m&4s0#}$24@e z2vwMbA)Y)x4Q&%cDEm0;-+?jYi&z7MG>fVJP$q0H6FC4qWU^LU@XNn(pcY|Mk|yS8 znSzl2!q60F$VM@SdS}BF+)-ZU{9TzVLP8!z(3@Izq5hn|_fbXo4oN-Cb%$u&V<5l9 zkI2bM``fyA%ht#YtNBDH*t2TG0?t?$KhlMYD9yak%#*t?jOB_u@P;O2M%qSPal?FQyh`G3`G#DmQF|~tCltRp1%L}iTp^Ok8gilL~mzZuHFRTNSmUwh2g|IdU zjt?Q%TcgyfM%!8*ZVkeo{VZvH1|^P$qMTgEyaxlNSh*{B zp^OK$3A*`f#G3A5(0+|)+Aou@5Q=nky9b5Iap((#S@GKMjC7B6J|Oxveo zDwIGmgfwCv;x58p@!Mdahm=~^;@MH|1fe#HPGc#zffw%cn5z#X)_+j*o|rG>gj^7F zb0cJ$mLZI}^}L|xr+SoFi`RdF^%};eXc9T}iUrk_{L}UCpg5)mN0Jfzw|v)nn?0zAo>9*)VT|hWRxPD}fK)x_sUU)9kyC z%HZ~b#JmVP@dD+EdnFlx`l?c0sxC7yW07v5E^!gd8a?*yoJWkXG4mLhx3i>$t#@L5 zC*`6{qzPNS1Vak2HBsmM@5yA6dgrz@Ibs@UQF6bSCYhpi3-veh zz@TASZis#7Uwu|d;6m^Ym6K+~(+-zXHE>o-c8vvNf;`!hZDZqH!EwnCu((8r2Ym0X zfE6uwpRqYr{X`s_%6e6LTfl^n+6;cdEq|6X47a;Nw~lLm4go_gev7A8&FBQkN8O+QpcJ>d?F8b_jU#6>dp6t}sFB9hKUQmB_cYM2# z4xHKh7`JcQd2qMv%K?e%xiPEjv!3aEjtOwOk!?CzrBnouGWY_got4G(aQ>w(0~eEO zcNn}LmUF67wug1qN|wdnW&?Ck{HoGSgJG_*I7e5dt`74P8~XbaV6NeONzRWYfjfhy zz;*h`$w5^<(}08?C4-c-4tFA-iBsrichU?Z=HIpJt8hJHa?7k>K>+FnHH zFKDxid4L3qGu+)6J5R2Q`mPtIuA~hinDg|$H7D2d+qqz4EZ@XNzzshA9HW+hRu!)0 zZQ6Hl>SFuZd-S?kjtzA&Qk^zW%WpIB%^SaGt8{hTwp{+XT+X(h-(jq3&VJmLT-8^{ z?MUICEeW#}+Owo!H=~xdI`|T&v1G>vs!L94u>4p@a!{P^xxQ|n!8yUH%k$GaK84$C zuxZ`zNZ$Nn(7~RUMtn}r83^i9*747`@H@%sU(~7!V=dgyI_`O_NpS6!_72V#`_A>+ zo*{K?UnV?68mx`wo{bEhlfpg6NMoLA;kF;MY7F<6aU!e6Y*M5a-8Jlt5)};XM1#Q&{uwgk zXB41l4#qGiC~$9JQio$Ks7F<3&$qY9L!L73arJZ0P+(L{b}l=Jw!>6Ma;7U&9`YC* zF9YqCobBxApULI7rZLnhg*x4y5>}g>u212&Dxj6YsQqQJK$if~Bpl0uGEM|Z7#Vzr zE1QDialT%jrl5+vN1tmN&n|VLW(D(biL2O~ z2?%aqZmo?zyEpLeh(LKnL_nGk7ei=sI+mFM9^GTuZPuQ(GLnMZ2Y4%eO3#Ylx)lKc5&*nn(dAr<#V(Cx_afl)^Zn zs)YztHo-42bfP|#GP;b&pzzNr_v&KdhYIY8WFMBeqet#uRV?_d6jjg@2qF*TFYr+0 zpgoBtRS0mG77PEXfID&PFg8v1@5LlW{OzWJlhCk{cGK`|xKu3%6)~nhXz7czPi`<3 zc+eaf#m?elSV0^YwcFU2nq$=(aK53&QpaAj2U+c1mW~+8xUH|5vjDqDnph@k+Z+tJ z6N-gX707Rq><1AByu)g#;-1)cV)ajqyxyO(?CI-qpmyqykwA8nZDkPiLai%qsQ(J1 z9+qQw3r<}cLk^?ZdS2Auo%wMU!Bl$ z&F5mh&-u;We^&7nx`%9z0C%Z`N`b_w53RbWxaoy+>RgECKV)9u zPpg3x$0H>0VlH8(()8cr6vZHD)si>jj$PYyT-=dA*cL9oTO5v^)!8Rjg(;YRK0QP08Z`++2cNhIiHGw0f zXFuE{(~}(j3e$VUA4^8IPVSn2fnUUNbqqrudGEe^@K@2kiFcm;@cOyC93sDfIln9g z?ZCe%%#s_v2ud68x;f5<<2P* zep`gLszyV54lyGft<*p%6pv z|1K9ED@QpJ`+K&CC-z{V?AM+ca1D919AjBZm@(n`X$QrgWjRNY?hzKauH~sjjyqkR zAi;At@!C8n)$1!qCMmX&doZ1qwAs!(3O4&>NP;8A7P7GUgeaqD!+$4gJV#KGb6yej zma0Iy{uJd1EOIs$9ra!N2}|z8^!1;>e!?*1AK#Im!JYVma)cJGEzvb6>9QZg4S2`9 zCC;$&qrRuT8cDm2uv2AX%^dfXI|s@wBW&}hED6FdA}0bdL~az?ek#1Ed{TAPw--_m ziRr&`5ML2*vX2oZ#?Cvi7x(&NYT$<)VeS{pg%`_lRVVU~5@Ggo!Cp>o6~gz)Gdn+G z*uAS<*i}xh-v+-b!rRJ)wsLaiHuyIp{JC=BxpMOLZSeCVyt!OxE+^+OJSmfBMR-%W z&{U3=RFRg`BCN4oXe=k6V|bF5Pel0B<-*hDGI33oW%SjEQ#Xw=jflk1|T$6tQp;^2RhAWeryouOb9n%UxA2 z{Hsi~W%hdT@$}0}7(DO5B0P-%4X_tsU~+DgV7l{;R;!4XJwDQQdfWTRjqwr2;FFb!k(lAy1 zD->+I8onsbxlp**j~+fm8O{{v{I0Ct1z-RE z++CREMV4Z$TncC6hWjZ+8U^!sc)9^z@-oi{$4mSJOm_n2@6+)g=u2C_*ius^ZZxjeK3Q2&N{)YlV`OEY( z{v-WQ1ykwoM8`h78|cY$Unmg%Qbwd=E?*W1Z+UFT;)+Sy!qenOOyxdPAY3UR*D?GH zn$At*z4947lE))Lj zStp$q(-=@TW53ybZoz zg#WQj_+uG)={ERY5nfv+JW@nDF)T{G14HLE$PuKa$~PL`^?(zFyF?6-Thb>v zTQP?H2BwTC9LMg~5Zg5FRt%jnmgy_XV!j#iJ$WZ=`);28Y869}Qi|ufEo7FlUF)M{J64W7=!IvmWBNw zxDixU%FZ|7Tqw586{ps7&j5Dx2sX4_I&48jt)x!I{}oGkphve{<9SQH$R3G7#JzbdGE?;@kL zbZm0#i#J|rZqexy)sV=Q?cA!&2Dj`QYH?Cw4{R}L#j9Z3e+NT@l*D0yX|t)^moApH zZ@dZTbB<+uZh^_Ovh{{YsfI)p=$7c%P&J<2u{hy63wNV*h=J?1Xs-}8y*J_hw|a^4 z5sY6a^_+NDLtLl8?BVOj$?pq5+d-y*=Y8DQ@`ZDyWCmjAjF;|Kxy_|QRcT?^f7Q#V z+o!I_pM`YrsDy55W0JNpj9$x@e9lH9Jg46FzRdNA{5I2^eovY5?#^Ol?6fo4|qT#(O>GDA7=tB6(y2E*(^rG}M zeN>*pQ{&k*c>`DVqAZ@4F$`#37^%!RCO{4$&~K;4=SjpZ5|3<>ZbZlHNSKDFj!NKG zKHaI8fIom`=r;^cOOm~al%?E%WJEF~J??k|KphBLqCD}LgxE32&>imEtV33E=fD*gHOTV==cZDMHIek-U=2MA#^jk_3U&Ehw8_W!| zfWe2vfZlK^6&p5Zfz0clzOj(SKgBG{Fbk0%2FhcAAA-IV?(qW-_4K?I3N;6(svZZY z9)6JDAyII5H2JTr?j5!hoy&UaeFpqUshc`#Orvnujy#5F{O?Mux5*RypxG$?VKJ=5 zvw!?U5SApwnnLGzo%1#MD_YNacf3SF zbYSOj#~!MqG61q|-U-g^6fK;3*JF^{la$QGbOk+rZ3ZB4XWNZPDChkeua3}}3I)_| zU=uSJvOfxsq(iMCf4GyNxSz86KmM_0nX4&%eW-eEs%zlmlm6G2?oy3>dp1;kX`}12 zr`B3s7v4{!sS)X=QJ3o}*Jq;*(OE|xuN?$8kFL!VmQmLa(!>6{R4MPIrUygjM6~I{ z)%A~4{1w_){=tT+wRsAr349Q}Q$|8@3ZM<0!?Lo#jv12E#`gDbH0y4V(@yz;}v_Wo1)b~4M>~r1C=l_A#&J)2rxGWT+wj9 z4^9Fvq!L=*`ZytO|Er8Nqs6)~$vS{u3p2p>MIIG1lohBZmd927b1b2ymmY{Cze8w3 z3uOIU!1*o426Dx)nCU=^7&eRWvtrmJhOY!}L48arFxIbCi=Rq8k^3gU6?&pc;g1rObVW2>;85AuQQ1xe1l6)F5IL-dL#X@)MgMeE@%kAeBy z{5R&GWZI()DKwRSuXpQfQGqKG;hb=Fz#R<%@~U^adT zgEL!%ezzJ{4db6vc3l{_eeqBGj;^XyVrC%7XNE7+hd62ADQa;kY^lC18PNB7btXx^ zei-`ZA&EaU(jhM=nNb8Q(m%`jkYO1rl}}HaBeZyFx~H4 zI4}Jn4Rv?d7?`%z0#x6*+QBr|!vR)DWb};l&auDSvrjjF>a3T*0rDz)c2#qf1KnXn zJ2DL!1}#iN4jn5T5PH4H57;G&;Jg^QhM_Jcxt<6AkHWP*cx?6soSd0W^&+B18HyY|9o+`4k}3%I>6I^*fyxJJd#35VoO0+R=4p7v5o}OaL!+=& z$tcT}+C#^Jmw{V@W!9eUS#oAe2m?!(;8fLLKe>+)YjEkb=2NEv8h^eV>Hx3ywLbTc zo=)be;F5h|z8TKszuH->BN%$6RESTCohpn*L>4M*=#>Sxv?I4*l2qjAm2H)!96H9d zrw>{cz!FBjRn7#byz-Ca6!n9}tsoZRaEi_z&Nge=K-xdSF#k1p_r;)<0<)F#|H?4w zE&jupjsanVey&qo zMHyNSNm_UrP+ZP7%2+d@O`w?B;vn2@m5llA(p1**F|o-(^+18R07F5 zzon{5)ZA~25;PeoxzV;vGJH3kQ&`L>ifyaO@I0FFZsBGn8XC{wQ-slU{oQnwqsz&L zZ?Y_OMLWng6q68|4PT1KGnnTh_au>w;*>+zEUA4XvXcR1DI#nI-%EA;UHv>u8ZchR z-POXe)64Gr5GJO-S{U}&sK3IO-s_(gQWYQJ$K6{zLfE*zlQvvRfr_B0`32ckuK0+o z>=iD<0{EI7j$i2kzwA60iNvguAMlhNHkI%250Z!Xq=yD^T(J&TL2-Q}(v$w;Ia^;u zfyZkoHr$n@J?BTK-Al2_3wN#JXF=A+RLoj75I{6jS#6XhYt?}*b5a}&Blq0J&}-;u zXS8E}Xrh;XP7xz3f0hbY-ql);eMT2mRxlgOkuz}Z? z;lEGtmx?0axPx3Q1P5+(w7by;`!@Ge+}B0mKSl;E>K?uiilqW`eOcCsb$gT_E9%0! z4cJCx$HOG#DCUiY1F?Z;RUua+_b8`orih?IWYCuwMVsZ$&tv#kxQv zGlAqVW`Q+HJ?D46DMGA?J1|XFV@t9B))>~whPn3oEyA3&jQ8TyMiRNl+xA{jyA3x+ zH(tfFAYl%pRvm4FIVWt#Pl3h&MBF=bh4x&ry|&^UAyD}}UKOEop360C%PqFe4=r-S zxZ+jNS)TSM38+l>dFO~@K!8cEm-#%^?F=j#2QLW8MqSFQRyP}$7t04Q{+8Hn@DxJk z8UMsD>QCx@C|e+fB)qGq?nUkp$-X zxx6MkQ35V3m19gW6!aanMj5#5A671x3&^-^+3wnrKy6OlEiZB>NV2W2#pWa{*Hg8+HcaC>+zN5 zz5X)>97m-9kVpV<m>j1zq!z_5q!mBGV@%*EE>!v{Gzr*hJ~s01?lqW-fLR$Id+6&xg>s{Cbbw!py;4DaOREXqCO z&bfR%M==+e>wY^&IOf@~7{`LoyqR`DJFA|?okI{LBx?VJvNw(dSao&zH{g!_3odonwhn?pV*XtOmZ zsL6YU4gR!33p`V|aGE;auZ8!A?SMAhS)SWzZM3!7tOQ;x?qaX-S{P42n$1^4E{b$@ zVR4f~3+^a%Vm#-y0??KZsB>N^9JHO~xGS7C{q?zeM?oFuAKwOpn;$#@pZ4snGrJ2m ze)|1tF1=(E~pI~zTxlphddagkMIY0sVEi&4Z=eeN7USGUY zDqx}Dex`d98O30Rr}|$Q{sh$zN?xu@;e+d8^oK}4ADqGk<#NH~slv@q>xx_+S@2}u z`Nhu_TaOtX;?&1MP}X7?Dgni!lFhK?{IMW8UmXu4j+V;h?hJguTO?$X#6m1J;K4V0~%;NPW%%7#80CoW*JovQ+aXEs2V9mvk$EM5HNn2+O&u& zEo*gwjgOni1_NEpNroY`2X{JuE!%X(t>X|+!J72y19xS0{FH8)W zI)#jC>F{P|YaQOuVHlsSK1|B|0}n3_nX&Oh=AK;p;|jdbSc&g9&%IO|q;>|a$nJ6V z)v)&ZO)zh!D3?|}W>p{4vX`u|MuP=f!4o&Zg-|1UxCXjUrho%LT_?9y^+`{WPM6wu z+TPb=AB|h0f+Hbq%K5&!Z(Q)eZL`I;yyvJ2>?rUy{hi5Fy8|APXlL4#%SWfaevqb7c;A=$aCuT#AHK&(`yC&c~q>-fX z)M^9y3pQ7mvRhAF*$|4-cWZiLRdKOWYOzYx zGGCj>@~YiwIK;tv4=#d`V(iYfJJ)Au%Dt9Fbij&lR`_=lg+bM8=*4)v2mXSqAbot$ zwa#xR7=K1?&)f8*Jd0ic+fuMFg%sge;DM`&5e-N`O&-AfPAxn2s8zFBn?+CIz#Bn; z!@!c&mtEn4({<3eQyn(J|;e>;_N9 zs?P?TfNgb*xIa1gnZ<5&ZQiySnUY0Y`AqMoRz}8{bYa_o&6F|LrHUK!0=oJ?kig}* zbDO^J;OOuaYWyG`O)qgwjsSh(_dHc;7kU_iqQzxL9|2}cuVYe?l>BMWs zJq}p5oo1I$=t9}ZMcbEmukCT!JGf7M`jRx=sl7ACb1D0at^`Sqbl=_wjY%#r#>mEB zhi=juG+*_i{dI2bK|3>NK!wNj4m%Dov(CkMG0`}?gfo=y+yXx~uTp_WZZV0Nu-%=M zKmOqajFa%k_*D1Iwl8vZaYJCGYImF0LzQ*;E~tGA$5fo#PDBzL0j}c`saapqiUjI$ueI&0*H;=?3R!cQS(XM@9q%1Q0!_@x)b;NMjP2I! zJistrUJ-CWx~JOYHT5+>3g z^pG!p144j&9S@^UI@{b?UXP~+@9R!YuC+5k-Gz{QRVZhbM0u;gV`z>soLh@ejxn?F zF{f$=TctL}Z&UbE390eDvtZIK>wI-0N)nu(pe=lnuHOlL64nJqV`{8j5*Q(AZnd-= zzR~3~-z!{48LM5@F(1sQvF@;5jbp8bsCAj%#WXtD1{ml=#+sbr8cWs8S0?wktbPMD zicXuO`FWO-!LE|6oo@77u8oiVCnf-!WsQ_!jQL!0zJ2+=RcPoOs9oX!KXi^aVZSP)2+eZyx*mY zKQJ>EP*sCcCS*VgUC4D%V}FV5mIj~hpFtHIycYP3y!BPpxhCB41XFAH<%#$MAq%`} zq|3D_hi0R4 zi7l*8-n)_Z;{=le&hb&TBM&oL3IZe{N^%A@ad%5*P-aY~GBXK{piLtgEg1`wm)g5z zr{08R-~13}IcUio+_vgon9-6FCM|gFCXQuM%4iuhBomCY_T`S!cR_dnGYv5VkK9az zOrakvi-wmsr`m3++;@IiZqq-bS~C2jV%b!Clq^~ryJ~8`r)DWLr~jP*V|(5o8biBO zcFWadD;x{_uEd($Q)kKkuB6AF{T;j~MfGSlZ*EjAKloODMre9O)Bu>@K`ELqPk7dc zFyjW|I*u^pZWQeyyjc-`ZDNT`7hx~X4X#?f^k@09&C1{MbaPw3Jlb!^)hBh`rc4urR7OQa-8M37d50je)Jf#zn2cKg$=6s z)_*Nq1c$kYDe9%TEO?XNH7u%)>Iw+A9QL-r(aI~Hu*?PFFS8@9vU%-eR?PyR9U~O?;je?+S*vzl^;e`%Xa0y8*gL zdvcXMTC!S$M{cM?0aRd_>`9ew6TJ9K)p%d`G9J6?I$d{(y=pXm7qh@sRku@nsrkE| zRV@A(o4;e(t5lVSjbK5EOEz%Jt;=g86W%+?wa>j0AbIP*tt!|^S1}6hT&g8Ra!FeU zlC-nsq19A`#!|;NGIet$+7SAZwGOklMoAvBE&;l^3ZQMI^N&04sb6_bVq=nWaVllJn#aXC|7!| znmHsr3cG`yUrjuz^vLs(iM8=;vVq%`+9faOxp`C$g9_dGMG=QR-{gGm zs4QdYfd8@wf*-931+E7l1k-M91PJzFN%-3n$BzUsK5LXiGq(DSp!K#<1t-@JGRnf} zs{>2zPv^C~698L`$E^0|gZ6zh=g()dM_ngwQ7>6j+Lrdx%~sa}@2?*pYlI#f z0HUxtW^){z*9P6$Mq8x~b9^>lX-M=DWjHbkOh%9x_zXMQ((#|r+xrFa;SA>lXuxH~ zCH0Z8J5k-^Q!Zr!K@77WUr-ntCMu6?3c9m7O1-KfHdQdKFie$ z=aVg0Ezh|6`o2pZ`)=%CE=!;O&A0o;^iZ{f8W5F~!#6BjVCK^ZdO7m`kp(`WEeBve z-Pe5eLVL4C4+%FP1bleO4HCfk)DFU(MSl|aDGJMI%DXqBWP!O8hdq)a)}LI-wcW@A zqsY!pOT5p`4zO5^;H^h%_ixZLwllflC#G5F#0uAqd>wK@Ka|DHX^2sV{Ak%M`ig0H zU~dFoJf31Y6kx2ir@VioNH!mz#WKG+Vb{W@BGaKil(kPgpXs;vyTJKrHfw{!B@CVZ zhHU-&*Q2~Tj?BdIw9^6Kz@@1|^uGw^_cvrI?_VF0bsYIlx1HU}y!Ft0n)GGa*Siq= zbq9DZaj`bbL6&`<)!M1_H{`MJ-q40p_;o*ig}m6!ES{$kPd9)ZLL0#QU*WA2`WLdZ z_r+<#yCz_++AY2<$y3Xnpr8IV0oU2zF+suETR*2!#p#~rx>AF!E$;@f(CK>Y!xB$F z0&&`xc$JY2|3NHk1NWvXkBb5H&2WGji=lNd9HUX z$3`{Iyu6M>YEp=l8*=k9=_#-0hTr7<{9dpjEAQv$f(^^_etxM~$joD!L={G|aP`3` zhdGK}*4G~fj;U@mA5{0Rntp`E8gQSr*{W^~XqY$s60(q#=T6Eid)|?hH$Hk(l~?#? zdT$jIWV)Mq2+-&HcNAAT!qGm=*rs%vbKOb;X=ANH7q;$;B zBb7KgA^$*ga&S*PJhgZVHdTQ)zy~uplDU?n)lzJXr5VKt_yE56^;dFoLn&9jCiXo) z-9iJn(AVi*YJX~t1Pr#$3pwD+QjOdJamrF2OM=&me}M+-N;-aF;;7;@ot6x%3g&!B zqt_I1UGu-1H5G1K+#T5--|KzhJdBp%l&-C>C0f!NgJxCTK;MAs%X#QB{6LKS%V;_c z0zE}vcIO|6(Fi}}x_`)p$Lk!IbHS~=`OTYOMr(xcbKO?~*y{Kif#HKU?Jv2yr_1VM zns>UoLU!(K57AlsJQP@GH!|q8IgNorn0Bw`mmxu~56B~Bf8NzT>!K>ynm#})K80Dp zZrn--0}1@ce~i!mIbB|Dv$|(YRi-PlefqJiw)pM^?MsdyRX5E(G^#GCZwR65hbGts zF4*eu@ZLe4b*qoNb<9Uc#rKno*R3WSY+q?UmHfbkACZdl4F^@{RyS(u+`2{yV{PQn zbtz(z-(p*yl$_UG=ftx^?@!@RVKntyO{0&4Mk4DGwO>nnO1onB1_M(s?I~wG5)9m+ zUma9p4yH8m-jMkUOaa$WHd`MW%^)T*edu(08GDHBl}@G)^`s{f6Cbvo4?ikD@f;Ov z-!l1rPhE$1U5+A_r($_o-MbTvG(3gkZUjh8reP z;4G@hJNw>k?ULb-p*IJ|fw3$8J_#&Pe&&D?*P|veSMFgk)hg|z0@B{>4!=T^3?!at(aE-CT z05{*;a++0iQ~gRwo&Dj4=Y8f&b*I^RNojlF0n)VV6Llkh0e@PHpJ3V4hNN(ZJlBri z3hdrg`Wjksk}6yS`;S!G=NPRQD8;9!xFUSK);8LUz01u*L$^DX)6 zEs!$A`ah+8+LIPjUT>RemACsf(i?w(^x?znApI{2RagUHx=8)+WtxXq{XeIX4;TJF zr@41{+5cDF9vDudtYI5B{}I|mz2*O~_bu>IRoD7w&P>kaF=!G(giL@rlQ#*P3`j@> zO@=Ue0Br~of|WLBFbU90Td7rB@pfjwVFD;&Q1Sp|G9)1&Xo#=)piNMxNWs6sN|mZb zG*o-l3kZr7$^TpX%uFWXjkeYPuJ`^*a&q=QYpuQZ+H3E<*0(yIi;rEd-37TmJ4)T^ zmFu!m$}~rHe5=Y4j|y(PPZ5{^rSAzk&Y`Xhj@sq2pc1qC?dcy&*2T1rd?dX!-JuA3 zw8k;R6UyEh>V2m^m%X*f_f}nQ*k`|Z$OX8sV29$6V@9&tArUtjk8Cnm%b(eL;TI=Jll zW33UIj%6_@^4p8Kw6ek>CMEOs6r5|}*E&qe;<_dEit_e0RIQ9%o;G#ygJ};5aa@@? zIX-OW7ZpEQJ!^W+Oq2|F1#$Q3U)P7PD488UYm}-i%C6v&MkzjyFHM&%$0!1%5PL-z!Y-)eOOp_S9bdK{FXYdXjtXi*R&I?Ao1^~)msXcL>< z(i8fjf}tz?9&>7P!6#<4YIo&WW5~ui#ilJGTMGAXwTYWFyHbJ~P6{4QDH>*clxcgcNzFxG_7=D6KMz z58&Wp}8wO zr_y4UHrm9;vk|iTI6kv?u>G%L&Mw3=7~kg2c_kWQ@d=~UY?ii76U>s!?4G)yT6^RD zyiIa5Gl4a;RiiS9t=csPCFhh{4N^<@-eOH%T2b0#i_Zw;<{G4JX0he=Ee6k_%;$J} zbMWh9T;r84C701zY>=Mz=+(II6E|5OVZ#vPmY%deLc`#e+UW5r_IQ+8Y;#N7qZ7Z1 zK7Gm%%0;g^WoY6&zvn=#0i-HRO7H$MO~6%yX0WLZL)dDDM_Xs`yq?*?d!7$-imjSZ zZI;>dx@)UTJEnYVO&C=}b$VW}?f5vYU>Pu8_w}X;n_GC()-bbJ8@3f&S2!bwwzdhN z&jvUpcfo>ryWHjbMfZHg@wXJ82JhLuGpO0w+Zwu1?UuGd5}uJnPK}|>6wAeazAP?B zJ01gLkZKJF`9*OtvDH&HyXVGiP6=8RHw@ytCq?Oa*EsT7Y@97q^73aDQ(kCGA*P&(w;#t z=1C=~b89fZXW80@6G|EycR_ZREVL}e@wXM9hU|G2!1cd{(A-k9 zAad@maF?0M>&vR79PQnQyTTVqwTs^4ok=mUmCvjlUQ&CT!eixOp7S29^A_Q|@EWNj87T~KBAoS6rWZpNtH zA8Zzz7k{2!IRn3&ruLRsx@szGoMd2~Qp;hn1@AatgP!zsvR4e^Hd9fr!DT@aX^qk; zwxo}7nO}Xqd`y2KLBNn+RmZz{WAiZHKCw5A&vf(l$gr?DWcnL=HA@76WN&cIgRW+- z4b@^2wi?_VDr!tsnnhQ7r4Dn>lY~i+m;Q^rq-HPSJTq2lM_g8#(uVgONceJjhGQh0 z_zl&}C6_6t7vu5bt(k6A=tX`@o1W)j4Gzmga`S%oRE)}Y9)t3p;^2FouUUZX)>F}o zP{wI$yN=W5XKoHQbcJK9OuBqLQ=g-aE1^ibTK$`Ri9ROQKIK=7%rW;Q29@YZzOxcl zX_HILxUXNY7auiuh0|IA+g?7VEk%i|OM4jUq5du2fVK}znQJ!3R3!u%Sli45RoWzj zImW=+qJZ?SGoY5V=WT_4l0~D`zs(zrB^q8c*dR6EuhL8Ih5ST*4sY6ksR@>2l`_)? z(KYJ>-hLybTKnQ%%iJ0xOq{;0j2|EAK`OP(`#72REXB^C;|CO<3I`AD@!+hlw6`pD ze9Sa81<~d&+Z+OFE&4W(jxceT>5H_UL(g5 zD@**WxFH5`bBYLXCAZDyvm%9;X$!c@_EsKg&B;+{BAZ-v|obbul(+t5bT+Gz$8N9<=$8TPEg99J6<~YUA)wp7F4E_f;%@ptv-A z1sT0qdq1=HK#9-n`Tb+LXCf;Oa7J65;$zi(eI#yusLS(O5CIkh{0uN4Z1R)CEq8do z$}Mhf7avQQ^i^fd*sj=uZf$}5#A+;n$8=yTeIV@(*bZ;G=C=@}=uiONU#b_q?GUGBU+dk~1FtcVEddMUsAM4|Oy zK4|Xh%9XJ+3^#COeiE~lWL6owG#xK8FJ=Hu<|vC5Rz)Jcg!F1nei2c z*_D-(b63?Pypa#ZG1s(UyOKkhZmnK7t}}c5H2#2+?M(7IjnZb%Xd0U>Q!9)Z(3@us z3oUU?)?7cUo;SX%aJzF{(=BFqaf!s++_#obx6F=!W-OmRTk$obN#5mq#v4e@BUH#c7&%{KOja|F2FUD3EzLjC_Yj& zv+LIU?px(Q7ZAe}lzabPBGq_kk=7cGQjNigV7QuDhGY0&gV>m^@1%VhKC>w4;aI)+ z$l^CL^}!`#Gd852Ian#+%$F(K~;tWywR0zoRnp7XX6RF z*3Lk0Hh2DV(J3N=uyYh}oSxE)o8eO*(Fb9{SI<>rD7AS;shRA~T4izBEWK zjdG51w9=FXy@82vRVJ-1!T_{Hi8ir$Z>!T)sTW;vqt)iQ23P}ErFQOuyb{O}6$vm` z_IhltN~h?uNiCWv_554(Vza?jnQFu~5{KQ$?+_m;5jW3@4>!B2Y$D82i+Wy+HqV3v zsK}(IAiayv(RYIE2BY3prI%VjpFwF2Z%-`sx%@_XC@90^(~`uh=Xzsv0+mmBNwVVGy;XI_TCoy;4=$FunKTQagDDPbM! zZ9a30$j!^Ea)*L8thnQe8}QAxbv{3uZR^M@V)x#SXUBsZJ0g2P5%Y_x$gik^Uy(=@ z!G-n_B|D%O@bRG5%mp2J?Cqs7k-b&a`h77Et{%F^m=s)cOe!2_ z3qt4k$7B|m@ALH_0eMV}Y*Tj^Z3+_AMz61$k8NF^(HvuBTQf6sEFQbF0`gT0X-q(Z z*H2w4@9E-$;K*bvzMwx*>@qr8oV1UNrTc^KXb$^iQx_@9Su<2y`bC{)BAMu{COucTca%(WY z%mYVO`=@>%+&@{!6F+zmJ_b~*=VxbW(`ov^?}O8RO~>|Y1=>WgN<;HT;9ikbE%pIy z+q`1#x8KBQ__vGDHrj7`{&-bBC+%2;ome}-r%*mOJo6UQjfcL_>8Z@o&LHo0^kz&2dELOc zvb|W}y5W{50vssVDBr1HQdy9lmuC9MZ&Q8^Jz)F6*oV{D4FM z5=sY97duBQli zS5#te3jZAkhifPEZn1G+kS5If7+oyvjj=o7AE3aOWoxIK96k5K5MdR)q~Wc1=iwDR z)%#8vh2DZ_ZuhoDoXtJ!iyn<$=AYnSleJZ)oqo`uacA-v7_n z|1tLduU~(6?7b#ZP%1cSeW6);8Z!Xy-1+DCCjlo zr6=gN@kShC-Jt~sIJ?6c0!{=bsEo#98#||F_oaA)4z`%fhf^gR?vY)b5trt9B{-K} z`y7^gm+^_;=2V8mhf1HUGrJHI#^u=8SaR+vU5a6EwwTsL$6tqo>cq&~D)l_Vm%x2d zq4DKAj8dZ>2f})|Qbw_{Scffix;_s{aJlJ|6vemd(#PbY$I^$tHUOz5GCh6??n|SO zN0or+9^O73oi|S4!wS&E6U4o%iE4z2)u2bPiMzCJ9F+tyAf{b3&1UH8HI8wl7S>X#CueRgqs- zM)7GTu43I-960bKf#O?p^#xo`oT9iyhge?>YpL;T6Vkj8Qf+}Wvb~ai$E=6k%n|8X z7MycJK!%s*8jT;onL)D!}hW^Nt z!nwtb^`TC2)!Q-7R{?y6P@jji5aUBfss|zJhsE~Lma~6w4-WnJOV1|!NsZI}{o=C- z^f7(TI~zYFindzZ2=v)~boG(^Wusk(#f^Aae~t4XoZeN{Bap=PoMVgDQN87eL%rg& z!_r3V*bZa5xZ~x}A$1PMwkXj#O+a2DIS}aQ&SAg)10_j*F$+*br*{Q~j3kVn15#f-6g$daB@=@!m z{QQ*77^K2s)wt4H1q*Oqx*=fD=ky7hgF2QJJX8;*f*GZr z>EDNr*h1JC;UqU;jAHioY*GU=YAmmB{1CH#6t1#1;)cd3ZqBDW9WtxJ5rtEH0{xlA zjSb!|ZQ>5lDbz=^p4BTV&F8Auqm1X_-kx=1Ea)2jhQ-IKjzr#Se;omD;2Dz23NnbR z3XymkZje?1ZolLJuLT_s9a$0zc4W=!KNTwKSl?MFeSxr5waBQ zUWGSJjkv<*mFm)%yV1F=3wX8` z+`$-K;kd;=GI%_W*hnU;3L{Hi2``aWp>oR#J*(W(^1x7kAE3_x`tC#*ZqPT%@Y2!g zJ542K93<~TV}n_dej{W}k~|Ejf+T5tk6)p0S)$dG-|Dqf*}D>!s!M;f5ZxHjO+1tj z%T+aRzfHlJ#m(i$Ni9*6%p$DPM!Ms{=s$#OWNl@AaN$rh2FD&s+>vw!2=Bka-#jzp zZvj~ajZmI9Bgcr!b4Q{|Jc(eD=H~nm^j$s7?17g+eN)IBI@S0)?H7+3vlmk{;n!+R z&C((>I>)Flps-Dt5$S$Ye)2YuSvYilunlIUz!*5&1I?eg|FlfFOI^BPjxk`CW63j% zE?v9@4>wox!fej|6K>_0urVfDS+|GH3oZsV9hUL!y!1#G%^kWdIs~2w3}v$ zEO_a`BG62DtsBjrqgI`%DuskFUpCzf=Jy*#ruda$98Ci4cF*nV(%VdC@a~PK-Htoz za=oSa=NZ5hSZn$?{pT6!_~Dt4plYxcMOo?kxtJj(xY&#f!pNvA^FgRVe8Ma~LFGCi z^c@SJ;iT;K!AOpPfnAwiO%Eb9N!Vpv&t7 zqE>nylzyTaq8Id-hS3A(^Lf<0=ZEUjQCWJXL!(Ia8eW$-1D(TW=;AuzJdwGZ=6U$? zjopCxR0w?;BOAJG`T*IvuE|O9j~ivf7L}zkimTxK1sZ$*JhI=7`6drT!)}WGf>MeWZ+1^ z@boiY6TnX*Isj3llDlrarF-lx-gWGSTbNJ0IV>ysH>#{ibc*2#8*|$j&?k?vwm>_k zkcXDjD8CJ(c4P_fNhO_)*(x*1&fIunfoP|cY=F)k89WX-XE2SIva1PWU=L!w zW0^vBwQBNgJ~RF$w9SglzEP$DjLSy#ATz3l!*GJ#@uOZ7{)#wKED4P%gGqUmK2bs^ z*$RxsTzIn=(q55BAq0rqe<};1PT&$fHh7g7&aijwQ?I~c;9}laky)bmnX~^<-o@gp&s2H0xu5#!CQt~eJBO6c?V)u_Q5$|#*IIy~{1oGYG`@)`AdZN{cbHaaS(Y%d2~YD0?-oGUd^)& z$isRiuP+blrM&axVeQZRH{@YGlXq2lSX=V`FAwWHIcDFnJgk@;X#FMgu)=+BegE>X zg7g04^ROhYHGXgQmMG*;l*A4Db4Bhv71_fwfC&~)&(){}EY9si0X>JLRfYAHNf>d5 zBGr)?8n3-)R?>%#_@gr;ipx4@$FHbtjW1nr24~)Ka3^r%7F zv`DNsA@JZHgW8{*W)$mlGCQMZ1eJ)j=C1I||pj^(elC{IoVTme<8!A)!eVdQFfveW|$x2`8JHhP0_^+ZUhp zus?4w?ml$;mi*@ckR=?=a}}suDlRu=l4*1hjmJ?M&Q|24xvfVh;77OANRR){9*=?t z=ayX2AAJ@5{8vWgq}}?Jv5E8Spo3rdaW++U>G)G=!Jd2$`99m=qt%D2gn_GGNeQKMyI&AB*ts(7Q z;caqG8opw4r!TMG<<8kJHdOo5tJFPKq*pztbW0n+y+=o9t1jfE;S%BV{J1>rSae~K zRvZ4pJL4i*j@8^q%CU-zfXL(=tGSU*@nM6wHam+Yq#2|QPH}?)n~c1+dKKNtqf6wp z8PUFaN|SqTBy!q}tbIOm+VYHZBT+V&+K=_MH;Nl31|P`#TTV{7QQDx%LzPJU2Nu#g zNK|>*!dgTS*J}$PfIkmaX+lgC_gs%-WKF$$_v@RV<4uJmu+*(?jHp*;kQlXrCe>pL z>y_LGOmc#?H%+y7Jt-<(M4a-Xd|3-Iu(G*#5$N!@EG;Gfw3sLg0;%6)` zZJi*}=E8DL9^Y#4>;}&(rtH}@H}VguL2kzL=2TT$5rp7oJfnA{d{Q1?8|Cq>3&`WM zF?n~iGkM!s+hxdUE3nN)l?o=W@m_hY!^lm<@!`6~Cvxg%K+R1*=&h-DL3`TjYiJhL zla@UHKZn>KAzaVYUZcz6L0FLr`jnIBvgGxbjdS2k4X$iD>z5-hM;~i`PU8 z<9i`zqiY^^)%kUybjn-w+!x-g%(5o(V;i0~!yYSUDv zlXz$Kie+WZspBvZ%N| zp~Gml;tMFhtUte>h8EK8FpEM%>67My-j6~HV!*Kd1x`E3 z4B1Exh>cpdi5Do~Z<)Tpn_}kW`Mya=F&oQL%pzl#_M?5tK*moI1xPUam@kaJ7<*IP=gfP=_7*hx)N8fhX$=MfhL^sCNB#-H*0(d;2pzN-l z;ISgR_b~FiBu={oqi2&E5IB+__e&a3qc$Gmp#i0vzrF!Q99jgH?*Ze9kz=Fs5#N^A z_OZ(H8O!f7paZ)8gE%PG^rGVlYLVYni^0m^m|}XFV2XKBCK9giJsVEFW>$=O2m-%&h@qf%vm4 zq5mWP&<`_^-4)N-f2=xms9d8wWLSeWz(#8cvb$JXa<+XI+#IMLCKoab8LLhfRmGy` z-50YX34?o+L+2JCp>nd)*eT&L60yzaw;@mpuMH_5E62}+M%@2h zp1vjHPWjQATQce?oVGn*#goqKH>NN3EH@s@Z5LBbk3(N?yl zEI2h1v8{eN$gvQC=CF)M5^qWnSb!Zcfss7Rw1H`e^CL21Ms&!$oXB_uA3gXVVd)3pOrn(-{-` znH=zkZ~dA~fvj3ydj@ojbNJZK!=CwgfjjUiGBcQNnMt+Ei4DXtu(1GR#D=UNKGpKk z(rh`vgL(VFyZik^`#Km z%z^96pU%=6YI=+2$FfZfXaK1I-sKZ=M$pgOJPk`+v*&+YFw1TLTU&OROUEuUmJ9=ey^N5y&=D2xbJvYF&Stk27Nqw?UI-hUz5sx|WF)!4SUp6^B`h*5wdGUaMULKC* z5DkHGzRJx#iDq~Df_YxQ zBX~Z=kRN;t2pnW@+RtLi#-YFVm&-PJ1Fq0;nqa56sb%^cZ8E4Ny^x&`->mcT(@$k# zVZ8jneg8NZYqtH$mOOk}qnfCu5cqM+E`QB#Zh>+yRML_ipxb2om%;YS=mS1?c&WUU zo!|Ba3;=1q}ov`xkz2sWiX`Il%Z`-oSyDs$O@3JP&y)Tu-}Fn;1+tfF?(o3hK(3}oq=}PziGh4J)a>)oGaKPOH6zJ^{|n_W@b%1 z4$?>(+yX50l!W3z+$)AmJD0X9;DKV;+4>H~`V7WJ^%VU23%9)Lu*z$xqXvtxhN- zTkV-~j;&@fuFLcY-0dg&E40kxS36D%EiDqu(@69o!hng0#K$+`37@4MLwcqI&btPA z^sn;0`!wD*FV&}8XANcASMsplj)51(J zRl8{r$&a<4Ca`Hl-Xhy-hZMKXxjVE_X7B;Z~Hhz_Q{-R@7vK{k}cUMqr;#B zettgUu}4jn`C$t_^oBO%{U2%S$fCF zMZ91y1#u3T?!Lk8=a_n1(Ol2DUbo(;t{~hSh+u+XHjcL$vl!%x*KgC~GmBiD8Mt#M z;14z!#C2xVwj#p0`C4`(%-p}UBE*V;m# z{FK7dr-hY1{{>=7oRCBPqF3)g0L&o-qQ~iZ4wA^{4to74 zPMS#E!Re)S*>`H-nyy19Iffa=1H4(4tr@0Kl^3ol8ly=xx|Wt#gku-DU`**_W-*lYH?WoC3i4M0~SY7VEu;%!JT>^u_1 zBg{H>5aRm|Ha0W}1jCPy%nwH2Zx8jyb=r0Zv(U~KyIv-+=2fpG6C%B0EPXys{s=`n z)>1_0&;p8T>Si8JltN*o79bNxaO4AXWYJ~}Lf#@3i?%5-gmvHv$ z($m+1Ec9J8C8_5+y|}?BKALWrk)5YUM4t3$^zmR%GQ|{cNKZfj*n6?T5Ww=)3+8*S zp@6vRD1V?a3o}0QK+uXjnxS(4_{E=jD7b(SCCHlaAal&D7;&Jijc9&(JDhBmtn*a9ov``eu#Dnd8%nQ~p$u6U~ym5^! z!Zejn3J$gn77&T9pCPziZ*6U~9-$XTQzgEuk5?OhlWjn}+OV7Y;?=IZ={)gjhMWEk z@oLdGT~)kV$W8wjulC)KSNqvGDDoxa)$Z`U_5F)io0t6`AFtMj8}2qrjeWS`ACp0r zal=0zgCF7K0XKYQYx2Ck=Iz1Oo%Cn%=`6$qC)J1O#ZAc+CBSiFdzJx@D70)7g_gM~ zwCr*DHN>B7N=9gz8*dB@ExU)#?`)zw`PYRNr-FNa%tW3EdRKkkCD--f$r# zbbCJ}bkli|&=DZZkkHeV*yGDU==Od<=ztJq>*$6!iawZCZb#${k{4cPheCc3#i$xG=#8 zoyvqq>;lqqzqrG6U_fA>K+nDeb}6Jq(AmJ9``2QiSHyhhFwhe(gn>R%kjLrU z!a#2h{mx;a)6~b^&-w6+&c#6QS@bz!pciF!7iM}hEfpE?mIh#;=VclI`9c`yxjC8r zFwlE`_Bk-nZ>GQdG0?Lz$-x%~VxTwKzD*4DkWA*($r$MF01R}Y6z78H$3Snw#bzJ| zIw^rrO7$3RcWRdyX4*ZriyTAvP@yFMG&{nt29A5C-}rq8{J)ZepM}-+^e-E$+*} zKwmztyLueMKz9?P12NETmC^$epkR;#A`+)hkf2rAf#;&AYh@rzIsS{R*R>^i;?LCLPvav8EyLmp(8%z z!Z>JtEOh&0SBr(-vy5>feE+e~6Yl#yW1(04{JVyQZjb(!u+W<&29EoEz(V(^Y4iEv zm1Cjbbk!R?#AA`gc#k&)K;tS0*$9K!pN9reaXMgzu^}6Kek}BaDgCg}uR*Ve`moTk zLtcix+xfxJFBdzLV(?(J{>516%@YH$&;!vk8OA%SF=mjBE=5ws_@U4dckit+CWqU^ z$T;FgZ=BA*0Smn+9aG^uiiLh3K%r3I1gjv1xcIV=(Bm05SUYUqMZK?%hEpC83ghYn zcK7R<7Yao)saY?1PZ@=3jQzKQgU&Nk|GmIL@3Zw+h=UGW-_P9m$`+j0 z$HUC%hl5V@;_Yv2>nlF#hlBo~W9xg~3&cVHUfcSF{XVQ@I%@ql*S%mk=+bWtei(F< zT;|}eDqpHQ)rGNN6b2p9%{?!Jr+*_3Is$L~g_w{Z;$6`FcL*25K^KP3LiU2J}rASQl5T^kwSon4jmv#!31JN}`+gfC~mLVS0*tPSPilj~#lLZRax5tf^r z?eiD4sd$)8ZWAjD{%@Y!|56Ml56b8sp22X?L+QH#IOs!ZQd|WHIssIFBMfx9H|U3f zo}h$UUjPFgF5>wy(3}3f80g->9vK6@C+i!kY z=U||}eFI^jPgEGGwk&Td=EOH|@InP&6a!uGVyyf6KgIh0QlW4B&ZN{cxF2z~D& zr;LN%tk8=auLuX-*Z=X;rK9de=P;oCanN%RB!T~sQxE{yOD;bU?jAA|>Tk;fGPW~y zh2i`3bm{V6q9-?c8f78e-nttY9{LOD<8tuOsUP5>e|)+$^ylcuhy$&7ETLHGfQLTk zYVpv$)O~QebnARGXN4D+owxU z|JWEXVTSx^F&uCo!C+}{unU6xP9-qWSoB@oL6 z@zCQ*$=nyLYN3V^S>XsY6d;z2x#u)ppZ{j6pJcP=sP!M$SEaNQDExc{t7S0&5IxjP zSoxG$!!GO?COXjxJKo#{{`1Y?pUp6!%$ox-(FGqS`rY3mCb}%5gy*5}IS4!kC*Kk# zy4-Q|Q>RORlZ}Z4@m~xReJ$qrWfp+&VWN8n_wm!E3&w(Se87*1zV7PScqI>ym2EVD`*A0G0p(4cPW1@TcX#_t>=l~-DO!S{z-~Hq3 zy{lT)^|H%-g_!80X?-KuaQZ;=I?yM|nCMBQf`o~Fvj-EPzm3J$WgGj}IX1SU_H=2{ zaCt~|Da^*+ay?n zr-Nv~8hHNkIm?@KYLq3|bxRLnflnpUhpnSTn&rxc-4?NxTgA=CW6F9)2BM9D9d%{yk*y(+_ zbnJY*FPE!_qn-r34cD*FPAQ!Ub|Q>-C%mbmrEycs3RjOW{Xx8J)Ri4 za=Bx{-U4f+{4wsZs5mb29dY~k?aGSR8B1QC=Zh=b9p=(|x$V4Fptsxg{C<%doDvDD zxp|*g0OLf(zMun35f{E9i>GuFn>*Mx9rbIna>JHtl>5c_!(zg5F)?S!lAVghpKs@F z68=BPFkRgf^yQII6>B#-bmgt%6&jUs5=TjZz^tF0JAe8jNw6NEVRPi}1U9r|`n#&? z2#2&!SuHl7>h;NA;&v(vCXF|0Li2&HIgty?JM?gb`HxWz;}-3TYN#z!IzqHFi_3Ox z9&*>a>V3kep{F!c_8zsID0bM69zD6$QQT{@xK3_;;?y9E<;2mWC;tAwmWMh&8nh+i z(4mtbD?W;FxlSHBdg3F+(X*YFLm7YXJ$fhuFLJ#RmQ}jyK~vuS!;{+`A@AHv!A)U# z&R5UWW~vH}$YybbM89>`ex?^kq|M1+tZfJ?c}4My%{q;yF0@0av7FemyUlXKva++L z=44yj$+qV@Ej1Yp>uNe#@AVOuYF%~cl*%bvtDfBVi?ObG%6INY?tEAtAY(H#g9?oT z_7U@x(VnxWGrik`y!h85vY<6)eaIpy!YHX`PdA7OrO}GmP-{*y#JI&dKW6@@`JwZ( z=Q%rs_4hfVHPPJA9ImplT01`#h=lK)oafX8R}1r|9}pCps6u7NnY7|D;aSs7aPon3 zRj8adJ!4a9`K0j7hsTLuq}jyyy4;lDjALngw=~*Q#Lv=PmEq-vB}OrEv~q8h=`-G_ zRNgdWMO;q8k`gfy5QAY{L2lXfuD8;<|C~lqd)C{Duy^*D#du9*#v$~Wm?EIh~r(V@b`5&FYDe#8TDqv7hCQuAKScs?t`k_c`3zt;nNSK6+f&qZc`vz zUIlwn5HVg+(qzaUd)o}7OXtWfZtCP>a=6yUSxr&ymm;~)981pXVplmmY-w~g>8x*% zmgT;Z_F(Aq4~LD>M0Gup)*YR;J$Pq`Q5s_1OMmV9eOmYL)2w^g&%aCS{#}}NH~l;< zbh~m+nAO9cKcCk9e44e3e)dN={$73y@BEIvQ=isdm*$oPL?$9q()v6-Jdn+|O4g_Q zwQHc?G($8h*W@*2QqIiI*^(yOA(^G9*gKYuP02N+?as|9XnSjVtEwZ)x`p1Z8a1d+ z(x}4f>m{QUB`7#eP>B>(5TOy$$99H|$+FIGtlA``Tgs~&=Uc~1Yd_}-teT+gyh5u% z3ZLDLz|wh*4oRc5R6-fc=Qq}O<9R`sW=;N>A8H1-+#wiWK2zAGQI>Tj-Z<*W2;E zGABMbL}P;LJBA#sj6emuAvRCcvZs!A3;|44>&XJ=mY@Qarl)X+ChDH2VNY_#ghzic zwrqMqZi#eV8H5tuGUVRe4^oTM$L5S_b13Tu7mpP+@%eL;bN`y^7Nd7B-5(#)E?#Go zv`#6;I+KLz6k}|nHa&gpmfYv2YsOB0Gu2K$uzGIP?x44ZY!9w^PG_A=FKY814BZfx zo*}N7S^D|ct+^f3ExUC!ZzKMc{^}XbK?L#T#pTh>D(kM);_|VU%C_CYThaI~K3ROL zXdOc@(r2U>QZ>N<##dK_?-uqaDvU2HtZDSe^d-9D>EepY(i_jN9KR*ET?(>^QPCYL zM{eEpE9;kSUJ9$AuWIwg zzwd!nktV9QtE`dqhuyjR#USe-`myWpsog zu{P$1LIs37{Wqy~$HFER=e0%uTC-cVKVH%J$J8AkrQ!p}@qz!PchSvpaoE0V-o4iP zA^l#q!!1R&OM^S6x8`bRT0fv?(?YF>=wF(QG$6*8)2(mQgRlp7iIMxo!Nvl}8&b5s zMNij;E@TWhwx#aqO0~X5&*b;4ud~1J(K&WlCU<6{e%(!6S4(R5@1Zq7^B-(|nf@*l zKp*PbnA+WuYW+PuCDD4`?gbGYQLQSF`y4$j@RFN-D-mpcmYyLx`YHNXCKm!Vyp(R; zF85)`<3J}AA^(vdbvaVIn|)v2+}EOGx|RI~@tVrKlsDd=x}za=g37wC-+Sxnx3xu_ zDTJG&47+iWlFPsDq;QvlW7Pj5wYxgix=Q}?bJOhyda=KVE)lOQ%$+^GK(Y2uQDu_m zgISw+PcfHqZEE_BZFPek%KFt#F{0Xf;MZJOW_qS>?ItYTb<@jsmx0@1@Rn=e{+4n%cUUem?M<8-!gPx7+&GYElTV4&Oz8vi^ep7t&cs|Lzil z_lsE5tyT1!tWzYhu*v3^WL+w!KbZ5lc{|D{cjnjLMSr!={L6++%EdQF}tsy zwR?D?Z(lIY+ou!JqV(@m)E`_YT(5BK$gCSuCrwZR07Wtua3&QuUz+eRt@|WFGb9*& z(5QqNfEOd^6G+>w5i?NRPR*SNZrb0m!3XqzYc5b_+!y=LRr_51fZG> zF*J?I&f8mB5HVqH&ZN%q-SZml5TK(wEHg7XD1CgVpyKMfjbeDsOPzc2vbv2@xJEgz zahm!-KKF~tPK~NW47G{DIWsLq4vls@KfAHoTCw=#v`{SK)LFr?@}Fds&+I(#ilWY1 z^OKAk{5VA6XsjunRP5+1uJ5dFEUxUVw>rf^EyE_19ozQE`Zso}n9o;za`&A(L$TuV z&G(+{xN{DENSJ+c_MMLI^xd5+&p;Hr#6j(%nr?;dC%4?$?oyEVbJt0y7(OvH`qx=I zL-&QC%>yUPx+aDmNl4cO*X34sFRLFu{qCgJ>6;%IGJQqL=AdiK8XZ>cOszvRjEJxA zE)l~uG3$Q?25c_QCJicyQ>D*zwN6e8s+fDy)!bQUZP@B^<*k1{Eyy*qvt{PBv9I81 zS>x8qtutpgVp&U^Ja~JMqtU%5cB`Y#THWZXv}~=fx0W@w3<>MFb055lo~0+J+24ecXEIPG!Z)lLv0&%cPDw!)9s*X|_SIQo_`ej$>Qyy!ZW; z9XnO>!-Of2bjcrji9%=Fn(*$xk>Rr(}do#fatAzE9nEi)Hz_0mF>MrB{hIgafu!-OK>y_V=f zIZx@zJw$5Hz4$5yEawj0w!)4md}#d1-FXW`Q}-U)8}Y}d+#@OhrrV_0XVQOmpP^5`KDer*g}k6?dJK zNjMUt+S{O>r=IZ0tf7&%KV)cUQwbUEuUle=;!$15gj((FMTMMj12;#FY7vE;eH_ln zg7L#IX6ZH$Thwu9eV4G`kOPz*rx^(V`p(YcCr@{2vAA+HT; z;i+B{SI>BoRoxETWKKJ?rlRwn#6g-N#j|ECRNXckW2C}vR=wZF?Q+rV7==%Gj`iY` zkUQ9^_%Y+9xr%r>5)<>u-_;)tfqiuBxTh`>#^pLPE{h5{PY5@G3a-pihyBW?=4yw& z3r_MmLB&l7#xw&Xi(ct>nG!IC{Y`iqDtPezI3)Q{HUYrNHXuy_F|rDV(Pnv)LwZXmW#cWCgf9P z#_5!L)#}>hwk6@)`F;GmVarl(*461=tX}O%T$VDV>%)}pJ5sDlQZc+@cw*0|VOgs2 zD$CLg=Qh5XS9548(ickkW_uvM%L3 zcrPEO{2TCIcBfnw-pdOqmIqvpU>E$F_*lo3N9yCX?s9!wZL-=C<-yjE<7Oo*(Cc03*$e@VQTk9==^|L|U7QvT!dUL@{*RYCm9rwY`C z*fADHEL33yKvl8ph950Z6yQODVqVmWyh26vk+XGiwa@VOc+NdoFg988m-8MSSElTk z)Hb=ZY)0|Sn&OQ?x6Rf*j4j%N`kI-)+`M4yPWTp92OVL{hX=im(Y3p&* z?q1_yVJfeSCjc%mnv`;#3;(@??)_-&}72A~+!9rBk@!-@1g=26K7pOgUnZEBcx z27Lp#bX!8U6z<(>6W42Yr3ABX@Ng=hG8^{@I7~)ur0+njv2~z%&#M*hqt=+I`H5mc@osX;=4$#vATd-W6gIm?3V_V8G?>|JGI6duBz5pgSXaLgSXaL!^LWi zHC$D#G1Ff!v(^|675v4qaihL~_$NUN&Zeo>On+GK(ytR2yz03Yn&Mc4V`D=|ePh_>m%)SCwbx?(G ztJc`h5KoEt$1ABdCSe5zU^bGTU%WfttuZoCn!^Ch#@c;RJ`ytIa$`(4<+5oqE515- z(CofK1ipe2eYIlx;eW$klZ4NB>!uz0m(?4KXZ6PF1YQ5(@YNdn20WOqtoX`h*BgTo z0Zcyddst-?*_2$m+E_(2t2TyQHi+6=Z0zS$G2-TPVA>f5c%mNzyx%xMBiJ}4^X1=8 ztuf-G5_$(gyDqQRSaS%gHReICeL$@-+|zsOUzEsdcjdLlFkp}-vX|t-X_r-`D{kpNrQTOZXbOWZ%tNW2Jt3b{VzCnvZ^WYIR*rt+D10zdQ6_R;{rQ z2H52RwZ@wN%<5p6-lqBS&#E=nb?)*>X5%tyjXmkBf)NBm#%hh(mvDApt+ACfi&1NA z!#AuoRzI-Tm~UZYwZ;Yra6mCos$cVxzkZEr8RYm+s5SO2*RQc(x_-?wtk&3ftbPrZ zYOMqgfNVEElI(6EEM-{cub?)E4JRC|-q_6eZ>`?gDpqf-&aQ(ULjPt--n#s|>y0(^t2g#$ z9L_6Py|IOT^~Q$MA*UNPEqHs?H>@}I-?B0Ozj|XRb`6#EIr$f>H+JMI>W$6w+iTPt z>u;`6p^-d8)Nv;74&{hs2hX=5IlrIl_LJ(X4f!qG>&vJ&_M`uhdSgG3ZCrnQ{qL?f z#^q|`5Sfdel;=jA{jPp-ZNGwJ!bJ;?(e-CjLN1%y-@kfeo)xsup#`?^dsA<06xDqB zr`8)o^{9T^ze^V8isS%O?5j5>jJ>*gW3d;mH-?09s?lXUr$(1dncr^pE45|z+pThM zy)h3kjmYr%wzZe!%Uc8%`&krF8w5j$eK{2zL!}{dDoAgpT(I8QwQR0`kL!)q8N`MQ z*Bfh~dSh=4zWRD&yQtoneR5yDF}v|%^~Qwr)EjFOyI&Cd>W#IC+f4wog*u8;$*SefO*;j82QL&d_Z_F-Sve;MyD>l|ZCn(W%H#6PsUu&$+TWhRA zt~J&GrT=Hu8l&5`z*=KHDP)MewZ=w`bF&m7f2}cx2w1brtTo2&@pkvbpDlep!^yh& zMzzMMJJcHM8HxVV0{cUWM-b(_K&>%t<@rjDt*g+Y99FWKk>xKnW*>!x(pzfGp43-r z%oKqLz;g~(tH|mTLaW${%vM`eRakfymiLnuc*!#^~dUrC4>>3r3bH*d-c~D3l}d?XADKgj@Z?^I`>#)2_~RM z+39OQ4Z6;mVmWVpvG!n35~Y!yQ(tTl<(3817h92s6b|I?wmhJfd*3I(r|J0zt1Z?L zEPthF3e^_ducO*xzc0B^ZLxR#wZ-JIK!LL8>@O%NZa{6ZI;t&p( zLAAw9L6jl2@_2u-^&J1&Ag)6VHDo$1{#=)+(oI@J`9L^2Vuiy5=PCP|Q&2x|-LSu$ z^1O43T--OV?1|8Wu2^pz1q>D6F2KpBJ_<9rYI&JmH+S9M%|}j?}m1{bf~Uq zZKU_;-aq$IG;TxO_@ng1`iRb=cXjZ#)O75tId`hzP+dgB*4?4$dplnZ)jH&^+^HFx zlX;tq{@&0~7jhtlv;8#P_aSHM4YhSIqsP@F(4&SQeiXS$&lrAX9l>b(txkM^(Kaf8 zw%^LM{hHDC8y{`fLBp5ZI7h@Y`k>Vz!x0px30b~n_3;rk4VK1V>1wmD>Ap+X^($R_ zV|wFVx}LK~>Al`q_MWBM(y8NY$(;4)I*ZL!7mVK=zqVNJDs`O3kM5MAuI)|qM#@l& zt!Y`q8b6&G))TZo?3k$&e?)Y;76;IIyG-W~8J)#GI-i-8Zv7i;l&=$KvPSm@H2R_3 zC|9S6u}<=}$<6V~J%^rP+#vTl9u&1!r>939S`x9?pvw-ojM3pyRyCw~vrn3A%%3r2 zSog3`rs~8D_DOrdC&$X4Oki{-`o3vRqpu{>SCVZyeN>8)xc2w=4D0VYoj9EJ7pOa; z++PIiFVfc^@x6sL3ekx%tkFXOL`2Drl*D(CuT3uR<(sD`m1Bly2)cBG%b^5O&g2Nq zr1UIe*)T6cGZ^uq*4~l6;d7@%Ebg!@5653^^CNuPX8m$xKgo42iO@gs|N4vWe}{V& z5k4%_#SH6xjO=$tiibzi7;g+9`=gO;o*WoS^W@L;9?cW$yYw92wN@~Msus`JFT{NKcAT0c^BGn$?b zplPd2(^^JTt&b+_20snSw(HD;)#hLy+nh!(^N*k;O8fH3SkJz(WTaTlzVS-HH=Ob} z?q}clZ{Ig^?<2NBFdH4K#s5Wz?b&-ntaf_OgE4G8pzYimk)FLvb1JjLn7%X@ytkID zenVSR7jFHlwof=E0m5;VAQz}}lOp4oHhp}!OP*LI8lF1TH}d#u1&PT|zrlK(X55Y$ zBgNT_{&xfDzeA>f8l(RQKKi-bBHy?b(X;8rBa8K}GMaCWnc`zwU2=G*EdswK&(y`= zXwmEN(E|FY^@sF2{!sA1vnTk*M~OY%s9gi*=WC3f8%ByZ5n=@+(zBVo-NFvKBi>` z6^1uuWJ5#ab?mj2kzL8`wdj!*o7roP-q)TZBmAhpO)RwuWo?F!?9#F}AtMu-Seu8v zuhoO|xFqEj=nOO4KqjbDtY*vLAw`oF27Z+^;N zQ;zI9JAz*OWJJ$;dTqx&?6t7vFA$w~`P+Os0&NblHeZhDI>y@kbwqPLwGkJv*ZAc& z8oKd1S#@s0;JqCSx%RW66>N+=BgDNUXp9O2#^~?}W>-2#kX`Ab_t^UTyAiU^|Bjwm zi~GiCY9R0bk1cu~jKJ;@UELsXO5?L5npZL2jeb5}AwC{wuf05?Yd3ps`-p@G*=ysy zudy+@(ch+n+BC8@9V5D4U~OC@daBVz5L2~wXbK`;Waby2N*|w|ZXhF^MG~me|i*a82u&-$KO;R_h7S|+E(BSag?Y18Kca#|24;cdwg=@tUnup zmB11F$tkObHU6&=;?G#)69J7^%8e^WV9lB5Yio7TPe>~JvD}4b&^{%SA>7Ghtzp-4?RvR$&r6W+E*F=P zIReX|A&x^10zMyiqqT;bellvuEK2=2*qd?vz`p;RUeGtHhab&I8u+(+eBWh%#|W}@ z&tTn2=4Qu;5n?=vuIbGH(cL18ZYY!cFrVx=YxoGZ@O^UJ`Z#NR%?L4^H9io~I9+ZW zOmYwPwM{n577TgeH0F=8=DowkAlCe^0nJ6Z`B%efZk(p~SWIfhvEdNPc;%VF)>W+W z{|*Eh}hhB@E2Nm-l68x|1`X~#5FI-@nl)01^K&`z9H{;l5%zmdhy~xEnY;}@k@nI z7QUg;w0FhQOX%-7^{_CsbZc<#F8Ol>cWk@E`V&Te=kQO%TnBYse`9=h(zD#>2-Q*U)a9d|nBw>dhi=To}SO~h3*wb&`R<3g;zr#H)j%t6V~iJxkQ z?+WT@e`S2@Bi0w_d14GNJkd+!)vyj7)FHjx;iyOZS!iHKF}r*NDH`aL1_^rDFw>I6;LYz z?gE&|Ih#PM^ER@x#ym9?z!ha=iVC+W8c&Va|91F$TgsWU7Er0wK9>PWgG!?$XtG( zwm}%E+P_Th)8_D(B6Jv`G(wF_!Ji{|vtOb=FMyN%NGkqZq1RP-bqHW#UrC`2#LUsB zZ4#w?jz}Ab^aF+2A$nU(f4%|Au>mJ+?9Wib^&cR#1R>5Ob0C$d-M6=bklHy}cPGOy z{uSL{BaV{p>lJY}(!CaMk_Pr-QmB@sA0XUABv{gY4uyK?{(B-V2Px%5GL3*2iT%3w z(yIEjty|9p@OMdCR8P{CvA+kt-E#oFeT~Q8$c@KF^~qF_l@<2>q*OopGXX-RHoTK& zT$E-UiBBh*(F%=cbRYOn91)71jpC9?REzdFkwq)w$q4K`}>8QHF$!Nm6>RbQk%M|?9BzTsv$W!7-1I|6g(c_OgO z1Y9gcpNja`M@4J+GbvHNn2$Pg_$P>Kovn{OnVJ;;wQfy{5fv44Ws_7-KP5U05iwa# zP^#r&!Xdw1bAtX^xg;oOPJgNwhe;G!9X7UW`XC~g71VwBJ(SMQ_QA0&tofC(%hai! zt7*vMUP|C|r~(ca0U&k|r7NeX>Z)))jem!t?bnjQD38jLd`|c=E!s!@n1-2dQK7ot z&)BaL&0Fl^OLALc|B2qqS*2w;@lD#XSn=z$L8qOUz8b8ju^lTMOXD{xw(+2mp_9L* z)hkMC{m0iDg(GR0vc=)>a2fMv7Q zp9^WYSbhwNNOioi;6u4A`P&FloH7K(?0oY$mlAyAcyQtI!TOQ0{OxJ0b!E1f*7jQV zvZk~qy=6F`OT_%GX&Jga8`ARwq{QSSH-)!H$W!Xcd5|Ce7K)Nxk>0bi&heRqYTAzx zMh1mAi!>^hJ-|tr$^yP0Jte=A?P{0s`o&kGew2MvTCTcil_}eV=YS>b*zs63>jbbq8cXQB{Jtvi+aW{MT#-gWvDU!{h=Lb4z0 zzDniaqh!KYsddK@-`^`nwoEwjS!(Dr#GkMGER}zo;vHx*QBS1@HKq#4J{Iur^d5=$ zho|$0QUfK7b-Jn1zf(3tT~jK5FS%FNdWuD$Xul!*om8^FA-f(=>k@-CVDPbQ+GE3P z>{1VtV`4nJQ-=*@vHO8j=j7YayeT%#-jSNOKzZ@8mR=aVvp1*Wa)C~UZRw0>fh~Je>UcH$j;|s8FgvNH zXIrf?wwB*WLC&02o8`}1IBrOM=#^CQmDKtTe-c)tdbj?uY{16LZXq^hdbM3ets&toBlR- zY%ar>68ixd4-R9f4!w9BQ&?b%rmMU&P$ixCqjx@uPQ?yi6kVJWPnGt5YP7@C zj^lhZKU%_P_TuygV|wtuK_t97lKzl8#oPw<228I{RPGE0w-RWp2l37@Iq^x>zVr#Jg})FND8`;gQ;mi(>L zMpCycwGV@&{JU6uw&oLM)|s4MR+vvGM6;g1nVvB$6IlNpKb*pRGX1q4y~YodUSp)! z3WnEEpg4tt0)Hcu{Y}y>LTzU;>E`?^bPEnR?(?hcajCvJ(zqh3mZXm^)urp!?noL$ z+Z(aJ&{lsw#T|e>DXG zxXrR;Hu&;a=)b}D65*nJ!-K)s$*~UbJ?rr3Ig`T^i|9_)&Q`XmmSe}_JoELuPj&GQ zzYyhpq8o3e<_gDB(saJ*T@?}4=19uKwfl4pwhvMis%qC;$x65^wVhYJH6O2c<-=Pp=OaD+ zoZG#S-x`epf8Xo`XDal`>!wdG^l?nlfr+rH(v#KmOG`J=MkAxwuE37Il{p4+#^uYWZ{2><`jy${pJ+ zd(*mQkIQ#>Xhe%^xB_AdKd(m?!w1;rO!$aK_7OVzj%KZgAI|8e&tuWN7Io9atA!@n z-GrA&dCi+LzN;|rlnWE?zUNo-?dg&eoKJEvuJEMz&>S_`-6=Q^SGj+N)Rw#Qe5fm-ZaGAmXv4i#AZ&Wp`^@>{3s=NP5OI6DS?@qR5ZZ+#XrP?x_v)NrK zzI^g=s_Il%y0u|w!>L{?bsIAKNHTRAZg}{=5EVWKQ9I{$N+Qo9R#8de|FF$hs#)(> zs&)H0ojtyrq^Kb3B@_|Jlk<%T3f9g_8LC2K<`pSJpUD~WzR4<*ddl&>#@NUJSN0L~E zORn;;J`a8EqP8Pe9_OHuOMAO+t1A2|+e~d-jO@Q~W66JS^y65*hU7)t)3LIDg^xh2 z(w6TCkGQcdhn_EY(=+%f5=d=1$GuhMiT8ODGNy2GX_fV&<$&OP>6hD!SiYi5cK8mG zjdDH=R{b4*2JN@QA4?6m!_mWaoK+G#>Zc?tDn968D$gF&WNljrWBr|sCC#p+&X(-@ z=T3cnvtxq?ASIWp9+rDM|7ddQ5-bP%F>CfSJ`d;f$NG>3zZSX3o82uR!3wrH1$~l+ z(qt>88|bD3#+$ z$@fr)E%#0qeif;N$tt>pG=2rWg!(Evgctpq4#qAWg6Xmjq(E#>1?r)I)L2HXQY~2p zy-;4~I(evqk~xfJXtF0&B>64afe(6KT<@rT7@@5+HKvkyHCz; zx4cf1viE~6YU1!*MWR&p-6bCBCecLsL*4AnAG1{zQqw8D^G9tCWgUwD%!YQQSr_`$ zCVpzG7d{d`wb3~BVk`eK#T0$Vgg&x~A0p~w;X|AALMwmB=IF-jztQx2ZQ=nCH3@sA z^gp-qdzAF=*~C4FIw-trbDnMGcSog5b7%g|X! ziGC0@2ro+Mzis7Tu{mtgv{xF7J{zU0w27-hS0_{woip6ZS15AIZQ@Eq)eFzqf?v1t z|Ll?e$!Pk;Hn9RkwZdX4{fSoo2_^mGHgO4}HVc2T1;1+L`R?iMf3%_5Z)QXDZQ^1O zZ4l;5>5sMAAGbM7%tQx9RFZ#TU2aa4cD7A?47C3eW)rRVXsi8^>uLG>qIwnC#JQk- zNhl)P;AgG;Jℑ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�dISi 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¥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

    C*xFflyL%7c*3gt% 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%0Aig_lAvkc+_$)YH7gL`2Kbi?qU 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 z ==FGYF~<23w*OeIx!QaDNo>xZ^+F^*04>M(7j1o=jG)_wUFX&E$-KN~r*eu+EY zwd{BoQ+Qlzo9mVS8dYhE9aVZ9o@j?b)@6*#%9eqF0Y?lO6Lj^sHb)vB+Xh0%=Zt$o zrLAF_m=}@&h~?Mzx#L}MGvQwBaw-J(2?=;VkDF|Sc{{G}w%{|w!Av}oY>64*Z;JF! z$_oAwY4RKE#mge`5hKp6#rW1Frw*NdJ>(<1wzU#L*3O;xNYHV%AVgmu`1;kWL(_X#?f*FKM#>E6@|4pT<$#GdOU`|ew+ z6u0^_pF4B6a643WH*X9ybnQmV^&3#cnn@ZmRcR7TMbI8gA#iyQ0XI`@T(Xyz-$Pl3 zy>AK&wK19N4_G1QkXjpJA96m79fVYNQbv--K`ZUxtH3qzlLU7z7Zy7 zF19R4tVC!!i8Yrpq-{ZwbUD_pAvVI9y`?V-ATB;%2u>^cs9k|T$+PNxEwRze4412t zjMCSlGl_Qt|At>#RTFKf=!KWrRtlzw!8)@uQjrVJ`kwLstcM_@!JnjetfEV$S|q zS9^QT-nh|HgE{jjZy|yKD6BJe@4v-9PDB+?kgoo+u}K;o4ao5ax)KjUR3hS=zxZbm zeDm535sQ8&_>;C2heF3OEHvwcJomHR`EthzX@UILo%72--R&Fk!LTJmSzLUn_Z~7v ze?>E#jCvsyYW!BT_{_#qMr7YZx>2m zQ|~L^Dzt19c5PY#2*ichohx6QIna_`>(CFYvjcDzC$7@>Cp+{*-TH`@jY8$p=PZkf z98|ZZ0G>1+Z(?#^6#yh|IrWrB=T4{CF1TeM+y^ay4tEe>3V&sdUO5FT_f5}|l>yR} zn$jsU7l$!(hEE85U@GCZx2Rpb@rxe=2fIv$39!GeVp?18NnEnKiK+3KVsbm^vF67h zSuCAdVAY`#5ihzNyDMxy_%(Y-3q=LD;;_5@29UuuV+hQbXAnL++SmlxI)-02euT#} zZ?}nKxR}^1t0XXLOI-v3F>nAzw_F1UU<)E}nAk7`R?Yf8dTgX?#%{}Jo!sXtkHXHu zTptR%+g?<`$KzPms@JSZYhoNTb=KTa*C(|ALD!gl`3kIXLtK=B1K2rYVtYcsM7@QW zXAXHu%hv(~nCdNXzcAF(f+26x3(-??OZ zQ5r8Yv^=r3ijtv9*9KA+V%*rMWe8(P7R*Xdou1s0{;S}R+@e26BB#*+z0qP95l9Oi zG%#B%%)V^KAw%y*I)`uh4{eW$ZK8?c3nweNtPgE@4`MgJWJ@+<99n8J8sfN6?js^^ z@L$`Ce_cvqkD4jpoy+XD-OtL5a(fy%l>6buN_)=)Z+G=Eu{FL~`&_F?H!;spGT?ZL zlfLTXL(ryef-VhV(nKG;LF&lzLJyZF0>-3kEHjpc^(*q#>qD*g>)87jSX|GLn(9BY ziMGOSy(W9OU9^gIJw-nFS~SR>c386&&6@gs5Ej~j zWA@|MOmK~biYplA=3goai_SB}UQ5#Bego~9Bz}f;WapWfaZ=(v5sycn#^Z0|elw@b=AT{!%^m}?96%pjo0gL3T{3a zO)v5ibW$Oy#CdSxbrFqvrILR!ix$gW=6#;wt5=j*ff(M~;!sKTn*YaEzqL4c-DnaiIt%?`EhXw~k|EMVth-!yFR=?e=;` zt{bCk9I-d8BED>1^QzJDlTzk2v*+j6KS!XKW0Y^YOC~HeNhQe_l(WWXekG(68EEEd zVb*wdHnb3At}jS`w2?AMZn@T5y5>Uk%`N(>?1z81l;-ZgQzr@jgpG3d{qVLV1?-jD zZ|xRGK!~X29ryu~mY;{F6o=`czI#BV|66+DBb@T_FB!hUno;GW-vKMqcNzp+o_p~k z_e?$r#qh`k-|J~)&EFJ#fWk~8WouE;U69V9EW;>LXQU_0GklVHqAVDAjg+GTpS=!EYIwsyy_bCy95);n*wGUu z&V6FNbAvK<$f&?G)^U6hS0)xC^loey(tJ{C)I-CUU!=lPiaahTyF*V(fH($Qy$FIRYXeOpL4TUPLZ zqTm72Wy1kBU3AJukoM0))W1L!~q@k{Q|QuLS|EPY9x4am84ecT*MNDf;A?*3`O5_5QheSyyIKsAktAWpJ6IE;(gD~DR(@l ztNO~r4q|?zGY!{{)BR;Y(k93du#x6P4Lh+6_Gn2M@eS&{OXlV! zLFX%|Yal)F`*c>dBMdSFf22&rl42cwY0juS(;}U_#ETZ{g39pQ{m;&SiMMYDTcO~Ok;ZcSRgD>>&BwxgQPIqwrnxv#e$v`^BmM6ZTe6TQvk3TcnYWYF5g<`SXDxE;iz>Xup079VHbki0Qn>4D=IXWlTFfGm~)KmkewH^+$!R` znd9YL+Co6y@>@YnsehxPnl?zl&pC>yNY1^AYTEh9R>T9^O(4Pcw+-K&HYI7`)qF=d|a>%m!?9orOwO9pAbLJ@2lPMiD67;cGWe(Da+gF&wf z{7hI>N+KTqKoxij+XwR)@IWI; zMY<34(lnw`+{D(ha6Ras3ke0%%g^+>KCi(Ts+C2n2|8F6w9hF&(d$wWG(pnIKJQBh z%s$!=JL38Waz#-GS+gKKEFE|+HKEH3g0K<<1H+(x*azeUz6hS|B1{?X6?Y<@k5I#7 z6Qnt5hzGI|e+gd5DI};Mg}C}<=?3`NNuY3skB&PBJ2M^Sp|8aZGQIU*+!^r(n|7$O z;R0+HksA#`GZ^WS`k#ekd7-1@ki$kND)&O7C1%EFV%YOI+}&QP0TRvGu0za;z(O^0 z%i+C-O8iD(!zSgCa`MDmd-}@ZR<1vBXN?UtkedaY523R5cR>mbRC&APTm9crGV9fw zaH@y(9sj;a_hBwvJp+7j>=C}uX(N-|Kc|6PK%9LzMZ75*WCW4(y36f?S~Rrk?|yYRQ!0v{$wqbM7`D<}rf0)jLhn=H-Iq)2lp z@}p!Fi@yr|@^My2PeEFzAZ%MivH4bMPBwmLK({W$-yHk|;Wt4Lx&`=KE`7{$L9j94 z|Jdlpb(t-vFRJGcR%AzbhR%8xlwx+ovqK#bYI}t0p)3ba;*eLXbCzgs-%0ZeH$B7R zCbiJf){P@~mE~HT%F7p3T5vO`7F&Wl7?+0*TH`p{iyZAy%?Dm?F1ykYH+JV{=gikR z{sP>V236eS2Ly2XR^ieI0@Q%wC59xC{>{HHXW@j;8ibRBm96s$!jQirq0ZClBM+XZ z2WkHu;tNw=4pVjBZ0_v5QuJX=)jLA9s(Rza$a6ouTyH05Za*@qUgwLH)x1?!(+s19 zqMu^Ui?NE&!KX-k6oLkl+I?2`jslJAs@27*6#sU!Pi&Y~2CEX&r%>m^)Y{iW&TpfG z-Rf_qHC9Dh}qJE_a?|+H-&3 zmkQUZa_yna>WyUNm0oca>C-TMY6UBt|D^NWxk7ft57Wl{zLYpV8Rb($AxwhGJ93qV zTOp0>PL)@yD_pJHV6Avy_1!HG3C%Sao3>j0?E}K}n}fg263*3VS~k4#ZRH#MFDqPg zh0AcL_cq=6p|0~&UG0$Iz;EO_U);n-b>;H6R=8#fjq5HhJyl-ex-4ovX;%#JTJqH! z@??o-A!`KmT1xVm+)L+=C|S8TOj#5kqq|36#x?8iVa{Bx$n+g7Vn^`tE6$h@&6>UG zJ=h7g)22ZiCdr#ga5|Hm?M#y3p$t_;{k|&H zlP}fJenXe1(+?G3Zj6M*0}UmH{yum9I`)c5uHZiE1mQMnH+*AIHcJA0F30MSP&6+z z!>WreVE>U^Puuwtvz&DwJFa1+$6{8XX56L{dwWwj(nLI=2&^_zhnvjrFce!_O5;C?+>n`;o(jM&9@%F|*H|uF8@t0o6 zT#u~?tzKtVZFr2S`@Hwah`NY3N*-fc){u2!$+}F8NtmWDgQ#{IbLO{-%*$k5Iw!6; zljKtY+b%JEqAuOUb$@t0NMR^d?NwoV%dg^{cM=6J6OR((>)t%IIbD+ECPp z6{9LbApk5t)LWLsBhxBrw75J7+P==jDw55yzK=-#Fdkxin=3-gJk6}KuDN%Yhu<;v z?((bEB3~8835@BZ&fs^fW?f@1t3;NJbGs7~(tIq72+y5|BnkR-PR5tILNcz+$E&ux|Xo{9^?S;#K4@ufHFpDN*X!20j zt+2o~@i~vA4bn;kHL+QcsUPrMIj5FP%6Y7;ERQ$IQxIf@N(#-Gqr)sfi?VqIqM2|c1la*WmKS^3XHru6 zl6u+!I8xpLM{xv>GJ-&aBa$q@W1%^ZH77pV3lRX?MJ&!Id%-X)pKuB>OObFp@}>is zi$ja@ng?<^dy6VHF1is5_y3XeUQ(w=nmhaboP1429?5ole|Ru5heBa$6Gt}w#R?1d z0J@Zek;RjdVN6SB_F{bE#(3&!p8dz7;NDQ&F(z?u^lc2{X1sA7JEB@$@)KQrq*vb7 z8+=6wP1MZR1h+)`B!O!DOHLAeH#ASGN#1)woI%+e9H1Y9hANNft(8_Ne?jc> z&2GM-F09Yn*Q$Y|%!M$T0BPCY%ud0tgMq}TN;+4{bCDo6{u7gL1% zpcFy+rC&w05B~rKRTsK$5P}BQ3>zh$b=78^CH@A+8msihO3AZNUMvA6u}$ZEDa6Vv ztl}j+SSOW2X+S$HN8izJ*RMU`AZe9Epy%bOT6Iw0)PHX%xo*AB)N@K$X;!GQ#(5s5 zy1<`=$iLC5z$dS1=P*WZbr`?Rz>nVL`dKJ~krb`j>GdDo%5SkMQUnLjm;IYT|)zH_-s8RNwKnT2XGOF55`R z%iG8XFGyd0vVYr)bexL0x{Z)F_R#?2YJG+q9;QH)-O>1C0YpaKo^;x~Ed$5xIRn%xIQlk zmmceBagz1fB+hH#IXN8mnv7IJvL^4sAfHi$EhjTYl{LB(6Y@(6?D`2$2zLmd4yzyM z7~`+q%=xa=+5h*t&FX1+fYiTUtRI(d_e?VFcnD6OQMIa1BM1?fycLT1&qX#4-?e-E zn0+FQJ3R#EOa#IU0XK`DV}qhcXL<+$?z+?-uTfHVYHq7~=z%FZuq--wiO0;2Em}Fj z-JYZWLeP15qvA_0Ug0D@%{}I_*XQC}y*lE(iJ|WHr^=6zX{t~}RaPpX=2U)=yn2mA z-h&cvei15b<)uxu{~MGg_kceI`BS?9`s@fdt?4)9#JAit^)Sl>Mhf1nd~p;mSAKRY z^ulzji^}gN71t}|CY#J^3$cp=-S^&A*llvm29!yr??XCy){QPI<9I8XAJh?K)%j2O zpz{Xh`KN+>?G{9yItw(O4l5gqxF=WS1)w-s=<2TZmM&i0hmw$x-R?8wF@_=nf_jMuij zBcJQYkGX7%KW`iB%^vBsjq}?6gmADO`I?UWP?*etn z2|DxLUP$cW{7h%v1=;r#bOlpgSv?65h`1jX=bxB2z#TF;5kIEFQmZsqnv)X7PcVI? zX@O335`Rh>b+)}Q>d3)DHsbWa5p9ZBT2l#n2<(8mtgOL4#`!!p%{1I3S9Y_J|54w8 z>pm4O{jR&aD==H z(z+m+RDerEcJMEihQDt<3*`vTH@|L9_wUBQ3zr_~Zuv9n4P=S+Rz29wji$7%bYKa3 zlU+CckNsaOTuSL~v6BAJ3HG13px4&Z{zWLVpl;G1ixdl&#&@?&Aimw58Dg0wD>KM0 zQ&+0u6w^gFj|aLkXpc^~spPedO|Q zjaSRgXu-1~qDZe>D6FN5zL26ma10EEDMo^d`%Dy%>Sp@X*nf-YJNU zLNaP4bDUn+hj%o+KrD!#1iV9zCBk3utZkCQhK!wEOMA>fY2_PxgQ$ymDJ*iX6YB?_ z20jPM#3|-BN=2-wDSw6JtX4$TR1`#2zM-fr=tlsqA8u8z1$9tAlK^WeT*$D>0Rmw+ z%y9jan8vlPpL_bq1DP)-#9s$5V4x3Xzov~~%xkN|$@w#Bm*qkawB}7x&CV76S({Cu z4-VZ5!t5Qv(7x)q^wF)Bk8eTVFrKWRAq+S^17{4}u?i=#pM_~)WqCSEl;PM7W7e4SM|rTXM{@|Z?$YfS;Oc)xD2+=EvA0)2Bx5#s&4Hc%Y7nT zD!tY6Zw|tT64K-Yaw^}*ur&0A))UF!c8-2WmDV^2c@@An? zRrZ>uasYry)&onNlip3)$JeVhdG|fk(kL{Jz&Y8pRO&rSHNmTzRT>9>2O90AL{_aiWa^l9MW=q{Pt2Ij8ampb5^`Z0)`p9ac zTf2&Q3j<3UEa>w>8-zw;#8$##D27cCJ*YI*Z5@QT#_U>?m2i>Mryxt_p_>&l?F^Nf z-nrGFMrRh+wcq^1+0`aoYPs3+5xNriP3#JV_7QX*G$v&7uI8J#jClEVMSIpdje=*r zmv07jjr+;PB=ot|69g2HZ(=u|4t4`QU_T(WA}l8TSjS4gAS-4W{9tJ+^kmS!EzWAZ>@DZMd>ae~q#{ zdeae$-AIn3tOh#p>n3h%Mcw>AuHii4QpU{|I{~MY!8OdBb<=C0w9hF`amvg;-^`bq z_;ne18aw}a&YZQm>w7SVcJWSBx)zED{dvF-zpMbP7OlFPVBqC5oN7G#Ydo$ zPi4ImhTfGMZ^G6Z7eeg~Sx1ZJJPkLt5%n#@eJzmzL1kw0*SZ#LyC^UERa5%ci`sMF zjgR`(7e^?D4n5PJSs%*!KP1bF<4;^z_}C-+;W4<=wGMIsa>8Mh7=*sPkkj7;mL>30 z&1mOPfFHn?iNr9zb8No25LeGFkha>H5>hXYRerpG2X^P6wl@HOR5im!`HKjkwE4+< z>DB?DO()w?U7AF6a@A}SG|=V0uiU)elN2Nc693hm;Nja9dyiBU?5#X_2Pt4)@8Bg4 zaqj%xy#yvo(aQe;d)$xMRNQUl9e-S#fhG!rO+=xIsQ=SMN3i~DV*Lo~M+MpeULAEG z4yY8~L990QUTVD2vWMsw)&&6!ClTnHhS+ibk5TMoU0t7=*qvDJ?cPgo-e}o*12m%H ztza=r&5in4D(i2wiN_2Pzy?A8s({c7zgq%~IrFs}=?_wwl{bJgv`@>xaWKD@yZMG$ zn)8?jz?`#nEf_k6kCm?1Zsb0H3l*6a_);yylOvzHlXnBE*Ay5?@1C{@pS-$A$QHjs?=4*2njyFlE zXMjgi3Ppn%l3QOdjS%AVAer~3&NrwrNz^XxqBR@i-oU01f|?l2_NH ztrr=BeExnuRuaTMBGa!Q`vjJW*{a7|c?pnGAXjD;=M%kLRG4h#>ELTW-t@(XxW2zh zaLZ2!@dfru7;sA!iX-h#$8K^(S% zy=ey(GYZ%~$&InnDl+4odoW9ZHJFh(b%(qD2mP^JxU|2k<>M~w=fWUR_wVO1eh-Q* zsB0p{p!Rv^e*U{~>AkL m-my%-bv~81zS@i5ES3{32A|-7+RG>;?M|h*v?r7EO zRpooTyd%^l@v*MAd&rkvcc>$C zvuVO!r7|~lWy^B?U2aOv8c;xQ(TREOk94;Wv=-|r%GYx;Sc3y4|(g#mV zjub+XiuSi)#|Krg{d2`=f6#JxU)(iRzA~{!NG={>9%>FB^@3zp68o}4D#^&w*+p%T zVl}mMZ~0vvtcPUSphgCKF3Qt6#LxXh&VIRcp83^AY1>t3<4LfLSqmw{UJ=hYAHW|I zSd-yn4GS?FztxTTU*P8vF2#1W#F6=!EzSp&;Qk+D?*iAL)A> z>?=6}C=_UuMr>)BFn~gLYO2MIFh2@~`B4bm=(RsA4!7G-j|FvT(|H4-@a-vlQuFuKJmwA4+y@{wC=_qki#XyRnrX*2N=3y z{}3O82|hl4Tk$dQkq2!eGI&UvPp#NU7u$l(&%+I&#cqi*t<~DvV2s)5h`hyD^A7V( z-p#iJ#vJ5=d^33EFV%@;aK?84Nv|J+$M-2<7nfFrpR?l zT*js7cLh1y!`_l#fpAUgq!s*nb#V=&S#X1eD@>au6a(0wmtdSw$L^fdH23$&@(Us) z-SEuBi)tfC2i--=?v&y2VZoWhD3)&>9~PttrnEkufpW~diC4iJ5F<5FbCCNu<@!4r z3=<4T1fbIt<&ZlEAYYBY;n9)q zhly~WK==|7miu$=^Q!B(SO3*CZg7VDkijVuk>amL-SCXM!9m^_DAuJa6K*0zI>c$G zp~HHg_KrsN%BB&dI@!4VwWnP%Ulgt?Z+L{I-j}_lDL;(^M~*CoT}#! z1a=YaO=mJI^>4goCYrKsDp zxEli4b7Twv?}yL#B<=-hn_s0ng6wtnz{Ufr&eyI!)qUlrDq}(S%CS0vjX+A2>WB>|KXd7)H<8!{Vy|wqOLh8>vq+-@0x=GY_kKKXA?$faK7qL7tcgS zVG9aqo(+GDisspOu~HMzc%b^9Cd>$ezd?SNMX=I!KY7y*;B+tUCQ#7#^x(VHAk9C9 zv`wH-shFD<-~43U5JpeNEfF33CZKMrG%0`I_%{(vBw-$1zA5WRr^gy@T zM%?|bV08z@@Bjy0+XaONG4*;t695}lcSuY>gqzli7|Q&@VESP({jm11Kny_5r9Hf8 z+l}T}-8*95I|$*Y7!Enu(jGSU2uUhBqV1?TkBI6az=71Juls8JxONu#GqLKNtb!N0@5AZZ}0~RW}FzrIs@eR;dH!sD!k>PgD z5LUaT+Fyybh|v9i^rM|sbZMz8a=e@g1J?e%U!*heuWW0(&m7!CjY_Ag9BkVoRAf3; zBC=YNdRa{40XCjg1le|-)6(qkOq6wQW!l@i#t>-G8d-1Lb>00BIX)m>_LBcC5L1-rc>HZ<;e$laj!Zge zN}to(%tkiuYxOP`m5q*Lg13~1djzZ`Z7Ki0yqRALf!R`$X$3qetlLI>x8TG3;6h49 z2k?v3kjLN&?3_SJt z4sQN%cDl?^^cO?XTyyqzEL$du4GTAMYEEq0xX0iuQW=UuyssH{|7ygakF@ynjW$cZ z`nEIn5#v>!m5!Vl8tmv44AVzqFs^(a>DqUAU;ZzAn{?zkh6QUJrg9t=Sh0|IAt~fN z$fK`}7e7xo47>^8)Ct&pjL(nwbm7BH7uQJg6GCpGG^1<}gh2^!_-Qh3k+b5tqdShy z98bAc`aqTskX`**@Zbh%K`q)eNF|+%iASnP4A90)eAP3a+r!1daS&q@o7k@lcRlB; zpH1qY7jVPX^<-^v=zUylaD0?xs9QG9w^}E-O2ySWL$qHkdSnG+Z^M37;0y%#-YgzD#+^KTCj3d-JJs$aw>WpJ z*3~53_%0qRZpdvvpKI2MLAmSuF_jpZ>lDvPqwsr=8!K&kG|IWQ@=Ofuva}~iI?5RT zP3D~yGrhIqnlaY$p)+ls@UGHcs`kfYx=|79CNOmer1@pY@+ z^{R_AB)hxqr@7dpFkr2>G{?5Z9JF7vB1jfJYWIcaqBgGRsIBPTy1yEKg=dP+mmHS_ z@UF%ro=9}bTa3A~b|&ua1HULNAke7fqx}UV@xJ+4s(B6D7H%R=+H!VM3&S(DIaqpM z2ARs^nCOga0_1ra$NPVRMz%+Zg$aJ*e&pxdRSQSO7$2!+9kQzmVy=$@OteQv3Z#+6 zH}A;Vh00M_x*7ZX(=Dou3&P+URzPhCw?N?;js4L7`qs7a7c3VddyeNO7dL16k)DkW zT1cm6?Cx)nc@uc}LkbILZa2s@2fv3AD=RKruSSF|rQ!QQU|i#QFc8hLBf+CYlZ>=w7^xD)9cF^KXPgNCk3roUi#WPT8gyqIYw?|Ui zj9LpKoSD+%Oci*;%Dnb%<)#tB3kMhx%ERju+`u@|VICC0+I?3{bQ|QWCXt9+m2Jd?W-EDcdtC z?`9!#kxI`-GT}*6TOZIB^zWI~=7$VGm8XE&dFFkTH{YN?`tRMRy=z`I_q^*vqZ{Pg z?E5>a+kM)mJ62QEasfM8%eBV0TTkmevx(y%w<5c~)pJNVdGd6L$5wKzx#Zm`573HO zTyAXj^)zq4&>+`_^5ilt!)WC^0yIvYY_|00IZZFC5OrDqDm5i)T!3-3>)zU?2l`q5 zBB8|%va6_Ik6exe2@mMdQr!;1OA$4_}0iDc4Ao>Lw!-p#Hae_)2xEKwV$gXBAV4@8< z#Fogf)y;TYF!&?Gq2#9m4ntf{xS?>QfxnX0rY{WE8zhDtpqmEs29l;X5Spv4mM~9a zH+I=2?@OEB6CA;U`GeOmHawjW9Cdx>_XeKY1&6)Q+%fQUOmKYBXFfLY(5!C9EaJOIzjBl$0-^QOEp`l;l$FQ1WiybL? zkRYb)Y|joMEoAh37zlk^LktKgyeRPI0WuGm_XT|%O~przbls={S!v4egHQ`l?-5*I z1M1Luo$NPnB;$2F(P!Qu{&=job>$KOPs%YsDW0f|>KB^qc=demL3L-mwlR zJ4?F)t0c<{<9QMH#9>q{^DZZdUiiqED~mCnwZ1Xo$cvLwSqvib9wE>(WAUx0JdpVAI=NG zo=*ku2Q~0Q_GTSkkidx0d}*Ja4f^aGx{UbX3yzekK%vspzXk2~Ij_t8X1Jf!8tBmC z@IQmUn9~RI61{=E6YHeLM~yZ9r-ps?sU|@*LIla1(dU`bN9cP;4QL*@X-brlKM~1H zaolWd5E)bZut)fs@Hek{zixc^IM?TBYH`z##2}N%2(Kphd6G$6+GAo{&}R^~{5zkN z$-oAg_w<=&sMc+o>7yCOnY;lk(yI<_pWeqG?HAX7I6sj8&;TzKMtGr^fkN87q!6*c z4*{Lv2XO3AFB9kt4L3jA0-FTK$zCi)Tj5`9g>zj^+a2w_#-{BS=kd#O8yy~*Agh%3 z!C2k4liCtBhQW$95*s3pSGtBAI8dRV=N@ z0*H+8(dO6?Has2fYr=0K6n+!WDNos$YUpv^i7(R zr(8$HIeS=~vxGb6jM6sMz%F-ygGuzP6tuPCoRNO?y*j6wIQK-qlt~as+QeSK?X!}} z92>l+XZ3A@3h-oIt|l9pI7;v6AzuEaULP;7tsrRV`VM;`+RzfGv81hN%nuW4`WGY^ zN#eTApga-1Fh7l+7OXzC!m_8bxEHv`p1G!;y2kYOn#Ndl=W>pbowBr=6062s`DEZ+ zuk2-{7WZc*;jpj!E1aq@q2>>2K?`{O8qltZM8!>Y`S2*C?>0P69jE{Pg ziE~Uam78Dzi8h(~x_+DRMn2qkmDLdW1J~BaVpq*kn-;Bsr;71WBa@tK_@ou%!-hNK zW~ooBSN9&Kjn@GgQRG187rQVdj&KDEvNHHgYrFi5r~ z8K`DlM(Sw)y`8Y#-w73qFfmiTKcK&;hu|v=AM~5_Xe-mQ5K_vCR8E*Ie?f@Zbvvgd zBJ$;+_tuymZQZF&Ay{dX4vX2nFpDAVYiC>>v;9XbK41rbY_MMU%y$SFr~(`8uC+B0zb z3hR1?^yz)ErfI2&EbwjxaY&K4=2j23<9cd46ZOaKxIXf=bE^jJ7@x0cS~%2>@xR1& z+`e|q^UtA3=WKHh`PTgTw#E6`Whp_kO6zTQCxxXo-u??V9w#p~{#%Hg+HWkaX__(6 z-0EwPIT#m_22c6g)7*QzG5|{!^|sh^z#lz8=hn-dw4^wC26oTC-}aFlr)WO1C2I8H zAnj_A?%aDDdj;o&$Fae^f^sdbX-XKH;!A>SzBqP*%i*`VSkRb>l|l{aD=LnQWs0Ms z92A!mQM!BN(Y`4n|<1b1#P^|9UGU>$ZIdH$9A-PI#4><#hWZ z33JOwV(0xJaB^zh+d)iZp@GaTq9?JmtQbDeW8oVqv^Z3Bd>@J&_&0cEzdAuxVPjZ! zx-W%lI^7S`Y47*)+?QlH0jC$L<{hhXin$9T>9TamXN56-Vh*ViymI*t(b`97f}WHi zEL?N;79_<3C*--9QoS5>L(-UH!fMrv{*R1{u~ZT1zVI$@NH}3@;=6E5Ax9eOt6m&2 z=*=!~hvvj5$jiO(tAdtLx*h4uRr9vi6#9lXl5QU*$vh)~J*6|dsO0)vjLg1cUf-?k z-73R$L~9ZypR;ES4qXI^;%_2I*oO>aD`Xpv)`&<)X%`9PRd(J|&roUB*5H1pZ$#uJ zT{CN%90LZ-h)MHdpDS6!kI%lN6>j0i(g1D%nmJM?@}VhOXTPRQ*wsucW{Kdb6x;md zbF^vTDPPzAab?8qMkP!RutLIO95isbhdT;+jQmu%JJka z?a1x(p1g&v#}&DqVG3hI8{};4$i(<`Lu+#^5#qX(WC1wl-*Sa-*W}y+PI$vmQk3C( z8Iq@Y0OktJH@KikQ!$U`i2VP|H{`zah%23-4n-B{1>ZeH{~Ih13op1_oxeoATpC&^ zif4+)Px5C1m9ukHAS^y`kB^`;Ulz3Y5CFlkUem-|V4VJ|Pa7f5<8l;U2(%$f!r(;Y zC%TNIKD#tdtE*{>CG*~ZD@Ik2T`sxhS#k?}vMWU7lOa=%d^AS8ra$)<4P3_LY9eo` z7pOFgK8MJtpuz2%+QN9sCkggV@XS~K(tc1xwqSx7?5h+(jM!jbZgIGZg<@idnl1VZ zTQt{u4i+PtS~o_fquHX-{`b>d>DP+|2y8G_z!xqyV%|R+6l#icN=KL=){hOVKLA8o z&#J2loDT>IqwZ_a?(hS=(I`bUCmwez0eov$vAKuh)ifO&G{W_~*>AiB%^BWRoF!P*_=c{jt{%VXsrE1X$>M$MCRx0< z&H|npe{tuCCH-#*0A|U2AkKUO@)gaVn=mlY{Bl+uubwyEjS0G=WS$&ydtYJ2JYU?l z2O!!z_8~>ZFckHkilVZ7v>SA`{Y9$cS}{wP{Wn#tr!zNE?KMDGP1()l&u?Zq;X)?k zom(@jf?@p{zlP4_$yLjY56{jFqcgWs8FR04p`pb5sY@SsJSK(93Dqw?9;u9DUiA$} z9~x##X`8Z7Ir`%%lkUre^3uRY&ihiBIazKvw)hS~hJhV9?+lVZ)jK9koun@uNwgP` z=Vg2>OxY*bAFb05odZxd`2%6*8%q7&kCP^uP?*TOM3?CCQF2#2VI*)wO)k1gv`RbA zCe2VM-`eHVDnXMXveuCg4P#_OS|uAB@oe7Bf}i&&Ape9(vh^V6WW(M*i4z7`srptN zGj<)MiCSq>p7&ZcS%#O?X&Shj6X_HbMnm=y&?+G`AE+1k@0oEE8YkE1)qkjKLbpWM zG%J6zy09=J$ql@l(xTjTfX@7i;9U}QP53>Xa-`gJb#9xNauak)+X=iwtp+*ZFgpu| zT146OMyvK6f_ILDo7$7xG`gFhQ^ph926RovHj+naR5w|ciO1f0FIX_8*47V5AvyS_ z@8IiQuw75bR7`io-*&yb4aW>^?Dl3>lUo}=92l{|xkm{@-4Ja2wV$x_6f@QJpnzhi zt<4duRzaS&*zSnDtvx8#A4ljTr5R4hrmJtdnB(}g&4O2=M9(jR@i4|&x$z1k=fYrNXh>*}nX!sC zEN$oJhvm#C#MqAn935(iji_*^=W&H}7$z3~@FP8!OFyPQ%~Ni+MQ{F^Xvg_ot&7&r zo(;n5EDARig>pqLY8kUXZj|<9HDovSJwygpy zy7jbm#%a`QhxAg0yR^RjZ_fpPX9W&{Rrst$y4gTBlfpm{@seU);V8<^C$<0z(5+{; z2!+xRb|%U9)dfY@*o4SWC561OoQ5ef$yzcp#PyZn6szH_35*Shv%yYRvC~5at0M5v z4s}9Y##$kr<#jX<|7erPVY|IiNSD1tk#&H>opw9am*+y6P^_OYm7}(2KtH*08*;r@ zMZBdBX|r}{Dtm~P0T?kG-A<01z(LCB5y|=V9zxDF_Pcm7Y<5A%FU-hT)057M^+MHz z*Mu_c9kJ4%NF_+j1}gz!U9VL)CHq%MqUV=h*DK;)LiUVAvHWlM;FLS}VAtY)G*WTh z!S)y}+jKjQU!WD~RQp))lELxZfp`O*`2eN(QP4E)1eEUHrWJkuZ94K3Xlp4f2j9ki z{9C&HUU4?WEmnhg-5B>yYJ51|epqnv)lD+rN=fugzU^9%@kYL@Bz?;b((uS|WybVD z0MKPkLi;r#@?8ZaV#H>+AR2)NIA8|xd2X0auHpMpCNCu;Qb2$LPDGZnLZM)Uz>M^l z&DxPZE6#ANfB9W?I#T8Z3fWH#)ajlX0K=`%Z!xD&fjaRl6M_;i>_OBvGYzPM89x+O{TO{k(F0w$(5nPP~pOC|NYMVvU zz3Ry%3vW^KO3LC~X?e>jk!hv`lChJ zru(Sw37C+&)fk-Z1m7HrK*nTsoM#X>#rz;?4ld@Wk#9l^Er0Rbb0jE0l1kS05iTpmN|i|32iCL42GWD<*;Uxu41@&I*|XOaj>@y;$!8kr_Bd+vIva1vQAl3fnVlWZz1uh1Yg$;fTtRVs1w6k%eSgpM z_9D~5HP+I7#{K<~(K0SnQ5yzTi1#H__#5z?T3Q=l5F?#y6D4F^D(mPvQp}P zh!n`I6Oj()1%P3C#;59&B|oY;UahmjucJkpXyKIio$FYAJEO_rmT8Y}OO+NvN| zW!+YhW3gG32uw66dmLyZZ=eA#MDz0xE%f?YHt@b&R;DXIbh^Xl*!S)kX4l3^9S^jA zJh{zLdh-1bSN(jdlRq;d=F7|6*$Lm3cRs~+sMl{OulD=Sv)CY4ujY0^E;%q(eg$)F zmp)bV=?`%43&*tQEg@&<^@nvE_T<nR4)PrdF`bt;oJjbN>-@8= zOy27xMa-|7?YG;K|M`O@ z5MDGbp=pCu0&`|pCU?A&l%}?Y23xKB(sz^1K5fwC&sSjKyD0Dn={ZOze8z9f&wUr# z1HKv|5{0QNKTnyn>qVjiuT~ODMgH5QaHgi>M8?9b+zcclK?7dfWtNM-vrM>eGhdZ6 zpNxgTW&o$AcXLs7`gnZ^lQKm=oC(`s7|2K!5-duJiPaSU0E0huET5Fpcs?bB1y^_! z8kaz`^%u9#vA_^0%SABZhRWIi7cU&rdKeK4yCnI-5eU+*tjpf zmW=E!OUn*r)3A3N4-qIGxD$FvS0bH2>9^@pl5Rbyt~3iZDPsQ6bm?p@p^f{rt~0lX z-ru(r%oBdV?Q@pb8+54SUvC3>T3;SV>(&?Rb0QwQFzZ_3K)F&wn7SAIU@K^&YIgdA zvCz{4uEcV9wMLn#G#J|%iw7;H;&_+!3O&%XD4dn%>doMpfz zRZ2geGF6%MvG0zbAD^0b?r3?4QHGO6A0m5v{Y3xa;hvuaKrC1U8c%Ut-{Ll`>chf z^O#`Jbz6ZvcRpoJt%{sKi%$x-9qmKZ!eP|t%cIv=Q`eAPeuJu+x7<_J2qk3NnxxV$ zyJ5+)oT<|gRbXL}K6QD;bf?r(MiFtMtswApfx;VdYr{GOp0QV^E=@|>ccvgdF+zW| zs}vqHle#hksnn%&)*&4w^hbMqsqJuTfpnw-Z+uCY<+$Ds2Ex({SZ6 zIvz5H1C&98RB8|^&8(so&6MjSdsEFFz}npBvBM{u_Ar5!a~O_|6^->Oj<@uTwU1jD z4c{UX0EXwoi>Jz+!^YwjoWr7;`3hVU25|w+Y~wA*W9as!lIB23V`F&n{fg$mvF#XX zb6`|s-&QD@b6`#b(^*}4w%|MS&1cQeY{D*MuRK$5+1&GN?#Wz50lD*_Pb9-;L*~`k?3-8TNy#oKMrKgX2)cP^Y|<^$jeGw3(&5X0 zd0$$;ySh^B=~2?tWpm5eMt4{J4*2?AHQZDmQfhj0{TlF`9e<-NAyXenI<+tP&F_*P zP@Vcnojg}aI!N4}CO<5|@g2Ov_B?xS0e$vwyT_If+J@LG3m+rP)=#E>2mIoq2e=`~ zuL~QeJ!Eg1b_dwg`aDy~ySU)s0}F=&ciYU;Kn>$@xlI!Y858-f3t%-edu6Wk;ng%` zq^q0tff99!N8|l+6QNJ;MeVU)HA*<2RVod z0LhlK;;K{Nbs>V2Ia$eF2wPnAr@O{A#_P5>UFjWK*FW}peiHqA*+~0?=Yf6bz!edY z`5l_2vgYNkP-OjO);K?O48x;~7f&k`CnIY_diuU4;bV>PT5|S|hCk``d`A3}RSb-K ztm4Y+>gIdt3k6E!UioG7`Mqk_h=8OiCe}|m6#pij{lQC+Rd@8RRR{Ri*_++M9HD zv=!IuiAP(md|zAQ>Tq#b8rp9aS~EG6S41mD^<&SzlPLIiin4o!_HF%?b5!u^V7@)+ ztqQt*SHEI{@JD4cgN4k#epp(6rO?R{=eJBr7W5yLY^Map90AM!3zUp(J|ddaQpvx5 z&&IwQgK&VawnJ@9c+}BB*htpZ(wTqjFI&-%*1(@+EVv9Qot|$=;!K!*y9}4y+)C|d ziekf$#!)!_lXFP=ig|M`pPv*mdri8<%FNcuarR=B6S}#GIyxSwlBv7&umahS7+*o; zw3g@%zMY<8f+wQ%6f4dpN#!Pn&QT_ee`TufOm7bS4X}>V#2K2C->YZvy0{qD{c=Lw zZcFDf{ZaMQG<``RMg+YDYgB3<+dNT@`(u{eH^o>I1r*MT8r|jW>;a#jXXsN}epTp@ znpZchVr4@BGj4T%dla?kNlqR`Dbv;2mD$;{24(Im0j5>FX{GhlO5QMY0uzpaebfv` zI;+;toOma#mlV#tH)m$jtgwV(nOOvO6R=y)tP5=poH(VHu?60{q*?({V`c{Kg`4tu zi^|lKZZhR_9pg-PIOMmIc8@r4XS4C0q+;cfMNc~AQOqinP0d75(dpCzhnamdc!8-r z$+SRay`Db$7Ooo<2dc93lCrO-XV}o#n9cu zGQ+6s9I>knt?SEwu$au69Dc+)7ko_oiUxg6p*S;&k&@P{9oCgFY#>cqS@l4xsiaNP zAb>O^pMne{x%JX{Lx}oOlX`)*FqX<+z!%CBa*HYVCl%4ICIxeS{N&8U#Vt~GvGsg$ z$g(+>wTJQyj?&p|M&|c8k>#|j6F*+|gMDHHT*P)*swbZKXXk`P2M=ts@szDZX>3q5 z$5P8SSS-0EggFO(YVEy;>diYYol$ZV5C3SlO+0e$CilMD#;aZ^4{ufmcHYyGcW!kH zJP1$dJlHnT(|M?!#+`0({35x=M#ws=NxQ)=AE1prPf7;q26G!L}45;#dB81$49hC+4iSSu_1{Y;6M}^XKuIm z2slPH&@rs`XQ8*Ol_5edmVmqlT2Gx)zM(DneUn4az;CT zbB7EUSWWqjci?uh(yXgE$FdW`I#06`#&&Y-gu|VBcEXVgnhC8iCim3g0%Xxvk!EB( zcnPS`A!~K=i4WML_0p&*XK96&!dW^AF5HRB(4@%6mCUdf%jqnFSiOT*H!Wv=d>rAe z!qQ22t7;63`QC@cc7{k${z@6gV05hp-X0#ACc`3z=yZ}Jc)E3lYIRRiYLazRlC?@@ zP0F{XsFHpKr<<=oI&NK6NP1F!`W-3p(tyNH{li2`12iId1lm%ZNh}CmjRWFU90;|) z3dzhR7I>^T;VmkP)$zO~G?Sq$p;OL`al#6)LC6gnhMm=jA1^T(l1n<7B~(G~;UrDx zlV(`eaXd>WMY4T^LruYDf?x%by-o8o}U<$lNsf2iwuL$Px7~wb8=jRyjb2M3M2<<T325tKBp+-g2~(W12J z4tJ(;x+4{roh)UXv9+0}nD33U&10^h%ydjW4yYpp$PO}|M?H1v3Wz$N+dA*iMV;I& zOQo6R+KjF0SatG+HxS9SJ&Q_}CoO4Y;}1tVL%8ElC8ai&6IURjtj=us&a{%}K9l1P zQ1M}XF^Qz=3zy`Um2hbseBnX^u)Hln()zKswRMs+LCWutHwUkCZ594I$SpHY-CAm$ z)OuE8k*vOb${uo|OcQ#vB|HO}P`(?vSaZ%4<@-i_IKIU0?%o|H1xe zctSZx;-3Fr#>nIKu+MZ%(kIZEylAf?6$$7tw_Tu*+uE(*M%Duy#bdC}Hy zlTy5P&G_nb@v;!ZF$ui7701yADC|V3wmJ4RPINF|WXX5d=H#!1yzr#Ss(Hy57gmKa zbl#-oG9hV!D!J5}G+CWC2{v#6!Bk4@r*FuZHITlJy6#)Yb=DDOv>a+;*(yRujDGHvy(ID}_&BIC<)4@QFNI?Qt z1-lqwL=WUK9}s-E+n6lOx_we`HA0~@vjN>{N_a1^+D#my*tJIvBYcx>am%pu>JWx@w30wOaB1r} zLYxI*G}R>79KPMdCI(inJA$l%L;^QLU)3uL4tUi$JQ#!X3m|&!V&kdw^sa2yl(a_8 z()Z=&;5M+PxE8b|X={mMQLg3XLoIoB$I2rm@?B*R?#dS-@O0PA6gCs51e-1}CxP1a za4U@!aoR|*JEK@yc{m#xm9q;=9DU3 z|AOpgZ6=}F6dX>kD_0^>yM`oM>m~Lu^HrGHt9ZA1cbI=lQf-inv!OwW2OAr^I>HcW z301siiF3XjZw((rO6(~biQ9(Yc)@z&b54~tl^K~nWAgb&LuP+cu+p3UrS<%mA$`Ms zlGzn=M|@uGj)t`7%yMp41~)4mZTNe#ggS>}9=oHQK~iTy1QVn$P)(zA3PPU@PVle= zArqO?1!2xvS3k4(1lfJ?a8Ph&Wuf`Ej?nE| ziGQ?CO$5hCc?jrCE1ET7&fv0LuuvZ(nZ4V>m?{>>SfKrJ24%qjEb@DK@yN&8G^+7+ zva)cBQFgGiUu1|gk{0H}8}FPtNYLj1!`#z6GXuZ;9jppnHF8xzX=C^?xDSMsILx6ZC!j`t5BY!1Z)r&&$N+~G{1WkR*i--M+C*2_SljX`eR5ZQKH za!>Z-{IZexy1j-8#I`rQx&m>f0VQL=R;apaHeJw!&fc5;w$)L42~_>E;{0oTOG3=S zGwV6c$O8#yE&dJwyUw}LnQ_Yo7p4tW%W-@3BS*L;sPcMf`RNO7U#Sx;axnR-Q^or zz4d&3h+R=%Zn1Q(GS|O@DB5MkREyoS>z$V1wu12E8=}ezDYt#D)E#s|6MktuUG_LN zO(|l1(ouE#$7-OFDOEie@gp0grwc|J&95+X?6D61BEWA6#4!ioL+W-**bo|-caUL; zICKFxG&X}jKY&B0|9|69&EOROF%H?NL_ZFlAH<=TfI~TDWVV$ZafyEP`FhDa=l?hK z3I9LPCvo@kWk4Sw0Ta;Kf+=`kHh0)G25#%Arg4{?j?(&u#(F;SKu2OsXU~S7f1OCY zxuNsFoNem*-MeeoFG$=?5Wo`G5|*}>ksTPqxAn8u%#5NldBKk$WOj#HY;Brwi}JWq zX$ftKnsX3XOMZ~q{3kHQYUeFsmZ;OCA~>a#T)Q!?Xw!t*m@+F|OqB18lAAV~OsDoa zHIc8qH|L-c7kdLqd1%V`@Ga2+%q+gT6?+jD9hRzTL2L2I5v1w=NndHTD8O3fEE(8% zrd?Sc8dSQVb(Jkg+>vtp3PQ`s>^#+D17={;uB@`nd-3w`)1Lc-wEMob1Z3x_9}8e^ z_+D95EpDgtY&mje&bwD|fM595IBmg}rVmATWniB*Z}eY%|Ayz^H(1DPXN!9im=>_K zoF+6q&y@a@MFxnR>h&X?S>)z^$wbz`m&e(QdLpQ;wqE@*8? zv(!M%-$Q5O1pJcuTQAm0U5%v*KB^lhxt}wCPwWXQa5+W0RhSl}c#?9)N^FS`<#Su0jYkrwb z7%3w5J4g;&)qsV1P?m6PWOF62BPd%>#qP*-~}K zK8747u=FW zEPfJ^p-mz(w8efIn(MQh>LSxBIiw_|#r$$bg0mpz+;Q!_TZmh|Ch3izf;E?gtJDn- zP5c**6xWL_epv2ViT56qX}XOeq0D*V>WyyC&2Gp)Bg8VRsz-Mo4sd!>Z3VIBiyQG4 z%;T1;jy0D+-aY0^t+^u1FwXl#9W(5KevGnN!}bNA zE{HM|sOJv*GT^^yco8ay*B5B~6;tK6;5KqrZ;4)-Q5>6mZn5R6>CcbGfQNjvGV_u; z1tIH5jMcQOK1YSquA~wM9sbJxEKizU)h?%o%6q1g@_>$5ez1ek)G(VSnv+Uld<6Qu zZZCM@gHch-=aDceVlMSNrjM&+Jw5 z#Q8WalrG?xeiE5Eh#n=I=WV%QQIH)*ky%7VwvV*S6Q5JBv|3m4t3F#9Nw+^hnIE-- zg;TnouCqtBjGFV>^2i|Af0dSYwGeZb(u1wbbAy^ivjG1qVX!TM&n`Mt`gcN4UmT=W zcvux!x_X~jU8JXh=_^B;vJXL=Uix?SZsMBa#lYqMUDLkVJ*xC2)r*4;UG1A4uU%X< zieGtGn#YB-*1OZ5HTJs$N!`J|TQ<92aD6XnP#7l(_V{O$51}toL~R~pziW_grSYD+ z{1+hgM3mB~C3byfxE*Uygo-=R_;?**U~P_{z6Ik7PI9HlxOS{V*#ikDEI&SwsQ~ve zeuzh2MY2}ff5`j^8z6q#I@Hx$)X$j!WK;%%^lgF3OyLrxH?}UZ2vlm7yfl|*6iYuz zOi{;LOL1t2e;ge%TW=sc@&8KaApa5r_(sL_KKLzc3P`_7baen>^#|7evuy7`Yzpk(A(Bzvm z#Qx^51k*CUM8N|x=GoUvl%1Ou{}IeH@GCO&hI`(51*P}`!0~Ps5H6dUt^FTC@fn^e z^OWn&CvUg$P}Hw*O2P|u6pCh^5-9UD)UEiFSk*nxTv7oX&pZhUakTbCpQ3}*HD2gz zf0z6~MOU5B-Udr{YV{2WBE8yP$Z?27@?<~%LRAbIxvjmQlTy~jYnIs06$j9nZwWC= zkX$IraN^@>#Tx?dAc{|!jRNJK=SuHW>?O^6BW}09CQw@MEk(W9@0+*Ucab0NdDKYFJYGq>F2#>L$fc3W0fF+;App=i)#{sgR&2SokGP(oTsQqix;X z^ze1oxpTlaHS4-(Hfe9S*dBIQ?E`)I>%H7x96bhRE-6XV<$8y8>ZFV*-$GWJ6&o{S zR;*$cX)@!{Ex>=sAMdFn%%^t01QwV#YoR9-`pq=HQ*D@Ucnc|#yH55a+}>0L=!MLs ztAk7raq&_)N4`&rx4s;5Jjb|ic?<6;|JtpKsfTf6HGc;^CgMG%pNv2_r&q6?Y|`;2 z)`~+f%e!TBr3Y-rtF@VNRB`kIz=N^1;hbej(L2&jYvfZ?xsInCif>_G*7WSxZYeql zK4obfiU*sjJHaIkNXc*?!Di8;7V7AN)t1I;T^Vp45?-n}QLo*zxv977%OK1ZGzgyU zg7=lpoWmr7Dn*Vs1wVb0WZ_eFF)3*}Ft1T^$d*MX1HHbvN^b9hWH9nYiE-Cv%xcqj zU66;1K2VI6o7 z1N^-DZ>+V}Y)os|*Dbo3gLzDLH9vH0%Ole|U{W>hN}kO!d61z*NejQ*?w|5Jn>zwx zTW?p-laM@nPuF%%W`Yztm$Qm z3T|a3Oz^Deh5_q+van?H-aemgSB)kfiSS%5^I3sGJYL1kSImm_!>(hLInardi5kwm zmr9HyX(9sLy!$zSK2bFMQcF%1+Lt7d=N+m=P_(1{Tv#x~mAXmU@D0MM&0BAoSe5T@ z!X)6W>3_xVQzPLk4n9r_``h>!h>y+k z4WPOLKRU2Q#=WP0p?nz3+Da&{MB>aE z0VN|48IB$2L@|YJ&Mup?7bchNoKcJ|X9t5g8UMr1iDudsJ$~}Nn%ean*f}w9BJ%XH z9KPlBock`!nQ(f};}_=Sou0EUEjTSE?Vhyz)8?>q)}}qKfBJCS)9>h?K4N>iRsXby zd%8{k^il5*GR!oKqv*Fn_8ODg!pEfSRu)hHj!`fX4A4g>V>TF0OPzd2;f$yp!x(+x zp`01;@H7^1F?-0-Q*%(*O;4#2IduYZ&Dee&orxP~h#r_6)6W)B=U7+q=B7)(`j)Pz zQSfF%-}CG#Ue8lsN=N_CyeEE`DDPNTaBY2SeAWAOhFj>9X}qKzF`Gf%DVy8M@^&2zTMfl@`g1ANzlo+>^E8#SJgU`=9N# z1@w7KV7^6N9=LLoybRYx=LQkKYexE}CGN1yz4pbmFAlQR_DustbJzEk!Q18>H4%~R zQ#Z(sLXSAk3@XcpF(N$2qm#3^x{tTgqBeQ1(vq-McE{eZHrL&c7Sskc$4cB$bKXWs zI@^g}tF_A=1ZLk_-)hSVa*Bc%|4{Kph>QEy0T>D6XZ7IDf(N@2+5@q=$cQRoyk5EY zfVGa8o{MDq7@cnD?_dct`O5j1Ll%*X z+Gm*TdTY~$1C58t5DqZ@*Z45!0=CJfL;vXr##!AbD20@CZRa$@G4-sPY>O!yNAoNm z%Zy#DJn(Vz3|+H0oo|H=N~Uza@W#A8%=fF91D3f$o84`w(6~i$4%9wQ*;B=h$=xei;9EGPoTgkh&l6G6k zadealew6eJpK^iK%Ic_UU3F@8R&`!=N%g8~OSQe)UENaM0m%>aLMT_+Pc8>p*+!0r zguIcBqS1!%ATivPiaO>-Sgv$I>CwHR^i)+y8-H^D<8&LpOmjonqL0-4EU52kw9uw< z&e0{*TTI+1#Ak3aJX4itB;DU=Rj*a6aeKuIy+n1FRnM6|=hTVZ)M-{bSDF%Hz9b~Z zuIEf#a*bvG2F3lB)!<}QC*yD`YlhsBs4!`;1QWfE$jrm4Eo9*DymPPqtJQTe`5W4CgjwBHbzTN4bpXV3DJP{b0r z`ULL|Szm9ex8j}*{_@UG?ytA5SK$z`YK{mWbTq*|K6R|Q7p}W~*WMT#v}#U#n(=AF z=k%B>qb)GcM_D`pfT#ZAt7}>@VK>XeNIyVxTUd{n&=Byw`hVm>IVZvUHM7xNuw+VV zK+GDGb%jDg-9x@R+G6&=3+S#?nWY)@&eGiK$S|2RV(QnI?`|t^-d{9$7S_`NL}su; zZwLT>!#=n>1(z^DoE`a<|6i*XjhbMRLbvvBaZo4k;m^-`s2fK1%OA}lu2qpwYY z$BjY?pirmqIw>xu>N~!|Fm3!fhMsbONcZ&}|4B;Lpgkm)Ex_XiG5@?Te?Ahv8OooF zN3WRwjW2%=5-twqKZM8c#r(^@{OL&eVJLqZ9)A(@fAZzukAy2j`IGT@P0YunlJTV= z;n$)3iFoW1^RM~x??J-#p?obKZ;1KVefhCS=o!i%15?qCZm~cY3Z#{i;{LZ+L?ZL5 znE4CIoKME$&ukw~u^nANH$8uC{2S%%49Z>?%l=Brjwj6ymW7~;?YJ%${&oBt-(ZnU zpw+QOK1`*kI`9^o@Y#b8a1U4!-Q0G4nsTdBU9+Zf>Kf}Bb>$5~jli<&lUmsjd*Hgq z;&2}%F`@DriC4{}Iq6_%PB~o0Gz4=7c)kq8+?UBHgnv)et?sbVBu+enJ|dN@4PhK; z%ReaURp7-jA8ugedc$JmL#Yozdv`3Y$e{L5m+dclX3UlNaAwcP@o{1ClSae-9kk_a zzdk1&g%wIF`DbC^x13u2tM4aa1(Gifq<6nOXz`o;E%g6_t1*`17KqQ&l$m;uiCW}wYLRP>pvNy#AVAPa*3xp(0Kq1F*f=|WPI zjs`f4gf$1;g&7R;=JqP#*?bXWhZm=(?BjPWk#=NLhpeVr`Z@hdg38JGuQIJa>ps?W}(|$dMhSGldY-wIn9y<8s*;YK zoUWnr-U_RFjEY(@Gb;%~^kr1kg{W%0^_IZJdX*XT#s-T8STD(Ky1!RB7q8#V&y(0p z_cO5u(|rchWSc=|Fh!=1qu_OMY0iSmx}Ch?o;-R7&(-kr6b{pUOn?CySJ_OH9R`WP zAhVfZQW4S*u4mkWd1QYv3GX&FdUd9V#tw%m*nxH15al+=Z3fC_5ZMg0%|KLwcZH9V z%n5(ub*3obmX3`SUYKLd$2q$z9YRGQ72^Y3XW_X*-hnE7Z8P21VURcsG5|_yp=A|( z)pqQ~uw{YN&oXmQJ(}f3eQUh;G^NMHdy#vO*C1nFM}CrdCY=tp)8pVF1)x#PCgk@O z>u*e59?xY6rBX{WLy(7f;$#wUh_SJ|9?R#BU&e zb9icIHhzE0M{RpPuy--quh;x6cLd+NmB&mu_(g9yuaEfI*9m;ORrpG$Kfzc1Bbd9>lTzJS^je}%OqSMevs$@w2Q6~Do}n6}I|REC2PRFbg^aH~dRz5FPHXjEt4#yU zz-W;9EIl@+DMN#9v`+DpgeTPAy`G;`WJP!(I**Kw9C;f z(=8;YUhU9syb2Sw|LxsTQfQ?lJy2$JJ)xsTx;M!_o%G5IfOKHyE0`3f@~KK@>oTc3 zi%k1Sdt{?9=_?&G!{L78r`^ra>H^6_=6(NLyA%5OWU*1O6Ri4N%8WZBA+7D8r@CqT zWytM^P}EFJe_}^?%0R_=YbCmTSxM+@ltvl5Pzj|D@ax>slxF~? z8HJ*>Z@^wvwt)#Z3MY9#R_W;Rx;O8j2}hzqc_Z(`u)mH+uo)RJk1ECc9y~Zp+CxEW zTVGhJ`uIsBJ6W~h{7hL_}LsJEkEjVgd45o$y9s}m)g7pLmWEwl(B zhkzmQ%(H7^#M%wDR9bX)#zW<)8GBO=8iRl&*k^q&xL>L{5@bgq*^K}$qp4JT5AJ)@ zMbzp}Slt#G*pQZ0>;C7CgH^76Ri0X;udUO!l+?B;cRQ`weHQk9H$Bc|3UQc}m*td& z9%ni6-CAq;K@oGx*HI=~wDlM*i=vu3dGIcUO(^Pit4#YSZ*y5(&D|i1@Gt65t+M_V zhu>86&|ghtFrmx2ybPs5f8MMT_ER&o)S?jA&_U;#rI*Q5P%srM!^|J%!PgKUs8R z3EjJxx?!h#OR1@N&w^y&eQVd2GjHkM4BPNBogPW)pW#zCxH9D~2}PRed6+k#nftn7 zMT)f1vl!tgN!Zs$cy${2?rWnb+yC9yMo$*PPmuHwHbXa|ndVGHJ&q_G=+VXliFEHY zk%bO6VG>E0WHO1yXDpZ6(#a%(RHdocw|92bLALNspf!`|n?s)3-HezSXJGF$y%ldV zP1dD7gdC%Nb9=aGmMc?YGDUps{kWsg6x?Ts)ET0DM~;ueg3pX_B}ZnQ1jfD%ba2wr zATTLlO_OlQkMWU-C6!k(Ju*d+vl$6`H+SJq90d#p21PN#jGZ@t*L(#~X zG_YZ$m;l)DN?q736H)jZlxAaP2b3pS$ZhvBU$(gC~DW*R;1+1T){4@e;|gNovB&@wLJ z#pTJg>~$(x1jI|vrU=%(X?QDa!%K8;6qWGBaQp^WvK)jkkOX+AoeFdM7T4bHbd`X2 zS}np)l5mJHx3n?-?}Tmdn_lclk}8no!u--8;t7&xWPYg;ew>6wBoDzoG|rA$A8ZtG z??FHAnHG-V9;CyBB|H?kXMS!B?)8@v+=Ir~ea5%qjsFMt9v#m8>x-EZqbcHT@7o<- zQ?Pdo?wtq=zBIz$`Tygdw%(6>P7$VsG~vJwAJRo;fly9Os}<0$RII~MceV?5%=~C) z0NTAp(9YmPyDySpPb!>C?%pg%lb7#MSaKTO;y2t%V)j6_vo zSs;soR*r~r0&`?+HYKId>G4!X3bA+u^K}I81$4sSpk)R&V)<-3Jr>q@lSM%bd_7Y4 z*bZNBFodcr4M2aH#@MeL(=V{;E?75UzDSzwpOYUAVNM!-bMln{$3jA}i_o#r#(U$>63Ndxs~Uf6Wqv@pnUcV#dNJ8qe`tixmqHW?yKhA5MPu!Ke{ z%-&b6zbvJo0F7lRHQP0Y5;jNz?fQ&PITpjLzFrHp6*#aC*b$a>CH;>;Eu5h;y;%EP zJG`~7@~c6S|FO|go34Ky6@`}L_g~$_0((V(aA@~~vot(*T zS_FOhw~Ic`{aWw2H0)|BKc8zG7jUxZs{ZuVNB{16t(%#Y@z6wY6Yy_wz}7k89j;X) zu_6X?X61PWl3rMVa{U3qgBeE+Go0jiPD1ZE${-C$T~%vvS+moz_NL}wZyP(D}oq;@HHb>sq-bQ1j(&g67yUsEOBuG#7;s*i`U~41WSke#mPXHYbYm*4#lk z0p#425pchOUbSb3{+-*;O0q`FVd-r(M$H)^yT5WQ>=%tpC`N7(Rs^CmLjL0>ykKA_ z`}zW%Qs6DtTf>9jU5}x8!gMbNNbM(?APu8^tWOR+)w#yox?rH z0Jr}I0WL+whDN@wj+y;D^z)wDHl;6!n(^8Nq8zfzJ-*vsJ7yGc+=4wVtgS=fHT~c_ zx8ym*=EFNQ`$!AmP!~4VZ}R5G9om2F5d7zTj0l9|$%nXb!xtRpMXouy*4 z*y~xpx{{UBmzCbJIMBVA_<2L?z~>v`D}2pZt&%)D<23yQ+hp-nayWq9VmfFnHH0tsRQ33+k4U`&e+_O(NBC>{gMWqO z0JXbW!lW4t0)OpYnDAm0n2?TpmN@ABV_qn_nEN&P z9xKX7l(b4bTZuk?n(v+{cR9K1%3)n-Y(AZ_EHQOoTlY3)Q`jK$__h|fA3AkEcR$H| zaa+P79%`szsn$#m1|;obm?SEov&4YqS-+$GjXP)#k%*e!^EL1J9a`eMOPlYzOLNuD z<(p|cbU?lXTVACTmsv=@ki|-{4c*Gw8x7d>d}gJ%${yAM`O&P5OQOdNESPVFn5?kJt+D2?@& z#&u*q)RFlP6Vcf6@i&df8c)4_!In)FkO+7x-#5NT*h&45>}b#PkIrPaiSD_@dlr%b z!lh*0TfDluzNB~}Lnn+ItdkAuN+&x??{kz!>PiUaG*-9R>WAmPc+LRo5z)th9J)2U0Jc&We?V^rgUZC2vVrzaz%v0 zTSO)$7B6=kMbej!q+eb-$>KFP%WJZ^ViGlHRIh;)P#S9U7FoPyc12BTvz&Xxm%`?% z-NsG}BZi*^B=Oxv)D_;^BW6O0hhYD5(iH z{AIUr4V$Gn?S%=8Wy8#|{-wi&I)qdSRL}dD442e@?{+cfCBvkU#W~_ain=IO;}>_U z!zi;3OZ-t{Dy})eN(>sE{JEgN@CgJlcO4hPYADhn;$VQUbm1HbNr!%JL|1UEqyyq} zU;E|w&xrXnz-a__#khy&*OEJW=p5hSpBE>?EWIf|)Fh3(YZM|O{z68BGU_d68k1>? zJ_3Qz;v=$PiZX?dKN6>^&2putxm;;VOZ2N?7DjHc6u*i~-b^#h*cjf5vP8c^qFyO1 zoLy7JOk|o%(q%xDr)5k;(G|W_w%Q)RMjs@GHV#f1fRSuRk;pu`(X~eHRGywr&WNoN z_>P^_I4jVp%u9hJFZT_HF=nHiNuFkcb2s9cGmxDR#XNIF>GW;`g=SWJF^}oKd zT1Z(fq^xG2JVS?zcEj-SU*))nceq48ldt6a-iW?_4v;Qc_*{2 zx_VT;1{v*eqeXJvqx|C})I(?Bz-z&F2D)Mh933spK5kcXr>4`cj&rN0>LXdw1yqd> zClZGF^J3K$853$7M_DVotZDOg_KG0@&ZR_fIN5L&4 z_=Pxu$2%3)3>QdIUN1~*z>YR~WoTd10Rd(X7myn-|CT`b1)9(JSX$-4g2YTU&@dR& ztxx;-X~{~7&lyHlBzRp4bH5WRHEvhb=?+#)rj5B7JY5Jef9{+Y2z3_GMSN9rVFIpC zBMDYFLvDuql~B2uBVBZ)ow-m(>r5issw3uGb!3i+IR*KQxgrzt#gI9&s-;x~cd1hY z>GaQdL8paEP=CxuA0qST5Lp8W|3i@@$Y5a4R9PgNHXb61sudLXgB9@H?z!#X{ljyx z-ff~T?$&-^FX-!B=h-F^s0CQs?Y{``Sp>V>bD1FSYm!G;z!P5Jo5eM2xX(#U93eBP zc$9MxWAjD4xG)ty)N>H#pAme4k+OA4&CT7DsN=E%?k z7J=z2Xz?#avSTL5-K70rLp2~TI|PD?SOx$kR#Edgv!HIvurpwnSPILHG7(krQatOc ztq288A_A)}2- zR;Z(W^=H^$iZuLEr0o|X*~6dS6YDF9J^asKjD6-8V$J9I3Yh3fs32>LQ#_*lCnorU zHN%ZH5z0}xuoPB2U;cRmZkl#vk}FDo1WSv3rmg)Eni9TlHSf-($0PzUgkl3~PBGbb z#nwQXi&dwKD5|2<>g#j3S|a7H1zsM)a~jW0JpX;8^h=5`*-T6+iVG)`2X$_iMJB#;gxmcAh>{%N zx+?Rx6rY{4+>_7XVim8A_s09|0dob1g;X#ro!KFaZ_)Q^pCmepk+24%8| z92*;DWib!Sl0xY8GyFW*z=)gbFJJ%Oomfp-Ok9{hBDeV2SgA0H6SZwvFEn2b-w_L^ z{*<1-^ZkwW$x=ajHeCCUdJ?UeCo?WXl)`fW`Wl^w7+tFxz=YeFl8aL#7W@+ zc}s?Skt1iJS`+iEfBgzIyU_IZ=HWXMFo;rs1mLB6l0ZA%`pt)U9cl;UR*JSZ0=5||yZkbj1TgTpvQTtr-KTryiK;e!5(R-K^}Ub)jMM!B5a7j6}UT+#l) z+5a%lIfgam&jGfuf-vN8dRJ3KvmdTPeM3d&uBLe#A%8qnBcsr78BTcNj*k-Z_cnnd z;jF{BPET;6M1-p)C zD7Dpk5pkFClq0;6Jovs8zdR&WqwuT76N3k0hlLa+rX=_c#uJr*@a4hzG5C!j?^Ix_ z8oyS+vg47=78g#!KMKDL9!f-u735bclZW9q2>*id8|8Zsh`?_E{@F>{JU_tS;Q7l( zuZk|uxhk^j#D#kRb1~rO<5`6#6A%BBum{4_Hp8M5GR5i`GQ5ygAJbK_V!7$R8r?7> ztN3xT!g2Uhq$s2N4o~nN#ttwrPo{aDXO@2UIvMzav6CTxyrz>^FH^U7@UsYOxnR^F zDFPdVtQ*w1?IhEt5oHHqYHXAu9?pnK{HV$ZNk0Mcp9K$-_z7cb2Lq`aNS!y`3mn#+ zNaVecMdMI<|+L(re~F4>YPjEA~}zOo7hvzAWvJ37_t1Q_$K?!L9?OCI|2Bt%09N zK}Z zt%a+}$d`>mS{DQ7>?Hl&hUKd74Hwan!7lhD<(NjrBoku zKK825z=b5jrF3LsY6%(1vaxfsl+Gz308J*!bLxjhY{`O?nx#W5P3;NM{xtkq(jCn; z0zYm%m{%YL|2v$ZyF{#Ikcc_FpfFH@25fiLXGWPRUoLLZ5`XEV(g>ucUfT}Yak zB{npTDM;*(^#eeXOt7n7C4R}~3b1MR@4W9T`G)n6bjn=~K_OCeWEf4sYu4y~oiK~! zzMCGK!~MMz2_L7)Gt5Nbn={bbsOI{I@cQ!;s$jIfVvu}M2xsEEiYZ*#a9t?@eNe%~ zj@An-p`TfOKni<+y!5{)m!HthqgVEy+S(_3DF2G2)CK4jGIUqH4M{1gqs~Cop zY^#r68M_iC2SBwK+n_Z~&9U#ndjDA{)1#qd(_|_Ve%goe(zks8wkf{O89lcr1G$I~ z6SB95yoV}4+2AZoAUJ6*@6rfKjRe3U1q4!&&L$Qi9dz~`(6?i!I4mo5VhI>=qy`}s-;*Dke_#{TLd6{ZFh1HH367ePrxl z!E1rl)(uAlD5UO_zRN<3;Y(opr4eS>XsLA{_G$jrHysKT6tp%lTz9|p^=Ur&#V?w3 zebeol6MaY?OK2k>bA;^Yc+_}&_29DmQ2aL3gYYb-Kketk`5WLCi(vSh^wF`AK59ES z(nlbqo4(~++@wOI>yUN{q8)|eE6bJEq_S}Br7x- zHU4uM87$P1d!dhvr+^WxmvlPn`PoI(v*}kKKt~7>chS}kz5wCO-~YclIy9M@sWH~;;f*@xO^A8I;CW~Nhdc|_Z5Om8?9XMIPKQ8X7)j+p+sH<|%F#ac7Y#qD*sw>Hbo z%beT`gU*O=Ckc1dx$nPk)4mjGx0zoWTS1xp>u=z<%NZLNH|A*Vl#Q?kWa%_j^v64K zq$+VT;|C*~5UXXg4bAd7u?91%og&b)wZO+T^d}(~F-7B-CJ)V@iEstZAUm4C-|L}r zf8rBv? z+C?X`MGp?1)EBUGRGyD`UChDAMBS=`vJ)bhc94K~25~#+^{G452{VzbIkdM>#KjHj z6fsznsYK;QZIOou-4XwwntS|}(r{}@@Eonb#=4mL$V4vhwp&42!pG}Y)t5}ZFYn88 z|L0`shlx-dOxDA7mFF+R$x@jJWd?wy_2V*RlObWZZu4Nt=lAPko+ogh_rrBc6E>a0EKVr+J6!zC zk>d7P*fsZyWA#}P0MwdfVOFl2~!Lh{bVge&K zFrk)JyZn&XJvJ!YCZZ@yjMM*ZRCRpa@tdi=d{VDl<*GVQb*rK4K*i5}Id3oBzYmk;i zBDDF>((^qf6DO)#Wrh3ItVW@|O&Mc4B9|FgbySt$7KToaewv;(<+sM;5ogB5s+vPq zv~-37LjH11GwSMr2SHEi2OQmPta&zm#=W(u3%(~ve#{u%FJyy2v^Je zIhD7ZMr)1H)K@>!>6zqoL*Ca1TfAgz69$-wPwDws4&h|+SKrHZG3{j5wReq>YA5vx zr*1ZfLPV4;I&rgr)s={}6};>bic+nSV#%Hw@tZRWGAWx#w$YADc>QMX>&TbPma%if zwVQbD?;T(jPH*qKh0BNQ8c9#maQ{+=EDP5U`%^ny3ZP5>e#*5%oi3qD^~|3NdtKe9 zU9QtgkB3?rcySrme3NV*%@M-h5z+r7FH1oq6WlkQ;ihPjB~G+DBto}8wN(yyovM@# z+&R)orBhcs{_PBh=W*0kcao1!go`p48rvyzB`Vu0UQS5@TattWQWKTyh7ZEz64r7= z%o#-r1Ww9u@7bwhWZY{6Dh#b{xyfxo`%dbG7Dn{1;gffkwsX(iEE~Ddh7GTsCPj=% zkQMWfGl|lg77!d9jnbEdjyE+?$vZcS3s`U+8Y{l(86KU56IeiipkjM=1r0*Q2HcA;q z!tpzGlQ-Ay3Z7Gk9Vi~!67VdksNGiov;sfL^)l>s-0OE3Irdd%Qgz+4^7v{YO`s!Y z2bn!P4oswbw-5U}VO{6Vsy`D)5NV<6J)oV=uS}i)KDl&G1Kp3fQe*1;4+!mwumTTw z`mOT964$yP__HO-%}=!-{9?mHv_HPq|~vHg6D{%B5PZ?WufT$ zLi)-=v2CHGZ=uw?fUI`@x+ja~NJ=6DN+!veC3EO>3a1?ZRU>45j~zML!~KdN4LKKt zC5sDZFG-!>jrRRO+P5@y{*U-oppB>Tegp3e-kr-*=l>+UgV%}hsyy6hARLUghanul zJazspgu@VyKzIn@L4+d^jzaike(L<&2uC5TMtDa7WcmSFI5&N~>FsKNXe9vF__C~(x#UX9`jCQAxcGoYbb?`l#`F022v}4Hpj~VTCLfYD2 zP7C7yk9_-fzNvc1^Yr` z<=fBlO({eDyJp1KO29Z#r-`z&+Lnn#VLP3$=G_sNjleV_bNj*#49y}NQRxqKCLc`pPbIGP)&WPLriE}4s_9-4r8($( zt+-k1j3=p@-Y1+iSa2ON>k9ujxCdE^=TSUZ;=6P3i!y8y5eDAsRJOs#PJE$FLbz$T z>7rOA_9BObPFKOitEyJVZ&23#n}=J!-SvgSEkyNb*V-f!n0how zq}DVg`mpW_zq?-ZIk^tuF7w+eA+9k!5w*)Ad+8>E%>`l~AMFz!g}1Rvu+m1cd<*<< z&U_?wej9K%ALp(u265p=#QlJ{6$o!cxE$fOM^ooNf^a#)XjgZYvaqxp`^e=IWud*h zZo=opE$4sup8xRe|H1UX-T&ka?mHfzP`*2savhrO7Ov6!eLNBkYuR6rRPH4dVz$m1 z88fo>eaiQI!nc3QH|@Hu{o@SC85JfHV6ozai{v#&1-E>E8QsKoY6yU#$Z_B9l!DlO#vyy>t^B-&&unlYW@*)+xbUwYjL3V*Ot$8JSH` zc=ss{&l`Ywv^l$yrKgv`teSk+lmT0`!W~1|%v4#WR<$2`)?kf9w4tXYastE=5*v;_9agdnVCnypQ-inz~V%V?P)QwUebxx zhq!NHn{-Wkl4!bjHZ}2z0?tp8Y(c$klqLzH9CY55ASecRuT~}$R>D*1uXg30;@9kq z4QLi$WVJ&L3CU-5?@0{N^CHs>#q-eWMx|$vn1~Z=XYOj1JCz#)VzQ#N&koHOhT~RKHMbb-)7(toGrDchI4l z9I-x}_L6*!K-GXJ#!fVPDa zK<4cY2MrfbRb@jaYi}L)Jg_#`{v>F6^w@CO?s>Lu%78OujhP8gY018D(vjNsL&`%q z0yMHlqYUlyBYwW>DwFe=x?ohsE%%9^4o)f<^+SQAr2)AyXL9n0I}wELo)?lu9mXJw zpmSdHImSca-84_)S~p-!fItanZSH8QKM**feH2(=K2Lg?;`6vVRkXww1Wdkv7w+4;W$I?g5NICsiGzoV`_ zb!>mkC;d@@{%8)#3%uET8GFv_WM1eg)pZ71`iwmZs*5uyCW6cidy}JS&n|n`#H-^C zuEGpE@u37hDgNpI_-tm(w?B~C+3et!lX}9>_%7mHe5j$jQrRj_p!jWx`QieYjx_%d zv4QwDX)&x3a@i!c8;+tgd@mAiA$fr;+ye5;T_5g_h5)*aW>lTxircw1TeDRAQv($8 zYE}h7J%OMk?&|upZo9Qq|CLmPvCmpVTa z&lWsUQG(2F(=FcXS_?tAX{2DU%LThv9WIKCCc%WHXN}@u{ky}br8A|*G@@?iN0i)# zEx1Iq$e1J3BKj-ph~(Rs!*KobUC?z&R8K$eDXA-!TEr4dS_N|DWz1MC_r3Z7z**gm zsj9^?Q(Da!u%%KN5lQuIsB3@Er#zH$T~g80$9szEOk#;IvFfQIKa^6b0Ed?CqRi!3 zq>GLZGb!Ie827rQrsp`XeXK4y8Zv83HE-|S0Oybh*}h&jAa?K)C(kl}Y| zl8H&tK2jGaV$&v}N-E2caeu0>AXY=MUR(+ILRk1Mk|1P z|HTHIB+?;?+LbH^Q@*94_jk}OYL?s5hzgEXQv#strfd(qS0x+(2chh`gDO?a_%re-gtQ1Xs4j#ra(Bt&TdbbQx`XL?-$;6m z)XeS7WY5D5$hj?;c?aTK{firradME54et%AH6e@KDJ|NphJ)!BTVyz@p)=e6gzmi~ zCAwfen}$7$>SPaq9%z`pJEdiM3s~hRNfhv*#M&e zC;2KB#r@?epj&eTk>acrUen2|mApcT`p@K-l|&tanT>>ha+vA84Xh+mSObKv^`k?x zn5gGD8WPTZ%|_29GNW_-pYla{{a1P`cxcoHfZ?utGs+;WRpxG<^~Nr*|EiXvnpJrz zKUH1gEdowfmGU;=ckDpbBYbkSYRSJ~X(x?&) zyir7Z!}{lz$`io^Sx^B|2k-$z{oCfBSDy9g&o=70TW~mJgY}2nW8H1e_15ho>(^=s z{5wV48f(w5w^oZF6AmE@*R5dJC&2?Z^-cfb2kdHBW3aVRdG@@X_z|+hkCyW63y4%( zZ|bd=f3%)o56y|%PJONG$6EXP>ju#k1Knp3!^};GLF$J29)ld?N!D=1L@E{iVxXy+ z+E#k`jtnm26*RhHea?#DlJ#kkY!|uXzzr=TRTl!lt33!CyIOU_!@zgNN!Uf_qR9}? zf{;^68sz8F2*C)*+yi&vEMrNg{-}m7`r*Kn;#m?-C146{wzurl3EEs!1`LP)o0=V5 zvSW@*uXn#C>YvmAMSw#sPY0@()}jji{TOVTbaVzO!E!=0ZRc0eH6UhKfoET=M}uxL);aSpJCzAP@w@jn2ObESteuHf z2+r%V3I$zfSND9+_lMUZB@$J9gNsVnHm?1@py?TLa}YFC<^)uaO3&EXkQ%2m1iOXp zByTGd_D`R-3i}AxMXKgzi@4Xw3pR?Q9pc}g+GfBNn1X8PHW)M!fc*EeJN14Y|${ga=O*5L|v_xz?UO{rZxKYPLUw4N{dzMf#$ucdb+bN^E&!eG9c z*?(%DT3vXuc*g0r)5=qCo?lY&y(@a}_S3ljzQ}VHQXHvX1nRa$KOyyy50Bh^B1d33 z6N)=I-Qj;SauaKgZ-fK*8m97C#~ee7Zl&A+1L(coo2~%On9z=*a7T7IP~>@et30*7 z(z>_ORjqzFAkR78@FAaCS*fy*Pfw!U(?vPQ)g78J&jQKHKvm!bz%?9x#?)&~EeT#6 zU}IOcN)0E6=PFXGD<75@E~q?DKOu2=A2;*_&kXAMh`;V#+;=7)9+b)w7*(|83ZB?Z;MU9jGP_*M?zP7mj+x<+a+jU51 zQZ8n?BrR_4hjQf8nI0m2*dKT`@7T2|14d1F@7q|bfe|$`fmlfP4M~=cD|3>rZPL(u zCms=!RCEC!n#imcwvPPbhXZG5ah9JRT@<%|J8P3s8<)sS!*b%wBVU3|`x%L?GE_(V zudifsB7dI}ToS5y4j0_zMCz(=zuI&8D`>U4pifvHx!03@y$W{*B{8|UUiP{ofK=Q` zQj-pE1XJVgQFCwkLct^y%k_{@WHgMdW{nbcDX!n?OYj{ zw?+m^cSof|)*?sMb&#**`v&s8 zWcEL*u7bQL{R?NK^GosUA-D`(r9P1^pqz<-r~Bj(TNc4mCeue77@`xa4d2dYB78@d ze7aR?D^4^N&o=*^?-FAfH6Q1j7s8G>b`OJh@ywuBi8*}!yudvv+B3E7n@4oqp~r20 zwH76}Um3d z<$Mx=999D9-=Xq=&teHwUI@m0)4y>PY%Ih z*m`vpf*#$s6Fd9lKmp-o?o;{P4AREMr@O?9_HnV~9er3MniaTbu)njmJ#M5A85&~e z{q9-_Qj16;p`snG_W|+6o$~^5_12umgcnqD{iN_N@xdjnlKxu$!wVwM%eCzj1t_i3 zo{PNag<9}G2A)K!bnt7@e^7EOi1vJi0d1AUMQgv}XGsWaz-ND*a>s-*H1`EbkFu|j zUsCoLXcuWylZ%;b-nH`ydRCxng^Z{@Z*Sp#BB|^$M!fFkormSQgLlg4>d_OwO-m)^ zv!)noQQB%psHdg&vw=IHx5Zs>Gz8X?XGblxzh63wT~BbIo7S}UNtbmCS!Ckm;QQ!I zt4aAxQR@7*okR0)nqcn*?-3`_$DcuDMJTtAdT1sK(C<>Z-5Zh+E=M52rYGRM)QWj*`|c>)v$Dp9>kbEi0(QRUIiJ%BZ=ov9916&K$l3Hcf!-WU;kVUCnv6 zV6LlnCwg7OP7bEF?H!FhKBL>VY|2`#gqgKkryfKnGslrF!eq2|>U}^^_1ZMGBf8j) z>c_eE)Y}%4+uXZVxUXZO*s)N8xILqi2e#zi#bcq| zB!p~DVU8xX$u+R;Nw9B=t@deMa?6Py!1t-KtyXaB2wFH!{ji~--{cxvQ`{i_XTUrUR zBb(;FZ}U|T(zQp`UQLwycrlkJ6s3u(EiE@KEOIO~q25&)q)AAt%2%qUDls-4ngGx5 zcY+L7rA$P|&U0L*0Qy?Z+Ze;$RgS}#eA=gHWIi`ceVTywBA$EV4k}>(>_)7S`yCX} z4@J0LulF4F@HE>$@oOw3XGts?|1SB(gvP{W zs+c&;$?DG>Mfdkc@|c@URmDwa65lRW4Tr zF5ktp%G=9pAa!thHHe1x^V?gcTfcxaZ$oiO{O4+QpV~+D_f*{Bo+8MrzXTl@^ZcEl zvZ7bFf5LM!iP9!iiT7T`(rQlHN!F{TRP1w2l#MNB0`3Hq#4fe5=BC^H0mY*0ho7;X zv<}#VnftA`>TQQF+4SUgH7XO-(Ul(6_P&$!%pmXS{1&%OuVil8^r5!Hhiv*VCexu0 zvFXE+wtt$~;ZlJh!3OGPsVm;a*7Kle>|J!Vrdru3@_Z-snds023i5~8?`_!cL!q9_ zgeQ9=6En%KUtpZ$-M@sc(vPkuCboEaLoy>a_QW^Sb9#Kehqjxhhs+7rnU?EJ2q(XZB?o%KGMX zpuf@=j`mkFZHx{xu*GFPW#^1Vq5ei%qQgtVVv<8A7O&AsMKcmN>^04mK&B{T=L(x9 zG{xSh5Y2enRuozl0zx!H7adZXe=#((bjEDbGxqIvTTzHij{Yn>La0f2PBlOC8=EGq z;Zy)R%MdHm6@|D@D40+TQ_Fs1krK{#d!;Z5wNmGza+bki*~4OEQScLD9r+Yuo=kS1 zK-n2NJm7K+Y3OE;O%t-GGj(m)9a;MZcxC!d!OTJrTlC2$U-yQKa@KTv_ny2X-ADtu zTIF3dR-ZWVM>56&QSIroqN6!3t*Zh>Ci zrfyX*K|YGr-`jT6QNybdffZMwUFr7GvLhFW;2}6n^L9my;3}>jLhN&(_gyAt6u#UJ zw%BG0DVapuOv`O95r{{d={Nn~!+a=JO$gPsgysOffjOk=5b4;JMi-qVjqu!8OL)9* z+$LTPdw$|Qidr9?Z2(~{DUV;K*11ln=!|KEvNpQDSYaf^nb?&DJsTn2Z z74N}~xlTytZw?BXR@^3AC9>f2mk@K^NSp3Suu)!WGOpI;Jvhox%y;K43n{hi`H%r4 zrW^u9$iPf3u#_46K!F?SPm1zwuWOlbj0{pOW?-$XOV;8>C7A~b4BQ$rMkdokWwtSy zWF?rSz^s5gDbA4jss`HRA{E0$ZD~hji3NE#Y%&;4`2~Gt9sBd>^a2RidfNE(k07^a zVD>LRLRY;{6&>aam$~w#E-7V_lr!Nud9agK&S(n^jI_WqrnvNMWbePsSDhfZ(Mp>i z;CtUf@n(3Cnf$EGaeUZvyt{T=<=Qos;A7-fWf(u;bN1J(27fDy6yYT8b>SSR=>M&_ z=0aDXaMZ*>Glw(`94u2|Z~HyvhYRJq$Cf``)PMh1Mz2COhzm3Z2UTsh_)v_mfZ4_DQa zw&jzIy`S)cH=z^`0wrr|KI^or`k2ooEe z_f*8j>#AuH7T85SF_8(!m;+y!S21ot>AR)=W|N`p%IOET8>@bceQ4EoBNt3&?bCq> zaBq-T6RkM-nY?5?40cHSKmU@MS_Pp2obr!Ca*S!1Iw_!4>iP1^$QD;&`RUb>`#m|= z(ti#4-(_9mD4f89xyx$-q_f9&IKM;!9dId8bF70L&p#&N$g1jd%w+6^mtYsf{uv}u zYRm2Cte4BN4gMMgxyyWNN8W|ls!1poCWUbRA#hLqLe{ly<#+S;&meg{y*u(YPlJD+ zbszuPQYM_zkHL3h$wcY8_iiI1Xn$7#PU-UoO3#@J$VuIE=1XQ`CtbSTVw!s>?+i`) z3R`H=(P0o^+!MD^;qT~;^cmSDIqu4~awegZun(!ECev~mY*naCrULZUhhJh*$3GJr zgqhWw!<*P~swy?sD9=tZU`#r+&+^h=+i1!=fFWCvS2YP;iy7rLnpWH$p_RRh0A!O=!Gspg}SX>@NYRgy$kB~#eRjBLooej{5vH9WL4q?tC$P|8Yq37!7Iuq>6#{N<`; z!4A|WBOyrb*n8fm&J6HX@Oa|aiNfg2|9R<6Z;ZP#jyR3uX>cnz^o*d z{ zfMXE^yA5UQ)_R#@63hbp+EJelQHxie?l`};AsB96QHu?Y!G#wjOxe@p znCwddYcEu$PY`{CnKn*TH><6-AvmvWUecGejHfOItBNO_H9I2@YLK1~RK@1INz08Sa`&;(<=TK0~nGjD=(;*mso-vnHo zXK9+b`AH;em3uajPsn`w8`d>sXqq`aI`=s~J25>3ZoefZyTA5=!T#ps9UAbILrIYp zBSj*M>ex`Tj%c&@oy#4EKZW01FTA53s_cj^di}NU6l*_Hd!tQ2CLgH&`Shhg;E@j= zj>6vPBGqCvUDOwCYR~17kZU1rK$=Sma&_IlnCJHU+PQJT)LnG1i?ZO1{n4~48m#N7 zz%39AgD}%LDo$aE zR;n_lFk9VC>oKBdx_~o=-x8wKnX**vH4J3D}JbVDz%~N zzZXAk`uia6wix8(+DHW;f<}7$ zP!2N%h8-A5?ZfrP;ztWBaZQEE!Dfu5hcHz>{=E8oLvb+IApjSf=VGyC=2@aw!DQKe z9Vc$OPjo-awEeZx^=@VNMzv~JPvP2_l4&NHgwK0hn%>Pbv(mxpoZ=QTOzb#y^I67y zs=IA#rK_TT?MC&9iDAevb=r79U0HYkVXPbJKVk$me`w2>G?PBNfxg209X6?m)M42!3_*H+!h_I#HAIqt|9+~ne9eCfxDe7`aXJc1REDgiG9rz}=xeI};sZF?% z!}T^vZ4MhIsoMyzzKEKu0IsNP3n*r~Wr5hVU@V`tQ)dpRpA9@co!o1>oaGW9? zbDNpoktOapeCYSpmMof?*pVeMWl6`tD-Bs481Xb=yk=6&4O6Dbboh`dlV+xxGR2GR zh|Ur*GK=6Xg_-25#74*3GAL;Nu(6{i!{VmamZ)RBDkH_Z7FPH}V_9x)n+K?$`!pQaSqGp3&fr;b)A7O6;5LKD|kKeiT0t{E>%@Gl6<}$;Z zSUA3c*#-k5qLz*}snrG}gZS1OYw4ElatA|DY+-B-jM`yx3{5tf-pFKEh9pziuTop) z%BJX)nf6sOUxEAooI8NFyT9+>y3Bo^d!F;Wob$Y$bDs08MyE*T51PFFrVJTU&;nu< z%Kou9uACc{^);#XCP}(y+!G=TnV=n&AKvN2@};<0Hrr*mAa0))k{z~Z!d7{}Il7b{ zGA|C7{Wh7N2-pydi8X^UXRuPU!;PQPoDpEkAn~-JA5tF8=HMT;InO`qJodBmaJq+= zHw1NO1a@Yi;o*fj*pa98>y{iksF?%N&S-Ef1~P`ZGU#rJfR(@J5?7XU(dJof(JZ-j zmck@8?OVa4I@DBI<_Y|fZP25x9R5&yDw69Dnr6vNNBX_97=MkoCn`cx4r1ybFhYnB zYNbYbQ)^Sa;<83)5@opVqFE-qN70^GB_`j#i3Rof9R~3h?IaSGTgR zce+;cOKOsDJez#_=j0RVu56}5*}yg{;2LWQ+yS%Q+49b8g)y7>K=?CZt!RUUGoV=| zyhfqtd5i%|(Vqou8Mr_#6tl%^E$c&*OG_+~p=tOV7&;Gs>q8t0aQCLstSXbqN@HLU z5Yj>_AlnWZN=M-i8N`|I%9=u7RKp1ATeyX6(%HV1)lThFHhu@=1x$9rl^ayA$kNF$ zl;+~Ab?e|@*a)@ZdcJxB?3^^;1qUn(;6@cKwb33X4!;GlL-N;nM`5ToHl$R>#2ckI zE=AKB$dxX$E9R({u}bUGd`bmzT>f-v#{_AKf{EK6NKs3(WEc`L#Vj4{UapwD+7)~Z z1d^fBp#7NC=7Hv=);2iWn?fOIDt#BWxt8YHohl9P^nww}A}sp3$Sfs;HD)YVzfQ$v z9T2O-xcY$QY+JKP-eDurp0b{Ki~@2~Ii7fG-#jL14(2b#w4yOqV;-Y5YlV9$i*-|Q zSbOYc+?%j;h1KZnvMZUX)!ed?-@BAD%d}Cd8zR%Gly!En$K1tleHh;Oy@+K`)P|lD zGGXy`q(>*3u6`?$ZjV{4AFP@k0>iTMNp}TdqxQjyxj0u*+$6(63mmN|-lFv=mHV2s zcBP_N3O0T&epsDgSE>pkW9-U+Qzz~?_wXZ(xC>$11m^LV)-_FwPI;?o@_*n}6n`9w z6B`HrsV(l(p82cz-Rl!pzEqxhcX}Q46W5+6v-1B}>V5D72~9=rtxd1#kb2==sqKe* z%k%FFXAK9oI=A@NYm^T*(*FNYY=Yc)R~Y@Nu~w7}b{-~Xlxnv5(J`nCi>tp>wIVZa z^X8W}eaL3*6tg@uCPhC6yH0_*6i^To1d(UKVMzYUSuOy|iB(5kMOK;7%68`|gilui zpUWHT)rDaWUu<4(6}%MH0NHbg(x?k>R_HE?c3mjX3#q!nG8t*<9dbTB6~g4xEHgep z+E=A4^855WLr0$K;Lx;iiKB3pz|*Nt0zm(Vg%o7Y_fU-PE78tp)kboG4RX6R%Whp_ zx2_UK(I-2j z?GtS$UxmvvgdSp8cxyi+cE~&VO^v5T;SxpJc~e1rBJLH0Q^y;M^ARWXhbNg@LYji= zM^^`yMcz#Re*V{apFQ)Du)E5Ur?%$>_sIw7%a?TpcJt|W>+k&$7+PC!1mYXf!B-ji zO|kc|-F&Hsf61OFcjU3AJXxyDc2;!WKY_}=is}!!u#%Vn^SVRHLVfB`%B8;w>8}!h zF(RH9E*`eSb|-MAD=@2akJb^GE&ZJ({mqg7&aT`{pzSHM zu*KNR*iir%7Vr&n+jBCF`W97zVX%h=Z<_gxqIbTrA3DuVSr<6ce5knSoj-vJMRKcX%CDy-vb!bvi9ReUAArR4itI(TW{=v;FW?gFhx*OV z{^G?YWqD?4b|2(cGoR4@r}>V(5FoZ;KxO8i7V%nB$Q}(Zs!sFHZi*Vza#WMFfu_3^BQHB-({kUk_7r6h|zcvL;op_q?oWL`uMY5sD z8zFjQAFXKT5<6ob16vD^5It(yfw=L^y#+sJ5ybMb7%lZ?Lg3Vu`YdjP**;5iJ~tN48a zc*xEy(3bX4CZ1e8>+yU7JUj7w9&ni`<9o1?i>IJn>~%VH<9Z5LSc zC%y0iRJdjoz`|18{0_Us5;szbqh?v(u#NvCb}2gK;B5ys z^|y(Nyj)q#hnnOnY;m+{`rw78JUAb?>ZhASH}V4m+h%3c_x79h=>;!Em~|nshT&$t zso*8H?Fn|OmCbsbHS2$+aYFEH#mDRrWU_fz-p;j# zRA^KWvqg2xnxYWRG8iMmRj=p9Y{C(rc0mL9#uMpZB~)BVh{G(Y4oi_eo5Jb z{q~5wKZ^}2Y<_%cuuG)m!UFoy5yquRpR(tEIYvdZ%upVbvxLalNu zMC=W!WgoFwk!Xtrus~@`Wj^g@vr-sy>r$xMXexogGAKKDN!6wFlJ@?_7wGckRfApFp${p$dQ&K`t7#O{h?_N=Rc*bp+)91L=(bz3 zx|HkIwi{UUJ6czskE(s6@@p*w2X#xt+;`Ja!PCQu7PTj{F3T8O(aVh%Iv_!txG1ts zSRfjnc)9d@8Pgopp@K?}rK03kW0#X>%^+h6Dtwm;QwuKTe46TDmgf~e8tOvD_h_v+ zy^p(DS{0hCnO0}=GL~)oQpW2SYGx)BIFxk{^tY~UCn@XG-A!WYpJa^CvI1B&)B3WokV9teV@hwypi9wbxY|xz-}xqYMacPQ zxTxH>wt4l7Y-45XcI>x;>>9SMMs_%FT`k-8stjdVr(uE3s-K}z*-kvuG#~gqV(E)A zuucH1a*O1FkZl&}(_`a?6>JKLg~IGPnKVAfwy|x$m06uKEM=hyw&p+JD;A5szzrq! zRs3UmM}F0-JI3_1OzLh)>2yAYdg89V28E$Ywpwjj60EYxU>k#^AiV8GF?W|1w4dMA zf4-_?_>H=*5k3FY-*~dWMp-km#!xf4W=74UHMW{(YhJ4PQ;oak{hC8a)=g5s2;rxn z(F{py^ax<+)`ef+&$i8#xrQ@NXM`)ijLY$Jrw0*lhd7s)RIG66(}VXomv8GBQTJWn zxW8KSO9{`@)SObc?HJKK;`o7nm)_KqUnP7-78RPDpGs3?jAN8x{@ZT&badz!m>)BM z>jqhW(ec;>Hfw>bbf%2g4fC|Zz=)GS?h+OeR-@@jvv=+#RRbJ#)08vl&KJtz(L$PNn?2cm~T{ zx{duwnCbYuP`7He0d`xl3rzmS#7ey4-| zfZ+yX*U#Z+#GtVRf2|v)MB<`PYVYw}QM}f{y=Qb$7VV8n#oFNf< zLjTt?Dz;zRetc1%57!mzMpo|D`U)X^g>&JsByP`6;RGedPB=_6HRp_>fBEp`_bk6} z`LC8gy!_Y8pI-j^1ijq2?~cLT-}+kq z*5~Wly5V|h08`{lgR~qwD&8qW3%xojV6cg}0JM+44Z$mzbEt3sx!3J;@XkO?Hx5a3l?hP?v_bUpsK{qRbVrr2D^UK0pQFxQwDkU1sAU+*8 zo!6&hmDtx;8V;XB7K^eJE|@x0s__0Ij0e!w>=H|Fi?9gJeJ^57Vu>f8E~2uyzD#0Y z^{}OjB)_M+lUL)zEUr$~BOG zl+n%u9>RX;vLG zG7Vm@j(^sRYnfR4vR@50Qr%a*<-^Ly+Lt}zSoVNvS-N?dNqC_U?B;c?{!z;ULLFDx_($&_-Y8jb_oG)(BPm56Sh%^;~?mR6;YJ~mB}OA`ViD^jO2l*q4H1N3vOUOjZn-iHQ#6 z9sr5$I9~TY77Z--D0dGBt2E(ju{@M3TRdU#wl<8*SLTyvh&q>Ow*KDN*1tVUZ{{C4 z;3g&E{J)b4;jSL4;BXiJNEZvC?r@>@Cq$qEDiyM_y|uM5v3E%6)GFGlwo39bWu5-E zuhhYnnfWU8f%ccoE(TY*(_tA@sNzqC&--gPx2>h(8s6O6IQkBbcSXb2t$t`2Uo^{Y zVt>Ww+}Orn-R>BM=D$h$d+0PXsmDocMt`e)hpS-=nF%|o$sio_H<@PqD5H~s#Em*l zdcy4vMPtJ4)b!N(sd=f-qzb83sdcH1Lw(j9sTaml?TnC~#Uu&$-kzYneO_@Q;;_C6 z(zE3H!0N~{c}n>AEngr1?94}3TzMgmJZN>pjCtYREg_vPi@YuKJS|Vy`7&2au93I* z@KumN${Cy|GRkr-B?>$Ll2JEmYV|{OqH*4YpxfxE!q#QT^5T9kU**B3N+Fa}_|$%P z)z%&ey2+?gH_?oxA-=T z48s;jylpkMUh^Xi!Xg>>k*+DyYOaqs9Tyt+CR_R-GhT`2FHX^7#{dl=?I=+zPdV?Gw7-$8={8c_8?|VdvTeJ8{2)Pwq)I`xRS>a8~Lazg4uQ7Tw{=oV~Zz-nu8#* z)TU8S2Cyxc8sS6+5qfA)1p=j*o<@x?&>KnT8+lj}E$K_wU zfi|$Oj7uUJl0v8{0BJxH)$byHr(Znj8r;WPu)FLc{1ROrgTp&Bq(MX%dVhp5gZZA7 znOQmWXebOUi&*8FXSHTl0l~^VTbG&hFem>O-+slkO=Ffvm|J^(kZfy>>@d^}H@YMnwVDOPPRE4Cxmndjoad(A z^JEYVfxaN>B}9xVa2)ELy>4pk_kQA`gyWdfL}pjQa~${Cq;aph4oSrG1jveEKoh`d zKh}Qw8mrPVr^kiHCH|h%TzOD@kc(z>KVEPqReWyCbQm%m=>_?U3t=iI^}156HAs$i z+7R7JwWkXY&X2kISY!}4{yON#=6=5ISiAPKNq*vu9uA%j^8yj#a=lF`=qPC~utAviP{+OzJ@UUbIP=7$(p^CQn^DT-bSo_x4x4(~rwA zOCuOKa9DPB&Zwos5h+ymSJg}L!M+h(X6QrABz!oqyDXuIDskk9z{Y3FqHz-~K z1_)RhEC>?ps{~8BUG!Bj0VYBazv6QTOFHoym0=IA^%{HG)++r(LbhLs`fbGH#M6Z5 z7@mLE1DjK2!W&eP2ibL#B`xqGS+Fe^>vd-r{LMdBGkjV2d5>IXxgAArD;TCzE*sZ% z^3AtC3?qg5pc**Z->T38kA~?yldA8)O~=%J4uID{eB0P1I`ZX07{MVfYavj5u+mJz z{@pSN`{7=SwyScbb2l8@!-pLO>mIrBR?U4bxvC&49>Rf(2_5oONnSLBxhtsgQ?VvO z=)F9E_gBp0+tz)Q6P^0uM>GBdxdOg0ymIBiliJEI?UmFU*I!RxxveJCUsf#bP&X*K z8{ZR!^Mm*jnb(7_y})M0qtyRa)B$YptZ{I+RyfhKX~+G*w(zc+<7i|}{va1g4cGXF zC>$Te9S+=$qi=k;W5&vD9r79+s`kU8eJJHdf9OuRDn-FNn3hwrP&$d;Hr4{11*LG}sbt+rx7E50dF^&{TO5R;F*{pjR^E$N3tD`2AT`2m|Xh-?wKURAUsw zKZh=K&Ahdh#cR6{$-3lN@SR@kN6e`W=|2*Je-eTv%3yc196K)GxwBrfAI3QKQ$7e? zzz6E$F2mLvV?%*4NN4yhy~|;x`(7F!QV^!p-9ul;taIUlV+b9JBu{nDH;V<4lG7R( zwh-Mq?%Ri>aUj0??<`KU_o+|}sFS4QcZOg6NS(pVZomz#x z3f|Y?iNsTxC!OWPIKru~To=z=7mr^TahRs@2CQ{`!$j_Zy6d9tp&zAu(-|!)6m$*& z;7vYwl}_3_8H2-DNlk+|o8p{i8tX_@X%bj_LPYI(d%{S&iMeZE9lyfPN0iE7Zji+= zTZ0D11PIvePG-P*CPfD8nf4R)Rx&Sxx!IJy@hbmJFXf>tgrQ~<^p5*>sf3;abVhSe`h#!RNd@v_=Jw8TOyW zlKeq6r?y?~b{{%BS8Z!M`=r`-;B1-vl6v+}RGM;GGYdJITS1AaZEuPg$PB$A6(OlG zP0~AF##n`Kd#$)SF8$?|21#Hb$t80ezd^q$8RoisF|-iz~14ow9jl z=^i!(%m3o)^dAyCl%Aa7%?e}A2;-43drpWWClnmiAg@>}{E9k3mW&a!^inZ1HNbyj z9(lREJwoJQA0gj38;Krx@XgMT&}1vix-IJ!({V|l3@+(*cR#2;wZgE!0$ zz&DOzr_}C-?ck0iZp)j3j!+)%P8ufpCb=jIvwuWHSvNPDV{0OjJ7zVhemp;%)0mx1 znx$l~)#Z(+i?u6$E(@!O-@=c*EDR?+nnZDno#&b2jR%V@C6=N-DJ|SlRDsYl z*@{_*Y>ukz@ZCQTk~aIQZ40`9Var+Jh6{il@P>|6k(6Y{IN_#f$HbmNqf~o6PG?AOL>TNv3DxTk;U{wP3dhwI zH}P8?7+iy&n!xtawgYsY?9YzUD_CC?4&a4vO?V-c*n(L<6z9J_XYId*VdukDH$Y)z z_~M_GWf{IZ@zna^V7Vmx{0!!W1{hs9 z8is@M`FmW3r>gMz#&4zZN%#WRPz;QnVQ1_Jyw~xWtnntUY9^mfhR;s|4m6pM`}-oe zz-ndXMq2D!%9P0)ODyq96R)qBWKu8}^G#o)3?@a)TM-YL>h$Ki+?-iU7B|3>3<8cR zRK}H=dvhLp<)VoXsrbUEfa~N?6P)5s(&B_47nSYd*fduO?YTHLjZA2N;V&WzrOB4r zwx8vKgpF$&WMzRh@mv!o!2LuN8cPmi969)fjLJB{1rH>QB}Ha?t^zgij~y*HM0YMm z4&AeB;@Nn-*Z*X`IhbWJ345oJ>>$2gbAq`x5A z^^9gwU}Bl6PMec$Rxn)PCP)j%f+~RqbCoNPv8<5!R#bGUp(FiFgrMoN=v!EU6+gq+ z74Qvc&twwRgG{0OwU`<;7{IvYj(x@Z=6UB{FSpm(?(I@G%g{mGTdKAyW23@twu;90 z2ipT4PaeVL-2?Oc{6|HzfziCLAlFbBerH!b32!V4a!+8GUA5cLz8}KJ-Byr~HuwWu z1fi88AmDChXHCZUzfq8mtJtnc`vh9y5IAUZXKwLj{9!Ps&f}50#lP*0(S^o#=5@!?yx!c!&nBBQId+Qk6 z2QudoZQ~iy74xudSuEPDGv*O*%)^cU5{0)fB0V&^Ey;Y$!)Tk9S;tN3q`MHFBg|L@ zva{c5$>R0JZ`iXu| z9d7w8RQQrWZY-!-Tch&J{a8;6_enXiV=wateT9){nO>HMsR|oY>q4*Q(W|o(3kG_1 z8o`cNugq-Ufs|T*X_#fNd}B0(U|X*_3&SY}HY`TD3^#wpnu3K3ny#ilh4n2t%RBqDdqN7Le7rtf)6=)oqrK$F zIuN&Mc=U|zl31JApfrCj!xadKdjaT-WX)$CdJ+#V0>xqcf~WVBNK&x zQZjB;lcGVzX@svRWSw#Nt^{8BVov3%%ZEzd`DU?o1`TpT2f-N?3ge7>5FC3MwGeRTs+Q_sdf4jPz`Iw>+kN$N*!Hw~|tu(#UWs*EALWe8&n*+{ObF=Z@L$F*B9NcYH zKM~X*hvnpk1P9I&%yMMQk&`V+S+NIj4hasF!tMoK-=?faCL&3$Fz zwv#0 zz3l|N^k#TlW?6AV!qFzP9JwC+C^v>GFmL}h$Pszuf9-^4DZP- zx2{5TWq4XC_0c?L!vFSR1(Yp!hhv#{iG}|OoTwTD?cFg2T3sE$D{#z9sHOUKut(n$ zeoeGH9K($`8gof@&|A_O&Nh!|Q25>wSHriGfS6`Js-BS_g)CTB1vV^$x!*r=0QDlzo^GO|5rWSb>}!1<-J8lCzzY8V=wovOnWGQ z1>{(GDjo<-!#?vFM;}hnt`E?BH5_}0Kpe>``bvhyPEkN~dkW5K?M)G;QZ9|%ef-WN z{^i9L$<;kZ^#7#_kU$()Ia`h>a|Ok#)nSjtj6kjv=+kcY;$~GW#=STR#c`lGHh`i_ zZ21>-N*j8Xhx)a>=z8yK1wAG6A8i!A&BZ%d=zD2?<#?PH+3Rq?G(ViM@jL&8k>o(% zrQquHhM+5-i7iJ4@qI=}#$Ik#3Ze9dDM%rFPRQVM0Qk=N=WDcwG-qSodU-S20_(j; z`U;hr(x7fOaMaULubDsgnnyC7tv?sPA3AT*+If#_=k2?yqIIjM_4;exuHgAs#DE`v zkGtZwsoDbI9amYg8D7%fp!QBs67F_AjlsD8MS&)Q&7rWJzPW6S=2oA}dDywD*ndvx zu+qZ@)W=rjyBDy#6<7}%7O*a?P;T88Hd6{7HZHaS8bUa9PP9bbtXH;STqb#t`z$J? ziMpx!hQh>?V~HoB3-|r28^`W6hlVxF>J7fX%I2!up9e$IxnPDl9L0^l#GY*D#?;Lf z-8-m@MfLMIax+F~rA)aoe#Qhb|0ac5e|Tv8)mvT&JgQ$GQOi@`7Cs;#oJC@V^%CI} z!s8TkIOZsND0=7YGyeXm^sN@>syB3M_RER2Rn$WZLxq);2qx`^#=AbbAuOZNKo4#E zj~=?#&)FG--_P0WBgO~AF)^yOrW@-bqGukX`)4n1fph=88y)ja6*r;<9aGjdg2rmM z4Q0^mP~JU8PuxZnziTZh?C+)Z z{CdWBjpk1OH}IO_8iY1j?@#dbX3I61L7d$2h3t6w>Sj3v^q-`j7?wKTIO|^HtUHq_ z)<@O))Kp{UL}TV8W9DRI<`iS*RAZ*J))JpW)|lI{LBfK;m`M{QEa7fZwC{K~m<^#U zDj%*E$7=??8cuc3Rbx;;*=@V=HO9@ayW!n+XF@0zPBOz)Y=WpB$1ql`+Jg41V|1H( zvFg_J48t199wX=8of^qzjbl8{^^l!jCyWoO+b;lz3!2%>Cn+@uA}mN9Et2Lcq%|_IOjlPv23<<9)`ji8XI_Ll*zKNesupNhf( ziNn>tZ->_MppnL*oR9rg z#%krE!5Y&td+Z>{Ap*fIB?RSn12@R9Ak}5in)VaJdKX~^OlXPw6Wcb2xwcVKXW;5w z%M#K4NiPriJ&r%)Tmi3*OF8?2>9k!Q&_&12I^;Mnke00le&NCeWK_H{6rK#zveOYs zci7y=nBH8Wy$VJ!yIZh0W~s_;5sc{{G9-ha`Awr|dAzs1Ey;Gt zIX{jexa-9DmWz8#-rf)N_u9SvTtsnBNm|<4+6Z7X>_s6?-GT@yzJ+u~1!lJNpjcp< zr23oKZjWz?l5}vO=WOUv!GXa}hkq<; zx@`iTHwKu#km>f`=7w$P#h}dkT^Scd{a6N-S;gYm(UDNuVm+!2MlaW*raqZiCMzXj zzfqwxwu;6~9byN^U}HS__Ne{s;fYN#wsT^AjBxwcXae+}oAg^IgVgFey{XQUjF`jx zABiU(Pck0;#A-;W@C*^2{W~3nyjNV?~Qtb<082r*b^`7jfOnVo3V65k~agx zi^9BMu05mLk&$c9$a7>^y%{z~Mu9zJ8BygLwSsGDgl0tuw|CG^7ye#_t5gO;BwX@? zj69XNq0?UrS4@N^XE;tE;$I_dn=T6H3EICm7tZ+MHSHHRc!%JLPngEPi&*}5-39xl zA2uAYo;$E(2=)`g+j$r4Q9tac_9GiycVI(c4`MWW$M>+w-R%9H?0sH#ygg6m2Y~ZB zc0%L3aPPnv))^Y)9&fJiOVZ84#$NcCa8p;RI3nzzcUm`M<=E|t8A-d@KT(`3Mnmro z|2r(E8R3uq_feWCnNUIRq+38+#v3oE4~`KBid?*$?*E|g_0s(x(wiA^e~{jIyuB#B zS+Q1#iwY8cMW_lK^!(-5KIlp-rw{kTy*Ble%*qm*Yyq{WwvNNa*@&AApj0%1hj`rnO6D@1(l zbI=nYoC~;+mqw(00hqPeS7l>P$$dF6?bsXA+~TP_1@0*5N0#$1-Fi^HTdCQ9zZa3g zLN;XwWeBHsFFixQt6Z()g{LUi^f}BoTy^^C?OZUQ$?tiS&y3+SX@C|Upzr<}kqdT0 zV>Oi`xX8vY#OPB;-?V3}u{+1wGm;2)j+8^)Brb~2B$1eq*$>#=;hN`lhQDJ-u-wwR zzwh52qj_G-E%80pZJDOddt+sx>VzgCZ;&?*D+|VkashwG$*UWt;_`N_i2OJgz zJrxhz>;R$+?Mv{kp!YTv=%0o)arbXT(Jrdk{NPi1&&26)ChU6h%8Xk$0aa%aaim*V zLdhmPbPHqY4Qgx5G4tt&?i4EQ*vl@b(l7~wzsfxkU3^r<3XX*vY<}se!Q#}1A4tS* z;MFGqo)Avnk;hOZT z5UxtUka5tjZ(O&Fr~1on?~6w3o%)9zP;+wOF{yrGDy)}K{SN^_)gLdld-_i|>lMNy z5(IWgBt1>xEerbEu3;gMdO|ICpgaA-&1}ViwdPO!;vuClgW#K4Tu`7CeogOV-u16{ zF@9M35a!spD7BDEpD^dqDs%|fR|B}7nIj$X6O4D^nmvfC5zP%;{uY&R#omQ$6828H z@H=}R<5?k|dOVmz;l>s9GOob?ved-XX{kA>O9ok?DQxPPG0_$N+!|!Qkgp*OIx({> zF8%eTZCcP&c#1M;3>vtidc)N#=jlFDVH6P}E0VG4x?`h`W1X0OTGYfV?T2rFkTS=h z?Vc--otEiuz{Xp+%M~a0po7NEaY7)aod4{KY*x49W|=acofVlH-(FK;!!ROYb1E)6ob>g#x!{hhwJGKFsKQrN}n+T09#dPYN# zy(KgCxUnT|R+Z_~d(&p5cc!O#)6+fart+4>Ld_ZB^lQMlyDs(0;zrF{H5bH%6DjB0 zMMrw3BYlP=J&Ramz^h6b!ZQ&*l?@ByvKgNAOqT>=lwxboW2FtB_>5P#zek%%B zzC#o?Uve)$1?vQN-PE~o^7w{ut`G4I(5@UbTHg@9^N;3Jcd(^Pn4=46_3YM*$*=%RBb-IvDf-#;IL+d2UW`(sw;c3BnU~^rBa6iQ?;XN(M z4Qvu8BuV9{7I6eADruNtA*79eqBGelY)}QW6n4N$Ov>|N3X<*`HJB%*%p7E%60v2o zC6!!U|dGpgd0?UPlfDp+7(&N;g zmNQ1LMY7M63ku4ka7vk=(I}Q2z9dUKo{pLYgATm60JUUsn~ZS#aVqn-FrPy9y7+Zq2(m?R4+V z_ibrwCRwg4t)E=Zh2PB4lme2S3yQ{{q|@uB))2CUoI_k$tA}7oDTERXWY3WQQSs6p z{e=;GryQLDiOpfd9#^v*%zR=bDl%TZ_XyzMksOm@6_1v^B~|E>bSRRG8n3!?lJ4Xb zJOc$iY(Uz^uf!80g$q95t~WS$mZXdfF4?@tqh>ywsIEO4ym{ZAgQeI<0&_KC9(y^s z%n>O2ux8t)9as0gd+?)?<1zCy%*rEAtt{SNO=Dw&%=S%+?Q}|+EFM>tCOcipx*MW4 z(WQ<3Q`L2`lDBIU4{Cdym&H(xQQ7F;>2)$^#HaV!U8g%;#U<(c>RrXvPUoBHmuo_u zdz_VygO~S&R@PKH%MNZXKW0eZ+-?c$+n40h#-wX`=RxnWx7&w8mvK32(!s?0rTKFD zY!J;(e6(7fmUa~?%>zs9{OrAD)8}AGo=iIe0H%#vIn6Pi0Hl)_9u3T6@POd*>vIYaC%5skg1 z{DTuP;Ys?uRox}?w&*=AN#%`PB3D>mH>)b4#rJXwEVg7=&@3b%9PfN0u(EPeagEk4 z4=i>rw7*jfPh<{q)I}G?f)L;}7i2|tqLp(RT~Xw#lH)H>#NXiz?w^n!*2|%%A^-C3 zy>iRRK8SwEIAfpO5`}v#NP7e2ibHOh)=T|#0Pm_hcx@E}c*E|(`$L1=@a7<1!&`*6 zSxzeLx8;_^KE9LngiS)$>*SW4UdjY!WTY~xK=`&a93Y?e80z;BEZkgzN{rbl?CQlY zJfyAYC-XHSl$s(QUfFX@96P8{LOO07DmjA+6Rj}iFi8<6>Dq}wqShO0qlBm(`23{W zS-94jwzf@%0d%fL0X!Dy!}t?{I^ad+~a z^vm@1Cgj^&^MB+U`QP(34dfd#l<(*NnQzdYd^7(oUo-Ok*Z-C8E%KxDpY=5l>h zQ$qV1fk=EB{qKCrgKlg7FS=Dw+W({*KR~yQ^jV_Y%)weqd@6PI4zVJ~Kdlb*_s>Pk zNof@DofIw8`lZ6H9V*-${l77lwN@?6y1Q_sO@i_tN}7RQl>c8#mut@OJ1lZA+uW2U58kJ5@nl;i6cAT{O)+E%%lIdx7o73kkMmDiZ`&~_478r&rQ`>=u>n&MCW za5O$UaxV)nN`zBGz!>9L;lyIRQPXBeLMsGgdtx7yOKJ;F%G%!+(?8?JA*t2`7n4%w zQ_@GNHOBZ`BmCc6!>Cv&+$KLOMoDWc;q}IhKkD+tBpK?(ifIymcw_E&c|$xg_xW~- zmi_%MZ-h5yf+r@~=N4f-;qpd$V$Cq)jfzHD>!WKvh=QCplOm zLa$aQ1yYnfOKRyo^kKD{TWQAFU~6E_{^*?)?fE1blHFz0669vdJw zq-GYP6kDd;a$%w;!ihp$XD!nvN_IWAUX;f;0PSuAQ%o3GCa|^;O!Ucvh}uPqI+=^w zJ*m_#^XMOLe}OCmOaCBa7_a^j)H+in0xh9pfk5hhUx3_lD~Wpn?G9orfq?`XEMESi z+OlJu^^@n|VnpShp0fQ&V&iXVDUM4Mgc2gN*;%?|VdHNojyw?kp5pA-Y^B88^(mSY zaT4|X?y>xRC7R}`!BOJ@%73dmDJUrzJqN8NZSjT46z%=QvQ-@&?9xv?y5qC?%hLyE zmcqo`?b|+*eKh0&vMI`?PdR#|ChsnYRV5$k27`^eZr4Xu&tCq_?g^T5wbglUMSfr4 zC0QpVz;wx+s$4i7#L$MQOy~$~d{7kTQYEB74xpB=MnB_FJEia?fksn5i(dXBEy$FPnX+<0I7aa=f*cJ> z>&&}(xJWrh;RhQ5eRe9|h1Xh<5|}nQD+(-9GR!;;91vU@a#V zWG|IRD7Z(dBC3Bd@d{VnRi4jGgrbu^pgQ{}BJ$1i{>Zl}l1|s5*bC^rfi3+MCJ+B) zYoABd!~Q5?4*kM_h0QvMHsd}9gI|G>NgtKTc8f*T)qPUcs|heV06h0Q>bq2R|6pE4 zABYuE_iU!fA6Y?>9%pGZxBoriVXAPUqD-a9*4twwyMC=TM+V5d29Na$>!;dU3sS{} zGzSQUQafnDNJ8exwaH{69;jsHdJx+ zY8ow-HG+^Xl_QWC3Y^8IG$;p{<^ic3Lm%Q%=z%Yj=u1-kF9*zO!GDR}U4_*=ZPlz^ z7dUL{x1)3I3T`Ic?L${G>f4aqVg)w}p*9S8Txk~m#8PR5d!({}%tYjy6g5ERNU1Ee zf*I$)r-Y#oq4WXn$_Bm=7f2i*O!1g{#sO2(y8lMLRDqS!u3rm~U$!&I7nkBEUn&~- z205^i9Pobp7~ZJ!P+wj0xxe!e%kJnL>^#0k*0TS&#K3jv&&N?K2c@S;w&KhBkrg{U zb*H_bX!pP8>t?uTrT&CgXi$zthtWUn<_; zP|!aAIOT3-Ew`lYCib+f+l_+v)+-jND{P#5@g%Sf!@Vz@C5a!(yO8dKcIoE|PY`l! zU4<_C;>w>pcw~y%i#5zaJgcx)*@&kSj}y;6JU8eYeoy1~7=ELlf&W81wRleB(H23b ziDxgK8+alCmx5;zo+)P(aKmd^%7!$;PS*Vsdoe0rSKG;b347jUVQSvn!%fjnDQROF zE~XT%`oRLW?H;-Al&GEPjF)3sr2C(r>RBEh;`ay}B$i?mCevXJ$!u77h$e^^)$lwR zDn~;o+?Uud6QO{UH%)CHqf*MPho-sQpJuDRyCrhlOtRFkvGliC3nu zwXGXI=XrTtiIO)wZ0TY6f3Vz7M)M??YELem#4^^nDR!p}I*r_vl4R{#W872=-=7>` zV)6F53@O67tH6U@5UPBdUR|~nO=53@((qdUb`<`Pa7HOYWlXlV?qc^`(X!+g??j8X zjim)B+V4fGWZMU9{N#eL&4o&1>}<{15hN0VMnGt{0Hr-nt%;QJup;3@?SV4*F5>6k zJ(BWqNeM%X347dqeBAi*34=q7JuW$6XeGhN-CsWc&KF}s`e1;Mn^6ADV89+X>5e{^ zkDGYM%VOE53Bn*0A2+$YaWGJJJ)y3)Y%ui8vPRxDJlo?!{-Z9V@x24S^(nP0mLz7J z9c}*)nb9EUoeE=XFF2yKR9aM4P-|taWc|!oOZ*92s})2nRX#3HnH+1xJunh4jFNa^ zJGG$Yh$d?SwYMiOLKCdvo!b))@R$Rqb7jIG34m5ljrWRPU765-24PR!NX?dT-uXeI zp@HPmr3BO%IVgDknP9wesSQd`T#9X1KZcY&A=RTejmODUez48GUA8@OgtSxsnBBg4 zxHpE@>`EIax9lI*9TTbf^{|fN(Zd>*F-H$L@=69{s*@@|+SZx(hrw`F2QYSw&9+%)q##hlR!d)2mW~kEp-Bk9H%h2pfh!bP3E?E z!zR@$4R7~nY$;kJPb>aHo$WHR&)dR(BRp&0WPlMQn4gLCo!z;cjc99mOR19xoG0h z_)*%{l6Ykk>wZHvbr1Xo$vnC;m#*Ah#%^D+7>RgYnMYR+lKD=smYhY#I;~w-HqFS_ zWhchlbJ~WVS_1opUlUzb=@0^rY~fC9DqqOOZweYm_;wIY)IbuVE`@)(K`W9#p87#Mp(jwXAiwXN6Ks&FODK@F|8XE~M8_8hW$5UU;pt+wX` zJ!Q0Po0`{ch9{!D%~+yt=#C3#v#v8n-PSP^t-3$XElwP7CficD~n$Oee@Vc(deT?0nlO{Y)8BN%X8bP}{?UKBu zrB8^U%E0u=yQW&{`7G0c78*-n4xOX+q+PeAwoI5y;g)xyfVc!rBsWb6pftG7&l(oa zoqVhG5ia3XRU)O#AjnH{!r$^XOwr{+ujG8{A1u&07EsHozQJ&qN^m`4;e-*BJpfyr zeZm!jRei;P3|kJY=Z-iFLSnPjuCTDASa`rKh+Qa*lS;C^&z}W1&4~V?5zbONtAw3) zd|Yetl#qf9HN1=$XszaOWSSJ~ZztfAFsYN|$oenKmy|f8oGDn!mew#X!(8EA@-GI} z@ub`Mb=l^&ZSyZpDrDQEV*Mj>3$-9d*C+!m`V0@V9KU^9Om>Xs9B;*G#xG{Vn^76l zl%e@ShXt4GP?pfN5Gi0V)-+M`wl(sd|^Z<}oU=6n1ZzeyRRLv9}1tfpZqi`~8?I)&HBqfJ;RoShoMX02vShq6*k zmJGJ>!M;JYD@Vh5@VB&aCyEA+;_d>nW z_CSAD05cGN4dH41S+HRki1-*0sr@u$XH7#UOw(f(V@l`smHxWV69;!X7!2LTEY{LX z`bt;%qj1>a4-lJ_tB&@;timK@5Csz^WAuNJ%7xL|#b&)EX5HHl4A2k)g>3^1@wz4F zjjV|@OH82@Datarrtpo@XKCiXe<)?!b7I@GcT)P+L*Br&z0{AjLb(u632B0FQ$T*O zk=l0JRYZ+fTQ;}CVhO!hh#o?v$`?z2Epj}pr$$jE?iZ2^5d&|m5JqntPqz*UBj`Qr zLO-+NCxn72RQi2Cq#{Bfy{k^c7zzO;1yB&qAt?Q|F6}0p-surc8f4pMew5~YZnllg zQL(xbGz4Coh|^qu>Mu<~0DPDPHp0hwkJ@Q{E*h(dJ8t`n^MOJ zGHN4;zq{0Z@=Ne1*K$GJ&?D?0NSVtp`;bo{eihHcW(Ln*Jjj=e)GSa>xFJquW9`ns zVq?gu&xIeU>@Z*U&uuMNM4_JWY?YVN6FC-Wg(WI=b7@IMmLCIHfsXh}k6{yFTW*GXl+$ZH*1O^HJAN@?Dfkkh!1HhY26Y`BS=P3>s2Ap2nv6ZZ!x(ZYuk ztaG3sJuK4#&l79>(Bp%~UVZ|&D~IsgwVDitut!R>?QZ-_r4%<{3+Z5)=v!RitJ9(d zrvz7i7w$`g}t$M@_Rh5@!Xcp-G~G#9|ZOL6gn zro|v3UMj#OH0=NiVp*>mrFN`l4~7F`!B`1pota4rNE4`2rg;Li32(pD(P9S3H4T4xDOn9phSl^c$KuD9ufYOJMNT~%h5r0@f&`w^yOzOqy6S@_{rf-6FHJby5JwT_>YHlv zWsU~2`lz*poRdd|g^PDx(G3|Jx_&CE)?!)jPFC%ft zI(e+bV7A(h;mlg3jk4>+hgp<_9`?_XB>2mbwu5$OFZxp$@~A%and3L~rM>7c(Rk^% z>cnv@ivBnBFOtJFoZPi0K48b=E$@*GcW@u_Kg*byhd7%Ae(gY=Xk=JHJrpkz$3OV+ zT0xH!yJ?0pY|cxQ%KH#u%H>Vsa5l(}RwD$g-4QMZG2|<>5JHdWE$=-tK9%=&8}!F` zKfSh;-PYe3?622-v+`Ud$y zBpI|p{5~Hhe$DV27#@atDi0jcv&y*C8~`;iG zG8)dFY+RPa{~-z~e?nRuOwpiij$EyP3rg`rhWiG&?Wgibd19KgkdW0&Ih#pgbi#~J zVNEKkQRczq&uu#OYo2wWMGXyJ-k+t+Teskz9as8}cbmqY{tn+aY0bfL)vp2nruruEYo5*f z2J~*!6rFCBGS6Ojn*#D$prgJngx9>cOI2Nr?fh#t(MISjB}7=*Bs9i6zQ#MqIL);*6&F zb73B3ZyfhU;1H3a7tOnmCt=lu|3Z!3G~DM?;2Fv^#%LOQ&Wufr(<_kPIoufxw7gYP zX5GJQ{wC;7=fHg6-$)&Ck97HXJoPJGJXrG+6~>5PYc5wG0{$66=Qe4pXP|t3F`7ck zj_gv^3_QI6@qb~(m1jqJ{L4e7g*t=duLG&4*CGCCEM!ilp)S!^_G5 ziv!BdMQ#&U{f)F~pQvRKXoHGG4gEiEj1%`#1ob?Uo5(LPOS*&8%At17KIOm-HC+vy zhjO0SnZhK;KI=dY^opndgq+`oFx5O;y_I$=WSPlZ0!g@ur3YlDC=$jz`))v1sv%_) zZ!lTmsmNZq?l6tAK~@6tW|QPNO!wFzD^*NZG*W3vklh9)v*xNSD}*%tio+CRgRIP9 zwZ(;=>GGjfcHnv;!U^nfnBr`Zl_4ZgVcm4>?Xo-(&c2KG-N(a<)o`=a6Mg{*BdX{9xZ3;g9F(iY81*P%AuQo`?4boAW z6x9|;-WeR$MGMSF%lHL?i85uf0NHrlD;qzrL!VNHJ_XNeJoR|G`<5jn8|Yi6YpHMf zGev1A@zx=_3#^{9SQU-~VQ=4(H;(l!uQS}2==8R?Z}|m=AB5}~!DX<%MHrMuT?-f= z{+7DNboy;r?WHg4REKls__F0j)1XXafLh5#W=ZKwIy3A1ic!1bOGG!lfOznO@!`bg zBa%3t$sI0#5Ld9!Y!(VP6|`R3FNycEa5eQ$3K*e9#z+VDjSfU($<*+XbEMEZg;+ol zo11Co3bKeN8YvPwI24tZ0%?uP%Fc*`qDeO!O%vRvguFs2{lU)6v$u=SP}zQqveT}I zeHWf`Jl*9uv>g;+Ko~kP5N+%sqSr9KryOxGM@`A8|G?TB4LS%o--p^f&UQ5!?| z+(~`})mVcXBf>J>nEw;fi9my?6ADPUCTTt?iI)i{1^Y>P4@seOc|&-o7(-|{+lcA_ z&M^r}$FqcmGtyx(<_&0%P&s|~2p~QAj0g{Hxh?Q$3(2ox9~e&!p6)!ICXOK+`vj7W zFvcw3lP8QjhZ(Qt9@(fK#AKr%!@YjHM>dc#43i&D;qvkFDh7!vp&_acij1$ z(bs}LIuPn;=hDDac0{h5>bYo5ooY0zF_8Y-=pnt;uSILT#p?e+YUBhOcTmS0`{W%Y z4WVM0ub$3s`BmG#uzhSta_saJf zC;(W#2ckZQPT^EJS9DLls;`qPYq5&q7WK*(>NA7o zYuIn=^BGp3>sgHFe^Z|iGWsFj`b71~_1WRA&&jMlX^L<<6utLt)}P6Bdb*=4v(#6o zr*)`rs#7DS(w%?A+k^aa8*o1*o;7&3<7vk;>2=KO@nBso&#CUYh?vf~`p_5dMtjX+ z+|KAJ3(U%fGG3pR+v_hJwb#cOn#GGo?e(-IY8l>QwAaXqw#fUApE^#5k0OUvhe?KU zw=)BEG=qp7EE(c&XHFc70VUL~F0}>Ou|T9BfSN{w!YwAC#nv*NLOaf%fzR z(+#1wi)U~LQVoM{7f+?EC`t^ALvnF${s->6eG1V;lnnyqh*56-7zcoexOx)m_3q3w z{luY!0(n*XI{2NQ(i1i(;So|>xsobVvf-WyW+B6Y&2IIdk61;~#(`2`4(&@X9RqR!{O@`C$U1cvA&fcQiL1>~A9hw^G&~VqHc~2CF zT-|t>@gYpKryJUC5xX5IloCm-CuYQUIk@>1xO`$|RL6M4{5$e?m*Lx6nJ@4tCa9ss zHwY6#!}@xMX`;<^U*@k@iVx74;#Vn5JVAe(3qc9{GF09hi59iIMAnlQpO=i0;h{;l z(087tXjY1lV9^<8tiUc5E;~+vt+NyIb^wp?Mz1zlegT-&rv_0Q+)eQsw#uhXX?l(} zxSH|Zt541Qk_q2-hU>o7r%zo*$m(HKUJ59}F`u`N*nkmtoV4i&aSMy_2BVGvkEUdp z%P(Z~wX8=qVn)HHWCb)OtHHcI@1I@hQ!)EOv%@SSZ)aEL+}kKP%rQ`sr*MPEtzt|| zd~=K>N&;m$26@cJYj7f zT+RzaFLb+@txF=m?aF-X7Mo)tHp~Bq$nj0ezoI+Oev~NkjDA&U6&};C+%SDAZOA-! z4)7NP)6xpz$18MbfG|UxMW96M6=+YG_mx6;UrDrEGMFt}(sbU&4EA9^ro;9`Dj~-) z6Gab(f3yk!rx0-U&q)l7ThaW*`w61YzWPugO#Ad%78rf|XCy0PvYs<0lfMda93jLc zUX3wRLOA$f^qmYC4X?=XQ?LYjsEv@x94>!QKrAkMZ(ad zVK|X1Uilty7#J(|SK=tc-XcK1k;M38fWnpX4Yx5tbW>Ej!j_wW6$5$Hc-IFQ9~Hr? zzmihIIioQlT9KkaXKfrGt$^*KQanpo>eRDf{~JKpJ#3)kZfKp{(%v??`ha$h&uKz8v{>Tg)WOy8&wPcn$#5yq)~se(NNfTLG>XayfY1&8gf03pym(pG8H8gHIu!ymV04mOEBQ-}86`V`C0-|> z9EkzaW|xZ{1Z$rilEGqP(MXA&Cm>9NRpPdpcq=B`JZQ2*Be=}5x8cHo7k?&*7{LAWnYBzEnd`Af0GY_L6?7iCdHx%^yZM&6%WY&FkpcHpA zQgU^MQ+48e;y7P5^@DxlkfbN_$mcW`WWCoeGa3y zwl_Uc6L>E@@i+A1oZiE6;tMR~Z+*zIx}fuR&-SKwv=@I*vsly^2037>4o8IDonk%( zfgEat`)}U~8TH2Vj%qFs#7o&&>8it>EkP$&P zMFYWd>8w`xTFSS4R?9bjXAKgE5W0RC^r?sQ@}yZ(LuZX z>fB_Y%L@aYCQ@r4la~mwp~9Oa{4jcGz3 z@gsqj#xIz$0YXIZ832Aqz;^=Y2`$qUt49eMGQ(||2HzvLXNw2nl^1XI^c)TKbru*F(jP-dWcWy z;OM@tT5DE_^Qk6VfHKXlPr|KU$+${Qk@%o~?fVwk5tPqp`d2ca@{1R@AjCO?aI@`t zT)2h{&2j@2X_@-9n~g^Y>^H(ks1Ufiqv5zD{`ehI9@c(RS$)L0SlBpUb?K;dmMZ$O zUA*TIx>aYYpHqdsH9qAKSF2PXpx5GqT&*c(FBi3)_w3_pCw{W#TrPMIoTCVnTaW%cFKY&*}ZLyn6YW)Gu z6vF+c{slIHfTh?LO!aKyqEh*kckvnGsbcir#`^%zo0LpSCEf?ZGA*i=Pk96HgFNNz z-GTSPp7regHN1yi}y&+eD?lFyhnNF;_oQig3-lUc)7>6;NFx>yu{cR#Ht^~ zOPp;%yeAzmV{8k?7C(ZQakd5HQy#)gf^ESB^$ae_G;iu>yeE~5dDN*(cITzq@-mVZ z%qva?%0%0O`%;qdGRd}JvN{nj_uCdc;F*ko$bu>bNX@l zLl!R{s7A|QkmOh}#Y2Fs+y&8CG3F0>BzM7x6a`*Vau=9Kdhf-`Qam>9qm%$HX*0KW z%;+T3>Z#+0d&{A~mbW}bs=kK#8q1+_^n*znMbH}uKA9g7WX~Kd(W-U6YLrUg9~%<}TJzDo10Tpfzk@Wdt*1W4!Z~0aI$}M%if#-X}ke{e$}qZ((D^JiKy<_%6k5 zxYA?d0e$CV)LXH^@GUks4jt%E)8p-GOpiCq)8mNpw~A5+CGELV6DAHlPc!6N%#f#5 zY^murL9TNPqu{Ov!+{bPX)DA>C@r!d=^JAQ_K>j!Vf zMNO?m@Pc}D;AG8_gI9jow6skALEM;$b0N6g zVa&HEshOI`5*E^=)xA4fR1o(W3v?-i$QXI|Qt{3-09uUqm*I+_BgO|Buy69z-vP22 zM{d$U+la$E5FdSn-Z(1}$>L1HKjBevSbK}{K1?`_6X7Z;bVP^8L*rzl(UAG4Tb|u) z%(QT@LT_}^Dn)FS6S)uX6y@(y*@*w2MN)R9y8wQ#L_R@@yn_;{EY^aro-(PD#EXCP zmPxd)OuiuQP$t+$gco2clZ1sCV#`)%i#wz zf@^=E62F_Wxok<2uD_1oQB8_$BpoM7FH00hUl@8yg*$*kGdNrT1oDOsDVE&?Wai7J z$UZvnIyE5nqJ-PEP|$Xz-mJxMv{LZi@?|(n@C4pkq{nXw(ysWIwE7I*%>h=M*3d@5 zB}~skWy5gAN}CVeS6+s{F&>!trs1#@dxWAf9=;*A1k-pv1BRQUYl%nP<4jWzJ0JUE zR*YR6yI+DM2>>SWK63c58M)ZGIdVW;E+_thqRO$FfKR!Yz~&wG@YUY=9=k8ea0lK- zE(_r}uHal?=WS*)rTv<4kDV9h!!zQ2ZfAkbJc5AFoCpT+?!Lggg_rF7iQt3%8=cA? z)Q1le>I0ylb31dr@$Ww0AE^Cz^%o}f0#ZsRf_L?Aq4+-3{=zee|DsUVJN^U0!;Gmd zy@B5JDZZ+Ad_sLu*wh>KWg!^A$$f#r#A&!BJOl-IcYN`4>6Aus{2Afi6JS}G**h!+ z8{dF|m@pcXLh}fg1eMR-W?s1eM6fV(SAU~%1cP(MiZC#oZ!`$6 zU60@~ZJiE&d~sLziVLeRM7*Oy)YU}ouh>;y$jZh#-2|g=Fzc*o7xzi-eZ#D!jm~Yv zsc zJtb-q`Q`dTH~Tu zSzGkt6Htw|c2`PKua_21UOUyubJ17dNN0N~tJdx%Hvdq4^P<#Nk2e&+#qy`V=(^LD1d=7pPJ4 zOGsjJbEBf$)ZA)y_8M*OHfwgB-dUq}KS;_BRL1-0`#;39r;W>Q!jpQE%f`AIB4Ra~ z4(!$&>v41ruTZorIlZx*045pW8)`5xb`0RG_nHzE!#B{)1u;vn%zG5WVtf0QQIDg! z1d_GishEhO3@p{QN)@Li-P!w&-riqUBzSDjJ0FZwtPcV=+XHg9aoIby)}8t`XJO89 z>5#P$;Lih^>I>zx@YSkrKhX5T0bDGT^LH8{_o{ttP+&mX0U8GP_8x6p0}>C=ShqLe z14pqBIYD7)mf|v~_*kEe{tTHD|0?0~)BTrEZR3u(x#nF`<5o!r$AGvEu&qk#tkNUY zteg=KNEP|EixzzJ7|x+8O1$SLPzJ28qQt8-c545 z#r_$Wr;S*y(m<&K8HA%#Lq+g$7QM-=_6=R=Mt`X936J^0W+^d*X8AuTz4^*QPB zHTLwNJ229XBZLmGU{3HhT!IkGRA&<Qi;9VH z**Jl7mS#ilMR47!nz3ThhJWu;z~Qq+myGLL9-o~UQ&^CW4s6lKK{?YUq~T$TBEve| z)Fs$(b69Li7jegNQjsKakaZOv4W2C+H;+R8kK<{>^D~|^c+TNz$8!ab06Z-oGoDd+ z4gnU9-*54&$8Q9lR=gj;GYIctcoyP8dpe>Rvns?VEXyLLIf_GR$=R=jEH?On5Rxqa zoFAm@+1j)$lA}5Pq5bj%zZc;HZgP9UNgJ*b4%2Xh6FIxfy27fPon|f6<$s^>FSSjP zw%bxRGb((vI+Sa>7Se*EyE~D~a;5ze)6_JE-VeBld{EjG+NRlzb`Vg3mzEaMHamon zK=+J`{>~%R)_^v|y`W8df?)?h=k%Yj1N&eH>hiPG3U$Ws|H6A<>f-OpTRhqyCwd&) zq)YWuL$#z&w>$<7QUO=*U6o_4-n1x$3r*xkxb(lqSR+F+lw4W{R$z%-o~!vSYUo)) z+C5r*6!8-+q~viqZ%D-){nhJLO~w#zKq5ESmG)~)3(VUOu=oe`1eCL`M%L3tvB+w5 zCYNKEQZ7lkD$M^?*8Gs}_$^5G*O;b!7Bk;vc$uZlQ{*Up`fB=$_EV>D|98ygePTW% z$1EQIU&LJ4CuWW}&FKFk=3{+g&hn-?^uLHXtxwDpZ<+!X56T9)?Ji!F77D4mgs5Wr z%f&-w(_gn@slHH`tc(A?kxmQ>Li$)~y|DVSaQy~+OmmhvDQ6sRWaYvWxoDT(6k~nQ z;^@znzpf(4=OlWSe)=kH`P)=gRZR3r{2PP0`cD|nPKKi@H){1GS#_$)o{SngCxxBG z>(8}q!ruHCZb%|m$!N~>=b7_t#f zNzS1EGs+G*iaLz5Z2zw!Z1bi;M?Wx-{5NU5Cr6Qs2xsyATx*14>uF(nwlVD~G4EN2Ra?cvES12%5pJr)it z9VR+-Z~P7E@HGjxKGqCN)ZnpY)lrf2^2hSUa2GIwJ2b~DFc?Cfa%DdmW6jsvFc9Gr z15qZ)zC*1yIVAF%!??2)8 zgZWwyYVdzT4c1kaqZJu3yYaNpkzg(W_e!ID#4gFm_P+^MgSqo>VTUl6z?d)A-Nstt zrCt3`1g}!C#XD8UN{wUqh?4GMf4O2zTL8A8Sh(GQOU>jNn$7uVA;?;%{cIy&d<7fo z=(yeqvgIh~0wDTlKe?l3eUQ9S_1PDEN^7^~@o<}TXuq>na0=WG+l}TOyN@^*?D*M{ ziX&M^W^yRp9pCKuj!4{4{2IIC^o}ptd#vLT&h{|pc!+b%)4h~<`^Zk*1QZkCCaep4zFYc74QHa6UQp~#KcM(iXoa_*Vrh!)9yI-XDY zu!qvmrGGE=5TW-Pow@Y;rEqWf(2j>W_d|p&=W=rUndZ`0!I680kIGa&`Xwe>&H_+$9=|C`1NzIge6pz%of-2a=#THdqJS1c{8Sbi?O+CrP*;V+ba=XjXA z8QW8&D4=gjy9E20*hW^~jVRzps03GFCZEa32)Z+h7S#2X(!Wz_d@PJ;nZe5VucaO$ zbf)=cY-yKF(jH6FRoS=Vj)p)$P;Eziggr(df2ALHI2TfJqc*78JmIB82wZ)617ajR zB4@XEwF@;X5+3ta6^mQy>8>hNHe!Uod#aD*Y;P`ICwvGZr{GbSRk&^^e3Pu$$*b=n z1=mT(BLPUg_y@^;(vcd7SD^;`%JiY2kFb;^_CdBUg1IPo5Rq+>cQ9MvCChf;?7PFCVUUm>qQ@%O&m^kJP3 zDWGg|Z{sR-ojM!P6a1X#9uC&pw~0G0^YSU82j1j4RQ-4;S9w4Rq<%GSwNX4gM zefP=oW^Hb>?(klzqdE3eb5u+7q{il{?&geXA*&3F71ba0zz;V`eS$_y>s5~CD9cXi zd3&%Mr`h)^+{wgB(jKglh3fNC#Xo4ml^OseOv?!=F;$PRY29mm@%l@te%6Kh#eRCs z(2OB5F=LwI6_&lX)311dSfEPF)TYTZB=5!z)5d414C#&fNGe}oP3RqzpfcP)1*=BD zqkjWGxcv9wt$@>lKUy`cJ;utR%(xqRtOq0TnDLCl6NAT@jWuFA)|+X-$>y^=kdw|}qH(a@i*Pi_h+9Y7g&TiGaFbWLIKvye{S3F5% z193fjg@ajp_W6bgm^`;Yg?U>ct=H{f)=3nKv3^p`@cbtxg|- zfY)Li#~#ryb@K0>)sdRSF%h^!P2|#VN{QKpbhI+w1i@c6_I47}yJdXjbw7k8l7@4M ziDRdw`ziyVRR6@}vD0$I^Q5pK3mOJXOD5@<=HCl3!9VAuls!e;o*RN@A3M7;W(Nk*PKa0+x1{0-}|_>;rYhgDJ= z!~9KiOYXm{$tJsI>Y2M>9)1ul{pKzuiN$1y1?{Aw}B=NDUVf28h{+XA`D zM!To<&)h`%FoQtJaI;Jm^V7krBbqa&(u+?p4Co0QTwLlb!1DgA(6^AEAVcU)TrOXI z8C$*Z*;A|7#T!Cy9)zVAF+K#0!%yl-MfGNdcv@QhD`J{8k3@>;?|^db*7dL9PxWbs(xF+(h~o519=w&6nUdY5s5>F)i>pQqmZa<=HD{1 zv6{*(rb$8NRnaBcT*Qp8uPDJ;bAsQHY#&jNLU1OUfJ*`X+?dGD2a@qfcin|byo%=< zmxb>b^t6&f#o>|{ZVbJL4B`^#S4sxXWlmBgbCc+Ma446^eg|>M_)S0`JqC}&bxPw- zYGThw#>1-cnfu%Y1G7vkl?|t*g!siBf;uBtJ6{o(8?x$@*pE7?@R?hA%Ri-Q-di&# zw_A=&u}7t8ExtN#_(8H9lP0*Q9T622VZ9>B#XY}9x!7;UY#FEGZ&JqQgt_TL3i648 zFR}2xPpms>{j@TmzW$0f+3BiiajwuV{S#H_s(|N<`}>Hm1d&yk8)R%AG#C96f?ETG z%%-O2bjPg^Q8QZ^pgrK!o^UptORHa@O`NJgnL z7qo3vdL(>utMqHP{=4}@X)oRLUgh75gGz8v1r8jW&2LpO4$k=J?$x%nJ*RuZ`W3N| z>aV@vtVfratUstc{EnoZ?F6)M@7NE`L^s7+NF3bgw{+-v0c%s4$tyrMutP5gGULCfwL-qcb9D79p5;=?SpjNV0^B^PzlVy;(Nr~1!W zF%68w$>TMMuM9xObzfVTu!0Ui{!!4`3-w^cGM!jl+0EbyUo)s`@XqOLyw$sBd;B za?(tRe%>7^XQb2+Eme$^mVNr>uYuMnA-Z^~wk*vIJMiXotJ3h1r7oYXO?;3cWxc{o+Cb?lP+1Wz+`mT5-Hb4`F~yN;g0D$n`QIiQuJ--umx9hMy{ucN`muDC9) zxDMP@Wm&5D9Dxvh^@KKKNckGA)kZ0nu>FEG^hIfhSbqc?34raq@gtYj`nv6Cr`2v6 zUK3#aXr+0l#72BfpK(N;_-jz_lIA4ztOhJ*dgv1W;w*+MAlSyUuy&4rI8? zSvy%F1c)BV{gDd`0ptKUc1?HwKB)1N^A}p8((AJ^WWZ8)r{ws^WpritMcr5vB@FRg zmN-uQm?8X@*2Wq?A)xr*5|)EV`cZ6FSS7N>0a4HsZ%Z59LAH-pT5YqCe7!xSqET{P zry@58z;BLMgBuX;o#-;Sx290VAJ)~4C`4bs84u2VtoKKw68s_C@M1D8=NPkeaMIufna-qb5$R>({a86n5O> zT;ya6`T9k&j%mb6?91icz(g*=MQS9;6%^lor3ttE0260lxQnLupAb5}xs6ZZiDCuf zp-BtnN2SKASl0}r@yHw? zzIBaEq?lz@Nq}t|(?zi+P|3s34{#_I0eZKD;hhg0fL+G@_{DnJ^0#YdmC+c3DUacX z6c@oY4p6uU!0G3>Hf+c1>Oa)Op?jS1UZe3I0*q?frx$eCG)4eLIY&Da=cHKtj>I`M zmCbw)vbR-1Zz=5U9Y32>^}JnZ9LkNXYn;P@m625=jq7HQAApXqWdP@Cm&__5&}bY3 zg2W3gCt{afH{5xkdlMAJ%JRqd6Fb;Cp#I9H+s>vdyVSxk7`k5|So-K$*>xdla~qvs#-`0S z)c>U^ec?4Ba3wBk2y64lDMMjM%b?L)HBGe}UJTr-Iii|}EY@yVTBlt*bObG%NPc}dha zWE-{qxr*b{g&;b*JF3j{z7)QtxLOJ?OWBOOjp10sXbgk=&EwNwrB;{fmzeq>Hz<)y za>XPc0ieJycKO5Dg*U8~^iibh5O_f8f@DB$*Ng+A^qI+A zwF%$}8sYK>@A2-h+VuKI(fo0t<@jnouBFKgb0Yc zEiTnAmFqo8984XnV4S2X@E7_gHWi-lf1>|(7nWAJQ6VtfY21v1vIYLRQR(;)E2T;i zxh~LTFEVVYJ+E@TA?;FEyg^ldBe1=Q>y7dfuVg3#S;31IzPg zp$K=Wb@65zO^wDmtzwM}AajK~gF42jDFgBc^2HxXNxSb%;wRa0X}#w|3ASJ89Ro=g zVC`b|KM0F0(q(y#{4AE+2Hoq3ouK+1O`2IHet5rk;>P-?F&G2Pc*1Bbzym#GZVpUZ z6yOMh+2r<|hp%Sj1TIZ0)GsZ}$O-j{R2Ix5tPaH*W282GtSx7tBj>IOVp7fkV(Tm% zQ$(3GIDJ$!pIE?aA=<)pN9%7)4Q zFZ$VX2F+I{#&cojxgL|qjoCIrZk1o7NY z*Z>v{SF!UmqSBS1X&C}Dj5Ts7U=u~%RRXt`bVC!wsDTrNfi}ayid|C4C0_>Z@a!KF zm!r)$j}p$q+xuzmmf~oD72|Dw0om0FH8nYNcc|^s8*n(qMNi&3V;2+f;JWogSQ# z-XE3ei;;CHba23WWriVSvfq47<3KKRc0ZeQrS(HCG$f=L*mvd~zb40q(3|~Q_Bq%4 zHQ6?VrsDO+JABg{8xDN#-q&`JcYd`&m>Aj_BuvKzE$)h7Zbt}gU%qz2$Y5!qyQ07I zLw&7)GaPbIWkb2g3DXm3&b>h+*@6NysEYA8gz^t*vR`Ght}5#=R;A58MxoO;Xy+W> zh)urT-QL9Q;(Vnp0j1(F445EpgymAPOF!vOx&{P<{$tr@Ey@H2wuK`qd_8Yc_g=d_!vxjmi;6- z{JC?rTN(vjr5|+`(f2x{@2L{o1m9TVFlfBfRqWIJ5luRC`CZF?xMJMQ)%ar-lsQ6i zBCz>y*qgUT7E1;GFpM%TLJ~5IIcIMg_FN_g)%s{{rJo~u3_haO;G%dKhv^UoFvswF zmk+Naui0v7aY><^sx-{|LLZ?` z^-GFiq?K(dOhe>JFj)g*N-|pLWCqJVyWawTqtmK?UwdxE2~|N3Y;6MelnHu`5;h`qM59YB*4?}*O zDcWn3+yCjn1V3g%3_f72>jf((SWufq6Vi*TAT?~f$#UHq zRPoH^@=e-Szm`#y>#88s*K&U@^Xqf!I&=k?Gw)Koy#WVQY|a3z9a;i8U7fsbs@o|r zU72kF_jOp1Fv#6{=%7k4J6ns6D6qRI1WpPTzT|e9KKm#%W8ayigJ*)i*fJ{3S(tdJ z5YvD3aolJ34%B^-u`ev?VA!=u8UW=`=AJV%p>vc5Q1R1FYgxH1j1=-QRZTWFIzL}B z$XCoZC0AN%V=8!E{IK@FK;{QwJ++5q|0I`pk21Ep^VGI>2eUdA`sEJfUhLQQFKzj| zdgufU6R*_&RgbmCR(^fI7XBsSHAjwiZ>*2DgMYDwUtJZlH>U^krxyN&4Bi^Ym&PO( zetxN{!WY!Yzr1&u@58~bYT;MTQOxi6xkY&U*x_Rh$HZfn)gPGwRg)lfNi5jCPf)hRmt0SKUv&)n0!d+DsSdj>;WcI6Kg&|2v zYpV>Np`5U(>Hq1`9Xz#RZ-@}?NGjf&o-&vdCU`M(2=kRHSBjRKv7yDFbtJ73hU~4V z64e3#t(P20MfhG;)qsP9j@`G~nhG6BHb9!I4&xBtQyT!-dr}zYNTRu#k8MYw$W@uX ztA%-uV>$((C0FLIV8BkAQ{#3~JCi?_!% zCcV@P)|y_nBq1a&>BU~KELT}xWsW0hbuZX#$j!Nwqkhya_k)`V?b(J;-hJA7Cud?+XQ7y+;f{|FaPS0P%J#SG_we8 zBXns&5q75WpFY1l$K;Y`-oXX?w7^~;V))?|Io z7aa$AopGxlA~yPSx)s?wLlSrD?P{C3ALh@)H?*-eQ@9y>gBH&4++~}Q`}&Mu^|da% ze0D|^serll^)vkGeNy!$$u(ROuhQ(FA^~5l?m(A~lWJhd=!C5g{?{Rx``Cn8QREX{ zC^~NYBxN>dmHdhR9VzzIW5}GH|D6+FIR7>3%y_#I;gvkj@c0xnzRF_p#@h{0{0Jk& zci%=rUeLvq4#{BaF!N?3o8uz*&ECP}t&)>o=57$rD?98OJDpv?rZCiVAVF$Prk#Pt z4R~;Q&T$Jlf$0!lpnRh6GM6i37kA*SJ#JzVM_!IIg&R{d5Em0->{0IP6qnsLTq0r# z8d}%2W2a7!uW0CoVjo8-!AFw`^Lv|#s|derGlw@$W3h1xXh6tT-mEklhtVWHFz>5Q zPas|Q;&$TiFpx*A$UU9;aiOt4;@)P^wByhoqpkE{`OL+BC#^o^1ye417N8X~ZyOE} zPqfvoH5`<@@mMywWazrKW3I3R5AtZ}#4$hABhZ<)%C+(qUQ6IuOfG+d2U@H2qK)8H zy%o7Nnu^N8^0$bmKF0+B|LziOKKsDM9ExA5v2DfGKd&D-)@eOqYWTjRv3nC_#u}Z~UjA04ZEu&Z%3AWC)nB zH<}|HA6ehBTmS4=S^}k}?eXD6+>dj-J>0!lwRVJ`V{hlinqe}0(-a?x*prtMl0eDu z;M3x@WgFa%;g+v1;e-mu;dqKL*wTC{*9j{!4zu>Ws4n5LTsC3~-aUp&TwA1X3*?;T z+3yckTWd|!3kjhP2N$%~y0ma(ou9n^&HSbF_?to)>4FPflrV-U7|UAo^|{liR&?=? z&mL*ak9SONhjgXym*O07d7+P=l9ShAd_$q1HN~vX@krv^6S3lrdy|hDI|bUaCpzM? zhR0>i>9Ob_Eu%qRl5#gTcRo-F+o3~voK1@CLwF=bmsE)UH5FkK@w|@r%2Ap`O$+pS ztWBbU22m<3d|o;ic2k z;nU<_Q+lI@lF5Pp11EvnuYFB#`(-|9SU9!thLn{zGl%Sp{6`p&m~CKLu5UO*&j8 zH6M`j#sXiz6ZlC^ed0)Mrdufto!kz(yLd)9eU)^=@6wkNeB{EvCaxRfLF9y=m&`J$ zdAXD~R5B|Qll0TN(=;mU_4CgT?{I%D7aP$jS)a^KtTlU7K*!9KG zOBuD9NkX_^oPVK^ENj^H@w1@2#_CPEOEpS8Nu&SE27SSXtxB(sy>xsg4=t-MKK9H_ zsMiN71SQn#u-WkH*UQGw=dDc$-*-Ryc)KNLVv{xA361BQ?{UztkH4qid8G%{89X^y ztw6ufcE7%*W$4nK<;E6;&>!pZr3cFQ@7$_B9i@me@}3itZTHcK)aYKH=9>@W^ynRR z+nHHFgB6XcIzjSNooVqT@Y_+55hDw77ygOFmPK(!Dwz25l`V?TVRK-3!A!fXGnbb~kyAw_Dw~TLJR1}<` zLjQ?jD#1T{0oJIeYZXWRV=uoNb3&W**v;cl+f^;0IM4ZDV<_jUqQ1lKk4f7E|LVWP zevv!9iO0kw?_s|BTd6Tr;SS|ieQ5zc+a2OUlf6P4yNL>QRqs-< zE0=A&xzw&*wnkdIk}}sv?SRmiB?^6sLMy%^GygsaD+6LzNil1+%R=7vMh{rN%_>(5 zaP0wzJn3r$iA$+qR&{UOz{VF~cMi-1?KLrZ;vRt8X7eYQibET#6`el_DLAFmdCith#(u?c>)0}Rz10ZE-Vjq!W#%h;6{J&~G%RjcDAZDyS zogHQBV?nmkFLqx-%y=daesSBpeK?WhV`gjPoYgV2^|6J-#2k2PF^bHyvSHc9^koEF z$#0r1K0_`rbN=Vm>_tRnF`s!^?}29hsaLHlSVi!m8}1Sp5E6pze0Bkq)M7rxk1J7# ze!%J&%AMxbXN=}^S4I;)? ze~0VG#i`xMnePqpJj6k;0A?J7ZWtg=reGlo-z#}v1~3m6qVORmc;n{ga-l!nCB}I_ z3;58#^v~FK2PU(!KX$~P!)HDlT0EDFgU8EzE~2af!(y**!#*~Z+U@X*zu)XXP5XU# zIPi(#XiZ*@Bn*vwmZ!PSVhoq``v?5O_sw^{V(pb;0k8I#%RF=Juf^9$ELQS8*~hs> zR-OQ((oE;z$(LoDefK4!WL1E>>1JO@xdzqi-;s5oK_q_Cq!>^^ITzP=m)4 z4fvH74|xN!c<~#0Ep`!wecjOFcO*0BIGD>!<}KQbuz9p86-H(+ou3dXzIp?3pau%J z3&yoW1^2#xk;h}Fxd@XzV=_(9QWTtxy^Q==xJhLpesagvaOe3Fp(TjZ?QBUUc64^f z?hxSy46<m0lFTUDoao7StAjBY`IU02nTdN+c6rP>(4@A#rI)p#T| z63}0&j#DjB-@aBRx?R_j75P6#UJLci0fe4>84-ikeI<>Td*dbe_3WX zLH{GB$v|&ZX4l*Gwnt<71m@V1bNc{tW#Wy>1q?f`PvAlysXP`K-zPBNmR!&Wu*gTM zfMJjA6S&xxyrdT(PWhzc(b4YYd2z{41C04r+K>Gc3z~-}?m5vvanwKhCw@Cco2bRw zqU;`RqIrZiaS5+YTywL3qI0+=aUQ2l)Zgi!n2e_q@2&Vs&(;!}q z)Iag)NKImAv^Fu(q)Gf14`*TbF5-+8+ zuUkaL7JS{+9rh)@*agJ|5qIHhm@f>AX8=kjmSEy8|ARr5?a5i)U)!aU7rH+_l^Q-m z=#*~2$5P{ydfSu9K0w0jvh+ zTdL6?=5XmVFABQ_)$(ne4gL~NM~BSIutsi}uZlKIQ20v5kbE&G`69Z&3d=<-)i3fB0jb5=dFs8+%8-r&%C=w0FUziAv{0c z#)`FXo`5FW8&=U178IXZ)FmVIhn-&*NFI9Oxts}|;$OTZ)g97*jHWGyd7wRH`TN=z zR_5H(DNeW`v*Nk*pW_7&Yp+DC*I!tb^Zjj6-zmp}&XIc<+cl6uLl^elK7wB7Q#{}Q zvrF3e$1PGs6l}EdOv00lXIze=#c73l#@(zH-x-GvA!A$Ti^}jKAxl^cA654W(^m&C z=_kCIVTlp$MLA|zVppGzvrLGyOpLSKH}j`l%fMWVF~br!GcwLHX=YK2MQgJRa99S} zEQ1>@p$^MkHcOb>GQ?pS>bB@?mT;TJ;INo%mWW16q{9+rvkX6Fi9cl-bILOIh-KUn z%lIRfggDFO49oqKzRIvXfLfpQiY!vG2c-;4A^{$h0Xd5v%&=HmEK^!6$sLvlJ1i-U zmZ@$_s?9>e;*&%8IlxzeIJ}+WZTLvSDW+(3W?{F^#84-L)REZy^C-CeAJ7#Kp4<2v z`FST@-+Z?O%IA{u2i;|8Ip4_7;&z(cJX!ANUF}Sv>(02X{?KH5)byG^V6fryK3I{L zJ27qHK8%L{QKO=by5efIJ{13UMDq(l53qbO(ABTM@6QP z9+sP$OO8W?SJI4n_4g8I_{TXx*d@U87#(Mb!mLjiV4Ok)B>P9j8h5y0m(M6;2b1#h zL6_l`b7Zr)<{YTT7M(M!IS2eyCBa03tv;e(qcwa@(2{OVM*<&biorsT&fO;PTZ3e~ z3rdx&_$nM7I6r|1X6C@{CwlEU@Pv;9UbL^n4S@vbhqZqq>nFwK=PN!s*P>y{ses9i zn)H*yZi}hX;bFI3!)_bdJVFe=4W5J{P}a+5647f@)RC^-O}@zB7SgrNHPSqIM4RavV{HkV|rnu30s zoD-8a0eaQBZiR++u*{*o&Lu;L>B&1fMJ8|exVboTi z$%kFB%YS56T81I5=?aw&?xb@V6mffbv^@*!sJ$X5byskxdMueDT4iC)D7vsX75 z&iQ1~h7Gg_uiDJx8V4%e1L@EjAnt*RIP(-pD*UX8Kb*7H)$gx^kALU@t0i%&wzf= zm)Oi9C<(~h#n-9iVR36SKZG}@+knb+ymw}X&DhfUL9N=FT?i8p&gOpX19PB0yD*6S zBV_Krm4Nn(2`ffd>`N_h-R#Jko{*?=_=w8s3Zwj!O0Ypp5sLaxGM4 z=<`+&e$3QQuTORwL#!DlVw=lgVHukf!!J`I8WjpI*R<%ppwY@W3$3cu=qZ;B93K^^ zk9pK;G7(Fh95QNvK2lF{DsvLjjm)ChR}BW$Z9BD%34Fde*k{DyEjEC0j_u4C@4^}C zLFzBkH~jnmW9)6`CcC#bRx*Q?IuDDi2DAe&|Wy#ch+Wo zkuad#Q>D<_&siL{UA^0?3Cj_vO+V*N8FlVmq!;K^D?Z_G4MSUcp~cyxAPn)yNXCF)DB=ay*CMoUL=tT)%+{)$9$1?F!naCLd6?yBa-RuX5U7rCd#Z>&st*)sxqe<#PG0wZvi%a4YyWHTksK{^mf( zw){X5JB!)_Jb4rB*paG-;m?yb=`F5a5o)dX*V!%j_>xV*w`{fHMPR)mY!sKy;25># zkcAyo?~9{(0|~Rmzsrsw_PqZkgwhLP2yy2IW{dmMiX`#dofi8jF8HWdg#6#)mm$(g zZ;me}e6exb_TIImTr^L{?QZg8IG_J>4M1tHakcu;IYnsC zwGOLmnI9TTS-1y2i%3fEs{Mm&so(l5VtK4A*BTeYt+GLFQG9%ZD-Tx?6aI`*Jye9b zaid6*K-P626m6AGKq)(n`KC$9-h*h8Gl$z07rzSbAZHhx@DiDS3)^cVTKd%9xl z_SM%g>S&!li@dV%(7Xt4w}3-$($107ryd>6y=K3b-9XtK99{8raxYP;3oR?XpBVMT z=q`@TE{HYP^ z;ptyw7e_=XX#wU#G2Lb#6I zA9pJvtH{Sc^+GzbOOeoVNT*ta>{U3!jEg9ZecNIG)@}RKq3cL#K1|oRx1=&$sDe7SbN`hxT3b=t4mv5 z=)Dw04(Ryou6YienBdesD~Cqky!rrIZDEaNDuYcST_>oSqkTg#XO2UNvaXnlUcD=q z`I}(D&W`Z9Z3?u8w{w|y1q&X7Kq}h8b_&~^mGi^Xso z#Z;q{S~pccJKN=-w>>16lhzQokXNrrNDqX{ZT9Qbyik5F2R)Lw(7HFg*>K{sF)^CE-yLPYRp zKovPbR~(xD^X3bpMiyeAgO4b)i^(gPeRF0Y1)D;q7ijgidW9MTiB@|kw;#e{yVhg} z(#4UyBAh#x!-k92PeZW#17#~h#zX0fLv(xZj)#OIbW{Q6G)KR7ehwX2XINzaLaWcg zh;*-W>J$;^T=V;vLi;@qBLq!uxFlV^ys#e~o$b`&g|B>zr{J zX%g2s5NvGHcDMV?>H7Cin_Ap(w`|IC?#-&( zo@MD!nVrvD&ZsP(sNReXpktRNaV@4wbIxL93@%?fpFiEqHU64{ODk76mvWjat8y^L zeNGR*`TDrmCF5RC#|GP+Q_Rkg(;hB-nRAF17^3(%HW-1ErFAB&{L=Z0z0AtFH43Cqm$&V_duW7rK`XGjW}6ChjXH%;PL`QaPBE z%$!4t-reap=j4x<_03prRfivMLn!J?*0Jh@|4Y{K&Dd{*?O+p~TSdcV94T5`j2BP& zo2E1;`m=gR+|H+H|2I5bEzL*!NXj^EZVnqyi;h&J-NtRUSf^9;+i|Ku<$FKTW%L#K zzU@i{rR?G|W?X;jXE0xPJ zl*i?8t3Ji4LM8h|GW)le)x6mc7egsv_7j&Acr!-(u=alV3kvHGj7!2ej zK^f?&)MAxVDIp>~ixYb7iU3eW_Ib7P3hW>VUaD>9<3{REyh^ zsCrB(S78#zN>lo(jk0v9up;P2m2%H=J$X)cJsDjS-@-L!QEO}VySd#A<*_z?`jhAz z?ttrr&~*@Zu#Tr^Ju-r%5D!`RN6PnZ$7{3jw<&6$%DG>GZ-za4Wd$95#(jb39NZNA z7PPzDS~ocll7lSybNF?wo5nsho!MR+{VJDlKGjH1H*MdJ-WR@wlK)O2U*f$zoFX^* z>Q8a8uVUF^IaVl;W23?DjVi;QMBJ;~?qmLSB1T^MB2UPt*5Mm+FY-vkStn9DSH8$| z99p|2cs``1zXlKb0m71+bob~Uous=aZU*N9Kq1IL9!2NxH`Gw)Ve&?Od_=@)s!8i6AxK&5>Zg5)N;5f-~~Pqahug&fR1; zsOOp~V-tFp+G_7Vrx3@#7FheFrfY|r8?cVwxB{c^fR&bh{2GVmYR;k??MPk{t`rat zvod&p38tkxRB+NC%5_1^$l=dY;!}7ajNi`{#!YNY(ld7Kw@wZd~eZg%K!3C_>6!I?hZGn_po}~ z#wz(EUZr!aTYwXGFlrwZ%u&h}3U&~|Zo_DqByC?3_BX)SX%&@KSVrMGU{ht;EBK0& ze?3PcZ1q{iag+1e#OXN@??` zKMw1=9Bfq4+^4_ucXO$yzwwua#tDBU!fEdeKN!&bfj>BUsg@4S>a=qTHq{slSpd}^bwZphd7x&$ww zs7Uf)IQp$byIK3huc~lLb5myYAEIYP*U;%t_xXu)nd=1f`HCP#w9VWA%|Q#U_b|w5 zQE}f_^xC4GbyqHt&REEW^PGpr8*d(u>}B8E?8_G5a$i;qw9;QZ1yEX^G?5x zSEPGSt7EN@T~gN*_>kCMZ{_EI7ck%V*HKilaMudh3OWtn&3O2Vh1Q!7*KEFh^G09#W{WZI8 zQE*40-LI5#l#6~xe`#Cv+xa|YP9E}49?ld$erF5)ZFcDI+Ie|4GnH*7Pp;!1Za zr7tpXUgtjA|Ers>U){83k`u5qMvvqD^}{YI%l;M3Q@nR+zBNuIzlE82+S2V@VHssC zM83;XxZNdqYgm@UH5OAl0Si-hICqbWmt34zhkoEOa2-S#bQ3UgxxXhj2CfCNH`S9gQJZ6SPAeQ19GO zoxs^6(m8Px1f?s+`9pt35Jp`r4t694MbFuhD5m4t(I~)t%8$_^f6Mg(t~qvo$>Lm_ zp$5{M9N+ZYu)fAUwb<-*ZrC5oSrLS>zNDBlo`rKxAst=FVbhI$7I$dZm^qT7C0@I= zoNLZ~;l6mxaq|%odrxhFHEKzrHEt2N%8kdQ;?heQBATY3qa)gd92?t#ON~F$e=gv< z`g~CIMKC%Rn*~JWg`$rZ7qb2j3V!z8ob%%e0eqjF@QwNz7+VoETyxj@%y*=M%DG)K zsw8gKkPx3gq?5`~KjSu1KjmCo+=Ijl!KzU^bkunL2ub~v->V<@8Bs}G8lr#-7wV;i z|CIH=CaOkI(w#_Z=P6>xwkIvHyYLkeRIPKL7t_(wL~i#Re&Hd%2Jfr97;jJx+`xvr zq=4l^HddA6m;M#-=$Uwv$0+4=W8O8~P=UoP#QF=hOtk>c zS&y=cmx9TPgQo(%Vi@oIwjdP>P@KMf_$H}ezWbF7wF3Lp;(aZ8OF>bPe)9Rm9HDIxGiyxU+R8GdGU+A!b z-{~*1i}4>$wqLvqQVZqk*!(V{xo8*Sy`5T2x4@hrq?O~DWgRAtWC*QSUV`kw8V{E3 zFBcrdq4~#9Uk5q#R@{+cBX@VykgcKu0sU7z6o$}^cn)PBF`q&kTYD3s%XvvksCvnj zK3EEWenSXL0e|*Oo1tw8V>+MAA3D4YPXVs>vuA&@{&;EjQ=8R%qI=8@D1LpoKyJ-QLkeoKaFGDdkE`84~N)q#Yfq zy#?iDYyRE;QwNJ$B5^K}<0}As)E};pQm)jJ9Cffdz5bcYd)Rx4Tw{Lg7?CPDbt1NI zokgx(WG`Xa8nkhuZs7XMvpd)$@aQ_So$q+9Qy)Yg4yh*_pSo<(AgMt#{&v^U8Bh&YMl#b582xK;g#kcdDzVW3}^U3>HIp!}f9D z^m#4e&L;1Ck+awPzRaNy{}X>#%K^PmjP5W!EfH4^Ar8Fdc~ga1fZ88OzZnzQcG!F7 zowsDd0BXmS>DF&aFTEh>ygchfkn8d+Yb&vDyt7pqwZwX9mR(eRl#4UgarSh08 zuTmmcc*Rmmx{7z`!&$gmvXKPp?4Nb0f0ie$`CETy-?(uYt0Z1-nvl#x|Cl9LwRI^u z?MjMil9yifN2MsvAS3Z9|E9z2^9s_07)gUuy)lx+*mAB{1>)eUrHKjguO^N&l`K=O zjDK~yH$^h%p^euQROLL@Z8cXPS}vXQaJn?gP@URAa}!oQ&MlZ%o`$u!S0|bCuwE6% zC(*_8sHlh11MI8PIzsw)&Fb7WtKHe?+BK_rP}cX5Bt2r;Cf4teO|msU(LU56 z+14;?*E@9YWAEUR$eKq)<*kx9(rUIkL_1R)BD<_+>((55#4`QRUQBr6mZryAtS=C6 z`uIfEkWOOVJZp|#$&=KcGdR(QoLJ$!%>z z9?78}lUtgs>qzR23kZu8`-IT*2kUCWdo*ZpL6nj_;3%DxTqifj3(I%pRxj0gdq3=7 zF{^VaqI}o2bk^_(vYuxa1Me{4Iq%FcgGAbB*MkrqabRLecnoqwS!;dW6J3V^ryaG6egNd_|CeEh8SP z=s?oty;~)&pOPHmE5SI&a<(D%s}yqlNRwCrzx0K09wcH0y1atIY>{VBPo1)tRA zKGuSZf60BEQ9Dr%bolf)l`g?VI^*liOUZg3%_nlfK^LC&2FXor4eIt5F|`=SpvF{V^`_i{W2V}{C^hmtt_(b{4QUQH&X)4#K!{>-?L3DP|6pKM(G01H}R6x18 zOcrGe;^aH{^+DX_Bh@>z>bX;*MHriH*;Be{DkFV|BfLI{lcBHP8FHT!DGt5%(CK9B zpGYZscfpOej|a2u6IF+)t)0o$VULt;UX;x{nzr(B`ux(S+>Q7?d2AGwe}zXrR6OjW zs-SPhx+lxKAAn-d7Lz1fU@+UYX#-s%S{Y@QY_${M^d;@H14i3_G4!62v1(O5L8n9z!+hBe7%S z<9q&>RKGpB)1KV!4tCj-W4Fs_+|)xkcgeMmP4db9V@#m-@13R{D#C4RHmTsN4%+qC zq}UP+JQ!$c-PGRmQ(NOE=T3R;_u9w3^QE>fS@n^}K9MHVGe*hD zdfzSetbhHRBJt=&+6&%Kq(Ypf(Y}mV>0Zmrd~!z)vupd~fjdO0tZNmI>VGo1vj|zt zas4iN*e=5cS+-Qb=Wu(8~|2AoS8}pG`tE|oc?7*m!N zlH3evIzNJg+SRLxU3p(__F+rnGruvK6xV$!YGaqYMf}Kw}P6qS>iCPrnGPCd<^Y|O(q-f26qTNxZk}k(ki>W$ldk%@rt=L1de^l_Q(7Qv=hE&E zenOL`MURV|3%3XFuB+W%%@1u1j!O#ZZ`O1+!S8#ndQI~ZS-X_~W(rq0gKB%v`yvk` z81(#6P1|18oIViJzgyF}6MjE-RcnULvbODBx0LVPX{krIQc}I=`WrNz+u;70>v_$v zNmefvRHy$P?K(e)vqL5!8GBLFX@`f)u4gsFzn0m|0-Krd;nqgRp24aveY_0eIu3eB z>0e04iL%?w0kAdy1%nyNXLEAg?67m+v>oR9lP1<9n=$GR<=dou+_GWjCkHyX`JdcH z_Aq`_M@ssi)^t9tY2TaZD%6nfH&50W*#CP?=UVWRT#E^Bc&^MAIv$#21hOacJS-;z z!ySC{we%K-Lc+_2AcaNwxb$q3*0>#?!d}%NGE4c{q5OGAr?{4BO8+KPItxFcvG$y+B+U;N9bApns=79Scj6(a2Ajc!Y?o~MP%SwdL*QO zo~CmivgmRpX@(y`{sgN!B>e_WXEvB_R~*TA=^R=0!#vEw!g;UAQ4PqR*-5=9kZ<0k zox7=;ALL5c#J)P7C0Y=^or73NULE3W6&2n@xpbP?1~~sPV>G;-gWO`Moac~cE2;34 z6w)oNA9utxII0_Lhl31|caz1}Tknd|l-5D?kXHU-%B9ehz6{@F;-aU~0qX+frJJ-% zw-+suKl@7IiU3^dQ9Do~6|B;Wir8jV6->cuDf1Q;`Boj_GArdB(zC*vcb?m8Z6xwo zmJfNX!49gg$Ux*pi_}~?oJ=6hzU}hWoAy_|o{aU#y)h1cdb?a4O>FgefswD?!>+qY zu~n1y^(ft&Q(QkJ4Q~dER4JQR(K->yYXQk?^($-VrTu;#|1TnFZVz(%N0T~7liHi| zU1ySryj3!c5UU=-bry2dDS5?Vi$`j$Ah|WM<#=w1slun`<{QVz_qbPZixzEPCt#L( zALp8Kwim6G$A`=MFC=viBF19Z(WKG`#&gCtnel>PorH3n<(S%h7~Vf5QLhL(ex@Xn zZ6ORi$cucQNIYbp<(}Zxv{-*l{1Q=leTj#|*K*vk6ds+NM5A@0 ztSp(7S21;#qh%9$n*?kOLcB;KzJpdr*4VJ(xNmGBd8!n5%E$e`PW;zisb~G~=ny(0 zYqngo!U18X}c(Y z!%rkXWI7(7l1U$HUF6}lE>pacq$UUX8oBk{qjUjoB`qru+NHHJoT`F^ORz{`gN~0I zJy@@gT584h&Y>NS0BbdJk*^k7H-mPga0BgZUUnldp$=K?<$?0LM(xLeSrK3J9UVKO z(`{-h-~LlOo=IUoSeoc8~HeJd!pia;&!! zv&$)6Ij2xvBEXho>QI@aq(DTL?9B)1{9U4owj#v)gug@(7#H{Ot%n71;VR6Xab*(Z z_f;LcwtrzNzP^SZ8_Ey@A&r|$8LFFX_)?vpBj1Q|M<|9Je7#`yCy8!Vko7b2g^$4> zW`C5JyI1EN#Tn{s=g_>+sd%BmEnVU-ltP1(J6uSbZSxYpqBjxi0vruZm!>OqW>LC1 z-A&ru!&cnKyj~&3=5t{dHceOO;mOukEHq1EN~8gC;UWE9iJk8yw(ni&>Pn3LC?Y&; zdiXPfN48-3QZB~mZ0imqDqv4rj;WBvh5r1S2hIxG6%venvq=V59S!kFP2FBP7;~9~ zaA?sAQ8!*&OY0oug1TKxqU=T6vUaGyF>7G z{=JEvF684mmou@sH^QD}Gm3DHk}=S-RpP*NqI_8aG~tb6i=(pMD6!PttT#$6o@d;~ zP~@*>$*v{#r!Dna3xnHsl8dwIjnJdC899~?2^gkA3swZymq_;9My}KDvl)5ImSNp! z6xxgd+o}?A@t(D6+?mfh3s4+OqFIKweC7gb@bK)vChB=QBdsl{G#jUAP0yH(AzJ-2 zI^)zT0q(l78EK2YQfHiE(SjFZu|H!oPVExX^};D=tlqceHr$zpi)L}oOE`7>5S7K` zTei$%xmmNsq`ishZdr=fbaPqC#+%xQv{(yJlt*stSGiGMN>;}Tg)#eN;4i^vaO z#KD?n>EWr&NjX#@(3HHAali4(vwY$e4;n0k?8{)FW&dGKRE$TC6TGv0d#9BAxY5s94b&;OFuWFR{u>7Qw8#YAT&`{|uRTI=P*55_)jgN%^!VI! zc?leP<~O`^PJb8PNAmFM@>~DG0Ne#a)|JIn)`bLf490y-w5da6{8ph)+{)#4ufeV= z2RD$%*~zOi>xT($br6~AYR0EJuCSD{{v)A7WbG#<$zLPG8s`>1O12zTH7uW6`yBQq z!q}BgyYpcpZm~bSC7@l(fBOhc<4YEFV(bI{zXXMU8ix7&g{tbeLi*oN=zKq+-T60H zcS31HL{YaKI{ThT>%$}g27_HdDebTQw7)Z<(+h7+uHy;A+aj>tg+@30xS#AseA@p` zLT3jYTUOLQDnEm<>}4^34XZsl2kp zATbp^Q(};^>`+=@o=24gaLoZc%M!dQlW+VZ2D7EdB)iE<+dPkJ!u4+Rc-`22G@laP z&)Rs?Y!D&1A;@e9j(!aL%fmra-G(4ilZN1QQj-GIZRw$pOYtf!QjQ>Ry}wp{;Y)wc2Q%wLo}EW-lNcA#bU4!^flZ})W38|ST6w0-6rIx9KT)1?ug-W56!iVyw_ zeIW7nSlTs`H}`P6ADKw(E!Dn9PLt(Z&ktDQV2f?|2p>(5nxlGE#ntYu8=51r&PbS} z*Yg@xj-1-dweQ;?m_=GWM8GvBQ{iS&2egp)5wU>>q84)d{MR>h}uRo>zr>phhD%7 zv3509bayQ;h|f94K6Z>JGVXRlRAYmVVD-I3TF@Mh%|RkVh&ZlCYTd=A(1;YCr9~%1 zM!Y%$sfwU3h$ag2oBM?0b`C)}WoI7g{eZ~kAYQ33E$!VwlqY!qPSKZ19Jh+I|A85& zcSiP|os_7=6S}`KsPDqh-X{dPC;urvswae054M3OQj4Dy9qD*Gr~ikz0w%Sxk1~>x0_$oW)_fphd3*K@-=coa=3m*SuBx8V|F~rple;0vaKz4-5bRwM* zm}hSJI*39+MD_j#Z6+p~wF?0Nk zn6U$n17n$s;ZOetli3J51S~vBF{7tNj1TdQ0#|_oxch(&z!1>zn3(BRNSNcO192OZ z*#RCObma$PW)S8PgyH`VXT1d>fB+ybOhiBsaQ-lp`QhUw;uwT80E6wQHxd{4 z6`*5?;|_2V=7r!H$l(>l*$4Y(*mE(yjv|a0W-Ty=XY>)c^}u`w)bKIxl{f@B114ZC z&Lkof zFkc0I7s^9N;MW6)k1?6G;Ojvxphch?K<%JwL0cgY56ljj&x2BLqO3@}0MNp`9B4v3 zcF+!B2oQCE5C3w|3}7)p!T%lj%K-l%;;aB~2ApEuhmN}?6v%4?2#5jnKn2hWoP?hqpciHXsdLZ)#M1;s_woxpc_D)ppYup1M?stI*l-( zF()BMpb|I&^Z-6Ua|-bQ9SGM1It1JSVqjkgGys)AEf8kHhfh(qFvNMa2l)ft0Epg) z{6HOm5AGeH=Yiw!;{(-zW&lM1CCAxQ&^ADga3lXjy@9p?CtKwV(~ejC9X~_JKDFD(*#|Vb+5>uq#7DhWs+MZIVpx`D4O$Bm+FxXcTdkfk+%*%=U zuknpY@O%j019}xOfggiBtVMogfCY#F#7J8NbilmvLxcgPVIM+21i1Qs)C154i~#a; z7%zYZpbwxC#sJuXjhG9(prk%zh$D=|3$qCP3V_rNsh2Py1NI|;X#o8NRR0m=4pai? z-;yw7e9nNI=#YeI0Ivw<4$wXzB6Vdu0d0gH`|*xHW*`bpkz~piO}C zK?i`k|AAaUHJ_qBfR%s+aDd+gdJ-_SVa$I6WqKWT+Kj%3apfZTP4J`NFJb6?66Vf( zkqrMc^qtR9FQ6-dbi6Yyho8+bHvz|iQQ!}lFMgAQIRoX%g?scMWC9ccm4E~AAdSs% z%K$vEYe9QKuLAT1)FbSvpkmOKpiW>AxP$aZ2_JL}aritE+|fk(cqHS+xYX1>K7XAA zuN5!=1waFEzDdGpQRjL<0~BG6Mp^I*73L<4H*O#r<_tg%TqSuRZfKWOH`Zh@=K@2p z`+!!sFFz$=`ar2QGKz^1F{3cwA@(7Z1CRl7Km&{}SV%2IcoRT%VWSo61qS@VUeqZC z83MVmF9wQ$4L}9Z0JH)pfkD87eEL8&Umz`*H$+fO2F!~Q@A7|Q9Df(rt;1dbtOYE9 zAKyHx18oI5fRn%gFaqTM8}$M-03E;pFaq2G=!=jw(5uSI)POb(qn-gDAi9LI0U5w@ zpc1eH4!{Wv0zN?e739JG3K=cTCZHUs1qNEMUIZMcBbjK3&;UA!^2k9eyD8>mnSdGS ziDY)e??W52GCiObjUuMul!%c@D8>YA20DPc2cVvGf?`CV6xPXMpmmudrWbIm{62F7 zPyj@db=oLJ{m*T`Uk^X>?E*%$O~CXXr6BH!VRfdu)+Yv5}8cndvg^(@KQ;Ynfj9QpY zfHnYrf&W|HR>EyagmM5R4}l|0rW7D%2nF?9}I~2?*3+x$JF#m#bVHW@*;O@76e-LQVWylt203;NL@|~iXtN#=*l?b!^ zJJcuW2*NhNEP|gw*e`yIKAnU6;J!w`f%)n;mZ+Ead`Pc@#7|wzESe9$fZtD}Ez>Bo z*ITg~?FoNP3T2MEEd zydh<{pdCIbqrN0%DsRI7Z7FlSd@OS_+HC4w$Q1H!1Y}5)f?WgZ1J(lP2@j>D!EZvk zn_;&DwZI5)1iT{%+XJ%)W+&i*z3qD`69)9%kuoA+1Zge=t%JWtK!*6J3P=zBPXeu> z6vKdL0KC9vfV7J-$bLi9nve6}JU#MRg*@ilf1K!iW9r76iQU!nLXBDv=N02m0}jjT zH*OnVIP`?y|M!oVZ&ga_p4$GjVaA)c?6+|(r;lA;A%5^* zi^2?C>m}Df&yOE|b?NLEihl*9y;nWuBi}b+%jOC$|NFq5z2A*}!u_vRH4778%ufHo zZ@u+&wX%56I$A&cli|wWn-2W*^T&!Fd*@cg@pu2;{ny>dn^ z)XqQImbt$EZGfL9v_sA`v_0@O0QHYZh6j5S+|L7T z@Dt6+%B%nyfs2Tv2h;~Ja9a$}Pm%t^!(xaF1ad}@KL&B(+qNwQ7(eSPA<%P%WSV z8ezv-(9BWL<*?TQn}I&0p%!FimV;_RkAPPWS_^v<{BMN04#51${@Gz}02+ZNpaVDw z$fC0{2SF(zuIfV^O~~IxgpYwe70{r}JyYNh<-P*<>7Yg6R{)y<2haxe0E2)JpaZfp zuRxX|$cqjbMYs&a`xLfAv~a5c-3apu=tiI(d8`Ar0Sv_IM~0hCGP@1KfrXZzaN%leoZZ zfO#R>aU<*=pba<u(QgcctTty7Qo>G z*m>npTp`B_8)sfpER>R|Gk?!oHHo8(_d+2$?W&TloRn8Qgk+Qn;N59Ri@i%%LJ6BcL2< zJA8hB?=i>`d-8J-em=slMR)_K41O3;4WWPur~ozt4uFF0%n{I$qoK@6&;elMu~23N z^bR0KJbnL-^)=!y0;0n)M}Sv=bQS}oO~}E!1D<#~$^{evn*k>vha7uB4e--}_1dCE z3#lar6SX+UL=A!O1IB=8_~S>SF9R|l127RY_~oD#zy`n$IPlET0J;z706d^WKnCI; z1ugn4l<7mCA@3*NhC6vbLEg38f!i1$ih^HxRwj85AcI*A=mGLBhP=nfg}DG&4#=@@ zOx{7rK0rT&eI-xQ)fO231U?M9gu-aR+A6Oq37M05jl+0bL1f1R8)QpbdzH+i}odfILYK zfQ|rTfEe`_4UoMKeApvX599)5ucHWba=)V-W;?J}g|-5kigrx)@-+`kVHP7Vt>Eh6i&4_>I6Fpb78*Z9oU$ z1uC_8jsooi1^^4}L!cvo4;TZkX5-m39{Jdd=Sol+AP3YyD!>4_z+zxIuo74cR010T z^~@=Z9(kmw8}Iu4Iy~@sz1UWuxN_`$!Mza}#Cu2bY&8Hgtwy^AAZygH?_Kh&iC^1! zD~>mUKLp4VSoh2VP%khB7!onp0LKAQ63l=Mr~opMeiP^s;3`0#IcYpclIQVO$Xx9I zA#>=`51GF6c&>q8xd#0OSO}1JnriqlkT_shCnFxvF@QYN%3vpRzAqt+$%P;1>@Y?T z-g1~nK?^{sS&-3#C>QKvnB_n!>_f22L1};i&-CQ?>{{jy%sp@$1U(6~0u6u#SP7Vb zJ`AQv`c4upY1h^*}1z?jS4~BQ2tzGV9RR zM(^OA7^L4u_9ua3KyK7e>^t68n7!~ro-=22!2{A@Uj#5fJq0^>r0>bF{-IFYWKV{# zgjtJmyw~q1s{pU@Hu|y-GJ-jy7jr5=FTffJ?ud;tfzJSHAQf(R;8zdI z0N#aR423v{z!Sq=3tk4|Cu1a;t4^Mt#tfXA#vF&+Lc~edePrIHKEk>Je#v)_hGt0**z{+2TF=Wm#z>N$cMAl@kB4sCSh?I$hy9_yu05SXVTzCNcD1Ze(c8j3nk}GZJ z(S5(PXrpJ!>|;2MEpIqhtHC~gfDq)VH}svg8Th=P`Wi8Frbu?RPx zZ{`c2|K)6!Hq9$V>Z6b z%%6^^ET!^xekApdr05A4qAc%lOz+6^oVVLcgX;OwCHxssCx%}2IsOCG1&L)H3^Oek zI7JuapB$~{%S-r*arZCLHolcuelP!$ud;m0Df(7^`BXhWri33m?tYygNBJd||B_$l z$6NgPjFkNQkLWe-x%v{m$i@$ZIEWTEKZqLF;^qfW=p!yE;nOz$q?R{-Qp=k^q2;~0 zw1h9V@rgbo8(umYeo~+DnG$}OjX!PDJ$%wVVj})6?zu7ZA4(UbPirfxG&}uEUwzc} zI;Z9ZdO9swC$OyE^rEojAZN`xZH1dm1@hWcy$ADOqVg*4F8v!<7(*Redix+R_G@nb z+ahRvsYsjL!=t0arwhzbd>S@Fzp~~4tD=-*DR&O-le8QtNffWz9c%G8ht^2etS*U@ ztlASXZaXL>cIm4B4rp0zjtgBnlVNpajMxhj9n&APK6V>ALV1tfUMh>Jt6+p?k;^bI8S-IM371(5grH)z`u+Ms}Wc4YP83VW5Uf; zUgYiiQmTY6v^mwbC8G8>28iO{hB3_+;p3F1qZ*e{si;+Yeq*@sF-p?|yKokj(Ni7% zE8#qx6etl;xDGICN#7C)loYoKZ`-DeYPQ%4MNko4+QFV5cxKGF27SA&$np+Uv`g2I zbw5l5`yXL%-};ZRvFpc-PuvUJ{QI$PY`On0VMqQmZ0YaEj0^9D9bPlmEu+jz4syKh z0`YF^5sl~b7C!6=1<0qyj0^>xd#)KL9MF-L$ZZGw)muW^-?&5iSlO7_DH4jHJXv}} zjDvK`rer7L`VS(vy!UU7i>`SkJk{ZIGY+S{x&pC2IcAhoRMxRu?O~#}328O|jtv{TjfN%|mG#E`ZqRfh z@s`dHHey`P^4#whyPS0!4&fQ`d_&E4-YVg#bxwa;cw{zTsB_Lq3zN*=eXA=}Wa{;{ zJ2|AzXCkuLC&m=7+#)C5pr)@ISJN*^U!QJEcc-_fccq^r>Rl7}iH|GoLuJ3Dn9u6$ z<{tTA?0L!0Q5MwsVS+;^@ zD_ORxAk}P)VcD@PJC0??7i4*xIeFXenp)(|CxhKa%1QL)IZmQ44`pbm>+_(A?>;j? z?x^};Y>4RN^NDJ$QIM~qW-qx_z%v^~Y`lSNyg_Wd!3CjaBdh&uWVL^dtoE;QYJtjZ z6tli1tZ!EP*BGi#(HX;7P5o)CrhYi9sUIO!;CV}GUhu| zb3aGA)G@=JdOs(0sUw)E?>Ao!X4UtjQud|nW)A=auxA2dzYf;L$NW;o|DJ9?j)$P7 z;l{Gorq)e%-ql=t=v9$jHP~ZM8ML3^dpd^;erj#82laN?BYQX46Z7?yeNL;$rl4)b zRK;!iH^K`7qSTKjetuk6AD5{SJ=F=q>OyNPag>ZkV~tghUEO7u>T+>hS&19O7wK}j zv`UxD!|}Il91Y^>as_m#E?20`4In*YGM`x(+J#VD?%`4%6?8uPc1sTZ{pPOSj=&v_ z5A{eVIByZo^c{_=9_0k*DB&dRXq0piMclq!5?9;JUAr9VJEA1)oPqnA=v_Nn_OplN z$f+(?zxF@VYWk0~{`Mbf?f#FnUj2Vd3yVO9s_uZZFHz#!dNVOm&An=yuvQVPbg+KH zY9m%kbPAJ{7_A+8GY)$ClPB2Oc15%fCNS!UCLy+ii zNhzoAhOfDF;P-A;Y@c(ckG@z zQBoBt>HM_m_o6L4@pH7}abgxlKHnOJR`j8Wn=P+-7BmJ;Si^2QU$eLq1^IIVCOA{! zA$>uuu7gX~F2QvNMxiS13c5LG&RaZirT26Bgc}O3@_w%02d=7C*P|m`+V!Ik?V_&T zJM@TT&YbsCl6mM+*)q0aPm1DFA=mgXKbvhL2f4hG-0$y5({roRDYT0Y9%*c7I+uJk zHE(UOhuURd_Q)FVo)gL1Mbjp9i$T3dG4^e*n}xQOKKcK4}B>z_&416Iz+`lGMJ?O%u^t^{q}7k_W7;)jsB;`~t5lLXhzqu7T?d zzVD<{#v619IUhqNgMiXqIOsI|!H+nHhzs(#I5{EA?qa%098dUW=lignF680*gU~`% z-cny-%Iqb+w6N(q2tP&pq(Tef^Jtk#zkN-Lw#ZjSQ6)}_tpF_Gd|gg_j3xHmkGOPa zfk=;9*kZ$dks@0Tt~;>haBVp}TMplrBe3NNZ8-tfOkZ`_bWbELvn>#nEC`$w$ZIXu zG$M~LQhXQqUDHq?6CM`d3wGzQXSZ^Av$ejo20k4O8K2-Ma3+e^8SjI?(poat9TYU5 zKnW+#%aQhDrRHa4qqHjp>$@0a`{|j!Z0_sXC%Mcb1;fO+og8F-9nGxSzRbv&e0@hJ z+EnbRAJ+wi{~*pqX{v1oQW^s(je%=3@N5RY%^G!btr$bJsH^cWMJEqfo)HQ z``VL%ZBGWaJsH^cWVo+A8QAuOBWGw&2DUvJ?rTp5wmlix_GDn&lOY1)Gsw(_d+q6D zr1h&CkY7PoKxuT|7dLEf|5gD`{7thC-PjsyPr;&?e2@2`M+M*TE(COilNKXvJ{asa zu<|wVvIcI<+X4APOgN9IET$$K5bvN6N1P7|hxZfVVvNd{a{B*yqw}9P+V}n4_0JpR zNMmA{UOJZ2fA&V_8F1fqy-&Eq>M%X-5W;;S{iknqo`l1DuJ>+~#)rl3{SoKt-z3>h z=H=J_MCxo}?8C*lJFC-+aXp;8o*g+nH)^)pM2h?Y{sf~549|w}NKWZ({{-uAV9|j) zH@NoP7;2X!?#75yQ-dKOS6-j1fJ5$1$4=2s*-mw0QlCwdEUKy5sh>!b=92l@ro!ac z=a5)yZ|ri|0_EZQnNj4{YB(S}2R^5{#%+xs&04dtdmk|IhFn$1uU*q!6anoNDiKSFqOKUfje5>dG^aClv_1? zkv%o{^8)Zu1b6&tEN~*WITO)OpN#&Y|0Vi#HhOk0BpU$ejmW6CRz8`O^Vu(rNGkSo za(Z$XW^!lW3z9>s8#ONw;mZ{NA7x(y*VJ|Xe{*vaLI{uqh=8;vHwFUL7J^E!wS#~G zvE3vpqH8xvn}}}RuTooIX164^5GdU+z5%6M5*tOQtzv7@*3D35w$)8s*Q&KG#m2Y# zg4Vg(R`UOzdlR9X`~UXy^O4+p&U4Ov&U2n~p65L0InRkCjNuYArzE_%X?nrk`e!3^ zM1lk4qsh^u5p{11qNjr)|{Jp6Q-XQiGD>rddFTB1j zu8xsdm{_dqp0vTxD21VMel;HApjymut2x?BDmPtg40L>3$H*)&vT>ju7}?qs^XIBP zFtW7?X0&lyNNi=twYE11q}&2?8wcrUl+ah^&x7?c37QR-$Y%7Xv~u;eEe8o?vIT}W z4zi0;MJ1Ny6EZt zGDSs6-Pk0PH(XSvo_7BtTfbTH1mizYv~{EHBSCS^wdz*@T{Kl*`9Ig@B#+-G^gVh_ zSHZDwg?9Y`!4#&Z>e^8pUSG1me~#i=(Yz{?C{N}>Vq{iyXaq7L3Yo}5 za(yqV$+|XoH>p%^MUO^6l~K^7k(J(cZEi1tOtzv&Bao^n!s!|8}=_FJauWvsndaX>&fc zxbNz+IaPCHi~o9c*@CK%;uasdT9*}5RTj7SeLP62-jw>IHg6owuR}jBRkSqVA zfXjz=yyWeN;9cd?%NsWQ8bgz}e?LiJ6QZz*{|c*U*f0}=)5Y1spInB4uEdDv9+EKP z@xa&nvV_#EY}lZ~0Oc*?9FQssJ&K2J2UJqSsHD+$*ioowv}X$F`U7FK7(*2yQL5IH zI32ptT({P&yINaS^`X3G&DC0aRh7JE_0`&Esy z)eW#_)aG9sotel3nVF!iKe=JJ{VH0lhp{=j1wf!k*a<+nFgyJVxT0bGlHu(D0zyc@ z!4eXDuWDt(`tsqe0Rl@1z`+s%+=k`JmDI34z3bhgapU&xg1!HqFxQX*yLiP@GO@L6 zB{$AFj))BQ1L5BL>8b!1fk(pgr*Fnp-RDC@7%tMT|4=l)-g|VJ!fCqtueNuBrSEwIlfn-OL(8VR1(tI4q6J5* z6svQu&YN5F(>)8<)x(8?qC$3V@U75(xS0#5Lh(4@)BW{`j=#u_Z?D!~U9r5d%q>{d z8u`SS5ueB;pQs#j)jhj0#%*gH<$k&`tNQu51+uA@GIh0Jkquw1NxC|(s>Xz`{A*%lsMb#nJ(pqu3a$YI6iHdg*_IT9@&4V!4uFBw^A&tSb`k(&Un z0iZiZmW`#tvKZ&aLARuFL+?*055oW*M`V5zWAeiM<_Ar-3Z8^P{YTQeSHhbMX!ET9 z1v2!I)IYPTz5-;eV}#UF?T7zV_z%cCz8RkJ$n2<$&W=g^>_}KC#`(nH@=gL7o$Uyu zDhfGjB;;d*%e%Kp>zGs*wni~|63Fx@FbzmPR{ASC+GYJQair!FhmMExW2T4 zESwr(#g4IE@T8qnKE#WY1{cmDkQsHLN(A!mDCC%tkdncL3kW1AtcgOhQAq7b$e}9> zmlDXab=XUe)R`HD%;F)@DONAF_^T_{1rpysuIN@rCfX05AtQ1JHzK!cUwFOaTMr|t zg9;U?hio@Pm$E|i47b9IWdd0GlPfEhEi5A?WOY!bA|=QMG*^ObKu6mhDRGpPm_tg) z>mY_BCCHXESAuLw|4WGjq{ISJBDoHlRip&jq~=PHP3qevpdYSKINu~Cma0;+u`QXI zNsIkd$F~rte4FMsM7GfXtxb!!T_Ko3lJafgAn(|g#r`V6vdw zYK2w|EV}|I^E2=KQjRZ}nisE3tM~o(O6bWUZ_yI!aqWkb#E2-vKd*mA^sKnwu2?8o zQGc{n;r!K=MYV-yw_rt7EG@q>EcqN)FzYy%Uumsw6Svm3salt{WxCyslVs&Cv$|HW z;u)xx&L>dA;*K|$ug90xKcjkBJpUOlQ8^b}S+u|^R%fcngwwx7QPF_!`FrIxHCGmG zjmp+q@`Z{yh*my%5`O z3Yimyyk{ijq$`C_6UcE06&i)SHwt+l4~fxXfb_fPioquF-FwCM(;;u}5^ARQ!*!g3 z@+)q5)J1(u&;Sb~rZ@r0Pt{o1g|5d^`P$<9u56wl!cHe@^krQ^$eg1kiah0&q7sLH zmYnE=D>wm4_6&q#1T)ZT)h_SRa)ncJrJ@`<{qDzUG450!bH!2WEoZz870DJL+r4(T zF_jpirYTn6x?C~M#ApsLL7kyvL*l8_>aQ>Nn-n>(9NnwfyJxh!@g-S?{~pG+dr16X zw2~{AE6U54s7lF@|MgI$<_jcot!v}CGGprMvynQQ6tHtm_Lr*>3%?by($%aN_AJe3 zmk}#+TWU_}v{uN%)gO<5E^lQwp351V-D+l|pZj3A=JeG^N5IPFMQS#Wf~<(teP~48 zif9$@TrMhin8wELo{$!?!2R(u=60Cr4llz-{X0XwVv2I^x!mtjsJA%K^c~#}(*eP> zmt?Ze>48l{+_fkmvTSYESh{y(SSGEHp{N|K^VQ1;ji0jyqMTEnQ4MQRuK{(JJC+W9ixcF(^I}O^8NYvn8%dbE97p6 zU1El;SKLo2J@>U*`PZg%%J%pAn-xvJ9jH|tGF=;|MCNZ4P0iP8mE<*vd%Ywf z2}y3#g+sDh*F!VhruJ5u+cj;ai%!L*)vdgt?&G)L88q#OG=a zYmAr6X>%s}$)KJ59D)@U)Gl*4#%@YgO`h-owjx#<#;R2_#n_x@`h`@l3d-9XF$-sZ zXWXf}Ow8qR=&sSul*^6x^siD(?!;zl`&xf?lE)ivX;-)1pX+w?w<`Sa7I|NB*xsaa zS9xK)>w3Sa$1B+Jx})e7wQl*)>;$=OJ z;H(BZpgJuu&~L;%h6v^>Ra(wB#ZDA}!;6p^mv1ly5M$K>>o}R0B<5slwcs*~+qH>h znwbV#(rP

    v!!E~-jtOzdbpC|ePXg}8vTzh22HBz;(eD) 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≠@Sa(+ba(Mhd- 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 ISNkltNIYE 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�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�Sxf}Xgs%yLFM)(!G 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 +#include "Constants.h" +#include "lib/Constants.h" +#include "../Config.h" +#include "Config.defaults.h" + +#ifdef USES_HW_SPI +#include +#endif + +#include "HAL/HAL.h" +#include "lib/Macros.h" +#include "pinmaps/Models.h" +#include "lib/debug/Debug.h" + +#if ST4_HAND_CONTROL == ON + #define SERIAL_ST4_MASTER ON +#endif + +#if AXIS1_DRIVER_MODEL != OFF && AXIS2_DRIVER_MODEL != OFF + #define MOUNT_PRESENT +#endif + +#if AXIS3_DRIVER_MODEL != OFF + #define ROTATOR_PRESENT +#endif + +#if AXIS4_DRIVER_MODEL != OFF || AXIS5_DRIVER_MODEL != OFF || AXIS6_DRIVER_MODEL != OFF || AXIS7_DRIVER_MODEL != OFF || AXIS8_DRIVER_MODEL != OFF || AXIS9_DRIVER_MODEL != OFF + #define FOCUSER_PRESENT +#endif + +#if FEATURE1_PURPOSE != OFF || FEATURE2_PURPOSE != OFF || FEATURE3_PURPOSE != OFF || FEATURE4_PURPOSE != OFF || FEATURE5_PURPOSE != OFF || FEATURE6_PURPOSE != OFF || FEATURE7_PURPOSE != OFF || FEATURE8_PURPOSE != OFF + #define FEATURES_PRESENT +#endif + +#if FEATURE1_PURPOSE == DEW_HEATER || FEATURE2_PURPOSE == DEW_HEATER || FEATURE3_PURPOSE == DEW_HEATER || FEATURE4_PURPOSE == DEW_HEATER || FEATURE5_PURPOSE == DEW_HEATER || FEATURE6_PURPOSE == DEW_HEATER || FEATURE7_PURPOSE == DEW_HEATER || FEATURE8_PURPOSE == DEW_HEATER + #define DEW_HEATER_PRESENT + + #if (FEATURE1_TEMP & DS_MASK) == DS1820 || (FEATURE2_TEMP & DS_MASK) == DS1820 || (FEATURE3_TEMP & DS_MASK) == DS1820 || (FEATURE4_TEMP & DS_MASK) == DS1820 || \ + (FEATURE5_TEMP & DS_MASK) == DS1820 || (FEATURE6_TEMP & DS_MASK) == DS1820 || (FEATURE7_TEMP & DS_MASK) == DS1820 || (FEATURE8_TEMP & DS_MASK) == DS1820 || \ + (FEATURE1_TEMP & DS_MASK) == DS18S20 || (FEATURE2_TEMP & DS_MASK) == DS18S20 || (FEATURE3_TEMP & DS_MASK) == DS18S20 || (FEATURE4_TEMP & DS_MASK) == DS18S20 || \ + (FEATURE5_TEMP & DS_MASK) == DS18S20 || (FEATURE6_TEMP & DS_MASK) == DS18S20 || (FEATURE7_TEMP & DS_MASK) == DS18S20 || (FEATURE8_TEMP & DS_MASK) == DS18S20 + #define DS1820_DEVICES_PRESENT + #endif + + #if FEATURE1_TEMP == THERMISTOR1 || FEATURE2_TEMP == THERMISTOR1 || FEATURE3_TEMP == THERMISTOR1 || FEATURE4_TEMP == THERMISTOR1 || \ + FEATURE5_TEMP == THERMISTOR1 || FEATURE6_TEMP == THERMISTOR1 || FEATURE7_TEMP == THERMISTOR1 || FEATURE8_TEMP == THERMISTOR1 || \ + FEATURE1_TEMP == THERMISTOR2 || FEATURE2_TEMP == THERMISTOR2 || FEATURE3_TEMP == THERMISTOR2 || FEATURE4_TEMP == THERMISTOR2 || \ + FEATURE5_TEMP == THERMISTOR2 || FEATURE6_TEMP == THERMISTOR2 || FEATURE7_TEMP == THERMISTOR2 || FEATURE8_TEMP == THERMISTOR2 + #define THERMISTOR_DEVICES_PRESENT + #endif +#endif + +#if FEATURE1_PURPOSE == COVER_SWITCH || FEATURE2_PURPOSE == COVER_SWITCH || FEATURE3_PURPOSE == COVER_SWITCH || FEATURE4_PURPOSE == COVER_SWITCH || FEATURE5_PURPOSE == COVER_SWITCH || FEATURE6_PURPOSE == COVER_SWITCH || FEATURE7_PURPOSE == COVER_SWITCH || FEATURE8_PURPOSE == COVER_SWITCH + #define COVER_SWITCH_SERVO_PRESENT +#endif + +#if (FOCUSER_TEMPERATURE & DS_MASK) == DS1820 || (FOCUSER_TEMPERATURE & DS_MASK) == DS18S20 + #ifndef DS1820_DEVICES_PRESENT + #define DS1820_DEVICES_PRESENT + #endif +#endif + +#if FOCUSER_TEMPERATURE == THERMISTOR1 || FOCUSER_TEMPERATURE == THERMISTOR2 + #ifndef THERMISTOR_DEVICES_PRESENT + #define THERMISTOR_DEVICES_PRESENT + #endif +#endif diff --git a/src/Config.defaults.h b/src/Config.defaults.h new file mode 100755 index 0000000..fe687ff --- /dev/null +++ b/src/Config.defaults.h @@ -0,0 +1,2460 @@ +// ----------------------------------------------------------------------------------- +// controller settings +#pragma once + +// host name for this microcontroller, by default used for the following if enabled/supported: +// PRODUCT_DESCRIPTION the user friendly name for this device, appears on websites etc. +// HOST_NAME the name ESP WiFi provides to any DHCP server (Ethernet doesn't support this) +// MDNS_NAME the name mDNS (Multicast DNS) clients see for IP address resolution +// AP_SSID the SSID WiFi clients see when the ESP WiFi Soft Access Point is enabled +// SERIAL_BT_NAME the name Bluetooth Servers see when the ESP32 Bluetooth client is enabled +#ifndef HOST_NAME +#define HOST_NAME "OnStep" +#endif + +// settings identification +#ifndef PRODUCT_DESCRIPTION +#define PRODUCT_DESCRIPTION HOST_NAME +#endif + +// use the HAL specified default NV driver +#ifndef NV_DRIVER +#define NV_DRIVER NV_DEFAULT +#endif + +// pinmap +#ifndef PINMAP +#define PINMAP OFF +#endif + +// debug +#ifndef DEBUG +#define DEBUG OFF +#endif +#ifndef DEBUG_ECHO_COMMANDS +#define DEBUG_ECHO_COMMANDS OFF +#endif +#ifndef SERIAL_DEBUG +#define SERIAL_DEBUG Serial +#endif +#ifndef SERIAL_DEBUG_BAUD +#define SERIAL_DEBUG_BAUD 9600 +#endif + +// flag hardware SPI as active +#ifdef DRIVER_TMC_STEPPER_HW_SPI +#ifndef DRIVER_TMC_STEPPER +#define DRIVER_TMC_STEPPER +#endif +#define USES_HW_SPI +#endif + +// serial ports +#ifndef SERIAL_A_BAUD_DEFAULT +#define SERIAL_A_BAUD_DEFAULT 9600 +#endif +#ifndef SERIAL_B_BAUD_DEFAULT +#define SERIAL_B_BAUD_DEFAULT OFF +#endif +#ifndef SERIAL_B_ESP_FLASHING +#define SERIAL_B_ESP_FLASHING OFF +#endif +#ifndef SERIAL_C_BAUD_DEFAULT +#define SERIAL_C_BAUD_DEFAULT OFF +#endif +#ifndef SERIAL_D_BAUD_DEFAULT +#define SERIAL_D_BAUD_DEFAULT OFF +#endif +#ifndef SERIAL_E_BAUD_DEFAULT +#define SERIAL_E_BAUD_DEFAULT OFF +#endif +#ifndef SERIAL_GPS_BAUD +#define SERIAL_GPS_BAUD 9600 +#endif + +// ESP32 automatically set wifi radio for bluetooth or IP modes +#ifdef SERIAL_RADIO +#if SERIAL_RADIO == BLUETOOTH +#define SERIAL_BT_MODE SLAVE +#elif SERIAL_RADIO == WIFI_ACCESS_POINT +#define SERIAL_IP_MODE WIFI_ACCESS_POINT +#define WEB_SERVER ON +#elif SERIAL_RADIO == WIFI_STATION +#define SERIAL_IP_MODE WIFI_STATION +#define WEB_SERVER ON +#endif +#endif + +// ESP32 virtual serial bluetooth command channel +#ifndef SERIAL_BT_MODE +#define SERIAL_BT_MODE OFF // use SLAVE to enable the interface (ESP32 only) +#endif +#ifndef SERIAL_BT_NAME +#define SERIAL_BT_NAME HOST_NAME // Bluetooth name of command channel +#endif +#ifndef SERIAL_BT_PASSKEY +#define SERIAL_BT_PASSKEY "" // Bluetooth four digit passkey +#endif + +// enable and customize WiFi functionality +// for other default IP settings see the file: +// src/lib/wifi/WifiManager.defaults.h + +#ifndef MDNS_SERVER +#define MDNS_SERVER ON +#endif + +#ifndef MDNS_NAME +#define MDNS_NAME HOST_NAME +#endif + +// translate Config.h IP settings into low level library settings +#ifndef SERIAL_IP_MODE +#define SERIAL_IP_MODE OFF // use settings shown below to enable the interface +#endif +#ifndef SERIAL_SERVER +#define SERIAL_SERVER BOTH // STANDARD (port 9999) or PERSISTENT (ports 9996 to 9998) +#endif + +#if SERIAL_IP_MODE == ETHERNET_W5500 +#define OPERATIONAL_MODE ETHERNET_W5500 +#elif SERIAL_IP_MODE == ETHERNET_W5100 +#define OPERATIONAL_MODE ETHERNET_W5100 +#elif SERIAL_IP_MODE == WIFI_ACCESS_POINT +#define OPERATIONAL_MODE WIFI +#define AP_ENABLED true +#elif SERIAL_IP_MODE == WIFI_STATION +#define OPERATIONAL_MODE WIFI +#define STA_ENABLED true +#elif SERIAL_IP_MODE == BOTH +#define OPERATIONAL_MODE WIFI +#define AP_ENABLED true +#define STA_ENABLED true +#endif + +#if OPERATIONAL_MODE == WIFI +#ifndef NV_WIFI_SETTINGS +#define NV_WIFI_SETTINGS // allow NV storage of WiFi settings +#endif +#endif + +#ifndef STA_AP_FALLBACK +#define STA_AP_FALLBACK true // activate SoftAP if station fails to connect +#endif + +#ifndef STA_AUTO_RECONNECT +#define STA_AUTO_RECONNECT true // automatically reconnect if connection is dropped +#endif + +#ifndef TIME_IP_ADDR +#define TIME_IP_ADDR {129,6,15,28} // for NTP if enabled we often use an address like +#endif // time-a-g.nist.gov at 129,6,15,28 or 129,6,15,29, 129,6,15,30, etc. + +// some CAN defaults +#ifndef CAN_PLUS +#define CAN_PLUS OFF // Select from CAN_SAN, CAN_ESP32, CAN_MCP2515, CANn_TEENSY4 +#endif +#ifndef CAN_BAUD +#define CAN_BAUD 1000000 // 1000000 baud default +#endif +#ifndef CAN_SEND_RATE_MS +#define CAN_SEND_RATE_MS 10 // 100 Hz CAN controller send message processing rate +#endif +#ifndef CAN_RECV_RATE_MS +#define CAN_RECV_RATE_MS 10 // 100 Hz CAN controller recv message processing rate +#endif +#ifndef CAN_RX_PIN +#define CAN_RX_PIN OFF // for ESP32 CAN interface +#endif +#ifndef CAN_TX_PIN +#define CAN_TX_PIN OFF // for ESP32 CAN interface +#endif +#ifndef CAN_CS_PIN +#define CAN_CS_PIN OFF // for MCP2515 SPI CAN controller +#endif +#ifndef CAN_INT_PIN +#define CAN_INT_PIN OFF // for MCP2515 SPI CAN controller +#endif + +// sensors +#ifndef WEATHER +#define WEATHER OFF +#endif + +// step signal +#ifndef STEP_WAVE_FORM +#define STEP_WAVE_FORM PULSE +#endif + +#if AXIS1_STEP_STATE == AXIS2_STEP_STATE == AXIS3_STEP_STATE == \ + AXIS4_STEP_STATE == AXIS5_STEP_STATE == AXIS6_STEP_STATE == \ + AXIS7_STEP_STATE == AXIS8_STEP_STATE == AXIS9_STEP_STATE == HIGH + #define DRIVER_STEP_DEFAULTS +#endif + +// gpio device +// DS2413: for 2-ch or 4-ch using 1-wire gpio's (one or two devices.) +// SWS: for 8-ch Serial gpio (normally 4 unused encoder pins.) +// MCP23008: for 8-ch I2C gpio. +// MCP23017, X9555, or X8575: for 16-ch I2C gpio. +// SSR74HC595: for up to 32-ch gpio (serial shift register, output only.) +// Works w/most OnStep features, channels assigned in order pin# 512 and up. +#ifndef GPIO_DEVICE +#define GPIO_DEVICE OFF +#endif + +#ifndef FileVersionConfig +#warning "Configuration (Config.h): FileVersionConfig is undefined, assuming version 5." +#define FileVersionConfig 5 +#endif + +// shared driver enable pin configuration +#ifndef SHARED_ENABLE_STATE +#define SHARED_ENABLE_STATE LOW // default state of shared ENable pin for motor power on +#endif +#ifndef SHARED2_ENABLE_STATE +#define SHARED2_ENABLE_STATE LOW +#endif +#ifndef SHARED3_ENABLE_STATE +#define SHARED3_ENABLE_STATE LOW +#endif + +// ----------------------------------------------------------------------------------- +// mount settings + +// axes +#ifndef AXIS1_DRIVER_MODEL +#define AXIS1_DRIVER_MODEL OFF // specify a driver model to enable +#endif +#ifndef AXIS1_STEPS_PER_DEGREE +#define AXIS1_STEPS_PER_DEGREE 12800.0 // (micro)steps per degree +#endif +#ifndef AXIS1_REVERSE +#define AXIS1_REVERSE OFF // reverse rotation direction +#endif +#ifndef AXIS1_POWER_DOWN +#define AXIS1_POWER_DOWN OFF // power down if at standstill +#endif +#ifndef AXIS1_POWER_DOWN_TIME +#define AXIS1_POWER_DOWN_TIME 30000 // power down time in milliseconds +#endif +#ifndef AXIS1_ENABLE_STATE +#define AXIS1_ENABLE_STATE LOW // default state of ENable pin for motor power on +#endif +#ifndef AXIS1_LIMIT_MIN +#define AXIS1_LIMIT_MIN -180 // in degrees +#endif +#ifndef AXIS1_LIMIT_MAX +#define AXIS1_LIMIT_MAX 180 // in degrees +#endif +#ifndef AXIS1_LIMIT_SYNC +#define AXIS1_LIMIT_SYNC OFF // sync limit in degrees, or OFF +#endif +#ifndef AXIS1_SENSE_HOME +#define AXIS1_SENSE_HOME OFF // HIGH or LOW state when clockwise of home position, seen from front +#endif +#ifndef AXIS1_SENSE_HOME_INIT +#define AXIS1_SENSE_HOME_INIT INPUT_PULLUP // pin mode for home sensing +#endif +#ifndef AXIS1_SENSE_HOME_OFFSET +#define AXIS1_SENSE_HOME_OFFSET 0 // default offset in arc-seconds to home from the sense position +#endif +#ifndef AXIS1_SENSE_HOME_DIST_LIMIT +#define AXIS1_SENSE_HOME_DIST_LIMIT 180.0 // max distance in degrees +#endif +#ifndef AXIS1_SENSE_LIMIT_MIN +#define AXIS1_SENSE_LIMIT_MIN LIMIT_SENSE // HIGH/LOW to activate min limit +#endif +#ifndef AXIS1_SENSE_LIMIT_MAX +#define AXIS1_SENSE_LIMIT_MAX LIMIT_SENSE // HIGH/LOW to activate max limit +#endif +#ifndef AXIS1_SENSE_LIMIT_INIT +#define AXIS1_SENSE_LIMIT_INIT LIMIT_SENSE_INIT // pin mode for limit sensing +#endif + +#if AXIS1_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS1_DRIVER_MODEL <= STEP_DIR_DRIVER_LAST + #define AXIS1_STEP_DIR_PRESENT + + #ifndef AXIS1_STEP_STATE + #define AXIS1_STEP_STATE HIGH // default signal transition state for a step + #endif + #ifndef AXIS1_M2_ON_STATE + #define AXIS1_M2_ON_STATE HIGH // default ON state for M2 + #endif + #ifndef AXIS1_DRIVER_MICROSTEPS + #define AXIS1_DRIVER_MICROSTEPS OFF // normal microstep mode + #endif + #ifndef AXIS1_DRIVER_MICROSTEPS_GOTO + #define AXIS1_DRIVER_MICROSTEPS_GOTO OFF // microstep mode to use during slews + #endif + #ifndef AXIS1_DRIVER_INTPOL + #define AXIS1_DRIVER_INTPOL ON // use interpolation if available + #endif + #ifndef AXIS1_DRIVER_DECAY + #define AXIS1_DRIVER_DECAY OFF // OFF for default, TMC STEALTHCHOP + #endif + #ifndef AXIS1_DRIVER_DECAY_GOTO + #define AXIS1_DRIVER_DECAY_GOTO OFF // OFF for default, TMC SPREADCYCLE + #endif + #ifndef AXIS1_DRIVER_IHOLD + #define AXIS1_DRIVER_IHOLD OFF // in mA + #endif + #ifndef AXIS1_DRIVER_IRUN + #define AXIS1_DRIVER_IRUN OFF // in mA + #endif + #ifndef AXIS1_DRIVER_IGOTO + #define AXIS1_DRIVER_IGOTO OFF // in mA + #endif + #ifndef AXIS1_DRIVER_STATUS + #define AXIS1_DRIVER_STATUS OFF // driver status reporting (ON for TMC SPI or HIGH/LOW for fault pin) + #endif +#endif + +#if AXIS1_DRIVER_MODEL >= SERVO_DRIVER_FIRST && AXIS1_DRIVER_MODEL <= SERVO_DRIVER_LAST + #define AXIS1_SERVO_PRESENT + + #ifndef AXIS1_SERVO_PH1_STATE + #define AXIS1_SERVO_PH1_STATE LOW // default (inactive) motor driver state, IN1 (SERVO_EE) or PHASE (SERVO_PE) pin + #endif + #ifndef AXIS1_SERVO_PH2_STATE + #define AXIS1_SERVO_PH2_STATE LOW // default (inactive) motor driver state, IN2 or ENABLE (pwm) pin + #endif + + #ifndef AXIS1_SERVO_ACCELERATION + #define AXIS1_SERVO_ACCELERATION 100 // acceleration limit, in %/s + #endif + #ifndef AXIS1_SERVO_VELOCITY_PWMTHRS + #define AXIS1_SERVO_VELOCITY_PWMTHRS OFF // velocity (in steps/s) to switch from stealthChop to spreadCycle + #endif // should happen at the 2x sidereal rate, for TMC2209/TMC5160 only + #ifndef AXIS1_MOTOR_STEPS_PER_DEGREE + #define AXIS1_MOTOR_STEPS_PER_DEGREE AXIS1_STEPS_PER_DEGREE // for calculating ratio of encoder counts/deg to motor steps/deg + #endif // for TMC stepper motors only + #ifndef AXIS1_SERVO_DC_PWR_MIN + #define AXIS1_SERVO_DC_PWR_MIN 0.0F // minimum power just below where axis motion starts, in % + #endif // approximate, for DC motors only + #ifndef AXIS1_SERVO_DC_PWR_MAX + #define AXIS1_SERVO_DC_PWR_MAX 100.0F // power required for fastest slew rate, in % + #endif // approximate, for DC motors only + + #ifndef AXIS1_SERVO_FEEDBACK + #define AXIS1_SERVO_FEEDBACK DUAL_PID // type of feedback: DUAL_PID + #endif + #ifndef AXIS1_PID_SENSITIVITY + #define AXIS1_PID_SENSITIVITY 0 // 0 to use slewing state, or % power for 100% pid set two (_GOTO) + #endif + #ifndef AXIS1_PID_P + #define AXIS1_PID_P 0.0 // P = proportional + #endif + #ifndef AXIS1_PID_I + #define AXIS1_PID_I 0.0 // I = integral + #endif + #ifndef AXIS1_PID_D + #define AXIS1_PID_D 0.0 // D = derivative + #endif + #ifndef AXIS1_PID_P_GOTO + #define AXIS1_PID_P_GOTO AXIS1_PID_P // P = proportional + #endif + #ifndef AXIS1_PID_I_GOTO + #define AXIS1_PID_I_GOTO AXIS1_PID_I // I = integral + #endif + #ifndef AXIS1_PID_D_GOTO + #define AXIS1_PID_D_GOTO AXIS1_PID_D // D = derivative + #endif + + #ifndef AXIS1_SERVO_FLTR + #define AXIS1_SERVO_FLTR OFF // servo encoder filter: OFF + #endif + #ifndef AXIS1_ENCODER + #define AXIS1_ENCODER AB // type of encoder: AB, CW_CCW, PULSE_DIR, PULSE_ONLY, SERIAL_BRIDGE + #endif + #ifndef AXIS1_ENCODER_ORIGIN + #define AXIS1_ENCODER_ORIGIN 0 // +/- offset so encoder count is 0 at home (for absolute encoders) + #endif + #ifndef AXIS1_ENCODER_REVERSE + #define AXIS1_ENCODER_REVERSE OFF // reverse count direction of encoder + #endif +#endif + +#if AXIS1_DRIVER_MODEL == ODRIVE + #define AXIS1_ODRIVE_PRESENT + #ifndef AXIS1_ODRIVE_P + #define AXIS1_ODRIVE_P 2.0 // P = proportional + #endif + #ifndef AXIS1_ODRIVE_I + #define AXIS1_ODRIVE_I 5.0 // I = integral + #endif + #ifndef AXIS1_ODRIVE_D + #define AXIS1_ODRIVE_D 1.0 // D = derivative + #endif +#endif + +#if AXIS1_DRIVER_MODEL == KTECH + #define AXIS1_KTECH_PRESENT +#endif + +#if AXIS1_DRIVER_MODEL == MKS42D + #define AXIS1_MKS42D_PRESENT +#endif + +#ifndef AXIS2_DRIVER_MODEL +#define AXIS2_DRIVER_MODEL OFF // specify a driver to enable +#endif +#ifndef AXIS2_STEPS_PER_DEGREE +#define AXIS2_STEPS_PER_DEGREE 12800.0 // (micro)steps per degree of movement +#endif +#ifndef AXIS2_REVERSE +#define AXIS2_REVERSE OFF // reverse movement +#endif +#ifndef AXIS2_POWER_DOWN +#define AXIS2_POWER_DOWN OFF // power down at standstill +#endif +#ifndef AXIS2_POWER_DOWN_TIME +#define AXIS2_POWER_DOWN_TIME 30000 // power off time in milliseconds +#endif +#ifndef AXIS2_ENABLE_STATE +#define AXIS2_ENABLE_STATE LOW // stepper enable state +#endif +#ifndef AXIS2_LIMIT_MIN +#define AXIS2_LIMIT_MIN -90 // in degrees +#endif +#ifndef AXIS2_LIMIT_MAX +#define AXIS2_LIMIT_MAX 90 // in degrees +#endif +#ifndef AXIS2_LIMIT_SYNC +#define AXIS2_LIMIT_SYNC OFF // sync limit in degrees, or OFF +#endif +#ifndef AXIS2_SENSE_HOME +#define AXIS2_SENSE_HOME OFF // HIGH or LOW state when clockwise of home position, seen from above +#endif +#ifndef AXIS2_SENSE_HOME_INIT +#define AXIS2_SENSE_HOME_INIT INPUT_PULLUP // pin mode for home sensing +#endif +#ifndef AXIS2_SENSE_HOME_OFFSET +#define AXIS2_SENSE_HOME_OFFSET 0 // default offset in arc-seconds to home from the sense position +#endif +#ifndef AXIS2_SENSE_HOME_DIST_LIMIT +#define AXIS2_SENSE_HOME_DIST_LIMIT 180.0 // max distance in degrees +#endif +#ifndef AXIS2_SENSE_LIMIT_MIN +#define AXIS2_SENSE_LIMIT_MIN LIMIT_SENSE // HIGH/LOW to activate min limit +#endif +#ifndef AXIS2_SENSE_LIMIT_MAX +#define AXIS2_SENSE_LIMIT_MAX LIMIT_SENSE // HIGH/LOW to activate max limit +#endif +#ifndef AXIS2_SENSE_LIMIT_INIT +#define AXIS2_SENSE_LIMIT_INIT LIMIT_SENSE_INIT // pin mode for limit sensing +#endif + +#if AXIS2_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS2_DRIVER_MODEL <= STEP_DIR_DRIVER_LAST + #define AXIS2_STEP_DIR_PRESENT + + #ifndef AXIS2_STEP_STATE + #define AXIS2_STEP_STATE HIGH + #endif + #ifndef AXIS2_M2_ON_STATE + #define AXIS2_M2_ON_STATE HIGH + #endif + #ifndef AXIS2_DRIVER_MICROSTEPS + #define AXIS2_DRIVER_MICROSTEPS OFF + #endif + #ifndef AXIS2_DRIVER_MICROSTEPS_GOTO + #define AXIS2_DRIVER_MICROSTEPS_GOTO OFF + #endif + #ifndef AXIS2_DRIVER_INTPOL + #define AXIS2_DRIVER_INTPOL ON + #endif + #ifndef AXIS2_DRIVER_DECAY + #define AXIS2_DRIVER_DECAY OFF + #endif + #ifndef AXIS2_DRIVER_DECAY_GOTO + #define AXIS2_DRIVER_DECAY_GOTO OFF + #endif + #ifndef AXIS2_DRIVER_IHOLD + #define AXIS2_DRIVER_IHOLD OFF + #endif + #ifndef AXIS2_DRIVER_IRUN + #define AXIS2_DRIVER_IRUN OFF + #endif + #ifndef AXIS2_DRIVER_IGOTO + #define AXIS2_DRIVER_IGOTO OFF + #endif + #ifndef AXIS2_DRIVER_STATUS + #define AXIS2_DRIVER_STATUS OFF + #endif +#endif + +#if AXIS2_DRIVER_MODEL >= SERVO_DRIVER_FIRST && AXIS2_DRIVER_MODEL <= SERVO_DRIVER_LAST + #define AXIS2_SERVO_PRESENT + + #ifndef AXIS2_SERVO_PH1_STATE + #define AXIS2_SERVO_PH1_STATE LOW + #endif + #ifndef AXIS2_SERVO_PH2_STATE + #define AXIS2_SERVO_PH2_STATE LOW + #endif + + #ifndef AXIS2_SERVO_ACCELERATION + #define AXIS2_SERVO_ACCELERATION 100 + #endif + #ifndef AXIS2_SERVO_VELOCITY_PWMTHRS + #define AXIS2_SERVO_VELOCITY_PWMTHRS OFF + #endif + #ifndef AXIS2_MOTOR_STEPS_PER_DEGREE + #define AXIS2_MOTOR_STEPS_PER_DEGREE AXIS2_STEPS_PER_DEGREE + #endif + #ifndef AXIS2_SERVO_DC_PWR_MIN + #define AXIS2_SERVO_DC_PWR_MIN 0.0F + #endif + #ifndef AXIS2_SERVO_DC_PWR_MAX + #define AXIS2_SERVO_DC_PWR_MAX 100.0F + #endif + + #ifndef AXIS2_SERVO_FEEDBACK + #define AXIS2_SERVO_FEEDBACK DUAL_PID + #endif + #ifndef AXIS2_PID_SENSITIVITY + #define AXIS2_PID_SENSITIVITY 0 + #endif + #ifndef AXIS2_PID_P + #define AXIS2_PID_P 0.0 + #endif + #ifndef AXIS2_PID_I + #define AXIS2_PID_I 0.0 + #endif + #ifndef AXIS2_PID_D + #define AXIS2_PID_D 0.0 + #endif + #ifndef AXIS2_PID_P_GOTO + #define AXIS2_PID_P_GOTO AXIS2_PID_P + #endif + #ifndef AXIS2_PID_I_GOTO + #define AXIS2_PID_I_GOTO AXIS2_PID_I + #endif + #ifndef AXIS2_PID_D_GOTO + #define AXIS2_PID_D_GOTO AXIS2_PID_D + #endif + + #ifndef AXIS2_SERVO_FLTR + #define AXIS2_SERVO_FLTR OFF + #endif + #ifndef AXIS2_ENCODER + #define AXIS2_ENCODER AB + #endif + #ifndef AXIS2_ENCODER_ORIGIN + #define AXIS2_ENCODER_ORIGIN 0 + #endif + #ifndef AXIS2_ENCODER_REVERSE + #define AXIS2_ENCODER_REVERSE OFF + #endif +#endif + +#if AXIS2_DRIVER_MODEL == ODRIVE + #define AXIS2_ODRIVE_PRESENT + #ifndef AXIS2_ODRIVE_P + #define AXIS2_ODRIVE_P 2.0 // P = proportional + #endif + #ifndef AXIS2_ODRIVE_I + #define AXIS2_ODRIVE_I 5.0 // I = integral + #endif + #ifndef AXIS2_ODRIVE_D + #define AXIS2_ODRIVE_D 1.0 // D = derivative + #endif +#endif + +#if AXIS2_DRIVER_MODEL == KTECH + #define AXIS2_KTECH_PRESENT +#endif + +#if AXIS2_DRIVER_MODEL == MKS42D + #define AXIS2_MKS42D_PRESENT +#endif + +// decode internal mount type, tangent arm, azm wrap +#ifndef MOUNT_TYPE +#define MOUNT_TYPE GEM +#endif +#if MOUNT_TYPE == GEM +#define MOUNT_SUBTYPE GEM +#endif +#if MOUNT_TYPE == GEM_TA +#define MOUNT_SUBTYPE GEM +#define AXIS2_TANGENT_ARM ON +#endif +#if MOUNT_TYPE == GEM_TAC +#define MOUNT_SUBTYPE GEM +#define AXIS2_TANGENT_ARM ON +#define AXIS2_TANGENT_ARM_CORRECTION ON +#endif +#if MOUNT_TYPE == FORK +#define MOUNT_SUBTYPE FORK +#endif +#if MOUNT_TYPE == FORK_TA +#define MOUNT_SUBTYPE FORK +#define AXIS2_TANGENT_ARM ON +#endif +#if MOUNT_TYPE == FORK_TAC +#define MOUNT_SUBTYPE FORK +#define AXIS2_TANGENT_ARM ON +#define AXIS2_TANGENT_ARM_CORRECTION ON +#endif +#if MOUNT_TYPE == ALTALT +#define MOUNT_SUBTYPE ALTALT +#endif +#if MOUNT_TYPE == ALTAZM +#define MOUNT_SUBTYPE ALTAZM +#endif +#if MOUNT_TYPE == ALTAZM_UNL +#define MOUNT_SUBTYPE ALTAZM +#define AXIS1_WRAP ON +#endif + +#ifndef MOUNT_SUBTYPE +#define MOUNT_SUBTYPE OFF +#endif +#ifndef MOUNT_ALTERNATE_ORIENTATION +#define MOUNT_ALTERNATE_ORIENTATION OFF // use ON or OFF, for FORK and ALTAZM mounts only +#endif +#ifndef MOUNT_COORDS +#define MOUNT_COORDS TOPOCENTRIC // mount coordinate system +#endif +#ifndef MOUNT_COORDS_MEMORY +#define MOUNT_COORDS_MEMORY OFF // ON Enables mount position memory +#endif +// SA_STRICT requires an authority source +// SA_AUTO grants legacy session trust only when neither paired absolute authority nor coordinate memory are configured +// SA_PERMISSIVE always grants boot trust +#ifndef MOUNT_STARTUP_MODE +#define MOUNT_STARTUP_MODE SA_AUTO +#endif +#ifndef NV_INIT_ERROR_REVOKES_AUTHORITY +#define NV_INIT_ERROR_REVOKES_AUTHORITY ON // ON revokes startup authority trust if NV reports an init/read fault +#endif +#ifndef MOUNT_ENABLE_IN_STANDBY +#define MOUNT_ENABLE_IN_STANDBY OFF // ON Enables mount motor drivers in standby +#endif +#ifndef MOUNT_AUTO_HOME_DEFAULT +#define MOUNT_AUTO_HOME_DEFAULT OFF // ON default find home at boot +#endif +#ifndef MOUNT_HOME_AT_OFFSETS +#define MOUNT_HOME_AT_OFFSETS OFF // ON to incorporate runtime offsets into home position (switches) +#endif +#ifndef MOUNT_HORIZON_AVOIDANCE +#define MOUNT_HORIZON_AVOIDANCE ON // ON allows eq mode horizon avoidance +#endif + +#ifndef AXIS1_TARGET_TOLERANCE +#define AXIS1_TARGET_TOLERANCE 0.0F // distance in arc-seconds when goto is at destination +#endif +#ifndef AXIS1_HOME_TOLERANCE // distance in arc-seconds when at home +#define AXIS1_HOME_TOLERANCE AXIS1_TARGET_TOLERANCE + (1800.0/AXIS1_STEPS_PER_DEGREE) +#endif +#ifndef AXIS1_SECTOR_GEAR +#define AXIS1_SECTOR_GEAR OFF // special case of a Sector Gear RA with limited travel +#endif +#ifndef AXIS1_WRAP +#define AXIS1_WRAP OFF // allow unlimited motion about an Azimuth axis +#endif + +#ifndef AXIS2_TARGET_TOLERANCE +#define AXIS2_TARGET_TOLERANCE 0.0F // in arc-seconds +#endif +#ifndef AXIS2_HOME_TOLERANCE // in arc-seconds +#define AXIS2_HOME_TOLERANCE AXIS2_TARGET_TOLERANCE + (1800.0/AXIS2_STEPS_PER_DEGREE) +#endif +#ifndef AXIS2_TANGENT_ARM +#define AXIS2_TANGENT_ARM OFF // special case of a Tangent Arm Dec with limited travel +#endif +#ifndef AXIS2_TANGENT_ARM_CORRECTION +#define AXIS2_TANGENT_ARM_CORRECTION OFF // apply formula below to correct for Tangent Arm geometry +#endif +#ifndef TANGENT_ARM_INSTRUMENT_TO_MOUNT +#define TANGENT_ARM_INSTRUMENT_TO_MOUNT(a) (atan(a)) // returns angle in radians +#endif +#ifndef TANGENT_ARM_MOUNT_TO_INSTRUMENT +#define TANGENT_ARM_MOUNT_TO_INSTRUMENT(a) (tan(a)) // angle (a) in radians +#endif + +// user feedback +#ifndef STATUS_LED +#define STATUS_LED OFF +#endif +#ifndef STATUS_LED_ON_STATE +#define STATUS_LED_ON_STATE LOW +#endif +#ifndef STATUS_MOUNT_LED +#define STATUS_MOUNT_LED OFF +#endif +#ifndef MOUNT_LED_ON_STATE +#define MOUNT_LED_ON_STATE LOW +#endif +#ifndef STATUS_BUZZER +#define STATUS_BUZZER OFF +#endif +#ifndef STATUS_BUZZER_ON_STATE +#define STATUS_BUZZER_ON_STATE HIGH +#endif +#ifndef STATUS_BUZZER_DEFAULT +#define STATUS_BUZZER_DEFAULT OFF +#endif +#ifndef STATUS_BUZZER_MEMORY +#define STATUS_BUZZER_MEMORY OFF +#endif + +// reticle +#ifndef RETICLE_LED_DEFAULT +#define RETICLE_LED_DEFAULT OFF +#endif +#ifndef RETICLE_LED_MEMORY +#define RETICLE_LED_MEMORY OFF +#endif +#ifndef RETICLE_LED_INVERT +#define RETICLE_LED_INVERT OFF +#endif + +// time and location +#ifndef TIME_LOCATION_SOURCE +#define TIME_LOCATION_SOURCE OFF // specify device to get date/time and optionally location +#endif +#ifndef TIME_LOCATION_SOURCE_FALLBACK // alternate TLS, must be differnet than above and not GPS or NTP +#define TIME_LOCATION_SOURCE_FALLBACK OFF +#endif +#ifndef TIME_LOCATION_PPS_SENSE +#define TIME_LOCATION_PPS_SENSE OFF +#endif +#ifndef TIME_LOCATION_PPS_SYNC +#define TIME_LOCATION_PPS_SYNC OFF // adjust timer rates to keep time in sync with PPS +#endif + +// limits +#ifndef LIMIT_SENSE +#define LIMIT_SENSE OFF // applied to AXIS1 and AXIS2 +#endif +#ifndef LIMIT_SENSE_INIT +#define LIMIT_SENSE_INIT INPUT_PULLUP // applied to AXIS1 and AXIS2 +#endif +#ifndef LIMIT_SENSE_STRICT +#define LIMIT_SENSE_STRICT OFF // for all axes, ON blocks motion if min/max are on the same pin +#endif +#ifndef LIMIT_STRICT +#define LIMIT_STRICT ON // ON enables Mount limits at startup if date/time are set +#endif +#ifndef LIMIT_RECOVERY +#define LIMIT_RECOVERY OFF // ON allows 1s for gotos away from horizon, meridian w, and axis1 max limits +#endif +#ifndef LIMIT_RECOVERY_WITH_TRACKING +#define LIMIT_RECOVERY_WITH_TRACKING OFF // ON to automatically enable tracking on limit recovery +#endif + +// st4 +#ifndef ST4_INTERFACE +#define ST4_INTERFACE OFF +#endif +#ifndef ST4_INTERFACE_INIT +#define ST4_INTERFACE_INIT INPUT_PULLUP +#endif +#ifndef ST4_HAND_CONTROL +#define ST4_HAND_CONTROL OFF +#endif +#ifndef ST4_HAND_CONTROL_FOCUSER +#define ST4_HAND_CONTROL_FOCUSER OFF +#endif + +// park +#ifndef PARK_SENSE +#define PARK_SENSE OFF +#endif +#ifndef PARK_SENSE_INIT +#define PARK_SENSE_INIT INPUT_PULLUP +#endif + +#ifndef PARK_SIGNAL +#define PARK_SIGNAL OFF +#endif +#ifndef PARK_SIGNAL_INIT +#define PARK_SIGNAL_INIT INPUT_PULLUP +#endif + +#ifndef PARK_STATUS +#define PARK_STATUS OFF +#endif + +// pec +#ifndef PEC_STEPS_PER_WORM_ROTATION +#define PEC_STEPS_PER_WORM_ROTATION 0 +#endif +#ifndef PEC_BUFFER_SIZE_LIMIT +#define PEC_BUFFER_SIZE_LIMIT 720 // fixed PEC buffer maximum size +#endif +#ifndef PEC_SENSE +#define PEC_SENSE OFF +#endif +#ifndef PEC_SENSE_INIT +#define PEC_SENSE_INIT INPUT_PULLUP +#endif + +// guiding +#ifndef GUIDE_TIME_LIMIT +#define GUIDE_TIME_LIMIT 0 // in seconds, 0 to disable +#endif +#ifndef GUIDE_DISABLE_BACKLASH +#define GUIDE_DISABLE_BACKLASH OFF // disables backlash while pulse-guiding +#endif +#ifndef GUIDE_SEPARATE_PULSE_RATE +#define GUIDE_SEPARATE_PULSE_RATE ON // normally always enabled +#endif + +// tracking +#ifndef TRACK_AUTOSTART +#define TRACK_AUTOSTART OFF // automatically begins tracking at startup +#endif +#ifndef TRACK_WITHOUT_LIMITS +#define TRACK_WITHOUT_LIMITS OFF // allows tracking even if limits are disabled +#endif +#ifndef TRACK_COMPENSATION_DEFAULT +#define TRACK_COMPENSATION_DEFAULT OFF // use OFF, REFRACTION, REFRACTION_DUAL, MODEL, MODEL_DUAL +#endif +#ifndef TRACK_COMPENSATION_MEMORY +#define TRACK_COMPENSATION_MEMORY OFF // remembers the last runtime tracking compensation setting +#endif +#ifndef TRACK_BACKLASH_RATE +#define TRACK_BACKLASH_RATE 25 // the backlash takeup rate in x the sidereal rate +#endif // this must be within stepper motors torque limits (no acceleration) +#ifndef TRACKING_RATE_DEFAULT_HZ + #define TRACKING_RATE_DEFAULT_HZ SIDEREAL_RATE_HZ // the normal sidereal tracking rate +#endif + +// slewing +#ifndef GOTO_FEATURE +#define GOTO_FEATURE ON // OFF disables goto functionality +#endif +#ifndef SLEW_RATE_BASE_DESIRED +#define SLEW_RATE_BASE_DESIRED 1.0 // *desired* maximum slew rate, actual slew rate depends on many factors +#endif +#ifndef SLEW_RATE_MEMORY +#define SLEW_RATE_MEMORY OFF // ON to retain runtime slew rate settings across power cycles +#endif +#ifndef AXIS2_SLEW_RATE_PERCENT +#define AXIS2_SLEW_RATE_PERCENT 100.0F // allows max slew rate slow down of Axis2 relative to Axis1 +#endif +#ifndef SLEW_ACCELERATION_DIST +#define SLEW_ACCELERATION_DIST 5.0 // distance in degrees to complete acceleration/deceleration +#endif +#ifndef SLEW_RAPID_STOP_DIST +#define SLEW_RAPID_STOP_DIST 2.0 // distance in degrees for emergency stop +#endif +#ifndef GOTO_OFFSET +#define GOTO_OFFSET 0.25 // distance in degrees for goto target unidirectional approach, 0.0 disables +#endif +#ifndef GOTO_OFFSET_ALIGN +#define GOTO_OFFSET_ALIGN OFF // skip final phase of goto for align stars so user tends to +#endif // approach from the correct direction when centering +#ifndef GOTO_SETTLE_TIME +#define GOTO_SETTLE_TIME 1500 // settle time in milliseconds for final phase of goto offset +#endif // allows for settle and encoder sync if available +#ifndef GOTO_REFINE_STAGES +#define GOTO_REFINE_STAGES 1 // number of times to perform the goto refinement stage +#endif + +// meridian flip, pier side +#ifndef MFLIP_SKIP_HOME +#define MFLIP_SKIP_HOME OFF +#endif +#ifndef MFLIP_PAUSE_HOME_DEFAULT +#define MFLIP_PAUSE_HOME_DEFAULT OFF +#endif +#ifndef MFLIP_PAUSE_HOME_MEMORY +#define MFLIP_PAUSE_HOME_MEMORY OFF +#endif +#ifndef MFLIP_AUTOMATIC_DEFAULT +#define MFLIP_AUTOMATIC_DEFAULT OFF +#endif +#ifndef MFLIP_AUTOMATIC_MEMORY +#define MFLIP_AUTOMATIC_MEMORY OFF +#endif +#ifndef PIER_SIDE_SYNC_CHANGE_SIDES +#define PIER_SIDE_SYNC_CHANGE_SIDES OFF +#endif +#ifndef PIER_SIDE_PREFERRED_DEFAULT +#define PIER_SIDE_PREFERRED_DEFAULT BEST +#endif +#ifndef PIER_SIDE_PREFERRED_MEMORY +#define PIER_SIDE_PREFERRED_MEMORY OFF +#endif + +// align +#ifndef ALIGN_MAX_STARS +#define ALIGN_MAX_STARS AUTO // max num align stars, AUTO for HAL specified default +#endif + +#ifndef ALIGN_AUTO_HOME +#define ALIGN_AUTO_HOME OFF // uses home switches to find home before starting the align +#endif + +#ifndef ALIGN_MODEL_MEMORY +#define ALIGN_MODEL_MEMORY OFF // restores any pointing model saved in NV at startup +#endif + +#define HIGH_SPEED_ALIGN + +// ----------------------------------------------------------------------------------- +// rotator settings, ROTATOR +#ifndef AXIS3_DRIVER_MODEL +#define AXIS3_DRIVER_MODEL OFF // specify a driver to enable +#endif +#ifndef AXIS3_STEPS_PER_DEGREE +#define AXIS3_STEPS_PER_DEGREE 64.0 // (micro)steps per degree of movement +#endif +#ifndef AXIS3_REVERSE +#define AXIS3_REVERSE OFF // reverse movement +#endif +#ifndef AXIS3_POWER_DOWN +#define AXIS3_POWER_DOWN OFF // power down at standstill +#endif +#ifndef AXIS3_POWER_DOWN_TIME +#define AXIS3_POWER_DOWN_TIME 30000 // power down time in milliseconds +#endif +#ifndef AXIS3_ENABLE_STATE +#define AXIS3_ENABLE_STATE LOW // stepper enable state +#endif +#ifndef AXIS3_SLEW_RATE_BASE_DESIRED +#define AXIS3_SLEW_RATE_BASE_DESIRED 3.0 // in degrees/sec +#endif +#ifndef AXIS3_ACCELERATION_TIME +#define AXIS3_ACCELERATION_TIME 1.0 // in seconds, to selected rate +#endif +#ifndef AXIS3_RAPID_STOP_TIME +#define AXIS3_RAPID_STOP_TIME 1.0 // in seconds, to stop +#endif +#ifndef AXIS3_BACKLASH_RATE +#define AXIS3_BACKLASH_RATE (AXIS3_SLEW_RATE_BASE_DESIRED/4) // in degrees/sec +#endif +#ifndef AXIS3_LIMIT_MIN +#define AXIS3_LIMIT_MIN -180 // in degrees +#endif +#ifndef AXIS3_LIMIT_MAX +#define AXIS3_LIMIT_MAX 180 // in degrees +#endif +#ifndef AXIS3_SENSE_HOME +#define AXIS3_SENSE_HOME OFF +#endif +#ifndef AXIS3_SENSE_HOME_INIT +#define AXIS3_SENSE_HOME_INIT INPUT_PULLUP +#endif +#ifndef AXIS3_SENSE_HOME_DIST_LIMIT +#define AXIS3_SENSE_HOME_DIST_LIMIT 180.0 // max home sense distance in degrees +#endif +#ifndef AXIS3_SENSE_LIMIT_MIN +#define AXIS3_SENSE_LIMIT_MIN OFF +#endif +#ifndef AXIS3_SENSE_LIMIT_MAX +#define AXIS3_SENSE_LIMIT_MAX OFF +#endif +#ifndef AXIS3_SENSE_LIMIT_INIT +#define AXIS3_SENSE_LIMIT_INIT INPUT_PULLUP +#endif +#if AXIS3_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS3_DRIVER_MODEL <= STEP_DIR_DRIVER_LAST + #define AXIS3_STEP_DIR_PRESENT + + #ifndef AXIS3_STEP_STATE + #define AXIS3_STEP_STATE HIGH + #endif + #ifndef AXIS3_M2_ON_STATE + #define AXIS3_M2_ON_STATE HIGH + #endif + #ifndef AXIS3_DRIVER_MICROSTEPS + #define AXIS3_DRIVER_MICROSTEPS OFF + #endif + #ifndef AXIS3_DRIVER_MICROSTEPS_GOTO + #define AXIS3_DRIVER_MICROSTEPS_GOTO OFF + #endif + #ifndef AXIS3_DRIVER_INTPOL + #define AXIS3_DRIVER_INTPOL ON + #endif + #ifndef AXIS3_DRIVER_DECAY + #define AXIS3_DRIVER_DECAY OFF + #endif + #ifndef AXIS3_DRIVER_DECAY_GOTO + #define AXIS3_DRIVER_DECAY_GOTO OFF + #endif + #ifndef AXIS3_DRIVER_IHOLD + #define AXIS3_DRIVER_IHOLD OFF + #endif + #ifndef AXIS3_DRIVER_IRUN + #define AXIS3_DRIVER_IRUN OFF + #endif + #ifndef AXIS3_DRIVER_IGOTO + #define AXIS3_DRIVER_IGOTO OFF + #endif + #ifndef AXIS3_DRIVER_STATUS + #define AXIS3_DRIVER_STATUS OFF + #endif +#endif + +#if AXIS3_DRIVER_MODEL >= SERVO_DRIVER_FIRST && AXIS2_DRIVER_MODEL <= SERVO_DRIVER_LAST + #define AXIS3_SERVO_PRESENT + + #ifndef AXIS3_SERVO_PH1_STATE + #define AXIS3_SERVO_PH1_STATE LOW + #endif + #ifndef AXIS3_SERVO_PH2_STATE + #define AXIS3_SERVO_PH2_STATE LOW + #endif + + #ifndef AXIS3_SERVO_ACCELERATION + #define AXIS3_SERVO_ACCELERATION 100 + #endif + #ifndef AXIS3_SERVO_VELOCITY_PWMTHRS + #define AXIS3_SERVO_VELOCITY_PWMTHRS OFF + #endif + #ifndef AXIS3_MOTOR_STEPS_PER_DEGREE + #define AXIS3_MOTOR_STEPS_PER_DEGREE AXIS3_STEPS_PER_DEGREE + #endif + #ifndef AXIS3_SERVO_DC_PWR_MIN + #define AXIS3_SERVO_DC_PWR_MIN 0.0F + #endif + #ifndef AXIS3_SERVO_DC_PWR_MAX + #define AXIS3_SERVO_DC_PWR_MAX 100.0F + #endif + + #ifndef AXIS3_SERVO_FEEDBACK + #define AXIS3_SERVO_FEEDBACK PID + #endif + #ifndef AXIS3_PID_P + #define AXIS3_PID_P 0.0 + #endif + #ifndef AXIS3_PID_I + #define AXIS3_PID_I 0.0 + #endif + #ifndef AXIS3_PID_D + #define AXIS3_PID_D 0.0 + #endif + + #ifndef AXIS3_SERVO_FLTR + #define AXIS3_SERVO_FLTR OFF + #endif + #ifndef AXIS3_ENCODER + #define AXIS3_ENCODER AB + #endif + #ifndef AXIS3_ENCODER_ORIGIN + #define AXIS3_ENCODER_ORIGIN 0 + #endif + #ifndef AXIS3_ENCODER_REVERSE + #define AXIS3_ENCODER_REVERSE OFF + #endif +#endif + +#if AXIS3_DRIVER_MODEL == KTECH + #define AXIS3_KTECH_PRESENT +#endif + +#if AXIS3_DRIVER_MODEL == MKS42D + #define AXIS3_MKS42D_PRESENT +#endif + +// ----------------------------------------------------------------------------------- +// focuser settings, all + +#ifndef FOCUSER_TEMPERATURE +#define FOCUSER_TEMPERATURE OFF // activate and set focuser sensor type DS18B20, THERMISTOR, etc. +#endif +#ifndef FOCUSER_BUTTON_SENSE_OUT +#define FOCUSER_BUTTON_SENSE_OUT OFF // moves focuser out +#endif +#ifndef FOCUSER_BUTTON_SENSE_IN +#define FOCUSER_BUTTON_SENSE_IN OFF // moves focuser in +#endif +#ifndef FOCUSER_BUTTON_SENSE_INIT +#define FOCUSER_BUTTON_SENSE_INIT INPUT_PULLUP // pin mode for focuser buttons +#endif +#ifndef FOCUSER_BUTTON_FOCUSER_INDEX +#define FOCUSER_BUTTON_FOCUSER_INDEX 1 // which focuser to associate pushbutton control with (1 to 6) +#endif +#ifndef FOCUSER_BUTTON_MOVE_RATE +#define FOCUSER_BUTTON_MOVE_RATE 0 // focuser button move rate, 0 uses last set or specify fixed rate in um/sec +#endif + +// ----------------------------------------------------------------------------------- +// focuser settings, FOCUSER1 +#ifndef AXIS4_DRIVER_MODEL +#define AXIS4_DRIVER_MODEL OFF // specify a driver to enable +#endif +#ifndef AXIS4_STEPS_PER_MICRON +#define AXIS4_STEPS_PER_MICRON 0.5 // (micro)steps per micron of movement +#endif +#ifndef AXIS4_REVERSE +#define AXIS4_REVERSE OFF // reverse movement direction +#endif +#ifndef AXIS4_POWER_DOWN +#define AXIS4_POWER_DOWN OFF // power down at standstill +#endif +#ifndef AXIS4_POWER_DOWN_TIME +#define AXIS4_POWER_DOWN_TIME 30000 // power down time in milliseconds +#endif +#ifndef AXIS4_SLAVED_TO_FOCUSER +#define AXIS4_SLAVED_TO_FOCUSER 0 // focuser to slave to, or 0 to disable +#endif +#ifndef AXIS4_ENABLE_STATE +#define AXIS4_ENABLE_STATE LOW // enable pin state when driver is active +#endif +#ifndef AXIS4_SLEW_RATE_MINIMUM +#define AXIS4_SLEW_RATE_MINIMUM 20 // in microns/sec +#endif +#ifndef AXIS4_SLEW_RATE_BASE_DESIRED +#define AXIS4_SLEW_RATE_BASE_DESIRED 500 // in microns/sec +#endif +#ifndef AXIS4_ACCELERATION_TIME +#define AXIS4_ACCELERATION_TIME 1.0 // in seconds, to selected rate +#endif +#ifndef AXIS4_RAPID_STOP_TIME +#define AXIS4_RAPID_STOP_TIME 1.0 // in seconds, to stop +#endif +#ifndef AXIS4_BACKLASH_RATE +#define AXIS4_BACKLASH_RATE (AXIS4_SLEW_RATE_BASE_DESIRED/4) // in microns/sec +#endif +#ifndef AXIS4_LIMIT_MIN +#define AXIS4_LIMIT_MIN 0 // in mm +#endif +#ifndef AXIS4_LIMIT_MAX +#define AXIS4_LIMIT_MAX 50 // in mm +#endif +#ifndef AXIS4_HOME_DEFAULT +#define AXIS4_HOME_DEFAULT MIDDLE // use MINIMUM (zero), MIDDLE (half travel), MAXIMUM (full travel), or a position in microns +#endif +#ifndef AXIS4_SENSE_HOME +#define AXIS4_SENSE_HOME OFF +#endif +#ifndef AXIS4_SENSE_HOME_INIT +#define AXIS4_SENSE_HOME_INIT INPUT_PULLUP +#endif +#ifndef AXIS4_SENSE_HOME_DIST_LIMIT +#define AXIS4_SENSE_HOME_DIST_LIMIT 50 // max home sense distance in mm +#endif +#ifndef AXIS4_SENSE_LIMIT_MIN +#define AXIS4_SENSE_LIMIT_MIN OFF +#endif +#ifndef AXIS4_SENSE_LIMIT_MAX +#define AXIS4_SENSE_LIMIT_MAX OFF +#endif +#ifndef AXIS4_SENSE_LIMIT_INIT +#define AXIS4_SENSE_LIMIT_INIT INPUT_PULLUP +#endif + +#if AXIS4_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS4_DRIVER_MODEL <= STEP_DIR_DRIVER_LAST + #define AXIS4_STEP_DIR_PRESENT + + #ifndef AXIS4_STEP_STATE + #define AXIS4_STEP_STATE HIGH + #endif + #ifndef AXIS4_M2_ON_STATE + #define AXIS4_M2_ON_STATE HIGH + #endif + #ifndef AXIS4_DRIVER_MICROSTEPS + #define AXIS4_DRIVER_MICROSTEPS OFF + #endif + #ifndef AXIS4_DRIVER_MICROSTEPS_GOTO + #define AXIS4_DRIVER_MICROSTEPS_GOTO OFF + #endif + #ifndef AXIS4_DRIVER_INTPOL + #define AXIS4_DRIVER_INTPOL ON + #endif + #ifndef AXIS4_DRIVER_DECAY + #define AXIS4_DRIVER_DECAY OFF + #endif + #ifndef AXIS4_DRIVER_DECAY_GOTO + #define AXIS4_DRIVER_DECAY_GOTO OFF + #endif + #ifndef AXIS4_DRIVER_IHOLD + #define AXIS4_DRIVER_IHOLD OFF + #endif + #ifndef AXIS4_DRIVER_IRUN + #define AXIS4_DRIVER_IRUN OFF + #endif + #ifndef AXIS4_DRIVER_IGOTO + #define AXIS4_DRIVER_IGOTO OFF + #endif + #ifndef AXIS4_DRIVER_STATUS + #define AXIS4_DRIVER_STATUS OFF + #endif +#endif + +#if AXIS4_DRIVER_MODEL >= SERVO_DRIVER_FIRST && AXIS2_DRIVER_MODEL <= SERVO_DRIVER_LAST + #define AXIS4_SERVO_PRESENT + + #ifndef AXIS4_SERVO_PH1_STATE + #define AXIS4_SERVO_PH1_STATE LOW + #endif + #ifndef AXIS4_SERVO_PH2_STATE + #define AXIS4_SERVO_PH2_STATE LOW + #endif + + #ifndef AXIS4_SERVO_ACCELERATION + #define AXIS4_SERVO_ACCELERATION 100 + #endif + #ifndef AXIS4_SERVO_VELOCITY_PWMTHRS + #define AXIS4_SERVO_VELOCITY_PWMTHRS OFF + #endif + #ifndef AXIS4_MOTOR_STEPS_PER_DEGREE + #define AXIS4_MOTOR_STEPS_PER_DEGREE AXIS4_STEPS_PER_DEGREE + #endif + #ifndef AXIS4_SERVO_DC_PWR_MIN + #define AXIS4_SERVO_DC_PWR_MIN 0.0F + #endif + #ifndef AXIS4_SERVO_DC_PWR_MAX + #define AXIS4_SERVO_DC_PWR_MAX 100.0F + #endif + + #ifndef AXIS4_SERVO_FEEDBACK + #define AXIS4_SERVO_FEEDBACK PID + #endif + #ifndef AXIS4_PID_P + #define AXIS4_PID_P 0.0 + #endif + #ifndef AXIS4_PID_I + #define AXIS4_PID_I 0.0 + #endif + #ifndef AXIS4_PID_D + #define AXIS4_PID_D 0.0 + #endif + + #ifndef AXIS4_SERVO_FLTR + #define AXIS4_SERVO_FLTR OFF + #endif + #ifndef AXIS4_ENCODER + #define AXIS4_ENCODER AB + #endif + #ifndef AXIS4_ENCODER_ORIGIN + #define AXIS4_ENCODER_ORIGIN 0 + #endif + #ifndef AXIS4_ENCODER_REVERSE + #define AXIS4_ENCODER_REVERSE OFF + #endif +#endif + +#if AXIS4_DRIVER_MODEL == KTECH + #define AXIS4_KTECH_PRESENT +#endif + +#if AXIS4_DRIVER_MODEL == MKS42D + #define AXIS4_MKS42D_PRESENT +#endif + +// focuser settings, FOCUSER2 +#ifndef AXIS5_DRIVER_MODEL +#define AXIS5_DRIVER_MODEL OFF +#endif +#ifndef AXIS5_STEPS_PER_MICRON +#define AXIS5_STEPS_PER_MICRON 0.5 +#endif +#ifndef AXIS5_REVERSE +#define AXIS5_REVERSE OFF +#endif +#ifndef AXIS5_POWER_DOWN +#define AXIS5_POWER_DOWN OFF +#endif +#ifndef AXIS5_POWER_DOWN_TIME +#define AXIS5_POWER_DOWN_TIME 30000 +#endif +#ifndef AXIS5_SLAVED_TO_FOCUSER +#define AXIS5_SLAVED_TO_FOCUSER 0 +#endif +#ifndef AXIS5_ENABLE_STATE +#define AXIS5_ENABLE_STATE LOW +#endif +#ifndef AXIS5_SLEW_RATE_MINIMUM +#define AXIS5_SLEW_RATE_MINIMUM 20 +#endif +#ifndef AXIS5_SLEW_RATE_BASE_DESIRED +#define AXIS5_SLEW_RATE_BASE_DESIRED 500 +#endif +#ifndef AXIS5_ACCELERATION_TIME +#define AXIS5_ACCELERATION_TIME 1.0 +#endif +#ifndef AXIS5_RAPID_STOP_TIME +#define AXIS5_RAPID_STOP_TIME 1.0 +#endif +#ifndef AXIS5_BACKLASH_RATE +#define AXIS5_BACKLASH_RATE (AXIS5_SLEW_RATE_BASE_DESIRED/4) +#endif +#ifndef AXIS5_LIMIT_MIN +#define AXIS5_LIMIT_MIN 0 +#endif +#ifndef AXIS5_LIMIT_MAX +#define AXIS5_LIMIT_MAX 50 +#endif +#ifndef AXIS5_HOME_DEFAULT +#define AXIS5_HOME_DEFAULT MIDDLE +#endif +#ifndef AXIS5_SENSE_HOME +#define AXIS5_SENSE_HOME OFF +#endif +#ifndef AXIS5_SENSE_HOME_INIT +#define AXIS5_SENSE_HOME_INIT INPUT_PULLUP +#endif +#ifndef AXIS5_SENSE_HOME_DIST_LIMIT +#define AXIS5_SENSE_HOME_DIST_LIMIT 50 +#endif +#ifndef AXIS5_SENSE_LIMIT_MIN +#define AXIS5_SENSE_LIMIT_MIN OFF +#endif +#ifndef AXIS5_SENSE_LIMIT_MAX +#define AXIS5_SENSE_LIMIT_MAX OFF +#endif +#ifndef AXIS5_SENSE_LIMIT_INIT +#define AXIS5_SENSE_LIMIT_INIT INPUT_PULLUP +#endif + +#if AXIS5_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS5_DRIVER_MODEL <= STEP_DIR_DRIVER_LAST + #define AXIS5_STEP_DIR_PRESENT + + #ifndef AXIS5_STEP_STATE + #define AXIS5_STEP_STATE HIGH + #endif + #ifndef AXIS5_M2_ON_STATE + #define AXIS5_M2_ON_STATE HIGH + #endif + #ifndef AXIS5_DRIVER_MICROSTEPS + #define AXIS5_DRIVER_MICROSTEPS OFF + #endif + #ifndef AXIS5_DRIVER_MICROSTEPS_GOTO + #define AXIS5_DRIVER_MICROSTEPS_GOTO OFF + #endif + #ifndef AXIS5_DRIVER_INTPOL + #define AXIS5_DRIVER_INTPOL ON + #endif + #ifndef AXIS5_DRIVER_DECAY + #define AXIS5_DRIVER_DECAY OFF + #endif + #ifndef AXIS5_DRIVER_DECAY_GOTO + #define AXIS5_DRIVER_DECAY_GOTO OFF + #endif + #ifndef AXIS5_DRIVER_IHOLD + #define AXIS5_DRIVER_IHOLD OFF + #endif + #ifndef AXIS5_DRIVER_IRUN + #define AXIS5_DRIVER_IRUN OFF + #endif + #ifndef AXIS5_DRIVER_IGOTO + #define AXIS5_DRIVER_IGOTO OFF + #endif + #ifndef AXIS5_DRIVER_STATUS + #define AXIS5_DRIVER_STATUS OFF + #endif +#endif + +#if AXIS5_DRIVER_MODEL >= SERVO_DRIVER_FIRST && AXIS2_DRIVER_MODEL <= SERVO_DRIVER_LAST + #define AXIS5_SERVO_PRESENT + + #ifndef AXIS5_SERVO_PH1_STATE + #define AXIS5_SERVO_PH1_STATE LOW + #endif + #ifndef AXIS5_SERVO_PH2_STATE + #define AXIS5_SERVO_PH2_STATE LOW + #endif + + #ifndef AXIS5_SERVO_ACCELERATION + #define AXIS5_SERVO_ACCELERATION 100 + #endif + #ifndef AXIS5_SERVO_VELOCITY_PWMTHRS + #define AXIS5_SERVO_VELOCITY_PWMTHRS OFF + #endif + #ifndef AXIS5_MOTOR_STEPS_PER_DEGREE + #define AXIS5_MOTOR_STEPS_PER_DEGREE AXIS5_STEPS_PER_DEGREE + #endif + #ifndef AXIS5_SERVO_DC_PWR_MIN + #define AXIS5_SERVO_DC_PWR_MIN 0.0F + #endif + #ifndef AXIS5_SERVO_DC_PWR_MAX + #define AXIS5_SERVO_DC_PWR_MAX 100.0F + #endif + + #ifndef AXIS5_SERVO_FEEDBACK + #define AXIS5_SERVO_FEEDBACK PID + #endif + #ifndef AXIS5_PID_P + #define AXIS5_PID_P 0.0 + #endif + #ifndef AXIS5_PID_I + #define AXIS5_PID_I 0.0 + #endif + #ifndef AXIS5_PID_D + #define AXIS5_PID_D 0.0 + #endif + #ifndef AXIS5_PID_P_GOTO + #define AXIS5_PID_P_GOTO AXIS5_PID_P + #endif + #ifndef AXIS5_PID_I_GOTO + #define AXIS5_PID_I_GOTO AXIS5_PID_I + #endif + #ifndef AXIS5_PID_D_GOTO + #define AXIS5_PID_D_GOTO AXIS5_PID_D + #endif + + #ifndef AXIS5_SERVO_FLTR + #define AXIS5_SERVO_FLTR OFF + #endif + #ifndef AXIS5_ENCODER + #define AXIS5_ENCODER AB + #endif + #ifndef AXIS5_ENCODER_ORIGIN + #define AXIS5_ENCODER_ORIGIN 0 + #endif + #ifndef AXIS5_ENCODER_REVERSE + #define AXIS5_ENCODER_REVERSE OFF + #endif +#endif + +#if AXIS5_DRIVER_MODEL == KTECH + #define AXIS5_KTECH_PRESENT +#endif + +#if AXIS5_DRIVER_MODEL == MKS42D + #define AXIS5_MKS42D_PRESENT +#endif + +// focuser settings, FOCUSER3 +#ifndef AXIS6_DRIVER_MODEL +#define AXIS6_DRIVER_MODEL OFF +#endif +#ifndef AXIS6_STEPS_PER_MICRON +#define AXIS6_STEPS_PER_MICRON 0.5 +#endif +#ifndef AXIS6_REVERSE +#define AXIS6_REVERSE OFF +#endif +#ifndef AXIS6_POWER_DOWN +#define AXIS6_POWER_DOWN OFF +#endif +#ifndef AXIS6_POWER_DOWN_TIME +#define AXIS6_POWER_DOWN_TIME 30000 +#endif +#ifndef AXIS6_SLAVED_TO_FOCUSER +#define AXIS6_SLAVED_TO_FOCUSER 0 +#endif +#ifndef AXIS6_ENABLE_STATE +#define AXIS6_ENABLE_STATE LOW +#endif +#ifndef AXIS6_SLEW_RATE_MINIMUM +#define AXIS6_SLEW_RATE_MINIMUM 20 +#endif +#ifndef AXIS6_SLEW_RATE_BASE_DESIRED +#define AXIS6_SLEW_RATE_BASE_DESIRED 500 +#endif +#ifndef AXIS6_ACCELERATION_TIME +#define AXIS6_ACCELERATION_TIME 1.0 +#endif +#ifndef AXIS6_RAPID_STOP_TIME +#define AXIS6_RAPID_STOP_TIME 1.0 +#endif +#ifndef AXIS6_BACKLASH_RATE +#define AXIS6_BACKLASH_RATE (AXIS6_SLEW_RATE_BASE_DESIRED/4) +#endif +#ifndef AXIS6_LIMIT_MIN +#define AXIS6_LIMIT_MIN 0 +#endif +#ifndef AXIS6_LIMIT_MAX +#define AXIS6_LIMIT_MAX 50 +#endif +#ifndef AXIS6_HOME_DEFAULT +#define AXIS6_HOME_DEFAULT MIDDLE +#endif +#ifndef AXIS6_SENSE_HOME +#define AXIS6_SENSE_HOME OFF +#endif +#ifndef AXIS6_SENSE_HOME_INIT +#define AXIS6_SENSE_HOME_INIT INPUT_PULLUP +#endif +#ifndef AXIS6_SENSE_HOME_DIST_LIMIT +#define AXIS6_SENSE_HOME_DIST_LIMIT 50 +#endif +#ifndef AXIS6_SENSE_LIMIT_MIN +#define AXIS6_SENSE_LIMIT_MIN OFF +#endif +#ifndef AXIS6_SENSE_LIMIT_MAX +#define AXIS6_SENSE_LIMIT_MAX OFF +#endif +#ifndef AXIS6_SENSE_LIMIT_INIT +#define AXIS6_SENSE_LIMIT_INIT INPUT_PULLUP +#endif + +#if AXIS6_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS6_DRIVER_MODEL <= STEP_DIR_DRIVER_LAST + #define AXIS6_STEP_DIR_PRESENT + + #ifndef AXIS6_STEP_STATE + #define AXIS6_STEP_STATE HIGH + #endif + #ifndef AXIS6_M2_ON_STATE + #define AXIS6_M2_ON_STATE HIGH + #endif + #ifndef AXIS6_DRIVER_MICROSTEPS + #define AXIS6_DRIVER_MICROSTEPS OFF + #endif + #ifndef AXIS6_DRIVER_MICROSTEPS_GOTO + #define AXIS6_DRIVER_MICROSTEPS_GOTO OFF + #endif + #ifndef AXIS6_DRIVER_INTPOL + #define AXIS6_DRIVER_INTPOL ON + #endif + #ifndef AXIS6_DRIVER_DECAY + #define AXIS6_DRIVER_DECAY OFF + #endif + #ifndef AXIS6_DRIVER_DECAY_GOTO + #define AXIS6_DRIVER_DECAY_GOTO OFF + #endif + #ifndef AXIS6_DRIVER_IHOLD + #define AXIS6_DRIVER_IHOLD OFF + #endif + #ifndef AXIS6_DRIVER_IRUN + #define AXIS6_DRIVER_IRUN OFF + #endif + #ifndef AXIS6_DRIVER_IGOTO + #define AXIS6_DRIVER_IGOTO OFF + #endif + #ifndef AXIS6_DRIVER_STATUS + #define AXIS6_DRIVER_STATUS OFF + #endif +#endif + +#if AXIS6_DRIVER_MODEL >= SERVO_DRIVER_FIRST && AXIS2_DRIVER_MODEL <= SERVO_DRIVER_LAST + #define AXIS6_SERVO_PRESENT + + #ifndef AXIS6_SERVO_PH1_STATE + #define AXIS6_SERVO_PH1_STATE LOW + #endif + #ifndef AXIS6_SERVO_PH2_STATE + #define AXIS6_SERVO_PH2_STATE LOW + #endif + + #ifndef AXIS6_SERVO_ACCELERATION + #define AXIS6_SERVO_ACCELERATION 100 + #endif + #ifndef AXIS6_SERVO_VELOCITY_PWMTHRS + #define AXIS6_SERVO_VELOCITY_PWMTHRS OFF + #endif + #ifndef AXIS6_MOTOR_STEPS_PER_DEGREE + #define AXIS6_MOTOR_STEPS_PER_DEGREE AXIS6_STEPS_PER_DEGREE + #endif + #ifndef AXIS6_SERVO_DC_PWR_MIN + #define AXIS6_SERVO_DC_PWR_MIN 0.0F + #endif + #ifndef AXIS6_SERVO_DC_PWR_MAX + #define AXIS6_SERVO_DC_PWR_MAX 100.0F + #endif + + #ifndef AXIS6_SERVO_FEEDBACK + #define AXIS6_SERVO_FEEDBACK PID + #endif + #ifndef AXIS6_PID_P + #define AXIS6_PID_P 0.0 + #endif + #ifndef AXIS6_PID_I + #define AXIS6_PID_I 0.0 + #endif + #ifndef AXIS6_PID_D + #define AXIS6_PID_D 0.0 + #endif + + #ifndef AXIS6_SERVO_FLTR + #define AXIS6_SERVO_FLTR OFF + #endif + #ifndef AXIS6_ENCODER + #define AXIS6_ENCODER AB + #endif + #ifndef AXIS6_ENCODER_ORIGIN + #define AXIS6_ENCODER_ORIGIN 0 + #endif + #ifndef AXIS6_ENCODER_REVERSE + #define AXIS6_ENCODER_REVERSE OFF + #endif +#endif + +#if AXIS6_DRIVER_MODEL == KTECH + #define AXIS6_KTECH_PRESENT +#endif + +#if AXIS6_DRIVER_MODEL == MKS42D + #define AXIS6_MKS42D_PRESENT +#endif + +// focuser settings, FOCUSER4 +#ifndef AXIS7_DRIVER_MODEL +#define AXIS7_DRIVER_MODEL OFF +#endif +#ifndef AXIS7_STEPS_PER_MICRON +#define AXIS7_STEPS_PER_MICRON 0.5 +#endif +#ifndef AXIS7_REVERSE +#define AXIS7_REVERSE OFF +#endif +#ifndef AXIS7_POWER_DOWN +#define AXIS7_POWER_DOWN OFF +#endif +#ifndef AXIS7_POWER_DOWN_TIME +#define AXIS7_POWER_DOWN_TIME 30000 +#endif +#ifndef AXIS7_SLAVED_TO_FOCUSER +#define AXIS7_SLAVED_TO_FOCUSER 0 +#endif +#ifndef AXIS7_ENABLE_STATE +#define AXIS7_ENABLE_STATE LOW +#endif +#ifndef AXIS7_SLEW_RATE_MINIMUM +#define AXIS7_SLEW_RATE_MINIMUM 20 +#endif +#ifndef AXIS7_SLEW_RATE_BASE_DESIRED +#define AXIS7_SLEW_RATE_BASE_DESIRED 500 +#endif +#ifndef AXIS7_ACCELERATION_TIME +#define AXIS7_ACCELERATION_TIME 1.0 +#endif +#ifndef AXIS7_RAPID_STOP_TIME +#define AXIS7_RAPID_STOP_TIME 1.0 +#endif +#ifndef AXIS7_BACKLASH_RATE +#define AXIS7_BACKLASH_RATE (AXIS7_SLEW_RATE_BASE_DESIRED/4) +#endif +#ifndef AXIS7_LIMIT_MIN +#define AXIS7_LIMIT_MIN 0 +#endif +#ifndef AXIS7_LIMIT_MAX +#define AXIS7_LIMIT_MAX 50 +#endif +#ifndef AXIS7_HOME_DEFAULT +#define AXIS7_HOME_DEFAULT MIDDLE +#endif +#ifndef AXIS7_SENSE_HOME +#define AXIS7_SENSE_HOME OFF +#endif +#ifndef AXIS7_SENSE_HOME_INIT +#define AXIS7_SENSE_HOME_INIT INPUT_PULLUP +#endif +#ifndef AXIS7_SENSE_HOME_DIST_LIMIT +#define AXIS7_SENSE_HOME_DIST_LIMIT 50 +#endif +#ifndef AXIS7_SENSE_LIMIT_MIN +#define AXIS7_SENSE_LIMIT_MIN OFF +#endif +#ifndef AXIS7_SENSE_LIMIT_MAX +#define AXIS7_SENSE_LIMIT_MAX OFF +#endif +#ifndef AXIS7_SENSE_LIMIT_INIT +#define AXIS7_SENSE_LIMIT_INIT INPUT_PULLUP +#endif +#if AXIS7_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS7_DRIVER_MODEL <= STEP_DIR_DRIVER_LAST + #define AXIS7_STEP_DIR_PRESENT + + #ifndef AXIS7_STEP_STATE + #define AXIS7_STEP_STATE HIGH + #endif + #ifndef AXIS7_M2_ON_STATE + #define AXIS7_M2_ON_STATE HIGH + #endif + #ifndef AXIS7_DRIVER_MICROSTEPS + #define AXIS7_DRIVER_MICROSTEPS OFF + #endif + #ifndef AXIS7_DRIVER_MICROSTEPS_GOTO + #define AXIS7_DRIVER_MICROSTEPS_GOTO OFF + #endif + #ifndef AXIS7_DRIVER_INTPOL + #define AXIS7_DRIVER_INTPOL ON + #endif + #ifndef AXIS7_DRIVER_DECAY + #define AXIS7_DRIVER_DECAY OFF + #endif + #ifndef AXIS7_DRIVER_DECAY_GOTO + #define AXIS7_DRIVER_DECAY_GOTO OFF + #endif + #ifndef AXIS7_DRIVER_IHOLD + #define AXIS7_DRIVER_IHOLD OFF + #endif + #ifndef AXIS7_DRIVER_IRUN + #define AXIS7_DRIVER_IRUN OFF + #endif + #ifndef AXIS7_DRIVER_IGOTO + #define AXIS7_DRIVER_IGOTO OFF + #endif + #ifndef AXIS7_DRIVER_STATUS + #define AXIS7_DRIVER_STATUS OFF + #endif +#endif + +#if AXIS7_DRIVER_MODEL >= SERVO_DRIVER_FIRST && AXIS2_DRIVER_MODEL <= SERVO_DRIVER_LAST + #define AXIS7_SERVO_PRESENT + + #ifndef AXIS7_SERVO_PH1_STATE + #define AXIS7_SERVO_PH1_STATE LOW + #endif + #ifndef AXIS7_SERVO_PH2_STATE + #define AXIS7_SERVO_PH2_STATE LOW + #endif + + #ifndef AXIS7_SERVO_ACCELERATION + #define AXIS7_SERVO_ACCELERATION 100 + #endif + #ifndef AXIS7_SERVO_VELOCITY_PWMTHRS + #define AXIS7_SERVO_VELOCITY_PWMTHRS OFF + #endif + #ifndef AXIS7_MOTOR_STEPS_PER_DEGREE + #define AXIS7_MOTOR_STEPS_PER_DEGREE AXIS7_STEPS_PER_DEGREE + #endif + #ifndef AXIS7_SERVO_DC_PWR_MIN + #define AXIS7_SERVO_DC_PWR_MIN 0.0F + #endif + #ifndef AXIS7_SERVO_DC_PWR_MAX + #define AXIS7_SERVO_DC_PWR_MAX 100.0F + #endif + + #ifndef AXIS7_SERVO_FEEDBACK + #define AXIS7_SERVO_FEEDBACK PID + #endif + #ifndef AXIS7_PID_P + #define AXIS7_PID_P 0.0 + #endif + #ifndef AXIS7_PID_I + #define AXIS7_PID_I 0.0 + #endif + #ifndef AXIS7_PID_D + #define AXIS7_PID_D 0.0 + #endif + + #ifndef AXIS7_SERVO_FLTR + #define AXIS7_SERVO_FLTR OFF + #endif + #ifndef AXIS7_ENCODER + #define AXIS7_ENCODER AB + #endif + #ifndef AXIS7_ENCODER_ORIGIN + #define AXIS7_ENCODER_ORIGIN 0 + #endif + #ifndef AXIS7_ENCODER_REVERSE + #define AXIS7_ENCODER_REVERSE OFF + #endif +#endif + +#if AXIS7_DRIVER_MODEL == KTECH + #define AXIS7_KTECH_PRESENT +#endif + +#if AXIS7_DRIVER_MODEL == MKS42D + #define AXIS7_MKS42D_PRESENT +#endif + +// focuser settings, FOCUSER5 +#ifndef AXIS8_DRIVER_MODEL +#define AXIS8_DRIVER_MODEL OFF +#endif +#ifndef AXIS8_STEPS_PER_MICRON +#define AXIS8_STEPS_PER_MICRON 0.5 +#endif +#ifndef AXIS8_REVERSE +#define AXIS8_REVERSE OFF +#endif +#ifndef AXIS8_POWER_DOWN +#define AXIS8_POWER_DOWN OFF +#endif +#ifndef AXIS8_POWER_DOWN_TIME +#define AXIS8_POWER_DOWN_TIME 30000 +#endif +#ifndef AXIS8_SLAVED_TO_FOCUSER +#define AXIS8_SLAVED_TO_FOCUSER 0 +#endif +#ifndef AXIS8_ENABLE_STATE +#define AXIS8_ENABLE_STATE LOW +#endif +#ifndef AXIS8_SLEW_RATE_MINIMUM +#define AXIS8_SLEW_RATE_MINIMUM 20 +#endif +#ifndef AXIS8_SLEW_RATE_BASE_DESIRED +#define AXIS8_SLEW_RATE_BASE_DESIRED 500 +#endif +#ifndef AXIS8_ACCELERATION_TIME +#define AXIS8_ACCELERATION_TIME 1.0 +#endif +#ifndef AXIS8_RAPID_STOP_TIME +#define AXIS8_RAPID_STOP_TIME 1.0 +#endif +#ifndef AXIS8_BACKLASH_RATE +#define AXIS8_BACKLASH_RATE (AXIS8_SLEW_RATE_BASE_DESIRED/4) +#endif +#ifndef AXIS8_LIMIT_MIN +#define AXIS8_LIMIT_MIN 0 +#endif +#ifndef AXIS8_LIMIT_MAX +#define AXIS8_LIMIT_MAX 50 +#endif +#ifndef AXIS8_HOME_DEFAULT +#define AXIS8_HOME_DEFAULT MIDDLE +#endif +#ifndef AXIS8_SENSE_HOME +#define AXIS8_SENSE_HOME OFF +#endif +#ifndef AXIS8_SENSE_HOME_INIT +#define AXIS8_SENSE_HOME_INIT INPUT_PULLUP +#endif +#ifndef AXIS8_SENSE_HOME_DIST_LIMIT +#define AXIS8_SENSE_HOME_DIST_LIMIT 50 +#endif +#ifndef AXIS8_SENSE_LIMIT_MIN +#define AXIS8_SENSE_LIMIT_MIN OFF +#endif +#ifndef AXIS8_SENSE_LIMIT_MAX +#define AXIS8_SENSE_LIMIT_MAX OFF +#endif +#ifndef AXIS8_SENSE_LIMIT_INIT +#define AXIS8_SENSE_LIMIT_INIT INPUT_PULLUP +#endif + +#if AXIS8_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS8_DRIVER_MODEL <= STEP_DIR_DRIVER_LAST + #define AXIS8_STEP_DIR_PRESENT + + #ifndef AXIS8_STEP_STATE + #define AXIS8_STEP_STATE HIGH + #endif + #ifndef AXIS8_M2_ON_STATE + #define AXIS8_M2_ON_STATE HIGH + #endif + #ifndef AXIS8_DRIVER_MICROSTEPS + #define AXIS8_DRIVER_MICROSTEPS OFF + #endif + #ifndef AXIS8_DRIVER_MICROSTEPS_GOTO + #define AXIS8_DRIVER_MICROSTEPS_GOTO OFF + #endif + #ifndef AXIS8_DRIVER_INTPOL + #define AXIS8_DRIVER_INTPOL ON + #endif + #ifndef AXIS8_DRIVER_DECAY + #define AXIS8_DRIVER_DECAY OFF + #endif + #ifndef AXIS8_DRIVER_DECAY_GOTO + #define AXIS8_DRIVER_DECAY_GOTO OFF + #endif + #ifndef AXIS8_DRIVER_IHOLD + #define AXIS8_DRIVER_IHOLD OFF + #endif + #ifndef AXIS8_DRIVER_IRUN + #define AXIS8_DRIVER_IRUN OFF + #endif + #ifndef AXIS8_DRIVER_IGOTO + #define AXIS8_DRIVER_IGOTO OFF + #endif + #ifndef AXIS8_DRIVER_STATUS + #define AXIS8_DRIVER_STATUS OFF + #endif +#endif + +#if AXIS8_DRIVER_MODEL >= SERVO_DRIVER_FIRST && AXIS2_DRIVER_MODEL <= SERVO_DRIVER_LAST + #define AXIS8_SERVO_PRESENT + + #ifndef AXIS8_SERVO_PH1_STATE + #define AXIS8_SERVO_PH1_STATE LOW + #endif + #ifndef AXIS8_SERVO_PH2_STATE + #define AXIS8_SERVO_PH2_STATE LOW + #endif + + #ifndef AXIS8_SERVO_ACCELERATION + #define AXIS8_SERVO_ACCELERATION 100 + #endif + #ifndef AXIS8_SERVO_VELOCITY_PWMTHRS + #define AXIS8_SERVO_VELOCITY_PWMTHRS OFF + #endif + #ifndef AXIS8_MOTOR_STEPS_PER_DEGREE + #define AXIS8_MOTOR_STEPS_PER_DEGREE AXIS8_STEPS_PER_DEGREE + #endif + #ifndef AXIS8_SERVO_DC_PWR_MIN + #define AXIS8_SERVO_DC_PWR_MIN 0.0F + #endif + #ifndef AXIS8_SERVO_DC_PWR_MAX + #define AXIS8_SERVO_DC_PWR_MAX 100.0F + #endif + + #ifndef AXIS8_SERVO_FEEDBACK + #define AXIS8_SERVO_FEEDBACK PID + #endif + #ifndef AXIS8_PID_P + #define AXIS8_PID_P 0.0 + #endif + #ifndef AXIS8_PID_I + #define AXIS8_PID_I 0.0 + #endif + #ifndef AXIS8_PID_D + #define AXIS8_PID_D 0.0 + #endif + + #ifndef AXIS8_SERVO_FLTR + #define AXIS8_SERVO_FLTR OFF + #endif + #ifndef AXIS8_ENCODER + #define AXIS8_ENCODER AB + #endif + #ifndef AXIS8_ENCODER_ORIGIN + #define AXIS8_ENCODER_ORIGIN 0 + #endif + #ifndef AXIS8_ENCODER_REVERSE + #define AXIS8_ENCODER_REVERSE OFF + #endif +#endif + +#if AXIS8_DRIVER_MODEL == KTECH + #define AXIS8_KTECH_PRESENT +#endif + +#if AXIS8_DRIVER_MODEL == MKS42D + #define AXIS8_MKS42D_PRESENT +#endif + +// focuser settings, FOCUSER6 +#ifndef AXIS9_DRIVER_MODEL +#define AXIS9_DRIVER_MODEL OFF +#endif +#ifndef AXIS9_STEPS_PER_MICRON +#define AXIS9_STEPS_PER_MICRON 0.5 +#endif +#ifndef AXIS9_REVERSE +#define AXIS9_REVERSE OFF +#endif +#ifndef AXIS9_POWER_DOWN +#define AXIS9_POWER_DOWN OFF +#endif +#ifndef AXIS9_POWER_DOWN_TIME +#define AXIS9_POWER_DOWN_TIME 30000 +#endif +#ifndef AXIS9_SLAVED_TO_FOCUSER +#define AXIS9_SLAVED_TO_FOCUSER 0 +#endif +#ifndef AXIS9_ENABLE_STATE +#define AXIS9_ENABLE_STATE LOW +#endif +#ifndef AXIS9_SLEW_RATE_MINIMUM +#define AXIS9_SLEW_RATE_MINIMUM 20 +#endif +#ifndef AXIS9_SLEW_RATE_BASE_DESIRED +#define AXIS9_SLEW_RATE_BASE_DESIRED 500 +#endif +#ifndef AXIS9_ACCELERATION_TIME +#define AXIS9_ACCELERATION_TIME 1.0 +#endif +#ifndef AXIS9_RAPID_STOP_TIME +#define AXIS9_RAPID_STOP_TIME 1.0 +#endif +#ifndef AXIS9_BACKLASH_RATE +#define AXIS9_BACKLASH_RATE (AXIS9_SLEW_RATE_BASE_DESIRED/4) +#endif +#ifndef AXIS9_LIMIT_MIN +#define AXIS9_LIMIT_MIN 0 +#endif +#ifndef AXIS9_LIMIT_MAX +#define AXIS9_LIMIT_MAX 50 +#endif +#ifndef AXIS9_HOME_DEFAULT +#define AXIS9_HOME_DEFAULT MIDDLE +#endif +#ifndef AXIS9_SENSE_HOME +#define AXIS9_SENSE_HOME OFF +#endif +#ifndef AXIS9_SENSE_HOME_INIT +#define AXIS9_SENSE_HOME_INIT INPUT_PULLUP +#endif +#ifndef AXIS9_SENSE_HOME_DIST_LIMIT +#define AXIS9_SENSE_HOME_DIST_LIMIT 50 +#endif +#ifndef AXIS9_SENSE_LIMIT_MIN +#define AXIS9_SENSE_LIMIT_MIN OFF +#endif +#ifndef AXIS9_SENSE_LIMIT_MAX +#define AXIS9_SENSE_LIMIT_MAX OFF +#endif +#ifndef AXIS9_SENSE_LIMIT_INIT +#define AXIS9_SENSE_LIMIT_INIT INPUT_PULLUP +#endif + +#if AXIS9_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS9_DRIVER_MODEL <= STEP_DIR_DRIVER_LAST + #define AXIS9_STEP_DIR_PRESENT + + #ifndef AXIS9_STEP_STATE + #define AXIS9_STEP_STATE HIGH + #endif + #ifndef AXIS9_M2_ON_STATE + #define AXIS9_M2_ON_STATE HIGH + #endif + #ifndef AXIS9_DRIVER_MICROSTEPS + #define AXIS9_DRIVER_MICROSTEPS OFF + #endif + #ifndef AXIS9_DRIVER_MICROSTEPS_GOTO + #define AXIS9_DRIVER_MICROSTEPS_GOTO OFF + #endif + #ifndef AXIS9_DRIVER_INTPOL + #define AXIS9_DRIVER_INTPOL ON + #endif + #ifndef AXIS9_DRIVER_DECAY + #define AXIS9_DRIVER_DECAY OFF + #endif + #ifndef AXIS9_DRIVER_DECAY_GOTO + #define AXIS9_DRIVER_DECAY_GOTO OFF + #endif + #ifndef AXIS9_DRIVER_IHOLD + #define AXIS9_DRIVER_IHOLD OFF + #endif + #ifndef AXIS9_DRIVER_IRUN + #define AXIS9_DRIVER_IRUN OFF + #endif + #ifndef AXIS9_DRIVER_IGOTO + #define AXIS9_DRIVER_IGOTO OFF + #endif + #ifndef AXIS9_DRIVER_STATUS + #define AXIS9_DRIVER_STATUS OFF + #endif +#endif + +#if AXIS9_DRIVER_MODEL >= SERVO_DRIVER_FIRST && AXIS2_DRIVER_MODEL <= SERVO_DRIVER_LAST + #define AXIS9_SERVO_PRESENT + + #ifndef AXIS9_SERVO_PH1_STATE + #define AXIS9_SERVO_PH1_STATE LOW + #endif + #ifndef AXIS9_SERVO_PH2_STATE + #define AXIS9_SERVO_PH2_STATE LOW + #endif + + #ifndef AXIS9_SERVO_ACCELERATION + #define AXIS9_SERVO_ACCELERATION 100 + #endif + #ifndef AXIS9_SERVO_VELOCITY_PWMTHRS + #define AXIS9_SERVO_VELOCITY_PWMTHRS OFF + #endif + #ifndef AXIS9_MOTOR_STEPS_PER_DEGREE + #define AXIS9_MOTOR_STEPS_PER_DEGREE AXIS9_STEPS_PER_DEGREE + #endif + #ifndef AXIS9_SERVO_DC_PWR_MIN + #define AXIS9_SERVO_DC_PWR_MIN 0.0F + #endif + #ifndef AXIS9_SERVO_DC_PWR_MAX + #define AXIS9_SERVO_DC_PWR_MAX 100.0F + #endif + + #ifndef AXIS9_SERVO_FEEDBACK + #define AXIS9_SERVO_FEEDBACK PID + #endif + #ifndef AXIS9_PID_P + #define AXIS9_PID_P 0.0 + #endif + #ifndef AXIS9_PID_I + #define AXIS9_PID_I 0.0 + #endif + #ifndef AXIS9_PID_D + #define AXIS9_PID_D 0.0 + #endif + + #ifndef AXIS9_SERVO_FLTR + #define AXIS9_SERVO_FLTR OFF + #endif + #ifndef AXIS9_ENCODER + #define AXIS9_ENCODER AB + #endif + #ifndef AXIS9_ENCODER_ORIGIN + #define AXIS9_ENCODER_ORIGIN 0 + #endif + #ifndef AXIS9_ENCODER_REVERSE + #define AXIS9_ENCODER_REVERSE OFF + #endif +#endif + +#if AXIS9_DRIVER_MODEL == KTECH + #define AXIS9_KTECH_PRESENT +#endif + +#if AXIS9_DRIVER_MODEL == MKS42D + #define AXIS9_MKS42D_PRESENT +#endif + +// ----------------------------------------------------------------------------------- +// helper for checking driver presence +#define DRIVER_CHECK(model) \ + AXIS1_DRIVER_MODEL == model || \ + AXIS2_DRIVER_MODEL == model || \ + AXIS3_DRIVER_MODEL == model || \ + AXIS4_DRIVER_MODEL == model || \ + AXIS5_DRIVER_MODEL == model || \ + AXIS6_DRIVER_MODEL == model || \ + AXIS7_DRIVER_MODEL == model || \ + AXIS8_DRIVER_MODEL == model || \ + AXIS9_DRIVER_MODEL == model + +// flag presence of step/dir legacy drivers +#if AXIS1_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS1_DRIVER_MODEL < TMC_DRIVER_FIRST || \ + AXIS2_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS2_DRIVER_MODEL < TMC_DRIVER_FIRST || \ + AXIS3_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS3_DRIVER_MODEL < TMC_DRIVER_FIRST || \ + AXIS4_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS4_DRIVER_MODEL < TMC_DRIVER_FIRST || \ + AXIS5_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS5_DRIVER_MODEL < TMC_DRIVER_FIRST || \ + AXIS6_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS6_DRIVER_MODEL < TMC_DRIVER_FIRST || \ + AXIS7_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS7_DRIVER_MODEL < TMC_DRIVER_FIRST || \ + AXIS8_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS8_DRIVER_MODEL < TMC_DRIVER_FIRST || \ + AXIS9_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS9_DRIVER_MODEL < TMC_DRIVER_FIRST + #define STEP_DIR_LEGACY_PRESENT +#endif + +// flag presence of Step/Dir TMC UART and SPI drivers +#if DRIVER_CHECK(TMC2130) + #define TMC2130_PRESENT +#endif +#if DRIVER_CHECK(TMC2160) + #define TMC2160_PRESENT +#endif +#if DRIVER_CHECK(TMC2208) + #define TMC2208_PRESENT +#endif +#if DRIVER_CHECK(TMC2209) + #define TMC2209_PRESENT +#endif +#if DRIVER_CHECK(TMC2226) + #define TMC2209_PRESENT +#endif +#if DRIVER_CHECK(TMC2660) + #define TMC2660_PRESENT +#endif +#if DRIVER_CHECK(TMC5160) + #define TMC5160_PRESENT +#endif +#if DRIVER_CHECK(TMC5161) + #define TMC5161_PRESENT +#endif + +#if defined(TMC2130_PRESENT) || defined(TMC2160_PRESENT) || defined(TMC2660_PRESENT) || \ + defined(TMC5160_PRESENT) || defined(TMC5161_PRESENT) + #define STEP_DIR_TMC_SPI_PRESENT +#endif + +#if defined(TMC2208_PRESENT) || defined(TMC2209_PRESENT) + #define STEP_DIR_TMC_UART_PRESENT +#endif + +#if defined(STEP_DIR_LEGACY_PRESENT) || defined(STEP_DIR_TMC_SPI_PRESENT) || defined(STEP_DIR_TMC_UART_PRESENT) + #define STEP_DIR_MOTOR_PRESENT +#endif + +// flag presence of Servo motors +#if DRIVER_CHECK(SERVO_PE) + #define SERVO_PE_PRESENT +#endif +#if DRIVER_CHECK(SERVO_EE) + #define SERVO_EE_PRESENT +#endif +#if DRIVER_CHECK(SERVO_TMC2130_DC) + #define SERVO_TMC2130_DC_PRESENT +#endif +#if DRIVER_CHECK(SERVO_TMC5160_DC) + #define SERVO_TMC5160_DC_PRESENT +#endif +#if DRIVER_CHECK(SERVO_TMC2209) + #define SERVO_TMC2209_PRESENT +#endif +#if DRIVER_CHECK(SERVO_TMC5160) + #define SERVO_TMC5160_PRESENT +#endif +#if DRIVER_CHECK(SERVO_KTECH) + #define SERVO_KTECH_PRESENT +#endif + +#if defined(SERVO_PE_PRESENT) || defined(SERVO_EE_PRESENT) || defined(SERVO_TMC2130_DC_PRESENT) || \ + defined(SERVO_TMC5160_DC_PRESENT) || defined(SERVO_TMC2209_PRESENT) || defined(SERVO_TMC5160_PRESENT) || \ + defined(SERVO_KTECH_PRESENT) + #define SERVO_MOTOR_PRESENT +#endif + +// flag presence of ODRIVE motors +#if defined(AXIS1_ODRIVE_PRESENT) || defined(AXIS2_ODRIVE_PRESENT) + #define ODRIVE_MOTOR_PRESENT +#endif + +// flag presence of KTECH motors +#if DRIVER_CHECK(KTECH) + #define KTECH_MOTOR_PRESENT +#endif + +// flag presence of MKS SERVO42D/57D motors +#if DRIVER_CHECK(MKS42D) + #define MKS42D_MOTOR_PRESENT +#endif + +// flag to indicate if any motor is present +#if defined(SERVO_MOTOR_PRESENT) || defined(STEP_DIR_MOTOR_PRESENT) || defined(ODRIVE_MOTOR_PRESENT) || defined(KTECH_MOTOR_PRESENT) + #define MOTOR_PRESENT +#endif + +// ----------------------------------------------------------------------------------- +// auxiliary feature settings + +#ifndef FEATURE1_PURPOSE +#define FEATURE1_PURPOSE OFF // OFF or SWITCH, ANALOG_OUT, DEW_HEATER, INTERVALOMETER +#endif +#ifndef FEATURE1_NAME +#define FEATURE1_NAME "FEATURE1" // user friendly name of feature, up to 10 chars +#endif +#ifndef FEATURE1_TEMP +#define FEATURE1_TEMP OFF // temperature sensor, thermistor or DS1820 +#endif +#ifndef FEATURE1_PIN +#define FEATURE1_PIN OFF // OUTPUT control pin +#endif +#ifndef FEATURE1_VALUE_DEFAULT +#define FEATURE1_VALUE_DEFAULT OFF // OUTPUT control pin default value/state ON, OFF, 0..255 +#endif +#ifndef FEATURE1_VALUE_MEMORY +#define FEATURE1_VALUE_MEMORY OFF // ON remembers feature value across power cycles +#endif +#ifndef FEATURE1_ON_STATE +#define FEATURE1_ON_STATE HIGH // OUTPUT control pin ON (active) state +#endif + +#ifndef FEATURE2_PURPOSE +#define FEATURE2_PURPOSE OFF +#endif +#ifndef FEATURE2_NAME +#define FEATURE2_NAME "FEATURE2" +#endif +#ifndef FEATURE2_TEMP +#define FEATURE2_TEMP OFF +#endif +#ifndef FEATURE2_PIN +#define FEATURE2_PIN OFF +#endif +#ifndef FEATURE2_VALUE_DEFAULT +#define FEATURE2_VALUE_DEFAULT OFF +#endif +#ifndef FEATURE2_VALUE_MEMORY +#define FEATURE2_VALUE_MEMORY OFF +#endif +#ifndef FEATURE2_ON_STATE +#define FEATURE2_ON_STATE HIGH +#endif + +#ifndef FEATURE3_PURPOSE +#define FEATURE3_PURPOSE OFF +#endif +#ifndef FEATURE3_NAME +#define FEATURE3_NAME "FEATURE3" +#endif +#ifndef FEATURE3_TEMP +#define FEATURE3_TEMP OFF +#endif +#ifndef FEATURE3_PIN +#define FEATURE3_PIN OFF +#endif +#ifndef FEATURE3_VALUE_DEFAULT +#define FEATURE3_VALUE_DEFAULT OFF +#endif +#ifndef FEATURE3_VALUE_MEMORY +#define FEATURE3_VALUE_MEMORY OFF +#endif +#ifndef FEATURE3_ON_STATE +#define FEATURE3_ON_STATE HIGH +#endif + +#ifndef FEATURE4_PURPOSE +#define FEATURE4_PURPOSE OFF +#endif +#ifndef FEATURE4_NAME +#define FEATURE4_NAME "FEATURE4" +#endif +#ifndef FEATURE4_TEMP +#define FEATURE4_TEMP OFF +#endif +#ifndef FEATURE4_PIN +#define FEATURE4_PIN OFF +#endif +#ifndef FEATURE4_VALUE_DEFAULT +#define FEATURE4_VALUE_DEFAULT OFF +#endif +#ifndef FEATURE4_VALUE_MEMORY +#define FEATURE4_VALUE_MEMORY OFF +#endif +#ifndef FEATURE4_ON_STATE +#define FEATURE4_ON_STATE HIGH +#endif + +#ifndef FEATURE5_PURPOSE +#define FEATURE5_PURPOSE OFF +#endif +#ifndef FEATURE5_NAME +#define FEATURE5_NAME "FEATURE5" +#endif +#ifndef FEATURE5_TEMP +#define FEATURE5_TEMP OFF +#endif +#ifndef FEATURE5_PIN +#define FEATURE5_PIN OFF +#endif +#ifndef FEATURE5_VALUE_DEFAULT +#define FEATURE5_VALUE_DEFAULT OFF +#endif +#ifndef FEATURE5_VALUE_MEMORY +#define FEATURE5_VALUE_MEMORY OFF +#endif +#ifndef FEATURE5_ON_STATE +#define FEATURE5_ON_STATE HIGH +#endif + +#ifndef FEATURE6_PURPOSE +#define FEATURE6_PURPOSE OFF +#endif +#ifndef FEATURE6_NAME +#define FEATURE6_NAME "FEATURE6" +#endif +#ifndef FEATURE6_TEMP +#define FEATURE6_TEMP OFF +#endif +#ifndef FEATURE6_PIN +#define FEATURE6_PIN OFF +#endif +#ifndef FEATURE6_VALUE_DEFAULT +#define FEATURE6_VALUE_DEFAULT OFF +#endif +#ifndef FEATURE6_VALUE_MEMORY +#define FEATURE6_VALUE_MEMORY OFF +#endif +#ifndef FEATURE6_ON_STATE +#define FEATURE6_ON_STATE HIGH +#endif + +#ifndef FEATURE7_PURPOSE +#define FEATURE7_PURPOSE OFF +#endif +#ifndef FEATURE7_NAME +#define FEATURE7_NAME "FEATURE7" +#endif +#ifndef FEATURE7_TEMP +#define FEATURE7_TEMP OFF +#endif +#ifndef FEATURE7_PIN +#define FEATURE7_PIN OFF +#endif +#ifndef FEATURE7_VALUE_DEFAULT +#define FEATURE7_VALUE_DEFAULT OFF +#endif +#ifndef FEATURE7_VALUE_MEMORY +#define FEATURE7_VALUE_MEMORY OFF +#endif +#ifndef FEATURE7_ON_STATE +#define FEATURE7_ON_STATE HIGH +#endif + +#ifndef FEATURE8_PURPOSE +#define FEATURE8_PURPOSE OFF +#endif +#ifndef FEATURE8_NAME +#define FEATURE8_NAME "FEATURE8" +#endif +#ifndef FEATURE8_TEMP +#define FEATURE8_TEMP OFF +#endif +#ifndef FEATURE8_PIN +#define FEATURE8_PIN OFF +#endif +#ifndef FEATURE8_VALUE_DEFAULT +#define FEATURE8_VALUE_DEFAULT OFF +#endif +#ifndef FEATURE8_VALUE_MEMORY +#define FEATURE8_VALUE_MEMORY OFF +#endif +#ifndef FEATURE8_ON_STATE +#define FEATURE8_ON_STATE HIGH +#endif + +// auxiliary feature power monitor configuration + +// fan control +#ifndef FAN_PIN +#define FAN_PIN OFF // PWM capable pin to run a small fan to help cool the controller +#endif +#ifndef FAN_THRESHOLD_LOW +#define FAN_THRESHOLD_LOW 35 // Deg. C +#endif +#ifndef FAN_POWER_LOW +#define FAN_POWER_LOW 60 // % +#endif +#ifndef FAN_THRESHOLD_MID +#define FAN_THRESHOLD_MID 45 // Deg. C +#endif +#ifndef FAN_POWER_MID +#define FAN_POWER_MID 80 // % +#endif +#ifndef FAN_THRESHOLD_HIGH +#define FAN_THRESHOLD_HIGH 50 // Deg. C +#endif +#ifndef FAN_POWER_HIGH +#define FAN_POWER_HIGH 100 // % +#endif +#ifndef FAN_THRESHOLD_OT +#define FAN_THRESHOLD_OT 60 // turn off all channels if MCU temperature exceeds this (Deg. C) +#endif +#if defined(FAN_PIN) + #define POWER_MONITOR_FAN_PRESENT +#endif + +// voltage sensing +//#define V_SENSE_PINS {OFF,OFF,OFF,OFF,OFF,OFF,OFF,OFF} // an array of pin#'s corresponding to auxiliary features 1..8 +#ifndef V_SENSE_FORMULA +#define V_SENSE_FORMULA (v*18.405) // scales up typical 0..3.3V to actual V (47k/2.7k resistor voltage divider) +#endif +#ifndef V_SENSE_LIMIT_LOW +#define V_SENSE_LIMIT_LOW 10.5 // 12V nominal, low limit below this all channels are turned OFF +#endif +#ifndef V_SENSE_LIMIT_HIGH +#define V_SENSE_LIMIT_HIGH 13.8 // 12V nominal, high limit above this all channels are turned OFF +#endif +#ifndef V_SENSE_LIMIT_EXCLUDE +#define V_SENSE_LIMIT_EXCLUDE OFF // allow excluding pin# from the checks (variable voltage output) +#endif +#if defined(V_SENSE_PINS) && defined(V_SENSE_FORMULA) + #define POWER_MONITOR_VOLTAGE_PRESENT +#endif + +// current sensing +//#define I_SENSE_PINS {OFF,OFF,OFF,OFF,OFF,OFF,OFF,OFF} // an array of pin#'s corresponding to auxiliary features 1..8 +#ifndef I_SENSE_FORMULA +#define I_SENSE_FORMULA (-((v-1.65)/0.09)) // nominal 3.3V Vcc/2 (at 0A) with scaling (down) at 0.09V/Amp +#endif +#ifndef I_SENSE_CHANNEL_MAX +#define I_SENSE_CHANNEL_MAX {OFF,OFF,OFF,OFF,OFF,OFF,OFF,OFF} // turn off individual channel (1..8) if current exceeds this (Amps) +#endif +#ifndef I_SENSE_COMBINED_MAX +#define I_SENSE_COMBINED_MAX 12 // turn off all channels if combined current exceeds this (Amps) +#endif +#if defined(I_SENSE_PINS) && defined(I_SENSE_FORMULA) + #define POWER_MONITOR_CURRENT_PRESENT +#endif + +#if defined(POWER_MONITOR_VOLTAGE_PRESENT) && defined(POWER_MONITOR_CURRENT_PRESENT) + #define POWER_MONITOR_PRESENT +#endif + +// ----------------------------------------------------------------------------------- +// thermistor configuration settings + +// type 1 +#ifndef THERMISTOR1_TNOM +#define THERMISTOR1_TNOM 25 // nominal temperature (Celsius) +#endif +#ifndef THERMISTOR1_RNOM +#define THERMISTOR1_RNOM 10000 // nominal resistance (Ohms) at nominal temperature +#endif +#ifndef THERMISTOR1_BETA +#define THERMISTOR1_BETA 3950 // beta coefficient +#endif +#ifndef THERMISTOR1_RSERIES +#define THERMISTOR1_RSERIES 4700 // series resistor value (Ohms) +#endif + +// type 2 +#ifndef THERMISTOR2_TNOM +#define THERMISTOR2_TNOM 25 // nominal temperature (Celsius) +#endif +#ifndef THERMISTOR2_RNOM +#define THERMISTOR2_RNOM 10000 // nominal resistance (Ohms) at nominal temperature +#endif +#ifndef THERMISTOR2_BETA +#define THERMISTOR2_BETA 3950 // beta coefficient +#endif +#ifndef THERMISTOR2_RSERIES +#define THERMISTOR2_RSERIES 4700 // series resistor value (Ohms) +#endif + diff --git a/src/Constants.h b/src/Constants.h new file mode 100755 index 0000000..8aff151 --- /dev/null +++ b/src/Constants.h @@ -0,0 +1,163 @@ +// ----------------------------------------------------------------------------------- +// Constants +#pragma once + +// Configuration options ---------------------------------------------------------------------------------------------------- + +// PINMAPS +#define PINMAP_FIRST 1 + +#define FYSETC_E4 1 // FYSETC E4 Version 1.0, *** EXPERIMENTAL, MAY BE REMOVED AT ANY TIME *** + +#define FYSETC_S6 2 // FYSETC S6 Version 1.2, 3D printer board, a 6-axis design +#define FYSETC_S6_1 3 // FYSETC S6 Version 1.2 +#define FYSETC_S6_2 4 // FYSETC S6 Version 2.0, 3D printer board, a 6-axis design + +#define BTT_SKR_PRO 5 // BigTreeTech SKR PRO Version 1.2 +#define BTT_OCTOPUS_PRO 6 // BigTreeTech Octopus Pro Version 1.1 + +#define MiniPCB 7 // small 2-axis design for embedded or mounting behind a panel, Teensy3.2 +#define MiniPCB13 8 // improved version 1.3 adds better support for ESP-01 flashing and optional I2C + +#define MiniPCB2 9 // 2-axis design for small alum. case, Teensy3.2 + +#define MaxPCB 10 // first generation custom 4-axis board, Teensy3.5/Teensy3.6 +#define MaxPCB2 11 // second generation adds alum. case, Teensy3.5/Teensy3.6 +#define MaxPCB3 12 // third generation adds SPI four axis support, Teensy4.1 +#define MaxPCB4 13 // forth generation with SPI/TMC2209 support, Teensy4.1 +#define RESERVED 14 // RESERVED + +#define MaxSTM3 15 // update to the MaxPCB3 using an Blackpill F411CE instead of the Teensy3.5/3.6 +#define MaxSTM3I 16 // as above but using an onboard STM32F411CE with M24C64 EEPROM as default + +#define MaxESP3 17 // adds 4th axis and option to flash the WeMos D1 Mini WiFi through OnStep +#define MaxESP4 18 // for ESP32S w/TMC2209 support +#define CNC3 19 // Arduino CNC Sheild on WeMos D1 R32 (ESP32) +#define MicroScope 20 // MicroScope PCB (ESP32, experimental and may be removed at any point!, USE AY YOUR OWN RISK!!!) + +#define STM32Blue 21 // Khalid and Dave's PCB for STM32 Blue pill (STM32F103CB and STM32F303CC) + +#define JTWSTM 22 // JTW Astronomy JTWSTM telescope mount controller Rev 2.1 +#define MANTICORE 23 // JTW Astronomy MANTICORE telescope mount controller Rev 1.0 + +#define SAL_XB1 24 // SAL-XB1 telescope mount controller + +#define PINMAP_LAST 24 + +// WEATHER sensors (temperature, pressure, and humidity) +#define WEATHER_FIRST 1 +#define BME280 1 // BME280 on I2C (at default address 0x77) +#define BME280_0x77 1 // BME280 on I2C (at address 0x77) +#define BME280_0x76 2 // BME280 on I2C (at address 0x76) +#define BME280_SPI 3 // BME280 on SPI (default CS) +#define BMP280 4 // BMP280 on I2C (at default address 0x77) +#define BMP280_0x77 4 // BMP280 on I2C (at address 0x77) +#define BMP280_0x76 5 // BMP280 on I2C (at address 0x76) +#define BMP280_SPI 6 // BMP280 on SPI (default CS) +#define WEATHER_LAST 6 + +// STEP WAVE FORM +#define STEP_WAVE_FORM_FIRST 1 +#define SQUARE 1 +#define PULSE 2 +#define STEP_WAVE_FORM_LAST 2 + +// MOUNT TYPE +#define MOUNT_TYPE_FIRST 1 +#define MOUNT_SUBTYPE_FIRST 1 +#define GEM 1 // German Equatorial Mount, meridian flips enabled +#define FORK 2 // Fork Mount, meridian flips disabled +#define ALTAZM 3 // Altitude Azimuth Mounts, Dobsonians, etc. +#define ALTALT 4 // Altitude Altitude Mounts +#define MOUNT_SUBTYPE_LAST 4 +#define GEM_TA 5 // GEM, w/tangent arm Declination +#define GEM_TAC 6 // GEM, w/tangent arm Declination and geometry correction +#define FORK_TA 7 // FORK, w/tangent arm Declination +#define FORK_TAC 8 // FORK, w/tangent arm Declination and geometry correction +#define ALTAZM_UNL 9 // ALTAZM, w/unlimited Azmiuth motion +#define MOUNT_TYPE_LAST 9 + +// MOUNT COORDS +#define MOUNT_COORDS_FIRST 1 +#define OBSERVED_PLACE 1 +#define TOPOCENTRIC 2 +#define TOPO_STRICT 3 +#define ASTROMETRIC_J2000 4 +#define MOUNT_COORDS_LAST 4 + +// STARTUP AUTHORITY MODE +#define SA_STRICT 1 +#define SA_AUTO 2 +#define SA_PERMISSIVE 3 + +// TIME LOCATION SOURCE devices supported +#define TLS_FIRST 1 +#define DS3231 1 // DS3231 RTC on I2C +#define DS3234 2 // DS3234 RTC on SPI (DS3234_CS_PIN) Makuna library +#define SD3031 3 // SD3031 RTC on I2C +#define TEENSY 4 // TEENSY3.2 RTC (Built-in) +#define GPS 5 // GPS device +#define NTP 6 // NTP +#define TLS_LAST 6 + +// PIER SIDE +#define PIER_SIDE_FIRST 1 +#define EAST 1 // same as PSS_EAST +#define WEST 2 // same as PSS_WEST +#define BEST 3 // same as PSS_BEST +#define AUTOMATIC 4 // same as PSS_AUTO +#define PIER_SIDE_LAST 4 + +// COMPENSATED TRACKING +#define COMPENSATED_TRACKING_FIRST 1 +#define REFRACTION 1 // refraction compensated tracking RA only +#define REFRACTION_DUAL 2 // refraction compensated tracking both axes +#define MODEL 3 // pointing model compensated tracking RA only +#define MODEL_DUAL 4 // pointing model compensated tracking both axes +#define COMPENSATED_TRACKING_LAST 4 + +// TEMPERATURE sensing devices +#define TEMPERATURE_FIRST 1 +#define DS1820 0x2800000000000000 // DS18B20 1-wire temperature sensors for focusing and dew heaters +#define DS18B20 0x2800000000000000 // as above +#define DS18S20 0x1000000000000000 // as above, except for DS18S20 +#define DS_MASK 0x3F00000000000000 // not for use in Config.h +#define THERMISTOR 1 // General purpose thermistor sensor, type 1 (see Config.defaults.h) +#define THERMISTOR1 1 // as above +#define THERMISTOR2 2 // General purpose thermistor sensor, type 2 (see Config.defaults.h) +#define TEMPERATURE_LAST 2 + +// AUXILIARY FEATURE purpose +#define AUX_FEATURE_PURPOSE_FIRST 1 +#define SWITCH 1 // control an simple on/off switch +#define ANALOG_OUTPUT 2 // control an analog (pwm) output, depends on MCU support +#define ANALOG_OUT 2 // as above +#define DEW_HEATER 3 // control an dew heater +#define INTERVALOMETER 4 // control an camera shutter +#define MOMENTARY_SWITCH 5 // control an simple momentary on/off switch +#define HIDDEN_SWITCH 6 // control an hidden on/off switch (for controlling a pin state at boot) +#define COVER_SWITCH 7 // control an servo driven OTA cover where "on" is closed and "off" is open +#define AUX_FEATURE_PURPOSE_LAST 7 + +// -------------------------------------------------------------------------------------------------------------------------- + +// task manager +#define TASKS_MAX 60 // up to 60 tasks +#define TASKS_SKIP_MISSED // just skip missed tasks if too late +#ifdef ESP32 + #define TASKS_HWTIMERS 4 // up to 4 hardware timers +#else + #define TASKS_HWTIMERS 3 +#endif + +// default start of axis class hardware timers +#define AXIS_HARDWARE_TIMER_BASE 2 // in the OnStepX timer#1 is the sidereal clock + +// enable library features +#define SERIAL_LOCAL_PRESENT +#define SERIAL_ST4_SERVER_PRESENT + +// NV ------------------------------------------------------------------------------------------------------------------- + +// unique volume signature for this volume/partition layout +#define NV_VOLUME_SIGNATURE 0x0001u diff --git a/src/HAL/HAL.cpp b/src/HAL/HAL.cpp new file mode 100755 index 0000000..2d9fa16 --- /dev/null +++ b/src/HAL/HAL.cpp @@ -0,0 +1,6 @@ +// HAL global variables +#include + +// Must match the externs in HAL_FAST_TICKS.h exactly +uint32_t _halTicksPerSecond = 1000000UL; +uint32_t _halTicksPerMicro = 1; diff --git a/src/HAL/HAL.h b/src/HAL/HAL.h new file mode 100755 index 0000000..649449f --- /dev/null +++ b/src/HAL/HAL.h @@ -0,0 +1,190 @@ +/* + * Hardware Abstraction Layer (HAL) for OnStep + * + * Copyright (C) 2018 Khalid Baheyeldin + * + * 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 . + */ +#pragma once + +// null decoration for non-ESP processors +#ifndef IRAM_ATTR + #define IRAM_ATTR +#endif + +#ifndef ICACHE_RAM_ATTR + #define ICACHE_RAM_ATTR +#endif + +#ifndef FPSTR + #define FPSTR +#endif + +#include "HAL_FAST_TICKS.h" + +#if defined(__AVR_ATmega328P__) + #define MCU_STR "AtMega328" + #include "atmel/Mega328.h" + +#elif defined(__AVR_ATmega1280__) + #define MCU_STR "Mega1280" + #include "atmel/Mega2560.h" + +#elif defined(__AVR_ATmega2560__) + #define MCU_STR "Mega2560" + #include "atmel/Mega2560.h" + +#elif defined(ARDUINO_UNOWIFIR4) + // Arduino UNO R4 WIFI + #define MCU_STR "RENESAS RA4M1 (Arduino UNO R4 WIFI)" + #include "esp32/ESP32UnoR4WiFi.h" + +#elif defined(ARDUINO_ARCH_SAMD) + // ARDUINO M0 + #define MCU_STR "ARDUINO M0" + #include "arduinoM0/ArduinoM0.h" + +#elif defined(ESP32) && ESP_ARDUINO_VERSION >= 0x30000 + // ESP32 w/libraries 3.x + #define MCU_STR "ESP32" + #include "esp/ESP32Libraries3.h" + +#elif defined(ESP32) && ESP_ARDUINO_VERSION >= 0x20000 + // ESP32 w/libraries 2.x + #define MCU_STR "ESP32" + #include "esp/ESP32Libraries2.h" + +#elif defined(ESP8266) + // ESP8266 + #define MCU_STR "ESP8266" + #include "esp/ESP8266.h" + +#elif defined(STM32F103xB) + // STM32F103C8/CB: 72MHz, 128K flash, 64K RAM, ARM Cortex M3 + #define MCU_STR "STM32F103" + #include "stm32/STM32F103.h" + +#elif defined(STM32F303xC) + // RobotDyn BlackPill STM32F303, 256K flash, ARM Cortex M4 (STM32duino board manager) + #define MCU_STR "STM32F303" + #include "stm32/STM32F303.h" + +#elif defined(STM32F401xC) + // Blackpill board with STM32F401CC + #define MCU_STR "STM32F401" + #include "stm32/STM32F4x1.h" + +#elif defined(STM32F411xE) + // Blackpill board with STM32F411CE + #define MCU_STR "STM32F411" + #include "stm32/STM32F4x1.h" + +#elif defined(STM32F407xx) + // BTT SKR PRO board with STM32F407 + #define MCU_STR "STM32F407" + #include "stm32/STM32F407.h" + +#elif defined(STM32F446xx) + // FYSETC S6 board with STM32F446 + #define MCU_STR "STM32F446" + #include "stm32/STM32F446.h" + +#elif defined(STM32H723xx) + #define MCU_STR "STM32H723" + #include "stm32/STM32H7xx.h" + +#elif defined(STM32H743xx) + // WeAct Studio board with STM32H743 + #define MCU_STR "STM32H743" + #include "stm32/STM32H7xx.h" + +#elif defined(STM32H750xx) + // WeAct Studio board with STM32H750 + #define MCU_STR "STM32H750" + #include "stm32/STM32H7xx.h" + +#elif defined(_mk20dx128_h_) || defined(__MK20DX128__) + // Teensy 3.0 + #define MCU_STR "Teensy3.0" + #include "teensy/Teensy3.2.h" + +#elif defined(__MK20DX256__) + // Teensy 3.2 + #define MCU_STR "Teensy3.2" + #include "teensy/Teensy3.2.h" + +#elif defined(__MK64FX512__) + // Teensy 3.5 + #define MCU_STR "Teensy3.5" + #include "teensy/Teensy3.5.h" + +#elif defined(__MK66FX1M0__) + // Teensy 3.6 + #define MCU_STR "Teensy3.6" + #include "teensy/Teensy3.6.h" + +#elif defined(ARDUINO_TEENSY40) + // Teensy 4.0 + #define MCU_STR "Teensy4.0" + #include "teensy/Teensy4.0.h" + +#elif defined(ARDUINO_TEENSY41) + // Teensy 4.1 + #define MCU_STR "Teensy4.1" + #include "teensy/Teensy4.1.h" + +#elif defined(ARDUINO_TEENSY_MICROMOD) + // Teensy MicroMod + #define MCU_STR "TeensyMicroMod" + #include "teensy/Teensy4.1.h" + +#elif defined(ARDUINO_ARCH_RP2040) + // Raspberry pi pico + #define MCU_STR "Raspberry Pi Pico" + #include "mbed/Rpi2040.h" + +#elif defined(ARDUINO_ARCH_RP2350) + // Raspberry pi pico2 + #define MCU_STR "Raspberry Pi Pico2" + #include "mbed/Rpi2350.h" + +#else + // Generic + #warning "Unknown Platform! If this is a new platform, it would probably do best with a new HAL designed for it." + #define MCU_STR "Generic (Unknown)" + #include "default/Default.h" +#endif + +#include "HAL_ANALOG.h" + +#ifndef HAL_INIT + #define HAL_INIT() do { HAL_FAST_TICKS_INIT(); } while (0) +#endif + +// baseline critical task timing +#ifdef HAL_FRACTIONAL_SEC + #define FRACTIONAL_SEC HAL_FRACTIONAL_SEC +#else + #define FRACTIONAL_SEC 100.0F +#endif + +// progmem standin for platforms that don't have it +#ifndef CAT_ATTR + #define CAT_ATTR +#endif + +// default I2C interface +#if defined(HAL_WIRE_CLOCK) + #define HAL_WIRE_SET_CLOCK() HAL_WIRE.setClock(HAL_WIRE_CLOCK) +#else + #define HAL_WIRE_SET_CLOCK() +#endif diff --git a/src/HAL/HAL_ANALOG.h b/src/HAL/HAL_ANALOG.h new file mode 100755 index 0000000..1986fa3 --- /dev/null +++ b/src/HAL/HAL_ANALOG.h @@ -0,0 +1,73 @@ + +// Analog HAL capabilities (defaults) ---------------------------------------------------------------- +// Defaults: no per-pin control, no global reconfig (safe) +#pragma once + +#ifndef HAL_HAS_PER_PIN_PWM_RESOLUTION + #define HAL_HAS_PER_PIN_PWM_RESOLUTION 0 +#endif +#ifndef HAL_HAS_PER_PIN_PWM_FREQUENCY + #define HAL_HAS_PER_PIN_PWM_FREQUENCY 0 +#endif +#ifndef HAL_HAS_GLOBAL_PWM_RESOLUTION + #define HAL_HAS_GLOBAL_PWM_RESOLUTION 0 +#endif +#ifndef HAL_HAS_GLOBAL_PWM_FREQUENCY + #define HAL_HAS_GLOBAL_PWM_FREQUENCY 0 +#endif + +#ifndef HAL_HAS_PER_PIN_ADC_RESOLUTION + #define HAL_HAS_PER_PIN_ADC_RESOLUTION 0 +#endif +#ifndef HAL_HAS_GLOBAL_ADC_RESOLUTION + #define HAL_HAS_GLOBAL_ADC_RESOLUTION 0 +#endif + +#ifndef HAL_ALLOW_GLOBAL_PWM_RECONFIG + #define HAL_ALLOW_GLOBAL_PWM_RECONFIG 0 +#endif +#ifndef HAL_ALLOW_GLOBAL_ADC_RECONFIG + #define HAL_ALLOW_GLOBAL_ADC_RECONFIG 0 +#endif + +// reasonable bounds (overridden per platform below) +#ifndef HAL_PWM_BITS_MIN + #define HAL_PWM_BITS_MIN 1 +#endif +#ifndef HAL_PWM_BITS_MAX + #define HAL_PWM_BITS_MAX 16 +#endif +#ifndef HAL_ADC_BITS_MIN + #define HAL_ADC_BITS_MIN 1 +#endif +#ifndef HAL_ADC_BITS_MAX + #define HAL_ADC_BITS_MAX 12 +#endif +#ifndef HAL_PWM_HZ_MIN + #define HAL_PWM_HZ_MIN 1U +#endif +#ifndef HAL_PWM_HZ_MAX + #define HAL_PWM_HZ_MAX 40000U +#endif + +// some validation +#if HAL_PWM_BITS_MIN < 1 || HAL_PWM_BITS_MIN > 32 + #error "Error: HAL_PWM_BITS_MIN outside of 1 to 32 range." +#endif +#if HAL_PWM_BITS_MAX < 1 || HAL_PWM_BITS_MAX > 32 + #error "Error: HAL_PWM_BITS_MAX outside of 1 to 32 range." +#endif +#if HAL_ADC_BITS_MIN < 1 || HAL_ADC_BITS_MIN > 32 + #error "Error: HAL_ADC_BITS_MIN outside of 1 to 32 range." +#endif +#if HAL_ADC_BITS_MAX < 1 || HAL_ADC_BITS_MAX > 32 + #error "Error: HAL_ADC_BITS_MAX outside of 1 to 32 range." +#endif + +// global default ranges +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023U // 2^n - 1 +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255U // 2^n - 1 +#endif diff --git a/src/HAL/HAL_FAST_TICKS.h b/src/HAL/HAL_FAST_TICKS.h new file mode 100755 index 0000000..70e3117 --- /dev/null +++ b/src/HAL/HAL_FAST_TICKS.h @@ -0,0 +1,248 @@ +// ------------------------------------------------------------------------------------------------- +// HAL_FAST_TICKS.h +// +// Fast ticks: 32-bit wrapping timestamp intended for ISRs / high-rate timing. +// +// Interface: +// HAL_FAST_TICKS_INIT() call once at startup (safe no-op where not needed) +// HAL_FAST_TICKS() returns uint32_t ticks (wrapping OK) +// HAL_TICKS_PER_SECOND() returns uint32_t tick frequency in Hz (cached) +// delayNanoseconds(ns) short busy-wait delay (NOT intended for ISR use) +// nanoseconds32() convenience conversion (NOT intended for ISR use) +// +// Policy (as requested): +// - Teensy 3.x/4.x: use DWT->CYCCNT (enable once). +// - ESP32 Xtensa (ESP32/S2/S3): use CCOUNT. +// - ESP8266: use ESP.getCycleCount(). +// - STM32: most use micros(), STM32H723/H743/H750 use DWT->CYCCNT. +// - ESP32 RISC-V (C3/C6/H2): use micros(). +// - Everything else: use micros(). +// +// Notes: +// - Tick frequency is cached in _halTicksPerSecond/_halTicksPerMicro (defined in HAL.cpp). +// ------------------------------------------------------------------------------------------------- +#pragma once + +#include +#include + +// Make header self-contained (HAL.h may not have been included yet) +#ifndef IRAM_ATTR + #define IRAM_ATTR +#endif + +// Must be defined once in HAL.cpp: +// uint32_t _halTicksPerSecond = 1000000UL; +// uint32_t _halTicksPerMicro = 1; +extern uint32_t _halTicksPerSecond; +extern uint32_t _halTicksPerMicro; + +// ---------------------------------------- +// Platform identification helpers +// ---------------------------------------- + +// Teensy (3.x/4.x) detection +#if defined(TEENSYDUINO) || defined(ARDUINO_TEENSY40) || defined(ARDUINO_TEENSY41) || \ + defined(ARDUINO_TEENSY_MICROMOD) || \ + defined(__MK20DX128__) || defined(__MK20DX256__) || defined(__MK64FX512__) || defined(__MK66FX1M0__) || \ + defined(__IMXRT1062__) + #define HAL_IS_TEENSY 1 +#else + #define HAL_IS_TEENSY 0 +#endif + +// STM32 H7 detection (STM32duino) +#if defined(ARDUINO_ARCH_STM32) && (defined(STM32H723xx) || defined(STM32H743xx) || defined(STM32H750xx)) + #define HAL_IS_STM32_H7 1 +#else + #define HAL_IS_STM32_H7 0 +#endif + +// ESP32 RISC-V detection (C3/C6/H2) +#if (defined(ARDUINO_ARCH_ESP32) || defined(ESP_PLATFORM)) && (defined(__riscv) || defined(__riscv__)) + #define HAL_IS_ESP32_RISCV 1 +#else + #define HAL_IS_ESP32_RISCV 0 +#endif + +// ESP32 Xtensa detection (ESP32/S2/S3) +#if (defined(ARDUINO_ARCH_ESP32) || defined(ESP_PLATFORM)) && (defined(__XTENSA__) || defined(__xtensa__)) + #define HAL_IS_ESP32_XTENSA 1 +#else + #define HAL_IS_ESP32_XTENSA 0 +#endif + +// ---------------------------------------- +// Platform-specific fast tick source +// ---------------------------------------- + +// ---------- ESP32 Xtensa: CCOUNT ---------- +#if HAL_IS_ESP32_XTENSA + +static inline uint32_t IRAM_ATTR HAL_FAST_TICKS() { + uint32_t ccount; + __asm__ __volatile__("rsr %0, ccount" : "=a"(ccount)); + return ccount; +} + +static inline uint32_t HAL_TICKS_PER_SECOND() { return _halTicksPerSecond; } + +static inline void HAL_FAST_TICKS_INIT() { + #if defined(F_CPU) + _halTicksPerSecond = (uint32_t)F_CPU; + #else + _halTicksPerSecond = (uint32_t)ESP.getCpuFreqMHz() * 1000000UL; + #endif + _halTicksPerMicro = _halTicksPerSecond / 1000000UL; + if (_halTicksPerMicro == 0) _halTicksPerMicro = 1; +} + +// ---------- ESP8266: cycle count ---------- +#elif defined(ESP8266) + +static inline uint32_t IRAM_ATTR HAL_FAST_TICKS() { + return (uint32_t)ESP.getCycleCount(); +} + +static inline uint32_t HAL_TICKS_PER_SECOND() { return _halTicksPerSecond; } + +static inline void HAL_FAST_TICKS_INIT() { + #if defined(F_CPU) + _halTicksPerSecond = (uint32_t)F_CPU; // typically 80 or 160 MHz + #else + _halTicksPerSecond = 80000000UL; + #endif + _halTicksPerMicro = _halTicksPerSecond / 1000000UL; + if (_halTicksPerMicro == 0) _halTicksPerMicro = 1; +} + +// ---------- Teensy 3.x/4.x: DWT->CYCCNT ---------- +#elif HAL_IS_TEENSY + +static inline void HAL_FAST_TICKS_INIT() { + #if defined(DWT) && defined(CoreDebug) && defined(DWT_CTRL_CYCCNTENA_Msk) + CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk; + if ((DWT->CTRL & DWT_CTRL_CYCCNTENA_Msk) == 0) { + DWT->CYCCNT = 0; // optional but recommended + DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk; + __DSB(); __ISB(); + } + #if defined(F_CPU) + _halTicksPerSecond = (uint32_t)F_CPU; + #else + _halTicksPerSecond = 1000000UL; + #endif + #else + // fallback tick source is micros() + _halTicksPerSecond = 1000000UL; + #endif + + _halTicksPerMicro = _halTicksPerSecond / 1000000UL; + if (_halTicksPerMicro == 0) _halTicksPerMicro = 1; +} + +static inline uint32_t HAL_TICKS_PER_SECOND() { return _halTicksPerSecond; } + +static inline uint32_t IRAM_ATTR HAL_FAST_TICKS() { + #if defined(DWT) && defined(DWT_CTRL_CYCCNTENA_Msk) + return (uint32_t)DWT->CYCCNT; + #else + return (uint32_t)micros(); + #endif +} + +// - STM32H7: use DWT->CYCCNT (enable once). +// - Other STM32: use micros(). +#elif HAL_IS_STM32_H7 + +// Some STM32 cores expose these via CMSIS headers already included by Arduino.h. +// If not, you may need: #include "core_cm7.h" + +static inline void HAL_FAST_TICKS_INIT() { + // Ensure SystemCoreClock is up to date (harmless if already correct). + #if defined(SystemCoreClockUpdate) + SystemCoreClockUpdate(); + #endif + + // Enable DWT CYCCNT + #if defined(DWT) && defined(CoreDebug) && defined(DWT_CTRL_CYCCNTENA_Msk) && defined(CoreDebug_DEMCR_TRCENA_Msk) + // Enable tracing (required to access DWT on Cortex-M) + CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk; + + #if defined(DWT_LAR) + // DWT->LAR = 0xC5ACCE55; // unlock (if implemented) + #endif + + // Enable the cycle counter + if ((DWT->CTRL & DWT_CTRL_CYCCNTENA_Msk) == 0) { + DWT->CYCCNT = 0; + DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk; + __DSB(); __ISB(); + } + + // Tick frequency is core clock + #if defined(F_CPU) + _halTicksPerSecond = (uint32_t)F_CPU; + #elif defined(SystemCoreClock) + _halTicksPerSecond = (uint32_t)SystemCoreClock; + #else + _halTicksPerSecond = 1000000UL; // last-resort fallback + #endif + #else + // If DWT isn't available for some reason, fall back to micros(). + _halTicksPerSecond = 1000000UL; + #endif + + _halTicksPerMicro = _halTicksPerSecond / 1000000UL; + if (_halTicksPerMicro == 0) _halTicksPerMicro = 1; +} + +static inline uint32_t HAL_TICKS_PER_SECOND() { return _halTicksPerSecond; } + +static inline uint32_t IRAM_ATTR HAL_FAST_TICKS() { + #if defined(DWT) && defined(CoreDebug) && defined(DWT_CTRL_CYCCNTENA_Msk) && defined(CoreDebug_DEMCR_TRCENA_Msk) + return (uint32_t)DWT->CYCCNT; // 32-bit wraps naturally + #else + return (uint32_t)micros(); // fallback + #endif +} + +#else + +static inline void HAL_FAST_TICKS_INIT() { + _halTicksPerSecond = 1000000UL; + _halTicksPerMicro = 1; +} + +static inline uint32_t HAL_TICKS_PER_SECOND() { return _halTicksPerSecond; } + +static inline uint32_t IRAM_ATTR HAL_FAST_TICKS() { return (uint32_t)micros(); } + +#endif + +// ---------------------------------------- +// Helpers (non-ISR intent) +// ---------------------------------------- + +static inline uint32_t nanoseconds32() { + // rolls over ~4.29s when returning uint32_t + return (uint32_t)((uint64_t)HAL_FAST_TICKS() * 1000000000ULL / (uint64_t)HAL_TICKS_PER_SECOND()); +} + +static inline uint32_t halNsToTicks(uint32_t ns) { + // ticks = ns * (ticks/us) / 1000 + return (uint32_t)(((uint64_t)ns * (uint64_t)_halTicksPerMicro + 999ULL) / 1000ULL); +} + +#if !HAL_IS_TEENSY + static inline void delayNanoseconds(uint32_t ns) { + if (ns >= 20000UL) { + delayMicroseconds((ns + 999UL) / 1000UL); + return; + } + const uint32_t wait = halNsToTicks(ns); + if (wait == 0) return; + const uint32_t start = HAL_FAST_TICKS(); + while ((uint32_t)(HAL_FAST_TICKS() - start) < wait) { } + } +#endif diff --git a/src/HAL/arduinoM0/ArduinoM0.h b/src/HAL/arduinoM0/ArduinoM0.h new file mode 100755 index 0000000..7801921 --- /dev/null +++ b/src/HAL/arduinoM0/ArduinoM0.h @@ -0,0 +1,57 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more Teensy boards based on different lines are supported +#define __M0__ + +#include + +// Base rate for critical task timing +#define HAL_FRACTIONAL_SEC 100.0F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 // always use 2^n - 1, within the platform's limits +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 // always use 2^n - 1, within the platform's limits +#else + #error "Configuration (Config.h): ANALOG_WRITE_RANGE can't be changed on this platform" +#endif + +// Lower limit (fastest) step rate in us for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 40 +#define HAL_PULSE_WIDTH 900 // in ns, estimated + +// New symbol for the default I2C port --------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#if NV_DRIVER == NV_DEFAULT + // Library FlashStorage defaults to 1024 bytes https://github.com/cmaglie/FlashStorage + #define E2END 1023 + #undef NV_DRIVER + #define NV_DRIVER NV_M0 +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//---------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +//----------------------------------------------------------------------------------------------------- +// Misc. includes and defines to support this processor's operation + diff --git a/src/HAL/atmel/Mega2560.h b/src/HAL/atmel/Mega2560.h new file mode 100755 index 0000000..2e0fed8 --- /dev/null +++ b/src/HAL/atmel/Mega2560.h @@ -0,0 +1,68 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more Teensy boards based on different lines are supported +// __AVR__ + +// 1/100 second resolution +#define HAL_FRACTIONAL_SEC 100.0F + +// This platform has 8 bit PWM +#ifndef HAL_VCC + #define HAL_VCC 5.0F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#else + #error "Configuration (Config.h): ANALOG_WRITE_RANGE can't be changed on this platform" +#endif + +// This platform doesn't support true double precision math +#define HAL_NO_DOUBLE_PRECISION + +// This is for ~16MHz AVR processors or similar. +#define HAL_SLOW_PROCESSOR + +// Lower limit (fastest) step rate in us for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 76.8 +#define HAL_PULSE_WIDTH 10000 // in ns, estimated + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ---------------------------------------------------------------------------- +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_EEPROM +#endif + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + analogReference(DEFAULT); \ + HAL_FAST_TICKS_INIT(); \ +} + +#define HAL_RESET() mega2560restart(); +#define HAL_RESET_FUNC void (*mega2560restart) (void) = 0; + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + +#define strtof strtod // there is no strtof defined for the AVR platform diff --git a/src/HAL/atmel/Mega328.h b/src/HAL/atmel/Mega328.h new file mode 100755 index 0000000..1d43863 --- /dev/null +++ b/src/HAL/atmel/Mega328.h @@ -0,0 +1,63 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more Teensy boards based on different lines are supported +// __AVR__ + +// 1/100 second resolution +#define HAL_FRACTIONAL_SEC 100.0F + +// This platform has 8 bit PWM +#ifndef HAL_VCC + #define HAL_VCC 5.0F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 // always use 2^n - 1, within the platform's limits +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 // always use 2^n - 1, within the platform's limits +#else + #error "Configuration (Config.h): ANALOG_WRITE_RANGE can't be changed on this platform" +#endif + +// This platform doesn't support true double precision math +#define HAL_NO_DOUBLE_PRECISION + +// This is for ~16MHz AVR processors or similar. +#define HAL_SLOW_PROCESSOR + +// Lower limit (fastest) step rate in us for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 76.8 +#define HAL_PULSE_WIDTH 10000 // in ns, estimated + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ---------------------------------------------------------------------------- +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_EEPROM +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + analogReference(DEFAULT); \ + HAL_FAST_TICKS_INIT(); \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation diff --git a/src/HAL/default/Default.h b/src/HAL/default/Default.h new file mode 100755 index 0000000..a368774 --- /dev/null +++ b/src/HAL/default/Default.h @@ -0,0 +1,55 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more Platform_Name boards based on different lines are supported + +// Base rate for critical task timing +#define HAL_FRACTIONAL_SEC 100.0F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#else + #error "Configuration (Config.h): ANALOG_WRITE_RANGE can't be changed on this platform" +#endif + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#ifndef HAL_MAXRATE_LOWER_LIMIT + #define HAL_MAXRATE_LOWER_LIMIT 60 +#endif +#ifndef HAL_PULSE_WIDTH + #define HAL_PULSE_WIDTH 10000 // in ns, estimated +#endif + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ---------------------------------------------------------------------------- +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_EEPROM +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation diff --git a/src/HAL/esp/ESP32Libraries2.h b/src/HAL/esp/ESP32Libraries2.h new file mode 100755 index 0000000..76557a7 --- /dev/null +++ b/src/HAL/esp/ESP32Libraries2.h @@ -0,0 +1,96 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// This is for fast processors with hardware FP +#define HAL_FAST_PROCESSOR + +// Base rate for critical task timing (0.0095s = 0.14", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 105.2631579F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 // always use 2^n - 1, within the platform's limits +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 // always use 2^n - 1, within the platform's limits +#endif + +// analog read/write capabilities +#define HAL_HAS_PER_PIN_PWM_RESOLUTION 0 +#define HAL_HAS_PER_PIN_PWM_FREQUENCY 0 +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_PWM_FREQUENCY 1 +#define HAL_PWM_HZ_MAX 200000U + +#define HAL_HAS_GLOBAL_ADC_RESOLUTION 1 + +#define HAL_PWM_BITS_MAX 16 +#define HAL_ADC_BITS_MAX 12 + +// Lower limit (fastest) step rate in us for this platform (in SQW mode) and width of step pulse +#if CAN_PLUS != OFF + #define HAL_MAXRATE_LOWER_LIMIT 60 +#else + #define HAL_MAXRATE_LOWER_LIMIT 40 +#endif +#define HAL_PULSE_WIDTH 300 // in ns, measured 12/5/25 (ESP32 v2.0.17) + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ---------------------------------------------------------------------------- +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_ESP +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +// Correction for ESP32's internal temperture sensor +#ifndef INTERNAL_TEMP_CORRECTION + #define INTERNAL_TEMP_CORRECTION 0 +#endif +#define HAL_TEMP() ( temperatureRead() + INTERNAL_TEMP_CORRECTION ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL, optionally also early init of SERIAL_SIP/PIP or SERIAL_BT +#ifndef SERIAL_BT_MODE + #define SERIAL_BT_MODE OFF +#endif +#if SERIAL_BT_MODE != OFF + #include + extern BluetoothSerial bluetoothSerial; + #define SERIAL_BT bluetoothSerial +#endif +#if SERIAL_BT_MODE == SLAVE + #ifdef SERIAL_BT_PASSKEY + #define SERIAL_BT_BEGIN() if (strlen(SERIAL_BT_PASSKEY) != 0) SERIAL_BT.setPin(SERIAL_BT_PASSKEY); SERIAL_BT.begin(SERIAL_BT_NAME) + #else + #define SERIAL_BT_BEGIN() SERIAL_BT.begin(SERIAL_BT_NAME) + #endif +#else + #define SERIAL_BT_BEGIN() +#endif + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + SERIAL_BT_BEGIN(); \ + HAL_FAST_TICKS_INIT(); \ +} + +// MCU reset +#define HAL_RESET() ESP.restart() + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation diff --git a/src/HAL/esp/ESP32Libraries3.h b/src/HAL/esp/ESP32Libraries3.h new file mode 100755 index 0000000..7858f9a --- /dev/null +++ b/src/HAL/esp/ESP32Libraries3.h @@ -0,0 +1,98 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// This is for fast processors with hardware FP +#define HAL_FAST_PROCESSOR + +// Base rate for critical task timing (0.0095s = 0.14", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 105.2631579F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#else + #error "Configuration (Config.h): ANALOG_WRITE_RANGE can't be changed on this platform" +#endif + +// analog read/write capabilities +#define HAL_HAS_PER_PIN_PWM_RESOLUTION 0 +#define HAL_HAS_PER_PIN_PWM_FREQUENCY 0 +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_PWM_FREQUENCY 1 +#define HAL_PWM_HZ_MAX 200000U + +#define HAL_HAS_GLOBAL_ADC_RESOLUTION 1 + +#define HAL_PWM_BITS_MAX 16 +#define HAL_ADC_BITS_MAX 12 + +// Lower limit (fastest) step rate in us for this platform (in SQW mode) and width of step pulse +#if CAN_PLUS != OFF + #define HAL_MAXRATE_LOWER_LIMIT 60 +#else + #define HAL_MAXRATE_LOWER_LIMIT 40 +#endif +#define HAL_PULSE_WIDTH 200 // in ns, measured 1/18/22 (ESP32 v2.0.0) + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ---------------------------------------------------------------------------- +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_ESP +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +// Correction for ESP32's internal temperture sensor +#ifndef INTERNAL_TEMP_CORRECTION + #define INTERNAL_TEMP_CORRECTION 0 +#endif +#define HAL_TEMP() ( temperatureRead() + INTERNAL_TEMP_CORRECTION ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL, optionally also early init of SERIAL_SIP/PIP or SERIAL_BT +#ifndef SERIAL_BT_MODE + #define SERIAL_BT_MODE OFF +#endif +#if SERIAL_BT_MODE != OFF + #include + extern BluetoothSerial bluetoothSerial; + #define SERIAL_BT bluetoothSerial +#endif +#if SERIAL_BT_MODE == SLAVE + #ifdef SERIAL_BT_PASSKEY + #define SERIAL_BT_BEGIN() if (strlen(SERIAL_BT_PASSKEY) != 0) SERIAL_BT.setPin(SERIAL_BT_PASSKEY, strlen(SERIAL_BT_PASSKEY)); SERIAL_BT.begin(SERIAL_BT_NAME) + #else + #define SERIAL_BT_BEGIN() SERIAL_BT.begin(SERIAL_BT_NAME) + #endif +#else + #define SERIAL_BT_BEGIN() +#endif + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + SERIAL_BT_BEGIN(); \ + HAL_FAST_TICKS_INIT(); \ +} + +// MCU reset +#define HAL_RESET() ESP.restart() + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation diff --git a/src/HAL/esp/ESP32UnoR4WiFi.h b/src/HAL/esp/ESP32UnoR4WiFi.h new file mode 100755 index 0000000..d21bd43 --- /dev/null +++ b/src/HAL/esp/ESP32UnoR4WiFi.h @@ -0,0 +1,56 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// This is for fast processors with hardware FP +#define HAL_FAST_PROCESSOR + +// Base rate for critical task timing (0.0095s = 0.14", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 105.2631579F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// Lower limit (fastest) step rate in us for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 60 +#define HAL_PULSE_WIDTH 10000 // in ns, estimated + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ---------------------------------------------------------------------------- +#if NV_DRIVER == NV_DEFAULT + #define E2END 2047 + #undef NV_DRIVER + #define NV_DRIVER NV_EEPROM +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + HAL_FAST_TICKS_INIT(); \ +} + +// MCU reset +#define HAL_RESET() ESP.restart() + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation diff --git a/src/HAL/esp/ESP8266.h b/src/HAL/esp/ESP8266.h new file mode 100755 index 0000000..205b436 --- /dev/null +++ b/src/HAL/esp/ESP8266.h @@ -0,0 +1,51 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more Platform_Name boards based on different lines are supported + +// Base rate for critical task timing +#define HAL_FRACTIONAL_SEC 100.0F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// Lower limit (fastest) step rate in us for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 60 +#define HAL_PULSE_WIDTH 10000 // in ns, estimated + +// New symbol for the default I2C port --------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#if NV_DRIVER == NV_DEFAULT + #define E2END 1023 + #undef NV_DRIVER + #define NV_DRIVER NV_ESP +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +//----------------------------------------------------------------------------------------------------- +// Misc. includes and defines to support this processor's operation + +// MCU reset +#define HAL_RESET() ESP.restart() diff --git a/src/HAL/mbed/Rpi2040.h b/src/HAL/mbed/Rpi2040.h new file mode 100755 index 0000000..efa4d52 --- /dev/null +++ b/src/HAL/mbed/Rpi2040.h @@ -0,0 +1,52 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// 1/100 second resolution +#define HAL_FRACTIONAL_SEC 100.0F + +// This platform has 8 bit PWM +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 // always use 2^n - 1, within the platform's limits +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 // always use 2^n - 1, within the platform's limits +#else + #error "Configuration (Config.h): ANALOG_WRITE_RANGE can't be changed on this platform" +#endif + +// Lower limit (fastest) step rate in us for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 76.8 +#define HAL_PULSE_WIDTH 10000 // in ns, estimated + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ---------------------------------------------------------------------------- +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_AT24C32 +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +// MCU reset +#define HAL_RESET() (*((volatile uint32_t*)(PPB_BASE + 0x0ED0C))) = 0x5FA0004; + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation diff --git a/src/HAL/mbed/Rpi2350.h b/src/HAL/mbed/Rpi2350.h new file mode 100755 index 0000000..efa4d52 --- /dev/null +++ b/src/HAL/mbed/Rpi2350.h @@ -0,0 +1,52 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// 1/100 second resolution +#define HAL_FRACTIONAL_SEC 100.0F + +// This platform has 8 bit PWM +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 // always use 2^n - 1, within the platform's limits +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 // always use 2^n - 1, within the platform's limits +#else + #error "Configuration (Config.h): ANALOG_WRITE_RANGE can't be changed on this platform" +#endif + +// Lower limit (fastest) step rate in us for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 76.8 +#define HAL_PULSE_WIDTH 10000 // in ns, estimated + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ---------------------------------------------------------------------------- +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_AT24C32 +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +// MCU reset +#define HAL_RESET() (*((volatile uint32_t*)(PPB_BASE + 0x0ED0C))) = 0x5FA0004; + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation diff --git a/src/HAL/stm32/STM32F103.h b/src/HAL/stm32/STM32F103.h new file mode 100755 index 0000000..49cfa29 --- /dev/null +++ b/src/HAL/stm32/STM32F103.h @@ -0,0 +1,65 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more STM32 boards based on different lines are supported +#define __ARM_STM32__ + +// Base rate for critical task timing (0.0095s = 0.14", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 105.2631579F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 34 // assumes optimization set to Fastest (-O3) +#define HAL_PULSE_WIDTH 900 // in ns, estimated + +#include + +// Interrupts +#define cli() noInterrupts() +#define sei() interrupts() + +// New symbol for the default I2C port --------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#undef E2END +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_AT24C32 +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL +#define HAL_INIT() { \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + +// always bring in the software serial library early as strange things happen otherwise +#include + +// MCU reset +#define HAL_RESET() NVIC_SystemReset() diff --git a/src/HAL/stm32/STM32F303.h b/src/HAL/stm32/STM32F303.h new file mode 100755 index 0000000..7a67b7e --- /dev/null +++ b/src/HAL/stm32/STM32F303.h @@ -0,0 +1,67 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more STM32 boards based on different lines are supported +#define __ARM_STM32__ + +#define HAL_FAST_PROCESSOR + +// Base rate for critical task timing (0.0057s = 0.09", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 175.4385965F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 20 // assumes optimization set to Fastest (-O3) +#define HAL_PULSE_WIDTH 450 // in ns, estimated + +#include + +// Interrupts +#define cli() noInterrupts() +#define sei() interrupts() + +// New symbol for the default I2C port --------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#undef E2END +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_AT24C32 +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL +#define HAL_INIT() { \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + +// always bring in the software serial library early as strange things happen otherwise +#include + +// MCU reset +#define HAL_RESET() NVIC_SystemReset() diff --git a/src/HAL/stm32/STM32F407.h b/src/HAL/stm32/STM32F407.h new file mode 100755 index 0000000..019a1e9 --- /dev/null +++ b/src/HAL/stm32/STM32F407.h @@ -0,0 +1,75 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more STM32 boards based on different lines are supported +#define __ARM_STM32__ + +// Base rate for critical task timing (0.0038s = 0.06", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 263.1578947F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// STM32 Arduino cores (F4 + H7): +// assume global resolution functions exist; per-pin freq/res is not generic. +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_ADC_RESOLUTION 1 + +#define HAL_PWM_BITS_MAX 16 + +// F4 ADC is 12-bit; H7 can be higher, but core support varies. +// Default to 12 and let advanced HAL override to 16 for known-good H7 setup. +#define HAL_ADC_BITS_MAX 12 + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#define HAL_FAST_PROCESSOR +#define HAL_MAXRATE_LOWER_LIMIT 14 // assumes optimization set to Fastest (-O3) +#define HAL_PULSE_WIDTH 250 // in ns, estimated + +#include + +// Interrupts +#define cli() noInterrupts() +#define sei() interrupts() + +// New symbol for the default I2C port --------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +// no HAL_WIRE_CLOCK, it breaks the STM32 library + +// Non-volatile storage ------------------------------------------------------------------------------ +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_AT24C32 +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL +#define HAL_INIT() { \ + HAL_WIRE.setSDA(PB7); \ + HAL_WIRE.setSCL(PB6); \ +} +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + +// always bring in the software serial library early as strange things happen otherwise +#include + +// MCU reset +#define HAL_RESET() NVIC_SystemReset() diff --git a/src/HAL/stm32/STM32F446.h b/src/HAL/stm32/STM32F446.h new file mode 100755 index 0000000..c68c6a3 --- /dev/null +++ b/src/HAL/stm32/STM32F446.h @@ -0,0 +1,86 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more STM32 boards based on different lines are supported +#define __ARM_STM32__ + +// Base rate for critical task timing (0.0038s = 0.06", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 263.1578947F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// STM32 Arduino cores (F4 + H7): +// assume global resolution functions exist; per-pin freq/res is not generic. +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_ADC_RESOLUTION 1 + +#define HAL_PWM_BITS_MAX 16 + +// F4 ADC is 12-bit; H7 can be higher, but core support varies. +// Default to 12 and let advanced HAL override to 16 for known-good H7 setup. +#define HAL_ADC_BITS_MAX 12 + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#define HAL_FAST_PROCESSOR +#define HAL_MAXRATE_LOWER_LIMIT 14 // assumes optimization set to Fastest (-O3) +#define HAL_PULSE_WIDTH 250 // in ns, estimated + +#include + +// Interrupts +#define cli() noInterrupts() +#define sei() interrupts() + +// New symbol for the default I2C port --------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#undef E2END +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #if PINMAP == FYSETC_S6_2 + // The FYSETC S6 v2 has a 4096 byte EEPROM built-in + #define NV_DRIVER NV_2432 + #elif PINMAP == FYSETC_S6 + // The FYSETC S6 has a 2048 byte EEPROM built-in + #define NV_DRIVER NV_2416 + #else + // Fallback to the EEPROM present on an ZS-042 module + #define NV_DRIVER NV_AT24C32 + #endif +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL +#define HAL_INIT() { \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + +// always bring in the software serial library early as strange things happen otherwise +#include + +// MCU reset +#define HAL_RESET() NVIC_SystemReset() diff --git a/src/HAL/stm32/STM32F4x1.h b/src/HAL/stm32/STM32F4x1.h new file mode 100755 index 0000000..405fc0e --- /dev/null +++ b/src/HAL/stm32/STM32F4x1.h @@ -0,0 +1,81 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more STM32 boards based on different lines are supported +#define __ARM_STM32__ + +#define HAL_FAST_PROCESSOR + +// Base rate for critical task timing (0.0057s = 0.09", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 175.4385965F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#ifdef STM32F401xC + #define HAL_MAXRATE_LOWER_LIMIT 20 // assumes optimization set to Fastest (-O3) + #define HAL_PULSE_WIDTH 300 // in ns, estimated +#elif STM32F411xE + #define HAL_MAXRATE_LOWER_LIMIT 20 // Lower limit (fastest) step rate in us (in SQW mode) assumes optimization set to Fastest (-O3) + #define HAL_PULSE_WIDTH 300 // in ns, estimated +#else + #define HAL_MAXRATE_LOWER_LIMIT 60 + #define HAL_PULSE_WIDTH 900 // in ns, estimated +#endif + +#include + +// Interrupts +#define cli() noInterrupts() +#define sei() interrupts() + +// New symbol for the default I2C port --------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#undef E2END +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #if PINMAP == MaxSTM3I + // The MaxPCB3I has an 8192 byte EEPROM built-in (rated for 5M write cycles) + #define NV_DRIVER NV_2464 + #else + // fall back to the DS3231/AT24C32 + #define NV_DRIVER NV_AT24C32 + #endif +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL +#define HAL_INIT() { \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + +// always bring in the software serial library early as strange things happen otherwise +#include + +// MCU reset +#define HAL_RESET() NVIC_SystemReset() diff --git a/src/HAL/stm32/STM32H7xx.h b/src/HAL/stm32/STM32H7xx.h new file mode 100755 index 0000000..a80a7e1 --- /dev/null +++ b/src/HAL/stm32/STM32H7xx.h @@ -0,0 +1,80 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more STM32 boards based on different lines are supported +#define __ARM_STM32__ + +// Base rate for critical task timing (0.0019s = 0.03", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 526.3157895F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#else + #error "Configuration (Config.h): ANALOG_READ_RANGE can't be changed on this platform" +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// STM32 Arduino cores (F4 + H7): +// assume global resolution functions exist; per-pin freq/res is not generic. +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_ADC_RESOLUTION 1 + +#define HAL_PWM_BITS_MAX 16 + +// F4 ADC is 12-bit; H7 can be higher, but core support varies. +// Default to 12 and let advanced HAL override to 16 for known-good H7 setup. +#ifndef HAL_ADC_BITS_MAX + #define HAL_ADC_BITS_MAX 12 +#endif + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 1.5 +#define HAL_PULSE_WIDTH 0 // effectively disable pulse mode +#define HAL_FAST_PROCESSOR +#define HAL_VFAST_PROCESSOR + +#include + +// Interrupts +#define cli() noInterrupts() +#define sei() interrupts() + +// New symbol for the default I2C port --------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#undef E2END +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_24256 +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( NAN ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL +#define HAL_INIT() { \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + +// always bring in the software serial library early as strange things happen otherwise +#include + +// MCU reset +#define HAL_RESET() NVIC_SystemReset() diff --git a/src/HAL/teensy/Teensy3.2.h b/src/HAL/teensy/Teensy3.2.h new file mode 100755 index 0000000..d38df79 --- /dev/null +++ b/src/HAL/teensy/Teensy3.2.h @@ -0,0 +1,82 @@ +// Platform setup ------------------------------------------------------------------------------------ +// Teensy3.0, 3.1, 3.2 +#pragma once + +// We define a more generic symbol, in case more Teensy boards based on different lines are supported +#define __TEENSYDUINO__ + +// This platform has digitalReadFast, digitalWriteFast, etc. +#define HAL_HAS_DIGITAL_FAST + +// Base rate for critical task timing (0.0076s = 0.11", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 131.5789474F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// analog read/write capabilities +#define HAL_HAS_PER_PIN_PWM_RESOLUTION 0 +#define HAL_HAS_PER_PIN_PWM_FREQUENCY 1 +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_PWM_FREQUENCY 0 +#define HAL_PWM_BITS_MAX 16 +#define HAL_PWM_HZ_MAX 200000U + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#if F_CPU >= 120000000 + #define HAL_MAXRATE_LOWER_LIMIT 10 + #define HAL_PULSE_WIDTH 400 // in ns, estimated +#elif F_CPU >= 96000000 + #define HAL_MAXRATE_LOWER_LIMIT 12 + #define HAL_PULSE_WIDTH 450 // in ns, estimated +#elif F_CPU >= 72000000 + #define HAL_MAXRATE_LOWER_LIMIT 14 + #define HAL_PULSE_WIDTH 500 // in ns, estimated +#else + #define HAL_MAXRATE_LOWER_LIMIT 28 + #define HAL_PULSE_WIDTH 750 // in ns, estimated +#endif + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_EEPROM +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define _Tpin 38 +#define HAL_TEMP() ( (-((analog.readV(_Tpin) - 0.719F)/0.001715F) + 25.0F ) ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + HAL_FAST_TICKS_INIT(); \ +} + +#define HAL_RESET() { \ + SCB_AIRCR = 0x05FA0004; \ + asm volatile ("dsb"); \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + diff --git a/src/HAL/teensy/Teensy3.5.h b/src/HAL/teensy/Teensy3.5.h new file mode 100755 index 0000000..6c8f1fd --- /dev/null +++ b/src/HAL/teensy/Teensy3.5.h @@ -0,0 +1,74 @@ +// Platform setup ---------------------------------------------------------------------------------- +// Teensy3.5 +#pragma once + +// We define a more generic symbol, in case more Teensy boards based on different lines are supported +#define __TEENSYDUINO__ + +// This platform has digitalReadFast, digitalWriteFast, etc. +#define HAL_HAS_DIGITAL_FAST + +// Turn on support for using DACs to output digital signals using Arduino standard commands +#define HAL_DAC_AS_DIGITAL + +// Base rate for critical task timing (0.0057s = 0.09", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 175.4385965F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// analog read/write capabilities +#define HAL_HAS_PER_PIN_PWM_RESOLUTION 0 +#define HAL_HAS_PER_PIN_PWM_FREQUENCY 1 +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_PWM_FREQUENCY 0 +#define HAL_PWM_BITS_MAX 16 +#define HAL_PWM_HZ_MAX 200000U + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 12 +#define HAL_PULSE_WIDTH 400 // in ns, measured 1/18/22 +#define HAL_FAST_PROCESSOR + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire1 +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ---------------------------------------------------------------------------- +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_EEPROM +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define _Tpin 70 +#define HAL_TEMP() ( (-(analog.readV(_Tpin)-0.719F)/0.001715F)+25.0F ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + HAL_FAST_TICKS_INIT(); \ +} + +#define HAL_RESET() { \ + SCB_AIRCR = 0x05FA0004; \ + asm volatile ("dsb"); \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation diff --git a/src/HAL/teensy/Teensy3.6.h b/src/HAL/teensy/Teensy3.6.h new file mode 100755 index 0000000..40bfab0 --- /dev/null +++ b/src/HAL/teensy/Teensy3.6.h @@ -0,0 +1,82 @@ +// Platform setup ------------------------------------------------------------------------------------ +// Teensy3.6 +#pragma once + +// We define a more generic symbol, in case more Teensy boards based on different lines are supported +#define __TEENSYDUINO__ + +// This platform has digitalReadFast, digitalWriteFast, etc. +#define HAL_HAS_DIGITAL_FAST + +// Turn on support for using DACs to output digital signals using Arduino standard commands +#define HAL_DAC_AS_DIGITAL + +// Base rate for critical task timing (0.0038s = 0.06", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 263.1578947F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// analog read/write capabilities +#define HAL_HAS_PER_PIN_PWM_RESOLUTION 0 +#define HAL_HAS_PER_PIN_PWM_FREQUENCY 1 +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_PWM_FREQUENCY 0 +#define HAL_PWM_BITS_MAX 16 +#define HAL_PWM_HZ_MAX 200000U + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#if F_CPU >= 240000000 + #define HAL_MAXRATE_LOWER_LIMIT 2 + #define HAL_PULSE_WIDTH 200 // in ns, estimated +#elif F_CPU >= 180000000 + #define HAL_MAXRATE_LOWER_LIMIT 2.6 + #define HAL_PULSE_WIDTH 300 // in ns, estimated +#else + #define HAL_MAXRATE_LOWER_LIMIT 4.8 + #define HAL_PULSE_WIDTH 400 // in ns, estimated +#endif +#define HAL_FAST_PROCESSOR + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire1 +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_EEPROM +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define _Tpin 70 +#define HAL_TEMP() ( (-(analog.readV(_Tpin)-0.719F)/0.001715F)+25.0F ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + HAL_FAST_TICKS_INIT(); \ +} + +#define HAL_RESET() { \ + SCB_AIRCR = 0x05FA0004; \ + asm volatile ("dsb"); \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation diff --git a/src/HAL/teensy/Teensy4.0.h b/src/HAL/teensy/Teensy4.0.h new file mode 100755 index 0000000..97cbcb3 --- /dev/null +++ b/src/HAL/teensy/Teensy4.0.h @@ -0,0 +1,77 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more Teensy boards based on different lines are supported +#define __TEENSYDUINO__ + +// This platform has digitalReadFast, digitalWriteFast, etc. +#define HAL_HAS_DIGITAL_FAST + +// Base rate for critical task timing (0.0019s = 0.03", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 526.3157895F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// analog read/write capabilities +#define HAL_HAS_PER_PIN_PWM_RESOLUTION 0 +#define HAL_HAS_PER_PIN_PWM_FREQUENCY 1 +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_PWM_FREQUENCY 0 +#define HAL_PWM_BITS_MAX 16 +#define HAL_PWM_HZ_MAX 200000U + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 1.5 +#define HAL_PULSE_WIDTH 0 // effectively disable pulse mode +#define HAL_FAST_PROCESSOR +#define HAL_VFAST_PROCESSOR + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_EEPROM +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( tempmonGetTemp() ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + HAL_FAST_TICKS_INIT(); \ +} + +#define HAL_RESET() { \ + SCB_AIRCR = 0x05FA0004; \ + asm volatile ("dsb"); \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + +#ifdef EmptyStr + #undef EmptyStr +#endif +#define EmptyStr "\1" + +#define CAT_ATTR PROGMEM diff --git a/src/HAL/teensy/Teensy4.1.h b/src/HAL/teensy/Teensy4.1.h new file mode 100755 index 0000000..97cbcb3 --- /dev/null +++ b/src/HAL/teensy/Teensy4.1.h @@ -0,0 +1,77 @@ +// Platform setup ------------------------------------------------------------------------------------ +#pragma once + +// We define a more generic symbol, in case more Teensy boards based on different lines are supported +#define __TEENSYDUINO__ + +// This platform has digitalReadFast, digitalWriteFast, etc. +#define HAL_HAS_DIGITAL_FAST + +// Base rate for critical task timing (0.0019s = 0.03", 0.2 sec/day) +#define HAL_FRACTIONAL_SEC 526.3157895F + +// Analog read and write +#ifndef HAL_VCC + #define HAL_VCC 3.3F +#endif +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +// analog read/write capabilities +#define HAL_HAS_PER_PIN_PWM_RESOLUTION 0 +#define HAL_HAS_PER_PIN_PWM_FREQUENCY 1 +#define HAL_HAS_GLOBAL_PWM_RESOLUTION 1 +#define HAL_HAS_GLOBAL_PWM_FREQUENCY 0 +#define HAL_PWM_BITS_MAX 16 +#define HAL_PWM_HZ_MAX 200000U + +// Lower limit (fastest) step rate in uS for this platform (in SQW mode) and width of step pulse +#define HAL_MAXRATE_LOWER_LIMIT 1.5 +#define HAL_PULSE_WIDTH 0 // effectively disable pulse mode +#define HAL_FAST_PROCESSOR +#define HAL_VFAST_PROCESSOR + +// New symbol for the default I2C port ------------------------------------------------------------- +#include +#ifndef HAL_WIRE + #define HAL_WIRE Wire +#endif +#ifndef HAL_WIRE_CLOCK + #define HAL_WIRE_CLOCK 100000 +#endif + +// Non-volatile storage ------------------------------------------------------------------------------ +#if NV_DRIVER == NV_DEFAULT + #undef NV_DRIVER + #define NV_DRIVER NV_EEPROM +#endif + +//-------------------------------------------------------------------------------------------------- +// Internal MCU temperature (in degrees C) +#define HAL_TEMP() ( tempmonGetTemp() ) + +//-------------------------------------------------------------------------------------------------- +// General purpose initialize for HAL + +#define HAL_INIT() { \ + HAL_FAST_TICKS_INIT(); \ +} + +#define HAL_RESET() { \ + SCB_AIRCR = 0x05FA0004; \ + asm volatile ("dsb"); \ +} + +//--------------------------------------------------------------------------------------------------- +// Misc. includes to support this processor's operation + +#ifdef EmptyStr + #undef EmptyStr +#endif +#define EmptyStr "\1" + +#define CAT_ATTR PROGMEM diff --git a/src/Validate.h b/src/Validate.h new file mode 100755 index 0000000..9610dc8 --- /dev/null +++ b/src/Validate.h @@ -0,0 +1,1466 @@ +// ------------------------------------------------------------------------------------------------- +// Validate configuration +#pragma once +#include "Common.h" + +#if !defined(FileVersionConfig) || FileVersionConfig != 6 // per FirmwareVersionConfig + #error "Configuration (Config.h): FileVersionConfig (Config.h version) must be 6 for this OnStep." +#endif + +// BACKWARDS COMPATABILITY ------------------------ +#ifdef AXIS3_SLEW_RATE_DESIRED + #warning "Configuration (Config.h): AXIS3_SLEW_RATE_DESIRED has been replaced with AXIS3_SLEW_RATE_BASE_DESIRED please update" + #define AXIS3_SLEW_RATE_BASE_DESIRED AXIS3_SLEW_RATE_DESIRED +#endif +#ifdef AXIS4_SLEW_RATE_DESIRED + #warning "Configuration (Config.h): AXIS4_SLEW_RATE_DESIRED has been replaced with AXIS4_SLEW_RATE_BASE_DESIRED please update" + #define AXIS4_SLEW_RATE_BASE_DESIRED AXIS4_SLEW_RATE_DESIRED +#endif +#ifdef AXIS5_SLEW_RATE_DESIRED + #warning "Configuration (Config.h): AXIS5_SLEW_RATE_DESIRED has been replaced with AXIS5_SLEW_RATE_BASE_DESIRED please update" + #define AXIS5_SLEW_RATE_BASE_DESIRED AXIS5_SLEW_RATE_DESIRED +#endif + +// GENERAL --------------------------------------- +#if defined(STEP_DIR_TMC_UART_PRESENT) && (!defined(SERIAL_TMC) || !defined(SERIAL_TMC_BAUD)) + #error "Configuration (Config.h): This PINMAP doesn't support TMC UART mode drivers" +#endif + +// TELESCOPE ------------------------------------- +#if PINMAP != OFF && (PINMAP < PINMAP_FIRST || PINMAP > PINMAP_LAST) + #error "Configuration (Config.h): PINMAP must be set to a valid board (from Constants.h) or OFF (for user pin defs in Config.h)" +#endif + +#if SERIAL_A_BAUD_DEFAULT != 9600 && SERIAL_A_BAUD_DEFAULT != 19200 && SERIAL_A_BAUD_DEFAULT != 38400 && \ + SERIAL_A_BAUD_DEFAULT != 57600 && SERIAL_A_BAUD_DEFAULT != 115200 && SERIAL_A_BAUD_DEFAULT != 230400 && \ + SERIAL_A_BAUD_DEFAULT != 460800 && SERIAL_A_BAUD_DEFAULT != 921600 && SERIAL_A_BAUD_DEFAULT != OFF + #warning "Configuration (Config.h): Setting SERIAL_A_BAUD_DEFAULT unknown, use 9600, 19200, 38400, 57600, 115200, 230400, 460800, or 921600 (baud.)" +#endif + +#if SERIAL_B_BAUD_DEFAULT != 9600 && SERIAL_B_BAUD_DEFAULT != 19200 && SERIAL_B_BAUD_DEFAULT != 38400 && \ + SERIAL_B_BAUD_DEFAULT != 57600 && SERIAL_B_BAUD_DEFAULT != 115200 && SERIAL_B_BAUD_DEFAULT != 230400 && \ + SERIAL_B_BAUD_DEFAULT != 460800 && SERIAL_B_BAUD_DEFAULT != 921600 && SERIAL_B_BAUD_DEFAULT != OFF + #warning "Configuration (Config.h): Setting SERIAL_B_BAUD_DEFAULT unknown, use OFF, 9600, 19200, 38400, 57600, 115200, 230400, 460800, or 921600 (baud.)" +#endif + +#if SERIAL_B_ESP_FLASHING != ON && SERIAL_B_ESP_FLASHING != OFF + #error "Configuration (Config.h): Setting SERIAL_B_ESP_FLASHING unknown, use OFF or ON." +#endif + +#if SERIAL_B_ESP_FLASHING == ON && SERIAL_B_BAUD_DEFAULT == OFF + #error "Configuration (Config.h): Setting SERIAL_B_ESP_FLASHING only supported if SERIAL_B_BAUD_DEFAULT is defined." +#endif + +#if SERIAL_B_ESP_FLASHING == ON && (ADDON_GPIO0_PIN == OFF || ADDON_RESET_PIN == OFF) + #error "Configuration (Config.h): Setting SERIAL_B_ESP_FLASHING only supported if ADDON_GPIO0_PIN and ADDON_RESET_PIN are defined." +#endif + +#if SERIAL_C_BAUD_DEFAULT != 9600 && SERIAL_C_BAUD_DEFAULT != 19200 && SERIAL_C_BAUD_DEFAULT != 38400 && \ + SERIAL_C_BAUD_DEFAULT != 57600 && SERIAL_C_BAUD_DEFAULT != 115200 && SERIAL_C_BAUD_DEFAULT != 230400 && \ + SERIAL_C_BAUD_DEFAULT != 460800 && SERIAL_C_BAUD_DEFAULT != 921600 && SERIAL_C_BAUD_DEFAULT != OFF + #warning "Configuration (Config.h): Setting SERIAL_C_BAUD_DEFAULT unknown, use OFF, 9600, 19200, 38400, 57600, 115200, 230400, 460800, or 921600 (baud.)" +#endif + +#if SERIAL_D_BAUD_DEFAULT != 9600 && SERIAL_D_BAUD_DEFAULT != 19200 && SERIAL_D_BAUD_DEFAULT != 38400 && \ + SERIAL_D_BAUD_DEFAULT != 57600 && SERIAL_D_BAUD_DEFAULT != 115200 && SERIAL_D_BAUD_DEFAULT != 230400 && \ + SERIAL_D_BAUD_DEFAULT != 460800 && SERIAL_D_BAUD_DEFAULT != 921600 && SERIAL_D_BAUD_DEFAULT != OFF + #warning "Configuration (Config.h): Setting SERIAL_D_BAUD_DEFAULT unknown, use OFF, 9600, 19200, 38400, 57600, 115200, 230400, 460800, or 921600 (baud.)" +#endif + +#if SERIAL_E_BAUD_DEFAULT != 9600 && SERIAL_E_BAUD_DEFAULT != 19200 && SERIAL_E_BAUD_DEFAULT != 38400 && \ + SERIAL_E_BAUD_DEFAULT != 57600 && SERIAL_E_BAUD_DEFAULT != 115200 && SERIAL_E_BAUD_DEFAULT != 230400 && \ + SERIAL_E_BAUD_DEFAULT != 460800 && SERIAL_E_BAUD_DEFAULT != 921600 && SERIAL_E_BAUD_DEFAULT != OFF + #warning "Configuration (Config.h): Setting SERIAL_E_BAUD_DEFAULT unknown, use OFF, 9600, 19200, 38400, 57600, 115200, 230400, 460800, or 921600 (baud.)" +#endif + +#if SERIAL_RADIO != OFF && SERIAL_RADIO != BLUETOOTH && SERIAL_RADIO != WIFI_ACCESS_POINT && SERIAL_RADIO != WIFI_STATION + #warning "Configuration (Config.h): Setting SERIAL_RADIO unknown, use OFF, BLUETOOTH, WIFI_ACCESS_POINT, or WIFI_STATION" +#endif + +#if STATUS_LED != OFF && STATUS_LED != ON + #error "Configuration (Config.h): Setting STATUS_LED unknown, use OFF or ON." +#endif + +#if RETICLE_LED_DEFAULT != OFF && (RETICLE_LED_DEFAULT < 0 || RETICLE_LED_DEFAULT > 255) + #error "Configuration (Config.h): Setting RETICLE_LED_DEFAULT unknown, use OFF or 0 to 255." +#endif + +#if RETICLE_LED_MEMORY != OFF && RETICLE_LED_MEMORY != ON + #error "Configuration (Config.h): Setting RETICLE_LED_MEMORY unknown, use OFF or ON." +#endif + +#if WEATHER != OFF && (WEATHER < WEATHER_FIRST || WEATHER > WEATHER_LAST) + #error "Configuration (Config.h): Setting WEATHER unknown, use OFF or valid WEATHER SENSOR (from Constants.h)" +#endif + +#if STEP_WAVE_FORM < STEP_WAVE_FORM_FIRST || STEP_WAVE_FORM > STEP_WAVE_FORM_LAST + #error "Configuration (Config.h): Setting STEP_WAVE_FORM unknown, use a valid STEP WAVE FORM (from Constants.h)" +#endif + +#if STEP_WAVE_FORM != SQUARE && (defined(ARDUINO_TEENSY40) || defined(ARDUINO_TEENSY41)) + #error "Configuration (Config.h): Setting STEP_WAVE_FORM SQUARE is required for the Teensy4.0 and 4.1" +#endif + +// MOUNT ----------------------------------------- + +#if (AXIS1_DRIVER_MODEL != OFF && AXIS2_DRIVER_MODEL == OFF) || \ + (AXIS1_DRIVER_MODEL == OFF && AXIS2_DRIVER_MODEL != OFF) + #error "Configuration (Config.h): Settings AXIS1_DRIVER_MODEL and AXIS2_DRIVER_MODEL must both be OFF or set to a valid DRIVER (from Constants.h)" +#endif + +// AXIS1 RA/AZM +#if AXIS1_DRIVER_MODEL != OFF && \ + (AXIS1_DRIVER_MODEL < STEP_DIR_DRIVER_FIRST || AXIS1_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) && \ + (AXIS1_DRIVER_MODEL < SERVO_DRIVER_FIRST || AXIS1_DRIVER_MODEL > SERVO_DRIVER_LAST) && \ + (AXIS1_DRIVER_MODEL < MOTOR_DRIVER_FIRST || AXIS1_DRIVER_MODEL > MOTOR_DRIVER_LAST) + #error "Configuration (Config.h): Setting AXIS1_DRIVER_MODEL unknown, use OFF or a valid DRIVER (from Constants.h)" +#endif + +#if AXIS1_DRIVER_STATUS != OFF && AXIS1_DRIVER_STATUS != ON && AXIS1_DRIVER_STATUS != HIGH && AXIS1_DRIVER_STATUS != LOW + #error "Configuration (Config.h): Setting AXIS1_DRIVER_STATUS unknown, use OFF or a valid driver status." +#endif + +#ifdef AXIS1_STEP_DIR_PRESENT + #if AXIS1_DRIVER_MICROSTEPS != OFF && (AXIS1_DRIVER_MICROSTEPS < 1 || AXIS1_DRIVER_MICROSTEPS > 256) + #error "Configuration (Config.h): Setting AXIS1_DRIVER_MICROSTEPS unknown, use OFF or a valid microstep setting (range 1 to 256x and supported by your driver/design.)" + #if AXIS1_DRIVER_MICROSTEPS != 1 && AXIS1_DRIVER_MICROSTEPS != 2 && AXIS1_DRIVER_MICROSTEPS != 4 && \ + AXIS1_DRIVER_MICROSTEPS != 8 && AXIS1_DRIVER_MICROSTEPS != 16 && AXIS1_DRIVER_MICROSTEPS != 32 && \ + AXIS1_DRIVER_MICROSTEPS != 64 && AXIS1_DRIVER_MICROSTEPS != 128 && AXIS1_DRIVER_MICROSTEPS != 256 + #warning "Configuration (Config.h): Setting AXIS1_DRIVER_MICROSTEPS has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS1_DRIVER_MICROSTEPS_GOTO != OFF && (AXIS1_DRIVER_MICROSTEPS_GOTO < 1 || AXIS1_DRIVER_MICROSTEPS_GOTO >= AXIS1_DRIVER_MICROSTEPS) + #error "Configuration (Config.h): Setting AXIS1_DRIVER_MICROSTEPS_GOTO unknown, use a valid microstep setting (range 1 to < AXIS1_DRIVER_MICROSTEPS and supported by your driver/design.)" + #if AXIS1_DRIVER_MICROSTEPS_GOTO != 1 && AXIS1_DRIVER_MICROSTEPS_GOTO != 2 && AXIS1_DRIVER_MICROSTEPS_GOTO != 4 && \ + AXIS1_DRIVER_MICROSTEPS_GOTO != 8 && AXIS1_DRIVER_MICROSTEPS_GOTO != 16 && AXIS1_DRIVER_MICROSTEPS_GOTO != 32 && \ + AXIS1_DRIVER_MICROSTEPS_GOTO != 64 && AXIS1_DRIVER_MICROSTEPS_GOTO != 128 && AXIS1_DRIVER_MICROSTEPS_GOTO != 256 + #warning "Configuration (Config.h): Setting AXIS1_DRIVER_MICROSTEPS_GOTO has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS1_DRIVER_MICROSTEPS == OFF && AXIS1_DRIVER_MICROSTEPS_GOTO != OFF + #error "Configuration (Config.h): Setting AXIS1_DRIVER_MICROSTEPS_GOTO can't be enabled without first enabling AXIS1_DRIVER_MICROSTEPS." + #endif + #if AXIS1_DRIVER_DECAY != OFF && (AXIS1_DRIVER_DECAY < DRIVER_DECAY_MODE_FIRST || AXIS1_DRIVER_DECAY > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS1_DRIVER_DECAY unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS1_DRIVER_DECAY_GOTO != OFF && (AXIS1_DRIVER_DECAY_GOTO < DRIVER_DECAY_MODE_FIRST || AXIS1_DRIVER_DECAY_GOTO > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS1_DRIVER_DECAY_GOTO unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS1_DRIVER_IRUN != OFF && (AXIS1_DRIVER_IRUN < 0 || AXIS1_DRIVER_IRUN > 3000) + #error "Configuration (Config.h): Setting AXIS1_DRIVER_IRUN unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS1_DRIVER_IHOLD != OFF && (AXIS1_DRIVER_IHOLD < 0 || AXIS1_DRIVER_IHOLD > 3000) + #error "Configuration (Config.h): Setting AXIS1_DRIVER_IHOLD unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS1_DRIVER_IGOTO != OFF && (AXIS1_DRIVER_IGOTO < 0 || AXIS1_DRIVER_IGOTO > 3000) + #error "Configuration (Config.h): Setting AXIS1_DRIVER_IGOTO unknown, use OFF or a value 0 to 3000 (mA.)" + #endif +#endif + +#ifdef AXIS1_SERVO_PRESENT + #if AXIS1_ENCODER < ENC_FIRST || AXIS1_ENCODER > ENC_LAST + #error "Configuration (Config.h): Setting AXIS1_ENCODER unknown, use a valid SERVO ENCODER (from Constants.h)" + #endif +#endif + +#if AXIS1_REVERSE != ON && AXIS1_REVERSE != OFF + #error "Configuration (Config.h): Setting AXIS1_REVERSE unknown, use OFF or ON." +#endif + +#if AXIS1_POWER_DOWN != ON && AXIS1_POWER_DOWN != OFF + #error "Configuration (Config.h): Setting AXIS1_POWER_DOWN unknown, use OFF or ON." +#endif + +#if AXIS1_SECTOR_GEAR != ON && AXIS1_SECTOR_GEAR != OFF + #error "Configuration (Config.h): Setting AXIS1_SECTOR_GEAR unknown, use OFF or ON." +#endif + +#if AXIS1_SECTOR_GEAR == ON + #if MOUNT_SUBTYPE != GEM && MOUNT_SUBTYPE != FORK + #error "Configuration (Config.h): Setting MOUNT_TYPE is not compatible with AXIS1_SECTOR_GEAR ON (from Constants.h)" + #endif + #if (AXIS1_SENSE_HOME) != OFF && (AXIS1_SENSE_HOME_OFFSET) != 0 + #error "Configuration (Config.h): Enabling AXIS1_SECTOR_GEAR and AXIS1_SENSE_HOME requires an AXIS1_SENSE_HOME_OFFSET of 0." + #endif + #if (AXIS2_SENSE_HOME) != OFF && AXIS2_TANGENT_ARM == OFF + #error "Configuration (Config.h): Enabling AXIS1_SECTOR_GEAR requires AXIS2_SENSE_HOME to be OFF (except for tangent arm Dec mounts.)" + #endif +#else + #if AXIS2_TANGENT_ARM == OFF && ((AXIS1_SENSE_HOME) == OFF && (AXIS2_SENSE_HOME) != OFF) + #error "Configuration (Config.h): Enabling AXIS2_SENSE_HOME requires enabling AXIS1_SENSE_HOME or AXIS2_TANGENT_ARM." + #endif + #if AXIS1_LIMIT_MIN < -360 || AXIS1_LIMIT_MIN > -90 + #error "Configuration (Config.h): Setting AXIS1_LIMIT_MIN unknown, use value in the range -90 to -360." + #endif + #if AXIS1_LIMIT_MAX < 90 || AXIS1_LIMIT_MAX > 360 + #error "Configuration (Config.h): Setting AXIS1_LIMIT_MAX unknown, use value in the range 90 to 360." + #endif +#endif + +#if (AXIS1_SENSE_HOME) != OFF && (AXIS1_SENSE_HOME) < 0 + #error "Configuration (Config.h): Setting AXIS1_SENSE_HOME unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS1_SENSE_LIMIT_MIN) != OFF && (AXIS1_SENSE_LIMIT_MIN) < 0 + #error "Configuration (Config.h): Setting AXIS1_SENSE_LIMIT_MIN unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS1_SENSE_LIMIT_MAX) != OFF && (AXIS1_SENSE_LIMIT_MAX) < 0 + #error "Configuration (Config.h): Setting AXIS1_SENSE_LIMIT_MAX unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +// AXIS2 DEC/ALT +#if AXIS2_DRIVER_MODEL != OFF && \ + (AXIS2_DRIVER_MODEL < STEP_DIR_DRIVER_FIRST || AXIS2_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) && \ + (AXIS2_DRIVER_MODEL < SERVO_DRIVER_FIRST || AXIS2_DRIVER_MODEL > SERVO_DRIVER_LAST) && \ + (AXIS2_DRIVER_MODEL < MOTOR_DRIVER_FIRST || AXIS2_DRIVER_MODEL > MOTOR_DRIVER_LAST) + #error "Configuration (Config.h): Setting AXIS2_DRIVER_MODEL unknown, use a valid DRIVER (from Constants.h)" +#endif + +#if AXIS2_DRIVER_STATUS != OFF && AXIS2_DRIVER_STATUS != ON && AXIS2_DRIVER_STATUS != HIGH && AXIS2_DRIVER_STATUS != LOW + #error "Configuration (Config.h): Setting AXIS2_DRIVER_STATUS unknown, use OFF or a valid driver status." +#endif + +#ifdef AXIS2_STEP_DIR_PRESENT + #if AXIS2_DRIVER_MICROSTEPS != OFF && (AXIS2_DRIVER_MICROSTEPS < 1 || AXIS2_DRIVER_MICROSTEPS > 256) + #error "Configuration (Config.h): Setting AXIS2_DRIVER_MICROSTEPS unknown, use OFF or a valid microstep setting (range 1 to 256x and supported by your driver/design.)" + #if AXIS2_DRIVER_MICROSTEPS != 1 && AXIS2_DRIVER_MICROSTEPS != 2 && AXIS2_DRIVER_MICROSTEPS != 4 && \ + AXIS2_DRIVER_MICROSTEPS != 8 && AXIS2_DRIVER_MICROSTEPS != 16 && AXIS2_DRIVER_MICROSTEPS != 32 && \ + AXIS2_DRIVER_MICROSTEPS != 64 && AXIS2_DRIVER_MICROSTEPS != 128 && AXIS2_DRIVER_MICROSTEPS != 256 + #warning "Configuration (Config.h): Setting AXIS2_DRIVER_MICROSTEPS has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS2_DRIVER_MICROSTEPS_GOTO != OFF && (AXIS2_DRIVER_MICROSTEPS_GOTO < 1 || AXIS2_DRIVER_MICROSTEPS_GOTO >= AXIS2_DRIVER_MICROSTEPS) + #error "Configuration (Config.h): Setting AXIS2_DRIVER_MICROSTEPS_GOTO unknown, use OFF or a valid microstep setting (range 1 to < AXIS2_DRIVER_MICROSTEPS and supported by your driver/design.)" + #if AXIS2_DRIVER_MICROSTEPS_GOTO != 1 && AXIS2_DRIVER_MICROSTEPS_GOTO != 2 && AXIS2_DRIVER_MICROSTEPS_GOTO != 4 && \ + AXIS2_DRIVER_MICROSTEPS_GOTO != 8 && AXIS2_DRIVER_MICROSTEPS_GOTO != 16 && AXIS2_DRIVER_MICROSTEPS_GOTO != 32 && \ + AXIS2_DRIVER_MICROSTEPS_GOTO != 64 && AXIS2_DRIVER_MICROSTEPS_GOTO != 128 && AXIS2_DRIVER_MICROSTEPS_GOTO != 256 + #warning "Configuration (Config.h): Setting AXIS2_DRIVER_MICROSTEPS_GOTO has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS2_DRIVER_MICROSTEPS == OFF && AXIS2_DRIVER_MICROSTEPS_GOTO != OFF + #error "Configuration (Config.h): Setting AXIS2_DRIVER_MICROSTEPS_GOTO can't be enabled without first enabling AXIS2_DRIVER_MICROSTEPS." + #endif + #if AXIS2_DRIVER_DECAY != OFF && (AXIS2_DRIVER_DECAY < DRIVER_DECAY_MODE_FIRST || AXIS2_DRIVER_DECAY > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS2_DRIVER_DECAY unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS2_DRIVER_DECAY_GOTO != OFF && (AXIS2_DRIVER_DECAY_GOTO < DRIVER_DECAY_MODE_FIRST || AXIS2_DRIVER_DECAY_GOTO > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS2_DRIVER_DECAY_GOTO unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS2_DRIVER_IRUN != OFF && (AXIS2_DRIVER_IRUN < 0 || AXIS2_DRIVER_IRUN > 3000) + #error "Configuration (Config.h): Setting AXIS2_DRIVER_IRUN unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS2_DRIVER_IHOLD != OFF && (AXIS2_DRIVER_IHOLD < 0 || AXIS2_DRIVER_IHOLD > 3000) + #error "Configuration (Config.h): Setting AXIS2_DRIVER_IHOLD unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS2_DRIVER_IGOTO != OFF && (AXIS2_DRIVER_IGOTO < 0 || AXIS2_DRIVER_IGOTO > 3000) + #error "Configuration (Config.h): Setting AXIS2_DRIVER_IGOTO unknown, use OFF or a value 0 to 3000 (mA.)" + #endif +#endif + +#ifdef AXIS2_SERVO_PRESENT + #if AXIS2_ENCODER < ENC_FIRST || AXIS2_ENCODER > ENC_LAST + #error "Configuration (Config.h): Setting AXIS2_ENCODER unknown, use a valid SERVO ENCODER (from Constants.h)" + #endif +#endif + +#if defined(AXIS1_SERVO_PRESENT) && \ + (AXIS1_ENCODER == AS37_H39B_B || AXIS1_ENCODER == JTW_24BIT || AXIS1_ENCODER == JTW_26BIT || AXIS1_ENCODER == LIKA_ASC85 || \ + (AXIS1_ENCODER == SERIAL_BRIDGE && SERIAL_ENCODER_ABSOLUTE == ON)) + #define HAS_ABSOLUTE_ENCODER_SERVO_AXIS1 +#endif + +#if defined(AXIS2_SERVO_PRESENT) && \ + (AXIS2_ENCODER == AS37_H39B_B || AXIS2_ENCODER == JTW_24BIT || AXIS2_ENCODER == JTW_26BIT || AXIS2_ENCODER == LIKA_ASC85 || \ + (AXIS2_ENCODER == SERIAL_BRIDGE && SERIAL_ENCODER_ABSOLUTE == ON)) + #define HAS_ABSOLUTE_ENCODER_SERVO_AXIS2 +#endif + +#if defined(HAS_ABSOLUTE_ENCODER_SERVO_AXIS1) && defined(HAS_ABSOLUTE_ENCODER_SERVO_AXIS2) + #define HAS_ABSOLUTE_ENCODER_SERVO +#endif + +#if AXIS1_DRIVER_MODEL == ODRIVE + #define AXIS1_HAS_ABSOLUTE_COORD_AUTHORITY ODRIVE_ABSOLUTE +#elif defined(HAS_ABSOLUTE_ENCODER_SERVO_AXIS1) + #define AXIS1_HAS_ABSOLUTE_COORD_AUTHORITY ON +#else + #define AXIS1_HAS_ABSOLUTE_COORD_AUTHORITY OFF +#endif + +#if AXIS2_DRIVER_MODEL == ODRIVE + #define AXIS2_HAS_ABSOLUTE_COORD_AUTHORITY ODRIVE_ABSOLUTE +#elif defined(HAS_ABSOLUTE_ENCODER_SERVO_AXIS2) + #define AXIS2_HAS_ABSOLUTE_COORD_AUTHORITY ON +#else + #define AXIS2_HAS_ABSOLUTE_COORD_AUTHORITY OFF +#endif + +#if (AXIS1_HAS_ABSOLUTE_COORD_AUTHORITY == ON && AXIS2_HAS_ABSOLUTE_COORD_AUTHORITY == OFF) || \ + (AXIS1_HAS_ABSOLUTE_COORD_AUTHORITY == OFF && AXIS2_HAS_ABSOLUTE_COORD_AUTHORITY == ON) + #error "Configuration (Config.h): Axes 1 and 2 must both use absolute coordinate authority or neither may use it." +#endif + +#if AXIS2_REVERSE != ON && AXIS2_REVERSE != OFF + #error "Configuration (Config.h): Setting AXIS2_REVERSE unknown, use OFF or ON." +#endif + +#if AXIS2_POWER_DOWN != ON && AXIS2_POWER_DOWN != OFF + #error "Configuration (Config.h): Setting AXIS2_POWER_DOWN unknown, use OFF or ON." +#endif + +#if AXIS2_LIMIT_MIN < -90 || AXIS2_LIMIT_MIN > 0 + #error "Configuration (Config.h): Setting AXIS2_LIMIT_MIN unknown, use value in the range -90 to 0." +#endif + +#if AXIS2_LIMIT_MAX < 0 || AXIS2_LIMIT_MAX > 90 + #error "Configuration (Config.h): Setting AXIS2_LIMIT_MAX unknown, use value in the range 0 to 90." +#endif + +#if (AXIS2_SENSE_HOME) != OFF && (AXIS2_SENSE_HOME) < 0 + #error "Configuration (Config.h): Setting AXIS2_SENSE_HOME unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS2_SENSE_LIMIT_MIN) != OFF && (AXIS2_SENSE_LIMIT_MIN) < 0 + #error "Configuration (Config.h): Setting AXIS2_SENSE_LIMIT_MIN unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS2_SENSE_LIMIT_MAX) != OFF && (AXIS2_SENSE_LIMIT_MAX) < 0 + #error "Configuration (Config.h): Setting AXIS2_SENSE_LIMIT_MAX unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if MOUNT_SUBTYPE < MOUNT_SUBTYPE_FIRST || MOUNT_SUBTYPE > MOUNT_SUBTYPE_LAST + #error "Configuration (Config.h): Setting MOUNT_TYPE unknown, use a valid MOUNT TYPE (from Constants.h)" +#endif + +#if AXIS2_TANGENT_ARM != ON && AXIS2_TANGENT_ARM != OFF + #error "Configuration (Config.h): Setting AXIS2_TANGENT_ARM unknown, use OFF or ON." +#endif + +#if AXIS2_TANGENT_ARM == ON + #if MOUNT_SUBTYPE != GEM && MOUNT_SUBTYPE != FORK + #error "Configuration (Config.h): Setting MOUNT_TYPE is not compatible with AXIS2_TANGENT_ARM ON (from Constants.h)" + #endif + #if (AXIS2_SENSE_HOME) != OFF && (AXIS2_SENSE_HOME_OFFSET) != 0 + #error "Configuration (Config.h): Enabling AXIS2_TANGENT_ARM and AXIS2_SENSE_HOME requires an AXIS2_SENSE_HOME_OFFSET of 0." + #endif + #if (AXIS1_SENSE_HOME) != OFF && AXIS1_SECTOR_GEAR == OFF + #error "Configuration (Config.h): Enabling AXIS2_TANGENT_ARM requires AXIS1_SENSE_HOME to be OFF (except for sector gear RA mounts.)" + #endif +#else + #if (AXIS2_SENSE_HOME) != OFF && (AXIS1_SENSE_HOME) == OFF + #error "Configuration (Config.h): Enabling AXIS2_SENSE_HOME requires enabling AXIS1_SENSE_HOME or AXIS2_TANGENT_ARM." + #endif +#endif + +#if AXIS2_TANGENT_ARM_CORRECTION != ON && AXIS2_TANGENT_ARM_CORRECTION != OFF + #error "Configuration (Config.h): Setting AXIS2_TANGENT_ARM_CORRECTION unknown, use OFF or ON." +#endif + +#if MOUNT_ALTERNATE_ORIENTATION != OFF && MOUNT_ALTERNATE_ORIENTATION != ON + #error "Configuration (Config.h): Setting MOUNT_ALTERNATE_ORIENTATION unknown, use ON or OFF" +#endif + +#if MOUNT_COORDS < MOUNT_COORDS_FIRST && MOUNT_COORDS > MOUNT_COORDS_LAST + #error "Configuration (Config.h): Setting MOUNT_COORDS unknown, use a valid MOUNT COORDS (from Constants.h)" +#endif + +#if MOUNT_COORDS_MEMORY != ON && MOUNT_COORDS_MEMORY != OFF + #error "Configuration (Config.h): Setting MOUNT_COORDS_MEMORY unknown, use ON or OFF" +#endif + +#if MOUNT_STARTUP_MODE < SA_STRICT || MOUNT_STARTUP_MODE > SA_PERMISSIVE + #error "Configuration (Config.h): Setting MOUNT_STARTUP_MODE unknown, use SA_STRICT, SA_AUTO, or SA_PERMISSIVE" +#endif + +#if NV_INIT_ERROR_REVOKES_AUTHORITY != ON && NV_INIT_ERROR_REVOKES_AUTHORITY != OFF + #error "Configuration (Config.h): Setting NV_INIT_ERROR_REVOKES_AUTHORITY unknown, use OFF or ON." +#endif + +#if MOUNT_ENABLE_IN_STANDBY != ON && MOUNT_ENABLE_IN_STANDBY != OFF + #error "Configuration (Config.h): Setting MOUNT_ENABLE_IN_STANDBY unknown, use ON or OFF" +#endif + +#if ALIGN_MAX_STARS != AUTO && (ALIGN_MAX_STARS < 1 && ALIGN_MAX_STARS > 9) + #error "Configuration (Config.h): Setting ALIGN_MAX_STARS unknown, use AUTO or a value from 1 to 9." +#endif + +// TIME AND LOCATION +#if TIME_LOCATION_SOURCE < TLS_FIRST && TIME_LOCATION_SOURCE > TLS_LAST + #error "Configuration (Config.h): Setting TIME_LOCATION_SOURCE unknown, use OFF or valid TIME LOCATION SOURCE (from Constants.h)" +#endif + +#if TIME_LOCATION_SOURCE_FALLBACK != OFF + #if (TIME_LOCATION_SOURCE_FALLBACK < TLS_FIRST && TIME_LOCATION_SOURCE_FALLBACK > TLS_LAST) || \ + TIME_LOCATION_SOURCE_FALLBACK == GPS || TIME_LOCATION_SOURCE_FALLBACK == NTP || \ + TIME_LOCATION_SOURCE_FALLBACK == TIME_LOCATION_SOURCE + #error "Configuration (Config.h): Setting TIME_LOCATION_SOURCE_FALLBACK unknown, use OFF or valid alternate TIME LOCATION SOURCE (except GPS or NTP, from Constants.h)" + #endif +#endif + +#if (TIME_LOCATION_PPS_SENSE) != OFF && \ + (TIME_LOCATION_PPS_SENSE) != LOW && \ + (TIME_LOCATION_PPS_SENSE) != HIGH && \ + (TIME_LOCATION_PPS_SENSE) != BOTH + #error "Configuration (Config.h): Setting TIME_LOCATION_PPS_SENSE unknown, use OFF or LOW or HIGH or BOTH." +#endif + +// USER FEEDBACK +#if STATUS_MOUNT_LED != ON && STATUS_MOUNT_LED != OFF + #error "Configuration (Config.h): Setting STATUS_MOUNT_LED unknown, use OFF or ON." +#endif + +#if STATUS_BUZZER != ON && STATUS_BUZZER != OFF && (STATUS_BUZZER < 100 || STATUS_BUZZER > 6000) + #error "Configuration (Config.h): Setting STATUS_BUZZER unknown, use OFF or ON or a value from 100 to 6000 (Hz.)" +#endif + +#if STATUS_BUZZER_DEFAULT != ON && STATUS_BUZZER_DEFAULT != OFF + #error "Configuration (Config.h): Setting STATUS_BUZZER_DEFAULT unknown, use OFF or ON." +#endif + +#if STATUS_BUZZER_MEMORY != ON && STATUS_BUZZER_MEMORY != OFF + #error "Configuration (Config.h): Setting STATUS_BUZZER_MEMORY unknown, use OFF or ON." +#endif + +// ST4 INTERFACE +#if ST4_INTERFACE != ON && ST4_INTERFACE != OFF + #error "Configuration (Config.h): Setting ST4_INTERFACE unknown, use OFF or ON." +#endif + +#if ST4_HAND_CONTROL != ON && ST4_HAND_CONTROL != OFF + #error "Configuration (Config.h): Setting ST4_HAND_CONTROL unknown, use OFF or ON." +#endif + +#if ST4_HAND_CONTROL_FOCUSER != ON && ST4_HAND_CONTROL_FOCUSER != OFF + #error "Configuration (Config.h): Setting ST4_HAND_CONTROL_FOCUSER unknown, use OFF or ON." +#endif + +// GUIDING +#if GUIDE_TIME_LIMIT < 0 || GUIDE_TIME_LIMIT > 120 + #error "Configuration (Config.h): Setting GUIDE_TIME_LIMIT unknown, use the value 0 to disable or 1 to 120 (seconds.)" +#endif + +#if GUIDE_DISABLE_BACKLASH != ON && GUIDE_DISABLE_BACKLASH != OFF + #error "Configuration (Config.h): Setting GUIDE_DISABLE_BACKLASH unknown, use OFF or ON." +#endif + +#if GUIDE_SEPARATE_PULSE_RATE != ON && GUIDE_SEPARATE_PULSE_RATE != OFF + #error "Configuration (Config.h): Setting GUIDE_SEPARATE_PULSE_RATE unknown, use OFF or ON." +#endif + +// SENSORS +#if (LIMIT_SENSE) != OFF && (LIMIT_SENSE) < 0 + #error "Configuration (Config.h): Setting LIMIT_SENSE unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +// PEC (max steps per degree 360000 * 360 degrees) +#if PEC_STEPS_PER_WORM_ROTATION < 0 || PEC_STEPS_PER_WORM_ROTATION > 129600000 + #error "Configuration (Config.h): Setting PEC_STEPS_PER_WORM_ROTATION unknown, use the value 0 to disable or 1 to 129600000 (steps.)" +#endif + +#if (PEC_SENSE) != OFF && (PEC_SENSE) < 0 + #error "Configuration (Config.h): Setting PEC_SENSE unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (PEC_BUFFER_SIZE_LIMIT != 0) && (PEC_BUFFER_SIZE_LIMIT < 61 && PEC_BUFFER_SIZE_LIMIT > 30000) + #error "Configuration (Config.h): Setting PEC_BUFFER_SIZE_LIMIT unknown, use the value 0 to disable or 61 to 30000 (seconds.)" +#endif + +// SLEWING BEHAVIOUR +#if GOTO_FEATURE != ON && GOTO_FEATURE != OFF + #error "Configuration (Config.h): Setting GOTO_FEATURE unknown, use OFF or ON." +#endif + +#if SLEW_RATE_MEMORY != ON && SLEW_RATE_MEMORY != OFF + #error "Configuration (Config.h): Setting SLEW_RATE_MEMORY unknown, use OFF or ON." +#endif + +// TRACKING BEHAVIOUR +#if TRACK_AUTOSTART != ON && TRACK_AUTOSTART != OFF + #error "Configuration (Config.h): Setting TRACK_AUTOSTART unknown, use OFF or ON." +#endif + +#if TRACK_COMPENSATION_DEFAULT != OFF && (TRACK_COMPENSATION_DEFAULT < COMPENSATED_TRACKING_FIRST || TRACK_COMPENSATION_DEFAULT > COMPENSATED_TRACKING_LAST) + #error "Configuration (Config.h): Setting TRACK_COMPENSATION_DEFAULT unknown, use OFF or REFRACTION or REFRACTION_DUAL or MODEL or MODEL_DUAL." +#endif + +#if TRACK_COMPENSATION_MEMORY != ON && TRACK_COMPENSATION_MEMORY != OFF + #error "Configuration (Config.h): Setting TRACK_COMPENSATION_MEMORY unknown, use OFF or ON." +#endif + +#if TRACK_BACKLASH_RATE < 2 && TRACK_BACKLASH_RATE > 100 + #error "Configuration (Config.h): Setting TRACK_BACKLASH_RATE unknown, use a value between 2 and 100 (x Sidereal.)" +#endif + +// GOTO_FEATURE CHECKS +#if GOTO_FEATURE == OFF && TRACK_BACKLASH_RATE > 20 + #error "Configuration (Config.h): Setting TRACK_BACKLASH_RATE must be <= 20 when GOTO_FEATURE is OFF." +#endif + +#if GOTO_FEATURE == OFF && (MOUNT_TYPE == GEM_TA || MOUNT_TYPE == GEM_TAC) + #error "Configuration (Config.h): Setting GEM_TA/GEM_TAC not available when GOTO_FEATURE is OFF." +#endif + +#if GOTO_FEATURE == OFF && (MOUNT_TYPE == FORK_TA || MOUNT_TYPE == FORK_TAC) + #error "Configuration (Config.h): Setting FORK_TA/FORK_TAC not available when GOTO_FEATURE is OFF." +#endif + +// PIER SIDE BEHAVIOUR +#if MFLIP_SKIP_HOME != ON && MFLIP_SKIP_HOME != OFF + #error "Configuration (Config.h): Setting MFLIP_SKIP_HOME unknown, use OFF or ON." +#endif + +#if MFLIP_PAUSE_HOME_DEFAULT != ON && MFLIP_PAUSE_HOME_DEFAULT != OFF + #error "Configuration (Config.h): Setting MFLIP_PAUSE_HOME_DEFAULT unknown, use OFF or ON." +#endif + +#if MFLIP_PAUSE_HOME_MEMORY != ON && MFLIP_PAUSE_HOME_MEMORY != OFF + #error "Configuration (Config.h): Setting MFLIP_PAUSE_HOME_MEMORY unknown, use OFF or ON." +#endif + +#if MFLIP_AUTOMATIC_DEFAULT != ON && MFLIP_AUTOMATIC_DEFAULT != OFF + #error "Configuration (Config.h): Setting MFLIP_AUTOMATIC_DEFAULT unknown, use OFF or ON." +#endif + +#if MFLIP_AUTOMATIC_MEMORY != ON && MFLIP_AUTOMATIC_MEMORY != OFF + #error "Configuration (Config.h): Setting MFLIP_AUTOMATIC_MEMORY unknown, use OFF or ON." +#endif + +#if PIER_SIDE_SYNC_CHANGE_SIDES != ON && PIER_SIDE_SYNC_CHANGE_SIDES != OFF + #error "Configuration (Config.h): Setting PIER_SIDE_SYNC_CHANGE_SIDES unknown, use OFF or ON." +#endif + +static_assert(AXIS1_LIMIT_SYNC == OFF || (AXIS1_LIMIT_SYNC >= 0 && AXIS1_LIMIT_SYNC <= 90), + "Configuration (Config.h): Setting AXIS1_LIMIT_SYNC unknown, use OFF or value in the range 0 to 90."); + +static_assert(AXIS2_LIMIT_SYNC == OFF || (AXIS2_LIMIT_SYNC >= 0 && AXIS2_LIMIT_SYNC <= 90), + "Configuration (Config.h): Setting AXIS2_LIMIT_SYNC unknown, use OFF or value in the range 0 to 90."); + +#if PIER_SIDE_SYNC_CHANGE_SIDES == ON + static_assert(AXIS1_LIMIT_SYNC == OFF && AXIS2_LIMIT_SYNC == OFF, + "Configuration (Config.h): Enabling AXIS1_LIMIT_SYNC or AXIS2_LIMIT_SYNC requires PIER_SIDE_SYNC_CHANGE_SIDES to be OFF."); +#endif + +#if PIER_SIDE_PREFERRED_DEFAULT < PIER_SIDE_FIRST && PIER_SIDE_PREFERRED_DEFAULT > PIER_SIDE_LAST + #error "Configuration (Config.h): Setting PIER_SIDE_PREFERRED_DEFAULT unknown, use EAST or WEST or BEST or AUTOMATIC." +#endif + +#if PIER_SIDE_PREFERRED_MEMORY != OFF && PIER_SIDE_PREFERRED_MEMORY != ON + #error "Configuration (Config.h): Setting PIER_SIDE_PREFERRED_MEMORY unknown, use ON or OFF." +#endif + +// PARKING BEHAVIOUR +#ifdef PARK_STRICT + #if PARK_STRICT == ON + #error "Configuration (Config.h): PARK_STRICT is obsolete. Remove it and use the startup authority / parking policy defaults instead." + #endif +#endif + +// ROTATOR --------------------------------------- + +// AXIS3 ROTATOR +#if AXIS3_DRIVER_MODEL != OFF && \ + (AXIS3_DRIVER_MODEL < STEP_DIR_DRIVER_FIRST || AXIS3_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) && \ + (AXIS3_DRIVER_MODEL < SERVO_DRIVER_FIRST || AXIS3_DRIVER_MODEL > SERVO_DRIVER_LAST) && \ + (AXIS3_DRIVER_MODEL < MOTOR_DRIVER_FIRST || AXIS3_DRIVER_MODEL > MOTOR_DRIVER_LAST) + #error "Configuration (Config.h): Setting AXIS3_DRIVER_MODEL unknown, use OFF or a valid DRIVER (from Constants.h)" +#endif + +#if AXIS3_DRIVER_STATUS != OFF && AXIS3_DRIVER_STATUS != ON && AXIS3_DRIVER_STATUS != HIGH && AXIS3_DRIVER_STATUS != LOW + #error "Configuration (Config.h): Setting AXIS3_DRIVER_STATUS unknown, use OFF or valid driver status." +#endif + +#ifdef AXIS3_STEP_DIR_PRESENT + #if AXIS3_DRIVER_MICROSTEPS != OFF && (AXIS3_DRIVER_MICROSTEPS < 1 || AXIS3_DRIVER_MICROSTEPS > 256) + #error "Configuration (Config.h): Setting AXIS3_DRIVER_MICROSTEPS unknown, use OFF or a valid microstep setting (range 1 to 256x and supported by your driver/design.)" + #if AXIS3_DRIVER_MICROSTEPS != 1 && AXIS3_DRIVER_MICROSTEPS != 2 && AXIS3_DRIVER_MICROSTEPS != 4 && \ + AXIS3_DRIVER_MICROSTEPS != 8 && AXIS3_DRIVER_MICROSTEPS != 16 && AXIS3_DRIVER_MICROSTEPS != 32 && \ + AXIS3_DRIVER_MICROSTEPS != 64 && AXIS3_DRIVER_MICROSTEPS != 128 && AXIS3_DRIVER_MICROSTEPS != 256 + #warning "Configuration (Config.h): Setting AXIS3_DRIVER_MICROSTEPS has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS3_DRIVER_MICROSTEPS_GOTO != OFF && (AXIS3_DRIVER_MICROSTEPS_GOTO < 1 || AXIS3_DRIVER_MICROSTEPS_GOTO >= AXIS3_DRIVER_MICROSTEPS) + #error "Configuration (Config.h): Setting AXIS3_DRIVER_MICROSTEPS_GOTO unknown, use OFF or a valid microstep setting (range 1 to < AXIS3_DRIVER_MICROSTEPS and supported by your driver/design.)" + #if AXIS3_DRIVER_MICROSTEPS_GOTO != 1 && AXIS3_DRIVER_MICROSTEPS_GOTO != 2 && AXIS3_DRIVER_MICROSTEPS_GOTO != 4 && \ + AXIS3_DRIVER_MICROSTEPS_GOTO != 8 && AXIS3_DRIVER_MICROSTEPS_GOTO != 16 && AXIS3_DRIVER_MICROSTEPS_GOTO != 32 && \ + AXIS3_DRIVER_MICROSTEPS_GOTO != 64 && AXIS3_DRIVER_MICROSTEPS_GOTO != 128 && AXIS3_DRIVER_MICROSTEPS_GOTO != 256 + #warning "Configuration (Config.h): Setting AXIS3_DRIVER_MICROSTEPS_GOTO has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS3_DRIVER_MICROSTEPS == OFF && AXIS3_DRIVER_MICROSTEPS_GOTO != OFF + #error "Configuration (Config.h): Setting AXIS3_DRIVER_MICROSTEPS_GOTO can't be enabled without first enabling AXIS3_DRIVER_MICROSTEPS." + #endif + #if AXIS3_DRIVER_DECAY != OFF && (AXIS3_DRIVER_DECAY < DRIVER_DECAY_MODE_FIRST || AXIS3_DRIVER_DECAY > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS3_DRIVER_DECAY unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS3_DRIVER_DECAY_GOTO != OFF && (AXIS3_DRIVER_DECAY_GOTO < DRIVER_DECAY_MODE_FIRST || AXIS3_DRIVER_DECAY_GOTO > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS3_DRIVER_DECAY_GOTO unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS3_DRIVER_IRUN != OFF && (AXIS3_DRIVER_IRUN < 0 || AXIS3_DRIVER_IRUN > 3000) + #error "Configuration (Config.h): Setting AXIS3_DRIVER_IRUN unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS3_DRIVER_IHOLD != OFF && (AXIS3_DRIVER_IHOLD < 0 || AXIS3_DRIVER_IHOLD > 3000) + #error "Configuration (Config.h): Setting AXIS3_DRIVER_IHOLD unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS3_DRIVER_IGOTO != OFF && (AXIS3_DRIVER_IGOTO < 0 || AXIS3_DRIVER_IGOTO > 3000) + #error "Configuration (Config.h): Setting AXIS3_DRIVER_IGOTO unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if (AXIS3_DRIVER_IRUN > 1000 || AXIS3_DRIVER_IHOLD > 1000 || AXIS3_DRIVER_IGOTO > 1000) + #warning "Configuration (Config.h): Setting AXIS3_DRIVER_IHOLD or _IRUN or _IGOTO > 1000 (mA) this Axis on many boards is not designed to operate at high current" + #endif +#endif + +#ifdef AXIS3_SERVO_PRESENT + #if AXIS3_ENCODER != OFF && (AXIS3_ENCODER < ENC_FIRST || AXIS3_ENCODER > ENC_LAST) + #error "Configuration (Config.h): Setting AXIS3_ENCODER unknown, use a valid SERVO ENCODER (from Constants.h)" + #endif +#endif + +#if AXIS3_REVERSE != ON && AXIS3_REVERSE != OFF + #error "Configuration (Config.h): Setting AXIS3_REVERSE unknown, use OFF or ON." +#endif + +#if AXIS3_POWER_DOWN != ON && AXIS3_POWER_DOWN != OFF + #error "Configuration (Config.h): Setting AXIS3_POWER_DOWN unknown, use OFF or ON." +#endif + +#if AXIS3_LIMIT_MIN < -360 || AXIS3_LIMIT_MIN > 0 + #error "Configuration (Config.h): Setting AXIS3_LIMIT_MIN unknown, use value in the range 0 to -360." +#endif + +#if AXIS3_LIMIT_MAX < 0 || AXIS3_LIMIT_MAX > 360 + #error "Configuration (Config.h): Setting AXIS3_LIMIT_MAX unknown, use value in the range 0 to 360." +#endif + +#if (AXIS3_SENSE_HOME) != OFF && (AXIS3_SENSE_HOME) < 0 + #error "Configuration (Config.h): Setting AXIS3_SENSE_HOME unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS3_SENSE_LIMIT_MIN) != OFF && (AXIS3_SENSE_LIMIT_MIN) < 0 + #error "Configuration (Config.h): Setting AXIS3_SENSE_LIMIT_MIN unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS3_SENSE_LIMIT_MAX) != OFF && (AXIS3_SENSE_LIMIT_MAX) < 0 + #error "Configuration (Config.h): Setting AXIS3_SENSE_LIMIT_MAX unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +// FOCUSER --------------------------------------- + +// AXIS4 FOCUSER +#if AXIS4_DRIVER_MODEL != OFF && \ + (AXIS4_DRIVER_MODEL < STEP_DIR_DRIVER_FIRST || AXIS4_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) && \ + (AXIS4_DRIVER_MODEL < SERVO_DRIVER_FIRST || AXIS4_DRIVER_MODEL > SERVO_DRIVER_LAST) && \ + (AXIS4_DRIVER_MODEL < MOTOR_DRIVER_FIRST || AXIS4_DRIVER_MODEL > MOTOR_DRIVER_LAST) + #error "Configuration (Config.h): Setting AXIS4_DRIVER_MODEL unknown, use OFF or a valid DRIVER (from Constants.h)" +#endif + +#if AXIS4_SLEW_RATE_MINIMUM < 5 || AXIS4_SLEW_RATE_MINIMUM > 200 + #error "Configuration (Config.h): Setting AXIS4_SLEW_RATE_MINIMUM out of range, use a value between 5 and 200" +#endif + +#if AXIS4_SLEW_RATE_BASE_DESIRED < 200 || AXIS4_SLEW_RATE_BASE_DESIRED > 5000 + #error "Configuration (Config.h): Setting AXIS4_SLEW_RATE_BASE_DESIRED out of range, use a value between 200 and 5000" +#endif + +#if AXIS4_DRIVER_STATUS != OFF && AXIS4_DRIVER_STATUS != ON && AXIS4_DRIVER_STATUS != HIGH && AXIS4_DRIVER_STATUS != LOW + #error "Configuration (Config.h): Setting AXIS4_DRIVER_STATUS unknown, use OFF or valid driver status." +#endif + +#if AXIS4_REVERSE != ON && AXIS4_REVERSE != OFF + #error "Configuration (Config.h): Setting AXIS4_REVERSE unknown, use OFF or ON." +#endif + +#if AXIS4_POWER_DOWN != ON && AXIS4_POWER_DOWN != OFF + #error "Configuration (Config.h): Setting AXIS4_POWER_DOWN unknown, use OFF or ON." +#endif +#if AXIS4_POWER_DOWN == ON && (AXIS4_ENABLE_PIN == OFF || AXIS4_ENABLE_PIN == SHARED) && \ + (AXIS4_DRIVER_MODEL < TMC_DRIVER_FIRST || AXIS4_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) + #error "Configuration (Config.h): AXIS4_POWER_DOWN requires a dedicated enable pin or a software-controlled step/dir TMC driver." +#endif + +#if AXIS4_LIMIT_MIN < 0 || AXIS4_LIMIT_MIN > 500 + #error "Configuration (Config.h): Setting AXIS4_LIMIT_MIN unknown, use value in the range 0 to 500 (mm.)" +#endif + +#if AXIS4_LIMIT_MAX < AXIS4_LIMIT_MIN || AXIS4_LIMIT_MAX > 500 + #error "Configuration (Config.h): Setting AXIS4_LIMIT_MAX unknown, use value in the range AXIS4_LIMIT_MIN to 500 (mm.)" +#endif + +#if AXIS4_HOME_DEFAULT != MINIMUM && AXIS4_HOME_DEFAULT != MIDDLE && AXIS4_HOME_DEFAULT != MAXIMUM && (AXIS4_HOME_DEFAULT < 0 || AXIS4_HOME_DEFAULT > 500000) + #error "Configuration (Config.h): Setting AXIS4_HOME_DEFAULT unknown, use MINIMUM (zero) or MIDDLE (half travel) or MAXIMUM (full travel) or the position in microns (0 to 500000.)" +#endif + +#if (AXIS4_SENSE_HOME) != OFF && (AXIS4_SENSE_HOME) < 0 + #error "Configuration (Config.h): Setting AXIS4_SENSE_HOME unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS4_SENSE_LIMIT_MIN) != OFF && (AXIS4_SENSE_LIMIT_MIN) < 0 + #error "Configuration (Config.h): Setting AXIS4_SENSE_LIMIT_MIN unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS4_SENSE_LIMIT_MAX) != OFF && (AXIS4_SENSE_LIMIT_MAX) < 0 + #error "Configuration (Config.h): Setting AXIS4_SENSE_LIMIT_MAX unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#ifdef AXIS4_STEP_DIR_PRESENT + #if AXIS4_DRIVER_MICROSTEPS != OFF && (AXIS4_DRIVER_MICROSTEPS < 1 || AXIS4_DRIVER_MICROSTEPS > 256) + #error "Configuration (Config.h): Setting AXIS4_DRIVER_MICROSTEPS unknown, use OFF or a valid microstep setting (range 1 to 256x and supported by your driver/design.)" + #if AXIS4_DRIVER_MICROSTEPS != 1 && AXIS4_DRIVER_MICROSTEPS != 2 && AXIS4_DRIVER_MICROSTEPS != 4 && \ + AXIS4_DRIVER_MICROSTEPS != 8 && AXIS4_DRIVER_MICROSTEPS != 16 && AXIS4_DRIVER_MICROSTEPS != 32 && \ + AXIS4_DRIVER_MICROSTEPS != 64 && AXIS4_DRIVER_MICROSTEPS != 128 && AXIS4_DRIVER_MICROSTEPS != 256 + #warning "Configuration (Config.h): Setting AXIS4_DRIVER_MICROSTEPS has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS4_DRIVER_MICROSTEPS_GOTO != OFF && (AXIS4_DRIVER_MICROSTEPS_GOTO < 1 || AXIS4_DRIVER_MICROSTEPS_GOTO >= AXIS4_DRIVER_MICROSTEPS) + #error "Configuration (Config.h): Setting AXIS4_DRIVER_MICROSTEPS_GOTO unknown, use OFF or a valid microstep setting (range 1 to < AXIS4_DRIVER_MICROSTEPS and supported by your driver/design.)" + #if AXIS4_DRIVER_MICROSTEPS_GOTO != 1 && AXIS4_DRIVER_MICROSTEPS_GOTO != 2 && AXIS4_DRIVER_MICROSTEPS_GOTO != 4 && \ + AXIS4_DRIVER_MICROSTEPS_GOTO != 8 && AXIS4_DRIVER_MICROSTEPS_GOTO != 16 && AXIS4_DRIVER_MICROSTEPS_GOTO != 32 && \ + AXIS4_DRIVER_MICROSTEPS_GOTO != 64 && AXIS4_DRIVER_MICROSTEPS_GOTO != 128 && AXIS4_DRIVER_MICROSTEPS_GOTO != 256 + #warning "Configuration (Config.h): Setting AXIS4_DRIVER_MICROSTEPS_GOTO has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS4_DRIVER_MICROSTEPS == OFF && AXIS4_DRIVER_MICROSTEPS_GOTO != OFF + #error "Configuration (Config.h): Setting AXIS4_DRIVER_MICROSTEPS_GOTO can't be enabled without first enabling AXIS4_DRIVER_MICROSTEPS." + #endif + #if AXIS4_DRIVER_DECAY != OFF && (AXIS4_DRIVER_DECAY < DRIVER_DECAY_MODE_FIRST || AXIS4_DRIVER_DECAY > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS4_DRIVER_DECAY unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS4_DRIVER_DECAY_GOTO != OFF && (AXIS4_DRIVER_DECAY_GOTO < DRIVER_DECAY_MODE_FIRST || AXIS4_DRIVER_DECAY_GOTO > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS4_DRIVER_DECAY_GOTO unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS4_DRIVER_IRUN != OFF && (AXIS4_DRIVER_IRUN < 0 || AXIS4_DRIVER_IRUN > 3000) + #error "Configuration (Config.h): Setting AXIS4_DRIVER_IRUN unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS4_DRIVER_IHOLD != OFF && (AXIS4_DRIVER_IHOLD < 0 || AXIS4_DRIVER_IHOLD > 3000) + #error "Configuration (Config.h): Setting AXIS4_DRIVER_IHOLD unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS4_DRIVER_IGOTO != OFF && (AXIS4_DRIVER_IGOTO < 0 || AXIS4_DRIVER_IGOTO > 3000) + #error "Configuration (Config.h): Setting AXIS4_DRIVER_IGOTO unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if (AXIS4_DRIVER_IRUN > 1000 || AXIS4_DRIVER_IHOLD > 1000 || AXIS4_DRIVER_IGOTO > 1000) + #warning "Configuration (Config.h): Setting AXIS4_DRIVER_IHOLD or _IRUN or _IGOTO > 1000 (mA) this Axis on many boards is not designed to operate at high current" + #endif +#endif + +#ifdef AXIS4_SERVO_PRESENT + #if AXIS4_ENCODER < ENC_FIRST || AXIS4_ENCODER > ENC_LAST + #error "Configuration (Config.h): Setting AXIS4_ENCODER unknown, use a valid SERVO ENCODER (from Constants.h)" + #endif +#endif + +// AXIS5 FOCUSER +#if AXIS5_DRIVER_MODEL != OFF && \ + (AXIS5_DRIVER_MODEL < STEP_DIR_DRIVER_FIRST || AXIS5_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) && \ + (AXIS5_DRIVER_MODEL < SERVO_DRIVER_FIRST || AXIS5_DRIVER_MODEL > SERVO_DRIVER_LAST) && \ + (AXIS5_DRIVER_MODEL < MOTOR_DRIVER_FIRST || AXIS5_DRIVER_MODEL > MOTOR_DRIVER_LAST) + #error "Configuration (Config.h): Setting AXIS5_DRIVER_MODEL unknown, use OFF or a valid DRIVER (from Constants.h)" +#endif + +#if AXIS5_SLEW_RATE_MINIMUM < 5 || AXIS5_SLEW_RATE_MINIMUM > 200 + #error "Configuration (Config.h): Setting AXIS5_SLEW_RATE_MINIMUM out of range, use a value between 5 and 200" +#endif + +#if AXIS5_SLEW_RATE_BASE_DESIRED < 200 || AXIS5_SLEW_RATE_BASE_DESIRED > 5000 + #error "Configuration (Config.h): Setting AXIS5_SLEW_RATE_BASE_DESIRED out of range, use a value between 200 and 5000" +#endif + +#if AXIS5_DRIVER_STATUS != OFF && AXIS5_DRIVER_STATUS != ON && AXIS5_DRIVER_STATUS != HIGH && AXIS5_DRIVER_STATUS != LOW + #error "Configuration (Config.h): Setting AXIS5_DRIVER_STATUS unknown, use OFF or valid driver status." +#endif + +#if AXIS5_REVERSE != ON && AXIS5_REVERSE != OFF + #error "Configuration (Config.h): Setting AXIS5_REVERSE unknown, use OFF or ON." +#endif + +#if AXIS5_POWER_DOWN != ON && AXIS5_POWER_DOWN != OFF + #error "Configuration (Config.h): Setting AXIS5_POWER_DOWN unknown, use OFF or ON." +#endif +#if AXIS5_POWER_DOWN == ON && (AXIS5_ENABLE_PIN == OFF || AXIS5_ENABLE_PIN == SHARED) && \ + (AXIS5_DRIVER_MODEL < TMC_DRIVER_FIRST || AXIS5_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) + #error "Configuration (Config.h): AXIS5_POWER_DOWN requires a dedicated enable pin or a software-controlled step/dir TMC driver." +#endif + +#if AXIS5_LIMIT_MIN < 0 || AXIS5_LIMIT_MIN > 500 + #error "Configuration (Config.h): Setting AXIS5_LIMIT_MIN unknown, use value in the range 0 to 500 (mm.)" +#endif + +#if AXIS5_LIMIT_MAX < AXIS5_LIMIT_MIN || AXIS5_LIMIT_MAX > 500 + #error "Configuration (Config.h): Setting AXIS5_LIMIT_MAX unknown, use value in the range AXIS5_LIMIT_MIN to 500 (mm.)" +#endif + +#if AXIS5_HOME_DEFAULT != MINIMUM && AXIS5_HOME_DEFAULT != MIDDLE && AXIS5_HOME_DEFAULT != MAXIMUM && (AXIS5_HOME_DEFAULT < 0 || AXIS5_HOME_DEFAULT > 500000) + #error "Configuration (Config.h): Setting AXIS5_HOME_DEFAULT unknown, use MINIMUM (zero) or MIDDLE (half travel) or MAXIMUM (full travel) or the position in microns (0 to 500000.)" +#endif + +#if (AXIS5_SENSE_HOME) != OFF && (AXIS5_SENSE_HOME) < 0 + #error "Configuration (Config.h): Setting AXIS5_SENSE_HOME unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS5_SENSE_LIMIT_MIN) != OFF && (AXIS5_SENSE_LIMIT_MIN) < 0 + #error "Configuration (Config.h): Setting AXIS5_SENSE_LIMIT_MIN unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS5_SENSE_LIMIT_MAX) != OFF && (AXIS5_SENSE_LIMIT_MAX) < 0 + #error "Configuration (Config.h): Setting AXIS5_SENSE_LIMIT_MAX unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#ifdef AXIS5_STEP_DIR_PRESENT + #if AXIS5_DRIVER_MICROSTEPS != OFF && (AXIS5_DRIVER_MICROSTEPS < 1 || AXIS5_DRIVER_MICROSTEPS > 256) + #error "Configuration (Config.h): Setting AXIS5_DRIVER_MICROSTEPS unknown, use OFF or a valid microstep setting (range 1 to 256x and supported by your driver/design.)" + #if AXIS5_DRIVER_MICROSTEPS != 1 && AXIS5_DRIVER_MICROSTEPS != 2 && AXIS5_DRIVER_MICROSTEPS != 4 && \ + AXIS5_DRIVER_MICROSTEPS != 8 && AXIS5_DRIVER_MICROSTEPS != 16 && AXIS5_DRIVER_MICROSTEPS != 32 && \ + AXIS5_DRIVER_MICROSTEPS != 64 && AXIS5_DRIVER_MICROSTEPS != 128 && AXIS5_DRIVER_MICROSTEPS != 256 + #warning "Configuration (Config.h): Setting AXIS5_DRIVER_MICROSTEPS has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS5_DRIVER_MICROSTEPS_GOTO != OFF && (AXIS5_DRIVER_MICROSTEPS_GOTO < 1 || AXIS5_DRIVER_MICROSTEPS_GOTO >= AXIS5_DRIVER_MICROSTEPS) + #error "Configuration (Config.h): Setting AXIS5_DRIVER_MICROSTEPS_GOTO unknown, use OFF or a valid microstep setting (range 1 to < AXIS5_DRIVER_MICROSTEPS and supported by your driver/design.)" + #if AXIS5_DRIVER_MICROSTEPS_GOTO != 1 && AXIS5_DRIVER_MICROSTEPS_GOTO != 2 && AXIS5_DRIVER_MICROSTEPS_GOTO != 4 && \ + AXIS5_DRIVER_MICROSTEPS_GOTO != 8 && AXIS5_DRIVER_MICROSTEPS_GOTO != 16 && AXIS5_DRIVER_MICROSTEPS_GOTO != 32 && \ + AXIS5_DRIVER_MICROSTEPS_GOTO != 64 && AXIS5_DRIVER_MICROSTEPS_GOTO != 128 && AXIS5_DRIVER_MICROSTEPS_GOTO != 256 + #warning "Configuration (Config.h): Setting AXIS5_DRIVER_MICROSTEPS_GOTO has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS5_DRIVER_MICROSTEPS == OFF && AXIS5_DRIVER_MICROSTEPS_GOTO != OFF + #error "Configuration (Config.h): Setting AXIS5_DRIVER_MICROSTEPS_GOTO can't be enabled without first enabling AXIS5_DRIVER_MICROSTEPS." + #endif + #if AXIS5_DRIVER_DECAY != OFF && (AXIS5_DRIVER_DECAY < DRIVER_DECAY_MODE_FIRST || AXIS5_DRIVER_DECAY > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS5_DRIVER_DECAY unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS5_DRIVER_DECAY_GOTO != OFF && (AXIS5_DRIVER_DECAY_GOTO < DRIVER_DECAY_MODE_FIRST || AXIS5_DRIVER_DECAY_GOTO > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS5_DRIVER_DECAY_GOTO unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS5_DRIVER_IRUN != OFF && (AXIS5_DRIVER_IRUN < 0 || AXIS5_DRIVER_IRUN > 3000) + #error "Configuration (Config.h): Setting AXIS5_DRIVER_IRUN unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS5_DRIVER_IHOLD != OFF && (AXIS5_DRIVER_IHOLD < 0 || AXIS5_DRIVER_IHOLD > 3000) + #error "Configuration (Config.h): Setting AXIS5_DRIVER_IHOLD unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS5_DRIVER_IGOTO != OFF && (AXIS5_DRIVER_IGOTO < 0 || AXIS5_DRIVER_IGOTO > 3000) + #error "Configuration (Config.h): Setting AXIS5_DRIVER_IGOTO unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if (AXIS5_DRIVER_IRUN > 1000 || AXIS5_DRIVER_IHOLD > 1000 || AXIS5_DRIVER_IGOTO > 1000) + #warning "Configuration (Config.h): Setting AXIS5_DRIVER_IHOLD or _IRUN or _IGOTO > 1000 (mA) this Axis on many boards is not designed to operate at high current" + #endif +#endif + +#ifdef AXIS5_SERVO_PRESENT + #if AXIS5_ENCODER < ENC_FIRST || AXIS5_ENCODER > ENC_LAST + #error "Configuration (Config.h): Setting AXIS5_ENCODER unknown, use a valid SERVO ENCODER (from Constants.h)" + #endif +#endif + +// AXIS6 FOCUSER +#if AXIS6_DRIVER_MODEL != OFF && \ + (AXIS6_DRIVER_MODEL < STEP_DIR_DRIVER_FIRST || AXIS6_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) && \ + (AXIS6_DRIVER_MODEL < SERVO_DRIVER_FIRST || AXIS6_DRIVER_MODEL > SERVO_DRIVER_LAST) && \ + (AXIS6_DRIVER_MODEL < MOTOR_DRIVER_FIRST || AXIS6_DRIVER_MODEL > MOTOR_DRIVER_LAST) + #error "Configuration (Config.h): Setting AXIS6_DRIVER_MODEL unknown, use OFF or a valid DRIVER (from Constants.h)" +#endif + +#if AXIS6_SLEW_RATE_MINIMUM < 5 || AXIS6_SLEW_RATE_MINIMUM > 200 + #error "Configuration (Config.h): Setting AXIS6_SLEW_RATE_MINIMUM out of range, use a value between 5 and 200" +#endif + +#if AXIS6_SLEW_RATE_BASE_DESIRED < 200 || AXIS6_SLEW_RATE_BASE_DESIRED > 5000 + #error "Configuration (Config.h): Setting AXIS6_SLEW_RATE_BASE_DESIRED out of range, use a value between 200 and 5000" +#endif + +#if AXIS6_DRIVER_STATUS != OFF && AXIS6_DRIVER_STATUS != ON && AXIS6_DRIVER_STATUS != HIGH && AXIS6_DRIVER_STATUS != LOW + #error "Configuration (Config.h): Setting AXIS6_DRIVER_STATUS unknown, use OFF or valid driver status." +#endif + +#if AXIS6_REVERSE != ON && AXIS6_REVERSE != OFF + #error "Configuration (Config.h): Setting AXIS6_REVERSE unknown, use OFF or ON." +#endif + +#if AXIS6_POWER_DOWN != ON && AXIS6_POWER_DOWN != OFF + #error "Configuration (Config.h): Setting AXIS6_POWER_DOWN unknown, use OFF or ON." +#endif +#if AXIS6_POWER_DOWN == ON && (AXIS6_ENABLE_PIN == OFF || AXIS6_ENABLE_PIN == SHARED) && \ + (AXIS6_DRIVER_MODEL < TMC_DRIVER_FIRST || AXIS6_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) + #error "Configuration (Config.h): AXIS6_POWER_DOWN requires a dedicated enable pin or a software-controlled step/dir TMC driver." +#endif + +#if AXIS6_LIMIT_MIN < 0 || AXIS6_LIMIT_MIN > 500 + #error "Configuration (Config.h): Setting AXIS6_LIMIT_MIN unknown, use value in the range 0 to 500 (mm.)" +#endif + +#if AXIS6_LIMIT_MAX < AXIS6_LIMIT_MIN || AXIS6_LIMIT_MAX > 500 + #error "Configuration (Config.h): Setting AXIS6_LIMIT_MAX unknown, use value in the range AXIS6_LIMIT_MIN to 500 (mm.)" +#endif + +#if AXIS6_HOME_DEFAULT != MINIMUM && AXIS6_HOME_DEFAULT != MIDDLE && AXIS6_HOME_DEFAULT != MAXIMUM && (AXIS6_HOME_DEFAULT < 0 || AXIS6_HOME_DEFAULT > 500000) + #error "Configuration (Config.h): Setting AXIS6_HOME_DEFAULT unknown, use MINIMUM (zero) or MIDDLE (half travel) or MAXIMUM (full travel) or the position in microns (0 to 500000.)" +#endif + +#if (AXIS6_SENSE_HOME) != OFF && (AXIS6_SENSE_HOME) < 0 + #error "Configuration (Config.h): Setting AXIS6_SENSE_HOME unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS6_SENSE_LIMIT_MIN) != OFF && (AXIS6_SENSE_LIMIT_MIN) < 0 + #error "Configuration (Config.h): Setting AXIS6_SENSE_LIMIT_MIN unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS6_SENSE_LIMIT_MAX) != OFF && (AXIS6_SENSE_LIMIT_MAX) < 0 + #error "Configuration (Config.h): Setting AXIS6_SENSE_LIMIT_MAX unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#ifdef AXIS6_STEP_DIR_PRESENT + #if AXIS6_DRIVER_MICROSTEPS != OFF && (AXIS6_DRIVER_MICROSTEPS < 1 || AXIS6_DRIVER_MICROSTEPS > 256) + #error "Configuration (Config.h): Setting AXIS6_DRIVER_MICROSTEPS unknown, use OFF or a valid microstep setting (range 1 to 256x and supported by your driver/design.)" + #if AXIS6_DRIVER_MICROSTEPS != 1 && AXIS6_DRIVER_MICROSTEPS != 2 && AXIS6_DRIVER_MICROSTEPS != 4 && \ + AXIS6_DRIVER_MICROSTEPS != 8 && AXIS6_DRIVER_MICROSTEPS != 16 && AXIS6_DRIVER_MICROSTEPS != 32 && \ + AXIS6_DRIVER_MICROSTEPS != 64 && AXIS6_DRIVER_MICROSTEPS != 128 && AXIS6_DRIVER_MICROSTEPS != 256 + #warning "Configuration (Config.h): Setting AXIS6_DRIVER_MICROSTEPS has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS6_DRIVER_MICROSTEPS_GOTO != OFF && (AXIS6_DRIVER_MICROSTEPS_GOTO < 1 || AXIS6_DRIVER_MICROSTEPS_GOTO >= AXIS6_DRIVER_MICROSTEPS) + #error "Configuration (Config.h): Setting AXIS6_DRIVER_MICROSTEPS_GOTO unknown, use OFF or a valid microstep setting (range 1 to < AXIS6_DRIVER_MICROSTEPS and supported by your driver/design.)" + #if AXIS6_DRIVER_MICROSTEPS_GOTO != 1 && AXIS6_DRIVER_MICROSTEPS_GOTO != 2 && AXIS6_DRIVER_MICROSTEPS_GOTO != 4 && \ + AXIS6_DRIVER_MICROSTEPS_GOTO != 8 && AXIS6_DRIVER_MICROSTEPS_GOTO != 16 && AXIS6_DRIVER_MICROSTEPS_GOTO != 32 && \ + AXIS6_DRIVER_MICROSTEPS_GOTO != 64 && AXIS6_DRIVER_MICROSTEPS_GOTO != 128 && AXIS6_DRIVER_MICROSTEPS_GOTO != 256 + #warning "Configuration (Config.h): Setting AXIS6_DRIVER_MICROSTEPS_GOTO has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS6_DRIVER_MICROSTEPS == OFF && AXIS6_DRIVER_MICROSTEPS_GOTO != OFF + #error "Configuration (Config.h): Setting AXIS6_DRIVER_MICROSTEPS_GOTO can't be enabled without first enabling AXIS6_DRIVER_MICROSTEPS." + #endif + #if AXIS6_DRIVER_DECAY != OFF && (AXIS6_DRIVER_DECAY < DRIVER_DECAY_MODE_FIRST || AXIS6_DRIVER_DECAY > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS6_DRIVER_DECAY unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS6_DRIVER_DECAY_GOTO != OFF && (AXIS6_DRIVER_DECAY_GOTO < DRIVER_DECAY_MODE_FIRST || AXIS6_DRIVER_DECAY_GOTO > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS6_DRIVER_DECAY_GOTO unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS6_DRIVER_IRUN != OFF && (AXIS6_DRIVER_IRUN < 0 || AXIS6_DRIVER_IRUN > 3000) + #error "Configuration (Config.h): Setting AXIS6_DRIVER_IRUN unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS6_DRIVER_IHOLD != OFF && (AXIS6_DRIVER_IHOLD < 0 || AXIS6_DRIVER_IHOLD > 3000) + #error "Configuration (Config.h): Setting AXIS6_DRIVER_IHOLD unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS6_DRIVER_IGOTO != OFF && (AXIS6_DRIVER_IGOTO < 0 || AXIS6_DRIVER_IGOTO > 3000) + #error "Configuration (Config.h): Setting AXIS6_DRIVER_IGOTO unknown, use OFF or a value 0 to 3000 (mA.)" + #endif +#endif + +#ifdef AXIS6_SERVO_PRESENT + #if AXIS6_ENCODER < ENC_FIRST || AXIS6_ENCODER > ENC_LAST + #error "Configuration (Config.h): Setting AXIS6_ENCODER unknown, use a valid SERVO ENCODER (from Constants.h)" + #endif +#endif + +// AXIS7 FOCUSER +#if AXIS7_DRIVER_MODEL != OFF && \ + (AXIS7_DRIVER_MODEL < STEP_DIR_DRIVER_FIRST || AXIS7_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) && \ + (AXIS7_DRIVER_MODEL < SERVO_DRIVER_FIRST || AXIS7_DRIVER_MODEL > SERVO_DRIVER_LAST) && \ + (AXIS7_DRIVER_MODEL < MOTOR_DRIVER_FIRST || AXIS7_DRIVER_MODEL > MOTOR_DRIVER_LAST) + #error "Configuration (Config.h): Setting AXIS7_DRIVER_MODEL unknown, use OFF or a valid DRIVER (from Constants.h)" +#endif + +#if AXIS7_SLEW_RATE_MINIMUM < 5 || AXIS7_SLEW_RATE_MINIMUM > 200 + #error "Configuration (Config.h): Setting AXIS7_SLEW_RATE_MINIMUM out of range, use a value between 5 and 200" +#endif + +#if AXIS7_SLEW_RATE_BASE_DESIRED < 200 || AXIS7_SLEW_RATE_BASE_DESIRED > 5000 + #error "Configuration (Config.h): Setting AXIS7_SLEW_RATE_BASE_DESIRED out of range, use a value between 200 and 5000" +#endif + +#if AXIS7_DRIVER_STATUS != OFF && AXIS7_DRIVER_STATUS != ON && AXIS7_DRIVER_STATUS != HIGH && AXIS7_DRIVER_STATUS != LOW + #error "Configuration (Config.h): Setting AXIS7_DRIVER_STATUS unknown, use OFF or valid driver status." +#endif + +#if AXIS7_REVERSE != ON && AXIS7_REVERSE != OFF + #error "Configuration (Config.h): Setting AXIS7_REVERSE unknown, use OFF or ON." +#endif + +#if AXIS7_POWER_DOWN != ON && AXIS7_POWER_DOWN != OFF + #error "Configuration (Config.h): Setting AXIS7_POWER_DOWN unknown, use OFF or ON." +#endif +#if AXIS7_POWER_DOWN == ON && (AXIS7_ENABLE_PIN == OFF || AXIS7_ENABLE_PIN == SHARED) && \ + (AXIS7_DRIVER_MODEL < TMC_DRIVER_FIRST || AXIS7_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) + #error "Configuration (Config.h): AXIS7_POWER_DOWN requires a dedicated enable pin or a software-controlled step/dir TMC driver." +#endif + +#if AXIS7_LIMIT_MIN < 0 || AXIS7_LIMIT_MIN > 500 + #error "Configuration (Config.h): Setting AXIS7_LIMIT_MIN unknown, use value in the range 0 to 500 (mm.)" +#endif + +#if AXIS7_LIMIT_MAX < AXIS7_LIMIT_MIN || AXIS7_LIMIT_MAX > 500 + #error "Configuration (Config.h): Setting AXIS7_LIMIT_MAX unknown, use value in the range AXIS7_LIMIT_MIN to 500 (mm.)" +#endif + +#if AXIS7_HOME_DEFAULT != MINIMUM && AXIS7_HOME_DEFAULT != MIDDLE && AXIS7_HOME_DEFAULT != MAXIMUM && (AXIS7_HOME_DEFAULT < 0 || AXIS7_HOME_DEFAULT > 500000) + #error "Configuration (Config.h): Setting AXIS7_HOME_DEFAULT unknown, use MINIMUM (zero) or MIDDLE (half travel) or MAXIMUM (full travel) or the position in microns (0 to 500000.)" +#endif + +#if (AXIS7_SENSE_HOME) != OFF && (AXIS7_SENSE_HOME) < 0 + #error "Configuration (Config.h): Setting AXIS7_SENSE_HOME unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS7_SENSE_LIMIT_MIN) != OFF && (AXIS7_SENSE_LIMIT_MIN) < 0 + #error "Configuration (Config.h): Setting AXIS7_SENSE_LIMIT_MIN unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS7_SENSE_LIMIT_MAX) != OFF && (AXIS7_SENSE_LIMIT_MAX) < 0 + #error "Configuration (Config.h): Setting AXIS7_SENSE_LIMIT_MAX unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#ifdef AXIS7_STEP_DIR_PRESENT + #if AXIS7_DRIVER_MICROSTEPS != OFF && (AXIS7_DRIVER_MICROSTEPS < 1 || AXIS7_DRIVER_MICROSTEPS > 256) + #error "Configuration (Config.h): Setting AXIS7_DRIVER_MICROSTEPS unknown, use OFF or a valid microstep setting (range 1 to 256x and supported by your driver/design.)" + #if AXIS7_DRIVER_MICROSTEPS != 1 && AXIS7_DRIVER_MICROSTEPS != 2 && AXIS7_DRIVER_MICROSTEPS != 4 && \ + AXIS7_DRIVER_MICROSTEPS != 8 && AXIS7_DRIVER_MICROSTEPS != 16 && AXIS7_DRIVER_MICROSTEPS != 32 && \ + AXIS7_DRIVER_MICROSTEPS != 64 && AXIS7_DRIVER_MICROSTEPS != 128 && AXIS7_DRIVER_MICROSTEPS != 256 + #warning "Configuration (Config.h): Setting AXIS7_DRIVER_MICROSTEPS has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS7_DRIVER_MICROSTEPS_GOTO != OFF && (AXIS7_DRIVER_MICROSTEPS_GOTO < 1 || AXIS7_DRIVER_MICROSTEPS_GOTO >= AXIS7_DRIVER_MICROSTEPS) + #error "Configuration (Config.h): Setting AXIS7_DRIVER_MICROSTEPS_GOTO unknown, use OFF or a valid microstep setting (range 1 to < AXIS7_DRIVER_MICROSTEPS and supported by your driver/design.)" + #if AXIS7_DRIVER_MICROSTEPS_GOTO != 1 && AXIS7_DRIVER_MICROSTEPS_GOTO != 2 && AXIS7_DRIVER_MICROSTEPS_GOTO != 4 && \ + AXIS7_DRIVER_MICROSTEPS_GOTO != 8 && AXIS7_DRIVER_MICROSTEPS_GOTO != 16 && AXIS7_DRIVER_MICROSTEPS_GOTO != 32 && \ + AXIS7_DRIVER_MICROSTEPS_GOTO != 64 && AXIS7_DRIVER_MICROSTEPS_GOTO != 128 && AXIS7_DRIVER_MICROSTEPS_GOTO != 256 + #warning "Configuration (Config.h): Setting AXIS7_DRIVER_MICROSTEPS_GOTO has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS7_DRIVER_MICROSTEPS == OFF && AXIS7_DRIVER_MICROSTEPS_GOTO != OFF + #error "Configuration (Config.h): Setting AXIS7_DRIVER_MICROSTEPS_GOTO can't be enabled without first enabling AXIS7_DRIVER_MICROSTEPS." + #endif + #if AXIS7_DRIVER_DECAY != OFF && (AXIS7_DRIVER_DECAY < DRIVER_DECAY_MODE_FIRST || AXIS7_DRIVER_DECAY > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS7_DRIVER_DECAY unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS7_DRIVER_DECAY_GOTO != OFF && (AXIS7_DRIVER_DECAY_GOTO < DRIVER_DECAY_MODE_FIRST || AXIS7_DRIVER_DECAY_GOTO > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS7_DRIVER_DECAY_GOTO unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS7_DRIVER_IRUN != OFF && (AXIS7_DRIVER_IRUN < 0 || AXIS7_DRIVER_IRUN > 3000) + #error "Configuration (Config.h): Setting AXIS7_DRIVER_IRUN unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS7_DRIVER_IHOLD != OFF && (AXIS7_DRIVER_IHOLD < 0 || AXIS7_DRIVER_IHOLD > 3000) + #error "Configuration (Config.h): Setting AXIS7_DRIVER_IHOLD unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS7_DRIVER_IGOTO != OFF && (AXIS7_DRIVER_IGOTO < 0 || AXIS7_DRIVER_IGOTO > 3000) + #error "Configuration (Config.h): Setting AXIS7_DRIVER_IGOTO unknown, use OFF or a value 0 to 3000 (mA.)" + #endif +#endif + +#ifdef AXIS7_SERVO_PRESENT + #if AXIS7_ENCODER < ENC_FIRST || AXIS7_ENCODER > ENC_LAST + #error "Configuration (Config.h): Setting AXIS7_ENCODER unknown, use a valid SERVO ENCODER (from Constants.h)" + #endif +#endif + +// AXIS8 FOCUSER +#if AXIS8_DRIVER_MODEL != OFF && \ + (AXIS8_DRIVER_MODEL < STEP_DIR_DRIVER_FIRST || AXIS8_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) && \ + (AXIS8_DRIVER_MODEL < SERVO_DRIVER_FIRST || AXIS8_DRIVER_MODEL > SERVO_DRIVER_LAST) && \ + (AXIS8_DRIVER_MODEL < MOTOR_DRIVER_FIRST || AXIS8_DRIVER_MODEL > MOTOR_DRIVER_LAST) + #error "Configuration (Config.h): Setting AXIS8_DRIVER_MODEL unknown, use OFF or a valid DRIVER (from Constants.h)" +#endif + +#if AXIS8_SLEW_RATE_MINIMUM < 5 || AXIS8_SLEW_RATE_MINIMUM > 200 + #error "Configuration (Config.h): Setting AXIS8_SLEW_RATE_MINIMUM out of range, use a value between 5 and 200" +#endif + +#if AXIS8_SLEW_RATE_BASE_DESIRED < 200 || AXIS8_SLEW_RATE_BASE_DESIRED > 5000 + #error "Configuration (Config.h): Setting AXIS8_SLEW_RATE_BASE_DESIRED out of range, use a value between 200 and 5000" +#endif + +#if AXIS8_DRIVER_STATUS != OFF && AXIS8_DRIVER_STATUS != ON && AXIS8_DRIVER_STATUS != HIGH && AXIS8_DRIVER_STATUS != LOW + #error "Configuration (Config.h): Setting AXIS8_DRIVER_STATUS unknown, use OFF or valid driver status." +#endif + +#if AXIS8_REVERSE != ON && AXIS8_REVERSE != OFF + #error "Configuration (Config.h): Setting AXIS8_REVERSE unknown, use OFF or ON." +#endif + +#if AXIS8_POWER_DOWN != ON && AXIS8_POWER_DOWN != OFF + #error "Configuration (Config.h): Setting AXIS8_POWER_DOWN unknown, use OFF or ON." +#endif +#if AXIS8_POWER_DOWN == ON && (AXIS8_ENABLE_PIN == OFF || AXIS8_ENABLE_PIN == SHARED) && \ + (AXIS8_DRIVER_MODEL < TMC_DRIVER_FIRST || AXIS8_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) + #error "Configuration (Config.h): AXIS8_POWER_DOWN requires a dedicated enable pin or a software-controlled step/dir TMC driver." +#endif + +#if AXIS8_LIMIT_MIN < 0 || AXIS8_LIMIT_MIN > 500 + #error "Configuration (Config.h): Setting AXIS8_LIMIT_MIN unknown, use value in the range 0 to 500 (mm.)" +#endif + +#if AXIS8_LIMIT_MAX < AXIS8_LIMIT_MIN || AXIS8_LIMIT_MAX > 500 + #error "Configuration (Config.h): Setting AXIS8_LIMIT_MAX unknown, use value in the range AXIS8_LIMIT_MIN to 500 (mm.)" +#endif + +#if AXIS8_HOME_DEFAULT != MINIMUM && AXIS8_HOME_DEFAULT != MIDDLE && AXIS8_HOME_DEFAULT != MAXIMUM && (AXIS8_HOME_DEFAULT < 0 || AXIS8_HOME_DEFAULT > 500000) + #error "Configuration (Config.h): Setting AXIS8_HOME_DEFAULT unknown, use MINIMUM (zero) or MIDDLE (half travel) or MAXIMUM (full travel) or the position in microns (0 to 500000.)" +#endif + +#if (AXIS8_SENSE_HOME) != OFF && (AXIS8_SENSE_HOME) < 0 + #error "Configuration (Config.h): Setting AXIS8_SENSE_HOME unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS8_SENSE_LIMIT_MIN) != OFF && (AXIS8_SENSE_LIMIT_MIN) < 0 + #error "Configuration (Config.h): Setting AXIS8_SENSE_LIMIT_MIN unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS8_SENSE_LIMIT_MAX) != OFF && (AXIS8_SENSE_LIMIT_MAX) < 0 + #error "Configuration (Config.h): Setting AXIS8_SENSE_LIMIT_MAX unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#ifdef AXIS8_STEP_DIR_PRESENT + #if AXIS8_DRIVER_MICROSTEPS != OFF && (AXIS8_DRIVER_MICROSTEPS < 1 || AXIS8_DRIVER_MICROSTEPS > 256) + #error "Configuration (Config.h): Setting AXIS8_DRIVER_MICROSTEPS unknown, use OFF or a valid microstep setting (range 1 to 256x and supported by your driver/design.)" + #if AXIS8_DRIVER_MICROSTEPS != 1 && AXIS8_DRIVER_MICROSTEPS != 2 && AXIS8_DRIVER_MICROSTEPS != 4 && \ + AXIS8_DRIVER_MICROSTEPS != 8 && AXIS8_DRIVER_MICROSTEPS != 16 && AXIS8_DRIVER_MICROSTEPS != 32 && \ + AXIS8_DRIVER_MICROSTEPS != 64 && AXIS8_DRIVER_MICROSTEPS != 128 && AXIS8_DRIVER_MICROSTEPS != 256 + #warning "Configuration (Config.h): Setting AXIS8_DRIVER_MICROSTEPS has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS8_DRIVER_MICROSTEPS_GOTO != OFF && (AXIS8_DRIVER_MICROSTEPS_GOTO < 1 || AXIS8_DRIVER_MICROSTEPS_GOTO >= AXIS8_DRIVER_MICROSTEPS) + #error "Configuration (Config.h): Setting AXIS8_DRIVER_MICROSTEPS_GOTO unknown, use OFF or a valid microstep setting (range 1 to < AXIS8_DRIVER_MICROSTEPS and supported by your driver/design.)" + #if AXIS8_DRIVER_MICROSTEPS_GOTO != 1 && AXIS8_DRIVER_MICROSTEPS_GOTO != 2 && AXIS8_DRIVER_MICROSTEPS_GOTO != 4 && \ + AXIS8_DRIVER_MICROSTEPS_GOTO != 8 && AXIS8_DRIVER_MICROSTEPS_GOTO != 16 && AXIS8_DRIVER_MICROSTEPS_GOTO != 32 && \ + AXIS8_DRIVER_MICROSTEPS_GOTO != 64 && AXIS8_DRIVER_MICROSTEPS_GOTO != 128 && AXIS8_DRIVER_MICROSTEPS_GOTO != 256 + #warning "Configuration (Config.h): Setting AXIS8_DRIVER_MICROSTEPS_GOTO has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS8_DRIVER_MICROSTEPS == OFF && AXIS8_DRIVER_MICROSTEPS_GOTO != OFF + #error "Configuration (Config.h): Setting AXIS8_DRIVER_MICROSTEPS_GOTO can't be enabled without first enabling AXIS8_DRIVER_MICROSTEPS." + #endif + #if AXIS8_DRIVER_DECAY != OFF && (AXIS8_DRIVER_DECAY < DRIVER_DECAY_MODE_FIRST || AXIS8_DRIVER_DECAY > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS8_DRIVER_DECAY unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS8_DRIVER_DECAY_GOTO != OFF && (AXIS8_DRIVER_DECAY_GOTO < DRIVER_DECAY_MODE_FIRST || AXIS8_DRIVER_DECAY_GOTO > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS8_DRIVER_DECAY_GOTO unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS8_DRIVER_IRUN != OFF && (AXIS8_DRIVER_IRUN < 0 || AXIS8_DRIVER_IRUN > 3000) + #error "Configuration (Config.h): Setting AXIS8_DRIVER_IRUN unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS8_DRIVER_IHOLD != OFF && (AXIS8_DRIVER_IHOLD < 0 || AXIS8_DRIVER_IHOLD > 3000) + #error "Configuration (Config.h): Setting AXIS8_DRIVER_IHOLD unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS8_DRIVER_IGOTO != OFF && (AXIS8_DRIVER_IGOTO < 0 || AXIS8_DRIVER_IGOTO > 3000) + #error "Configuration (Config.h): Setting AXIS8_DRIVER_IGOTO unknown, use OFF or a value 0 to 3000 (mA.)" + #endif +#endif + +#ifdef AXIS8_SERVO_PRESENT + #if AXIS8_ENCODER < ENC_FIRST || AXIS8_ENCODER > ENC_LAST + #error "Configuration (Config.h): Setting AXIS8_ENCODER unknown, use a valid SERVO ENCODER (from Constants.h)" + #endif +#endif + +// AXIS9 FOCUSER +#if AXIS9_DRIVER_MODEL != OFF && \ + (AXIS9_DRIVER_MODEL < STEP_DIR_DRIVER_FIRST || AXIS9_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) && \ + (AXIS9_DRIVER_MODEL < SERVO_DRIVER_FIRST || AXIS9_DRIVER_MODEL > SERVO_DRIVER_LAST) && \ + (AXIS9_DRIVER_MODEL < MOTOR_DRIVER_FIRST || AXIS9_DRIVER_MODEL > MOTOR_DRIVER_LAST) + #error "Configuration (Config.h): Setting AXIS9_DRIVER_MODEL unknown, use OFF or a valid DRIVER (from Constants.h)" +#endif + +#if AXIS9_SLEW_RATE_MINIMUM < 5 || AXIS9_SLEW_RATE_MINIMUM > 200 + #error "Configuration (Config.h): Setting AXIS9_SLEW_RATE_MINIMUM out of range, use a value between 5 and 200" +#endif + +#if AXIS9_SLEW_RATE_BASE_DESIRED < 200 || AXIS9_SLEW_RATE_BASE_DESIRED > 5000 + #error "Configuration (Config.h): Setting AXIS9_SLEW_RATE_BASE_DESIRED out of range, use a value between 200 and 5000" +#endif + +#if AXIS9_DRIVER_STATUS != OFF && AXIS9_DRIVER_STATUS != ON && AXIS9_DRIVER_STATUS != HIGH && AXIS9_DRIVER_STATUS != LOW + #error "Configuration (Config.h): Setting AXIS9_DRIVER_STATUS unknown, use OFF or valid driver status." +#endif + +#if AXIS9_REVERSE != ON && AXIS9_REVERSE != OFF + #error "Configuration (Config.h): Setting AXIS9_REVERSE unknown, use OFF or ON." +#endif + +#if AXIS9_POWER_DOWN != ON && AXIS9_POWER_DOWN != OFF + #error "Configuration (Config.h): Setting AXIS9_POWER_DOWN unknown, use OFF or ON." +#endif +#if AXIS9_POWER_DOWN == ON && (AXIS9_ENABLE_PIN == OFF || AXIS9_ENABLE_PIN == SHARED) && \ + (AXIS9_DRIVER_MODEL < TMC_DRIVER_FIRST || AXIS9_DRIVER_MODEL > STEP_DIR_DRIVER_LAST) + #error "Configuration (Config.h): AXIS9_POWER_DOWN requires a dedicated enable pin or a software-controlled step/dir TMC driver." +#endif + +#if AXIS9_LIMIT_MIN < 0 || AXIS9_LIMIT_MIN > 500 + #error "Configuration (Config.h): Setting AXIS9_LIMIT_MIN unknown, use value in the range 0 to 500 (mm.)" +#endif + +#if AXIS9_LIMIT_MAX < AXIS9_LIMIT_MIN || AXIS9_LIMIT_MAX > 500 + #error "Configuration (Config.h): Setting AXIS9_LIMIT_MAX unknown, use value in the range AXIS9_LIMIT_MIN to 500 (mm.)" +#endif + +#if AXIS9_HOME_DEFAULT != MINIMUM && AXIS9_HOME_DEFAULT != MIDDLE && AXIS9_HOME_DEFAULT != MAXIMUM && (AXIS9_HOME_DEFAULT < 0 || AXIS9_HOME_DEFAULT > 500000) + #error "Configuration (Config.h): Setting AXIS9_HOME_DEFAULT unknown, use MINIMUM (zero) or MIDDLE (half travel) or MAXIMUM (full travel) or the position in microns (0 to 500000.)" +#endif + +#if (AXIS9_SENSE_HOME) != OFF && (AXIS9_SENSE_HOME) < 0 + #error "Configuration (Config.h): Setting AXIS9_SENSE_HOME unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS9_SENSE_LIMIT_MIN) != OFF && (AXIS9_SENSE_LIMIT_MIN) < 0 + #error "Configuration (Config.h): Setting AXIS9_SENSE_LIMIT_MIN unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#if (AXIS9_SENSE_LIMIT_MAX) != OFF && (AXIS9_SENSE_LIMIT_MAX) < 0 + #error "Configuration (Config.h): Setting AXIS9_SENSE_LIMIT_MAX unknown, use OFF or HIGH/LOW and HYST() and/or THLD() as described in comments." +#endif + +#ifdef AXIS9_STEP_DIR_PRESENT + #if AXIS9_DRIVER_MICROSTEPS != OFF && (AXIS9_DRIVER_MICROSTEPS < 1 || AXIS9_DRIVER_MICROSTEPS > 256) + #error "Configuration (Config.h): Setting AXIS9_DRIVER_MICROSTEPS unknown, use OFF or a valid microstep setting (range 1 to 256x and supported by your driver/design.)" + #if AXIS9_DRIVER_MICROSTEPS != 1 && AXIS9_DRIVER_MICROSTEPS != 2 && AXIS9_DRIVER_MICROSTEPS != 4 && \ + AXIS9_DRIVER_MICROSTEPS != 8 && AXIS9_DRIVER_MICROSTEPS != 16 && AXIS9_DRIVER_MICROSTEPS != 32 && \ + AXIS9_DRIVER_MICROSTEPS != 64 && AXIS9_DRIVER_MICROSTEPS != 128 && AXIS9_DRIVER_MICROSTEPS != 256 + #warning "Configuration (Config.h): Setting AXIS9_DRIVER_MICROSTEPS has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS9_DRIVER_MICROSTEPS_GOTO != OFF && (AXIS9_DRIVER_MICROSTEPS_GOTO < 1 || AXIS9_DRIVER_MICROSTEPS_GOTO >= AXIS9_DRIVER_MICROSTEPS) + #error "Configuration (Config.h): Setting AXIS9_DRIVER_MICROSTEPS_GOTO unknown, use OFF or a valid microstep setting (range 1 to < AXIS9_DRIVER_MICROSTEPS and supported by your driver/design.)" + #if AXIS9_DRIVER_MICROSTEPS_GOTO != 1 && AXIS9_DRIVER_MICROSTEPS_GOTO != 2 && AXIS9_DRIVER_MICROSTEPS_GOTO != 4 && \ + AXIS9_DRIVER_MICROSTEPS_GOTO != 8 && AXIS9_DRIVER_MICROSTEPS_GOTO != 16 && AXIS9_DRIVER_MICROSTEPS_GOTO != 32 && \ + AXIS9_DRIVER_MICROSTEPS_GOTO != 64 && AXIS9_DRIVER_MICROSTEPS_GOTO != 128 && AXIS9_DRIVER_MICROSTEPS_GOTO != 256 + #warning "Configuration (Config.h): Setting AXIS9_DRIVER_MICROSTEPS_GOTO has an unusual value (not a power of 2!)" + #endif + #endif + #if AXIS9_DRIVER_MICROSTEPS == OFF && AXIS9_DRIVER_MICROSTEPS_GOTO != OFF + #error "Configuration (Config.h): Setting AXIS9_DRIVER_MICROSTEPS_GOTO can't be enabled without first enabling AXIS9_DRIVER_MICROSTEPS." + #endif + #if AXIS9_DRIVER_DECAY != OFF && (AXIS9_DRIVER_DECAY < DRIVER_DECAY_MODE_FIRST || AXIS9_DRIVER_DECAY > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS9_DRIVER_DECAY unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS9_DRIVER_DECAY_GOTO != OFF && (AXIS9_DRIVER_DECAY_GOTO < DRIVER_DECAY_MODE_FIRST || AXIS9_DRIVER_DECAY_GOTO > DRIVER_DECAY_MODE_LAST) + #error "Configuration (Config.h): Setting AXIS9_DRIVER_DECAY_GOTO unknown, use a valid DRIVER DECAY MODE (from Constants.h)" + #endif + #if AXIS9_DRIVER_IRUN != OFF && (AXIS9_DRIVER_IRUN < 0 || AXIS9_DRIVER_IRUN > 3000) + #error "Configuration (Config.h): Setting AXIS9_DRIVER_IRUN unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS9_DRIVER_IHOLD != OFF && (AXIS9_DRIVER_IHOLD < 0 || AXIS9_DRIVER_IHOLD > 3000) + #error "Configuration (Config.h): Setting AXIS9_DRIVER_IHOLD unknown, use OFF or a value 0 to 3000 (mA.)" + #endif + #if AXIS9_DRIVER_IGOTO != OFF && (AXIS9_DRIVER_IGOTO < 0 || AXIS9_DRIVER_IGOTO > 3000) + #error "Configuration (Config.h): Setting AXIS9_DRIVER_IGOTO unknown, use OFF or a value 0 to 3000 (mA.)" + #endif +#endif + +#ifdef AXIS9_SERVO_PRESENT + #if AXIS9_ENCODER < ENC_FIRST || AXIS9_ENCODER > ENC_LAST + #error "Configuration (Config.h): Setting AXIS9_ENCODER unknown, use a valid SERVO ENCODER (from Constants.h)" + #endif +#endif + +// GENERAL TEMPERATURE --------------------------- +#if defined(DS1820_DEVICES_PRESENT) && defined(THERMISTOR_DEVICES_PRESENT) + #error "Configuration (Config.h): Setting DS18B20 devices and THERMISTOR devices can not both be used at the same time, use one or the other" +#endif + +// FOCUSER TEMPERATURE --------------------------- +#if FOCUSER_TEMPERATURE != OFF && \ + (FOCUSER_TEMPERATURE & DS_MASK) != DS18B20 && \ + (FOCUSER_TEMPERATURE & DS_MASK) != DS18S20 && \ + (FOCUSER_TEMPERATURE < TEMPERATURE_FIRST || FOCUSER_TEMPERATURE > TEMPERATURE_LAST) + #error "Configuration (Config.h): Setting FOCUSER_TEMPERATURE unknown, use OFF or TEMPERATURE device (from Constants.h)" +#endif + +// AUXILIARY FEATURE ----------------------------- + +#if FEATURE1_PURPOSE != OFF && (FEATURE1_PURPOSE < AUX_FEATURE_PURPOSE_FIRST || FEATURE1_PURPOSE > AUX_FEATURE_PURPOSE_LAST) + #error "Configuration (Config.h): Setting FEATURE1_PURPOSE unknown, use OFF or AUXILIARY FEATURE purpose (from Constants.h)" +#endif +#if FEATURE1_VALUE_DEFAULT != OFF && FEATURE1_VALUE_DEFAULT != ON && (FEATURE1_VALUE_DEFAULT < 0 || FEATURE1_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE1_VALUE_DEFAULT unknown, use OFF or ON or a value 0 to 255" +#endif +#if FEATURE1_VALUE_MEMORY != OFF && FEATURE1_VALUE_MEMORY != ON + #error "Configuration (Config.h): Setting FEATURE1_VALUE_MEMORY unknown, use OFF or ON" +#endif + +#if FEATURE2_PURPOSE != OFF && (FEATURE2_PURPOSE < AUX_FEATURE_PURPOSE_FIRST || FEATURE2_PURPOSE > AUX_FEATURE_PURPOSE_LAST) + #error "Configuration (Config.h): Setting FEATURE2_PURPOSE unknown, use OFF or AUXILIARY FEATURE purpose (from Constants.h)" +#endif +#if FEATURE2_VALUE_DEFAULT != OFF && FEATURE2_VALUE_DEFAULT != ON && (FEATURE2_VALUE_DEFAULT < 0 || FEATURE2_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE2_VALUE_DEFAULT unknown, use OFF or ON or a value 0 to 255" +#endif +#if FEATURE2_VALUE_MEMORY != OFF && FEATURE2_VALUE_MEMORY != ON + #error "Configuration (Config.h): Setting FEATURE2_VALUE_MEMORY unknown, use OFF or ON" +#endif + +#if FEATURE3_PURPOSE != OFF && (FEATURE3_PURPOSE < AUX_FEATURE_PURPOSE_FIRST || FEATURE3_PURPOSE > AUX_FEATURE_PURPOSE_LAST) + #error "Configuration (Config.h): Setting FEATURE3_PURPOSE unknown, use OFF or AUXILIARY FEATURE purpose (from Constants.h)" +#endif +#if FEATURE3_VALUE_DEFAULT != OFF && FEATURE3_VALUE_DEFAULT != ON && (FEATURE3_VALUE_DEFAULT < 0 || FEATURE3_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE3_VALUE_DEFAULT unknown, use OFF or ON or a value 0 to 255" +#endif +#if FEATURE3_VALUE_MEMORY != OFF && FEATURE3_VALUE_MEMORY != ON + #error "Configuration (Config.h): Setting FEATURE3_VALUE_MEMORY unknown, use OFF or ON" +#endif + +#if FEATURE4_PURPOSE != OFF && (FEATURE4_PURPOSE < AUX_FEATURE_PURPOSE_FIRST || FEATURE4_PURPOSE > AUX_FEATURE_PURPOSE_LAST) + #error "Configuration (Config.h): Setting FEATURE4_PURPOSE unknown, use OFF or AUXILIARY FEATURE purpose (from Constants.h)" +#endif +#if FEATURE4_VALUE_DEFAULT != OFF && FEATURE4_VALUE_DEFAULT != ON && (FEATURE4_VALUE_DEFAULT < 0 || FEATURE4_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE4_VALUE_DEFAULT unknown, use OFF or ON or a value 0 to 255" +#endif +#if FEATURE4_VALUE_MEMORY != OFF && FEATURE4_VALUE_MEMORY != ON + #error "Configuration (Config.h): Setting FEATURE4_VALUE_MEMORY unknown, use OFF or ON" +#endif + +#if FEATURE5_PURPOSE != OFF && (FEATURE5_PURPOSE < AUX_FEATURE_PURPOSE_FIRST || FEATURE5_PURPOSE > AUX_FEATURE_PURPOSE_LAST) + #error "Configuration (Config.h): Setting FEATURE5_PURPOSE unknown, use OFF or AUXILIARY FEATURE purpose (from Constants.h)" +#endif +#if FEATURE5_VALUE_DEFAULT != OFF && FEATURE5_VALUE_DEFAULT != ON && (FEATURE5_VALUE_DEFAULT < 0 || FEATURE5_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE5_VALUE_DEFAULT unknown, use OFF or ON or a value 0 to 255" +#endif +#if FEATURE5_VALUE_MEMORY != OFF && FEATURE5_VALUE_MEMORY != ON + #error "Configuration (Config.h): Setting FEATURE5_VALUE_MEMORY unknown, use OFF or ON" +#endif + +#if FEATURE6_PURPOSE != OFF && (FEATURE6_PURPOSE < AUX_FEATURE_PURPOSE_FIRST || FEATURE6_PURPOSE > AUX_FEATURE_PURPOSE_LAST) + #error "Configuration (Config.h): Setting FEATURE6_PURPOSE unknown, use OFF or AUXILIARY FEATURE purpose (from Constants.h)" +#endif +#if FEATURE6_VALUE_DEFAULT != OFF && FEATURE6_VALUE_DEFAULT != ON && (FEATURE6_VALUE_DEFAULT < 0 || FEATURE6_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE6_VALUE_DEFAULT unknown, use OFF or ON or a value 0 to 255" +#endif +#if FEATURE6_VALUE_MEMORY != OFF && FEATURE6_VALUE_MEMORY != ON + #error "Configuration (Config.h): Setting FEATURE6_VALUE_MEMORY unknown, use OFF or ON" +#endif + +#if FEATURE7_PURPOSE != OFF && (FEATURE7_PURPOSE < AUX_FEATURE_PURPOSE_FIRST || FEATURE7_PURPOSE > AUX_FEATURE_PURPOSE_LAST) + #error "Configuration (Config.h): Setting FEATURE7_PURPOSE unknown, use OFF or AUXILIARY FEATURE purpose (from Constants.h)" +#endif +#if FEATURE7_VALUE_DEFAULT != OFF && FEATURE7_VALUE_DEFAULT != ON && (FEATURE7_VALUE_DEFAULT < 0 || FEATURE7_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE7_VALUE_DEFAULT unknown, use OFF or ON or a value 0 to 255" +#endif +#if FEATURE7_VALUE_MEMORY != OFF && FEATURE7_VALUE_MEMORY != ON + #error "Configuration (Config.h): Setting FEATURE7_VALUE_MEMORY unknown, use OFF or ON" +#endif + +#if FEATURE8_PURPOSE != OFF && (FEATURE8_PURPOSE < AUX_FEATURE_PURPOSE_FIRST || FEATURE8_PURPOSE > AUX_FEATURE_PURPOSE_LAST) + #error "Configuration (Config.h): Setting FEATURE8_PURPOSE unknown, use OFF or AUXILIARY FEATURE purpose (from Constants.h)" +#endif +#if FEATURE8_VALUE_DEFAULT != OFF && FEATURE8_VALUE_DEFAULT != ON && (FEATURE8_VALUE_DEFAULT < 0 || FEATURE8_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE8_VALUE_DEFAULT unknown, use OFF or ON or a value 0 to 255" +#endif +#if FEATURE8_VALUE_MEMORY != OFF && FEATURE8_VALUE_MEMORY != ON + #error "Configuration (Config.h): Setting FEATURE8_VALUE_MEMORY unknown, use OFF or ON" +#endif + +#if FEATURE1_TEMP != OFF && \ + (FEATURE1_TEMP & DS_MASK) != DS18B20 && \ + (FEATURE1_TEMP & DS_MASK) != DS18S20 && \ + (FEATURE1_TEMP < TEMPERATURE_FIRST || FEATURE1_TEMP > TEMPERATURE_LAST) + #error "Configuration (Config.h): Setting FEATURE1_TEMP unknown, use OFF or TEMPERATURE device (from Constants.h)" +#endif +#if FEATURE2_TEMP != OFF && \ + (FEATURE2_TEMP & DS_MASK) != DS18B20 && \ + (FEATURE2_TEMP & DS_MASK) != DS18S20 && \ + (FEATURE2_TEMP < TEMPERATURE_FIRST || FEATURE2_TEMP > TEMPERATURE_LAST) + #error "Configuration (Config.h): Setting FEATURE2_TEMP unknown, use OFF or TEMPERATURE device (from Constants.h)" +#endif +#if FEATURE3_TEMP != OFF && \ + (FEATURE3_TEMP & DS_MASK) != DS18B20 && \ + (FEATURE3_TEMP & DS_MASK) != DS18S20 && \ + (FEATURE3_TEMP < TEMPERATURE_FIRST || FEATURE3_TEMP > TEMPERATURE_LAST) + #error "Configuration (Config.h): Setting FEATURE3_TEMP unknown, use OFF or TEMPERATURE device (from Constants.h)" +#endif +#if FEATURE4_TEMP != OFF && \ + (FEATURE4_TEMP & DS_MASK) != DS18B20 && \ + (FEATURE4_TEMP & DS_MASK) != DS18S20 && \ + (FEATURE4_TEMP < TEMPERATURE_FIRST || FEATURE4_TEMP > TEMPERATURE_LAST) + #error "Configuration (Config.h): Setting FEATURE4_TEMP unknown, use OFF or TEMPERATURE device (from Constants.h)" +#endif +#if FEATURE5_TEMP != OFF && \ + (FEATURE5_TEMP & DS_MASK) != DS18B20 && \ + (FEATURE5_TEMP & DS_MASK) != DS18S20 && \ + (FEATURE5_TEMP < TEMPERATURE_FIRST || FEATURE5_TEMP > TEMPERATURE_LAST) + #error "Configuration (Config.h): Setting FEATURE5_TEMP unknown, use OFF or TEMPERATURE device (from Constants.h)" +#endif +#if FEATURE6_TEMP != OFF && \ + (FEATURE6_TEMP & DS_MASK) != DS18B20 && \ + (FEATURE6_TEMP & DS_MASK) != DS18S20 && \ + (FEATURE6_TEMP < TEMPERATURE_FIRST || FEATURE6_TEMP > TEMPERATURE_LAST) + #error "Configuration (Config.h): Setting FEATURE6_TEMP unknown, use OFF or TEMPERATURE device (from Constants.h)" +#endif +#if FEATURE7_TEMP != OFF && \ + (FEATURE7_TEMP & DS_MASK) != DS18B20 && \ + (FEATURE7_TEMP & DS_MASK) != DS18S20 && \ + (FEATURE7_TEMP < TEMPERATURE_FIRST || FEATURE7_TEMP > TEMPERATURE_LAST) + #error "Configuration (Config.h): Setting FEATURE7_TEMP unknown, use OFF or TEMPERATURE device (from Constants.h)" +#endif +#if FEATURE8_TEMP != OFF && \ + (FEATURE8_TEMP & DS_MASK) != DS18B20 && \ + (FEATURE8_TEMP & DS_MASK) != DS18S20 && \ + (FEATURE8_TEMP < TEMPERATURE_FIRST || FEATURE8_TEMP > TEMPERATURE_LAST) + #error "Configuration (Config.h): Setting FEATURE8_TEMP unknown, use OFF or TEMPERATURE device (from Constants.h)" +#endif + +#if FEATURE1_PIN != OFF && FEATURE1_PIN < 0 + #error "Configuration (Config.h): Setting FEATURE1_PIN unknown, use OFF or a valid microcontroller pin designation." +#endif +#if FEATURE2_PIN != OFF && FEATURE2_PIN < 0 + #error "Configuration (Config.h): Setting FEATURE2_PIN unknown, use OFF or a valid microcontroller pin designation." +#endif +#if FEATURE3_PIN != OFF && FEATURE3_PIN < 0 + #error "Configuration (Config.h): Setting FEATURE3_PIN unknown, use OFF or a valid microcontroller pin designation." +#endif +#if FEATURE4_PIN != OFF && FEATURE4_PIN < 0 + #error "Configuration (Config.h): Setting FEATURE4_PIN unknown, use OFF or a valid microcontroller pin designation." +#endif +#if FEATURE5_PIN != OFF && FEATURE5_PIN < 0 + #error "Configuration (Config.h): Setting FEATURE5_PIN unknown, use OFF or a valid microcontroller pin designation." +#endif +#if FEATURE6_PIN != OFF && FEATURE6_PIN < 0 + #error "Configuration (Config.h): Setting FEATURE6_PIN unknown, use OFF or a valid microcontroller pin designation." +#endif +#if FEATURE7_PIN != OFF && FEATURE7_PIN < 0 + #error "Configuration (Config.h): Setting FEATURE7_PIN unknown, use OFF or a valid microcontroller pin designation." +#endif +#if FEATURE8_PIN != OFF && FEATURE8_PIN < 0 + #error "Configuration (Config.h): Setting FEATURE8_PIN unknown, use OFF or a valid microcontroller pin designation." +#endif + +#if FEATURE1_VALUE_DEFAULT != OFF && FEATURE1_VALUE_DEFAULT != ON && (FEATURE1_VALUE_DEFAULT < 0 || FEATURE1_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE1_VALUE_DEFAULT unknown, use OFF, ON or a value from 0 to 255 (for ANALOG_OUT.)" +#endif +#if FEATURE2_VALUE_DEFAULT != OFF && FEATURE2_VALUE_DEFAULT != ON && (FEATURE2_VALUE_DEFAULT < 0 || FEATURE2_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE2_VALUE_DEFAULT unknown, use OFF, ON or a value from 0 to 255 (for ANALOG_OUT.)" +#endif +#if FEATURE3_VALUE_DEFAULT != OFF && FEATURE3_VALUE_DEFAULT != ON && (FEATURE3_VALUE_DEFAULT < 0 || FEATURE3_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE3_VALUE_DEFAULT unknown, use OFF, ON or a value from 0 to 255 (for ANALOG_OUT.)" +#endif +#if FEATURE4_VALUE_DEFAULT != OFF && FEATURE4_VALUE_DEFAULT != ON && (FEATURE4_VALUE_DEFAULT < 0 || FEATURE4_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE4_VALUE_DEFAULT unknown, use OFF, ON or a value from 0 to 255 (for ANALOG_OUT.)" +#endif +#if FEATURE5_VALUE_DEFAULT != OFF && FEATURE5_VALUE_DEFAULT != ON && (FEATURE5_VALUE_DEFAULT < 0 || FEATURE5_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE5_VALUE_DEFAULT unknown, use OFF, ON or a value from 0 to 255 (for ANALOG_OUT.)" +#endif +#if FEATURE6_VALUE_DEFAULT != OFF && FEATURE6_VALUE_DEFAULT != ON && (FEATURE6_VALUE_DEFAULT < 0 || FEATURE6_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE6_VALUE_DEFAULT unknown, use OFF, ON or a value from 0 to 255 (for ANALOG_OUT.)" +#endif +#if FEATURE7_VALUE_DEFAULT != OFF && FEATURE7_VALUE_DEFAULT != ON && (FEATURE7_VALUE_DEFAULT < 0 || FEATURE7_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE7_VALUE_DEFAULT unknown, use OFF, ON or a value from 0 to 255 (for ANALOG_OUT.)" +#endif +#if FEATURE8_VALUE_DEFAULT != OFF && FEATURE8_VALUE_DEFAULT != ON && (FEATURE8_VALUE_DEFAULT < 0 || FEATURE8_VALUE_DEFAULT > 255) + #error "Configuration (Config.h): Setting FEATURE8_VALUE_DEFAULT unknown, use OFF, ON or a value from 0 to 255 (for ANALOG_OUT.)" +#endif + +#if FEATURE1_ON_STATE != HIGH && FEATURE1_ON_STATE != LOW + #error "Configuration (Config.h): Setting FEATURE1_ON_STATE unknown, use HIGH or LOW." +#endif +#if FEATURE2_ON_STATE != HIGH && FEATURE2_ON_STATE != LOW + #error "Configuration (Config.h): Setting FEATURE2_ON_STATE unknown, use HIGH or LOW." +#endif +#if FEATURE3_ON_STATE != HIGH && FEATURE3_ON_STATE != LOW + #error "Configuration (Config.h): Setting FEATURE3_ON_STATE unknown, use HIGH or LOW." +#endif +#if FEATURE4_ON_STATE != HIGH && FEATURE4_ON_STATE != LOW + #error "Configuration (Config.h): Setting FEATURE4_ON_STATE unknown, use HIGH or LOW." +#endif +#if FEATURE5_ON_STATE != HIGH && FEATURE5_ON_STATE != LOW + #error "Configuration (Config.h): Setting FEATURE5_ON_STATE unknown, use HIGH or LOW." +#endif +#if FEATURE6_ON_STATE != HIGH && FEATURE6_ON_STATE != LOW + #error "Configuration (Config.h): Setting FEATURE6_ON_STATE unknown, use HIGH or LOW." +#endif +#if FEATURE7_ON_STATE != HIGH && FEATURE7_ON_STATE != LOW + #error "Configuration (Config.h): Setting FEATURE7_ON_STATE unknown, use HIGH or LOW." +#endif +#if FEATURE8_ON_STATE != HIGH && FEATURE8_ON_STATE != LOW + #error "Configuration (Config.h): Setting FEATURE8_ON_STATE unknown, use HIGH or LOW." +#endif diff --git a/src/lib/1wire/1Wire.cpp b/src/lib/1wire/1Wire.cpp new file mode 100755 index 0000000..dcce178 --- /dev/null +++ b/src/lib/1wire/1Wire.cpp @@ -0,0 +1,10 @@ +// ----------------------------------------------------------------------------------- +// Dallas/Maxim 1-Wire library + +#include "1Wire.h" + +#if defined(DS1820_DEVICES_PRESENT) || (defined(GPIO_DEVICE) && GPIO_DEVICE == DS2413) + +OneWire oneWire(ONE_WIRE_PIN); + +#endif \ No newline at end of file diff --git a/src/lib/1wire/1Wire.h b/src/lib/1wire/1Wire.h new file mode 100755 index 0000000..4d86fbb --- /dev/null +++ b/src/lib/1wire/1Wire.h @@ -0,0 +1,13 @@ +// ----------------------------------------------------------------------------------- +// Dallas/Maxim 1-Wire library +#pragma once + +#include "../../Common.h" + +#if defined(DS1820_DEVICES_PRESENT) || (defined(GPIO_DEVICE) && GPIO_DEVICE == DS2413) + +#include // my OneWire library https://github.com/hjd1964/OneWire + +extern OneWire oneWire; + +#endif diff --git a/src/lib/Constants.h b/src/lib/Constants.h new file mode 100755 index 0000000..8789580 --- /dev/null +++ b/src/lib/Constants.h @@ -0,0 +1,202 @@ +// Library general purpose constants +#pragma once + +// misc. +#define AUTO -1 +#define OFF -1 +#define ON -2 +#define AUX -4 +#define MASTER -5 +#define SLAVE -6 +#define BOTH -7 +#define SoftSerial -8 +#define HardSerial -9 +#define CONSOLE -10 +#define PROFILER -11 +#define VERBOSE -12 +#define REMOTE -13 +#define WIFI_ACCESS_POINT -14 // shorthand for easy WIFI mode settings +#define WIFI_STATION -15 // shorthand for easy WIFI mode settings +#define BLUETOOTH -16 // shorthand for easy bluetooth mode settings +#define SHARED -17 +#define STANDARD -18 +#define PERSISTENT -19 +#define ERRORS_ONLY -20 +#define MINIMUM -21 +#define MIDDLE -22 +#define MAXIMUM -23 +#define INVALID -127 + +// CAN interface options +#define CAN_SAN 0 +#define CAN_ESP32 1 +#define CAN_MCP2515 2 +#define CAN0_TEENSY4 3 +#define CAN1_TEENSY4 4 +#define CAN2_TEENSY4 5 +#define CAN3_TEENSY4 6 + +// network interface options +#define ETHERNET_FIRST 1 +#define ETHERNET_W5100 1 +#define ETHERNET_W5500 2 +#define ETHERNET_TEENSY41 3 +#define ETHERNET_LAST 3 +#define WIFI_FIRST 4 +#define WIFI 4 +#define WIFI_LAST 4 + +// driver (step/dir interface, usually for stepper motors) +// changes here must be reflected in the StepDirDriver.cpp file, etc. +#define STEP_DIR_DRIVER_FIRST 0 +#define A4988 0 // allows M0,M1,M2 bit patterens for 1x,2x,4x,8x,16x +#define DRV8825 1 // allows M0,M1,M2 bit patterens for 1x,2x,4x,8x,16x,32x +#define GENERIC 2 // generic s/d driver allows for 1x,2x,4x,8x,16x,32x,64x,128x,256x (using just the M2 pin) +#define LV8729 3 // allows M0,M1,M2 bit patterens for 1x,2x,4x,8x,16x,32x,64x,128x +#define RAPS128 4 // allows M0,M1,M2 bit patterens for 1x,2x,4x,8x,16x,32x,64x,128x +#define S109 5 // allows M0,M1,M2 bit patterens for 1x,2x,4x,8x,16x,32x +#define ST820 6 // allows M0,M1,M2 bit patterens for 1x,2x,4x,8x,16x,32x,128x,256x +#define TMC2100 7 // allows M0,M1 bit patterens for 1x,2x,4x,16x (spreadCycle only, no 256x intpol) +#define TMC2130S 8 // allows M0,M1 bit patterens for 1x,2x,4x,16x (spreadCycle only, no 256x intpol) +#define TMC2208S 9 // allows M0,M1 bit patterens for 2x,4x,8x,16x (stealthChop default, uses 256x intpol) +#define TMC2225S 10 // allows M0,M1 bit patterens for 4x,8x,16x,32x (M2 sets spreadCycle/stealthChop, uses 256x intpol) +#define TMC2209S 11 // allows M0,M1 bit patterens for 8x,16x,32x,64x (M2 sets spreadCycle/stealthChop, uses 256x intpol) +#define TMC2226S 12 // allows M0,M1 bit patterens for 8x,16x,32x,64x (M2 sets spreadCycle/stealthChop, uses 256x intpol) +#define TMC_DRIVER_FIRST 13 +#define TMC2130 13 // uses TMC software SPI comms for 1x,2x...,256x (SPI sets spreadCycle/stealthChop etc.) +#define TMC2160 14 // uses TMC software SPI comms for 1x,2x...,256x (SPI sets spreadCycle/stealthChop etc.) +#define TMC2660 15 // uses TMC software SPI comms for 1x,2x...,256x (SPI sets spreadCycle/stealthChop etc.) +#define TMC5160 16 // uses TMC software SPI comms for 1x,2x...,256x (SPI sets spreadCycle/stealthChop etc.) +#define TMC5161 17 // uses TMC software SPI comms for 1x,2x...,256x (SPI sets spreadCycle/stealthChop etc.) +#define TMC_UART_DRIVER_FIRST 18 +#define TMC2208 18 // uses TMC software UART comms for 1x,2x...,256x (UART sets spreadCycle/stealthChop etc, dedicated RX/TX UART to each driver using index 0) +#define TMC2225 19 // uses TMC software UART comms for 1x,2x...,256x (UART sets spreadCycle/stealthChop etc, dedicated RX/TX UART to each driver using index 0) +#define TMC2209 20 // uses TMC software UART comms for 1x,2x...,256x (UART sets spreadCycle/stealthChop etc, dedicated RX/TX UART to each driver using index 0) +#define TMC2226 21 // uses TMC software UART comms for 1x,2x...,256x (UART sets spreadCycle/stealthChop etc, dedicated RX/TX UART to each driver using index 0) +#define STEP_DIR_DRIVER_LAST 21 + +// servo driver (usually for DC motors equipped with encoders) +// changes here must be reflected in the ServoDriver.cpp file, etc. +#define SERVO_DRIVER_FIRST 100 +#define SERVO_PE 100 // SERVO, direction (phase) and pwm (enable) connections +#define SERVO_EE 101 // SERVO, dual pwm input (enable/enable) connections +#define SERVO_TMC2130_DC 102 // TMC2130 DC motor control +#define SERVO_TMC5160_DC 103 // TMC5160 DC motor control +#define SERVO_TMC2209 104 // TMC2209 stepper driver using VACTUAL velocity control +#define SERVO_TMC5160 105 // TMC5160 stepper driver using VMAX velocity control +#define SERVO_KTECH 106 // KTech servo motor using velocity control +#define SERVO_DRIVER_LAST 106 + +// integrated motor drivers +#define MOTOR_DRIVER_FIRST 200 +#define ODRIVE 200 // First generation ODrive (axis 1 and 2 only), EXPERIMENTAL! +#define KTECH 201 // KTech CAN driver +#define MKS42D 202 // MKS SERVO 42D, EXPERIMENTAL! +#define MKS57D 202 // MKS SERVO 57D, EXPERIMENTAL! +#define MOTOR_DRIVER_LAST 202 + +// driver (step/dir) decay mode +#define DRIVER_DECAY_MODE_FIRST 1 +#define MIXED 1 +#define FAST 2 +#define SLOW 3 +#define SPREADCYCLE 4 +#define STEALTHCHOP 5 +#define DRIVER_DECAY_MODE_LAST 6 + +// servo encoder (must match Encoder library) +#define ENC_FIRST 1 +#define AB 1 // AB quadrature encoder +#define AB_ESP32 2 // AB quadrature encoder (using fast ESP32 hardware decode) +#define CW_CCW 3 // clockwise/counter-clockwise encoder +#define PULSE_DIR 4 // pulse/direction encoder +#define PULSE_ONLY 5 // pulse only encoder (uses hint for direction) +#define VIRTUAL 6 // virtual encoder (uses hints for velocity and direction) +#define AS37_H39B_B 7 // Broadcom AS37-H39B-B BISS-C interface encoder +#define JTW_24BIT 8 // JTW Trident BISS-C interface 24bit encoder +#define JTW_26BIT 9 // JTW Trident BISS-C interface 26bit encoder +#define LIKA_ASC85 10 // Lika ASC85 BISS-C interface 25bit encoder (experimental) +#define KTECH_IME 11 // KTech in motor encoder +#define SERIAL_BRIDGE 12 // serial bridge to encoders +#define ENC_LAST 12 + +// encoder filter types +#define ENC_FILT_FIRST 1 +#define KALMAN 1 // more advanced, predictive +#define ROLLING 2 // basic, rolling average +#define WINDOWING ROLLING // deprecated compatibility alias for rolling average +#define LEARNING 4 // learning, for RA axis only (experimental may be removed) +#define ENC_FILT_LAST 4 + +// servo feedback (must match Encoder library) +#define SERVO_FEEDBACK_FIRST 1 +#define PID 1 // PID feedback +#define DUAL_PID 2 // Dual PID feedback +#define SERVO_FEEDBACK_LAST 2 + +// driver (step/dir) and servo, misc. +#define ODRIVER -10 // general purpose flag for a ODRIVE driver motor +#define SERVO -11 // general purpose flag for a SERVO driver motor +#define STEP_DIR -12 // general purpose flag for a STEP_DIR driver motor + +// NV/EEPROM +#define NV_KEY_VALUE 111111111UL + +#define NV_DEF 0 +#define NV_DEFAULT 0 // PLATFORM SPECIFIC (HAL) +#define NV_EEPROM 1 // EEPROM.h +#define NV_ESP 2 // ESP8266/ESP32 EEPROM emulation with commits +#define NV_M0 3 // Arduino M0 EEPROM emulation with commits +#define NV_2416 4 // 2KB I2C EEPROM AT DEFAULT ADDRESS 0x50 +#define NV_2432 5 // 4KB I2C EEPROM AT DEFAULT ADDRESS 0x50 +#define NV_2464 6 // 8KB I2C EEPROM AT DEFAULT ADDRESS 0x50 +#define NV_24128 7 // 16KB I2C EEPROM AT DEFAULT ADDRESS 0x50 +#define NV_24256 8 // 32KB I2C EEPROM AT DEFAULT ADDRESS 0x50 +#define NV_AT24C32 9 // 4KB I2C EEPROM AT DEFAULT ADDRESS 0x57 (ZS042 module for instance) +#define NV_MB85RC32 10 // 4KB I2C FRAM AT DEFAULT ADDRESS 0x50 +#define NV_MB85RC64 11 // 8KB I2C FRAM AT DEFAULT ADDRESS 0x50 +#define NV_MB85RC256 12 // 32KB I2C FRAM AT DEFAULT ADDRESS 0x50 + +#define NVE_LOW 0 // low (< 100K writes) +#define NVE_MID 1 // mid (~ 100K writes) +#define NVE_HIGH 2 // high (~ 1M writes) +#define NVE_VHIGH 3 // very high (> 300M writes, FRAM) + +// GPIO devices (pin# 512 up to 543) +// these can work for most digital I/O EXCEPT: STEP/DIR, 1-WIRE/I2C/SPI (CS is ok), the ST4 port, and the PPS pin +#define GPIO_FIRST 1 +#define DS2413 1 // DS2413 2-channel GPIO +#define MCP23008 2 // MCP23008 8-channel GPIO +#define MCP23017 3 // MCP23017 16-channel GPIO +#define X9555 4 // TCA/PCA9555 16-channel GPIO +#define X8574 5 // PCF8574 8-channel GPIO (up to 4) +#define X8575 6 // PCF8575 16-channel GPIO +#define SWS 7 // Smart Web Server 8-channel GPIO (usually on the four Encoder pins, if otherwise unused) +#define SSR74HC595 8 // 74HC595 8,16,24,32-channel GPIO (serial shift register, output only) +#define GPIO_LAST 8 + +// angular +#define RAD_DEG_RATIO 57.29577951308232L +#define RAD_DEG_RATIO_F 57.295780F +#define RAD_HOUR_RATIO 3.819718634205488L +#define RAD_HOUR_RATIO_F 3.8197186F +#define SIDEREAL_RATIO 1.002737909350795L +#define SIDEREAL_RATIO_F 1.0027379F +#define SIDEREAL_PERIOD 15956313.06126534L +#define SIDEREAL_RATE_HZ 60.16427456104770L +#define SOLAR_RATE_HZ 60.0L +#define LUNAR_RATE_HZ 57.9L +#define KING_RATE_HZ 60.136L +#define Deg10 0.174532925199432L +#define Deg20 0.349065850398865L +#define Deg45 0.785398163397448L +#define Deg60 1.047197551196597L +#define Deg85 1.483529864195180L +#define Deg90 1.570796326794896L +#define Deg180 3.141592653589793L +#define Deg360 6.283185307179586L + +// for handling degenerate spherical coordinates near the poles +#define TenthArcSec 0.000000484813681L +#define OneArcSec 0.000004848136811L +#define SmallestFloat 0.0000005F diff --git a/src/lib/Macros.h b/src/lib/Macros.h new file mode 100755 index 0000000..1c13a65 --- /dev/null +++ b/src/lib/Macros.h @@ -0,0 +1,291 @@ +// Library general purpose macros +#pragma once + +// conversion math +#define degToArcsecF(x) ((x)/3600.0F) +#define degToRad(x) ((x)/(double)RAD_DEG_RATIO) +#define degToRadF(x) ((x)/(double)RAD_DEG_RATIO_F) +#define radToDeg(x) ((x)*(double)RAD_DEG_RATIO) +#define radToDegF(x) ((x)*(double)RAD_DEG_RATIO_F) +#define hrsToRad(x) ((x)/(double)RAD_HOUR_RATIO) +#define radToHrs(x) ((x)*(double)RAD_HOUR_RATIO) +#define arcsecToRad(x) ((x)/(double)206264.8062470963L) +#define radToArcsec(x) ((x)*(double)206264.8062470963L) +#define siderealToRad(x) ((x)/(double)13750.98708313975L) +#define siderealToRadF(x) ((x)/13750.987F) +#define radToSidereal(x) ((x)*(double)13750.98708313975L) +#define hzToSubMicros(x) ((x)*(double)266666.666666667L) +#define hzToSidereal(x) ((x)/(double)SIDEREAL_RATE_HZ) +#define siderealToHz(x) ((x)*(double)SIDEREAL_RATE_HZ) +#define fequal(x,y) (fabs((x)-(y))SmallestFloat) +#define flt(x,y) ((y)-(x)>SmallestFloat) +#define NormalizeAzimuth(x) (x<0.0L?x+360.0L:x) + +// strings + +// tests if strings are equal +#define strequ(str1, str2) (strlen(str1) != strlen(str2) ? 0 : strstr(str1, str2)) + +// safe string copy from (char*)source to (char *)dest for a destination array of size bytes +#define sstrcpy(dest, source) do { \ + int16_t _cap = sizeof(dest); \ + if (_cap) { \ + int16_t _i = 0; \ + for (; _i + 1 < _cap && (source)[_i]; ++_i) { \ + (dest)[_i] = (source)[_i]; \ + } \ + (dest)[_i] = '\0'; \ + } \ +} while (0) + +#define sstrcpyex(dest, source, cap) do { \ + if (cap) { \ + int16_t _i = 0; \ + for (; _i + 1 < cap && (source)[_i]; ++_i) { \ + (dest)[_i] = (source)[_i]; \ + } \ + (dest)[_i] = '\0'; \ + } \ +} while (0) + +// safe string append from (char*)source to (char*)dest for a destination array of size bytes +#define sstrcat(dest, source) do { \ + int16_t _cap = sizeof(dest); \ + if (_cap) { \ + int16_t _i = 0; \ + while (_i < _cap && (dest)[_i]) ++_i; \ + if (_i >= _cap) { \ + (dest)[_cap - 1] = '\0'; \ + } else { \ + int16_t _j = 0; \ + for (; _i + 1 < _cap && (source)[_j]; ++_i, ++_j) { \ + (dest)[_i] = (source)[_j]; \ + } \ + (dest)[_i] = '\0'; \ + } \ + } \ +} while (0) + +#define sstrcatex(dest, source, cap) do { \ + int16_t _cap = (cap); \ + if (_cap) { \ + int16_t _i = 0; \ + while (_i < _cap && (dest)[_i]) ++_i; \ + if (_i >= _cap) { \ + (dest)[_cap - 1] = '\0'; \ + } else { \ + int16_t _j = 0; \ + for (; _i + 1 < _cap && (source)[_j]; ++_i, ++_j) { \ + (dest)[_i] = (source)[_j]; \ + } \ + (dest)[_i] = '\0'; \ + } \ + } \ +} while (0) + +// safe single-character append for a destination array of size bytes +#define sstrcatc(dest, value) do { \ + int16_t _cap = sizeof(dest); \ + if (_cap) { \ + int16_t _i = 0; \ + while (_i < _cap && (dest)[_i]) ++_i; \ + if (_i >= _cap) { \ + (dest)[_cap - 1] = '\0'; \ + } else if (_i + 1 < _cap) { \ + (dest)[_i] = (value); \ + (dest)[_i + 1] = '\0'; \ + } \ + } \ +} while (0) + +#define sstrcatcex(dest, value, cap) do { \ + int16_t _cap = (cap); \ + if (_cap) { \ + int16_t _i = 0; \ + while (_i < _cap && (dest)[_i]) ++_i; \ + if (_i >= _cap) { \ + (dest)[_cap - 1] = '\0'; \ + } else if (_i + 1 < _cap) { \ + (dest)[_i] = (value); \ + (dest)[_i + 1] = '\0'; \ + } \ + } \ +} while (0) + +// truncate a string so there is room for reserve bytes plus the null terminator +#define sstrreserve(dest, reserve) do { \ + int16_t _cap = sizeof(dest); \ + int16_t _reserve = (reserve); \ + if (_cap) { \ + if (_reserve >= _cap) { \ + (dest)[0] = '\0'; \ + } else { \ + int16_t _max = _cap - _reserve - 1; \ + int16_t _i = 0; \ + while (_i < _cap && (dest)[_i]) ++_i; \ + if (_i >= _cap) { \ + (dest)[_cap - 1] = '\0'; \ + _i = _cap - 1; \ + } \ + if (_i > _max) (dest)[_max] = '\0'; \ + } \ + } \ +} while (0) + +#define sstrreserveex(dest, reserve, cap) do { \ + int16_t _cap = (cap); \ + int16_t _reserve = (reserve); \ + if (_cap) { \ + if (_reserve >= _cap) { \ + (dest)[0] = '\0'; \ + } else { \ + int16_t _max = _cap - _reserve - 1; \ + int16_t _i = 0; \ + while (_i < _cap && (dest)[_i]) ++_i; \ + if (_i >= _cap) { \ + (dest)[_cap - 1] = '\0'; \ + _i = _cap - 1; \ + } \ + if (_i > _max) (dest)[_max] = '\0'; \ + } \ + } \ +} while (0) + +// convert string to lower case +#define strtolower(source) for (int i = 0; source[i]; i++) source[i] = tolower(source[i]) + +#define _allowed_fqdn "0123456789abcdefghijklmnopqrstuvwxyz" +// convert to lower case and strip away characters that aren't allowed in an hostname +#define strtohostname(source) for (int i = 0; source[i]; i++) { source[i] = tolower(source[i]); if (!strchr(_allowed_fqdn "-", source[i])) { if (i < (int)(strlen(source) - 1)) { memmove(&source[i], &source[i + 1], strlen(&source[i])); i--; } else source[i] = 0;; } } + +// convert to lower case and strip away characters that aren't allowed in an hostname (and '-') +#define strtohostname2(source) for (int i = 0; source[i]; i++) { source[i] = tolower(source[i]); if (!strchr(_allowed_fqdn, source[i])) { if (i < (int)(strlen(source) - 1)) { memmove(&source[i], &source[i + 1], strlen(&source[i])); i--; } else source[i] = 0;; } } + +// embeds a string in a macro +#define STR_HELPER(x) #x +#define STR(x) STR_HELPER(x) + +// ip address helper copies from one ip[4] address to another +#define ip4toip4(ip4, ip) for (int i = 0; i < 4; i++) ip4[i] = ip[i] + +// check for an invalid ip[4] address of 0:0:0:0 +#define validip4(ip4) (ip4[0]!=0?true:ip4[1]!=0?true:ip4[2]!=0?true:ip4[3]!=0?true:false) + +// an empty string +#ifndef EmptyStr + #define EmptyStr "" +#endif + +// pins +#define DAC_PIN(v) ((v)+0x100) +#define GPIO_PIN(v) ((v)+0x200) + +// sense +#define THLD(v) ((v)<<1) // 10 bit analog threshold, bits 1 through 10 +#define HYST(v) ((v)<<11) // 10 bit hysteresis, bits 11 through 20 +#define ANLG(v) ((v)<<21) // 10 bit analog value, bits 21 through 30 +#ifndef INPUT_PULLDOWN + #define INPUT_PULLDOWN INPUT +#endif + +#define RANGE_FROM_BITS(bits) ((1 << (bits)) - 1) + +#define BITS_FROM_RANGE(R) ( \ + (R)<=1?1 : (R)<=3?2 : (R)<=7?3 : (R)<=15?4 : (R)<=31?5 : (R)<=63?6 : \ + (R)<=127?7 : (R)<=255?8 : (R)<=511?9 : (R)<=1023?10 : (R)<=2047?11 : \ + (R)<=4095?12 : (R)<=8191?13 : (R)<=16383?14 : (R)<=32767?15 : 16 ) + +#define IS_POW2_MINUS1(R) ((R) > 0 && (R) < 0xFFFFFFFFU && (((R) + 1) & (R)) == 0) + +// Atomic helpers for single ISR-shared scalars. +// Use for single reads/writes/RMW only. For multi-variable invariants, keep cli/sei blocks. +#if defined(__GNUC__) || defined(__clang__) + + #define ATOMIC_LOAD(var) (__atomic_load_n(&(var), __ATOMIC_ACQUIRE)) + #define ATOMIC_STORE(var, val) (__atomic_store_n(&(var), (val), __ATOMIC_RELEASE)) + #define ATOMIC_XCHG(var, val) (__atomic_exchange_n(&(var), (val), __ATOMIC_ACQ_REL)) + + // Read/Modify/Write bit ops (return previous value) + #define ATOMIC_OR(var, mask) (__atomic_fetch_or(&(var), (mask), __ATOMIC_ACQ_REL)) + #define ATOMIC_AND(var, mask) (__atomic_fetch_and(&(var), (mask), __ATOMIC_ACQ_REL)) + +#else + + #define ATOMIC_LOAD(var) \ + ({ __typeof__(var) _v; noInterrupts(); _v = (var); interrupts(); _v; }) + + #define ATOMIC_STORE(var, val) \ + do { noInterrupts(); (var) = (val); interrupts(); } while (0) + + #define ATOMIC_XCHG(var, val) \ + ({ __typeof__(var) _old; noInterrupts(); _old = (var); (var) = (val); interrupts(); _old; }) + + // Read/Modify/Write bit ops (return previous value) + #define ATOMIC_OR(var, mask) \ + ({ __typeof__(var) _old; noInterrupts(); _old = (var); (var) = (__typeof__(var))(_old | (__typeof__(var))(mask)); interrupts(); _old; }) + + #define ATOMIC_AND(var, mask) \ + ({ __typeof__(var) _old; noInterrupts(); _old = (var); (var) = (__typeof__(var))(_old & (__typeof__(var))(mask)); interrupts(); _old; }) + +#endif + +// Fast GPIO read/write for Arduino-ESP32 cores 2.x / 3.x +// Works across ESP32 / ESP32-S2 / ESP32-S3 +#if defined(CONFIG_IDF_TARGET_ESP32) || defined(CONFIG_IDF_TARGET_ESP32S2) || defined(CONFIG_IDF_TARGET_ESP32S3) + #include "soc/gpio_struct.h" + + // SOC_GPIO_PIN_COUNT exists in ESP-IDF-based cores; core 1.x may be missing it. + #if defined(__has_include) + #if __has_include("soc/soc_caps.h") + #include "soc/soc_caps.h" + #endif + #endif + + static inline IRAM_ATTR void gpioWriteFast(uint32_t pin, uint32_t level) { + if (pin >= (uint32_t)SOC_GPIO_PIN_COUNT) return; + uint32_t mask = 1UL << (pin & 31U); + if (pin < 32U) { if (level) GPIO.out_w1ts = mask; else GPIO.out_w1tc = mask; } + #if SOC_GPIO_PIN_COUNT > 32 + else { if (level) GPIO.out1_w1ts.val = mask; else GPIO.out1_w1tc.val = mask; } + #endif + } + #ifndef digitalWriteF + #define digitalWriteF(pin,value) gpioWriteFast((uint32_t)(pin), (uint32_t)(value)) + #endif + + static inline IRAM_ATTR uint32_t gpioReadFast(uint32_t pin) { + if (pin >= (uint32_t)SOC_GPIO_PIN_COUNT) return 0; + uint32_t mask = 1UL << (pin & 31U); + if (pin < 32U) { return (GPIO.in & mask) ? 1U : 0U; } + #if SOC_GPIO_PIN_COUNT > 32 + else { return (GPIO.in1.data & mask) ? 1U : 0U; } + #else + return 0; + #endif + } + #ifndef digitalReadF + #define digitalReadF(pin) gpioReadFast((uint32_t)(pin)) + #endif +#endif + +// automatically use fast I/O if available +#ifndef digitalReadF + #ifdef HAL_HAS_DIGITAL_FAST + #define digitalReadF(pin) ( digitalReadFast(pin) ) + #else + #define digitalReadF(pin) ( digitalRead(pin) ) + #endif +#endif +#ifndef digitalWriteF + #ifdef HAL_HAS_DIGITAL_FAST + #define digitalWriteF(pin,value) { digitalWriteFast(pin,value); } + #else + #define digitalWriteF(pin,value) { digitalWrite(pin,value); } + #endif +#endif + +// supress compiler warnings for unused parameters +#ifndef UNUSED + #define UNUSED(x) (void)(x) +#endif diff --git a/src/lib/analog/Analog.cpp b/src/lib/analog/Analog.cpp new file mode 100755 index 0000000..128dc5c --- /dev/null +++ b/src/lib/analog/Analog.cpp @@ -0,0 +1,660 @@ +// Analog.cpp +#include + +#include "Analog.h" + +// this was only for pin 38 of a Teensy4.1, now any pin +#if defined(ARDUINO_TEENSY41) && defined(PWM_CUSTOM_PIN) && \ + defined(PWM_CUSTOM_ANALOG_WRITE_FREQUENCY) && defined(PWM_CUSTOM_ANALOG_WRITE_RANGE) + #define HAS_CUSTOM_PIN +#endif + +#ifdef HAS_CUSTOM_PIN + static IntervalTimer itimer4; + static volatile uint16_t _pwm_custom_period = 0; + static volatile uint8_t _pwm_custom_toggle = 0; + static float _base_freq_divider = PWM_CUSTOM_ANALOG_WRITE_FREQUENCY/(1.0F/(PWM_CUSTOM_ANALOG_WRITE_RANGE/1000000.0F)); + + void PWM_CUSTOM_HWTIMER() { + if (_pwm_custom_period == 0 || _pwm_custom_period == PWM_CUSTOM_ANALOG_WRITE_RANGE) { + itimer4.update(PWM_CUSTOM_ANALOG_WRITE_RANGE/_base_freq_divider); + digitalWriteF(PWM_CUSTOM_PIN, _pwm_custom_period == PWM_CUSTOM_ANALOG_WRITE_RANGE); + _pwm_custom_toggle = 0; + return; + } else { + if (!_pwm_custom_toggle) { + itimer4.update((PWM_CUSTOM_ANALOG_WRITE_RANGE - _pwm_custom_period)/_base_freq_divider); + digitalWriteF(PWM_CUSTOM_PIN, LOW); + } else { + itimer4.update(_pwm_custom_period/_base_freq_divider); + digitalWriteF(PWM_CUSTOM_PIN, HIGH); + } + } + _pwm_custom_toggle = !_pwm_custom_toggle; + } + + #define analogWriteCustomPin(x) do { \ + uint32_t _v = (uint32_t)(x); \ + if (_v > (uint32_t)PWM_CUSTOM_ANALOG_WRITE_RANGE) _v = (uint32_t)PWM_CUSTOM_ANALOG_WRITE_RANGE; \ + _pwm_custom_period = (uint16_t)_v; \ + } while (0) +#endif + +// track actual global resolution when platform only supports global reconfig. +// keeps behavior honest (no "virtual range trick"). +static uint16_t gPwmBits = (uint16_t)BITS_FROM_RANGE(ANALOG_WRITE_RANGE); +static uint16_t gAdcBits = (uint16_t)BITS_FROM_RANGE(ANALOG_READ_RANGE); +static volatile bool ready = false; + +static inline bool toCorePin(int16_t pin, uint8_t &out) { + if (!ready) return false; // not initialized + if (pin == OFF) return false; + if (pin < 0) return false; // reject any other negative + if (pin > 0xFF) return false; // prevents wrap on platforms with >255 pins + out = (uint8_t)pin; + return true; +} + +static inline uint32_t clampU32(uint32_t v, uint32_t lo, uint32_t hi) { + if (v < lo) return lo; + if (v > hi) return hi; + return v; +} + +static inline float clamp01(float x) { + if (isnan(x) || isinf(x)) return 0.0F; + if (x < 0.0F) return 0.0F; + if (x > 1.0F) return 1.0F; + return x; +} + +static inline uint32_t rangeFromBits(uint16_t bits) { + if (bits == 0) return 0; + if (bits >= 32) return 0xFFFFFFFFu; + return (1u << bits) - 1u; +} + +int AnalogClass::pwmIndex(int16_t pin) const { + for (int i = 0; i < MAX_TRACKED; i++) if (pwm_[i].pin == pin) return i; + for (int i = 0; i < MAX_TRACKED; i++) if (pwm_[i].pin == OFF) return i; + return -1; +} + +int AnalogClass::adcIndex(int16_t pin) const { + for (int i = 0; i < MAX_TRACKED; i++) if (adc_[i].pin == pin) return i; + for (int i = 0; i < MAX_TRACKED; i++) if (adc_[i].pin == OFF) return i; + return -1; +} + +// prepare global adc read resolution and global pwm write resolution/frequency +void AnalogClass::begin() { + if (ready) return; + + VLF("MSG: Analog, begin"); + + // ADC global default + (void)gAdcBits; + #if HAL_HAS_GLOBAL_ADC_RESOLUTION + const uint16_t adcBits = (uint16_t)BITS_FROM_RANGE(ANALOG_READ_RANGE); + analogReadResolution(adcBits); + gAdcBits = adcBits; + #endif + + // PWM global default (ONLY if your platform truly uses a global resolution) + (void)gPwmBits; + #if HAL_HAS_GLOBAL_PWM_RESOLUTION && !HAL_HAS_PER_PIN_PWM_RESOLUTION + const uint16_t pwmBits = (uint16_t)BITS_FROM_RANGE(ANALOG_WRITE_RANGE); + analogWriteResolution(pwmBits); + gPwmBits = pwmBits; + VF("MSG: Analog, pwmInit global PWM resolution changed to bits="); VL(pwmBits); + #endif + + // PWM global freq (again: only if global is real on that platform) + #if defined(ANALOG_WRITE_FREQUENCY) && HAL_HAS_GLOBAL_PWM_FREQUENCY + analogWriteFrequency(ANALOG_WRITE_FREQUENCY); + VF("MSG: Analog, pwmInit global PWM freq changed to hz="); VL(ANALOG_WRITE_FREQUENCY); + #endif + + ready = true; +} + +// ---------------- PWM ---------------- + +bool AnalogClass::pwmInit(int16_t pin, const AnalogPwmConfig& cfg) { + uint8_t p; + if (!toCorePin(pin, p)) { + DF("ERR: Analog, pwmInit invalid pin="); DL(pin); + return false; + } + + const int idx = pwmIndex(pin); + if (idx < 0) { DF("ERR: Analog, pwmInit table full pin="); DL(pin); return false; } + const uint32_t defRange = (uint32_t)ANALOG_WRITE_RANGE; + uint16_t reqBits = cfg.bits; + uint32_t reqRange = cfg.range; + uint32_t reqHz = cfg.hz; + + // if this is a T4.1 allow one extra custom PWM pin + #ifdef HAS_CUSTOM_PIN + if (pin == PWM_CUSTOM_PIN) { + pinMode(PWM_CUSTOM_PIN, OUTPUT); + pwm_[idx].custom = true; + itimer4.priority(0); + itimer4.begin(PWM_CUSTOM_HWTIMER, 100); + VF("MSG: Analog, pwmInit emulating PWM using Teensy4.1 iTimer4 on pin"); VL(pin); + reqBits = BITS_FROM_RANGE(PWM_CUSTOM_ANALOG_WRITE_RANGE); + reqRange = PWM_CUSTOM_ANALOG_WRITE_RANGE; + reqHz = PWM_CUSTOM_ANALOG_WRITE_FREQUENCY; + } else pwm_[idx].custom = false; + #endif + + if (!pwm_[idx].custom) { + + // derive bits from range if only range provided (range must be 2^n-1) + if (reqBits == 0 && reqRange != 0) { + if (reqRange == 0xFFFFFFFFu) { + DF("ERR: Analog, pwmInit range wrap pin="); D(pin); DF(" range="); DL(reqRange); + return false; + } + uint32_t r = reqRange + 1; + if ((r & (r - 1)) != 0) { + DF("ERR: Analog, pwmInit range not 2^n-1 pin="); D(pin); DF(" range="); DL(reqRange); + return false; + } + uint16_t b = 0; + while (r >>= 1) b++; + reqBits = b; + } + + // derive range from bits or default + if (reqBits == 0 && reqRange == 0) { + reqRange = defRange; + } else if (reqRange == 0 && reqBits != 0) { + reqRange = rangeFromBits(reqBits); + } + + #ifdef ANALOG_WRITE_FREQUENCY + if (reqHz == 0) { + reqHz = ANALOG_WRITE_FREQUENCY; + } + #endif + + // bounds + if (reqBits) { + if (reqBits < HAL_PWM_BITS_MIN || reqBits > HAL_PWM_BITS_MAX) { + DF("ERR: Analog, pwmInit bits out of bounds pin="); D(pin); + DF(" bits="); D(reqBits); DF(" ("); D(HAL_PWM_BITS_MIN); DF(".."); D(HAL_PWM_BITS_MAX); DLF(")"); + return false; + } + } + if (reqHz) { + if (reqHz < HAL_PWM_HZ_MIN || reqHz > HAL_PWM_HZ_MAX) { + DF("ERR: Analog, pwmInit hz out of bounds pin="); D(pin); + DF(" hz="); D(reqHz); DF(" ("); D(HAL_PWM_HZ_MIN); DF(".."); D(HAL_PWM_HZ_MAX); DLF(")"); + return false; + } + } + + // --- APPLY (best-effort) --- + + // warn generally the "per-pin resolutions/frequencies" can still affect other pins if the core + // maps channels to shared timers. This may interfere with tone() or other PWM users. + static bool warned = false; + (void)warned; + + // frequency + if (reqHz) { + #if HAL_HAS_PER_PIN_PWM_FREQUENCY + analogWriteFrequency(p, reqHz); + if (!warned) { + warned = true; + VLF("WRN: Analog, adding new resolutions/frequencies may affect other PWM pins (tone, servo, due to shared timers.)"); + } + #elif HAL_HAS_GLOBAL_PWM_FREQUENCY + if (!HAL_ALLOW_GLOBAL_PWM_RECONFIG) { + DF("ERR: Analog, pwmInit global PWM freq reconfig disallowed pin="); DL(pin); + return false; + } + analogWriteFrequency(reqHz); + VF("WRN: Analog, pwmInit global PWM freq changed hz="); VL(reqHz); + #else + DF("ERR: Analog, pwmInit no PWM frequency control pin="); DL(pin); + return false; + #endif + } + + // resolution + if (reqBits) { + #if HAL_HAS_PER_PIN_PWM_RESOLUTION + analogWriteResolution(p, reqBits); + if (!warned) { + warned = true; + VLF("WRN: Analog, adding new resolutions/frequencies may affect other PWM pins (tone, servo, due to shared timers.)"); + } + #elif HAL_HAS_GLOBAL_PWM_RESOLUTION + if (reqBits != gPwmBits) { + if (!HAL_ALLOW_GLOBAL_PWM_RECONFIG) { + DF("ERR: Analog, pwmInit global PWM resolution reconfig disallowed pin="); D(pin); + DF(" reqBits="); D(reqBits); + DF(" currentBits="); DL(gPwmBits); + return false; + } + analogWriteResolution(reqBits); + gPwmBits = reqBits; + VF("WRN: Analog, pwmInit global PWM bits set bits="); VL(reqBits); + } + #else + DF("ERR: Analog, pwmInit no PWM resolution control pin="); DL(pin); + return false; + #endif + } else reqBits = gPwmBits; + } + + pwm_[idx].pin = pin; + pwm_[idx].bits = reqBits; + pwm_[idx].hz = reqHz; + pwm_[idx].range = reqRange ? reqRange : defRange; + + VF("MSG: Analog, pwmInit ok pin="); V(pin); + VF(" bits="); V(reqBits); + VF(" hz="); V(reqHz); + VF(" range="); VL(pwm_[idx].range); + + return true; +} + +AnalogPwmHandle AnalogClass::pwmInitHandle(int16_t pin, const AnalogPwmConfig& cfg) { + AnalogPwmHandle h; + h.pin = 0; + h.idx = ANALOG_INVALID_IDX; + + uint8_t p; + if (!toCorePin(pin, p)) { + DF("ERR: Analog pwmInitHandle invalid pin="); DL(pin); + return h; + } + if (!pwmInit(pin, cfg)) { + // pwmInit already emits the detailed error path + return h; + } + + // find the committed slot for this pin (no allocation now, should hit first loop) + int idx = -1; + for (int i = 0; i < MAX_TRACKED; i++) if (pwm_[i].pin == pin) { idx = i; break; } + if (idx < 0 || idx > 0xFE) { + DF("ERR: Analog pwmInitHandle slot not found pin="); DL(pin); + return h; + } + + h.pin = p; + h.idx = (uint8_t)idx; + return h; +} + +uint32_t AnalogClass::pwmRange(int16_t pin) const { + const uint32_t fallback = (uint32_t)ANALOG_WRITE_RANGE; + + #ifdef HAS_CUSTOM_PIN + if (pin == (int16_t)PWM_CUSTOM_PIN) { + for (int i = 0; i < MAX_TRACKED; i++) + if (pwm_[i].pin == pin) return pwm_[i].range ? pwm_[i].range : fallback; + return (uint32_t)PWM_CUSTOM_ANALOG_WRITE_RANGE; + } + #endif + + // if only global PWM resolution exists, report the true global range + #if HAL_HAS_GLOBAL_PWM_RESOLUTION && !HAL_HAS_PER_PIN_PWM_RESOLUTION + return rangeFromBits(gPwmBits); + #endif + + for (int i = 0; i < MAX_TRACKED; i++) { + if (pwm_[i].pin == pin) return pwm_[i].range ? pwm_[i].range : fallback; + } + return fallback; +} + +void AnalogClass::write(int16_t pin, uint32_t v) { + uint8_t p; + if (!toCorePin(pin, p)) { + VF("WRN: Analog write(u32) invalid pin="); VL(pin); + return; + } + + const uint32_t r = pwmRange(pin); + v = clampU32(v, 0, r); + + #ifdef HAS_CUSTOM_PIN + if (p == (uint8_t)PWM_CUSTOM_PIN) { analogWriteCustomPin(v); } else + #endif + analogWrite(p, (int)v); +} + +void AnalogClass::write(int16_t pin, float x01) { + uint8_t p; + if (!toCorePin(pin, p)) { + VF("WRN: Analog write(f) invalid pin="); VL(pin); + return; + } + + x01 = clamp01(x01); + const uint32_t r = pwmRange(pin); + const uint32_t v = (uint32_t)lroundf(x01 * (float)r); + + #ifdef HAS_CUSTOM_PIN + if (p == (uint8_t)PWM_CUSTOM_PIN) { analogWriteCustomPin(v); } else + #endif + analogWrite(p, (int)v); +} + +void AnalogClass::writeQ16(int16_t pin, uint16_t q16) { + uint8_t p; + if (!toCorePin(pin, p)) { + VF("WRN: Analog writeQ16 invalid pin="); VL(pin); + return; + } + + const uint32_t r = pwmRange(pin); + const uint32_t v = (uint32_t)((((uint64_t)q16) * (uint64_t)r + 32767ULL) / 65535ULL); + + #ifdef HAS_CUSTOM_PIN + if (p == (uint8_t)PWM_CUSTOM_PIN) { analogWriteCustomPin(v); } else + #endif + analogWrite(p, (int)v); +} + +void AnalogClass::write(const AnalogPwmHandle& h, uint32_t v) { + if (h.idx == ANALOG_INVALID_IDX) return; + + uint32_t r; + #ifdef HAS_CUSTOM_PIN + if (h.pin == (uint8_t)PWM_CUSTOM_PIN) { + r = pwm_[h.idx].range ? pwm_[h.idx].range : (uint32_t)PWM_CUSTOM_ANALOG_WRITE_RANGE; + } else + #endif + #if HAL_HAS_GLOBAL_PWM_RESOLUTION && !HAL_HAS_PER_PIN_PWM_RESOLUTION + r = rangeFromBits(gPwmBits); + #else + r = pwm_[h.idx].range ? pwm_[h.idx].range : (uint32_t)ANALOG_WRITE_RANGE; + #endif + + v = clampU32(v, 0, r); + + #ifdef HAS_CUSTOM_PIN + if (h.pin == (uint8_t)PWM_CUSTOM_PIN) { analogWriteCustomPin(v); } else + #endif + analogWrite(h.pin, (int)v); +} + +void AnalogClass::write(const AnalogPwmHandle& h, float x01) { + if (h.idx == ANALOG_INVALID_IDX) return; + + x01 = clamp01(x01); + + uint32_t r; + #ifdef HAS_CUSTOM_PIN + if (h.pin == (uint8_t)PWM_CUSTOM_PIN) { + r = pwm_[h.idx].range ? pwm_[h.idx].range : (uint32_t)PWM_CUSTOM_ANALOG_WRITE_RANGE; + } else + #endif + #if HAL_HAS_GLOBAL_PWM_RESOLUTION && !HAL_HAS_PER_PIN_PWM_RESOLUTION + r = rangeFromBits(gPwmBits); + #else + r = pwm_[h.idx].range ? pwm_[h.idx].range : (uint32_t)ANALOG_WRITE_RANGE; + #endif + + const uint32_t v = (uint32_t)lroundf(x01 * (float)r); + + #ifdef HAS_CUSTOM_PIN + if (h.pin == (uint8_t)PWM_CUSTOM_PIN) { analogWriteCustomPin(v); } else + #endif + analogWrite(h.pin, (int)v); +} + +void AnalogClass::writeQ16(const AnalogPwmHandle& h, uint16_t q16) { + if (h.idx == ANALOG_INVALID_IDX) return; + + uint32_t r; + #ifdef HAS_CUSTOM_PIN + if (h.pin == (uint8_t)PWM_CUSTOM_PIN) { + r = pwm_[h.idx].range ? pwm_[h.idx].range : (uint32_t)PWM_CUSTOM_ANALOG_WRITE_RANGE; + } else + #endif + #if HAL_HAS_GLOBAL_PWM_RESOLUTION && !HAL_HAS_PER_PIN_PWM_RESOLUTION + r = rangeFromBits(gPwmBits); + #else + r = pwm_[h.idx].range ? pwm_[h.idx].range : (uint32_t)ANALOG_WRITE_RANGE; + #endif + + const uint32_t v = (uint32_t)((((uint64_t)q16) * (uint64_t)r + 32767ULL) / 65535ULL); + + #ifdef HAS_CUSTOM_PIN + if (h.pin == (uint8_t)PWM_CUSTOM_PIN) { analogWriteCustomPin(v); } else + #endif + analogWrite(h.pin, (int)v); +} + +// ---------------- ADC ---------------- + +bool AnalogClass::adcInit(int16_t pin, const AnalogAdcConfig& cfg) { + uint8_t p; + if (!toCorePin(pin, p)) { + DF("ERR: Analog adcInit invalid pin="); DL(pin); + return false; + } + + const int idx = adcIndex(pin); + if (idx < 0) { DF("ERR: Analog adcInit table full pin="); DL(pin); return false; } + const uint32_t defRange = (uint32_t)ANALOG_READ_RANGE; + + uint16_t reqBits = cfg.bits; + uint32_t reqRange = cfg.range; + + // derive bits from range if needed (range must be 2^n-1) + if (reqBits == 0 && reqRange != 0) { + if (!IS_POW2_MINUS1(reqRange)) { + DF("ERR: Analog adcInit range not 2^n-1 pin="); D(pin); DF(" range="); DL(reqRange); + return false; + } + reqBits = (uint16_t)BITS_FROM_RANGE(reqRange); + } + + // derive range from bits or default + if (reqBits == 0 && reqRange == 0) { + reqRange = defRange; + } else if (reqRange == 0 && reqBits != 0) { + reqRange = rangeFromBits(reqBits); + } + + // bounds + if (reqBits) { + if (reqBits < HAL_ADC_BITS_MIN || reqBits > HAL_ADC_BITS_MAX) { + DF("ERR: Analog, adcInit bits out of bounds pin="); D(pin); + DF(" bits="); D(reqBits); DF(" ("); D(HAL_ADC_BITS_MIN); DF(".."); D(HAL_ADC_BITS_MAX); DLF(")"); + return false; + } + } + + // apply resolution only if allowed + if (reqBits) { + #if HAL_HAS_PER_PIN_ADC_RESOLUTION + analogReadResolution(p, reqBits); + #elif HAL_HAS_GLOBAL_ADC_RESOLUTION + if (!HAL_ALLOW_GLOBAL_ADC_RECONFIG) { + DF("ERR: Analog, adcInit global ADC reconfig disallowed pin="); DL(pin); + return false; + } + analogReadResolution(reqBits); + gAdcBits = reqBits; // reflect actual global state + VF("WRN: Analog, adcInit global ADC bits set bits="); VL(reqBits); + #else + DF("ERR: Analog, adcInit no ADC resolution control pin="); DL(pin); + return false; + #endif + } + + adc_[idx].pin = pin; + adc_[idx].bits = reqBits; + adc_[idx].range = reqRange ? reqRange : defRange; + adc_[idx].oversample = cfg.oversample ? cfg.oversample : 1; + + VF("MSG: Analog, adcInit ok pin="); V(pin); + VF(" bits="); V(reqBits); + VF(" range="); V(adc_[idx].range); + VF(" os="); VL(adc_[idx].oversample); + + return true; +} + +AnalogAdcHandle AnalogClass::adcInitHandle(int16_t pin, const AnalogAdcConfig& cfg) { + AnalogAdcHandle h; + h.pin = 0; + h.oversample = 1; + h.idx = ANALOG_INVALID_IDX; + + uint8_t p; + if (!toCorePin(pin, p)) { + DF("ERR: Analog, adcInitHandle invalid pin="); DL(pin); + return h; + } + if (!adcInit(pin, cfg)) { + // adcInit already emits the detailed error path + return h; + } + + int idx = -1; + for (int i = 0; i < MAX_TRACKED; i++) if (adc_[i].pin == pin) { idx = i; break; } + if (idx < 0 || idx > 0xFE) { + DF("ERR: Analog, adcInitHandle slot not found pin="); DL(pin); + return h; + } + + h.pin = p; + h.idx = (uint8_t)idx; + h.oversample = adc_[idx].oversample ? adc_[idx].oversample : 1; + return h; +} + +uint32_t AnalogClass::adcRange(int16_t pin) const { + const uint32_t fallback = (uint32_t)ANALOG_READ_RANGE; + + // If only global ADC resolution exists, report the true global range + #if HAL_HAS_GLOBAL_ADC_RESOLUTION && !HAL_HAS_PER_PIN_ADC_RESOLUTION + (void)pin; + return rangeFromBits(gAdcBits); + #endif + + for (int i = 0; i < MAX_TRACKED; i++) { + if (adc_[i].pin == pin) return adc_[i].range ? adc_[i].range : fallback; + } + return fallback; +} + +uint32_t AnalogClass::read(int16_t pin) { + uint8_t p; + if (!toCorePin(pin, p)) { + VF("WRN: Analog, read invalid pin="); VL(pin); + return 0; + } + + uint8_t os = 1; + for (int i = 0; i < MAX_TRACKED; i++) { + if (adc_[i].pin == pin) { os = adc_[i].oversample; break; } + } + + if (os <= 1) return (uint32_t)analogRead(p); + + uint32_t acc = 0; + for (uint8_t i = 0; i < os; i++) acc += (uint32_t)analogRead(p); + return (acc + (os / 2)) / os; +} + +float AnalogClass::readf(int16_t pin) { + uint8_t p; + if (!toCorePin(pin, p)) { + VF("WRN: Analog, readf invalid pin="); VL(pin); + return 0.0f; + } + (void)p; + + const uint32_t r = adcRange(pin); + const uint32_t v = read(pin); + if (r == 0) return 0.0f; + return clamp01((float)v / (float)r); +} + +float AnalogClass::readV(int16_t pin) { + uint8_t p; + if (!toCorePin(pin, p)) { + VF("WRN: Analog, readV invalid pin="); VL(pin); + return 0.0f; + } + +#if defined(ESP32) + return (float)analogReadMilliVolts(p) * 0.001F; +#else + const uint32_t r = adcRange(pin); + if (r == 0) return 0.0F; + const uint32_t raw = read(pin); + return (float)raw * (HAL_VCC / (float)r); +#endif +} + +uint16_t AnalogClass::readQ16(int16_t pin) { + uint8_t p; + if (!toCorePin(pin, p)) { + VF("WRN: Analog, readQ16 invalid pin="); VL(pin); + return 0; + } + (void)p; + + const uint32_t r = adcRange(pin); + const uint32_t v = read(pin); + if (r == 0) return 0; + + const uint32_t q = (uint32_t)((((uint64_t)v) * 65535ULL + (r / 2)) / (uint64_t)r); + return (uint16_t)clampU32(q, 0, 65535U); +} + +uint32_t AnalogClass::read(const AnalogAdcHandle& h) { + if (h.idx == ANALOG_INVALID_IDX) return 0; + + const uint8_t os = (h.oversample <= 1) ? 1 : h.oversample; + if (os == 1) return (uint32_t)analogRead(h.pin); + + uint32_t acc = 0; + for (uint8_t i = 0; i < os; i++) acc += (uint32_t)analogRead(h.pin); + return (acc + (os / 2)) / os; +} + +float AnalogClass::readf(const AnalogAdcHandle& h) { + if (h.idx == ANALOG_INVALID_IDX) return 0.0f; + + uint32_t r; + #if HAL_HAS_GLOBAL_ADC_RESOLUTION && !HAL_HAS_PER_PIN_ADC_RESOLUTION + r = rangeFromBits(gAdcBits); + #else + r = adc_[h.idx].range ? adc_[h.idx].range : (uint32_t)ANALOG_READ_RANGE; + #endif + + if (r == 0) return 0.0f; + const uint32_t v = read(h); + return clamp01((float)v / (float)r); +} + +uint16_t AnalogClass::readQ16(const AnalogAdcHandle& h) { + if (h.idx == ANALOG_INVALID_IDX) return 0; + + uint32_t r; + #if HAL_HAS_GLOBAL_ADC_RESOLUTION && !HAL_HAS_PER_PIN_ADC_RESOLUTION + r = rangeFromBits(gAdcBits); + #else + r = adc_[h.idx].range ? adc_[h.idx].range : (uint32_t)ANALOG_READ_RANGE; + #endif + + if (r == 0) return 0; + const uint32_t v = read(h); + const uint32_t q = (uint32_t)((((uint64_t)v) * 65535ULL + (r / 2)) / (uint64_t)r); + return (uint16_t)clampU32(q, 0, 65535U); +} + +AnalogClass analog; diff --git a/src/lib/analog/Analog.h b/src/lib/analog/Analog.h new file mode 100755 index 0000000..c8e27b6 --- /dev/null +++ b/src/lib/analog/Analog.h @@ -0,0 +1,112 @@ +// Analog.h +#pragma once +#include +#include +#include "../../Common.h" + +// --- Pin sentinel --- +#ifndef OFF + #define OFF (-1) +#endif + +// --- Some error checking --- +#if !IS_POW2_MINUS1(ANALOG_WRITE_RANGE) + #error "ANALOG_WRITE_RANGE must be (2^n - 1)." +#endif + +#if !IS_POW2_MINUS1(ANALOG_WRITE_RANGE) + #error "ANALOG_WRITE_RANGE must be (2^n - 1)." +#endif +#if ANALOG_WRITE_RANGE < RANGE_FROM_BITS(HAL_PWM_BITS_MIN) + #error "ANALOG_WRITE_RANGE below platform PWM resolution limits." +#endif +#if ANALOG_WRITE_RANGE > RANGE_FROM_BITS(HAL_PWM_BITS_MAX) + #error "ANALOG_WRITE_RANGE exceeds platform PWM resolution limits." +#endif + +#if !IS_POW2_MINUS1(ANALOG_READ_RANGE) + #error "ANALOG_READ_RANGE must be (2^n - 1)." +#endif +#if ANALOG_READ_RANGE < RANGE_FROM_BITS(HAL_ADC_BITS_MIN) + #error "ANALOG_READ_RANGE below platform ADC resolution limits." +#endif +#if ANALOG_READ_RANGE > RANGE_FROM_BITS(HAL_ADC_BITS_MAX) + #error "ANALOG_READ_RANGE exceeds platform ADC resolution limits." +#endif + +// Optional: Servo PWM range only allowed to differ when per-pin PWM resolution exists +#ifdef SERVO_ANALOG_WRITE_RANGE + #if !IS_POW2_MINUS1(SERVO_ANALOG_WRITE_RANGE) + #error "SERVO_ANALOG_WRITE_RANGE must be (2^n - 1)." + #endif + #if !HAL_HAS_PER_PIN_PWM_RESOLUTION && SERVO_ANALOG_WRITE_RANGE != ANALOG_WRITE_RANGE + #error "Global-only PWM: SERVO_ANALOG_WRITE_RANGE must equal ANALOG_WRITE_RANGE." + #endif +#endif + +static constexpr uint8_t ANALOG_INVALID_IDX = 0xFF; + +struct AnalogPwmConfig { + uint32_t hz = 0; // 0 = leave default + uint16_t bits = 0; // 0 = leave default + uint32_t range = 0; // 0 = auto (2^bits-1) or leave +}; + +struct AnalogPwmHandle { + uint8_t pin = 0; // core pin for analogWrite() + uint8_t idx = ANALOG_INVALID_IDX; // index into pwm_[] cache +}; + +struct AnalogAdcConfig { + uint16_t bits = 0; // 0 = leave default + uint32_t range = 0; // 0 = auto (2^bits-1) or leave + uint8_t oversample = 1; +}; + +struct AnalogAdcHandle { + uint8_t pin = 0; // core pin for analogRead() + uint8_t oversample = 1; // cached oversample (avoid adc_[] lookup each read) + uint8_t idx = ANALOG_INVALID_IDX; // index into adc_[] cache +}; + +class AnalogClass { +public: + // prepare global adc read resolution and global pwm write resolution/frequency + void begin(); + + // pwm write, with per pin frequency/resolution where possible + bool pwmInit(int16_t pin, const AnalogPwmConfig& cfg = {}); + AnalogPwmHandle pwmInitHandle(int16_t pin, const AnalogPwmConfig& cfg); + void write(int16_t pin, uint32_t value); // native 0..range + void write(int16_t pin, float x01); // normalized 0..1 + void writeQ16(int16_t pin, uint16_t q16); // normalized 0..65535 + void write(const AnalogPwmHandle& h, uint32_t v); + void write(const AnalogPwmHandle& h, float x01); + void writeQ16(const AnalogPwmHandle& h, uint16_t q16); + uint32_t pwmRange(int16_t pin) const; + + // adc read, with per pin resolution where possible + bool adcInit(int16_t pin, const AnalogAdcConfig& cfg = {}); + AnalogAdcHandle adcInitHandle(int16_t pin, const AnalogAdcConfig& cfg); + uint32_t read(int16_t pin); // native 0..range + float readf(int16_t pin); // normalized 0..1 + float readV(int16_t pin); // volts (best-effort) + uint16_t readQ16(int16_t pin); // normalized 0..65535 + uint32_t read(const AnalogAdcHandle& h); + float readf(const AnalogAdcHandle& h); + uint16_t readQ16(const AnalogAdcHandle& h); + uint32_t adcRange(int16_t pin) const; + +private: + struct PwmState { int16_t pin = OFF; uint16_t bits = 0; uint32_t hz = 0; uint32_t range = 0; bool custom = false; }; + struct AdcState { int16_t pin = OFF; uint16_t bits = 0; uint8_t oversample = 1; uint32_t range = 0; }; + + static constexpr uint8_t MAX_TRACKED = 32; // must be <= 254 + mutable PwmState pwm_[MAX_TRACKED]{}; + mutable AdcState adc_[MAX_TRACKED]{}; + + int pwmIndex(int16_t pin) const; + int adcIndex(int16_t pin) const; +}; + +extern AnalogClass analog; diff --git a/src/lib/axis/Axis.command.cpp b/src/lib/axis/Axis.command.cpp new file mode 100755 index 0000000..b6cc2e4 --- /dev/null +++ b/src/lib/axis/Axis.command.cpp @@ -0,0 +1,195 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, commands + +#include "Axis.h" + +#ifdef MOTOR_PRESENT + +#include "../../lib/nv/Nv.h" + +#include "../convert/Convert.h" + +extern AxesRevert revert; + +bool Axis::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + *suppressFrame = false; + + if (command[0] == 'G' && command[1] == 'X') { + + // :GXA[n],[p]# Get axis/motor/driver parameter + // Returns: Value + if (parameter[0] == 'A' && parameter[1] >= '1' && parameter[1] <= '9' && parameter[2] == ',') { + if (parameter[1] - '0' != axisNumber) return false; + + // return motor/driver name + if (parameter[3] == 'M' && parameter[4] == 0) { + strncpy(reply, motor->name(), 40); + *numericReply = false; + return true; + } + + int parameterNumber = atoi(¶meter[3]); + if (parameterNumber < 0 || parameterNumber > getParameterCount()) { *commandError = CE_PARAM_RANGE; return true; } + + // check if all axes are set to revert + if (revert.all) { *commandError = CE_0; return true; } + + // check if this axis is set to revert + if (getAxisRevert()) { *commandError = CE_0; return true; } + + // requesting parameter 0 returns the parameter count + if (parameterNumber == 0) { + sprintf(reply, "%d", (int)getParameterCount()); + *numericReply = false; + return true; + } + + // get parameter values + double value = ((parameterNumber == 1) ? stepsPerMeasureValueNv : getParameter(parameterNumber)->valueNv); + float min = getParameter(parameterNumber)->min; + float max = getParameter(parameterNumber)->max; + AxisParameterType type = getParameter(parameterNumber)->type; + + // convert to degrees if necessary + if (getParameter(parameterNumber)->type == AXP_FLOAT_RAD) { + value = radToDeg(value); + min = radToDeg(min); + max = radToDeg(max); + type = AXP_FLOAT; + } + if (getParameter(parameterNumber)->type == AXP_FLOAT_RAD_INV) { + value = degToRad(value); + min = degToRad(min); + max = degToRad(max); + type = AXP_FLOAT; + } + + char valueStr[24]; + sprintF(valueStr, "%1.3f", value); + convert.stripNumericStr(valueStr); + + sprintf(reply, "%s,%ld,%ld,%d,%s", valueStr, lround(min), lround(max), (int)type, getParameter(parameterNumber)->name); + + *numericReply = false; + } + + #ifdef SERVO_MOTOR_PRESENT + // :GXS[n]# Get axis servo delta (in counts) and velocity + // Returns: Values + if (parameter[0] == 'S' && parameter[2] == 0) { + int index = parameter[1] - '1'; + if (index > 8) { *commandError = CE_PARAM_RANGE; return true; } + if (index + 1 != axisNumber) return false; // command wasn't processed + if (motor->driverType != SERVO) { *commandError = CE_CMD_UNKNOWN; return true; } // not a servo + + char temp[20]; + sprintF(temp, "%0.3f", ((ServoMotor*)motor)->velocityPercent); + sprintf(reply, "%ld,%s", ((ServoMotor*)motor)->delta, temp); + *numericReply = false; + } else + #endif + + // :GXU[n]# Get stepper driver statUs for axis [n] + // Returns: Value + if (parameter[0] == 'U' && parameter[2] == 0) { + int index = parameter[1] - '1'; + if (index < 0 || index > 8) { *commandError = CE_PARAM_RANGE; return true; } + if (index + 1 != axisNumber) return false; // command wasn't processed + DriverStatus status = getStatus(); + if (status.active) { + strcat(reply, status.standstill ? "ST," : ","); + strcat(reply, status.outputA.openLoad ? "OA," : ","); + strcat(reply, status.outputB.openLoad ? "OB," : ","); + strcat(reply, status.outputA.shortToGround ? "GA," : ","); + strcat(reply, status.outputB.shortToGround ? "GB," : ","); + strcat(reply, status.overTemperature ? "OT," : ","); // > 150C + strcat(reply, status.overTemperatureWarning ? "PW," : ","); // > 120C + strcat(reply, status.fault ? "GF" : ""); + } else { *commandError = CE_0; return true; } + *numericReply = false; + } else return false; + } else + + if (command[0] == 'S' && command[1] == 'X') { + + // :SXA[n],R# Revert axis/motor/driver parameters to default + // :SXA[n],[p],nnnn.n# Set axis/motor/driver parameter value + if (parameter[0] == 'A' && parameter[2] == ',') { + + // check for axis settings enable/disable + // :SXAC,0# for run-time NV (EEPROM) axis settings + // :SXAC,1# for compile-time Config.h axis settings + // Return: 0 failure, 1 success + if (parameter[1] == 'C') { + if ((parameter[3] == '0' || parameter[3] == '1') && parameter[4] == 0) { + + if (parameter[3] == '0') { + VLF("MSG: Using Axes settings from NV (EEPROM)"); + revert.all = false; + } else { + VLF("MSG: Using Axes settings from Config.h"); + revert.all = true; + } + nv().kv().put(nvRevertKey, revert); + + return true; + } else { *commandError = CE_PARAM_RANGE; return false; } + } + + // check for a valid axisNumber + int index = parameter[1] - '1'; + if (index + 1 != axisNumber) return false; + + // check if all axes are set to revert + if (revert.all) { *commandError = CE_0; return true; } + + // check if this axis is set to revert + if (getAxisRevert()) { *commandError = CE_0; return true; } + + // :SXA[n],R# reverts this axis to defaults on next boot + if (parameter[3] == 'R' && parameter[4] == 0) { + setAxisRevert(true); + nv().kv().put(nvRevertKey, revert); + return true; + } + + // :SXA[n],[p],nnn.n# Set axis/motor/driver parameter value + // :SXA[n],[p],nnn.n# :SXA1,14,12.5# + int parameterNumber = atoi(¶meter[3]); + char* valueStr = strchr(¶meter[3], ','); + if (valueStr == NULL) { *commandError = CE_PARAM_FORM; return true; } + char* conv_end; + double value = strtod(++valueStr, &conv_end); + if (&valueStr[0] == conv_end) { *commandError = CE_PARAM_FORM; return true; } + + // convert to radians if necessary + if (getParameter(parameterNumber)->type == AXP_FLOAT_RAD) value = degToRad(value); + if (getParameter(parameterNumber)->type == AXP_FLOAT_RAD_INV) value = radToDeg(value); + + if (parameterIsValid(getParameter(parameterNumber), value, true)) { + // save parameter values + getParameter(parameterNumber)->valueNv = value; + if (parameterNumber == 1) stepsPerMeasureValueNv = value; + + // get ready to write to NV + AxisStoredSettings nvAxisSettings; + nvAxisSettings.stepsPerMeasure = stepsPerMeasureValueNv; + for (int i = 1; i <= getParameterCount(); i++) nvAxisSettings.value[i - 1] = getParameter(i)->valueNv; + + // write the settings to NV + nv().kv().put(nvKey, nvAxisSettings); + + // update immediate parameters now + AxisParameterType type = getParameter(parameterNumber)->type; + if (type == AXP_BOOLEAN_IMMEDIATE || type == AXP_INTEGER_IMMEDIATE || type == AXP_FLOAT_IMMEDIATE) { + getParameter(parameterNumber)->value = value; + } + + } else *commandError = CE_PARAM_RANGE; + } else return false; + } else return false; + + return true; +} + +#endif \ No newline at end of file diff --git a/src/lib/axis/Axis.cpp b/src/lib/axis/Axis.cpp new file mode 100755 index 0000000..c1c9254 --- /dev/null +++ b/src/lib/axis/Axis.cpp @@ -0,0 +1,765 @@ +// ----------------------------------------------------------------------------------- +// Axis motion control + +#include "Axis.h" + +#include "../tasks/OnTask.h" +#include "../nv/Nv.h" + +#ifdef MOTOR_PRESENT + +AxesRevert revert = {true, false, false, false, false, false, false, false, false, false, false}; + +Axis *axisWrapper[9]; +IRAM_ATTR void axisWrapper1() { axisWrapper[0]->poll(); } +IRAM_ATTR void axisWrapper2() { axisWrapper[1]->poll(); } +IRAM_ATTR void axisWrapper3() { axisWrapper[2]->poll(); } +IRAM_ATTR void axisWrapper4() { axisWrapper[3]->poll(); } +IRAM_ATTR void axisWrapper5() { axisWrapper[4]->poll(); } +IRAM_ATTR void axisWrapper6() { axisWrapper[5]->poll(); } +IRAM_ATTR void axisWrapper7() { axisWrapper[6]->poll(); } +IRAM_ATTR void axisWrapper8() { axisWrapper[7]->poll(); } +IRAM_ATTR void axisWrapper9() { axisWrapper[8]->poll(); } + +Axis::Axis(uint8_t axisNumber, const AxisPins *pins, const AxisSettings *Settings, const AxisMeasure axisMeasure, float targetTolerance) { + axisPrefix[5] = '0' + axisNumber; + this->axisNumber = axisNumber; + + this->pins = pins; + + // attach the function pointers to the callbacks + axisWrapper[axisNumber - 1] = this; + switch (axisNumber) { + case 1: callback = axisWrapper1; break; + case 2: callback = axisWrapper2; break; + case 3: callback = axisWrapper3; break; + case 4: callback = axisWrapper4; break; + case 5: callback = axisWrapper5; break; + case 6: callback = axisWrapper6; break; + case 7: callback = axisWrapper7; break; + case 8: callback = axisWrapper8; break; + case 9: callback = axisWrapper9; break; + } + + unitsRadians = false; + switch (axisMeasure) { + case AXIS_MEASURE_MICRONS: + strcpy(unitsStr, "um"); + stepsPerMeasure = &stepsPerMicron; + minMeasure = &minMicrons; + maxMeasure = &maxMicrons; + break; + case AXIS_MEASURE_RADIANS: + strcpy(unitsStr, " deg"); + stepsPerMeasure = &stepsPerRadian; + minMeasure = &minRadians; + maxMeasure = &maxRadians; + unitsRadians = true; + break; + case AXIS_MEASURE_UNKNOWN: + case AXIS_MEASURE_DEGREES: + default: + strcpy(unitsStr, " deg"); + stepsPerMeasure = &stepsPerDegree; + minMeasure = &minDegrees; + maxMeasure = &maxDegrees; + break; + } + + if (stepsPerMeasure != NULL) { + stepsPerMeasure->valueDefault = Settings->stepsPerMeasure; + stepsPerMeasureDefault = Settings->stepsPerMeasure; + minMeasure->valueDefault = Settings->limits.min; + maxMeasure->valueDefault = Settings->limits.max; + } + + backlashFreq = Settings->backlashFreq; + + this->targetTolerance = targetTolerance; +} + +bool Axis::init(Motor *motor) { + this->motor = motor; + + // get default parameter values + AxisStoredSettings nvAxisSettings; + nvAxisSettings.revert = true; + nvAxisSettings.stepsPerMeasure = stepsPerMeasureDefault; + for (int i = 1; i <= getParameterCount(); i++) { + #if DEBUG == VERBOSE + const char* axpn[26] = {AXPN_1, AXPN_2, AXPN_3, AXPN_4, AXPN_5, AXPN_6, AXPN_7, AXPN_8, AXPN_9, AXPN_10, + AXPN_11, AXPN_12, AXPN_13, AXPN_14, AXPN_15, AXPN_16, AXPN_17, AXPN_18, AXPN_19, AXPN_20, AXPN_21, AXPN_22, + AXPN_23, AXPN_24, AXPN_25, AXPN_26}; + VF("MSG:"); V(axisPrefix); VF("found parameter \""); + if (getParameter(i)->name[0] == '$') { + char number[3] = ""; + number[0] = getParameter(i)->name[1]; + number[1] = getParameter(i)->name[2]; + number[2] = 0; + V(axpn[atoi(number) - 1]); + } else { V(getParameter(i)->name); } + VF("\" with default value "); VL(getParameter(i)->valueDefault); + #endif + getParameter(i)->value = getParameter(i)->valueDefault; + getParameter(i)->valueNv = getParameter(i)->valueDefault; + nvAxisSettings.value[i - 1] = getParameter(i)->valueDefault; + } + + // check default parameters + for (int i = 1; i <= getParameterCount(); i++) { + if (!parameterIsValid(getParameter(i))) { + DF("ERR:"); D(axisPrefix); DF("default parameter# "); D(i); DLF(" validation failed!"); + return false; + } + } + + // prepare the revert key + nvRevertKey = nv().kv().computeKey("AXIS_SETTINGS_REVERT"); + + // get the revert setting + if (!nv().kv().getOrInit(nvRevertKey, revert)) { DLF("WRN: init failed for AXIS_SETTINGS_REVERT"); }; + + // prepare the axis settings key for this axis + char keyStr[26]; + snprintf(keyStr, sizeof(keyStr), "AXIS%u_SETTINGS", (unsigned)axisNumber); + nvKey = nv().kv().computeKey(keyStr); + + // read axis settings from NV, unless we are reverting to defaults + if (!revert.all) { + if (getAxisRevert()) { + VF("MSG:"); V(axisPrefix); VLF("reverting settings on NV"); + nv().kv().put(nvKey, nvAxisSettings); + setAxisRevert(false); + nv().kv().put(nvRevertKey, revert); + } else { + VF("MSG:"); V(axisPrefix); VLF("reading settings from NV"); + if (!nv().kv().getOrInit(nvKey, nvAxisSettings)) { DF("WRN: init failed for "); DL(keyStr); } + } + } else { + nv().kv().del(nvKey); + VF("MSG:"); V(axisPrefix); VLF("revert all ignoring settings on NV"); + } + + // move NV stepsPerMeasure into parameter (special case of using a double) + stepsPerMeasureValue = nvAxisSettings.stepsPerMeasure; + stepsPerMeasureValueNv = nvAxisSettings.stepsPerMeasure; + getParameter(1)->value = nvAxisSettings.value[0]; + getParameter(1)->valueNv = nvAxisSettings.value[0]; + if (!parameterIsValid(getParameter(1))) { + DF("WRN:"); D(axisPrefix); DLF("parameter validation failed, reverting to default"); + stepsPerMeasureValue = stepsPerMeasureDefault; + stepsPerMeasureValueNv = stepsPerMeasureDefault; + getParameter(1)->value = getParameter(1)->valueDefault; + getParameter(1)->valueNv = getParameter(1)->valueDefault; + } + + // move other NV values into parameters + for (int i = 2; i <= getParameterCount(); i++) { + getParameter(i)->value = nvAxisSettings.value[i - 1]; + getParameter(i)->valueNv = nvAxisSettings.value[i - 1]; + if (!parameterIsValid(getParameter(i))) { + DF("WRN:"); D(axisPrefix); DLF("reverting parameter to default"); + getParameter(i)->value = getParameter(i)->valueDefault; + getParameter(i)->valueNv = getParameter(i)->valueDefault; + } + } + + #if DEBUG == VERBOSE + VF("MSG:"); V(axisPrefix); VF("stepsPerMeasure="); VL(stepsPerMeasureValue); + VF("MSG:"); V(axisPrefix); VF("backlash takeup frequency set to "); + if (unitsRadians) V(radToDegF(backlashFreq)); else V(backlashFreq); + V(unitsStr); VLF("/s"); + #endif + + // activate home and limit sense + VF("MSG:"); V(axisPrefix); VLF("adding any home and/or limit senses"); + homeSenseHandle = sense.add(pins->home, pins->axisSense.homeInit, pins->axisSense.homeTrigger); + minSenseHandle = sense.add(pins->min, pins->axisSense.minMaxInit, pins->axisSense.minTrigger); + maxSenseHandle = sense.add(pins->max, pins->axisSense.minMaxInit, pins->axisSense.maxTrigger); + #if LIMIT_SENSE_STRICT != ON + commonMinMaxSense = pins->min != OFF && pins->min == pins->max; + #endif + + // setup motor + if (!motor->init()) { DF("ERR:"); D(axisPrefix); DLF("no motor driver!"); return false; } + + motor->setBacklashFrequencySteps(backlashFreq*stepsPerMeasureValue); + + // start monitor + VF("MSG:"); V(axisPrefix); VF("start motion controller task (rate "); V(FRACTIONAL_SEC_US); VF("us priority 1)... "); + uint8_t taskHandle = 0; + char taskName[] = "Ax_Motn"; + taskName[2] = axisNumber + '0'; + taskHandle = tasks.add(0, 0, true, 1, callback, taskName); + tasks.setPeriodMicros(taskHandle, FRACTIONAL_SEC_US); + if (taskHandle) { VLF("success"); } else { + VLF("FAILED!"); + DF("ERR:"); D(axisPrefix); DLF("no motion controller task!"); return false; + } + motor->monitorHandle = taskHandle; + + return true; +} + +AxisParameter* Axis::getParameter(uint8_t number) { + if (number == 0) { return motor->getParameter(number); } else + if (number == 1) { return stepsPerMeasure; } else + if (number == 2) { return minMeasure; } else + if (number == 3) { return maxMeasure; } else + if (number >= 4) { return motor->getParameter(number - 3); } else return NULL; +} + +void Axis::enable(bool state) { + enabled = state; + motor->enable(enabled & !poweredDown); +} + +void Axis::setPowerDownTime(int time) { + if (time == 0) powerDownStandstill = false; else { powerDownStandstill = true; powerDownDelay = time; } +} + +void Axis::setPowerDownOverrideTime(int time) { + if (time == 0) powerDownOverride = false; else { + if (poweredDown) { + poweredDown = false; + motor->enable(true); + } + powerDownOverride = true; + powerDownOverrideEnds = millis() + time; + } +} + +void Axis::setBacklash(float value) { + if (autoRate == AR_NONE) motor->setBacklashSteps(round(value*stepsPerMeasureValue)); +} + +float Axis::getBacklash() { + return motor->getBacklashSteps()/stepsPerMeasureValue; +} + +CommandError Axis::resetPosition(double value) { + return resetPositionSteps(lround(value*stepsPerMeasureValue)); +} + +CommandError Axis::resetPositionSteps(long value) { + if (autoRate != AR_NONE) return CE_SLEW_IN_MOTION; + if (motor->getFrequencySteps() != 0) return CE_SLEW_IN_MOTION; + motor->resetPositionSteps(value); + return CE_NONE; +} + +double Axis::getMotorPosition() { + return motor->getMotorPositionSteps()/stepsPerMeasureValue; +} + +double Axis::getIndexPosition() { + return motor->getIndexPositionSteps()/stepsPerMeasureValue; +} + +double distance(double c1, double c2) { + double d1 = fabs(c1 - c2); + double d2 = fabs(c2 - c1); + if (d1 <= d2) return d1; else return d2; +} + +double Axis::wrap(double value) { + if (wrapEnabled) { + while (value > maxMeasure->value) value -= wrapAmount; + while (value < minMeasure->value) value += wrapAmount; + } + return value; +} + +double Axis::unwrap(double value) { + if (wrapEnabled) { + double position = motor->getInstrumentCoordinateSteps()/stepsPerMeasureValue; + while (value > position + wrapAmount/2.0L) value -= wrapAmount; + while (value < position - wrapAmount/2.0L) value += wrapAmount; + } + return value; +} + +double Axis::unwrapNearest(double value) { + if (wrapEnabled) { + value = unwrap(value); + double instr = motor->getInstrumentCoordinateSteps()/stepsPerMeasureValue; +// VF("MSG:"); V(axisPrefix); +// VF("unwrapNearest instr "); V(radToDeg(instr)); +// VF(", before "); V(radToDeg(value)); + double dist = distance(value, instr); + if (distance(value + wrapAmount, instr) < dist) value += wrapAmount; else + if (distance(value - wrapAmount, instr) < dist) value -= wrapAmount; +// VF(", after "); VL(radToDeg(value)); + } + return value; +} + +void Axis::setInstrumentCoordinate(double value) { + setInstrumentCoordinateSteps(lround(unwrap(value)*stepsPerMeasureValue)); +} + +double Axis::getInstrumentCoordinate() { + return wrap(motor->getInstrumentCoordinateSteps()/stepsPerMeasureValue); +} + +void Axis::setInstrumentCoordinatePark(double value) { + motor->setInstrumentCoordinateParkSteps(lround(unwrapNearest(value)*stepsPerMeasureValue), motor->getSequencerSteps()); +} + +void Axis::setTargetCoordinatePark(double value) { + motor->setFrequencySteps(0); + motor->setTargetCoordinateParkSteps(lround(unwrapNearest(value)*stepsPerMeasureValue), motor->getSequencerSteps()); +} + +void Axis::setTargetCoordinate(double value) { + setTargetCoordinateSteps(lround(unwrapNearest(value)*stepsPerMeasureValue)); +} + +double Axis::getTargetCoordinate() { + return wrap(motor->getTargetCoordinateSteps()/stepsPerMeasureValue); +} + +bool Axis::atTarget() { + return labs(motor->getTargetDistanceSteps()) <= targetTolerance*stepsPerMeasureValue; +} + +bool Axis::nearTarget() { + return labs(motor->getTargetDistanceSteps()) < backlashFreq*stepsPerMeasureValue; +} + +double Axis::getTargetDistance() { + return labs(motor->getTargetDistanceSteps())/stepsPerMeasureValue; +} + +double Axis::getOriginOrTargetDistance() { + return motor->getOriginOrTargetDistanceSteps()/stepsPerMeasureValue; +} + +void Axis::setSlewAccelerationRate(float mpsps) { + if (autoRate == AR_NONE) { + slewAccelRateFs = mpsps/FRACTIONAL_SEC; + if (slewAccelRateFs > backlashFreq) slewAccelRateFs = backlashFreq; + slewAccelTime = NAN; + } +} + +void Axis::setSlewAccelerationTime(float seconds) { + if (autoRate == AR_NONE) { + if (seconds < 0.1F) seconds = 0.1F; + slewAccelTime = seconds; + } +} + +void Axis::setSlewAccelerationRateAbort(float mpsps) { + if (autoRate == AR_NONE) { + abortAccelRateFs = mpsps/FRACTIONAL_SEC; + if (abortAccelRateFs > backlashFreq) abortAccelRateFs = backlashFreq; + abortAccelTime = NAN; + } +} + +void Axis::setSlewAccelerationTimeAbort(float seconds) { + if (autoRate == AR_NONE) abortAccelTime = seconds; +} + +CommandError Axis::autoGoto(float frequency) { + if (!enabled) return CE_SLEW_ERR_IN_STANDBY; + if (autoRate != AR_NONE) return CE_SLEW_IN_SLEW; + if (motionError(DIR_BOTH)) return CE_SLEW_ERR_OUTSIDE_LIMITS; + if (motorFault()) return CE_SLEW_ERR_HARDWARE_FAULT; + + if (!isnan(frequency)) setFrequencySlew(frequency); + + VF("MSG:"); V(axisPrefix); + VF("autoGoto start "); + + motor->markOriginCoordinateSteps(); + motor->setSynchronized(false); + motor->setSlewing(true); + autoRate = AR_RATE_BY_DISTANCE; + + #if DEBUG == VERBOSE + if (unitsRadians) V(radToDeg(slewFreq)); else V(slewFreq); + V(unitsStr); VF("/s, accel "); + if (unitsRadians) SERIAL_DEBUG.print(radToDeg(slewAccelRateFs)*FRACTIONAL_SEC, 3); else SERIAL_DEBUG.print(slewAccelRateFs*FRACTIONAL_SEC, 3); + V(unitsStr); VLF("/s/s"); + #endif + + return CE_NONE; +} + +CommandError Axis::autoSlew(Direction direction, float frequency) { + if (!enabled) return CE_SLEW_ERR_IN_STANDBY; + if (autoRate == AR_RATE_BY_DISTANCE) return CE_SLEW_IN_SLEW; + if (direction != DIR_FORWARD && direction != DIR_REVERSE) return CE_SLEW_ERR_UNSPECIFIED; + if (motionError(direction)) return CE_SLEW_ERR_OUTSIDE_LIMITS; + if (motorFault()) return CE_SLEW_ERR_HARDWARE_FAULT; + + if (!isnan(frequency)) setFrequencySlew(frequency); + + VF("MSG:"); V(axisPrefix); + if (autoRate == AR_NONE) { + motor->setSynchronized(true); + motor->setSlewing(true); + VF("MSG:"); V(axisPrefix); VF("autoSlew start "); + } else { VF("autoSlew resum "); } + + if (direction == DIR_FORWARD) { + autoRate = AR_RATE_BY_TIME_FORWARD; + VF("fwd@ "); + } else { + autoRate = AR_RATE_BY_TIME_REVERSE; + VF("rev@ "); + } + + #if DEBUG == VERBOSE + if (unitsRadians) { + if (radToDeg(slewFreq) >= 0.01F ) { + V(radToDeg(slewFreq)); V(unitsStr); + } else { + V(radToDeg(slewFreq)*3600.0F); V(" arc-sec"); + } + } else { V(slewFreq); V(unitsStr); } + + VF("/s, accel "); + if (unitsRadians) SERIAL_DEBUG.print(radToDeg(slewAccelRateFs)*FRACTIONAL_SEC, 3); else SERIAL_DEBUG.print(slewAccelRateFs*FRACTIONAL_SEC, 3); + V(unitsStr); VLF("/s/s"); + #endif + + return CE_NONE; +} + +CommandError Axis::autoSlewHome(unsigned long timeout) { + if (!enabled) return CE_SLEW_ERR_IN_STANDBY; + if (autoRate != AR_NONE) return CE_SLEW_IN_SLEW; + if (motionError(DIR_BOTH)) return CE_SLEW_ERR_OUTSIDE_LIMITS; + if (motorFault()) return CE_SLEW_ERR_HARDWARE_FAULT; + + if (pins->axisSense.homeTrigger != OFF) { + motor->setSynchronized(true); + if (homingStage == HOME_NONE) homingStage = HOME_FAST; + if (autoRate == AR_NONE) { + motor->setSlewing(true); + VF("MSG:"); V(axisPrefix); VF("autoSlewHome "); + switch (homingStage) { + case HOME_FAST: VF("fast "); break; + case HOME_SLOW: VF("slow "); break; + case HOME_FINE: VF("fine "); break; + default: break; + } + } + if (sense.isOn(homeSenseHandle)) { + VF("fwd@ "); + autoRate = AR_RATE_BY_TIME_FORWARD; + } else { + VF("rev@ "); + autoRate = AR_RATE_BY_TIME_REVERSE; + } + + // automatically set timeout if not specified + if (timeout == 0) timeout = (pins->axisSense.homeDistLimit/slewFreq)*1.2F*1000.0F; + + #if DEBUG == VERBOSE + if (unitsRadians) V(radToDeg(slewFreq)); else V(slewFreq); + V(unitsStr); VF("/s, accel "); + if (unitsRadians) SERIAL_DEBUG.print(radToDeg(slewAccelRateFs)*FRACTIONAL_SEC, 3); else SERIAL_DEBUG.print(slewAccelRateFs*FRACTIONAL_SEC, 3); + V(unitsStr); VF("/s/s, timeout "); + #endif + VL(timeout); + homeTimeoutTime = millis() + timeout; + } + return CE_NONE; +} + +void Axis::autoSlewStop() { + if (autoRate <= AR_RATE_BY_TIME_END) return; + + motor->setSynchronized(true); + + VF("MSG:"); V(axisPrefix); VLF("slew stopping"); + autoRate = AR_RATE_BY_TIME_END; + poll(); +} + +void Axis::autoSlewAbort() { + if (autoRate <= AR_RATE_BY_TIME_ABORT) return; + + motor->setSynchronized(true); + + VF("MSG:"); V(axisPrefix); VLF("slew aborting"); + autoRate = AR_RATE_BY_TIME_ABORT; + homingStage = HOME_NONE; + poll(); +} + +bool Axis::isSlewing() { + return autoRate != AR_NONE; +} + +void Axis::poll() { + // make sure we're ready + if (axisNumber == 0) return; + + // check physical limit switches + errors.minLimitSensed = sense.isOn(minSenseHandle); + errors.maxLimitSensed = sense.isOn(maxSenseHandle); + bool commonMinMaxSensed = commonMinMaxSense && (errors.minLimitSensed || errors.maxLimitSensed); + + // let the user know if the associated senses change state + #if DEBUG == VERBOSE + bool senseMin = sense.isOn(minSenseHandle); + bool senseMax = sense.isOn(maxSenseHandle); + if (lastSenseMin != senseMin || lastSenseMax != senseMax) { + VF("MSG:"); V(axisPrefix); VF("limit sense state: "); + V("A"); V(axisNumber); V("S-"); + if (senseMin) VF("< "); else VF(" "); + V("A"); V(axisNumber); V("S+"); + if (senseMax) VLF("< "); else VLF(" "); + lastSenseMin = senseMin; + lastSenseMax = senseMax; + } + bool senseHome = sense.isOn(homeSenseHandle); + if (lastSenseHome != senseHome) { + VF("MSG:"); V(axisPrefix); VF("home sense state: "); + if (senseHome) VLF("ON"); else VLF("OFF"); + lastSenseHome = senseHome; + } + #endif + + // stop homing as we pass by the switch or times out + if (homingStage != HOME_NONE && (autoRate == AR_RATE_BY_TIME_FORWARD || autoRate == AR_RATE_BY_TIME_REVERSE)) { + if (autoRate == AR_RATE_BY_TIME_FORWARD && !sense.isOn(homeSenseHandle)) autoSlewStop(); + if (autoRate == AR_RATE_BY_TIME_REVERSE && sense.isOn(homeSenseHandle)) autoSlewStop(); + if ((long)(millis() - homeTimeoutTime) > 0) { + VF("MSG:"); V(axisPrefix); VLF("autoSlewHome timed out"); + autoSlewAbort(); + } + } + Y; + + // slewing + if (autoRate != AR_NONE && !motor->inBacklash) { + + if (autoRate != AR_RATE_BY_TIME_ABORT) { + if (motionError(motor->getDirection())) { + VF("MSG:"); V(axisPrefix); VLF("motion error"); + autoSlewAbort(); + return; + } + if (motorFault()) { + VF("MSG:"); V(axisPrefix); VLF("motor fault"); + autoSlewAbort(); + return; + } + } + if (autoRate == AR_RATE_BY_DISTANCE) { + if (commonMinMaxSensed) { + VF("MSG:"); V(axisPrefix); VLF("commonMinMaxSensed"); + autoSlewAbort(); + return; + } + if (atTarget()) { + motor->setSlewing(false); + autoRate = AR_NONE; + freq = 0.0F; + motor->setSynchronized(true); + VF("MSG:"); V(axisPrefix); VLF("slew stopped"); + } else { + freq = sqrtf(2.0F*(slewAccelRateFs*FRACTIONAL_SEC)*getOriginOrTargetDistance()); + if (freq < backlashFreq) freq = backlashFreq; + if (freq > slewFreq) freq = slewFreq; + if (motor->getTargetDistanceSteps() < 0) freq = -freq; + } + } else + if (autoRate == AR_RATE_BY_TIME_FORWARD) { + freq += slewAccelRateFs; + if (freq > slewFreq) freq = slewFreq; + } else + if (autoRate == AR_RATE_BY_TIME_REVERSE) { + freq -= slewAccelRateFs; + if (freq < -slewFreq) freq = -slewFreq; + } else + if (autoRate == AR_RATE_BY_TIME_END) { + if (commonMinMaxSensed) { + VF("MSG:"); V(axisPrefix); VLF("commonMinMaxSensed"); + autoSlewAbort(); + return; + } + + if (freq > slewAccelRateFs) freq -= slewAccelRateFs; else if (freq < -slewAccelRateFs) freq += slewAccelRateFs; else freq = 0.0F; + if (fabs(freq) <= slewAccelRateFs) { + motor->setSlewing(false); + autoRate = AR_NONE; + freq = 0.0F; + if (homingStage == HOME_FAST) homingStage = HOME_SLOW; else + if (homingStage == HOME_SLOW) { + if (!sense.isOn(homeSenseHandle)) homingStage = HOME_FINE; else { + slewFreq *= 6.0F; + VF("MSG:"); V(axisPrefix); VLF("autoSlewHome approach correction"); + } + } else + if (homingStage == HOME_FINE) homingStage = HOME_NONE; + if (homingStage != HOME_NONE) { + float f = fabs(slewFreq)/6.0F; + if (f < 0.0003F) f = 0.0003F; + setFrequencySlew(f); + autoSlewHome(SLEW_HOME_REFINE_TIME_LIMIT * 1000); + } else { + VF("MSG:"); V(axisPrefix); VLF("slew stopped"); + } + } + } else + if (autoRate == AR_RATE_BY_TIME_ABORT) { + if (freq > abortAccelRateFs) freq -= abortAccelRateFs; else if (freq < -abortAccelRateFs) freq += abortAccelRateFs; else freq = 0.0F; + if (fabs(freq) <= abortAccelRateFs) { + motor->setSlewing(false); + autoRate = AR_NONE; + freq = 0.0F; + VF("MSG:"); V(axisPrefix); VLF("slew aborted"); + } + } else freq = 0.0F; + } else { + freq = 0.0F; + if (commonMinMaxSensed || motionError(DIR_BOTH) || motorFault()) baseFreq = 0.0F; + } + Y; + + setFrequency(freq); + + // keep associated motor updated + motor->poll(); + + // respond to the motor disabling itself + if (autoRate != AR_NONE && !motor->enabled) { + autoRate = AR_NONE; + freq = 0.0F; + VF("MSG:"); V(axisPrefix); VLF("motion stopped, motor disabled!"); + } +} + +void Axis::setFrequencyMin(float frequency) { + minFreq = frequency; +} + +void Axis::setFrequencyMax(float frequency) { + maxFreq = frequency; + motor->setFrequencyMax(frequency*stepsPerMeasure->value); +} + +void Axis::setFrequencySlew(float frequency) { + if (minFreq != 0.0F && frequency < minFreq) frequency = minFreq; + if (maxFreq != 0.0F && frequency > maxFreq) frequency = maxFreq; + slewFreq = frequency; + + // adjust acceleration rates if they depend on slewFreq + if (!isnan(slewAccelTime)) slewAccelRateFs = (slewFreq/slewAccelTime)/FRACTIONAL_SEC; + if (!isnan(abortAccelTime)) abortAccelRateFs = (slewFreq/abortAccelTime)/FRACTIONAL_SEC; +} + +void Axis::setFrequency(float frequency) { + const unsigned long now = millis(); + + frequency *= scaleFreq; + if (powerDownStandstill && frequency == 0.0F && baseFreq == 0.0F) { + if (!poweredDown) { + if (!powerDownOverride || (long)(now - powerDownOverrideEnds) > 0) { + powerDownOverride = false; + if ((long)(now - powerDownTime) > 0) { + poweredDown = true; + motor->enable(false); + } + } + } + } else { + if (poweredDown) { + poweredDown = false; + motor->enable(true); + } + powerDownTime = now + powerDownDelay; + } + + if (frequency != 0.0F) { + if (frequency < 0.0F) { + if (maxFreq != 0.0F && frequency < -maxFreq) frequency = -maxFreq; + if (minFreq != 0.0F && frequency > -minFreq) frequency = -minFreq; + } else { + if (minFreq != 0.0F && frequency < minFreq) frequency = minFreq; + if (maxFreq != 0.0F && frequency > maxFreq) frequency = maxFreq; + } + } + + // apply base frequency as required + if (enabled) { + if (autoRate == AR_NONE) { + motor->setFrequencySteps((frequency + baseFreq)*stepsPerMeasureValue); + } else { + motor->setFrequencySteps(frequency*stepsPerMeasureValue); + } + } else { + motor->setFrequencySteps(0.0F); + } +} + +float Axis::getFrequency() { + return motor->getFrequencySteps()/stepsPerMeasureValue; +} + +float Axis::getBacklashFrequency() { + return backlashFreq; +} + +DriverStatus Axis::getStatus() { + return motor->getDriverStatus(); +} + +void Axis::setMotionLimitsCheck(bool state) { + limitsCheck = state; +} + +bool Axis::motionError(Direction direction) { + bool result = false; + + if (motor->isStalled()) return true; + + if (direction == DIR_FORWARD || direction == DIR_BOTH) { + result = getInstrumentCoordinateSteps() > lroundf(0.9F*INT32_MAX) || + (limitsCheck && homingStage == HOME_NONE && getInstrumentCoordinate() > maxMeasure->value + 1.0F/stepsPerMeasureValue) || + (!commonMinMaxSense && errors.maxLimitSensed); + if (result == true && result != lastErrorResult) { VF("MSG:"); V(axisPrefix); VLF("motion error forward limit"); } + } else + + if (direction == DIR_REVERSE || direction == DIR_BOTH) { + result = getInstrumentCoordinateSteps() < lroundf(0.9F*INT32_MIN) || + (limitsCheck && homingStage == HOME_NONE && getInstrumentCoordinate() < minMeasure->value - 1.0F/stepsPerMeasureValue) || + (!commonMinMaxSense && errors.minLimitSensed); + if (result == true && result != lastErrorResult) { VF("MSG:"); V(axisPrefix); VLF("motion error reverse limit"); } + } + + lastErrorResult = result; + + return lastErrorResult; +} + +bool Axis::motionErrorSensed(Direction direction) { + if ((direction == DIR_REVERSE || direction == DIR_BOTH) && errors.minLimitSensed) return true; else + if ((direction == DIR_FORWARD || direction == DIR_BOTH) && errors.maxLimitSensed) return true; else return false; +} + +void Axis::setAxisRevert(bool state) { + switch (axisNumber) { + case 1: revert.axis1 = state; break; case 2: revert.axis2 = state; break; case 3: revert.axis3 = state; break; + case 4: revert.axis4 = state; break; case 5: revert.axis5 = state; break; case 6: revert.axis6 = state; break; + case 7: revert.axis7 = state; break; case 8: revert.axis8 = state; break; case 9: revert.axis9 = state; break; + } +} + +bool Axis::getAxisRevert() { + switch (axisNumber) { + case 1: return revert.axis1; case 2: return revert.axis2; case 3: return revert.axis3; + case 4: return revert.axis4; case 5: return revert.axis5; case 6: return revert.axis6; + case 7: return revert.axis7; case 8: return revert.axis8; case 9: return revert.axis9; + default: return false; + } +} + +#endif diff --git a/src/lib/axis/Axis.h b/src/lib/axis/Axis.h new file mode 100755 index 0000000..17ac228 --- /dev/null +++ b/src/lib/axis/Axis.h @@ -0,0 +1,552 @@ +// ----------------------------------------------------------------------------------- +// Axis motion control +#pragma once + +#include "../../Common.h" +#include "../sense/Sense.h" + +#ifdef MOTOR_PRESENT + +// default start of axis class hardware timers +#ifndef AXIS_HARDWARE_TIMER_BASE +#define AXIS_HARDWARE_TIMER_BASE 1 +#endif + +// polling frequency for monitoring axis motion (default 100X/second) +#ifndef FRACTIONAL_SEC +#define FRACTIONAL_SEC 100.0F +#endif +#define FRACTIONAL_SEC_US (lround(1000000.0F / FRACTIONAL_SEC)) + +// time limit in seconds for slew home phases +#ifndef SLEW_HOME_REFINE_TIME_LIMIT +#define SLEW_HOME_REFINE_TIME_LIMIT 120 +#endif + +// ON blocks all motion when min/max are on the same pin, applies to all axes (mount/rotator/focusers) +#ifndef LIMIT_SENSE_STRICT +#define LIMIT_SENSE_STRICT OFF +#endif + +#include "../../libApp/commands/ProcessCmds.h" +#include "motor/Motor.h" +#include "motor/stepDir/StepDir.h" +#include "motor/servo/Servo.h" +#include "motor/oDrive/ODriveNew.h" +#include "motor/oDrive/ODrive.h" +#include "motor/kTech/KTech.h" + +#pragma pack(1) + +typedef struct AxesRevert +{ + uint16_t all : 1; + uint16_t axis1 : 1; + uint16_t axis2 : 1; + uint16_t axis3 : 1; + uint16_t axis4 : 1; + uint16_t axis5 : 1; + uint16_t axis6 : 1; + uint16_t axis7 : 1; + uint16_t axis8 : 1; + uint16_t axis9 : 1; + uint16_t reserved : 5; +} AxesRevert; + +typedef struct AxisLimits +{ + float min; // unit (radians, microns, etc.) depends on axis settings + float max; // unit (radians, microns, etc.) depends on axis settings +} AxisLimits; + +typedef struct AxisSettings +{ + double stepsPerMeasure; // unit (radians, microns, etc.) depends on axis settings + AxisLimits limits; + float backlashFreq; // in measures/s +} AxisSettings; + +// axis parameters +#define MOTOR_PARAMETER_MAX_COUNT 20 + +#define AxisStoredSettingsSize 89 +typedef struct AxisStoredSettings +{ + bool revert; + double stepsPerMeasure; // unit (radians, microns, etc.) depends on axis settings + float value[MOTOR_PARAMETER_MAX_COUNT]; +} AxisStoredSettings; +#pragma pack() + +typedef struct AxisSense +{ + int32_t homeTrigger; + int8_t homeInit; + float homeDistLimit; + int32_t minTrigger; + int32_t maxTrigger; + int8_t minMaxInit; +} AxisSense; + +typedef struct AxisPins +{ + int16_t min; + int16_t home; + int16_t max; + AxisSense axisSense; +} AxisPins; + +typedef struct AxisErrors +{ + uint8_t minLimitSensed : 1; + uint8_t maxLimitSensed : 1; +} AxisErrors; + +enum AutoRate : uint8_t +{ + AR_NONE, + AR_RATE_BY_TIME_ABORT, + AR_RATE_BY_TIME_END, + AR_RATE_BY_DISTANCE, + AR_RATE_BY_TIME_FORWARD, + AR_RATE_BY_TIME_REVERSE +}; +enum HomingStage : uint8_t +{ + HOME_NONE, + HOME_FINE, + HOME_SLOW, + HOME_FAST +}; +enum AxisMeasure : uint8_t +{ + AXIS_MEASURE_UNKNOWN, + AXIS_MEASURE_MICRONS, + AXIS_MEASURE_DEGREES, + AXIS_MEASURE_RADIANS +}; + +class Axis +{ +public: + // constructor for this motion controller + // \param axisNumber: from 1 to 9 + // \param *pins: provides pins and states for h/w limits and homing + // \param *settings: provides axis scale (steps per measure,) s/w limits, reversal, and backlash frequency + // \param axisMeasure: one of AXIS_MEASURE_MICRONS, _DEGREES, or _RADIANS for conversion to/from steps + // \param targetTolerance: in "measures" for detecting when slews arrive at their target + Axis(uint8_t axisNumber, const AxisPins *pins, const AxisSettings *settings, const AxisMeasure axisMeasure, float targetTolerance = 0.0F); + + // process axis commands + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // init prepares this motion controller and the provided motor for operation + // \param motor: associated motor to be controlled + bool init(Motor *motor); + + // returns the maximum number of parameters possible + uint8_t getParameterMaxCount() { return MOTOR_PARAMETER_MAX_COUNT; } + + // returns the number of parameters for this axis + uint8_t getParameterCount() { return 3 + motor->getParameterCount(); } + + // returns the specified axis parameter + AxisParameter *getParameter(uint8_t number); + + // check if parameter is valid + bool parameterIsValid(AxisParameter *parameter, bool next = false) { return motor->parameterIsValid(parameter, next); } + bool parameterIsValid(AxisParameter *parameter, float value, bool next = false) { + bool result; + float temp = parameter->value; + float tempNv = parameter->valueNv; + if (next) parameter->valueNv = value; else parameter->value = value; + result = motor->parameterIsValid(parameter, next); + parameter->valueNv = tempNv; + parameter->value = temp; + return result; + } + + // sets the enabled state (and for its associated motor if supported) + // \param state: true to enable or false to disable + void enable(bool state); + + // gets the enabled state + inline bool isEnabled() { return enabled && !motor->calibrating; } + + // sets the automatic power down time + // \param time: allowed standstill time in milliseconds before power down, or 0 to disable + void setPowerDownTime(int time); + + // sets the automatic power down override time + // \param time: time in milliseconds to disable automatic power down, or 0 to disable + void setPowerDownOverrideTime(int time); + + // get steps per "measure" (radian, micron, etc.) + inline double getStepsPerMeasure() { return stepsPerMeasureValue; } + + // get tracking mode steps per slewing mode step + inline int getStepsPerStepSlewing() { return motor->getStepsPerStepSlewing(); } + + // reset position, also zeros backlash and index + // \param value: position of motor and target in "measures" (radians, microns, etc.) + CommandError resetPosition(double value); + + // reset position, also zeros backlash and index + // \param value: position of motor and target in steps + CommandError resetPositionSteps(long value); + + // resets the target position to the motor position + inline void resetTargetToMotorPosition() { motor->resetTargetToMotorPosition(); } + + // get motor position, in "measures" (radians, microns, etc.) + // \note motor: position based on actual motion taken since startup/reset (including backlash) + double getMotorPosition(); + + // get motor position, in steps + // \note motor: position based on actual motion taken since startup/reset (including backlash) + inline long getMotorPositionSteps() { return motor->getMotorPositionSteps(); } + + // get index position, in "measures" (radians, microns, etc.) + // \note indexPosition: added to motorPositon (-backlash) yeilds an instrumentCoordinate + double getIndexPosition(); + + // get index position, in steps + // \note indexPosition: added to motorPositon (-backlash) yeilds an instrumentCoordinate + inline long getIndexPositionSteps() { return motor->getIndexPositionSteps(); } + + // coordinate wrap + // \param value: one complete rotation in "measures" (radians, microns, etc.), 0.0 disables + // \note wrap occurs when the coordinate exceeds the min or max limits + inline void coordinateWrap(double value) + { + wrapAmount = value; + wrapEnabled = fabs(value) > 0.0F; + } + + // set instrument coordinate + // \param value: position in "measures" (radians, microns, etc.) + void setInstrumentCoordinate(double value); + + // set instrument coordinate + // \param value: position in steps + inline void setInstrumentCoordinateSteps(long value) { motor->setInstrumentCoordinateSteps(value); } + + // get instrument coordinate in "measures" (radians, microns, etc.) + double getInstrumentCoordinate(); + + // get instrument coordinate, in steps + inline long getInstrumentCoordinateSteps() { return motor->getInstrumentCoordinateSteps(); } + + // set instrument coordinate to park at + // \param value: position in "measures" (radians, microns, etc.) + // \note with backlash disabled this indexes to the nearest position where the motor wouldn't cog + void setInstrumentCoordinatePark(double value); + + // set the target coordinate for park + // \param value: postion in "measures" (degrees, microns, etc.) + // \note with backlash disabled this moves to the nearest position where the motor doesn't cog + void setTargetCoordinatePark(double value); + + // set target coordinate for autoGoto() + // \param value: postion in "measures" (degrees, microns, etc.) + void setTargetCoordinate(double value); + + // set target coordinate for autoGoto() + // \param value: postion in steps + inline void setTargetCoordinateSteps(long value) { motor->setTargetCoordinateSteps(value); } + + // get target coordinate, in "measures" (degrees, microns, etc.) + double getTargetCoordinate(); + + // get target coordinate, in steps + inline long getTargetCoordinateSteps() { return motor->getTargetCoordinateSteps(); } + + // distance to target in "measures" (degrees, microns, etc.) + double getTargetDistance(); + + // returns true if at the target coordinate (+/- targetTolerance) + bool atTarget(); + + // returns true if within one second of the target coordinate at the backlash takeup rate + bool nearTarget(); + + // sets backlash amount + // \param value: backlash distance in "measures" (degrees, microns, etc.) + void setBacklash(float value); + + // sets backlash amount + // \param value: backlash distance in steps + inline void setBacklashSteps(long value) + { + if (autoRate == AR_NONE) + motor->setBacklashSteps(value); + } + + // get backlash amount in "measures" (radians, microns, etc.) + float getBacklash(); + + // get frequency in "measures" (degrees, microns, etc.) per second + float getFrequency(); + + // get frequency in steps per second + float getFrequencySteps() { return motor->getFrequencySteps(); } + + // get direction + Direction getDirection() { return motor->getDirection(); } + + // gets backlash frequency in "measures" (degrees, microns, etc.) per second + float getBacklashFrequency(); + + // sets reversal of axis directions + // \param state: true reverses the direction behavior specified in settings + inline void setReverse(bool state) { motor->setReverse(state); } + + // sets reversal of homing directions + // \param state: true reverses the normal sense direction behavior + inline void setHomeReverse(bool state) { sense.reverse(homeSenseHandle, state); } + + // sets maximum frequency for next slew + // \param frequency: rate of motion in "measures" (radians, microns, etc.) per second + void setFrequencySlew(float frequency); + + // sets overall minimum frequency + // \param frequency: rate of motion in "measures" (radians, microns, etc.) per second + void setFrequencyMin(float frequency); + + // sets overall maximum frequency + // \param frequency: rate of motion in "measures" (radians, microns, etc.) per second + void setFrequencyMax(float frequency); + + // sets frequency scaling factor for slews + // \param frequency: scaling factor for this axis ranging from 0.0 (0%) to 1.0 (100%) of normal + void setFrequencyScale(float frequency) + { + if (frequency >= 0.0F && frequency <= 1.0F) + scaleFreq = frequency; + } + + // sets acceleration rate for slews + // \param mpsps: acceleration rate in "measures" per second per second + void setSlewAccelerationRate(float mpsps); + + // set acceleration rate for slews + // \param seconds: time during which acceleration to/from the last specified slew frequency occurs + void setSlewAccelerationTime(float seconds); + + // sets acceleration rate for emergency stop of movement + // \param mpsps: deceleration rate in "measures" per second per second + void setSlewAccelerationRateAbort(float mpsps); + + // set acceleration rate for emergency stop of movement + // \param seconds: time during which deceleration from the last specified slew frequency occurs + void setSlewAccelerationTimeAbort(float seconds); + + // auto goto to destination target coordinate + // \param frequency: optional frequency of slew in "measures" (radians, microns, etc.) per second + CommandError autoGoto(float frequency = NAN); + + // auto slew + // \param direction: direction of motion, DIR_FORWARD or DIR_REVERSE + // \param frequency: optional frequency of slew in "measures" (radians, microns, etc.) per second + CommandError autoSlew(Direction direction, float frequency = NAN); + + // automatic slew to home + // \param timeout: time in seconds before aborting the operation + // \note requires a home sensor (switch) + CommandError autoSlewHome(unsigned long timeout = 0); + + // returns true homing is in progress + bool isHoming() { return homingStage != HOME_NONE; } + + // returns true if a home sensor is available + inline bool hasHomeSense() { return pins->axisSense.homeTrigger != OFF; } + + // stops any autoGoto() or autoSlew() or autoSlewHome() with deacceleration by time + void autoSlewStop(); + + // stops any autoGoto() or autoSlew() or autoSlewHome() with deacceleration by time using the abort rate + void autoSlewAbort(); + + // returns true if a slew is active on this axis + bool isSlewing(); + + // returns 1 if departing origin or -1 if approaching target + inline int getRampDirection() { return motor->getRampDirection(); } + + // sets synchronized automatic target movement frequency + // \param frequency: rate of motion in "measures" (radians, microns, etc.) per second + inline void setSynchronizedFrequency(float frequency) { baseFreq = frequency; } + + // set synchronized automatic target movement + // \param state: true to force target synchronized movement + // \note movement at the setSynchronizedFrequency() rate + inline void setSynchronized(bool state) { motor->setSynchronized(state); } + + // returns true if synchronized automatic target movement is active + // \note movement at the setSynchronizedFrequency() rate + inline bool getSynchronized() { return motor->getSynchronized(); } + + // returns true if the associated motor reports a fault + inline bool motorFault() { return motor->getDriverStatus().fault; }; + + // returns the associated motors driver status + DriverStatus getStatus(); + + // enables or disables software based position range limits + // \param state: true to enable or false to disable + void setMotionLimitsCheck(bool state); + + // check for all errors that would disallow motion in the given direction + // \param direction: one of DIR_FORWARD, DIR_REVERSE, or DIR_BOTH + bool motionError(Direction direction); + + // gets the minimum coordinate in "measures" (radians, microns, etc.) + float getLimitMin() { return minMeasure->value; } + + // sets the minimum coordinate in "measures" (radians, microns, etc.) + void setLimitMin(float value) { if (parameterIsValid(minMeasure, value)) minMeasure->value = value; } + + // gets the maximum coordinate in "measures" (radians, microns, etc.) + float getLimitMax() { return maxMeasure->value; } + + // sets the maximum coordinate in "measures" (radians, microns, etc.) + void setLimitMax(float value) { if (parameterIsValid(maxMeasure, value)) maxMeasure->value = value; } + + // check for sense (h/w limit) errors that would disallow motion in the given direction + // \param direction: one of DIR_FORWARD, DIR_REVERSE, or DIR_BOTH + bool motionErrorSensed(Direction direction); + + // calibrate the associated motor + void calibrate(float value) { motor->calibrate(value); } + + // calibrate the associated motor's driver + void calibrateDriver() { motor->calibrateDriver(); } + + // monitor movement + void poll(); + + // associated motor + Motor *motor; + + // hint that min and max pins are the same (no directional limit indication) + bool commonMinMaxSense = false; + +private: + // set frequency in "measures" (degrees, microns, etc.) per second (0 stops motion) + void setFrequency(float frequency); + + // sets driver power on/off + void powered(bool value); + + // distance to origin or target, whichever is closer, in "measures" (degrees, microns, etc.) + double getOriginOrTargetDistance(); + + // returns true if traveling through backlash + bool inBacklash(); + + // convert from unwrapped (full range) to normal (+/- wrapAmount) coordinate + double wrap(double value); + + // convert from normal (+/- wrapAmount) to an unwrapped (full range) coordinate + double unwrap(double value); + + // convert from normal (+/- wrapAmount) to an unwrapped (full range) coordinate + // nearest the instrument coordinate + double unwrapNearest(double value); + + // get or set the axis revert flags + void setAxisRevert(bool state); + bool getAxisRevert(); + + AxisErrors errors; + bool lastErrorResult = false; + + uint8_t axisNumber = 0; + char axisPrefix[9] = " Axis_, "; + + char unitsStr[5] = "?"; + bool unitsRadians = false; + + bool enabled = false; // enabled or disabled axis and motor power + bool limitsCheck = true; // enabled or disabled software range limits check + + uint8_t homeSenseHandle = 0; // home sensor handle + uint8_t minSenseHandle = 0; // min sensor handle + uint8_t maxSenseHandle = 0; // max sensor handle + +#if DEBUG == VERBOSE + bool lastSenseMin = false; + bool lastSenseMax = false; + bool lastSenseHome = false; +#endif + + uint16_t backlashStepsStore; + volatile uint16_t backlashSteps = 0; + volatile uint16_t backlashAmountSteps = 0; + + volatile bool takeStep = false; + + // coordinate handling + double wrapAmount = 0.0L; + bool wrapEnabled = false; + + // power down standstill control + bool powerDownStandstill = false; + bool powerDownOverride = false; + bool poweredDown = false; + unsigned long powerDownDelay; // in milliseconds + unsigned long powerDownOverrideEnds; // in milliseconds + unsigned long powerDownTime = 0; // in milliseconds + + // timeout for home switch detection + unsigned long homeTimeoutTime = 0; // in milliseconds + + // rates (in measures per second) to control motor movement + float freq = 0.0F; // momentary frequency in measures/s + float baseFreq = 0.0F; // base frequency for continuous movement in measures/s + float minFreq = 0.0F; // minimum frequency in measures/s + float slewFreq = 0.0F; // slewing frequency in measures/s + float maxFreq = 0.0F; // maximum frequency in measures/s + float backlashFreq = 0.0F; // in measures/s + + float scaleFreq = 1.0F; + + double stepsPerMeasureValue = NAN; + double stepsPerMeasureValueNv = NAN; + double stepsPerMeasureDefault = NAN; + + float targetTolerance = 0.0F; + + AutoRate autoRate = AR_NONE; // auto slew mode + float slewAccelRateFs; // auto slew rate in measures per second per frac-sec + float abortAccelRateFs; // abort slew rate in measures per second per frac-sec + float slewAccelTime = NAN; // auto slew acceleration time in seconds + float abortAccelTime = NAN; // abort slew acceleration time in seconds + + HomingStage homingStage = HOME_NONE; + + const AxisPins *pins; + + void (*volatile callback)() = NULL; + + uint16_t nvKey, nvRevertKey; + + AxisParameter stepsPerDegree = {NAN, NAN, NAN, 1.0, 360000.0, AXP_FLOAT, AXPN_STEPS_PER_DEG}; + AxisParameter minDegrees = {NAN, NAN, NAN, -360.0, 360.0, AXP_FLOAT, AXPN_LIMIT_DEGS_MIN}; + AxisParameter maxDegrees = {NAN, NAN, NAN, -360.0, 360.0, AXP_FLOAT, AXPN_LIMIT_DEGS_MAX}; + + AxisParameter stepsPerRadian = {NAN, NAN, NAN, radToDegF(1.0), radToDegF(360000.0), AXP_FLOAT_RAD_INV, AXPN_STEPS_PER_DEG}; + AxisParameter minRadians = {NAN, NAN, NAN, -Deg360, Deg360, AXP_FLOAT_RAD, AXPN_LIMIT_DEGS_MIN}; + AxisParameter maxRadians = {NAN, NAN, NAN, -Deg360, Deg360, AXP_FLOAT_RAD, AXPN_LIMIT_DEGS_MAX}; + + AxisParameter stepsPerMicron = {NAN, NAN, NAN, 0.001, 1000.0, AXP_FLOAT, AXPN_STEPS_PER_UM}; + AxisParameter minMicrons = {NAN, NAN, NAN, 0.0, 500000.0, AXP_FLOAT, AXPN_LIMIT_UM_MIN}; + AxisParameter maxMicrons = {NAN, NAN, NAN, 0.0, 500000.0, AXP_FLOAT, AXPN_LIMIT_UM_MAX}; + + AxisParameter *stepsPerMeasure = NULL; + AxisParameter *minMeasure = NULL; + AxisParameter *maxMeasure = NULL; + +}; + +#endif diff --git a/src/lib/axis/motor/Drivers.h b/src/lib/axis/motor/Drivers.h new file mode 100755 index 0000000..6f40438 --- /dev/null +++ b/src/lib/axis/motor/Drivers.h @@ -0,0 +1,93 @@ +#pragma once + +#include + +typedef struct DriverOutputStatus { + bool shortToGround; + bool openLoad; +} DriverOutputStatus; + +typedef struct DriverStatus { + bool active; + DriverOutputStatus outputA; + DriverOutputStatus outputB; + bool overTemperatureWarning; + bool overTemperature; + bool standstill; + bool fault; +} DriverStatus; + +// codes for locale specific name generation of certain terms in SWS, etc. +// any AxisParameter can instead just pass a string of up to 18 chars directly +#define AXPN_STEPS_PER_DEG "$1" +#define AXPN_LIMIT_DEGS_MIN "$2" +#define AXPN_LIMIT_DEGS_MAX "$3" +#define AXPN_STEPS_PER_UM "$4" +#define AXPN_LIMIT_UM_MIN "$5" +#define AXPN_LIMIT_UM_MAX "$6" +#define AXPN_REVERSE "$7" +#define AXPN_MICROSTEPS "$8" +#define AXPN_MICROSTEPS_GOTO "$9" +#define AXPN_DECAY_MODE "$10" +#define AXPN_DECAY_MODE_GOTO "$11" +#define AXPN_CURRENT_HOLD "$12" +#define AXPN_CURRENT_RUN "$13" +#define AXPN_CURRENT_GOTO "$14" +#define AXPN_INTERPOLATE "$15" +#define AXPN_PID_P "$16" +#define AXPN_PID_I "$17" +#define AXPN_PID_D "$18" +#define AXPN_PID_SLEWING_P "$19" +#define AXPN_PID_SLEWING_I "$20" +#define AXPN_PID_SLEWING_D "$21" +#define AXPN_COUNTS_PER_RAD "$22" +#define AXPN_STEPS_TO_COUNTS "$23" +#define AXPN_MAX_ACCEL "$24" +#define AXPN_MIN_PWR "$25" +#define AXPN_MAX_PWR "$26" + +#define AXPN_1 "Steps/degree" +#define AXPN_2 "Min limit, degs" +#define AXPN_3 "Max limit, degs" +#define AXPN_4 "Steps/um" +#define AXPN_5 "Min limit, um" +#define AXPN_6 "Max limit, um" +#define AXPN_7 "Reverse" +#define AXPN_8 "Microsteps" +#define AXPN_9 "Microsteps Goto" +#define AXPN_10 "Decay mode" +#define AXPN_11 "Decay mode Goto" +#define AXPN_12 "mA Hold" +#define AXPN_13 "mA Run" +#define AXPN_14 "mA Goto" +#define AXPN_15 "256x Interpolate" +#define AXPN_16 "P tracking" +#define AXPN_17 "I tracking" +#define AXPN_18 "D tracking" +#define AXPN_19 "P slewing" +#define AXPN_20 "I slewing" +#define AXPN_21 "D slewing" +#define AXPN_22 "Rads/count" +#define AXPN_23 "Steps/count ratio" +#define AXPN_24 "Max accel, %/s/s" +#define AXPN_25 "Min power, %" +#define AXPN_26 "Max power, %" + +// AXP_FLOAT_RAD and AXP_FLOAT_RAD_INV automatically translate to/from AXP_FLOAT (in degrees) for commands +enum AxisParameterType: uint8_t {AXP_INVALID, + AXP_BOOLEAN, AXP_BOOLEAN_IMMEDIATE, + AXP_INTEGER, AXP_INTEGER_IMMEDIATE, + AXP_FLOAT, AXP_FLOAT_IMMEDIATE, + AXP_FLOAT_RAD, AXP_FLOAT_RAD_INV, + AXP_POW2, + AXP_DECAY}; + +typedef struct AxisParameter { + float value; + float valueNv; + float valueDefault; + float min; + float max; + AxisParameterType type; + const char name[18]; +} AxisParameter; diff --git a/src/lib/axis/motor/Motor.cpp b/src/lib/axis/motor/Motor.cpp new file mode 100755 index 0000000..6128b4c --- /dev/null +++ b/src/lib/axis/motor/Motor.cpp @@ -0,0 +1,212 @@ +// ----------------------------------------------------------------------------------- +// Generic motor controller + +#include "Motor.h" + +#ifdef MOTOR_PRESENT + +Motor::Motor(uint8_t axisNumber, int8_t reverse) { + this->axisNumber = axisNumber; + this->reverse.valueDefault = reverse == ON; +} + +bool Motor::init() { + VF("MSG:"); V(axisPrefix); VLF("motor init"); + normalizedReverse = (bool)lround(reverse.value); + return true; +} + +// returns the specified axis parameter by name +AxisParameter* Motor::getParameterByName(const char* name) { + for (int i = 1; i <= getParameterCount(); i++) { + if (strcmp(getParameter(i)->name, name) == 0) { return getParameter(i); } + } + return &invalid; +} + +// check if parameter is valid +bool Motor::parameterIsValid(AxisParameter* parameter, bool next) { + const float value = next ? parameter->valueNv : parameter->value; + + if (isnan(value) || isinf(value)) return false; + + // reject nonsense bounds + const float pmin = parameter->min; + const float pmax = parameter->max; + if (isnan(pmin) || isnan(pmax) || isinf(pmin) || isinf(pmax) || (pmax < pmin)) return false; + + if (value < pmin) return false; + if (value > pmax) return false; + + if (parameter->type == AXP_POW2) { + static constexpr float kIntEps = 1E-3F; + + // Value must be effectively integral + const float vf = value; + const int32_t vi = (int32_t)lroundf(vf); + if (fabsf(vf - (float)vi) > kIntEps) return false; + + if (vi < 1 || vi > 256) return false; + if ((vi & (vi - 1)) != 0) return false; // power of two check + } + + return true; +} + +// resets motor and target angular position in steps, also zeros backlash and index +void Motor::resetPositionSteps(long value) { + indexSteps = 0; + noInterrupts(); + motorSteps = value; + targetSteps = value; + backlashSteps = 0; + interrupts(); +} + +// resets target position to the motor position +void Motor::resetTargetToMotorPosition() { + noInterrupts(); + targetSteps = motorSteps; + interrupts(); +} + +// get motor position in steps (including backlash) +long Motor::getMotorPositionSteps() { + noInterrupts(); + long steps = motorSteps + backlashSteps; + interrupts(); + return steps; +} + +// get instrument coordinate, in steps +long Motor::getInstrumentCoordinateSteps() { + long steps = ATOMIC_LOAD(motorSteps); + return steps + indexSteps; +} + +// set instrument coordinate, in steps +void Motor::setInstrumentCoordinateSteps(long value) { + indexSteps = value - ATOMIC_LOAD(motorSteps); +} + +// set instrument park coordinate, in steps +// should only be called when the axis is not moving +// nudge index so park lands on a stable cogging grid (multiple of 4*modulo steps) +void Motor::setInstrumentCoordinateParkSteps(long value, int modulo) { + long priorLocationOffset = value - ATOMIC_LOAD(motorSteps); + if (driverType == STEP_DIR) { + if (modulo == OFF) modulo = 1; + long steps = priorLocationOffset; + steps -= modulo*2L; + for (int l = 0; l < modulo*4; l++) { if (steps % (modulo*4L) == 0) break; steps++; } + indexSteps = steps; + } else setInstrumentCoordinateSteps(value); + VF("MSG:"); V(axisPrefix); VF("setInstrumentCoordinateParkSteps at "); V(indexSteps); VF(" (was "); V(priorLocationOffset); VL(")"); +} + +// get target coordinate (with index), in steps +long Motor::getTargetCoordinateSteps() { + long steps = ATOMIC_LOAD(targetSteps) + indexSteps; + return steps; +} + +// set target coordinate (with index), in steps +void Motor::setTargetCoordinateSteps(long value) { + noInterrupts(); + targetSteps = value - indexSteps; + interrupts(); +} + +// set target park coordinate, in steps (taking into account stepper motor cogging when powered off) +// should only be called when the axis is not moving +void Motor::setTargetCoordinateParkSteps(long value, int modulo) { + if (driverType == STEP_DIR) { + if (modulo == OFF) modulo = 1; + long steps = value - indexSteps; + steps -= modulo*2L; + for (int l = 0; l < modulo*4; l++) { if (steps % (modulo*4L) == 0) break; steps++; } + noInterrupts(); + targetSteps = steps; + interrupts(); + } else setTargetCoordinateSteps(value); + VF("MSG:"); V(axisPrefix); VF("setTargetCoordinateParkSteps at "); V(targetSteps); VF(" (was "); V(value - indexSteps); VL(")"); +} + +// get backlash amount in steps +long Motor::getBacklashSteps() { + uint16_t backlash = ATOMIC_LOAD(backlashAmountSteps); + return (long)backlash; +} + +// set backlash amount in steps +void Motor::setBacklashSteps(long value) { + if (value < 0) value = 0; + if (value > 65535) value = 65535; + ATOMIC_STORE(backlashAmountSteps, (uint16_t)value); +} + +// mark origin coordinate for autoGoto as current location +void Motor::markOriginCoordinateSteps() { + noInterrupts(); + originSteps = motorSteps; + interrupts(); +} + +// distance to target in steps (+/-) +long Motor::getTargetDistanceSteps() { + noInterrupts(); + long dist = targetSteps - motorSteps; + interrupts(); + return dist; +} + +// distance to origin or target, whichever is closer, in steps +long Motor::getOriginOrTargetDistanceSteps() { + long steps = ATOMIC_LOAD(motorSteps); + long distanceOrigin = labs(originSteps - steps); + long distanceTarget = labs(targetSteps - steps); + if (distanceOrigin < distanceTarget) return distanceOrigin; else return distanceTarget; +} + +// returns 1 if distance to origin is closer else -1 if target is closer +int Motor::getRampDirection() { + long steps = ATOMIC_LOAD(motorSteps); + long distanceOrigin = labs(originSteps - steps); + long distanceTarget = labs(targetSteps - steps); + if (distanceOrigin < distanceTarget) return 1; else return -1; +} + +// set backlash frequency in steps per second +void Motor::setBacklashFrequencySteps(float frequency) { + backlashFrequency = frequency; +} + +// get the current direction of motion +Direction Motor::getDirection() { + if (getFrequencySteps() != 0.0F) { + if (step >= 1) return DIR_FORWARD; + if (step <= -1) return DIR_REVERSE; + } + return DIR_NONE; +} + +void Motor::disableBacklash() { + noInterrupts(); + backlashAmountStepsStore = backlashAmountSteps; + motorSteps += backlashSteps; + backlashStepsStore = backlashSteps; + backlashSteps = 0; + interrupts(); +} + +void Motor::enableBacklash() { + noInterrupts(); + backlashSteps = backlashStepsStore; + motorSteps -= backlashSteps; + backlashAmountSteps = backlashAmountStepsStore; + interrupts(); + backlashStepsStore = 0; + backlashAmountStepsStore = 0; +} + +#endif diff --git a/src/lib/axis/motor/Motor.h b/src/lib/axis/motor/Motor.h new file mode 100755 index 0000000..41e399d --- /dev/null +++ b/src/lib/axis/motor/Motor.h @@ -0,0 +1,219 @@ +// ----------------------------------------------------------------------------------- +// Generic motor controller +#pragma once + +#include +#include "../../../Common.h" +#include "Drivers.h" + +#ifdef MOTOR_PRESENT + +enum Direction: uint8_t {DIR_NONE, DIR_FORWARD, DIR_REVERSE, DIR_BOTH}; + +#ifndef STEP_WAVE_FORM +#define STEP_WAVE_FORM SQUARE +#endif + +class Motor { + public: + Motor(uint8_t axisNumber, int8_t reverse); + + // sets up the motor identification + virtual bool init(); + + // returns the number of parameters from the motor and motor driver + virtual uint8_t getParameterCount() { return numParameters; } + + // returns the specified axis parameter + virtual AxisParameter* getParameter(uint8_t number) { if (number > numParameters) return &invalid; else return parameter[number]; } + + // check if parameter is valid + virtual bool parameterIsValid(AxisParameter* parameter, bool next = false); + + // returns the specified axis parameter by name + AxisParameter* getParameterByName(const char* name); + + // sets reversal of axis directions + // \param state: true reverses the direction behavior specified in settings + virtual void setReverse(bool state) { reversed = state; } + + // sets motor enable on/off (if possible) + virtual void enable(bool value) { UNUSED(value); } + + // get the associated stepper motor driver status + virtual DriverStatus getDriverStatus() { return errorStatus; } + + // resets motor and target angular position in steps, also zeros backlash and index + virtual void resetPositionSteps(long value); + + // resets target position to the motor position + void resetTargetToMotorPosition(); + + // get motor position in steps (including backlash) + long getMotorPositionSteps(); + + // get index position in steps + inline long getIndexPositionSteps() { return indexSteps; } + + // get instrument coordinate, in steps + virtual long getInstrumentCoordinateSteps(); + + // set instrument coordinate, in steps + virtual void setInstrumentCoordinateSteps(long value); + + // set instrument park coordinate, in steps + // should only be called when the axis is not moving + void setInstrumentCoordinateParkSteps(long value, int modulo); + + // get target coordinate (with index), in steps + long getTargetCoordinateSteps(); + + // set target coordinate (with index), in steps + void setTargetCoordinateSteps(long value); + + // set target park coordinate, in steps (taking into account stepper motor cogging when powered off) + // should only be called when the axis is not moving + void setTargetCoordinateParkSteps(long value, int modulo); + + // get backlash amount in steps + long getBacklashSteps(); + + // set backlash amount in steps + void setBacklashSteps(long value); + + // mark origin coordinate at current location + void markOriginCoordinateSteps(); + + // distance to target in steps (+/-) + virtual long getTargetDistanceSteps(); + + // distance to origin or target, whichever is closer, in steps + long getOriginOrTargetDistanceSteps(); + + // returns 1 if distance to origin is closer else -1 if target is closer + int getRampDirection(); + + // sets overall maximum frequency + // \param frequency: rate of motion in steps per second + virtual void setFrequencyMax(float frequency) { UNUSED(frequency); } + + // get movement frequency in steps per second + virtual float getFrequencySteps() { return 0; } + + // set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) + virtual void setFrequencySteps(float frequency) { UNUSED(frequency); } + + // set backlash frequency in steps per second + virtual void setBacklashFrequencySteps(float frequency); + + // get tracking mode steps per slewing mode step + virtual int getStepsPerStepSlewing() { return 1; } + + // get synchronized state (automatic movement of target at setFrequencySteps() rate) + inline bool getSynchronized() { return sync; } + + // set synchronized state (automatic movement of target at setFrequencySteps() rate) + virtual inline void setSynchronized(bool state) { + if (state) { + noInterrupts(); + sync = state; + targetSteps = motorSteps; + interrupts(); + } else sync = state; + } + + // get the current direction of motion + Direction getDirection(); + + // microstep sequencer steps + int getSequencerSteps() { return 1; }; + + // set slewing state (hint that we are about to slew or are done slewing) + virtual void setSlewing(bool state) { UNUSED(state); } + + // signal that the motor load has exceeded its threshold + virtual bool isStalled() { return false; } + + // calibrate the motor if required + virtual void calibrate(float value) { UNUSED(value); } + + // calibrate the motor driver if required + virtual void calibrateDriver() {} + + // set zero of absolute encoders + virtual uint32_t encoderZero() { return 0; } + + // return the encoder count, if present + virtual int32_t getEncoderCount() { return 0; } + + // set origin of absolute encoders + virtual void encoderSetOrigin(uint32_t origin) { UNUSED(origin); } + + // true when this motor has an absolute position source after boot + virtual bool hasAbsoluteEncoder() const { return false; } + + // get the motor name + virtual const char* name() { return NULL; } + + // monitor and respond to motor state as required + virtual void poll() {} + + int driverType = OFF; + volatile bool inBacklash = false; // must be true if within the backlash travel + + volatile uint8_t monitorHandle = 0; // handle to the axis task monitor + + bool enabled = false; // enable/disable logical state + + bool ready = false; // set to true after successful init + + bool calibrating = false; // shadow disable when calibrating + + protected: + // disable backlash compensation, to work properly there must be an enable call to match + void disableBacklash(); + + // enable backlash compensation, to work properly this must be proceeded by a disable call + void enableBacklash(); + + volatile uint8_t axisNumber = 0; // axis number for this motor (1 to 9 in OnStepX) + char axisPrefix[32]; // prefix for debug messages + char nameStr[40]; // name of this motor/driver + + volatile bool sync = true; // locks movement of axis target with timer rate + bool limitsCheck = true; // enable/disable numeric range limits (doesn't apply to limit switches) + + uint8_t homeSenseHandle = 0; // home sensor handle + uint8_t minSenseHandle = 0; // limit min sensor handle + uint8_t maxSenseHandle = 0; // limit max sensor handle + + float backlashFrequency = 0.0F; + volatile uint16_t backlashSteps = 0; // count of motor steps taken for backlash + uint16_t backlashStepsStore; // temporary storage for the position in backlash + volatile uint16_t backlashAmountSteps = 0; // the amount of backlash travel + uint16_t backlashAmountStepsStore; // temporary storage for the amount of backlash travel + + long originSteps = 0; // start position for an autoGoto() + volatile long targetSteps = 0; // where we want the motor + volatile long motorSteps = 0; // where the motor is not counting backlash + volatile long indexSteps = 0; // for absolute motor position to axis position + volatile long step = 1; // step size, and for direction control + + // a fault return status + const DriverStatus errorStatus = {false, {false, false}, {false, false}, false, false, false, true}; + + // reverses the set direction of motion + bool reversed = false; + + // set direction of motion + bool normalizedReverse = false; + + // runtime adjustable settings + const int numParameters = 1; + AxisParameter invalid = {NAN, NAN, NAN, NAN, NAN, AXP_INVALID, ""}; + AxisParameter reverse = {NAN, NAN, NAN, 0, 1, AXP_BOOLEAN, AXPN_REVERSE}; + + AxisParameter* parameter[2] = {&invalid, &reverse}; +}; + +#endif diff --git a/src/lib/axis/motor/kTech/KTech.cpp b/src/lib/axis/motor/kTech/KTech.cpp new file mode 100755 index 0000000..6e1db50 --- /dev/null +++ b/src/lib/axis/motor/kTech/KTech.cpp @@ -0,0 +1,377 @@ +// ----------------------------------------------------------------------------------- +// axis ktech servo motor (designed for the MS4010v3) + +#include "KTech.h" + +#ifdef KTECH_MOTOR_PRESENT + +#include "../../../tasks/OnTask.h" +#include "../../../canPlus/CanPlus.h" + +static KTechMotor *ktechMotorInstance[9]; +IRAM_ATTR void moveKTechMotorAxis1() { ktechMotorInstance[0]->move(); } +IRAM_ATTR void moveKTechMotorAxis2() { ktechMotorInstance[1]->move(); } +IRAM_ATTR void moveKTechMotorAxis3() { ktechMotorInstance[2]->move(); } +IRAM_ATTR void moveKTechMotorAxis4() { ktechMotorInstance[3]->move(); } +IRAM_ATTR void moveKTechMotorAxis5() { ktechMotorInstance[4]->move(); } +IRAM_ATTR void moveKTechMotorAxis6() { ktechMotorInstance[5]->move(); } +IRAM_ATTR void moveKTechMotorAxis7() { ktechMotorInstance[6]->move(); } +IRAM_ATTR void moveKTechMotorAxis8() { ktechMotorInstance[7]->move(); } +IRAM_ATTR void moveKTechMotorAxis9() { ktechMotorInstance[8]->move(); } + +void statusKTechMotorAxis1(uint8_t data[8]) { ktechMotorInstance[0]->requestStatusCallback(data); } +void statusKTechMotorAxis2(uint8_t data[8]) { ktechMotorInstance[1]->requestStatusCallback(data); } +void statusKTechMotorAxis3(uint8_t data[8]) { ktechMotorInstance[2]->requestStatusCallback(data); } +void statusKTechMotorAxis4(uint8_t data[8]) { ktechMotorInstance[3]->requestStatusCallback(data); } +void statusKTechMotorAxis5(uint8_t data[8]) { ktechMotorInstance[4]->requestStatusCallback(data); } +void statusKTechMotorAxis6(uint8_t data[8]) { ktechMotorInstance[5]->requestStatusCallback(data); } +void statusKTechMotorAxis7(uint8_t data[8]) { ktechMotorInstance[6]->requestStatusCallback(data); } +void statusKTechMotorAxis8(uint8_t data[8]) { ktechMotorInstance[7]->requestStatusCallback(data); } +void statusKTechMotorAxis9(uint8_t data[8]) { ktechMotorInstance[8]->requestStatusCallback(data); } + +// constructor +KTechMotor::KTechMotor(uint8_t axisNumber, int8_t reverse, const KTechDriverSettings *Settings, bool useFastHardwareTimers) + :Motor(axisNumber, reverse) { + if (axisNumber < 1 || axisNumber > 9) return; + + driverType = ODRIVER; + + strcpy(axisPrefix, " Axis_KTech, "; + axisPrefix[5] = '0' + axisNumber; + + // the motor CAN ID is the axis number! + canID = 0x140 + axisNumber; + + statusMode = Settings->status; + + if (axisNumber > 2) useFastHardwareTimers = false; + this->useFastHardwareTimers = useFastHardwareTimers; + + // attach the function pointers to the callbacks + ktechMotorInstance[this->axisNumber - 1] = this; + switch (this->axisNumber) { + case 1: callback = moveKTechMotorAxis1; break; + case 2: callback = moveKTechMotorAxis2; break; + case 3: callback = moveKTechMotorAxis3; break; + case 4: callback = moveKTechMotorAxis4; break; + case 5: callback = moveKTechMotorAxis5; break; + case 6: callback = moveKTechMotorAxis6; break; + case 7: callback = moveKTechMotorAxis7; break; + case 8: callback = moveKTechMotorAxis8; break; + case 9: callback = moveKTechMotorAxis9; break; + } +} + +bool KTechMotor::init() { + if (!Motor::init()) return false; + + if (!canPlus.ready) { + V("ERR:"); V(axisPrefix); VLF("No CAN interface!"); + return false; + } + + ready = true; + enable(false); + + // start the motion timer + VF("MSG:"); V(axisPrefix); VF("start task to synthesize motion... "); + char timerName[] = "Ax_KTec"; + timerName[2] = axisNumber + '0'; + taskHandle = tasks.add(0, 0, true, 0, callback, timerName); + if (taskHandle) { + VF("success"); + if (useFastHardwareTimers) { + if (!tasks.requestHardwareTimer(taskHandle, 0)) { + VF(" (no hardware timer!)"); + } else { + maxFrequency = (1000000.0F/HAL_MAXRATE_LOWER_LIMIT)/2.0F; + }; + } + VLF(""); + } else { + VLF("FAILED!"); + ready = false; + return false; + } + + stopSyntheticMotion(); + + // get ready for status messages + if (statusMode == ON) { + switch (this->axisNumber) { + case 1: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechMotorAxis1); break; + case 2: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechMotorAxis2); break; + case 3: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechMotorAxis3); break; + case 4: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechMotorAxis4); break; + case 5: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechMotorAxis5); break; + case 6: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechMotorAxis6); break; + case 7: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechMotorAxis7); break; + case 8: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechMotorAxis8); break; + case 9: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechMotorAxis9); break; + } + } + + return true; +} + +// low level reversal of axis directions +// \param state: OFF normal or ON to reverse +void KTechMotor::setReverse(int8_t state) { + if (!ready) return; + + if (state == ON) { + V("WRN:"); V(axisPrefix); VLF("axis reversal must be accomplished with hardware or KTech setup!"); + } +} + +// sets motor enable on/off (if possible) +void KTechMotor::enable(bool state) { + if (!ready || state == enabled) return; + + if (!state) enabled = false; + + stopSyntheticMotion(); + resetToTrackingBaseline(); + + VF("MSG:"); V(axisPrefix); VF("driver powered "); VLF(state ? "up" : "down"); + + // best-effort command (no ACK assumed) + if (state) { + static const uint8_t cmdOn[] = "\x88\x00\x00\x00\x00\x00\x00\x00"; + canPlus.writePacket(canID, cmdOn, 8); + enabled = true; // open window only if we intend to be enabled + } else { + static const uint8_t cmdOff[] = "\x80\x00\x00\x00\x00\x00\x00\x00"; + canPlus.writePacket(canID, cmdOff, 8); + // enabled already false + } +} + +void KTechMotor::setInstrumentCoordinateSteps(long value) { + Motor::setInstrumentCoordinateSteps(value); +} + +// resets motor and target angular position in steps, also zeros backlash and index +void KTechMotor::resetPositionSteps(long value) { + if (!ready) return; + + static const uint8_t cmd[] = "\x95\x00\x00\x00"; + canPlus.txWait(); + canPlus.beginPacket(canID); + canPlus.write(cmd, 4); + canPlus.write((uint8_t*)&value, 4); + canPlus.endPacket(); + + noInterrupts(); + motorSteps = value; + targetSteps = value; + backlashSteps = 0; + interrupts(); +} + +// set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) +void KTechMotor::setFrequencySteps(float frequency) { + if (!ready) return; + + if (!enabled) { stopSyntheticMotion(); return; } + + // negative frequency, convert to positive and reverse the direction + int dir = 0; + if (frequency > 0.0F) dir = 1; else if (frequency < 0.0F) { frequency = -frequency; dir = -1; } + + // if in backlash override the frequency + if (inBacklash) frequency = backlashFrequency; + + if (frequency != currentFrequency) { + // compensate for performace limitations by taking larger steps as needed + if (frequency < maxFrequency) stepSize = 1; else + if (frequency < maxFrequency*2) stepSize = 2; else + if (frequency < maxFrequency*4) stepSize = 4; else + if (frequency < maxFrequency*8) stepSize = 8; else + if (frequency < maxFrequency*16) stepSize = 16; else + if (frequency < maxFrequency*32) stepSize = 32; else + if (frequency < maxFrequency*64) stepSize = 64; else + if (frequency < maxFrequency*128) stepSize = 128; else stepSize = 256; + + // timer period in microseconds + float period = (1000000.0F*stepSize)/frequency; + + // range is 0 to 134 seconds/step + if (!isnan(period) && period <= 130000000.0F) { + period *= 16.0F; + lastPeriod = (unsigned long)lroundf(period); + } else { + lastPeriod = 0; + frequency = 0.0F; + dir = 0; + } + + currentFrequency = frequency; + + // change the motor rate/direction + noInterrupts(); + step = 0; + interrupts(); + tasks.setPeriodSubMicros(taskHandle, lastPeriod); + } + + noInterrupts(); + step = dir * stepSize; + absStep = (int)labs(step); + interrupts(); +} + +float KTechMotor::getFrequencySteps() { + if (!ready) return 0.0F; + + if (lastPeriod == 0) return 0; + return (16000000.0F / lastPeriod) * absStep; +} + +// set slewing state (hint that we are about to slew or are done slewing) +void KTechMotor::setSlewing(bool state) { + if (!ready) return; + + isSlewing = state; +} + +// updates PID and sets ktech position +void KTechMotor::poll() { + const unsigned long now = millis(); + + if (statusMode == ON && (now - lastStatusRequestTime) >= KTECH_STATUS_MS) { + lastStatusRequestTime = now; + static const uint8_t cmd[] = "\x9a\x00\x00\x00\x00\x00\x00\x00"; + canPlus.writePacket(canID, cmd, 8); + } + + // hard faults on loss of comms during motion + if (statusMode == ON) { + if (!hasHeartbeat(KTECH_STATUS_MS * 4U) || status.fault) { + enabled = false; + stopSyntheticMotion(); + resetToTrackingBaseline(); + return; + } + } + + if (!enabled) return; + + if (now - lastSetPositionTime < CAN_SEND_RATE_MS) return; + lastSetPositionTime = now; + + noInterrupts(); + #if KTECH_SLEW_DIRECT == ON + long target = targetSteps + backlashSteps; + #else + long target = motorSteps + backlashSteps; + #endif + interrupts(); + + if (lastTarget != target) { + static const uint8_t cmd[] = "\xa3\x00\x00\x00"; + canPlus.txWait(); + canPlus.beginPacket(canID); + canPlus.write(cmd, 4); + canPlus.write((uint8_t*)&target, 4); + canPlus.endPacket(); + lastTarget = target; + } +} + +void KTechMotor::stopSyntheticMotion() { + if (lastPeriod == 0 && step == 0 && absStep == 0) return; + currentFrequency = 0.0F; + lastPeriod = 0; + noInterrupts(); + step = 0; + absStep = 0; + interrupts(); + if (taskHandle) tasks.setPeriodSubMicros(taskHandle, 0); +} + +void KTechMotor::resetToTrackingBaseline() { + noInterrupts(); + step = 0; + absStep = 0; + inBacklash = false; + backlashSteps = 0; + interrupts(); + + currentFrequency = 0.0F; + lastPeriod = 0; + stepSize = 1; + + // force next poll() to send target + lastTarget = LONG_MIN; +} + +// sets dir as required and moves coord toward target at setFrequencySteps() rate +IRAM_ATTR void KTechMotor::move() { + if (sync && !inBacklash) targetSteps += step; + + if (motorSteps > targetSteps) { + if (backlashSteps > 0) { + backlashSteps -= absStep; + inBacklash = backlashSteps > 0; + } else { + motorSteps -= absStep; + inBacklash = false; + } + } else + + if (motorSteps < targetSteps || inBacklash) { + if (backlashSteps < backlashAmountSteps) { + backlashSteps += absStep; + inBacklash = backlashSteps < backlashAmountSteps; + } else { + motorSteps += absStep; + inBacklash = false; + } + } +} + +void KTechMotor::updateStatus() { + if (statusMode == OFF) return; + if (millis() - lastStatusUpdateTime >= KTECH_STATUS_MS*4U) { + status.outputA.shortToGround = true; + status.outputA.openLoad = true; + status.outputB.shortToGround = true; + status.outputB.openLoad = true; + status.overTemperatureWarning = true; + status.overTemperature = true; + status.standstill = true; + status.fault = true; + status.active = true; + } +} + +// update the associated driver status from CAN +void KTechMotor::requestStatusCallback(uint8_t data[8]) { + if (statusMode == OFF) return; + + uint8_t errorState = data[7]; + status.outputA.shortToGround = false; + status.outputA.openLoad = false; + status.outputB.shortToGround = false; + status.outputB.openLoad = false; + status.overTemperatureWarning = false; + status.overTemperature = bitRead(errorState, 3); + status.standstill = false; + status.fault = bitRead(errorState, 0) || bitRead(errorState, 3); + status.active = true; + + lastStatusUpdateTime = millis(); + statusValid = true; +} + +bool KTechMotor::hasHeartbeat(uint32_t maxAgeMs) const { + if (!ready || statusMode == OFF) return false; + + const unsigned long now = millis(); + const unsigned long age = now - lastStatusUpdateTime; + + return statusValid && (age < maxAgeMs); +} + +#endif diff --git a/src/lib/axis/motor/kTech/KTech.h b/src/lib/axis/motor/kTech/KTech.h new file mode 100755 index 0000000..27d472b --- /dev/null +++ b/src/lib/axis/motor/kTech/KTech.h @@ -0,0 +1,118 @@ +// ----------------------------------------------------------------------------------- +// axis ktech servo motor (designed for the MS4010v3) +#pragma once +#include "../../../../Common.h" + +#ifdef KTECH_MOTOR_PRESENT + +#if !defined(CAN_PLUS) || CAN_PLUS == OFF + #error "No KTECH motor CAN interface!" +#endif + +#include "../Motor.h" +#include "../../../convert/Convert.h" + +// KTECH status rate default 1Hz +#ifndef KTECH_STATUS_MS + #define KTECH_STATUS_MS 1000 +#endif + +// KTECH direct slewing ON or OFF (KTech handles acceleration) +#ifndef KTECH_SLEW_DIRECT + #define KTECH_SLEW_DIRECT OFF +#endif + +typedef struct KTechDriverSettings { + int16_t model; + int8_t status; +} KTechDriverSettings; + +class KTechMotor : public Motor { + public: + // constructor + KTechMotor(uint8_t axisNumber, int8_t reverse, const KTechDriverSettings *Settings, bool useFastHardwareTimers = true); + + // sets up the ktech motor + bool init(); + + // low level reversal of axis directions + // \param state: OFF normal or ON to reverse + void setReverse(int8_t state); + + // sets motor enable on/off (if possible) + void enable(bool value); + + // set instrument coordinate, in steps + void setInstrumentCoordinateSteps(long value); + + // get the associated driver status + DriverStatus getDriverStatus() { if (ready) updateStatus(); else status = errorStatus; return status; } + bool hasHeartbeat(uint32_t maxAgeMs) const; + + // resets motor and target angular position in steps, also zeros backlash and index + void resetPositionSteps(long value); + + // get tracking mode steps per slewing mode step + inline int getStepsPerStepSlewing() { return 256; } + + // get movement frequency in steps per second + float getFrequencySteps(); + + // set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) + void setFrequencySteps(float frequency); + + // set slewing state (hint that we are about to slew or are done slewing) + void setSlewing(bool state); + + // updates PID and sets servo motor power/direction + void poll(); + + // sets dir as required and moves coord toward target at setFrequencySteps() rate + void move(); + + // update the associated driver status + void updateStatus(); + + // update the associated driver status from CAN + void requestStatusCallback(uint8_t data[8]); + + // get the motor name + const char* name() { return "KTECH"; } + + private: + void stopSyntheticMotion(); + void resetToTrackingBaseline(); + + int canID; + + unsigned long lastSetPositionTime = 0; + unsigned long lastStatusRequestTime = 0; + unsigned long lastStatusUpdateTime = 0; + bool statusValid = false; + + uint8_t taskHandle = 0; + + int stepSize = 1; // step size + volatile bool takeStep = false; // should we take a step + long lastTarget = 0; + + float currentFrequency = 0.0F; // last frequency set + unsigned long lastPeriod = 0; // last timer period (in sub-micros) + float maxFrequency = HAL_FRACTIONAL_SEC; // fastest timer rate + + volatile int absStep = 0; // absolute step size (unsigned) + + void (*callback)() = NULL; + + bool useFastHardwareTimers = true; + + bool isSlewing = false; + + int16_t statusMode = OFF; + DriverStatus status = { false, {false, false}, {false, false}, false, false, false, false }; + bool statusRequestSent = false; + + float stepsPerMeasure = 0.0F; +}; + +#endif \ No newline at end of file diff --git a/src/lib/axis/motor/mksServo/MksServo.cpp b/src/lib/axis/motor/mksServo/MksServo.cpp new file mode 100755 index 0000000..b0a910e --- /dev/null +++ b/src/lib/axis/motor/mksServo/MksServo.cpp @@ -0,0 +1,454 @@ +// ----------------------------------------------------------------------------------- +// axis MKS SERVO42D/57D motor driver via CAN, using 0xFE absolute position updates +// EXPERIMENTAL!!! + +#include "MksServo.h" + +#ifdef MKS42D_MOTOR_PRESENT + +#include "../../../tasks/OnTask.h" +#include "../../../canPlus/CanPlus.h" + +static Mks42DMotor *mksMotorInstance[9] = {nullptr}; + +IRAM_ATTR void moveMksAxis1() { mksMotorInstance[0]->move(); } +IRAM_ATTR void moveMksAxis2() { mksMotorInstance[1]->move(); } +IRAM_ATTR void moveMksAxis3() { mksMotorInstance[2]->move(); } +IRAM_ATTR void moveMksAxis4() { mksMotorInstance[3]->move(); } +IRAM_ATTR void moveMksAxis5() { mksMotorInstance[4]->move(); } +IRAM_ATTR void moveMksAxis6() { mksMotorInstance[5]->move(); } +IRAM_ATTR void moveMksAxis7() { mksMotorInstance[6]->move(); } +IRAM_ATTR void moveMksAxis8() { mksMotorInstance[7]->move(); } +IRAM_ATTR void moveMksAxis9() { mksMotorInstance[8]->move(); } + +// Status callbacks (0xF1 and 0x3E both funnel into requestStatusCallback) +static void statusMksAxis1(uint8_t data[8]) { if (mksMotorInstance[0]) mksMotorInstance[0]->requestStatusCallback(data); } +static void statusMksAxis2(uint8_t data[8]) { if (mksMotorInstance[1]) mksMotorInstance[1]->requestStatusCallback(data); } +static void statusMksAxis3(uint8_t data[8]) { if (mksMotorInstance[2]) mksMotorInstance[2]->requestStatusCallback(data); } +static void statusMksAxis4(uint8_t data[8]) { if (mksMotorInstance[3]) mksMotorInstance[3]->requestStatusCallback(data); } +static void statusMksAxis5(uint8_t data[8]) { if (mksMotorInstance[4]) mksMotorInstance[4]->requestStatusCallback(data); } +static void statusMksAxis6(uint8_t data[8]) { if (mksMotorInstance[5]) mksMotorInstance[5]->requestStatusCallback(data); } +static void statusMksAxis7(uint8_t data[8]) { if (mksMotorInstance[6]) mksMotorInstance[6]->requestStatusCallback(data); } +static void statusMksAxis8(uint8_t data[8]) { if (mksMotorInstance[7]) mksMotorInstance[7]->requestStatusCallback(data); } +static void statusMksAxis9(uint8_t data[8]) { if (mksMotorInstance[8]) mksMotorInstance[8]->requestStatusCallback(data); } + +Mks42DMotor::Mks42DMotor(uint8_t axisNumber, + int8_t reverse, + const MksDriverSettings *Settings, + bool useFastHardwareTimers) + : Motor(axisNumber, reverse) { + + if (axisNumber < 1 || axisNumber > 9) return; + + driverType = ODRIVER; + + strcpy(axisPrefix, " Axis_Mks42D, "); + axisPrefix[5] = '0' + axisNumber; + + // Mapping policy: CAN ID == axis number (1..9) + canID = axisNumber; + + // reserve settings for future protocol/status differences + if (Settings) { + model = Settings->model; + statusMode = Settings->status; + } else { + model = 0; + statusMode = OFF; + } + + // AxisParameter defaults (must be assigned here) + // stepsPerSecondToRpm is intentionally *not* used in the simple/robust mode below. + stepsPerSecondToRpm.valueDefault = 0.01F; + maxRpm.valueDefault = 60.0F; + + if (axisNumber > 2) useFastHardwareTimers = false; + this->useFastHardwareTimers = useFastHardwareTimers; + + mksMotorInstance[axisNumber - 1] = this; + switch (axisNumber) { + case 1: callback = moveMksAxis1; break; + case 2: callback = moveMksAxis2; break; + case 3: callback = moveMksAxis3; break; + case 4: callback = moveMksAxis4; break; + case 5: callback = moveMksAxis5; break; + case 6: callback = moveMksAxis6; break; + case 7: callback = moveMksAxis7; break; + case 8: callback = moveMksAxis8; break; + case 9: callback = moveMksAxis9; break; + } +} + +bool Mks42DMotor::init() { + if (!Motor::init()) return false; + + if (!canPlus.ready) { + V("ERR:"); V(axisPrefix); VLF("No CAN interface!"); + return false; + } + + ready = true; + enable(false); + + VF("MSG:"); V(axisPrefix); VF("start task to synthesize motion... "); + char timerName[] = "Ax_Mks_"; + timerName[2] = axisNumber + '0'; + + taskHandle = tasks.add(0, 0, true, 0, callback, timerName); + if (taskHandle) { + VF("success"); + if (useFastHardwareTimers) { + if (!tasks.requestHardwareTimer(taskHandle, 0)) { + VF(" (no hardware timer!)"); + } else { + maxFrequency = (1000000.0F / HAL_MAXRATE_LOWER_LIMIT) / 2.0F; + } + } + VLF(""); + } else { + VLF("FAILED!"); + ready = false; + return false; + } + + stopSyntheticMotion(); + resetToTrackingBaseline(); + + // Always-on heartbeat + protect polling (RX callbacks) + if (statusMode == ON) { + switch (axisNumber) { + case 1: + canPlus.callbackRegisterMessage(canID, 0xF1, statusMksAxis1); + canPlus.callbackRegisterMessage(canID, 0x3E, statusMksAxis1); + break; + case 2: + canPlus.callbackRegisterMessage(canID, 0xF1, statusMksAxis2); + canPlus.callbackRegisterMessage(canID, 0x3E, statusMksAxis2); + break; + case 3: + canPlus.callbackRegisterMessage(canID, 0xF1, statusMksAxis3); + canPlus.callbackRegisterMessage(canID, 0x3E, statusMksAxis3); + break; + case 4: + canPlus.callbackRegisterMessage(canID, 0xF1, statusMksAxis4); + canPlus.callbackRegisterMessage(canID, 0x3E, statusMksAxis4); + break; + case 5: + canPlus.callbackRegisterMessage(canID, 0xF1, statusMksAxis5); + canPlus.callbackRegisterMessage(canID, 0x3E, statusMksAxis5); + break; + case 6: + canPlus.callbackRegisterMessage(canID, 0xF1, statusMksAxis6); + canPlus.callbackRegisterMessage(canID, 0x3E, statusMksAxis6); + break; + case 7: + canPlus.callbackRegisterMessage(canID, 0xF1, statusMksAxis7); + canPlus.callbackRegisterMessage(canID, 0x3E, statusMksAxis7); + break; + case 8: + canPlus.callbackRegisterMessage(canID, 0xF1, statusMksAxis8); + canPlus.callbackRegisterMessage(canID, 0x3E, statusMksAxis8); + break; + case 9: + canPlus.callbackRegisterMessage(canID, 0xF1, statusMksAxis9); + canPlus.callbackRegisterMessage(canID, 0x3E, statusMksAxis9); + break; + } + + statusValid = false; + protectActive = false; + status.fault = false; + lastStatusUpdateTime = 0; + lastStatusRequestTime = 0; + lastProtectRequestTime = 0; + } + + return true; +} + +void Mks42DMotor::setReverse(int8_t state) { + if (!ready) return; + if (state == ON) { + V("WRN:"); V(axisPrefix); VLF("axis reversal must be done in MKS setup or wiring!"); + } +} + +void Mks42DMotor::setReverse(bool state) { + if (state) { + V("WRN:"); V(axisPrefix); VLF("software reverse requested; prefer MKS setup or wiring!"); + } + Motor::setReverse(state); +} + +void Mks42DMotor::enable(bool state) { + if (!ready || state == enabled) return; + + if (!state) enabled = false; + + stopSyntheticMotion(); + resetToTrackingBaseline(); + + VF("MSG:"); V(axisPrefix); VF("driver powered "); VLF(state ? "up" : "down"); + + canPlus.txWait(); + sendF3(state); + + if (state) { + enabled = true; + lastEnableTime = millis(); + + // clear latched faults on enable attempt (simple policy for v1) + status.fault = false; + protectActive = false; + // statusValid remains as-is; always-on polling will refresh it soon + } + + // force next poll() to send target + lastTarget = LONG_MIN; +} + +void Mks42DMotor::resetPositionSteps(long value) { + if (!ready) return; + Motor::resetPositionSteps(value); + + // force next poll() to send target + lastTarget = LONG_MIN; +} + +float Mks42DMotor::getFrequencySteps() { + if (!ready) return 0.0F; + if (lastPeriod == 0) return 0.0F; + return (16000000.0F / lastPeriod) * absStep; +} + +void Mks42DMotor::setFrequencySteps(float frequency) { + if (!ready) return; + if (!enabled) { stopSyntheticMotion(); return; } + + int dir = 0; + if (frequency > 0.0F) dir = 1; + else if (frequency < 0.0F) { frequency = -frequency; dir = -1; } + + if (inBacklash) frequency = backlashFrequency; + + if (frequency != currentFrequency) { + // compensate for performance limitations by taking larger steps as needed + if (frequency < maxFrequency) stepSize = 1; else + if (frequency < maxFrequency*2) stepSize = 2; else + if (frequency < maxFrequency*4) stepSize = 4; else + if (frequency < maxFrequency*8) stepSize = 8; else + if (frequency < maxFrequency*16) stepSize = 16; else + if (frequency < maxFrequency*32) stepSize = 32; else + if (frequency < maxFrequency*64) stepSize = 64; else + if (frequency < maxFrequency*128) stepSize = 128; else stepSize = 256; + + // timer period in microseconds + float period = (1000000.0F * stepSize) / frequency; + + // range is 0 to 134 seconds/step + if (!isnan(period) && period <= 130000000.0F) { + period *= 16.0F; + lastPeriod = (unsigned long)lroundf(period); + } else { + lastPeriod = 0; + frequency = 0.0F; + dir = 0; + } + + currentFrequency = frequency; + + // change the motor rate/direction + noInterrupts(); + step = 0; + interrupts(); + tasks.setPeriodSubMicros(taskHandle, lastPeriod); + } + + noInterrupts(); + step = dir * stepSize; + absStep = (int)labs(step); + interrupts(); +} + +void Mks42DMotor::setSlewing(bool state) { + if (!ready) return; + isSlewing = state; +} + +// ---- CAN helpers ---- + +inline void Mks42DMotor::sendWithCrc(const uint8_t *payload, size_t n) { + if (!payload || n < 1 || n > 7) return; + + uint8_t buf[8] = {0}; + memcpy(buf, payload, n); + buf[n] = crc8((uint16_t)canID, buf, n); + + canPlus.writePacket(canID, buf, n + 1); +} + +inline void Mks42DMotor::sendF3(bool en) { + const uint8_t p[2] = { 0xF3, (uint8_t)(en ? 1 : 0) }; + sendWithCrc(p, 2); +} + +inline void Mks42DMotor::sendFE(int32_t pos, uint16_t speed) { + const int32_t p = clamp24(pos); + const uint32_t u = (uint32_t)p & 0x00FFFFFFUL; // signed 24-bit in low 24 bits + + const uint8_t payload[7] = { + 0xFE, + (uint8_t)(speed >> 8), + (uint8_t)(speed & 0xFF), + (uint8_t)MKS_FE_ACCEL_CONST, + (uint8_t)((u >> 16) & 0xFF), + (uint8_t)((u >> 8) & 0xFF), + (uint8_t)((u >> 0) & 0xFF), + }; + + sendWithCrc(payload, 7); +} + +// Always-on polling commands +inline void Mks42DMotor::sendF1() { const uint8_t p[1] = { 0xF1 }; sendWithCrc(p, 1); } +inline void Mks42DMotor::send3E() { const uint8_t p[1] = { 0x3E }; sendWithCrc(p, 1); } + +// RX: treat 0xF1 and 0x3E as heartbeat sources; latch fault on protect active. +void Mks42DMotor::requestStatusCallback(uint8_t data[8]) { + if (statusMode == OFF) return; + + const uint8_t code = data[0]; + if (code != 0xF1 && code != 0x3E) return; + + lastStatusUpdateTime = millis(); + statusValid = true; + + if (code == 0x3E) { + protectActive = (data[1] != 0); + if (protectActive) status.fault = true; // latch + } + + // Optional extension hook: decode 0xF1 state from data[1] later if desired. +} + +bool Mks42DMotor::hasHeartbeat(uint32_t maxAgeMs) const { + if (!ready || statusMode == OFF) return false; + if (!statusValid) return false; + + const unsigned long now = millis(); + return (now - lastStatusUpdateTime) < maxAgeMs; +} + +// Absolute position streaming (simple/robust): +// - Stream 0xFE target position +// - Use a fixed speed cap (maxRpm) rather than a dynamic feed-forward mapping +void Mks42DMotor::poll() { + if (!ready) return; + + const unsigned long now = millis(); + + // Always-on heartbeat + protect polling + if (statusMode == ON) { + if ((now - lastStatusRequestTime) >= MKS_STATUS_MS) { + lastStatusRequestTime = now; + if (canPlus.txTryLock()) sendF1(); // best-effort, non-blocking + } + + if ((now - lastProtectRequestTime) >= MKS_PROTECT_MS) { + lastProtectRequestTime = now; + if (canPlus.txTryLock()) send3E(); // best-effort, non-blocking + } + + // Hard faults only when enabled, with grace window after enabling + if (enabled) { + const bool inGrace = (now - lastEnableTime) < (unsigned long)MKS_HEARTBEAT_GRACE_MS; + + const bool ok = statusValid ? hasHeartbeat(MKS_STATUS_MS * 4U) : inGrace; + + if (!ok || status.fault) { + enabled = false; + stopSyntheticMotion(); + resetToTrackingBaseline(); + return; + } + } + } + + if (!enabled) return; + + noInterrupts(); + #if MKS_SLEW_DIRECT == ON + long target = targetSteps + backlashSteps; + #else + long target = motorSteps + backlashSteps; + #endif + interrupts(); + + // signed 24-bit domain enforced here + const int32_t pos = clamp24((int32_t)target); + + // simple: speed is a cap (RPM), not a feed-forward term + uint16_t spd = (uint16_t)lroundf(pval(maxRpm)); + if (spd > 3000) spd = 3000; + + // send only on position change (avoid any "speed jitter" surprises) + if (lastTarget == (long)pos) return; + + if (!canPlus.txTryLock()) return; + + sendFE(pos, spd); + + lastTarget = (long)pos; +} + +void Mks42DMotor::stopSyntheticMotion() { + if (lastPeriod == 0 && step == 0 && absStep == 0) return; + currentFrequency = 0.0F; + lastPeriod = 0; + noInterrupts(); + step = 0; + absStep = 0; + interrupts(); + if (taskHandle) tasks.setPeriodSubMicros(taskHandle, 0); +} + +void Mks42DMotor::resetToTrackingBaseline() { + noInterrupts(); + step = 0; + absStep = 0; + inBacklash = false; + backlashSteps = 0; + interrupts(); + + currentFrequency = 0.0F; + lastPeriod = 0; + stepSize = 1; + + // force next poll() to send target + lastTarget = LONG_MIN; +} + +// sets dir as required and moves coord toward target at setFrequencySteps() rate +IRAM_ATTR void Mks42DMotor::move() { + if (sync && !inBacklash) targetSteps += step; + + if (motorSteps > targetSteps) { + if (backlashSteps > 0) { + backlashSteps -= absStep; + inBacklash = backlashSteps > 0; + } else { + motorSteps -= absStep; + inBacklash = false; + } + } else if (motorSteps < targetSteps || inBacklash) { + if (backlashSteps < backlashAmountSteps) { + backlashSteps += absStep; + inBacklash = backlashSteps < backlashAmountSteps; + } else { + motorSteps += absStep; + inBacklash = false; + } + } +} + +#endif diff --git a/src/lib/axis/motor/mksServo/MksServo.h b/src/lib/axis/motor/mksServo/MksServo.h new file mode 100755 index 0000000..5a74d40 --- /dev/null +++ b/src/lib/axis/motor/mksServo/MksServo.h @@ -0,0 +1,184 @@ +// ----------------------------------------------------------------------------------- +// axis MKS SERVO42D/57D motor driver via CAN, using 0xFE absolute position updates +// EXPERIMENTAL!!! +#pragma once +#include "../../../../Common.h" + +#ifdef MKS42D_MOTOR_PRESENT + +#if !defined(CAN_PLUS) || CAN_PLUS == OFF + #error "No MKS motor CAN interface!" +#endif + +#include "../Motor.h" + +#ifndef MKS_SLEW_DIRECT + #define MKS_SLEW_DIRECT OFF +#endif + +#ifndef MKS_FE_ACCEL_CONST + #define MKS_FE_ACCEL_CONST 10 +#endif + +// always-on status request (0xF1) rate +#ifndef MKS_STATUS_MS + #define MKS_STATUS_MS 250 +#endif + +// always-on protect-state request (0x3E) rate +#ifndef MKS_PROTECT_MS + #define MKS_PROTECT_MS 1000 +#endif + +// grace period after enabling before enforcing heartbeat +#ifndef MKS_HEARTBEAT_GRACE_MS + #define MKS_HEARTBEAT_GRACE_MS 1500 +#endif + +typedef struct MksDriverSettings { + int16_t model; + int8_t status; // ON/OFF (enables always-on heartbeat + protect polling) +} MksDriverSettings; + +class Mks42DMotor : public Motor { + public: + Mks42DMotor(uint8_t axisNumber, + int8_t reverse, + const MksDriverSettings *Settings, + bool useFastHardwareTimers = true); + + bool init() override; + + uint8_t getParameterCount() override { return Motor::getParameterCount() + numParameters; } + + AxisParameter* getParameter(uint8_t number) override { + const uint8_t base = Motor::getParameterCount(); + if (number >= 1 && number <= base) return Motor::getParameter(number); + + const uint8_t i = number - base; + if (i == 1) return &stepsPerSecondToRpm; + if (i == 2) return &maxRpm; + return &invalid; + } + + // Integrated-driver style reverse control (kept for parity with other integrated CAN motors) + void setReverse(int8_t state); + + // Base-class reverse (prevents silent bypass if someone calls Motor::setReverse(bool)) + void setReverse(bool state) override; + + void enable(bool state) override; + + void resetPositionSteps(long value) override; + + int getStepsPerStepSlewing() override { return 256; } + + float getFrequencySteps() override; + void setFrequencySteps(float frequency) override; + + void setSlewing(bool state) override; + + void poll() override; + + const char* name() override { return "MKS_FE"; } + + // ISR uses this; not a Motor virtual + void move(); + + // minimal heartbeat API (updated by 0xF1 or 0x3E callbacks) + bool hasHeartbeat(uint32_t maxAgeMs) const; + + // driver status (minimal; only "fault" is currently meaningful) + DriverStatus getDriverStatus() { return ready ? status : errorStatus; } + + // RX callback (wired via CanPlus callbackRegisterMessage) + void requestStatusCallback(uint8_t data[8]); + + private: + static inline uint8_t crc8(uint16_t id11, const uint8_t *data, size_t n) { + uint32_t sum = (uint32_t)(id11 & 0x7FF); + for (size_t i = 0; i < n; i++) sum += data[i]; + return (uint8_t)(sum & 0xFF); + } + + static inline int32_t clamp24(int32_t v) { + if (v > 8388607L) return 8388607L; + if (v < -8388608L) return -8388608L; + return v; + } + + inline float pval(const AxisParameter &p) const { + const float v = p.value; + return isnan(v) ? p.valueDefault : v; + } + + // stepsPerSecondToRpm unit: RPM per (steps/second) + inline uint16_t speedFromStepRate(float stepsPerSec) const { + if (stepsPerSec < 0.0F) stepsPerSec = -stepsPerSec; + + const float scale = pval(stepsPerSecondToRpm); + float sF = stepsPerSec * scale; + if (sF < 0.0F) sF = 0.0F; + + // MKS protocol speed range is 0..3000 RPM; keep the clamp aligned to that. + float capF = pval(maxRpm); + if (capF < 0.0F) capF = 0.0F; + if (capF > 3000.0F) capF = 3000.0F; + + if (sF > capF) sF = capF; + return (uint16_t)lroundf(sF); + } + + inline void sendWithCrc(const uint8_t *payload, size_t n); // n<=7 + inline void sendF3(bool en); + inline void sendFE(int32_t pos, uint16_t speed); + + // Always-on polling helpers + inline void sendF1(); // queryStatus (0xF1) + inline void send3E(); // readProtectState (0x3E) + + void stopSyntheticMotion(); + void resetToTrackingBaseline(); + + int canID = 0; + + // reserved / future + int16_t model = 0; + int8_t statusMode = OFF; + + uint8_t taskHandle = 0; + + int stepSize = 1; + float currentFrequency = 0.0F; + unsigned long lastPeriod = 0; + float maxFrequency = HAL_FRACTIONAL_SEC; + + volatile int absStep = 0; + + void (*callback)() = nullptr; + + bool useFastHardwareTimers = true; + bool isSlewing = false; + + long lastTarget = LONG_MIN; + + // --- always-on heartbeat / protect state --- + unsigned long lastStatusRequestTime = 0; + unsigned long lastProtectRequestTime = 0; + unsigned long lastStatusUpdateTime = 0; + unsigned long lastEnableTime = 0; + bool statusValid = false; + + bool protectActive = false; // latched via 0x3E + + // Minimal status model: only "fault" is currently meaningful + DriverStatus status = { false, {false, false}, {false, false}, false, false, false, false }; + + // runtime adjustable settings + AxisParameter stepsPerSecondToRpm = {NAN, NAN, NAN, 0.0F, 10000.0F, AXP_FLOAT, "Steps/s to RPM"}; + AxisParameter maxRpm = {NAN, NAN, NAN, 0.0F, 3000.0F, AXP_INTEGER, "Max Speed RPM"}; + + const int numParameters = 2; +}; + +#endif diff --git a/src/lib/axis/motor/oDrive/ODrive.cpp b/src/lib/axis/motor/oDrive/ODrive.cpp new file mode 100755 index 0000000..71bb71f --- /dev/null +++ b/src/lib/axis/motor/oDrive/ODrive.cpp @@ -0,0 +1,288 @@ +// ----------------------------------------------------------------------------------- +// axis odrive servo motor + +#include "ODrive.h" + +#ifndef ODRIVE_NEW_MOTOR_PRESENT +#ifdef ODRIVE_MOTOR_PRESENT + +#include "../../../tasks/OnTask.h" +#include "../../../gpioEx/GpioEx.h" + +#include "ODriveEnums.h" + +ODriveMotor *odriveMotorInstance[2]; +IRAM_ATTR void moveODriveMotorAxis1() { odriveMotorInstance[0]->move(); } +IRAM_ATTR void moveODriveMotorAxis2() { odriveMotorInstance[1]->move(); } + +// ODrive servo motor driver object pointer +#if ODRIVE_COMM_MODE == OD_UART + ODriveArduino *_oDriveDriver; +#elif ODRIVE_COMM_MODE == OD_CAN + ODriveTeensyCAN *_oDriveDriver; +#endif + +// constructor +ODriveMotor::ODriveMotor(uint8_t axisNumber, int8_t reverse, const ODriveDriverSettings *Settings, float radsPerCount, bool useFastHardwareTimers) + :Motor(axisNumber, reverse) { + if (axisNumber < 1 || axisNumber > 2) return; + + driverType = ODRIVER; + + #if ODRIVE_SWAP_AXES == ON + this->axisNumber = 3 - axisNumber; + #else + this->axisNumber = axisNumber; + #endif + + strcpy(axisPrefix, " Axis_ODrive, "); + axisPrefix[5] = '0' + axisNumber; + + if (axisNumber > 2) useFastHardwareTimers = false; + this->useFastHardwareTimers = useFastHardwareTimers; + + if (axisNumber == 1) { // only do once since motor 2 object creation could + #if ODRIVE_COMM_MODE == OD_UART + _oDriveDriver = new ODriveArduino(ODRIVE_SERIAL); + #elif ODRIVE_COMM_MODE == OD_CAN + _oDriveDriver = new ODriveTeensyCAN(250000); + #endif + } + + // set parameter default values during object creation + radsPerCount.valueDefualt = radsPerCount; + + // attach the function pointers to the callbacks + odriveMotorInstance[this->axisNumber - 1] = this; + switch (this->axisNumber) { + case 1: callback = moveODriveMotorAxis1; break; + case 2: callback = moveODriveMotorAxis2; break; + } +} + +bool ODriveMotor::init() { + if (!Motor::init()) return false; + + if (axisNumber == 1) { + pinModeEx(ODRIVE_RST_PIN, OUTPUT); + digitalWriteEx(ODRIVE_RST_PIN, HIGH); // bring ODrive out of Reset + delay(1000); // allow time for ODrive to boot + + #if ODRIVE_COMM_MODE == OD_UART + ODRIVE_SERIAL.begin(ODRIVE_SERIAL_BAUD); + VF("MSG:"); V(axisPrefix); VLF("SERIAL channel init"); + #elif ODRIVE_COMM_MODE == OD_CAN + // .begin is done by the constructor + VF("MSG:"); V(axisPrefix); VLF("CAN channel init"); + #endif + } + + enable(false); + + // start the motion timer + VF("MSG:"); V(axisPrefix); VF("start task to synthesize motion... "); + char timerName[] = "Target_"; + timerName[6] = '0' + axisNumber; + taskHandle = tasks.add(0, 0, true, 0, callback, timerName); + if (taskHandle) { + V("success"); + if (useFastHardwareTimers && !tasks.requestHardwareTimer(taskHandle, 0)) { VLF(" (no hardware timer!)"); } else { VLF(""); } + } else { + VLF("FAILED!"); + return false; + } + + ready = true; + return true; +} + +// set motor reverse state +void ODriveMotor::setReverse(int8_t state) { + if (!ready) return; + + if (state == ON) { + VF("MSG:"); V(axisPrefix); VLF("axis reversal must be accomplished with hardware or ODrive setup!"); + } +} + +// sets motor enable on/off (if possible) +void ODriveMotor::enable(bool state) { + if (!ready) return; + + VF("MSG:"); V(axisPrefix); VF("driver powered "); if (state) { VLF("up"); } else { VLF("down"); } + + int requestedState = AXIS_STATE_IDLE; + if (state) requestedState = AXIS_STATE_CLOSED_LOOP_CONTROL; + + #if ODRIVE_COMM_MODE == OD_UART + float timeout = 0.5; + if(!_oDriveDriver->run_state(axisNumber - 1, requestedState, false, timeout)) { + VF("MSG:"); V(axisPrefix); VLF(" Power, closed loop control - command timeout!"); + return; + } + #elif ODRIVE_COMM_MODE == OD_CAN + if(!_oDriveDriver->RunState(axisNumber - 1, requestedState)) { //currently, always returns true...need to add timeout + VF("MSG:"); V(axisPrefix); VLF(" Power, closed loop control - command timeout!"); + return; + } + #endif + + VF("MSG:"); V(axisPrefix); VF("closed loop control - "); if (state) { VLF("Active"); } else { VLF("Idle"); } + + enabled = state; +} + +void ODriveMotor::setInstrumentCoordinateSteps(long value) { + if (!ready) return; + + #if ODRIVE_ABSOLUTE == ON && ODRIVE_SYNC_LIMIT != OFF + noInterrupts(); + long index = value - motorSteps; + interrupts(); + float indexDeg = index/radsPerCount.value; + if (indexDeg >= -degToRadF(ODRIVE_SYNC_LIMIT/3600.0F) && indexDeg <= degToRadF(ODRIVE_SYNC_LIMIT/3600.0F)) + #endif + Motor::setInstrumentCoordinateSteps(value); +} + +// resets motor and target angular position in steps, also zeros backlash and index +void ODriveMotor::resetPositionSteps(long value) { + if (!ready) return; + + // this is where the initial odrive position in "steps" is brought into agreement with the motor position in steps + // not sure on this... but code below ignores (value,) gets the odrive position convert to steps and resets the motor + // there (as the odrive encoders are absolute.) + + long oPosition; + // if (axisNumber - 1 == 0) oPosition = o_position0; + // if (axisNumber - 1 == 1) oPosition = o_position1; + + // get ODrive position in fractionial Turns + #if ODRIVE_COMM_MODE == OD_UART + oPosition = _oDriveDriver->GetPosition(axisNumber - 1)*TWO_PI*radsPerCount.value; // axis1/2 are in steps per radian + #elif ODRIVE_COMM_MODE == OD_CAN + oPosition = _oDriveDriver->GetPosition(axisNumber - 1)*TWO_PI*radsPerCount.value; // axis1/2 are in steps per radian + #endif + + noInterrupts(); + motorSteps = oPosition; + targetSteps = motorSteps; + #if ODRIVE_ABSOLUTE == OFF + // but what if the odrive encoders are incremental? how to tell the odrive what its angular position is? + // here thinking we'll ignore it... sync OnStepX there and let the offset handle it + indexSteps = value - motorSteps; + #else + UNUSED(value); + indexSteps = 0; + #endif + backlashSteps = 0; + interrupts(); +} + +// set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) +void ODriveMotor::setFrequencySteps(float frequency) { + if (!ready) return; + + // negative frequency, convert to positive and reverse the direction + int dir = 0; + if (frequency > 0.0F) dir = 1; else if (frequency < 0.0F) { frequency = -frequency; dir = -1; } + + // if in backlash override the frequency + if (inBacklash) + frequency = backlashFrequency; + + if (frequency != currentFrequency) { + lastFrequency = frequency; + + // if slewing has a larger step size divide the frequency to account for it + if (lastFrequency <= backlashFrequency * 2.0F) stepSize = 1; else { if (!inBacklash) stepSize = 64; } + frequency /= stepSize; + + // timer period in microseconds + float period = 1000000.0F / frequency; + + // range is 0 to 134 seconds/step + if (!isnan(period) && period <= 130000000.0F) { + period *= 16.0F; + lastPeriod = (unsigned long)lroundf(period); + } else { + lastPeriod = 0; + frequency = 0.0F; + dir = 0; + } + + currentFrequency = frequency; + + // change the motor rate/direction + noInterrupts(); + step = 0; + interrupts(); + tasks.setPeriodSubMicros(taskHandle, lastPeriod); + } + + noInterrupts(); + step = dir * stepSize; + absStep = abs(step); + interrupts(); +} + +float ODriveMotor::getFrequencySteps() { + if (!ready) return 0.0F; + + if (lastPeriod == 0) return 0.0F; + return (16000000.0F / lastPeriod) * absStep; +} + +// set slewing state (hint that we are about to slew or are done slewing) +void ODriveMotor::setSlewing(bool state) { + if (!ready) return; + + isSlewing = state; +} + +// updates PID and sets odrive position +void ODriveMotor::poll() { + if ((long)(millis() - lastSetPositionTime) < ODRIVE_UPDATE_MS) return; + lastSetPositionTime = millis(); + + noInterrupts(); + #if ODRIVE_SLEW_DIRECT == ON + long target = targetSteps + backlashSteps; + #else + long target = motorSteps + backlashSteps; + #endif + interrupts(); + #if ODRIVE_COMM_MODE == OD_UART + setPosition(axisNumber -1, target/(TWO_PI*radsPerCount.value)); + #elif ODRIVE_COMM_MODE == OD_CAN + _oDriveDriver->SetPosition(axisNumber -1, target/(TWO_PI*radsPerCount.value)); + #endif +} + +// sets dir as required and moves coord toward target at setFrequencySteps() rate +IRAM_ATTR void ODriveMotor::move() { + if (sync && !inBacklash) targetSteps += step; + + if (motorSteps > targetSteps) { + if (backlashSteps > 0) { + backlashSteps -= absStep; + inBacklash = backlashSteps > 0; + } else { + motorSteps -= absStep; + inBacklash = false; + } + } else + + if (motorSteps < targetSteps || inBacklash) { + if (backlashSteps < backlashAmountSteps) { + backlashSteps += absStep; + inBacklash = backlashSteps < backlashAmountSteps; + } else { + motorSteps += absStep; + inBacklash = false; + } + } +} + +#endif +#endif diff --git a/src/lib/axis/motor/oDrive/ODrive.h b/src/lib/axis/motor/oDrive/ODrive.h new file mode 100755 index 0000000..cba9388 --- /dev/null +++ b/src/lib/axis/motor/oDrive/ODrive.h @@ -0,0 +1,181 @@ +// ----------------------------------------------------------------------------------- +// axis oDrive servo motor +#pragma once +#include "../../../../Common.h" + +#ifndef ODRIVE_NEW_MOTOR_PRESENT +#ifdef ODRIVE_MOTOR_PRESENT + +#include "../Motor.h" +#include "../../../convert/Convert.h" + +// the following would be in the pinmap normally and should trigger #error on compile here when not present +// for now, they fit your hardware as best as I can tell... +#ifndef ODRIVE_SERIAL + #define ODRIVE_SERIAL Serial3 // Teensy HW Serial3 (if used,) for example +#endif +#ifndef ODRIVE_SERIAL_BAUD + #define ODRIVE_SERIAL_BAUD 115200 // was 19200 +#endif + +#ifndef ODRIVE_RST_PIN + #define ODRIVE_RST_PIN 3 +#endif + +// odrive update rate default 10Hz +#ifndef ODRIVE_UPDATE_MS + #define ODRIVE_UPDATE_MS 100 // was 3000 +#endif + +// odrive direct slewing ON or OFF (ODrive handles acceleration) +// ON to use ODrive trapezoidal move profile, OFF for OnStep move profile +#ifndef ODRIVE_SLEW_DIRECT + #define ODRIVE_SLEW_DIRECT OFF +#endif + +// odrive if using absolute encoders set to ON +#ifndef ODRIVE_ABSOLUTE + #define ODRIVE_ABSOLUTE ON // was OFF +#endif + +// odrive sync limit (for absolute encoders) OFF or specify the sync limit in arc-seconds +// this should, I hope, allow you to limit just how far from the encoders you can sync. (+/-) to fine-tune the origin +// with absolute encoders this protects you from exceeding the software min/max limits by > the amount specified +// in arc seconds..one encoder tick encoder resolution = 2^14 = 16380 +// 16380/360=45.5 ticks/deg; 45.5/60=0.7583 ticks/min; 0.7583/60 = .00126 ticks/sec +// or 1/0.7583 = 1.32 arc-min/tick; 1.32*60 sec = 79.2 arc sec per encoder tick +#ifndef ODRIVE_SYNC_LIMIT + #define ODRIVE_SYNC_LIMIT 80 // was OFF +#endif + +// Use OD_UART or OD_CAN...I2C may be added later +#ifndef ODRIVE_COMM_MODE + #define ODRIVE_COMM_MODE OD_CAN +#endif + +// ODrive axis 0 = OnStep Axis2 = DEC or ALT +// ODrive axis 1 = OnStep Axis1 = RA or AZM +#ifndef ODRIVE_SWAP_AXES + #define ODRIVE_SWAP_AXES ON +#endif + +#if ODRIVE_COMM_MODE == OD_UART + #include // https://github.com/odriverobotics/ODrive/tree/master/Arduino/ODriveArduino + // ODrive servo motor serial driver + extern ODriveArduino *_oDriveDriver; +#elif ODRIVE_COMM_MODE == OD_CAN + #include // https://github.com/tonton81/FlexCAN_T4.git + // changes were required to this CAN library so it is local now + #include "src/plugins/DDScope/ODriveTeensyCAN/ODriveTeensyCAN.h" //https://github.com/Malaphor/ODriveTeensyCAN.git + extern ODriveTeensyCAN *_oDriveDriver; +#endif + +typedef struct ODriveDriverSettings { + int16_t model; + int8_t status; +} ODriveDriverSettings; + +class ODriveMotor : public Motor { + public: + // constructor + ODriveMotor(uint8_t axisNumber, int8_t reverse, const ODriveDriverSettings *Settings, float radsPerCount, bool useFastHardwareTimers = true); + + // sets up the odrive motor + bool init(); + + // returns the number of parameters from the motor + uint8_t getParameterCount() { return Motor::getParameterCount() + numParameters; } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { + if (number == Motor::getParameterCount() + 1) return &radsPerCount; else + if (number >= 1 && number <= Motor::getParameterCount()) return Motor::getParameter(number); else + return &invalid; + } + + // set motor reverse state + void setReverse(int8_t state); + + // sets motor enable on/off (if possible) + void enable(bool value); + + bool hasAbsoluteEncoder() const override { return ODRIVE_ABSOLUTE == ON; } + + // set instrument coordinate, in steps + void setInstrumentCoordinateSteps(long value); + + // get the associated driver status + inline DriverStatus getDriverStatus() { if (ready) return status; else return errorStatus; } + + // resets motor and target angular position in steps, also zeros backlash and index + void resetPositionSteps(long value); + + // get tracking mode steps per slewing mode step + inline int getStepsPerStepSlewing() { return 64; } + + // get movement frequency in steps per second + float getFrequencySteps(); + + // set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) + void setFrequencySteps(float frequency); + + // set slewing state (hint that we are about to slew or are done slewing) + void setSlewing(bool state); + + // get the motor name + const char* name() { return "ODRIVE"; } + + // updates PID and sets servo motor power/direction + void poll(); + + // sets dir as required and moves coord toward target at setFrequencySteps() rate + void move(); + + private: + +// float o_position0 = 0; +// float o_position1 = 0; + + #if ODRIVE_COMM_MODE == OD_UART + // special command to send high resolution position to odrive + void setPosition(int motor_number, float position) { +// if (motor_number == 0) o_position0 = position; +// if (motor_number == 1) o_position1 = position; + char command[32]; + sprintF(command, "p n %1.8f\n", position); + command[2] = '0' + motor_number; + ODRIVE_SERIAL.print(command); + } + #endif + + unsigned long lastSetPositionTime = 0; + uint8_t oDriveMonitorHandle = 0; + uint8_t taskHandle = 0; + + int stepSize = 1; // step size + volatile int homeSteps = 1; // step count for microstep sequence between home positions (driver indexer) + volatile bool takeStep = false; // should we take a step + + float currentFrequency = 0.0F; // last frequency set + float lastFrequency = 0.0F; // last frequency requested + unsigned long lastPeriod = 0; // last timer period (in sub-micros) + + volatile int absStep = 1; // absolute step size (unsigned) + + void (*callback)() = NULL; + + bool useFastHardwareTimers = true; + + bool isSlewing = false; + + DriverStatus status = { false, {false, false}, {false, false}, false, false, false, false }; + + // runtime adjustable settings + AxisParameter radsPerCount = {NAN, NAN, NAN, degToRadF(300.0), degToRadF(360000.0), AXP_FLOAT, AXPN_RADS_PER_COUNT}; + + const int numParameters = 1; + AxisParameter* parameter[2] = {&invalid, &radsPerCount}; +}; + +#endif +#endif diff --git a/src/lib/axis/motor/oDrive/ODriveCanPlus.cpp b/src/lib/axis/motor/oDrive/ODriveCanPlus.cpp new file mode 100755 index 0000000..55708a2 --- /dev/null +++ b/src/lib/axis/motor/oDrive/ODriveCanPlus.cpp @@ -0,0 +1,220 @@ +// ----------------------------------------------------------------------------------- +// axis oDrive servo motor CanPlus interface + +#include "ODriveCanPlus.h" + +#ifdef ODRIVE_NEW_MOTOR_PRESENT +#ifdef ODRIVE_MOTOR_PRESENT + +#include "../../../tasks/OnTask.h" +#include "../../../canPlus/CanPlus.h" + +static void odHb0(uint8_t d[8]) { odriveCan.onHeartbeat(0, d); } +static void odEnc0(uint8_t d[8]) { odriveCan.onFeedbackPosVel(0, d); } +static void odHb1(uint8_t d[8]) { odriveCan.onHeartbeat(1, d); } +static void odEnc1(uint8_t d[8]) { odriveCan.onFeedbackPosVel(1, d); } +static void odVer0(uint8_t d[8]) { odriveCan.onGetVersion(0, d); } +static void odVer1(uint8_t d[8]) { odriveCan.onGetVersion(1, d); } + +bool ODriveCanPlus::init(uint8_t node) { + if (!canPlus.ready) return false; + switch (node) { + case 0: + canPlus.callbackRegisterId(makeId(0, CMD_HEARTBEAT), odHb0); + canPlus.callbackRegisterId(makeId(0, CMD_GET_ENCODER_EST), odEnc0); + canPlus.callbackRegisterId(makeId(0, CMD_GET_VERSION), odVer0); + return true; + case 1: + canPlus.callbackRegisterId(makeId(1, CMD_HEARTBEAT), odHb1); + canPlus.callbackRegisterId(makeId(1, CMD_GET_ENCODER_EST), odEnc1); + canPlus.callbackRegisterId(makeId(1, CMD_GET_VERSION), odVer1); + return true; + default: + return false; + } +} + +bool ODriveCanPlus::getVersionSnapshot(uint8_t node, + uint8_t raw[8], + uint16_t& proto, + uint8_t& fw_major, + uint8_t& fw_minor, + uint8_t& fw_rev, + uint8_t& hw_variant, + uint8_t& hw_version) const { + if (node >= MaxNodes || raw == nullptr) return false; + + uint8_t seen; + noInterrupts(); + seen = cache_[node].seen; + if (!(seen & SEEN_VER)) { interrupts(); return false; } + + proto = cache_[node].proto_ver; + fw_major = cache_[node].fw_major; + fw_minor = cache_[node].fw_minor; + fw_rev = cache_[node].fw_rev; + hw_variant = cache_[node].hw_variant; + hw_version = cache_[node].hw_version; + for (int i = 0; i < 8; i++) raw[i] = cache_[node].ver_raw[i]; + interrupts(); + + return true; +} + +bool ODriveCanPlus::hasFreshVersion(uint8_t node, uint32_t max_age_ms) const { + if (node >= MaxNodes) return false; + uint8_t seen; + uint32_t t; + noInterrupts(); + seen = cache_[node].seen; + t = cache_[node].last_ver_ms; + interrupts(); + if (!(seen & SEEN_VER)) return false; + return (uint32_t)(millis() - t) <= max_age_ms; +} + +bool ODriveCanPlus::setAxisState(uint8_t node, uint32_t requested_state) { + if (!canPlus.ready || node >= MaxNodes) return false; + + uint8_t d[8] = {0}; + put_le32(&d[0], requested_state); + + canPlus.txWait(); + return canPlus.writePacket(makeId(node, CMD_SET_AXIS_STATE), d, 8) == 1; +} + +uint8_t ODriveCanPlus::axisState(uint8_t node) const { + if (node >= MaxNodes) return 0; + noInterrupts(); + uint8_t s = cache_[node].axis_state; + interrupts(); + return s; +} + +void ODriveCanPlus::setInputPos(uint8_t node, float pos_turns, float vel_ff_turns_s , float tq_ff_nm) { + if (!canPlus.ready || node >= MaxNodes) return; + + uint8_t d[8] = {0}; + + const int32_t vel_i = lroundf(vel_ff_turns_s * 1000.0F); + const int32_t tq_i = lroundf(tq_ff_nm * 1000.0F); + + put_f32(&d[0], pos_turns); + put_le16(&d[4], clamp_i16(vel_i)); + put_le16(&d[6], clamp_i16(tq_i)); + + if (canPlus.txTryLock()) { + canPlus.writePacket(makeId(node, CMD_SET_INPUT_POS), d, 8); + } +} + +float ODriveCanPlus::getPosTurns(uint8_t node) const { + if (node >= MaxNodes) return 0.0F; + noInterrupts(); + float p = cache_[node].pos_turns; + interrupts(); + return p; +} + +bool ODriveCanPlus::hasFreshTurns(uint8_t node, uint32_t max_age_ms) const { + if (node >= MaxNodes) return false; + uint8_t seen; + uint32_t t; + noInterrupts(); + seen = cache_[node].seen; + t = cache_[node].last_enc_ms; + interrupts(); + if (!(seen & SEEN_ENC)) return false; + return (uint32_t)(millis() - t) <= max_age_ms; +} + +bool ODriveCanPlus::hasHeartbeat(uint8_t node, uint32_t max_age_ms) const { + if (node >= MaxNodes) return false; + uint8_t seen; + uint32_t t; + noInterrupts(); + seen = cache_[node].seen; + t = cache_[node].last_hb_ms; + interrupts(); + if (!(seen & SEEN_HB)) return false; + return (uint32_t)(millis() - t) <= max_age_ms; +} + +uint32_t ODriveCanPlus::lastHeartbeatMs(uint8_t node) const { + if (node >= MaxNodes) return 0; + noInterrupts(); + uint32_t t = cache_[node].last_hb_ms; + interrupts(); + return t; +} + +uint32_t ODriveCanPlus::lastError(uint8_t node) const { + if (node >= MaxNodes) return 0; + noInterrupts(); + uint32_t e = cache_[node].last_err; + interrupts(); + return e; +} + +void ODriveCanPlus::onHeartbeat(uint8_t node, const uint8_t* d, uint8_t len) { + if (node >= MaxNodes || len < 7) return; + + cache_[node].last_hb_ms = millis(); + cache_[node].last_err = + (uint32_t(d[0]) ) | + (uint32_t(d[1]) << 8) | + (uint32_t(d[2]) << 16) | + (uint32_t(d[3]) << 24); + cache_[node].axis_state = d[4]; + + ATOMIC_OR(cache_[node].seen, SEEN_HB); + + // optionally store: + // cache_[node].procedure_result = d[5]; + // cache_[node].traj_done = d[6]; +} + +bool ODriveCanPlus::requestVersion(uint8_t node) { + if (!canPlus.ready || node >= MaxNodes) return false; + return canPlus.writePacketRtr(makeId(node, CMD_GET_VERSION), 8) == 1; +} + +bool ODriveCanPlus::requestTurns(uint8_t node) { + if (!canPlus.ready || node >= MaxNodes) return false; + return canPlus.writePacketRtr(makeId(node, CMD_GET_ENCODER_EST), 8) == 1; +} + +void ODriveCanPlus::onGetVersion(uint8_t node, const uint8_t* d, uint8_t len) { + if (node >= MaxNodes || len < 8) return; + + const uint32_t now = millis(); + + for (int i = 0; i < 8; i++) cache_[node].ver_raw[i] = d[i]; + + cache_[node].proto_ver = get_u16_le(&d[0]); + cache_[node].fw_major = d[2]; + cache_[node].fw_minor = d[3]; + cache_[node].fw_rev = d[4]; + cache_[node].hw_variant = d[5]; + cache_[node].hw_version = d[6]; + + cache_[node].last_ver_ms = now; // write time first + + ATOMIC_OR(cache_[node].seen, SEEN_VER); +} + +void ODriveCanPlus::onFeedbackPosVel(uint8_t node, const uint8_t* d, uint8_t len) { + if (node >= MaxNodes || len < 8) return; + + // Example: pos_turns (f32) + vel_turns/s (f32) + cache_[node].pos_turns = get_f32(d + 0); + cache_[node].vel_turns_s = get_f32(d + 4); + cache_[node].last_enc_ms = millis(); + + ATOMIC_OR(cache_[node].seen, SEEN_ENC); +} + +ODriveCanPlus odriveCan; + +#endif +#endif diff --git a/src/lib/axis/motor/oDrive/ODriveCanPlus.h b/src/lib/axis/motor/oDrive/ODriveCanPlus.h new file mode 100755 index 0000000..b4b119d --- /dev/null +++ b/src/lib/axis/motor/oDrive/ODriveCanPlus.h @@ -0,0 +1,113 @@ +// ----------------------------------------------------------------------------------- +// axis oDrive servo motor CanPlus interface +#pragma once +#include "../../../../Common.h" + +#ifdef ODRIVE_NEW_MOTOR_PRESENT +#ifdef ODRIVE_MOTOR_PRESENT + +class ODriveCanPlus { +public: + bool init(uint8_t node); + + bool getVersionSnapshot(uint8_t node, + uint8_t raw[8], + uint16_t& proto, + uint8_t& fw_major, + uint8_t& fw_minor, + uint8_t& fw_rev, + uint8_t& hw_variant, + uint8_t& hw_version) const; + + bool setAxisState(uint8_t node, uint32_t requested_state); + uint8_t axisState(uint8_t node) const; + + void setInputPos(uint8_t node, float pos_turns, float vel_ff_turns_s = 0.0F, float tq_ff_nm = 0.0F); + float getPosTurns(uint8_t node) const; // cached feedback + bool hasFreshTurns(uint8_t node, uint32_t max_age_ms = 250U) const; + + void onGetVersion(uint8_t node, const uint8_t* d, uint8_t len = 8); + bool hasFreshVersion(uint8_t node, uint32_t max_age_ms = 1000U) const; + + bool hasHeartbeat(uint8_t node, uint32_t max_age_ms = 250U) const; + uint32_t lastHeartbeatMs(uint8_t node) const; + uint32_t lastError(uint8_t node) const; + + void onHeartbeat(uint8_t node, const uint8_t* d, uint8_t len = 8); + void onFeedbackPosVel(uint8_t node, const uint8_t* d, uint8_t len = 8); + + bool requestVersion(uint8_t node); + bool requestTurns(uint8_t node); + +private: + + // helpers + constexpr uint8_t CmdBits = 5; + static inline uint16_t makeId(uint8_t node, uint8_t cmd) { return (uint16_t(node) << CmdBits) | (cmd & 0x1F); } + + static inline void put_le16(uint8_t* p, int16_t v) { p[0] = uint8_t(v & 0xFF); p[1] = uint8_t((v >> 8) & 0xFF); } + static inline void put_le32(uint8_t* p, uint32_t v) { + p[0]=(uint8_t)v; + p[1]=(uint8_t)(v>>8); + p[2]=(uint8_t)(v>>16); + p[3]=(uint8_t)(v>>24); + } + static inline void put_f32(uint8_t* p, float f) { + static_assert(sizeof(float) == 4, "float must be 32-bit"); + uint32_t u; + memcpy(&u, &f, 4); + put_le32(p, u); + } + + static inline float get_f32(const uint8_t* p) { + uint32_t u = (uint32_t(p[0])) | + (uint32_t(p[1]) << 8) | + (uint32_t(p[2]) << 16) | + (uint32_t(p[3]) << 24); + float f; + memcpy(&f, &u, 4); + return f; + } + static inline uint16_t get_u16_le(const uint8_t* p) { return (uint16_t)p[0] | ((uint16_t)p[1] << 8); } + + static inline int16_t clamp_i16(int32_t x) { + if (x > 32767) return 32767; + if (x < -32768) return -32768; + return (int16_t)x; + } + + // ODrive CMD IDs + static constexpr uint8_t CMD_GET_VERSION = 0x00; + static constexpr uint8_t CMD_HEARTBEAT = 0x01; + static constexpr uint8_t CMD_SET_AXIS_STATE = 0x07; + static constexpr uint8_t CMD_SET_INPUT_POS = 0x0C; + static constexpr uint8_t CMD_GET_ENCODER_EST = 0x09; + + // startup state + static constexpr uint8_t SEEN_HB = 0x01; + static constexpr uint8_t SEEN_ENC = 0x02; + static constexpr uint8_t SEEN_VER = 0x04; + + struct AxisCache { + volatile float pos_turns = 0.0F; + volatile float vel_turns_s = 0.0F; + volatile uint32_t last_hb_ms = 0; + volatile uint32_t last_err = 0; + volatile uint8_t axis_state = 0; + volatile uint32_t last_enc_ms = 0; + volatile uint32_t last_ver_ms = 0; + volatile uint8_t ver_raw[8] = {0}; + volatile uint16_t proto_ver = 0; + volatile uint8_t fw_major = 0, fw_minor = 0, fw_rev = 0; + volatile uint8_t hw_variant = 0, hw_version = 0; + volatile uint8_t seen = 0; + }; + + static constexpr uint8_t MaxNodes = 2; + AxisCache cache_[MaxNodes]; +}; + +extern ODriveCanPlus odriveCan; + +#endif +#endif diff --git a/src/lib/axis/motor/oDrive/ODriveNew.cpp b/src/lib/axis/motor/oDrive/ODriveNew.cpp new file mode 100755 index 0000000..db6217b --- /dev/null +++ b/src/lib/axis/motor/oDrive/ODriveNew.cpp @@ -0,0 +1,437 @@ +// ----------------------------------------------------------------------------------- +// oDrive servo motor +// EXPERIMENTAL!!! + +#include "ODriveNew.h" + +#ifdef ODRIVE_NEW_MOTOR_PRESENT +#ifdef ODRIVE_MOTOR_PRESENT + +#include "../../../tasks/OnTask.h" +#include "../../../gpioEx/GpioEx.h" + +#include "ODriveCanPlus.h" + +// constructor +ODriveMotor::ODriveMotor(uint8_t axisNumber, int8_t reverse, const ODriveDriverSettings *Settings, float countsPerRad, bool useFastHardwareTimers) + :Motor(axisNumber, reverse) { + if (axisNumber < 1 || axisNumber > 2) return; + + driverType = ODRIVER; + + this->axisNumber = axisNumber; + this->useFastHardwareTimers = useFastHardwareTimers; + + #if ODRIVE_SWAP_AXES == ON + oDriveNode = 2 - axisNumber; + #else + oDriveNode = axisNumber - 1; + #endif + + strcpy(axisPrefix, " Axis_oDrive, "); + axisPrefix[5] = '0' + this->axisNumber; + + // set parameter default values during object creation + this->countsPerRad.valueDefault = countsPerRad; + + // attach the function pointers to the callbacks + odriveMotorInstance[axisNumber - 1] = this; + switch (this->axisNumber) { + case 1: callback = moveODriveMotorAxis1; break; + case 2: callback = moveODriveMotorAxis2; break; + } +} + +bool ODriveMotor::init() { + if (!Motor::init()) return false; + + // reset the ODrive(s) via h/w pin + if (axisNumber == 1) { + pinModeEx(ODRIVE_RST_PIN, OUTPUT); + digitalWriteEx(ODRIVE_RST_PIN, LOW); + tasks.yield(10); + digitalWriteEx(ODRIVE_RST_PIN, HIGH); + + // allow time for boot + tasks.yield(1000); + } + + if (!odriveCan.init(oDriveNode)) return false; + + // request version info and + // let CAN poll task (priority 3) run to deliver the reply + odriveCan.requestVersion(oDriveNode); + const uint32_t t0 = millis(); + while (!odriveCan.hasFreshVersion(oDriveNode, 1000) && (uint32_t)(millis() - t0) < 1000U) { tasks.yield(10); } + + if (odriveCan.hasFreshVersion(oDriveNode, 1000)) { + uint8_t raw[8]; + uint16_t proto; + uint8_t maj, min, rev, hwv, hww; + + if (odriveCan.getVersionSnapshot(oDriveNode, raw, proto, maj, min, rev, hwv, hww)) { + VF("MSG:"); V(axisPrefix); VF("ODrive version: node "); V(oDriveNode); + VF(" proto "); V(proto); + VF(" fw "); V(maj); VF("."); V(min); VF("."); V(rev); + VF(" hwVar "); V(hwv); + VF(" hwVer "); V(hww); + VLF(""); + + VF("MSG:"); V(axisPrefix); VF("ODrive version raw: "); + for (int i = 0; i < 8; i++) { + if (raw[i] < 16) V("0"); + VH(raw[i]); + if (i != 7) V(" "); + } + VLF(""); + } + } + + // idle the ODrive + odriveCan.setAxisState(oDriveNode, AXIS_STATE_IDLE); + + // request an encoder position update and + // let CAN poll task (priority 3) run to deliver the reply + odriveCan.requestTurns(oDriveNode); + lastEncoderUpdateRequestTime = millis(); + tasks.yield(250); + + // require an encoder sample + if (!odriveCan.hasFreshTurns(oDriveNode, 250)) { + VF("MSG:"); V(axisPrefix); VLF("no encoder reply at startup"); + ready = false; + return false; + } + + // local state: definitely disabled, no transition pending + ready = true; + enabled = false; + enablePending = false; + enableTarget = false; + enableDeadlineMs = 0; + + // start the motion timer + VF("MSG:"); V(axisPrefix); VF("start task to synthesize motion... "); + char timerName[] = "Ax_ODr"; + timerName[2] = axisNumber + '0'; + taskHandle = tasks.add(0, 0, true, 0, callback, timerName); + if (taskHandle) { + VF("success"); + if (useFastHardwareTimers) { + if (!tasks.requestHardwareTimer(taskHandle, 0)) { + VF(" (no hardware timer!)"); + } else { + maxFrequency = (1000000.0F/HAL_MAXRATE_LOWER_LIMIT)/2.0F; + }; + } + VLF(""); + } else { + VLF("FAILED!"); + ready = false; + return false; + } + + stopSyntheticMotion(); + + return true; +} + +// set motor reverse state +void ODriveMotor::setReverse(bool state) { + if (!ready) return; + + if (state) { + VF("MSG:"); V(axisPrefix); VLF("axis reversal must be accomplished with hardware or ODrive setup!"); + } +} + +// sets motor enable on/off (if possible) +void ODriveMotor::enable(bool state) { + if (!ready) return; + + // If we're already in the requested steady-state AND no transition is pending, do nothing. + if (!enablePending && (state == enabled)) return; + + // Always reset local motion first + if (!state) enabled = false; + stopSyntheticMotion(); + resetToTrackingBaseline(); + + const uint32_t requestedState = state ? AXIS_STATE_CLOSED_LOOP_CONTROL + : AXIS_STATE_IDLE; + + if (!odriveCan.setAxisState(oDriveNode, requestedState)) { + enabled = false; + enablePending = false; + return; + } + + if (!state) { + // disable: treat as immediate locally; no need to wait for heartbeats/encoder + enabled = false; + enablePending = false; + enableTarget = false; + enableDeadlineMs = 0; + return; + } + + // Enable: wait for confirmation + enablePending = true; + enableTarget = true; + enableDeadlineMs = millis() + 500; +} + +void ODriveMotor::setInstrumentCoordinateSteps(long value) { + if (!ready) return; + + #if ODRIVE_ABSOLUTE == ON && ODRIVE_SYNC_LIMIT != OFF + long index = value - ATOMIC_LOAD(motorSteps); + float indexRad = index/countsPerRad.value; + if (indexRad >= -degToRadF(ODRIVE_SYNC_LIMIT/3600.0F) && indexRad <= degToRadF(ODRIVE_SYNC_LIMIT/3600.0F)) + #endif + + Motor::setInstrumentCoordinateSteps(value); +} + +// resets motor and target angular position in steps, also zeros backlash and index +void ODriveMotor::resetPositionSteps(long value) { + if (!ready) return; + + // make sure we have a recent encoder reading + if (!odriveCan.hasFreshTurns(oDriveNode, 250)) { + status.fault = true; + odriveCan.requestTurns(oDriveNode); + return; + } else { + status.fault = false; + } + + // Convert turns -> steps (countsPerRad is counts-per-radian) + const float posTurns = odriveCan.getPosTurns(oDriveNode); + const long oPositionSteps = lroundf(posTurns * TWO_PI * countsPerRad.value); + + noInterrupts(); + motorSteps = oPositionSteps; + targetSteps = motorSteps; + + #if ODRIVE_ABSOLUTE == OFF + // For incremental encoders, keep an index offset so OnStepX can still align to "value". + indexSteps = value - motorSteps; + #else + UNUSED(value); + indexSteps = 0; + #endif + + backlashSteps = 0; + interrupts(); +} + +// set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) +void ODriveMotor::setFrequencySteps(float frequency) { + if (!ready) return; + + if (!enabled) { stopSyntheticMotion(); return; } + + // negative frequency, convert to positive and reverse the direction + int dir = 0; + if (frequency > 0.0F) dir = 1; else if (frequency < 0.0F) { frequency = -frequency; dir = -1; } + + // if in backlash override the frequency + if (inBacklash) frequency = backlashFrequency; + + if (frequency != currentFrequency) { + if (frequency < maxFrequency) stepSize = 1; else + if (frequency < maxFrequency*2) stepSize = 2; else + if (frequency < maxFrequency*4) stepSize = 4; else + if (frequency < maxFrequency*8) stepSize = 8; else + if (frequency < maxFrequency*16) stepSize = 16; else + if (frequency < maxFrequency*32) stepSize = 32; else + if (frequency < maxFrequency*64) stepSize = 64; else + if (frequency < maxFrequency*128) stepSize = 128; else stepSize = 256; + + // timer period in microseconds + float period = (1000000.0F*stepSize)/frequency; + + // range is 0 to 134 seconds/step + if (!isnan(period) && period <= 130000000.0F) { + period *= 16.0F; + lastPeriod = (unsigned long)lroundf(period); + } else { + lastPeriod = 0; + frequency = 0.0F; + dir = 0; + } + + currentFrequency = frequency; + + // change the motor rate/direction + noInterrupts(); + step = 0; + interrupts(); + tasks.setPeriodSubMicros(taskHandle, lastPeriod); + } + + noInterrupts(); + step = dir * stepSize; + absStep = (int)labs(step); + interrupts(); + + if (dir == 0 || lastPeriod == 0 || frequency == 0.0F) { + feedForwardVelocity = 0.0F; + } else { + feedForwardVelocity = (dir > 0) ? frequency : -frequency; + } +} + +float ODriveMotor::getFrequencySteps() { + if (!ready) return 0.0F; + + if (lastPeriod == 0) return 0.0F; + return (16000000.0F / lastPeriod) * absStep; +} + +// set slewing state (hint that we are about to slew or are done slewing) +void ODriveMotor::setSlewing(bool state) { + if (!ready) return; + + isSlewing = state; +} + +// updates PID and sets odrive position +void ODriveMotor::poll() { + const uint32_t now = millis(); + + // grab a new encoder position update at 10Hz + if ((uint32_t)(now - lastEncoderUpdateRequestTime) >= 100U) { + odriveCan.requestTurns(oDriveNode); + lastEncoderUpdateRequestTime = now; + } + + // ------------------------- + // handle enable/disable handshake (async confirmation) + // ------------------------- + if (enablePending) { + // snapshot ODrive status + const uint8_t st = odriveCan.axisState(oDriveNode); + const uint32_t err = odriveCan.lastError(oDriveNode); + + // hard faults during transition: lose heartbeat or error latched + if (!odriveCan.hasHeartbeat(oDriveNode, 250) || (err != 0)) { + enabled = false; + enablePending = false; + stopSyntheticMotion(); + resetToTrackingBaseline(); + return; + } + + // commit when we observe the desired steady state + if (enableTarget) { + if (st == AXIS_STATE_CLOSED_LOOP_CONTROL) { + enabled = true; + enablePending = false; + } + } else { + if (st == AXIS_STATE_IDLE) { + enabled = false; + enablePending = false; + } + } + + // deadline: if still pending after the window, fail closed + if (enablePending && (int32_t)(now - enableDeadlineMs) >= 0) { + enabled = false; + enablePending = false; + stopSyntheticMotion(); + resetToTrackingBaseline(); + return; + } + } + + // ------------------------- + // normal operation (only when truly enabled) + // ------------------------- + if (!ready || !enabled) return; + + // fail closed if we lose comms or an error appears while running + // (no encoder freshness requirement in this variant) + if (!odriveCan.hasHeartbeat(oDriveNode, 250) || (odriveCan.lastError(oDriveNode) != 0)) { + enabled = false; + enablePending = false; + stopSyntheticMotion(); + resetToTrackingBaseline(); + return; + } + + // rate-limit position commands + if (now - lastSetPositionTime < ODRIVE_UPDATE_MS) return; + lastSetPositionTime = now; + + long target; + noInterrupts(); + #if ODRIVE_SLEW_DIRECT == ON + target = targetSteps + backlashSteps; + #else + target = motorSteps + backlashSteps; + #endif + interrupts(); + + float vel_ff_turns_s = feedForwardVelocity/(TWO_PI*countsPerRad.value); + + odriveCan.setInputPos(oDriveNode, target/(TWO_PI*countsPerRad.value), vel_ff_turns_s); +} + +void ODriveMotor::stopSyntheticMotion() { + feedForwardVelocity = 0.0F; + + if (lastPeriod == 0 && step == 0 && absStep == 0) return; + currentFrequency = 0.0F; + lastPeriod = 0; + feedForwardVelocity = 0.0F; + noInterrupts(); + step = 0; + absStep = 0; + interrupts(); + if (taskHandle) tasks.setPeriodSubMicros(taskHandle, 0); +} + +void ODriveMotor::resetToTrackingBaseline() { + noInterrupts(); + step = 0; + absStep = 0; + inBacklash = false; + backlashSteps = 0; + interrupts(); + + currentFrequency = 0.0F; + lastPeriod = 0; + stepSize = 1; + feedForwardVelocity = 0.0F; +} + +// sets dir as required and moves coord toward target at setFrequencySteps() rate +IRAM_ATTR void ODriveMotor::move() { + if (sync && !inBacklash) targetSteps += step; + + if (motorSteps > targetSteps) { + if (backlashSteps > 0) { + backlashSteps -= absStep; + inBacklash = backlashSteps > 0; + } else { + motorSteps -= absStep; + inBacklash = false; + } + } else + + if (motorSteps < targetSteps || inBacklash) { + if (backlashSteps < backlashAmountSteps) { + backlashSteps += absStep; + inBacklash = backlashSteps < backlashAmountSteps; + } else { + motorSteps += absStep; + inBacklash = false; + } + } +} + +#endif +#endif \ No newline at end of file diff --git a/src/lib/axis/motor/oDrive/ODriveNew.h b/src/lib/axis/motor/oDrive/ODriveNew.h new file mode 100755 index 0000000..058b7ed --- /dev/null +++ b/src/lib/axis/motor/oDrive/ODriveNew.h @@ -0,0 +1,151 @@ +// ----------------------------------------------------------------------------------- +// oDrive servo motor +// EXPERIMENTAL!!! +#pragma once +#include "../../../../Common.h" + +#ifdef ODRIVE_NEW_MOTOR_PRESENT +#ifdef ODRIVE_MOTOR_PRESENT + +#include "../Motor.h" +#include "../../../convert/Convert.h" + +#ifndef ODRIVE_RST_PIN + #define ODRIVE_RST_PIN 3 +#endif + +// odrive update rate default 40Hz +#ifndef ODRIVE_UPDATE_MS + #define ODRIVE_UPDATE_MS CAN_SEND_RATE_MS // normally > about 5ms and < 100ms +#endif + +// odrive direct slewing ON or OFF (ODrive handles acceleration) +// ON to use ODrive trapezoidal move profile, OFF for OnStep move profile +#ifndef ODRIVE_SLEW_DIRECT + #define ODRIVE_SLEW_DIRECT OFF +#endif + +// odrive if using absolute encoders set to ON +#ifndef ODRIVE_ABSOLUTE + #define ODRIVE_ABSOLUTE ON // was OFF +#endif + +// odrive sync limit (for absolute encoders) OFF or specify the sync limit in arc-seconds +// this should, I hope, allow you to limit just how far from the encoders you can sync. (+/-) to fine-tune the origin +// with absolute encoders this protects you from exceeding the software min/max limits by > the amount specified +// in arc seconds..one encoder tick encoder resolution = 2^14 = 16384 +// 16384/360=45.5 ticks/deg; 45.5/60=0.7583 ticks/min; 0.7583/60 = .00126 ticks/sec +// or 1/0.7583 = 1.32 arc-min/tick; 1.32*60 sec = 79.2 arc sec per encoder tick +#ifndef ODRIVE_SYNC_LIMIT + #define ODRIVE_SYNC_LIMIT 80 // was OFF +#endif + +// Use OD_UART or OD_CAN...I2C may be added later +#ifndef ODRIVE_COMM_MODE + #define ODRIVE_COMM_MODE OD_CAN +#endif + +// ODrive axis 0 = OnStep Axis2 = DEC or ALT +// ODrive axis 1 = OnStep Axis1 = RA or AZM +#ifndef ODRIVE_SWAP_AXES + #define ODRIVE_SWAP_AXES ON +#endif + +typedef struct ODriveDriverSettings { + int16_t model; + int8_t status; +} ODriveDriverSettings; + +class ODriveMotor : public Motor { + public: + // constructor + ODriveMotor(uint8_t axisNumber, int8_t reverse, const ODriveDriverSettings *Settings, float countsPerRad, bool useFastHardwareTimers = true); + + // sets up the odrive motor + bool init(); + + // returns the number of parameters from the motor + uint8_t getParameterCount() { return Motor::getParameterCount() + numParameters; } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { + if (number == Motor::getParameterCount() + 1) return &countsPerRad; else + if (number >= 1 && number <= Motor::getParameterCount()) return Motor::getParameter(number); else + return &invalid; + } + + // set motor reverse state + void setReverse(bool state); + + // sets motor enable on/off (if possible) + void enable(bool value); + + bool hasAbsoluteEncoder() const override { return ODRIVE_ABSOLUTE == ON; } + + // set instrument coordinate, in steps + void setInstrumentCoordinateSteps(long value); + + // get the associated driver status + inline DriverStatus getDriverStatus() { if (ready) return status; else return errorStatus; } + + // resets motor and target angular position in steps, also zeros backlash and index + void resetPositionSteps(long value); + + // get tracking mode steps per slewing mode step + inline int getStepsPerStepSlewing() { return 64; } + + // get movement frequency in steps per second + float getFrequencySteps(); + + // set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) + void setFrequencySteps(float frequency); + + // set slewing state (hint that we are about to slew or are done slewing) + void setSlewing(bool state); + + // get the motor name + const char* name() { return "ODRIVE"; } + + // updates PID and sets servo motor power/direction + void poll(); + + // sets dir as required and moves coord toward target at setFrequencySteps() rate + void move(); + + private: + void stopSyntheticMotion(); + void resetToTrackingBaseline(); + + float feedForwardVelocity = 0.0F; + unsigned long lastSetPositionTime = 0; + unsigned long lastEncoderUpdateRequestTime = 0; + uint8_t oDriveNode = 0; // ODrive node for this mount axis (swapped if ODRIVE_SWAP_AXES==ON) + uint8_t taskHandle = 0; + + int stepSize = 1; // step size + + unsigned long lastPeriod = 0; // last timer period (in sub-micros) + float maxFrequency = HAL_FRACTIONAL_SEC; // fastest timer rate + + volatile int absStep = 0; // absolute step size (unsigned) + + void (*callback)() = NULL; + + bool useFastHardwareTimers = true; + + bool enablePending = false; + bool enableTarget = false; + uint32_t enableDeadlineMs = 0; + bool isSlewing = false; + + DriverStatus status = { false, {false, false}, {false, false}, false, false, false, false }; + + // runtime adjustable settings + AxisParameter countsPerRad = {NAN, NAN, NAN, 300.0*RAD_DEG_RATIO_F, 360000.0*RAD_DEG_RATIO_F, AXP_FLOAT, AXPN_COUNTS_PER_RAD}; + + const int numParameters = 1; + AxisParameter* parameter[2] = {&invalid, &countsPerRad}; +}; + +#endif +#endif diff --git a/src/lib/axis/motor/servo/Servo.cpp b/src/lib/axis/motor/servo/Servo.cpp new file mode 100755 index 0000000..818477a --- /dev/null +++ b/src/lib/axis/motor/servo/Servo.cpp @@ -0,0 +1,525 @@ +// ----------------------------------------------------------------------------------- +// axis servo motor + +#include "Servo.h" + +#ifdef SERVO_MOTOR_PRESENT + +#include "../../../tasks/OnTask.h" +#include "../Motor.h" + +static ServoMotor *servoMotorInstance[9]; +IRAM_ATTR void moveServoMotorAxis1() { servoMotorInstance[0]->move(); } +IRAM_ATTR void moveServoMotorAxis2() { servoMotorInstance[1]->move(); } +IRAM_ATTR void moveServoMotorAxis3() { servoMotorInstance[2]->move(); } +IRAM_ATTR void moveServoMotorAxis4() { servoMotorInstance[3]->move(); } +IRAM_ATTR void moveServoMotorAxis5() { servoMotorInstance[4]->move(); } +IRAM_ATTR void moveServoMotorAxis6() { servoMotorInstance[5]->move(); } +IRAM_ATTR void moveServoMotorAxis7() { servoMotorInstance[6]->move(); } +IRAM_ATTR void moveServoMotorAxis8() { servoMotorInstance[7]->move(); } +IRAM_ATTR void moveServoMotorAxis9() { servoMotorInstance[8]->move(); } + +// constructor +ServoMotor::ServoMotor(uint8_t axisNumber, int8_t reverse, + ServoDriver *Driver, Filter *filter, + Encoder *encoder, uint32_t encoderOrigin, bool encoderReverse, + Feedback *feedback, ServoControl *control, + bool useFastHardwareTimers) + :Motor(axisNumber, reverse) { + if (axisNumber < 1 || axisNumber > 9) return; + + driverType = SERVO; + + strcpy(axisPrefix, " Axis_Servo, "); + axisPrefix[5] = '0' + axisNumber; + + this->filter = filter; + this->encoder = encoder; + this->feedback = feedback; + this->control = control; + + if (axisNumber > 2) useFastHardwareTimers = false; + this->useFastHardwareTimers = useFastHardwareTimers; + + this->driver = Driver; + + this->encoderOrigin = encoderOrigin; + this->encoderReverse = encoderReverse; + this->encoderReverseDefault = encoderReverse; + + // attach the function pointers to the callbacks + servoMotorInstance[axisNumber - 1] = this; + switch (axisNumber) { + case 1: callback = moveServoMotorAxis1; break; + case 2: callback = moveServoMotorAxis2; break; + case 3: callback = moveServoMotorAxis3; break; + case 4: callback = moveServoMotorAxis4; break; + case 5: callback = moveServoMotorAxis5; break; + case 6: callback = moveServoMotorAxis6; break; + case 7: callback = moveServoMotorAxis7; break; + case 8: callback = moveServoMotorAxis8; break; + case 9: callback = moveServoMotorAxis9; break; + } +} + +bool ServoMotor::init() { + if (!Motor::init()) return false; + + #ifdef CALIBRATE_SERVO_DC + calibrateVelocity = new ServoCalibrateTrackingVelocity(axisNumber); + driver->setTrackingMode(true); + driver->setBypassAccelOnTracking(true); + slewing = false; + #endif + + if (encoder->supportsTimeAlignedMotorSteps()) { encoder->setMotorStepsPtr(&motorSteps); } + + if (!encoder->init()) { DF("ERR:"); D(axisPrefix); DLF("no encoder!"); return false; } + + encoder->setOrigin(encoderOrigin); + + if (!driver->init(normalizedReverse)) { DF("ERR:"); D(axisPrefix); DLF("no motor driver!"); return false; } + + driver->enable(false); + + // get the feedback control loop ready + feedback->init(axisNumber, control); + feedback->reset(); + trackingFrequency = (AXIS1_STEPS_PER_DEGREE/240.0F)*SIDEREAL_RATIO_F; + + // start the motion timer + VF("MSG:"); V(axisPrefix); VF("start task to synthesize motion... "); + char timerName[] = "Ax_Svo"; + timerName[2] = '0' + axisNumber; + taskHandle = tasks.add(0, 0, true, 0, callback, timerName); + if (taskHandle) { + VF("success"); + if (useFastHardwareTimers) { + if (!tasks.requestHardwareTimer(taskHandle, 0)) { + VF(" (no hardware timer!)"); + } else { + maxFrequency = (1000000.0F/HAL_MAXRATE_LOWER_LIMIT)/2.0F; + }; + } + VLF(""); + } else { + VLF("FAILED!"); + return false; + } + + ready = true; + return true; +} + +void ServoMotor::setReverse(int8_t state) { + if (!ready) return; + + feedback->setControlDirection(state); + if (state == ON) encoderReverse = encoderReverseDefault; else encoderReverse = !encoderReverseDefault; +} + +void ServoMotor::enable(bool state) { + if (!ready || state == enabled) return; + + if (state) { + driver->enable(true); // power up first + feedback->reset(); // clean start (PID state) + safetyShutdown = false; + + stopSyntheticMotion(); // stop ISR/task + resetToTrackingBaseline(); // clear backlash/step state + enabled = true; + } else { + enabled = false; // close window + stopSyntheticMotion(); // stop ISR/task + resetToTrackingBaseline(); // clear backlash/step state + + feedback->reset(); // clear PID state + driver->enable(false); // then power down + } + + #ifdef CALIBRATE_SERVO_DC + if (enabled && !encoder->isVirtual) { + calibrateVelocity->start(trackingFrequency, getInstrumentCoordinateSteps()); + } + #endif +} + +DriverStatus ServoMotor::getDriverStatus() { + if (!ready) return errorStatus; + + DriverStatus driverStatus; + if (ready) { driver->updateStatus(); driverStatus = driver->getStatus(); } else driverStatus.fault = true; + if (encoder->errorThresholdExceeded()) driverStatus.fault = true; + if (safetyShutdown) driverStatus.fault = true; + return driverStatus; +} + +// resets motor and target angular position in steps, also zeros backlash and index +void ServoMotor::resetPositionSteps(long value) { + if (!ready) return; + + Motor::resetPositionSteps(value); + if (!encoder->isAbsolute()) { + encoder->write(value); + } else { + VF("MSG:"); V(axisPrefix); VL("absolute encoder ignored reset position"); + } +} + +// get instrument coordinate, in steps +long ServoMotor::getInstrumentCoordinateSteps() { + if (!ready) return 0; + + return encoderRead() + indexSteps; +} + +// set instrument coordinate, in steps +void ServoMotor::setInstrumentCoordinateSteps(long value) { + bool startupOriginState = indexSteps == 0 && motorSteps == 0 && targetSteps == 0 && backlashSteps == 0; + + noInterrupts(); + indexSteps = value - motorSteps; + interrupts(); + + if (encoder->isAbsolute() && startupOriginState) homeSet = true; +} + +// distance to target in steps (+/-) +long ServoMotor::getTargetDistanceSteps() { + if (!ready) return 0; + + long encoderCounts = encoderRead(); + noInterrupts(); + long dist = targetSteps - encoderCounts; + interrupts(); + return dist; +} + +// set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) +void ServoMotor::setFrequencySteps(float frequency) { + if (!ready) return; + + if (!enabled) { stopSyntheticMotion(); return; } + + // negative frequency, convert to positive and reverse the direction + int dir = 0; + if (frequency > 0.0F) dir = 1; else if (frequency < 0.0F) { frequency = -frequency; dir = -1; } + + // if in backlash override the frequency + if (inBacklash) frequency = backlashFrequency; + + if (frequency != currentFrequency) { + // compensate for performace limitations by taking larger steps as needed + if (frequency < maxFrequency) stepSize = 1; else + if (frequency < maxFrequency*2) stepSize = 2; else + if (frequency < maxFrequency*4) stepSize = 4; else + if (frequency < maxFrequency*8) stepSize = 8; else + if (frequency < maxFrequency*16) stepSize = 16; else + if (frequency < maxFrequency*32) stepSize = 32; else + if (frequency < maxFrequency*64) stepSize = 64; else + if (frequency < maxFrequency*128) stepSize = 128; else stepSize = 256; + + // timer period in microseconds + float period = (1000000.0F*stepSize)/frequency; + + // range is 0 to 134 seconds/step + if (!isnan(period) && period <= 130000000.0F) { + period *= 16.0F; + lastPeriod = (unsigned long)lroundf(period); + } else { + lastPeriod = 0; + frequency = 0.0F; + dir = 0; + } + + currentFrequency = frequency; + currentDirection = dir; + + // change the motor rate/direction + noInterrupts(); + step = 0; + interrupts(); + tasks.setPeriodSubMicros(taskHandle, lastPeriod); + } + + noInterrupts(); + step = dir * stepSize; + absStep = abs(step); + interrupts(); +} + +float ServoMotor::getFrequencySteps() { + if (!ready) return 0; + + if (lastPeriod == 0) return 0; + return (16000000.0F / lastPeriod) * absStep; +} + +// set slewing state (hint that we are about to slew or are done slewing) +void ServoMotor::setSlewing(bool state) { + if (!ready) return; + + slewing = state; +} + +// set zero/origin of absolute encoders +uint32_t ServoMotor::encoderZero() { + if (!ready) return 0; + + encoder->origin = 0; + encoder->index = 0; + + uint32_t zero = (uint32_t)(-encoder->read()); + encoder->origin = zero; + + return zero; +} + +int32_t ServoMotor::encoderRead() { + int32_t encoderCounts = encoder->read(); + if (encoderReverse) encoderCounts = -encoderCounts; + return encoderCounts; +} + +// updates PID and sets servo motor power/direction +void ServoMotor::poll() { + int32_t encoderCounts = encoder->read(); + if (encoderReverse) encoderCounts = -encoderCounts; + + // for absolute encoders initialize the motor position at startup + if (encoder->isAbsolute()) { + if (!motorStepsInitDone && homeSet) { + noInterrupts(); + motorSteps = encoderCounts; + targetSteps = encoderCounts; + backlashSteps = 0; + interrupts(); + motorStepsInitDone = true; + } + } + + long motorCounts; + if (encoder->hasMotorStepsAtLastRead()) { + motorCounts = encoder->motorStepsAtLastRead(); + } else { + noInterrupts(); + motorCounts = motorSteps; + interrupts(); + } + + long unfilteredEncoderCounts = encoderCounts; + UNUSED(unfilteredEncoderCounts); + + // find encoder velocity + float encoderVelocity = encoder->readVelocityCps(); + if (encoderReverse) encoderVelocity = -encoderVelocity; + if (isnan(encoderVelocity)) { + const uint32_t nowUs = micros(); + + if (lastUs == 0) { + lastUs = nowUs; + lastEnc = unfilteredEncoderCounts; + encoderVelocity = 0.0F; + } else { + uint32_t dtUs = nowUs - lastUs; + if (dtUs == 0) dtUs = 1; + encoderVelocity = (unfilteredEncoderCounts - lastEnc)*(1000000.0F/(float)dtUs); + lastEnc = unfilteredEncoderCounts; + lastUs = nowUs; + } + } + + // Eq mount tracking? + bool isTracking = (axisNumber == 1) && (fabsf(currentFrequency - trackingFrequency) < trackingFrequency*0.1F); + + encoderCounts = filter->update(encoderCounts, motorCounts, isTracking); + + control->set = motorCounts; + control->in = encoderCounts; + float velocity; + if (enabled) { + // directly use fixed PWM value during calibration + #ifdef CALIBRATE_SERVO_DC + if (calibrateVelocity->experimentMode) { + // Get unfiltered counts + calibrateVelocity->updateState(unfilteredEncoderCounts); + // experimentVel is in PERCENT of max velocity, convert to cps + velocity = (calibrateVelocity->experimentVelocity/100.0F)*velocityMax; + // disable the PID // or feedback->zeroOutputs() + control->out = 0.0f; // ensure PID output doesn't leak in + } else { + // your normal control path; keep whatever you used before + velocity = control->out + currentDirection*currentFrequency; + } + #else + feedback->poll(); + velocity = control->out + currentDirection*currentFrequency; + #endif + + } else velocity = 0.0F; + + // for virtual encoders set the velocity and direction + if (encoder->isVirtual) { + encoderDirection = velocity < 0.0F ? -1 : 1; + encoder->setVelocity(abs(velocity)); + encoder->setDirection(&encoderDirection); + } + +// const float vmax = velocityMax; +// v_eff = driver->setMotorVelocity(velocity, encoderVelocity)*100.0F; +// velocityPercent = (vmax > 0.0F) ? (v_eff/vmax)*100.0F : 0.0F; + velocityPercent = (driver->setMotorVelocity(velocity, encoderVelocity)/velocityMax)*100.0F; + if (driver->getMotorDirection() == DIR_FORWARD) control->directionHint = 1; else control->directionHint = -1; + + const unsigned long now = millis(); + + if (feedback->manuallySwitchParameters) { + if (!slewing && enabled) { + if (now - lastSlewingTime >= SERVO_SLEWING_TO_TRACKING_DELAY) feedback->selectTrackingParameters(); else feedback->selectSlewingParameters(); + } else { + lastSlewingTime = now; + feedback->selectSlewingParameters(); + } + } else { + feedback->variableParameters(fabs(velocityPercent)); + } + + if (velocityPercent < -33) wasBelow33 = true; + if (velocityPercent > 33) wasAbove33 = true; + + if (now - lastCheckTime >= 1000U) { + delta = motorCounts - encoderCounts; + + #ifndef SERVO_SAFETY_DISABLE + // if above SERVO_SAFETY_STALL_POWER (33% default) and we're not moving something is seriously wrong, so shut it down + if (labs(encoderCounts - lastEncoderCounts) < 10 && abs(velocityPercent) >= SERVO_SAFETY_STALL_POWER) { + DF("WRN:"); D(axisPrefix); DF("stall detected!"); + DF(" control->in = "); D(control->in); DF(", control->set = "); D(control->set); + DF(", control->out = "); D(control->out); DF(", velocity % = "); DL(velocityPercent); + enable(false); + safetyShutdown = true; + } + + // if above 90% power for > three seconds and the distance to the target is increasing + // something is seriously wrong so shut it down + if (labs(delta - lastDelta) > lastTargetDistance && abs(velocityPercent) >= 90) { + movingAwaySeconds++; + if (movingAwaySeconds >= 3) { + DF("WRN:"); D(axisPrefix); DF("runaway detected!"); + DLF(" > 90% power while moving away from the target!"); + enable(false); + safetyShutdown = true; + } + } else movingAwaySeconds = 0; + lastTargetDistance = labs(delta - lastDelta); + + // if we were below -33% and above 33% power in a one second period something is seriously wrong, so shut it down + if (wasBelow33 && wasAbove33) { + DF("WRN:"); D(axisPrefix); DF("oscillation detected!"); + DLF(" below -33% and above 33% power in a 2 second period!"); + enable(false); + safetyShutdown = true; + } + #endif + + wasAbove33 = false; + wasBelow33 = false; + lastEncoderCounts = encoderCounts; + lastDelta = delta; + lastCheckTime = now; + } + + #if DEBUG != OFF && defined(DEBUG_AXIS) && DEBUG_AXIS != OFF + if (axisNumber == DEBUG_AXIS) { + static uint16_t count = 0; + count++; + if (count % 10 == 0) { + char s[256]; + + float spas = 0; + if (axisNumber == 1) spas = AXIS1_STEPS_PER_DEGREE/3600.0F; else if (axisNumber == 2) spas = AXIS2_STEPS_PER_DEGREE/3600.0F; + +// snprintf(s, sizeof(s), "Ax%dSvo: Delta %6ld, Motor %6ld, Encoder %6ld, Ax%dSvo_Power: %6.3f%%\r\n", (int)axisNumber, (motorCounts - encoderCounts), motorCounts, (long)encoderCounts, (int)axisNumber, velocityPercent); +// snprintf(s, sizeof(s), "Ax%dSvo: Motor %6ld, Encoder %6ld\r\n", (int)axisNumber, motorCounts, (long)encoderCounts); +// snprintf(s, sizeof(s), "Ax%dSvo: Delta %0.2f\r\n", (int)axisNumber, (motorCounts - (long)encoderCounts)/12.9425); +// snprintf(s, sizeof(s), "Ax%dSvo: DeltaASf: %0.2f, DeltaAS: %0.2f, Ax%dSvo_Power: %6.3f%%\r\n", (int)axisNumber, (motorCounts - encoderCounts)/spas, (motorCounts - unfilteredEncoderCounts)/spas, (int)axisNumber, velocityPercent); + snprintf(s, sizeof(s), "%0.2f, %6.3f%%\r\n", (motorCounts - unfilteredEncoderCounts)/spas, velocityPercent); + + D(s); + UNUSED(spas); + } + } + #endif +} + +void ServoMotor::stopSyntheticMotion() { + if (lastPeriod == 0 && step == 0 && absStep == 0) return; + currentFrequency = 0.0F; + currentDirection = 0; + lastPeriod = 0; + + noInterrupts(); + step = 0; + absStep = 0; + interrupts(); + if (taskHandle) tasks.setPeriodSubMicros(taskHandle, 0); +} + +void ServoMotor::resetToTrackingBaseline() { + noInterrupts(); + step = 0; + absStep = 0; + inBacklash = false; + backlashSteps = 0; + interrupts(); + + currentFrequency = 0.0F; + currentDirection = 0; + lastPeriod = 0; + + lastEnc = 0; + lastUs = 0; +} + +// sets dir as required and moves coord toward target at setFrequencySteps() rate +IRAM_ATTR void ServoMotor::move() { + + #if SERVO_SLEW_DIRECT == ON + if (sync && !inBacklash) targetSteps += step; + + if (motorSteps > targetSteps) { + motorSteps = targetSteps; + } else + + if (motorSteps < targetSteps + backlashAmountSteps) { + motorSteps = targetSteps + backlashAmountSteps; + } + + #else + if (sync && !inBacklash) targetSteps += step; + + if (motorSteps > targetSteps) { + if (backlashSteps > 0) { + backlashSteps -= absStep; + inBacklash = backlashSteps > 0; + } else { + motorSteps -= absStep; + inBacklash = false; + } + } else + + if (motorSteps < targetSteps || inBacklash) { + if (backlashSteps < backlashAmountSteps) { + backlashSteps += absStep; + inBacklash = backlashSteps < backlashAmountSteps; + } else { + motorSteps += absStep; + inBacklash = false; + } + } + + #endif +} + +#endif diff --git a/src/lib/axis/motor/servo/Servo.h b/src/lib/axis/motor/servo/Servo.h new file mode 100755 index 0000000..94d1572 --- /dev/null +++ b/src/lib/axis/motor/servo/Servo.h @@ -0,0 +1,190 @@ +// ----------------------------------------------------------------------------------- +// axis servo motor +#pragma once +#include "../../../../Common.h" + +#ifdef SERVO_MOTOR_PRESENT + +#include "../../../encoder/Encoder.h" +#include "filter/Filter.h" +#include "feedback/Feedback.h" +#include "dc/calibration/TrackingVelocity.h" + +#include "dc/eE/EE.h" +#include "dc/pE/PE.h" +#include "dc/tmc/tmc2130/Tmc2130.h" +#include "dc/tmc/tmc5160/Tmc5160.h" +#include "kTech/KTech.h" +#include "tmc/tmc2209/Tmc2209.h" +#include "tmc/tmc5160/Tmc5160.h" + +#ifndef SERVO_SLEW_DIRECT + #define SERVO_SLEW_DIRECT OFF +#endif + +#ifndef SERVO_SLEWING_TO_TRACKING_DELAY + #define SERVO_SLEWING_TO_TRACKING_DELAY 3000 // in milliseconds +#endif + +#ifndef SERVO_SAFETY_STALL_POWER + #define SERVO_SAFETY_STALL_POWER 33 // in percent +#endif + +class ServoMotor : public Motor { + public: + // constructor + ServoMotor(uint8_t axisNumber, int8_t reverse, ServoDriver *Driver, Filter *filter, Encoder *encoder, uint32_t encoderOrigin, bool encoderReverse, Feedback *feedback, ServoControl *control, bool useFastHardwareTimers = true); + + // sets up the servo motor + bool init(); + + // returns the number of parameters from the motor/driver + uint8_t getParameterCount() { return Motor::getParameterCount() + driver->getParameterCount() + feedback->getParameterCount(); } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { + if (number > Motor::getParameterCount() + driver->getParameterCount()) return feedback->getParameter(number - (Motor::getParameterCount() + driver->getParameterCount())); else + if (number > Motor::getParameterCount()) return driver->getParameter(number - Motor::getParameterCount()); else + if (number >= 1 && number <= Motor::getParameterCount()) return Motor::getParameter(number); else + return &invalid; + } + + // check if parameter is valid + bool parameterIsValid(AxisParameter* parameter, bool next = false) { if (!Motor::parameterIsValid(parameter, next)) return false; else return driver->parameterIsValid(parameter, next); } + + // sets reversal of axis directions + // \param state: true reverses the direction behavior specified in settings + void setReverse(int8_t state); + + // sets motor enable on/off (if possible) + void enable(bool value); + + // get the associated motor driver status + DriverStatus getDriverStatus(); + + // resets motor and target angular position in steps, also zeros backlash and index + void resetPositionSteps(long value); + + // get instrument coordinate, in steps + long getInstrumentCoordinateSteps(); + + // set instrument coordinate, in steps + void setInstrumentCoordinateSteps(long value); + + // distance to target in steps (+/-) + long getTargetDistanceSteps(); + + // get tracking mode steps per slewing mode step + inline int getStepsPerStepSlewing() { return 256; } + + // sets overall maximum frequency (also allows for 10% over) + // \param frequency: rate of motion in steps (counts) per second + void setFrequencyMax(float frequency) { + velocityMax = frequency; + if (velocityMax < 1.0F) velocityMax = 1.0F; + driver->setFrequencyMax(frequency*1.1F); + feedback->setControlRange(frequency*1.1F); + } + + // get movement frequency in steps per second + float getFrequencySteps(); + + // set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) + void setFrequencySteps(float frequency); + + // set slewing state (hint that we are about to slew or are done slewing) + void setSlewing(bool state); + + // calibrate the motor driver + void calibrateDriver() { if (ready) driver->calibrateDriver(); } + + // get encoder count + int32_t getEncoderCount() { if (ready) return encoder->count; else return 0; } + + // set zero of absolute encoders + uint32_t encoderZero(); + + // set origin of absolute encoders + void encoderSetOrigin(uint32_t origin) { if (ready) encoder->setOrigin(origin); } + + bool hasAbsoluteEncoder() const override { return encoder != nullptr && encoder->isAbsolute(); } + + // read encoder + int32_t encoderRead(); + + // get the motor name + const char* name() { strcpy(nameStr, "Servo, "); strcat(nameStr, driver->name()); return nameStr; } + + // updates PID and sets servo motor power/direction + void poll(); + + // sets dir as required and moves coord toward target at setFrequencySteps() rate + void move(); + + // servo motor driver + ServoDriver *driver; + + // servo encoder + Encoder *encoder; + + float velocityPercent = 0.0F; + long delta = 0; + + private: + void stopSyntheticMotion(); + void resetToTrackingBaseline(); + + Filter *filter; + + void (*callback)() = NULL; + + Feedback *feedback; + ServoControl *control; + #ifdef CALIBRATE_SERVO_DC + ServoCalibrateTrackingVelocity *calibrateVelocity; + #endif + + uint8_t servoMonitorHandle = 0; + uint8_t taskHandle = 0; + + float maxFrequency = HAL_FRACTIONAL_SEC; // fastest timer rate + float maxFrequency2, maxFrequency4, maxFrequency8, maxFrequency16, maxFrequency32, maxFrequency64, maxFrequency128; + bool useFastHardwareTimers = true; + + bool encoderReverse = false; + bool encoderReverseDefault = false; + volatile int8_t encoderDirection = 0; + int32_t lastEnc = 0; + uint32_t lastUs = 0; + + bool motorStepsInitDone = false; // help determining when absolute position is initialized + bool homeSet = false; // help determining when startup home/origin was established + uint32_t encoderOrigin = 0; // the starting position + + int stepSize = 1; // step size + volatile int homeSteps = 1; // step count for microstep sequence between home positions (driver indexer) + volatile bool takeStep = false; // should we take a step + float trackingFrequency = 0; // help figure out if equatorial mount is tracking + bool slewing = false; + + float currentDirection = 0.0F; // last direction + float currentFrequency = 0.0F; // last frequency set in encoder counts per second + float lastFrequency = 0.0F; // last frequency requested + unsigned long lastPeriod = 0; // last timer period (in sub-micros) + float velocityMax = 0.0F; // the maximum velocity allowed + + volatile int absStep = 1; // absolute step size (unsigned) + // servo safety checks + unsigned long lastCheckTime = 0; // time since the last encoder position was checked + unsigned long startTime = 0; // time at start of servo polling + unsigned long lastSlewingTime = 0; // time when last slewing + long lastEncoderCounts = 0; // the last encoder position for stall check + long movingAwaySeconds = 0; // amount of time for runaway check + long lastTargetDistance = 0; // check if moving away from target for runaway check + long lastDelta = 0; // the last distance from target for runaway check + bool wasAbove33 = false; // check for oscillation + bool wasBelow33 = false; // check for oscillation + bool safetyShutdown = false; +}; + +#endif diff --git a/src/lib/axis/motor/servo/ServoDriver.cpp b/src/lib/axis/motor/servo/ServoDriver.cpp new file mode 100755 index 0000000..4c30bdc --- /dev/null +++ b/src/lib/axis/motor/servo/ServoDriver.cpp @@ -0,0 +1,170 @@ +// ----------------------------------------------------------------------------------- +// axis servo motor driver + +#include "ServoDriver.h" + +#ifdef SERVO_MOTOR_PRESENT + +// the various servo driver models +#define SERVO_DRIVER_MODEL_COUNT (SERVO_DRIVER_LAST - SERVO_DRIVER_FIRST + 1) + +#include "../../../gpioEx/GpioEx.h" + +#include "../Motor.h" + +#if DEBUG != OFF + const char* SERVO_DRIVER_NAME[SERVO_DRIVER_MODEL_COUNT] = + { + "SERVO_PE", // Phase (Direction)/Enable + "SERVO_EE", // Enable/Enable + "SERVO_TMC2130_DC", // TMC2130 w/ DC motor + "SERVO_TMC5160_DC", // TMC5160 w/ DC motor + "SERVO_TMC2209", // TMC2209 w/ stepper motor + "SERVO_TMC5160", // TMC5160 w/ stepper motor + "SERVO_KTECH" // KTech servo motor using velocity control + }; +#endif + +ServoDriver::ServoDriver(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings) { + if (axisNumber < 1 || axisNumber > 9) return; + + this->axisNumber = axisNumber; + + this->Pins = Pins; + if (Pins != NULL) { + enablePin = Pins->enable; + enabledState = Pins->enabledState; + faultPin = Pins->fault; + } + + this->Settings = Settings; + driverModel = Settings->model; + statusMode = Settings->status; + + acceleration.valueDefault = Settings->acceleration; + zeroDeadband.valueDefault = 0.0F; +} + +bool ServoDriver::init(bool reverse) { + #if DEBUG == VERBOSE + VF("MSG:"); V(axisPrefix); VF("init model "); VL(SERVO_DRIVER_NAME[driverModel - SERVO_DRIVER_FIRST]); + VF("MSG:"); V(axisPrefix); VF("en="); + if (enablePin == OFF) { VLF("OFF"); } else + if (enablePin == SHARED) { VLF("SHARED"); } else { VL(enablePin); } + #endif + + // init default driver control pins + if (enablePin != SHARED) { + pinModeEx(enablePin, OUTPUT); + digitalWriteEx(enablePin, !enabledState); + } + + // automatically set fault status for known drivers + status.active = statusMode != OFF; + if (statusMode == ON) statusMode = LOW; + if (statusMode == LOW) pinModeEx(faultPin, INPUT_PULLUP); + #ifdef PULLDOWN + if (statusMode == HIGH) pinModeEx(faultPin, INPUT_PULLDOWN); + #else + if (statusMode == HIGH) pinModeEx(faultPin, INPUT); + #endif + + reversed = reverse; + + return true; +} + +void ServoDriver::enable(bool state) { + enabled = state; + + // Only touch a real, dedicated enable pin + if (enablePin != OFF && enablePin != SHARED) { + digitalWriteEx(enablePin, state ? enabledState : !enabledState); + } + + // Default behavior: if disabled, force ramp to 0 so outputs converge quickly + if (!state) velocityRamp = 0.0F; +} + +void ServoDriver::setFrequencyMax(float frequency) { + velocityMax = frequency; + InvVelocityMax = 1.0F/frequency; + + normalizedAcceleration = (acceleration.value/100.0F)*velocityMax; + accelerationFs = normalizedAcceleration/FRACTIONAL_SEC; + + // show velocity control settings + VF("MSG:"); V(axisPrefix); VF("Vmax="); V(velocityMax); VLF(" steps/s"); + VF("MSG:"); V(axisPrefix); VF("Acceleration="); V(acceleration.value); VF("%/s/s ("); V(accelerationFs); VLF(" steps/s/fs)"); +} + +float ServoDriver::setMotorVelocity(float velocity) { + if (!enabled) velocity = 0.0F; + + if (zeroDeadband.value > 0.0F && fabsf(velocity) < zeroDeadband.value) velocity = 0.0F; + + if (velocity > velocityMax) velocity = velocityMax; else + if (velocity < -velocityMax) velocity = -velocityMax; + + if(bypassAccelOnTracking) + velocityRamp = velocity; + else { + // ramp velocity + if (velocity > velocityRamp) { + velocityRamp += accelerationFs; + if (velocityRamp > velocity) velocityRamp = velocity; + } else + if (velocity < velocityRamp) { + velocityRamp -= accelerationFs; + if (velocityRamp < velocity) velocityRamp = velocity; + } + } + + if (velocityRamp >= 0.0F) motorDirection = DIR_FORWARD; else motorDirection = DIR_REVERSE; + + return velocityRamp; +} + +// update status info. for driver +void ServoDriver::updateStatus() { + if (statusMode == ON) { + const unsigned long now = millis(); + + if ((long)(now - timeLastStatusUpdate) > 200L) { + readStatus(); + + // open load indication is not reliable in standstill + if (status.outputA.shortToGround || + status.outputB.shortToGround || + status.overTemperatureWarning || + status.overTemperature) status.fault = true; else status.fault = false; + + timeLastStatusUpdate = now; + } + } + + #if DEBUG == VERBOSE + if (status.standstill) { status.outputA.openLoad = false; status.outputB.openLoad = false; status.standstill = false; } + if ((status.outputA.shortToGround != lastStatus.outputA.shortToGround) || + (status.outputA.openLoad != lastStatus.outputA.openLoad) || + (status.outputB.shortToGround != lastStatus.outputB.shortToGround) || + (status.outputB.openLoad != lastStatus.outputB.openLoad) || + (status.overTemperatureWarning != lastStatus.overTemperatureWarning) || + (status.overTemperature != lastStatus.overTemperature) || + (status.standstill != lastStatus.standstill) || + (status.fault != lastStatus.fault)) { + VF("MSG:"); V(axisPrefix); VF("status change "); + VF("SGA"); if (status.outputA.shortToGround) VF("< "); else VF(". "); + VF("OLA"); if (status.outputA.openLoad) VF("< "); else VF(". "); + VF("SGB"); if (status.outputB.shortToGround) VF("< "); else VF(". "); + VF("OLB"); if (status.outputB.openLoad) VF("< "); else VF(". "); + VF("OTP"); if (status.overTemperatureWarning) VF("< "); else VF(". "); + VF("OTE"); if (status.overTemperature) VF("< "); else VF(". "); + VF("SST"); if (status.standstill) VF("< "); else VF(". "); + VF("FLT"); if (status.fault) VLF("<"); else VLF("."); + } + lastStatus = status; + #endif +}; + +#endif diff --git a/src/lib/axis/motor/servo/ServoDriver.h b/src/lib/axis/motor/servo/ServoDriver.h new file mode 100755 index 0000000..c785413 --- /dev/null +++ b/src/lib/axis/motor/servo/ServoDriver.h @@ -0,0 +1,135 @@ +// ----------------------------------------------------------------------------------- +// axis servo motor driver +#pragma once + +#include +#include "../../../../Common.h" + +#include "../Drivers.h" +#include "../Motor.h" + +#ifdef SERVO_MOTOR_PRESENT + +typedef struct ServoPins { + int16_t ph1; // step + int16_t ph1State; + int16_t ph2; // dir + int16_t ph2State; + int16_t enable; + uint8_t enabledState; + int16_t m0; + int16_t m1; + int16_t m2; + int16_t m3; + int16_t fault; +} ServoPins; + +typedef struct ServoSettings { + int16_t model; + int8_t status; + int32_t acceleration; // acceleration in encoder %/s/s +} ServoSettings; + +class ServoDriver { + public: + ServoDriver(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings); + + // decodes driver model and sets up the pin modes + virtual bool init(bool reverse); + + // returns the number of axis parameters + virtual uint8_t getParameterCount() { return numParameters; } + + // returns the specified axis parameter + virtual AxisParameter* getParameter(uint8_t number) { if (number > numParameters) return &invalid; else return parameter[number]; } + + // check if axis parameter is valid + virtual bool parameterIsValid(AxisParameter* parameter, bool next = false) { return true; } + + // alternate mode for movement + virtual void alternateMode(bool state) { UNUSED(state); } + + // enable or disable the driver using the enable pin or other method + virtual void enable(bool state); + + // sets frequency corrosponding to the fastest allowed slew rate + // \param frequency: rate of motion in steps (counts) per second + void setFrequencyMax(float frequency); + + // set motor velocity + // \param velocity as needed to reach the target position, in signed encoder counts per second + virtual float setMotorVelocity(float velocity); + + // set motor velocity + // \param velocity as needed to reach the target position, in signed encoder counts per second + // \param encoderVelocity in signed encoder counts per second + // \returns velocity in effect, in signed encoder counts per second + virtual float setMotorVelocity(float velocity, float encoderVelocity) { + UNUSED(encoderVelocity); + return setMotorVelocity(velocity); + } + + // returns motor direction (DIR_FORWARD or DIR_REVERSE) + Direction getMotorDirection() { return motorDirection; }; + + // update status info. for driver + // this is a required method for the Axis class + virtual void updateStatus(); + + // get status info. + // this is a required method for the Axis class + DriverStatus getStatus() { return status; } + + // do not use acceleration while trackings + void setBypassAccelOnTracking(bool on) { bypassAccelOnTracking = on; } + + // calibrate the motor if required + virtual void calibrateDriver() {} + + // get the driver name + virtual const char* name() { return NULL; } + + protected: + virtual void readStatus() {} + + int axisNumber; + char axisPrefix[32]; // prefix for debug messages + + int16_t driverModel; + int16_t statusMode; + + DriverStatus status = { false, {false, false}, {false, false}, false, false, false, false }; + #if DEBUG != OFF + DriverStatus lastStatus = {false, {false, false}, {false, false}, false, false, false, false}; + #endif + unsigned long timeLastStatusUpdate = 0; + + float normalizedAcceleration; // in encoder counts/s/s + float accelerationFs; // in encoder counts/s/fs + float velocityRamp = 1.0F; // regulate velocity changes + float velocityMax = 1.0F; // frequency corrosponding to the fastest allowed slew rate, in encoder counts/s + float InvVelocityMax = 1.0F; + + Direction motorDirection = DIR_FORWARD; + bool reversed = false; + + int16_t enablePin = OFF; + uint8_t enabledState = LOW; + bool enabled = false; + int16_t faultPin = OFF; + bool bypassAccelOnTracking = false; + + const ServoPins *Pins; + const ServoSettings *Settings; + + // runtime adjustable settings + AxisParameter invalid = {NAN, NAN, NAN, NAN, NAN, AXP_INVALID, ""}; + AxisParameter acceleration = {NAN, NAN, NAN, 0, 100000, AXP_FLOAT, AXPN_MAX_ACCEL}; + AxisParameter zeroDeadband = {NAN, NAN, NAN, 0.0, 500.0, AXP_FLOAT_IMMEDIATE, "Deadband, cps"}; + + // this array list isn't used if overridden, just a place holder! + const int numParameters = 2; + AxisParameter* parameter[3] = {&invalid, &acceleration, &zeroDeadband}; +}; + +#endif diff --git a/src/lib/axis/motor/servo/dc/DcServoDriver.cpp b/src/lib/axis/motor/servo/dc/DcServoDriver.cpp new file mode 100755 index 0000000..d445092 --- /dev/null +++ b/src/lib/axis/motor/servo/dc/DcServoDriver.cpp @@ -0,0 +1,167 @@ +// ----------------------------------------------------------------------------------- +// axis servo DC motor driver + +#include "DcServoDriver.h" + +#if defined(SERVO_PE_PRESENT) || defined(SERVO_EE_PRESENT) || \ + defined(SERVO_TMC2130_DC_PRESENT) || defined(SERVO_TMC5160_DC_PRESENT) + +#include "../../../../gpioEx/GpioEx.h" + +// constructor +ServoDcDriver::ServoDcDriver(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, + float pwmMinimum, float pwmMaximum) + :ServoDriver(axisNumber, Pins, Settings) { + if (axisNumber < 1 || axisNumber > 9) return; + + this->pwmMinimum.valueDefault = pwmMinimum; + this->pwmMaximum.valueDefault = pwmMaximum; + + dirDeadTimeMs.valueDefault = 0.0F; + #if SERVO_DC_VPID == ON + velKp.valueDefault = 0.2F; + velKi.valueDefault = 0.5F; + velIMax.valueDefault = 0.2F; + #endif +} + +#if SERVO_DC_VPID == ON + + float ServoDcDriver::setMotorVelocity(float velocity, float encoderVelocity) { + velocity = ServoDriver::setMotorVelocity(velocity); + + if (velocity == 0.0F) { + pwmUpdate(0.0F); + vI = 0.0F; + velLastUs = 0; + lastEffectiveDirection = 0; + return 0.0F; + } + + const float vmag = fabsf(velocity); + const int8_t dir = (velocity > 0.0F) ? 1 : -1; + + const unsigned long nowMs = millis(); + if (lastEffectiveDirection != 0 && dir != lastEffectiveDirection) { + const unsigned long dtMs = (unsigned long)lroundf(dirDeadTimeMs.value); + if (dtMs) dirHoldUntilMs = nowMs + dtMs; + vI = 0.0F; + velLastUs = 0; + } + lastEffectiveDirection = dir; + + if ((long)(dirHoldUntilMs - nowMs) > 0) { + pwmUpdate(0.0F); + return 0.0F; + } + + const float dMin = pwmMinimum.value * 0.01F; + const float dMax0 = pwmMaximum.value * 0.01F; + const float dMax = (dMax0 >= dMin) ? dMax0 : dMin; + const float dSpan = dMax - dMin; + + float vcmd01 = vmag * InvVelocityMax; + if (vcmd01 > 1.0F) vcmd01 = 1.0F; + + const uint32_t nowUs = micros(); + uint32_t dUs = nowUs - velLastUs; + if (velLastUs == 0) dUs = 0; + velLastUs = nowUs; + + // measured velocity projected onto commanded direction and normalized + encoderVelocity *= (float)dir; + const float vmeas01 = encoderVelocity * InvVelocityMax; + const float error01 = vcmd01 - vmeas01; + + float u01 = vcmd01 + (velKp.value * error01) + vI; + + float uSat = u01; + if (uSat < 0.0F) uSat = 0.0F; + else if (uSat > 1.0F) uSat = 1.0F; + + if (velKi.value > 0.0F && dUs > 0 && dUs <= 200000U) { + const bool atLo = (uSat <= 0.0F); + const bool atHi = (uSat >= 1.0F); + const bool allowI = + (!atLo && !atHi) || + (atLo && error01 > 0.0F) || + (atHi && error01 < 0.0F); + + if (allowI) { + vI += velKi.value * error01 * (dUs * 0.000001F); + + const float imax = velIMax.value; + if (vI > imax) vI = imax; + else if (vI < -imax) vI = -imax; + + u01 = vcmd01 + (velKp.value * error01) + vI; + uSat = u01; + if (uSat < 0.0F) uSat = 0.0F; + else if (uSat > 1.0F) uSat = 1.0F; + } + } else if (dUs > 200000U) { + vI = 0.0F; + } + + float dutyMag01 = 0.0F; + if (uSat > 0.0F) { + dutyMag01 = dMin + dSpan * uSat; + if (dutyMag01 > dMax) dutyMag01 = dMax; + } + + pwmUpdate(dutyMag01 * (float)dir); + return velocity; + } + +#else + + float ServoDcDriver::setMotorVelocity(float velocity, float /*encoderVelocity*/) { + velocity = ServoDriver::setMotorVelocity(velocity); + + if (velocity == 0.0F) { + pwmUpdate(0.0F); + velLastUs = 0; + lastEffectiveDirection = 0; + return 0.0F; + } + + const float vmag = fabsf(velocity); + const int8_t dir = (velocity > 0.0F) ? 1 : -1; + + const unsigned long nowMs = millis(); + if (lastEffectiveDirection != 0 && dir != lastEffectiveDirection) { + const unsigned long dtMs = (unsigned long)lroundf(dirDeadTimeMs.value); + if (dtMs) dirHoldUntilMs = nowMs + dtMs; + velLastUs = 0; + } + lastEffectiveDirection = dir; + + if ((long)(dirHoldUntilMs - nowMs) > 0) { + pwmUpdate(0.0F); + return 0.0F; + } + + const float dMin = pwmMinimum.value * 0.01F; + const float dMax0 = pwmMaximum.value * 0.01F; + const float dMax = (dMax0 >= dMin) ? dMax0 : dMin; + const float dSpan = dMax - dMin; + + float vcmd01 = vmag * InvVelocityMax; + if (vcmd01 > 1.0F) vcmd01 = 1.0F; + + // feedforward-only: uSat = vcmd01 + const float uSat = vcmd01; + + float dutyMag01 = 0.0F; + if (uSat > 0.0F) { + dutyMag01 = dMin + dSpan * uSat; + if (dutyMag01 > dMax) dutyMag01 = dMax; + } + + pwmUpdate(dutyMag01 * (float)dir); + return velocity; + } + +#endif + +#endif diff --git a/src/lib/axis/motor/servo/dc/DcServoDriver.h b/src/lib/axis/motor/servo/dc/DcServoDriver.h new file mode 100755 index 0000000..74c8c5e --- /dev/null +++ b/src/lib/axis/motor/servo/dc/DcServoDriver.h @@ -0,0 +1,65 @@ +// ----------------------------------------------------------------------------------- +// axis servo DC motor driver +#pragma once + +#include +#include "../../../../../Common.h" + +#if defined(SERVO_PE_PRESENT) || defined(SERVO_EE_PRESENT) || defined(SERVO_TMC2130_DC_PRESENT) || defined(SERVO_TMC5160_DC_PRESENT) + +#include "../ServoDriver.h" + +#ifndef SERVO_DC_VPID + #if ENCODER_VELOCITY == ON + #define SERVO_DC_VPID ON + #else + #define SERVO_DC_VPID OFF + #endif +#endif + +class ServoDcDriver : public ServoDriver { + public: + // constructor + ServoDcDriver(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float pwmMinimum, float pwmMaximum); + + // returns the number of axis parameters + uint8_t getParameterCount() { return numParameters; } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { if (number > numParameters) return &invalid; else return parameter[number]; } + + // set motor velocity + // \param velocity as needed to reach the target position, in signed encoder counts per second + // \param encoderVelocity in signed encoder counts per second + // \returns velocity in effect, in signed encoder counts per second + float setMotorVelocity(float velocity, float encoderVelocity) override; + + protected: + + // motor control pwm update + // \param power01 in -1.0 to 1.0 units + virtual void pwmUpdate(float power01) { } + + // runtime adjustable settings + AxisParameter pwmMinimum = {NAN, NAN, NAN, 0.0, 100.0, AXP_FLOAT_IMMEDIATE, AXPN_MIN_PWR}; + AxisParameter pwmMaximum = {NAN, NAN, NAN, 1.0, 100.0, AXP_FLOAT_IMMEDIATE, AXPN_MAX_PWR}; + AxisParameter dirDeadTimeMs = {NAN, NAN, NAN, 0.0, 50.0, AXP_FLOAT_IMMEDIATE, "Deadtime, ms"}; + #if SERVO_DC_VPID == ON + AxisParameter velKp = {NAN, NAN, NAN, 0.0, 10.0, AXP_FLOAT_IMMEDIATE, "Vel Kp"}; + AxisParameter velKi = {NAN, NAN, NAN, 0.0, 10.0, AXP_FLOAT_IMMEDIATE, "Vel Ki"}; + AxisParameter velIMax = {NAN, NAN, NAN, 0.0, 1.0, AXP_FLOAT_IMMEDIATE, "Vel Imax"}; + const int numParameters = 8; + AxisParameter* parameter[9] = {&invalid, &acceleration, &zeroDeadband, &pwmMinimum, &pwmMaximum, &dirDeadTimeMs, &velKp, &velKi, &velIMax}; + #else + const int numParameters = 5; + AxisParameter* parameter[6] = {&invalid, &acceleration, &zeroDeadband, &pwmMinimum, &pwmMaximum, &dirDeadTimeMs}; + #endif + + private: + float vI = 0.0F; + uint32_t velLastUs = 0; + uint32_t dirHoldUntilMs = 0; + int8_t lastEffectiveDirection = 0; // -1,0,+1 +}; + +#endif diff --git a/src/lib/axis/motor/servo/dc/calibration/TrackingVelocity.cpp b/src/lib/axis/motor/servo/dc/calibration/TrackingVelocity.cpp new file mode 100755 index 0000000..7b49532 --- /dev/null +++ b/src/lib/axis/motor/servo/dc/calibration/TrackingVelocity.cpp @@ -0,0 +1,746 @@ +// ============================== TrackingVelocity.cpp =============================== +// ----------------------------------------------------------------------------------- +// Servo Tracking Velocity Calibration — Overview +// +// Goal +// Calibrate, per direction, the minimum open-loop *driver command percent* (“u”, % of +// the driver’s velocity range) that: +// • breaks stiction from rest (u_break) +// • sustains motion after a short kick (u_hold) +// +// Mode (Open-loop) +// While calibration is active (experimentMode=true) the axis runs open-loop: +// • Tracking/PID/hysteresis/nonlinear helpers are disabled in this TU +// • The driver is fed a fixed *command %* (experimentVelocity), interpreted as a +// fraction of the driver’s max velocity capability (not a PWM duty cycle) +// • “Velocity” in the logs means encoder-derived steps/s (not a PID setpoint) +// +// Per-direction phases +// 1) Stiction Break (u_break) +// - Staircase upward from SERVO_CALIBRATION_START_VELOCITY_PERCENT. +// - Between steps, STOP and wait SERVO_CALIBRATION_MOTOR_SETTLE_TIME ms to kill carry-over. +// - Acceptance rule: must meet the SAME consecutive-moving requirement as u_hold +// (SERVO_CALIBRATION_REQUIRED_MOVING_SAMPLES). UB additionally enforces a hard +// per-candidate sample cap (SERVO_CAL_UB_MAX_SAMPLES) to avoid indefinite waiting. +// 2) Velocity Hold (u_hold) +// - From u_break, staircase downward to find the minimum command % that keeps moving. +// - Each candidate is kick-started at u_break, then held at the candidate %. +// - Acceptance rule: SAME consecutive-moving requirement. Any failed sample +// immediately stalls the candidate. +// +// Reporting/imbalance +// After both directions finish, an imbalance warning is logged if FWD/REV u_hold +// differ beyond SERVO_CALIBRATION_IMBALANCE_ERROR_THRESHOLD. +// +// ------------------------------ How the state machine works ------------------------- +// There are TWO interleaved state machines: +// +// (A) High-level PHASE machine (per axis) [CalibrationState]: +// IDLE → U_BREAK → U_HOLD → (flip direction) → U_BREAK → U_HOLD → CHECK_IMBALANCE +// ↘ (if both axes enabled) WAIT_PEER +// If both axes are enabled, we serialize execution RA first, DEC second via WAIT_TURN. +// +// (B) Motor SUB-STATE machine (per axis) [MotorState]: +// STOPPED ↔ SETTLING → (start test) → KICKING → HOLDING → RUNNING_STEADY +// +// - SETTLING: enforced pause after STOP to let motion decay. +// - KICKING: briefly command u_break to overcome stiction for a u_hold test. +// - HOLDING: hold candidate % and sample velocity at fixed cadence. +// - RUNNING_STEADY: means “accepted as moving” (name kept for API compatibility). +// +// ------------------------------ “Motor moved?” decision ----------------------------- +// At each HOLDING sample (every SERVO_CALIBRATION_VELOCITY_SETTLE_CHECK_INTERVAL ms): +// - Compute instantaneous velocity from encoder/step deltas. +// - Accept a single sample as MOVING if BOTH are true: +// • |velocity| > SERVO_CALIBRATION_MIN_DETECTABLE_VELOCITY (noise floor guard) +// • |deltaCounts| ≥ SERVO_CALIBRATION_MIN_COUNTS_PER_SAMPLE (minimum progress) +// +// Acceptance rule (shared by UB & UH): +// - Require SERVO_CALIBRATION_REQUIRED_MOVING_SAMPLES consecutive MOVING samples +// to accept the candidate as RUNNING_STEADY. +// - For u_hold (UH): any non-moving sample immediately fails the candidate. +// - For u_break (UB): keep sampling until a small cap (SERVO_CAL_UB_MAX_SAMPLES); +// if we still haven’t reached the consecutive requirement, fail the candidate. +// +// ------------------------------ Two-axis coordination ------------------------------ +// - Selection mask: CALIBRATE_SERVO_AXIS_SELECT (bit0=Axis1, bit1=Axis2). In this .cpp, +// 0 expands to “both” via SERVO_CAL_ALL_AXES_MASK (0x03). +// - Turn-taking: If both axes are enabled, Axis 1 runs first while Axis 2 waits +// in WAIT_TURN. When Axis 1 ends, it grants the turn to Axis 2. +// - Joint report: First finisher waits (WAIT_PEER) for the other; then a single +// combined report is printed. +// ----------------------------------------------------------------------------------- + +#include "TrackingVelocity.h" + +#if defined(SERVO_MOTOR_PRESENT) && defined(CALIBRATE_SERVO_DC) + +// ---------- Compact logging helpers (one-line logs) ---------- +static inline void LOG_HDR(const char* axisPrefix) { V(axisPrefix); VF(" "); } +static inline void LOG_DIR(bool fwd){ VF(fwd ? "F " : "R "); } // F=forward, R=reverse +static inline const char* PHASE_UB(){ return "UB"; } // u_break +static inline const char* PHASE_UH(){ return "UH"; } // u_hold + +// Disable servo helpers during calibration (we want raw behavior) +#ifdef SERVO_HYSTERESIS_ENABLE + #undef SERVO_HYSTERESIS_ENABLE +#endif +#ifdef SERVO_STICTION_KICK + #undef SERVO_STICTION_KICK +#endif +#ifdef SERVO_NONLINEAR_ENABLE + #undef SERVO_NONLINEAR_ENABLE +#endif + +#ifdef TRACK_AUTOSTART + #undef TRACK_AUTOSTART +#endif + +// ------------------------ UB sampling cap (avoid infinite wait) --------------------- +// UB uses the same consecutive requirement as UH, but we also enforce a hard cap on the +// total number of samples we will take for a single UB candidate before declaring STALLED. +#ifndef SERVO_CAL_UB_MAX_SAMPLES + #define SERVO_CAL_UB_MAX_SAMPLES 6 +#endif + +// -------------------- Joint calibration coordination (for 2 axes) ------------------- +struct AxisCalibSnapshot { + bool valid = false; + ServoCalibrateTrackingVelocity::DirectionData fwd; + ServoCalibrateTrackingVelocity::DirectionData rev; + char axisPrefix[32] = {0}; +}; + +// 1-based index: [1] and [2] used; [0] unused +static volatile bool g_axisEnabledForCal[3] = {false,false,false}; +static volatile bool g_axisDone[3] = {false,false,false}; +static AxisCalibSnapshot g_snapshot[3]; +static volatile bool g_jointReportPrinted = false; + +// Turn-taking: 0 = none yet, 1 = Axis 1's turn, 2 = Axis 2's turn +static volatile uint8_t g_currentAxisTurn = 0; + +static inline uint8_t otherAxis(uint8_t axis) { return axis == 1 ? 2 : 1; } + +// Save final per-axis results for the joint report +static void snapshotAxisData(uint8_t axis, + const char* axisPrefix, + const ServoCalibrateTrackingVelocity::DirectionData& fwd, + const ServoCalibrateTrackingVelocity::DirectionData& rev) { + AxisCalibSnapshot &s = g_snapshot[axis]; + s.valid = true; + s.fwd = fwd; + s.rev = rev; + snprintf(s.axisPrefix, sizeof(s.axisPrefix), "%s", axisPrefix ? axisPrefix : ""); +} + +// Print one axis table +static void printOneAxisTable(const AxisCalibSnapshot& s) { + ServoCalibrateTrackingVelocity::printReport(s.axisPrefix, s.fwd, s.rev); +} + +// Print the combined report for both axes (if present) +static void printJointReport() { + VLF("\n===== Joint Servo Calibration ====="); + if (g_snapshot[1].valid) printOneAxisTable(g_snapshot[1]); + if (g_snapshot[2].valid) printOneAxisTable(g_snapshot[2]); + + if (g_snapshot[1].valid && g_snapshot[2].valid) { + float a1 = (g_snapshot[1].fwd.u_hold + g_snapshot[1].rev.u_hold) / 2.0f; + float a2 = (g_snapshot[2].fwd.u_hold + g_snapshot[2].rev.u_hold) / 2.0f; + float delta = fabsf(a1 - a2); + VF("Cross-axis avg u_hold delta: "); V(delta); VLF("%"); + (void)delta; // silence if logs trimmed + } + VLF("==================================\n"); +} + +// ------------------------------------------------------------------------------------ +// Class methods +// ------------------------------------------------------------------------------------ + +ServoCalibrateTrackingVelocity::ServoCalibrateTrackingVelocity(uint8_t axisNumber) { + this->axisNumber = axisNumber; + snprintf(axisPrefix, sizeof(axisPrefix), "Axis%d ServoCalibrate", axisNumber); +} + +void ServoCalibrateTrackingVelocity::init() { + experimentVelocity = 0.0f; + experimentMode = false; + calibrationState = CALIBRATION_IDLE; + motorState = MOTOR_STOPPED; + + resetCalibrationValues(); + + lastStateChangeTime = lastVelocityTime = settleStartTime = + calibrationStepStartTime = kickStartTime = 0; + currentTicks = calibrationStepStartTicks = lastTicks = 0; + lastVelocityMeasurement = 0.0f; + lastDeltaCounts = 0; + steadySinceMs = 0; + steadyStartTicks = 0; + lastCheckTime = 0; + + staircaseIters = 0; + currentSearchVelocity = 0.0f; + foundValidMotion = false; + + hasQueuedTest = false; + queuedState = CALIBRATION_IDLE; + queuedVelocity = 0.0f; + + consecutiveMovingSamples = 0; + candidateSampleCount = 0; + + if (axisNumber == 1) { + g_axisDone[1] = g_axisDone[2] = false; + g_axisEnabledForCal[1] = g_axisEnabledForCal[2] = false; // set in start() + g_snapshot[1] = AxisCalibSnapshot(); + g_snapshot[2] = AxisCalibSnapshot(); + g_jointReportPrinted = false; + g_currentAxisTurn = 0; + } + + setVelocity(0); + startSettling(); +} + +void ServoCalibrateTrackingVelocity::start(float trackingFrequency, long /*instrumentCoordinateSteps*/) { + // Expand 0 → all-axes mask, otherwise use the provided mask + const uint8_t effectiveMask = + (CALIBRATE_SERVO_AXIS_SELECT == 0) ? SERVO_CAL_ALL_AXES_MASK + : CALIBRATE_SERVO_AXIS_SELECT; + + // Respect axis selection bitmask (skip if not requested) + if (!(effectiveMask & (1U << (axisNumber - 1)))) { + LOG_HDR(axisPrefix); VLF("skip"); + g_axisEnabledForCal[axisNumber] = false; + return; + } + + g_axisEnabledForCal[axisNumber] = true; + + LOG_HDR(axisPrefix); VLF("start"); + + enabled = true; + experimentMode = true; + calibrationDirectionIsForward = true; + calibrationState = CALIBRATION_U_BREAK; // may be overridden to WAIT_TURN + motorState = MOTOR_STOPPED; + calibrationVelocity = SERVO_CALIBRATION_START_VELOCITY_PERCENT; + targetVelocity = trackingFrequency; + lastStateChangeTime = millis(); + + staircaseIters = 0; + currentSearchVelocity = calibrationVelocity; + foundValidMotion = false; + + const bool bothEnabled = (effectiveMask == SERVO_CAL_ALL_AXES_MASK); + if (bothEnabled) { + if (g_currentAxisTurn == 0) { + g_currentAxisTurn = 1; // Axis 1 starts + } + if (axisNumber != g_currentAxisTurn) { + LOG_HDR(axisPrefix); VLF("wait-turn"); + calibrationState = CALIBRATION_WAIT_TURN; + setVelocity(0); + startSettling(); + return; + } + } + + setVelocity(0); + startSettling(); +} + +void ServoCalibrateTrackingVelocity::updateState(long instrumentCoordinateSteps) { + if(!enabled || !experimentMode) return; + + currentTime = millis(); + currentTicks = instrumentCoordinateSteps; + + handleMotorState(); + + if (currentTime - lastStateChangeTime > SERVO_CALIBRATION_TIMEOUT) { + LOG_HDR(axisPrefix); VLF("timeout → reset"); + handleCalibrationFailure(); + return; + } + + if (calibrationState == CALIBRATION_WAIT_TURN) { + if (g_currentAxisTurn == axisNumber) { + calibrationState = CALIBRATION_U_BREAK; + hasQueuedTest = false; + queueNextTest(CALIBRATION_U_BREAK, calibrationDirectionIsForward + ? SERVO_CALIBRATION_START_VELOCITY_PERCENT + : -SERVO_CALIBRATION_START_VELOCITY_PERCENT); + if (motorState != MOTOR_SETTLING) { + setVelocity(0); + startSettling(); + } + } + return; + } + + if (calibrationState == CALIBRATION_WAIT_PEER) { + uint8_t other = otherAxis(axisNumber); + if (!g_axisEnabledForCal[other] || g_axisDone[other]) { + if (!g_jointReportPrinted) { + g_jointReportPrinted = true; + printJointReport(); + } + experimentMode = false; + calibrationState = CALIBRATION_IDLE; + setVelocity(0); + LOG_HDR(axisPrefix); VLF("done"); + } + return; + } + + // Only run phase logic when a candidate outcome is resolvable + if (motorState != MOTOR_RUNNING_STEADY && motorState != MOTOR_STOPPED) return; + + switch (calibrationState) { + case CALIBRATION_U_BREAK: processUBreak(); break; + case CALIBRATION_U_HOLD: processUHold(); break; + case CALIBRATION_CHECK_IMBALANCE: processImbalanceCheck(); break; + default: break; + } +} + +// -------------------------------- Motor sub-state machine --------------------------- +void ServoCalibrateTrackingVelocity::handleMotorState() { + switch (motorState) { + case MOTOR_SETTLING: { + float currentVelocity = calculateInstantaneousVelocity(); + if (currentTime - settleStartTime >= SERVO_CALIBRATION_MOTOR_SETTLE_TIME) { + motorState = MOTOR_STOPPED; + LOG_HDR(axisPrefix); VF("settled v="); V(currentVelocity); VLF(" sps"); + if (hasQueuedTest) { + calibrationState = queuedState; + hasQueuedTest = false; + startTest(queuedVelocity); + } + } + lastVelocityMeasurement = currentVelocity; + lastVelocityTime = currentTime; + break; + } + + case MOTOR_KICKING: + if (currentTime - kickStartTime >= SERVO_CALIBRATION_KICK_DURATION_MS) { + setVelocity(calibrationVelocity); + motorState = MOTOR_HOLDING; + calibrationStepStartTime = currentTime; + calibrationStepStartTicks = currentTicks; + lastVelocityTime = currentTime; + lastVelocityMeasurement = 0; + consecutiveMovingSamples = 0; + candidateSampleCount = 0; + + LOG_HDR(axisPrefix); LOG_DIR(calibrationDirectionIsForward); + VF("kick→hold @"); V(calibrationVelocity); VLF("%"); + } + break; + + case MOTOR_HOLDING: + // Both UB and UH require N consecutive moving samples. + // UB additionally has a hard sample cap to avoid endless waiting. + if (currentTime - lastVelocityTime >= SERVO_CALIBRATION_VELOCITY_SETTLE_CHECK_INTERVAL) { + float v_now = calculateInstantaneousVelocity(); + long dCounts = lastDeltaCounts; + + const bool isUB = (calibrationState == CALIBRATION_U_BREAK); + const int requiredConsec = SERVO_CALIBRATION_REQUIRED_MOVING_SAMPLES; + + const bool movingNow = + (fabsf(v_now) > SERVO_CALIBRATION_MIN_DETECTABLE_VELOCITY) && + (labs(dCounts) >= SERVO_CALIBRATION_MIN_COUNTS_PER_SAMPLE); + + // count total samples in this candidate (UB and UH) + candidateSampleCount++; + + if (movingNow) { + consecutiveMovingSamples++; + LOG_HDR(axisPrefix); LOG_DIR(calibrationDirectionIsForward); + VF(isUB ? PHASE_UB() : PHASE_UH()); + VF(" hold@"); V(calibrationVelocity); VF("% sps="); V(v_now); + VF(" cnt="); V(dCounts); VF(" ok "); V(consecutiveMovingSamples); + VF("/"); V(requiredConsec); + if (consecutiveMovingSamples >= requiredConsec) VF(" → MOVE"); + VL(""); + + if (consecutiveMovingSamples >= requiredConsec) { + motorState = MOTOR_RUNNING_STEADY; // accept candidate + steadySinceMs = currentTime; + steadyStartTicks = currentTicks; + } + } else { + // failed sample → reset the consecutive counter for BOTH UB and UH + consecutiveMovingSamples = 0; + + if (isUB) { + // UB: keep sampling until cap, then fail if we never reached requiredConsec + if (candidateSampleCount >= SERVO_CAL_UB_MAX_SAMPLES) { + motorState = MOTOR_STOPPED; + LOG_HDR(axisPrefix); VLF("HOLD_STALLED (UB: no consecutive move within cap)"); + } + // else: keep waiting for next sample + } else { + // UH: strict — any failure cancels this candidate immediately + motorState = MOTOR_STOPPED; + LOG_HDR(axisPrefix); VLF("HOLD_STALLED"); + } + } + + lastVelocityMeasurement = v_now; + lastVelocityTime = currentTime; + } + break; + + case MOTOR_RUNNING_STEADY: + // Nothing to do; phase logic will treat as "moved" + break; + + case MOTOR_STOPPED: + // Idle; phase logic will interpret as "not moved" + break; + } +} + +// Compute instantaneous velocity in steps/s using elapsed time. +float ServoCalibrateTrackingVelocity::calculateInstantaneousVelocity() { + if (lastCheckTime == 0) { + lastCheckTime = currentTime; + lastTicks = currentTicks; + lastDeltaCounts = 0; + return 0.0f; + } + + float elapsed = (currentTime - lastCheckTime) / 1000.0f; + if (elapsed <= 0) return 0.0f; + + long dCounts = (currentTicks - lastTicks); + float velocity = dCounts / elapsed; + +#ifdef SERVO_CAL_DEBUG + VF("DBG: "); V(axisPrefix); VF(" vel%="); V(calibrationVelocity); + VF(", dTicks="); V(dCounts); VF(", Vel="); V(velocity); VL(" steps/s"); +#endif + + lastTicks = currentTicks; + lastCheckTime = currentTime; + lastDeltaCounts = dCounts; + + return velocity; +} + +// ------------------------------- Helpers & Phase handlers --------------------------- + +ServoCalibrateTrackingVelocity::DirectionData& +ServoCalibrateTrackingVelocity::currentDirectionData() { + return calibrationDirectionIsForward ? fwdData : revData; +} + +const ServoCalibrateTrackingVelocity::DirectionData& +ServoCalibrateTrackingVelocity::currentDirectionData() const { + return calibrationDirectionIsForward ? fwdData : revData; +} + +void ServoCalibrateTrackingVelocity::recordMovementData(float velocity, long counts) { + DirectionData& data = currentDirectionData(); + if (calibrationState == CALIBRATION_U_BREAK) { + data.breakVel = velocity; + data.breakCounts = counts; + } else { + data.holdVel = velocity; + data.holdCounts = counts; + } +} + +void ServoCalibrateTrackingVelocity::logTestResult(const char* phase, bool moved) { + LOG_HDR(axisPrefix); LOG_DIR(calibrationDirectionIsForward); + V(phase); VF(": "); VF(moved ? "MOVE" : "STALL"); + VF(" @"); V(calibrationVelocity); VF("%"); + if (moved) { VF(" v≈"); V(lastVelocityMeasurement); VF(" sps"); } + VL(""); +} + +// u_break: staircase upward from rest until we get a "moved" or hit limits +void ServoCalibrateTrackingVelocity::processUBreak() { + if (++staircaseIters > SERVO_CALIBRATION_REFINE_MAX_ITERATIONS) { + LOG_HDR(axisPrefix); VLF("UB iter-limit"); + if (!foundValidMotion) { + currentDirectionData().u_break = SERVO_CALIBRATION_STOP_VELOCITY_PERCENT; + LOG_HDR(axisPrefix); VF("UB none→max="); V(currentDirectionData().u_break); VLF("%"); + } + proceedToUHold(); + return; + } + + if (motorState != MOTOR_RUNNING_STEADY && motorState != MOTOR_STOPPED) return; + + const bool moved = (motorState == MOTOR_RUNNING_STEADY); + const float currentAbsVelocity = fabsf(calibrationVelocity); + + LOG_HDR(axisPrefix); LOG_DIR(calibrationDirectionIsForward); + VF("UB "); VF(moved ? "OK" : "NO"); VF(" @"); V(currentAbsVelocity); VLF("%"); + + if (moved) { + foundValidMotion = true; + recordMovementData(lastVelocityMeasurement, lastDeltaCounts); + currentDirectionData().u_break = currentAbsVelocity; + currentDirectionData().everMoved = true; + + LOG_HDR(axisPrefix); LOG_DIR(calibrationDirectionIsForward); + VF("UB set="); V(currentAbsVelocity); VF("% v≈"); V(lastVelocityMeasurement); VLF(" sps"); + proceedToUHold(); + } else { + const float nextAbsVelocity = currentAbsVelocity + SERVO_CALIBRATION_STAIRCASE_STEP_PERCENT; + + if (nextAbsVelocity > SERVO_CALIBRATION_STOP_VELOCITY_PERCENT) { + if (!foundValidMotion) { + currentDirectionData().u_break = SERVO_CALIBRATION_STOP_VELOCITY_PERCENT; + LOG_HDR(axisPrefix); VF("UB none→max="); V(currentDirectionData().u_break); VLF("%"); + } + proceedToUHold(); + } else { + calibrationVelocity = calibrationDirectionIsForward ? nextAbsVelocity : -nextAbsVelocity; + startTest(calibrationVelocity); + } + } +} + +// u_hold: staircase downward; each candidate must meet the N-consecutive-moving rule +void ServoCalibrateTrackingVelocity::processUHold() { + if (++staircaseIters > SERVO_CALIBRATION_REFINE_MAX_ITERATIONS) { + LOG_HDR(axisPrefix); VLF("UH iter-limit"); + finishUHold(); + return; + } + + if (motorState != MOTOR_RUNNING_STEADY && motorState != MOTOR_STOPPED) return; + + const bool moved = (motorState == MOTOR_RUNNING_STEADY); + const float currentAbsVelocity = fabsf(calibrationVelocity); + const float u_break = currentDirectionData().u_break; + + if (moved) { + recordMovementData(lastVelocityMeasurement, lastDeltaCounts); + currentDirectionData().u_hold = currentAbsVelocity; + + logTestResult("u_hold", true); + + const float nextAbsVelocity = currentAbsVelocity - SERVO_CALIBRATION_STAIRCASE_STEP_PERCENT; + + if (nextAbsVelocity < SERVO_CALIBRATION_START_VELOCITY_PERCENT) { + LOG_HDR(axisPrefix); VF("UH min="); V(currentDirectionData().u_hold); VLF("%"); + finishUHold(); + } else { + // Kick at u_break to overcome stiction, then test the next-lower candidate + calibrationVelocity = calibrationDirectionIsForward ? nextAbsVelocity : -nextAbsVelocity; + setVelocity(calibrationDirectionIsForward ? u_break : -u_break); + motorState = MOTOR_KICKING; + kickStartTime = currentTime; + lastStateChangeTime = currentTime; + } + } else { + logTestResult("u_hold", false); + + if (currentDirectionData().u_hold == 0.0f) { + currentDirectionData().u_hold = u_break; // fall back + LOG_HDR(axisPrefix); VF("UH use UB="); V(currentDirectionData().u_hold); VLF("%"); + } + finishUHold(); + } +} + +void ServoCalibrateTrackingVelocity::proceedToUHold() { + // Transition to u_hold: stop, settle, then queue first test below u_break + setVelocity(0); + startSettling(); + + calibrationState = CALIBRATION_U_HOLD; + staircaseIters = 0; + + const float u_break = currentDirectionData().u_break; + currentSearchVelocity = max(u_break - SERVO_CALIBRATION_STAIRCASE_STEP_PERCENT, + SERVO_CALIBRATION_START_VELOCITY_PERCENT); + + LOG_HDR(axisPrefix); VF("UH first="); V(currentSearchVelocity); VLF("%"); + + queueNextTest(CALIBRATION_U_HOLD, calibrationDirectionIsForward ? currentSearchVelocity : -currentSearchVelocity); +} + +void ServoCalibrateTrackingVelocity::finishUHold() { + setVelocity(0); + startSettling(); + switchDirectionOrComplete(); +} + +void ServoCalibrateTrackingVelocity::switchDirectionOrComplete() { + if (calibrationDirectionIsForward) { + calibrationDirectionIsForward = false; + calibrationState = CALIBRATION_U_BREAK; + staircaseIters = 0; + calibrationVelocity = -SERVO_CALIBRATION_START_VELOCITY_PERCENT; + currentSearchVelocity = fabsf(calibrationVelocity); + foundValidMotion = false; + + queueNextTest(CALIBRATION_U_BREAK, calibrationVelocity); + LOG_HDR(axisPrefix); VLF("→ REVERSE"); + } else { + calibrationState = CALIBRATION_CHECK_IMBALANCE; + processImbalanceCheck(); + } +} + +void ServoCalibrateTrackingVelocity::processImbalanceCheck() { + snapshotAxisData(axisNumber, axisPrefix, fwdData, revData); + + if (fwdData.u_hold > 0 && revData.u_hold > 0) { + float avgTracking = (fwdData.u_hold + revData.u_hold) / 2.0f; + float imbalance = fabsf(fwdData.u_hold - revData.u_hold) / avgTracking * 100.0f; + + if (imbalance > SERVO_CALIBRATION_IMBALANCE_ERROR_THRESHOLD) { + LOG_HDR(axisPrefix); VF("imbalance "); V(imbalance); VLF("%"); + } + } + + g_axisDone[axisNumber] = true; + + uint8_t other = otherAxis(axisNumber); + if (g_axisEnabledForCal[other] && !g_axisDone[other]) { + g_currentAxisTurn = other; // pass the turn + } + + const bool peerEnabled = g_axisEnabledForCal[other]; + const bool peerDone = g_axisDone[other]; + + if (peerEnabled && !peerDone) { + calibrationState = CALIBRATION_WAIT_PEER; + setVelocity(0); + startSettling(); + return; + } + + if (!g_jointReportPrinted) { + g_jointReportPrinted = true; + printJointReport(); + } + + experimentMode = false; + calibrationState = CALIBRATION_IDLE; + setVelocity(0); + LOG_HDR(axisPrefix); VLF("done"); +} + +void ServoCalibrateTrackingVelocity::handleCalibrationFailure() { + LOG_HDR(axisPrefix); VLF("ERR reset"); + experimentMode = false; + calibrationState = CALIBRATION_IDLE; + setVelocity(0); + resetCalibrationValues(); + hasQueuedTest = false; +} + +void ServoCalibrateTrackingVelocity::startSettling() { + settleStartTime = currentTime; + motorState = MOTOR_SETTLING; +} + +void ServoCalibrateTrackingVelocity::startTest(float velocity) { + calibrationVelocity = velocity; + lastVelocityTime = currentTime; + lastVelocityMeasurement = 0; + lastStateChangeTime = currentTime; + + consecutiveMovingSamples = 0; + candidateSampleCount = 0; + + if (calibrationState == CALIBRATION_U_BREAK) { + setVelocity(calibrationVelocity); + motorState = MOTOR_HOLDING; + calibrationStepStartTime = currentTime; + calibrationStepStartTicks = currentTicks; + + LOG_HDR(axisPrefix); LOG_DIR(calibrationDirectionIsForward); + VF(PHASE_UB()); VF(" test @"); V(velocity); VLF("%"); + } else { + float u_break = currentDirectionData().u_break; + setVelocity(calibrationDirectionIsForward ? u_break : -u_break); + motorState = MOTOR_KICKING; + kickStartTime = currentTime; + + LOG_HDR(axisPrefix); LOG_DIR(calibrationDirectionIsForward); + VF(PHASE_UH()); VF(" kick@"); V(u_break); VF("% → hold@"); V(velocity); VLF("%"); + } +} + +void ServoCalibrateTrackingVelocity::setVelocity(float velocityPercent) { + experimentVelocity = constrain(velocityPercent, + -SERVO_CALIBRATION_STOP_VELOCITY_PERCENT, + +SERVO_CALIBRATION_STOP_VELOCITY_PERCENT); +} + +// -------- Getters ------------------------------------------------------------------- +float ServoCalibrateTrackingVelocity::getU_break(bool forward) { + return forward ? fwdData.u_break : revData.u_break; +} + +float ServoCalibrateTrackingVelocity::getU_hold(bool forward) { + return forward ? fwdData.u_hold : revData.u_hold; +} + +// -------- Reports ------------------------------------------------------------------- +void ServoCalibrateTrackingVelocity::printReport(const char* prefix, + const DirectionData& fwd, + const DirectionData& rev) { + VF("\n=== Calibration Report: "); V(prefix); VLF(" ==="); + VLF("Dir | u_break | u_hold"); + VLF("-----+---------------------------------+---------------------------------"); + + auto printRow = [&](const char* dir, const DirectionData& data) { + VF(dir); VF(" | "); + VF("pct "); V(data.u_break); VF("%, v "); V(data.breakVel); VF(" steps/s, cnt "); V(data.breakCounts); VF(" | "); + VF("pct "); V(data.u_hold); VF("%, v "); V(data.holdVel); VF(" steps/s, cnt "); V(data.holdCounts); VL(""); + }; + + printRow("FWD", fwd); + printRow("REV", rev); + + float breakDeltaAbs = fabsf(fwd.u_break - rev.u_break); + float holdDeltaAbs = fabsf(rev.u_hold - fwd.u_hold); + + VF("Δ u_break: "); V(breakDeltaAbs); VF("%, "); + VF("Δ u_hold: "); V(holdDeltaAbs); VLF("%"); + + if (fwd.u_hold > 0.0f && rev.u_hold > 0.0f) { + float avgTracking = (fwd.u_hold + rev.u_hold) / 2.0f; + float holdImbalancePct = (avgTracking > 0.0f) + ? (fabsf(fwd.u_hold - rev.u_hold) / avgTracking * 100.0f) + : 0.0f; + + VF("u_hold imbalance vs avg: "); V(holdImbalancePct); VLF("%"); + + if (holdImbalancePct > SERVO_CALIBRATION_IMBALANCE_ERROR_THRESHOLD) { + VF("WARN: "); V(prefix); VF(" Imbalance: "); V(holdImbalancePct); VL("%"); + } + } + + if (fwd.u_hold >= SERVO_CALIBRATION_STOP_VELOCITY_PERCENT - 0.1f) VLF("WARN: FWD velocity at calibration limit"); + if (rev.u_hold >= SERVO_CALIBRATION_STOP_VELOCITY_PERCENT - 0.1f) VLF("WARN: REV velocity at calibration limit"); + + VF("=== End Report ===\n"); +} + +void ServoCalibrateTrackingVelocity::printReport() { + printReport(axisPrefix, fwdData, revData); +} + +void ServoCalibrateTrackingVelocity::resetCalibrationValues() { + fwdData = DirectionData(); + revData = DirectionData(); +} + +#endif // SERVO_MOTOR_PRESENT && CALIBRATE_SERVO_DC diff --git a/src/lib/axis/motor/servo/dc/calibration/TrackingVelocity.h b/src/lib/axis/motor/servo/dc/calibration/TrackingVelocity.h new file mode 100755 index 0000000..c1cf4e6 --- /dev/null +++ b/src/lib/axis/motor/servo/dc/calibration/TrackingVelocity.h @@ -0,0 +1,192 @@ +// ============================== TrackingVelocity.h ============================== +#pragma once + +#include +#include "../../../../../../Common.h" + +#if defined(SERVO_MOTOR_PRESENT) && defined(CALIBRATE_SERVO_DC) + +#include "../DcServoDriver.h" + +// ----------------------------------------------------------------------------- +// Axis selection mask: +// - Bit 0 -> Axis 1, Bit 1 -> Axis 2 (i.e., 1=Axis1, 2=Axis2, 3=both). +// - 0 also means all axes using SERVO_CAL_ALL_AXES_MASK +// ----------------------------------------------------------------------------- +#ifndef CALIBRATE_SERVO_AXIS_SELECT + #define CALIBRATE_SERVO_AXIS_SELECT 0 +#endif +// When CALIBRATE_SERVO_AXIS_SELECT==0, use it as both axes +#define SERVO_CAL_ALL_AXES_MASK 0x03 // bit0=axis1, bit1=axis2 + +// ----------------------------------------------------------------------------- +// Configuration constants (tuning and safety limits) +// All units are either percentages of PWM duty (for velocities) or milliseconds +// for timing, unless stated otherwise. +// ----------------------------------------------------------------------------- +#define SERVO_CALIBRATION_START_VELOCITY_PERCENT 2.5f // Initial staircase % for u_break (per direction) +#define SERVO_CALIBRATION_STOP_VELOCITY_PERCENT 12.0f // Safety cap for commanded % during tests +#define SERVO_CALIBRATION_STAIRCASE_STEP_PERCENT 0.1f // Step size for staircase up/down +#define SERVO_CALIBRATION_MOTOR_SETTLE_TIME 300 // ms to wait after STOP to remove transients +#define SERVO_CALIBRATION_VELOCITY_SETTLE_CHECK_INTERVAL 200 // ms between HOLD samples +#define SERVO_CALIBRATION_REQUIRED_MOVING_SAMPLES 1 // need this many consecutive moving samples to accept +#define SERVO_CALIBRATION_MIN_COUNTS_PER_SAMPLE 2L // min raw encoder/step counts per sample to accept "moving" (tune for encoder) +#define SERVO_CALIBRATION_MIN_DETECTABLE_VELOCITY 0.1f // steps/s—below this we treat as "not moving" +#define SERVO_CALIBRATION_REFINE_MAX_ITERATIONS 200 // Max steps per phase (u_break/u_hold) to avoid endless loops +#define SERVO_CALIBRATION_KICK_DURATION_MS 300 // ms to apply kick at u_break before HOLD +#define SERVO_CALIBRATION_IMBALANCE_ERROR_THRESHOLD 2.0f // % threshold (vs. avg) to warn about FWD/REV imbalance +#define SERVO_CALIBRATION_TIMEOUT 10000000 // ms guard for state timing (very generous) + +// ----------------------------------------------------------------------------- +// High-level calibration states (per-axis) +// ----------------------------------------------------------------------------- +enum CalibrationState { + CALIBRATION_IDLE, // Not running + CALIBRATION_U_BREAK, // Staircase upward to overcome stiction from rest + CALIBRATION_U_HOLD, // Staircase downward to find minimum % that sustains motion + CALIBRATION_CHECK_IMBALANCE, // Compute/report per-axis FWD/REV imbalance and snapshot data + CALIBRATION_WAIT_PEER, // Finished this axis; waiting for the other axis to finish (joint report) + CALIBRATION_WAIT_TURN // Both axes selected; wait here until it's this axis' turn to start +}; + +// ----------------------------------------------------------------------------- +// Motor sub-states (lifecycle around each test step) +// ----------------------------------------------------------------------------- +enum MotorState { + MOTOR_STOPPED, // At rest; used to delimit tests or indicate failure to move (after HOLD sample) + MOTOR_SETTLING, // Waiting for transients to decay after STOP/changes (enforced pause) + MOTOR_KICKING, // Brief kick at u_break to overcome stiction for u_hold tests + MOTOR_HOLDING, // Holding candidate % and sampling velocity periodically + MOTOR_RUNNING_STEADY // ACCEPTED MOVING (kept name for compatibility) +}; + +// ----------------------------------------------------------------------------- +// Calibrator class (per axis instance) +// ----------------------------------------------------------------------------- +class ServoCalibrateTrackingVelocity { +public: + // --------------------------------------------------------------------------- + // Per-direction compact record of results/telemetry for reporting + // --------------------------------------------------------------------------- + struct DirectionData { + float u_break = 0.0f; // % that first produced motion from rest (staircase up) + float u_hold = 0.0f; // % that minimally sustains motion (after kick; staircase down) + float breakVel = 0.0f; // measured steps/s at u_break + float holdVel = 0.0f; // measured steps/s at u_hold + long breakCounts= 0; // raw delta counts measured at u_break (for diagnostics) + long holdCounts = 0; // raw delta counts measured at u_hold (for diagnostics) + bool everMoved = false;// whether any motion was detected in this direction + }; + + // axisNumber is 1-based (1=RA, 2=DEC in common mounts) + ServoCalibrateTrackingVelocity(uint8_t axisNumber); + + // One-time per-run init: clears state, resets local accumulators + void init(); + + // Start the calibration sequence for this axis. + // - trackingFrequency: target sidereal steps/s reference (informational). + // - instrumentCoordinateSteps: current encoder/step count baseline (unused here, caller passes live counts in updateState). + void start(float trackingFrequency, long instrumentCoordinateSteps); + + // Drive the state machine; call frequently from the main control loop. + void updateState(long instrumentCoordinateSteps); + + // Readouts for the final tuned duty % values + float getU_break(bool forward); // forward=true -> FWD, false -> REV + float getU_hold(bool forward); // forward=true -> FWD, false -> REV + + // Exposed experiment flags/telemetry (read-only from outside in normal use) + bool experimentMode = false; // true while calibration is running + float experimentVelocity = 0.0f; // last commanded velocity % (signed) + bool enabled = false; // axis was selected and started + + // Reports + static void printReport(const char* axisPrefix, + const struct DirectionData& fwd, + const struct DirectionData& rev); + void printReport(); + +private: + // --------------------------- Phase handlers -------------------------------- + void handleMotorState(); // sub-state machine for settle/kick/hold + void processUBreak(); // staircase upward search + void processUHold(); // staircase downward refinement + void processImbalanceCheck(); // per-axis FWD/REV imbalance + joint sync/report + void handleCalibrationFailure(); // timeout/fault recovery + + // --------------------------- Utilities ------------------------------------- + float calculateInstantaneousVelocity(); // steps/s from delta counts/time + void startSettling(); // enter MOTOR_SETTLING and timestamp + void startTest(float velocityPercent); // begin a test step (kick/hold based on phase) + void setVelocity(float velocityPercent); // clamp+store experimentVelocity (signed %) + void resetCalibrationValues(); // clear DirectionData (FWD/REV) + void proceedToUHold(); // transition helper (after u_break success) + void finishUHold(); // transition helper (after u_hold completes) + void switchDirectionOrComplete(); // flip FWD↔REV or exit to imbalance stage + + // --------------------------- Helpers --------------------------------------- + DirectionData& currentDirectionData(); // FWD or REV ref (mutable) + const DirectionData& currentDirectionData() const; // FWD or REV ref (const) + void recordMovementData(float velocity, long counts); // write last measurement + void logTestResult(const char* phase, bool moved); // compact progress log + + // Queue the next test to start right after settling + void queueNextTest(CalibrationState st, float velocity) { + queuedState = st; + queuedVelocity = velocity; + hasQueuedTest = true; + } + + // --------------------------- Hardware/context ------------------------------ + ServoDcDriver* driver = nullptr; // optional driver hook if needed by platform + uint8_t axisNumber; // 1-based axis id + char axisPrefix[32]; // used in logs (e.g., "Axis1 ServoCalibration") + + // --------------------------- State ----------------------------------------- + CalibrationState calibrationState = CALIBRATION_IDLE; + MotorState motorState = MOTOR_STOPPED; + bool calibrationDirectionIsForward = true; // FWD=true, REV=false + int candidateSampleCount = 0; // samples taken in current HOLDING candidate (UB/UH) + + + // --------------------------- Timing/telemetry ------------------------------- + unsigned long currentTime = 0; + unsigned long lastStateChangeTime = 0; + unsigned long settleStartTime = 0; + unsigned long calibrationStepStartTime = 0; + unsigned long lastVelocityTime = 0; + unsigned long kickStartTime = 0; + + long currentTicks = 0; // caller-provided instrument steps + long calibrationStepStartTicks = 0; // ticks at the start of a test step + float lastVelocityMeasurement = 0.0f; // steps/s + + unsigned long steadySinceMs = 0; // time we accepted the candidate + long steadyStartTicks = 0; // ticks when we accepted the candidate + + long lastDeltaCounts = 0; // raw delta counts from last sample + + float calibrationVelocity = 0.0f; // signed % (positive FWD, negative REV) + float targetVelocity = 0.0f; // sidereal target (steps/s), informational + + // --------------------------- Results ---------------------------------------- + DirectionData fwdData; // accumulated forward-direction results + DirectionData revData; // accumulated reverse-direction results + + // --------------------------- Search bookkeeping ---------------------------- + int staircaseIters = 0; // steps taken within current phase + float currentSearchVelocity = 0.0f; // helper for proposed % values + bool foundValidMotion = false; // latched once motion is first observed + + long lastTicks = 0; // sample baseline + unsigned long lastCheckTime = 0; // sample timestamp + int consecutiveMovingSamples = 0; // counts consecutive moving samples for a candidate + + // --------------------------- Deferred start of next test -------------------- + bool hasQueuedTest = false; // true if next test is queued + CalibrationState queuedState = CALIBRATION_IDLE; // queued phase + float queuedVelocity = 0.0f; // queued signed % +}; + +#endif // SERVO_MOTOR_PRESENT && CALIBRATE_SERVO_DC diff --git a/src/lib/axis/motor/servo/dc/eE/EE.cpp b/src/lib/axis/motor/servo/dc/eE/EE.cpp new file mode 100755 index 0000000..946af1d --- /dev/null +++ b/src/lib/axis/motor/servo/dc/eE/EE.cpp @@ -0,0 +1,92 @@ +// ----------------------------------------------------------------------------------- +// axis servo DC EE motor driver + +#include "EE.h" + +#ifdef SERVO_EE_PRESENT + +#include "../../../../../gpioEx/GpioEx.h" +#include "../../../../../analog/Analog.h" + +ServoEE::ServoEE(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float pwmMinimum, float pwmMaximum) + :ServoDcDriver(axisNumber, Pins, Settings, pwmMinimum, pwmMaximum) { + if (axisNumber < 1 || axisNumber > 9) return; + + strcpy(axisPrefix, " Axis_ServoEE, "); + axisPrefix[5] = '0' + axisNumber; +} + +bool ServoEE::init(bool reverse) { +if (!ServoDcDriver::init(reverse)) return false; + + #if DEBUG == VERBOSE + VF("MSG:"); V(axisPrefix); + V("pins pwm1="); if (Pins->ph1 == OFF) VF("OFF"); else V(Pins->ph1); + V(", pwm2="); if (Pins->ph2 == OFF) VLF("OFF"); else VL(Pins->ph2); + #endif + + // init default driver control pins + pinModeEx(Pins->ph1, OUTPUT); + digitalWriteF(Pins->ph1, Pins->ph1State); // either ph1 or direction, state should default to inactive + pinModeEx(Pins->ph2, OUTPUT); + digitalWriteF(Pins->ph2, Pins->ph2State); // either ph2 or step (PWM,) state should default to inactive + + // set PWM range & frequency + AnalogPwmConfig scfg{}; + #ifdef SERVO_ANALOG_WRITE_FREQUENCY + scfg.hz = SERVO_ANALOG_WRITE_FREQUENCY; + #endif + #ifdef SERVO_ANALOG_WRITE_RANGE + scfg.range = SERVO_ANALOG_WRITE_RANGE; + #endif + if (!analog.pwmInit(Pins->ph1, scfg)) return false; + if (!analog.pwmInit(Pins->ph2, scfg)) return false; + + return true; +} + +// enable or disable the driver using the enable pin or other method +void ServoEE::enable(bool state) { + ServoDriver::enable(state); + + VF("MSG:"); V(axisPrefix); + if (!enabled) { + VF("EE outputs off"); + + // force both outputs inactive + analog.write(Pins->ph1, off1()); + analog.write(Pins->ph2, off2()); + + VLF(""); + } else { + VLF("EE enabled"); + } + + ServoDriver::updateStatus(); +} + +void ServoEE::pwmUpdate(float power01) { + if (!enabled) return; + + if (reversed) power01 = -power01; + float duty01 = fabsf(power01); + + if (power01 >= 0.0F) { + if (Pins->ph2State == HIGH) duty01 = 1.0F - duty01; + analog.write(Pins->ph1, off1()); + analog.write(Pins->ph2, duty01); + } else { + if (Pins->ph1State == HIGH) duty01 = 1.0F - duty01; + analog.write(Pins->ph1, duty01); + analog.write(Pins->ph2, off2()); + } +} + +// update status info. for driver +void ServoEE::updateStatus() { + if (statusMode == LOW || statusMode == HIGH) { + status.fault = digitalReadEx(faultPin) == statusMode; + } +} + +#endif diff --git a/src/lib/axis/motor/servo/dc/eE/EE.h b/src/lib/axis/motor/servo/dc/eE/EE.h new file mode 100755 index 0000000..828e1da --- /dev/null +++ b/src/lib/axis/motor/servo/dc/eE/EE.h @@ -0,0 +1,41 @@ +// ----------------------------------------------------------------------------------- +// axis servo DC EE motor driver +#pragma once + +#include +#include "../../../../../../Common.h" + +#ifdef SERVO_EE_PRESENT + +#include "../DcServoDriver.h" + +class ServoEE : public ServoDcDriver { + public: + // constructor + ServoEE(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float pwmMinimum, float pwmMaximum); + + // decodes driver model and sets up the pin modes + bool init(bool reverse); + + // enable or disable the driver using the enable pin or other method + void enable(bool state); + + // update status info. for driver + void updateStatus(); + + // get the driver name + const char* name() { + if (driverModel == SERVO_EE) return "DC Enable/Enable"; else + return "?"; + } + + private: + // motor control pwm update + // \param power01 in -1.0 to 1.0 units + void pwmUpdate(float power01) override; + + inline float off1() { return (Pins->ph1State == HIGH) ? 1.0F : 0.0F; } + inline float off2() { return (Pins->ph2State == HIGH) ? 1.0F : 0.0F; } +}; + +#endif diff --git a/src/lib/axis/motor/servo/dc/pE/PE.cpp b/src/lib/axis/motor/servo/dc/pE/PE.cpp new file mode 100755 index 0000000..53566d2 --- /dev/null +++ b/src/lib/axis/motor/servo/dc/pE/PE.cpp @@ -0,0 +1,95 @@ +// ----------------------------------------------------------------------------------- +// axis servo DC PE motor driver + +#include "PE.h" + +#ifdef SERVO_PE_PRESENT + +// for a Teensy4.1 you can have one additional PWM channel on a pin (for example pin 38) +// for example in Config.h: +// +// #define PWM_CUSTOM_PIN 38 +// #define PWM_CUSTOM_ANALOG_WRITE_RANGE 4095 +// #define PWM_CUSTOM_ANALOG_WRITE_FREQUENCY 10000 +// +// then use the AXISn_SERVO_PHn_PIN as you normally would (AXIS1_SERVO_PH2_PIN 38, for example) + +#include "../../../../../gpioEx/GpioEx.h" +#include "../../../../../analog/Analog.h" + +ServoPE::ServoPE(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float pwmMinimum, float pwmMaximum) + :ServoDcDriver(axisNumber, Pins, Settings, pwmMinimum, pwmMaximum) { + if (axisNumber < 1 || axisNumber > 9) return; + + strcpy(axisPrefix, " Axis_ServoPE, "); + axisPrefix[5] = '0' + axisNumber; +} + +bool ServoPE::init(bool reverse) { + if (!ServoDcDriver::init(reverse)) return false; + + #if DEBUG == VERBOSE + VF("MSG:"); V(axisPrefix); + V("pins dir="); if (Pins->ph1 == OFF) VF("OFF"); else V(Pins->ph1); + V(", pwm="); if (Pins->ph2 == OFF) VLF("OFF"); else VL(Pins->ph2); + #endif + + // init default driver control pins + pinModeEx(Pins->ph1, OUTPUT); + digitalWriteF(Pins->ph1, Pins->ph1State); // either ph1 or direction, state should default to inactive + pinModeEx(Pins->ph2, OUTPUT); + digitalWriteF(Pins->ph2, Pins->ph2State); // either ph2 or step (PWM,) state should default to inactive + + // set PWM range & frequency + AnalogPwmConfig scfg{}; + #ifdef SERVO_ANALOG_WRITE_FREQUENCY + scfg.hz = SERVO_ANALOG_WRITE_FREQUENCY; + #endif + #ifdef SERVO_ANALOG_WRITE_RANGE + scfg.range = SERVO_ANALOG_WRITE_RANGE; + #endif + if (!analog.pwmInit(Pins->ph2, scfg)) return false; + + return true; +} + +// enable or disable the driver using the enable pin or other method +void ServoPE::enable(bool state) { + ServoDriver::enable(state); + + VF("MSG:"); V(axisPrefix); + if (!enabled) { + VF("PE outputs off"); + + // force outputs inactive + digitalWriteF(Pins->ph1, Pins->ph1State); + analog.write(Pins->ph2, off2()); + + VLF(""); + } else { + VLF("PE enabled"); + } + + ServoDriver::updateStatus(); +} + +void ServoPE::pwmUpdate(float power01) { + if (!enabled) return; + + if (reversed) power01 = -power01; + float duty01 = fabsf(power01); + + digitalWriteF(Pins->ph1, power01 >= 0.0F ? Pins->ph1State : !Pins->ph1State); + + if (Pins->ph2State == HIGH) duty01 = 1.0F - duty01; + analog.write(Pins->ph2, duty01); +} + +// update status info. for driver +void ServoPE::updateStatus() { + if (statusMode == LOW || statusMode == HIGH) { + status.fault = digitalReadEx(faultPin) == statusMode; + } +} + +#endif diff --git a/src/lib/axis/motor/servo/dc/pE/PE.h b/src/lib/axis/motor/servo/dc/pE/PE.h new file mode 100755 index 0000000..0be4ebc --- /dev/null +++ b/src/lib/axis/motor/servo/dc/pE/PE.h @@ -0,0 +1,40 @@ +// ----------------------------------------------------------------------------------- +// axis servo DC motor driver +#pragma once + +#include +#include "../../../../../../Common.h" + +#ifdef SERVO_PE_PRESENT + +#include "../DcServoDriver.h" + +class ServoPE : public ServoDcDriver { + public: + // constructor + ServoPE(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float pwmMinimum, float pwmMaximum); + + // decodes driver model and sets up the pin modes + bool init(bool reverse); + + // enable or disable the driver using the enable pin or other method + void enable(bool state); + + // update status info. for driver + void updateStatus(); + + // get the driver name + const char* name() { + if (driverModel == SERVO_PE) return "DC Phase/Enable" ; else + return "?"; + } + + private: + // motor control pwm update + // \param power01 -1.0 to 1.0 + void pwmUpdate(float power01) override; + + inline float off2() { return (Pins->ph2State == HIGH) ? 1.0F : 0.0F; } +}; + +#endif diff --git a/src/lib/axis/motor/servo/dc/tmc/tmc2130/Tmc2130.cpp b/src/lib/axis/motor/servo/dc/tmc/tmc2130/Tmc2130.cpp new file mode 100755 index 0000000..6d3ed84 --- /dev/null +++ b/src/lib/axis/motor/servo/dc/tmc/tmc2130/Tmc2130.cpp @@ -0,0 +1,103 @@ +// ----------------------------------------------------------------------------------- +// axis servo TMC2130 DC motor driver + +#include "Tmc2130.h" + +#ifdef SERVO_TMC2130_DC_PRESENT + +#include "../../../../../tasks/OnTask.h" +#include "../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +ServoTmc2130DC::ServoTmc2130DC(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float pwmMinimum, float pwmMaximum) + :ServoDcDriver(axisNumber, Pins, Settings, pwmMinimum, pwmMaximum) { + if (axisNumber < 1 || axisNumber > 9) return; + + strcpy(axisPrefix, " Axis_ServoTmc2130DC, "); + axisPrefix[5] = '0' + axisNumber; +} + +bool ServoTmc2130DC::init(bool reverse) { + if (!ServoDcDriver::init(reverse)) return false; + + // get TMC SPI driver ready + pinModeEx(Pins->ph1, OUTPUT); // step + pinModeEx(Pins->ph2, OUTPUT); // dir + + // set S/D motion pins to known, fixed state + digitalWriteEx(Pins->ph1, LOW); // step + digitalWriteEx(Pins->ph2, LOW); // dir + + VF("MSG:"); V(axisPrefix); VLF("TMC current control at max (IHOLD, IRUN, and IGOTO ignored)"); + + driver = new TMC2130Stepper(Pins->cs, Pins->mosi, Pins->miso, Pins->sck); + driver->begin(); + driver->direct_mode(true); + driver->en_pwm_mode(true); + driver->pwm_autoscale(false); + driver->pwm_ampl(255); + driver->pwm_grad(4); + driver->ihold(0); + driver->irun(31); + driver->toff(5); + + driver->XDIRECT((uint32_t)(lround(0) & 0b111111111)); + + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + #ifndef DRIVER_TMC_STEPPER_HW_SPI + if (Pins->miso != OFF) + #endif + { + readStatus(); + if (!status.standstill || status.overTemperature) { DF("ERR:"); D(axisPrefix); DLF("no driver detected!"); return false; } + } + #endif + + return true; +} + +// enable or disable the driver using the enable pin or other method +void ServoTmc2130DC::enable(bool state) { + ServoDriver::enable(state); + + VF("MSG:"); V(axisPrefix); VF("powered "); if (state) { VF("up"); } else { VF("down"); } VLF(" using SPI"); + + if (state) { driver->ihold(31); } else { driver->ihold(0); } + + ServoDriver::updateStatus(); +} + +void ServoTmc2130DC::pwmUpdate(float power01) { + + // signed 9-bit value: -255..+255 (avoid -256) + int32_t power = (int32_t)lroundf(power01 * 255.0F); + if (power > 255) power = 255; else + if (power < -255) power = -255; + + if (reversed) power = -power; + + driver->XDIRECT((uint32_t)(power & 0x1FF)); // 9-bit two's complement +} + +void ServoTmc2130DC::readStatus() { + TMC2130_n::DRV_STATUS_t status_result; + status_result.sr = 0; + + status_result.sr = driver->DRV_STATUS(); + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = false; + status.outputB.openLoad = false; + status.overTemperatureWarning= status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +#endif diff --git a/src/lib/axis/motor/servo/dc/tmc/tmc2130/Tmc2130.h b/src/lib/axis/motor/servo/dc/tmc/tmc2130/Tmc2130.h new file mode 100755 index 0000000..f4b704a --- /dev/null +++ b/src/lib/axis/motor/servo/dc/tmc/tmc2130/Tmc2130.h @@ -0,0 +1,39 @@ +// ----------------------------------------------------------------------------------- +// axis servo TMC2130 DC motor driver +#pragma once + +#include +#include "../../../../../../../Common.h" + +#ifdef SERVO_TMC2130_DC_PRESENT + +#include "../../DcServoDriver.h" + +#include // https://github.com/teemuatlut/TMCStepper + +class ServoTmc2130DC : public ServoDcDriver { + public: + // constructor + ServoTmc2130DC(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float pwmMinimum, float pwmMaximum); + + // decodes driver model and sets up the pin modes + bool init(bool reverse); + + // enable or disable the driver using the enable pin or other method + void enable(bool state); + + // get the driver name + const char* name() { return "DC TMC2130 (SPI)"; } + + private: + // motor control pwm update + // \param power01 in -1.0 to 1.0 units + void pwmUpdate(float power01); + + // read status info. from driver + void readStatus(); + + TMC2130Stepper *driver; +}; + +#endif diff --git a/src/lib/axis/motor/servo/dc/tmc/tmc5160/Tmc5160.cpp b/src/lib/axis/motor/servo/dc/tmc/tmc5160/Tmc5160.cpp new file mode 100755 index 0000000..bf32917 --- /dev/null +++ b/src/lib/axis/motor/servo/dc/tmc/tmc5160/Tmc5160.cpp @@ -0,0 +1,103 @@ +// ----------------------------------------------------------------------------------- +// axis servo TMC5160 DC motor driver + +#include "Tmc5160.h" + +#ifdef SERVO_TMC5160_DC_PRESENT + +#include "../../../../../tasks/OnTask.h" +#include "../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +ServoTmc5160DC::ServoTmc5160DC(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float pwmMinimum, float pwmMaximum) + :ServoDcDriver(axisNumber, Pins, Settings, pwmMinimum, pwmMaximum) { + if (axisNumber < 1 || axisNumber > 9) return; + + strcpy(axisPrefix, " Axis_ServoTmc5160DC, "); + axisPrefix[5] = '0' + axisNumber; + } + +bool ServoTmc5160DC::init(bool reverse) { + if (!ServoDcDriver::init(reverse)) return false; + + // get TMC SPI driver ready + pinModeEx(Pins->ph1, OUTPUT); // step + pinModeEx(Pins->ph2, OUTPUT); // dir + + // set S/D motion pins to known, fixed state + digitalWriteEx(Pins->ph1, LOW); // step + digitalWriteEx(Pins->ph2, LOW); // dir + + VF("MSG:"); V(axisPrefix); VLF("TMC current control at max (IHOLD, IRUN, and IGOTO ignored)"); + + driver = new TMC5160Stepper(Pins->cs, Pins->mosi, Pins->miso, Pins->sck); + driver->begin(); + driver->direct_mode(true); + driver->en_pwm_mode(true); + driver->pwm_autoscale(false); + driver->pwm_ofs(255); + driver->pwm_grad(4); + driver->ihold(0); + driver->irun(31); + driver->toff(5); + + driver->XTARGET((uint32_t)(lround(0) & 0b111111111)); + + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + #ifndef DRIVER_TMC_STEPPER_HW_SPI + if (Pins->miso != OFF) + #endif + { + readStatus(); + if (!status.standstill || status.overTemperature) { DF("ERR:"); D(axisPrefix); DLF("no driver detected!"); return false; } + } + #endif + + return true; +} + +// enable or disable the driver using the enable pin or other method +void ServoTmc5160DC::enable(bool state) { + ServoDriver::enable(state); + + VF("MSG:"); V(axisPrefix); VF("powered "); if (state) { VF("up"); } else { VF("down"); } VLF(" using SPI"); + + if (state) { driver->ihold(31); } else { driver->ihold(0); } + + ServoDriver::updateStatus(); +} + +void ServoTmc5160DC::pwmUpdate(float power01) { + + // signed 9-bit value: -255..+255 + int32_t power = (int32_t)lroundf(power01 * 255.0F); + if (power > 255) power = 255; else + if (power < -255) power = -255; + if (reversed) power = -power; + + driver->XTARGET((uint32_t)(power & 0x1FF)); // 9-bit two's complement +} + +// read status info. from driver +void ServoTmc5160DC::readStatus() { + TMC2130_n::DRV_STATUS_t status_result; + status_result.sr = 0; + + status_result.sr = driver->DRV_STATUS(); + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = false; + status.outputB.openLoad = false; + status.overTemperatureWarning= status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +#endif diff --git a/src/lib/axis/motor/servo/dc/tmc/tmc5160/Tmc5160.h b/src/lib/axis/motor/servo/dc/tmc/tmc5160/Tmc5160.h new file mode 100755 index 0000000..94280fd --- /dev/null +++ b/src/lib/axis/motor/servo/dc/tmc/tmc5160/Tmc5160.h @@ -0,0 +1,39 @@ +// ----------------------------------------------------------------------------------- +// axis servo TMC5160 DC motor driver +#pragma once + +#include +#include "../../../../../../../Common.h" + +#ifdef SERVO_TMC5160_DC_PRESENT + +#include "../../DcServoDriver.h" + +#include // https://github.com/teemuatlut/TMCStepper + +class ServoTmc5160DC : public ServoDcDriver { + public: + // constructor + ServoTmc5160DC(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float pwmMinimum, float pwmMaximum); + + // decodes driver model and sets up the pin modes + bool init(bool reverse); + + // enable or disable the driver using the enable pin or other method + void enable(bool state); + + // get the driver name + const char* name() {return "DC TMC5160 (SPI)"; } + + private: + // motor control pwm update + // \param power01 in -1.0 to 1.0 units + void pwmUpdate(float power01); + + // read status info. from driver + void readStatus(); + + TMC5160Stepper *driver; +}; + +#endif diff --git a/src/lib/axis/motor/servo/feedback/DualPid/DualPid.cpp b/src/lib/axis/motor/servo/feedback/DualPid/DualPid.cpp new file mode 100755 index 0000000..d9d1dfa --- /dev/null +++ b/src/lib/axis/motor/servo/feedback/DualPid/DualPid.cpp @@ -0,0 +1,118 @@ +// ----------------------------------------------------------------------------------- +// servo motor PID feedback + +#include "DualPid.h" + +#ifdef SERVO_MOTOR_PRESENT + +#if AXIS1_SERVO_FEEDBACK == DUAL_PID || AXIS2_SERVO_FEEDBACK == DUAL_PID || AXIS3_SERVO_FEEDBACK == DUAL_PID || \ + AXIS4_SERVO_FEEDBACK == DUAL_PID || AXIS5_SERVO_FEEDBACK == DUAL_PID || AXIS6_SERVO_FEEDBACK == DUAL_PID || \ + AXIS7_SERVO_FEEDBACK == DUAL_PID || AXIS8_SERVO_FEEDBACK == DUAL_PID || AXIS9_SERVO_FEEDBACK == DUAL_PID + +DualPid::DualPid(const float P, const float I, const float D, const float P_goto, const float I_goto, const float D_goto, const float sensitivity) { + trackingP.valueDefault = P; + trackingI.valueDefault = I; + trackingD.valueDefault = D; + + slewingP.valueDefault = P_goto; + slewingI.valueDefault = I_goto; + slewingD.valueDefault = D_goto; + + manuallySwitchParameters = (sensitivity == 0); + if (manuallySwitchParameters) this->sensitivity = 100; else this->sensitivity = sensitivity; +} + +// initialize PID control and parameters +void DualPid::init(uint8_t axisNumber, ServoControl *control) { + if (ready) return; + + Feedback::init(axisNumber, control); + + axisPrefix[5] = '0' + axisNumber; + + VF("MSG:"); V(axisPrefix); if (manuallySwitchParameters) { VL("using manual parameter switching"); } else { VL("using auto parameter scaling"); } + + pid = new QuickPID(&control->in, &control->out, &control->set, + 0, 0, 0, + QuickPID::pMode::PID_PMODE, QuickPID::dMode::PID_DMODE, QuickPID::iAwMode::PID_IMODE, + QuickPID::Action::direct); + pid->SetSampleTimeUs(PID_SAMPLE_TIME_US); + pid->Initialize(); + pid->SetMode(QuickPID::Control::automatic); +} + +// reset feedback control and parameters +void DualPid::reset() { + if (!ready) return; + + VF("MSG:"); V(axisPrefix); VLF("reset"); + control->in = 0; + control->set = 0; + control->out = 0; + trackingSelected = false; + selectTrackingParameters(); +} + +void DualPid::setControlDirection(int8_t state) { + if (!ready) return; + + if (state == ON) pid->SetControllerDirection(QuickPID::Action::reverse); else pid->SetControllerDirection(QuickPID::Action::direct); +} + +void DualPid::setControlRange(float controlRange) { + if (!ready) return; + + VF("MSG:"); V(axisPrefix); VF("setting feedback range +/-"); VL(controlRange); + pid->SetOutputLimits(-controlRange, controlRange); +} + +// select PID param set for tracking +void DualPid::selectTrackingParameters() { + if (!trackingSelected) { + VF("MSG:"); V(axisPrefix); VL("tracking selected"); + trackingSelected = true; + parameterSelectPercent = 0; + pid->Reset(); + pid->SetTunings(trackingP.value, trackingI.value, trackingD.value); + lastP = trackingP.value; + lastI = trackingI.value; + lastD = trackingD.value; + } +} + +// select PID param set for slewing +void DualPid::selectSlewingParameters() { + if (trackingSelected) { + VF("MSG:"); V(axisPrefix); VL("slewing selected"); + trackingSelected = false; + parameterSelectPercent = 100; + pid->Reset(); + pid->SetTunings(slewingP.value, slewingI.value, slewingD.value); + lastP = slewingP.value; + lastI = slewingI.value; + lastD = slewingD.value; + } +} + +// manage feedback, variable PID params +void DualPid::variableParameters(float percent) { + float s = percent/sensitivity; + if (s < 0.0F) s = 0.0F; + if (s > 1.0F) s = 1.0F; + float p = trackingP.value + (slewingP.value - trackingP.value)*s; + float i = trackingI.value + (slewingI.value - trackingI.value)*s; + float d = trackingD.value + (slewingD.value - trackingD.value)*s; + if (lastP != p || lastI != i || lastD != d) { +// VF("MSG:"); V(axisPrefix); +// V("variable parameters"); +// V(" P="); V(p); V(", I="); V(i); V(", D="); VL(d); + pid->SetTunings(p, i, d); + lastP = p; + lastI = i; + lastD = d; + } +} + +#endif + +#endif diff --git a/src/lib/axis/motor/servo/feedback/DualPid/DualPid.h b/src/lib/axis/motor/servo/feedback/DualPid/DualPid.h new file mode 100755 index 0000000..ab2a171 --- /dev/null +++ b/src/lib/axis/motor/servo/feedback/DualPid/DualPid.h @@ -0,0 +1,107 @@ +// ----------------------------------------------------------------------------------- +// servo motor PID feedback +#pragma once + +#include "../FeedbackBase.h" + +#ifdef SERVO_MOTOR_PRESENT + +#if AXIS1_SERVO_FEEDBACK == DUAL_PID || AXIS2_SERVO_FEEDBACK == DUAL_PID || AXIS3_SERVO_FEEDBACK == DUAL_PID || \ + AXIS4_SERVO_FEEDBACK == DUAL_PID || AXIS5_SERVO_FEEDBACK == DUAL_PID || AXIS6_SERVO_FEEDBACK == DUAL_PID || \ + AXIS7_SERVO_FEEDBACK == DUAL_PID || AXIS8_SERVO_FEEDBACK == DUAL_PID || AXIS9_SERVO_FEEDBACK == DUAL_PID + +#include // https://github.com/Dlloydev/QuickPID + +// various options for QuickPID read about them here https://github.com/Dlloydev/QuickPID +#ifndef PID_SLEWING_TO_TRACKING_TIME_MS + #define PID_SLEWING_TO_TRACKING_TIME_MS 1000 // time to switch from PID slewing to tracking parameters in milliseconds +#endif +#ifndef PID_SAMPLE_TIME_US + #define PID_SAMPLE_TIME_US 10000 // PID sample time in microseconds (defaults to 10 milliseconds) +#endif +#ifndef PID_PMODE + #define PID_PMODE pOnError // http://brettbeauregard.com/blog/2017/06/introducing-proportional-on-measurement/ +#endif +#ifndef PID_IMODE + #define PID_IMODE iAwCondition +#endif +#ifndef PID_DMODE + #define PID_DMODE dOnMeas +#endif + +class DualPid : public Feedback { + public: + DualPid(const float P, const float I, const float D, const float P_goto, const float I_goto, const float D_goto, const float sensitivity = 0); + + // initialize PID control and parameters + void init(uint8_t axisNumber, ServoControl *control); + + // reset feedback control and parameters + void reset(); + + // returns the number of axis parameters + uint8_t getParameterCount() { return numParameters; } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { if (number > numParameters) return &invalid; else return parameter[number]; } + + // set feedback control direction + void setControlDirection(int8_t state); + + // set feedback control range + void setControlRange(float controlRange); + + // select PID param set for tracking + void selectTrackingParameters(); + + // select PID param set for slewing + void selectSlewingParameters(); + + // variable feedback, variable PID params + void variableParameters(float percent); + + inline void poll() { + pid->Compute(); + + if (manuallySwitchParameters) { + if ((long)(millis() - nextSelectIncrementTime) > 0) { + if (trackingSelected) parameterSelectPercent--; + if (parameterSelectPercent < 0) parameterSelectPercent = 0; + variableParameters(parameterSelectPercent); + nextSelectIncrementTime = millis() + round(PID_SLEWING_TO_TRACKING_TIME_MS/100.0F); + } + } + } + + private: + QuickPID *pid; + + char axisPrefix[26] = " Axis_ServoFeedbackDPID, "; // prefix for debug messages + + float sensitivity; + float lastP = 0; + float lastI = 0; + float lastD = 0; + + unsigned long timeSinceLastUpdate = 0; // for varaible pid update + + int parameterSelectPercent = 0; + bool trackingSelected = true; + unsigned long nextSelectIncrementTime = 0; + + // runtime adjustable settings + AxisParameter trackingP = {NAN, NAN, NAN, 0.0, 10000.0, AXP_FLOAT_IMMEDIATE, AXPN_PID_P}; + AxisParameter trackingI = {NAN, NAN, NAN, 0.0, 10000.0, AXP_FLOAT_IMMEDIATE, AXPN_PID_I}; + AxisParameter trackingD = {NAN, NAN, NAN, 0.0, 10000.0, AXP_FLOAT_IMMEDIATE, AXPN_PID_D}; + + AxisParameter slewingP = {NAN, NAN, NAN, 0.0, 10000.0, AXP_FLOAT_IMMEDIATE, AXPN_PID_SLEWING_P}; + AxisParameter slewingI = {NAN, NAN, NAN, 0.0, 10000.0, AXP_FLOAT_IMMEDIATE, AXPN_PID_SLEWING_I}; + AxisParameter slewingD = {NAN, NAN, NAN, 0.0, 10000.0, AXP_FLOAT_IMMEDIATE, AXPN_PID_SLEWING_D}; + + const int numParameters = 6; + AxisParameter* parameter[7] = {&invalid, &trackingP, &trackingI, &trackingD, &slewingP, &slewingI, &slewingD}; +}; + +#endif + +#endif diff --git a/src/lib/axis/motor/servo/feedback/Feedback.h b/src/lib/axis/motor/servo/feedback/Feedback.h new file mode 100755 index 0000000..38ef59d --- /dev/null +++ b/src/lib/axis/motor/servo/feedback/Feedback.h @@ -0,0 +1,5 @@ +// ----------------------------------------------------------------------------------- +// servo motor feedback +#pragma once + +#include "DualPid/DualPid.h" diff --git a/src/lib/axis/motor/servo/feedback/FeedbackBase.cpp b/src/lib/axis/motor/servo/feedback/FeedbackBase.cpp new file mode 100755 index 0000000..813209c --- /dev/null +++ b/src/lib/axis/motor/servo/feedback/FeedbackBase.cpp @@ -0,0 +1,19 @@ +// ----------------------------------------------------------------------------------- +// servo motor feedback + +#include "FeedbackBase.h" + +#ifdef SERVO_MOTOR_PRESENT + +// initialize feedback control and parameters +void Feedback::init(uint8_t axisNumber, ServoControl *control) { + this->axisNumber = axisNumber; + + this->control = control; + control->in = 0; + control->set = 0; + + ready = true; +} + +#endif \ No newline at end of file diff --git a/src/lib/axis/motor/servo/feedback/FeedbackBase.h b/src/lib/axis/motor/servo/feedback/FeedbackBase.h new file mode 100755 index 0000000..90e24ab --- /dev/null +++ b/src/lib/axis/motor/servo/feedback/FeedbackBase.h @@ -0,0 +1,90 @@ +// ----------------------------------------------------------------------------------- +// servo motor feedback +#pragma once +#include "../../../../../Common.h" + +#ifdef SERVO_MOTOR_PRESENT + +#include "../../Drivers.h" + +#ifndef AXIS1_SERVO_FEEDBACK + #define AXIS1_SERVO_FEEDBACK DUAL_PID +#endif +#ifndef AXIS2_SERVO_FEEDBACK + #define AXIS2_SERVO_FEEDBACK DUAL_PID +#endif +#ifndef AXIS3_SERVO_FEEDBACK + #define AXIS3_SERVO_FEEDBACK DUAL_PID +#endif +#ifndef AXIS4_SERVO_FEEDBACK + #define AXIS4_SERVO_FEEDBACK DUAL_PID +#endif +#ifndef AXIS5_SERVO_FEEDBACK + #define AXIS5_SERVO_FEEDBACK DUAL_PID +#endif +#ifndef AXIS6_SERVO_FEEDBACK + #define AXIS6_SERVO_FEEDBACK DUAL_PID +#endif +#ifndef AXIS7_SERVO_FEEDBACK + #define AXIS7_SERVO_FEEDBACK DUAL_PID +#endif +#ifndef AXIS8_SERVO_FEEDBACK + #define AXIS8_SERVO_FEEDBACK DUAL_PID +#endif +#ifndef AXIS9_SERVO_FEEDBACK + #define AXIS9_SERVO_FEEDBACK DUAL_PID +#endif + +typedef struct ServoControl { + float in; + float out; + float set; + volatile int8_t directionHint; +} ServoControl; + +class Feedback { + public: + // initialize feedback control and parameters + virtual void init(uint8_t axisNumber, ServoControl *control); + + // reset feedback control and parameters + virtual void reset(); + + // returns the number of axis parameters + virtual uint8_t getParameterCount() { return 0; } + + // returns the specified axis parameter + virtual AxisParameter* getParameter(uint8_t number) { return &invalid; } + + // select feedback PID param set for tracking + virtual void selectTrackingParameters(); + + // select feedback PID param set for slewing + virtual void selectSlewingParameters(); + + // variable feedback PID params + virtual void variableParameters(float percent); + + // set feedback control direction + virtual void setControlDirection(int8_t state); + + // set feedback control range controlRange, +/- the maximum encoder counts/s + virtual void setControlRange(float controlRange); + + virtual void poll(); + + bool manuallySwitchParameters = true; + + // true if the feedback instance is ready to use + bool ready = false; + + protected: + uint8_t axisNumber = 0; + + ServoControl *control; + + // runtime adjustable settings + AxisParameter invalid = {NAN, NAN, NAN, NAN, NAN, AXP_INVALID, ""}; +}; + +#endif \ No newline at end of file diff --git a/src/lib/axis/motor/servo/feedback/Pid/Pid.cpp b/src/lib/axis/motor/servo/feedback/Pid/Pid.cpp new file mode 100755 index 0000000..92b247c --- /dev/null +++ b/src/lib/axis/motor/servo/feedback/Pid/Pid.cpp @@ -0,0 +1,81 @@ +// ----------------------------------------------------------------------------------- +// servo motor PID feedback + +#include "Pid.h" + +#ifdef SERVO_MOTOR_PRESENT + +#if AXIS1_SERVO_FEEDBACK == PID || AXIS2_SERVO_FEEDBACK == PID || AXIS3_SERVO_FEEDBACK == PID || \ + AXIS4_SERVO_FEEDBACK == PID || AXIS5_SERVO_FEEDBACK == PID || AXIS6_SERVO_FEEDBACK == PID || \ + AXIS7_SERVO_FEEDBACK == PID || AXIS8_SERVO_FEEDBACK == PID || AXIS9_SERVO_FEEDBACK == PID + +Pid::Pid(const float P, const float I, const float D) { + trackingP.valueDefault = P; + trackingI.valueDefault = I; + trackingD.valueDefault = D; +} + +// initialize PID control and parameters +void DualPid::init(uint8_t axisNumber, ServoControl *control) { + if (ready) return; + + Feedback::init(axisNumber, control); + + axisPrefix[5] = '0' + axisNumber; + + pid = new QuickPID(&control->in, &control->out, &control->set, + 0, 0, 0, + QuickPID::pMode::PID_PMODE, QuickPID::dMode::PID_DMODE, QuickPID::iAwMode::PID_IMODE, + QuickPID::Action::direct); + pid->SetSampleTimeUs(PID_SAMPLE_TIME_US); + pid->Initialize(); + pid->SetMode(QuickPID::Control::automatic); +} + +// reset feedback control and parameters +void Pid::reset() { + VF("MSG:"); V(axisPrefix); VLF("reset"); + control->in = 0; + control->set = 0; + control->out = 0; + trackingSelected = false; + selectTrackingParameters(); +} + +void DualPid::setControlDirection(int8_t state) { + if (state == ON) pid->SetControllerDirection(QuickPID::Action::reverse); else pid->SetControllerDirection(QuickPID::Action::direct); +} + +void Pid::setControlRange(float controlRange) { + VF("MSG:"); V(axisPrefix); VF("setting feedback range +/-"); VL(controlRange); + pid->SetOutputLimits(-controlRange, controlRange); +} + +// select PID param set for tracking +void Pid::selectTrackingParameters() { + if (!trackingSelected) { + VF("MSG:"); V(axisPrefix); VL("tracking selected"); + trackingSelected = true; + pid->Reset(); + pid->SetTunings(P.value, I.value, D.value); + } +} + +// select PID param set for slewing +void Pid::selectSlewingParameters() { + if (trackingSelected) { + VF("MSG:"); V(axisPrefix); VL("slewing selected"); + trackingSelected = false; + pid->Reset(); + pid->SetTunings(P.value, I.value, D.value); + } +} + +// variable PID params isn't used +void Pid::variableParameters(float percent) { + UNUSED(percent); +} + +#endif + +#endif diff --git a/src/lib/axis/motor/servo/feedback/Pid/Pid.h b/src/lib/axis/motor/servo/feedback/Pid/Pid.h new file mode 100755 index 0000000..dd937ae --- /dev/null +++ b/src/lib/axis/motor/servo/feedback/Pid/Pid.h @@ -0,0 +1,80 @@ +// ----------------------------------------------------------------------------------- +// servo motor PID feedback +#pragma once + +#include "../FeedbackBase.h" + +#ifdef SERVO_MOTOR_PRESENT + +#if AXIS1_SERVO_FEEDBACK == PID || AXIS2_SERVO_FEEDBACK == PID || AXIS3_SERVO_FEEDBACK == PID || \ + AXIS4_SERVO_FEEDBACK == PID || AXIS5_SERVO_FEEDBACK == PID || AXIS6_SERVO_FEEDBACK == PID || \ + AXIS7_SERVO_FEEDBACK == PID || AXIS8_SERVO_FEEDBACK == PID || AXIS9_SERVO_FEEDBACK == PID + +#include // https://github.com/Dlloydev/QuickPID + +// various options for QuickPID read about them here https://github.com/Dlloydev/QuickPID +#ifndef PID_SAMPLE_TIME_US + #define PID_SAMPLE_TIME_US 10000 // PID sample time in microseconds (defaults to 10 milliseconds) +#endif +#ifndef PID_PMODE + #define PID_PMODE pOnError // http://brettbeauregard.com/blog/2017/06/introducing-proportional-on-measurement/ +#endif +#ifndef PID_IMODE + #define PID_IMODE iAwCondition +#endif +#ifndef PID_DMODE + #define PID_DMODE dOnMeas +#endif + +class Pid : public Feedback { + public: + Pid(const float P, const float I, const float D); + + // initialize PID control and parameters + void init(uint8_t axisNumber, ServoControl *control); + + // reset feedback control and parameters + void reset(); + + // returns the number of axis parameters + uint8_t getParameterCount() { return numParameters; } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { if (number > numParameters) return &invalid; else return parameter[number]; } + + // set feedback control direction + void setControlDirection(int8_t state); + + // set feedback control range + void setControlRange(float controlRange); + + // select PID param set for tracking + void selectTrackingParameters(); + + // select PID param set for slewing + void selectSlewingParameters(); + + // variable feedback, variable PID params + void variableParameters(float percent); + + inline void poll() { } + + private: + QuickPID *pid; + + char axisPrefix[26] = " Axis_ServoFeedbackPID, "; // prefix for debug messages + + bool trackingSelected = true; + + // runtime adjustable settings + AxisParameter P = {NAN, NAN, NAN, 0.0, 10000.0, AXP_FLOAT_IMMEDIATE, "P"}; + AxisParameter I = {NAN, NAN, NAN, 0.0, 10000.0, AXP_FLOAT_IMMEDIATE, "I"}; + AxisParameter D = {NAN, NAN, NAN, 0.0, 10000.0, AXP_FLOAT_IMMEDIATE, "D"}; + + const int numParameters = 3; + AxisParameter* parameter[4] = {&invalid, &P, &I, &D}; +}; + +#endif + +#endif diff --git a/src/lib/axis/motor/servo/filter/Filter.h b/src/lib/axis/motor/servo/filter/Filter.h new file mode 100755 index 0000000..9f36502 --- /dev/null +++ b/src/lib/axis/motor/servo/filter/Filter.h @@ -0,0 +1,7 @@ +// ----------------------------------------------------------------------------------- +// servo filter +#pragma once + +#include "Kalman/Kalman.h" +#include "Learning/Learning.h" +#include "Rolling/Rolling.h" diff --git a/src/lib/axis/motor/servo/filter/FilterBase.cpp b/src/lib/axis/motor/servo/filter/FilterBase.cpp new file mode 100755 index 0000000..08304a4 --- /dev/null +++ b/src/lib/axis/motor/servo/filter/FilterBase.cpp @@ -0,0 +1,4 @@ +// ----------------------------------------------------------------------------------- +// servo filter + +#include "FilterBase.h" diff --git a/src/lib/axis/motor/servo/filter/FilterBase.h b/src/lib/axis/motor/servo/filter/FilterBase.h new file mode 100755 index 0000000..9823c2b --- /dev/null +++ b/src/lib/axis/motor/servo/filter/FilterBase.h @@ -0,0 +1,41 @@ +// ----------------------------------------------------------------------------------- +// servo filter +#pragma once + +#include "../../../../../Common.h" + +#ifndef AXIS1_SERVO_FLTR + #define AXIS1_SERVO_FLTR OFF +#endif +#ifndef AXIS2_SERVO_FLTR + #define AXIS2_SERVO_FLTR OFF +#endif +#ifndef AXIS3_SERVO_FLTR + #define AXIS3_SERVO_FLTR OFF +#endif +#ifndef AXIS4_SERVO_FLTR + #define AXIS4_SERVO_FLTR OFF +#endif +#ifndef AXIS5_SERVO_FLTR + #define AXIS5_SERVO_FLTR OFF +#endif +#ifndef AXIS6_SERVO_FLTR + #define AXIS6_SERVO_FLTR OFF +#endif +#ifndef AXIS7_SERVO_FLTR + #define AXIS7_SERVO_FLTR OFF +#endif +#ifndef AXIS8_SERVO_FLTR + #define AXIS8_SERVO_FLTR OFF +#endif +#ifndef AXIS9_SERVO_FLTR + #define AXIS9_SERVO_FLTR OFF +#endif + +class Filter { + public: + virtual long update(long encoderCounts, long motorCounts, bool isTracking) { UNUSED(motorCounts); UNUSED(isTracking); return encoderCounts; } + + private: + bool initialized = false; +}; diff --git a/src/lib/axis/motor/servo/filter/Kalman/Kalman.cpp b/src/lib/axis/motor/servo/filter/Kalman/Kalman.cpp new file mode 100755 index 0000000..769430c --- /dev/null +++ b/src/lib/axis/motor/servo/filter/Kalman/Kalman.cpp @@ -0,0 +1,29 @@ +// ----------------------------------------------------------------------------------- +// kalman filter + +#include "Kalman.h" + +#if AXIS1_SERVO_FLTR == KALMAN || AXIS2_SERVO_FLTR == KALMAN || AXIS3_SERVO_FLTR == KALMAN || \ + AXIS4_SERVO_FLTR == KALMAN || AXIS5_SERVO_FLTR == KALMAN || AXIS6_SERVO_FLTR == KALMAN || \ + AXIS7_SERVO_FLTR == KALMAN || AXIS8_SERVO_FLTR == KALMAN || AXIS9_SERVO_FLTR == KALMAN + +KalmanFilter::KalmanFilter(float measurementUncertainty, float variance) { + kalmanFilter = new SimpleKalmanFilter(measurementUncertainty, measurementUncertainty, variance); +} + +long KalmanFilter::update(long encoderCounts, long motorCounts, bool isTracking) { + UNUSED(isTracking); + + long delta = encoderCounts - motorCounts; + + if (!initialized) { + result = encoderCounts - motorCounts; + initialized = true; + } else { + result = kalmanFilter->updateEstimate(delta); + } + + return result + motorCounts; +} + +#endif diff --git a/src/lib/axis/motor/servo/filter/Kalman/Kalman.h b/src/lib/axis/motor/servo/filter/Kalman/Kalman.h new file mode 100755 index 0000000..3cd5ad9 --- /dev/null +++ b/src/lib/axis/motor/servo/filter/Kalman/Kalman.h @@ -0,0 +1,26 @@ +// ----------------------------------------------------------------------------------- +// kalman filter +#pragma once + +#include "../FilterBase.h" + +#if AXIS1_SERVO_FLTR == KALMAN || AXIS2_SERVO_FLTR == KALMAN || AXIS3_SERVO_FLTR == KALMAN || \ + AXIS4_SERVO_FLTR == KALMAN || AXIS5_SERVO_FLTR == KALMAN || AXIS6_SERVO_FLTR == KALMAN || \ + AXIS7_SERVO_FLTR == KALMAN || AXIS8_SERVO_FLTR == KALMAN || AXIS9_SERVO_FLTR == KALMAN + +#include // https://github.com/denyssene/SimpleKalmanFilter + +class KalmanFilter : public Filter { + public: + KalmanFilter(float measurementUncertainty, float variance); + + long update(long encoderCounts, long motorCounts, bool isTracking); + + private: + bool initialized = false; + long long result; + + SimpleKalmanFilter *kalmanFilter; +}; + +#endif diff --git a/src/lib/axis/motor/servo/filter/Learning/Learning.cpp b/src/lib/axis/motor/servo/filter/Learning/Learning.cpp new file mode 100755 index 0000000..d28ee20 --- /dev/null +++ b/src/lib/axis/motor/servo/filter/Learning/Learning.cpp @@ -0,0 +1,198 @@ +// ----------------------------------------------------------------------------------- +// learning filter (experimental) +// +// This is not a conventional noise filter. +// It attempts to learn a repeatable cosine-like periodic error in the +// encoder-minus-motor delta for the RA axis and subtract part of that learned +// pattern back out. It should be treated as experimental cyclic-error +// compensation rather than a general-purpose smoothing filter. + +#include "Learning.h" + +#if AXIS1_SERVO_FLTR == LEARNING + +#include "../../../../tasks/OnTask.h" + +void learningAnalyze() { filterAxis1.analyze(); } + +LearningFilter::LearningFilter(int smoothingWindowSize, int historyLength) { + this->smoothingWindowSize = smoothingWindowSize; + this->historyLength = historyLength; + + deltaSamples = new long[this->historyLength]; + + if (deltaSamples == NULL) { active = false; return; } else active = true; + + trackingCountsPerSecond = (AXIS1_STEPS_PER_DEGREE/240.0F)*SIDEREAL_RATIO_F; + sampleSpacingCounts = trackingCountsPerSecond/4.0F; + sampleSpacingSeconds = sampleSpacingCounts/trackingCountsPerSecond; +} + +long LearningFilter::wrappedSampleIndex(long sample) const { + long wrapped = sample % historyLength; + if (wrapped < 0) wrapped += historyLength; + return wrapped; +} + +float LearningFilter::periodicCorrection(long sample) const { + if (!lock || averagePeriodSamples <= 0.0F) return 0.0F; + + float phaseOffset = fmodf((sample - averagePhaseSample), averagePeriodSamples); + if (phaseOffset < 0.0F) phaseOffset += averagePeriodSamples; + + return cosf((phaseOffset/averagePeriodSamples)*PI*2.0F) * (averageAmplitude*0.4F); +} + +long LearningFilter::update(long encoderCounts, long motorCounts, bool learningActive) { + if (!active) return encoderCounts; + + long delta = encoderCounts - motorCounts; + + if (!initialized) { + reset(); + + smoothedDelta = delta; + smoothedEncoderCounts = encoderCounts; + + VF("MSG: Filter, learning start polling task (rate 5s priority 7)... "); + if (tasks.add(2000, 0, true, 7, learningAnalyze, "Learn")) { VLF("success"); } else { VLF("FAILED!"); } + + initialized = true; + } + + smoothedDelta = (smoothedDelta*(smoothingWindowSize - 1) + delta)/smoothingWindowSize; + smoothedEncoderCounts = (smoothedEncoderCounts*(smoothingWindowSize - 1) + encoderCounts)/smoothingWindowSize; + + sampleIndex = lround(smoothedEncoderCounts/sampleSpacingCounts); + + // Take samples only while the motion is stable enough to learn from. + if (learningActive && sampleIndex != lastLearnedSampleIndex) { + lastLearnedSampleIndex = sampleIndex; + + deltaSamples[wrappedSampleIndex(sampleIndex)] = smoothedDelta; + } + + learnedCorrection = lroundf(periodicCorrection(sampleIndex)); + + return (smoothedDelta - learnedCorrection) + motorCounts; +} + +void LearningFilter::analyze() { + if (!active) return; + + // Find the strongest positive and negative error sample in the learned history. + long maxDelta = deltaSamples[wrappedSampleIndex(sampleIndex)]; + long minDelta = maxDelta; + long strongestPhaseSample = wrappedSampleIndex(sampleIndex); + for (int i = 0; i < historyLength; i++) { + int j = wrappedSampleIndex(sampleIndex - i); + if (deltaSamples[j] >= maxDelta) { maxDelta = deltaSamples[j]; strongestPhaseSample = j; } + if (deltaSamples[j] <= minDelta) { minDelta = deltaSamples[j]; } + Y; + } + phaseSample = strongestPhaseSample; + + averagePeakDelta = ((averagePeakDelta*19.0F) + maxDelta)/20.0F; + averageValleyDelta = ((averageValleyDelta*19.0F) + minDelta)/20.0F; + averageAmplitude = (averagePeakDelta - averageValleyDelta)/2.0F; + + float error; + float sampleDelta; + error = 0; + for (int i = 0; i < historyLength; i++) { + int j = wrappedSampleIndex(phaseSample - i); + sampleDelta = deltaSamples[j]; + error += sampleDelta*sampleDelta; + Y; + } + error /= historyLength; + float nativeError = error; + + float bestError = 100000; + float bestPeriod = 0; + for (int period = 200; period > 20; period -= 1) { + error = 0; + for (int i = 0; i < historyLength; i++) { + int j = wrappedSampleIndex(phaseSample - i); + sampleDelta = deltaSamples[j] - cosf(((i/(float)historyLength)*(period/20.0F))*(float)(PI)*2.0F)*averageAmplitude; + error += sampleDelta*sampleDelta; + Y; + } + error /= historyLength; + + if (error < bestError) { + bestPeriod = historyLength/(period/20.0F); + bestError = error; + } + } + + if (averagePhaseSample == 0) { + averagePhaseSample = phaseSample; + } else { + float phaseForAverage = (float)phaseSample; + float avgPhaseForAverage = (float)averagePhaseSample; + + // Smooth phase on a circular history buffer without jumping at wraparound. + if (labs(phaseSample - averagePhaseSample) > historyLength/2) { + if (phaseSample < averagePhaseSample) phaseForAverage += historyLength; else avgPhaseForAverage += historyLength; + } + + averagePhaseSample = wrappedSampleIndex(lroundf((avgPhaseForAverage*19.0F + phaseForAverage)/20.0F)); + } + if (averagePeriodSamples == 0) averagePeriodSamples = bestPeriod; + averagePeriodSamples = ((averagePeriodSamples*19.0F) + bestPeriod)/20.0F; + + long phaseDistance = labs(phaseSample - averagePhaseSample); + if (phaseDistance > historyLength/2) phaseDistance = historyLength - phaseDistance; + const long phaseTolerance = max(2L, lroundf(averagePeriodSamples*0.1F)); + + if (bestError < nativeError && + averagePeriodSamples > 0 && + bestPeriod/averagePeriodSamples > 0.8F && bestPeriod/averagePeriodSamples < 1.2F && + phaseDistance <= phaseTolerance) + { + lock = true; + } else { + lock = false; + } + + if (lock) { D("Lock: true "); } else { D("Lock: false"); } + D(", Qual: "); D((bestError > 0.0F) ? sqrtf(nativeError/bestError)*100.0F : 0.0F); D("%"); + D(", Period s: "); D(bestPeriod*sampleSpacingSeconds); D(", Period avg s: "); D(averagePeriodSamples*sampleSpacingSeconds); + D(", Phase: "); D((averagePeriodSamples > 0.0F) ? fmodf((float)phaseSample, averagePeriodSamples)/averagePeriodSamples : 0.0F); + D(", Phase avg: "); DL((averagePeriodSamples > 0.0F) ? fmodf((float)averagePhaseSample, averagePeriodSamples)/averagePeriodSamples : 0.0F); + + +// VF("MSG: Native error (sd) "); VL(sqrt(nativeError)); +// VF("MSG: Best error "); VL(sqrt(bestError)); +// VF("MSG: Default frame (samples)"); VL(historyLength); +// VF("MSG: B Period (samples) "); VL(bestPeriod); +// VF("MSG: A Period (samples) "); VL(averagePeriodSamples); +// VF("MSG: Phase (samples) "); VL(averagePhaseSample); +// VF("MSG: Phase cos() "); VL(cos((averagePhaseSample/averagePeriodSamples)*PI*2.0F)); +// VF("MSG: Amplitude (counts) "); VL(averageAmplitude); +// VL(""); + +} + +void LearningFilter::reset() { + if (!active) return; + + phaseSample = 0; + averagePhaseSample = 0; + learnedCorrection = 0; + averagePeakDelta = 0; + averageValleyDelta = 0; + averageAmplitude = 0; + averagePeriodSamples = 0; + sampleIndex = 0; + lastLearnedSampleIndex = 0; + lock = false; + for (int i = 0; i < historyLength; i++) { + deltaSamples[i] = 0; + } +} + +LearningFilter filterAxis1(AXIS1_SERVO_FLTR_WSIZE, 240); + +#endif diff --git a/src/lib/axis/motor/servo/filter/Learning/Learning.h b/src/lib/axis/motor/servo/filter/Learning/Learning.h new file mode 100755 index 0000000..f5614bb --- /dev/null +++ b/src/lib/axis/motor/servo/filter/Learning/Learning.h @@ -0,0 +1,51 @@ +// ----------------------------------------------------------------------------------- +// learning filter (experimental) +#pragma once + +#include "../FilterBase.h" + +#if AXIS1_SERVO_FLTR == LEARNING + +class LearningFilter : public Filter { + public: + // smoothingWindowSize: sample count for the rolling average + // historyLength: number of learned samples retained for periodic analysis + // learningActive: true when the motion is stable enough to train on + LearningFilter(int smoothingWindowSize, int historyLength); + + long update(long encoderCounts, long motorCounts, bool learningActive); + + void analyze(); + + void reset(); + + private: + long wrappedSampleIndex(long sample) const; + float periodicCorrection(long sample) const; + + bool active = false; + bool initialized = false; + bool lock = false; + int smoothingWindowSize; // in samples + int historyLength; // in samples + + float trackingCountsPerSecond; + float sampleSpacingCounts; + float sampleSpacingSeconds; + long phaseSample = 0; + long averagePhaseSample = 0; + long learnedCorrection = 0; + float averagePeakDelta = 0; + float averageValleyDelta = 0; + float averageAmplitude = 0; + float averagePeriodSamples = 0; + long *deltaSamples; + long sampleIndex = 0; + long long smoothedDelta; + long long smoothedEncoderCounts; + long lastLearnedSampleIndex = 0; +}; + +extern LearningFilter filterAxis1; + +#endif diff --git a/src/lib/axis/motor/servo/filter/Rolling/Rolling.cpp b/src/lib/axis/motor/servo/filter/Rolling/Rolling.cpp new file mode 100755 index 0000000..8ac0252 --- /dev/null +++ b/src/lib/axis/motor/servo/filter/Rolling/Rolling.cpp @@ -0,0 +1,28 @@ +// ----------------------------------------------------------------------------------- +// rolling average filter + +#include "Rolling.h" + +#if AXIS1_SERVO_FLTR == ROLLING || AXIS2_SERVO_FLTR == ROLLING || AXIS3_SERVO_FLTR == ROLLING || \ + AXIS4_SERVO_FLTR == ROLLING || AXIS5_SERVO_FLTR == ROLLING || AXIS6_SERVO_FLTR == ROLLING || \ + AXIS7_SERVO_FLTR == ROLLING || AXIS8_SERVO_FLTR == ROLLING || AXIS9_SERVO_FLTR == ROLLING + +RollingFilter::RollingFilter(int size) { + this->size = size; +} + +long RollingFilter::update(long encoderCounts, long motorCounts, bool isTracking) { + UNUSED(isTracking); + + long delta = encoderCounts - motorCounts; + + if (!initialized) { + result = encoderCounts - motorCounts; + initialized = true; + } + + result = (result*(size - 1) + delta)/size; + return result + motorCounts; +} + +#endif diff --git a/src/lib/axis/motor/servo/filter/Rolling/Rolling.h b/src/lib/axis/motor/servo/filter/Rolling/Rolling.h new file mode 100755 index 0000000..9d76bf9 --- /dev/null +++ b/src/lib/axis/motor/servo/filter/Rolling/Rolling.h @@ -0,0 +1,23 @@ +// ----------------------------------------------------------------------------------- +// rolling average filter +#pragma once + +#include "../FilterBase.h" + +#if AXIS1_SERVO_FLTR == ROLLING || AXIS2_SERVO_FLTR == ROLLING || AXIS3_SERVO_FLTR == ROLLING || \ + AXIS4_SERVO_FLTR == ROLLING || AXIS5_SERVO_FLTR == ROLLING || AXIS6_SERVO_FLTR == ROLLING || \ + AXIS7_SERVO_FLTR == ROLLING || AXIS8_SERVO_FLTR == ROLLING || AXIS9_SERVO_FLTR == ROLLING + +class RollingFilter : public Filter { + public: + RollingFilter(int size); + + long update(long encoderCounts, long motorCounts, bool isTracking); + + private: + bool initialized = false; + int size; + long long result; +}; + +#endif diff --git a/src/lib/axis/motor/servo/kTech/KTech.cpp b/src/lib/axis/motor/servo/kTech/KTech.cpp new file mode 100755 index 0000000..9485116 --- /dev/null +++ b/src/lib/axis/motor/servo/kTech/KTech.cpp @@ -0,0 +1,177 @@ +// ----------------------------------------------------------------------------------- +// axis servo KTech motor driver (designed for the MS4010v3 with 16bit encoder) + +#include "KTech.h" + +#ifdef SERVO_KTECH_PRESENT + +#if !defined(CAN_PLUS) || CAN_PLUS == OFF + #error "No KTECH motor CAN interface!" +#endif + +#include "../../../../tasks/OnTask.h" +#include "../../../../canPlus/CanPlus.h" + +ServoKTech *ktechServoInstance[9]; +void requestKTechServoAxis1() { ktechServoInstance[0]->requestStatus(); } +void requestKTechServoAxis2() { ktechServoInstance[1]->requestStatus(); } +void requestKTechServoAxis3() { ktechServoInstance[2]->requestStatus(); } +void requestKTechServoAxis4() { ktechServoInstance[3]->requestStatus(); } +void requestKTechServoAxis5() { ktechServoInstance[4]->requestStatus(); } +void requestKTechServoAxis6() { ktechServoInstance[5]->requestStatus(); } +void requestKTechServoAxis7() { ktechServoInstance[6]->requestStatus(); } +void requestKTechServoAxis8() { ktechServoInstance[7]->requestStatus(); } +void requestKTechServoAxis9() { ktechServoInstance[8]->requestStatus(); } + +void statusKTechServoAxis1(uint8_t data[8]) { ktechServoInstance[0]->requestStatusCallback(data); } +void statusKTechServoAxis2(uint8_t data[8]) { ktechServoInstance[1]->requestStatusCallback(data); } +void statusKTechServoAxis3(uint8_t data[8]) { ktechServoInstance[2]->requestStatusCallback(data); } +void statusKTechServoAxis4(uint8_t data[8]) { ktechServoInstance[3]->requestStatusCallback(data); } +void statusKTechServoAxis5(uint8_t data[8]) { ktechServoInstance[4]->requestStatusCallback(data); } +void statusKTechServoAxis6(uint8_t data[8]) { ktechServoInstance[5]->requestStatusCallback(data); } +void statusKTechServoAxis7(uint8_t data[8]) { ktechServoInstance[6]->requestStatusCallback(data); } +void statusKTechServoAxis8(uint8_t data[8]) { ktechServoInstance[7]->requestStatusCallback(data); } +void statusKTechServoAxis9(uint8_t data[8]) { ktechServoInstance[8]->requestStatusCallback(data); } + +ServoKTech::ServoKTech(uint8_t axisNumber, const ServoSettings *Settings, float countsToStepsRatio) + :ServoDriver(axisNumber, NULL, Settings) { + if (axisNumber < 1 || axisNumber > 9) return; + + strcpy(axisPrefix, " Axis_ServoKTech, "); + axisPrefix[5] = '0' + axisNumber; + + // the motor CAN ID is the axis number! + canID = 0x140 + axisNumber; + + this->countsToStepsRatio.valueDefault = countsToStepsRatio; + + ktechServoInstance[this->axisNumber - 1] = this; + switch (this->axisNumber) { + case 1: callback = requestKTechServoAxis1; break; + case 2: callback = requestKTechServoAxis2; break; + case 3: callback = requestKTechServoAxis3; break; + case 4: callback = requestKTechServoAxis4; break; + case 5: callback = requestKTechServoAxis5; break; + case 6: callback = requestKTechServoAxis6; break; + case 7: callback = requestKTechServoAxis7; break; + case 8: callback = requestKTechServoAxis8; break; + case 9: callback = requestKTechServoAxis9; break; + } +} + +bool ServoKTech::init(bool reverse) { + if (!ServoDriver::init(reverse)) return false; + + // automatically set fault status for known drivers + status.active = statusMode != OFF; + + // get ready for status messages + if (statusMode == ON) { + + switch (this->axisNumber) { + case 1: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechServoAxis1); break; + case 2: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechServoAxis2); break; + case 3: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechServoAxis3); break; + case 4: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechServoAxis4); break; + case 5: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechServoAxis5); break; + case 6: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechServoAxis6); break; + case 7: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechServoAxis7); break; + case 8: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechServoAxis8); break; + case 9: canPlus.callbackRegisterMessage(canID, 0x9a, statusKTechServoAxis9); break; + } + + VF("MSG:"); V(axisPrefix); VF("start callback status request task (rate "); V(KTECH_STATUS_MS); VF("ms priority 7)... "); + char name[] = "Ax_StaK"; + name[2] = axisNumber + '0'; + if (tasks.add(KTECH_STATUS_MS, 0, true, 7, callback, name)) { VLF("success"); } else { VLF("FAILED!"); } + } else { + VF("MSG:"); V(axisPrefix); VLF("no driver status"); + } + + return true; +} + +// enable or disable the driver using the enable pin or other method +void ServoKTech::enable(bool state) { + enabled = state; + + VF("MSG:"); V(axisPrefix); VF("powered "); + + static const uint8_t cmd[] = "\xa2\x00\x00\x00\x00\x00\x00\x00"; + canPlus.txWait(); + canPlus.writePacket(canID, cmd, 8); + + if (state) { + static const uint8_t cmd[] = "\x88\x00\x00\x00\x00\x00\x00\x00"; + canPlus.txWait(); + canPlus.writePacket(canID, cmd, 8); + VLF("up"); + } else { + static const uint8_t cmd[] = "\x80\x00\x00\x00\x00\x00\x00\x00"; + canPlus.txWait(); + canPlus.writePacket(canID, cmd, 8); + VLF("down"); + } + + velocityRamp = 0.0F; +} + +// velocity is in units of 0.01 deg/s +// so with an encoder of 65536 counts per turn into 360:1 reduction (65536 counts per degree) = a velocity of 36000 motor "steps"/s +float ServoKTech::setMotorVelocity(float velocity) { + velocity = ServoDriver::setMotorVelocity(velocity); + + int32_t velocityNext = lroundf(velocity*countsToStepsRatio.value); + if (reversed) velocityNext = -velocityNext; + + if (canPlus.txTryLock()) { + static const uint8_t cmd[] = "\xa2\x00\x00\x00"; + canPlus.beginPacket(canID); + canPlus.write(cmd, 4); + canPlus.write((uint8_t*)&velocityNext, 4); + canPlus.endPacket(); + velocityLast = velocityNext; + canPlus.rxBurst(1000); + } + + return velocity; +} + +// request driver status from CAN +void ServoKTech::requestStatus() { + static const uint8_t cmd[] = "\x9a\x00\x00\x00\x00\x00\x00\x00"; + if (canPlus.txTryLock()) canPlus.writePacket(canID, cmd, 8); +} + +void ServoKTech::readStatus() { + if (statusMode == OFF) return; + + if (millis() - lastStatusUpdateTime >= KTECH_STATUS_MS*4U) { + status.outputA.shortToGround = true; + status.outputA.openLoad = true; + status.outputB.shortToGround = true; + status.outputB.openLoad = true; + status.overTemperatureWarning = true; + status.overTemperature = true; + status.standstill = true; + status.fault = true; + } +} + +// update the associated driver status from CAN +void ServoKTech::requestStatusCallback(uint8_t data[8]) { + if (statusMode == OFF) return; + + uint8_t errorState = data[7]; + status.outputA.shortToGround = false; + status.outputA.openLoad = false; + status.outputB.shortToGround = false; + status.outputB.openLoad = false; + status.overTemperatureWarning = false; + status.overTemperature = bitRead(errorState, 3); + status.standstill = false; + status.fault = bitRead(errorState, 0) || bitRead(errorState, 3); + lastStatusUpdateTime = millis(); +} + +#endif diff --git a/src/lib/axis/motor/servo/kTech/KTech.h b/src/lib/axis/motor/servo/kTech/KTech.h new file mode 100755 index 0000000..a7b56f4 --- /dev/null +++ b/src/lib/axis/motor/servo/kTech/KTech.h @@ -0,0 +1,73 @@ +// ----------------------------------------------------------------------------------- +// axis servo KTech motor driver (designed for the MS4010v3 with 16bit encoder) +#pragma once + +#include +#include "../../../../../Common.h" + +#ifdef SERVO_KTECH_PRESENT + +#include "../ServoDriver.h" + +#if !defined(CAN_PLUS) || CAN_PLUS == OFF + #error "No KTECH motor CAN interface!" +#endif + +// KTECH status rate default 1Hz +#ifndef KTECH_STATUS_MS + #define KTECH_STATUS_MS 1000 +#endif + +class ServoKTech : public ServoDriver { + public: + // constructor + ServoKTech(uint8_t axisNumber, const ServoSettings *Settings, float countsToDegreesRatio); + + // decodes driver model and sets up the pin modes + bool init(bool reverse); + + // returns the number of axis parameters + uint8_t getParameterCount() { return numParameters; } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { if (number > numParameters) return &invalid; else return parameter[number]; } + + // enable or disable the driver using the enable pin or other method + void enable(bool state); + + // set motor velocity + // \param velocity as needed to reach the target position, in encoder counts per second + // \param velocityTarget is the desired instantanous velocity at this moment, in encoder counts per second + // \returns velocity in effect, in encoder counts per second + float setMotorVelocity(float velocity); + + // request driver status from CAN + void requestStatus(); + + // read the associated driver status from CAN + void requestStatusCallback(uint8_t data[8]); + + // get the driver name + const char* name() { return "KTECH"; } + + private: + // read status info. from driver + void readStatus(); + + int canID; + unsigned long lastStatusUpdateTime = 0; + + void (*callback)() = NULL; + + // regulate velocity changes + int32_t velocityLast = 0; + + // runtime adjustable settings + AxisParameter countsToStepsRatio = {NAN, NAN, NAN, -1, 20000, AXP_FLOAT, "Count/Step ratio"}; + + const int numParameters = 3; + AxisParameter* parameter[4] = {&invalid, &acceleration, &zeroDeadband, &countsToStepsRatio}; + +}; + +#endif diff --git a/src/lib/axis/motor/servo/tmc/TmcServoDriver.cpp b/src/lib/axis/motor/servo/tmc/TmcServoDriver.cpp new file mode 100755 index 0000000..f9817f4 --- /dev/null +++ b/src/lib/axis/motor/servo/tmc/TmcServoDriver.cpp @@ -0,0 +1,133 @@ +// ----------------------------------------------------------------------------------- +// axis servo motor driver + +#include "TmcServoDriver.h" + +#ifdef SERVO_MOTOR_PRESENT + +TmcServoDriver::TmcServoDriver(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, + int16_t microsteps, int16_t current, int8_t decay, int8_t decaySlewing) + :ServoDriver(axisNumber, Pins, Settings) { + if (axisNumber < 1 || axisNumber > 9) return; + + // get the maximum current and Rsense for this axis + float user_rSense = 0; + int16_t user_currentMax = 0; + switch (axisNumber) { + case 1: + #ifdef AXIS1_DRIVER_RSENSE + user_rSense = AXIS1_DRIVER_RSENSE; + #endif + #ifdef AXIS1_DRIVER_MAX_CURRENT + user_currentMax = AXIS1_DRIVER_MAX_CURRENT; + #endif + break; + case 2: + #ifdef AXIS2_DRIVER_RSENSE + user_rSense = AXIS2_DRIVER_RSENSE; + #endif + #ifdef AXIS2_DRIVER_MAX_CURRENT + user_currentMax = AXIS2_DRIVER_MAX_CURRENT; + #endif + break; + case 3: + #ifdef AXIS3_DRIVER_RSENSE + user_rSense = AXIS3_DRIVER_RSENSE; + #endif + #ifdef AXIS3_DRIVER_MAX_CURRENT + user_currentMax = AXIS3_DRIVER_MAX_CURRENT; + #endif + break; + case 4: + #ifdef AXIS4_DRIVER_RSENSE + user_rSense = AXIS4_DRIVER_RSENSE; + #endif + #ifdef AXIS4_DRIVER_MAX_CURRENT + user_currentMax = AXIS4_DRIVER_MAX_CURRENT; + #endif + break; + case 5: + #ifdef AXIS5_DRIVER_RSENSE + user_rSense = AXIS5_DRIVER_RSENSE; + #endif + #ifdef AXIS5_DRIVER_MAX_CURRENT + user_currentMax = AXIS5_DRIVER_MAX_CURRENT; + #endif + break; + case 6: + #ifdef AXIS6_DRIVER_RSENSE + user_rSense = AXIS6_DRIVER_RSENSE; + #endif + #ifdef AXIS6_DRIVER_MAX_CURRENT + user_currentMax = AXIS6_DRIVER_MAX_CURRENT; + #endif + break; + case 7: + #ifdef AXIS7_DRIVER_RSENSE + user_rSense = AXIS7_DRIVER_RSENSE; + #endif + #ifdef AXIS7_DRIVER_MAX_CURRENT + user_currentMax = AXIS7_DRIVER_MAX_CURRENT; + #endif + break; + case 8: + #ifdef AXIS8_DRIVER_RSENSE + user_rSense = AXIS8_DRIVER_RSENSE; + #endif + #ifdef AXIS8_DRIVER_MAX_CURRENT + user_currentMax = AXIS8_DRIVER_MAX_CURRENT; + #endif + break; + case 9: + #ifdef AXIS9_DRIVER_RSENSE + user_rSense = AXIS9_DRIVER_RSENSE; + #endif + #ifdef AXIS9_DRIVER_MAX_CURRENT + user_currentMax = AXIS9_DRIVER_MAX_CURRENT; + #endif + break; + } + + if (driverModel == SERVO_TMC5160) { currentMax = TMC5160_MAX_CURRENT; rSense = TMC5160_RSENSE; } else + if (driverModel == SERVO_TMC2209) { currentMax = TMC2209_MAX_CURRENT; rSense = TMC2209_RSENSE; } else + driverModel = 0; + + if (user_rSense != 0) rSense = user_rSense; + if (user_currentMax != 0) currentMax = user_currentMax; + + // set current defaults for TMC drivers + if (lround(current) == OFF) current = 300.0F; + + this->currentRun.valueDefault = current; + this->currentRun.max = currentMax; + + // setup decay modes + this->decay.valueDefault = decay; + if (this->decay.valueDefault == OFF) this->decay.valueDefault = STEALTHCHOP; + this->decaySlewing.valueDefault = decaySlewing; + if (this->decaySlewing.valueDefault == OFF) this->decaySlewing.valueDefault = SPREADCYCLE; +} + +bool TmcServoDriver::init(bool reverse) { + if (!ServoDriver::init(reverse)) return false; + + if (!driverModel) { + DF("WRN:"); D(axisPrefix); DLF("unknown driver model!"); + return false; + } + + VF("MSG:"); V(axisPrefix); VF("Rsense="); V(rSense); VL("Ohms"); + VF("MSG:"); V(axisPrefix); VF("max current="); V(currentMax); VL("mA"); + + iRun = this->currentRun.value; + iHold = iRun; + iHoldRatio = (float)1.0F; + + VF("MSG:"); V(axisPrefix); + VF("IHOLD="); V(lround(iHold)); VF("mA, "); + VF("IRUN="); V(lround(iRun)); VL("mA"); + + return true; +} + +#endif diff --git a/src/lib/axis/motor/servo/tmc/TmcServoDriver.h b/src/lib/axis/motor/servo/tmc/TmcServoDriver.h new file mode 100755 index 0000000..f6c9f85 --- /dev/null +++ b/src/lib/axis/motor/servo/tmc/TmcServoDriver.h @@ -0,0 +1,63 @@ +// ----------------------------------------------------------------------------------- +// axis servo motor driver +#pragma once + +#include "../ServoDriver.h" + +#ifdef SERVO_MOTOR_PRESENT + +// default settings for any TMC drivers that may be present +#ifndef DRIVER_TMC_STEPPER_AUTOGRAD + #define DRIVER_TMC_STEPPER_AUTOGRAD true +#endif +#ifndef TMC5160_RSENSE + #define TMC5160_RSENSE 0.075F +#endif +#ifndef TMC5160_MAX_CURRENT + #define TMC5160_MAX_CURRENT 4230 // typical module rated at 3.0A RMS +#endif +#ifndef TMC2209_RSENSE + #define TMC2209_RSENSE 0.11F +#endif +#ifndef TMC2209_MAX_CURRENT + #define TMC2209_MAX_CURRENT (2820*0.8) // chip rated at 2.0A RMS, downrated to 80% due to typical step-stick form +#endif + +class TmcServoDriver : public ServoDriver { + public: + TmcServoDriver(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, int16_t microsteps, int16_t current, int8_t decay, int8_t decaySlewing); + + // decodes driver model and sets up the pin modes + virtual bool init(bool reverse); + + // returns the number of axis parameters + uint8_t getParameterCount() { return numParameters; } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { if (number > numParameters) return &invalid; else return parameter[number]; } + + // set motor velocity + // \param velocity as needed to reach the target position, in signed encoder counts per second + // \returns velocity in effect, in signed encoder counts per second + virtual float setMotorVelocity(float velocity) { return 0; } + + protected: + // driver current control + float rSense = 0.11F; + int16_t currentMax = 0; + + float iHold, iRun, iHoldRatio; + + int16_t normalizedMicrosteps = 256; + + // runtime adjustable settings + AxisParameter countsToStepsRatio = {NAN, NAN, NAN, 0, 20000, AXP_FLOAT, AXPN_STEPS_TO_COUNTS}; + AxisParameter currentRun = {NAN, NAN, NAN, 0, 20000, AXP_INTEGER, AXPN_CURRENT_RUN}; + AxisParameter decay = {NAN, NAN, NAN, SPREADCYCLE, STEALTHCHOP, AXP_DECAY, AXPN_DECAY_MODE}; + AxisParameter decaySlewing = {NAN, NAN, NAN, SPREADCYCLE, STEALTHCHOP, AXP_DECAY, AXPN_DECAY_MODE_GOTO}; + + const int numParameters = 6; + AxisParameter* parameter[7] = {&invalid, &acceleration, &zeroDeadband, &countsToStepsRatio, ¤tRun, &decay, &decaySlewing}; +}; + +#endif diff --git a/src/lib/axis/motor/servo/tmc/tmc2209/Tmc2209.cpp b/src/lib/axis/motor/servo/tmc/tmc2209/Tmc2209.cpp new file mode 100755 index 0000000..314ef16 --- /dev/null +++ b/src/lib/axis/motor/servo/tmc/tmc2209/Tmc2209.cpp @@ -0,0 +1,180 @@ +// ----------------------------------------------------------------------------------- +// axis servo TMC2209 stepper motor driver + +#include "Tmc2209.h" + +#ifdef SERVO_TMC2209_PRESENT + +#include "../../../../../tasks/OnTask.h" +#include "../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define rx m3 +#define tx m2 + +// provide for using hardware serial +#if SERIAL_TMC == HardSerial + #include + #undef SERIAL_TMC + HardwareSerial HWSerialTMC(SERIAL_TMC_RX, SERIAL_TMC_TX); + #define SERIAL_TMC HWSerialTMC + #define SERIAL_TMC_RXTX_SET +#endif + +ServoTmc2209::ServoTmc2209(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, + float countsToStepsRatio, int16_t microsteps, int16_t current, int8_t decay, int8_t decaySlewing) + :TmcServoDriver(axisNumber, Pins, Settings, microsteps, current, decay, decaySlewing) { + if (axisNumber < 1 || axisNumber > 9) return; + + strcpy(axisPrefix, " Axis_ServoTmc2209, "); + axisPrefix[5] = '0' + axisNumber; + + this->velocityThrs = velocityThrs; + this->countsToStepsRatio.valueDefault = countsToStepsRatio; +} + +bool ServoTmc2209::init(bool reverse) { + if (!TmcServoDriver::init(reverse)) return false; + + // get TMC UART driver ready + pinModeEx(Pins->m0, OUTPUT); + pinModeEx(Pins->m1, OUTPUT); + pinModeEx(Pins->ph1, OUTPUT); // step + pinModeEx(Pins->ph2, OUTPUT); // dir + + // set S/D motion pins to known, fixed state + digitalWriteEx(Pins->ph1, LOW); // step + digitalWriteEx(Pins->ph2, LOW); // dir + + // initialize the serial port + VF("MSG:"); V(axisPrefix); VF("TMC "); + #if defined(SERIAL_TMC_HARDWARE_UART) + #if defined(DEDICATED_MODE_PINS) + // program the device address 0,1,2,3 since M0 and M1 are all unique + int deviceAddress = SERIAL_TMC_ADDRESS_MAP(axisNumber - 1); + digitalWriteEx(Pins->m0, bitRead(deviceAddress, 0)); + digitalWriteEx(Pins->m1, bitRead(deviceAddress, 1)); + #else + // help user hard code the device address 0,1,2,3 by cutting pins + digitalWriteEx(Pins->m0, HIGH); + digitalWriteEx(Pins->m1, HIGH); + #endif + + #define SerialTMC SERIAL_TMC + static bool initialized = false; + if (!initialized) { + #if defined(SERIAL_TMC_RX) && defined(SERIAL_TMC_TX) && !defined(SERIAL_TMC_RXTX_SET) + VF("HW UART driver pins rx="); V(SERIAL_TMC_RX); VF(", tx="); V(SERIAL_TMC_TX); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + SerialTMC.begin(SERIAL_TMC_BAUD, SERIAL_8N1, SERIAL_TMC_RX, SERIAL_TMC_TX); + #else + VF("HW UART driver pins on port default"); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + SerialTMC.begin(SERIAL_TMC_BAUD); + #endif + initialized = true; + } + #else + // pull MS1 and MS2 low for device address 0 + digitalWriteEx(Pins->m0, LOW); + digitalWriteEx(Pins->m1, LOW); + VF("SW UART driver pins rx="); V(Pins->rx); VF(", tx="); V(Pins->tx); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + SerialTMC = new SoftwareSerial(Pins->rx, Pins->tx); + SerialTMC->begin(SERIAL_TMC_BAUD); + #endif + + #if defined(SERIAL_TMC_HARDWARE_UART) + driver = new TMC2209Stepper(&SerialTMC, rSense, SERIAL_TMC_ADDRESS_MAP(axisNumber - 1)); + #else + driver = new TMC2209Stepper(SerialTMC, rSense, SERIAL_TMC_ADDRESS_MAP(axisNumber - 1)); + #endif + driver->begin(); + driver->intpol(true); + + if (decay.value == STEALTHCHOP && decaySlewing.value == SPREADCYCLE && velocityThrs > 0) { + VF("MSG:"); V(axisPrefix); VF("TMC decay mode velocity threshold "); V(velocityThrs); VLF(" sps"); + driver->TPWMTHRS(velocityThrs/0.715F); + } + + driver->microsteps(256); + + driver->hold_multiplier(iHoldRatio); + + VF("MSG:"); V(axisPrefix); VF("Irun="); V(lround(iRun)); VLF("mA"); + driver->rms_current(iRun*0.7071); + + driver->en_spreadCycle(true); + + // automatically set fault status for known drivers + status.active = statusMode == ON; + + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + readStatus(); + if (!status.standstill || status.overTemperature) { + DF("ERR:"); D(axisPrefix); DLF("no driver detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + #endif + + return true; +} + +// enable or disable the driver using the enable pin or other method +void ServoTmc2209::enable(bool state) { + enabled = state; + + if (enablePin == SHARED) { + VF("MSG:"); V(axisPrefix); VF("powered "); if (state) { VF("up"); } else { VF("down"); } VLF(" using UART"); + if (state) { + driver->en_spreadCycle(!stealthChop()); + driver->rms_current(iRun*0.7071); + } else { + driver->en_spreadCycle(false); + driver->ihold(0); + } + } else { + VF("MSG:"); V(axisPrefix); VF("powered "); if (state) { VF("up"); } else { VF("down"); } VLF(" using enable pin"); + if (!enabled) { digitalWriteF(enablePin, !enabledState); } else { digitalWriteF(enablePin, enabledState); } + } + + velocityRamp = 0.0F; + + ServoDriver::updateStatus(); + + return; +} + +float ServoTmc2209::setMotorVelocity(float velocity) { + velocity = ServoDriver::setMotorVelocity(velocity); + + driver->VACTUAL(reversed ? -(velocity/0.715F)*countsToStepsRatio.value : (velocity/0.715F)*countsToStepsRatio.value); + + return velocity; +} + +void ServoTmc2209::readStatus() { + TMC2208_n::DRV_STATUS_t status_result; + status_result.sr = driver->DRV_STATUS(); + if (driver->CRCerror) status_result.sr = 0xFFFFFFFF; + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = status_result.s2gb; + status.outputB.openLoad = status_result.olb; + status.overTemperatureWarning = status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +// calibrate the motor driver if required +void ServoTmc2209::calibrateDriver() { + if (stealthChop()) { + VF("MSG:"); V(axisPrefix); VL("TMC standstill automatic current calibration"); + driver->rms_current(iRun*0.7071); + driver->pwm_autograd(DRIVER_TMC_STEPPER_AUTOGRAD); + driver->pwm_autoscale(true); + driver->en_spreadCycle(false); + delay(1000); + } +} + +#endif diff --git a/src/lib/axis/motor/servo/tmc/tmc2209/Tmc2209.h b/src/lib/axis/motor/servo/tmc/tmc2209/Tmc2209.h new file mode 100755 index 0000000..ea26cda --- /dev/null +++ b/src/lib/axis/motor/servo/tmc/tmc2209/Tmc2209.h @@ -0,0 +1,91 @@ +// ----------------------------------------------------------------------------------- +// axis servo TMC2209 stepper motor driver +#pragma once + +#include +#include "../../../../../../Common.h" + +#ifdef SERVO_TMC2209_PRESENT + +#include "../TmcServoDriver.h" + +// default settings for any TMC UART drivers that may be present +#ifndef SERIAL_TMC + #define SERIAL_TMC SoftSerial // Use software serial w/ TX on M3 (CS) and RX on M4 (MISO) of each axis +#endif +#ifndef SERIAL_TMC_BAUD + #define SERIAL_TMC_BAUD 115200 // Baud rate +#endif +#ifndef SERIAL_TMC_ADDRESS_MAP + #define SERIAL_TMC_ADDRESS_MAP(x) (0) // driver addresses are 0 for all axes +#endif + +#if SERIAL_TMC == SoftSerial + #include // must be built into the board libraries +#endif + +#include // https://github.com/teemuatlut/TMCStepper + +typedef struct ServoTmcPins { + int16_t step; + int16_t dir; + int16_t enable; + uint8_t enabledState; + int16_t m0; + int16_t m1; + int16_t fault; +} ServoTmcPins; + +typedef struct ServoTmcSettings { + int16_t model; + int8_t status; + int32_t velocityMax; // maximum velocity in steps/second + int32_t velocityThrs; // velocity for stealthChop to spreadCycle switch in steps/second + int32_t acceleration; // acceleration steps/second/second + int16_t microsteps; + int16_t current; // peak current in mA + int8_t decay; + int8_t decaySlewing; +} ServoTmcSettings; + +class ServoTmc2209 : public TmcServoDriver { + public: + // constructor + ServoTmc2209(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float countsToStepsRatio, int16_t microsteps, int16_t current, int8_t decay, int8_t decaySlewing); + + // decodes driver model and sets up the pin modes + bool init(bool reverse); + + // enable or disable the driver using the enable pin or other method + void enable(bool state); + + // set motor velocity + // \param velocity as needed to reach the target position, in encoder counts per second + // \returns velocity in effect, in encoder counts per second + float setMotorVelocity(float velocity); + + // calibrate the motor if required + void calibrateDriver(); + + // get the driver name + const char* name() { return "TMC2209 (UART)"; } + + private: + // read status from driver + void readStatus(); + + bool stealthChop() { if (lround(decay.value) == STEALTHCHOP) return true; else return false; } + + #if SERIAL_TMC == SoftSerial + SoftwareSerial *SerialTMC; + #endif + + TMC2209Stepper *driver; + + bool sdMode = false; + + // for switching to/from spreadCycle + int16_t velocityThrs; +}; + +#endif diff --git a/src/lib/axis/motor/servo/tmc/tmc5160/Tmc5160.cpp b/src/lib/axis/motor/servo/tmc/tmc5160/Tmc5160.cpp new file mode 100755 index 0000000..377ba2d --- /dev/null +++ b/src/lib/axis/motor/servo/tmc/tmc5160/Tmc5160.cpp @@ -0,0 +1,139 @@ +// ----------------------------------------------------------------------------------- +// axis servo TMC5160 stepper motor driver + +#include "Tmc5160.h" + +#ifdef SERVO_TMC5160_PRESENT + +#include "../../../../../tasks/OnTask.h" +#include "../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +ServoTmc5160::ServoTmc5160(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *TmcSettings, + float countsToStepsRatio, int16_t microsteps, int16_t current, int8_t decay, int8_t decaySlewing) + :TmcServoDriver(axisNumber, Pins, Settings, microsteps, current, decay, decaySlewing) { + if (axisNumber < 1 || axisNumber > 9) return; + + strcpy(axisPrefix, " Axis_ServoTmc5160, "); + axisPrefix[5] = '0' + axisNumber; + + this->velocityThrs = velocityThrs; + this->countsToStepsRatio.valueDefault = countsToStepsRatio; +} + +bool ServoTmc5160::init(bool reverse) { + if (!TmcServoDriver::init(reverse)) return false; + + // get TMC SPI driver ready + pinModeEx(Pins->ph1, OUTPUT); // step + pinModeEx(Pins->ph2, OUTPUT); // dir + + // set S/D motion pins to known, fixed state + digitalWriteEx(Pins->ph1, LOW); // step + digitalWriteEx(Pins->ph2, LOW); // dir + + driver = new TMC5160Stepper(Pins->cs, rSense, Pins->mosi, Pins->miso, Pins->sck); + driver->begin(); + driver->intpol(true); + + if (decay.value == STEALTHCHOP && decaySlewing.value == SPREADCYCLE && velocityThrs > 0) { + VF("MSG:"); V(axisPrefix); VF("TMC decay mode velocity threshold "); V(velocityThrs); VLF(" sps"); + driver->TPWMTHRS(velocityThrs/0.715F); + } + + driver->microsteps(256); + + driver->hold_multiplier(iHoldRatio); + driver->rms_current(iRun*0.7071); + + unsigned long mode = driver->IOIN(); + if (mode && 0b01000000 > 0) { + DF("WRN:"); D(axisPrefix); DLF("TMC driver is in Step/Dir mode and WILL NOT WORK for TMC5160_SERVO!"); + return false; + } + + driver->en_pwm_mode(false); + driver->AMAX(65535); + driver->RAMPMODE(1); + + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + #ifndef DRIVER_TMC_STEPPER_HW_SPI + if (Pins->miso != OFF) + #endif + { + readStatus(); + if (!status.standstill || status.overTemperature) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + } + #endif + + return true; +} + +// enable or disable the driver using the enable pin or other method +void ServoTmc5160::enable(bool state) { + enabled = state; + + if (enablePin == SHARED) { + VF("MSG:"); V(axisPrefix); VF(", powered "); if (state) { VF("up"); } else { VF("down"); } VLF(" using SPI"); + if (state) { + driver->en_pwm_mode(stealthChop()); + driver->rms_current(iRun*0.7071); + } else { + driver->en_pwm_mode(true); + driver->ihold(0); + } + } else { + VF("MSG:"); V(axisPrefix); VF(", powered "); if (state) { VF("up"); } else { VF("down"); } VLF(" using enable pin"); + if (!enabled) { digitalWriteF(enablePin, !enabledState); } else { digitalWriteF(enablePin, enabledState); } + } + + velocityRamp = 0.0F; + + ServoDriver::updateStatus(); +} + +float ServoTmc5160::setMotorVelocity(float velocity) { + velocity = ServoDriver::setMotorVelocity(velocity); + + if (motorDirection = DIR_FORWARD) driver->shaft(reversed ? true : false); else driver->shaft(reversed ? false : true); + driver->VMAX(fabs((velocity/0.715F)*countsToStepsRatio.value)); + + return velocity; +} + +// read status info. from driver +void ServoTmc5160::readStatus() { + TMC2130_n::DRV_STATUS_t status_result; + status_result.sr = ((TMC5160Stepper*)driver)->DRV_STATUS(); + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = status_result.s2gb; + status.outputB.openLoad = status_result.olb; + status.overTemperatureWarning = status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +// calibrate the motor driver if required +void ServoTmc5160::calibrateDriver() { + if (stealthChop()) { + VF("MSG:"); V(axisPrefix); VL("TMC standstill automatic current calibration"); + driver->rms_current(iRun*0.7071); + driver->pwm_autograd(DRIVER_TMC_STEPPER_AUTOGRAD); + driver->pwm_autoscale(true); + driver->en_pwm_mode(true); + delay(1000); + } +} + +#endif diff --git a/src/lib/axis/motor/servo/tmc/tmc5160/Tmc5160.h b/src/lib/axis/motor/servo/tmc/tmc5160/Tmc5160.h new file mode 100755 index 0000000..21baff4 --- /dev/null +++ b/src/lib/axis/motor/servo/tmc/tmc5160/Tmc5160.h @@ -0,0 +1,48 @@ +// ----------------------------------------------------------------------------------- +// axis servo TMC5160 stepper motor driver +#pragma once + +#include +#include "../../../../../../Common.h" + +#ifdef SERVO_TMC5160_PRESENT + +#include "../TmcServoDriver.h" + +#include // https://github.com/teemuatlut/TMCStepper + +class ServoTmc5160 : public TmcServoDriver { + public: + // constructor + ServoTmc5160(uint8_t axisNumber, const ServoPins *Pins, const ServoSettings *Settings, float countsToStepsRatio, int16_t microsteps, int16_t current, int8_t decay, int8_t decaySlewing); + + // decodes driver model and sets up the pin modes + bool init(bool reverse); + + // enable or disable the driver using the enable pin or other method + void enable(bool state); + + // set motor velocity + // \param velocity as needed to reach the target position, in encoder counts per second + // \returns velocity in effect, in encoder counts per second + float setMotorVelocity(float velocity); + + // calibrate the motor if required + void calibrateDriver(); + + // get the driver name + const char* name() { return "TMC5160 (SPI)"; } + + private: + // read status from driver + void readStatus(); + + bool stealthChop() { if (lround(decay.value) == STEALTHCHOP) return true; else return false; } + + TMC5160Stepper *driver; + + // for switching to/from spreadCycle + int16_t velocityThrs; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/StepDir.cpp b/src/lib/axis/motor/stepDir/StepDir.cpp new file mode 100755 index 0000000..b9182f3 --- /dev/null +++ b/src/lib/axis/motor/stepDir/StepDir.cpp @@ -0,0 +1,572 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor + +#include "StepDir.h" + +#ifdef STEP_DIR_MOTOR_PRESENT + +#include "../../../tasks/OnTask.h" + +static StepDirMotor *stepDirMotorInstance[9]; + +#ifndef AXIS1_STEP_PIN + #define AXIS1_STEP_PIN stepDirMotorInstance[0]->Pins->step +#endif +IRAM_ATTR void moveStepDirMotorAxis1() { stepDirMotorInstance[0]->move(AXIS1_STEP_PIN); } +IRAM_ATTR void moveStepDirMotorFFAxis1() { stepDirMotorInstance[0]->moveFF(AXIS1_STEP_PIN); } +IRAM_ATTR void moveStepDirMotorFRAxis1() { stepDirMotorInstance[0]->moveFR(AXIS1_STEP_PIN); } + +#ifndef AXIS2_STEP_PIN + #define AXIS2_STEP_PIN stepDirMotorInstance[1]->Pins->step +#endif +IRAM_ATTR void moveStepDirMotorAxis2() { stepDirMotorInstance[1]->move(AXIS2_STEP_PIN); } +IRAM_ATTR void moveStepDirMotorFFAxis2() { stepDirMotorInstance[1]->moveFF(AXIS2_STEP_PIN); } +IRAM_ATTR void moveStepDirMotorFRAxis2() { stepDirMotorInstance[1]->moveFR(AXIS2_STEP_PIN); } + +#ifndef AXIS3_STEP_PIN + #define AXIS3_STEP_PIN stepDirMotorInstance[2]->Pins->step +#endif +IRAM_ATTR void moveStepDirMotorAxis3() { stepDirMotorInstance[2]->move(AXIS3_STEP_PIN); } +IRAM_ATTR void moveStepDirMotorFFAxis3() { stepDirMotorInstance[2]->moveFF(AXIS3_STEP_PIN); } +IRAM_ATTR void moveStepDirMotorFRAxis3() { stepDirMotorInstance[2]->moveFR(AXIS3_STEP_PIN); } + +#ifndef AXIS4_STEP_PIN + #define AXIS4_STEP_PIN stepDirMotorInstance[3]->Pins->step +#endif +void moveStepDirMotorAxis4() { stepDirMotorInstance[3]->move(AXIS4_STEP_PIN); } +void moveStepDirMotorFFAxis4() { stepDirMotorInstance[3]->moveFF(AXIS4_STEP_PIN); } +void moveStepDirMotorFRAxis4() { stepDirMotorInstance[3]->moveFR(AXIS4_STEP_PIN); } + +#ifndef AXIS5_STEP_PIN + #define AXIS5_STEP_PIN stepDirMotorInstance[4]->Pins->step +#endif +void moveStepDirMotorAxis5() { stepDirMotorInstance[4]->move(AXIS5_STEP_PIN); } +void moveStepDirMotorFFAxis5() { stepDirMotorInstance[4]->moveFF(AXIS5_STEP_PIN); } +void moveStepDirMotorFRAxis5() { stepDirMotorInstance[4]->moveFR(AXIS5_STEP_PIN); } + +#ifndef AXIS6_STEP_PIN + #define AXIS6_STEP_PIN stepDirMotorInstance[5]->Pins->step +#endif +void moveStepDirMotorAxis6() { stepDirMotorInstance[5]->move(AXIS6_STEP_PIN); } +void moveStepDirMotorFFAxis6() { stepDirMotorInstance[5]->moveFF(AXIS6_STEP_PIN); } +void moveStepDirMotorFRAxis6() { stepDirMotorInstance[5]->moveFR(AXIS6_STEP_PIN); } + +#ifndef AXIS7_STEP_PIN + #define AXIS7_STEP_PIN stepDirMotorInstance[6]->Pins->step +#endif +void moveStepDirMotorAxis7() { stepDirMotorInstance[6]->move(AXIS7_STEP_PIN); } +void moveStepDirMotorFFAxis7() { stepDirMotorInstance[6]->moveFF(AXIS7_STEP_PIN); } +void moveStepDirMotorFRAxis7() { stepDirMotorInstance[6]->moveFR(AXIS7_STEP_PIN); } + +#ifndef AXIS8_STEP_PIN + #define AXIS8_STEP_PIN stepDirMotorInstance[7]->Pins->step +#endif +void moveStepDirMotorAxis8() { stepDirMotorInstance[7]->move(AXIS8_STEP_PIN); } +void moveStepDirMotorFFAxis8() { stepDirMotorInstance[7]->moveFF(AXIS8_STEP_PIN); } +void moveStepDirMotorFRAxis8() { stepDirMotorInstance[7]->moveFR(AXIS8_STEP_PIN); } + +#ifndef AXIS9_STEP_PIN + #define AXIS9_STEP_PIN stepDirMotorInstance[8]->Pins->step +#endif +void moveStepDirMotorAxis9() { stepDirMotorInstance[8]->move(AXIS9_STEP_PIN); } +void moveStepDirMotorFFAxis9() { stepDirMotorInstance[8]->moveFF(AXIS9_STEP_PIN); } +void moveStepDirMotorFRAxis9() { stepDirMotorInstance[8]->moveFR(AXIS9_STEP_PIN); } + +StepDirMotor::StepDirMotor(uint8_t axisNumber, int8_t reverse, + const StepDirPins *Pins, StepDirDriver *Driver, bool useFastHardwareTimers) + :Motor(axisNumber, reverse) { + strcpy(axisPrefix, " Axis_StepDir, "); + axisPrefix[5] = '0' + axisNumber; + + driverType = STEP_DIR; + + this->Pins = Pins; + + if (axisNumber > 2) useFastHardwareTimers = false; + this->useFastHardwareTimers = useFastHardwareTimers; + + driver = Driver; + pulseWidth = driver->getPulseWidth(); + + // attach the function pointers to the callbacks + stepDirMotorInstance[axisNumber - 1] = this; + switch (axisNumber) { + case 1: callback = moveStepDirMotorAxis1; callbackFF = moveStepDirMotorFFAxis1; callbackFR = moveStepDirMotorFRAxis1; break; + case 2: callback = moveStepDirMotorAxis2; callbackFF = moveStepDirMotorFFAxis2; callbackFR = moveStepDirMotorFRAxis2; break; + case 3: callback = moveStepDirMotorAxis3; callbackFF = moveStepDirMotorFFAxis3; callbackFR = moveStepDirMotorFRAxis3; break; + case 4: callback = moveStepDirMotorAxis4; callbackFF = moveStepDirMotorFFAxis4; callbackFR = moveStepDirMotorFRAxis4; break; + case 5: callback = moveStepDirMotorAxis5; callbackFF = moveStepDirMotorFFAxis5; callbackFR = moveStepDirMotorFRAxis5; break; + case 6: callback = moveStepDirMotorAxis6; callbackFF = moveStepDirMotorFFAxis6; callbackFR = moveStepDirMotorFRAxis6; break; + case 7: callback = moveStepDirMotorAxis7; callbackFF = moveStepDirMotorFFAxis7; callbackFR = moveStepDirMotorFRAxis7; break; + case 8: callback = moveStepDirMotorAxis8; callbackFF = moveStepDirMotorFFAxis8; callbackFR = moveStepDirMotorFRAxis8; break; + case 9: callback = moveStepDirMotorAxis9; callbackFF = moveStepDirMotorFFAxis9; callbackFR = moveStepDirMotorFRAxis9; break; + } +} + +bool StepDirMotor::init() { + if (ready) return true; + if (!Motor::init()) return false; + + #if DEBUG == VERBOSE + VF("MSG:"); V(axisPrefix); V("pins step="); if (Pins->step == OFF) { VF("OFF"); } else { V(Pins->step); } + VF(", dir="); if (Pins->dir == OFF) { VF("OFF"); } else { V(Pins->dir); } + VF(", en="); if (Pins->enable == OFF) { VLF("OFF"); } else if (Pins->enable == SHARED) { VLF("SHARED"); } else { VL(Pins->enable); } + #endif + + // this driver requires available pins to function + if (Pins->dir == OFF || Pins->step == OFF) { + DF("ERR:"); D(axisPrefix); DLF("step or dir pin not present!"); + return false; + } + + // init default driver direction pin for output + pinModeEx(Pins->dir, OUTPUT); + if (normalizedReverse) { dirFwd = HIGH; dirRev = LOW; } else { dirFwd = LOW; dirRev = HIGH; } + digitalWriteEx(Pins->dir, dirFwd); + direction = dirFwd; + + // init default driver step state (clear) + #ifndef DRIVER_STEP_DEFAULTS + stepSet = Pins->stepState; + stepClr = !stepSet; + #endif + pinModeEx(Pins->step, OUTPUT); + digitalWriteF(Pins->step, stepClr); + + // init default driver enable pin + if (Pins->enable != SHARED) { + pinModeEx(Pins->enable, OUTPUT); + digitalWriteEx(Pins->enable, !Pins->enabledState); + } + + // start the driver + if (!driver->init()) { DF("ERR:"); D(axisPrefix); DLF("no motor driver!"); return false; } + + // start the motor timer + VF("MSG:"); V(axisPrefix); VF("start task to move motor... "); + char timerName[] = "Motor_"; + timerName[5] = '0' + axisNumber; + taskHandle = tasks.add(0, 0, true, 0, callback, timerName); + if (taskHandle) { + V("success"); + if (useFastHardwareTimers && !tasks.requestHardwareTimer(taskHandle, 0)) { VLF(" (no hardware timer!)"); } else { VLF(""); } + } else { + VLF("FAILED!"); + return false; + } + + ready = true; + return true; +} + +void StepDirMotor::setReverse(bool state) { + if (!ready) return; + Motor::setReverse(state); + + if (reversed != normalizedReverse) { dirFwd = HIGH; dirRev = LOW; } else { dirFwd = LOW; dirRev = HIGH; } + noInterrupts(); + digitalWriteEx(Pins->dir, dirFwd); + direction = dirFwd; + interrupts(); +} + +void StepDirMotor::enable(bool state) { + if (!ready || state == enabled) return; + + if (!state) enabled = false; + + stopStepTimerAndClearPulse(); + resetToTrackingBaseline(); + + VF("MSG:"); V(axisPrefix); VF("driver powered "); VF(state ? "up" : "down"); + + bool ok = true; + + if (Pins->enable != OFF && Pins->enable != SHARED) { + VF(" using pin "); VL(Pins->enable); + digitalWriteEx(Pins->enable, state ? Pins->enabledState : !Pins->enabledState); + } else { + ok = driver->enable(state); + if (ok) { VLF(" using secondary method (if available)"); } else { VLF(" using secondary method failed"); } + } + + enabled = (state && ok); +} + +// set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) +void StepDirMotor::setFrequencySteps(float frequency) { + if (!ready) return; + + if (!enabled) { stopStepTimerAndClearPulse(); return; } + + // chart acceleration + #if DEBUG != OFF && defined(DEBUG_STEPDIR_ACCEL) + if (axisNumber == DEBUG_STEPDIR_ACCEL) { + static unsigned long t = 0; + if (millis() - t >= 100U) { + DF("Axis"); D(axisNumber); + D(" step frequency "); D(frequency); DL("Hz"); + t = millis(); + } + } + #endif + + // chart motor position + #if DEBUG != OFF && defined(DEBUG_STEPDIR_POSITION) + if (axisNumber == DEBUG_STEPDIR_POSITION) { + static unsigned long t = 0; + if (millis() - t >= 100U) { + DF("Axis"); D(axisNumber); + D(" motor step position "); D(motorSteps); + D(" motor target position "); DL(targetSteps); + t = millis(); + } + } + #endif + + if (!inBacklash) modeSwitch(); + + Y; + // negative frequency, convert to positive and reverse the direction + int dir = 0; + if (frequency > 0.0F) dir = 1; else if (frequency < 0.0F) { frequency = -frequency; dir = -1; } + + // if in backlash override the frequency OR change + // microstep mode and/or swap in fast ISRs as required + if (inBacklash) frequency = backlashFrequency; + + if (frequency != currentFrequency || microstepModeControl >= MMC_SLEWING_PAUSE) { + lastFrequency = frequency; + + // if slewing has a larger step size divide the frequency to account for it + if (microstepModeControl == MMC_SLEWING || microstepModeControl == MMC_SLEWING_READY) frequency /= stepSize; + + // frequency in steps per second to period in microsecond counts per step + // also runs the timer twice as fast if using a square wave + #if STEP_WAVE_FORM == SQUARE + float period = 500000.0F/frequency; + #else + float period = 1000000.0F/frequency; + #endif + + // range is 0 to 134 seconds/step + if (!isnan(period) && period <= 130000000.0F) { + period *= 16.0F; + lastPeriod = (unsigned long)lroundf(period); + } else { + lastPeriod = 0; + frequency = 0.0F; + dir = 0; + } + + currentFrequency = frequency; + + // change the motor rate/direction + if (step != dir) step = 0; + if (lastPeriodSet != lastPeriod) { + tasks.setPeriodSubMicros(taskHandle, lastPeriod); + lastPeriodSet = lastPeriod; + } + step = dir; + + if (microstepModeControl == MMC_TRACKING_READY) microstepModeControl = MMC_TRACKING; + if (microstepModeControl == MMC_SLEWING_READY) { + #if DEBUG == VERBOSE + VF("MSG:"); V(axisPrefix); VF("high speed swap in took "); V(millis() - switchStartTimeMs); VLF(" ms"); + #endif + microstepModeControl = MMC_SLEWING; + } + + } else { + noInterrupts(); + step = dir; + interrupts(); + } +} + +// switch microstep modes as needed +void StepDirMotor::modeSwitch() { + if (lastFrequency <= backlashFrequency*2.0F) { + if (microstepModeControl >= MMC_SLEWING) { + microstepModeControl = MMC_TRACKING_READY; + + enableMoveFast(false); + + if (driver->modeSwitchAllowed || driver->modeSwitchFastAllowed) { + VF("MSG:"); V(axisPrefix); VLF("mode switch tracking set"); + driver->modeMicrostepTracking(); + } + } + } else { + if (microstepModeControl == MMC_TRACKING) { + noInterrupts(); + if (!sync || (step == -1 && direction == dirRev) || (step == 1 && direction == dirFwd)) { + microstepModeControl = MMC_SLEWING_REQUEST; + } + interrupts(); + switchStartTimeMs = millis(); + } else + if (microstepModeControl == MMC_SLEWING_PAUSE) { + if (driver->modeSwitchAllowed || driver->modeSwitchFastAllowed) { + VF("MSG:"); V(axisPrefix); VLF("mode switch slewing set"); + stepSize = driver->modeMicrostepSlewing(); + } + enableMoveFast(true); + microstepModeControl = MMC_SLEWING_READY; + } + } +} + +float StepDirMotor::getFrequencySteps() { + if (!ready) return 0.0F; + + if (lastPeriod == 0) return 0; + #if STEP_WAVE_FORM == SQUARE + return 8000000.0F/lastPeriod; + #else + return 16000000.0F/lastPeriod; + #endif +} + +// set slewing state (hint that we are about to slew or are done slewing) +void StepDirMotor::setSlewing(bool state) { + if (!ready) return; + + if (state == true) driver->modeDecaySlewing(); else driver->modeDecayTracking(); +} + +bool StepDirMotor::isStalled() { + if (!ready || !enabled || !driver) return false; + if (!driver->hasStallDetect()) return false; +// if (microstepModeControl != MMC_SLEWING) return false; + return driver->isStalled(step >= 0 ? lastFrequency : -lastFrequency); +} + +// swaps in/out fast unidirectional ISR for slewing +bool StepDirMotor::enableMoveFast(const bool fast) { + if (fast) { + if (direction == dirRev) { + tasks.setCallback(taskHandle, callbackFR); + VF("MSG:"); V(axisPrefix); VF("high speed Rev ISR swapped in at "); V(lastFrequency); VLF(" steps/sec."); + } else { + tasks.setCallback(taskHandle, callbackFF); + VF("MSG:"); V(axisPrefix); VF("high speed Fwd ISR swapped in at "); V(lastFrequency); VLF(" steps/sec."); + } + } else { + tasks.setCallback(taskHandle, callback); + VF("MSG:"); V(axisPrefix); VF("high speed ISR swapped out at "); V(lastFrequency); VL(" steps/sec."); + } + return true; +} + +// gard local guarantee: stop the step generator and force STEP inactive. +void StepDirMotor::stopStepTimerAndClearPulse() { + + // clear any previously latched stall state now that we're "stopped" + if (driver->hasStallDetect()) driver->stallDetectReset(); + + // already stopped? + if (lastPeriod == 0 && lastPeriodSet == 0 && step == 0 && !takeStep) { + digitalWriteF(Pins->step, stepClr); + takeStep = false; + return; + } + + // stop task first + if (taskHandle) tasks.setPeriodSubMicros(taskHandle, 0); + + // clear bookkeeping + lastPeriod = 0; + lastPeriodSet = 0; + currentFrequency = 0.0F; + lastFrequency = 0.0F; + + noInterrupts(); + step = 0; + takeStep = false; + interrupts(); + + // force STEP low so we don't leave a high level latched + digitalWriteF(Pins->step, stepClr); +} + +// clears backlash/state, sets microstep tracking, etc. +void StepDirMotor::resetToTrackingBaseline() { + if (taskHandle) tasks.setCallback(taskHandle, callback); + + noInterrupts(); + // clear any pending synthetic motion state + step = 0; + takeStep = false; + + // clear backlash state so next start is “clean” + inBacklash = false; + backlashSteps = 0; + + interrupts(); + + microstepModeControl = MMC_TRACKING; + stepSize = 1; + + #if defined(GPIO_DIRECTION_PINS) + if (direction > DirNone) updateMotorDirection(); + #endif + + if (driver->modeSwitchAllowed || driver->modeSwitchFastAllowed) driver->modeMicrostepTracking(); + + // force STEP low so we don't leave a high level latched + digitalWriteF(Pins->step, stepClr); +} + +#if defined(GPIO_DIRECTION_PINS) + // change motor direction on request by polling + IRAM_ATTR void StepDirMotor::updateMotorDirection() { + if (direction == DirSetRev) { + digitalWriteEx(Pins->dir, dirRev); + direction = dirRev; + } else + if (direction == DirSetFwd) { + digitalWriteEx(Pins->dir, dirFwd); + direction = dirFwd; + } + } +#endif + +IRAM_ATTR void StepDirMotor::move(const int16_t stepPin) { + #if STEP_WAVE_FORM == PULSE + digitalWriteF(stepPin, stepClr); + #endif + + #ifdef GPIO_DIRECTION_PINS + if (direction > DirNone) return; + #endif + + if (microstepModeControl == MMC_SLEWING_REQUEST && (motorSteps + backlashSteps) % driver->getMicrostepRatio() == 0 && direction < DirNone) { + microstepModeControl = MMC_SLEWING_PAUSE; + tasks.immediate(monitorHandle); + } + if (microstepModeControl >= MMC_SLEWING_PAUSE) return; + + #if STEP_WAVE_FORM == SQUARE + if (takeStep) { + #endif + + long lastTargetSteps = targetSteps; + if (sync && !inBacklash) targetSteps += step; + + if (motorSteps > targetSteps || (inBacklash && direction == dirRev)) { + if (direction != dirRev) { + targetSteps = lastTargetSteps; + #ifdef GPIO_DIRECTION_PINS + direction = DirSetRev; + #else + direction = dirRev; + digitalWriteF(Pins->dir, dirRev); + #endif + return; + } + + if (backlashSteps > 0) { + backlashSteps--; + inBacklash = backlashSteps > 0; + } else { + motorSteps--; + inBacklash = false; + } + + #ifdef SHARED_DIRECTION_PINS + if (axisNumber > 2) { digitalWriteF(Pins->dir, direction); delayNanoseconds(pulseWidth); } + #endif + digitalWriteF(stepPin, stepSet); + } else + + if (motorSteps < targetSteps || (inBacklash && direction == dirFwd)) { + if (direction != dirFwd) { + targetSteps = lastTargetSteps; + #ifdef GPIO_DIRECTION_PINS + direction = DirSetFwd; + #else + direction = dirFwd; + digitalWriteF(Pins->dir, dirFwd); + #endif + return; + } + + if (backlashSteps < backlashAmountSteps) { + backlashSteps++; + inBacklash = backlashSteps < backlashAmountSteps; + } else { + motorSteps++; + inBacklash = false; + } + + #ifdef SHARED_DIRECTION_PINS + if (axisNumber > 2) { digitalWriteF(Pins->dir, direction); delayNanoseconds(pulseWidth); } + #endif + digitalWriteF(stepPin, stepSet); + + } else if (!inBacklash) direction = DirNone; + + #if STEP_WAVE_FORM == SQUARE + } else digitalWriteF(stepPin, stepClr); + takeStep = !takeStep; + #endif +} + +IRAM_ATTR void StepDirMotor::moveFF(const int16_t stepPin) { + #if STEP_WAVE_FORM == PULSE + digitalWriteF(stepPin, stepClr); + #endif + + if (microstepModeControl >= MMC_SLEWING_PAUSE) return; + + #if STEP_WAVE_FORM == SQUARE + if (takeStep) { + #endif + + if (sync) targetSteps += stepSize; + + if (motorSteps < targetSteps) { + motorSteps += stepSize; + + #ifdef SHARED_DIRECTION_PINS + if (axisNumber > 2) { digitalWriteF(Pins->dir, direction); delayNanoseconds(pulseWidth); } + #endif + digitalWriteF(stepPin, stepSet); + } + + #if STEP_WAVE_FORM == SQUARE + } else digitalWriteF(stepPin, stepClr); + takeStep = !takeStep; + #endif +} + +IRAM_ATTR void StepDirMotor::moveFR(const int16_t stepPin) { + #if STEP_WAVE_FORM == PULSE + digitalWriteF(stepPin, stepClr); + #endif + + if (microstepModeControl >= MMC_SLEWING_PAUSE) return; + + #if STEP_WAVE_FORM == SQUARE + if (takeStep) { + #endif + + if (sync) targetSteps -= stepSize; + + if (motorSteps > targetSteps) { + motorSteps -= stepSize; + + #ifdef SHARED_DIRECTION_PINS + if (axisNumber > 2) { digitalWriteF(Pins->dir, direction); delayNanoseconds(pulseWidth); } + #endif + digitalWriteF(stepPin, stepSet); + } + + #if STEP_WAVE_FORM == SQUARE + } else digitalWriteF(stepPin, stepClr); + takeStep = !takeStep; + #endif +} + +#endif diff --git a/src/lib/axis/motor/stepDir/StepDir.h b/src/lib/axis/motor/stepDir/StepDir.h new file mode 100755 index 0000000..5d9e3b1 --- /dev/null +++ b/src/lib/axis/motor/stepDir/StepDir.h @@ -0,0 +1,179 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor +#pragma once + +#include "../../../../Common.h" + +#ifdef STEP_DIR_MOTOR_PRESENT + +#if defined(GPIO_DIRECTION_PINS) && defined(SHARED_DIRECTION_PINS) + #error "Configuration (Config.h): Having both GPIO_DIRECTION_PINS and SHARED_DIRECTION_PINS is not allowed" +#endif + +#include "../../../gpioEx/GpioEx.h" + +#include "generic/Generic.h" +#include "tmc/legacy/tmc2130/Tmc2130.h" +#include "tmc/legacy/tmc2209/Tmc2209.h" +#include "tmc/legacy/tmc5160/Tmc5160.h" +#include "tmc/tmcStepper/tmc2130/Tmc2130.h" +#include "tmc/tmcStepper/tmc2160/Tmc2160.h" +#include "tmc/tmcStepper/tmc2208/tmc2208.h" +#include "tmc/tmcStepper/tmc2209/Tmc2209.h" +#include "tmc/tmcStepper/tmc2660/Tmc2660.h" +#include "tmc/tmcStepper/tmc5160/Tmc5160.h" +#include "tmc/tmcStepper/tmc5161/Tmc5161.h" +#include "../Motor.h" + +typedef struct StepDirPins { + int16_t step; + uint8_t stepState; + int16_t dir; + int16_t enable; + uint8_t enabledState; +} StepDirPins; + +#define DirNone 253 +#define DirSetRev 254 +#define DirSetFwd 255 + +enum MicrostepModeControl: uint8_t {MMC_TRACKING, MMC_SLEWING, MMC_SLEWING_REQUEST, MMC_SLEWING_PAUSE, MMC_SLEWING_READY, MMC_TRACKING_READY}; + +class StepDirMotor : public Motor { + public: + // constructor + StepDirMotor(uint8_t axisNumber, int8_t reverse, const StepDirPins *Pins, StepDirDriver *Driver, bool useFastHardwareTimers = true); + + // sets up the driver step/dir/enable pins + bool init(); + + // revert settings to defaults + void useDefaults() { driver->useDefaults(); } + + // returns the number of parameters from the motor/driver + uint8_t getParameterCount() { return Motor::getParameterCount() + driver->getParameterCount(); } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { + if (number > Motor::getParameterCount()) return driver->getParameter(number - Motor::getParameterCount()); else + if (number >= 1 && number <= Motor::getParameterCount()) return Motor::getParameter(number); else + return &invalid; + } + + // check if parameter is valid + bool parameterIsValid(AxisParameter* parameter, bool next = false) { + if (!Motor::parameterIsValid(parameter, next)) return false; else return driver->parameterIsValid(parameter, next); + } + + // sets reversal of axis directions + // \param state: true reverses the direction behavior specified in settings + void setReverse(bool state); + + // sets motor enable on/off (if possible) + void enable(bool value); + + // get the associated stepper driver status + DriverStatus getDriverStatus() { if (ready) { driver->updateStatus(); return driver->getStatus(); } else return errorStatus; } + + // get movement frequency in steps per second + float getFrequencySteps(); + + // set frequency (+/-) in steps per second negative frequencies move reverse in direction (0 stops motion) + void setFrequencySteps(float frequency); + + // sets overall maximum frequency + // \param frequency: rate of motion in steps (counts) per second + void setFrequencyMax(float frequency) { + driver->setFrequencyMax(frequency); + } + + // get tracking mode steps per slewing mode step + inline int getStepsPerStepSlewing() { return driver->getMicrostepRatio(); } + + // microstep sequencer steps + int getSequencerSteps() { return driver->getMicrostepMode(); }; + + // set slewing state (hint that we are about to slew or are done slewing) + void setSlewing(bool state); + + // signal that the motor load has exceeded its threshold + bool isStalled(); + + // calibrate stealthChop then return to tracking mode + void calibrateDriver() { + if (!ready) return; + digitalWriteEx(Pins->enable, Pins->enabledState); + driver->calibrateDriver(); + digitalWriteEx(Pins->enable, !Pins->enabledState); + } + + #if defined(GPIO_DIRECTION_PINS) + // monitor and respond to motor state as required + void poll() { updateMotorDirection(); } + + // change motor direction on request by polling + void updateMotorDirection(); + #endif + + // sets dir as required and moves coord toward target at setFrequencySteps() rate + void move(const int16_t stepPin); + + // fast forward axis movement, no backlash, no mode switching + void moveFF(const int16_t stepPin); + + // fast reverse axis movement, no backlash, no mode switching + void moveFR(const int16_t stepPin); + + // get the motor name + const char* name() { strcpy(nameStr, "Step/Dir, "); strcat(nameStr, driver->name()); return nameStr; } + + // a stepper motor driver, should not be used above the StepDir class + StepDirDriver *driver; + + // the stepper motor driver pins, should not be used above the StepDir class + const StepDirPins *Pins; + + private: + // switch microstep modes as needed + void modeSwitch(); + + // swaps in/out fast unidirectional ISR for slewing + bool enableMoveFast(const bool state); + + void stopStepTimerAndClearPulse(); + + void resetToTrackingBaseline(); + + uint8_t taskHandle = 0; + + #ifdef DRIVER_STEP_DEFAULTS + #define stepClr LOW // pin state to reset driver before taking a step + #define stepSet HIGH // pin state to take a step + #else + volatile uint8_t stepClr = LOW; // pin state to reset driver before taking a step + volatile uint8_t stepSet = HIGH; // pin state to take a step + #endif + volatile uint8_t dirFwd = LOW; // pin state for forward direction + volatile uint8_t dirRev = HIGH; // pin state for reverse direction + volatile uint8_t direction = LOW; // current direction in use + volatile uint32_t pulseWidth = 2000; // step/dir driver pulse width in nanoseconds + + volatile int16_t stepSize = 1; // step size during slews (for microstep mode switching) + volatile bool takeStep = false; // should we take a step + + float currentFrequency = 0.0F; // last frequency set + float lastFrequency = 0.0F; // last frequency requested in tracking mode microsteps per second + unsigned long lastPeriod = 0; // last timer period (in sub-micros) + unsigned long lastPeriodSet = 0; // last timer period actually set (in sub-micros) + unsigned long switchStartTimeMs; // log time to switch microstep mode and do ISR swap + + volatile MicrostepModeControl microstepModeControl = MMC_TRACKING; + + bool useFastHardwareTimers = true; + + void (*callback)() = NULL; + void (*callbackFF)() = NULL; + void (*callbackFR)() = NULL; +}; + +#endif \ No newline at end of file diff --git a/src/lib/axis/motor/stepDir/StepDirDriver.cpp b/src/lib/axis/motor/stepDir/StepDirDriver.cpp new file mode 100755 index 0000000..2ec800b --- /dev/null +++ b/src/lib/axis/motor/stepDir/StepDirDriver.cpp @@ -0,0 +1,310 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver + +#include "StepDirDriver.h" + +#ifdef STEP_DIR_MOTOR_PRESENT + +#include "../../../gpioEx/GpioEx.h" + +// the various microsteps for different driver models, with the bit modes for each +#define DRIVER_MODEL_COUNT 22 + +const static int8_t steps[DRIVER_MODEL_COUNT][9] = +// 1 2 4 8 16 32 64 128 256x +{ + { 0, 1, 2, 3, 7,OFF,OFF,OFF,OFF}, // A4988 + { 0, 1, 2, 3, 4, 5,OFF,OFF,OFF}, // DRV8825 + { 0, 4, 4, 4, 4, 4, 4, 4, 4}, // GENERIC + { 0, 1, 2, 3, 4, 5, 6, 7,OFF}, // LV8729 + { 4, 2, 6, 5, 3, 7,OFF,OFF,OFF}, // S109 + { 0, 1, 2, 3, 4, 5,OFF, 6, 7}, // ST820 + { 0, 1, 2, 3, 4, 5, 6, 7,OFF}, // RAPS128 + { 0, 1, 2,OFF, 3,OFF,OFF,OFF,OFF}, // TMC2100 + { 0, 1, 2,OFF, 3,OFF,OFF,OFF,OFF}, // TMC2130S + {OFF, 1, 2, 0, 3,OFF,OFF,OFF,OFF}, // TMC2208S + {OFF,OFF, 0, 1, 2, 3,OFF,OFF,OFF}, // TMC2225S + {OFF,OFF,OFF, 0, 3, 1, 2,OFF,OFF}, // TMC2209S + {OFF,OFF,OFF, 0, 3, 1, 2,OFF,OFF}, // TMC2226S + + { 8, 7, 6, 5, 4, 3, 2, 1, 0}, // TMC2130 + { 8, 7, 6, 5, 4, 3, 2, 1, 0}, // TMC2160 + { 8, 7, 6, 5, 4, 3, 2, 1, 0}, // TMC2660 + { 8, 7, 6, 5, 4, 3, 2, 1, 0}, // TMC5160 + { 8, 7, 6, 5, 4, 3, 2, 1, 0}, // TMC5161 + + { 8, 7, 6, 5, 4, 3, 2, 1, 0}, // TMC2208 + { 8, 7, 6, 5, 4, 3, 2, 1, 0}, // TMC2225 + { 8, 7, 6, 5, 4, 3, 2, 1, 0}, // TMC2209 + { 8, 7, 6, 5, 4, 3, 2, 1, 0}, // TMC2226 +}; + +const static int16_t DriverPulseWidth[DRIVER_MODEL_COUNT] = +// minimum step pulse width, in ns +{ + 1000, // A4988 + 2000, // DRV8825 + OFF, // GENERIC + 500, // LV8729 + 7000, // RAPS128 + 300, // S109 + 20, // ST820 + 103, // TMC2100 + 103, // TMC2130S + 103, // TMC2208S + 103, // TMC2225S + 103, // TMC2209S + 103, // TMC2226S + + 103, // TMC2130 + 103, // TMC2160 + 103, // TMC2660 + 103, // TMC5160 + 103, // TMC5161 + + 103, // TMC2208 + 103, // TMC2225 + 103, // TMC2209 + 103, // TMC2226 +}; + +const char* DRIVER_NAME[DRIVER_MODEL_COUNT] = { + "A4988", + "DRV8825", + "GENERIC", + "LV8729", + "RAPS128", + "S109", + "ST820", + "TMC2100", + "TMC2130", + "TMC2208", + "TMC2225", + "TMC2209", + "TMC2226", + + "TMC2130 (SPI)", + "TMC2160 (SPI)", + "TMC2660 (SPI)", + "TMC5160 (SPI)", + "TMC5161 (SPI)", + + "TMC2208 (UART)", + "TMC2225 (UART)", + "TMC2209 (UART)", + "TMC2226 (UART)", +}; + +StepDirDriver::StepDirDriver(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings) { + this->axisNumber = axisNumber; + + this->Pins = Pins; + + driverModel = Settings->model; + statusMode = Settings->status; + + microsteps.valueDefault = Settings->microsteps; + microstepsSlewing.valueDefault = Settings->microstepsSlewing; + + if (microsteps.valueDefault == OFF) microsteps.valueDefault = 1.0F; + if (microstepsSlewing.valueDefault == OFF) microstepsSlewing.valueDefault = microsteps.valueDefault; + + decay.valueDefault = Settings->decay; + decaySlewing.valueDefault = Settings->decaySlewing; +} + +bool StepDirDriver::init() { + if (driverModel >= DRIVER_MODEL_COUNT) { + DF("ERR:"); D(axisPrefix); DLF("invalid driver model"); + return false; + } + + VF("MSG:"); V(axisPrefix); VL(name()); + + // check if platform pulse width (ns) is ok for this stepper driver timing in PULSE mode + #if STEP_WAVE_FORM == PULSE + long pulseWidth = HAL_PULSE_WIDTH; + if (axisNumber > 2) pulseWidth = 2000; + + if (DriverPulseWidth[driverModel] == OFF) { + VF("MSG:"); V(axisPrefix); V(DRIVER_NAME[driverModel]); VLF(" min. pulse width unknown!"); + } + + if (DriverPulseWidth[driverModel] > pulseWidth) { + DF("WRN:"); D(axisPrefix); D(DRIVER_NAME[driverModel]); + DF(" min. pulse width "); D(DriverPulseWidth[driverModel]); DF("ns > platform at "); D(pulseWidth); DLF("ns"); + return false; + } + #endif + + normalizedMicrosteps = lround(microsteps.value); + normalizedMicrostepsSlewing = lround(microstepsSlewing.value); + VF("MSG:"); V(axisPrefix); VF("microstep mode "); V(microsteps.value); VF("X"); + VF(" (goto mode "); V(microstepsSlewing.value); VL("X)"); + + // set parmeter min/max to cover range of available microsteps for this driver + int microstep[9] = {1, 2, 4, 8, 16, 32, 64, 128, 256}; + int lowestMode = 256; + int highestMode = 1; + for (int i = 0; i < 9; i++) { + if (subdivisionsToCode(microstep[i]) != OFF) { + if (microstep[i] < lowestMode) lowestMode = microstep[i]; + if (microstep[i] > highestMode) highestMode = microstep[i]; + } + } + microsteps.min = lowestMode; + microstepsSlewing.min = lowestMode; + microsteps.max = highestMode; + microstepsSlewing.max = highestMode; + + microstepCode = subdivisionsToCode(normalizedMicrosteps); + microstepCodeSlewing = subdivisionsToCode(normalizedMicrostepsSlewing); + + if (microstepCode == OFF || microstepCodeSlewing == OFF) { + DF("MSG:"); D(axisPrefix); DLF("invalid microstep mode for this driver."); + return false; + } + + microstepRatio = normalizedMicrosteps/normalizedMicrostepsSlewing; + + normalizedDecay = lround(decay.value); + normalizedDecaySlewing = lround(decaySlewing.value); + + // automatically set fault status for known drivers + if (statusMode == ON) { + switch (driverModel) { + case DRV8825: statusMode = LOW; break; + case ST820: statusMode = LOW; break; + default: break; + } + } + + // disable certain status modes if the fault pin isn't defined + if ((statusMode == LOW || statusMode == HIGH) && Pins->fault == OFF) { + statusMode = OFF; + } + + // flag status as active or not + status.active = statusMode != OFF; + + // set fault pin mode + if (statusMode == LOW) pinModeEx(Pins->fault, INPUT_PULLUP); + #ifdef PULLDOWN + if (statusMode == HIGH) pinModeEx(Pins->fault, INPUT_PULLDOWN); + #else + if (statusMode == HIGH) pinModeEx(Pins->fault, INPUT); + #endif + + // check to see if the driver is ok if we're using a fault pin + if (statusMode == LOW || statusMode == HIGH) { + status.fault = digitalReadEx(Pins->fault) == statusMode; + if (status.fault) { + DF("ERR:"); D(axisPrefix); DLF("motor driver device fault!"); + return false; + } else { + VF("MSG:"); V(axisPrefix); VLF("motor driver device ok"); + } + } + + return true; +} + +bool StepDirDriver::parameterIsValid(AxisParameter* parameter, bool next) { + if (parameter == µsteps || parameter == µstepsSlewing) { + + int microstepsValue, microstepsSlewingValue; + if (next) { + microstepsValue = lround(microsteps.valueNv); + microstepsSlewingValue = lround(microstepsSlewing.valueNv); + } else { + microstepsValue = lround(microsteps.value); + microstepsSlewingValue = lround(microstepsSlewing.value); + } + + if (subdivisionsToCode(microstepsValue) == OFF) { + DF("WRN:"); D(axisPrefix); DLF("unsupported microsteps value"); + return false; + } + if (subdivisionsToCode(microstepsSlewingValue) == OFF) { + DF("WRN:"); D(axisPrefix); DLF("unsupported microsteps slewing value"); + return false; + } + if (microstepsValue < microstepsSlewingValue) { + DF("WRN:"); D(axisPrefix); + DF("bad microsteps "); D(microstepsValue); + DF(" must be >= microstepsGoto "); DL(microstepsSlewingValue); + return false; + } + } + return true; +} + +// get the pulse width in nanoseconds, if unknown (-1) returns 2000 nanoseconds +long StepDirDriver::getPulseWidth() { + long ns = DriverPulseWidth[driverModel]; + if (ns < 0) ns = 2000; + return ns; +} + +// different models of stepper drivers have different bit settings for microsteps +// translate the human readable microsteps in the configuration to mode bit settings +// returns bit code (0 to 7) or OFF if microsteps is not supported or unknown +int StepDirDriver::subdivisionsToCode(long microsteps) { + int allowed[9] = {1,2,4,8,16,32,64,128,256}; + if (driverModel >= DRIVER_MODEL_COUNT) return OFF; + for (int i = 0; i < 9; i++) { + if (microsteps == allowed[i]) return steps[driverModel][i]; + } + return OFF; +} + +// get the driver name +const char* StepDirDriver::name() { + return DRIVER_NAME[driverModel]; +} + +// update status info. for driver +void StepDirDriver::updateStatus() { + if (statusMode == ON) { + const unsigned long now = millis(); + + if (now - timeLastStatusUpdate > 200U) { + readStatus(); + + // open load indication is not reliable in standstill + status.fault = status.outputA.shortToGround || + status.outputB.shortToGround || + status.overTemperatureWarning || + status.overTemperature; + + timeLastStatusUpdate = now; + } + } else + if (statusMode == LOW || statusMode == HIGH) { + status.fault = digitalReadEx(Pins->fault) == statusMode; + } + + #if DEBUG == VERBOSE + if ((status.outputA.shortToGround != lastStatus.outputA.shortToGround) || +// (status.outputA.openLoad != lastStatus.outputA.openLoad) || + (status.outputB.shortToGround != lastStatus.outputB.shortToGround) || +// (status.outputB.openLoad != lastStatus.outputB.openLoad) || + (status.overTemperatureWarning != lastStatus.overTemperatureWarning) || + (status.overTemperature != lastStatus.overTemperature) || +// (status.standstill != lastStatus.standstill) || + (status.fault != lastStatus.fault)) { + VF("MSG:"); V(axisPrefix); + VF("SGA"); if (status.outputA.shortToGround) VF("< "); else VF(". "); + VF("OLA"); if (status.outputA.openLoad) VF("< "); else VF(". "); + VF("SGB"); if (status.outputB.shortToGround) VF("< "); else VF(". "); + VF("OLB"); if (status.outputB.openLoad) VF("< "); else VF(". "); + VF("OTP"); if (status.overTemperatureWarning) VF("< "); else VF(". "); + VF("OTE"); if (status.overTemperature) VF("< "); else VF(". "); + VF("SST"); if (status.standstill) VF("< "); else VF(". "); + VF("FLT"); if (status.fault) VLF("<"); else VLF("."); + } + lastStatus = status; + #endif +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/StepDirDriver.h b/src/lib/axis/motor/stepDir/StepDirDriver.h new file mode 100755 index 0000000..92a8155 --- /dev/null +++ b/src/lib/axis/motor/stepDir/StepDirDriver.h @@ -0,0 +1,146 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver +#pragma once + +#include +#include "../../../../Common.h" + +#ifdef STEP_DIR_MOTOR_PRESENT + +#include "../Drivers.h" + +typedef struct StepDirDriverPins { + int16_t m0; + int16_t m1; + int16_t m2; + uint8_t m2State; + int16_t m3; + int16_t decay; + int16_t fault; +} StepDirDriverPins; + +typedef struct StepDirDriverSettings { + int16_t model; + int8_t status; + int16_t microsteps; + int16_t microstepsSlewing; + int8_t decay; + int8_t decaySlewing; +} StepDirDriverSettings; + +class StepDirDriver { + public: + StepDirDriver(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings); + + // set up driver + virtual bool init(); + + // revert settings to defaults + virtual void useDefaults() { return; } + + // returns the number of axis parameters + virtual uint8_t getParameterCount() { return 0; } + + // returns the specified axis parameter + virtual AxisParameter* getParameter(uint8_t number) { UNUSED(number); return &invalid; } + + // check if axis parameter is valid + virtual bool parameterIsValid(AxisParameter* parameter, bool next = false); + + // set microstep mode for tracking + virtual void modeMicrostepTracking() {} + + // set microstep mode for slewing + virtual int modeMicrostepSlewing() { return 1; } + + // set decay mode for tracking + virtual void modeDecayTracking() {} + + // set decay mode for slewing + virtual void modeDecaySlewing() {} + + // get microstep ratio for slewing + inline int getMicrostepRatio() { return microstepRatio; } + + // get microstep mode used for tracking + inline int getMicrostepMode() { return normalizedMicrosteps; } + + // update status info. for driver + virtual void updateStatus(); + + // get status info. + inline DriverStatus getStatus() { return status; } + + // secondary way to power down not using the enable pin + // default assume the driver is always enabled, i.e. no control + virtual bool enable(bool state) { UNUSED(state); return true; } + + // sets frequency corrosponding to the fastest allowed slew rate + // \param frequency: rate of motion in steps per second + void setFrequencyMax(float frequency) { velocityMax = frequency; } + + // calibrate the motor driver if required + virtual void calibrateDriver() {} + + // determine if this motor can detect a stall + virtual bool hasStallDetect() const { return false; } + + // check to if the motor is stalled + virtual bool isStalled(float stepsPerSec) { (void)stepsPerSec; return false; } + + // reset any internal stall-detect state (baseline, latch, etc.) + virtual void stallDetectReset() {} + + // get the pulse width in nanoseconds, if unknown (-1) returns 2000 nanoseconds + long getPulseWidth(); + + // get the driver name + virtual const char* name(); + + // true if switching microstep modes at low speed is allowed + bool modeSwitchAllowed = false; + + // true if switching microstep modes at high speed is allowed + bool modeSwitchFastAllowed = false; + + protected: + // read status from driver + virtual void readStatus() {} + + // different models of stepper drivers have different bit settings for microsteps + // translate the human readable microsteps in the configuration to mode bit settings + // returns bit code (0 to 7) or OFF if microsteps is not supported or unknown + int subdivisionsToCode(long microsteps); + + uint8_t axisNumber; + char axisPrefix[32]; // prefix for debug messages + + DriverStatus status = {false, {false, false}, {false, false}, false, false, false, false}; + #if DEBUG != OFF + DriverStatus lastStatus = {false, {false, false}, {false, false}, false, false, false, false}; + #endif + unsigned long timeLastStatusUpdate = 0; + + const StepDirDriverPins *Pins; + + int16_t driverModel = 0; + int16_t statusMode; + int16_t normalizedMicrosteps; + int16_t normalizedMicrostepsSlewing; + int16_t normalizedDecay; + int16_t normalizedDecaySlewing; + int16_t microstepRatio = 1; + int16_t microstepCode = OFF; + int16_t microstepCodeSlewing = OFF; + + float velocityMax = 1.0F; // frequency corrosponding to the fastest allowed slew rate, in microsteps/s + + // runtime adjustable settings + AxisParameter invalid = {NAN, NAN, NAN, NAN, NAN, AXP_INVALID, ""}; + AxisParameter microsteps = {NAN, NAN, NAN, 1, 256, AXP_POW2, AXPN_MICROSTEPS}; + AxisParameter microstepsSlewing = {NAN, NAN, NAN, 1, 256, AXP_POW2, AXPN_MICROSTEPS_GOTO}; + AxisParameter decay = {NAN, NAN, NAN, DRIVER_DECAY_MODE_FIRST, DRIVER_DECAY_MODE_LAST, AXP_DECAY, AXPN_DECAY_MODE}; + AxisParameter decaySlewing = {NAN, NAN, NAN, DRIVER_DECAY_MODE_FIRST, DRIVER_DECAY_MODE_LAST, AXP_DECAY, AXPN_DECAY_MODE_GOTO}; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/generic/Generic.cpp b/src/lib/axis/motor/stepDir/generic/Generic.cpp new file mode 100755 index 0000000..9379f41 --- /dev/null +++ b/src/lib/axis/motor/stepDir/generic/Generic.cpp @@ -0,0 +1,113 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver + +#include "Generic.h" + +#ifdef STEP_DIR_LEGACY_PRESENT + +#include "../../../../gpioEx/GpioEx.h" + +// constructor +StepDirGeneric::StepDirGeneric(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings) : StepDirDriver(axisNumber, Pins, Settings) { + strcpy(axisPrefix, " Axis_StepDirGeneric, "); + axisPrefix[5] = '0' + axisNumber; +} + +// setup driver +bool StepDirGeneric::init() { + if (!StepDirDriver::init()) return false; + + m0Pin = Pins->m0; + m1Pin = Pins->m1; + if (isDecayOnM2()) { decayPin = Pins->m2; m2Pin = OFF; } else { decayPin = Pins->decay; m2Pin = Pins->m2; } + pinModeEx(decayPin, OUTPUT); + digitalWriteEx(decayPin, getDecayPinState(normalizedDecay)); + + #if DEBUG == VERBOSE + VF("MSG: StepDirDriver"); V(axisNumber); + V(", pins m0="); if (Pins->m0 == OFF) V("OFF"); else V(Pins->m0); + V(", m1="); if (Pins->m1 == OFF) VF("OFF"); else V(Pins->m1); + V(", m2="); if (m2Pin == OFF) VF("OFF"); else V(m2Pin); + V(", decay="); if (decayPin == OFF) VF("OFF"); else V(decayPin); + if (statusMode == ON) { + V(", fault="); if (Pins->fault == OFF) VF("OFF"); else V(Pins->fault); + } + VL(""); + #endif + + // toggle the M2 pin states if needed, this allows extra flexibility for stand alone stepper drivers + if (Pins->m2State == LOW) { + if (bitRead(microstepCode, 2)) bitClear(microstepCode, 2); else bitSet(microstepCode, 2); + if (bitRead(microstepCodeSlewing, 2)) bitClear(microstepCodeSlewing, 2); else bitSet(microstepCodeSlewing, 2); + } + + microstepBitCode = microstepCode; + microstepBitCodeM0 = bitRead(microstepBitCode, 0); + microstepBitCodeM1 = bitRead(microstepBitCode, 1); + microstepBitCodeM2 = bitRead(microstepBitCode, 2); + + microstepBitCodeGoto = microstepCodeSlewing; + microstepBitCodeGotoM0 = bitRead(microstepBitCodeGoto, 0); + microstepBitCodeGotoM1 = bitRead(microstepBitCodeGoto, 1); + microstepBitCodeGotoM2 = bitRead(microstepBitCodeGoto, 2); + + pinModeEx(m0Pin, OUTPUT); + digitalWriteEx(m0Pin, microstepBitCodeM0); + pinModeEx(m1Pin, OUTPUT); + digitalWriteEx(m1Pin, microstepBitCodeM1); + pinModeEx(m2Pin, OUTPUT); + digitalWriteEx(m2Pin, microstepBitCodeM2); + + // set mode switching support flags + // use high speed mode + modeSwitchAllowed = false; + modeSwitchFastAllowed = microstepRatio != 1; + VF("MSG: StepDirDriver"); V(axisNumber); + if (modeSwitchAllowed) { VLF(", ModeSwitch Allowed"); }else { VLF(", ModeSwitch Disabled"); } + VF("MSG: StepDirDriver"); V(axisNumber); + if (modeSwitchFastAllowed) { VLF(", ModeSwitchFast Allowed"); } else { VLF(", ModeSwitchFast Disabled"); } + + return true; +} + +IRAM_ATTR void StepDirGeneric::modeMicrostepTracking() { + if (m0Pin != OFF) digitalWriteF(m0Pin, microstepBitCodeM0); + if (m1Pin != OFF) digitalWriteF(m1Pin, microstepBitCodeM1); + digitalWriteEx(m2Pin, microstepBitCodeM2); +} + +IRAM_ATTR int StepDirGeneric::modeMicrostepSlewing() { + if (microstepRatio > 1) { + if (m0Pin != OFF) digitalWriteF(m0Pin, microstepBitCodeGotoM0); + if (m1Pin != OFF) digitalWriteF(m1Pin, microstepBitCodeGotoM1); + digitalWriteEx(m2Pin, microstepBitCodeGotoM2); + } + return microstepRatio; +} + +void StepDirGeneric::modeDecayTracking() { + if (normalizedDecay == OFF) return; + int8_t state = getDecayPinState(normalizedDecay); + if (state != OFF) digitalWriteEx(decayPin, state); +} + +void StepDirGeneric::modeDecaySlewing() { + if (normalizedDecaySlewing == OFF) return; + int8_t state = getDecayPinState(normalizedDecaySlewing); + if (state != OFF) digitalWriteEx(decayPin, state); +} + +int8_t StepDirGeneric::getDecayPinState(int8_t decay) { + uint8_t state = OFF; + if (decay == SPREADCYCLE) state = HIGH; else + if (decay == STEALTHCHOP) state = LOW; else + if (decay == MIXED) state = LOW; else + if (decay == FAST) state = HIGH; + return state; +} + +bool StepDirGeneric::isDecayOnM2() { + if (driverModel == TMC2209S || driverModel == TMC2225S) return true; else return false; +} + +#endif diff --git a/src/lib/axis/motor/stepDir/generic/Generic.h b/src/lib/axis/motor/stepDir/generic/Generic.h new file mode 100755 index 0000000..e0694b9 --- /dev/null +++ b/src/lib/axis/motor/stepDir/generic/Generic.h @@ -0,0 +1,68 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver +#pragma once + +#include +#include "../../../../../Common.h" + +#ifdef STEP_DIR_LEGACY_PRESENT + +#include "../../Drivers.h" +#include "../StepDirDriver.h" + +class StepDirGeneric : StepDirDriver { + public: + // constructor + StepDirGeneric(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings); + + // setup driver + bool init(); + + // returns the number of axis parameters + uint8_t getParameterCount() { return numParameters; } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { if (number > numParameters) return &invalid; else return parameter[number]; } + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // read status info. from driver + inline void readStatus() {}; + + private: + + // checks if decay pin should be HIGH/LOW for a given decay setting + int8_t getDecayPinState(int8_t decay); + + // checkes if decay control is on the M2 pin + bool isDecayOnM2(); + + uint8_t microstepBitCode = 0; + uint8_t microstepBitCodeM0 = 0; + uint8_t microstepBitCodeM1 = 0; + uint8_t microstepBitCodeM2 = 0; + uint8_t microstepBitCodeGoto = 0; + uint8_t microstepBitCodeGotoM0 = 0; + uint8_t microstepBitCodeGotoM1 = 0; + uint8_t microstepBitCodeGotoM2 = 0; + int16_t m0Pin = OFF; + int16_t m1Pin = OFF; + int16_t m2Pin = OFF; + int16_t decayPin = OFF; + + // runtime adjustable settings + const int numParameters = 2; + AxisParameter* parameter[3] = {&invalid, µsteps, µstepsSlewing}; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriver.cpp b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriver.cpp new file mode 100755 index 0000000..6e2b7ac --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriver.cpp @@ -0,0 +1,253 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver + +#include "TmcStepDirDriver.h" + +#ifdef STEP_DIR_MOTOR_PRESENT + +#ifndef TMC2130_RSENSE +#define TMC2130_RSENSE 0.11F +#endif +#ifndef TMC2130_MAX_CURRENT +#define TMC2130_MAX_CURRENT (1700*0.8) // chip typically rated at 1.2A RMS, downrated to 80% due to typical step-stick form +#endif + +#ifndef TMC2160_RSENSE +#define TMC2160_RSENSE 0.075F +#endif +#ifndef TMC2160_MAX_CURRENT +#define TMC2160_MAX_CURRENT 4230 // module typically rated at 3.0A RMS +#endif + +#ifndef TMC2208_RSENSE +#define TMC2208_RSENSE 0.11F +#endif +#ifndef TMC2208_MAX_CURRENT +#define TMC2208_MAX_CURRENT (1974*0.8) // chip rated at 1.4A RMS, downrated to 80% due to typical step-stick form +#endif + +#ifndef TMC2209_RSENSE +#define TMC2209_RSENSE 0.11F +#endif +#ifndef TMC2209_MAX_CURRENT +#define TMC2209_MAX_CURRENT (2820*0.8) // chip rated at 2.0A RMS, downrated to 80% due to typical step-stick form +#endif + +#ifndef TMC2226_RSENSE +#define TMC2226_RSENSE 0.11F +#endif +#ifndef TMC2226_MAX_CURRENT +#define TMC2226_MAX_CURRENT (2820*0.8) // chip rated at 2.0A RMS, downrated to 80% due to typical step-stick form +#endif + +#ifndef TMC2660_RSENSE +#define TMC2660_RSENSE 0.075F +#endif +#ifndef TMC2660_MAX_CURRENT +#define TMC2660_MAX_CURRENT 2820 // module/chip rated at 2.0A RMS +#endif + +#ifndef TMC5160_RSENSE +#define TMC5160_RSENSE 0.075F +#endif +#ifndef TMC5160_MAX_CURRENT +#define TMC5160_MAX_CURRENT 4230 // typical module rated at 3.0A RMS +#endif + +#ifndef TMC5161_RSENSE +#define TMC5161_RSENSE 0.075F +#endif +#ifndef TMC5161_MAX_CURRENT +#define TMC5161_MAX_CURRENT (4935*0.8) // chip rated at 3.5A RMS, downrated to 80% due to typical step-stick form +#endif + +TmcStepDirDriver::TmcStepDirDriver(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :StepDirDriver(axisNumber, Pins, Settings) { + + // get the maximum current and Rsense for this axis + float user_rSense = 0; + int16_t user_currentMax = 0; + switch (axisNumber) { + case 1: + #ifdef AXIS1_DRIVER_RSENSE + user_rSense = AXIS1_DRIVER_RSENSE; + #endif + #ifdef AXIS1_DRIVER_MAX_CURRENT + user_currentMax = AXIS1_DRIVER_MAX_CURRENT; + #endif + break; + case 2: + #ifdef AXIS2_DRIVER_RSENSE + user_rSense = AXIS2_DRIVER_RSENSE; + #endif + #ifdef AXIS2_DRIVER_MAX_CURRENT + user_currentMax = AXIS2_DRIVER_MAX_CURRENT; + #endif + break; + case 3: + #ifdef AXIS3_DRIVER_RSENSE + user_rSense = AXIS3_DRIVER_RSENSE; + #endif + #ifdef AXIS3_DRIVER_MAX_CURRENT + user_currentMax = AXIS3_DRIVER_MAX_CURRENT; + #endif + break; + case 4: + #ifdef AXIS4_DRIVER_RSENSE + user_rSense = AXIS4_DRIVER_RSENSE; + #endif + #ifdef AXIS4_DRIVER_MAX_CURRENT + user_currentMax = AXIS4_DRIVER_MAX_CURRENT; + #endif + break; + case 5: + #ifdef AXIS5_DRIVER_RSENSE + user_rSense = AXIS5_DRIVER_RSENSE; + #endif + #ifdef AXIS5_DRIVER_MAX_CURRENT + user_currentMax = AXIS5_DRIVER_MAX_CURRENT; + #endif + break; + case 6: + #ifdef AXIS6_DRIVER_RSENSE + user_rSense = AXIS6_DRIVER_RSENSE; + #endif + #ifdef AXIS6_DRIVER_MAX_CURRENT + user_currentMax = AXIS6_DRIVER_MAX_CURRENT; + #endif + break; + case 7: + #ifdef AXIS7_DRIVER_RSENSE + user_rSense = AXIS7_DRIVER_RSENSE; + #endif + #ifdef AXIS7_DRIVER_MAX_CURRENT + user_currentMax = AXIS7_DRIVER_MAX_CURRENT; + #endif + break; + case 8: + #ifdef AXIS8_DRIVER_RSENSE + user_rSense = AXIS8_DRIVER_RSENSE; + #endif + #ifdef AXIS8_DRIVER_MAX_CURRENT + user_currentMax = AXIS8_DRIVER_MAX_CURRENT; + #endif + break; + case 9: + #ifdef AXIS9_DRIVER_RSENSE + user_rSense = AXIS9_DRIVER_RSENSE; + #endif + #ifdef AXIS9_DRIVER_MAX_CURRENT + user_currentMax = AXIS9_DRIVER_MAX_CURRENT; + #endif + break; + } + + if (driverModel == TMC2130) { currentMax = TMC2130_MAX_CURRENT; rSense = TMC2130_RSENSE; } else + if (driverModel == TMC2160) { currentMax = TMC2160_MAX_CURRENT; rSense = TMC2160_RSENSE; } else + if (driverModel == TMC2660) { currentMax = TMC2660_MAX_CURRENT; rSense = TMC2660_RSENSE; } else + if (driverModel == TMC5160) { currentMax = TMC5160_MAX_CURRENT; rSense = TMC5160_RSENSE; } else + if (driverModel == TMC5161) { currentMax = TMC5161_MAX_CURRENT; rSense = TMC5161_RSENSE; } else + if (driverModel == TMC2208) { currentMax = TMC2208_MAX_CURRENT; rSense = TMC2208_RSENSE; } else + if (driverModel == TMC2209) { currentMax = TMC2209_MAX_CURRENT; rSense = TMC2209_RSENSE; } else + if (driverModel == TMC2226) { currentMax = TMC2226_MAX_CURRENT; rSense = TMC2226_RSENSE; } else + driverModel = 0; + + if (user_rSense != 0) rSense = user_rSense; + if (user_currentMax != 0) currentMax = user_currentMax; + + // set current defaults for TMC drivers + if (lround(currentRun) == OFF) { + if (driverModel == TMC2130) currentRun = 2500.0F; else currentRun = 300.0F; + } + currentHold = lround(currentHold) == OFF ? currentRun/2.0F : currentHold; + currentSlewing = lround(currentSlewing) == OFF ? currentRun : currentSlewing; + + this->currentHold.valueDefault = currentHold; + this->currentHold.max = currentMax; + this->currentRun.valueDefault = currentRun; + this->currentRun.max = currentMax; + this->currentSlewing.valueDefault = currentSlewing; + this->currentSlewing.max = currentMax; + this->intpol.valueDefault = intpol; + + // setup decay modes + if (decay.valueDefault == OFF) decay.valueDefault = STEALTHCHOP; + if (decaySlewing.valueDefault == OFF) decaySlewing.valueDefault = SPREADCYCLE; + decay.min = SPREADCYCLE; + decay.max = STEALTHCHOP; + decaySlewing.min = SPREADCYCLE; + decaySlewing.max = STEALTHCHOP; +} + +bool TmcStepDirDriver::init() { + if (!StepDirDriver::init()) return false; + + if (!driverModel) { + DF("WRN:"); D(axisPrefix); DLF("unknown driver model!"); + return false; + } + + VF("MSG:"); V(axisPrefix); VF("Rsense="); V(rSense); VL("Ohms"); + VF("MSG:"); V(axisPrefix); VF("max current="); V(currentMax); VL("mA"); + + iHold = currentHold.value; + iRun = currentRun.value; + iGoto = currentSlewing.value; + iHoldRatio = (float)iHold/iRun; + + VF("MSG:"); V(axisPrefix); + VF("IHOLD="); V(lround(iHold)); VF("mA, "); + VF("IRUN="); V(lround(iRun)); VF("mA, "); + VF("IGOTO="); V(lround(iGoto)); VL("mA"); + + // set mode switching support flags + // use low speed mode switch for TMC drivers + modeSwitchAllowed = microstepRatio != 1; + modeSwitchFastAllowed = false; + + VF("MSG:"); V(axisPrefix); + if (modeSwitchAllowed) { VLF("ModeSwitch Allowed"); }else { VLF("ModeSwitch Disabled"); } + VF("MSG:"); V(axisPrefix); + if (modeSwitchFastAllowed) { VLF("ModeSwitchFast Allowed"); } else { VLF("ModeSwitchFast Disabled"); } + + return true; +} + +bool TmcStepDirDriver::parameterIsValid(AxisParameter* parameter, bool next) { + if (!StepDirDriver::parameterIsValid(parameter, next)) return false; + + if (parameter == ¤tHold || parameter == ¤tRun || parameter == ¤tSlewing) { + int currentHoldValue; + int currentRunValue; + int currentSlewingValue; + if (next) { + currentHoldValue = lround(currentHold.valueNv); + currentRunValue = lround(currentRun.valueNv); + currentSlewingValue = lround(currentSlewing.valueNv); + } else { + currentHoldValue = lround(currentHold.value); + currentRunValue = lround(currentRun.value); + currentSlewingValue = lround(currentSlewing.value); + } + + if (currentRunValue > currentMax) { + DF("WRN:"); D(axisPrefix); DF("bad current run="); D(currentRunValue); DF("mA > current max "); D(currentMax); DLF("mA"); + return false; + } + + if (currentSlewingValue > currentMax) { + DF("WRN:"); D(axisPrefix); DF("bad current goto="); D(currentSlewingValue); DF("mA > current max "); D(currentMax); DLF("mA"); + return false; + } + + if (currentHoldValue > currentRunValue) { + DF("WRN:"); D(axisPrefix); DF("bad current hold="); D(currentHoldValue); DF("mA > current run "); D(currentRunValue); DLF("mA"); + return false; + } + } + + return true; +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriver.h b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriver.h new file mode 100755 index 0000000..a63afac --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriver.h @@ -0,0 +1,52 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver +#pragma once + +#include "../StepDirDriver.h" + +#ifdef STEP_DIR_MOTOR_PRESENT + +// default settings for any TMC drivers that may be present +#ifndef DRIVER_TMC_STEPPER_AUTOGRAD + #define DRIVER_TMC_STEPPER_AUTOGRAD true // note that AUTOGRAD was false for SPI drivers before! +#endif +#ifndef SERIAL_TMC + #define SERIAL_TMC SoftSerial // Use software serial w/ TX on M3 (CS) and RX on M4 (MISO) of each axis +#endif +#ifndef SERIAL_TMC_BAUD + #define SERIAL_TMC_BAUD 115200 // Slower and more timing disrutpions or faster and it doesn't work (platform dependant) +#endif +#ifndef SERIAL_TMC_ADDRESS_MAP + #define SERIAL_TMC_ADDRESS_MAP(x) (0) // driver addresses are 0 for all axes +#endif + +#if SERIAL_TMC == SoftSerial + #include // must be built into the board libraries +#endif + +class TmcStepDirDriver : public StepDirDriver { + public: + TmcStepDirDriver(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // set up driver + virtual bool init(); + + // check if axis parameter is valid + bool parameterIsValid(AxisParameter* parameter, bool next = false); + + protected: + // driver current control + float rSense = 0.11F; + int16_t currentMax = 0; + + float iHold, iRun, iGoto, iHoldRatio; + + // runtime adjustable settings + AxisParameter currentHold = {NAN, NAN, NAN, 0, 20000, AXP_INTEGER, AXPN_CURRENT_HOLD}; + AxisParameter currentRun = {NAN, NAN, NAN, 0, 20000, AXP_INTEGER, AXPN_CURRENT_RUN}; + AxisParameter currentSlewing = {NAN, NAN, NAN, 0, 20000, AXP_INTEGER, AXPN_CURRENT_GOTO}; + AxisParameter intpol = {NAN, NAN, NAN, -2, -1, AXP_BOOLEAN, AXPN_INTERPOLATE}; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverNSG.cpp b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverNSG.cpp new file mode 100755 index 0000000..7dbecfe --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverNSG.cpp @@ -0,0 +1,14 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver + +#include "TmcStepDirDriverNSG.h" + +#ifdef STEP_DIR_MOTOR_PRESENT + +TmcStepDirDriverNSG::TmcStepDirDriverNSG(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriver(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverNSG.h b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverNSG.h new file mode 100755 index 0000000..665e638 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverNSG.h @@ -0,0 +1,30 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver +#pragma once + +#include "TmcStepDirDriver.h" + +#ifdef STEP_DIR_MOTOR_PRESENT + +class TmcStepDirDriverNSG : public TmcStepDirDriver { + public: + TmcStepDirDriverNSG(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // returns the number of axis parameters + uint8_t getParameterCount() { return numParameters; } + + // returns the specified axis parameter + AxisParameter* getParameter(uint8_t number) { if (number > numParameters) return &invalid; else return parameter[number]; } + + protected: + + const int numParameters = 7; + AxisParameter* parameter[8] = {&invalid, µsteps, µstepsSlewing, + ¤tHold, ¤tRun, ¤tSlewing, + &decay, &decaySlewing +// ,&intpol + }; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverSG.cpp b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverSG.cpp new file mode 100755 index 0000000..adce5e7 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverSG.cpp @@ -0,0 +1,730 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver + StallGuard helper +// + +#include +#include +#include "TmcStepDirDriverSG.h" +#include "../../../../nv/Nv.h" + +#if defined(STEP_DIR_MOTOR_PRESENT) + +// Dual-rate adaptation: +// - SG Train ON => fast EMA (explicit training) +#ifndef BASE_TC_FAST + #define BASE_TC_FAST 128.0f +#endif +#ifndef DEV_TC_FAST + #define DEV_TC_FAST 256.0f +#endif +// - SG Train OFF => slow EMA drift tracking +#ifndef BASE_TC_SLOW + #define BASE_TC_SLOW 4096.0f +#endif +#ifndef DEV_TC_SLOW + #define DEV_TC_SLOW 8192.0f +#endif + +// Margin for model: +#define MARGIN_GENERAL 80 // general was 40 +#define MARGIN_NOISE 4 // noise relative was 3 + +TmcStepDirDriverSG::TmcStepDirDriverSG(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriver(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + + sgEnabled.valueDefault = (float)SG_ENABLED; + sgTrain.valueDefault = (float)SG_TRAIN; + + // Floor disabled by default (0%) + sgFloorPct.valueDefault = (float)SG_FLOOR; + sgRampAllowPct.valueDefault = (float)SG_RAMP_ALLOW; + + sgArmFps.valueDefault = (float)SG_ARM_FPS; + sgArmFaultMs.valueDefault = (float)SG_FAULT_MS; + sgSensitivity.valueDefault = (float)SG_SENS; +} + +bool TmcStepDirDriverSG::init() { + if (!TmcStepDirDriver::init()) return false; + + #ifdef DRIVER_TMC_STEPPER_STALLGUARD + + #ifdef DRIVER_TMC_STEPPER_STALLGUARD_BASIC + sgArmFps.value = (float)SG_ARM_FPS; + sgArmFaultMs.value = (float)SG_FAULT_MS; + sgSensitivity.value = (float)SG_SENS; + #endif + + sgLastFps = 0.0f; + sgRampF = 0.0f; + sgTrainPrev = sgTrain.value; + sgModelSavePending = false; + sgModelSaveIntervalMs = (uint32_t)SG_MODEL_SAVE_MS; + if (nv().device().endurance() == NvDevice::Endurance::Mid) sgModelSaveIntervalMs = (uint32_t)SG_MODEL_SAVE_MS_MID; else + if (nv().device().endurance() == NvDevice::Endurance::High) sgModelSaveIntervalMs = (uint32_t)SG_MODEL_SAVE_MS_HIGH; + sgModelLastSaveMs = millis(); + + // Default model in RAM first + sgModelInit(sgModel); + + // create the nvKey for this axis + char keyStr[24]; + sprintf(keyStr, "STALLGUARD_AXIS%u", (unsigned)axisNumber); + nvKey = nv().kv().computeKey(keyStr); + + if (sgEnabled.value == ON) { + // Read existing model (if present) + KvPartition::Status result = nv().kv().get(nvKey, sgModel); + if (result == KvPartition::Status::Ok) { + VF("MSG:"); V(axisPrefix); VLF("StallGuard model NV file read success"); + } else if (result == KvPartition::Status::NotFound) { + VF("MSG:"); V(axisPrefix); VLF("StallGuard model NV file not found (using defaults)"); + } else { + DF("WRN:"); D(axisPrefix); DLF("StallGuard model NV file read failed"); + } + + sgModelDebugDumpNv(); + + // If loaded model is stale/incompatible, reset to defaults and store back + if (!sgModelValid(sgModel)) { + DF("WRN:"); D(axisPrefix); DLF("StallGuard model invalid/discarded"); + sgModelInit(sgModel); + sgRuntimeFromModel(); + if (nv().kv().put(nvKey, sgModel) != KvPartition::Status::Ok) { DF("WRN:"); D(axisPrefix); DLF("StallGuard save failed"); } + } else { + sgRuntimeFromModel(); + } + + } else { + // Delete existing model (if present) + KvPartition::Status result = nv().kv().del(nvKey); + if (result == KvPartition::Status::Ok) { + VF("MSG:"); V(axisPrefix); VLF("StallGuard model NV file found and deleted"); + } else if (result != KvPartition::Status::NotFound) { + DF("WRN:"); D(axisPrefix); DLF("StallGuard model NV file delete error"); + } + } + + // bin cache invalid until first use + sgBinValid = false; + sgBinArmFps = 0.0f; + sgBinHi = 0.0f; + for (int i = 0; i < (int)(SG_BINS - 1); i++) sgBinEdge[i] = 0.0f; + for (int i = 0; i < (int)SG_BINS; i++) sgBinAnchor[i] = 0.0f; + #endif + + return true; +} + +// check if sg axis parameter is valid +bool TmcStepDirDriverSG::parameterIsValid(AxisParameter* parameter, bool next) { + if (!TmcStepDirDriver::parameterIsValid(parameter, next)) return false; + + if (parameter == &sgEnabled || parameter == &decaySlewing) { + int sgEnabledValue, decaySlewingValue; + if (next) { + sgEnabledValue = lround(sgEnabled.valueNv); + decaySlewingValue = lround(decaySlewing.valueNv); + } else { + sgEnabledValue = lround(sgEnabled.value); + decaySlewingValue = lround(decaySlewing.value); + } + + if (driverModel == TMC2209) { + if (sgEnabledValue == ON && (decaySlewingValue != OFF && decaySlewingValue != STEALTHCHOP)) { + DF("WRN:"); D(axisPrefix); + DLF("stallGuard SG-Enable ON requires Decay-mode-Goto StealthChop"); + return true; + } + } else { + if (sgEnabledValue == ON && (decaySlewingValue != OFF && decaySlewingValue != SPREADCYCLE)) { + DF("WRN:"); D(axisPrefix); + DLF("stallGuard SG-Enable ON requires Decay-mode-Goto SpreadCycle"); + return true; + } + } + } + + return true; +} + +bool TmcStepDirDriverSG::isStalled(float stepsPerSec) { + + #ifdef DRIVER_TMC_STEPPER_STALLGUARD + + if (sgEnabled.value == OFF) return false; + if (!stallGuardModeActive()) return false; + + sgTrainPrev = sgTrain.value; + + const uint32_t nowMs = millis(); + if (sgLastMs != 0 && (uint32_t)(nowMs - sgLastMs) < (uint32_t)SG_EVAL_MIN_MS) return sgLatch; + + // Convert signed microsteps/s -> signed fullsteps/s + const float fpsSigned = stepsPerSec / normalizedMicrosteps; + const float spd = fabsf(fpsSigned); + + // Defer model writes while slewing; flush once speed drops below SG arm threshold. + if (sgModelSavePending && spd < sgArmFps.value) { + sgModelFromRuntime(); + + if (nv().kv().put(nvKey, sgModel) == KvPartition::Status::Ok) { + DF("MSG:"); D(axisPrefix); DLF("StallGuard model NV file saved"); + } else { + DF("WRN:"); D(axisPrefix); DLF("StallGuard model NV file save failed"); + } + + sgModelSavePending = false; + sgModelLastSaveMs = nowMs; + } + + if (!(spd > 0.0f)) { + stallDetectSoftReset(); + sgLastFps = fpsSigned; + sgLastMs = nowMs; + return false; + } + + // Live tuning: if sensitivity changed, apply and reset model + const uint8_t pctNow = (uint8_t)sgSensitivity.value; + if (pctNow != sgAppliedPct) { + // First application after boot uses sentinel 255 and should not wipe + // the persisted learned model. Real runtime/user changes still hard-reset. + const bool firstApply = (sgAppliedPct == 255); + applySgSensitivityPercent(pctNow); + sgAppliedPct = pctNow; + if (firstApply) { + stallDetectSoftReset(); + } else { + stallDetectHardReset(); + } + return false; + } + + // Time delta (clamped) for integrators. millis() has 1ms resolution, so fast loops can see dtMs==0 + uint16_t dtMs = (sgLastMs == 0) ? 0 : (uint16_t)(nowMs - sgLastMs); + sgLastMs = nowMs; + if (dtMs > 50) dtMs = 50; + + // Signed accel estimate (fullsteps/sec^2) + // IMPORTANT: if dtMs==0, do not advance sgLastFps, otherwise dv gets "eaten" on fast MCUs + float a = 0.0f; // signed accel + float absA = 0.0f; // magnitude + + if (dtMs > 0) { + const float dv = fpsSigned - sgLastFps; + sgLastFps = fpsSigned; + a = dv * 1000.0f / (float)dtMs; + absA = fabsf(a); + } + + // Arm only above minimum speed (fullsteps/sec) + if (spd < sgArmFps.value) { + stallDetectSoftReset(); + sgLastFps = fpsSigned; + return false; + } + + const uint16_t armWarmMs = (uint16_t)SG_ARM_WARM_MS; + + const uint16_t sg = readSg10(); + // Treat sg==0 as "not usable for training" until warmed; 0xFFFF is invalid read. + if ((sg == 0 && sgWarmMs < armWarmMs) || sg == 0xFFFF) { + if (dtMs) { if (sgBadMs >= dtMs) sgBadMs -= dtMs; else sgBadMs = 0; } + return sgLatch; + } + + // Warm-up accumulator while armed and samples are valid. + if (dtMs && sgWarmMs < armWarmMs) { + const uint32_t w = (uint32_t)sgWarmMs + (uint32_t)dtMs; + sgWarmMs = (w > armWarmMs) ? armWarmMs : (uint16_t)w; + } + + // dir index: 0 = negative, 1 = positive. + const uint8_t dir = (fpsSigned >= 0.0f) ? 1 : 0; + + const float armFps = (float)sgArmFps.value; + + // ---------------- ramp allowance / motion-state estimate ---------------- + // Keep sgRampF as a "motion state" estimate even if rampAllowPct is 0, + // so steady-state gating works. + if (dtMs > 0) { + const float vref = (spd > armFps) ? spd : armFps; // floor avoids blow-up near zero + constexpr float Tramp = 0.8f; // seconds; detector shaping constant + float rampFactorInstant = (vref > 0.0f) ? (absA / vref) * Tramp : 0.0f; + if (rampFactorInstant < 0.0f) rampFactorInstant = 0.0f; + if (rampFactorInstant > 1.0f) rampFactorInstant = 1.0f; + + // Smooth ramp factor so sustained ramps are visible. + constexpr float TAU_MS = 80.0f; + const float alpha = (float)dtMs / (TAU_MS + (float)dtMs); + sgRampF += alpha * (rampFactorInstant - sgRampF); + } + + // Define "steady" from sgRampF (NOT from rampExtra). + // Tune range ~0.08..0.20. Lower => stricter steady requirement. + constexpr float SG_STEADY_RAMPF = 0.12f; + const bool steadyNow = (sgRampF < SG_STEADY_RAMPF); + + uint16_t rampExtra = 0; + const int rampPct = (int)sgRampAllowPct.value; + + // Optional ramp allowance (still available). This remains symmetric (absA-based). + // ------------------------------------------------------------------------- + // Cross-fade bins for trip computation (avoid discontinuities at bin edges). + uint8_t b0, b1; + float bt; + sgSpeedBlend(spd, armFps, b0, b1, bt); + const uint8_t bl = (bt < 0.5f) ? b0 : b1; // nearest bin for learning + + // Seed baseline/deviation for the nearest learning bin. + if (sgTrain.value == ON) { + if (!sgModel.init[dir][bl]) { + sgModel.base[dir][bl] = sgToFp(sg); + sgModel.dev[dir][bl] = sgToFp(10); + sgBaseF[dir][bl] = (float)sg; + sgDevF[dir][bl] = 10.0f; + sgModel.init[dir][bl] = true; + } + } + + // Blend baseline/deviation across adjacent speed bins for smoother thresholds. + const float baseF = (1.0f - bt) * sgBaseF[dir][b0] + bt * sgBaseF[dir][b1]; + const float devF = (1.0f - bt) * sgDevF [dir][b0] + bt * sgDevF [dir][b1]; + const uint16_t base = (uint16_t)lroundf(baseF); + const uint16_t devE = (uint16_t)lroundf(devF); + + uint16_t margin = (uint16_t)(MARGIN_GENERAL + (uint16_t)(MARGIN_NOISE * devE)); + + // Cap margin to 50% of baseline. + uint16_t cap = (uint16_t)(base / 2); + if (cap < MARGIN_GENERAL) cap = MARGIN_GENERAL; + if (margin > cap) margin = cap; + if (base > 0 && margin >= base) margin = base - 1; + + // ---------------- ramp allowance (optional) ---------------- + if (rampPct > 0 && base > 0) { + const uint16_t rampAllowCounts = (uint16_t)((uint32_t)base * (uint32_t)rampPct / 20U); + rampExtra = (uint16_t)lroundf((float)rampAllowCounts * sgRampF); + if (rampExtra > cap) rampExtra = cap; + } + + sgLastRampExtra = rampExtra; + // ---------------------------------------------------------- + + // "hard bad": sg==0 after warm-up. + const bool hardBad = (sg == 0) && (sgWarmMs >= armWarmMs); + + // Base trip threshold. + int trip = (int)base - (int)(margin + rampExtra); + if (trip < 0) trip = 0; + + // Rate-of-change sensitivity boost ("floor"): + { + int floorPct = (int)lroundf(sgFloorPct.value); + if (floorPct < 0) floorPct = 0; + if (floorPct > 100) floorPct = 100; + + if (floorPct > 0 && base > 0 && sgWarmMs >= SG_ZERO_GRACE_MS) { + const float vref = (spd > armFps) ? spd : armFps; + const float r = (vref > 0.0f) ? (absA / vref) : 1.0f; + + #ifndef SG_FLOOR_R0 + #define SG_FLOOR_R0 0.08f + #endif + #ifndef SG_FLOOR_R1 + #define SG_FLOOR_R1 0.25f + #endif + + float k; + if (r <= SG_FLOOR_R0) k = 1.0f; + else if (r >= SG_FLOOR_R1) k = 0.0f; + else k = (SG_FLOOR_R1 - r) / (SG_FLOOR_R1 - SG_FLOOR_R0); + + #ifndef SG_FLOOR_COUNTS_PER_PCT + #define SG_FLOOR_COUNTS_PER_PCT 2 + #endif + int floorAdd = floorPct * SG_FLOOR_COUNTS_PER_PCT; + floorAdd = (int)lroundf(k * (float)floorAdd); + + const int floorCap = (int)base/2; + if (floorAdd > floorCap) floorAdd = floorCap; + + trip += floorAdd; + if (trip > (int)base) trip = (int)base; + } + } + + const bool bad = hardBad || ((int)sg < trip); + + // debug snapshot + sgLast = sg; + sgLastMargin = margin; + sgBadLast = bad; + + const bool steadyHealthy = steadyNow && !sgLatch && !bad; + const bool adaptFast = (sgTrain.value == ON) && steadyHealthy; + const bool adaptSlow = (sgTrain.value == OFF) && steadyHealthy; + + if (adaptFast || adaptSlow) { + const float baseTc = adaptFast ? BASE_TC_FAST : BASE_TC_SLOW; + const float devTc = adaptFast ? DEV_TC_FAST : DEV_TC_SLOW; + + const float sgF = (float)sg; + + // Update only the nearest bin to avoid cross-speed drift between adjacent bins. + sgBaseF[dir][bl] += (sgF - sgBaseF[dir][bl]) / baseTc; + + // Downward-only deviation EMA update for the nearest learning bin. + const float d = sgBaseF[dir][bl] - sgF; + const float devDown = (d > 0.0f) ? d : 0.0f; + + sgDevF[dir][bl] += (devDown - sgDevF[dir][bl]) / devTc; + + // Queue periodic save; actual write is deferred until non-slew speeds. + if ((nowMs - sgModelLastSaveMs) >= sgModelSaveIntervalMs) { + sgModelSavePending = true; + } + + // decay fault accumulator toward 0 when healthy + if (dtMs) { + const uint16_t d = dtMs; + if (sgBadMs >= d) sgBadMs -= d; else sgBadMs = 0; + } + } else if (!bad) { + // Healthy sample; decay fault accumulator. + if (dtMs) { + const uint16_t d = dtMs; + if (sgBadMs >= d) sgBadMs -= d; else sgBadMs = 0; + } + } else { + // Accumulate faults once warmed. + if (sgWarmMs >= armWarmMs) { + if (dtMs) { + const uint32_t x = (uint32_t)sgBadMs + (uint32_t)dtMs; + sgBadMs = (x > 65535U) ? 65535U : (uint16_t)x; + } + } + } + + const int fpsInt = (int)lroundf(spd); + UNUSED(fpsInt); + + const uint16_t armFaultMs = (uint16_t)sgArmFaultMs.value; + if (sgTrain.value == OFF && sgBadMs >= armFaultMs && !sgLatch) { + sgLatch = true; + D("WRN:"); D(axisPrefix); + D("SG stall detected fps="); D(fpsInt); + D(", sg="); D((int)sg); + D(", trip="); DL((int)trip); + } + + #if DEBUG != OFF && defined(DEBUG_AXIS) && DEBUG_AXIS != OFF + if (axisNumber == DEBUG_AXIS) { + if (spd >= sgArmFps.value) { +// const int rampX = (int)-rampExtra; + const int fpsOut = (int)lroundf(spd); + + unsigned long tms = millis(); + static unsigned long next = 0; + if ((long)(tms - next) > 0) { + next = tms + 250; // 250ms log rate + D("sg:"); D(sg); + D(" sg-trip:"); D(trip); +// D(" sg-rampExtra:"); D(rampX); + D(" sg-binFps:"); D((int)lroundf(sgBinAnchor[bl])); +// D(" sg-bl*10:"); D((int)bl * 10); +// D(" sg-bt%:"); D((int)lroundf(bt * 100.0f)); + D(" sg-fps:"); D(fpsOut); +// D(" sg-base-trip:"); D(base); +// D(" sg-base-learn:"); D((int)lroundf(sgBaseF[dir][bl])); + D(" sg-dev:"); D(devE); + DL(""); + } + } + } + #endif + + #else + UNUSED(stepsPerSec); + #endif + + return sgLatch; +} + +void TmcStepDirDriverSG::stallDetectReset() { + #ifdef DRIVER_TMC_STEPPER_STALLGUARD + stallDetectSoftReset(); + #else + sgLatch = false; + #endif +} + +#ifdef DRIVER_TMC_STEPPER_STALLGUARD + +uint8_t TmcStepDirDriverSG::sgSpeedBin(float spd, float armFps) const { + if (armFps < 1.0f) armFps = 1.0f; + if (spd < armFps) return 0; + + float hi = (float)velocityMax / normalizedMicrosteps; + if (hi < 1.0f) hi = 1.0f; + + if (spd > hi) spd = hi; + + constexpr float EpsThreshold = 0.01f; + if (!sgBinValid || fabsf(sgBinHi - hi) > EpsThreshold) { + sgBinValid = true; + sgBinArmFps = armFps; + sgBinHi = hi; + + // Fixed anchor points by max slew speed: + // b0=low anchor, b1=0.25*Vmax, b2=0.375*Vmax, b3=0.5*Vmax, b4=0.75*Vmax, b5=Vmax + sgBinAnchor[0] = (float)SG_BIN0_FPS; + if (sgBinAnchor[0] < 0.0f) sgBinAnchor[0] = 0.0f; + sgBinAnchor[1] = hi * 0.25f; + sgBinAnchor[2] = hi * 0.33333f; + sgBinAnchor[3] = hi * 0.5f; + sgBinAnchor[4] = hi * 0.75f; + sgBinAnchor[5] = hi; + + // Keep anchors strictly increasing to avoid divide-by-zero / ordering issues. + constexpr float MinStep = 0.001f; + for (uint8_t i = 1; i < SG_BINS; i++) { + if (sgBinAnchor[i] <= sgBinAnchor[i - 1]) sgBinAnchor[i] = sgBinAnchor[i - 1] + MinStep; + } + } + + uint8_t best = 0; + float bestErr = fabsf(spd - sgBinAnchor[0]); + for (uint8_t b = 1; b < SG_BINS; b++) { + const float e = fabsf(spd - sgBinAnchor[b]); + if (e < bestErr) { + bestErr = e; + best = b; + } + } + return best; +} + +void TmcStepDirDriverSG::sgSpeedBlend(float spd, float armFps, uint8_t &b0, uint8_t &b1, float &t) const { + + if (armFps < 1.0f) armFps = 1.0f; + + if (spd <= armFps) { + b0 = 0; b1 = 0; t = 0.0f; + return; + } + + (void)sgSpeedBin(spd, armFps); + + float sp = spd; + if (sp > sgBinHi) sp = sgBinHi; + + if (sp <= sgBinAnchor[0]) { + b0 = 0; b1 = 0; t = 0.0f; + return; + } + + for (uint8_t k = 0; k < (SG_BINS - 2); k++) { + const float lo = sgBinAnchor[k]; + const float hi2 = sgBinAnchor[k + 1]; + + if (sp < hi2) { + b0 = k; + b1 = (uint8_t)(k + 1); + t = (hi2 > lo) ? (sp - lo) / (hi2 - lo) : 0.0f; + if (t < 0.0f) t = 0.0f; + if (t > 1.0f) t = 1.0f; + return; + } + } + + b0 = (uint8_t)(SG_BINS - 2); + b1 = (uint8_t)(SG_BINS - 1); + const float lo = sgBinAnchor[SG_BINS - 2]; + const float hi2 = sgBinAnchor[SG_BINS - 1]; + t = (hi2 > lo) ? (sp - lo) / (hi2 - lo) : 1.0f; + if (t < 0.0f) t = 0.0f; + if (t > 1.0f) t = 1.0f; +} + +uint16_t TmcStepDirDriverSG::readSg10() { + const uint32_t now = millis(); + + if (sgLastGoodMs != 0 && (uint32_t)(now - sgLastGoodMs) >= 500) { + sgCached = 0xFFFF; + sgLastGoodMs = 0; + sgRetryAtMs = now + 2; + } + + if ((int32_t)(now - sgRetryAtMs) < 0) return sgCached; + + const uint32_t sr = readSgRegister(); + + if (sr != 0 && sr != 0xFFFFFFFFUL) { + if (sgCached == 0xFFFF) { + sgCached = (uint16_t)(sr & 0x03FF); + } else { + sgCached = (uint16_t)((sgCached * 9U + (uint16_t)(sr & 0x03FF) + 5U) / 10U); + } + sgLastGoodMs = now; + sgRetryAtMs = now + 20; + } else { + sgRetryAtMs = now + 2; + } + + return sgCached; +} + +void TmcStepDirDriverSG::stallDetectSoftReset() { + sgLatch = false; + sgBadMs = 0; + sgWarmMs = 0; + sgRampF = 0.0f; + + sgCached = 0xFFFF; + sgLastGoodMs = 0; + sgRetryAtMs = 0; + + sgLast = 0xFFFF; + sgLastMargin = 0; + sgLastRampExtra = 0; + sgBadLast = false; +} + +void TmcStepDirDriverSG::stallDetectHardReset() { + sgModelInit(sgModel); + sgRuntimeFromModel(); + + // Persist cleared model if possible so next boot starts clean too + sgModelFromRuntime(); + if (nv().kv().put(nvKey, sgModel) == KvPartition::Status::Ok) { + VF("MSG:"); V(axisPrefix); VLF("StallGuard model reset and file saved"); + } else { + DF("WRN:"); D(axisPrefix); DLF("StallGuard model reset but file save failed"); + } + + stallDetectSoftReset(); + sgModelLastSaveMs = millis(); + + sgBinValid = false; + sgBinArmFps = 0.0f; + sgBinHi = 0.0f; + for (int i = 0; i < (int)(SG_BINS - 1); i++) sgBinEdge[i] = 0.0f; + for (int i = 0; i < (int)SG_BINS; i++) sgBinAnchor[i] = 0.0f; +} + +void TmcStepDirDriverSG::sgModelInit(SgModel& model) const { + switch (axisNumber) { + case 1: { + SgModel seed = {1, 0, 0, 0, AXIS1_SG_MODEL_INIT, AXIS1_SG_MODEL_BASE, AXIS1_SG_MODEL_DEV}; + model = seed; + break; + } + case 2: { + SgModel seed = {1, 0, 0, 0, AXIS2_SG_MODEL_INIT, AXIS2_SG_MODEL_BASE, AXIS2_SG_MODEL_DEV}; + model = seed; + break; + } + default: { + SgModel seed = {1, 0, 0, 0, SG_MODEL_INIT, SG_MODEL_BASE, SG_MODEL_DEV}; + model = seed; + break; + } + } + + // overwrite live metadata after applying compile-time seed arrays + model.version = 1; + model.normalizedMicrostepsSlewing = normalizedMicrostepsSlewing; + model.mAGoto = currentSlewing.value; + model.sgSens = sgSensitivity.value; +} + +bool TmcStepDirDriverSG::sgModelValid(const SgModel& model) const { + if (model.version != 1) return false; + if (model.normalizedMicrostepsSlewing != normalizedMicrostepsSlewing) return false; + if (lroundf(model.mAGoto) != lroundf(currentSlewing.value)) return false; + if (lroundf(model.sgSens) != lroundf(sgSensitivity.value)) return false; + return true; +} + +void TmcStepDirDriverSG::sgRuntimeFromModel() { + for (uint8_t d = 0; d < 2; d++) { + for (uint8_t b = 0; b < SG_BINS; b++) { + sgBaseF[d][b] = (float)sgModel.base[d][b] / (float)SG_FP_ONE; + sgDevF[d][b] = (float)sgModel.dev [d][b] / (float)SG_FP_ONE; + } + } +} + +void TmcStepDirDriverSG::sgModelFromRuntime() { + for (uint8_t d = 0; d < 2; d++) { + for (uint8_t b = 0; b < SG_BINS; b++) { + float base = sgBaseF[d][b]; + float dev = sgDevF[d][b]; + if (base < 0.0f) base = 0.0f; + if (dev < 0.0f) dev = 0.0f; + + const float baseFp = base * (float)SG_FP_ONE; + const float devFp = dev * (float)SG_FP_ONE; + + sgModel.base[d][b] = (baseFp > 65535.0f) ? 65535u : (uint16_t)lroundf(baseFp); + sgModel.dev [d][b] = (devFp > 65535.0f) ? 65535u : (uint16_t)lroundf(devFp); + } + } +} + +void TmcStepDirDriverSG::sgModelDebugDumpNv() const { + #if DEBUG != OFF + VF("MSG:"); V(axisPrefix); VF("Stallguard model metadata v="); + V((int)sgModel.version); + VF(" microstepsGoto="); + V((int)sgModel.normalizedMicrostepsSlewing); + VF(" mAGoto="); + V((int)lroundf(sgModel.mAGoto)); + VF(" sgSens="); + VL((int)lroundf(sgModel.sgSens)); + + #ifdef SG_DEBUG_MODEL + VLF("------------------------------------------------------------------"); + VF("#define AXIS"); V((int)axisNumber); VF("_SG_MODEL_INIT { { "); + for (int d = 0; d < 2; d++) { + for (int b = 0; b < SG_BINS; b++) { + V(sgModel.init[d][b] ? "true" : "false"); + if (b < SG_BINS - 1) { VF(", "); } + } + VF(" }"); + if (d == 0) { VF(", { "); } + } + VLF(" }"); + + VF("#define AXIS"); V((int)axisNumber); VF("_SG_MODEL_BASE { { "); + for (int d = 0; d < 2; d++) { + for (int b = 0; b < SG_BINS; b++) { + V((int)sgModel.base[d][b]); + if (b < SG_BINS - 1) { VF(", "); } + } + VF(" }"); + if (d == 0) { V(", { "); } + } + VLF(" }"); + + VF("#define AXIS"); V((int)axisNumber); VF("_SG_MODEL_DEV { { "); + for (int d = 0; d < 2; d++) { + for (int b = 0; b < SG_BINS; b++) { + V((int)sgModel.dev[d][b]); + if (b < SG_BINS - 1) { VF(", "); } + } + VF(" }"); + if (d == 0) { VF(", { "); } + } + VLF(" }"); + VLF("------------------------------------------------------------------"); + #endif + #endif +} + +#endif + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverSG.h b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverSG.h new file mode 100755 index 0000000..2b01bf1 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/TmcStepDirDriverSG.h @@ -0,0 +1,379 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver + StallGuard helper +// +// The “Arduino IDE charts” in your debug output are these runtime signals: +// +// sg = raw StallGuard result (0..1023) from the driver status. +// Lower sg => higher load / closer to stall. 0 is often “not usable” +// at low speed or before SG has warmed up. +// +// trip = computed threshold. If sg < trip => “bad sample” (potential stall). +// trip starts near the learned baseline (base) and is adjusted by +// noise margin, ramp allowance, and optional steady-state “floor”. +// +// rampExtra = extra margin during ramps (accel/decel) so normal +// transient load spikes don’t false-trip. +// Logged/charted as a negative number (rampX = -rampExtra) +// to visualize it as “headroom reduction”. +// +// sg-bin*10 = which speed bin you’re in (lower bin index * 10 for plotting). +// Bins exist so base/dev can differ by speed (SG is speed dependent). +// +// fpsOut/10 = speed in fullsteps/sec divided by 10 (cheap scaling for plotting). +// +// base = learned SG baseline for this direction + speed bin (counts). +// This is the “healthy” SG you expect at this speed when not ramping. +// +// devE = learned downward deviation (noise / dips) for this dir+bin (counts). +// Used to inflate margin: margin = M0 + M1*devE. +// +// The tunable parameters exposed in the UI (AxisParameter) are: +// +// sgEnabled (OFF/ON) +// - Master enable for StallGuard-based stall detection on this axis. +// - Hard constraint: +// * StallGuard2 devices (tmc2130/2160/5160/5161) require “decay slewing SpreadCycle” +// * StallGuard4 devices (tmc2209) require “decay slewing StealthChop” +// +// sgTrain (OFF/ON) +// - Enables learning of baseline (sgB) and deviation (sgD) while moving. +// - Training only happens when: +// * not latched, +// * sample is healthy (not “bad”), +// * and motion is “steady” (low ramp factor). +// +// sgSensitivity (0..100 percent) +// - User-facing knob mapped by applySgSensitivityPercent() into driver settings +// (typically SGTHRS / coolStep related thresholding depending on chip). +// - Changing it forces a hard reset of learned model so new sensitivity starts clean. +// +// sgArmFps (fullsteps/sec) +// - Minimum speed where SG is considered valid and the detector “arms”. +// - Below this: detector disarms, clears warm/fault accumulators, returns “no stall”. +// - This avoids the common low-speed regime where StallGuard is noisy/useless. +// +// sgArmFaultMs (milliseconds) +// - Time-integrator for “bad samples” before declaring a stall. +// - The detector accumulates sgBadMs when sg is below trip (or sg==0 after warmup), +// and decays sgBadMs back toward 0 on healthy samples. +// - When sgBadMs >= sgArmFaultMs => sgLatch=true (stall latched). +// +// sgRampAllowPct (percent-ish) +// - Optional ramp allowance. Adds extra margin during ramps proportional to: +// base * (rampAllowPct/20) * sgRampF +// - sgRampF is a normalized ramp factor derived from |accel|/speed, smoothed. +// - Purpose: reduce false stalls during accel/decel and during direction changes. +// +// sgFloorPct (0..100 percent) +// - Optional steady-state sensitivity boost. +// - When enabled, it ADDS counts to trip (making it easier to trip) *only* when +// motion is steady, and fades out as ramping increases. +// - Interpreted as fixed counts: +// floorAdd = sgFloorPct * SG_FLOOR_COUNTS_PER_PCT +// then blended by “k” based on r = |dv/dt| / vref using thresholds: +// SG_FLOOR_R0 (fully steady) .. SG_FLOOR_R1 (fully ramping) +// +// Build-time knobs that shape the plotted behavior (these affect how the above looks): +// +// SG_BINS +// - Number of speed bins used for learning base/dev. +// - More bins = more adaptation by speed, but slower learning per bin. +// +// SG_ARM_WARM_MS +// - Warm-up time after arming before sg==0 is treated as a “hard bad”. +// - During warm-up, sg==0 is treated as “not usable for training” rather than a fault. +// +// SG_ZERO_GRACE_MS +// - Additional grace period before floor logic is allowed to act (prevents early +// over-sensitivity while SG is still stabilizing). +// +// SG_FLOOR_R0 / SG_FLOOR_R1 +// - Define what “steady” vs “ramping” means for the floor fade-out. +// +// SG_FLOOR_COUNTS_PER_PCT +// - Converts floorPct into raw SG counts (default 2 counts per %). +// +// Notes on the internal state variables you see affecting plots: +// +// sgRampF +// - A smoothed [0..1] ramp factor. 0 ~= steady, 1 ~= strong ramping. +// - Used for “steadyNow” gating (training only when steady) and for rampExtra. +// +// sgModel.base[dir][bin], sgModel.dev[dir][bin] +// - Learned baseline and learned deviation per direction and speed bin. +// - Stored as U10.6 fixed-point SG counts. +// - Updated with EMA time constants BASE_TC and DEV_TC when training. +// +// sgBadMs +// - Fault integrator (ms). Accumulates “bad” time after warm-up, +// decays toward 0 on healthy samples. +// - This makes stall detection robust against single-sample noise. +// +#pragma once + +#include "TmcStepDirDriver.h" + +#if defined(STEP_DIR_MOTOR_PRESENT) + +// Warmup time (ms) after arming before SG==0 is treated as "hard bad" +// and before faults are accumulated. +#ifndef SG_ARM_WARM_MS + #define SG_ARM_WARM_MS 200 +#endif + +// Minimum period (ms) between StallGuard evaluations in isStalled(). +// This normalizes model learning and fault integration against loop-rate variance. +#ifndef SG_EVAL_MIN_MS + #define SG_EVAL_MIN_MS 20 +#endif + +#ifndef SG_MODEL_SAVE_MS + #define SG_MODEL_SAVE_MS 300000 +#endif +#ifndef SG_MODEL_SAVE_MS_MID + #define SG_MODEL_SAVE_MS_MID 150000 +#endif +#ifndef SG_MODEL_SAVE_MS_HIGH + #define SG_MODEL_SAVE_MS_HIGH 60000 +#endif + +// Default init values + +// Generic model parameters +#ifndef SG_ENABLED + #define SG_ENABLED OFF +#endif +#ifndef SG_TRAIN + #define SG_TRAIN ON +#endif +#ifndef SG_SENS + #define SG_SENS 50 +#endif +#ifndef SG_FLOOR + #define SG_FLOOR 0 +#endif +#ifndef SG_RAMP_ALLOW + #define SG_RAMP_ALLOW 0 +#endif +#ifndef SG_ARM_FPS + #define SG_ARM_FPS 150 +#endif +#ifndef SG_FAULT_MS + #define SG_FAULT_MS 200 +#endif + +// Optional low-speed anchor for SG bin0 in fullsteps/sec. +// Keep at 0 for a true low anchor, or raise to manually smooth low-speed behavior. +#ifndef SG_BIN0_FPS + #define SG_BIN0_FPS 0 +#endif + +// Generic fallback StallGuard seed model +#ifndef SG_MODEL_INIT + #define SG_MODEL_INIT { { false, false, false, false, false, false }, { false, false, false, false, false, false } } +#endif +#ifndef SG_MODEL_BASE + #define SG_MODEL_BASE { { 0, 0, 0, 0, 0, 0 }, { 0, 0, 0, 0, 0, 0 } } +#endif +#ifndef SG_MODEL_DEV + #define SG_MODEL_DEV { { 0, 0, 0, 0, 0, 0 }, { 0, 0, 0, 0, 0, 0 } } +#endif + +// Axis 1 override defaults to generic model if not supplied +#ifndef AXIS1_SG_MODEL_INIT + #define AXIS1_SG_MODEL_INIT SG_MODEL_INIT +#endif +#ifndef AXIS1_SG_MODEL_BASE + #define AXIS1_SG_MODEL_BASE SG_MODEL_BASE +#endif +#ifndef AXIS1_SG_MODEL_DEV + #define AXIS1_SG_MODEL_DEV SG_MODEL_DEV +#endif + +// Axis 2 override defaults to generic model if not supplied +#ifndef AXIS2_SG_MODEL_INIT + #define AXIS2_SG_MODEL_INIT SG_MODEL_INIT +#endif +#ifndef AXIS2_SG_MODEL_BASE + #define AXIS2_SG_MODEL_BASE SG_MODEL_BASE +#endif +#ifndef AXIS2_SG_MODEL_DEV + #define AXIS2_SG_MODEL_DEV SG_MODEL_DEV +#endif + +// Number of speed bins used for learning base/dev. (fixed at 6) +#define SG_BINS 6 + +typedef struct SgModel { + uint8_t version; + int16_t normalizedMicrostepsSlewing; + float mAGoto; + float sgSens; + + bool init[2][SG_BINS]; + uint16_t base[2][SG_BINS]; // U10.6 + uint16_t dev[2][SG_BINS]; // U10.6 +} SgModel; + +class TmcStepDirDriverSG : public TmcStepDirDriver { + public: + TmcStepDirDriverSG(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // set up driver + bool init(); + + uint8_t getParameterCount() { return numParameters; } + + AxisParameter* getParameter(uint8_t number) { + if (number == 0 || number > numParameters) return &invalid; + return parameter[number]; + } + + // check if axis parameter is valid + bool parameterIsValid(AxisParameter* parameter, bool next = false); + + // indicate that this driver can detect stalls + bool hasStallDetect() const { return true; } + + // Returns true if the motor is overloaded/stalled + // NOTE: stepsPerSec is signed microsteps/sec; converted internally to signed fullsteps/sec + bool isStalled(float stepsPerSec); + + // reset any internal stall-detect state (baseline, latch, etc.) + void stallDetectReset() override; + + protected: + + // read the 32bit status register + virtual uint32_t readSgRegister() { return 0xFFFFFFFFUL; } + + // should return true when in a mode where SG is meaningful + virtual bool stallGuardModeActive() const { return true; } + + // apply normalized sensitivity percent (0..100) to the concrete chip register + virtual void applySgSensitivityPercent(uint8_t pct) = 0; + + #ifdef DRIVER_TMC_STEPPER_STALLGUARD + // read SG result (0..1023), or 0xFFFF on invalid read + uint16_t readSg10(); + + // speed-bin selection using [armFps .. velocityMax] if available + uint8_t sgSpeedBin(float spd, float armFps) const; + + // cross-fade between adjacent bins to avoid abrupt trip jumps at bin edges. + void sgSpeedBlend(float spd, float armFps, uint8_t &b0, uint8_t &b1, float &t) const; + + // reset + void stallDetectSoftReset(); + void stallDetectHardReset(); + + // U10.6 fixed-point helpers for learned model storage + static constexpr uint8_t SG_FP_SHIFT = 6; + static constexpr uint16_t SG_FP_ONE = (uint16_t)(1u << SG_FP_SHIFT); + + static inline uint16_t sgToFp(uint16_t x) { + return (uint16_t)(x << SG_FP_SHIFT); + } + + static inline uint16_t sgFpToInt(uint16_t xfp) { + return (uint16_t)((xfp + (SG_FP_ONE >> 1)) >> SG_FP_SHIFT); + } + + void sgModelInit(SgModel& model) const; + bool sgModelValid(const SgModel& model) const; + void sgModelDebugDumpNv() const; + void sgRuntimeFromModel(); + void sgModelFromRuntime(); + + SgModel sgModel = {}; + float sgBaseF[2][SG_BINS] = {{0}}; + float sgDevF[2][SG_BINS] = {{0}}; + + uint16_t sgBadMs = 0; // persistence accumulator (milliseconds) + uint16_t sgWarmMs = 0; // warm-up accumulator (milliseconds) + uint32_t sgLastMs = 0; // last millis() sample time + uint8_t sgAppliedPct = 255; // last applied sensitivity percent + + // accel estimate (signed fullsteps/sec sample) + float sgLastFps = 0.0f; + + // smoothed ramp factor (0..1) + float sgRampF = 0.0f; + + // ---- speed-bin edge cache (avoid per-call powf) ---- + mutable bool sgBinValid = false; + mutable float sgBinArmFps = 0.0f; + mutable float sgBinHi = 0.0f; + mutable float sgBinAnchor[SG_BINS] = {0.0f}; + mutable float sgBinEdge[SG_BINS - 1] = {0.0f}; + // ---------------------------------------------------- + + // stallguard sample caching + uint32_t sgLastGoodMs = 0; + uint32_t sgRetryAtMs = 0; + uint16_t sgCached = 0xFFFF; + + // debug logging + uint16_t sgLast = 0xFFFF; + uint16_t sgLastMargin = 0; + uint16_t sgLastRampExtra = 0; + bool sgBadLast = false; + bool sgModelSavePending = false; + uint32_t sgModelSaveIntervalMs = (uint32_t)SG_MODEL_SAVE_MS; + uint32_t sgModelLastSaveMs = 0; + + // Used to avoid treating an immediate transient SG==0 as a fault right at arming. + // (prevents hard-bad from triggering before any SG has had a chance to settle) + static constexpr uint16_t SG_ZERO_GRACE_MS = 50; + #endif + + // debug logging + int16_t sgAppliedReg = 0; + + // indicates stalled state + bool sgLatch = false; + + // keep track of training disable events + float sgTrainPrev = OFF; + + // key for NV model storage + uint32_t nvKey = 0; + + // ---------------------- PARAMETERS ---------------------- + AxisParameter sgEnabled = {NAN, NAN, NAN, -2, -1, AXP_BOOLEAN, "SG Enable"}; + AxisParameter sgTrain = {NAN, NAN, NAN, -2, -1, AXP_BOOLEAN_IMMEDIATE, "SG Train"}; + + // Floor raises the trip threshold in steady-state only: + // higher => more aggressive, trips sooner (applied only when sgRampF is low). + AxisParameter sgFloorPct = {NAN, NAN, NAN, 0, 100, AXP_INTEGER_IMMEDIATE, "SG Floor, %"}; + AxisParameter sgRampAllowPct = {NAN, NAN, NAN, 0, 100, AXP_INTEGER_IMMEDIATE, "SG Ramp Allow, %"}; + + AxisParameter sgSensitivity = {NAN, NAN, NAN, 0, 100, AXP_INTEGER_IMMEDIATE, "SG Sens, %"}; + AxisParameter sgArmFps = {NAN, NAN, NAN, 50, 2000, AXP_INTEGER_IMMEDIATE, "SG Arm, FPS"}; + AxisParameter sgArmFaultMs = {NAN, NAN, NAN, 50, 500, AXP_INTEGER_IMMEDIATE, "SG Fault, ms"}; + + + #ifdef DRIVER_TMC_STEPPER_STALLGUARD + #ifdef DRIVER_TMC_STEPPER_STALLGUARD_BASIC + const int numParameters = 11; + #else + const int numParameters = 14; + #endif + #else + const int numParameters = 7; + #endif + + AxisParameter* parameter[15] = { + &invalid, µsteps, µstepsSlewing, + ¤tHold, ¤tRun, ¤tSlewing, + &decay, &decaySlewing, +// &intpol, + &sgEnabled, &sgTrain, + &sgFloorPct, &sgRampAllowPct, + + &sgSensitivity, &sgArmFps, &sgArmFaultMs + }; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/legacy/TmcSPI.cpp b/src/lib/axis/motor/stepDir/tmc/legacy/TmcSPI.cpp new file mode 100755 index 0000000..621a85b --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/legacy/TmcSPI.cpp @@ -0,0 +1,269 @@ +// ----------------------------------------------------------------------------------- +// Step/Dir TMC SPI motor driver + +#include "TmcSPI.h" + +#if !defined(DRIVER_TMC_STEPPER) && defined(STEP_DIR_TMC_SPI_PRESENT) + +#include "../TmcStepDirDriver.h" + +bool TmcSPI::init(int model, int16_t mosi, int16_t sck, int16_t cs, int16_t miso, int16_t axisNumber) { + active = false; + this->model = model; + UNUSED(axisNumber); + + if (model == TMC2130 || model == TMC5160) { + active = softSpi.init(mosi, sck, cs, miso); + return true; + } else + + return false; +} + +bool TmcSPI::mode(bool intpol, int decay_mode, byte micro_step_code, int irun, int ihold, float rsense) { + if (!active) return false; + + softSpi.begin(); + uint32_t data_out = 0; + + // *** My notes are limited, see the TMC2130 datasheet for more info. *** + + // IHOLDDELAY=0x00, IRUN=0x1F, IHOLD=0x1F ( 0, 31, 31 ) or 50% (0,16,16) + // 0b0000 11111 11111 + // IHOLD, default=16, range 0 to 31 (Standstill current 0=1/32... 31=32/32) + // IRUN, default=31, range 0 to 31 (Run current 0=1/32... 31=32/32) + // IHOLDDELAY, default=4, range 0 to 15 (Delay per current reduction step in x 2^18 clocks) + + float Ifs = 0.325/rsense; + if (model == TMC2130) Ifs = 0.325/(rsense + 0.02); + + long IHOLD = round(( (ihold/1000.0)/Ifs)*32.0)-1; + long IRUN = round(( (irun/1000.0)/Ifs)*32.0)-1; + if (IHOLD < 0) IHOLD = 0; + if (IHOLD > 31) IHOLD = 31; + if (IRUN < 0) IRUN = 0; + if (IRUN > 31) IRUN = 31; + + // IHOLD + IRUN + IHOLDDELAY + data_out = (IHOLD << 0) + (IRUN << 8) + (4UL << 16); + if (last_IHOLD_IRUN != data_out) { + last_IHOLD_IRUN = data_out; + uint8_t statusFlag = write(REG_IHOLD_IRUN, data_out); + softSpi.pause(); + + // if we can, check if the driver is there + #ifdef MOTOR_DRIVER_DETECT + if (!softSpi.outOnly()) { + // check for standstill status flag + bool standstill = statusFlag & 0b00001000; + // check for fault status flag + bool fault = statusFlag & 0b00000010; + if (!standstill || fault) { + softSpi.end(); + active = false; + return false; + } + } + #else + UNUSED(statusFlag); + #endif + } + + // TPOWERDOWN, default=127, range 0 to 255 (Delay after standstill for motor current power down, about 0 to 4 seconds) + data_out = (tpd_value << 0); + if (last_TPOWERDOWN != data_out) { + last_TPOWERDOWN = data_out; + write(REG_TPOWERDOWN, data_out); + softSpi.pause(); + } + + // TPWMTHRS, default=0, range 0 to 2^20 (switchover upper velocity for stealthChop voltage PWM mode) + data_out = (tpt_value << 0); + if (last_TPWMTHRS != data_out) { + last_TPWMTHRS = data_out; + write(REG_TPWMTHRS, data_out); + softSpi.pause(); + } + + // THIGH, default=0, range 0 to 2^20 (switchover rate for vhighfs/vhighchm) + data_out = (thigh_value << 0); + if (last_THIGH != data_out) { + last_THIGH = data_out; + write(REG_THIGH, data_out); + softSpi.pause(); + } + + // PWMCONF + if (model == TMC2130) { + // default=0x00050480UL + data_out = (pc_pwm_ampl<<0)+(pc_pwm_grad<<8)+(pc_pwm_freq<<16)+(pc_pwm_auto<<18)+(pc_pwm_sym<<19)+(pc_pwm_freewheel<<20); + if (last_PWMCONF != data_out) { + last_PWMCONF = data_out; + write(REG_PWMCONF, data_out); + softSpi.pause(); + } + } else + if (model == TMC5160) { + // default=0xC40C001EUL + data_out = (pc_pwm_ofs<<0)+(pc_pwm_grad<<8)+(pc_pwm_freq<<16)+(pc_pwm_auto<<18)+(pc_pwm_autograd<<19)+(pc_pwm_freewheel<<20)+(pc_pwm_reg<<24)+(pc_pwm_lim<<28); + if (last_PWMCONF != data_out) { + last_PWMCONF = data_out; + write(REG_PWMCONF, data_out); + softSpi.pause(); + } + } + + // CHOPCONF + if (intpol) cc_intpol=1; else cc_intpol=0; // set interpolation bit + // default=0x00008008UL + if (model == TMC2130) last_chop_config = (cc_toff<<0)+(cc_hstart<<4)+(cc_hend<<7)+(cc_rndtf<<13)+(cc_tbl<<15)+(cc_vsense<<17)+(cc_vhighfs<<18)+(cc_vhighchm<<19)+(cc_intpol<<28); + // default=0x10410150UL + if (model == TMC5160) last_chop_config = (cc_toff<<0)+(cc_hstart<<4)+(cc_hend<<7)+(cc_tbl<<15)+(cc_vhighfs<<18)+(cc_vhighchm<<19)+(cc_tpfd<<20)+(cc_intpol<<28); + if (micro_step_code != 255) { + data_out = last_chop_config + (((uint32_t)micro_step_code)<<24); + write(REG_CHOPCONF, data_out); + softSpi.pause(); + } + + // GCONF + // voltage on AIN is current reference + data_out = 0x00000001UL; + // set stealthChop bit + if (decay_mode == STEALTHCHOP) data_out |= 0x00000004UL; + if (last_GCONF != data_out) { + last_GCONF = data_out; + write(REG_GCONF, data_out); + } + + softSpi.end(); + return true; +} + +bool TmcSPI::error() { + if (!active) return false; + + if (model == TMC2130 || model == TMC5160) { + softSpi.begin(); + + // get global status register, look for driver error bit + uint32_t data_out = 0; + uint8_t result = read(REG_DRVSTATUS, &data_out); + + softSpi.end(); + if ((result & 2) != 0 || (result == 0 && data_out == 0)) return true; else return false; + } else + + return true; +} + +bool TmcSPI::refresh_CHOPCONF(byte micro_step_code) { + if (!active) return false; + + if (model == TMC2130 || model == TMC5160) { + softSpi.begin(); + + // default=0x00008008UL + if (model == TMC2130) last_chop_config = (cc_toff<<0)+(cc_hstart<<4)+(cc_hend<<7)+(cc_rndtf<<13)+(cc_tbl<<15)+(cc_vsense<<17)+(cc_vhighfs<<18)+(cc_vhighchm<<19)+(cc_intpol<<28); + // default=0x10410150UL + if (model == TMC5160) last_chop_config = (cc_toff<<0)+(cc_hstart<<4)+(cc_hend<<7)+(cc_tbl<<15)+(cc_vhighfs<<18)+(cc_vhighchm<<19)+(cc_tpfd<<20)+(cc_intpol<<28); + + write(REG_CHOPCONF, last_chop_config + (((uint32_t)micro_step_code)<<24)); + softSpi.end(); + return true; + } else + + return false; +} + +uint32_t TmcSPI::read_CHOPCONF() { + if (!active) return false; + + if (model == TMC2130 || model == TMC5160) { + softSpi.begin(); + + uint32_t data_out = 0; + read(REG_CHOPCONF, &data_out); + + // first write returns nothing, second the data + data_out = 0; + read(REG_DRVSTATUS, &data_out); + + softSpi.end(); + return data_out; + } else + + return 0; +} + +int TmcSPI::refresh_DRVSTATUS() { + if (!active) return false; + + if (model == TMC2130 || model == TMC5160) { + softSpi.begin(); + + // get global status register, look for driver error bit + uint32_t data_out=0; + uint8_t result = read(REG_DRVSTATUS, &data_out); + + softSpi.pause(); + + // first write returns nothing, second the status data + data_out=0; + read(REG_DRVSTATUS, &data_out); + + // get the extended status info. + if (data_out != 0 || result != 0) { + ds_stst = (bool)bitRead(data_out,31); // DRV_STATUS 31 Standstill + ds_olb = (bool)bitRead(data_out,30); // DRV_STATUS 30 Open Load B + ds_ola = (bool)bitRead(data_out,29); // DRV_STATUS 29 Open Load A + ds_s2ga = (bool)bitRead(data_out,28); // DRV_STATUS 28 Short to Ground B + ds_s2gb = (bool)bitRead(data_out,27); // DRV_STATUS 27 Short to Ground A + ds_otpw = (bool)bitRead(data_out,26); // DRV_STATUS 26 Overtemperature Pre-warning 120C + ds_ot = (bool)bitRead(data_out,25); // DRV_STATUS 25 Overtemperature Shutdown 150C + ds_stallguard = (bool)bitRead(data_out,24); // DRV_STATUS 24 stallGuard2 status + ds_cs_actual = (data_out>>16) & 0b011111; // DRV_STATUS 16 Actual current control scaling + ds_fs_active = (bool)bitRead(data_out,15); // DRV_STATUS 15 Full step active indicator + ds_result = data_out & 0b1111111111; // DRV_STATUS 0 stallGuard2 result + } else { + ds_stst = true; ds_olb = true; ds_ola = true; ds_s2ga = true; ds_s2gb = true; ds_otpw = true; + ds_ot = true; ds_stallguard = false; ds_cs_actual = 0; ds_fs_active = false; ds_result = 0; + } + + softSpi.end(); + return data_out != 0; + } else + + return 0; +} + +bool TmcSPI::refresh_COOLCONF() { + if (!active) return false; + + if (model == TMC2130 || model == TMC5160) { + softSpi.begin(); + + uint32_t data_out = (cl_semin<<0)+(cl_seup<<5)+(cl_semax<<8)+(cl_sedn<<13)+(cl_seimin<<15)+(cl_sgt<<16)+(cl_sfilt<<24); + write(REG_COOLCONF, data_out); + + softSpi.end(); + return true; + } else + + return false; +} + +uint8_t TmcSPI::write(byte Address, uint32_t data_out) { + Address = Address | 0x80; + uint8_t status_byte = softSpi.transfer(Address); + softSpi.transfer32(data_out); + return status_byte; +} + +uint8_t TmcSPI::read(byte Address, uint32_t* data_out) { + Address = Address & ~0x80; + uint8_t status_byte = softSpi.transfer(Address); + *data_out = softSpi.transfer32(*data_out); + return status_byte; +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/legacy/TmcSPI.h b/src/lib/axis/motor/stepDir/tmc/legacy/TmcSPI.h new file mode 100755 index 0000000..6ce5e08 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/legacy/TmcSPI.h @@ -0,0 +1,180 @@ +// ----------------------------------------------------------------------------------- +// Step/Dir TMC SPI motor driver +#pragma once + +#include +#include "../../../../../../Common.h" + +#if !defined(DRIVER_TMC_STEPPER) && defined(STEP_DIR_TMC_SPI_PRESENT) + +#include "../../../../../softSpi/SoftSpi.h" + +class TmcSPI { + public: + // setup SoftSpi or UART and driver model + bool init(int model, int16_t mosi, int16_t sck, int16_t cs, int16_t miso, int16_t axisNumber = 0); + + // TMC setup most common settings + // 256x interpolation: intpol + // decay mode: decay_mode (STEALTHCHOP or SPREADCYCLE) + // microstepping mode: micro_step_code (0=256x, 1=128x, 2=64x, 3=32x, 4=16x, 5=8x, 6=4x, 7=2x, 8=1x) + // irun, ihold, rsense: current in mA and sense resistor value + bool mode(bool intpol, int decay_mode, byte micro_step_code, int irun, int ihold, float rsense); + + // Check for TMC error from DRVSTATUS register + bool error(); + int refresh_DRVSTATUS(); + inline bool get_DRVSTATUS_stst() { return ds_stst; } + inline bool get_DRVSTATUS_olA() { return ds_ola; } + inline bool get_DRVSTATUS_olB() { return ds_olb; } + inline bool get_DRVSTATUS_s2gA() { return ds_s2ga; } + inline bool get_DRVSTATUS_s2gB() { return ds_s2gb; } + inline bool get_DRVSTATUS_otpw() { return ds_otpw; } + inline bool get_DRVSTATUS_ot() { return ds_ot; } + inline bool get_DRVSTATUS_stallguard() { return ds_stallguard; } + inline int get_DRVSTATUS_cs_actual() { return ds_cs_actual; } + inline bool get_DRVSTATUS_active() { return ds_fs_active; } + inline int get_DRVSTATUS_result() { return ds_result; } + + // Chopper configuration + bool refresh_CHOPCONF(byte micro_step_code); + uint32_t read_CHOPCONF(); + inline bool set_CHOPCONF_toff(int v) { if (v >= 2 && v <= 15) { cc_toff = v; return true; } return false; } + inline bool set_CHOPCONF_hstart(int v) { if (v >= 0 && v <= 7) { cc_hstart = v; return true; } return false; } + inline bool set_CHOPCONF_hend(int v) { if (v >= 0 && v <= 15) { cc_hend = v; return true; } return false; } + inline bool set_CHOPCONF_rndtf(int v) { if (v >= 0 && v <= 1) { cc_rndtf = v; return true; } return false; } + inline bool set_CHOPCONF_tbl(int v) { if (v >= 0 && v <= 3) { cc_tbl = v; return true; } return false; } + inline bool set_CHOPCONF_vsense(int v) { if (v >= 0 && v <= 1) { cc_vsense = v; return true; } return false; } + inline bool set_CHOPCONF_vhighfs(int v) { if (v >= 0 && v <= 1) { cc_vhighfs = v; return true; } return false; } + inline bool set_CHOPCONF_vhighchm(int v) { if (v >= 0 && v <= 1) { cc_vhighchm = v; return true; } return false; } + inline bool set_CHOPCONF_intpol(int v) { if (v >= 0 && v <= 1) { cc_intpol = v; return true; } return false; } + // TMC5160 specific + inline bool set_CHOPCONF_tpfd(int v) { if (v >= 0 && v <= 15) { cc_tpfd = v; return true; } return false; } + volatile uint32_t last_chop_config; + + // Misc. configuration + inline bool set_TPOWERDOWN_value(int v) { if (v >= 0 && v <= 255) { tpd_value = v; return true; } return false; } + inline bool set_TPWMTHRS_value(long v) { if (v >= 0 && v <= 1048575) { tpt_value = v; return true; } return false; } + inline bool set_THIGH_value(long v) { if (v >= 0 && v <= 1048575) { thigh_value = v; return true; } return false; } + + // PWM/stealthChop configuration + inline bool set_PWMCONF_PWM_GRAD(int v) { if (v >= 0 && v <= 255) { pc_pwm_grad = v; return true; } return false; } + inline bool set_PWMCONF_pwm_freq(int v) { if (v >= 0 && v <= 3) { pc_pwm_freq = v; return true; } return false; } + inline bool set_PWMCONF_pwm_auto(int v) { if (v >= 0 && v <= 1) { pc_pwm_auto = v; return true; } return false; } + inline bool set_PWMCONF_pwm_freewheel(int v) { if (v >= 0 && v <= 1) { pc_pwm_freewheel= v; return true; } return false; } + // TMC2130 specific + inline bool set_PWMCONF_PWM_AMPL(int v) { if (v >= 0 && v <= 255) { pc_pwm_ampl = v; return true; } return false; } + inline bool set_PWMCONF_pwm_sym(int v) { if (v >= 0 && v <= 1) { pc_pwm_sym = v; return true; } return false; } + // TMC5160/5161 specific + inline bool set_PWMCONF_PWM_OFS(int v) { if (v >= 0 && v <= 255) { pc_pwm_ofs = v; return true; } return false; } + inline bool set_PWMCONF_pwm_autograd(int v) { if (v >= 0 && v <= 1) { pc_pwm_autograd = v; return true; } return false; } + inline bool set_PWMCONF_PWM_REG(int v) { if (v >= 0 && v <= 15) { pc_pwm_reg = v; return true; } return false; } + inline bool set_PWMCONF_PWM_LIM(int v) { if (v >= 0 && v <= 15) { pc_pwm_lim = v; return true; } return false; } + + // Coolstep and stallguard configurarion + bool refresh_COOLCONF(); + inline bool set_COOLCONF_semin(int v) { if (v >= 0 && v <= 15) { cl_semin = v; return true; } return false; } + inline bool set_COOLCONF_seup(int v) { if (v >= 0 && v <= 3) { cl_seup = v; return true; } return false; } + inline bool set_COOLCONF_semax(int v) { if (v >= 0 && v <= 15) { cl_semax = v; return true; } return false; } + inline bool set_COOLCONF_sedn(int v) { if (v >= 0 && v <= 3) { cl_sedn = v; return true; } return false; } + inline bool set_COOLCONF_seimin(int v) { if (v >= 0 && v <= 1) { cl_seimin= v; return true; } return false; } + inline bool set_COOLCONF_sgt(int v) { if (v >= -64 && v <= 63) { cl_sgt= v+64; return true; } return false; } + inline bool set_COOLCONF_sfilt(int v) { if (v >= 0 && v <= 1) { cl_sfilt = v; return true; } return false; } + + private: + uint8_t write(byte Address, uint32_t data_out); + uint8_t read(byte Address, uint32_t* data_out); + + // the write flag and various TMC SPI registers + static const uint8_t WRITE = 0x80; + static const uint8_t REG_GCONF = 0x00; + static const uint8_t REG_GSTAT = 0x01; + static const uint8_t REG_IHOLD_IRUN = 0x10; + static const uint8_t REG_TPOWERDOWN = 0x11; + static const uint8_t REG_TPWMTHRS = 0x13; + static const uint8_t REG_THIGH = 0x15; + static const uint8_t REG_CHOPCONF = 0x6C; + static const uint8_t REG_COOLCONF = 0x6D; + static const uint8_t REG_DCCTRL = 0x6E; + static const uint8_t REG_DRVSTATUS = 0x6F; + static const uint8_t REG_PWMCONF = 0x70; + + // keep track of what commands need to be sent + int last_microStepCode = -1; + int last_irun = -1; + int last_ihold = -1; + + // keep track of what registers need to be updated + uint32_t last_GCONF = 0; + uint32_t last_IHOLD_IRUN = 0; + uint32_t last_TPOWERDOWN = 0; + uint32_t last_TPWMTHRS = 0; + uint32_t last_THIGH = 0; + uint32_t last_PWMCONF = 0; + + // CHOPCONF settings + uint32_t cc_toff = 4; // default=4, range 2 to 15 (Off time setting, slow decay phase) + uint32_t cc_hstart = 0; // default=0, range 0 to 7 (Hysteresis start 1, 2, ..., 8) + uint32_t cc_hend = 0; // default=0, range 0 to 15 (Hysteresis -3, -2, -1, 0, 1 ..., 12) + uint32_t cc_rndtf = 0; // default=0, range 0 to 1 (Enables small random value to be added to TOFF) + uint32_t cc_tbl = 1; // default=1, range 0 to 3 (for 6, 24, 36 or 54 clocks) + uint32_t cc_vsense = 0; // default=0, range 0 to 1 (0 for high sensitivity, 1 for low sensitivity @ 50% current setting) + uint32_t cc_vhighfs = 0; // default=0, range 0 to 1 (Enables switch to full-step when VHIGH (THIGH?) is exceeded) + uint32_t cc_vhighchm = 0; // default=0, range 0 to 1 (Enables switch to fast-decay mode VHIGH (THIGH?) is exceeded) + uint32_t cc_intpol = 1; // default=1, range 0 to 1 (Enables 256x interpolation) + + // TMC5160 specific + uint32_t cc_tpfd = 4UL; // default=4, range 0 to 15 (Passive fast decay time mid-range resonance dampening) + + // TPOWERDOWN settings + uint32_t tpd_value = 128; // default=127, range 0 to 255 (Delay after standstill for motor current power down, about 0 to 4 seconds) + + // TPWMTHRS settings + uint32_t tpt_value = 0; // default=0, range 0 to 2^20 (Switchover upper velocity for stealthChop voltage PWM mode) + + // THIGH settings + uint32_t thigh_value = 0; // default=0, range 0 to 2^20 (Switchover rate for vhighfs/vhighchm) + + // PWMCONF settings + uint32_t pc_pwm_grad = 0x04; // default=4, range 0 to 14 (PWM gradient scale using automatic current control) + uint32_t pc_pwm_freq = 0x01; // default=1, range 0 to 3 (PWM frequency 0: fpwm=2/1024 fclk, 1: fpwm=2/683 fclk, 2: fpwm=2/512 fclk, 3: fpwm=2/410 fclk) + uint32_t pc_pwm_auto = 0x01; // default=1, range 0 to 1 (PWM automatic current control 0: off, 1: on) + uint32_t pc_pwm_freewheel = 0x01; // default=1, range 0 to 3 (PWM freewheel 0: normal, 1: freewheel, 2:LS short, 3: HS short) + // TMC2130 specific + uint32_t pc_pwm_ampl = 0x80; // default=128, range 0 to 255 (PWM amplitude or switch back amplitude if pwm_auto=1) + uint32_t pc_pwm_sym = 0x00; // default=0, range 0 to 1 (PWM symmetric 0: value may change during cycle, 1: enforce; 0: disable autograd on TMC5160/5161) + // TMC2209/TMC5160 specific + uint32_t pc_pwm_ofs = 0x1e; // default=30, range 0 to 255 (PWM user defined amplitude offset related to full motor current) + uint32_t pc_pwm_autograd = 0x00; // default=0, range 0 to 1 (PWM automatic grad control 0: off, 1: on) + uint32_t pc_pwm_reg = 0x04; // default=4, range 0 to 15 (PWM maximum amplitude change per half-wave when using pwm autoscale) + uint32_t pc_pwm_lim = 0x0c; // default=12, range 0 to 15 (PWM limit for PWM_SCALE_AUTO when switching back from spreadCycle to stealthChop) + + // DRVSTATUS settings + bool ds_stst = false; + bool ds_olb = false; + bool ds_ola = false; + bool ds_s2ga = false; + bool ds_s2gb = false; + bool ds_ot = false; + bool ds_otpw = false; + bool ds_stallguard = false; + uint16_t ds_cs_actual = 0; + bool ds_fs_active = false; + uint16_t ds_result = 0; + + // COOLCONF settings + uint32_t cl_semin = 0; // default=0, range 0 to 15 (Minimum stallGuard2 value for smart current control and smart current enable) + uint32_t cl_seup = 0; // default=0, range 0 to 3 (Current up step width) + uint32_t cl_semax = 0; // default=0, range 0 to 15 (stallGuard2 hysteresis value for smart current control) + uint32_t cl_sedn = 0; // default=0, range 0 to 3 (Current down step speed) + uint32_t cl_seimin = 0; // default=0, range 0 to 1 (Minimum current for scc) + uint32_t cl_sgt = 0; // default=0, range 0 to 127 (stallGuard2 hysteresis value -64 to 63) + uint32_t cl_sfilt = 0; // default=0, range 0 to 1 (stallGuard2 filter enable) + + bool active = false; + int model; + + SoftSpi softSpi; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/legacy/tmc2130/Tmc2130.cpp b/src/lib/axis/motor/stepDir/tmc/legacy/tmc2130/Tmc2130.cpp new file mode 100755 index 0000000..b37debb --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/legacy/tmc2130/Tmc2130.cpp @@ -0,0 +1,97 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2130Stepper + +// note: LegacySPI requires MOSI, SCK, CS but MISO is optional + +#include "Tmc2130.h" + +#if !defined(DRIVER_TMC_STEPPER) && defined(TMC2130_PRESENT) + +#include "../../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +// constructor +StepDirTmc2130::StepDirTmc2130(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriverNSG(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc2130StepDir legacy, "); + axisPrefix[5] = '0' + axisNumber; +} + +// set up driver and parameters: microsteps, microsteps goto, hold current, run current, goto current, unused +bool StepDirTmc2130::init() { + if (!TmcStepDirDriver::init()) return false; + + // get TMC SPI ready + driver.init(driverModel, Pins->m0, Pins->m1, Pins->m2, Pins->m3, axisNumber); + + // get driver ready and check to see if it's there (if possible) + if (!driver.mode(intpol.value == ON, decay.value, microstepCode, iRun, iHold, rSense)) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { + if (Pins->m3 != OFF) { + VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); + } + } + + return true; +} + +void StepDirTmc2130::modeMicrostepTracking() { + driver.refresh_CHOPCONF(microstepCode); +} + +int StepDirTmc2130::modeMicrostepSlewing() { + if (microstepRatio > 1) { + driver.refresh_CHOPCONF(microstepCodeSlewing); + } + return microstepRatio; +} + +void StepDirTmc2130::modeDecayTracking() { + driver.mode(intpol.value == ON, decay.value, microstepCode, iRun, iHold, rSense); +} + +void StepDirTmc2130::modeDecaySlewing() { + driver.mode(intpol.value == ON, decaySlewing.value, microstepCode, iGoto, iHold, rSense); +} + +void StepDirTmc2130::readStatus() { + if (driver.refresh_DRVSTATUS()) { + status.outputA.shortToGround = driver.get_DRVSTATUS_s2gA(); + status.outputA.openLoad = driver.get_DRVSTATUS_olA(); + status.outputB.shortToGround = driver.get_DRVSTATUS_s2gB(); + status.outputB.openLoad = driver.get_DRVSTATUS_olB(); + status.overTemperatureWarning = driver.get_DRVSTATUS_otpw(); + status.overTemperature = driver.get_DRVSTATUS_ot(); + status.standstill = driver.get_DRVSTATUS_stst(); + } +} + +// secondary way to power down not using the enable pin +bool StepDirTmc2130::enable(bool state) { + if (state) { + driver.mode(intpol.value == ON, decay.value, microstepCode, iRun, iHold, rSense); + } else { + driver.mode(intpol.value == ON, STEALTHCHOP, microstepCode, iRun, 0, rSense); + } + return true; +} + +// calibrate the motor driver if required +void StepDirTmc2130::calibrateDriver() { + if (decay.value == STEALTHCHOP || decaySlewing.value == STEALTHCHOP) { + VF("MSG:"); V(axisPrefix); VL("TMC standstill automatic current calibration"); + driver.mode(intpol.value == ON, STEALTHCHOP, microstepCode, iRun, iRun, rSense); + delay(1000); + driver.mode(intpol.value == ON, decay.value, microstepCode, iRun, iHold, rSense); + } +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/legacy/tmc2130/Tmc2130.h b/src/lib/axis/motor/stepDir/tmc/legacy/tmc2130/Tmc2130.h new file mode 100755 index 0000000..6f1e2be --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/legacy/tmc2130/Tmc2130.h @@ -0,0 +1,46 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if !defined(DRIVER_TMC_STEPPER) && defined(TMC2130_PRESENT) + +#include "../TmcSPI.h" +#include "../../TmcStepDirDriverNSG.h" + +class StepDirTmc2130 : public TmcStepDirDriverNSG { + public: + // constructor + StepDirTmc2130(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // calibrate the motor driver if required + void calibrateDriver(); + + private: + // read status info. from driver + void readStatus(); + + TmcSPI driver; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/legacy/tmc2209/Tmc2209.cpp b/src/lib/axis/motor/stepDir/tmc/legacy/tmc2209/Tmc2209.cpp new file mode 100755 index 0000000..f1d00ff --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/legacy/tmc2209/Tmc2209.cpp @@ -0,0 +1,166 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2209Stepper + +// note: LegacyUART requires UART RX but TX is optional + +#include "Tmc2209.h" + +#if !defined(DRIVER_TMC_STEPPER) && defined(TMC2209_PRESENT) + +#include "../../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define rx m3 +#define tx m2 + +#define CurrentToPercent(current) ((current/1000.0)/(0.325/(rSense + 0.02)))*100.0 + +// constructor +StepDirTmc2209::StepDirTmc2209(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriverNSG(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc2209StepDir legacy, "); + axisPrefix[5] = '0' + axisNumber; +} + +// setup driver +bool StepDirTmc2209::init() { + if (!TmcStepDirDriver::init()) return false; + + // get TMC UART driver ready + pinModeEx(Pins->m0, OUTPUT); + pinModeEx(Pins->m1, OUTPUT); + + driver = new TMC2209Stepper(); + if (driver == NULL) return false; + + int16_t rxPin = Pins->rx; + + delay(1); + #if defined(SERIAL_TMC_HARDWARE_UART) + #if defined(DEDICATED_MODE_PINS) + // program the device address 0,1,2,3 since M0 and M1 are all unique + int deviceAddress = SERIAL_TMC_ADDRESS_MAP(axisNumber - 1); + digitalWriteEx(Pins->m0, bitRead(deviceAddress, 0)); + digitalWriteEx(Pins->m1, bitRead(deviceAddress, 1)); + #else + // help user hard code the device address 0,1,2,3 by cutting pins + digitalWriteEx(Pins->m0, HIGH); + digitalWriteEx(Pins->m1, HIGH); + #endif + + VF("MSG:"); V(axisPrefix); + VF("HW UART driver pins rx="); V(SERIAL_TMC_RX); VF(", tx="); V(SERIAL_TMC_TX); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + pinModeEx(SERIAL_TMC_RX, INPUT_PULLUP); + #if SERIAL_TMC_INVERT == ON + driver->setup(SERIAL_TMC, SERIAL_TMC_BAUD, SERIAL_TMC_ADDRESS_MAP(axisNumber - 1), SERIAL_TMC_RX, SERIAL_TMC_TX, true); + #else + driver->setup(SERIAL_TMC, SERIAL_TMC_BAUD, SERIAL_TMC_ADDRESS_MAP(axisNumber - 1), SERIAL_TMC_RX, SERIAL_TMC_TX); + #endif + rxPin = SERIAL_TMC_RX; + #else + // pull MS1 and MS2 low for device address 0 + digitalWriteEx(Pins->m0, LOW); + digitalWriteEx(Pins->m1, LOW); + + #if SERIAL_TMC_RX_DISABLE == true + rxPin = OFF; + #endif + VF("MSG:"); V(axisPrefix); + VF("SW UART driver pins rx="); V(rxPin); VF(", tx="); V(Pins->tx); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + pinModeEx(rxPin, INPUT_PULLUP); + driver->setup(SERIAL_TMC_BAUD, SERIAL_TMC_ADDRESS_MAP(axisNumber - 1), rxPin, Pins->tx); + #endif + + // this driver automatically switches to one-way communications, even if a RX pin is set + // so the following only returns false if communications are "half working" + #ifdef MOTOR_DRIVER_DETECT + if (rxPin != OFF) { + if (!driver->isSetupAndCommunicating()) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + } + #endif + + driver->useExternalSenseResistors(); + driver->enableAnalogCurrentScaling(); + + driver->enable(); + driver->moveUsingStepDirInterface(); + driver->setPwmOffset(pc_pwm_ofs); + driver->setPwmGradient(pc_pwm_grad); + if (pc_pwm_auto) driver->enableAutomaticCurrentScaling(); + if (!intpol.value) { + VF("MSG:"); V(axisPrefix); VLF("driver interpolation control not supported"); + } + + modeMicrostepTracking(); + driver->setRunCurrent(CurrentToPercent(iRun)); + driver->setHoldCurrent(CurrentToPercent(iHold)); + driver->disableStealthChop(); + + return true; +} + +void StepDirTmc2209::modeMicrostepTracking() { + driver->setMicrostepsPerStep(normalizedMicrosteps); +} + +int StepDirTmc2209::modeMicrostepSlewing() { + if (microstepRatio > 1) { + driver->setMicrostepsPerStep(normalizedMicrostepsSlewing); + } + return microstepRatio; +} + +void StepDirTmc2209::modeDecayTracking() { + if (normalizedDecay == SPREADCYCLE) driver->disableStealthChop(); else driver->enableStealthChop(); + driver->setRunCurrent(CurrentToPercent(iRun)); + driver->setHoldCurrent(CurrentToPercent(iHold)); +} + +void StepDirTmc2209::modeDecaySlewing() { + if (decaySlewing.value == SPREADCYCLE) driver->disableStealthChop(); else driver->enableStealthChop(); + driver->setRunCurrent(CurrentToPercent(iGoto)); + driver->setHoldCurrent(CurrentToPercent(iHold)); +} + +void StepDirTmc2209::readStatus() { + TMC2209Stepper::Status status_result = driver->getStatus(); + status.outputA.shortToGround = (bool)status_result.short_to_ground_a || (bool)status_result.low_side_short_a; + status.outputA.openLoad = (bool)status_result.open_load_a; + status.outputB.shortToGround = (bool)status_result.short_to_ground_b || (bool)status_result.low_side_short_b; + status.outputB.openLoad = (bool)status_result.open_load_b; + status.overTemperatureWarning = (bool)status_result.over_temperature_warning; + status.overTemperature = (bool)status_result.over_temperature_shutdown; + status.standstill = (bool)status_result.standstill; +} + +// secondary way to power down not using the enable pin +bool StepDirTmc2209::enable(bool state) { + if (state) { + modeDecayTracking(); + } else { + driver->enableStealthChop(); + driver->setHoldCurrent(0); + } + + return true; +} + +// calibrate the motor driver if required +void StepDirTmc2209::calibrateDriver() { + if (decay.value == STEALTHCHOP || decaySlewing.value == STEALTHCHOP) { + VF("MSG: StepDirDriver"); V(axisNumber); VL(", TMC standstill automatic current calibration"); + driver->setRunCurrent(CurrentToPercent(iRun)); + driver->setHoldCurrent(CurrentToPercent(iRun)); + driver->enableStealthChop(); + delay(1000); + driver->setRunCurrent(CurrentToPercent(iRun)); + driver->setHoldCurrent(CurrentToPercent(iHold)); + driver->disableStealthChop(); + } +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/legacy/tmc2209/Tmc2209.h b/src/lib/axis/motor/stepDir/tmc/legacy/tmc2209/Tmc2209.h new file mode 100755 index 0000000..0566aef --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/legacy/tmc2209/Tmc2209.h @@ -0,0 +1,75 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if !defined(DRIVER_TMC_STEPPER) && defined(TMC2209_PRESENT) + +#include "../../TmcStepDirDriverNSG.h" + +// default settings for any TMC UART drivers that may be present +#ifndef SERIAL_TMC + #define SERIAL_TMC SoftSerial // Use software serial with TX on M3 (CS) of each axis +#endif +#ifndef SERIAL_TMC_RX_DISABLE + #define SERIAL_TMC_RX_DISABLE true // Recieving data often doesn't work with software serial +#endif +#ifndef SERIAL_TMC_BAUD + #define SERIAL_TMC_BAUD 115200 // Baud rate +#endif +#ifndef SERIAL_TMC_ADDRESS_MAP + #define SERIAL_TMC_ADDRESS_MAP(x) (0) // driver addresses are 0 for all axes +#endif +#ifndef SERIAL_TMC_INVERT + #define SERIAL_TMC_INVERT OFF // invert the serial interface signal logic +#endif + +#ifndef SERIAL_TMC_HARDWARE_UART + #include // source as appropriate for your platform (if not built-in) + #define TMC2209_SOFTWARE_SERIAL +#endif + +#define TMC2209_DEBUG false +#include // https://github.com/hjd1964/TMC2209 + +class StepDirTmc2209 : public TmcStepDirDriverNSG { + public: + // constructor + StepDirTmc2209(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // calibrate the motor driver if required + void calibrateDriver(); + + private: + // read status info. from driver + void readStatus(); + + // TMC2209/TMC5160 specific + uint32_t pc_pwm_grad = 0x04; // default=4, range 0 to 14 (PWM gradient scale using automatic current control) + uint32_t pc_pwm_auto = 0x01; // default=1, range 0 to 1 (PWM automatic current control 0: off, 1: on) + uint32_t pc_pwm_ofs = 0x1e; // default=30, range 0 to 255 (PWM user defined amplitude offset related to full motor current) + + TMC2209Stepper *driver; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/legacy/tmc5160/Tmc5160.cpp b/src/lib/axis/motor/stepDir/tmc/legacy/tmc5160/Tmc5160.cpp new file mode 100755 index 0000000..541fee7 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/legacy/tmc5160/Tmc5160.cpp @@ -0,0 +1,97 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC5160Stepper + +// note: LegacySPI requires MOSI, SCK, CS but MISO is optional + +#include "Tmc5160.h" + +#if !defined(DRIVER_TMC_STEPPER) && defined(TMC5160_PRESENT) + +#include "../../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +// constructor +StepDirTmc5160::StepDirTmc5160(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriverNSG(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc5160StepDir legacy, "); + axisPrefix[5] = '0' + axisNumber; +} + +// set up driver and parameters: microsteps, microsteps goto, hold current, run current, goto current, unused +bool StepDirTmc5160::init() { + if (!TmcStepDirDriver::init()) return false; + + // get TMC SPI ready + driver.init(driverModel, Pins->m0, Pins->m1, Pins->m2, Pins->m3, axisNumber); + + // get driver ready and check to see if it's there (if possible) + if (!driver.mode(intpol.value == ON, decay.value, microstepCode, iRun, iHold, rSense)) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { + if (Pins->m3 != OFF) { + VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); + } + } + + return true; +} + +void StepDirTmc5160::modeMicrostepTracking() { + driver.refresh_CHOPCONF(microstepCode); +} + +int StepDirTmc5160::modeMicrostepSlewing() { + if (microstepRatio > 1) { + driver.refresh_CHOPCONF(microstepCodeSlewing); + } + return microstepRatio; +} + +void StepDirTmc5160::modeDecayTracking() { + driver.mode(intpol.value == ON, decay.value, microstepCode, iRun, iHold, rSense); +} + +void StepDirTmc5160::modeDecaySlewing() { + driver.mode(intpol.value == ON, decaySlewing.value, microstepCode, iGoto, iHold, rSense); +} + +void StepDirTmc5160::readStatus() { + if (driver.refresh_DRVSTATUS()) { + status.outputA.shortToGround = driver.get_DRVSTATUS_s2gA(); + status.outputA.openLoad = driver.get_DRVSTATUS_olA(); + status.outputB.shortToGround = driver.get_DRVSTATUS_s2gB(); + status.outputB.openLoad = driver.get_DRVSTATUS_olB(); + status.overTemperatureWarning = driver.get_DRVSTATUS_otpw(); + status.overTemperature = driver.get_DRVSTATUS_ot(); + status.standstill = driver.get_DRVSTATUS_stst(); + } +} + +// secondary way to power down not using the enable pin +bool StepDirTmc5160::enable(bool state) { + if (state) { + driver.mode(intpol.value == ON, decay.value, microstepCode, iRun, iHold, rSense); + } else { + driver.mode(intpol.value == ON, STEALTHCHOP, microstepCode, iRun, 0, rSense); + } + return true; +} + +// calibrate the motor driver if required +void StepDirTmc5160::calibrateDriver() { + if (decay.value == STEALTHCHOP || decaySlewing.value == STEALTHCHOP) { + VF("MSG:"); V(axisPrefix); VL("TMC standstill automatic current calibration"); + driver.mode(intpol.value == ON, STEALTHCHOP, microstepCode, iRun, iRun, rSense); + delay(1000); + driver.mode(intpol.value == ON, decay.value, microstepCode, iRun, iHold, rSense); + } +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/legacy/tmc5160/Tmc5160.h b/src/lib/axis/motor/stepDir/tmc/legacy/tmc5160/Tmc5160.h new file mode 100755 index 0000000..dfcb2b9 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/legacy/tmc5160/Tmc5160.h @@ -0,0 +1,46 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if !defined(DRIVER_TMC_STEPPER) && defined(TMC5160_PRESENT) + +#include "../TmcSPI.h" +#include "../../TmcStepDirDriverNSG.h" + +class StepDirTmc5160 : public TmcStepDirDriverNSG { + public: + // constructor + StepDirTmc5160(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // calibrate the motor driver if required + void calibrateDriver(); + + private: + // read status info. from driver + void readStatus(); + + TmcSPI driver; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2130/Tmc2130.cpp b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2130/Tmc2130.cpp new file mode 100755 index 0000000..8817169 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2130/Tmc2130.cpp @@ -0,0 +1,130 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2130Stepper + +#include "Tmc2130.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2130_PRESENT) + +#include "../../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +// constructor +StepDirTmc2130:: +StepDirTmc2130(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriverSG(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc2130StepDir, "); + axisPrefix[5] = '0' + axisNumber; +} + +// setup driver +bool StepDirTmc2130::init() { + if (!TmcStepDirDriverSG::init()) return false; + + #ifdef DRIVER_TMC_STEPPER_HW_SPI + driver = new TMC2130Stepper(Pins->cs, rSense); + #else + driver = new TMC2130Stepper(Pins->cs, rSense, Pins->mosi, Pins->miso, Pins->sck); + #endif + driver->begin(); + driver->intpol(intpol.value == ON); + modeMicrostepTracking(); + driver->en_pwm_mode(false); + + current(iRun, iHoldRatio); + + // enable StallGuard / CoolStep speed threshold gating + // common "don't-care yet" value: always enable while moving + driver->TCOOLTHRS(0xFFFFF); // width depends on part; library handles masking + + // if you are NOT using CoolStep current scaling, keep it off + // disable CoolStep + driver->semin(0); + + // if we can, check to see if the driver is there + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + #ifndef DRIVER_TMC_STEPPER_HW_SPI + if (Pins->miso != OFF) + #endif + { + readStatus(); + if (!status.standstill || status.overTemperature) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + } + #endif + + return true; +} + +void StepDirTmc2130::modeMicrostepTracking() { + driver->microsteps(normalizedMicrosteps); +} + +int StepDirTmc2130::modeMicrostepSlewing() { + if (microstepRatio > 1) { + driver->microsteps(normalizedMicrostepsSlewing); + } + return microstepRatio; +} + +void StepDirTmc2130::modeDecayTracking() { + setDecayMode(decay.value); + current(iRun, iHoldRatio); +} + +void StepDirTmc2130::modeDecaySlewing() { + setDecayMode(decaySlewing.value); + current(iGoto, 1.0F); +} + +void StepDirTmc2130::readStatus() { + TMC2130_n::DRV_STATUS_t status_result; + status_result.sr = driver->DRV_STATUS(); + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = status_result.s2gb; + status.outputB.openLoad = status_result.olb; + status.overTemperatureWarning= status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +// secondary way to power down not using the enable pin +bool StepDirTmc2130::enable(bool state) { + if (state) { + modeDecayTracking(); + } else { + setDecayMode(STEALTHCHOP); + driver->ihold(0); + } + return true; +} + +// calibrate the motor driver if required +void StepDirTmc2130::calibrateDriver() { + if (decay.value == STEALTHCHOP || decaySlewing.value == STEALTHCHOP) { + VF("MSG:"); V(axisPrefix); VL("standstill automatic current calibration"); + + current(iRun, 1.0F); + driver->pwm_autoscale(true); + driver->en_pwm_mode(true); + delay(1000); + modeDecayTracking(); + } +} + +// set the decay mode STEALTHCHOP or SPREADCYCLE +void StepDirTmc2130::setDecayMode(int decayMode) { + driver->en_pwm_mode(decayMode != SPREADCYCLE); +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2130/Tmc2130.h b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2130/Tmc2130.h new file mode 100755 index 0000000..327da75 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2130/Tmc2130.h @@ -0,0 +1,69 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2130Stepper +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2130_PRESENT) + +#include // https://github.com/teemuatlut/TMCStepper + +#include "../../../../Drivers.h" +#include "../../TmcStepDirDriverSG.h" + +class StepDirTmc2130 : public TmcStepDirDriverSG { + public: + // constructor + StepDirTmc2130(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // read the 32bit stallguard register + uint32_t readSgRegister() override { return driver->DRV_STATUS(); } + + // SG only meaningful in spreadCycle (not stealthChop) + // and SG is only active while slewing so we assume this is representative of the state + bool stallGuardModeActive() const override { return decaySlewing.value == SPREADCYCLE; } + + // apply normalized sensitivity percent (0..100) to the concrete chip register + // (e.g., 2209: SGTHRS, 2130: SGT). Called only when % changes. + void applySgSensitivityPercent(uint8_t pct) override { + int sgt = 63 - (((int)pct * 127 + 50) / 100); // yields +63..-64 + driver->sgt((int8_t)sgt); + sgAppliedReg = (int16_t)sgt; + } + + // calibrate the motor driver if required + void calibrateDriver(); + + private: + // read status from driver + void readStatus(); + + // set the decay mode STEALTH_CHOP or SPREAD_CYCLE + void setDecayMode(int decayMode); + + // set peak current and hold current multiplier + inline void current(float mA, float mult) { driver->rms_current(mA*0.7071F, mult); } + + TMC2130Stepper *driver; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2160/Tmc2160.cpp b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2160/Tmc2160.cpp new file mode 100755 index 0000000..1bf178c --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2160/Tmc2160.cpp @@ -0,0 +1,133 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2160Stepper + +#include "Tmc2160.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2160_PRESENT) + +#include "../../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +// constructor +StepDirTmc2160:: +StepDirTmc2160(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriverSG(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc2160StepDir, "); + axisPrefix[5] = '0' + axisNumber; +} + +// setup driver +bool Tmc2160StepDirDriver::init() { + if (!TmcStepDirDriverSG::init()) return false; + + #ifdef TMC2160_RSENSE_KRAKEN + if (axisNumber <= 4) rSense = TMC2160_RSENSE_KRAKEN; + #endif + #ifdef DRIVER_TMC_STEPPER_HW_SPI + driver = new TMC2160Stepper(Pins->cs, rSense); + #else + driver = new TMC2160Stepper(Pins->cs, rSense, Pins->mosi, Pins->miso, Pins->sck); + #endif + driver->begin(); + driver->intpol(intpol.value == ON); + modeMicrostepTracking(); + driver->en_pwm_mode(false); + + current(iRun, iHoldRatio); + + // enable StallGuard / CoolStep speed threshold gating + // common "don't-care yet" value: always enable while moving + driver->TCOOLTHRS(0xFFFFF); // width depends on part; library handles masking + + // if you are NOT using CoolStep current scaling, keep it off + // disable CoolStep + driver->semin(0); + + // if we can, check to see if the driver is there + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + #ifndef DRIVER_TMC_STEPPER_HW_SPI + if (Pins->miso != OFF) + #endif + { + readStatus(); + if (!status.standstill || status.overTemperature) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + } + #endif + + return true; +} + +void Tmc2160StepDirDriver::modeMicrostepTracking() { + int16_t microsteps = 0; + driver->microsteps(normalizedMicrosteps); +} + +int Tmc2160StepDirDriver::modeMicrostepSlewing() { + if (microstepRatio > 1) { + driver->microsteps(normalizedMicrostepsSlewing); + } + return microstepRatio; +} + +void Tmc2160StepDirDriver::modeDecayTracking() { + setDecayMode(decay.value); + current(iRun, iHoldRatio); +} + +void Tmc2160StepDirDriver::modeDecaySlewing() { + setDecayMode(decaySlewing.value); + current(iGoto, 1.0F); +} + +void Tmc2160StepDirDriver::readStatus() { + TMC2130_n::DRV_STATUS_t status_result; + status_result.sr = driver->DRV_STATUS(); + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = status_result.s2gb; + status.outputB.openLoad = status_result.olb; + status.overTemperatureWarning= status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +// secondary way to power down not using the enable pin +bool Tmc2160StepDirDriver::enable(bool state) { + if (state) { + modeDecayTracking(); + } else { + setDecayMode(STEALTHCHOP); + driver->ihold(0); + } + return true; +} + +// calibrate the motor driver if required +void Tmc2160StepDirDriver::calibrateDriver() { + if (decay.value == STEALTHCHOP || decaySlewing.value == STEALTHCHOP) { + VF("MSG:"); V(axisPrefix); VL("standstill automatic current calibration"); + current(iRun, 1.0F); + driver->pwm_autoscale(true); + driver->en_pwm_mode(true); + delay(1000); + modeDecayTracking(); + } +} + +// set the decay mode STEALTHCHOP or SPREADCYCLE +void Tmc2160StepDirDriver::setDecayMode(int decayMode) { + driver->en_pwm_mode(decayMode != SPREADCYCLE); +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2160/Tmc2160.h b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2160/Tmc2160.h new file mode 100755 index 0000000..b24f960 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2160/Tmc2160.h @@ -0,0 +1,69 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2160Stepper +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2160_PRESENT) + +#include // https://github.com/teemuatlut/TMCStepper + +#include "../../../../Drivers.h" +#include "../../TmcStepDirDriverSG.h" + +class StepDirTmc2160 : public TmcStepDirDriverSG { + public: + // constructor + StepDirTmc2160(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // read the 32bit stallguard register + uint32_t readSgRegister() override { return driver->DRV_STATUS(); } + + // SG only meaningful in spreadCycle (not stealthChop) + // and SG is only active while slewing so we assume this is representative of the state + bool stallGuardModeActive() const override { return decaySlewing.value == SPREADCYCLE; } + + // apply normalized sensitivity percent (0..100) to the concrete chip register + // (e.g., 2209: SGTHRS, 2130: SGT). Called only when % changes. + void applySgSensitivityPercent(uint8_t pct) override { + int sgt = 63 - (((int)pct * 127 + 50) / 100); // yields +63..-64 + driver->sgt((int8_t)sgt); + sgAppliedReg = (int16_t)sgt; + } + + // calibrate the motor driver if required + void calibrateDriver(); + + private: + // read status from driver + void readStatus(); + + // set the decay mode STEALTH_CHOP or SPREAD_CYCLE + void setDecayMode(int decayMode); + + // set peak current and hold current multiplier + inline void current(float mA, float mult) { driver->rms_current(mA*0.7071F, mult); } + + TMC2160Stepper *driver; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2208/tmc2208.cpp b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2208/tmc2208.cpp new file mode 100755 index 0000000..15ac3db --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2208/tmc2208.cpp @@ -0,0 +1,152 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2208Stepper + +#include "tmc2208.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2208_PRESENT) + +#include "../../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define rx m3 +#define tx m2 + +// provide for using hardware serial +#if SERIAL_TMC == HardSerial + #include + #undef SERIAL_TMC + HardwareSerial HWSerialTMC(SERIAL_TMC_RX, SERIAL_TMC_TX); + #define SERIAL_TMC HWSerialTMC + #define SERIAL_TMC_RXTX_SET +#endif + +// constructor +StepDirTmc2208:: +StepDirTmc2208(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriver(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc2208StepDir, "); + axisPrefix[5] = '0' + axisNumber; +} + +// setup driver +bool StepDirTmc2208::init() { + if (!TmcStepDirDriver::init()) return false; + + // the MS1 and MS2 pins are unused + pinModeEx(Pins->m0, OUTPUT); + pinModeEx(Pins->m1, OUTPUT); + + // initialize the serial port + #if defined(SERIAL_TMC_HARDWARE_UART) + #define SerialTMC SERIAL_TMC + static bool initialized = false; + if (!initialized) { + VF("MSG:"); V(axisPrefix); + #if defined(SERIAL_TMC_RX) && defined(SERIAL_TMC_TX) && !defined(SERIAL_TMC_RXTX_SET) + VF("HW UART driver pins rx="); V(SERIAL_TMC_RX); VF(", tx="); V(SERIAL_TMC_TX); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + pinModeEx(SERIAL_TMC_RX, INPUT_PULLUP); + SerialTMC.begin(SERIAL_TMC_BAUD, SERIAL_8N1, SERIAL_TMC_RX, SERIAL_TMC_TX); + #else + VF("HW UART driver pins on port default"); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + SerialTMC.begin(SERIAL_TMC_BAUD); + #endif + initialized = true; + } + #else + VF("SW UART driver pins rx="); V(Pins->rx); VF(", tx="); V(Pins->tx); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + pinModeEx(Pins->rx, INPUT_PULLUP); + SerialTMC = new SoftwareSerial(Pins->rx, Pins->tx); + SerialTMC->begin(SERIAL_TMC_BAUD); + #endif + + // initialize the stepper driver + #if defined(SERIAL_TMC_HARDWARE_UART) + driver = new TMC2208Stepper(&SerialTMC, rSense); + #else + driver = new TMC2208Stepper(SerialTMC, rSense); + #endif + driver->begin(); + driver->intpol(intpol.value == ON); + modeMicrostepTracking(); + driver->rms_current(iRun, iHoldRatio); + driver->en_spreadCycle(true); + + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + readStatus(); + if (!status.standstill || status.overTemperature) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + #endif + + return true; +} + +void StepDirTmc2208::modeMicrostepTracking() { + if (normalizedMicrosteps == 1) driver->microsteps(0); else driver->microsteps(normalizedMicrosteps); +} + +int StepDirTmc2208::modeMicrostepSlewing() { + if (microstepRatio > 1) { + if (normalizedMicrostepsSlewing == 1) driver->microsteps(0); else driver->microsteps(normalizedMicrostepsSlewing); + } + return microstepRatio; +} + +void StepDirTmc2208::modeDecayTracking() { + setDecayMode(decay.value); + current(iRun, iHoldRatio); +} + +void StepDirTmc2208::modeDecaySlewing() { + setDecayMode(decaySlewing.value); + current(iGoto, 1.0F); +} + +// set the decay mode STEALTHCHOP or SPREADCYCLE +void StepDirTmc2208::setDecayMode(int decayMode) { + driver->en_spreadCycle(decayMode == SPREADCYCLE); +} + +void StepDirTmc2208::readStatus() { + TMC2208_n::DRV_STATUS_t status_result; + status_result.sr = driver->DRV_STATUS(); + if (driver->CRCerror) status_result.sr = 0xFFFFFFFF; + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = status_result.s2gb; + status.outputB.openLoad = status_result.olb; + status.overTemperatureWarning = status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +// secondary way to power down not using the enable pin +bool StepDirTmc2208::enable(bool state) { + if (state) { + modeDecayTracking(); + } else { + setDecayMode(STEALTHCHOP); + driver->ihold(0); + } + return true; +} + +// calibrate the motor driver if required +void StepDirTmc2208::calibrateDriver() { + if (decay.value == STEALTHCHOP || decaySlewing.value == STEALTHCHOP) { + VF("MSG:"); V(axisPrefix); VL("standstill automatic current calibration"); + + current(iRun, 1.0F); + driver->pwm_autograd(DRIVER_TMC_STEPPER_AUTOGRAD); + driver->pwm_autoscale(true); + driver->en_spreadCycle(false); + delay(1000); + modeDecayTracking(); + } +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2208/tmc2208.h b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2208/tmc2208.h new file mode 100755 index 0000000..80e1ec9 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2208/tmc2208.h @@ -0,0 +1,62 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2208Stepper +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2208_PRESENT) + +#include // https://github.com/teemuatlut/TMCStepper + +#include "../../../../Drivers.h" +#include "../../TmcStepDirDriverNSG.h" + +#if SERIAL_TMC == SoftSerial + #include // must be built into the board libraries +#endif + +class StepDirTmc2208 : public TmcStepDirDriverNSG { + public: + // constructor + StepDirTmc2208(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // set the decay mode STEALTH_CHOP or SPREAD_CYCLE + void setDecayMode(int decayMode); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // calibrate the motor driver if required + void calibrateDriver(); + + private: + // read status from driver + void readStatus(); + + // set peak current and hold current multiplier + inline void current(float mA, float mult) { driver->rms_current(round(mA*0.7071F), mult); } + + #if SERIAL_TMC == SoftSerial + SoftwareSerial *SerialTMC; + #endif + + TMC2208Stepper *driver; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2209/Tmc2209.cpp b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2209/Tmc2209.cpp new file mode 100755 index 0000000..1e6ed40 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2209/Tmc2209.cpp @@ -0,0 +1,180 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2209Stepper + +#include "Tmc2209.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2209_PRESENT) + +#include "../../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define rx m3 +#define tx m2 + +// provide for using hardware serial +#if SERIAL_TMC == HardSerial + #include + #undef SERIAL_TMC + HardwareSerial HWSerialTMC(SERIAL_TMC_RX, SERIAL_TMC_TX); + #define SERIAL_TMC HWSerialTMC + #define SERIAL_TMC_RXTX_SET +#endif + +// constructor +StepDirTmc2209:: +StepDirTmc2209(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriverSG(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc2209StepDir, "); + axisPrefix[5] = '0' + axisNumber; +} + +// setup driver +bool StepDirTmc2209::init() { + if (!TmcStepDirDriverSG::init()) return false; + + // get TMC UART driver address select pins ready + pinModeEx(Pins->m0, OUTPUT); + pinModeEx(Pins->m1, OUTPUT); + + // initialize the serial port + #if defined(SERIAL_TMC_HARDWARE_UART) + #if defined(DEDICATED_MODE_PINS) + // program the device address 0,1,2,3 since M0 and M1 are all unique + int deviceAddress = SERIAL_TMC_ADDRESS_MAP(axisNumber - 1); + digitalWriteEx(Pins->m0, bitRead(deviceAddress, 0)); + digitalWriteEx(Pins->m1, bitRead(deviceAddress, 1)); + #else + // pull MS1 and MS2 high for device address 3 + // the user can then hard code the device address 0,1,2,3 by cutting off pins as needed + digitalWriteEx(Pins->m0, HIGH); + digitalWriteEx(Pins->m1, HIGH); + #endif + + #define SerialTMC SERIAL_TMC + static bool initialized = false; + if (!initialized) { + VF("MSG:"); V(axisPrefix); + #if defined(SERIAL_TMC_RX) && defined(SERIAL_TMC_TX) && !defined(SERIAL_TMC_RXTX_SET) + VF("HW UART driver pins rx="); V(SERIAL_TMC_RX); VF(", tx="); V(SERIAL_TMC_TX); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + pinModeEx(SERIAL_TMC_RX, INPUT_PULLUP); + SerialTMC.begin(SERIAL_TMC_BAUD, SERIAL_8N1, SERIAL_TMC_RX, SERIAL_TMC_TX); + #else + VF("HW UART driver pins on port default"); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + SerialTMC.begin(SERIAL_TMC_BAUD); + #endif + initialized = true; + } + #else + // pull MS1 and MS2 low for device address 0 + digitalWriteEx(Pins->m0, LOW); + digitalWriteEx(Pins->m1, LOW); + VF("SW UART driver pins rx="); V(Pins->rx); VF(", tx="); V(Pins->tx); VF(", baud="); V(SERIAL_TMC_BAUD); VLF(" bps"); + SerialTMC = new SoftwareSerial(Pins->rx, Pins->tx); + SerialTMC->begin(SERIAL_TMC_BAUD); + #endif + + // initialize the stepper driver + #if defined(SERIAL_TMC_HARDWARE_UART) + driver = new TMC2209Stepper(&SerialTMC, rSense, SERIAL_TMC_ADDRESS_MAP(axisNumber - 1)); + #else + driver = new TMC2209Stepper(SerialTMC, rSense, SERIAL_TMC_ADDRESS_MAP(axisNumber - 1)); + #endif + driver->begin(); + + driver->pdn_disable(true); + driver->mstep_reg_select(true); + driver->toff(3); + driver->blank_time(24); + + driver->intpol(intpol.value == ON); + modeMicrostepTracking(); + current(iRun, iHoldRatio); + driver->en_spreadCycle(true); + + // enable StallGuard / CoolStep speed threshold gating + // common "don't-care yet" value: always enable while moving + driver->TCOOLTHRS(0xFFFFF); // width depends on part; library handles masking + + // if you are NOT using CoolStep current scaling, keep it off + // disable CoolStep + driver->semin(0); + + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + readStatus(); + if (!status.standstill || status.overTemperature) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + #endif + + return true; +} + +void StepDirTmc2209::modeMicrostepTracking() { + if (normalizedMicrosteps == 1) driver->microsteps(0); else driver->microsteps(normalizedMicrosteps); +} + +int StepDirTmc2209::modeMicrostepSlewing() { + if (microstepRatio > 1) { + if (normalizedMicrostepsSlewing == 1) driver->microsteps(0); else driver->microsteps(normalizedMicrostepsSlewing); + } + return microstepRatio; +} + +void StepDirTmc2209::modeDecayTracking() { + setDecayMode(decay.value); + current(iRun, iHoldRatio); +} + +void StepDirTmc2209::modeDecaySlewing() { + setDecayMode(decaySlewing.value); + current(iGoto, 1.0F); +} + +// set the decay mode STEALTHCHOP or SPREADCYCLE +void StepDirTmc2209::setDecayMode(int decayMode) { + driver->en_spreadCycle(decayMode == SPREADCYCLE); +} + +void StepDirTmc2209::readStatus() { + TMC2208_n::DRV_STATUS_t status_result; + status_result.sr = driver->DRV_STATUS(); + if (driver->CRCerror) { status_result.sr = 0xFFFFFFFF; } + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = status_result.s2gb; + status.outputB.openLoad = status_result.olb; + status.overTemperatureWarning = status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +// secondary way to power down not using the enable pin +bool StepDirTmc2209::enable(bool state) { + if (state) { + modeDecayTracking(); + } else { + setDecayMode(STEALTHCHOP); + driver->ihold(0); + } + return true; +} + +// calibrate the motor driver if required +void StepDirTmc2209::calibrateDriver() { + if (decay.value == STEALTHCHOP || decaySlewing.value == STEALTHCHOP) { + VF("MSG:"); V(axisPrefix); VL("standstill automatic current calibration"); + + current(iRun, 1.0F); + driver->pwm_autograd(DRIVER_TMC_STEPPER_AUTOGRAD); + driver->pwm_autoscale(true); + driver->en_spreadCycle(false); + delay(1000); + modeDecayTracking(); + } +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2209/Tmc2209.h b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2209/Tmc2209.h new file mode 100755 index 0000000..7b9cfc1 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2209/Tmc2209.h @@ -0,0 +1,73 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2209Stepper +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2209_PRESENT) + +#include // https://github.com/teemuatlut/TMCStepper + +#include "../../../../Drivers.h" +#include "../../TmcStepDirDriverSG.h" + +class StepDirTmc2209 : public TmcStepDirDriverSG { + public: + // constructor + StepDirTmc2209(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // set the decay mode STEALTH_CHOP or SPREAD_CYCLE + void setDecayMode(int decayMode); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // read the 32bit stallguard register + uint32_t readSgRegister() override { return (uint32_t)(driver->SG_RESULT() & 0x03FF); } + + // SG only meaningful in stealthChop (not spreadCycle) + // and SG is only active while slewing so we assume this is representative of the state + bool stallGuardModeActive() const override { return decaySlewing.value == STEALTHCHOP; } + + // apply normalized sensitivity percent (0..100) to the concrete chip register + // (e.g., 2209: SGTHRS, 2130: SGT). Called only when % changes. + void applySgSensitivityPercent(uint8_t pct) override { + uint8_t sgthrs = (uint8_t)(((int)pct * 255 + 50) / 100); + driver->SGTHRS(sgthrs); + sgAppliedReg = (int16_t)sgthrs; + } + + // calibrate the motor driver if required + void calibrateDriver(); + + private: + // read status from driver + void readStatus(); + + // set peak current and hold current multiplier + inline void current(float mA, float mult) { driver->rms_current(round(mA*0.7071F), mult); } + + #if SERIAL_TMC == SoftSerial + SoftwareSerial *SerialTMC; + #endif + + TMC2209Stepper *driver; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2660/Tmc2660.cpp b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2660/Tmc2660.cpp new file mode 100755 index 0000000..842e779 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2660/Tmc2660.cpp @@ -0,0 +1,101 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2660Stepper + +#include "Tmc2660.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2660_PRESENT) + +#include "../../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +// constructor +StepDirTmc2660:: +StepDirTmc2660(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriver(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc2660StepDir, "); + axisPrefix[5] = '0' + axisNumber; +} + +// setup driver +bool StepDirTmc2660::init() { + if (!TmcStepDirDriver::init()) return false; + + #ifdef DRIVER_TMC_STEPPER_HW_SPI + driver = new TMC2660Stepper(Pins->cs, rSense); + #else + driver = new TMC2660Stepper(Pins->cs, rSense, Pins->mosi, Pins->miso, Pins->sck); + #endif + driver->begin(); + driver->toff(5); + driver->intpol(intpol.value == ON); + modeMicrostepTracking(); + + current(iRun); + + // if we can, check to see if the driver is there + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + #ifndef DRIVER_TMC_STEPPER_HW_SPI + if (Pins->miso != OFF) + #endif + { + readStatus(); + if (!status.standstill || status.overTemperature) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + } + #endif + + return true; +} + +void StepDirTmc2660::modeMicrostepTracking() { + driver->microsteps(normalizedMicrosteps); +} + +int StepDirTmc2660::modeMicrostepSlewing() { + if (microstepRatio > 1) { + driver->microsteps(normalizedMicrostepsSlewing); + } + return microstepRatio; +} + +void StepDirTmc2660::modeDecayTracking() { + current(iRun); +} + +void StepDirTmc2660::modeDecaySlewing() { + current(iGoto); +} + +void StepDirTmc2660::readStatus() { + TMC2130_n::DRV_STATUS_t status_result; + status_result.sr = driver->DRV_STATUS(); + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = status_result.s2gb; + status.outputB.openLoad = status_result.olb; + status.overTemperatureWarning= status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +// secondary way to power down not using the enable pin +bool StepDirTmc2660::enable(bool state) { + if (state) { + modeDecayTracking(); + } else { + driver->rms_current(0); + } + return true; +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2660/Tmc2660.h b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2660/Tmc2660.h new file mode 100755 index 0000000..2cc57f4 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc2660/Tmc2660.h @@ -0,0 +1,51 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC2660Stepper +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC2660_PRESENT) + +#include // https://github.com/teemuatlut/TMCStepper + +#include "../../../../Drivers.h" +#include "../../TmcStepDirDriverNSG.h" + +class StepDirTmc2660 : public TmcStepDirDriver { + public: + // constructor + StepDirTmc2660(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // calibrate the motor driver if required + void calibrateDriver() {} + + private: + // read status from driver + void readStatus(); + + // set peak current current multiplier + inline void current(float mA) { driver->rms_current(mA*0.7071F); } + + TMC2660Stepper *driver; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5160/Tmc5160.cpp b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5160/Tmc5160.cpp new file mode 100755 index 0000000..c575592 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5160/Tmc5160.cpp @@ -0,0 +1,131 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC5160Stepper + +#include "Tmc5160.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC5160_PRESENT) + +#include "../../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +// constructor +StepDirTmc5160:: +StepDirTmc5160(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriverSG(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc5160StepDir, "); + axisPrefix[5] = '0' + axisNumber; +} + +// setup driver +bool StepDirTmc5160::init() { + if (!TmcStepDirDriverSG::init()) return false; + + #ifdef DRIVER_TMC_STEPPER_HW_SPI + driver = new TMC5160Stepper(Pins->cs, rSense); + #else + driver = new TMC5160Stepper(Pins->cs, rSense, Pins->mosi, Pins->miso, Pins->sck); + #endif + driver->begin(); + driver->intpol(intpol.value == ON); + modeMicrostepTracking(); + driver->en_pwm_mode(false); + + current(iRun, iHoldRatio); + + // enable StallGuard / CoolStep speed threshold gating + // common "don't-care yet" value: always enable while moving + driver->TCOOLTHRS(0xFFFFF); // width depends on part; library handles masking + + // if you are NOT using CoolStep current scaling, keep it off + // disable CoolStep + driver->semin(0); + + // if we can, check to see if the driver is there + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + #ifndef DRIVER_TMC_STEPPER_HW_SPI + if (Pins->miso != OFF) + #endif + { + readStatus(); + if (!status.standstill || status.overTemperature) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + } + #endif + + return true; +} + +void StepDirTmc5160::modeMicrostepTracking() { + driver->microsteps(normalizedMicrosteps); +} + +int StepDirTmc5160::modeMicrostepSlewing() { + if (microstepRatio > 1) { + driver->microsteps(normalizedMicrostepsSlewing); + } + return microstepRatio; +} + +void StepDirTmc5160::modeDecayTracking() { + setDecayMode(decay.value); + current(iRun, iHoldRatio); +} + +void StepDirTmc5160::modeDecaySlewing() { + setDecayMode(decaySlewing.value); + current(iGoto, 1.0F); +} + +void StepDirTmc5160::readStatus() { + TMC2130_n::DRV_STATUS_t status_result; + status_result.sr = driver->DRV_STATUS(); + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = status_result.s2gb; + status.outputB.openLoad = status_result.olb; + status.overTemperatureWarning= status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +// secondary way to power down not using the enable pin +bool StepDirTmc5160::enable(bool state) { + if (state) { + modeDecayTracking(); + } else { + setDecayMode(STEALTHCHOP); + driver->ihold(0); + } + return true; +} + +// calibrate the motor driver if required +void StepDirTmc5160::calibrateDriver() { + if (decay.value == STEALTHCHOP || decaySlewing.value == STEALTHCHOP) { + VF("MSG:"); V(axisPrefix); VL("standstill automatic current calibration"); + + current(iRun, 1.0F); + driver->pwm_autograd(DRIVER_TMC_STEPPER_AUTOGRAD); + driver->pwm_autoscale(true); + driver->en_pwm_mode(true); + delay(1000); + modeDecayTracking(); + } +} + +// set the decay mode STEALTHCHOP or SPREADCYCLE +void StepDirTmc5160::setDecayMode(int decayMode) { + driver->en_pwm_mode(decayMode != SPREADCYCLE); +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5160/Tmc5160.h b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5160/Tmc5160.h new file mode 100755 index 0000000..1d6ad21 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5160/Tmc5160.h @@ -0,0 +1,71 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC5160Stepper +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC5160_PRESENT) + +#include // https://github.com/teemuatlut/TMCStepper + +#include "../../../../Drivers.h" + +#include "../../TmcStepDirDriverSG.h" + +class StepDirTmc5160 : public TmcStepDirDriverSG { + + public: + // constructor + StepDirTmc5160(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // read the 32bit stallguard register + uint32_t readSgRegister() override { return driver->DRV_STATUS(); } + + // SG only meaningful in spreadCycle (not stealthChop) + // and SG is only active while slewing so we assume this is representative of the state + bool stallGuardModeActive() const override { return decaySlewing.value == SPREADCYCLE; } + + // apply normalized sensitivity percent (0..100) to the concrete chip register + // (e.g., 2209: SGTHRS, 2130: SGT). Called only when % changes. + void applySgSensitivityPercent(uint8_t pct) override { + int sgt = 63 - (((int)pct * 127 + 50) / 100); // yields +63..-64 + driver->sgt((int8_t)sgt); + sgAppliedReg = (int16_t)sgt; + } + + // calibrate the motor driver if required + void calibrateDriver(); + + private: + // read status from driver + void readStatus(); + + // set the decay mode STEALTH_CHOP or SPREAD_CYCLE + void setDecayMode(int decayMode); + + // set peak current and hold current multiplier + inline void current(float mA, float mult) { driver->rms_current(mA*0.7071F, mult); } + + TMC5160Stepper *driver; +}; + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5161/Tmc5161.cpp b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5161/Tmc5161.cpp new file mode 100755 index 0000000..604d8d8 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5161/Tmc5161.cpp @@ -0,0 +1,131 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC5161Stepper + +#include "Tmc5161.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC5161_PRESENT) + +#include "../../../../../gpioEx/GpioEx.h" + +// help with pin names +#define mosi m0 +#define sck m1 +#define cs m2 +#define miso m3 + +// constructor +StepDirTmc5161:: +StepDirTmc5161(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, + int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol) + :TmcStepDirDriverSG(axisNumber, Pins, Settings, currentHold, currentRun, currentSlewing, intpol) { + strcpy(axisPrefix, " Axis_Tmc5161StepDir, "); + axisPrefix[5] = '0' + axisNumber; +} + +// setup driver +bool StepDirTmc5161::init() { + if (!TmcStepDirDriverSG::init()) return false; + + #ifdef DRIVER_TMC_STEPPER_HW_SPI + driver = new TMC5161Stepper(Pins->cs, rSense); + #else + driver = new TMC5161Stepper(Pins->cs, rSense, Pins->mosi, Pins->miso, Pins->sck); + #endif + driver->begin(); + driver->intpol(intpol.value == ON); + modeMicrostepTracking(); + driver->en_pwm_mode(false); + + current(iRun, iHoldRatio); + + // enable StallGuard / CoolStep speed threshold gating + // common "don't-care yet" value: always enable while moving + driver->TCOOLTHRS(0xFFFFF); // width depends on part; library handles masking + + // if you are NOT using CoolStep current scaling, keep it off + // disable CoolStep + driver->semin(0); + + // if we can, check to see if the driver is there + // check to see if the driver is there and ok + #ifdef MOTOR_DRIVER_DETECT + #ifndef DRIVER_TMC_STEPPER_HW_SPI + if (Pins->miso != OFF) + #endif + { + readStatus(); + if (!status.standstill || status.overTemperature) { + DF("ERR:"); D(axisPrefix); DLF("no motor driver device detected!"); + return false; + } else { VF("MSG:"); V(axisPrefix); VLF("motor driver device detected"); } + } + #endif + + return true; +} + +void StepDirTmc5161::modeMicrostepTracking() { + driver->microsteps(normalizedMicrosteps); +} + +int StepDirTmc5161::modeMicrostepSlewing() { + if (microstepRatio > 1) { + driver->microsteps(normalizedMicrostepsSlewing); + } + return microstepRatio; +} + +void StepDirTmc5161::modeDecayTracking() { + setDecayMode(decay.value); + current(iRun, iHoldRatio); +} + +void StepDirTmc5161::modeDecaySlewing() { + setDecayMode(decaySlewing.value); + current(iGoto, 1.0F); +} + +void StepDirTmc5161::readStatus() { + TMC2130_n::DRV_STATUS_t status_result; + status_result.sr = driver->DRV_STATUS(); + + status.outputA.shortToGround = status_result.s2ga; + status.outputA.openLoad = status_result.ola; + status.outputB.shortToGround = status_result.s2gb; + status.outputB.openLoad = status_result.olb; + status.overTemperatureWarning= status_result.otpw; + status.overTemperature = status_result.ot; + status.standstill = status_result.stst; +} + +// secondary way to power down not using the enable pin +bool StepDirTmc5161::enable(bool state) { + if (state) { + modeDecayTracking(); + } else { + setDecayMode(STEALTHCHOP); + driver->ihold(0); + } + return true; +} + +// calibrate the motor driver if required +void StepDirTmc5161::calibrateDriver() { + if (decay.value == STEALTHCHOP || decaySlewing.value == STEALTHCHOP) { + VF("MSG:"); V(axisPrefix); VL("standstill automatic current calibration"); + + current(iRun, 1.0F); + driver->pwm_autograd(DRIVER_TMC_STEPPER_AUTOGRAD); + driver->pwm_autoscale(true); + driver->en_pwm_mode(true); + delay(1000); + modeDecayTracking(); + } +} + +// set the decay mode STEALTHCHOP or SPREADCYCLE +void StepDirTmc5161::setDecayMode(int decayMode) { + driver->en_pwm_mode(decayMode != SPREADCYCLE); +} + +#endif diff --git a/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5161/Tmc5161.h b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5161/Tmc5161.h new file mode 100755 index 0000000..615fac9 --- /dev/null +++ b/src/lib/axis/motor/stepDir/tmc/tmcStepper/tmc5161/Tmc5161.h @@ -0,0 +1,69 @@ +// ----------------------------------------------------------------------------------- +// axis step/dir motor driver, TMC5161Stepper +#pragma once + +#include +#include "../../../../../../../Common.h" + +#if defined(DRIVER_TMC_STEPPER) && defined(TMC5161_PRESENT) + +#include // https://github.com/teemuatlut/TMCStepper + +#include "../../../../Drivers.h" +#include "../../TmcStepDirDriverSG.h" + +class StepDirTmc5161 : public TmcStepDirDriverSG { + public: + // constructor + StepDirTmc5161(uint8_t axisNumber, const StepDirDriverPins *Pins, const StepDirDriverSettings *Settings, int16_t currentHold, int16_t currentRun, int16_t currentSlewing, int8_t intpol); + + // setup driver + bool init(); + + // set microstep mode for tracking + void modeMicrostepTracking(); + + // set microstep mode for slewing + int modeMicrostepSlewing(); + + // set decay mode for tracking + void modeDecayTracking(); + + // set decay mode for slewing + void modeDecaySlewing(); + + // secondary way to power down not using the enable pin + bool enable(bool state); + + // read the 32bit stallguard register + uint32_t readSgRegister() override { return driver->DRV_STATUS(); } + + // SG only meaningful in spreadCycle (not stealthChop) + // and SG is only active while slewing so we assume this is representative of the state + bool stallGuardModeActive() const override { return decaySlewing.value == SPREADCYCLE; } + + // apply normalized sensitivity percent (0..100) to the concrete chip register + // (e.g., 2209: SGTHRS, 2130: SGT). Called only when % changes. + void applySgSensitivityPercent(uint8_t pct) override { + int sgt = 63 - (((int)pct * 127 + 50) / 100); // yields +63..-64 + driver->sgt((int8_t)sgt); + sgAppliedReg = (int16_t)sgt; + } + + // calibrate the motor driver if required + void calibrateDriver(); + + private: + // read status from driver + void readStatus(); + + // set the decay mode STEALTH_CHOP or SPREAD_CYCLE + void setDecayMode(int decayMode); + + // set peak current and hold current multiplier + inline void current(float mA, float mult) { driver->rms_current(mA*0.7071F, mult); } + + TMC5161Stepper *driver; +}; + +#endif diff --git a/src/lib/bluetooth/Bluetooth.defaults.h b/src/lib/bluetooth/Bluetooth.defaults.h new file mode 100755 index 0000000..acb3c34 --- /dev/null +++ b/src/lib/bluetooth/Bluetooth.defaults.h @@ -0,0 +1,91 @@ +#pragma once + +// ------------------------------------------------------------------------------------------------- +// general bt settings + +#ifndef HOST_NAME +#define HOST_NAME "Unknown" +#endif + +#ifndef SERIAL_BT_NAME +#define SERIAL_BT_NAME HOST_NAME +#endif + +// ------------------------------------------------------------------------------------------------- +// bluetooth manager settings + +#ifndef PASSWORD_DEFAULT +#define PASSWORD_DEFAULT "password" // default pwd for wifi settings +#endif + +// station 1 + +#ifndef STA1_BT_NAME +#define STA1_BT_NAME "OnStep" // the bluetooth server name this station is connecting to +#endif +#ifndef STA1_BT_ADDR +#define STA1_BT_ADDR "" // bluetooth MAC address to connect to +#endif +#ifndef STA1_BT_PASSKEY +#define STA1_BT_PASSKEY "" // bluetooth four digit passkey, leave blank to disable security +#endif + +// station 2 + +#ifndef STA2_BT_NAME +#define STA2_BT_NAME "" +#endif +#ifndef STA2_BT_ADDR +#define STA2_BT_ADDR "" +#endif +#ifndef STA2_BT_PASSKEY +#define STA2_BT_PASSKEY "" +#endif + +// station 3 + +#ifndef STA3_BT_NAME +#define STA3_BT_NAME "" +#endif +#ifndef STA3_BT_ADDR +#define STA3_BT_ADDR "" +#endif +#ifndef STA3_BT_PASSKEY +#define STA3_BT_PASSKEY "" +#endif + +// station 4 + +#ifndef STA4_BT_NAME +#define STA4_BT_NAME "" +#endif +#ifndef STA4_BT_ADDR +#define STA4_BT_ADDR "" +#endif +#ifndef STA4_BT_PASSKEY +#define STA4_BT_PASSKEY "" +#endif + +// station 5 + +#ifndef STA5_BT_NAME +#define STA5_BT_NAME "" +#endif +#ifndef STA5_BT_ADDR +#define STA5_BT_ADDR "" +#endif +#ifndef STA5_BT_PASSKEY +#define STA5_BT_PASSKEY "" +#endif + +// station 6 + +#ifndef STA6_BT_NAME +#define STA6_BT_NAME "" +#endif +#ifndef STA6_BT_ADDR +#define STA6_BT_ADDR "" +#endif +#ifndef STA6_BT_PASSKEY +#define STA6_BT_PASSKEY "" +#endif diff --git a/src/lib/bluetooth/BluetoothManager.cpp b/src/lib/bluetooth/BluetoothManager.cpp new file mode 100755 index 0000000..8d6a593 --- /dev/null +++ b/src/lib/bluetooth/BluetoothManager.cpp @@ -0,0 +1,86 @@ +// bluetooth manager +#include "BluetoothManager.h" + +#if SERIAL_BT_MODE == MASTER + +#include "../nv/Nv.h" + +bool BluetoothManager::init() { + if (!active) { + readSettings(); + + setStation(stationNumber); + + VF("MSG: Bluetooth, init device "); + VF(sta->address); DF(" "); VF(sta->host); + + int channel = 0; + BTAddress address = BTAddress(sta->address); + std::map channels = SERIAL_BT.getChannels(address); + if (channels.size() > 0) { channel = channels.begin()->first; } + VF(" on ch "); V(channel); + + if (strlen(sta->passkey) > 0) { + VF(" w/passkey "); V(bluetoothManager.sta->passkey); + SERIAL_BT.setPin(bluetoothManager.sta->passkey); + } + + VF("..."); + if (channel != 0 && SERIAL_BT.connect(address, channel, ESP_SPP_SEC_NONE, ESP_SPP_ROLE_SLAVE)) { + VLF(" success"); + active = true; + } else { + VLF(" failed"); + } + } + + return active; +} + +void BluetoothManager::setStation(int number) { + if (number >= 1 && number <= BluetoothStationCount) stationNumber = number; + sta = &settings.station[stationNumber - 1]; +} + +void BluetoothManager::disconnect() { + active = false; + VLF("MSG: Bluetooth, disconnected"); +} + +void BluetoothManager::readSettings() { + if (settingsReady) return; + + #ifdef NV_BT_SETTINGS + if (!nv().kv().getOrInit("BT_SETTINGS", settings)) { DLF("WRN: Nv, init failed for BT_SETTINGS"); } + #endif + + VF("MSG: Bluetooth, Master Pwd = "); VL(settings.masterPassword); + + VF("MSG: Bluetooth, Sta Select = "); VL(stationNumber); + + int currentStationNumber = stationNumber; + + for (int station = 1; station <= BluetoothStationCount; station++) { + setStation(station); + VF("MSG: Bluetooth, Sta"); V(station); VF(" NAME = "); VL(sta->host); + VF("MSG: Bluetooth, Sta"); V(station); VF(" MAC = "); VL(sta->address); + VF("MSG: Bluetooth, Sta"); V(station); VF(" KEY = "); VL(sta->passkey); + } + + stationNumber = currentStationNumber; + + settingsReady = true; +} + +void BluetoothManager::writeSettings() { + if (!settingsReady) return; + + #ifdef NV_BT_SETTINGS + VLF("MSG: BluetoothManager, writing settings to NV"); + nv().kv().put("BT_SETTINGS", settings); + #endif +} + +BluetoothManager bluetoothManager; + +#endif diff --git a/src/lib/bluetooth/BluetoothManager.h b/src/lib/bluetooth/BluetoothManager.h new file mode 100755 index 0000000..c82e7fa --- /dev/null +++ b/src/lib/bluetooth/BluetoothManager.h @@ -0,0 +1,75 @@ +// bluetooth manager +#pragma once + +#include "../../Common.h" + +#if SERIAL_BT_MODE == MASTER + +#include "Bluetooth.defaults.h" + +#ifndef ESP32 + #error "Configuration (Config.h): No Bluetooth support is present for this device" +#endif + +typedef struct BluetoothStationSettings { + char host[16]; + char address[18]; + char passkey[5]; +} BluetoothStationSettings; + +#ifndef BluetoothStationCount + // number of bluetooth stations supported, between 1 and 6 + #define BluetoothStationCount 3 +#endif +#define BluetoothSettingsSize (32 + BluetoothStationCount*39) +typedef struct BluetoothSettings { + char masterPassword[32]; + BluetoothStationSettings station[BluetoothStationCount]; +} BluetoothSettings; + +class BluetoothManager { + public: + bool init(); + void disconnect(); + void setStation(int number); + void readSettings(); + void writeSettings(); + + BluetoothStationSettings *sta; + + BluetoothSettings settings = { + PASSWORD_DEFAULT, + + { + #if BluetoothStationCount > 0 + {STA1_BT_NAME, STA1_BT_ADDR, STA1_BT_PASSKEY}, + #endif + #if BluetoothStationCount > 1 + {STA2_BT_NAME, STA2_BT_ADDR, STA2_BT_PASSKEY}, + #endif + #if BluetoothStationCount > 2 + {STA3_BT_NAME, STA3_BT_ADDR, STA3_BT_PASSKEY}, + #endif + #if BluetoothStationCount > 3 + {STA4_BT_NAME, STA4_BT_ADDR, STA4_BT_PASSKEY}, + #endif + #if BluetoothStationCount > 4 + {STA5_BT_NAME, STA5_BT_ADDR, STA5_BT_PASSKEY}, + #endif + #if BluetoothStationCount > 5 + {STA6_BT_NAME, STA6_BT_ADDR, STA6_BT_PASSKEY}, + #endif + } + }; + + bool active = false; + bool settingsReady = false; + int stationNumber = 1; + + private: + +}; + +extern BluetoothManager bluetoothManager; + +#endif diff --git a/src/lib/calendars/Calendars.cpp b/src/lib/calendars/Calendars.cpp new file mode 100755 index 0000000..c2ae85f --- /dev/null +++ b/src/lib/calendars/Calendars.cpp @@ -0,0 +1,73 @@ +// ----------------------------------------------------------------------------------- +// Gregorian and Julian calendars + +#include "Calendars.h" + +#ifdef CALENDARS_PRESENT + +// convert from Gregorian to Julian date/time +JulianDate Calendars::gregorianToJulian(GregorianDate date) { + JulianDate jd = gregorianToJulianDay(date); + jd.hour = date.hour; + + while (jd.hour >= 24.0) { jd.hour -= 24.0; jd.day += 1.0; } + while (jd.hour < 0.0) { jd.hour += 24.0; jd.day -= 1.0; } + + return jd; +} + +// convert from Julian to Gregorian date/time +GregorianDate Calendars::julianToGregorian(JulianDate julianDate) { + while (julianDate.hour >= 24.0) { julianDate.hour -= 24.0; julianDate.day += 1.0; } + while (julianDate.hour < 0.0) { julianDate.hour += 24.0; julianDate.day -= 1.0; } + + GregorianDate date = julianDayToGregorian(julianDate); + date.hour = julianDate.hour; + + return date; +} + +// convert from Gregorian to Julian date (does not handle hours) +JulianDate Calendars::gregorianToJulianDay(GregorianDate date) { + JulianDate julianDay; + + int y = date.year; + int m = date.month; + if (m == 1 || m == 2) { y--; m += 12; } + double B = 2.0 - floor(y/100.0) + floor(y/400.0); + julianDay.day = B + floor(365.25*y) + floor(30.6001*(m + 1.0)) + date.day + 1720994.5; + julianDay.hour = 0; + + return julianDay; +} + +// convert from Julian to Gregorian date (does not handle hours) +GregorianDate Calendars::julianDayToGregorian(JulianDate julianDate) { + double A, B, C, D, D1, E, F, G, I; + GregorianDate date; + + I = floor(julianDate.day + 0.5); + + F = 0.0; + if (I > 2299160.0) { + A = int((I - 1867216.25)/36524.25); + B = I + 1.0 + A - floor(A/4.0); + } else B = I; + + C = B + 1524.0; + D = floor((C - 122.1)/365.25); + E = floor(365.25*D); + G = floor((C - E)/30.6001); + + D1 = C - E + F - floor(30.6001*G); + date.day = floor(D1); + if (G < 13.5) date.month = floor(G - 1.0); else date.month = floor(G - 13.0); + if (date.month > 2.5) date.year = floor(D - 4716.0); else date.year = floor(D - 4715.0); + date.hour = 0.0; + + return date; +} + +Calendars calendars; + +#endif diff --git a/src/lib/calendars/Calendars.h b/src/lib/calendars/Calendars.h new file mode 100755 index 0000000..454855f --- /dev/null +++ b/src/lib/calendars/Calendars.h @@ -0,0 +1,43 @@ +// ----------------------------------------------------------------------------------- +// Gregorian and Julian calendars +#pragma once + +#include + +#define CALENDARS_PRESENT + +#ifdef CALENDARS_PRESENT + +typedef struct GregorianDate { + int16_t year; + uint8_t month; + uint8_t day; + double hour; +} GregorianDate; + +#define JulianDateSize 16 +typedef struct JulianDate { + double day; + double hour; +} JulianDate; + +class Calendars { + public: + // convert from Gregorian to Julian date/time + JulianDate gregorianToJulian(GregorianDate date); + + // convert from Julian to Gregorian date/time + GregorianDate julianToGregorian(JulianDate julianDate); + + // convert from Gregorian to Julian date (does not handle hours) + JulianDate gregorianToJulianDay(GregorianDate date); + + // convert from Julian to Gregorian date (does not handle hours) + GregorianDate julianDayToGregorian(JulianDate julianDate); + + private: +}; + +extern Calendars calendars; + +#endif diff --git a/src/lib/canPlus/CanPlus.h b/src/lib/canPlus/CanPlus.h new file mode 100755 index 0000000..d7e201f --- /dev/null +++ b/src/lib/canPlus/CanPlus.h @@ -0,0 +1,15 @@ +// ----------------------------------------------------------------------------------- +// CAN library +#pragma once + +#include "../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS != OFF + #include "san/San.h" + #include "esp32/Esp32.h" + #include "mcp2515/Mcp2515.h" + #include "teensy4/Can0.h" + #include "teensy4/Can1.h" + #include "teensy4/Can2.h" + #include "teensy4/Can3.h" +#endif diff --git a/src/lib/canPlus/CanPlusBase.cpp b/src/lib/canPlus/CanPlusBase.cpp new file mode 100755 index 0000000..354479d --- /dev/null +++ b/src/lib/canPlus/CanPlusBase.cpp @@ -0,0 +1,131 @@ +// ----------------------------------------------------------------------------------- +// CAN library + +#include "CanPlusBase.h" + +#if defined(CAN_PLUS) && CAN_PLUS != OFF + +#include "../tasks/OnTask.h" + +int CanPlus::beginPacket(int id) { + if (!ready) return 0; + sendId = id; + sendCount = 0; + return 1; +} + +int CanPlus::endPacket() { + if (!ready) return 0; + if (sendCount < 1) return 0; + if (writePacket(sendId, sendData, sendCount)) return 1; else return 0; +} + +int CanPlus::write(uint8_t byte) { + if (!ready) return 0; + if (sendCount < 0 || sendCount > 7) return 0; + sendData[sendCount++] = byte; + return 1; +} + +int CanPlus::write(const uint8_t *buffer, size_t size) { + if (!ready) return 0; + if (sendCount < 0 || size < 1 || sendCount + size > 8) return 0; + + for (unsigned int i = 0; i < size; i++) { if (!write(buffer[i])) return 0; } + return size; +} + +// add an id only callback +int CanPlus::callbackRegisterId(int id, void (*callback)(uint8_t data[8])) { + if (!ready) return 0; + if (id < 0 || id > 0x7FF || idCallbackCount >= CAN_MAX_CALLBACKS) return 0; + idCallback[idCallbackCount] = callback; + idCallBackId[idCallbackCount] = id; + idCallbackEx[idCallbackCount] = nullptr; + idCallbackCount++; + return 1; +} + +// add an id only callback (len-aware) +int CanPlus::callbackRegisterId(int id, void (*callback)(uint8_t data[8], uint8_t len)) { + if (!ready) return 0; + if (id < 0 || id > 0x7FF || idCallbackCount >= CAN_MAX_CALLBACKS) return 0; + idCallBackId[idCallbackCount] = id; + idCallback[idCallbackCount] = nullptr; // old slot unused + idCallbackEx[idCallbackCount] = callback; // new slot used + idCallbackCount++; + return 1; +} + +// add an id + message callback +int CanPlus::callbackRegisterMessage(int id, uint8_t msg, void (*callback)(uint8_t data[8])) { + if (!ready) return 0; + if (id < 0 || id > 0x7FF || msgCallbackCount >= CAN_MAX_CALLBACKS) return 0; + msgCallback[msgCallbackCount] = callback; + msgCallBackId[msgCallbackCount] = id; + msgCallBackMsg[msgCallbackCount] = msg; + msgCallbackEx[msgCallbackCount] = nullptr; + msgCallbackCount++; + return 1; +} + +// add an id + message callback (len-aware) +int CanPlus::callbackRegisterMessage(int id, uint8_t msg, void (*callback)(uint8_t data[8], uint8_t len)) { + if (!ready) return 0; + if (id < 0 || id > 0x7FF || msgCallbackCount >= CAN_MAX_CALLBACKS) return 0; + msgCallBackId[msgCallbackCount] = id; + msgCallBackMsg[msgCallbackCount] = msg; + msgCallback[msgCallbackCount] = nullptr; // old slot unused + msgCallbackEx[msgCallbackCount] = callback; // new slot used + msgCallbackCount++; + return 1; +} + +// run id/msg based callbacks +int CanPlus::callbackProcess(int id, uint8_t *buffer, size_t size) { + uint8_t paddedBuffer[8] = {0}; + + uint8_t len = 0; + if (buffer && size) { + if (size > 8) size = 8; + len = (uint8_t)size; + memcpy(paddedBuffer, buffer, size); + } else { + len = 0; + } + + int called = 0; + + for (int i = 0; i < idCallbackCount; i++) { + if (id == idCallBackId[i]) { + if (idCallbackEx[i]) idCallbackEx[i](paddedBuffer, len); + else if (idCallback[i]) idCallback[i](paddedBuffer); + called++; + } + } + + for (int i = 0; i < msgCallbackCount; i++) { + if (len >= 1 && id == msgCallBackId[i] && paddedBuffer[0] == msgCallBackMsg[i]) { + if (msgCallbackEx[i]) msgCallbackEx[i](paddedBuffer, len); + else if (msgCallback[i]) msgCallback[i](paddedBuffer); + called++; + } + } + + return called ? 1 : 0; +} + +bool CanPlus::txTryLock(uint32_t minGapUs) { + uint32_t now = micros(); + if ((uint32_t)(now - lastTxUs) < minGapUs) return false; + lastTxUs = now; + return true; +} + +void CanPlus::txWait(uint32_t minGapUs) { + while (!txTryLock(minGapUs)) { + tasks.yield(minGapUs/1000UL); + } +} + +#endif diff --git a/src/lib/canPlus/CanPlusBase.h b/src/lib/canPlus/CanPlusBase.h new file mode 100755 index 0000000..c23eaf4 --- /dev/null +++ b/src/lib/canPlus/CanPlusBase.h @@ -0,0 +1,117 @@ +// ----------------------------------------------------------------------------------- +// CAN library +#pragma once + +#include "../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS != OFF + +#ifndef DEBUG_CAN +#define DEBUG_CAN OFF +#endif + +#ifndef CAN_BAUD +#define CAN_BAUD 1000000 // 1000000 baud default +#endif +#ifndef CAN_SEND_RATE_MS +#define CAN_SEND_RATE_MS 10 // 100 Hz CAN controller send message processing rate +#endif +#ifndef CAN_RECV_RATE_MS +#define CAN_RECV_RATE_MS 2 // 500 Hz CAN controller recv. message processing rate +#endif +#ifndef CAN_RX_PIN +#define CAN_RX_PIN OFF // for ESP32 CAN interface +#endif +#ifndef CAN_TX_PIN +#define CAN_TX_PIN OFF // for ESP32 CAN interface +#endif +#ifndef CAN_CS_PIN +#define CAN_CS_PIN OFF // for MCP2515 SPI CAN controller +#endif +#ifndef CAN_INT_PIN +#define CAN_INT_PIN OFF // for MCP2515 SPI CAN controller +#endif + +#ifndef CAN_BURST_WINDOW_US +#define CAN_BURST_WINDOW_US 1000 // for polling recv. how long to wait during a burst +#endif + +#ifndef CAN_MAX_CALLBACKS + #define CAN_MAX_CALLBACKS 16 +#endif + +class CanPlus { + public: + virtual ~CanPlus() = default; + virtual int beginPacket(int id); + virtual int endPacket(); + virtual int write(uint8_t byte); + virtual int write(const uint8_t *buffer, size_t size); + virtual int writePacket(int id, const uint8_t *buffer, size_t size); + // RTR policy: supports sending RTR, but drops on receive + virtual int writePacketRtr(int id, size_t dlc) { UNUSED(id); UNUSED(dlc); return 0; } + + virtual int callbackRegisterId(int id, void (*callback)(uint8_t data[8])); + virtual int callbackRegisterMessage(int id, uint8_t msg, void (*callback)(uint8_t data[8])); + + virtual int callbackRegisterId(int id, void (*callback)(uint8_t data[8], uint8_t len)); + virtual int callbackRegisterMessage(int id, uint8_t msg, void (*callback)(uint8_t data[8], uint8_t len)); + + virtual int callbackProcess(int id, uint8_t *buffer, size_t size); + + // send pacing, non-blocking + bool txTryLock(uint32_t minGapUs = defaultPacingUs()); + + // send pacing, blocking + void txWait(uint32_t minGapUs = defaultPacingUs()); + + // allow any polling recv that may be present to happen quickly for a short period of time + // this increases the polling rate to 1ms for the specified period in microseconds + virtual void rxBurst(uint32_t periodUs = 2000) { UNUSED(periodUs); } + + static inline uint32_t defaultPacingUs() { return (uint32_t)CAN_SEND_RATE_MS*1000UL; } + + bool ready = false; + + inline void resetStats() { + noInterrupts(); + tx_ok = 0; + tx_fail = 0; + rx_ok = 0; + rx_drop_ext = 0; + rx_drop_rtr = 0; + rx_drop_len = 0; + interrupts(); + } + + volatile uint32_t rx_ok = 0; + volatile uint32_t rx_drop_ext = 0; + volatile uint32_t rx_drop_rtr = 0; + volatile uint32_t rx_drop_len = 0; + volatile uint32_t tx_ok = 0; + volatile uint32_t tx_fail = 0; + + protected: + int sendId = 0; + int sendCount = -1; + uint8_t sendData[8] = {0}; + + int idCallbackCount = 0; + int idCallBackId[CAN_MAX_CALLBACKS] = {0}; + void (*idCallback[CAN_MAX_CALLBACKS])(uint8_t data[8]) = {nullptr}; + void (*idCallbackEx[CAN_MAX_CALLBACKS])(uint8_t data[8], uint8_t len) = {nullptr}; + + int msgCallbackCount = 0; + int msgCallBackId[CAN_MAX_CALLBACKS] = {0}; + int msgCallBackMsg[CAN_MAX_CALLBACKS] = {0}; + void (*msgCallback[CAN_MAX_CALLBACKS])(uint8_t data[8]) = {nullptr}; + void (*msgCallbackEx[CAN_MAX_CALLBACKS])(uint8_t data[8], uint8_t len) = {nullptr}; + + uint32_t lastTxUs = 0; + + // for recv. path loops if present + const uint32_t budgetUs = 200; // tune ~ 100–300us + const int maxFrames = 8; // cap frames that are processed per CAN_RECV_RATE_MS, must be >= 2 +}; + +#endif \ No newline at end of file diff --git a/src/lib/canPlus/esp32/Esp32.cpp b/src/lib/canPlus/esp32/Esp32.cpp new file mode 100755 index 0000000..58cc8f5 --- /dev/null +++ b/src/lib/canPlus/esp32/Esp32.cpp @@ -0,0 +1,194 @@ +// ----------------------------------------------------------------------------------- +// CAN library (ESP32 TWAI backend) + +#include "Esp32.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN_ESP32 + +#include "../../tasks/OnTask.h" + +#include "driver/twai.h" // ESP-IDF TWAI (CAN) driver +#include "esp_err.h" + +void canEsp32Monitor() { canPlus.poll(); } + +static bool twaiReady = false; + +CanPlusESP32::CanPlusESP32() {} + +static twai_timing_config_t timingFromBaud() { + #if CAN_BAUD == 125000 + return TWAI_TIMING_CONFIG_125KBITS(); + #elif CAN_BAUD == 250000 + return TWAI_TIMING_CONFIG_250KBITS(); + #elif CAN_BAUD == 500000 + return TWAI_TIMING_CONFIG_500KBITS(); + #elif CAN_BAUD == 1000000 + return TWAI_TIMING_CONFIG_1MBITS(); + #else + return TWAI_TIMING_CONFIG_500KBITS(); + #endif +} + +void CanPlusESP32::init() { + VF("MSG: CanPlus, CAN_ESP32 (TWAI) Start... "); + + // General config: NORMAL mode means we transmit and ACK others. + twai_general_config_t g_config = TWAI_GENERAL_CONFIG_DEFAULT( + (gpio_num_t)CAN_TX_PIN, + (gpio_num_t)CAN_RX_PIN, + TWAI_MODE_NORMAL + ); + + // You can tune these if you want more buffering: + g_config.tx_queue_len = 32; + g_config.rx_queue_len = 128; + + // Optional: reduce ISR workload by not receiving every single frame if you use acceptance filters. + // Here we accept everything (no filtering at hardware level). + twai_filter_config_t f_config = TWAI_FILTER_CONFIG_ACCEPT_ALL(); + + twai_timing_config_t t_config = timingFromBaud(); + + esp_err_t err = twai_driver_install(&g_config, &t_config, &f_config); + if (err != ESP_OK) { + V("FAILED! twai_driver_install err="); VL((int)err); + ready = false; + return; + } + + err = twai_start(); + if (err != ESP_OK) { + V("FAILED! twai_start err="); VL((int)err); + twai_driver_uninstall(); + ready = false; + return; + } + + twaiReady = true; + ready = true; + + VLF("success"); + + VF("MSG: CanPlus, start callback monitor task (rate "); V(CAN_RECV_RATE_MS); + VF("ms priority 3)... "); + if (tasks.add(CAN_RECV_RATE_MS, 0, true, 3, canEsp32Monitor, "CanESP")) { + VLF("success"); + + // setup the burst task disabled (period 0) and so it only runs once + burst = tasks.add(0, 0, true, 3, canEsp32Monitor, "CanBrst"); + + } else { + VLF("FAILED!"); + } +} + +int CanPlusESP32::writePacket(int id, const uint8_t *buffer, size_t size) { + if (!ready || !twaiReady) return 0; + if (size > 8) return 0; + if (size > 0 && buffer == nullptr) return 0; + + twai_message_t msg = {}; + msg.identifier = (uint32_t)(id & 0x7FF); + msg.extd = 0; // standard 11-bit + msg.rtr = 0; + msg.data_length_code = (uint8_t)size; + if (size) memcpy(msg.data, buffer, size); + + // Zero timeout: do not block the caller; return failure if TX queue is full or bus is off. + esp_err_t err = twai_transmit(&msg, 0); + + if (err == ESP_OK) { + tx_ok++; + return 1; + } else { + tx_fail++; + // Optional 1 Hz debug: + // DL1("TWAI tx fail err="); DL1((int)err); + return 0; + } +} + +int CanPlusESP32::writePacketRtr(int id, size_t dlc) { + if (!ready || !twaiReady) return 0; + if (dlc > 8) return 0; + + twai_message_t msg = {}; + msg.identifier = (uint32_t)(id & 0x7FF); + msg.extd = 0; + msg.rtr = 1; + msg.data_length_code = (uint8_t)dlc; + + esp_err_t err = twai_transmit(&msg, 0); + + if (err == ESP_OK) { tx_ok++; return 1; } + tx_fail++; + return 0; +} + +void CanPlusESP32::rxBurst(uint32_t periodUs) { + const uint32_t now = micros(); + const uint32_t until = now + periodUs; + + if (!burstEnabled) { + burstEnabled = true; + burstUntilUs = until; + tasks.setPeriod(burst, 1); + } else { + if ((int32_t)(until - burstUntilUs) > 0) burstUntilUs = until; + } +} + +void CanPlusESP32::poll() { + if (!ready || !twaiReady) return; + + if (burstEnabled && (int32_t)(micros() - burstUntilUs) >= 0) { + tasks.setPeriod(burst, 0); + burstEnabled = false; + } + + const uint32_t start = micros(); + + // shorten workload during busts + const int frames = burstEnabled ? (maxFrames >> 1) : maxFrames; + + // drain up to N frames per poll so we don't monopolize the CPU + for (int n = 0; n < frames; n++) { + twai_message_t msg; + esp_err_t err = twai_receive(&msg, 0); // non-blocking + if (err != ESP_OK) break; + + // drop extended IDs (unless you want to support them) + if (msg.extd) { rx_drop_ext++; continue; } + // drop RTR frames (unless you want them) + if (msg.rtr) { rx_drop_rtr++; continue; } + // DLC sanity + if (msg.data_length_code < 1 || msg.data_length_code > 8) { rx_drop_len++; continue; } + + rx_ok++; + + callbackProcess((int)(msg.identifier & 0x7FF), (uint8_t*)msg.data, msg.data_length_code); + + debugStatus(); + + if ((uint32_t)(micros() - start) > budgetUs) break; + } +} + +void CanPlusESP32::debugStatus() { + #if DEBUG != OFF && DEBUG_CAN != OFF + if (!ready || !twaiReady) return; + twai_status_info_t s; + if (twai_get_status_info(&s) != ESP_OK) return; + + // 1 Hz debug suggested: + D1("MSG: TWAI, state="); D1((int)s.state); + D1(" tx_err="); D1((int)s.tx_error_counter); + D1(" rx_err="); D1((int)s.rx_error_counter); + D1(" bus_err="); DL1((int)s.bus_error_count); + #endif +} + +CanPlusESP32 canPlus; + +#endif diff --git a/src/lib/canPlus/esp32/Esp32.h b/src/lib/canPlus/esp32/Esp32.h new file mode 100755 index 0000000..3d617f0 --- /dev/null +++ b/src/lib/canPlus/esp32/Esp32.h @@ -0,0 +1,40 @@ +// ----------------------------------------------------------------------------------- +// CAN library +#pragma once + +#include "../../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN_ESP32 + +#include "../CanPlusBase.h" + +#ifndef ESP32 + #error "Configuration (Config.h): Setting CAN_PLUS CAN_ESP32 requires an ESP32 microcontroller." +#endif + +#if CAN_RX_PIN == OFF || CAN_TX_PIN == OFF + #error "CAN_ESP32 requires CAN_RX_PIN and CAN_TX_PIN to be defined." +#endif + +class CanPlusESP32 : public CanPlus { + public: + CanPlusESP32(); + void init(); + int writePacket(int id, const uint8_t *buffer, size_t size); + int writePacketRtr(int id, size_t dlc); + + void rxBurst(uint32_t periodUs = 2000); + + void debugStatus(); + + void poll(); + + private: + uint8_t burst = 0; + uint32_t burstUntilUs = 0; + bool burstEnabled = false; +}; + +extern CanPlusESP32 canPlus; + +#endif diff --git a/src/lib/canPlus/mcp2515/Mcp2515.cpp b/src/lib/canPlus/mcp2515/Mcp2515.cpp new file mode 100755 index 0000000..e068193 --- /dev/null +++ b/src/lib/canPlus/mcp2515/Mcp2515.cpp @@ -0,0 +1,152 @@ +// ----------------------------------------------------------------------------------- +// CAN library (MCP2515 via autowp/arduino-mcp2515) + +#include "Mcp2515.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN_MCP2515 + +#include "../../tasks/OnTask.h" + +#include +#include // https://github.com/autowp/arduino-mcp2515 + +// Pick the right oscillator value for your module: +// - Most shields/modules are 16MHz +// - Some are 8MHz +#ifndef CAN_MCP2515_CLOCK + #define CAN_MCP2515_CLOCK MCP_16MHZ +#endif + +IRAM_ATTR void canMcp2515Monitor() { canPlus.poll(); } + +static MCP2515 mcp2515(CAN_CS_PIN); + +CanPlusMCP2515::CanPlusMCP2515() {} + +static inline can_bitrate_t toBitrate() { + #if CAN_BAUD == 125000 + return CAN_125KBPS; + #elif CAN_BAUD == 250000 + return CAN_250KBPS; + #elif CAN_BAUD == 500000 + return CAN_500KBPS; + #elif CAN_BAUD == 1000000 + return CAN_1000KBPS; + #else + return CAN_500KBPS; + #endif +} + +void CanPlusMCP2515::init() { + VF("MSG: CanPlus, CAN_MCP2515 (autowp) Start... "); + + #if CAN_INT_PIN != OFF + pinMode(CAN_INT_PIN, INPUT_PULLUP); + #endif + + SPI.begin(); + mcp2515.reset(); + + ready = (mcp2515.setBitrate(toBitrate(), CAN_MCP2515_CLOCK) == MCP2515::ERROR_OK); + if (ready) ready = (mcp2515.setNormalMode() == MCP2515::ERROR_OK); + + if (ready) { + VLF("success"); + VF("MSG: CanPlus, start callback monitor task (rate "); V(CAN_RECV_RATE_MS); + VF("ms priority 3)... "); + if (tasks.add(CAN_RECV_RATE_MS, 0, true, 3, canMcp2515Monitor, "Can2515")) { + VLF("success"); + + // setup the burst task disabled (period 0) and so it only runs once + burst = tasks.add(0, 0, true, 3, canEsp32Monitor, "CanBrst"); + + } else VLF("FAILED!"); + } else { + VLF("FAILED!"); + } +} + +int CanPlusMCP2515::writePacket(int id, const uint8_t *buffer, size_t size) { + if (!ready) return 0; + if (size > 8) return 0; + if (size > 0 && buffer == nullptr) return 0; + + struct can_frame frame{}; + frame.can_id = (uint32_t)(id & CAN_SFF_MASK); // standard 11-bit + frame.can_dlc = (uint8_t)size; + if (size && buffer) { + memcpy(frame.data, buffer, size); + } + auto err = mcp2515.sendMessage(&frame); + if (err == MCP2515::ERROR_OK) tx_ok++; else tx_fail++; + return (err == MCP2515::ERROR_OK) ? 1 : 0; +} + +int CanPlusMCP2515::writePacketRtr(int id, size_t dlc) { + if (!ready) return 0; + if (dlc > 8) return 0; + + struct can_frame frame{}; + frame.can_id = (uint32_t)(id & CAN_SFF_MASK) | CAN_RTR_FLAG; + frame.can_dlc = (uint8_t)dlc; + + auto err = mcp2515.sendMessage(&frame); + if (err == MCP2515::ERROR_OK) tx_ok++; else tx_fail++; + return (err == MCP2515::ERROR_OK) ? 1 : 0; +} + +void CanPlusMCP2515::rxBurst(uint32_t periodUs) { + const uint32_t now = micros(); + const uint32_t until = now + periodUs; + + if (!burstEnabled) { + burstEnabled = true; + burstUntilUs = until; + tasks.setPeriod(burst, 1); + } else { + if ((int32_t)(until - burstUntilUs) > 0) burstUntilUs = until; + } +} + +void CanPlusMCP2515::poll() { + if (!ready) return; + + if (burstEnabled && (int32_t)(micros() - burstUntilUs) >= 0) { + tasks.setPeriod(burst, 0); + burstEnabled = false; + } + + const uint32_t start = micros(); + + // shorten workload during busts + const int frames = burstEnabled ? (maxFrames >> 1) : maxFrames; + + // drain up to N frames per poll so we don't monopolize the CPU + for (int n = 0; n < frames; n++) { + #if CAN_INT_PIN != OFF + if (digitalRead(CAN_INT_PIN)) break; + #endif + + struct can_frame frame{}; + auto err = mcp2515.readMessage(&frame); + + // If you're NOT using INT, this is your "no more frames" exit + if (err != MCP2515::ERROR_OK) break; + + if (frame.can_id & CAN_EFF_FLAG) { rx_drop_ext++; continue; } + if (frame.can_id & CAN_RTR_FLAG) { rx_drop_rtr++; continue; } + + const uint8_t dlc = frame.can_dlc; + if (dlc < 1 || dlc > 8) { rx_drop_len++; continue; } + + rx_ok++; + callbackProcess((int)(frame.can_id & CAN_SFF_MASK), frame.data, dlc); + + if ((uint32_t)(micros() - start) > budgetUs) break; + } +} + + +CanPlusMCP2515 canPlus; + +#endif diff --git a/src/lib/canPlus/mcp2515/Mcp2515.h b/src/lib/canPlus/mcp2515/Mcp2515.h new file mode 100755 index 0000000..b8acf4e --- /dev/null +++ b/src/lib/canPlus/mcp2515/Mcp2515.h @@ -0,0 +1,31 @@ +// ----------------------------------------------------------------------------------- +// CAN library +#pragma once + +#include "../../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN_MCP2515 + +#include "../CanPlusBase.h" + +class CanPlusMCP2515 : public CanPlus { + public: + CanPlusMCP2515(); + void init(); + + int writePacket(int id, const uint8_t *buffer, size_t size) override; + int writePacketRtr(int id, size_t dlc) override; + + void rxBurst(uint32_t periodUs = 2000); + + void poll(); + + private: + uint8_t burst = 0; + uint32_t burstUntilUs = 0; + bool burstEnabled = false; +}; + +extern CanPlusMCP2515 canPlus; + +#endif diff --git a/src/lib/canPlus/san/San.cpp b/src/lib/canPlus/san/San.cpp new file mode 100755 index 0000000..41a523a --- /dev/null +++ b/src/lib/canPlus/san/San.cpp @@ -0,0 +1,124 @@ +// ----------------------------------------------------------------------------------- +// CAN library + +#include "San.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN_SAN + +#include // https://github.com/sandeepmistry/arduino-CAN + +// Pick the right oscillator value for your module: +// - Most shields/modules are 16MHz +// - Some are 8MHz +#ifndef CAN_SAN_CLOCK + #define CAN_SAN_CLOCK 16000000UL // or 8000000UL for 8MHz modules +#endif + +IRAM_ATTR void onReceive(int packetSize) { canPlus.poll(packetSize); } + +CanPlusSan::CanPlusSan() { +} + +void CanPlusSan::init() { + CAN.setClockFrequency(CAN_SAN_CLOCK); + CAN.setPins(CAN_RX_PIN, CAN_TX_PIN); + VF("MSG: CanPlus, CAN Start... "); + ready = CAN.begin(CAN_BAUD); + if (ready) { VLF("success"); } else { VLF("FAILED!"); } + CAN.onReceive(onReceive); +} + +int CanPlusSan::beginPacket(int id) { + if (!ready) return 0; + return CAN.beginPacket(id & 0x7FF); +} + +int CanPlusSan::endPacket() { + if (!ready) return 0; + return CAN.endPacket(); +} + +int CanPlusSan::write(uint8_t byte) { + if (!ready) return 0; + return CAN.write(byte); +} + +int CanPlusSan::write(const uint8_t *buffer, size_t size) { + if (!ready) return 0; + return CAN.write(buffer, size); +} + +int CanPlusSan::writePacket(int id, const uint8_t *buffer, size_t size) { + if (!ready) return 0; + if (size > 8) return 0; + if (size > 0 && buffer == nullptr) return 0; + + const uint16_t sid = (uint16_t)id & 0x7FF; + if (!CAN.beginPacket(sid)) { tx_fail++; return 0; } + + int written = 0; + + if (size > 0) { + if (!buffer) { (void)CAN.endPacket(); tx_fail++; return 0; } + + written = CAN.write((uint8_t*)buffer, size); // only if API requires non-const + if (written != (int)size) { + (void)CAN.endPacket(); + tx_fail++; + return 0; + } + } + + bool ok = CAN.endPacket(); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +int CanPlusSan::writePacketRtr(int id, size_t dlc) { + if (!ready) return 0; + if (dlc > 8) return 0; + + // arduino-CAN supports beginPacket(id, dlc, rtr) in most versions + if (!CAN.beginPacket(id & 0x7FF, (int)dlc, true)) { tx_fail++; return 0; } + + bool ok = CAN.endPacket(); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +IRAM_ATTR void CanPlusSan::poll(int packetSize) { + if (!ready) return; + + bool ext = CAN.packetExtended(); + bool rtr = CAN.packetRtr(); + int packetId = CAN.packetId() & 0x7FF; + + if (ext) { rx_drop_ext++; while (CAN.available()) (void)CAN.read(); return; } + + // Handle RTR early; DLC may legitimately be 0 + if (rtr) { + rx_drop_rtr++; + while (CAN.available()) (void)CAN.read(); + return; + } + + if (packetSize < 1 || packetSize > 8) { + rx_drop_len++; + while (CAN.available()) (void)CAN.read(); + return; + } + + uint8_t buffer[8] = {0}; + for (int i = 0; i < packetSize; i++) { + int b = CAN.read(); + buffer[i] = (b < 0) ? 0 : (uint8_t)b; + } + while (CAN.available()) (void)CAN.read(); + + rx_ok++; + callbackProcess(packetId, buffer, (size_t)packetSize); +} + +CanPlusSan canPlus; + +#endif diff --git a/src/lib/canPlus/san/San.h b/src/lib/canPlus/san/San.h new file mode 100755 index 0000000..3775006 --- /dev/null +++ b/src/lib/canPlus/san/San.h @@ -0,0 +1,29 @@ +// ----------------------------------------------------------------------------------- +// CAN library +#pragma once + +#include "../../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN_SAN + +#include "../CanPlusBase.h" + +class CanPlusSan : public CanPlus { + public: + CanPlusSan(); + void init(); + int beginPacket(int id); + int endPacket(); + int write(uint8_t byte); + int write(const uint8_t *buffer, size_t size); + int writePacket(int id, const uint8_t *buffer, size_t size); + int writePacketRtr(int id, size_t dlc); + void poll(int packetSize); + + private: + +}; + +extern CanPlusSan canPlus; + +#endif diff --git a/src/lib/canPlus/teensy4/Can0.cpp b/src/lib/canPlus/teensy4/Can0.cpp new file mode 100755 index 0000000..338077d --- /dev/null +++ b/src/lib/canPlus/teensy4/Can0.cpp @@ -0,0 +1,92 @@ +// ----------------------------------------------------------------------------------- +// CAN library + +#include "Can0.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN0_TEENSY4 + +#include "../../tasks/OnTask.h" + +void canT4Recv0(const CAN_message_t &msg) { canPlus.poll(msg); } +void canT4Poll0() { canPlus.events(); } + +FlexCAN_T4 can0; + +CanPlus0Teesny4::CanPlus0Teesny4() { +} + +void CanPlus0Teesny4::init() { + VF("MSG: CanPlus, CAN_TEENSY4 CAN0 Start..."); + can0.begin(); + can0.setBaudRate(CAN_BAUD); + can0.setMaxMB(16); + can0.enableFIFO(); + can0.enableFIFOInterrupt(); + can0.onReceive(canT4Recv0); + ready = true; + + if (ready) { + VLF("success"); + + VF("MSG: CanPlus, start callback monitor task (rate "); V(CAN_RECV_RATE_MS); VF("ms priority 3)... "); + if (tasks.add(CAN_RECV_RATE_MS, 0, true, 3, canT4Poll0, "SysCan0")) { VLF("success"); } else { VLF("FAILED!"); } + } else { + VLF("FAILED!"); + } +} + +int CanPlus0Teesny4::writePacket(int id, const uint8_t *buffer, size_t size) { + if (!ready) return 0; + if (size > 8) return 0; + if (size > 0 && buffer == nullptr) return 0; + + CAN_message_t msg{}; + msg.id = id & 0x7FF; + msg.len = (uint8_t)size; + msg.flags.remote = 0; + msg.flags.extended = 0; + + for (uint8_t i = 0; i < msg.len; i++) msg.buf[i] = buffer[i]; + + bool ok = can0.write(msg); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +int CanPlus0Teesny4::writePacketRtr(int id, size_t dlc) { + if (!ready) return 0; + if (dlc > 8) return 0; // DLC may be 0..8 + + CAN_message_t msg{}; + msg.id = id & 0x7FF; + msg.len = (uint8_t)dlc; + msg.flags.remote = 1; + msg.flags.extended = 0; + + bool ok = can0.write(msg); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +void CanPlus0Teesny4::poll(const CAN_message_t &msg) { + if (!ready) return; + + if (msg.flags.overrun) { rx_drop_len++; return; } + if (msg.flags.extended) { rx_drop_ext++; return; } + if (msg.flags.remote) { rx_drop_rtr++; return; } + + if (msg.len < 1 || msg.len > 8) { rx_drop_len++; return; } + + rx_ok++; + callbackProcess(msg.id & 0x7FF, (uint8_t*)msg.buf, msg.len); +} + +void CanPlus0Teesny4::events() { + can0.events(); +} + +#if CAN_PLUS_DEFAULT == CAN0_TEENSY4 + CanPlus0Teesny4 canPlus; +#endif + +#endif diff --git a/src/lib/canPlus/teensy4/Can0.h b/src/lib/canPlus/teensy4/Can0.h new file mode 100755 index 0000000..900be3a --- /dev/null +++ b/src/lib/canPlus/teensy4/Can0.h @@ -0,0 +1,38 @@ +// ----------------------------------------------------------------------------------- +// CAN library +#pragma once + +#include "../../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN0_TEENSY4 + +#include "../CanPlusBase.h" + +#include // https://github.com/tonton81/FlexCAN_T4 + +#if !defined(ARDUINO_TEENSY40) && !defined(ARDUINO_TEENSY41) + #error "Configuration (Config.h): Setting CAN_PLUS CAN_TEENSY4 requires an Teensy4.0 or Teensy4.1 microcontroller." +#endif + +#ifndef CAN_PLUS_DEFAULT + #define CAN_PLUS_DEFAULT CAN0_TEENSY4 +#endif + +class CanPlus0Teesny4 : public CanPlus { + public: + CanPlus0Teesny4(); + void init(); + int writePacket(int id, const uint8_t *buffer, size_t size); + int writePacketRtr(int id, size_t dlc); + void poll(const CAN_message_t &msg); + void events(); + + private: + +}; + +#if CAN_PLUS_DEFAULT == CAN0_TEENSY4 + extern CanPlus0Teesny4 canPlus; +#endif + +#endif diff --git a/src/lib/canPlus/teensy4/Can1.cpp b/src/lib/canPlus/teensy4/Can1.cpp new file mode 100755 index 0000000..353d30d --- /dev/null +++ b/src/lib/canPlus/teensy4/Can1.cpp @@ -0,0 +1,92 @@ +// ----------------------------------------------------------------------------------- +// CAN library + +#include "Can1.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN1_TEENSY4 + +#include "../../tasks/OnTask.h" + +void canT4Recv1(const CAN_message_t &msg) { canPlus.poll(msg); } +void canT4Poll1() { canPlus.events(); } + +FlexCAN_T4 can1; + +CanPlus1Teesny4::CanPlus1Teesny4() { +} + +void CanPlus1Teesny4::init() { + VF("MSG: CanPlus, CAN_TEENSY4 CAN1 Start..."); + can1.begin(); + can1.setBaudRate(CAN_BAUD); + can1.setMaxMB(16); + can1.enableFIFO(); + can1.enableFIFOInterrupt(); + can1.onReceive(canT4Recv1); + ready = true; + + if (ready) { + VLF("success"); + + VF("MSG: CanPlus, start callback monitor task (rate "); V(CAN_RECV_RATE_MS); VF("ms priority 3)... "); + if (tasks.add(CAN_RECV_RATE_MS, 0, true, 3, canT4Poll1, "SysCan1")) { VLF("success"); } else { VLF("FAILED!"); } + } else { + VLF("FAILED!"); + } +} + +int CanPlus1Teesny4::writePacket(int id, const uint8_t *buffer, size_t size) { + if (!ready) return 0; + if (size > 8) return 0; + if (size > 0 && buffer == nullptr) return 0; + + CAN_message_t msg{}; + msg.id = id & 0x7FF; + msg.len = (uint8_t)size; + msg.flags.remote = 0; + msg.flags.extended = 0; + + for (uint8_t i = 0; i < msg.len; i++) msg.buf[i] = buffer[i]; + + bool ok = can1.write(msg); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +int CanPlus1Teesny4::writePacketRtr(int id, size_t dlc) { + if (!ready) return 0; + if (dlc > 8) return 0; // DLC may be 0..8 + + CAN_message_t msg{}; + msg.id = id & 0x7FF; + msg.len = (uint8_t)dlc; + msg.flags.remote = 1; + msg.flags.extended = 0; + + bool ok = can1.write(msg); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +void CanPlus1Teesny4::poll(const CAN_message_t &msg) { + if (!ready) return; + + if (msg.flags.overrun) { rx_drop_len++; return; } + if (msg.flags.extended) { rx_drop_ext++; return; } + if (msg.flags.remote) { rx_drop_rtr++; return; } + + if (msg.len < 1 || msg.len > 8) { rx_drop_len++; return; } + + rx_ok++; + callbackProcess(msg.id & 0x7FF, (uint8_t*)msg.buf, msg.len); +} + +void CanPlus1Teesny4::events() { + can1.events(); +} + +#if CAN_PLUS_DEFAULT == CAN1_TEENSY4 + CanPlus1Teesny4 canPlus; +#endif + +#endif diff --git a/src/lib/canPlus/teensy4/Can1.h b/src/lib/canPlus/teensy4/Can1.h new file mode 100755 index 0000000..3052fd7 --- /dev/null +++ b/src/lib/canPlus/teensy4/Can1.h @@ -0,0 +1,38 @@ +// ----------------------------------------------------------------------------------- +// CAN library +#pragma once + +#include "../../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN1_TEENSY4 + +#include "../CanPlusBase.h" + +#include // https://github.com/tonton81/FlexCAN_T4 + +#if !defined(ARDUINO_TEENSY40) && !defined(ARDUINO_TEENSY41) + #error "Configuration (Config.h): Setting CAN_PLUS CAN_TEENSY4 requires an Teensy4.0 or Teensy4.1 microcontroller." +#endif + +#ifndef CAN_PLUS_DEFAULT + #define CAN_PLUS_DEFAULT CAN1_TEENSY4 +#endif + +class CanPlus1Teesny4 : public CanPlus { + public: + CanPlus1Teesny4(); + void init(); + int writePacket(int id, const uint8_t *buffer, size_t size); + int writePacketRtr(int id, size_t dlc); + void poll(const CAN_message_t &msg); + void events(); + + private: + +}; + +#if CAN_PLUS_DEFAULT == CAN1_TEENSY4 + extern CanPlus1Teesny4 canPlus; +#endif + +#endif diff --git a/src/lib/canPlus/teensy4/Can2.cpp b/src/lib/canPlus/teensy4/Can2.cpp new file mode 100755 index 0000000..7c5b170 --- /dev/null +++ b/src/lib/canPlus/teensy4/Can2.cpp @@ -0,0 +1,92 @@ +// ----------------------------------------------------------------------------------- +// CAN library + +#include "Can2.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN2_TEENSY4 + +#include "../../tasks/OnTask.h" + +void canT4Recv2(const CAN_message_t &msg) { canPlus.poll(msg); } +void canT4Poll2() { canPlus.events(); } + +FlexCAN_T4 can2; + +CanPlus2Teesny4::CanPlus2Teesny4() { +} + +void CanPlus2Teesny4::init() { + VF("MSG: CanPlus, CAN_TEENSY4 CAN2 Start..."); + can2.begin(); + can2.setBaudRate(CAN_BAUD); + can2.setMaxMB(16); + can2.enableFIFO(); + can2.enableFIFOInterrupt(); + can2.onReceive(canT4Recv2); + ready = true; + + if (ready) { + VLF("success"); + + VF("MSG: CanPlus, start callback monitor task (rate "); V(CAN_RECV_RATE_MS); VF("ms priority 3)... "); + if (tasks.add(CAN_RECV_RATE_MS, 0, true, 3, canT4Poll2, "SysCan2")) { VLF("success"); } else { VLF("FAILED!"); } + } else { + VLF("FAILED!"); + } +} + +int CanPlus2Teesny4::writePacket(int id, const uint8_t *buffer, size_t size) { + if (!ready) return 0; + if (size > 8) return 0; + if (size > 0 && buffer == nullptr) return 0; + + CAN_message_t msg{}; + msg.id = id & 0x7FF; + msg.len = (uint8_t)size; + msg.flags.remote = 0; + msg.flags.extended = 0; + + for (uint8_t i = 0; i < msg.len; i++) msg.buf[i] = buffer[i]; + + bool ok = can2.write(msg); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +int CanPlus2Teesny4::writePacketRtr(int id, size_t dlc) { + if (!ready) return 0; + if (dlc > 8) return 0; // DLC may be 0..8 + + CAN_message_t msg{}; + msg.id = id & 0x7FF; + msg.len = (uint8_t)dlc; + msg.flags.remote = 1; + msg.flags.extended = 0; + + bool ok = can2.write(msg); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +void CanPlus2Teesny4::poll(const CAN_message_t &msg) { + if (!ready) return; + + if (msg.flags.overrun) { rx_drop_len++; return; } + if (msg.flags.extended) { rx_drop_ext++; return; } + if (msg.flags.remote) { rx_drop_rtr++; return; } + + if (msg.len < 1 || msg.len > 8) { rx_drop_len++; return; } + + rx_ok++; + callbackProcess(msg.id & 0x7FF, (uint8_t*)msg.buf, msg.len); +} + +void CanPlus2Teesny4::events() { + can2.events(); +} + +#if CAN_PLUS_DEFAULT == CAN2_TEENSY4 + CanPlus2Teesny4 canPlus; +#endif + +#endif diff --git a/src/lib/canPlus/teensy4/Can2.h b/src/lib/canPlus/teensy4/Can2.h new file mode 100755 index 0000000..b91678b --- /dev/null +++ b/src/lib/canPlus/teensy4/Can2.h @@ -0,0 +1,38 @@ +// ----------------------------------------------------------------------------------- +// CAN library +#pragma once + +#include "../../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN2_TEENSY4 + +#include "../CanPlusBase.h" + +#include // https://github.com/tonton81/FlexCAN_T4 + +#if !defined(ARDUINO_TEENSY40) && !defined(ARDUINO_TEENSY41) + #error "Configuration (Config.h): Setting CAN_PLUS CAN_TEENSY4 requires an Teensy4.0 or Teensy4.1 microcontroller." +#endif + +#ifndef CAN_PLUS_DEFAULT + #define CAN_PLUS_DEFAULT CAN2_TEENSY4 +#endif + +class CanPlus2Teesny4 : public CanPlus { + public: + CanPlus2Teesny4(); + void init(); + int writePacket(int id, const uint8_t *buffer, size_t size); + int writePacketRtr(int id, size_t dlc); + void poll(const CAN_message_t &msg); + void events(); + + private: + +}; + +#if CAN_PLUS_DEFAULT == CAN2_TEENSY4 + extern CanPlus2Teesny4 canPlus; +#endif + +#endif diff --git a/src/lib/canPlus/teensy4/Can3.cpp b/src/lib/canPlus/teensy4/Can3.cpp new file mode 100755 index 0000000..62999df --- /dev/null +++ b/src/lib/canPlus/teensy4/Can3.cpp @@ -0,0 +1,92 @@ +// ----------------------------------------------------------------------------------- +// CAN library + +#include "Can3.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN3_TEENSY4 + +#include "../../tasks/OnTask.h" + +void canT4Recv3(const CAN_message_t &msg) { canPlus.poll(msg); } +void canT4Poll3() { canPlus.events(); } + +FlexCAN_T4 can3; + +CanPlus3Teesny4::CanPlus3Teesny4() { +} + +void CanPlus3Teesny4::init() { + VF("MSG: CanPlus, CAN_TEENSY4 CAN3 Start..."); + can3.begin(); + can3.setBaudRate(CAN_BAUD); + can3.setMaxMB(16); + can3.enableFIFO(); + can3.enableFIFOInterrupt(); + can3.onReceive(canT4Recv3); + ready = true; + + if (ready) { + VLF("success"); + + VF("MSG: CanPlus, start callback monitor task (rate "); V(CAN_RECV_RATE_MS); VF("ms priority 3)... "); + if (tasks.add(CAN_RECV_RATE_MS, 0, true, 3, canT4Poll3, "SysCan3")) { VLF("success"); } else { VLF("FAILED!"); } + } else { + VLF("FAILED!"); + } +} + +int CanPlus3Teesny4::writePacket(int id, const uint8_t *buffer, size_t size) { + if (!ready) return 0; + if (size > 8) return 0; + if (size > 0 && buffer == nullptr) return 0; + + CAN_message_t msg{}; + msg.id = id & 0x7FF; + msg.len = (uint8_t)size; + msg.flags.remote = 0; + msg.flags.extended = 0; + + for (uint8_t i = 0; i < msg.len; i++) msg.buf[i] = buffer[i]; + + bool ok = can3.write(msg); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +int CanPlus3Teesny4::writePacketRtr(int id, size_t dlc) { + if (!ready) return 0; + if (dlc > 8) return 0; // DLC may be 0..8 + + CAN_message_t msg{}; + msg.id = id & 0x7FF; + msg.len = (uint8_t)dlc; + msg.flags.remote = 1; + msg.flags.extended = 0; + + bool ok = can3.write(msg); + if (ok) tx_ok++; else tx_fail++; + return ok ? 1 : 0; +} + +void CanPlus3Teesny4::poll(const CAN_message_t &msg) { + if (!ready) return; + + if (msg.flags.overrun) { rx_drop_len++; return; } + if (msg.flags.extended) { rx_drop_ext++; return; } + if (msg.flags.remote) { rx_drop_rtr++; return; } + + if (msg.len < 1 || msg.len > 8) { rx_drop_len++; return; } + + rx_ok++; + callbackProcess(msg.id & 0x7FF, (uint8_t*)msg.buf, msg.len); +} + +void CanPlus3Teesny4::events() { + can3.events(); +} + +#if CAN_PLUS_DEFAULT == CAN3_TEENSY4 + CanPlus3Teesny4 canPlus; +#endif + +#endif diff --git a/src/lib/canPlus/teensy4/Can3.h b/src/lib/canPlus/teensy4/Can3.h new file mode 100755 index 0000000..9b8d8ae --- /dev/null +++ b/src/lib/canPlus/teensy4/Can3.h @@ -0,0 +1,38 @@ +// ----------------------------------------------------------------------------------- +// CAN library +#pragma once + +#include "../../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS == CAN3_TEENSY4 + +#include "../CanPlusBase.h" + +#include // https://github.com/tonton81/FlexCAN_T4 + +#if !defined(ARDUINO_TEENSY40) && !defined(ARDUINO_TEENSY41) + #error "Configuration (Config.h): Setting CAN_PLUS CAN_TEENSY4 requires an Teensy4.0 or Teensy4.1 microcontroller." +#endif + +#ifndef CAN_PLUS_DEFAULT + #define CAN_PLUS_DEFAULT CAN3_TEENSY4 +#endif + +class CanPlus3Teesny4 : public CanPlus { + public: + CanPlus3Teesny4(); + void init(); + int writePacket(int id, const uint8_t *buffer, size_t size); + int writePacketRtr(int id, size_t dlc); + void poll(const CAN_message_t &msg); + void events(); + + private: + +}; + +#if CAN_PLUS_DEFAULT == CAN3_TEENSY4 + extern CanPlus3Teesny4 canPlus; +#endif + +#endif diff --git a/src/lib/canTransport/CanTransportBase.cpp b/src/lib/canTransport/CanTransportBase.cpp new file mode 100755 index 0000000..f178442 --- /dev/null +++ b/src/lib/canTransport/CanTransportBase.cpp @@ -0,0 +1,227 @@ +// ----------------------------------------------------------------------------------- +// CAN transport (base) +// ----------------------------------------------------------------------------------- + +#include "CanTransportBase.h" + +#if defined(CAN_PLUS) && CAN_PLUS != OFF + +#include "../CanPlus/CanPlus.h" + +CanTransport* CanTransport::s_instances[TRANSPORT_CAN_MAX_INSTANCES] = {nullptr}; + +CanTransport::CanTransport(uint16_t requestId, uint16_t responseId, uint8_t dualFrameOpcodeStart) + : reqId(requestId), rspId(responseId), opDualResponse(dualFrameOpcodeStart) { + tidop = 0; + opcode = 0; + + // dual-cursor state + rxLen = 0; + rxPos = 0; + txPos = 0; + + // buffers are fixed arrays; no pointer init needed + // optional: clear for determinism + memset(rxBuf, 0, sizeof(rxBuf)); + memset(txBuf, 0, sizeof(txBuf)); +} + +bool CanTransport::init() { + if (!canPlus.ready) return false; + + if (slot < 0) slot = allocSlot(this); + if (slot < 0) return false; + + return true; +} + +// ----------------------------------------------------------------------------------- +// Dual-cursor pack/unpack helpers (LE on wire) +// +// read* => rxBuf/rxPos/rxLen +// write* => txBuf/txPos/txMax +// ----------------------------------------------------------------------------------- + +bool CanTransport::writeBytes(const uint8_t *src, uint8_t n) { + if (!src) return false; + if (!allowTx(n)) return false; + memcpy(&txBuf[txPos], src, n); + txPos = (uint8_t)(txPos + n); + return true; +} + +int CanTransport::readBytes(uint8_t *dst, uint8_t n) { + if (!dst) return 0; + if (!allowRx(n)) return 0; + memcpy(dst, &rxBuf[rxPos], n); + rxPos = (uint8_t)(rxPos + n); + return (int)n; +} + +bool CanTransport::writeU8(uint8_t v) { + if (!allowTx(1)) return false; + txBuf[txPos++] = v; + return true; +} + +bool CanTransport::readU8(uint8_t &v) { + if (!allowRx(1)) return false; + v = rxBuf[rxPos++]; + return true; +} + +bool CanTransport::writeU16(uint16_t v) { + if (!allowTx(2)) return false; + txBuf[txPos + 0] = (uint8_t)(v & 0xFFu); + txBuf[txPos + 1] = (uint8_t)((v >> 8) & 0xFFu); + txPos = (uint8_t)(txPos + 2); + return true; +} + +bool CanTransport::readU16(uint16_t &v) { + if (!allowRx(2)) return false; + v = (uint16_t)rxBuf[rxPos + 0] + | (uint16_t)((uint16_t)rxBuf[rxPos + 1] << 8); + rxPos = (uint8_t)(rxPos + 2); + return true; +} + +bool CanTransport::writeU32(uint32_t v) { + if (!allowTx(4)) return false; + txBuf[txPos + 0] = (uint8_t)(v & 0xFFu); + txBuf[txPos + 1] = (uint8_t)((v >> 8) & 0xFFu); + txBuf[txPos + 2] = (uint8_t)((v >> 16) & 0xFFu); + txBuf[txPos + 3] = (uint8_t)((v >> 24) & 0xFFu); + txPos = (uint8_t)(txPos + 4); + return true; +} + +bool CanTransport::readU32(uint32_t &v) { + if (!allowRx(4)) return false; + v = (uint32_t)rxBuf[rxPos + 0] + | (uint32_t)((uint32_t)rxBuf[rxPos + 1] << 8) + | (uint32_t)((uint32_t)rxBuf[rxPos + 2] << 16) + | (uint32_t)((uint32_t)rxBuf[rxPos + 3] << 24); + rxPos = (uint8_t)(rxPos + 4); + return true; +} + +bool CanTransport::writeF32(float v) { + uint32_t u = 0; + static_assert(sizeof(float) == sizeof(uint32_t), "float must be 32-bit"); + memcpy(&u, &v, sizeof(u)); + return writeU32(u); +} + +bool CanTransport::readF32(float &v) { + uint32_t u = 0; + if (!readU32(u)) return false; + static_assert(sizeof(float) == sizeof(uint32_t), "float must be 32-bit"); + memcpy(&v, &u, sizeof(v)); + return true; +} + +bool CanTransport::writeFixedI16(float value, int32_t scale) { + if (scale == 0) return false; + if (isnan(value)) return writeI16(NAN_SENTINEL); + + const float scaled = value * (float)scale; + const float adj = (scaled >= 0.0f) ? 0.5f : -0.5f; + const int32_t v = (int32_t)(scaled + adj); + + // reserve INT16_MIN for NaN sentinel; overflow => sentinel + if (v < -32767 || v > 32767) return writeI16(NAN_SENTINEL); + + return writeI16((int16_t)v); +} + +bool CanTransport::readFixedI16(float &value, int32_t scale) { + if (scale == 0) return false; + + int16_t v = 0; + if (!readI16(v)) return false; + + if (v == NAN_SENTINEL) { value = NAN; return true; } + + value = ((float)v) / (float)scale; + return true; +} + +bool CanTransport::writeFixedI16(double value, int32_t scale) { + if (scale == 0) return false; + if (isnan(value)) return writeI16(NAN_SENTINEL); + + const double scaled = value * (double)scale; + const double adj = (scaled >= 0.0) ? 0.5 : -0.5; + const int32_t v = (int32_t)(scaled + adj); + + if (v < -32767 || v > 32767) return writeI16(NAN_SENTINEL); + + return writeI16((int16_t)v); +} + +bool CanTransport::readFixedI16(double &value, int32_t scale) { + if (scale == 0) return false; + + int16_t v = 0; + if (!readI16(v)) return false; + + if (v == NAN_SENTINEL) { value = NAN; return true; } + + value = ((double)v) / (double)scale; + return true; +} + +// -------------------- slot allocation -------------------- + +int8_t CanTransport::allocSlot(CanTransport *p) { + for (int8_t i = 0; i < (int8_t)TRANSPORT_CAN_MAX_INSTANCES; i++) { + if (s_instances[i] == nullptr) { s_instances[i] = p; return i; } + } + return -1; +} + +void CanTransport::taskThunk() { + // Pump RX once per scheduler tick/task invocation + canPlus.rxBurst(); + + // Run all instances (cheap); instances with no work return quickly + for (int i = 0; i < (int)TRANSPORT_CAN_MAX_INSTANCES; i++) { + if (s_instances[i]) s_instances[i]->process(); + } +} + +CanTransport::ThunkFn CanTransport::thunkForSlot(int8_t s) { + switch (s) { + case 0: return &CanTransport::onThunk0; + case 1: return &CanTransport::onThunk1; + case 2: return &CanTransport::onThunk2; + case 3: return &CanTransport::onThunk3; + case 4: return &CanTransport::onThunk4; + case 5: return &CanTransport::onThunk5; + case 6: return &CanTransport::onThunk6; + case 7: return &CanTransport::onThunk7; + default: return &CanTransport::onThunk0; + } +} + +// -------------------- thunks -------------------- + +#define TRANSPORT_CAN_THUNK(N) \ + void CanTransport::onThunk##N(uint8_t data[8], uint8_t len) { \ + CanTransport *p = s_instances[N]; \ + if (p) p->onFrame((const uint8_t*)data, len); \ + } + +TRANSPORT_CAN_THUNK(0) +TRANSPORT_CAN_THUNK(1) +TRANSPORT_CAN_THUNK(2) +TRANSPORT_CAN_THUNK(3) +TRANSPORT_CAN_THUNK(4) +TRANSPORT_CAN_THUNK(5) +TRANSPORT_CAN_THUNK(6) +TRANSPORT_CAN_THUNK(7) + +#undef TRANSPORT_CAN_THUNK + +#endif diff --git a/src/lib/canTransport/CanTransportBase.h b/src/lib/canTransport/CanTransportBase.h new file mode 100755 index 0000000..043a363 --- /dev/null +++ b/src/lib/canTransport/CanTransportBase.h @@ -0,0 +1,224 @@ +// ----------------------------------------------------------------------------------- +// CAN transport (base) +// +// Wire format (payload bytes): +// Request: [ tidop, args... ] (1..8 bytes) +// Response: [ tidop, status, payload... ] (2..8 bytes) +// status: [7 handled][6 numericReply][5 suppressFrame][4..0 commandError] +// +// Notes: +// - Uses global canPlus (single CAN interface typical on Arduino-class targets) +// - This base provides: +// * dual-cursor pack/unpack (RX cursor for reads, TX cursor for writes) +// * slot/thunk dispatch so callbacks can route to instances without globals +// - This base does NOT impose a global/shared tidop. tid/op correlation is a +// per-transaction concern and should be tracked by the client implementation. +// ----------------------------------------------------------------------------------- + +#pragma once + +#include "../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS != OFF + +#include "../commands/CommandErrors.h" + +#ifndef TRANSPORT_CAN_MAX_INSTANCES + #define TRANSPORT_CAN_MAX_INSTANCES 8 +#endif + +class CanTransport { +public: + CanTransport(uint16_t requestId, uint16_t responseId, uint8_t dualFrameOpcodeStart = 32); + + virtual bool init(); + virtual void begin() {} + + inline uint8_t opCode() const { return opcode; } + inline uint16_t requestCanId() const { return reqId; } + inline uint16_t responseCanId() const { return rspId; } + + // ------------------------- + // Raw bytes + // write* => TX cursor + // read* => RX cursor + // ------------------------- + bool writeBytes(const uint8_t *src, uint8_t n); + int readBytes(uint8_t *dst, uint8_t n); + int readRemainingBytes(uint8_t *dst) { if (rxPos > rxLen) return 0; return readBytes(dst, (uint8_t)(rxLen - rxPos)); } + + // ------------------------- + // Unsigned integers (LE on wire) + // ------------------------- + bool writeU8(uint8_t v); + bool readU8(uint8_t &v); + bool writeU16(uint16_t v); + bool readU16(uint16_t &v); + bool writeU32(uint32_t v); + bool readU32(uint32_t &v); + + // ------------------------- + // Signed integers (LE on wire) + // ------------------------- + inline bool writeI16(int16_t v) { return writeU16((uint16_t)v); } + inline bool readI16(int16_t &v) { uint16_t u = 0; if (!readU16(u)) return false; v = (int16_t)u; return true; } + inline bool writeI32(int32_t v) { return writeU32((uint32_t)v); } + inline bool readI32(int32_t &v) { uint32_t u = 0; if (!readU32(u)) return false; v = (int32_t)u; return true; } + + // ------------------------- + // Floats (IEEE-754, LE on wire) + // ------------------------- + bool writeF32(float v); + bool readF32(float &v); + + // ------------------------- + // Fixed-point helpers (int16 payload, NaN sentinel) + // ------------------------- + bool writeFixedI16(float value, int32_t scale); + bool readFixedI16(float &value, int32_t scale); + bool writeFixedI16(double value, int32_t scale); + bool readFixedI16(double &value, int32_t scale); + + // ------------------------- + // RX cursor accessors (default size/offset/remaining map to RX) + // ------------------------- + uint8_t size() const { return rxLen; } + uint8_t offset() const { return rxPos; } + uint8_t remaining() const { return (rxPos <= rxLen) ? (uint8_t)(rxLen - rxPos) : 0; } + +protected: + // Server-side handler: interpret request bytes and decide payload/status. + // Reads come from RX cursor; writes go to TX cursor. + virtual void processCommand() {} + + // Unified ingress point for CAN frames delivered via thunk. + // Default: treat the frame as a request and call processCommand() directly. + // Server implementations that need ISR-safe handling should override onFrame(). + virtual void onFrame(const uint8_t data[8], uint8_t len) { + beginNewRequest(data, len); + beginNewResponse(); + processCommand(); + } + + virtual void onResponse(const uint8_t data[8], uint8_t len) { (void)data; (void)len; } + + // Optional per-instance periodic processing hook (poll loop / task) + virtual void process() {} + + // ------------------------- + // RX/TX buffer binding + cursors + // ------------------------- + inline void beginNewRequest(const uint8_t data[8], uint8_t len) { + if (!data) { rxLen = 0; rxPos = 0; return; } + if (len > (uint8_t)sizeof(rxBuf)) len = (uint8_t)sizeof(rxBuf); + memcpy(rxBuf, data, len); + rxLen = len; + + tidop = (len >= 1) ? rxBuf[0] : 0; + opcode = unpackOp(tidop); + + // args start after tidop + rxPos = 1; + } + + inline void beginNewResponse() { + txPos = 0; + } + + inline uint8_t responsePayloadLen() const { return txPos; } + inline const uint8_t* responsePayload() const { return txBuf; } + inline uint8_t* responsePayloadMut() { return txBuf; } + + // Optional cursor control + inline void resetRx() { rxPos = 0; } + inline bool seekRx(uint8_t newOffset) { if (newOffset > rxLen) return false; rxPos = newOffset; return true; } + inline void resetTx() { txPos = 0; } + inline bool seekTx(uint8_t newOffset) { if (newOffset > txMax) return false; txPos = newOffset; return true; } + + // ------------------------- + // TidOp helpers + // ------------------------- + static inline uint8_t packTidOp(uint8_t tid, uint8_t op) { return (uint8_t)(((tid & 0x07) << 5) | (op & 0x1F)); } + static inline uint8_t unpackTid(uint8_t tidop) { return (uint8_t)((tidop >> 5) & 0x07); } + static inline uint8_t unpackOp (uint8_t tidop) { return (uint8_t)(tidop & 0x1F); } + + // ------------------------- + // Status helpers + // ------------------------- + static inline uint8_t packStatus(bool handled, bool suppressFrame, bool numericReply, CommandError commandError) { + return (uint8_t)((handled ? 0x80:0x00) | + (numericReply ? 0x40:0x00) | + (suppressFrame ? 0x20:0x00) | + ((uint8_t)commandError & 0x1F)); + } + + static inline void unpackStatus(uint8_t status, bool &handled, bool &suppressFrame, bool &numericReply, CommandError &commandError) { + handled = (status & 0x80) != 0; + numericReply = (status & 0x40) != 0; + suppressFrame = (status & 0x20) != 0; + commandError = (CommandError)(status & 0x1F); + } + + // ------------------------- + // Cursor bounds check (RX/TX) + // ------------------------- + inline bool allowRx(uint8_t n) const { + if (rxPos > rxLen) return false; + return (uint8_t)(rxLen - rxPos) >= n; + } + + inline bool allowTx(uint8_t n) const { + if (txPos > txMax) return false; + return (uint8_t)(txMax - txPos) >= n; + } + + // ------------------------- + // Slot/thunk dispatch (no global self) + // ------------------------- + int8_t slot = -1; + static CanTransport* s_instances[TRANSPORT_CAN_MAX_INSTANCES]; + + static int8_t allocSlot(CanTransport *p); + + static void taskThunk(); + + static void onThunk0(uint8_t data[8], uint8_t len); + static void onThunk1(uint8_t data[8], uint8_t len); + static void onThunk2(uint8_t data[8], uint8_t len); + static void onThunk3(uint8_t data[8], uint8_t len); + static void onThunk4(uint8_t data[8], uint8_t len); + static void onThunk5(uint8_t data[8], uint8_t len); + static void onThunk6(uint8_t data[8], uint8_t len); + static void onThunk7(uint8_t data[8], uint8_t len); + + typedef void (*ThunkFn)(uint8_t data[8], uint8_t len); + static ThunkFn thunkForSlot(int8_t s); + + // ------------------------- + // IDs + // ------------------------- + const uint16_t reqId; + const uint16_t rspId; + const uint8_t opDualResponse; + + // ------------------------- + // Dual-cursor buffers + // RX: holds last request/response frame bytes for decoding + // TX: holds payload bytes (max 12) for encoding + // ------------------------- + uint8_t rxBuf[14] = {0}; + volatile uint8_t rxLen = 0; + volatile uint8_t rxPos = 0; + + uint8_t txBuf[12] = {0}; + static constexpr uint8_t txMax = 12; + volatile uint8_t txPos = 0; + + static constexpr int16_t NAN_SENTINEL = (int16_t)0x8000; + + // Per-instance scratch + uint8_t tidop = 0; + uint8_t opcode = 0; +}; + +#endif diff --git a/src/lib/canTransport/CanTransportClient.cpp b/src/lib/canTransport/CanTransportClient.cpp new file mode 100755 index 0000000..fe5ebb5 --- /dev/null +++ b/src/lib/canTransport/CanTransportClient.cpp @@ -0,0 +1,222 @@ +// ----------------------------------------------------------------------------------- +// CAN transport - Client +// ----------------------------------------------------------------------------------- + +#include "CanTransportClient.h" + +#if defined(CAN_PLUS) && CAN_PLUS != OFF + +#include + +bool CanTransportClient::init() { + if (!CanTransport::init()) return false; + + if (callbackRegistered) return true; + + if (canPlus.callbackRegisterId((int)responseCanId(), thunkForSlot(slot))) { + callbackRegistered = true; + } + + return callbackRegistered; +} + +// ----------------------------------------------------------------------------- +// Build request (TX cursor writes into base txBuf/txPos) +// ----------------------------------------------------------------------------- +bool CanTransportClient::beginNewRequest(uint8_t opCode) { + if (!canPlus.ready) return false; + + tid = (uint8_t)((tid + 1) & 0x07); + + opcode = (uint8_t)(opCode & 0x1F); + tidop = packTidOp(tid, opcode); + + // Use base TX buffer for request build + resetTx(); + + // First byte on wire is tidop + return writeU8(tidop); +} + +// ----------------------------------------------------------------------------- +// Unified transaction: chooses transact() vs transact2() based on opDualResponse +// On success sets RX cursor to payload start (rxPos=2). +// +// IMPORTANT: on failure, does NOT modify handled/suppressFrame/numericReply/commandError. +// ----------------------------------------------------------------------------- +bool CanTransportClient::transactRequest(bool &handled, bool &suppressFrame, bool &numericReply, CommandError &commandError) { + if (!canPlus.ready) return false; + + // Must have at least tidop written, and <= 8 total + if (txPos < 1 || txPos > 8) return false; + + const uint8_t op = unpackOp(tidop); + + // Build combined response directly into base rxBuf + uint8_t combinedLen = 0; + bool ok = false; + + if (op >= opDualResponse) { + memset(rxBuf, 0, sizeof(rxBuf)); + ok = transact2(tidop, txBuf, txPos, rxBuf, combinedLen); + } else { + memset(rxBuf, 0, 8); + ok = transact(tidop, txBuf, txPos, rxBuf, combinedLen); + } + + if (!ok) return false; + if (combinedLen < 2 || combinedLen > sizeof(rxBuf)) return false; + if (rxBuf[0] != tidop) return false; + + bool h = false; + bool sf = false; + bool nr = true; + CommandError ce = CE_NONE; + unpackStatus(rxBuf[1], h, sf, nr, ce); + + // Commit outputs only on success + handled = h; + suppressFrame = sf; + numericReply = nr; + commandError = ce; + + // Commit RX cursor for payload reads + rxLen = combinedLen; + rxPos = 2; + + return true; +} + +// ----------------------------------------------------------------------------- +// Single-frame transaction +// ----------------------------------------------------------------------------- +bool CanTransportClient::transact(uint8_t expectedTidOp, + const uint8_t *requestPayload, uint8_t requestLen, + uint8_t responsePayload[8], uint8_t &responseLen) { + responseLen = 0; + if (!canPlus.ready) return false; + if (!requestPayload || requestLen < 1 || requestLen > 8) return false; + if (!responsePayload) return false; + + rspMode = 1; + rspReady = false; + rspLenLatched = 0; + rspTidOpLatched = expectedTidOp; + + canPlus.txWait(); + if (!canPlus.writePacket((int)requestCanId(), requestPayload, requestLen)) { + rspMode = 0; + return false; + } + + const uint32_t startUs = micros(); + const uint32_t timeoutUs = (uint32_t)timeoutMs * 1000UL; + + while (!rspReady) { + canPlus.rxBurst(); + if ((uint32_t)(micros() - startUs) > timeoutUs) { + rspMode = 0; + return false; + } + tasks.yield(); + } + + responseLen = rspLenLatched; + memcpy(responsePayload, rspBuf, rspLenLatched); + + rspReady = false; + rspMode = 0; + + return (responseLen >= 2); +} + +// ----------------------------------------------------------------------------- +// Dual-frame transaction (waits for both frames) +// +// Combined buffer: +// [ tidop, status, payload0..., payload1... ] +// where payload0 = dlc0-2 bytes, payload1 = dlc1-2 bytes +// ----------------------------------------------------------------------------- +bool CanTransportClient::transact2(uint8_t expectedTidOp, + const uint8_t *requestPayload, uint8_t requestLen, + uint8_t responsePayload[14], uint8_t &responseLen) { + responseLen = 0; + if (!canPlus.ready) return false; + if (!requestPayload || requestLen < 1 || requestLen > 8) return false; + if (!responsePayload) return false; + + rspMode = 2; + + rspReady = false; + rspLenLatched = 0; + rspTidOpLatched = expectedTidOp; + + rsp1Ready = false; + rsp1LenLatched = 0; + rsp1TidOpLatched = tidopPlus1(expectedTidOp); + + canPlus.txWait(); + if (!canPlus.writePacket((int)requestCanId(), requestPayload, requestLen)) { + rspMode = 0; + return false; + } + + const uint32_t startUs = micros(); + const uint32_t timeoutUs = (uint32_t)timeoutMs * 1000UL; + + while (!(rspReady && rsp1Ready)) { + canPlus.rxBurst(); + if ((uint32_t)(micros() - startUs) > timeoutUs) { + rspMode = 0; + return false; + } + tasks.yield(); + } + + if (!(rspLenLatched >= 2 && rspLenLatched <= 8)) { rspMode = 0; return false; } + if (!(rsp1LenLatched >= 2 && rsp1LenLatched <= 8)) { rspMode = 0; return false; } + if (rspBuf[0] != expectedTidOp) { rspMode = 0; return false; } + if (rsp1Buf[0] != rsp1TidOpLatched) { rspMode = 0; return false; } + + const uint8_t d0 = (uint8_t)(rspLenLatched - 2); // 0..6 + const uint8_t d1 = (uint8_t)(rsp1LenLatched - 2); // 0..6 + + // Build combined: tidop/status from frame0, then payload0 + payload1 + responsePayload[0] = rspBuf[0]; + responsePayload[1] = rspBuf[1]; + + if (d0 > 0) memcpy(&responsePayload[2], &rspBuf[2], d0); + if (d1 > 0) memcpy(&responsePayload[2 + d0], &rsp1Buf[2], d1); + + responseLen = (uint8_t)(2 + d0 + d1); + + rspReady = false; + rsp1Ready = false; + rspMode = 0; + + return (responseLen >= 2); +} + +// ----------------------------------------------------------------------------- +// Response callback (invoked via onFrame()) +// ----------------------------------------------------------------------------- +void CanTransportClient::onResponse(const uint8_t data[8], uint8_t len) { + if (len > 8) len = 8; + if (len < 2) return; + + if (!rspReady && rspMode > 0 && data[0] == rspTidOpLatched) { + memcpy(rspBuf, data, len); + rspLenLatched = len; + rspReady = true; + return; + } + + if (!rsp1Ready && rspMode > 1 && data[0] == rsp1TidOpLatched) { + memcpy(rsp1Buf, data, len); + rsp1LenLatched = len; + rsp1Ready = true; + return; + } +} + +#endif diff --git a/src/lib/canTransport/CanTransportClient.h b/src/lib/canTransport/CanTransportClient.h new file mode 100755 index 0000000..69c3fca --- /dev/null +++ b/src/lib/canTransport/CanTransportClient.h @@ -0,0 +1,84 @@ +// ----------------------------------------------------------------------------------- +// CAN transport - Client (single/dual-frame request/response, 1 in-flight per instance) +// ----------------------------------------------------------------------------------- + +#pragma once + +#include "../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS != OFF + +#include "../tasks/OnTask.h" +#include "../canPlus/CanPlus.h" +#include "CanTransportBase.h" + +class CanTransportClient : public CanTransport { +public: + CanTransportClient(uint16_t requestId, uint16_t responseId, uint8_t dualFrameOpcodeStart = 32) + : CanTransport(requestId, responseId, dualFrameOpcodeStart) {} + + bool init(); + + // Changes timeout, default is 10ms + void setTimeoutMs(uint16_t ms) { timeoutMs = ms; } + +protected: + // Clients do NOT treat inbound frames as requests; they treat them as responses. + void onFrame(const uint8_t data[8], uint8_t len) override { onResponse(data, len); } + + // Start building a request frame using opCode (0..31). + // Resets TX cursor and writes tidop as the first byte. + bool beginNewRequest(uint8_t opCode); + + // Sends the request and waits for the reply. + // Auto-selects single/dual based on opcode >= opDualResponse. + // On success: + // rxLen/rxPos updated; rxPos=2 (payload start after tidop/status) + // readXXX() helpers read from rxBuf via rxPos + bool transactRequest(bool &handled, bool &suppressFrame, bool &numericReply, CommandError &commandError); + +private: + // Response callback invoked via onFrame(). + void onResponse(const uint8_t data[8], uint8_t len) override; + + // Send request and wait for correlated response (tidop match). + bool transact(uint8_t expectedTidOp, + const uint8_t *requestPayload, uint8_t requestLen, + uint8_t responsePayload[8], uint8_t &responseLen); + + // Send request and wait for two correlated responses (tidop and tidop+1 match). + bool transact2(uint8_t expectedTidOp, + const uint8_t *requestPayload, uint8_t requestLen, + uint8_t responsePayload[14], uint8_t &responseLen); + + static inline uint8_t tidopPlus1(uint8_t tidop) { + const uint8_t op = (uint8_t)(tidop & 0x1F); + const uint8_t tid = (uint8_t)((tidop >> 5) & 0x07); + const uint8_t tid1 = (uint8_t)((tid + 1) & 0x07); + return (uint8_t)((tid1 << 5) | op); + } + + uint16_t timeoutMs = 50; + + // Per-instance TID (3 bits). No global coupling. + uint8_t tid = 0; + + bool callbackRegistered = false; + + // in-flight request correlation mode: 0=idle, 1=single, 2=dual + volatile uint8_t rspMode = 0; + + // first in-flight response correlation + volatile bool rspReady = false; + volatile uint8_t rspLenLatched = 0; + volatile uint8_t rspTidOpLatched = 0; + uint8_t rspBuf[8] = {0}; + + // second in-flight response correlation + volatile bool rsp1Ready = false; + volatile uint8_t rsp1LenLatched = 0; + volatile uint8_t rsp1TidOpLatched = 0; + uint8_t rsp1Buf[8] = {0}; +}; + +#endif diff --git a/src/lib/canTransport/CanTransportServer.cpp b/src/lib/canTransport/CanTransportServer.cpp new file mode 100755 index 0000000..35285ca --- /dev/null +++ b/src/lib/canTransport/CanTransportServer.cpp @@ -0,0 +1,108 @@ +// ----------------------------------------------------------------------------------- +// CAN transport - Server +// ----------------------------------------------------------------------------------- + +#include "CanTransportServer.h" + +#if defined(CAN_PLUS) && CAN_PLUS != OFF + +bool CanTransportServer::init(bool startTask, uint16_t processPeriodMs) { + if (!CanTransport::init()) return false; + + // Register request callback for this CAN ID; thunk routes to onFrame() + if (!canPlus.callbackRegisterId((int)requestCanId(), thunkForSlot(slot))) return false; + + if (startTask) { + if (!tasks.add(processPeriodMs, 0, true, 5, &CanTransport::taskThunk, "CanTrS")) return false; + } + + return true; +} + +void CanTransportServer::onFrame(const uint8_t data[8], uint8_t len) { + enqueueFromCallback(data, len); +} + +void CanTransportServer::process() { + Frame f; + while (dequeue(f)) { + if (f.len < 1) continue; + + // Bind RX (copies into base rxBuf, sets tidop/opcode, sets rxPos=1) + beginNewRequest(f.data, f.len); + + // Fresh TX response (txPos=0) + beginNewResponse(); + + // Execute command in non-ISR context + processCommand(); + } +} + +void CanTransportServer::sendResponse(bool handled, bool suppressFrame, bool numericReply, CommandError commandError) { + const uint8_t status = packStatus(handled, suppressFrame, numericReply, commandError); + + // Payload bytes written so far (cap at txMax == 12) + uint8_t plen = txPos; + if (plen > txMax) plen = txMax; + + const bool dual = (opcode >= opDualResponse); + + // Single-frame mode: clamp payload to 6 + if (!dual && plen > 6) plen = 6; + + // ---------------- frame 0 ---------------- + uint8_t out0[8] = {0}; + out0[0] = tidop; + out0[1] = status; + + const uint8_t n0 = (plen > 6) ? 6 : plen; // 0..6 + for (uint8_t i = 0; i < n0; ++i) out0[2 + i] = txBuf[i]; + + const uint8_t out0Len = (uint8_t)(2 + n0); // 2..8 + canPlus.txWait(); + (void)canPlus.writePacket((int)responseCanId(), out0, out0Len); + + // ---------------- optional frame 1 ---------------- + if (dual) { + const uint8_t tidop1 = tidopPlus1(tidop); + + uint8_t out1[8] = {0}; + out1[0] = tidop1; + out1[1] = status; + + const uint8_t rem = (plen > 6) ? (uint8_t)(plen - 6) : 0; // 0..6 + const uint8_t n1 = (rem > 6) ? 6 : rem; // 0..6 + + for (uint8_t i = 0; i < n1; ++i) out1[2 + i] = txBuf[6 + i]; + + const uint8_t out1Len = (uint8_t)(2 + n1); // 2..8 (may be 2) + canPlus.txWait(); + (void)canPlus.writePacket((int)responseCanId(), out1, out1Len); + } +} + +void CanTransportServer::enqueueFromCallback(const uint8_t data[8], uint8_t len) { + if (len > 8) len = 8; + if (len < 1) return; + + const uint8_t head = qHead; + const uint8_t next = (uint8_t)((head + 1u) % (uint8_t)TRANSPORT_CAN_SERVER_RXQ); + if (next == qTail) return; // full, drop + + q[head].len = len; + for (uint8_t i = 0; i < len; i++) q[head].data[i] = data[i]; + + qHead = next; +} + +bool CanTransportServer::dequeue(Frame &out) { + const uint8_t tail = qTail; + if (tail == qHead) return false; + + out = q[tail]; + qTail = (uint8_t)((tail + 1u) % (uint8_t)TRANSPORT_CAN_SERVER_RXQ); + return true; +} + +#endif diff --git a/src/lib/canTransport/CanTransportServer.h b/src/lib/canTransport/CanTransportServer.h new file mode 100755 index 0000000..e1e68b6 --- /dev/null +++ b/src/lib/canTransport/CanTransportServer.h @@ -0,0 +1,67 @@ +// ----------------------------------------------------------------------------------- +// CAN transport - Server (ISR-safe enqueue; process() executes commands) +// +// Request: [ tidop, args... ] (1..8 bytes) +// Response0: [ tidop, status, payload0... ] (2..8 bytes) +// Response1: [ tidop+1, status, payload1... ] (2..8 bytes) // dual ops only +// +// Notes: +// - Uses global canPlus +// - ISR-safe: callback only enqueues; process() drains and calls processCommand() +// - process() binds RX via beginNewRequest() (args at rxPos=1) and starts a new TX response via beginNewResponse() +// - Dual-frame responses enabled when: opcode >= opDualResponse +// In dual mode, frame0 and frame1 are always sent, with DLC matching payload length +// ----------------------------------------------------------------------------------- + +#pragma once + +#include "../../Common.h" + +#if defined(CAN_PLUS) && CAN_PLUS != OFF + +#include "../tasks/OnTask.h" +#include "../canPlus/CanPlus.h" +#include "CanTransportBase.h" + +#ifndef TRANSPORT_CAN_SERVER_RXQ + #define TRANSPORT_CAN_SERVER_RXQ 16 +#endif + +class CanTransportServer : public CanTransport { +public: + CanTransportServer(uint16_t requestId, uint16_t responseId, uint8_t dualFrameOpcodeStart = 32) + : CanTransport(requestId, responseId, dualFrameOpcodeStart) {} + + bool init(bool startTask = true, uint16_t processPeriodMs = 2); + +protected: + // ISR ingress: enqueue only (do not execute command processing here) + void onFrame(const uint8_t data[8], uint8_t len) override; + + // Send response using current tidop (captured from the request frame). + // Uses TX payload bytes written so far (0..12) via txBuf/txPos in base. + void sendResponse(bool handled, bool suppressFrame, bool numericReply, CommandError commandError); + + void process() override; + +private: + struct Frame { + uint8_t len; + uint8_t data[8]; + }; + + void enqueueFromCallback(const uint8_t data[8], uint8_t len); + bool dequeue(Frame &out); + + static inline uint8_t tidopPlus1(uint8_t t) { + // increment TID (bits 7..5) modulo 8, opcode unchanged + return (uint8_t)(((t & 0xE0u) + 0x20u) | (t & 0x1Fu)); + } + + // RX queue (written from callback, drained in process()) + volatile uint8_t qHead = 0; + volatile uint8_t qTail = 0; + Frame q[TRANSPORT_CAN_SERVER_RXQ]; +}; + +#endif diff --git a/src/lib/commands/BufferCmds.cpp b/src/lib/commands/BufferCmds.cpp new file mode 100755 index 0000000..7311057 --- /dev/null +++ b/src/lib/commands/BufferCmds.cpp @@ -0,0 +1,100 @@ +// ----------------------------------------------------------------------------------- +// Command processing + +#include +#include "../Constants.h" +#include "BufferCmds.h" + +void Buffer::init(int mountType) { + this->mountType = mountType; +} + +bool Buffer::add(char c) { + // (chr)6 is a special status command for the LX200 protocol + if (c == (char)6 && cbp == 0) { + cb[0] = ':'; cb[1] = (char)6; + if (mountType == 3) cb[2] = 'A'; else cb[2] = 'P'; + cb[3] = 0; cbp = 3; c = '#'; + } + + // ignore spaces/lf/cr + if (c != (char)32 && c != (char)10 && c != (char)13 && c != (char)6) { + if (cbp > bufferSize-2) cbp = bufferSize - 2; + cb[cbp] = c; cbp++; cb[cbp] = (char)0; + } + + if (c == '#') { + // validate the command frame, normal command + if (!(cbp > 1) && ((cb[0] == ':') || (cb[0] == ';')) && (cb[cbp-1] == '#')) { flush(); return false; } + if (((cb[0] == ':') || (cb[0] == ';')) && (cb[1] == '#') && (cb[2] == 0)) { flush(); return false; } + + checksum = (cb[0] == ';'); + if (checksum) { + byte len = strlen(cb) - 1; + + // Minimum length for a valid command is 5 ';CCS#' + if (len < 5) { + flush(); + cb[0] = ':'; cb[1] = (char)6; cb[2] = '0'; cb[3] = '#'; cb[4] = 0; cbp = 4; + return true; + } + + // checksum the data, for example ";111111CCS#". I don't include the command frame in the checksum. The error response is a checksumed string "CK_FAILS#" to request re-transmit. + byte cks = 0; + for (int cksCount0 = 1; cksCount0 < len - 3; cksCount0++) { cks += cb[cksCount0]; } + + char chkSum[12]; + snprintf(chkSum, sizeof(chkSum), "%02X", cks); + + seq = cb[len - 1]; + if (!((chkSum[0] == cb[len - 3]) && (chkSum[1] == cb[len - 2]))) { + flush(); + cb[0] = ':'; cb[1] = (char)6; cb[2] = '0'; cb[3] = '#'; cb[4] = 0; + cbp = 4; + return true; + } + + // remove the sequence char and checksum from string + --len; --len; cb[--len] = 0; + } + + return true; + } else { + return false; + } +} + +char* Buffer::getCmd() { + // the command is either one or two chars in length + cmd[0] = 0; + memmove(cmd, (char *)&cb[1], 2); + cmd[2] = 0; + if (cmd[1] == '#' && cmd[2] == 0) cmd[1] = 0; + return cmd; +} + +char* Buffer::getParameter() { + // the remaining parameter + pb[0] = 0; + if (cbp > 4) memmove(pb, (char *)&cb[3], cbp-4); + pb[cbp-4] = 0; + return pb; +} + +char* Buffer::getSeq() { + static char s[2] = " "; + s[0] = seq; + return s; +} + +bool Buffer::ready() { + if (!cbp) return false; + if (cb[cbp-1] == '#' && cbp == 1) flush(); + return (cb[cbp-1] == '#'); +} + +bool Buffer::flush() { + cbp = 0; + cb[0] = (char)0; + return true; +} diff --git a/src/lib/commands/BufferCmds.h b/src/lib/commands/BufferCmds.h new file mode 100755 index 0000000..b2e4bd5 --- /dev/null +++ b/src/lib/commands/BufferCmds.h @@ -0,0 +1,30 @@ +// ----------------------------------------------------------------------------------- +// Command processing +#pragma once + +class Buffer { + public: + bool checksum = false; + + void init(int mountType); + + bool add(char c); + char* getCmd(); + char* getParameter(); + char* getSeq(); + bool ready(); + bool flush(); + + private: + int mountType = 0; + char channel; + char (*reader)(); + char (*writer)(char c); + + const static int bufferSize = 80; + char cmd[4] = ""; + char pb[bufferSize] = ""; + char cb[bufferSize] = ""; + int cbp = 0; + char seq = 0; +}; diff --git a/src/lib/commands/CommandErrors.h b/src/lib/commands/CommandErrors.h new file mode 100755 index 0000000..3f40289 --- /dev/null +++ b/src/lib/commands/CommandErrors.h @@ -0,0 +1,16 @@ +// ----------------------------------------------------------------------------------- +// Command processing errors +#pragma once + +typedef enum CommandError { + CE_NONE, CE_0, CE_CMD_UNKNOWN, CE_REPLY_UNKNOWN, CE_PARAM_RANGE, CE_PARAM_FORM, + CE_ALIGN_FAIL, CE_ALIGN_NOT_ACTIVE, CE_NOT_PARKED_OR_AT_HOME, CE_PARKED, + CE_PARK_FAILED, CE_NOT_PARKED, CE_NO_PARK_POSITION_SET, CE_GOTO_FAIL, CE_LIBRARY_FULL, + + // goto/guide errors + CE_SLEW_ERR_BELOW_HORIZON, CE_SLEW_ERR_ABOVE_OVERHEAD, CE_SLEW_ERR_IN_STANDBY, + CE_SLEW_ERR_IN_PARK, CE_SLEW_IN_SLEW, CE_SLEW_ERR_OUTSIDE_LIMITS, CE_SLEW_ERR_HARDWARE_FAULT, + CE_SLEW_IN_MOTION, CE_SLEW_ERR_UNSPECIFIED, + + CE_NULL, CE_1 +} CommandError; diff --git a/src/lib/commands/SerialWrapper.cpp b/src/lib/commands/SerialWrapper.cpp new file mode 100755 index 0000000..4eacede --- /dev/null +++ b/src/lib/commands/SerialWrapper.cpp @@ -0,0 +1,413 @@ +// ----------------------------------------------------------------------------------- +// SerialWrapper a single class to allow uniform access to other serial port classes + +#include "SerialWrapper.h" + +#if SERIAL_A == HardSerial + #undef SERIAL_A + HardwareSerial HWSerialA(SERIAL_A_RX, SERIAL_A_TX); + #define SERIAL_A HWSerialA + #define SERIAL_A_RXTX_SET +#endif + +#if SERIAL_B == HardSerial + #undef SERIAL_B + HardwareSerial HWSerialB(SERIAL_B_RX, SERIAL_B_TX); + #define SERIAL_B HWSerialB + #define SERIAL_B_RXTX_SET +#endif + +#if SERIAL_C == HardSerial + #undef SERIAL_C + HardwareSerial HWSerialC(SERIAL_C_RX, SERIAL_C_TX); + #define SERIAL_C HWSerialC + #define SERIAL_C_RXTX_SET +#endif + +#ifdef SERIAL_BT + BluetoothSerial bluetoothSerial; +#endif + +SerialWrapper::SerialWrapper() { + static uint8_t channel = 0; + #ifdef SERIAL_A + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_B + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_C + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_D + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_ST4 + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_BT + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_PIP1 + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_PIP2 + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_PIP3 + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_SIP + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + #ifdef SERIAL_LOCAL + if (!hasChannel(channel)) { thisChannel = channel; setChannel(channel); return; } + channel++; + #endif + UNUSED(channel); +} + +void SerialWrapper::begin() { begin(9600); } + +void SerialWrapper::begin(long baud) { + uint8_t channel = 0; + #ifdef SERIAL_A + if (isChannel(channel++)) + #if defined(SERIAL_A_RX) && defined(SERIAL_A_TX) && !defined(SERIAL_A_RXTX_SET) + SERIAL_A.begin(baud, SERIAL_8N1, SERIAL_A_RX, SERIAL_A_TX); + #else + SERIAL_A.begin(baud); + #endif + #endif + #ifdef SERIAL_B + if (isChannel(channel++)) + #if defined(SERIAL_B_RX) && defined(SERIAL_B_TX) && !defined(SERIAL_B_RXTX_SET) + SERIAL_B.begin(baud, SERIAL_8N1, SERIAL_B_RX, SERIAL_B_TX); + #else + SERIAL_B.begin(baud); + #endif + #endif + #ifdef SERIAL_C + if (isChannel(channel++)) + #if defined(SERIAL_C_RX) && defined(SERIAL_C_TX) && !defined(SERIAL_C_RXTX_SET) + SERIAL_C.begin(baud, SERIAL_8N1, SERIAL_C_RX, SERIAL_C_TX); + #else + SERIAL_C.begin(baud); + #endif + #endif + #ifdef SERIAL_D + if (isChannel(channel++)) + #if defined(SERIAL_D_RX) && defined(SERIAL_D_TX) && !defined(SERIAL_D_RXTX_SET) + SERIAL_D.begin(baud, SERIAL_8N1, SERIAL_D_RX, SERIAL_D_TX); + #else + SERIAL_D.begin(baud); + #endif + #endif + #ifdef SERIAL_ST4 + if (isChannel(channel++)) SERIAL_ST4.begin(baud); + #endif + #ifdef SERIAL_BT + //if (isChannel(channel++)) SERIAL_BT.begin(SERIAL_BT_NAME); // started early in .ino file + #endif + #ifdef SERIAL_PIP1 + if (isChannel(channel++)) SERIAL_PIP1.begin(9996, 10L*1000L, true); + #endif + #ifdef SERIAL_PIP2 + if (isChannel(channel++)) SERIAL_PIP2.begin(9997, 10L*1000L, true); + #endif + #ifdef SERIAL_PIP3 + if (isChannel(channel++)) SERIAL_PIP3.begin(9998, 10L*1000L, true); + #endif + #ifdef SERIAL_SIP + if (isChannel(channel++)) SERIAL_SIP.begin(9999, 10L*1000L, true); + #endif + #ifdef SERIAL_LOCAL + if (isChannel(channel++)) SERIAL_LOCAL.begin(baud); + #endif + UNUSED(baud); + UNUSED(channel); +} + +void SerialWrapper::end() { + uint8_t channel = 0; + #ifdef SERIAL_A + if (isChannel(channel++)) SERIAL_A.end(); + #endif + #ifdef SERIAL_B + if (isChannel(channel++)) SERIAL_B.end(); + #endif + #ifdef SERIAL_C + if (isChannel(channel++)) SERIAL_C.end(); + #endif + #ifdef SERIAL_D + if (isChannel(channel++)) SERIAL_D.end(); + #endif + #ifdef SERIAL_ST4 + if (isChannel(channel++)) SERIAL_ST4.end(); + #endif + #ifdef SERIAL_BT + if (isChannel(channel++)) SERIAL_BT.end(); + #endif + #ifdef SERIAL_PIP1 + if (isChannel(channel++)) SERIAL_PIP1.end(); + #endif + #ifdef SERIAL_PIP2 + if (isChannel(channel++)) SERIAL_PIP2.end(); + #endif + #ifdef SERIAL_PIP3 + if (isChannel(channel++)) SERIAL_PIP3.end(); + #endif + #ifdef SERIAL_SIP + if (isChannel(channel++)) SERIAL_SIP.end(); + #endif + #ifdef SERIAL_LOCAL + if (isChannel(channel++)) SERIAL_LOCAL.end(); + #endif + UNUSED(channel); +} + +size_t SerialWrapper::write(uint8_t data) { + uint8_t channel = 0; + #ifdef SERIAL_A + if (isChannel(channel++)) return SERIAL_A.write(data); + #endif + #ifdef SERIAL_B + if (isChannel(channel++)) return SERIAL_B.write(data); + #endif + #ifdef SERIAL_C + if (isChannel(channel++)) return SERIAL_C.write(data); + #endif + #ifdef SERIAL_D + if (isChannel(channel++)) return SERIAL_D.write(data); + #endif + #ifdef SERIAL_ST4 + if (isChannel(channel++)) return SERIAL_ST4.write(data); + #endif + #ifdef SERIAL_BT + if (isChannel(channel++)) return SERIAL_BT.write(data); + #endif + #ifdef SERIAL_PIP1 + if (isChannel(channel++)) return SERIAL_PIP1.write(data); + #endif + #ifdef SERIAL_PIP2 + if (isChannel(channel++)) return SERIAL_PIP2.write(data); + #endif + #ifdef SERIAL_PIP3 + if (isChannel(channel++)) return SERIAL_PIP3.write(data); + #endif + #ifdef SERIAL_SIP + if (isChannel(channel++)) return SERIAL_SIP.write(data); + #endif + #ifdef SERIAL_LOCAL + if (isChannel(channel++)) return SERIAL_LOCAL.write(data); + #endif + UNUSED(data); + UNUSED(channel); + return -1; +} + +size_t SerialWrapper::write(const uint8_t *data, size_t quantity) { + uint8_t channel = 0; + #ifdef SERIAL_A + if (isChannel(channel++)) return SERIAL_A.write(data, quantity); + #endif + #ifdef SERIAL_B + if (isChannel(channel++)) return SERIAL_B.write(data, quantity); + #endif + #ifdef SERIAL_C + if (isChannel(channel++)) return SERIAL_C.write(data, quantity); + #endif + #ifdef SERIAL_D + if (isChannel(channel++)) return SERIAL_D.write(data, quantity); + #endif + #ifdef SERIAL_ST4 + if (isChannel(channel++)) return SERIAL_ST4.write(data, quantity); + #endif + #ifdef SERIAL_BT + if (isChannel(channel++)) return SERIAL_BT.write(data, quantity); + #endif + #ifdef SERIAL_PIP1 + if (isChannel(channel++)) return SERIAL_PIP1.write(data, quantity); + #endif + #ifdef SERIAL_PIP2 + if (isChannel(channel++)) return SERIAL_PIP2.write(data, quantity); + #endif + #ifdef SERIAL_PIP3 + if (isChannel(channel++)) return SERIAL_PIP3.write(data, quantity); + #endif + #ifdef SERIAL_SIP + if (isChannel(channel++)) return SERIAL_SIP.write(data, quantity); + #endif + #ifdef SERIAL_LOCAL + if (isChannel(channel++)) return SERIAL_LOCAL.write(data, quantity); + #endif + UNUSED(data); + UNUSED(quantity); + UNUSED(channel); + return -1; +} + +int SerialWrapper::available() { + uint8_t channel = 0; + #ifdef SERIAL_A + if (isChannel(channel++)) return SERIAL_A.available(); + #endif + #ifdef SERIAL_B + if (isChannel(channel++)) return SERIAL_B.available(); + #endif + #ifdef SERIAL_C + if (isChannel(channel++)) return SERIAL_C.available(); + #endif + #ifdef SERIAL_D + if (isChannel(channel++)) return SERIAL_D.available(); + #endif + #ifdef SERIAL_ST4 + if (isChannel(channel++)) return SERIAL_ST4.available(); + #endif + #ifdef SERIAL_BT + if (isChannel(channel++)) return SERIAL_BT.available(); + #endif + #ifdef SERIAL_PIP1 + if (isChannel(channel++)) return SERIAL_PIP1.available(); + #endif + #ifdef SERIAL_PIP2 + if (isChannel(channel++)) return SERIAL_PIP2.available(); + #endif + #ifdef SERIAL_PIP3 + if (isChannel(channel++)) return SERIAL_PIP3.available(); + #endif + #ifdef SERIAL_SIP + if (isChannel(channel++)) return SERIAL_SIP.available(); + #endif + #ifdef SERIAL_LOCAL + if (isChannel(channel++)) return SERIAL_LOCAL.available(); + #endif + UNUSED(channel); + return 0; +} + +int SerialWrapper::read() { + uint8_t channel = 0; + #ifdef SERIAL_A + if (isChannel(channel++)) return SERIAL_A.read(); + #endif + #ifdef SERIAL_B + if (isChannel(channel++)) return SERIAL_B.read(); + #endif + #ifdef SERIAL_C + if (isChannel(channel++)) return SERIAL_C.read(); + #endif + #ifdef SERIAL_D + if (isChannel(channel++)) return SERIAL_D.read(); + #endif + #ifdef SERIAL_ST4 + if (isChannel(channel++)) return SERIAL_ST4.read(); + #endif + #ifdef SERIAL_BT + if (isChannel(channel++)) return SERIAL_BT.read(); + #endif + #ifdef SERIAL_PIP1 + if (isChannel(channel++)) return SERIAL_PIP1.read(); + #endif + #ifdef SERIAL_PIP2 + if (isChannel(channel++)) return SERIAL_PIP2.read(); + #endif + #ifdef SERIAL_PIP3 + if (isChannel(channel++)) return SERIAL_PIP3.read(); + #endif + #ifdef SERIAL_SIP + if (isChannel(channel++)) return SERIAL_SIP.read(); + #endif + #ifdef SERIAL_LOCAL + if (isChannel(channel++)) return SERIAL_LOCAL.read(); + #endif + UNUSED(channel); + return -1; +} + +int SerialWrapper::peek() { + uint8_t channel = 0; + #ifdef SERIAL_A + if (isChannel(channel++)) return SERIAL_A.peek(); + #endif + #ifdef SERIAL_B + if (isChannel(channel++)) return SERIAL_B.peek(); + #endif + #ifdef SERIAL_C + if (isChannel(channel++)) return SERIAL_C.peek(); + #endif + #ifdef SERIAL_D + if (isChannel(channel++)) return SERIAL_D.peek(); + #endif + #ifdef SERIAL_ST4 + if (isChannel(channel++)) return SERIAL_ST4.peek(); + #endif + #ifdef SERIAL_BT + if (isChannel(channel++)) return SERIAL_BT.peek(); + #endif + #ifdef SERIAL_PIP1 + if (isChannel(channel++)) return SERIAL_PIP1.peek(); + #endif + #ifdef SERIAL_PIP2 + if (isChannel(channel++)) return SERIAL_PIP2.peek(); + #endif + #ifdef SERIAL_PIP3 + if (isChannel(channel++)) return SERIAL_PIP3.peek(); + #endif + #ifdef SERIAL_SIP + if (isChannel(channel++)) return SERIAL_SIP.peek(); + #endif + #ifdef SERIAL_LOCAL + if (isChannel(channel++)) return SERIAL_LOCAL.peek(); + #endif + UNUSED(channel); + return -1; +} + +void SerialWrapper::flush() { + uint8_t channel = 0; + #ifdef SERIAL_A + if (isChannel(channel++)) SERIAL_A.flush(); + #endif + #ifdef SERIAL_B + if (isChannel(channel++)) SERIAL_B.flush(); + #endif + #ifdef SERIAL_C + if (isChannel(channel++)) SERIAL_C.flush(); + #endif + #ifdef SERIAL_D + if (isChannel(channel++)) SERIAL_D.flush(); + #endif + #ifdef SERIAL_ST4 + if (isChannel(channel++)) SERIAL_ST4.flush(); + #endif + #ifdef SERIAL_BT + if (isChannel(channel++)) SERIAL_BT.flush(); + #endif + #ifdef SERIAL_PIP1 + if (isChannel(channel++)) SERIAL_PIP1.flush(); + #endif + #ifdef SERIAL_PIP2 + if (isChannel(channel++)) SERIAL_PIP2.flush(); + #endif + #ifdef SERIAL_PIP3 + if (isChannel(channel++)) SERIAL_PIP3.flush(); + #endif + #ifdef SERIAL_SIP + if (isChannel(channel++)) SERIAL_SIP.flush(); + #endif + #ifdef SERIAL_LOCAL + if (isChannel(channel++)) SERIAL_LOCAL.flush(); + #endif + UNUSED(channel); +} diff --git a/src/lib/commands/SerialWrapper.h b/src/lib/commands/SerialWrapper.h new file mode 100755 index 0000000..8a802da --- /dev/null +++ b/src/lib/commands/SerialWrapper.h @@ -0,0 +1,50 @@ +// ----------------------------------------------------------------------------------- +// SerialWrapper a single class to allow uniform access to other serial port classes +#pragma once + +#include "../../Common.h" + +#include "../serial/Serial_IP_Wifi.h" +#include "../serial/Serial_IP_Ethernet.h" + +#ifdef MOUNT_PRESENT + #if ST4_INTERFACE == ON && ST4_HAND_CONTROL == ON + #include "../serial/Serial_ST4_Master.h" + #endif +#endif +#include "../serial/Serial_Local.h" + +static uint8_t _wrapper_channels = 0; + +#define isChannel(x) (x == thisChannel) + +class SerialWrapper : public Stream { + public: + SerialWrapper(); + + void begin(); + void begin(long baud); + + void end(); + + virtual size_t write(uint8_t); + virtual size_t write(const uint8_t *, size_t); + virtual int available(void); + virtual int read(void); + virtual int peek(void); + virtual void flush(void); + + inline size_t write(unsigned long n) { return write((uint8_t)n); } + inline size_t write(long n) { return write((uint8_t)n); } + inline size_t write(unsigned int n) { return write((uint8_t)n); } + inline size_t write(int n) { return write((uint8_t)n); } + + inline bool hasChannel(uint8_t channel) { return bitRead(_wrapper_channels, channel); } + inline void setChannel(uint8_t channel) { bitSet(_wrapper_channels, channel); } + inline void clrChannel(uint8_t channel) { bitClear(_wrapper_channels, channel); } + + using Print::write; + + private: + uint8_t thisChannel = 0; +}; diff --git a/src/lib/commands/commands.ino b/src/lib/commands/commands.ino new file mode 100755 index 0000000..0f91199 --- /dev/null +++ b/src/lib/commands/commands.ino @@ -0,0 +1,4 @@ +// Placeholder file +// Nothing to see here ... +// +// This file is only present so the Arduino IDE can edit the .h file(s) diff --git a/src/lib/convert/Convert.cpp b/src/lib/convert/Convert.cpp new file mode 100755 index 0000000..1f04773 --- /dev/null +++ b/src/lib/convert/Convert.cpp @@ -0,0 +1,339 @@ +//-------------------------------------------------------------------------------------------------- +// convert to/from C strings + +#include "../../Common.h" +#include "Convert.h" + +#if defined(ARDUINO_ARDUINO_NANO33BLE) || \ + defined(__TEENSYDUINO__) || \ + defined(ARDUINO_ARCH_SAMD) || \ + defined(ARDUINO_ARCH_MBED_RP2040) || \ + defined(ARDUINO_ARCH_RP2040) + void sprintF(char *result, const char *source, double f) { + sprintf(result, source, f); + } +#else + void sprintF(char *result, const char *source, double f) { + bool ok = false; + uint8_t mas = 0, frac = 0, len = 0; + char* a; + do { + a = (char*)strchr(source, '%'); + if (a == NULL) return; + // "%f" form + if (a[1] == 'f') { len = 2; ok = true; break; } + // "%.2f" form + if (a[1] == '.' && a[2] >= '0' && a[2] <= '9' && a[3] == 'f') { frac = a[2] - '0'; len = 4; ok = true; break; } + // "%1.2f" form + if (a[1] >= '0' && a[1] <= '9' && a[2] == '.' && a[3] >= '0' && a[3] <= '9' && a[4] == 'f') { + mas = a[1] - '0'; + frac = a[3] - '0'; + len = 5; + ok = true; + break; + } + } while (!ok); + + char s[20]; + dtostrf(f, mas, frac, s); + + uint8_t j = 0; + for (uint8_t i = 0; i < a - source; i++) result[j++] = source[i]; + for (uint8_t i = 0; i < strlen(s); i++) result[j++] = s[i]; + for (uint8_t i = len; i < strlen(a); i++) result[j++] = a[i]; + result[j++] = 0; + } +#endif + +bool Convert::tzToDouble(double *value, char *hm) { + int16_t sign = 1; + int16_t hour, minute = 0; + + if (strlen(hm) < 1 || strlen(hm) > 6) return false; + + // if there's a decimal part just convert it and return + if (strchr(hm, '.') != NULL) { return atof2(hm, value); } + + // determine if the sign was used, skip any '+' + if (hm[0] == '-') { sign = -1; hm++; } else if (hm[0] == '+') hm++; + + // if there's a minute part convert it and mark the end of the hours string + char* m = strchr(hm, ':'); + if (m != NULL) { + m[0] = 0; + m++; + if (strlen(m) != 1 && strlen(m) != 2) return false; + if (!atoi2(m, &minute, false)) return false; + // only these exact minutes are allowed for time zones + if (minute != 45 && minute != 30 && minute != 0) return false; + } + + if (!atoi2(hm, &hour, false)) return false; + *value = sign*(hour + minute/60.0); + + return true; +} + +bool Convert::hmsToDouble(double *value, char *hms, PrecisionMode p) { + char h[3], m[5]; + int16_t hour, minute, decimal = 0; + double second = 0; + + while (*hms == ' ') hms++; + + if (strlen(hms) > 13) hms[13] = 0; + int16_t length = strlen(hms); + + if (p == PM_HIGHEST || p == PM_HIGH) { if (length != 8 && length < 10) return false; } else + if (p == PM_LOW) { if (length != 7) return false; } + + // convert the hours part + h[0] = *hms++; h[1] = *hms++; h[2] = 0; + if (!atoi2(h, &hour, false)) return false; + + // make sure the seperator is an allowed character, then convert the minutes part + if (*hms++ != ':') return false; + m[0] = *hms++; m[1] = *hms++; m[2] = 0; + if (!atoi2(m, &minute, false)) return false; + + if (p == PM_HIGHEST || p == PM_HIGH) { + // make sure the seperator is an allowed character, then convert the seconds part + if (*hms++ != ':') return false; + if (!atof2(hms, &second, false)) return false; + } else + if (p == PM_LOW) { + // make sure the seperator is an allowed character, then convert the decimal minutes part + if (*hms++ != '.') return false; + decimal = (*hms++) - '0'; + } + + if (hour < 0 || hour > 23 || minute < 0 || minute > 59 || decimal < 0 || decimal > 9 || second < 0 || second > 59.9999) return false; + + *value = hour + minute/60.0 + (double)decimal/600.0 + second/3600.0; + return true; +} + +bool Convert::hmsToDouble(double *value, char *hms) { + if (!hmsToDouble(value, hms, PM_HIGHEST)) + if (!hmsToDouble(value, hms, PM_HIGH)) + if (!hmsToDouble(value, hms, PM_LOW)) return false; + return true; +} + +// convert string in format as follows to double (in degrees): +// sDD:MM PM_LOW +// DDD:MM PM_LOW +// sDD*MM PM_LOW +// DDD*MM PM_LOW +// sDD:MM:SS PM_HIGH +// DDD:MM:SS PM_HIGH +// sDD:MM:SS.SSS PM_HIGHEST +bool Convert::dmsToDouble(double *value, char *dms, bool signPresent, PrecisionMode p) { + char d[4], m[5]; + int16_t length; + int16_t sign = 1, deg, minute, lowLimit = 0, highLimit = 360; + double second = 0; + bool secondsOff = false; + + while (*dms == ' ') dms++; + if (strlen(dms) > 13) dms[13] = 0; + length = strlen(dms); + + if (p == PM_HIGHEST || p == PM_HIGH) { if (length != 9 && length < 11) return false; } else + if (p == PM_LOW) { + if (length == 6) secondsOff = true; else + if (length == 9) secondsOff = false; else return false; + } + + // determine if the sign was used and accept it if so, then convert the degrees part + if (signPresent) { + if (*dms == '-') sign = -1; else if (*dms != '+') return false; + dms++; d[0] = *dms++; d[1] = *dms++; d[2] = 0; + if (!atoi2(d, °, false)) return false; + } else { + d[0] = *dms++; d[1] = *dms++; d[2] = *dms++; d[3] = 0; + if (!atoi2(d, °, false)) return false; + } + + // make sure the seperator is an allowed character, then convert the minutes part + if (*dms != ':' && *dms != '*' && *dms != char(223)) return false; else dms++; + m[0] = *dms++; m[1] = *dms++; m[2] = 0; + if (!atoi2(m, &minute, false)) return false; + + if ((p == PM_HIGHEST || p == PM_HIGH) && !secondsOff) { + // make sure the seperator is an allowed character, then convert the seconds part + if (*dms++ != ':' && *dms++ != '\'') return false; + if (!atof2(dms, &second, false)) return false; + } + + if (signPresent) { lowLimit = -90; highLimit = 90; } + if (deg < lowLimit || deg > highLimit || minute < 0 || minute > 59 || second < 0 || second > 59.999) return false; + + *value = sign*(deg + minute/60.0 + second/3600.0); + return true; +} + +// convert string in format as follows to double (in degrees): +// sDD:MM PM_LOW +// DDD:MM PM_LOW +// sDD*MM PM_LOW +// DDD*MM PM_LOW +// sDD:MM:SS PM_HIGH +// DDD:MM:SS PM_HIGH +// sDD:MM:SS.SSS PM_HIGHEST +// automatically detects PrecisionMode +bool Convert::dmsToDouble(double *value, char *dms, bool signPresent) { + if (!dmsToDouble(value, dms, signPresent, PM_HIGHEST)) + if (!dmsToDouble(value, dms, signPresent, PM_HIGH)) + if (!dmsToDouble(value, dms, signPresent, PM_LOW)) return false; + return true; +} + +void Convert::doubleToHms(char *reply, double value, bool signPresent, PrecisionMode p) { + char sign[2] = ""; + double hour, minute, second, decimal = 0; + + // setup formatting, handle adding the sign + if (signPresent) { + if (value < 0) { value = -value; strcpy(sign, "-"); } else strcpy(sign, "+"); + } + + // round to 0.00005 second or 0.5 second, depending on precision mode + if (p == PM_HIGHEST) value += 0.0000000139; else value += 0.000139; + + hour = floor(value); + minute = (value - hour)*60.0; + second = (minute - floor(minute))*60.0; + + // finish off calculations for hms and form string template + char form[]="%s%02d:%02d:%02d.%04d"; + if (p == PM_HIGHEST) { decimal = (second - floor(second))*10000.0; } else + if (p == PM_HIGH) { form[16] = 0; } else + if (p == PM_LOW) { form[16] = 0; form[11] = '.'; form[14] = '1'; second = second/6.0; } else + if (p == PM_LOWEST) { form[11] = 0; second = 0; } + + // set sign and return result string + if (p == PM_HIGHEST) sprintf(reply, form, sign, (int)hour, (int)minute, (int)second, (int)decimal); else + if (p == PM_LOWEST) sprintf(reply, form, sign, (int)hour, (int)minute); else + sprintf(reply, form, sign, (int)hour, (int)minute, (int)second); +} + +// convert double (in degrees) to string in format as follows: +// sDD:MM PM_LOW +// DDD:MM PM_LOW +// sDD*MM PM_LOW +// DDD*MM PM_LOW +// DDD:MM:SS PM_HIGH +// sDD:MM:SS.SSS PM_HIGHEST +void Convert::doubleToDms(char *reply, double value, bool fullRange, bool signPresent, PrecisionMode p) { + char sign[2] = ""; + double deg, minute, second = 0, decimal = 0; + + // setup formatting, handle adding the sign + if (signPresent) { + if (value < 0) { value = -value; strcpy(sign, "-"); } else strcpy(sign, "+"); + } + + // round to 0.0005 arc-second or 0.5 arc-second, depending on precision mode + if (p == PM_HIGHEST) value += 0.000000139; else value += 0.000139; + + deg = floor(value); + minute = (value - deg)*60.0; + second = (minute - floor(minute))*60.0; + + // finish off calculations for dms and form string template + char form[]="%s%02d*%02d:%02d.%03d"; + if (p != PM_HIGHEST) form[16] = 0; else decimal = (second - floor(second))*1000.0; + if (p == PM_LOW) form[11] = 0; + if (fullRange) form[4] = '3'; + + // return result string + if (p == PM_HIGHEST) sprintf(reply, form, sign, (int)deg, (int)minute, (int)second, (int)decimal); else + if (p == PM_HIGH) sprintf(reply, form, sign, (int)deg, (int)minute, (int)second); else + if (p == PM_LOW) sprintf(reply, form, sign, (int)deg, (int)minute); +} + +bool Convert::atoi2(char *a, int16_t *i, bool sign) { + int16_t len = strlen(a); + if (len == 0 || len > 6) return false; + for (int l = 0; l < len; l++) { + if (l == 0 && (a[l] == '+' || a[l] == '-') && sign) continue; + if (a[l] < '0' || a[l] > '9') return false; + } + long l = atol(a); + if (l < -32767 || l > 32768) return false; + *i = l; + return true; +} + +bool Convert::atoi2(char *a, uint8_t *u, bool sign) { + int16_t i = *u; + bool result = atoi2(a, &i, sign); + if (i >= 0 && i <= 255) { *u = i; return result; } else return false; +} + +bool Convert::atof2(char *a, double *d, bool sign) { + int16_t dc = 0; + int16_t len = strlen(a); + for (int l = 0; l < len; l++) { + if (l == 0 && (a[l] == '+' || a[l] == '-') && sign) continue; + if (a[l] == '.') { if (dc == 0) { dc++; continue; } else return false; } + if (a[l] < '0' || a[l] > '9') return false; + } + *d = atof(a); + return true; +} + +void Convert::stripNumericStr(char* s, bool trailingDecimal) { + int pp = -1; + for (unsigned int p = 0; p < strlen(s); p++) if (s[p] == '.') { pp = p; break; } + if (pp != -1) { + int p; + for (p = strlen(s) - 1; p >= pp; p--) { + if (trailingDecimal && p - 1 > 0 && s[p] == '0' && s[p - 1] == '.') break; + if (s[p] != '0') break; + s[p] = 0; + } + if (s[p] == '.') s[p] = 0; + } + if (s[0] == '-' || s[0] == '+') { + while (s[1] == '0' && s[2] != '.' && strlen(s) > 2) memmove(&s[1], &s[2], strlen(s) - 1); + } else { + while (s[0] == '0' && s[1] != '.' && strlen(s) > 1) memmove(&s[0], &s[1], strlen(s)); + } +} + +uint8_t Convert::packSeconds(float t) { + float f = 10.0F; // default is 1 second + if (t <= 0.0162F) f = 0.0F; else // 0.0156 (1/64 second) (0) + if (t <= 0.0313F) f = 1.0F; else // 0.0313 (1/32 second) (1) + if (t <= 0.0625F) f = 2.0F; else // 0.0625 (1/16 second) (2) + if (t <= 1.0F) f = 2.0F + t*8.0F; else // 0.125 seconds to 1 seconds (2 to 10) + if (t <= 10.0F) f = 6.0F + t*4.0F; else // 0.25 seconds to 10 seconds (10 to 46) + if (t <= 30.0F) f = 26.0F + t*2.0F; else // 0.5 seconds to 30 seconds (46 to 86) + if (t <= 120.0F) f = 56.0F + t; else // 1 second to 120 seconds (86 to 176) + if (t <= 600.0F) f = 168.0F + t/15.0F; else // 15 seconds to 300 seconds (176 to 208) + if (t <= 3360.0F) f = 198.0F + t/60.0F; else // 1 minute to 56 minutes (208 to 254) + if (t <= 3600.0F) f = 255.0F; // 1 hour (255) + if (f < 0.0F) f = 0.0F; + if (f > 255.0F) f = 255.0F; + return lroundf(f); +} + +float Convert::unpackSeconds(uint8_t b) { + float f = 1.0; // default is 1 second + if (b == 0) f = 0.016125F; else // 0.0156 (1/64 second) (0) + if (b == 1) f = 0.03125F; else // 0.0313 (1/32 second) (1) + if (b == 2) f = 0.0625F; else // 0.0625 (1/16 second) (2) + if (b <= 10) f = (b - 2.0F)/8.0F; else // 0.125 seconds to 1 seconds (2 to 10) + if (b <= 46) f = (b - 6.0F)/4.0F; else // 0.25 seconds to 10 seconds (10 to 46) + if (b <= 86) f = (b - 26.0F)/2.0F; else // 0.5 seconds to 30 seconds (46 to 86) + if (b <= 176) f = (b - 56.0F); else // 1 second to 120 seconds (86 to 176) + if (b <= 208) f = (b - 168.0F)*15.0F; else // 15 seconds to 300 seconds (176 to 208) + if (b <= 254) f = (b - 198.0F)*60.0F; else // 1 minute to 56 minutes (208 to 254) + if (b == 255) f = 3600.0F; // 1 hour (255) + return f; +} + + +Convert convert; \ No newline at end of file diff --git a/src/lib/convert/Convert.h b/src/lib/convert/Convert.h new file mode 100755 index 0000000..9a5b85c --- /dev/null +++ b/src/lib/convert/Convert.h @@ -0,0 +1,94 @@ +//-------------------------------------------------------------------------------------------------- +// convert to/from C strings +#pragma once + +#include + +enum PrecisionMode {PM_LOWEST, PM_LOW, PM_HIGH, PM_HIGHEST, PM_UNKNOWN}; + +// sprintf like function for float type, limited to one parameter +extern void sprintF(char *result, const char *source, double f); + +class Convert { + public: + // convert timezone string sHH:MM to double (in hours): + // (also handles) sHH + bool tzToDouble(double *value, char *hm); + + // convert string in format as follows to double (in hours): + // HH:MM PM_LOWEST + // HH:MM.M PM_LOW + // HH:MM:SS PM_HIGH (DEFAULT) + // HH:MM:SS.SSSS PM_HIGHEST + bool hmsToDouble(double *value, char *hms, PrecisionMode p); + + // convert string in format as follows to double (in hours): + // HH:MM PM_LOWEST + // HH:MM.M PM_LOW + // HH:MM:SS PM_HIGH (DEFAULT) + // HH:MM:SS.SSSS PM_HIGHEST + // automatically detects PrecisionMode + bool hmsToDouble(double *value, char *hms); + + // convert string in format as follows to double (in degrees): + // sDD:MM PM_LOW + // DDD:MM PM_LOW + // sDD*MM PM_LOW + // DDD*MM PM_LOW + // sDD:MM:SS PM_HIGH + // DDD:MM:SS PM_HIGH + // sDD:MM:SS.SSS PM_HIGHEST + bool dmsToDouble(double *value, char *dms, bool signPresent, PrecisionMode p); + + // convert string in format as follows to double (in degrees): + // sDD:MM PM_LOW + // DDD:MM PM_LOW + // sDD*MM PM_LOW + // DDD*MM PM_LOW + // sDD:MM:SS PM_HIGH + // DDD:MM:SS PM_HIGH + // sDD:MM:SS.SSS PM_HIGHEST + // automatically detects PrecisionMode + bool dmsToDouble(double *value, char *dms, bool signPresent); + + // convert double (in hours) to string in format as follows: + // HH:MM PM_LOWEST + // HH:MM.M PM_LOW + // HH:MM:SS PM_HIGH, + // HH:MM:SS.SSSS PM_HIGHEST + void doubleToHms(char *reply, double value, bool signPresent, PrecisionMode p); + + // convert double (in degrees) to string in format as follows: + // sDD:MM PM_LOW + // DDD:MM PM_LOW + // sDD*MM PM_LOW + // DDD*MM PM_LOW + // DDD:MM:SS PM_HIGH + // sDD:MM:SS.SSS PM_HIGHEST + void doubleToDms(char *reply, double value, bool fullRange, bool signPresent, PrecisionMode p); + + // convert seconds with range from 1/16s to an hour into a packed byte + uint8_t packSeconds(float t); + + // convert a packed byte into seconds with range from 1/16s to an hour + float unpackSeconds(uint8_t b); + + // string to int with error checking + bool atoi2(char *a, int16_t *i, bool sign = true); + + // string to byte with error checking + bool atoi2(char *a, uint8_t *u, bool sign = true); + + // string to double with error checking + bool atof2(char *a, double *d, bool sign = true); + + // removes unnecessary digits from floating point numeric string + void stripNumericStr(char* s, bool trailingDecimal = false); + + PrecisionMode precision = PM_HIGH; + + private: + +}; + +extern Convert convert; \ No newline at end of file diff --git a/src/lib/debug/Debug.cpp b/src/lib/debug/Debug.cpp new file mode 100755 index 0000000..1078840 --- /dev/null +++ b/src/lib/debug/Debug.cpp @@ -0,0 +1,114 @@ +// Helper macros for debugging, with less typing + +#include "Debug.h" + +#if defined(DEBUG) && DEBUG != OFF + #if defined(REMOTE) && DEBUG == REMOTE + bool debugRemoteConnected = false; + void debugPrint(const char* s) { + char s1[255]; + sstrcpy(s1, s); + int length = strlen(s1); + for (unsigned int i = 0; i < length; i++) if (s1[i] == ' ') s1[i] = '_'; + SERIAL_ONSTEP.print(s1); + } + #endif + + #ifdef TASKS_PROFILER_ENABLE + #include "../tasks/OnTask.h" + + #warning "Warning: the OnTask PROFILER is for debugging only, there is siginficant overhead associated with enabling this feature." + #define PROFILER_VT100 ON + + char scale_unit(double *d) { + long v = labs(lround(*d)); + if (v > 999999) { *d /= 1000000.0; return 's'; } // s + if (v > 999) { *d /= 1000.0; return 'm'; } // ms + return 'u'; // us + } + + void profiler() { + char s[120]; + char aau = 'u'; char axu = 'u'; char rtu = 'u'; char rau = 'u'; char rxu = 'u'; + static int count; + static double AAA,AXA,RTT,RAA,RXA; + + static int handle = tasks.getFirstHandle(); + if (!handle) { + AAA /= count; AXA /= count; RAA /= count; RXA /= count; + aau = scale_unit(&AAA); + axu = scale_unit(&AXA); + rtu = scale_unit(&RTT); + rau = scale_unit(&RAA); + rxu = scale_unit(&RXA); + + snprintf(s, sizeof(s), " ----------- ------------ ---------- -------- ----------"); + SERIAL_DEBUG.print(s); Y; + SERIAL_DEBUG.println(); Y; + SERIAL_DEBUG.print("\x1b[K"); + + snprintf(s, sizeof(s), " avgd %5ld%cs avgd %4ld%cs totalled %4ld%cs avgd %4ld%cs avgd %4ld%cs", + lround(AAA), aau, lround(AXA), axu, lround(RTT), rtu, lround(RAA), rau, lround(RXA), rxu); Y; + + SERIAL_DEBUG.print(s); Y; + SERIAL_DEBUG.println(); Y; + SERIAL_DEBUG.print("\x1b[K"); + + count = 0; + handle = tasks.getFirstHandle(); + #if PROFILER_VT100 == ON + SERIAL_DEBUG.print("\x1b[J"); // clear to end of screen + SERIAL_DEBUG.print("\x1b[H"); // cursor to upper left + SERIAL_DEBUG.print("\x1b[K"); // clear to end of line + #endif + SERIAL_DEBUG.println(); Y; + SERIAL_DEBUG.print("\x1b[K"); + snprintf(s, sizeof(s), "Profiler %2d.%02d%s Task Profiler", 1, 0, "b"); + SERIAL_DEBUG.println(s); Y; + SERIAL_DEBUG.print("\x1b[K"); + SERIAL_DEBUG.println(); + SERIAL_DEBUG.print("\x1b[K"); + + AAA = 0; AXA = 0; RTT = 0; RAA = 0; RXA = 0; + } + + char *name = tasks.getNameStr(handle); + + if (!strstr(name, "Profilr")) { + char priority = tasks.getPriority(handle) + '0'; + + double AA = tasks.getArrivalAvg(handle); Y; + AAA += AA; + aau = scale_unit(&AA); + + double AX = tasks.getArrivalMax(handle); Y; + AXA += AX; + axu = scale_unit(&AX); + + double RT = tasks.getRuntimeTotal(handle); Y; + RTT += RT; + rtu = scale_unit(&RT); + + double RTcount = tasks.getRuntimeTotalCount(handle); Y; + double RA; + if (RTcount == 0) RA = 0; else RA = RT/RTcount; + RAA += RA; + rau = scale_unit(&RA); + + double RX = tasks.getRuntimeMax(handle); Y; + RXA += RX; + rxu = scale_unit(&RX); + + count++; + + snprintf(s, sizeof(s), "[%-9sP%c] arrive avg %5ld%cs, max ±%4ld%cs; run total %4ld%cs, avg %4ld%cs, max %4ld%cs", + name, priority, lround(AA), aau, lround(AX), axu, lround(RT), rtu, lround(RA), rau, lround(RX), rxu); Y; + + SERIAL_DEBUG.print(s); Y; + SERIAL_DEBUG.println(); + } + + handle = tasks.getNextHandle(handle); + } + #endif +#endif diff --git a/src/lib/debug/Debug.h b/src/lib/debug/Debug.h new file mode 100755 index 0000000..947fc25 --- /dev/null +++ b/src/lib/debug/Debug.h @@ -0,0 +1,51 @@ +// ----------------------------------------------------------------------------------- +// Helper macros for debugging, with less typing +#pragma once + +#include "../../Common.h" + +#if DEBUG == PROFILER + #define TASKS_PROFILER_ENABLE +#endif + +#if defined(DEBUG) && DEBUG != OFF && DEBUG != PROFILER + #if defined(REMOTE) && DEBUG == REMOTE + // echo strings to OnStep debug interface (supports embedded spaces and cr/lf) + extern void debugPrint(const char* s); + extern bool debugRemoteConnected; + + #define D(x) { if (debugRemoteConnected) { SERIAL_ONSTEP.print(":EC"); SERIAL_ONSTEP.print(x); SERIAL_ONSTEP.print("#"); delay(50); } } + #define DF(x) { if (debugRemoteConnected) { SERIAL_ONSTEP.print(":EC"); debugPrint(x); SERIAL_ONSTEP.print("#"); delay(50); } } + #define DL(x) { if (debugRemoteConnected) { SERIAL_ONSTEP.print(":EC"); SERIAL_ONSTEP.print(x); SERIAL_ONSTEP.print("&#"); delay(50); } } + #define DLF(x) { if (debugRemoteConnected) { SERIAL_ONSTEP.print(":EC"); debugPrint(x); SERIAL_ONSTEP.print("&#"); delay(50); } } + #else + #define D(x) SERIAL_DEBUG.print(x) + #define DF(x) SERIAL_DEBUG.print(F(x)) + #define DL(x) SERIAL_DEBUG.println(x) + #define DLF(x) SERIAL_DEBUG.println(F(x)) + #endif + #define D1(x) { static uint32_t t = 0; if (millis() > t + 1000UL) { D(x); t = millis(); } } + #define DL1(x) { static uint32_t t = 0; if (millis() > t + 1000UL) { DL(x); t = millis(); } } +#else + #define D(x) + #define DF(x) + #define DL(x) + #define D1(x) + #define DL1(x) + #define DLF(x) +#endif + +#if (defined(VERBOSE) && DEBUG == VERBOSE) || (defined(REMOTE) && DEBUG == REMOTE) + #define V(x) D(x) + #define V1(x) D1(x) + #define VF(x) DF(x) + #define VL(x) DL(x) + #define VL1(x) DL1(x) + #define VLF(x) DLF(x) +#else + #define V(x) + #define VF(x) + #define VL(x) + #define VL1(x) + #define VLF(x) +#endif diff --git a/src/lib/encoder/Encoder.h b/src/lib/encoder/Encoder.h new file mode 100755 index 0000000..2c16495 --- /dev/null +++ b/src/lib/encoder/Encoder.h @@ -0,0 +1,15 @@ +// general purpose encoder class +#pragma once + +#include "bissc/As37h39bb.h" +#include "bissc/Jtw24.h" +#include "bissc/Jtw26.h" +#include "bissc/Asc85.h" +#include "ktech/KTech.h" +#include "cwCcw/CwCcw.h" +#include "pulseDir/PulseDir.h" +#include "pulseOnly/PulseOnly.h" +#include "quadrature/Quadrature.h" +#include "quadratureEsp32/QuadratureEsp32.h" +#include "serialBridge/SerialBridge.h" +#include "virtualEnc/VirtualEnc.h" diff --git a/src/lib/encoder/EncoderBase.cpp b/src/lib/encoder/EncoderBase.cpp new file mode 100755 index 0000000..e974c68 --- /dev/null +++ b/src/lib/encoder/EncoderBase.cpp @@ -0,0 +1,228 @@ +// general purpose encoder class + +#include "EncoderBase.h" + +#if AXIS1_ENCODER != OFF || AXIS2_ENCODER != OFF || AXIS3_ENCODER != OFF || \ + AXIS4_ENCODER != OFF || AXIS5_ENCODER != OFF || AXIS6_ENCODER != OFF || \ + AXIS7_ENCODER != OFF || AXIS8_ENCODER != OFF || AXIS9_ENCODER != OFF + +#include "Arduino.h" +#include "../tasks/OnTask.h" + +Encoder *encoder[9]; + +void encoderCallback1() { encoder[0]->poll(); } +void encoderCallback2() { encoder[1]->poll(); } +void encoderCallback3() { encoder[2]->poll(); } +void encoderCallback4() { encoder[3]->poll(); } +void encoderCallback5() { encoder[4]->poll(); } +void encoderCallback6() { encoder[5]->poll(); } +void encoderCallback7() { encoder[6]->poll(); } +void encoderCallback8() { encoder[7]->poll(); } +void encoderCallback9() { encoder[8]->poll(); } + +// get device ready for use +bool Encoder::init() { + if (ready) return true; + if (axis < 1 || axis > 9) return false; + + encoder[axis - 1] = this; + + uint8_t taskHandle = 0; + VF("MSG: Encoder"); V(axis); VF(", start status monitor task... "); + + switch (axis) { + case 1: + taskHandle = tasks.add(1000, 0, true, 6, encoderCallback1, "encSta1"); + break; + case 2: + taskHandle = tasks.add(1000, 0, true, 6, encoderCallback2, "encSta2"); + break; + case 3: + taskHandle = tasks.add(1000, 0, true, 6, encoderCallback3, "encSta3"); + break; + case 4: + taskHandle = tasks.add(1000, 0, true, 6, encoderCallback4, "encSta4"); + break; + case 5: + taskHandle = tasks.add(1000, 0, true, 6, encoderCallback5, "encSta5"); + break; + case 6: + taskHandle = tasks.add(1000, 0, true, 6, encoderCallback6, "encSta6"); + break; + case 7: + taskHandle = tasks.add(1000, 0, true, 6, encoderCallback7, "encSta7"); + break; + case 8: + taskHandle = tasks.add(1000, 0, true, 6, encoderCallback8, "encSta8"); + break; + case 9: + taskHandle = tasks.add(1000, 0, true, 6, encoderCallback9, "encSta9"); + break; + } + + if (taskHandle) { VL("success"); } else { VLF("FAILED!"); return false; } + + #if ENCODER_FILTER > 0 + ticksToWait = halNsToTicks(ENCODER_FILTER); + if (ticksToWait > 0x7FFFFFFFUL) ticksToWait = 0x7FFFFFFFUL; + #endif + + #if ENCODER_VELOCITY == ON + velTicksPerSec = HAL_TICKS_PER_SECOND(); + + // Cache stop timeout (us) converted to ticks (avoids 64-bit math in readVelocityCps()) + uint64_t stopTicks64 = (uint64_t)ENCODER_VEL_STOP_US * (uint64_t)velTicksPerSec; + stopTicks64 = (stopTicks64 + 500000ULL) / 1000000ULL; // rounded divide by 1e6 + if (stopTicks64 > 0x7FFFFFFFULL) stopTicks64 = 0x7FFFFFFFULL; + velStopTicks = (uint32_t)stopTicks64; + + velLastEdgeTicks = 0; + velLastPeriodTicks = 0; + velLastDir = 0; + + velWinLastCount = (int32_t)count; + velWinLastUs = 0; + velBlendCps = NAN; + velHasEstimate = false; + #endif + + return true; +} + +float Encoder::readVelocityCps() { + #if ENCODER_VELOCITY != ON + return NAN; + #else + + // snapshot state (safe if velLast* can be updated from ISR) + uint32_t lastEdgeTicks, lastPeriodTicks; + int8_t dirSnap; + int32_t countSnap; + + noInterrupts(); + lastEdgeTicks = velLastEdgeTicks; + lastPeriodTicks = velLastPeriodTicks; + dirSnap = velLastDir; + countSnap = count; + interrupts(); + + // cached stop timeout (ticks) computed once in init() + const uint32_t nowTicks = HAL_FAST_TICKS(); + const uint32_t stopTicks = velStopTicks; + + const uint32_t ageTicks = nowTicks - lastEdgeTicks; + const bool stale = (lastEdgeTicks == 0) || (ageTicks > stopTicks); + + // (A) period/reciprocal estimate (best at low speed) + float v_per = NAN; + if (!stale && lastPeriodTicks != 0 && dirSnap != 0) { + v_per = (dirSnap > 0 ? 1.0F : -1.0F) * ((float)velTicksPerSec / (float)lastPeriodTicks); + } + + // (B) windowed count estimate (best at higher speed) + const uint32_t nowUs = micros(); + if (velWinLastUs == 0) { + velWinLastUs = nowUs; + velWinLastCount = countSnap; + + // if we already have a period estimate, expose it immediately (low-speed friendly) + if (!isnan(v_per)) { + velBlendCps = v_per; + velHasEstimate = true; + return velBlendCps; + } + + // otherwise: no usable estimate yet. + return NAN; + } + + const uint32_t dtUs = nowUs - velWinLastUs; + const int32_t dc = countSnap - velWinLastCount; + + if (dtUs >= (uint32_t)ENCODER_VEL_WINDOW_US) { + const float v_cnt = (dtUs != 0) ? (dc*(1000000.0F/(float)dtUs)) : 0.0F; + + // if period estimate is unavailable, do NOT bias toward 0; use v_cnt directly + if (isnan(v_per)) { + velBlendCps = v_cnt; + } else { + float a = fabsf((float)dc) / (float)ENCODER_VEL_BLEND_COUNTS; + if (a < 0.0F) a = 0.0F; + if (a > 1.0F) a = 1.0F; + velBlendCps = a * v_cnt + (1.0F - a) * v_per; + } + + velHasEstimate = true; + + // reset window + velWinLastUs = nowUs; + velWinLastCount = countSnap; + } else { + // before we've ever produced an estimate, allow v_per to seed velBlendCps + if (!velHasEstimate && !isnan(v_per)) { + velBlendCps = v_per; + velHasEstimate = true; + } + + // stop timeout means stop timeout (once we have any estimate) + if (velHasEstimate && stale) { + velBlendCps = 0.0F; + } + } + + return velBlendCps; + +#endif +} + +// update encoder status +void Encoder::poll() { + #if ENCODER_FILTER > 0 + noInterrupts(); + msNow += 1000; + interrupts(); + #endif + + // run once every 5 seconds + if (++tick % 5 == 0) { + + noInterrupts(); + uint32_t w = warn; + warn = 0; + uint32_t e = error; + error = 0; + interrupts(); + + totalWarningCount += w; + totalErrorCount += e; + + uint32_t errors = e; + #ifdef ENCODER_WARN_AS_ERROR + errors += w; + #endif + + // look at how often errors and warnings occur on a given axis + // VF("MSG: Encoder"); V(axis); VF(" status, errors="); V(totalErrorCount); VF(" warnings="); VL(totalWarningCount); + + if (errors > UINT16_MAX) errors = UINT16_MAX; + errorCount[errorCountIndex++ % 12] = errors; + + // sum the errors and set the error flag as required + errors = 0; + for (int i = 0; i < 12; i++) { errors += errorCount[i]; } + + errorState = errors > ENCODER_ERROR_COUNT_THRESHOLD; + + if (errorState != lastErrorState) { + if (errorState) { + DF("WRN: Encoder"); D(axis); DF(" errors, exceeded threshold/minute at "); DL(errors); + } else { + DF("MSG: Encoder"); D(axis); DF(" errors, within threshold/minute at "); DL(errors); + } + lastErrorState = errorState; + } + } +} + +#endif diff --git a/src/lib/encoder/EncoderBase.h b/src/lib/encoder/EncoderBase.h new file mode 100755 index 0000000..50b1826 --- /dev/null +++ b/src/lib/encoder/EncoderBase.h @@ -0,0 +1,292 @@ +// general purpose encoder class +#pragma once + +#include "../../Common.h" + +#include + +// -------------------------------------------------------------------------------------------------------- + +#ifndef ENCODER_VELOCITY + #define ENCODER_VELOCITY OFF +#endif + +#if ENCODER_VELOCITY == ON + + // ENCODER_VEL_WINDOW_US: + // Window length for dc/dt estimate (microseconds). Smaller = more responsive/noisier + // larger = smoother/more lag. Typical: 5000–20000 us for 100–1000 Hz control loops + #ifndef ENCODER_VEL_WINDOW_US + #define ENCODER_VEL_WINDOW_US 10000UL // default 10ms (10000UL) + #endif + + // ENCODER_VEL_STOP_US: + // If no new edges/deltas occur for this long, velocity is forced to 0 + // If velocity drops to 0 at very slow tracking/creep speeds, increase this + // Typical: 300000 us (0.3s) up to 2000000 us (2s) for very low counts/sec systems + #ifndef ENCODER_VEL_STOP_US + #define ENCODER_VEL_STOP_US 300000UL // 0.3s (300000UL) + #endif + + // ENCODER_VEL_BLEND_COUNTS: + // Blend point between period (t/d) and windowed (d/t) estimates + // Larger values favor period estimate longer (better at low counts/sec) + // Typical: 4–12 counts + #ifndef ENCODER_VEL_BLEND_COUNTS + #define ENCODER_VEL_BLEND_COUNTS 4.0F // 4 counts (4.0F) + #endif + + // -------------------------------------------------------------------------- + // An example for very low count systems (copy/paste into your Config.h to override): + // + // #define ENCODER_VEL_WINDOW_US 20000UL // 20ms smoother + // #define ENCODER_VEL_STOP_US 1000000UL // 1.0s avoid false “stops” + // #define ENCODER_VEL_BLEND_COUNTS 8.0F // rely on period estimate longer + // -------------------------------------------------------------------------- + +#endif + +// ENCODER_ERROR_COUNT_THRESHOLD: +// allow up to 20 errors per minute before throwing a fault +#ifndef ENCODER_ERROR_COUNT_THRESHOLD + #define ENCODER_ERROR_COUNT_THRESHOLD 20 // 20 errors (20) +#endif + +// OFF is disabled, ON disregards unexpected quadrature encoder signals, or +// a value > 0 (nanoseconds) disregards repeat signal events for that timer period +#ifndef ENCODER_FILTER + #define ENCODER_FILTER OFF +#endif + +// these should allow time for an encoder signal to stabalize +#if ENCODER_FILTER > 0 + // once a signal state changes don't allow the ISR to run again for ENCODER_FILTER nanoseconds + #define ENCODER_FILTER_UNTIL() do { \ + const uint32_t _msNow = (uint32_t)msNow; \ + if ((int32_t)(_msNow - ticksInvalidMillis) >= 0) { ticksNext = 0; } \ + const uint32_t _ticksNow = HAL_FAST_TICKS(); \ + if (ticksNext && (int32_t)(_ticksNow - ticksNext) < 0) return; \ + ticksNext = _ticksNow + ticksToWait; \ + ticksInvalidMillis = _msNow + 2000U; \ + } while (0) +#endif + +// signal mode for pulse and cw/ccw encoders, default RISING or CHANGE or FALLING +// quadrature encoders ignore this and use CHANGE +#ifndef ENCODER_SIGNAL_MODE + #define ENCODER_SIGNAL_MODE RISING +#endif + +// -------------------------------------------------------------------------------------------------------- + +#ifndef AXIS1_ENCODER + #define AXIS1_ENCODER OFF +#endif +#ifndef AXIS2_ENCODER + #define AXIS2_ENCODER OFF +#endif +#ifndef AXIS3_ENCODER + #define AXIS3_ENCODER OFF +#endif +#ifndef AXIS4_ENCODER + #define AXIS4_ENCODER OFF +#endif +#ifndef AXIS5_ENCODER + #define AXIS5_ENCODER OFF +#endif +#ifndef AXIS6_ENCODER + #define AXIS6_ENCODER OFF +#endif +#ifndef AXIS7_ENCODER + #define AXIS7_ENCODER OFF +#endif +#ifndef AXIS8_ENCODER + #define AXIS8_ENCODER OFF +#endif +#ifndef AXIS9_ENCODER + #define AXIS9_ENCODER OFF +#endif + +#if AXIS1_ENCODER == AS37_H39B_B || AXIS2_ENCODER == AS37_H39B_B + #define HAS_AS37_H39B_B +#endif + +#if AXIS1_ENCODER == LIKA_ASC85 || AXIS2_ENCODER == LIKA_ASC85 + #define HAS_LIKA_ASC85 +#endif + +#if AXIS1_ENCODER == JTW_24BIT || AXIS2_ENCODER == JTW_24BIT + #define HAS_JTW_24BIT +#endif + +#if AXIS1_ENCODER == JTW_26BIT || AXIS2_ENCODER == JTW_26BIT + #define HAS_JTW_26BIT +#endif + +#if defined(HAS_AS37_H39B_B) || defined(HAS_LIKA_ASC85) || defined(HAS_JTW_24BIT) || defined(HAS_JTW_26BIT) + #define HAS_BISS_C +#endif + +#if AXIS1_ENCODER != OFF || AXIS2_ENCODER != OFF || AXIS3_ENCODER != OFF || \ + AXIS4_ENCODER != OFF || AXIS5_ENCODER != OFF || AXIS6_ENCODER != OFF || \ + AXIS7_ENCODER != OFF || AXIS8_ENCODER != OFF || AXIS9_ENCODER != OFF + +class Encoder { + public: + // get device ready for use + virtual bool init(); + + // true when this encoder can report absolute position after boot + virtual bool isAbsolute() const { return false; } + + // set encoder origin + virtual void setOrigin(int32_t counts) { origin = counts; } + + // get current position + virtual int32_t read() { return 0; } + + // set current position + virtual void write(int32_t position) { UNUSED(position); } + + // set the virtual encoder velocity in counts per second + virtual void setVelocity(float countsPerSec) { UNUSED(countsPerSec); } + + // fast, control-grade velocity + virtual float readVelocityCps(); + + // set the virtual encoder direction (-1 is reverse, 1 is forward) + virtual void setDirection(volatile int8_t *direction) { UNUSED(direction); } + + // check error state + virtual bool errorThresholdExceeded() { return errorState; } + + // update encoder status + void poll(); + + // total number of errors + uint32_t totalErrorCount = 0; + + // total number of warnings + uint32_t totalWarningCount = 0; + + // true if encoder count is ready + bool ready = false; + + // true if this is a virtual encoder + bool isVirtual = false; + + // raw count as last read (includes origin for absolute encoders) + volatile int32_t count = 0; + + // raw index as last set + volatile int32_t index = 0; + + // raw origin as last set (for absolute encoders) + uint32_t origin = 0; + + // for encoders with slow readout, available before init()/ready()/hardware detection + virtual bool supportsTimeAlignedMotorSteps() const { return false; } + inline bool hasMotorStepsAtLastRead() const { return hasMotorStepsAtLastReadValue; } + inline long motorStepsAtLastRead() const { return motorStepsAtLastReadValue; } + inline void setMotorStepsPtr(volatile long* p) { motorStepsPtr = p; } + + protected: + #if ENCODER_VELOCITY == ON + inline void IRAM_ATTR velNoteEdge(int8_t dir) { + const uint32_t now = HAL_FAST_TICKS(); + const uint32_t prev = velLastEdgeTicks; + velLastEdgeTicks = now; + velLastDir = dir; + if (prev != 0) velLastPeriodTicks = now - prev; + } + + inline void velNoteDelta(int32_t dc, uint32_t dtUs) { + if (dc == 0 || dtUs == 0) return; + + const uint32_t nowTicks = HAL_FAST_TICKS(); + const uint32_t tps = velTicksPerSec; + const uint32_t absdc = (dc > 0) ? (uint32_t)dc : (uint32_t)(-dc); + + uint64_t dtTicks = (uint64_t)dtUs * (uint64_t)tps; + dtTicks = (dtTicks + 500000ULL) / 1000000ULL; + + uint32_t perTicks = (uint32_t)((dtTicks + (absdc/2)) / absdc); + if (perTicks == 0) perTicks = 1; + + noInterrupts(); + velLastEdgeTicks = nowTicks; + velLastPeriodTicks = perTicks; + velLastDir = (dc > 0) ? 1 : -1; + interrupts(); + } + + // Feed velocity estimator from sampled count reads (for devices without edge ISR info) + // Note: pass raw encoder count (pre-index) to avoid velocity spikes on write()/index changes + inline void velNoteSampledCount(int32_t rawCount) { + const uint32_t nowUs = micros(); + + if (!velSampleInit) { + velSampleInit = true; + velSampleLastCount = rawCount; + velSampleLastUs = nowUs; + return; + } + + const uint32_t dtUs = nowUs - velSampleLastUs; + const int32_t dc = rawCount - velSampleLastCount; + + velSampleLastCount = rawCount; + velSampleLastUs = nowUs; + + if (dc != 0 && dtUs != 0) velNoteDelta(dc, dtUs); + } + + bool velHasEstimate = false; + bool velSampleInit = false; + int32_t velSampleLastCount = 0; + uint32_t velSampleLastUs = 0; + uint32_t velStopTicks = 0; + + volatile uint32_t velLastEdgeTicks = 0; + volatile uint32_t velLastPeriodTicks = 0; + volatile int8_t velLastDir = 0; + uint32_t velTicksPerSec = 1000000UL; + + int32_t velWinLastCount = 0; + uint32_t velWinLastUs = 0; + float velBlendCps = 0.0F; + #endif + + // axis number from 1 to 9 + int16_t axis = 0; + + // accumulator for warning detection + volatile uint32_t warn = 0; + + // accumulator for error detection + volatile uint32_t error = 0; + + // number of errors over the last minute + uint16_t errorCount[12] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}; + + // keep track of the error state + bool errorState = false; + bool lastErrorState = false; + uint16_t tick = UINT16_MAX; + uint16_t errorCountIndex = UINT16_MAX; + + #if ENCODER_FILTER > 0 + // approximate time keeping for filtering + volatile uint32_t msNow = 0; + volatile uint32_t ticksNext = 0; + volatile uint32_t ticksToWait = 0; + volatile uint32_t ticksInvalidMillis = 0; + #endif + + // for encoders with slow readout + volatile bool hasMotorStepsAtLastReadValue = false; + volatile long motorStepsAtLastReadValue = 0; + volatile long * volatile motorStepsPtr = nullptr; +}; + +#endif diff --git a/src/lib/encoder/bissc/As37h39bb.cpp b/src/lib/encoder/bissc/As37h39bb.cpp new file mode 100755 index 0000000..2bab5d5 --- /dev/null +++ b/src/lib/encoder/bissc/As37h39bb.cpp @@ -0,0 +1,48 @@ +// Broadcom AS37-H39B-B BISS-C encoders + +#include "As37h39bb.h" + +#ifdef HAS_AS37_H39B_B + +#include + +// initialize BiSS-C encoder +As37h39bb::As37h39bb(int16_t axis, int16_t maPin, int16_t sloPin) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + + this->maPin = maPin; + this->sloPin = sloPin; + + snprintf(encoderName, sizeof(encoderName), "AS37_H39B_B Ax%d", axis); + encoderBits = 23; + encoderMultiTurnBits = 16; + encoderErrInvert = false; +} + +// Designed according protocol description found in as38-H39e-b-an100.pdf and +// Renishaw application note E201D02_02 + +// BiSS-C 6-bit CRC of 41 bit data (16 multi-turn + 23 position + 2 err/wrn) +uint8_t As37h39bb::crc6(uint64_t data) { + uint8_t crc; + uint64_t idx; + idx = ((data >> 36) & 0b011111); + crc = ((data >> 30) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 24) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 18) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 12) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 6) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = (data & 0b111111); + idx = crc ^ CRC6[idx]; + crc = CRC6[idx]; + return (~crc & 0b111111); +} + +#endif diff --git a/src/lib/encoder/bissc/As37h39bb.h b/src/lib/encoder/bissc/As37h39bb.h new file mode 100755 index 0000000..a188368 --- /dev/null +++ b/src/lib/encoder/bissc/As37h39bb.h @@ -0,0 +1,30 @@ +// Broadcom AS37-H39B-B BISS-C encoders +#pragma once + +#include "Bissc.h" + +#ifdef HAS_AS37_H39B_B + + class As37h39bb : public Bissc { + public: + // initialize BiSS-C encoder + As37h39bb(int16_t axis, int16_t maPin, int16_t sloPin); + + private: + + // BiSS-C 6-bit CRC of 41 bit data (16 multi-turn + 23 position + 2 err/wrn) + uint8_t crc6(uint64_t data); + + // BiSS-C 6-bit CRC table (x^6 + x^1 + 1) + uint8_t CRC6[64] = { + 0x00, 0x03, 0x06, 0x05, 0x0C, 0x0F, 0x0A, 0x09, + 0x18, 0x1B, 0x1E, 0x1D, 0x14, 0x17, 0x12, 0x11, + 0x30, 0x33, 0x36, 0x35, 0x3C, 0x3F, 0x3A, 0x39, + 0x28, 0x2B, 0x2E, 0x2D, 0x24, 0x27, 0x22, 0x21, + 0x23, 0x20, 0x25, 0x26, 0x2F, 0x2C, 0x29, 0x2A, + 0x3B, 0x38, 0x3D, 0x3E, 0x37, 0x34, 0x31, 0x32, + 0x13, 0x10, 0x15, 0x16, 0x1F, 0x1C, 0x19, 0x1A, + 0x0B, 0x08, 0x0D, 0x0E, 0x07, 0x04, 0x01, 0x02}; + }; + +#endif diff --git a/src/lib/encoder/bissc/Asc85.cpp b/src/lib/encoder/bissc/Asc85.cpp new file mode 100755 index 0000000..a029e6b --- /dev/null +++ b/src/lib/encoder/bissc/Asc85.cpp @@ -0,0 +1,43 @@ +// Lika ASC85 25 BIT BISS-C encoder + +#include "Asc85.h" + +#ifdef HAS_LIKA_ASC85 + +#include + +// initialize BiSS-C encoder +LikaAsc85::LikaAsc85(int16_t axis, int16_t maPin, int16_t sloPin) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + + this->maPin = maPin; + this->sloPin = sloPin; + + snprintf(encoderName, sizeof(encoderName), "LIKA_ASC85 Ax%d", axis); + encoderBits = 25; + encoderMultiTurnBits = 0; +} + +// Designed according protocol description found in as38-H39e-b-an100.pdf and +// Renishaw application note E201D02_02 + +// BiSS-C 6-bit CRC of 27 bit data (25 position + 2 err/wrn) +uint8_t LikaAsc85::crc6(uint64_t data) { + uint8_t crc; + uint64_t idx; + idx = ((data >> 24) & 0b000111); + crc = ((data >> 18) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 12) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 6) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = (data & 0b111111); + idx = crc ^ CRC6[idx]; + crc = CRC6[idx]; + return (~crc & 0b111111); +} + +#endif diff --git a/src/lib/encoder/bissc/Asc85.h b/src/lib/encoder/bissc/Asc85.h new file mode 100755 index 0000000..70f7df8 --- /dev/null +++ b/src/lib/encoder/bissc/Asc85.h @@ -0,0 +1,30 @@ +// Lika ASC85 25 BIT BISS-C encoder +#pragma once + +#include "Bissc.h" + +#ifdef HAS_LIKA_ASC85 + + class LikaAsc85 : public Bissc { + public: + // initialize BiSS-C encoder + LikaAsc85(int16_t axis, int16_t maPin, int16_t sloPin); + + private: + + // BiSS-C 6-bit CRC of 27 bit data (25 position + 2 err/wrn) + uint8_t crc6(uint64_t data); + + // BiSS-C 6-bit CRC table (x^6 + x^1 + 1) + uint8_t CRC6[64] = { + 0x00, 0x03, 0x06, 0x05, 0x0C, 0x0F, 0x0A, 0x09, + 0x18, 0x1B, 0x1E, 0x1D, 0x14, 0x17, 0x12, 0x11, + 0x30, 0x33, 0x36, 0x35, 0x3C, 0x3F, 0x3A, 0x39, + 0x28, 0x2B, 0x2E, 0x2D, 0x24, 0x27, 0x22, 0x21, + 0x23, 0x20, 0x25, 0x26, 0x2F, 0x2C, 0x29, 0x2A, + 0x3B, 0x38, 0x3D, 0x3E, 0x37, 0x34, 0x31, 0x32, + 0x13, 0x10, 0x15, 0x16, 0x1F, 0x1C, 0x19, 0x1A, + 0x0B, 0x08, 0x0D, 0x0E, 0x07, 0x04, 0x01, 0x02}; + }; + +#endif diff --git a/src/lib/encoder/bissc/Bissc.cpp b/src/lib/encoder/bissc/Bissc.cpp new file mode 100755 index 0000000..8a6eb9d --- /dev/null +++ b/src/lib/encoder/bissc/Bissc.cpp @@ -0,0 +1,284 @@ +// BISS-C encoders + +#include "Bissc.h" + +#ifdef HAS_BISS_C + +#if BISSC_SAMPLE_IN_LOW_PHASE == ON + #define BISSC_SAMPLE_LOW_AND_READ(sampleAction) \ + delayNanoseconds(tSample); \ + sampleAction; \ + delayNanoseconds(rate - tSample); \ + digitalWriteF(maPin, HIGH_MA); \ + delayNanoseconds(rate) +#else + #define BISSC_SAMPLE_LOW_AND_READ(sampleAction) \ + delayNanoseconds(rate - tSample); \ + digitalWriteF(maPin, HIGH_MA); \ + delayNanoseconds(tSample); \ + sampleAction; \ + delayNanoseconds(rate - tSample) +#endif + +// get device ready for use +bool Bissc::init() { + if (ready) return true; + if (!Encoder::init()) return false; + if (encoderBits < 8 || encoderBits > 31) return false; + + pinMode(maPin, OUTPUT); + digitalWriteF(maPin, LOW); + pinMode(sloPin, INPUT_PULLUP); + + // get the counts/mask ready + encoderCounts = (uint32_t)(1UL << encoderBits); + encoderHalfCounts = (int32_t)(encoderCounts >> 1); + + const uint8_t lowTurnBits = (encoderBits >= 32) ? 0 : (uint8_t)(32U - encoderBits); + encoderMultiTurnMask = (lowTurnBits >= 32) ? 0xFFFFFFFFUL : ((1UL << lowTurnBits) - 1UL); + + VF("MSG: Encoder "); V(encoderName); VLF(", confirming attempt 1..."); + + // see if the encoder is there + uint32_t temp; + if (!getCount(temp)) { + VF("MSG: Encoder "); V(encoderName); VLF(", confirming attempt 2..."); + if (!getCount(temp)) { + VF("MSG: Encoder "); V(encoderName); VLF(", confirming attempt 3..."); + if (!getCount(temp)) return false; + } + } + + VF("MSG: Encoder "); V(encoderName); VLF(", confirmation success"); + + ready = true; + return true; +} + +// set encoder origin +void Bissc::setOrigin(int32_t counts) { + if (!ready) { DF("WRN: Encoder "); V(encoderName); DLF(", setOrigin(); failed not ready"); return; } + + // origin must always remains in the of range +/- encoderCounts/2 which is the + // normalized absolute encoder range (prior to applying the origin and any index) + if (counts < -encoderHalfCounts || counts >= encoderHalfCounts) { + DF("WRN: Encoder "); V(encoderName); DLF(", setOrigin(); failed counts out of range"); return; + } + + const int32_t temp = index; + index = 0; + origin = 0; + + VLF("----------------------------------------------------------------------------------------"); + VF("MSG: Encoder "); V(encoderName); VLF(", >>> with the mount in the home position <<<"); + VF("MSG: Encoder "); V(encoderName); VF(", if used AXIS"); V(axis); VF("_ENCODER_OFFSET in counts should be set to "); VL(-read()); + origin = counts; + + VF("MSG: Encoder "); V(encoderName); + uint32_t currentCounts; + if (getCount(currentCounts)) { + VF(", counts at home should be 0 and currently are "); VL((int32_t)currentCounts); + } else { + VLF(", getCount read FAILED!"); + } + VLF("----------------------------------------------------------------------------------------"); + + index = temp; +} + +// read encoder position +int32_t Bissc::read() { + if (!ready) return 0; + + int32_t newCount = getCountWithErrorRecovery(); + + if (newCount != INT32_MAX) return newCount + index; else return INT32_MAX; +} + +// write encoder position +void Bissc::write(int32_t position) { + if (!ready) return; + + if (position != INT32_MAX) { + int32_t newCount; + newCount = getCountWithErrorRecovery(true); + if (newCount == INT32_MAX) { + error = ENCODER_ERROR_COUNT_THRESHOLD + 1; + return; + } + + index = position - newCount; + } +} + +// read encoder count with 1 second error recovery +// returns encoder count or INT32_MAX on error +int32_t Bissc::getCountWithErrorRecovery(bool immediate) { + const unsigned long now = millis(); + if (immediate || now - lastValidTime > 2) { + uint32_t newCount = 0; + if (getCount(newCount)) { + lastValidTime = now; + lastValidCount = newCount; + + #if ENCODER_VELOCITY == ON + velNoteSampledCount((int32_t)newCount); + #endif + + } else { + if (now - lastValidTime > 1000U) lastValidCount = INT32_MAX; + } + } + + return lastValidCount; +} + +// get encoder count relative to origin +bool Bissc::getCount(uint32_t &count) { + + // prepare for a reading + foundAck = false; + foundStart = false; + foundCds = false; + + nErr = 1; + nWrn = 1; + frameCrc = 0; + + turns = 0; + count = 0; + + #ifdef ESP32 + static portMUX_TYPE bisscMutex = portMUX_INITIALIZER_UNLOCKED; + taskENTER_CRITICAL(&bisscMutex); + #else + noInterrupts(); + #endif + + getCountBitBang(count); + + #ifdef ESP32 + taskEXIT_CRITICAL(&bisscMutex); + #else + interrupts(); + #endif + + // trap errors + int16_t errors = 0; + + uint64_t encData = (uint64_t)count | ((uint64_t)turns << encoderBits); + encData = (encData << 1) | nErr; + encData = (encData << 1) | nWrn; + if (foundAck && foundStart && foundCds) { + if (crc6(encData) == frameCrc) { + if (encoderWrnInvert ? !nWrn : nWrn) { + D1("WRN: Encoder "); D1(encoderName); DL1(", Warn bit set"); + warn++; + } + if (encoderErrInvert ? !nErr : nErr) { + D1("WRN: Encoder "); D1(encoderName); DL1(", Error bit set"); + errors++; + } else + good++; + } else { + bad++; + #if DEBUG != OFF + float goodBadRatio = (float)bad/(good + bad); + D1("WRN: Encoder "); D1(encoderName); D1(", Crc invalid (overall "); D1(goodBadRatio*100.0F); D1("%"); DL1(")"); + #endif + errors++; + } + } else { + D1("WRN: Encoder "); D1(encoderName); + if (!foundAck) { D1(", Ack"); } else + if (!foundStart) { D1(", Start"); } else + if (!foundCds) { D1(", Cds"); } else + { DL1(" bit invalid"); } + errors++; + } + + if (errors > 0) { + error++; + return false; + } + + #if BISSC_SINGLE_TURN != ON + // combine absolute and low order bits of multi-turn count for a 32 bit count + count = count | ((turns & encoderMultiTurnMask) << encoderBits); + #endif + + // apply origin + count += origin; + + // center count about the +/- half counts range (a signed value stored unsigned) + // note: instead shifts an multiTurn count but for historical reasons thats preferred + count = count - (encoderCounts >> 1); + + #ifdef BISSC_RESOLUTION_DIVISOR + count = (int32_t)count/(int32_t)(BISSC_RESOLUTION_DIVISOR); + #endif + + return true; +} + +IRAM_ATTR void Bissc::getCountBitBang(uint32_t &count) { + + // sync phase + for (int i = 0; i < BISSC_SYNC_PHASE; i++) { + digitalWriteF(maPin, LOW_MA); + BISSC_SAMPLE_LOW_AND_READ(if (digitalReadF(sloPin) == LOW_SLO) foundAck = true); + if (foundAck) break; + } + + // if we have an Ack + if (foundAck) { + for (int i = 0; i < BISSC_ACK_PHASE; i++) { + digitalWriteF(maPin, LOW_MA); + BISSC_SAMPLE_LOW_AND_READ(if (digitalReadF(sloPin) == HIGH_SLO) foundStart = true); + if (foundStart) break; + } + + // if we have an Start + if (foundStart) { + digitalWriteF(maPin, LOW_MA); + BISSC_SAMPLE_LOW_AND_READ(if (digitalReadF(sloPin) == LOW_SLO) foundCds = true); + + // if we have an Cds, read the data + if (foundCds) { + + // the first n bits are the multi-turn count + for (int i = 1; i <= encoderMultiTurnBits; i++) { + digitalWriteF(maPin, LOW_MA); + BISSC_SAMPLE_LOW_AND_READ(if (digitalReadF(sloPin) == HIGH_SLO) bitSet(turns, encoderMultiTurnBits - i)); + } + + // the next n bits are the encoder absolute count + for (int i = 1; i <= encoderBits; i++) { + digitalWriteF(maPin, LOW_MA); + BISSC_SAMPLE_LOW_AND_READ(if (digitalReadF(sloPin) == HIGH_SLO) bitSet(count, encoderBits - i)); + } + + // the Err bit + digitalWriteF(maPin, LOW_MA); + BISSC_SAMPLE_LOW_AND_READ(nErr = (digitalReadF(sloPin) == HIGH_SLO)); + + // the Wrn bit + digitalWriteF(maPin, LOW_MA); + BISSC_SAMPLE_LOW_AND_READ(nWrn = (digitalReadF(sloPin) == HIGH_SLO)); + + // the last 6 bits are the CRC + for (int i = 0; i < 6; i++) { + digitalWriteF(maPin, LOW_MA); + BISSC_SAMPLE_LOW_AND_READ(if (digitalReadF(sloPin) == HIGH_SLO) bitSet(frameCrc, 5 - i)); + } + } + } + } + + // send a CDM (invert) + digitalWriteF(maPin, LOW_MA); + delayNanoseconds(rate*4); + digitalWriteF(maPin, HIGH_MA); +} + +#endif diff --git a/src/lib/encoder/bissc/Bissc.h b/src/lib/encoder/bissc/Bissc.h new file mode 100755 index 0000000..0991d64 --- /dev/null +++ b/src/lib/encoder/bissc/Bissc.h @@ -0,0 +1,137 @@ +// BISS-C encoders +#pragma once + +#include "../EncoderBase.h" + +#ifdef HAS_BISS_C + + // designed according protocol description found in as38-H39e-b-an100.pdf + + // similar broadcom devices have range of 10MHz to 80 KHz + #ifndef BISSC_CLOCK_RATE_KHZ + #define BISSC_CLOCK_RATE_KHZ 4000 + #endif + + // default to single turn mode + #ifndef BISSC_SINGLE_TURN + #define BISSC_SINGLE_TURN ON + #endif + + // default sync phase + #ifndef BISSC_SYNC_PHASE + #define BISSC_SYNC_PHASE 20 + #endif + + // default ack phase + #ifndef BISSC_ACK_PHASE + #define BISSC_ACK_PHASE 20 + #endif + + // sample during the low phase after LOW_MA + #ifndef BISSC_SAMPLE_IN_LOW_PHASE + #define BISSC_SAMPLE_IN_LOW_PHASE ON + #endif + + // sample during the high phase after HIGH_MA + #ifndef BISSC_SAMPLE_IN_HIGH_PHASE + #define BISSC_SAMPLE_IN_HIGH_PHASE OFF + #endif + + // sample point within the selected half-clock phase, in quarter-cycle steps (2 is mid-cycle and default) + #ifndef BISSC_TSAMPLE_QUARTERS + #define BISSC_TSAMPLE_QUARTERS 2 + #endif + + #if BISSC_SAMPLE_IN_LOW_PHASE == BISSC_SAMPLE_IN_HIGH_PHASE + #error "Configuration (Config.h): Set exactly one of BISSC_SAMPLE_IN_LOW_PHASE or BISSC_SAMPLE_IN_HIGH_PHASE to ON" + #endif + #if BISSC_TSAMPLE_QUARTERS < 1 + #error "Configuration (Config.h): BISSC_TSAMPLE_QUARTERS must be >= 1" + #endif + #if BISSC_TSAMPLE_QUARTERS > 3 + #error "Configuration (Config.h): BISSC_TSAMPLE_QUARTERS must be between 1 and 3" + #endif + + // resolution adjustment use 2, 4, or 8 (example:) + //#define BISSC_RESOLUTION_DIVISOR 4 + + // allow for inverting the signal state to fix incorrect wiring if needed + #ifndef HIGH_SLO + #define HIGH_SLO HIGH + #endif + #ifndef LOW_SLO + #define LOW_SLO LOW + #endif + #ifndef HIGH_MA + #define HIGH_MA HIGH + #endif + #ifndef LOW_MA + #define LOW_MA LOW + #endif + + class Bissc : public Encoder { + public: + // get device ready for use + bool init(); + + bool isAbsolute() const override { return true; } + + // set encoder origin + void setOrigin(int32_t counts); + + // read encoder position + int32_t read(); + + // write encoder position + void write(int32_t position); + + protected: + // read encoder count with 1 second error recovery + // returns encoder count or INT32_MAX on error + int32_t getCountWithErrorRecovery(bool immediate = false); + + // read encoder count + bool getCount(uint32_t &count); + + // low level bitbang read encoder count + IRAM_ATTR void getCountBitBang(uint32_t &count); + + // the custom crc routine + virtual uint8_t crc6(uint64_t data) = 0; + + bool foundAck = false; + bool foundStart = false; + bool foundCds = false; + + uint8_t nErr = 1; + uint8_t nWrn = 1; + uint8_t frameCrc = 0; + + uint32_t turns = 0; + + // this design allows for 8 to 31 bit encoders + char encoderName[16] = {0}; + uint8_t encoderBits = 0; + uint32_t encoderCounts = 0; + int32_t encoderHalfCounts = 0; + uint8_t encoderMultiTurnBits = 0; + uint32_t encoderMultiTurnMask = 0; + bool encoderWrnInvert = true; + bool encoderErrInvert = true; + + uint32_t good = 0; + uint32_t bad = 0; + uint16_t nvAddress = 0; + + // bit delay in nanoseconds + const uint32_t rate = 500000/BISSC_CLOCK_RATE_KHZ; + const uint32_t tSample = (rate*BISSC_TSAMPLE_QUARTERS)/4; + + int16_t maPin; + int16_t sloPin; + + uint32_t lastValidTime = 0; + int32_t lastValidCount = 0; + }; + +#endif diff --git a/src/lib/encoder/bissc/Jtw24.cpp b/src/lib/encoder/bissc/Jtw24.cpp new file mode 100755 index 0000000..1948082 --- /dev/null +++ b/src/lib/encoder/bissc/Jtw24.cpp @@ -0,0 +1,45 @@ +// JTW 24 BIT BISS-C encoders + +#include "Jtw24.h" + +#ifdef HAS_JTW_24BIT + +#define ENC_BISSC_NAME "JTW24" + +#include + +// initialize BiSS-C encoder +Jtw24::Jtw24(int16_t axis, int16_t maPin, int16_t sloPin) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + + this->maPin = maPin; + this->sloPin = sloPin; + + snprintf(encoderName, sizeof(encoderName), "JTW_24BIT Ax%d", axis); + encoderBits = 24; + encoderMultiTurnBits = 0; +} + +// Designed according protocol description found in as38-H39e-b-an100.pdf and +// Renishaw application note E201D02_02 + +// BiSS-C 6-bit CRC of 26 bit data (24 position + 2 err/wrn) +uint8_t Jtw24::crc6(uint64_t data) { + uint8_t crc; + uint64_t idx; + idx = ((data >> 24) & 0b000011); + crc = ((data >> 18) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 12) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 6) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = (data & 0b111111); + idx = crc ^ CRC6[idx]; + crc = CRC6[idx]; + return (~crc & 0b111111); +} + +#endif diff --git a/src/lib/encoder/bissc/Jtw24.h b/src/lib/encoder/bissc/Jtw24.h new file mode 100755 index 0000000..7d35817 --- /dev/null +++ b/src/lib/encoder/bissc/Jtw24.h @@ -0,0 +1,30 @@ +// JTW 24 BIT BISS-C encoders +#pragma once + +#include "Bissc.h" + +#ifdef HAS_JTW_24BIT + + class Jtw24 : public Bissc { + public: + // initialize BiSS-C encoder + Jtw24(int16_t axis, int16_t maPin, int16_t sloPin); + + private: + + // BiSS-C 6-bit CRC of 26 bit data (24 position + 2 err/wrn) + uint8_t crc6(uint64_t data); + + // BiSS-C 6-bit CRC table (x^6 + x^1 + 1) + uint8_t CRC6[64] = { + 0x00, 0x03, 0x06, 0x05, 0x0C, 0x0F, 0x0A, 0x09, + 0x18, 0x1B, 0x1E, 0x1D, 0x14, 0x17, 0x12, 0x11, + 0x30, 0x33, 0x36, 0x35, 0x3C, 0x3F, 0x3A, 0x39, + 0x28, 0x2B, 0x2E, 0x2D, 0x24, 0x27, 0x22, 0x21, + 0x23, 0x20, 0x25, 0x26, 0x2F, 0x2C, 0x29, 0x2A, + 0x3B, 0x38, 0x3D, 0x3E, 0x37, 0x34, 0x31, 0x32, + 0x13, 0x10, 0x15, 0x16, 0x1F, 0x1C, 0x19, 0x1A, + 0x0B, 0x08, 0x0D, 0x0E, 0x07, 0x04, 0x01, 0x02}; + }; + +#endif diff --git a/src/lib/encoder/bissc/Jtw26.cpp b/src/lib/encoder/bissc/Jtw26.cpp new file mode 100755 index 0000000..ee80da5 --- /dev/null +++ b/src/lib/encoder/bissc/Jtw26.cpp @@ -0,0 +1,45 @@ +// JTW 26 BIT BISS-C encoders + +#include "Jtw26.h" + +#ifdef HAS_JTW_26BIT + +#define ENC_BISSC_NAME "JTW26" + +#include + +// initialize BiSS-C encoder +Jtw26::Jtw26(int16_t axis, int16_t maPin, int16_t sloPin) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + + this->maPin = maPin; + this->sloPin = sloPin; + + snprintf(encoderName, sizeof(encoderName), "JTW_26BIT Ax%d", axis); + encoderBits = 26; + encoderMultiTurnBits = 0; +} + +// Designed according protocol description found in as38-H39e-b-an100.pdf and +// Renishaw application note E201D02_02 + +// BiSS-C 6-bit CRC of 28 bit data (26 position + 2 err/wrn) +uint8_t Jtw26::crc6(uint64_t data) { + uint8_t crc; + uint64_t idx; + idx = ((data >> 24) & 0b001111); + crc = ((data >> 18) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 12) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = ((data >> 6) & 0b111111); + idx = crc ^ CRC6[idx]; + crc = (data & 0b111111); + idx = crc ^ CRC6[idx]; + crc = CRC6[idx]; + return (~crc & 0b111111); +} + +#endif diff --git a/src/lib/encoder/bissc/Jtw26.h b/src/lib/encoder/bissc/Jtw26.h new file mode 100755 index 0000000..513918a --- /dev/null +++ b/src/lib/encoder/bissc/Jtw26.h @@ -0,0 +1,30 @@ +// JTW 26 BIT BISS-C encoders +#pragma once + +#include "Bissc.h" + +#ifdef HAS_JTW_26BIT + + class Jtw26 : public Bissc { + public: + // initialize BiSS-C encoder + Jtw26(int16_t axis, int16_t maPin, int16_t sloPin); + + private: + + // BiSS-C 6-bit CRC of 50 bit data (24 multi-turn + 24 position + 2 err/wrn) + uint8_t crc6(uint64_t data); + + // BiSS-C 6-bit CRC table (x^6 + x^1 + 1) + uint8_t CRC6[64] = { + 0x00, 0x03, 0x06, 0x05, 0x0C, 0x0F, 0x0A, 0x09, + 0x18, 0x1B, 0x1E, 0x1D, 0x14, 0x17, 0x12, 0x11, + 0x30, 0x33, 0x36, 0x35, 0x3C, 0x3F, 0x3A, 0x39, + 0x28, 0x2B, 0x2E, 0x2D, 0x24, 0x27, 0x22, 0x21, + 0x23, 0x20, 0x25, 0x26, 0x2F, 0x2C, 0x29, 0x2A, + 0x3B, 0x38, 0x3D, 0x3E, 0x37, 0x34, 0x31, 0x32, + 0x13, 0x10, 0x15, 0x16, 0x1F, 0x1C, 0x19, 0x1A, + 0x0B, 0x08, 0x0D, 0x0E, 0x07, 0x04, 0x01, 0x02}; + }; + +#endif diff --git a/src/lib/encoder/cwCcw/CwCcw.cpp b/src/lib/encoder/cwCcw/CwCcw.cpp new file mode 100755 index 0000000..6182caa --- /dev/null +++ b/src/lib/encoder/cwCcw/CwCcw.cpp @@ -0,0 +1,180 @@ +// CW/CCW encoders + +#include "CwCcw.h" + +#if AXIS1_ENCODER == CW_CCW || AXIS2_ENCODER == CW_CCW || AXIS3_ENCODER == CW_CCW || \ + AXIS4_ENCODER == CW_CCW || AXIS5_ENCODER == CW_CCW || AXIS6_ENCODER == CW_CCW || \ + AXIS7_ENCODER == CW_CCW || AXIS8_ENCODER == CW_CCW || AXIS9_ENCODER == CW_CCW + +CwCcw *cwCcwInstance[9]; + +#if AXIS1_ENCODER == CW_CCW + IRAM_ATTR void cwCcw_A_Axis1() { cwCcwInstance[0]->cw(); } + IRAM_ATTR void cwCcw_B_Axis1() { cwCcwInstance[0]->ccw(); } +#endif + +#if AXIS2_ENCODER == CW_CCW + IRAM_ATTR void cwCcw_A_Axis2() { cwCcwInstance[1]->cw();} + IRAM_ATTR void cwCcw_B_Axis2() { cwCcwInstance[1]->ccw(); } +#endif + +#if AXIS3_ENCODER == CW_CCW + IRAM_ATTR void cwCcw_A_Axis3() { cwCcwInstance[2]->cw(); } + IRAM_ATTR void cwCcw_B_Axis3() { cwCcwInstance[2]->ccw(); } +#endif + +#if AXIS4_ENCODER == CW_CCW + IRAM_ATTR void cwCcw_A_Axis4() { cwCcwInstance[3]->cw(); } + IRAM_ATTR void cwCcw_B_Axis4() { cwCcwInstance[3]->ccw(); } +#endif + +#if AXIS5_ENCODER == CW_CCW + IRAM_ATTR void cwCcw_A_Axis5() { cwCcwInstance[4]->cw(); } + IRAM_ATTR void cwCcw_B_Axis5() { cwCcwInstance[4]->ccw(); } +#endif + +#if AXIS6_ENCODER == CW_CCW + IRAM_ATTR void cwCcw_A_Axis6() { cwCcwInstance[5]->cw(); } + IRAM_ATTR void cwCcw_B_Axis6() { cwCcwInstance[5]->ccw(); } +#endif + +#if AXIS7_ENCODER == CW_CCW + IRAM_ATTR void cwCcw_A_Axis7() { cwCcwInstance[6]->cw(); } + IRAM_ATTR void cwCcw_B_Axis7() { cwCcwInstance[6]->ccw(); } +#endif + +#if AXIS8_ENCODER == CW_CCW + IRAM_ATTR void cwCcw_A_Axis8() { cwCcwInstance[7]->cw(); } + IRAM_ATTR void cwCcw_B_Axis8() { cwCcwInstance[7]->ccw(); } +#endif + +#if AXIS9_ENCODER == CW_CCW + IRAM_ATTR void cwCcw_A_Axis9() { cwCcwInstance[8]->cw(); } + IRAM_ATTR void cwCcw_B_Axis9() { cwCcwInstance[8]->ccw(); } +#endif + +CwCcw::CwCcw(int16_t axis, int16_t cwPin, int16_t ccwPin) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + axis_index = axis - 1; + + CwPin = cwPin; + CcwPin = ccwPin; + + cwCcwInstance[axis_index] = this; +} + +bool CwCcw::init() { + if (ready) return true; + if (!Encoder::init()) return false; + + pinMode(CwPin, INPUT_PULLUP); + pinMode(CcwPin, INPUT_PULLUP); + + int cwPin = digitalPinToInterrupt(CwPin); + int ccwPin = digitalPinToInterrupt(CcwPin); + + if (cwPin < 0 || ccwPin < 0) { + DF("ERR: Encoder CwCcw"); D(axis); DLF(" init(), couldn't attach interrupt!"); + return false; + } + + switch (axis) { + #if AXIS1_ENCODER == CW_CCW + case 1: + attachInterrupt(cwPin, cwCcw_A_Axis1, ENCODER_SIGNAL_MODE); + attachInterrupt(ccwPin, cwCcw_B_Axis1, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS2_ENCODER == CW_CCW + case 2: + attachInterrupt(cwPin, cwCcw_A_Axis2, ENCODER_SIGNAL_MODE); + attachInterrupt(ccwPin, cwCcw_B_Axis2, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS3_ENCODER == CW_CCW + case 3: + attachInterrupt(cwPin, cwCcw_A_Axis3, ENCODER_SIGNAL_MODE); + attachInterrupt(ccwPin, cwCcw_B_Axis3, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS4_ENCODER == CW_CCW + case 4: + attachInterrupt(cwPin, cwCcw_A_Axis4, ENCODER_SIGNAL_MODE); + attachInterrupt(ccwPin, cwCcw_B_Axis4, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS5_ENCODER == CW_CCW + case 5: + attachInterrupt(cwPin, cwCcw_A_Axis5, ENCODER_SIGNAL_MODE); + attachInterrupt(ccwPin, cwCcw_B_Axis5, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS6_ENCODER == CW_CCW + case 6: + attachInterrupt(cwPin, cwCcw_A_Axis6, ENCODER_SIGNAL_MODE); + attachInterrupt(ccwPin, cwCcw_B_Axis6, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS7_ENCODER == CW_CCW + case 7: + attachInterrupt(cwPin, cwCcw_A_Axis7, ENCODER_SIGNAL_MODE); + attachInterrupt(ccwPin, cwCcw_B_Axis7, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS8_ENCODER == CW_CCW + case 8: + attachInterrupt(cwPin, cwCcw_A_Axis8, ENCODER_SIGNAL_MODE); + attachInterrupt(ccwPin, cwCcw_B_Axis8, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS9_ENCODER == CW_CCW + case 9: + attachInterrupt(cwPin, cwCcw_A_Axis9, ENCODER_SIGNAL_MODE); + attachInterrupt(ccwPin, cwCcw_B_Axis9, ENCODER_SIGNAL_MODE); + break; + #endif + } + + ready = true; + return true; +} + +int32_t CwCcw::read() { + if (!ready) return 0; + + return ATOMIC_LOAD(count) + index; +} + +void CwCcw::write(int32_t position) { + if (!ready) return; + + index = position - ATOMIC_LOAD(count); +} + +IRAM_ATTR void CwCcw::cw() { + #if ENCODER_FILTER > 0 + ENCODER_FILTER_UNTIL(); + #endif + + count++; + + #if ENCODER_VELOCITY == ON + velNoteEdge(+1); + #endif +} + +IRAM_ATTR void CwCcw::ccw() { + #if ENCODER_FILTER > 0 + ENCODER_FILTER_UNTIL(); + #endif + + count--; + + #if ENCODER_VELOCITY == ON + velNoteEdge(-1); + #endif +} + +#endif diff --git a/src/lib/encoder/cwCcw/CwCcw.h b/src/lib/encoder/cwCcw/CwCcw.h new file mode 100755 index 0000000..f5432c3 --- /dev/null +++ b/src/lib/encoder/cwCcw/CwCcw.h @@ -0,0 +1,31 @@ +// CW/CCW encoders +#pragma once + +#include "../EncoderBase.h" + +#if AXIS1_ENCODER == CW_CCW || AXIS2_ENCODER == CW_CCW || AXIS3_ENCODER == CW_CCW || \ + AXIS4_ENCODER == CW_CCW || AXIS5_ENCODER == CW_CCW || AXIS6_ENCODER == CW_CCW || \ + AXIS7_ENCODER == CW_CCW || AXIS8_ENCODER == CW_CCW || AXIS9_ENCODER == CW_CCW + +// for example: +// CwCcw encoder1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + +class CwCcw : public Encoder { + public: + CwCcw(int16_t axis, int16_t cwPin, int16_t ccwPin); + bool init(); + + int32_t read(); + void write(int32_t position); + + void cw(); + void ccw(); + + private: + int16_t axis_index; + + int16_t CwPin; + int16_t CcwPin; +}; + +#endif diff --git a/src/lib/encoder/ktech/KTech.cpp b/src/lib/encoder/ktech/KTech.cpp new file mode 100755 index 0000000..2042742 --- /dev/null +++ b/src/lib/encoder/ktech/KTech.cpp @@ -0,0 +1,207 @@ +// KTech in motor encoder (designed for the MS4010v3 with 16bit encoder) + +#include "KTech.h" + +#if AXIS1_ENCODER == KTECH_IME || AXIS2_ENCODER == KTECH_IME || AXIS3_ENCODER == KTECH_IME || \ + AXIS4_ENCODER == KTECH_IME || AXIS5_ENCODER == KTECH_IME || AXIS6_ENCODER == KTECH_IME || \ + AXIS7_ENCODER == KTECH_IME || AXIS8_ENCODER == KTECH_IME || AXIS9_ENCODER == KTECH_IME + +#if !defined(CAN_PLUS) || CAN_PLUS == OFF + #error "No KTECH motor CAN interface!" +#endif + +#include "../../tasks/OnTask.h" +#include "../../canPlus/CanPlus.h" + +KTechIME *ktechEncoderInstance[9]; +void requestKTechEncoderAxis1() { ktechEncoderInstance[0]->requestPosition(); } +void requestKTechEncoderAxis2() { ktechEncoderInstance[1]->requestPosition(); } +void requestKTechEncoderAxis3() { ktechEncoderInstance[2]->requestPosition(); } +void requestKTechEncoderAxis4() { ktechEncoderInstance[3]->requestPosition(); } +void requestKTechEncoderAxis5() { ktechEncoderInstance[4]->requestPosition(); } +void requestKTechEncoderAxis6() { ktechEncoderInstance[5]->requestPosition(); } +void requestKTechEncoderAxis7() { ktechEncoderInstance[6]->requestPosition(); } +void requestKTechEncoderAxis8() { ktechEncoderInstance[7]->requestPosition(); } +void requestKTechEncoderAxis9() { ktechEncoderInstance[8]->requestPosition(); } + +void positionKTechEncoderAxis1(uint8_t data[8]) { ktechEncoderInstance[0]->updatePositionCallback(data); } +void positionKTechEncoderAxis2(uint8_t data[8]) { ktechEncoderInstance[1]->updatePositionCallback(data); } +void positionKTechEncoderAxis3(uint8_t data[8]) { ktechEncoderInstance[2]->updatePositionCallback(data); } +void positionKTechEncoderAxis4(uint8_t data[8]) { ktechEncoderInstance[3]->updatePositionCallback(data); } +void positionKTechEncoderAxis5(uint8_t data[8]) { ktechEncoderInstance[4]->updatePositionCallback(data); } +void positionKTechEncoderAxis6(uint8_t data[8]) { ktechEncoderInstance[5]->updatePositionCallback(data); } +void positionKTechEncoderAxis7(uint8_t data[8]) { ktechEncoderInstance[6]->updatePositionCallback(data); } +void positionKTechEncoderAxis8(uint8_t data[8]) { ktechEncoderInstance[7]->updatePositionCallback(data); } +void positionKTechEncoderAxis9(uint8_t data[8]) { ktechEncoderInstance[8]->updatePositionCallback(data); } + +void velocityKTechEncoderAxis1(uint8_t data[8]) { ktechEncoderInstance[0]->updateVelocityCallback(data); } +void velocityKTechEncoderAxis2(uint8_t data[8]) { ktechEncoderInstance[1]->updateVelocityCallback(data); } +void velocityKTechEncoderAxis3(uint8_t data[8]) { ktechEncoderInstance[2]->updateVelocityCallback(data); } +void velocityKTechEncoderAxis4(uint8_t data[8]) { ktechEncoderInstance[3]->updateVelocityCallback(data); } +void velocityKTechEncoderAxis5(uint8_t data[8]) { ktechEncoderInstance[4]->updateVelocityCallback(data); } +void velocityKTechEncoderAxis6(uint8_t data[8]) { ktechEncoderInstance[5]->updateVelocityCallback(data); } +void velocityKTechEncoderAxis7(uint8_t data[8]) { ktechEncoderInstance[6]->updateVelocityCallback(data); } +void velocityKTechEncoderAxis8(uint8_t data[8]) { ktechEncoderInstance[7]->updateVelocityCallback(data); } +void velocityKTechEncoderAxis9(uint8_t data[8]) { ktechEncoderInstance[8]->updateVelocityCallback(data); } + +KTechIME::KTechIME(int16_t axis) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + axis_index = axis - 1; + + // the motor CAN ID is the axis number! + canID = 0x140 + axis; + + ktechEncoderInstance[axis_index] = this; + + switch (this->axis) { + case 1: callback = requestKTechEncoderAxis1; break; + case 2: callback = requestKTechEncoderAxis2; break; + case 3: callback = requestKTechEncoderAxis3; break; + case 4: callback = requestKTechEncoderAxis4; break; + case 5: callback = requestKTechEncoderAxis5; break; + case 6: callback = requestKTechEncoderAxis6; break; + case 7: callback = requestKTechEncoderAxis7; break; + case 8: callback = requestKTechEncoderAxis8; break; + case 9: callback = requestKTechEncoderAxis9; break; + } +} + +bool KTechIME::init() { + if (ready) return true; + if (!Encoder::init()) return false; + + if (!canPlus.ready) { + DLF("WRN: Encoder KTech_IME"); D(axis); DLF(", no CAN interface!"); + ready = false; + return false; + } + + switch (this->axis) { + case 1: + canPlus.callbackRegisterMessage(canID, 0x90, positionKTechEncoderAxis1); + canPlus.callbackRegisterMessage(canID, 0xA2, velocityKTechEncoderAxis1); + break; + case 2: + canPlus.callbackRegisterMessage(canID, 0x90, positionKTechEncoderAxis2); + canPlus.callbackRegisterMessage(canID, 0xA2, velocityKTechEncoderAxis2); + break; + case 3: + canPlus.callbackRegisterMessage(canID, 0x90, positionKTechEncoderAxis3); + canPlus.callbackRegisterMessage(canID, 0xA2, velocityKTechEncoderAxis3); + break; + case 4: + canPlus.callbackRegisterMessage(canID, 0x90, positionKTechEncoderAxis4); + canPlus.callbackRegisterMessage(canID, 0xA2, velocityKTechEncoderAxis4); + break; + case 5: + canPlus.callbackRegisterMessage(canID, 0x90, positionKTechEncoderAxis5); + canPlus.callbackRegisterMessage(canID, 0xA2, velocityKTechEncoderAxis5); + break; + case 6: + canPlus.callbackRegisterMessage(canID, 0x90, positionKTechEncoderAxis6); + canPlus.callbackRegisterMessage(canID, 0xA2, velocityKTechEncoderAxis6); + break; + case 7: + canPlus.callbackRegisterMessage(canID, 0x90, positionKTechEncoderAxis7); + canPlus.callbackRegisterMessage(canID, 0xA2, velocityKTechEncoderAxis7); + break; + case 8: + canPlus.callbackRegisterMessage(canID, 0x90, positionKTechEncoderAxis8); + canPlus.callbackRegisterMessage(canID, 0xA2, velocityKTechEncoderAxis8); + break; + case 9: + canPlus.callbackRegisterMessage(canID, 0x90, positionKTechEncoderAxis9); + canPlus.callbackRegisterMessage(canID, 0xA2, velocityKTechEncoderAxis9); + break; + } + + VF("MSG: Encoder KTech_IME"); V(axis); VF(", start request position task (rate 500ms priority 6)... "); + char name[] = "SysEnK_"; + name[6] = axis + '0'; + if (tasks.add(500, 0, true, 6, callback, name)) { VLF("success"); } else { VLF("FAILED!"); } + + ready = true; + return true; +} + +int32_t KTechIME::read() { + if (!ready) return 0; + + int32_t result = ATOMIC_LOAD(count) + index; + motorStepsAtLastReadValue = motorStepsAtLastUpdate; + + #if ENCODER_VELOCITY == ON + velNoteSampledCount(ATOMIC_LOAD(count)); + #endif + + return result; +} + +void KTechIME::write(int32_t position) { + if (!ready) return; + + index = position - ATOMIC_LOAD(count); +} + +void KTechIME::requestPosition() { + uint32_t now = millis(); + + if ((uint32_t)(now - lastUpdateByPositionCommand) > 1000UL && + (uint32_t)(now - lastUpdateByVelocityCommand) > 1000UL) error++; + + if ((uint32_t)(now - lastUpdateByVelocityCommand) < 500UL) return; + + static const uint8_t cmd[] = "\x90\x00\x00\x00\x00\x00\x00\x00"; + if (canPlus.txTryLock()) canPlus.writePacket(canID, cmd, 8); +} + +IRAM_ATTR void KTechIME::updatePositionCallback(uint8_t data[8]) { + lastUpdateByPositionCommand = millis(); + + if (motorStepsPtr) { + motorStepsAtLastUpdate = *motorStepsPtr; + hasMotorStepsAtLastReadValue = true; + } + + uint16_t countSingleTurn = (uint16_t)data[2] | ((uint16_t)data[3] << 8); + + static constexpr uint16_t high = (KTECH_SINGLE_TURN*3)/4; + static constexpr uint16_t low = (KTECH_SINGLE_TURN*1)/4; + + // count wraps forward and reverse + if (!firstCall) { + if (lastCountSingleTurn > high && countSingleTurn < low) countTurns++; + if (lastCountSingleTurn < low && countSingleTurn > high) countTurns--; + } + firstCall = false; + + lastCountSingleTurn = countSingleTurn; + count = countSingleTurn + countTurns*KTECH_SINGLE_TURN; +} + +IRAM_ATTR void KTechIME::updateVelocityCallback(uint8_t data[8]) { + lastUpdateByVelocityCommand = millis(); + + if (motorStepsPtr) { + motorStepsAtLastUpdate = *motorStepsPtr; + hasMotorStepsAtLastReadValue = true; + } + + uint16_t countSingleTurn = (uint16_t)data[6] | ((uint16_t)data[7] << 8); + + static constexpr uint16_t high = (KTECH_SINGLE_TURN*3)/4; + static constexpr uint16_t low = (KTECH_SINGLE_TURN*1)/4; + + if (!firstCall) { + if (lastCountSingleTurn > high && countSingleTurn < low) countTurns++; + if (lastCountSingleTurn < low && countSingleTurn > high) countTurns--; + } + firstCall = false; + + lastCountSingleTurn = countSingleTurn; + count = countSingleTurn + countTurns*KTECH_SINGLE_TURN; +} + +#endif diff --git a/src/lib/encoder/ktech/KTech.h b/src/lib/encoder/ktech/KTech.h new file mode 100755 index 0000000..c333aa8 --- /dev/null +++ b/src/lib/encoder/ktech/KTech.h @@ -0,0 +1,48 @@ +// KTech in motor encoder (designed for the MS4010v3 with 16bit encoder) +#pragma once + +#include "../EncoderBase.h" + +#ifndef KTECH_SINGLE_TURN + #define KTECH_SINGLE_TURN 65536 +#endif + +// for example: +// KTechIME encoder1(1); + +#if AXIS1_ENCODER == KTECH_IME || AXIS2_ENCODER == KTECH_IME || AXIS3_ENCODER == KTECH_IME || \ + AXIS4_ENCODER == KTECH_IME || AXIS5_ENCODER == KTECH_IME || AXIS6_ENCODER == KTECH_IME || \ + AXIS7_ENCODER == KTECH_IME || AXIS8_ENCODER == KTECH_IME || AXIS9_ENCODER == KTECH_IME + +class KTechIME : public Encoder { + public: + KTechIME(int16_t axis); + bool init(); + + int32_t read(); + void write(int32_t position); + + bool supportsTimeAlignedMotorSteps() const { return true; } + void updatePositionCallback(uint8_t data[8]); + void updateVelocityCallback(uint8_t data[8]); + + void requestPosition(); + + private: + int16_t axis_index = 0; + + bool firstCall = true; + + int canID = 0; + void (*callback)() = NULL; + + volatile uint16_t lastCountSingleTurn = 0; + volatile long countTurns = 0; + + volatile long motorStepsAtLastUpdate = 0; + + uint32_t lastUpdateByPositionCommand = 0; + uint32_t lastUpdateByVelocityCommand = 0; +}; + +#endif diff --git a/src/lib/encoder/pulseDir/PulseDir.cpp b/src/lib/encoder/pulseDir/PulseDir.cpp new file mode 100755 index 0000000..adb4697 --- /dev/null +++ b/src/lib/encoder/pulseDir/PulseDir.cpp @@ -0,0 +1,159 @@ +// Pulse/Dir encoders + +#include "PulseDir.h" + +#if AXIS1_ENCODER == PULSE_DIR || AXIS2_ENCODER == PULSE_DIR || AXIS3_ENCODER == PULSE_DIR || \ + AXIS4_ENCODER == PULSE_DIR || AXIS5_ENCODER == PULSE_DIR || AXIS6_ENCODER == PULSE_DIR || \ + AXIS7_ENCODER == PULSE_DIR || AXIS8_ENCODER == PULSE_DIR || AXIS9_ENCODER == PULSE_DIR + +PulseDir *pulseDirInstance[9]; + +#if AXIS1_ENCODER == PULSE_DIR + IRAM_ATTR void pulseDir_A_Axis1() { pulseDirInstance[0]->pulse(AXIS1_ENCODER_B_PIN); } +#endif + +#if AXIS2_ENCODER == PULSE_DIR + IRAM_ATTR void pulseDir_A_Axis2() { pulseDirInstance[1]->pulse(AXIS2_ENCODER_B_PIN); } +#endif + +#if AXIS3_ENCODER == PULSE_DIR + IRAM_ATTR void pulseDir_A_Axis3() { pulseDirInstance[2]->pulse(AXIS3_ENCODER_B_PIN); } +#endif + +#if AXIS4_ENCODER == PULSE_DIR + IRAM_ATTR void pulseDir_A_Axis4() { pulseDirInstance[3]->pulse(AXIS4_ENCODER_B_PIN); } +#endif + +#if AXIS5_ENCODER == PULSE_DIR + IRAM_ATTR void pulseDir_A_Axis5() { pulseDirInstance[4]->pulse(AXIS5_ENCODER_B_PIN); } +#endif + +#if AXIS6_ENCODER == PULSE_DIR + IRAM_ATTR void pulseDir_A_Axis6() { pulseDirInstance[5]->pulse(AXIS6_ENCODER_B_PIN); } +#endif + +#if AXIS7_ENCODER == PULSE_DIR + IRAM_ATTR void pulseDir_A_Axis7() { pulseDirInstance[6]->pulse(AXIS7_ENCODER_B_PIN); } +#endif + +#if AXIS8_ENCODER == PULSE_DIR + IRAM_ATTR void pulseDir_A_Axis8() { pulseDirInstance[7]->pulse(AXIS8_ENCODER_B_PIN); } +#endif + +#if AXIS9_ENCODER == PULSE_DIR + IRAM_ATTR void pulseDir_A_Axis9() { pulseDirInstance[8]->pulse(AXIS9_ENCODER_B_PIN); } +#endif + +PulseDir::PulseDir(int16_t axis, int16_t pulsePin, int16_t dirPin) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + axis_index = axis - 1; + + PulsePin = pulsePin; + DirPin = dirPin; + + pulseDirInstance[axis_index] = this; +} + +bool PulseDir::init() { + if (ready) return true; + if (!Encoder::init()) return false; + + pinMode(PulsePin, INPUT_PULLUP); + pinMode(DirPin, INPUT_PULLUP); + + int pulsePin = digitalPinToInterrupt(PulsePin); + + if (pulsePin < 0) { + DF("ERR: Encoder PulseDir"); D(axis); DLF(" init(), couldn't attach interrupt!"); + return false; + } + + switch (axis) { + #if AXIS1_ENCODER == PULSE_DIR + case 1: + attachInterrupt(pulsePin, pulseDir_A_Axis1, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS2_ENCODER == PULSE_DIR + case 2: + attachInterrupt(pulsePin, pulseDir_A_Axis2, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS3_ENCODER == PULSE_DIR + case 3: + attachInterrupt(pulsePin, pulseDir_A_Axis3, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS4_ENCODER == PULSE_DIR + case 4: + attachInterrupt(pulsePin, pulseDir_A_Axis4, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS5_ENCODER == PULSE_DIR + case 5: + attachInterrupt(pulsePin, pulseDir_A_Axis5, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS6_ENCODER == PULSE_DIR + case 6: + attachInterrupt(pulsePin, pulseDir_A_Axis6, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS7_ENCODER == PULSE_DIR + case 7: + attachInterrupt(pulsePin, pulseDir_A_Axis7, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS8_ENCODER == PULSE_DIR + case 8: + attachInterrupt(pulsePin, pulseDir_A_Axis8, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS9_ENCODER == PULSE_DIR + case 9: + attachInterrupt(pulsePin, pulseDir_A_Axis9, ENCODER_SIGNAL_MODE); + break; + #endif + } + + ready = true; + return true; +} + +int32_t PulseDir::read() { + if (!ready) return 0; + + return ATOMIC_LOAD(count) + index; +} + +void PulseDir::write(int32_t position) { + if (!ready) return; + + index = position - ATOMIC_LOAD(count); +} + +void IRAM_ATTR PulseDir::pulse(const int16_t dirPin) { + #if ENCODER_FILTER > 0 + ENCODER_FILTER_UNTIL(); + #endif + + if (digitalReadF(dirPin)) { + count--; + + #if ENCODER_VELOCITY == ON + velNoteEdge(-1); + #endif + + } else { + count++; + + #if ENCODER_VELOCITY == ON + velNoteEdge(+1); + #endif + + } +} + +#endif diff --git a/src/lib/encoder/pulseDir/PulseDir.h b/src/lib/encoder/pulseDir/PulseDir.h new file mode 100755 index 0000000..89208bc --- /dev/null +++ b/src/lib/encoder/pulseDir/PulseDir.h @@ -0,0 +1,30 @@ +// Pulse/Dir encoders +#pragma once + +#include "../EncoderBase.h" + +#if AXIS1_ENCODER == PULSE_DIR || AXIS2_ENCODER == PULSE_DIR || AXIS3_ENCODER == PULSE_DIR || \ + AXIS4_ENCODER == PULSE_DIR || AXIS5_ENCODER == PULSE_DIR || AXIS6_ENCODER == PULSE_DIR || \ + AXIS7_ENCODER == PULSE_DIR || AXIS8_ENCODER == PULSE_DIR || AXIS9_ENCODER == PULSE_DIR + +// for example: +// PulseDir encoder1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + +class PulseDir : public Encoder { + public: + PulseDir(int16_t axis, int16_t pulsePin, int16_t dirPin); + bool init(); + + int32_t read(); + void write(int32_t position); + + void pulse(const int16_t dirPin); + + private: + int16_t axis_index; + + int16_t PulsePin + volatile int16_t DirPin; +}; + +#endif diff --git a/src/lib/encoder/pulseOnly/PulseOnly.cpp b/src/lib/encoder/pulseOnly/PulseOnly.cpp new file mode 100755 index 0000000..d057c1a --- /dev/null +++ b/src/lib/encoder/pulseOnly/PulseOnly.cpp @@ -0,0 +1,158 @@ +// Pulse only encoders + +#include "PulseOnly.h" + +#if AXIS1_ENCODER == PULSE_ONLY || AXIS2_ENCODER == PULSE_ONLY || AXIS3_ENCODER == PULSE_ONLY || \ + AXIS4_ENCODER == PULSE_ONLY || AXIS5_ENCODER == PULSE_ONLY || AXIS6_ENCODER == PULSE_ONLY || \ + AXIS7_ENCODER == PULSE_ONLY || AXIS8_ENCODER == PULSE_ONLY || AXIS9_ENCODER == PULSE_ONLY + +PulseOnly *pulseOnlyInstance[9]; + +#if AXIS1_ENCODER == PULSE_ONLY + IRAM_ATTR void pulse_A_Axis1() { pulseOnlyInstance[0]->pulse(); } +#endif + +#if AXIS2_ENCODER == PULSE_ONLY + IRAM_ATTR void pulse_A_Axis2() { pulseOnlyInstance[1]->pulse(); } +#endif + +#if AXIS3_ENCODER == PULSE_ONLY + IRAM_ATTR void pulse_A_Axis3() { pulseOnlyInstance[2]->pulse(); } +#endif + +#if AXIS4_ENCODER == PULSE_ONLY + IRAM_ATTR void pulse_A_Axis4() { pulseOnlyInstance[3]->pulse(); } +#endif + +#if AXIS5_ENCODER == PULSE_ONLY + IRAM_ATTR void pulse_A_Axis5() { pulseOnlyInstance[4]->pulse(); } +#endif + +#if AXIS6_ENCODER == PULSE_ONLY + IRAM_ATTR void pulse_A_Axis6() { pulseOnlyInstance[5]->pulse(); } +#endif + +#if AXIS7_ENCODER == PULSE_ONLY + IRAM_ATTR void pulse_A_Axis7() { pulseOnlyInstance[6]->pulse(); } +#endif + +#if AXIS8_ENCODER == PULSE_ONLY + IRAM_ATTR void pulse_A_Axis8() { pulseOnlyInstance[7]->pulse(); } +#endif + +#if AXIS9_ENCODER == PULSE_ONLY + IRAM_ATTR void pulse_A_Axis9() { pulseOnlyInstance[8]->pulse(); } +#endif + +PulseOnly::PulseOnly(int16_t axis, int16_t pulsePin, volatile int8_t *direction) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + axis_index = axis - 1; + + PulsePin = pulsePin; + pulseDirection = direction; + + pulseOnlyInstance[axis_index] = this; +} + +bool PulseOnly::init() { + if (ready) return true; + if (!Encoder::init()) return false; + + pinMode(pulsePin, INPUT_PULLUP); + + int pulsePin = digitalPinToInterrupt(PulsePin); + + if (pulsePin < 0) { + DF("ERR: Encoder PulseOnly"); D(axis); DLF(" init(), couldn't attach interrupt!"); + return false; + } + + switch (axis) { + #if AXIS1_ENCODER == PULSE_ONLY + case 1: + attachInterrupt(pulsePin, pulse_A_Axis1, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS2_ENCODER == PULSE_ONLY + case 2: + attachInterrupt(pulsePin, pulse_A_Axis2, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS3_ENCODER == PULSE_ONLY + case 3: + attachInterrupt(pulsePin, pulse_A_Axis3, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS4_ENCODER == PULSE_ONLY + case 4: + attachInterrupt(pulsePin, pulse_A_Axis4, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS5_ENCODER == PULSE_ONLY + case 5: + attachInterrupt(pulsePin, pulse_A_Axis5, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS6_ENCODER == PULSE_ONLY + case 6: + attachInterrupt(pulsePin, pulse_A_Axis6, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS7_ENCODER == PULSE_ONLY + case 7: + attachInterrupt(pulsePin, pulse_A_Axis7, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS8_ENCODER == PULSE_ONLY + case 8: + attachInterrupt(pulsePin, pulse_A_Axis8, ENCODER_SIGNAL_MODE); + break; + #endif + #if AXIS9_ENCODER == PULSE_ONLY + case 9: + attachInterrupt(pulsePin, pulse_A_Axis9, ENCODER_SIGNAL_MODE); + break; + #endif + } + + ready = true; +} + +int32_t PulseOnly::read() { + if (!ready) return 0; + + noInterrupts(); + count = count; + interrupts(); + + return count + index; +} + +void PulseOnly::write(int32_t position) { + if (!ready) return; + + noInterrupts(); + index = position - count; + interrupts(); +} + +void PulseOnly::setDirection(volatile int8_t *direction) { + if (!ready) return; + + pulseDirection = direction; +} + +IRAM_ATTR void PulseOnly::pulse() { + #if ENCODER_FILTER > 0 + ENCODER_FILTER_UNTIL(); + #endif + count += *pulseDirection; + + #if ENCODER_VELOCITY == ON + velNoteEdge(*pulseDirection); + #endif +} + +#endif diff --git a/src/lib/encoder/pulseOnly/PulseOnly.h b/src/lib/encoder/pulseOnly/PulseOnly.h new file mode 100755 index 0000000..268d528 --- /dev/null +++ b/src/lib/encoder/pulseOnly/PulseOnly.h @@ -0,0 +1,32 @@ +// Pulse only encoders +#pragma once + +#include "../EncoderBase.h" + +#if AXIS1_ENCODER == PULSE_ONLY || AXIS2_ENCODER == PULSE_ONLY || AXIS3_ENCODER == PULSE_ONLY || \ + AXIS4_ENCODER == PULSE_ONLY || AXIS5_ENCODER == PULSE_ONLY || AXIS6_ENCODER == PULSE_ONLY || \ + AXIS7_ENCODER == PULSE_ONLY || AXIS8_ENCODER == PULSE_ONLY || AXIS9_ENCODER == PULSE_ONLY + +// for example: +// PulseOnly encoder1(1, int16_t axis, AXIS1_ENCODER_A_PIN, &direction); + +class PulseOnly : public Encoder { + public: + PulseOnly(int16_t axis, int16_t pulsePin, volatile int8_t *direction); + bool init(); + + int32_t read(); + void write(int32_t position); + + void setDirection(volatile int8_t *direction); + + void pulse(); + + private: + int16_t axis_index; + + int16_t PulsePin; + volatile int8_t *pulseDirection; +}; + +#endif diff --git a/src/lib/encoder/quadrature/Quadrature.cpp b/src/lib/encoder/quadrature/Quadrature.cpp new file mode 100755 index 0000000..9c27327 --- /dev/null +++ b/src/lib/encoder/quadrature/Quadrature.cpp @@ -0,0 +1,235 @@ +// A/B Quadrature encoders + +#include "Quadrature.h" + +#if AXIS1_ENCODER == AB || AXIS2_ENCODER == AB || AXIS3_ENCODER == AB || \ + AXIS4_ENCODER == AB || AXIS5_ENCODER == AB || AXIS6_ENCODER == AB || \ + AXIS7_ENCODER == AB || AXIS8_ENCODER == AB || AXIS9_ENCODER == AB + +Quadrature *quadratureInstance[9]; + +#if AXIS1_ENCODER == AB + IRAM_ATTR void quadrature_A_Axis1() { quadratureInstance[0]->A(AXIS1_ENCODER_A_PIN); } + IRAM_ATTR void quadrature_B_Axis1() { quadratureInstance[0]->B(AXIS1_ENCODER_B_PIN); } +#endif + +#if AXIS2_ENCODER == AB + IRAM_ATTR void quadrature_A_Axis2() { quadratureInstance[1]->A(AXIS2_ENCODER_A_PIN); } + IRAM_ATTR void quadrature_B_Axis2() { quadratureInstance[1]->B(AXIS2_ENCODER_B_PIN); } +#endif + +#if AXIS3_ENCODER == AB + IRAM_ATTR void quadrature_A_Axis3() { quadratureInstance[2]->A(AXIS3_ENCODER_A_PIN); } + IRAM_ATTR void quadrature_B_Axis3() { quadratureInstance[2]->B(AXIS3_ENCODER_B_PIN); } +#endif + +#if AXIS4_ENCODER == AB + IRAM_ATTR void quadrature_A_Axis4() { quadratureInstance[3]->A(AXIS4_ENCODER_A_PIN); } + IRAM_ATTR void quadrature_B_Axis4() { quadratureInstance[3]->B(AXIS4_ENCODER_B_PIN); } +#endif + +#if AXIS5_ENCODER == AB + IRAM_ATTR void quadrature_A_Axis5() { quadratureInstance[4]->A(AXIS5_ENCODER_A_PIN); } + IRAM_ATTR void quadrature_B_Axis5() { quadratureInstance[4]->B(AXIS5_ENCODER_B_PIN); } +#endif + +#if AXIS6_ENCODER == AB + IRAM_ATTR void quadrature_A_Axis6() { quadratureInstance[5]->A(AXIS6_ENCODER_A_PIN); } + IRAM_ATTR void quadrature_B_Axis6() { quadratureInstance[5]->B(AXIS6_ENCODER_B_PIN); } +#endif + +#if AXIS7_ENCODER == AB + IRAM_ATTR void quadrature_A_Axis7() { quadratureInstance[6]->A(AXIS7_ENCODER_A_PIN); } + IRAM_ATTR void quadrature_B_Axis7() { quadratureInstance[6]->B(AXIS7_ENCODER_B_PIN); } +#endif + +#if AXIS8_ENCODER == AB + IRAM_ATTR void quadrature_A_Axis8() { quadratureInstance[7]->A(AXIS8_ENCODER_A_PIN); } + IRAM_ATTR void quadrature_B_Axis8() { quadratureInstance[7]->B(AXIS8_ENCODER_B_PIN); } +#endif + +#if AXIS9_ENCODER == AB + IRAM_ATTR void quadrature_A_Axis9() { quadratureInstance[8]->A(AXIS9_ENCODER_A_PIN); } + IRAM_ATTR void quadrature_B_Axis9() { quadratureInstance[8]->B(AXIS9_ENCODER_B_PIN); } +#endif + +Quadrature::Quadrature(int16_t axis, int16_t APin, int16_t BPin) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + axis_index = axis - 1; + + this->APin = APin; + this->BPin = BPin; + quadratureInstance[axis_index] = this; +} + +bool Quadrature::init() { + if (ready) return true; + if (!Encoder::init()) return false; + + pinMode(APin, INPUT_PULLUP); + pinMode(BPin, INPUT_PULLUP); + + stateA = digitalRead(APin); + lastA = stateA; + stateB = digitalRead(BPin); + lastB = stateB; + + int aPin = digitalPinToInterrupt(APin); + int bPin = digitalPinToInterrupt(BPin); + + if (aPin < 0 || bPin < 0) { + DF("MSG: Encoder Quadrature"); D(axis); DLF(" init(), couldn't attach interrupt!"); + return false; + } + + VF("MSG: Encoder Quadrature"); V(axis); VF(" init(), attaching interrupts to "); + VF("APin="); V(APin); VF(" and BPin="); VL(BPin); + + switch (axis) { + #if AXIS1_ENCODER == AB + case 1: + attachInterrupt(aPin, quadrature_A_Axis1, CHANGE); + attachInterrupt(bPin, quadrature_B_Axis1, CHANGE); + break; + #endif + #if AXIS2_ENCODER == AB + case 2: + attachInterrupt(aPin, quadrature_A_Axis2, CHANGE); + attachInterrupt(bPin, quadrature_B_Axis2, CHANGE); + break; + #endif + #if AXIS3_ENCODER == AB + case 3: + attachInterrupt(aPin, quadrature_A_Axis3, CHANGE); + attachInterrupt(bPin, quadrature_B_Axis3, CHANGE); + break; + #endif + #if AXIS4_ENCODER == AB + case 4: + attachInterrupt(aPin, quadrature_A_Axis4, CHANGE); + attachInterrupt(bPin, quadrature_B_Axis4, CHANGE); + break; + #endif + #if AXIS5_ENCODER == AB + case 5: + attachInterrupt(aPin, quadrature_A_Axis5, CHANGE); + attachInterrupt(bPin, quadrature_B_Axis5, CHANGE); + break; + #endif + #if AXIS6_ENCODER == AB + case 6: + attachInterrupt(aPin, quadrature_A_Axis6, CHANGE); + attachInterrupt(bPin, quadrature_B_Axis6, CHANGE); + break; + #endif + #if AXIS7_ENCODER == AB + case 7: + attachInterrupt(aPin, quadrature_A_Axis7, CHANGE); + attachInterrupt(bPin, quadrature_B_Axis7, CHANGE); + break; + #endif + #if AXIS8_ENCODER == AB + case 8: + attachInterrupt(aPin, quadrature_A_Axis8, CHANGE); + attachInterrupt(bPin, quadrature_B_Axis8, CHANGE); + break; + #endif + #if AXIS9_ENCODER == AB + case 9: + attachInterrupt(aPin, quadrature_A_Axis9, CHANGE); + attachInterrupt(bPin, quadrature_B_Axis9, CHANGE); + break; + #endif + } + + ready = true; + return true; +} + +int32_t Quadrature::read() { + if (!ready) return 0; + + return ATOMIC_LOAD(count) + index; +} + +void Quadrature::write(int32_t position) { + if (!ready) return; + + index = position - ATOMIC_LOAD(count); +} + +// Phase 1: LLHH LLHH +// Phase 2: LHHL LHHL +// ...00 01 11 10 00 01 11 10 00 01 11 10... + +ICACHE_RAM_ATTR void Quadrature::A(const int16_t pin) { + #if ENCODER_FILTER > 0 + ENCODER_FILTER_UNTIL(); + #endif + stateA = digitalReadF(pin); + + uint8_t v = (stateA<<3) + (stateB<<2) + (lastA<<1) + lastB; + switch (v) { + case 0b0000: QUAD_F2; break; // skipped pulse (invalid A state, valid B state) + case 0b0001: dir = -1; break; + case 0b0010: dir = 1; break; + case 0b0011: QUAD_F1; break; // skipped pulse (valid A state, impossible B state) + case 0b0100: dir = 1; break; + case 0b0101: QUAD_F2; break; // skipped pulse (invalid A state, valid B state) + case 0b0110: QUAD_F1; break; // skipped pulse (valid A state, impossible B state) + case 0b0111: dir = -1; break; + case 0b1000: dir = -1; break; + case 0b1001: QUAD_F1; break; // skipped pulse (valid A state, impossible B state) + case 0b1010: QUAD_F2; break; // skipped pulse (invalid A state, valid B state) + case 0b1011: dir = 1; break; + case 0b1100: QUAD_F1; break; // skipped pulse (valid A state, impossible B state) + case 0b1101: dir = 1; break; + case 0b1110: dir = -1; break; + case 0b1111: QUAD_F2; break; // skipped pulse (invalid A state, valid B state) + } + count += dir; + + #if ENCODER_VELOCITY == ON + if (dir) { velNoteEdge(dir); } + #endif + + lastA = stateA; +} + +ICACHE_RAM_ATTR void Quadrature::B(const int16_t pin) { + #if ENCODER_FILTER > 0 + ENCODER_FILTER_UNTIL(); + #endif + stateB = digitalReadF(pin); + + uint8_t v = (stateA<<3) + (stateB<<2) + (lastA<<1) + lastB; + switch (v) { + case 0b0000: QUAD_F2; break; // skipped pulse (valid A state, invalid B state) + case 0b0001: dir = -1; break; + case 0b0010: dir = 1; break; + case 0b0011: QUAD_F1; break; // skipped pulse (impossible A state, valid B state) + case 0b0100: dir = 1; break; + case 0b0101: QUAD_F2; break; // skipped pulse (valid A state, invalid B state) + case 0b0110: QUAD_F1; break; // skipped pulse (impossible A state, valid B state) + case 0b0111: dir = -1; break; + case 0b1000: dir = -1; break; + case 0b1001: QUAD_F1; break; // skipped pulse (impossible A state, valid B state) + case 0b1010: QUAD_F2; break; // skipped pulse (valid A state, invalid B state) + case 0b1011: dir = 1; break; + case 0b1100: QUAD_F1; break; // skipped pulse (impossible A state, valid B state) + case 0b1101: dir = 1; break; + case 0b1110: dir = -1; break; + case 0b1111: QUAD_F2; break; // skipped pulse (valid A state, invalid B state) + } + count += dir; + + #if ENCODER_VELOCITY == ON + if (dir) { velNoteEdge(dir); } + #endif + + lastB = stateB; +} + +#endif diff --git a/src/lib/encoder/quadrature/Quadrature.h b/src/lib/encoder/quadrature/Quadrature.h new file mode 100755 index 0000000..de1c79d --- /dev/null +++ b/src/lib/encoder/quadrature/Quadrature.h @@ -0,0 +1,59 @@ +// A/B Quadrature encoders +#pragma once + +#include "../EncoderBase.h" + +#if AXIS1_ENCODER == AB || AXIS2_ENCODER == AB || AXIS3_ENCODER == AB || \ + AXIS4_ENCODER == AB || AXIS5_ENCODER == AB || AXIS6_ENCODER == AB || \ + AXIS7_ENCODER == AB || AXIS8_ENCODER == AB || AXIS9_ENCODER == AB + +// for example: +// Quadrature encoder1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + +// Phase 1: LLHH LLHH +// Phase 2: LHHL LHHL +// ...00 01 11 10 00 01 11 10 00 01 11 10... +// + +// quadrature encoder behavior for invalid signal state + +#ifndef ENCODER_AB_STRICT + #define ENCODER_AB_STRICT OFF +#endif + +#if ENCODER_AB_STRICT == OFF + // current A and/or B signal didn't toggle, skip counting and flag warning + #define QUAD_F1 dir = 0; warn++ + #define QUAD_F2 dir = 0; warn++ +#else + // current A and/or B signal didn't toggle, skip counting and flag error + #define QUAD_F1 dir = 0; error++ + #define QUAD_F2 dir = 0; error++ +#endif + +class Quadrature : public Encoder { + public: + Quadrature(int16_t axis, int16_t APin, int16_t BPin); + bool init(); + + int32_t read(); + void write(int32_t position); + + void A(const int16_t pin); + void B(const int16_t pin); + + private: + int16_t axis_index; + + int16_t APin = OFF; + int16_t BPin = OFF; + + volatile int16_t stateA; + volatile int16_t stateB; + volatile int16_t lastA; + volatile int16_t lastB; + volatile int16_t dir; +}; + + +#endif diff --git a/src/lib/encoder/quadratureEsp32/QuadratureEsp32.cpp b/src/lib/encoder/quadratureEsp32/QuadratureEsp32.cpp new file mode 100755 index 0000000..9ed1818 --- /dev/null +++ b/src/lib/encoder/quadratureEsp32/QuadratureEsp32.cpp @@ -0,0 +1,63 @@ +// A/B Quadrature encoders (fast ESP32 hardware decode) + +#include "QuadratureEsp32.h" + +#if AXIS1_ENCODER == AB_ESP32 || AXIS2_ENCODER == AB_ESP32 || AXIS3_ENCODER == AB_ESP32 || \ + AXIS4_ENCODER == AB_ESP32 || AXIS5_ENCODER == AB_ESP32 || AXIS6_ENCODER == AB_ESP32 || \ + AXIS7_ENCODER == AB_ESP32 || AXIS8_ENCODER == AB_ESP32 || AXIS9_ENCODER == AB_ESP32 + +// for example: +// QuadratureEsp32 encoder1(AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN, 1); + +QuadratureEsp32::QuadratureEsp32(int16_t axis, int16_t APin, int16_t BPin) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + + this->APin = APin; + this->BPin = BPin; +} + +bool QuadratureEsp32::init() { + if (ready) return true; + if (!Encoder::init()) return false; + + ab = new ESP32Encoder; + if (ab == NULL) { + DF("ERR: Encoder QuadratureEsp32"); D(axis); DLF(" init(), didn't get instance!"); + return false; + } + + ab->attachFullQuad(APin, BPin); + if (!ab->isAttached()) { + DF("ERR: Encoder QuadratureEsp32"); D(axis); DLF(" init(), couldn't attach interrupts!"); + delete ab; + ab = nullptr; + return false; + } + + ab->setCount(0); + + ready = true; + return true; +} + +int32_t QuadratureEsp32::read() { + if (!ready) return 0; + + count = (int32_t)ab->getCount(); + + #if ENCODER_VELOCITY == ON + velNoteSampledCount(count); + #endif + + return count + index; +} + +void QuadratureEsp32::write(int32_t position) { + if (!ready) return; + + index = position - (int32_t)ab->getCount(); +} + +#endif diff --git a/src/lib/encoder/quadratureEsp32/QuadratureEsp32.h b/src/lib/encoder/quadratureEsp32/QuadratureEsp32.h new file mode 100755 index 0000000..f40db62 --- /dev/null +++ b/src/lib/encoder/quadratureEsp32/QuadratureEsp32.h @@ -0,0 +1,30 @@ +// A/B Quadrature encoders (fast ESP32 hardware decode) +#pragma once + +#include "../EncoderBase.h" + +#if AXIS1_ENCODER == AB_ESP32 || AXIS2_ENCODER == AB_ESP32 || AXIS3_ENCODER == AB_ESP32 || \ + AXIS4_ENCODER == AB_ESP32 || AXIS5_ENCODER == AB_ESP32 || AXIS6_ENCODER == AB_ESP32 || \ + AXIS7_ENCODER == AB_ESP32 || AXIS8_ENCODER == AB_ESP32 || AXIS9_ENCODER == AB_ESP32 + +#include // https://github.com/madhephaestus/ESP32Encoder/tree/master + +// for example: +// QuadratureEsp32 encoder1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + +class QuadratureEsp32 : public Encoder { + public: + QuadratureEsp32(int16_t axis, int16_t APin, int16_t BPin); + bool init(); + + int32_t read(); + void write(int32_t position); + + ESP32Encoder *ab = nullptr; + + private: + int16_t APin = OFF; + int16_t BPin = OFF; +}; + +#endif diff --git a/src/lib/encoder/serialBridge/SerialBridge.cpp b/src/lib/encoder/serialBridge/SerialBridge.cpp new file mode 100755 index 0000000..ec67515 --- /dev/null +++ b/src/lib/encoder/serialBridge/SerialBridge.cpp @@ -0,0 +1,87 @@ +// Serial bridge encoder + +#include "SerialBridge.h" + +#if (AXIS1_ENCODER == SERIAL_BRIDGE || AXIS2_ENCODER == SERIAL_BRIDGE || AXIS3_ENCODER == SERIAL_BRIDGE || \ + AXIS4_ENCODER == SERIAL_BRIDGE || AXIS5_ENCODER == SERIAL_BRIDGE || AXIS6_ENCODER == SERIAL_BRIDGE || \ + AXIS7_ENCODER == SERIAL_BRIDGE || AXIS8_ENCODER == SERIAL_BRIDGE || AXIS9_ENCODER == SERIAL_BRIDGE) && defined(SERIAL_ENCODER) + +bool _serial_bridge_initialized = false; + +#if SERIAL_ENCODER == HardSerial + #undef SERIAL_ENCODER + HardwareSerial HWSerialEncoder(SERIAL_ENCODER_RX, SERIAL_ENCODER_TX); + #define SERIAL_ENCODER HWSerialEncoder + #define SERIAL_ENCODER_RXTX_SET +#endif + +SerialBridge::SerialBridge(int16_t axis) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + + this->channel[0] = '0' + axis; + + ready = true; +} + +int32_t SerialBridge::read() { + if (!ready) return 0; + + const unsigned long now = millis(); + if (now - lastReadMillis > 10U) { + count = getCount(); + + #if ENCODER_VELOCITY == ON + velNoteSampledCount(count); + #endif + + lastReadMillis = now; + } + + return count + index; +} + +void SerialBridge::write(int32_t position) { + if (!ready) return; + + index = position - getCount(); +} + +int32_t SerialBridge::getCount() { + if (!_serial_bridge_initialized) { + #if defined(SERIAL_ENCODER_RX) && defined(SERIAL_ENCODER_TX) && !defined(SERIAL_ENCODER_RXTX_SET) + SERIAL_ENCODER.begin(SERIAL_ENCODER_BAUD, SERIAL_8N1, SERIAL_ENCODER_RX, SERIAL_ENCODER_TX); + #else + SERIAL_ENCODER.begin(SERIAL_ENCODER_BAUD); + #endif + delay(100); + _serial_bridge_initialized = true; + } + + SERIAL_ENCODER.print(channel); + + char result[32] = ""; + char c; + int i = 0; + errorDetected = false; + unsigned long start = millis(); + do { + if (SERIAL_ENCODER.available()) c = SERIAL_ENCODER.read(); else c = 'x'; + if ((c >= '0' && c <= '9') || c == '-') { + result[i++] = c; + result[i] = 0; + } + if (c == 'E') errorDetected = true; + } while (c != 13 && i < 16 && (millis() - start < 4U); + + if (strlen(result) > 0) { + return atoi(result); + } else { + DLF("WRN: SerialBridge getCount(), timed out!"); + error++; + return 0; + } +} + +#endif diff --git a/src/lib/encoder/serialBridge/SerialBridge.h b/src/lib/encoder/serialBridge/SerialBridge.h new file mode 100755 index 0000000..1183d27 --- /dev/null +++ b/src/lib/encoder/serialBridge/SerialBridge.h @@ -0,0 +1,34 @@ +// Serial bridge encoder +#pragma once + +#include "../EncoderBase.h" + +#if (AXIS1_ENCODER == SERIAL_BRIDGE || AXIS2_ENCODER == SERIAL_BRIDGE || AXIS3_ENCODER == SERIAL_BRIDGE || \ + AXIS4_ENCODER == SERIAL_BRIDGE || AXIS5_ENCODER == SERIAL_BRIDGE || AXIS6_ENCODER == SERIAL_BRIDGE || \ + AXIS7_ENCODER == SERIAL_BRIDGE || AXIS8_ENCODER == SERIAL_BRIDGE || AXIS9_ENCODER == SERIAL_BRIDGE) && defined(SERIAL_ENCODER) + +#ifndef SERIAL_ENCODER_BAUD + #define SERIAL_ENCODER_BAUD 460800 +#endif + +#ifndef SERIAL_ENCODER_ABSOLUTE + #define SERIAL_ENCODER_ABSOLUTE OFF +#endif + +class SerialBridge : public Encoder { + public: + SerialBridge(int16_t axis); + bool isAbsolute() const override { return SERIAL_ENCODER_ABSOLUTE == ON; } + int32_t read(); + void write(int32_t count); + bool errorThresholdExceeded() { return errorDetected; } + + private: + int32_t getCount(); + + char channel[2] = "0"; + unsigned long lastReadMillis = 0; + bool errorDetected = false; +}; + +#endif diff --git a/src/lib/encoder/virtualEnc/VirtualEnc.cpp b/src/lib/encoder/virtualEnc/VirtualEnc.cpp new file mode 100755 index 0000000..6ec04f3 --- /dev/null +++ b/src/lib/encoder/virtualEnc/VirtualEnc.cpp @@ -0,0 +1,155 @@ +// Pulse only encoders + +#include "VirtualEnc.h" + +#if AXIS1_ENCODER == VIRTUAL || AXIS2_ENCODER == VIRTUAL || AXIS3_ENCODER == VIRTUAL || \ + AXIS4_ENCODER == VIRTUAL || AXIS5_ENCODER == VIRTUAL || AXIS6_ENCODER == VIRTUAL || \ + AXIS7_ENCODER == VIRTUAL || AXIS8_ENCODER == VIRTUAL || AXIS9_ENCODER == VIRTUAL + +#include "../../tasks/OnTask.h" + +float _virtual_count[9] = {0, 0, 0, 0, 0, 0, 0, 0, 0}; +float _virtual_direction[9]; +float _virtual_increment[9]; + +#if AXIS1_ENCODER == VIRTUAL + IRAM_ATTR void pulse_A_Axis1() { _virtual_count[0] += _virtual_direction[0] * _virtual_increment[0]; } +#endif + +#if AXIS2_ENCODER == VIRTUAL + IRAM_ATTR void pulse_A_Axis2() { _virtual_count[1] += _virtual_direction[1] * _virtual_increment[1]; } +#endif + +#if AXIS3_ENCODER == VIRTUAL + IRAM_ATTR void pulse_A_Axis3() { _virtual_count[2] += _virtual_direction[2] * _virtual_increment[2]; } +#endif + +#if AXIS4_ENCODER == VIRTUAL + IRAM_ATTR void pulse_A_Axis4() { _virtual_count[3] += _virtual_direction[3] * _virtual_increment[3]; } +#endif + +#if AXIS5_ENCODER == VIRTUAL + IRAM_ATTR void pulse_A_Axis5() { _virtual_count[4] += _virtual_direction[4] * _virtual_increment[4]; } +#endif + +#if AXIS6_ENCODER == VIRTUAL + IRAM_ATTR void pulse_A_Axis6() { _virtual_count[5] += _virtual_direction[5] * _virtual_increment[5]; } +#endif + +#if AXIS7_ENCODER == VIRTUAL + IRAM_ATTR void pulse_A_Axis7() { _virtual_count[6] += _virtual_direction[6] * _virtual_increment[6]; } +#endif + +#if AXIS8_ENCODER == VIRTUAL + IRAM_ATTR void pulse_A_Axis8() { _virtual_count[7] += _virtual_direction[7] * _virtual_increment[7]; } +#endif + +#if AXIS9_ENCODER == VIRTUAL + IRAM_ATTR void pulse_A_Axis9() { _virtual_count[8] += _virtual_direction[8] * _virtual_increment[8]; } +#endif + +VirtualEnc::VirtualEnc(int16_t axis) { + if (axis < 1 || axis > 9) return; + + this->axis = axis; + axis_index = axis - 1; + + this->countsPerSec = countsPerSec; + + _virtual_direction[axis_index] = 1; + _virtual_increment[axis_index] = 0.0F; + + isVirtual = true; +} + +bool VirtualEnc::init() { + if (ready) return true; + Encoder::init(); + + virtualEncoderHandle = 0; + + switch (axis) { + #if AXIS1_ENCODER == VIRTUAL + case 1: + virtualEncoderHandle = tasks.add(timerRateMs, 0, true, 3, pulse_A_Axis1, "venc1"); + break; + #endif + #if AXIS2_ENCODER == VIRTUAL + case 2: + virtualEncoderHandle = tasks.add(timerRateMs, 0, true, 3, pulse_A_Axis2, "venc2"); + break; + #endif + #if AXIS3_ENCODER == VIRTUAL + case 3: + virtualEncoderHandle = tasks.add(timerRateMs, 0, true, 3, pulse_A_Axis3, "venc3"); + break; + #endif + #if AXIS4_ENCODER == VIRTUAL + case 4: + virtualEncoderHandle = tasks.add(timerRateMs, 0, true, 3, pulse_A_Axis4, "venc4"); + break; + #endif + #if AXIS5_ENCODER == VIRTUAL + case 5: + virtualEncoderHandle = tasks.add(timerRateMs, 0, true, 3, pulse_A_Axis5, "venc5"); + break; + #endif + #if AXIS6_ENCODER == VIRTUAL + case 6: + virtualEncoderHandle = tasks.add(timerRateMs, 0, true, 3, pulse_A_Axis6, "venc6"); + break; + #endif + #if AXIS7_ENCODER == VIRTUAL + case 7: + virtualEncoderHandle = tasks.add(timerRateMs, 0, true, 3, pulse_A_Axis7, "venc7"); + break; + #endif + #if AXIS8_ENCODER == VIRTUAL + case 8: + virtualEncoderHandle = tasks.add(timerRateMs, 0, true, 3, pulse_A_Axis8, "venc8"); + break; + #endif + #if AXIS9_ENCODER == VIRTUAL + case 9: + virtualEncoderHandle = tasks.add(timerRateMs, 0, true, 3, pulse_A_Axis9, "venc9"); + break; + #endif + } + + if (!virtualEncoderHandle) { + DF("ERR: Encoder Virtual"); D(axis); DLF(" init(), couldn't get task!"); + return false; + } + + ready = true; + return true; +} + +int32_t VirtualEnc::read() { + if (!ready) return 0; + + noInterrupts(); + count = _virtual_count[axis_index]; + interrupts(); + + return count + index; +} + +void VirtualEnc::write(int32_t position) { + if (!ready) return; + + noInterrupts(); + index = position - _virtual_count[axis_index]; + interrupts(); +} + +void VirtualEnc::setVelocity(float countsPerSec) { + if (!ready) { DF("WRN: Encoder Virtual"); D(axis); DLF(" setVelocity(), not ready!"); return; } + _virtual_increment[axis_index] = (countsPerSec)*(timerRateMs/1000.0F); +} + +void VirtualEnc::setDirection(volatile int8_t *direction) { + _virtual_direction[axis_index] = *direction; +} + +#endif diff --git a/src/lib/encoder/virtualEnc/VirtualEnc.h b/src/lib/encoder/virtualEnc/VirtualEnc.h new file mode 100755 index 0000000..3dc2253 --- /dev/null +++ b/src/lib/encoder/virtualEnc/VirtualEnc.h @@ -0,0 +1,29 @@ +// Pulse only encoders +#pragma once + +#include "../EncoderBase.h" + +#if AXIS1_ENCODER == VIRTUAL || AXIS2_ENCODER == VIRTUAL || AXIS3_ENCODER == VIRTUAL || \ + AXIS4_ENCODER == VIRTUAL || AXIS5_ENCODER == VIRTUAL || AXIS6_ENCODER == VIRTUAL || \ + AXIS7_ENCODER == VIRTUAL || AXIS8_ENCODER == VIRTUAL || AXIS9_ENCODER == VIRTUAL + +class VirtualEnc : public Encoder { + public: + VirtualEnc(int16_t axis); + bool init(); + + int32_t read(); + void write(int32_t count); + + void setVelocity(float countsPerSec); + void setDirection(volatile int8_t *direction); + + private: + int16_t axis_index; + + uint8_t virtualEncoderHandle = 0; + long countsPerSec = 0; + long timerRateMs = 3000/HAL_FRACTIONAL_SEC; // (1.0/HAL_FRACTIONAL_SEC)*3*1000 +}; + +#endif diff --git a/src/lib/ethernet/EthernetManager.cpp b/src/lib/ethernet/EthernetManager.cpp new file mode 100755 index 0000000..e51cdef --- /dev/null +++ b/src/lib/ethernet/EthernetManager.cpp @@ -0,0 +1,174 @@ +// ethernet manager, used by the webserver and ethernet serial IP +#include "EthernetManager.h" + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST + +#include "../tasks/OnTask.h" +#include "../nv/Nv.h" + +#if MDNS_SERVER == ON + enum MdnsReady {MD_WAIT, MD_READY, MD_FAIL}; + + #if OPERATIONAL_MODE != ETHERNET_TEENSY41 + EthernetUDP udp; + MDNS mdns(udp); + #endif + + void mdnsPoll() { + static MdnsReady mdnsReady = MD_WAIT; + if (mdnsReady == MD_WAIT && millis() > 5000) { + char name[] = MDNS_NAME; + strtohostname2(name); + #if OPERATIONAL_MODE == ETHERNET_TEENSY41 + MDNS.begin(name, 1); + VF("MSG: Ethernet, mDNS started for "); VL(name); + // MDNS.addService("_http._tcp", 80); // adding a webserver service would look like this + mdnsReady = MD_READY; + #else + if (mdns.begin(Ethernet.localIP(), name)) { + VF("MSG: Ethernet, mDNS started for "); VL(name); + mdnsReady = MD_READY; + } else { + DF("WRN: Ethernet, mDNS start FAILED for "); DL(name); + mdnsReady = MD_FAIL; + } + #endif + } + + if (mdnsReady == MD_READY) { + #if OPERATIONAL_MODE != ETHERNET_TEENSY41 + mdns.run(); + #endif + } + } +#endif + +bool EthernetManager::init() { + if (!active) { + readSettings(); + + #if defined(ETHERNET_CS_PIN) && ETHERNET_CS_PIN != OFF + VF("MSG: Ethernet, device ETHERNET_CS_PIN ("); V(ETHERNET_CS_PIN); VL(")"); + Ethernet.init(ETHERNET_CS_PIN); + #endif + + if (ETHERNET_RESET_PIN != OFF) { + VF("MSG: Ethernet, device ETHERNET_RESET_PIN ("); V(ETHERNET_RESET_PIN); VL(")"); + pinMode(ETHERNET_RESET_PIN, OUTPUT); + digitalWrite(ETHERNET_RESET_PIN, LOW); + delay(1000); + digitalWrite(ETHERNET_RESET_PIN, HIGH); + delay(1000); + } + + if (settings.dhcpEnabled) { + Ethernet.begin(settings.mac); + } else { + Ethernet.begin(settings.mac, settings.ip, settings.dns, settings.gw, settings.sn); + } + + if (Ethernet.hardwareStatus() == EthernetNoHardware) { + DLF("WRN: Ethernet, no hardware"); + return false; + } + + if (Ethernet.linkStatus() == LinkOFF) { + DLF("WRN: Ethernet, no cable"); + return false; + } + + active = true; + + VLF("MSG: Ethernet, initialized"); + + #if MDNS_SERVER == ON + VF("MSG: Ethernet, starting mDNS polling"); + VF(" task (rate 5ms priority 7)... "); + if (tasks.add(5, 0, true, 7, mdnsPoll, "mdPoll")) { VL("success"); } else { VL("FAILED!"); } + #endif + } + + return active; +} + +void EthernetManager::restart() { + if (ETHERNET_RESET_PIN != OFF) { + VF("MSG: Ethernet, device ETHERNET_RESET_PIN ("); V(ETHERNET_RESET_PIN); VL(")"); + pinMode(ETHERNET_RESET_PIN, OUTPUT); + digitalWrite(ETHERNET_RESET_PIN, LOW); + delay(1000); + digitalWrite(ETHERNET_RESET_PIN, HIGH); + delay(1000); + } + + VLF("MSG: Ethernet, restart"); + if (settings.dhcpEnabled) { + active = Ethernet.begin(settings.mac); + } else { + Ethernet.begin(settings.mac, settings.ip, settings.dns, settings.gw, settings.sn); + active = true; + } +} + +void EthernetManager::disconnect() { + VLF("MSG: Ethernet, disconnect ignored!"); +} + +void EthernetManager::setStation(int number) { + if (number >= 1 && number <= EthernetStationCount) stationNumber = number; + sta = &station[stationNumber - 1]; +} + +void EthernetManager::readSettings() { + if (settingsReady) return; + + #ifdef NV_ETHERNET_SETTINGS + VLF("MSG: Ethernet, reading settings from NV"); + if (!nv().kv().getOrInit("ETHERNET_SETTINGS", settings)) { DLF("WRN: Nv, init failed for ETHERNET_SETTINGS"); } + + for (int i = 1; i <= EthernetStationCount; i++) { + char keyStr[24]; + snprintf(keyStr, sizeof(keyStr), "ETHERNET_STATION%u", i); + if (!nv().kv().getOrInit(keyStr, station[i - 1])) { DF("WRN: Nv, init failed for "); DL(keyStr); } + nv().kv().put(keyStr, station[i - 1]); + } + #endif + + #if DEBUG != OFF + int currentStationNumber = stationNumber; + + VF("MSG: Ethernet, DHCP En = "); VL(settings.dhcpEnabled); + VF("MSG: Ethernet, IP = "); V(settings.ip[0]); V("."); V(settings.ip[1]); V("."); V(settings.ip[2]); V("."); VL(settings.ip[3]); + VF("MSG: Ethernet, GW = "); V(settings.gw[0]); V("."); V(settings.gw[1]); V("."); V(settings.gw[2]); V("."); VL(settings.gw[3]); + VF("MSG: Ethernet, SN = "); V(settings.sn[0]); V("."); V(settings.sn[1]); V("."); V(settings.sn[2]); V("."); VL(settings.sn[3]); + + for (int i = 1; i <= EthernetStationCount; i++) { + setStation(i); + + VF("MSG: Ethernet, Sta"); V(stationNumber); VF(" NAME = "); VL(sta->host); + VF("MSG: Ethernet, Sta"); V(stationNumber); VF(" TARGET = "); V(sta->target[0]); V("."); V(sta->target[1]); V("."); V(sta->target[2]); V("."); VL(sta->target[3]); + } + stationNumber = currentStationNumber; + #endif + + settingsReady = true; +} + +void EthernetManager::writeSettings() { + if (!settingsReady) return; + + #ifdef NV_ETHERNET_SETTINGS + VLF("MSG: Ethernet, writing settings to NV"); + nv().kv().put("ETHERNET_SETTINGS", settings); + + for (int i = 1; i <= EthernetStationCount; i++) { + char keyStr[24]; + snprintf(keyStr, sizeof(keyStr), "ETHERNET_STATION%u", i); + nv().kv().put(keyStr, station[i - 1]); + } + #endif +} + +EthernetManager ethernetManager; + +#endif diff --git a/src/lib/ethernet/EthernetManager.defaults.h b/src/lib/ethernet/EthernetManager.defaults.h new file mode 100755 index 0000000..81fac55 --- /dev/null +++ b/src/lib/ethernet/EthernetManager.defaults.h @@ -0,0 +1,142 @@ +#pragma once + +// ------------------------------------------------------------------------------------------------- +// general ip settings + +#ifndef HOST_NAME +#define HOST_NAME "Unknown" +#endif + +// default ETHERNET_XXX disabled +#ifndef OPERATIONAL_MODE +#define OPERATIONAL_MODE OFF +#endif + +// optional web-server +#ifndef WEB_SERVER +#define WEB_SERVER OFF // ON for website at port 80 +#endif + +// optional LX200 command server IP channels 9996 to 9999 (listens to clients) used by SWS +// OFF or STANDARD (port 9999), or PERSISTENT (ports 9996 to 9998), or BOTH +#ifndef COMMAND_SERVER +#define COMMAND_SERVER OFF +#endif + +// optional Arduino Serial class work-alike IP channels 9996 to 9999 as a server (listens to clients) +// OFF or STANDARD (port 9999), or PERSISTENT (ports 9996 to 9998), or BOTH +#ifndef SERIAL_SERVER +#define SERIAL_SERVER OFF // SERIAL_SIP, SERIAL_PIP1, etc. +#endif + +// optional Arduino Serial class work-alike IP channel to port 9998 as a client (connects to a server) +#ifndef SERIAL_CLIENT +#define SERIAL_CLIENT OFF // ON for SERIAL_IP at port 9998 +#endif + +// mDNS defaults +#ifndef MDNS_SERVER +#define MDNS_SERVER OFF +#endif + +#ifndef MDNS_NAME +#define MDNS_NAME HOST_NAME +#endif + +// ------------------------------------------------------------------------------------------------- +// ethernet manager settings + +#ifndef MAC +#define MAC {0xDE,0xAD,0xBE,0xEF,0xFE,0xED} // unique MAC address +#endif + +#ifndef PASSWORD_DEFAULT +#define PASSWORD_DEFAULT "password" // default password for settings +#endif + +#ifndef DHCP_ENABLED +#define DHCP_ENABLED true // true to use LAN DHCP addresses +#endif + +#ifndef STA_IP_ADDR +#define STA_IP_ADDR {192,168,0,2} // IP Address +#endif + +#ifndef STA_GW_ADDR +#define STA_GW_ADDR {192,168,0,1} // GATEWAY Address +#endif + +#ifndef STA_SN_MASK +#define STA_SN_MASK {255,255,255,0} // SUBNET Mask +#endif + +#ifndef STA_HOST_NAME +#define STA_HOST_NAME "Home" // Host name to connect to (OnStep for example) +#endif + +#ifndef STA_TARGET_IP_ADDR +#define STA_TARGET_IP_ADDR {192,168,0,1} // IP Address to connect to +#endif +#ifndef STA_TARGET +#define STA_TARGET STA_TARGET_IP_ADDR +#endif + +// station 1 + +#ifndef STA1_HOST_NAME +#define STA1_HOST_NAME STA_HOST_NAME +#endif + +#ifndef STA1_TARGET_IP_ADDR +#define STA1_TARGET_IP_ADDR STA_TARGET +#endif + +// station 2 + +#ifndef STA2_HOST_NAME +#define STA2_HOST_NAME "" +#endif + +#ifndef STA2_TARGET_IP_ADDR +#define STA2_TARGET_IP_ADDR {192,168,0,1} +#endif + +// station 3 + +#ifndef STA3_HOST_NAME +#define STA3_HOST_NAME "" +#endif + +#ifndef STA3_TARGET_IP_ADDR +#define STA3_TARGET_IP_ADDR {192,168,0,1} +#endif + +// station 4 + +#ifndef STA4_HOST_NAME +#define STA4_HOST_NAME "" +#endif + +#ifndef STA4_TARGET_IP_ADDR +#define STA4_TARGET_IP_ADDR {192,168,0,1} +#endif + +// station 5 + +#ifndef STA5_HOST_NAME +#define STA5_HOST_NAME "" +#endif + +#ifndef STA5_TARGET_IP_ADDR +#define STA5_TARGET_IP_ADDR {192,168,0,1} +#endif + +// station 6 + +#ifndef STA6_HOST_NAME +#define STA6_HOST_NAME "" +#endif + +#ifndef STA6_TARGET_IP_ADDR +#define STA6_TARGET_IP_ADDR {192,168,0,1} +#endif diff --git a/src/lib/ethernet/EthernetManager.h b/src/lib/ethernet/EthernetManager.h new file mode 100755 index 0000000..efe4346 --- /dev/null +++ b/src/lib/ethernet/EthernetManager.h @@ -0,0 +1,114 @@ +// ethernet manager, used by the webserver and ethernet serial IP +#pragma once + +#include "../../Common.h" + +#ifndef OPERATIONAL_MODE +#define OPERATIONAL_MODE OFF +#endif + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST + +#include "EthernetManager.defaults.h" + +#ifdef ESP8266 + #ifndef ETHERNET_W5500 + #error "The ESP8266 Ethernet option supports the W5500 only" + #endif + #include // https://github.com/adafruit/Ethernet2 +#else + #if OPERATIONAL_MODE == ETHERNET_TEENSY41 + #include // built-in library or my https://github.com/hjd1964/Ethernet for ESP32 and ASCOM Alpaca support + #else + #include // built-in library or my https://github.com/hjd1964/Ethernet for ESP32 and ASCOM Alpaca support + #if MDNS_SERVER == ON + #include // built-in library + #include // https://www.arduino.cc/reference/en/libraries/arduinomdns/ + #endif + #endif +#endif + +#ifndef EthernetStationCount + // number of ethernet stations supported, between 1 and 6 + #define EthernetStationCount 1 +#endif + +#define EthernetStationSize 36 +typedef struct EthernetStationSettings { + char host[32]; + uint8_t target[4]; +} EthernetStationSettings; + +#define EthernetSettingsSize 72 +typedef struct EthernetSettings { + char masterPassword[32]; + + unsigned char mac[6]; + bool dhcpEnabled; + IPAddress ip, dns, gw, sn; + +} EthernetSettings; + +class EthernetManager { + public: + // starts Ethernet + bool init(); + + // resets Ethernet + void restart(); + + // Ethernet disconnect is ignored! + void disconnect(); + + // set the currently active station + // \param number from 1 to EthernetStationCount + void setStation(int number); + + void readSettings(); + void writeSettings(); + + // currently selected station + EthernetStationSettings *sta; + + // currently selected station number + int stationNumber = 1; + + // optional station host name lookup overrides target IP (not implemented!) + bool staNameLookup = false; + + EthernetSettings settings = { + PASSWORD_DEFAULT, + MAC, + STA_DHCP_ENABLED, + STA_IP_ADDR, STA_GW_ADDR, STA_GW_ADDR, STA_SN_MASK + }; + + bool active = false; + bool settingsReady = false; + private: + + EthernetStationSettings station[EthernetStationCount] = { + #if EthernetStationCount > 0 + {STA1_HOST_NAME, STA1_TARGET_IP_ADDR}, + #endif + #if EthernetStationCount > 1 + {STA2_HOST_NAME, STA2_TARGET_IP_ADDR}, + #endif + #if EthernetStationCount > 2 + {STA3_HOST_NAME, STA3_TARGET_IP_ADDR}, + #endif + #if EthernetStationCount > 3 + {STA4_HOST_NAME, STA4_TARGET_IP_ADDR}, + #endif + #if EthernetStationCount > 4 + {STA5_HOST_NAME, STA5_TARGET_IP_ADDR}, + #endif + #if EthernetStationCount > 5 + {STA6_HOST_NAME, STA6_TARGET_IP_ADDR}, + #endif + }; +}; + +extern EthernetManager ethernetManager; + +#endif diff --git a/src/lib/ethernet/cmdServer/CmdServer.cpp b/src/lib/ethernet/cmdServer/CmdServer.cpp new file mode 100755 index 0000000..d7db8c4 --- /dev/null +++ b/src/lib/ethernet/cmdServer/CmdServer.cpp @@ -0,0 +1,78 @@ +// ethernet IP command server +#include "CmdServer.h" + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST && COMMAND_SERVER != OFF + + #include "../../tasks/OnTask.h" + #include "../../../libApp/cmd/Cmd.h" + + CmdServer::CmdServer(uint32_t port, long clientTimeoutMs, bool persist) { + cmdBuffer[0] = 0; + cmdBufferPos = 0; + clientEndTimeMs = 0; + this->clientTimeoutMs = clientTimeoutMs; + this->persist = persist; + cmdSvr = new EthernetServer(port); + } + + void CmdServer::begin() { + cmdSvr->begin(); + } + + void CmdServer::handleClient() { + const unsigned long now = millis(); + + // drop stale client socket (disconnected or timed out/hung) + if (cmdSvrClient && + (!cmdSvrClient.connected() || (long)(clientEndTimeMs - now) < 0)) { + cmdSvrClient.stop(); + cmdBuffer[0] = 0; + cmdBufferPos = 0; + } + + // new client + if (!cmdSvrClient) { + cmdSvrClient = cmdSvr->available(); + if (cmdSvrClient) { + clientEndTimeMs = now + clientTimeoutMs; + cmdBuffer[0] = 0; + cmdBufferPos = 0; + } + } + + // check clients for data, if found get the command, pass to OnStep and pickup the response, then return the response to client + while (cmdSvrClient && cmdSvrClient.connected() && cmdSvrClient.available() > 0) { + // still active? push back disconnect + if (persist) clientEndTimeMs = now + clientTimeoutMs; + + // get the data + int c = cmdSvrClient.read(); + if (c < 0 || c > 255) break; + + // insert into the command buffer + cmdBuffer[cmdBufferPos] = (char)c; + cmdBufferPos++; + if (cmdBufferPos > 39) cmdBufferPos = 39; + cmdBuffer[cmdBufferPos] = 0; + + // send cmd and pickup the response + if (c == '#' || (strlen(cmdBuffer) == 1 && c == (char)6)) { + char result[40] = ""; + + onStep.processCommand(cmdBuffer, result, cmdTimeout); + + // pickup response + if (strlen(result) > 0) { + if (cmdSvrClient && cmdSvrClient.connected()) { + cmdSvrClient.print(result); // there was a delay(2); after this + } + } + + // reset command buffer + cmdBuffer[0] = 0; + cmdBufferPos = 0; + } else tasks.yield(); + } + } + +#endif diff --git a/src/lib/ethernet/cmdServer/CmdServer.h b/src/lib/ethernet/cmdServer/CmdServer.h new file mode 100755 index 0000000..9921bdc --- /dev/null +++ b/src/lib/ethernet/cmdServer/CmdServer.h @@ -0,0 +1,27 @@ +// ethernet IP command server +#pragma once + +#include "../../../Common.h" +#include "../EthernetManager.h" + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST && COMMAND_SERVER != OFF + + class CmdServer { + public: + CmdServer(uint32_t port, long clientTimeoutMs, bool persist = false); + void begin(); + void handleClient(); + + private: + EthernetServer *cmdSvr; + EthernetClient cmdSvrClient; + + char cmdBuffer[40]; + int cmdBufferPos; + + unsigned long clientTimeoutMs; + unsigned long clientEndTimeMs; + bool persist; + }; + +#endif diff --git a/src/lib/ethernet/webServer/WebServer.cpp b/src/lib/ethernet/webServer/WebServer.cpp new file mode 100755 index 0000000..25f5f6c --- /dev/null +++ b/src/lib/ethernet/webServer/WebServer.cpp @@ -0,0 +1,335 @@ +// ----------------------------------------------------------------------------------- +// Web server + +#include "WebServer.h" +#include "../../tasks/OnTask.h" + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST && WEB_SERVER != OFF + + void WebServer::begin(long port, long timeToClose, bool autoReset) { + if (webServer == NULL) { + ethernetManager.init(); + + this->port = port; + this->timeToClose = timeToClose; + this->autoReset = autoReset; + + webServer = new EthernetServer(port); + webServer->begin(); + Ethernet.setRetransmissionCount(8); + Ethernet.setRetransmissionTimeout(25); + VF("MSG: Ethernet, started web server on port "); VL(port); + } + } + + void WebServer::handleClient() { + client = webServer->available(); + + if (client) { + WLF("--------------------------------------------------"); + WF("MSG: Webserver, new client socket "); WL(client.getSocketNumber()); + + parameter_count = 0; + String line = ""; + int currentSection = 1; + int handler_number = -1; + lastMethod = HTTP_UNKNOWN; + + unsigned long to = millis() + WEB_SOCKET_TIMEOUT; + while (client.connected() && (long)(millis() - to) < 0 && currentSection <= 2) { + if (client.available()) { + // read in a char + char c = client.read(); if (c == '\r') continue; + + // build up ea. line + if (line.length() <= 1024) line += c; + + // loop until an entire line is present + if (c != '\n' && client.available()) continue; + + // look for end of sections + if (line.equals("\n")) { line = ""; currentSection++; continue; } + + // scan the header + if (currentSection == 1) { + if (!modifiedSinceFound && line.indexOf("If-Modified-Since:") >= 0) modifiedSinceFound = true; + if (lastMethod == HTTP_UNKNOWN) { + int index = line.indexOf("GET "); + if (index >= 0) { + lastMethod = HTTP_GET; + line = line.substring(index + 4); + handler_number = getHandler(&line); + if (handler_number >= 0) processGet(&line); + break; + } else { + index = line.indexOf("POST "); + if (index >= 0) { + lastMethod = HTTP_POST; + line = line.substring(index + 5); + handler_number = getHandler(&line); + } else { + index = line.indexOf("PUT "); + if (index >= 0) { + lastMethod = HTTP_PUT; + line = line.substring(index + 4); + handler_number = getHandler(&line); + if (handler_number >= 0) processPut(&line); + } + } + } + } + } else + + // scan the request + if (currentSection == 2 && handler_number >= 0) { + if (lastMethod == HTTP_PUT) processPut(&line); else + if (lastMethod == HTTP_POST) processPost(&line); + } + + line = ""; + } + Y; + } + + // process get or post request + bool handlerFound = false; + if (handler_number >= 0) { + if (handlers[handler_number] != NULL) { + WF("MSG: Webserver, running handler# "); WL(handler_number); + (*handlers[handler_number])(); + handlerFound = true; + } + } + + // handle page not found + if (!handlerFound && notFoundHandler != NULL) { + WLF("MSG: Webserver, didn't find handler"); + (*notFoundHandler)(); + } + + // port timeout to close + tasks.yield(timeToClose); + + // make sure everything is sent + client.flush(); + + // close the connection: + client.stop(); + + // reset the webserver if requested + if (autoReset) webServer->begin(); + + modifiedSinceFound = false; + + WL("MSG: Webserver, client disconnected"); + } + } + + int WebServer::getHandler(String* line) { + int url_end = line->indexOf("HTTP/"); + if (url_end <= 0) return -1; + + WF("MSG: Webserver, checking handler for "); + + // isolate the content + *line = line->substring(0, url_end); + int url_start = 0; + int url_end2 = line->indexOf('?'); + if (url_end2 > 0) url_end = url_end2; + requestedHandler = line->substring(url_start, url_end); + *line = line->substring(url_end); + requestedHandler.trim(); + if (requestedHandler.length() == 0) requestedHandler = "/"; + WF("["); W(requestedHandler); WL("]"); + + for (int i = 0; i < handler_count; i++) { + if (requestedHandler.equals(handlers_fn[i])) { + WF("MSG: Webserver, found handler# "); WL(i); + return i; + } + } + return -1; + } + + void WebServer::processGet(String* line) { + WLF("MSG: Webserver, checking header GET parameters"); + + if (line->equals(EmptyStr)) { WLF("MSG: Webserver, GET empty"); return; } + + // isolate any parameters, get their values + // look for form "?a=1&" or "&a=1" + while ((*line)[0] == '?' || (*line)[0] == '&') { + *line = line->substring(1); + int j = line->indexOf('='); + if (j == -1) j = line->length(); + if (j == -1) break; // invalid formatting + int j1 = line->indexOf('&'); + if (j1 == -1) j1 = line->length() + 1; + String thisArg = line->substring(0, j); + String thisVal = line->substring(j + 1, j1); + if (thisArg != "") { + if (++parameter_count > PARAMETER_COUNT_MAX) parameter_count = PARAMETER_COUNT_MAX; + parameters[parameter_count - 1] = thisArg; + thisVal.trim(); + values[parameter_count - 1] = thisVal; + } + if ((int)line->length() > j1) *line = line->substring(j1); else *line = ""; + + WF("MSG: Webserver, found "); W(thisArg); W(" = "); WL(thisVal); + } + } + + void WebServer::processPut(String* line) { + WLF("MSG: Webserver, checking header PUT parameters"); + + // make all tokens start with '&' + *line = "&" + *line; + + if (line->equals("&")) { WLF("MSG: Webserver, PUT empty"); return; } + + // isolate any parameters, get their values + // look for form "&a=1" + while ((*line)[0] == '?' || (*line)[0] == '&') { + *line = line->substring(1); + int j = line->indexOf('='); + if (j == -1) j = line->length(); + if (j == -1) break; // invalid formatting + int j1 = line->indexOf('&'); + if (j1 == -1) j1 = line->length() + 1; + String thisArg = line->substring(0, j); + if (thisArg.startsWith("?")) thisArg = thisArg.substring(1); + String thisVal = line->substring(j + 1, j1); + if (thisArg != "") { + if (++parameter_count > PARAMETER_COUNT_MAX) parameter_count = PARAMETER_COUNT_MAX; + parameters[parameter_count - 1] = thisArg; + thisVal.trim(); + values[parameter_count - 1] = thisVal; + } + if ((int)line->length() > j1) *line = line->substring(j1); else *line = ""; + + WF("MSG: Webserver found "); W(thisArg); W(" = "); WL(thisVal); + } + } + + void WebServer::processPost(String* line) { + WLF("MSG: Webserver, checking header POST parameters"); + + // make all tokens start with '&' + *line = "&" + *line; + + if (line->equals(EmptyStr)) { WLF("MSG: Webserver, POST empty"); return; } + + // isolate any parameters, get their values + // look for form "&a=1" + while ((*line)[0] == '&') { + *line = line->substring(1); + int j = line->indexOf('='); + if (j == -1) j = line->length(); + if (j == -1) break; // invalid formatting + int j1 = line->indexOf('&'); + if (j1 == -1) j1 = line->length() + 1; + String thisArg = line->substring(0, j); + String thisVal = line->substring(j + 1, j1); + if (thisArg != "") { + if (++parameter_count > PARAMETER_COUNT_MAX) parameter_count = PARAMETER_COUNT_MAX; + parameters[parameter_count - 1] = thisArg; + values[parameter_count - 1] = thisVal; + } + if ((int)line->length() > j1) *line = line->substring(j1); else *line = ""; + + WF("MSG: Webserver, found "); W(thisArg); W(" = "); WL(thisVal); + } + } + + void WebServer::on(String fn, webFunction handler) { + handler_count++; if (handler_count > WEB_HANDLER_COUNT_MAX) { handler_count = WEB_HANDLER_COUNT_MAX; return; } + handlers[handler_count - 1] = handler; + handlers_fn[handler_count - 1] = fn; + } + + void WebServer::onNotFound(webFunction handler) { + notFoundHandler = handler; + } + + // get argument value by identifier + String WebServer::arg(String id) { + for (int i = 0; i < parameter_count; i++) { + if (id == parameters[i]) return values[i]; + } + return EmptyStr; + } + + // get argument value by index + String WebServer::arg(int i) { + if (i >= 0 && i < parameter_count) { + return values[i]; + } else return ""; + } + + // get argument identifier by index + String WebServer::argName(int i) { + if (i >= 0 && i < parameter_count) { + return parameters[i]; + } else return EmptyStr; + } + + // get arguments count + int WebServer::args() { + return parameter_count; + } + + // check if argument exists + bool WebServer::hasArg(String id) { + for (int i = 0; i < parameter_count; i++) { + if (id == parameters[i]) return true; + } + return false; + } + + void WebServer::setContentLength(long length) { + this->length = length; + } + + void WebServer::setResponseHeader(const char* str) { + if (!str) return; + strcpy_P(responseHeader, str); + } + + void WebServer::sendHeader(const char* key, const char* val, bool first) { + String line = key; + line.concat(": "); + line.concat(val); + line.concat("\r\n"); + if (first) header = line + header; else header.concat(line); + } + + void WebServer::send(int code, const char* content_type, const String& content) { + header = "HTTP/1.1 " + String(code) + " OK\r\n" + header; + header += "Content-Type: "; header += content_type; header += "\r\n"; + if (length == CONTENT_LENGTH_UNKNOWN) { + header += "Connection: close\r\n"; + } else { + if (length == CONTENT_LENGTH_NOT_SET) length = content.length(); + header += "content-length: " + String(length) + "\r\n"; + } + header += "\r\n"; + + client.print(header); + + if (length) client.print(content); + + length = CONTENT_LENGTH_NOT_SET; + header = ""; + } + + void WebServer::sendContent(String s) { + client.print(s); + } + + void WebServer::sendContent(const char * s) { + client.print(s); + } + + WebServer www; + +#endif diff --git a/src/lib/ethernet/webServer/WebServer.h b/src/lib/ethernet/webServer/WebServer.h new file mode 100755 index 0000000..16ec6ee --- /dev/null +++ b/src/lib/ethernet/webServer/WebServer.h @@ -0,0 +1,115 @@ +// ----------------------------------------------------------------------------------- +// Web server +#pragma once + +#include "../../../Common.h" + +#include "../EthernetManager.h" + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST && WEB_SERVER != OFF + + // Turn ON to allow webserver debug messages + #ifndef DEBUG_WEBSERVER + #define DEBUG_WEBSERVER OFF + #endif + + #if DEBUG_WEBSERVER == ON + #define W(x) V(x) + #define WF(x) VF(x) + #define WL(x) VL(x) + #define WLF(x) VLF(x) + #else + #define W(x) + #define WF(x) + #define WL(x) + #define WLF(x) + #endif + + // misc. + #ifndef WEB_SOCKET_TIMEOUT + #define WEB_SOCKET_TIMEOUT 250 + #endif + #ifndef WEB_HANDLER_COUNT_MAX + #define WEB_HANDLER_COUNT_MAX 24 + #endif + #define PARAMETER_COUNT_MAX 12 + #define CONTENT_LENGTH_UNKNOWN -1 + #define CONTENT_LENGTH_NOT_SET -2 + #define HTTP_UNKNOWN 0 + #define HTTP_GET 1 + #define HTTP_PUT 2 + #define HTTP_POST 3 + + #define sendContentAndClear(x) sendContent(x); x = ""; + + typedef void (* webFunction) (); + + class WebServer { + public: + void begin(long port = 80, long timeToClose = 50, bool autoReset = false); + + void handleClient(); + + void on(String fn, webFunction handler); + void onNotFound(webFunction handler); + + // get argument value by identifier + String arg(String id); + // get argument value by index + String arg(int i); + // get argument name by index + String argName(int i); + // get arguments count + int args(); + // check if argument exists + bool hasArg(String id); + + // check http last method used, returns HTTP_UNKNOWN, HTTP_GET, HTTP_PUT, or HTTP_POST + inline int method() { return lastMethod; } + + // return uniform resource identifier + String uri() { return requestedHandler; } + + // return modified since state + bool modifiedSince() { return modifiedSinceFound; } + + void setContentLength(long length); + void setResponseHeader(const char *str); + void sendHeader(const char* key, const char* val, bool first = false); + void send(int code, const char* content_type = "text/html", const String& content = ""); + void sendContent(String s); + void sendContent(const char * s); + + EthernetServer *webServer = NULL; + EthernetClient client; + private: + int getHandler(String* line); + void processGet(String* line); + void processPut(String* line); + void processPost(String* line); + + char responseHeader[200] = ""; + bool modifiedSinceFound = false; + + webFunction notFoundHandler = NULL; + webFunction handlers[WEB_HANDLER_COUNT_MAX]; + String handlers_fn[WEB_HANDLER_COUNT_MAX]; + int handler_count = 0; + + String requestedHandler; + String parameters[PARAMETER_COUNT_MAX]; + String values[PARAMETER_COUNT_MAX]; + int parameter_count; + int port = -1; + bool autoReset = false; + long timeToClose = 100; + + int lastMethod = HTTP_UNKNOWN; + + long length; + String header; + }; + + extern WebServer www; + +#endif diff --git a/src/lib/gpioEx/GpioBase.cpp b/src/lib/gpioEx/GpioBase.cpp new file mode 100755 index 0000000..7eb8360 --- /dev/null +++ b/src/lib/gpioEx/GpioBase.cpp @@ -0,0 +1,18 @@ +// ----------------------------------------------------------------------------------- +// standard external GPIO library + +#include "GpioBase.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE != OFF + +bool Gpio::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + UNUSED(reply); + UNUSED(command); + UNUSED(parameter); + UNUSED(suppressFrame); + UNUSED(numericReply); + UNUSED(commandError); + return false; +} + +#endif diff --git a/src/lib/gpioEx/GpioBase.h b/src/lib/gpioEx/GpioBase.h new file mode 100755 index 0000000..295463d --- /dev/null +++ b/src/lib/gpioEx/GpioBase.h @@ -0,0 +1,68 @@ +// ----------------------------------------------------------------------------------- +// standard external GPIO library +#pragma once + +#include "../../Common.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE != OFF + + #include "../commands/CommandErrors.h" + + class Gpio { + public: + virtual bool init(); + virtual bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + virtual void pinMode(int pin, int mode); + virtual int digitalRead(int pin); + virtual void digitalWrite(int pin, int value); + + bool lateInitError = false; + private: + }; + + #if defined(HAL_DAC_AS_DIGITAL) + // external GPIO and DAC as digital + #define pinModeEx(pin,mode) { if (pin >= 0x200) gpio.pinMode(pin-0x200,mode); else if (pin >= 0x100) pinMode(pin-0x100,mode); else if (pin >= 0) pinMode(CLEAN_PIN(pin),mode); } + #define digitalWriteEx(pin,value) { if (pin >= 0x200) gpio.digitalWrite(pin-0x200,value); else if (pin >= 0x100) analogWrite(pin-0x100,value); else if (pin >= 0) digitalWriteF(CLEAN_PIN(pin),value); } + // special case(s) allowing digitalWriteF() to work with GPIOs + #if GPIO_DEVICE == SSR74HC595 + #define digitalWriteF(pin,value) { if (pin >= 0x200) gpio.digitalWrite(pin-0x200,value); else if (pin >= 0x100) analogWrite(pin-0x100,value); else if (pin >= 0) digitalWrite(CLEAN_PIN(pin),value); } + #endif + #else + // external GPIO but no DAC as digital + #define pinModeEx(pin,mode) { if (pin >= 0x200) gpio.pinMode(pin-0x200,mode); else if (pin >= 0) pinMode(CLEAN_PIN(pin),mode); } + #define digitalWriteEx(pin,value) { if (pin >= 0x200) gpio.digitalWrite(pin-0x200,value); else if (pin >= 0) digitalWriteF(CLEAN_PIN(pin),value); } + // special case(s) allowing digitalWriteF() to work with GPIOs + #if GPIO_DEVICE == SSR74HC595 + #define digitalWriteF(pin,value) { if (pin >= 0x200) gpio.digitalWrite(pin-0x200,value); else if (pin >= 0) digitalWrite(CLEAN_PIN(pin),value); } + #endif + #endif + // no support for DAC input + #define digitalReadEx(pin) ( (pin >= 0)?((pin < 0x100)?digitalReadF(CLEAN_PIN(pin)):gpio.digitalRead(pin-0x200)):0 ) + + // external GPIO analogWrite + #if GPIO_DEVICE == SWS + #define analogWriteEx(pin,value) { if (pin >= 0x200) gpio.analogWrite(pin-0x200,value); else if (pin >= 0) analogWrite(CLEAN_PIN(pin),value); } + #endif +#else + #if defined(HAL_DAC_AS_DIGITAL) + // DAC but no external GPIO + #define pinModeEx(pin,mode) { if (pin > 0x100) pinMode(CLEAN_PIN(pin-0x100),mode); else if (pin >= 0) pinMode(CLEAN_PIN(pin),mode); } + #define digitalWriteEx(pin,value) { if (pin > 0x100) analogWrite(CLEAN_PIN(pin-0x100),value); else if (pin >= 0) { digitalWriteF(CLEAN_PIN(pin),value); } } + #else + // neither DAC as digital or external GPIO + #define pinModeEx(pin,mode) { if (pin >= 0) pinMode(pin,mode); } + #define digitalWriteEx(pin,value) { if (pin >= 0) { digitalWriteF(pin,value); } } + #endif + // no support for DAC input and no external GPIO + #define digitalReadEx(pin) ( (pin >= 0)?digitalReadF(pin):0 ) +#endif + +// automatically use analogWrite +#ifndef analogWriteEx + #define analogWriteEx(pin,value) { analogWrite(pin,value); } +#endif + +// use "Ex" functions to exclude pins that are OFF or SHARED +// pins in range 0x00 to 0xFF are normal, 0x100 to 0x1FF are DAC as digital outputs, 0x200 to 0x2FF are external GPIO pins +#define CLEAN_PIN(pin) ((uint8_t)((pin) & 0xff)) diff --git a/src/lib/gpioEx/GpioEx.h b/src/lib/gpioEx/GpioEx.h new file mode 100755 index 0000000..333a684 --- /dev/null +++ b/src/lib/gpioEx/GpioEx.h @@ -0,0 +1,12 @@ +// ----------------------------------------------------------------------------------- +// standard external GPIO library +#pragma once + +#include "ds2413/Ds2413.h" +#include "mcp23008/Mcp23008.h" +#include "mcp23017/Mcp23017.h" +#include "tca9555/Tca9555.h" +#include "pcf8575/Pcf8575.h" +#include "pcf8574/Pcf8574.h" +#include "sws/Sws.h" +#include "ssr74HC595/Ssr74HC595.h" diff --git a/src/lib/gpioEx/ds2413/Ds2413.cpp b/src/lib/gpioEx/ds2413/Ds2413.cpp new file mode 100755 index 0000000..0148561 --- /dev/null +++ b/src/lib/gpioEx/ds2413/Ds2413.cpp @@ -0,0 +1,136 @@ +// ----------------------------------------------------------------------------------- +// Dallas/Maxim 1-Wire DS2413 device support + +#include "Ds2413.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == DS2413 + +#include "../../1wire/1Wire.h" + +#include // my DallasGPIO library https://github.com/hjd1964/Arduino-DS2413GPIO-Control-Library +DallasGPIO DS2413GPIO(&oneWire); + +#include "../../tasks/OnTask.h" + +void ds2413Wrapper() { gpio.poll(); } + +// scan for a DS2413 device on the 1-wire bus +bool GpioDs2413::init() { + static bool initialized = false; + if (initialized) return found; + + // scan the 1-wire bus and record the devices found + oneWire.reset_search(); + + #if DEBUG == VERBOSE + bool detected = false; + #endif + + VLF("*********************************************"); + VLF("MSG: Dallas/Maxim 1-wire DS2413 device s/n's:"); + + uint8_t addressFound[8] = { 0, 0, 0, 0, 0, 0, 0, 0 }; + while (oneWire.search(addressFound)) { + if (oneWire.crc8(addressFound, 7) == addressFound[7]) { + if (addressFound[0] == 0x3A || addressFound[0] == 0xBA) { + #if DEBUG == VERBOSE + VF("DS2413: 0x"); + for (int i = 0; i < 8; i++) { + if (addressFound[i] < 16) { V("0"); } + if (DEBUG != OFF) SERIAL_DEBUG.print(addressFound[i], HEX); + } + if (deviceCount < DS2413_MAX_DEVICES) { + VF(" allocated to GPIO("); V(deviceCount*2); VF(") and GPIO("); V(deviceCount*2 + 1); VLF(")"); + } else { VLF(" not assigned"); } + + detected = true; + #endif + + if (deviceCount < DS2413_MAX_DEVICES) { + for (int i = 0; i < 8; i++) address[deviceCount][i] = addressFound[i]; + deviceCount++; + } + + } + } + } + + #if DEBUG == VERBOSE + if (!detected) { VLF("No DS2413 devices found"); } + #endif + + VLF("*********************************************"); + + if (deviceCount > 0) { + found = true; + VF("MSG: GPIO, start DS2413 monitor task (rate 100ms priority 7)... "); + if (tasks.add(100, 0, true, 7, ds2413Wrapper, "ds2413")) { VLF("success"); } else { VLF("FAILED!"); } + } else found = false; + + lastValidPin = deviceCount*2 - 1; + + initialized = true; + return found; +} + +// set GPIO pin mode for INPUT or OUTPUT (both pins of any device must be in the same mode) +void GpioDs2413::pinMode(int pin, int mode) { + if (found && pin >= 0 && pin <= lastValidPin) { + if (mode == INPUT_PULLUP) mode = INPUT; + this->mode[pin/2] = mode; + } +} + +// get GPIO pin state +int GpioDs2413::digitalRead(int pin) { + if (found && (long)(millis() - goodUntil[pin/2]) < 0 && pin >= 0 && pin <= lastValidPin) { + return state[pin]; + } else return -1; +} + +// set GPIO pin state +void GpioDs2413::digitalWrite(int pin, int value) { + if (found && pin >= 0 && pin <= lastValidPin) state[pin] = value; +} + +// update the DS2413 +void GpioDs2413::poll() { + if (found) { + // loop to get/set the GPIO + // tasks.yield() during the 1-wire command sequence is ok since: + // 1. only higher priority level tasks are allowed to run during a yield + // 2. all 1-wire task polling is run at the lowest priority level + for (int index = 0; index < deviceCount; index++) { + if (mode[index] == INPUT) { + for (int i = 0; i < 22; i++) { + if (DS2413GPIO.getStateByAddress(address[0 + index], &state[0 + index*2], &state[1 + index*2], true)) break; else tasks.yield(2); + } + } else + if (mode[index] == OUTPUT) { + if (lastState[0 + index*2] != state[0 + index*2] || lastState[1 + index*2] != state[1 + index*2]) { + for (int i = 0; i < 22; i++) { + if (DS2413GPIO.setStateByAddress(address[0 + index], state[0 + index*2], state[1 + index*2], true)) break; else tasks.yield(2); + } + } + } + lastState[0 + index*2] = state[0 + index*2]; + lastState[1 + index*2] = state[1 + index*2]; + + if (DS2413GPIO.success()) { + goodUntil[index] = millis() + 5000; + } else { + state[0 + index*2] = state[1 + index*2] = INVALID; + DF("ERR: DS2413 0x"); + for (int i = 0; i < 8; i++) { + if (address[0 + index][i] < 16) { V("0"); } + if (DEBUG != OFF) SERIAL_DEBUG.print(address[0 + index][i], HEX); + } + DLF(" GPIO comms failure"); + } + } + } +} + +GpioDs2413 gpio; + +#endif diff --git a/src/lib/gpioEx/ds2413/Ds2413.h b/src/lib/gpioEx/ds2413/Ds2413.h new file mode 100755 index 0000000..44e8d92 --- /dev/null +++ b/src/lib/gpioEx/ds2413/Ds2413.h @@ -0,0 +1,44 @@ +// ----------------------------------------------------------------------------------- +// Dallas/Maxim 1-Wire DS2413 device support +#pragma once + +#include "../GpioBase.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == DS2413 + +#define DS2413_MAX_DEVICES 2 + +class GpioDs2413 : public Gpio { + public: + // scan for DS2413 devices on the 1-wire bus + bool init(); + + // set GPIO pin mode for INPUT or OUTPUT (both pins of any device must be in the same mode) + void pinMode(int pin, int mode); + + // get GPIO pin state + int digitalRead(int pin); + + // set GPIO pin state + void digitalWrite(int pin, int value); + + // update the DS2413 + void poll(); + + private: + bool found = false; + uint8_t deviceCount = 0; + int lastValidPin = -1; + + uint8_t address[DS2413_MAX_DEVICES][8]; + + int8_t mode[DS2413_MAX_DEVICES] = {INPUT, INPUT}; + uint8_t state[DS2413_MAX_DEVICES*2] = {false, false, false, false}; + int16_t lastState[DS2413_MAX_DEVICES*2] = {INVALID, INVALID, INVALID, INVALID}; + + unsigned long goodUntil[DS2413_MAX_DEVICES] = {0, 0}; +}; + +extern GpioDs2413 gpio; + +#endif diff --git a/src/lib/gpioEx/mcp23008/Mcp23008.cpp b/src/lib/gpioEx/mcp23008/Mcp23008.cpp new file mode 100755 index 0000000..aad30c4 --- /dev/null +++ b/src/lib/gpioEx/mcp23008/Mcp23008.cpp @@ -0,0 +1,64 @@ +// ----------------------------------------------------------------------------------- +// I2C MCP23008 GPIO support + +#include "Mcp23008.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == MCP23008 + +#ifndef GPIO_MCP23008_I2C_ADDRESS + #define GPIO_MCP23008_I2C_ADDRESS 0x20 +#endif + +// needs: https://github.com/adafruit/Adafruit-MCP23017-Arduino-Library and https://github.com/adafruit/Adafruit_BusIO +#include "Adafruit_MCP23X08.h" +Adafruit_MCP23X08 mcp; + +// check for MCP23008 device on the I2C bus +bool GpioMcp23008::init() { + static bool initialized = false; + if (initialized) return found; + + if (mcp.begin_I2C(GPIO_MCP23008_I2C_ADDRESS, &HAL_WIRE)) { + found = true; + for (int i = 0; i < 8; i++) { mcp.pinMode(i, INPUT); } + } else { found = false; DF("WRN: Gpio.init(), MCP23008 (I2C 0x"); if (DEBUG != OFF) SERIAL_DEBUG.print(GPIO_MCP23008_I2C_ADDRESS, HEX); DLF(") not found"); } + HAL_WIRE_SET_CLOCK(); + + return found; +} + +// set GPIO pin (0 to 7) mode for INPUT, INPUT_PULLUP, or OUTPUT +void GpioMcp23008::pinMode(int pin, int mode) { + if (found && pin >= 0 && pin <= 7) { + #ifdef INPUT_PULLDOWN + if (mode == INPUT_PULLDOWN) mode = INPUT; + #endif + mcp.pinMode(pin, mode); + this->mode[pin] = mode; + } +} + +// one eight channel MCP23008 GPIO is supported, this gets the last set value +int GpioMcp23008::digitalRead(int pin) { + if (found && pin >= 0 && pin <= 7) { + if (mode[pin] == INPUT || mode[pin] == INPUT_PULLUP) { + return mcp.digitalRead(pin); + } else return state[pin]; + } else return 0; +} + +// one eight channel MCP23008 GPIO is supported, this sets each output on or off +void GpioMcp23008::digitalWrite(int pin, int value) { + if (found && pin >= 0 && pin <= 7) { + state[pin] = value; + if (mode[pin] == OUTPUT) { + mcp.digitalWrite(pin, value); + } else { + if (value == HIGH) pinMode(pin, INPUT_PULLUP); else pinMode(pin, INPUT); + } + } else return; +} + +GpioMcp23008 gpio; + +#endif diff --git a/src/lib/gpioEx/mcp23008/Mcp23008.h b/src/lib/gpioEx/mcp23008/Mcp23008.h new file mode 100755 index 0000000..afe557f --- /dev/null +++ b/src/lib/gpioEx/mcp23008/Mcp23008.h @@ -0,0 +1,31 @@ +// ----------------------------------------------------------------------------------- +// I2C MCP23008 GPIO support +#pragma once + +#include "../GpioBase.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == MCP23008 + +class GpioMcp23008 : public Gpio { + public: + // scan for MCP23008 device + bool init(); + + void pinMode(int pin, int mode); + + // one eight channel MCP23008 GPIO is supported, this gets the last set value + int digitalRead(int pin); + + // one eight channel MCP23008 GPIO is supported, this sets each output on or off + void digitalWrite(int pin, int value); + + private: + bool found = false; + + int8_t mode[8] = { INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT }; + bool state[8] = { false, false, false, false, false, false, false, false }; +}; + +extern GpioMcp23008 gpio; + +#endif diff --git a/src/lib/gpioEx/mcp23017/Mcp23017.cpp b/src/lib/gpioEx/mcp23017/Mcp23017.cpp new file mode 100755 index 0000000..6552a4f --- /dev/null +++ b/src/lib/gpioEx/mcp23017/Mcp23017.cpp @@ -0,0 +1,67 @@ +// ----------------------------------------------------------------------------------- +// I2C MCP23017 GPIO support + +#include "Mcp23017.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == MCP23017 + +#ifndef GPIO_MCP23017_I2C_ADDRESS + #define GPIO_MCP23017_I2C_ADDRESS 0x20 +#endif + +// needs: https://github.com/adafruit/Adafruit-MCP23017-Arduino-Library and https://github.com/adafruit/Adafruit_BusIO +#include "Adafruit_MCP23X17.h" +Adafruit_MCP23X17 mcp; + +// check for MCP23017 device on the I2C bus +bool GpioMcp23017::init() { + static bool initialized = false; + if (initialized) return found; + + if (mcp.begin_I2C(GPIO_MCP23017_I2C_ADDRESS, &HAL_WIRE)) { + found = true; + for (int i = 0; i < 16; i++) { mcp.pinMode(i, INPUT); } + } else { + found = false; + DF("WRN: Gpio.init(), MCP23017 (I2C 0x"); if (DEBUG != OFF) SERIAL_DEBUG.print(GPIO_MCP23017_I2C_ADDRESS, HEX); DLF(") not found"); + } + HAL_WIRE_SET_CLOCK(); + + return found; +} + +// set GPIO pin (0 to 15) mode for INPUT, INPUT_PULLUP, or OUTPUT +void GpioMcp23017::pinMode(int pin, int mode) { + if (found && pin >= 0 && pin <= 15) { + #ifdef INPUT_PULLDOWN + if (mode == INPUT_PULLDOWN) mode = INPUT; + #endif + mcp.pinMode(pin, mode); + this->mode[pin] = mode; + } +} + +// one sixteen channel MCP23017 GPIO is supported, this gets the last set value +int GpioMcp23017::digitalRead(int pin) { + if (found && pin >= 0 && pin <= 15) { + if (mode[pin] == INPUT || mode[pin] == INPUT_PULLUP) { + return mcp.digitalRead(pin); + } else return state[pin]; + } else return 0; +} + +// one sixteen channel MCP23017 GPIO is supported, this sets each output on or off +void GpioMcp23017::digitalWrite(int pin, int value) { + if (found && pin >= 0 && pin <= 15) { + state[pin] = value; + if (mode[pin] == OUTPUT) { + mcp.digitalWrite(pin, value); + } else { + if (value == HIGH) pinMode(pin, INPUT_PULLUP); else pinMode(pin, INPUT); + } + } else return; +} + +GpioMcp23017 gpio; + +#endif diff --git a/src/lib/gpioEx/mcp23017/Mcp23017.h b/src/lib/gpioEx/mcp23017/Mcp23017.h new file mode 100755 index 0000000..c7f7237 --- /dev/null +++ b/src/lib/gpioEx/mcp23017/Mcp23017.h @@ -0,0 +1,31 @@ +// ----------------------------------------------------------------------------------- +// I2C MCP23017 GPIO support +#pragma once + +#include "../GpioBase.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == MCP23017 + +class GpioMcp23017 : public Gpio { + public: + // scan for MCP23017 device + bool init(); + + void pinMode(int pin, int mode); + + // one sixteen channel MCP23017 GPIO is supported, this gets the last set value + int digitalRead(int pin); + + // one sixteen channel MCP23017 GPIO is supported, this sets each output on or off + void digitalWrite(int pin, int value); + + private: + bool found = false; + + int8_t mode[16] = { INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT }; + bool state[16] = { false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false }; +}; + +extern GpioMcp23017 gpio; + +#endif diff --git a/src/lib/gpioEx/pcf8574/Pcf8574.cpp b/src/lib/gpioEx/pcf8574/Pcf8574.cpp new file mode 100755 index 0000000..a5aa510 --- /dev/null +++ b/src/lib/gpioEx/pcf8574/Pcf8574.cpp @@ -0,0 +1,102 @@ +// ----------------------------------------------------------------------------------- +// I2C PCF8574 GPIO support + +#include "Pcf8574.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == X8574 + +// check for up to four PCF8574 devices on the I2C bus +bool GpioPcf8574::init() { + static bool initialized = false; + if (initialized) return found; + + for (int i = 0; i < 32; i++) mode[i] = -1; + + HAL_WIRE.begin(); + HAL_WIRE_SET_CLOCK(); + + // check to be sure we find all devices + for (int i = 0; i < GPIO_PCF8574_I2C_NUM_DEVICES; i++) { + HAL_WIRE.beginTransmission(iicAddress[i]); + uint8_t error = HAL_WIRE.endTransmission(); + if (error) { + // try again + HAL_WIRE.beginTransmission(iicAddress[i]); + uint8_t error = HAL_WIRE.endTransmission(); + if (error) { + if (DEBUG != OFF) { DF("WRN: Gpio.init(), PCF8574 (I2C 0x"); SERIAL_DEBUG.print(iicAddress[i], HEX); DLF(") not found"); } + found = false; + return false; + } + } + } + + found = true; + return found; +} + +// set GPIO pin (0 to 31) mode for INPUT or OUTPUT +void GpioPcf8574::pinMode(int pin, int mode) { + if (found && pin >= 0 && pin <= GPIO_PCF8574_I2C_NUM_DEVICES*8 - 1) { + uint8_t device = pin >> 3; + uint8_t devicePin = pin & 0b0111; + + #ifdef INPUT_PULLDOWN + if (mode == INPUT_PULLDOWN) mode = INPUT; + #endif + if (mode == INPUT_PULLUP) mode = INPUT; + if (mode != INPUT && mode != OUTPUT) return; + + if (this->mode[pin] != mode) { + bitWrite(state[device], devicePin, (mode == INPUT) ? 1 : 0); + + HAL_WIRE.beginTransmission(iicAddress[device]); + HAL_WIRE.write(state[device]); + HAL_WIRE.endTransmission(); + + this->mode[pin] = mode; + } + } +} + +// get GPIO pin (0 to 31) state +int GpioPcf8574::digitalRead(int pin) { + if (found && pin >= 0 && pin <= GPIO_PCF8574_I2C_NUM_DEVICES*8 - 1 && mode[pin] > 0) { + uint8_t device = pin >> 3; + uint8_t devicePin = pin & 0b0111; + + if (mode[pin] == INPUT) { + + HAL_WIRE.requestFrom(iicAddress[device], (uint8_t)1); + + unsigned long timeout = millis() + 1000UL; + do { if ((long)(timeout - millis()) < 0) return 0; } while (Wire.available() < 1); + + uint8_t data = HAL_WIRE.read(); + return bitRead(data, devicePin); + } else + return bitRead(state[device], devicePin); + } + + return 0; +} + +// set GPIO pin (0 to 31) state +void GpioPcf8574::digitalWrite(int pin, int value) { + if (found && pin >= 0 && pin <= GPIO_PCF8574_I2C_NUM_DEVICES*8 - 1 && mode[pin] > 0) { + if (mode[pin] == OUTPUT) { + uint8_t device = pin >> 3; + uint8_t devicePin = pin & 0b0111; + + bitWrite(state[device], devicePin, (value == 0) ? 0 : 1); + + HAL_WIRE.beginTransmission(iicAddress[device]); + HAL_WIRE.write(state[device]); + HAL_WIRE.endTransmission(); + } + } +} + +GpioPcf8574 gpio; + +#endif diff --git a/src/lib/gpioEx/pcf8574/Pcf8574.h b/src/lib/gpioEx/pcf8574/Pcf8574.h new file mode 100755 index 0000000..ff283c3 --- /dev/null +++ b/src/lib/gpioEx/pcf8574/Pcf8574.h @@ -0,0 +1,48 @@ +// ----------------------------------------------------------------------------------- +// I2C PCF8574 GPIO support +#pragma once + +#include "../GpioBase.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == X8574 + +#ifndef GPIO_PCF8574_I2C_NUM_DEVICES + #define GPIO_PCF8574_I2C_NUM_DEVICES 1 +#endif + +#ifndef GPIO_PCF8574_I2C_ADDRESS1 + #define GPIO_PCF8574_I2C_ADDRESS1 0x39 +#endif +#ifndef GPIO_PCF8574_I2C_ADDRESS2 + #define GPIO_PCF8574_I2C_ADDRESS2 0x3A +#endif +#ifndef GPIO_PCF8574_I2C_ADDRESS3 + #define GPIO_PCF8574_I2C_ADDRESS3 0x3B +#endif +#ifndef GPIO_PCF8574_I2C_ADDRESS4 + #define GPIO_PCF8574_I2C_ADDRESS4 0x3C +#endif + +class GpioPcf8574 : public Gpio { + public: + // scan for PCF8574 device + bool init(); + + void pinMode(int pin, int mode); + + int digitalRead(int pin); + + void digitalWrite(int pin, int value); + + private: + bool found = false; + + uint8_t iicAddress[4] = {GPIO_PCF8574_I2C_ADDRESS1, GPIO_PCF8574_I2C_ADDRESS2, GPIO_PCF8574_I2C_ADDRESS3, GPIO_PCF8574_I2C_ADDRESS4}; + + int8_t mode[32]; + uint8_t state[4] = {0, 0, 0, 0}; +}; + +extern GpioPcf8574 gpio; + +#endif diff --git a/src/lib/gpioEx/pcf8575/Pcf8575.cpp b/src/lib/gpioEx/pcf8575/Pcf8575.cpp new file mode 100755 index 0000000..55bf8d4 --- /dev/null +++ b/src/lib/gpioEx/pcf8575/Pcf8575.cpp @@ -0,0 +1,105 @@ +// ----------------------------------------------------------------------------------- +// I2C PCF8575 GPIO support + +#include "Pcf8575.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == X8575 + +// check for up to two PCF8575 devices on the I2C bus +bool GpioPcf8575::init() { + static bool initialized = false; + if (initialized) return found; + + for (int i = 0; i < 32; i++) mode[i] = -1; + + HAL_WIRE.begin(); + HAL_WIRE_SET_CLOCK(); + + // check to be sure we find all devices + for (int i = 0; i < GPIO_PCF8575_I2C_NUM_DEVICES; i++) { + HAL_WIRE.beginTransmission(iicAddress[i]); + uint8_t error = HAL_WIRE.endTransmission(); + if (error) { + // try again + HAL_WIRE.beginTransmission(iicAddress[i]); + uint8_t error = HAL_WIRE.endTransmission(); + if (error) { + if (DEBUG != OFF) { DF("WRN: Gpio.init(), PCF8575 (I2C 0x"); SERIAL_DEBUG.print(iicAddress[i], HEX); DLF(") not found"); } + found = false; + return false; + } + } + } + + found = true; + return found; +} + +// set GPIO pin (0 to 31) mode for INPUT or OUTPUT +void GpioPcf8575::pinMode(int pin, int mode) { + if (found && pin >= 0 && pin <= GPIO_PCF8575_I2C_NUM_DEVICES*16 - 1) { + uint8_t device = pin >> 4; + uint8_t devicePin = pin & 0b01111; + + #ifdef INPUT_PULLDOWN + if (mode == INPUT_PULLDOWN) mode = INPUT; + #endif + if (mode == INPUT_PULLUP) mode = INPUT; + if (mode != INPUT && mode != OUTPUT) return; + + if (this->mode[pin] != mode) { + bitWrite(state[device], devicePin, (mode == INPUT) ? 1 : 0); + + HAL_WIRE.beginTransmission(iicAddress[device]); + HAL_WIRE.write(state[device]); + HAL_WIRE.endTransmission(); + + this->mode[pin] = mode; + } + } +} + +// get GPIO pin (0 to 31) state +int GpioPcf8575::digitalRead(int pin) { + if (found && pin >= 0 && pin <= GPIO_PCF8575_I2C_NUM_DEVICES*16 - 1 && mode[pin] > 0) { + uint8_t device = pin >> 4; + uint8_t devicePin = pin & 0b01111; + + if (mode[pin] == INPUT) { + + HAL_WIRE.requestFrom(iicAddress[device], (uint8_t)2); + + unsigned long timeout = millis() + 1000UL; + do { if ((long)(timeout - millis()) < 0) return 0; } while (Wire.available() < 2); + + uint16_t data = HAL_WIRE.read(); + data |= HAL_WIRE.read() << 8; + + return bitRead(data, devicePin); + } else + return bitRead(state[device], devicePin); + } + + return 0; +} + +// set GPIO pin (0 to 31) state +void GpioPcf8575::digitalWrite(int pin, int value) { + if (found && pin >= 0 && pin <= GPIO_PCF8575_I2C_NUM_DEVICES*16 - 1 && mode[pin] > 0) { + if (mode[pin] == OUTPUT) { + uint8_t device = pin >> 4; + uint8_t devicePin = pin & 0b01111; + + bitWrite(state[device], devicePin, (value == 0) ? 0 : 1); + + HAL_WIRE.beginTransmission(iicAddress[device]); + HAL_WIRE.write(state[device] & 0x000FF); + HAL_WIRE.write((state[device] & 0x0FF00) >> 8); + HAL_WIRE.endTransmission(); + } + } +} + +GpioPcf8575 gpio; + +#endif diff --git a/src/lib/gpioEx/pcf8575/Pcf8575.h b/src/lib/gpioEx/pcf8575/Pcf8575.h new file mode 100755 index 0000000..6725ac2 --- /dev/null +++ b/src/lib/gpioEx/pcf8575/Pcf8575.h @@ -0,0 +1,42 @@ +// ----------------------------------------------------------------------------------- +// I2C PCF8575 GPIO support +#pragma once + +#include "../GpioBase.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == X8575 + +#ifndef GPIO_PCF8575_I2C_NUM_DEVICES + #define GPIO_PCF8575_I2C_NUM_DEVICES 1 +#endif + +#ifndef GPIO_PCF8575_I2C_ADDRESS1 + #define GPIO_PCF8575_I2C_ADDRESS1 0x20 +#endif +#ifndef GPIO_PCF8575_I2C_ADDRESS2 + #define GPIO_PCF8575_I2C_ADDRESS2 0x21 +#endif + +class GpioPcf8575 : public Gpio { + public: + // scan for PCF8575 device + bool init(); + + void pinMode(int pin, int mode); + + int digitalRead(int pin); + + void digitalWrite(int pin, int value); + + private: + bool found = false; + + uint8_t iicAddress[2] = {GPIO_PCF8575_I2C_ADDRESS1, GPIO_PCF8575_I2C_ADDRESS2}; + + int8_t mode[32]; + uint16_t state[2] = {0, 0}; +}; + +extern GpioPcf8575 gpio; + +#endif diff --git a/src/lib/gpioEx/ssr74HC595/Ssr74HC595.cpp b/src/lib/gpioEx/ssr74HC595/Ssr74HC595.cpp new file mode 100755 index 0000000..81f88b2 --- /dev/null +++ b/src/lib/gpioEx/ssr74HC595/Ssr74HC595.cpp @@ -0,0 +1,127 @@ +// ----------------------------------------------------------------------------------- +// 74HC595 GPIO support + +#include "Ssr74HC595.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == SSR74HC595 + +#if !defined(GPIO_SSR74HC595_LATCH_PIN) || GPIO_SSR74HC595_LATCH_PIN == OFF + #error "GPIO device SSR74HC595 GPIO_SSR74HC595_LATCH_PIN must be present and not OFF." +#endif +#if !defined(GPIO_SSR74HC595_CLOCK_PIN) || GPIO_SSR74HC595_CLOCK_PIN == OFF + #error "GPIO device SSR74HC595 GPIO_SSR74HC595_CLOCK_PIN must be present and not OFF." +#endif +#if !defined(GPIO_SSR74HC595_DATA_PIN) || GPIO_SSR74HC595_DATA_PIN == OFF + #error "GPIO device SSR74HC595 GPIO_SSR74HC595_DATA_PIN must be present and not OFF." +#endif +#ifndef GPIO_SSR74HC595_COUNT + #error "GPIO device SSR74HC595 GPIO_SSR74HC595_COUNT must be present." +#endif +#if GPIO_SSR74HC595_COUNT != 8 && GPIO_SSR74HC595_COUNT != 16 && GPIO_SSR74HC595_COUNT != 24 && GPIO_SSR74HC595_COUNT != 32 + #error "GPIO device SSR74HC595 supports GPIO_SSR74HC595_COUNT of 8, 16, 24, or 32 only." +#endif + +#ifdef ESP32 + // ESP32 GPIO SSR74HC595 macros (if used, code below only works for pins 0 to 31) + #define GPIO_SSR74HC595_LATCH_LOW() { GPIO.out_w1tc = ((uint32_t)1 << GPIO_SSR74HC595_LATCH_PIN); } + #define GPIO_SSR74HC595_LATCH_HIGH() { GPIO.out_w1ts = ((uint32_t)1 << GPIO_SSR74HC595_LATCH_PIN); } + #define GPIO_SSR74HC595_CLOCK_LOW() { GPIO.out_w1tc = ((uint32_t)1 << GPIO_SSR74HC595_CLOCK_PIN); } + #define GPIO_SSR74HC595_CLOCK_HIGH() { GPIO.out_w1ts = ((uint32_t)1 << GPIO_SSR74HC595_CLOCK_PIN); } + #define GPIO_SSR74HC595_DATA_LOW() { GPIO.out_w1tc = ((uint32_t)1 << GPIO_SSR74HC595_DATA_PIN); } + #define GPIO_SSR74HC595_DATA_HIGH() { GPIO.out_w1ts = ((uint32_t)1 << GPIO_SSR74HC595_DATA_PIN); } +#else + // generic GPIO SSR74HC595 macros + #define GPIO_SSR74HC595_LATCH_LOW() digitalWrite(GPIO_SSR74HC595_LATCH_PIN, LOW) + #define GPIO_SSR74HC595_LATCH_HIGH() digitalWrite(GPIO_SSR74HC595_LATCH_PIN, HIGH) + #define GPIO_SSR74HC595_CLOCK_LOW() digitalWrite(GPIO_SSR74HC595_CLOCK_PIN, LOW) + #define GPIO_SSR74HC595_CLOCK_HIGH() digitalWrite(GPIO_SSR74HC595_CLOCK_PIN, HIGH) + #define GPIO_SSR74HC595_DATA_LOW() digitalWrite(GPIO_SSR74HC595_DATA_PIN, LOW) + #define GPIO_SSR74HC595_DATA_HIGH() digitalWrite(GPIO_SSR74HC595_DATA_PIN, HIGH) +#endif + +// designed for a 20MHz max bit rate +IRAM_ATTR void shiftOut20MHz(uint8_t val) { + if ((val & 0b10000000) == 0) { GPIO_SSR74HC595_DATA_LOW(); } else { GPIO_SSR74HC595_DATA_HIGH(); } + GPIO_SSR74HC595_CLOCK_HIGH(); + GPIO_SSR74HC595_CLOCK_LOW(); + if ((val & 0b01000000) == 0) { GPIO_SSR74HC595_DATA_LOW(); } else { GPIO_SSR74HC595_DATA_HIGH(); } + GPIO_SSR74HC595_CLOCK_HIGH(); + GPIO_SSR74HC595_CLOCK_LOW(); + if ((val & 0b00100000) == 0) { GPIO_SSR74HC595_DATA_LOW(); } else { GPIO_SSR74HC595_DATA_HIGH(); } + GPIO_SSR74HC595_CLOCK_HIGH(); + GPIO_SSR74HC595_CLOCK_LOW(); + if ((val & 0b00010000) == 0) { GPIO_SSR74HC595_DATA_LOW(); } else { GPIO_SSR74HC595_DATA_HIGH(); } + GPIO_SSR74HC595_CLOCK_HIGH(); + GPIO_SSR74HC595_CLOCK_LOW(); + if ((val & 0b00001000) == 0) { GPIO_SSR74HC595_DATA_LOW(); } else { GPIO_SSR74HC595_DATA_HIGH(); } + GPIO_SSR74HC595_CLOCK_HIGH(); + GPIO_SSR74HC595_CLOCK_LOW(); + if ((val & 0b00000100) == 0) { GPIO_SSR74HC595_DATA_LOW(); } else { GPIO_SSR74HC595_DATA_HIGH(); } + GPIO_SSR74HC595_CLOCK_HIGH(); + GPIO_SSR74HC595_CLOCK_LOW(); + if ((val & 0b00000010) == 0) { GPIO_SSR74HC595_DATA_LOW(); } else { GPIO_SSR74HC595_DATA_HIGH(); } + GPIO_SSR74HC595_CLOCK_HIGH(); + GPIO_SSR74HC595_CLOCK_LOW(); + if ((val & 0b00000001) == 0) { GPIO_SSR74HC595_DATA_LOW(); } else { GPIO_SSR74HC595_DATA_HIGH(); } + GPIO_SSR74HC595_CLOCK_HIGH(); + GPIO_SSR74HC595_CLOCK_LOW(); +} + +// get device ready +bool GpioSsr74HC595::init() { + static bool initialized = false; + if (initialized) return found; + + ::pinMode(GPIO_SSR74HC595_LATCH_PIN, OUTPUT); + ::pinMode(GPIO_SSR74HC595_CLOCK_PIN, OUTPUT); + ::pinMode(GPIO_SSR74HC595_DATA_PIN, OUTPUT); + + for (int i = 0; i < GPIO_SSR74HC595_COUNT; i++) { + mode[i] = OUTPUT; + state[i] = false; + } + + VLF("MSG: GPIO, SSR74HC595 Initialized"); + + found = true; + return found; +} + +// set GPIO pin mode for INPUT, INPUT_PULLUP, or OUTPUT (input does nothing always, false) +void GpioSsr74HC595::pinMode(int pin, int mode) { + if (found && pin >= 0 && pin < GPIO_SSR74HC595_COUNT) { + #ifdef INPUT_PULLDOWN + if (mode == INPUT_PULLDOWN) mode = INPUT; + #endif + this->mode[pin] = mode; + } +} + +// up to four eight channel 74HC595 GPIOs are supported, this gets the last set value (output only) +int GpioSsr74HC595::digitalRead(int pin) { + if (found && pin >= 0 && pin < GPIO_SSR74HC595_COUNT) { + return state[pin]; + } else return 0; +} + +// up to four eight channel 74HC595 GPIOs are supported, this sets each output on or off +void GpioSsr74HC595::digitalWrite(int pin, int value) { + if (found && pin >= 0 && pin < GPIO_SSR74HC595_COUNT) { + cli(); + state[pin] = value; + if (mode[pin] == OUTPUT) { + if (value) bitSet(register_value, pin); else bitClear(register_value, pin); + GPIO_SSR74HC595_LATCH_LOW(); + if (GPIO_SSR74HC595_COUNT >= 32) shiftOut20MHz((register_value>>24) & 0xff); + if (GPIO_SSR74HC595_COUNT >= 24) shiftOut20MHz((register_value>>16) & 0xff); + if (GPIO_SSR74HC595_COUNT >= 16) shiftOut20MHz((register_value>>8) & 0xff); + shiftOut20MHz((register_value) & 0xff); + GPIO_SSR74HC595_LATCH_HIGH(); + } + sei(); + } else return; +} + +GpioSsr74HC595 gpio; + +#endif diff --git a/src/lib/gpioEx/ssr74HC595/Ssr74HC595.h b/src/lib/gpioEx/ssr74HC595/Ssr74HC595.h new file mode 100755 index 0000000..2b94e9f --- /dev/null +++ b/src/lib/gpioEx/ssr74HC595/Ssr74HC595.h @@ -0,0 +1,33 @@ +// ----------------------------------------------------------------------------------- +// 74HC595 GPIO support +#pragma once + +#include "../GpioBase.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == SSR74HC595 + +class GpioSsr74HC595 : public Gpio { + public: + // init for SSR74HC595 device + bool init(); + + // set GPIO pin mode for INPUT, INPUT_PULLUP, or OUTPUT (input does nothing always, false) + void pinMode(int pin, int mode); + + // up to four eight channel 74HC595 GPIOs are supported, this gets the last set value (output only) + int digitalRead(int pin); + + // up to four eight channel 74HC595 GPIOs are supported, this sets each output on or off + void digitalWrite(int pin, int value); + + private: + uint32_t register_value = 0; + bool found = false; + + int8_t mode[32]; + bool state[32]; +}; + +extern GpioSsr74HC595 gpio; + +#endif diff --git a/src/lib/gpioEx/sws/Sws.cpp b/src/lib/gpioEx/sws/Sws.cpp new file mode 100755 index 0000000..51a8e19 --- /dev/null +++ b/src/lib/gpioEx/sws/Sws.cpp @@ -0,0 +1,146 @@ +// ----------------------------------------------------------------------------------- +// Smart Web Server GPIO support (optional when SWS encoders are not used) + +#include "Sws.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == SWS + +#include "../../tasks/OnTask.h" +#include "../../../libApp/commands/ProcessCmds.h" + +void swsGpioWrapper() { gpio.poll(); } + +// check for SWS device +bool GpioSws::init() { + if (found) return true; + + VF("MSG: GPIO, start SwsGpio monitor task (rate 1000ms priority 7)... "); + if (tasks.add(1000, 0, true, 7, swsGpioWrapper, "SwsGpio")) { VLF("success"); } else { VLF("FAILED!"); return false; } + + found = true; + return true; +} + +// no command processing +bool GpioSws::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + if (command[0] == 'G') { + if (command[1] == 'X' && parameter[2] == 0) { + // :GXGA# Get Gpio presence + // Returns: 8# on success or 0 (error) if not present + if (parameter[0] == 'G' && parameter[1] == 'A') { + strcpy(reply, "8"); + + active = true; + lastActiveTimeMs = millis(); + *numericReply = false; + } else + + // :GXGO# Get Gpio Output mode or State + // Returns: Value + if (parameter[0] == 'G' && parameter[1] == 'O') { + for (int i = 0; i < 8; i++) { + char newMode = 'X'; + if (mode[i] == INPUT) { if (virtualRead[i] == LOW) newMode = 'i'; else newMode = 'I'; } else + if (mode[i] == INPUT_PULLUP) { if (virtualRead[i] == LOW) newMode = 'u'; else newMode = 'U'; } else + if (mode[i] == OUTPUT) newMode = 'O'; + + if (virtualMode[i] != newMode) { + reply[i] = newMode; + virtualMode[i] = newMode; + } else { + if (virtualMode[i] == 'O') { + if (virtualWrite[i] == 0) reply[i] = '0'; else + if (virtualWrite[i] == 1) reply[i] = '1'; else + if (virtualWrite[i] >= 2) reply[i] = (char)((virtualWrite[i] - 2) + 128); + } else reply[i] = newMode; + } + + reply[i + 1] = 0; + } + + active = true; + lastActiveTimeMs = millis(); + *numericReply = false; + } else return false; + } else return false; + } else + + if (command[0] == 'S') { + if (command[1] == 'X') { + if (parameter[2] != ',') { *commandError = CE_PARAM_FORM; return true; } + + // :SXG[n],[v]# Set Gpio input [n]umber to [v]alue + // Return: 0 on failure + // 1 on success + if (parameter[0] == 'G' && parameter[1] >= '0' && parameter[1] <= '7') { + int i = parameter[1] - '0'; + int v = atol(¶meter[3]); + if (v == 0 || v == 1) { + virtualRead[i] = v; + } else *commandError = CE_PARAM_RANGE; + + active = true; + lastActiveTimeMs = millis(); + } else return false; + } else return false; + } else return false; + + return true; +} + +// set GPIO pin (0 to 7) mode for INPUT, INPUT_PULLUP, or OUTPUT +void GpioSws::pinMode(int pin, int mode) { + if (pin >= 0 && pin <= 7) { + #ifdef INPUT_PULLDOWN + if (mode == INPUT_PULLDOWN) mode = INPUT; + #endif + this->mode[pin] = mode; + } +} + +// one eight channel SWS GPIO is supported, this gets the last set value +int GpioSws::digitalRead(int pin) { + if (readyStage2 && pin >= 0 && pin <= 7) { + if (mode[pin] == INPUT || mode[pin] == INPUT_PULLUP) { + return virtualRead[pin]; + } else return state[pin]; + } else return 0; +} + +// one eight channel SWS GPIO is supported, this sets each output on or off +void GpioSws::digitalWrite(int pin, int value) { + if (pin >= 0 && pin <= 7) { + state[pin] = value; + virtualWrite[pin] = value; + } else return; +} + +// one eight channel SWS GPIO is supported +void GpioSws::analogWrite(int pin, int value) { + value = (value*127)/ANALOG_WRITE_RANGE + 2; + if (pin >= 0 && pin <= 7 && value >= 2 && value <= 129) { + state[pin] = value; + virtualWrite[pin] = value; + } else return; +} + +// monitor SWS presence +void GpioSws::poll() { + if (lateInitError) return; + + // init wait for indication of SWS presence + if (active && !readyStage1) { startTimeMs = millis(); readyStage1 = true; VLF("MSG: GpioSws, active"); } + + // init delay for synchronization + if (readyStage1 && !readyStage2 && millis() - startTimeMs > 2000U) { readyStage2 = true; VLF("MSG: GpioSws, ready"); } + + // init timeout + if (!readyStage1 && !readyStage2 && millis() - startTimeMs > 60000U) { lateInitError = true; DLF("ERR: GpioSws, connection failed"); } + + // running timeout + if (readyStage2 && millis() - lastActiveTimeMs > 5000U) { startTimeMs = millis(); lastActiveTimeMs = millis(); active = false; readyStage1 = false; readyStage2 = false; DLF("WRN: GpioSws, connection restart"); } +} + +GpioSws gpio; + +#endif diff --git a/src/lib/gpioEx/sws/Sws.h b/src/lib/gpioEx/sws/Sws.h new file mode 100755 index 0000000..cedc39b --- /dev/null +++ b/src/lib/gpioEx/sws/Sws.h @@ -0,0 +1,52 @@ +// ----------------------------------------------------------------------------------- +// Smart Web Server GPIO support (optional when SWS Encoders are not used) +#pragma once + +#include "../GpioBase.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == SWS + +#include "../../commands/CommandErrors.h" + +class GpioSws : public Gpio { + public: + // scan for SWS device + bool init(); + + // process any gpio commands + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + void pinMode(int pin, int mode); + + // one eight channel SWS GPIO is supported, this gets the last set value + int digitalRead(int pin); + + // one eight channel SWS GPIO is supported, this sets each output on or off + void digitalWrite(int pin, int value); + + // one eight channel SWS GPIO is supported + void analogWrite(int pin, int value); + + // monitor SWS presence + void poll(); + + private: + + bool found = false; + bool active = false; + bool readyStage1 = false; + bool readyStage2 = false; + unsigned long startTimeMs = 0; + unsigned long lastActiveTimeMs = 0; + + bool virtualRead[8] = {false, false, false, false, false, false, false, false}; + uint8_t virtualWrite[8] = {false, false, false, false, false, false, false, false}; + char virtualMode[8] = {'X', 'X', 'X', 'X', 'X', 'X', 'X', 'X' }; + + int8_t mode[8] = {OFF, OFF, OFF, OFF, OFF, OFF, OFF, OFF}; + bool state[8] = {false, false, false, false, false, false, false, false}; +}; + +extern GpioSws gpio; + +#endif diff --git a/src/lib/gpioEx/tca9555/Tca9555.cpp b/src/lib/gpioEx/tca9555/Tca9555.cpp new file mode 100755 index 0000000..9e1bb35 --- /dev/null +++ b/src/lib/gpioEx/tca9555/Tca9555.cpp @@ -0,0 +1,65 @@ +// ----------------------------------------------------------------------------------- +// I2C TCA9555 GPIO support + +#include "Tca9555.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == X9555 + +#ifndef GPIO_TCA9555_I2C_ADDRESS + #define GPIO_TCA9555_I2C_ADDRESS 0x27 +#endif + +#include // https://www.arduino.cc/reference/en/libraries/tca9555/ + +TCA9555 tca(GPIO_TCA9555_I2C_ADDRESS, &HAL_WIRE); // might need to change this I2C Address? + +// check for TCA9555 device on the I2C bus +bool GpioTca9555::init() { + static bool initialized = false; + if (initialized) return found; + + if (tca.begin()) { + found = true; + for (int i = 0; i < 16; i++) { tca.pinMode1(i, INPUT); } + } else { found = false; DLF("WRN: Gpio.init(), TCA9555 (I2C 0x"); if (DEBUG != OFF) SERIAL_DEBUG.print(GPIO_TCA9555_I2C_ADDRESS, HEX); DLF(") not found"); } + HAL_WIRE_SET_CLOCK(); + + return found; +} + +// set GPIO pin (0 to 15) mode for INPUT, INPUT_PULLUP, or OUTPUT +void GpioTca9555::pinMode(int pin, int mode) { + if (found && pin >= 0 && pin <= 15) { + #ifdef INPUT_PULLDOWN + if (mode == INPUT_PULLDOWN) mode = INPUT; + #endif + if (mode == INPUT_PULLUP) mode = INPUT; + tca.pinMode1(pin, mode); + this->mode[pin] = mode; + } +} + +// one sixteen channel Tca9555 GPIO is supported, this gets the last set value +int GpioTca9555::digitalRead(int pin) { + if (found && pin >= 0 && pin <= 15) { + if (mode[pin] == INPUT || mode[pin] == INPUT_PULLUP) { + return tca.read1(pin); + } else return state[pin]; + } else return 0; +} + +// one sixteen channel Tca9555 GPIO is supported, this sets each output on or off +void GpioTca9555::digitalWrite(int pin, int value) { + if (found && pin >= 0 && pin <= 15) { + state[pin] = value; + if (mode[pin] == OUTPUT) { + tca.write1(pin, value); + } else { + if (value == HIGH) tca.pinMode1(pin, INPUT_PULLUP); else tca.pinMode1(pin, INPUT); + } + } else return; +} + +GpioTca9555 gpio; + +#endif diff --git a/src/lib/gpioEx/tca9555/Tca9555.h b/src/lib/gpioEx/tca9555/Tca9555.h new file mode 100755 index 0000000..b73eaa5 --- /dev/null +++ b/src/lib/gpioEx/tca9555/Tca9555.h @@ -0,0 +1,31 @@ +// ----------------------------------------------------------------------------------- +// I2C TCA9555 GPIO support +#pragma once + +#include "../GpioBase.h" + +#if defined(GPIO_DEVICE) && GPIO_DEVICE == X9555 + +class GpioTca9555 : public Gpio { + public: + // scan for TCA9555 device + bool init(); + + void pinMode(int pin, int mode); + + // one sixteen channel TCA9555 GPIO is supported, this gets the last set value + int digitalRead(int pin); + + // one sixteen channel TCA9555 GPIO is supported, this sets each output on or off + void digitalWrite(int pin, int value); + + private: + bool found = false; + + int8_t mode[16] = { INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT, INPUT }; + bool state[16] = { false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false }; +}; + +extern GpioTca9555 gpio; + +#endif diff --git a/src/lib/math/Crc.cpp b/src/lib/math/Crc.cpp new file mode 100755 index 0000000..dbd75bd --- /dev/null +++ b/src/lib/math/Crc.cpp @@ -0,0 +1,39 @@ +// Crc.cpp +#include "Crc.h" + +// CRC-24/OPENPGP table (poly=0x864CFB), MSB-first, no reflect. +// This out-of-class definition avoids linker/ODR issues on Arduino/ESP32 toolchains. +const uint32_t Crc24::table_[256] = { + 0x000000u, 0x864CFBu, 0x8AD50Du, 0x0C99F6u, 0x93E6E1u, 0x15AA1Au, 0x1933ECu, 0x9F7F17u, + 0xA18139u, 0x27CDC2u, 0x2B5434u, 0xAD18CFu, 0x3267D8u, 0xB42B23u, 0xB8B2D5u, 0x3EFE2Eu, + 0xC54E89u, 0x430272u, 0x4F9B84u, 0xC9D77Fu, 0x56A868u, 0xD0E493u, 0xDC7D65u, 0x5A319Eu, + 0x64CFB0u, 0xE2834Bu, 0xEE1ABDu, 0x685646u, 0xF72951u, 0x7165AAu, 0x7DFC5Cu, 0xFBB0A7u, + 0x0CD1E9u, 0x8A9D12u, 0x8604E4u, 0x00481Fu, 0x9F3708u, 0x197BF3u, 0x15E205u, 0x93AEFEu, + 0xAD50D0u, 0x2B1C2Bu, 0x2785DDu, 0xA1C926u, 0x3EB631u, 0xB8FACAu, 0xB4633Cu, 0x322FC7u, + 0xC99F60u, 0x4FD39Bu, 0x434A6Du, 0xC50696u, 0x5A7981u, 0xDC357Au, 0xD0AC8Cu, 0x56E077u, + 0x681E59u, 0xEE52A2u, 0xE2CB54u, 0x6487AFu, 0xFBF8B8u, 0x7DB443u, 0x712DB5u, 0xF7614Eu, + 0x19A3D2u, 0x9FEF29u, 0x9376DFu, 0x153A24u, 0x8A4533u, 0x0C09C8u, 0x00903Eu, 0x86DCC5u, + 0xB822EBu, 0x3E6E10u, 0x32F7E6u, 0xB4BB1Du, 0x2BC40Au, 0xAD88F1u, 0xA11107u, 0x275DFCu, + 0xDCED5Bu, 0x5AA1A0u, 0x563856u, 0xD074ADu, 0x4F0BBAu, 0xC94741u, 0xC5DEB7u, 0x43924Cu, + 0x7D6C62u, 0xFB2099u, 0xF7B96Fu, 0x71F594u, 0xEE8A83u, 0x68C678u, 0x645F8Eu, 0xE21375u, + 0x15723Bu, 0x933EC0u, 0x9FA736u, 0x19EBCDu, 0x8694DAu, 0x00D821u, 0x0C41D7u, 0x8A0D2Cu, + 0xB4F302u, 0x32BFF9u, 0x3E260Fu, 0xB86AF4u, 0x2715E3u, 0xA15918u, 0xADC0EEu, 0x2B8C15u, + 0xD03CB2u, 0x567049u, 0x5AE9BFu, 0xDCA544u, 0x43DA53u, 0xC596A8u, 0xC90F5Eu, 0x4F43A5u, + 0x71BD8Bu, 0xF7F170u, 0xFB6886u, 0x7D247Du, 0xE25B6Au, 0x641791u, 0x688E67u, 0xEEC29Cu, + 0x3347A4u, 0xB50B5Fu, 0xB992A9u, 0x3FDE52u, 0xA0A145u, 0x26EDBEu, 0x2A7448u, 0xAC38B3u, + 0x92C69Du, 0x148A66u, 0x181390u, 0x9E5F6Bu, 0x01207Cu, 0x876C87u, 0x8BF571u, 0x0DB98Au, + 0xF6092Du, 0x7045D6u, 0x7CDC20u, 0xFA90DBu, 0x65EFCCu, 0xE3A337u, 0xEF3AC1u, 0x69763Au, + 0x578814u, 0xD1C4EFu, 0xDD5D19u, 0x5B11E2u, 0xC46EF5u, 0x42220Eu, 0x4EBBF8u, 0xC8F703u, + 0x3F964Du, 0xB9DAB6u, 0xB54340u, 0x330FBBu, 0xAC70ACu, 0x2A3C57u, 0x26A5A1u, 0xA0E95Au, + 0x9E1774u, 0x185B8Fu, 0x14C279u, 0x928E82u, 0x0DF195u, 0x8BBD6Eu, 0x872498u, 0x016863u, + 0xFAD8C4u, 0x7C943Fu, 0x700DC9u, 0xF64132u, 0x693E25u, 0xEF72DEu, 0xE3EB28u, 0x65A7D3u, + 0x5B59FDu, 0xDD1506u, 0xD18CF0u, 0x57C00Bu, 0xC8BF1Cu, 0x4EF3E7u, 0x426A11u, 0xC426EAu, + 0x2AE476u, 0xACA88Du, 0xA0317Bu, 0x267D80u, 0xB90297u, 0x3F4E6Cu, 0x33D79Au, 0xB59B61u, + 0x8B654Fu, 0x0D29B4u, 0x01B042u, 0x87FCB9u, 0x1883AEu, 0x9ECF55u, 0x9256A3u, 0x141A58u, + 0xEFAAFFu, 0x69E604u, 0x657FF2u, 0xE33309u, 0x7C4C1Eu, 0xFA00E5u, 0xF69913u, 0x70D5E8u, + 0x4E2BC6u, 0xC8673Du, 0xC4FECBu, 0x42B230u, 0xDDCD27u, 0x5B81DCu, 0x57182Au, 0xD154D1u, + 0x26359Fu, 0xA07964u, 0xACE092u, 0x2AAC69u, 0xB5D37Eu, 0x339F85u, 0x3F0673u, 0xB94A88u, + 0x87B4A6u, 0x01F85Du, 0x0D61ABu, 0x8B2D50u, 0x145247u, 0x921EBCu, 0x9E874Au, 0x18CBB1u, + 0xE37B16u, 0x6537EDu, 0x69AE1Bu, 0xEFE2E0u, 0x709DF7u, 0xF6D10Cu, 0xFA48FAu, 0x7C0401u, + 0x42FA2Fu, 0xC4B6D4u, 0xC82F22u, 0x4E63D9u, 0xD11CCEu, 0x575035u, 0x5BC9C3u, 0xDD8538u +}; diff --git a/src/lib/math/Crc.h b/src/lib/math/Crc.h new file mode 100755 index 0000000..38731e7 --- /dev/null +++ b/src/lib/math/Crc.h @@ -0,0 +1,205 @@ +// ----------------------------------------------------------------------------------- +// Crc, crc8/crc16/crc32 helpers with optional cooperative yielding + +#pragma once +#include +#include + +#include "../tasks/OnTask.h" + +#ifndef CRC_YIELD_BYTES + #define CRC_YIELD_BYTES 64 +#endif + +class Crc8 { +public: + // crc8/atm (aka crc-8) + // poly=0x07 init=0x00 refin=false refout=false xorout=0x00 + + static inline uint8_t init() { return 0x00u; } + + static inline uint8_t updateByte(uint8_t crc, uint8_t data) { + crc ^= data; + for (uint8_t i = 0; i < 8; i++) { + crc = (crc & 0x80u) ? (uint8_t)((crc << 1) ^ 0x07u) : (uint8_t)(crc << 1); + } + return crc; + } + + static inline uint8_t update(uint8_t crc, const uint8_t* data, uint16_t len) { + uint16_t sinceYield = 0; + for (uint16_t i = 0; i < len; i++) { + crc = updateByte(crc, data[i]); + #if CRC_YIELD_BYTES > 0 + if (++sinceYield >= CRC_YIELD_BYTES) { sinceYield = 0; tasks.yield(); } + #endif + } + return crc; + } + + static inline uint8_t compute(const uint8_t* data, uint16_t len) { + return update(init(), data, len); + } + + // Salted ASCII helper (optional convenience) + static inline uint8_t saltedAscii(const char* saltAscii, const char* textAscii) { + if (!saltAscii) saltAscii = ""; + if (!textAscii) textAscii = ""; + uint8_t crc = init(); + crc = update(crc, (const uint8_t*)saltAscii, (uint16_t)strlen(saltAscii)); + crc = update(crc, (const uint8_t*)textAscii, (uint16_t)strlen(textAscii)); + return crc; + } +}; + +class Crc16 { +public: + // crc16/ccitt-false + // poly=0x1021 init=0xffff refin=false refout=false xorout=0x0000 + + static inline uint16_t init() { return 0xFFFFu; } + + static inline uint16_t updateByte(uint16_t crc, uint8_t data) { + crc ^= (uint16_t)data << 8; + for (uint8_t i = 0; i < 8; i++) { + crc = (crc & 0x8000u) ? (uint16_t)((crc << 1) ^ 0x1021u) : (uint16_t)(crc << 1); + } + return crc; + } + + static inline uint16_t update(uint16_t crc, const uint8_t* data, uint16_t len) { + uint16_t sinceYield = 0; + for (uint16_t i = 0; i < len; i++) { + crc = updateByte(crc, data[i]); + #if CRC_YIELD_BYTES > 0 + if (++sinceYield >= CRC_YIELD_BYTES) { sinceYield = 0; tasks.yield(); } + #endif + } + return crc; + } + + static inline uint16_t compute(const uint8_t* data, uint16_t len) { + return update(init(), data, len); + } + + // Salted ASCII helpers (for volume/partition IDs, tags, etc.) + static inline uint16_t saltedAscii(const char* saltAscii, const char* textAscii) { + if (!saltAscii) saltAscii = ""; + if (!textAscii) textAscii = ""; + uint16_t crc = init(); + crc = update(crc, (const uint8_t*)saltAscii, (uint16_t)strlen(saltAscii)); + crc = update(crc, (const uint8_t*)textAscii, (uint16_t)strlen(textAscii)); + return crc; + } + + static inline uint16_t saltedAscii2(const char* saltAscii, const char* aAscii, const char* bAscii) { + if (!saltAscii) saltAscii = ""; + if (!aAscii) aAscii = ""; + if (!bAscii) bAscii = ""; + uint16_t crc = init(); + crc = update(crc, (const uint8_t*)saltAscii, (uint16_t)strlen(saltAscii)); + crc = update(crc, (const uint8_t*)aAscii, (uint16_t)strlen(aAscii)); + crc = update(crc, (const uint8_t*)bAscii, (uint16_t)strlen(bAscii)); + return crc; + } +}; + +/*class Crc24 { +public: + // CRC-24/OPENPGP + // poly=0x864CFB init=0xB704CE refin=false refout=false xorout=0x000000 + + static inline uint32_t init() { return 0x00B704CEu; } // 24-bit + + static inline uint32_t updateByte(uint32_t crc, uint8_t data) { + crc ^= (uint32_t)data << 16; // align byte to top of 24-bit register + for (uint8_t i = 0; i < 8; i++) { + crc = (crc & 0x800000u) ? ((crc << 1) ^ 0x864CFBu) : (crc << 1); + crc &= 0xFFFFFFu; + } + return crc; + } + + static inline uint32_t update(uint32_t crc, const uint8_t* data, uint16_t len) { + uint16_t sinceYield = 0; + for (uint16_t i = 0; i < len; i++) { + crc = updateByte(crc, data[i]); + #if CRC_YIELD_BYTES > 0 + if (++sinceYield >= CRC_YIELD_BYTES) { sinceYield = 0; tasks.yield(); } + #endif + } + return crc & 0xFFFFFFu; + } + + static inline uint32_t compute(const uint8_t* data, uint16_t len) { + return update(init(), data, len) & 0xFFFFFFu; + } +}; +*/ + +class Crc24 { +public: + static inline uint32_t init() { return 0x00B704CEu; } + + static inline uint32_t updateByte(uint32_t crc, uint8_t data) { + const uint8_t idx = (uint8_t)(((crc >> 16) ^ (uint32_t)data) & 0xFFu); + crc = ((crc << 8) & 0xFFFFFFu) ^ table_[idx]; + return crc & 0xFFFFFFu; + } + + static inline uint32_t update(uint32_t crc, const uint8_t* data, uint16_t len) { + for (uint16_t i = 0; i < len; i++) crc = updateByte(crc, data[i]); + return crc & 0xFFFFFFu; + } + + static inline uint32_t compute(const uint8_t* data, uint16_t len) { + return update(init(), data, len); + } + +private: + static const uint32_t table_[256]; +}; + +class Crc32 { +public: + // crc32 (ieee 802.3), bitwise + // poly=0xedb88320 init=0xffffffff xorout=~ + + static inline uint32_t init() { return 0xFFFFFFFFu; } + + static inline uint32_t updateByte(uint32_t crc, uint8_t data) { + crc ^= data; + for (uint8_t b = 0; b < 8; b++) { + uint32_t mask = -(int32_t)(crc & 1u); + crc = (crc >> 1) ^ (0xEDB88320u & mask); + } + return crc; + } + + static inline uint32_t update(uint32_t crc, const uint8_t* data, uint16_t len) { + uint16_t sinceYield = 0; + for (uint16_t i = 0; i < len; i++) { + crc = updateByte(crc, data[i]); + #if CRC_YIELD_BYTES > 0 + if (++sinceYield >= CRC_YIELD_BYTES) { sinceYield = 0; tasks.yield(); } + #endif + } + return crc; + } + + static inline uint32_t final(uint32_t crc) { return ~crc; } + + static inline uint32_t compute(const uint8_t* data, uint16_t len) { + return final(update(init(), data, len)); + } + + // Salted ASCII helper (optional convenience) + static inline uint32_t saltedAscii(const char* saltAscii, const char* textAscii) { + if (!saltAscii) saltAscii = ""; + if (!textAscii) textAscii = ""; + uint32_t crc = init(); + crc = update(crc, (const uint8_t*)saltAscii, (uint16_t)strlen(saltAscii)); + crc = update(crc, (const uint8_t*)textAscii, (uint16_t)strlen(textAscii)); + return final(crc); + } +}; diff --git a/src/lib/nv/Nv.cpp b/src/lib/nv/Nv.cpp new file mode 100755 index 0000000..0874e48 --- /dev/null +++ b/src/lib/nv/Nv.cpp @@ -0,0 +1,191 @@ +// Nv.cpp +#include "Nv.h" + +#include + +#include "../tasks/OnTask.h" + +// -------------------- Backend type selection (per driver) -------------------- + +#if (NV_DRIVER == NV_EEPROM) + + #include "device/EepromArduino.h" + using NvBackend = NvDeviceEepromArduino; + +#elif (NV_DRIVER == NV_ESP) + + #include "device/EepromEmuEsp.h" + using NvBackend = NvDeviceEepromEmuEsp; + +#elif (NV_DRIVER == NV_M0) + + #include "device/EepromEmuM0.h" + using NvBackend = NvDeviceEepromEmuM0; + +#elif (NV_DRIVER == NV_2416) + + #include "device/24xxI2C.h" + using NvBackend = NvDevice24xxI2C<2048u>; + +#elif (NV_DRIVER == NV_2432) + + #include "device/24xxI2C.h" + using NvBackend = NvDevice24xxI2C<4096u>; + +#elif (NV_DRIVER == NV_2464) + + #include "device/24xxI2C.h" + using NvBackend = NvDevice24xxI2C<8192u>; + +#elif (NV_DRIVER == NV_24128) + + #include "device/24xxI2C.h" + using NvBackend = NvDevice24xxI2C<16384u>; + +#elif (NV_DRIVER == NV_24256) + + #include "device/24xxI2C.h" + using NvBackend = NvDevice24xxI2C<32768u>; + +#elif (NV_DRIVER == NV_AT24C32) + + #include "device/24xxI2C.h" + using NvBackend = NvDevice24xxI2C<4096u>; + +#elif (NV_DRIVER == NV_MB85RC32) + + #include "device/Mb85rcI2C.h" + using NvBackend = NvDeviceMb85rcI2C<4096u>; + +#elif (NV_DRIVER == NV_MB85RC64) + + #include "device/Mb85rcI2C.h" + using NvBackend = NvDeviceMb85rcI2C<8192u>; + +#elif (NV_DRIVER == NV_MB85RC256) + + #include "device/Mb85rcI2C.h" + using NvBackend = NvDeviceMb85rcI2C<32768u>; + +#elif (NV_DRIVER == OFF) + + #include "device/Null.h" + using NvBackend = NvDeviceNull; + +#else + #error "Unsupported NV_DRIVER" +#endif + + +// -------------------- Construct backend instance -------------------- +// I2C-backed drivers require ctor(TwoWire&, addr). Others default construct. +// HAL_WIRE and NV_I2C_ADDRESS are expected to be defined in NvsConfig.h for I2C drivers. + +#ifdef NV_DEVICE_I2C + + static NvBackend nvDevice(HAL_WIRE, NV_I2C_ADDRESS); + +#else + + static NvBackend nvDevice; + +#endif + +// -------------------- Optional shim + active pointer -------------------- + +#if (NV_SHIM == NV_SHIM_CACHED) + #include "device/ShimCached.h" + static NvShimCached nvShimCached(nvDevice); + static NvDevice* nvActive = &nvShimCached; + constexpr uint32_t NV_SVC_MS = 20; + +#elif (NV_SHIM == NV_SHIM_DELAYED) + #include "device/ShimDelayedCommit.h" + static NvShimDelayedCommit nvShimDelayedCommit(nvDevice, NV_WAIT_MS); + static NvDevice* nvActive = &nvShimDelayedCommit; + constexpr uint32_t NV_SVC_MS = 100; + +#else + static NvDevice* nvActive = &nvDevice; + constexpr uint32_t NV_SVC_MS = 100; +#endif + + +// -------------------- Volume instance -------------------- +// Bound to nvActive in NvSystem::init(). Partitions/format/mount happen higher up. + +static NvVolume nvVolume; + +// -------------------- NvSystem singleton -------------------- + +static NvSystem nvSystem; + +NvSystem& nv() { return nvSystem; } + + +// -------------------- NvSystem methods -------------------- + +// task callback +void nvServices() { + nv().poll(); +} + +bool NvSystem::init(uint8_t priorityLevel) { + if (ok_) return true; + + #if (NV_DRIVER == OFF) + // If OFF means “NV unavailable”, exit cleanly. + return false; + #endif + + // Init active layer (shim init may call down into device init) + if (!nvActive->init()) return false; + + // Bind volume to active device/shim (does not mount/format) + const NvVolume::Status st = nvVolume.init(*nvActive); + if (st != NvVolume::Status::Ok) return false; + + uint32_t pollingRate = NV_SVC_MS; + + // High endurance means FRAM and we double the polling rate since there is no write wait to worry about + if (device().endurance() == NvDevice::Endurance::High) { pollingRate /= 2U; } + + if (priorityLevel > 7) priorityLevel = 7; + + // start system service task + VF("MSG: Nv, start service task (rate "); V(pollingRate); VF("ms priority "); V((int)priorityLevel); VF(")... "); + // add task for system services, runs at pollingRate intervals + if (tasks.add(pollingRate, 0, true, priorityLevel, nvServices, "SvcNv")) { VLF("success"); } else { VLF("FAILED!"); return false; } + + ok_ = true; + return true; +} + +void NvSystem::wipe() { + static const uint8_t pattern[16] = { 0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF,0xFF }; + int16_t sizeBlocks = nv().device().sizeBytes()/16; + + VF("MSG: Setup, NV (EEPROM/FRAM/Flash/etc.) wiping device ."); + + for (int i = 0; i < sizeBlocks; i++) { + nv().device().writeBlock16(i, pattern); + if (i % 128 == 0) { VF("."); } + } + + nv().device().commit(); + VLF(" done."); + VLF(""); + VLF("MSG: Setup, !!!!!!! REMEMBER TO DISABLE THIS FEATURE IN Config.h !!!!!!!"); + VLF(""); +} + +void NvSystem::poll() { + if (!ok_) return; + if (!canService_()) return; + nvActive->poll(); +} + +NvDevice& NvSystem::device() { return nvDevice; } +NvDevice& NvSystem::active() { return *nvActive; } + +NvVolume& NvSystem::volume() { return nvVolume; } diff --git a/src/lib/nv/Nv.h b/src/lib/nv/Nv.h new file mode 100755 index 0000000..da5d0dc --- /dev/null +++ b/src/lib/nv/Nv.h @@ -0,0 +1,95 @@ +// ----------------------------------------------------------------------------------- +// Nv.h +// +// Non-volatile storage “front door” for the project. +// +// What you get +// - A single global NV system (`nv()`) that owns the selected storage backend +// (real EEPROM, FRAM, or flash/EEPROM-emulation), plus optional shims. +// - A volume manager (`NvVolume`) on top of that device, which provides named partitions. +// - A small KV store (`nv().kv()`) for persisting settings/structures by name. +// +// Typical usage pattern +// 1) nv().init(); // initialize backend + start background service +// 2) nv().volume().mount(...); // mount/format volume as needed (elsewhere) +// 3) nv().kv().init(nv().volume(),"KV");// bind KV store to the "KV" partition +// 4) nv().kv().getOrInit("NAME", obj); // load settings or write defaults +// +// Selecting KV16 vs KV32 +// - This header can build with either KV implementation, chosen at compile time by +// NV_USE_KV32 in NvConfig.h. +// - KV16 (NvKvPartition16) is the compact option for small EEPROM/FRAM. +// - KV32 (NvKvPartition32) supports larger entries/files and uses a wider key. +// - Call sites should NOT care which is used: prefer `KvPartition::Status::Ok` and +// access the store through `nv().kv()`. +// +// Background servicing +// - Background servicing is automatic using lib/OnTask, additionally +// setGate() can temporarily suspend this servicing when the system is busy. +// +// Notes for new users +// - If NV_DRIVER is OFF, nv().init() will fail (storage disabled). +// - This layer is intentionally small and deterministic: fixed-size partition, +// overwrite-in-place updates, and a rebuild-on-boot allocation scan. +// ----------------------------------------------------------------------------------- +#pragma once + +#include "../../Common.h" + +#include "device/NvDeviceBase.h" + +#include "NvConfig.h" +#include "NvVolume.h" + +#if NV_USE_KV32 == ON + #include "NvKvPartition32.h" + #define KvPartition KvPartition32 +#else + #include "NvKvPartition16.h" + #define KvPartition KvPartition16 +#endif + +class NvSystem { +public: + // Initializes backend (and optional shim), then binds NvVolume to nvActive. + bool init(uint8_t priorityLevel = 7); + + // Overwrite the entire associated device with 0xFF + void wipe(); + + // Gate on xBusy status + void setGate(bool *gate) { gate_ = gate; } + + bool ok() const { return ok_; } + + // Raw backend device (selected by NV_DRIVER) + NvDevice& device(); + + // Device you should use everywhere (raw or shimmed) + NvDevice& active(); + + // Volume manager bound to active() + NvVolume& volume(); + + void poll(); + + #if NV_USE_KV32 == ON + KvPartition32& kv() { return kv_; } + #else + KvPartition16& kv() { return kv_; } + #endif + +private: + bool canService_() const { return (gate_ == nullptr) ? true : !(*gate_); } + + #if NV_USE_KV32 == ON + KvPartition32 kv_; + #else + KvPartition16 kv_; + #endif + + bool ok_ = false; + bool *gate_ = nullptr; +}; + +NvSystem& nv(); diff --git a/src/lib/nv/NvConfig.h b/src/lib/nv/NvConfig.h new file mode 100755 index 0000000..55dae67 --- /dev/null +++ b/src/lib/nv/NvConfig.h @@ -0,0 +1,88 @@ +// NvConfig.h +#pragma once +#include + +// Provide driver-dependent defaults for: +// - E2END (sizeBytes = E2END + 1) +// - NV_I2C_ADDRESS (7-bit I2C addr) [I2C devices only] +// - NV_WAIT_MS (only meaningful for emulated EEPROM backends) +// + +#ifndef NV_DRIVER + #error "NV_DRIVER must be defined before including NvConfig.h" +#endif + +// OFF = KvPartition16 (16B blocks / v1), ON = KvPartition32 (virtual 32B blocks / v2) +#ifndef NV_USE_KV32 + #define NV_USE_KV32 OFF +#endif + +// NV_SHIM options +#define NV_SHIM_OFF 0 +#define NV_SHIM_CACHED 1 +#define NV_SHIM_DELAYED 2 + +// If your VM requires size to be multiple-of-16, enforce it (default ON). +#ifndef NVS_REQUIRE_SIZE_MULTIPLE_OF_16 + #define NVS_REQUIRE_SIZE_MULTIPLE_OF_16 0 +#endif + +// ---- Default I2C address (7-bit) ------------------------------------------------ +// Only meaningful for I2C devices. User may override by defining NV_I2C_ADDRESS earlier. +#if (NV_DRIVER == NV_2416) || (NV_DRIVER == NV_2432) || (NV_DRIVER == NV_2464) || \ + (NV_DRIVER == NV_24128) || (NV_DRIVER == NV_24256) || (NV_DRIVER == NV_AT24C32) || \ + (NV_DRIVER == NV_MB85RC32) || (NV_DRIVER == NV_MB85RC64) || (NV_DRIVER == NV_MB85RC256) + + #ifndef NV_I2C_ADDRESS + #if (NV_DRIVER == NV_AT24C32) + #define NV_I2C_ADDRESS 0x57 // common ZS042 module + #else + #define NV_I2C_ADDRESS 0x50 + #endif + #endif + + #ifndef NV_SHIM + #define NV_SHIM NV_SHIM_CACHED + #endif + + #ifndef NV_DEVICE_I2C + #define NV_DEVICE_I2C + #endif + +#endif + +// ---- Default shim selection for emulated EEPROM backends ----------------------- +#if (NV_DRIVER == NV_ESP) || (NV_DRIVER == NV_M0) + #ifndef NV_SHIM + #define NV_SHIM NV_SHIM_DELAYED + #endif +#endif + +// ---- Default shim selection for emulated EEPROM backends ----------------------- +#if NV_DRIVER == NV_EEPROM + #ifndef NV_SHIM + #define NV_SHIM NV_SHIM_CACHED + #endif +#endif + +// ---- Sanity checks -------------------------------------------------------------- +// Your system constraint: <= 65536 bytes +#if ((E2END + 1u) > 65536u) + #error "E2END+1 exceeds 65536 bytes" +#endif + +#if NVS_REQUIRE_SIZE_MULTIPLE_OF_16 + #if (((E2END + 1u) & 15u) != 0) + #error "NV size (E2END+1) must be a multiple of 16 bytes" + #endif +#endif + +#ifndef NV_SHIM + #define NV_SHIM NV_SHIM_OFF +#endif + +#if (NV_SHIM == NV_SHIM_DELAYED) + #ifndef NV_WAIT_MS + #define NV_WAIT_MS 5000u + #endif +#endif diff --git a/src/lib/nv/NvIvPartition.cpp b/src/lib/nv/NvIvPartition.cpp new file mode 100755 index 0000000..c10d596 --- /dev/null +++ b/src/lib/nv/NvIvPartition.cpp @@ -0,0 +1,101 @@ +// ------------------------------------------------------------------------------------------------- +// NvIvPartition.cpp +#include "NvIvPartition.h" + +bool IvPartition::init(NvVolume& vol, uint8_t partIdx) { + vol_ = &vol; + partIdx_ = partIdx; + ready_ = false; + partBytes_ = 0; + + if (!vol_->isMounted()) return false; + if (partIdx_ >= vol_->partitionCount()) return false; + + partBytes_ = vol_->partitionByteSize(partIdx_); + if (partBytes_ == 0) return false; + + // partitionByteSize is expected to be a multiple of block size; if not, refuse. + if ((partBytes_ % kBlockSize) != 0) return false; + + ready_ = true; + return true; +} + +// bind by ASCII partition name (requires SB1 present/valid) +bool IvPartition::init(NvVolume& vol, const char* partitionAscii) { + if (!partitionAscii || !partitionAscii[0]) return false; + if (!vol.isMounted()) return false; + + uint8_t idx = 0xFF; + if (!vol.partitionFind(partitionAscii, idx)) return false; + return init(vol, idx); +} + +// bind by name16 tag (requires SB1 present/valid) +bool IvPartition::init(NvVolume& vol, uint16_t partitionName16) { + if (partitionName16 == 0) return false; // 0 reserved/unnamed + if (!vol.isMounted()) return false; + + int8_t idx = vol.partitionFindByName16(partitionName16); + if (idx < 0) return false; + + return init(vol, (uint8_t)idx); +} + +IvPartition::NvVolStatus IvPartition::readBlock(uint16_t partBlock, uint8_t out16[kBlockSize]) { + if (!isReady()) return NvVolStatus::NotReady; + if (!out16) return NvVolStatus::IoError; + if (partBlock >= sizeBlocks()) return NvVolStatus::OutOfRange; + return vol_->partitionReadBlock(partIdx_, partBlock, out16); +} + +IvPartition::NvVolStatus IvPartition::writeBlock(uint16_t partBlock, const uint8_t in16[kBlockSize]) { + if (!isReady()) return NvVolStatus::NotReady; + if (!vol_->isWritable()) return NvVolStatus::ReadOnly; + if (!in16) return NvVolStatus::IoError; + if (partBlock >= sizeBlocks()) return NvVolStatus::OutOfRange; + return vol_->partitionWriteBlock(partIdx_, partBlock, in16); +} + +IvPartition::NvVolStatus IvPartition::readBytes(uint16_t offset, void* dst, uint16_t len) { + if (!isReady()) return NvVolStatus::NotReady; + if (len == 0) return NvVolStatus::Ok; + if (!dst) return NvVolStatus::IoError; + if ((uint32_t)offset + (uint32_t)len > (uint32_t)partBytes_) return NvVolStatus::OutOfRange; + + // Pass-through: NvVolume/backend owns any alignment/RMW/device constraints. + return vol_->partitionRead(partIdx_, offset, dst, len); +} + +IvPartition::NvVolStatus IvPartition::writeBytes(uint16_t offset, const void* src, uint16_t len) { + if (!isReady()) return NvVolStatus::NotReady; + if (!vol_->isWritable()) return NvVolStatus::ReadOnly; + if (len == 0) return NvVolStatus::Ok; + if (!src) return NvVolStatus::IoError; + if ((uint32_t)offset + (uint32_t)len > (uint32_t)partBytes_) return NvVolStatus::OutOfRange; + + // Pass-through: NvVolume/backend owns any alignment/RMW/device constraints. + return vol_->partitionWrite(partIdx_, offset, src, len); +} + +IvPartition::NvVolStatus IvPartition::clearBytes(uint16_t offset, uint16_t len) { + if (!isReady()) return NvVolStatus::NotReady; + if (!vol_->isWritable()) return NvVolStatus::ReadOnly; + if (len == 0) return NvVolStatus::Ok; + if ((uint32_t)offset + (uint32_t)len > (uint32_t)partBytes_) return NvVolStatus::OutOfRange; + + // Chunked zeros; NvVolume/backend handles any required alignment/merging. + uint8_t zchunk[32]; + memset(zchunk, 0, sizeof(zchunk)); + + uint16_t remaining = len; + uint16_t off = offset; + while (remaining) { + uint16_t take = (remaining > (uint16_t)sizeof(zchunk)) ? (uint16_t)sizeof(zchunk) : remaining; + NvVolStatus st = vol_->partitionWrite(partIdx_, off, zchunk, take); + if (st != NvVolStatus::Ok) return st; + off = (uint16_t)(off + take); + remaining = (uint16_t)(remaining - take); + } + return NvVolStatus::Ok; +} diff --git a/src/lib/nv/NvIvPartition.h b/src/lib/nv/NvIvPartition.h new file mode 100755 index 0000000..6a24643 --- /dev/null +++ b/src/lib/nv/NvIvPartition.h @@ -0,0 +1,87 @@ +// ------------------------------------------------------------------------------------------------- +// NvIvPartition.h +// +// Index/Value partition +// +// Provides a simple "flat byte array" API over a volume partition, plus typed helpers. +// +// - Addressing: partition-local offsets [0 .. partitionByteSize-1]. +// - Alignment/RMW: This layer does NOT perform block-based RMW. +// Any underlying device constraints (e.g., 16-byte aligned/multiple-of-16 I/O) must be +// satisfied/handled by NvVolume and/or the selected backend. +// - Endianness: typed helpers store the host representation as raw bytes. +// (If you need a stable cross-platform format, add explicit LE/BE conversions.) +// +// This layer does NOT add its own CRC. If you want integrity, store CRC fields in your payload +// or use the KV partition for "file-like" items with CRC. +// +// ------------------------------------------------------------------------------------------------- +#pragma once + +#include +#include + +#include "NvVolume.h" + +class IvPartition { +public: + using NvVolStatus = NvVolume::Status; + static constexpr uint16_t kBlockSize = NvVolume::kBlockSize; // 16 + + IvPartition() = default; + + // Bind to a mounted volume + partition index. + bool init(NvVolume& vol, uint8_t partIdx); + + // Bind by ASCII partition name (requires valid SB1 names block). + bool init(NvVolume& vol, const char* partitionAscii); + + // Bind by partition name16 tag (requires valid SB1 names block). + bool init(NvVolume& vol, uint16_t partitionName16); + + bool isReady() const { return (vol_ != nullptr) && ready_; } + uint8_t partIndex() const { return partIdx_; } + + uint16_t sizeBytes() const { return partBytes_; } + uint16_t sizeBlocks() const { return (uint16_t)(partBytes_ / kBlockSize); } + + // Explicit block ops (partition-local block index). + // These are useful for callers that already operate on block granularity. + NvVolStatus readBlock(uint16_t partBlock, uint8_t out16[kBlockSize]); + NvVolStatus writeBlock(uint16_t partBlock, const uint8_t in16[kBlockSize]); + + // Raw byte access (pass-through; NvVolume/backend handles any alignment/device constraints). + NvVolStatus readBytes(uint16_t offset, void* dst, uint16_t len); + NvVolStatus writeBytes(uint16_t offset, const void* src, uint16_t len); + + // Zero-fill a range (implemented via small chunked writes). + NvVolStatus clearBytes(uint16_t offset, uint16_t len); + + // Typed helpers + template + NvVolStatus read(uint16_t offset, T& outVal) { + return readBytes(offset, &outVal, (uint16_t)sizeof(T)); + } + + template + NvVolStatus write(uint16_t offset, const T& val) { + return writeBytes(offset, &val, (uint16_t)sizeof(T)); + } + + template + NvVolStatus readArray(uint16_t offset, T* outVals, uint16_t count) { + return readBytes(offset, outVals, (uint16_t)(sizeof(T) * count)); + } + + template + NvVolStatus writeArray(uint16_t offset, const T* vals, uint16_t count) { + return writeBytes(offset, vals, (uint16_t)(sizeof(T) * count)); + } + +private: + NvVolume* vol_ = nullptr; + uint8_t partIdx_ = 0; + bool ready_ = false; + + uint16_t partBytes_ = 0; +}; diff --git a/src/lib/nv/NvKvPartition16.cpp b/src/lib/nv/NvKvPartition16.cpp new file mode 100755 index 0000000..8ce7a60 --- /dev/null +++ b/src/lib/nv/NvKvPartition16.cpp @@ -0,0 +1,722 @@ +// ----------------------------------------------------------------------------------- +// NvKvPartition16.cpp +#include "NvKvPartition16.h" + +#if defined(ARDUINO) + #include +#elif defined(ARDUINO_ARCH_AVR) + #include +#endif + +namespace { +static inline uint8_t readProgByte16_(const char* p) { +#if defined(ARDUINO_ARCH_AVR) + return (uint8_t)pgm_read_byte(p); +#else + return (uint8_t)(*p); +#endif +} +} + +bool KvPartition16::initGeom_() { + if (!vol_) return false; + + const uint16_t pb = vol_->partitionBlockSize(partIdx_); + if (pb < 2u) return false; + if (pb > MAX_PART_BLOCKS) return false; + + uint32_t t = (uint32_t)pb * (uint32_t)KEY_TABLE_PERCENT + 500u; + t /= 1000u; + if (t < 1u) t = 1u; + + const uint16_t tableMax = (uint16_t)(pb / 2u); + if (t > tableMax) t = tableMax; + + const uint16_t minTableForAddr8 = (pb > 255u) ? (uint16_t)(pb - 255u) : 0u; + if (t < minTableForAddr8) t = minTableForAddr8; + if (t > tableMax) t = tableMax; + + g_.partBlocks = pb; + g_.tableBlocks = (uint16_t)t; + g_.slotCount = g_.tableBlocks; + + if (g_.tableBlocks == 0u || g_.tableBlocks >= g_.partBlocks) return false; + + g_.dataBegin = g_.tableBlocks; + { + uint16_t dc = (uint16_t)(g_.partBlocks - g_.dataBegin); + if (dc > 255u) dc = 255u; + g_.dataCount = dc; + } + + g_.mainPoolBase = g_.dataBegin; + return g_.dataCount != 0u; +} + +KvPartition16::Status KvPartition16::init(NvVolume& vol, uint8_t partIdx) { + if (!vol.isMounted()) return status_ = Status::NotBound; + if (partIdx >= vol.partitionCount()) return status_ = Status::BadGeom; + + vol_ = &vol; + partIdx_ = partIdx; + allocInit_ = false; + memset(allocBits_, 0, sizeof(allocBits_)); + + if (!initGeom_()) return status_ = Status::BadGeom; + + const Status s = initAllocMap_(); + if (s != Status::Ok) { + allocInit_ = false; + return status_ = s; + } + + return status_ = Status::Ok; +} + +KvPartition16::Status KvPartition16::init(NvVolume& vol, uint16_t partitionName16) { + if (partitionName16 == 0u) return status_ = Status::BadGeom; + if (!vol.isMounted()) return status_ = Status::NotBound; + + const int8_t idx = vol.partitionFindByName16(partitionName16); + if (idx < 0) return status_ = Status::NotBound; + + return init(vol, (uint8_t)idx); +} + +KvPartition16::Status KvPartition16::init(NvVolume& vol, const char* partitionAscii) { + if (!partitionAscii || !partitionAscii[0]) return status_ = Status::BadGeom; + if (!vol.isMounted()) return status_ = Status::NotBound; + + uint8_t idx = 0; + if (!vol.partitionFind(partitionAscii, idx)) return status_ = Status::NotBound; + + return init(vol, idx); +} + +KvPartition16::Status KvPartition16::readSlot_(uint16_t slotIdx, uint8_t A[16]) { + if (!vol_) return Status::NotBound; + if (slotIdx >= g_.slotCount) return Status::OutOfRange; + + const uint16_t bo = slotToBlockOfs_(slotIdx); + return (vol_->partitionReadBlock(partIdx_, bo, A) == NvVolume::Status::Ok) ? Status::Ok : Status::IoError; +} + +KvPartition16::Status KvPartition16::writeSlot_(uint16_t slotIdx, const uint8_t A[16]) { + if (!vol_) return Status::NotBound; + if (slotIdx >= g_.slotCount) return Status::OutOfRange; + + const uint16_t bo = slotToBlockOfs_(slotIdx); + return (vol_->partitionWriteBlock(partIdx_, bo, A) == NvVolume::Status::Ok) ? Status::Ok : Status::IoError; +} + +KvPartition16::Status KvPartition16::readSlotName24_(uint16_t slotIdx, uint32_t& outName24) { + if (!vol_) return Status::NotBound; + if (slotIdx >= g_.slotCount) return Status::OutOfRange; + + const uint16_t bo = slotToBlockOfs_(slotIdx); + uint8_t n3[3]; + if (vol_->partitionReadInBlock(partIdx_, bo, 0, n3, 3) != NvVolume::Status::Ok) return Status::IoError; + outName24 = le24_(n3) & 0x00FFFFFFu; + return Status::Ok; +} + +KvPartition16::Status KvPartition16::readDataBlockByAddr_(uint8_t addr8, uint8_t out16[16]) const { + if (!vol_) return Status::NotBound; + if (!dataAddrValid_(addr8)) return Status::Corrupt; + + const uint16_t b = dataAddrToBlock_(addr8); + return (vol_->partitionReadBlock(partIdx_, b, out16) == NvVolume::Status::Ok) ? Status::Ok : Status::IoError; +} + +KvPartition16::Status KvPartition16::writeDataBlockByAddr_(uint8_t addr8, const uint8_t in16[16]) { + if (!vol_) return Status::NotBound; + if (!dataAddrValid_(addr8)) return Status::OutOfRange; + + const uint16_t b = dataAddrToBlock_(addr8); + return (vol_->partitionWriteBlock(partIdx_, b, in16) == NvVolume::Status::Ok) ? Status::Ok : Status::IoError; +} + +KvPartition16::Status KvPartition16::decodeEntry_(const uint8_t A[16], Decoded& out) const { + out = Decoded{}; + + out.flags3 = hdrFlags3_(A[3]); + out.len5 = hdrLen5_(A[3]); + + const bool fInlineOnly = (out.flags3 & FLAG_INLINE_ONLY) != 0u; + const bool fInlinePlus = (out.flags3 & FLAG_INLINE_PLUS_BLOCK) != 0u; + const bool fTail = (out.flags3 & FLAG_TAIL) != 0u; + + if (fInlineOnly) { + if (fInlinePlus || fTail) return Status::Corrupt; + if (out.len5 > INLINE_CAP) return Status::Corrupt; + + out.mode = Mode::InlineOnly; + out.inlineLen = out.len5; + return Status::Ok; + } + + if (fInlinePlus) { + if (fTail) return Status::Corrupt; + if (out.len5 <= INLINE_PLUS_HEAD_CAP || out.len5 > (uint8_t)(INLINE_PLUS_HEAD_CAP + BLOCK_BYTES)) return Status::Corrupt; + + uint8_t body[9]; + bodyRead_(A, body); + + if (!dataAddrValid_(body[8])) return Status::Corrupt; + + out.mode = Mode::InlinePlusBlock; + out.inlineLen = INLINE_PLUS_HEAD_CAP; + out.oneBlockAddr = body[8]; + return Status::Ok; + } + + if (!fTail) return Status::Corrupt; + if (out.len5 < 1u || out.len5 > BLOCK_BYTES) return Status::Corrupt; + + uint8_t body[9]; + bodyRead_(A, body); + + out.mode = Mode::AddrList; + out.tailLen = out.len5; + out.blockCount = 0; + + for (uint8_t i = 0; i < ADDR_CAP; i++) { + const uint8_t a = body[i]; + if (a == ADDR_END) break; + if (!dataAddrValid_(a)) return Status::Corrupt; + + out.blocks[out.blockCount++] = a; + } + + if (out.blockCount == 0u) return Status::Corrupt; + out.blocks[out.blockCount] = ADDR_END; + return Status::Ok; +} + +uint16_t KvPartition16::payloadLenBytes_(const Decoded& d) const { + if (d.mode == Mode::InlineOnly) return d.inlineLen; + if (d.mode == Mode::InlinePlusBlock) return d.len5; + + if (d.blockCount == 0u) return 0u; + return (uint16_t)(((uint16_t)(d.blockCount - 1u) * BLOCK_BYTES) + d.tailLen); +} + +KvPartition16::Status KvPartition16::computeFullCrc24_(const uint8_t A[16], uint32_t& outCrc24) const { + if (!vol_) return Status::NotBound; + + Decoded d; + const Status ds = decodeEntry_(A, d); + if (ds != Status::Ok) return ds; + + uint8_t Ac[16]; + memcpy(Ac, A, 16); + Ac[13] = 0; + Ac[14] = 0; + Ac[15] = 0; + + uint32_t crc = Crc24::init(); + crc = Crc24::update(crc, Ac, 16); + + if (d.mode == Mode::InlinePlusBlock) { + uint8_t blk[16]; + const Status rs = readDataBlockByAddr_(d.oneBlockAddr, blk); + if (rs != Status::Ok) return rs; + crc = Crc24::update(crc, blk, 16); + } else if (d.mode == Mode::AddrList) { + for (uint8_t i = 0; i < d.blockCount; i++) { + uint8_t blk[16]; + const Status rs = readDataBlockByAddr_(d.blocks[i], blk); + if (rs != Status::Ok) return rs; + crc = Crc24::update(crc, blk, 16); + } + } + + outCrc24 = crc & 0x00FFFFFFu; + return Status::Ok; +} + +KvPartition16::Status KvPartition16::validateEntryCrc_(const uint8_t A[16]) const { + const uint32_t stored = loadCrc24LE_(A) & 0x00FFFFFFu; + uint32_t calc = 0; + const Status s = computeFullCrc24_(A, calc); + if (s != Status::Ok) return s; + return (((stored ^ calc) & 0x00FFFFFFu) == 0u) ? Status::Ok : Status::Corrupt; +} + +void KvPartition16::markUsed_(uint16_t blockIdx, bool used) { + if (blockIdx >= g_.partBlocks) return; + + const uint16_t byteIdx = (uint16_t)(blockIdx >> 3); + const uint8_t mask = (uint8_t)(1u << (blockIdx & 7u)); + if (byteIdx >= BITMAP_BYTES) return; + + if (used) allocBits_[byteIdx] |= mask; + else allocBits_[byteIdx] &= (uint8_t)~mask; +} + +bool KvPartition16::isUsed_(uint16_t blockIdx) const { + if (blockIdx >= g_.partBlocks) return true; + + const uint16_t byteIdx = (uint16_t)(blockIdx >> 3); + const uint8_t mask = (uint8_t)(1u << (blockIdx & 7u)); + if (byteIdx >= BITMAP_BYTES) return true; + + return (allocBits_[byteIdx] & mask) != 0u; +} + +void KvPartition16::freeEntryBlocksFromMap_(const uint8_t A[16]) { + Decoded d; + if (decodeEntry_(A, d) != Status::Ok) return; + + if (d.mode == Mode::InlinePlusBlock) { + if (dataAddrValid_(d.oneBlockAddr)) markUsed_(dataAddrToBlock_(d.oneBlockAddr), false); + return; + } + + if (d.mode == Mode::AddrList) { + for (uint8_t i = 0; i < d.blockCount; i++) { + if (dataAddrValid_(d.blocks[i])) markUsed_(dataAddrToBlock_(d.blocks[i]), false); + } + } +} + +KvPartition16::Status KvPartition16::findSlot_(uint32_t name24, uint16_t& outSlot, uint8_t A[16]) { + if (!vol_) return Status::NotBound; + name24 &= 0x00FFFFFFu; + + for (uint16_t i = 0; i < g_.slotCount; i++) { + uint32_t n = 0; + const Status ns = readSlotName24_(i, n); + if (ns != Status::Ok) return ns; + if (n != name24) continue; + + const Status rs = readSlot_(i, A); + if (rs != Status::Ok) return rs; + + const Status vs = validateEntryCrc_(A); + if (vs == Status::IoError) return vs; + if (vs != Status::Ok) continue; + + outSlot = i; + return Status::Ok; + } + + return Status::NotFound; +} + +KvPartition16::Status KvPartition16::findOrAllocSlot_(uint32_t name24, uint16_t& outSlot, uint8_t A[16], bool& outIsExisting) { + int16_t firstEmpty = -1; + int16_t firstCorruptMatch = -1; + name24 &= 0x00FFFFFFu; + + for (uint16_t i = 0; i < g_.slotCount; i++) { + uint32_t n = 0; + const Status ns = readSlotName24_(i, n); + if (ns != Status::Ok) return ns; + + if (n == name24) { + const Status rs = readSlot_(i, A); + if (rs != Status::Ok) return rs; + + const Status vs = validateEntryCrc_(A); + if (vs == Status::IoError) return vs; + + if (vs != Status::Ok) { + if (firstCorruptMatch < 0) firstCorruptMatch = (int16_t)i; + continue; + } + + outSlot = i; + outIsExisting = true; + return Status::Ok; + } + + if (n == EMPTY_NAME24 && firstEmpty < 0) firstEmpty = (int16_t)i; + } + + if (firstCorruptMatch >= 0) { + outSlot = (uint16_t)firstCorruptMatch; + outIsExisting = false; + return Status::Ok; + } + + if (firstEmpty >= 0) { + outSlot = (uint16_t)firstEmpty; + outIsExisting = false; + return Status::Ok; + } + + return Status::NoSpace; +} + +KvPartition16::Status KvPartition16::initAllocMap_() { + memset(allocBits_, 0, sizeof(allocBits_)); + + for (uint16_t b = 0; b < g_.dataBegin; b++) markUsed_(b, true); + for (uint16_t b = (uint16_t)(g_.dataBegin + g_.dataCount); b < g_.partBlocks; b++) markUsed_(b, true); + + uint8_t A[16]; + + for (uint16_t i = 0; i < g_.slotCount; i++) { + Status s = readSlot_(i, A); + if (s != Status::Ok) { allocInit_ = false; return s; } + + const uint32_t n = le24_(&A[0]) & 0x00FFFFFFu; + if (n == EMPTY_NAME24) continue; + + const Status vs = validateEntryCrc_(A); + if (vs == Status::IoError) { allocInit_ = false; return Status::IoError; } + if (vs != Status::Ok) continue; + + Decoded d; + if (decodeEntry_(A, d) != Status::Ok) continue; + + if (d.mode == Mode::InlinePlusBlock) { + markUsed_(dataAddrToBlock_(d.oneBlockAddr), true); + } else if (d.mode == Mode::AddrList) { + for (uint8_t k = 0; k < d.blockCount; k++) markUsed_(dataAddrToBlock_(d.blocks[k]), true); + } + } + + allocInit_ = true; + return Status::Ok; +} + +KvPartition16::Status KvPartition16::allocDataBlocks_(uint8_t count, uint8_t outAddrs[ADDR_CAP]) { + if (count == 0u || count > ADDR_CAP) return Status::OutOfRange; + if (!allocInit_) return Status::Corrupt; + + uint8_t got = 0; + + const uint16_t first = g_.dataBegin; + const uint16_t last = (uint16_t)(g_.dataBegin + g_.dataCount - 1u); + + for (int32_t b = (int32_t)last; b >= (int32_t)first; --b) { + const uint16_t bb = (uint16_t)b; + if (isUsed_(bb)) continue; + + markUsed_(bb, true); + outAddrs[got++] = (uint8_t)(bb - g_.dataBegin); + if (got == count) return Status::Ok; + } + + for (uint8_t i = 0; i < got; i++) markUsed_(dataAddrToBlock_(outAddrs[i]), false); + + return Status::NoSpace; +} + +KvPartition16::Status KvPartition16::get(uint32_t name24, void* dst, uint16_t dstCap, uint16_t& outLen) { + if (!vol_) return Status::NotBound; + name24 &= 0x00FFFFFFu; + if (name24 == EMPTY_NAME24) return Status::OutOfRange; + + uint8_t A[16]; + uint16_t slot = 0; + const Status fs = findSlot_(name24, slot, A); + (void)slot; + if (fs != Status::Ok) return fs; + + Decoded d; + const Status ds = decodeEntry_(A, d); + if (ds != Status::Ok) return ds; + + outLen = payloadLenBytes_(d); + if (!dst) return Status::Ok; + if (dstCap < outLen) return Status::OutOfRange; + + uint8_t* p = (uint8_t*)dst; + + if (d.mode == Mode::InlineOnly) { + uint8_t body[9]; + bodyRead_(A, body); + if (d.inlineLen) memcpy(p, body, d.inlineLen); + return Status::Ok; + } + + if (d.mode == Mode::InlinePlusBlock) { + uint8_t body[9]; + bodyRead_(A, body); + memcpy(p, body, INLINE_PLUS_HEAD_CAP); + + uint8_t blk[16]; + const Status rs = readDataBlockByAddr_(d.oneBlockAddr, blk); + if (rs != Status::Ok) return rs; + + const uint8_t tail = (uint8_t)(d.len5 - INLINE_PLUS_HEAD_CAP); + if (tail) memcpy(p + INLINE_PLUS_HEAD_CAP, blk, tail); + return Status::Ok; + } + + uint16_t written = 0; + for (uint8_t i = 0; i < d.blockCount; i++) { + uint8_t blk[16]; + const Status rs = readDataBlockByAddr_(d.blocks[i], blk); + if (rs != Status::Ok) return rs; + + const bool isLast = (i == (uint8_t)(d.blockCount - 1u)); + const uint8_t n = isLast ? d.tailLen : BLOCK_BYTES; + + memcpy(p + written, blk, n); + written = (uint16_t)(written + n); + } + + return (written == outLen) ? Status::Ok : Status::Corrupt; +} + +KvPartition16::Status KvPartition16::put(uint32_t name24, const void* src, uint16_t len) { + if (!vol_) return Status::NotBound; + if (!src && len) return Status::OutOfRange; + if (!allocInit_) return Status::Corrupt; + + name24 &= 0x00FFFFFFu; + if (name24 == EMPTY_NAME24) return Status::OutOfRange; + + if (len > (uint16_t)(ADDR_CAP * BLOCK_BYTES)) return Status::OutOfRange; + + uint8_t Aold[16]; + uint16_t slot = 0; + bool existing = false; + + Status s = findOrAllocSlot_(name24, slot, Aold, existing); + if (s != Status::Ok) return s; + + if (!existing) memset(Aold, 0xFF, sizeof(Aold)); + + bool freedOld = false; + { + const Status vs = validateEntryCrc_(Aold); + if (vs == Status::Ok) { + freeEntryBlocksFromMap_(Aold); + freedOld = true; + } else if (vs == Status::IoError) { + return Status::IoError; + } + } + + uint8_t A[16]; + memset(A, 0xFF, sizeof(A)); + wrle24_(&A[0], name24); + + const uint8_t* p = (const uint8_t*)src; + + if (len <= INLINE_CAP) { + A[3] = packHeader_(FLAG_INLINE_ONLY, (uint8_t)len); + + uint8_t body[9]; + memset(body, 0xFF, sizeof(body)); + if (len) memcpy(body, p, len); + bodyWrite_(A, body); + + uint32_t crc24 = 0; + Status cs = computeFullCrc24_(A, crc24); + if (cs != Status::Ok) { invalidateAlloc_(); return cs; } + storeCrc24LE_(A, crc24); + + Status ws = writeSlot_(slot, A); + if (ws == Status::IoError) invalidateAlloc_(); + return ws; + } + + if (len <= (uint16_t)(INLINE_PLUS_HEAD_CAP + BLOCK_BYTES)) { + uint8_t addrs[ADDR_CAP] = {0}; + s = allocDataBlocks_(1u, addrs); + if (s != Status::Ok) { + if (freedOld) invalidateAlloc_(); + return s; + } + + uint8_t blk[16]; + memset(blk, 0xFF, sizeof(blk)); + const uint8_t tail = (uint8_t)(len - INLINE_PLUS_HEAD_CAP); + if (tail) memcpy(blk, p + INLINE_PLUS_HEAD_CAP, tail); + + Status wsb = writeDataBlockByAddr_(addrs[0], blk); + if (wsb != Status::Ok) { + markUsed_(dataAddrToBlock_(addrs[0]), false); + invalidateAlloc_(); + return wsb; + } + + A[3] = packHeader_(FLAG_INLINE_PLUS_BLOCK, (uint8_t)len); + + uint8_t body[9]; + memset(body, 0xFF, sizeof(body)); + memcpy(body, p, INLINE_PLUS_HEAD_CAP); + body[8] = addrs[0]; + bodyWrite_(A, body); + + uint32_t crc24 = 0; + Status cs = computeFullCrc24_(A, crc24); + if (cs != Status::Ok) { invalidateAlloc_(); return cs; } + storeCrc24LE_(A, crc24); + + Status ws = writeSlot_(slot, A); + if (ws == Status::IoError) invalidateAlloc_(); + return ws; + } + + const uint8_t blocksNeeded = (uint8_t)((len + (BLOCK_BYTES - 1u)) / BLOCK_BYTES); + if (blocksNeeded == 0u || blocksNeeded > ADDR_CAP) return Status::OutOfRange; + + uint8_t addrs[ADDR_CAP] = {0}; + s = allocDataBlocks_(blocksNeeded, addrs); + if (s != Status::Ok) { + if (freedOld) invalidateAlloc_(); + return s; + } + + uint8_t tmp[16]; + for (uint8_t i = 0; i < blocksNeeded; i++) { + memset(tmp, 0xFF, sizeof(tmp)); + + const uint16_t ofs = (uint16_t)i * BLOCK_BYTES; + const uint16_t avail = (len > ofs) ? (uint16_t)(len - ofs) : 0u; + const uint16_t chunk = (avail >= BLOCK_BYTES) ? BLOCK_BYTES : avail; + if (chunk) memcpy(tmp, p + ofs, chunk); + + Status ws = writeDataBlockByAddr_(addrs[i], tmp); + if (ws != Status::Ok) { + for (uint8_t k = 0; k < blocksNeeded; k++) markUsed_(dataAddrToBlock_(addrs[k]), false); + invalidateAlloc_(); + return ws; + } + } + + const uint8_t tailLen = (uint8_t)((len & (BLOCK_BYTES - 1u)) ? (len & (BLOCK_BYTES - 1u)) : BLOCK_BYTES); + A[3] = packHeader_(FLAG_TAIL, tailLen); + + uint8_t body[9]; + memset(body, ADDR_END, sizeof(body)); + for (uint8_t i = 0; i < blocksNeeded; i++) body[i] = addrs[i]; + bodyWrite_(A, body); + + uint32_t crc24 = 0; + Status cs = computeFullCrc24_(A, crc24); + if (cs != Status::Ok) { invalidateAlloc_(); return cs; } + storeCrc24LE_(A, crc24); + + Status ws = writeSlot_(slot, A); + if (ws == Status::IoError) invalidateAlloc_(); + return ws; +} + +KvPartition16::Status KvPartition16::del(uint32_t name24) { + if (!vol_) return Status::NotBound; + if (!allocInit_) return Status::Corrupt; + + name24 &= 0x00FFFFFFu; + if (name24 == EMPTY_NAME24) return Status::OutOfRange; + + uint8_t A[16]; + uint16_t slot = 0; + const Status fs = findSlot_(name24, slot, A); + if (fs != Status::Ok) return fs; + + if (validateEntryCrc_(A) == Status::Ok) freeEntryBlocksFromMap_(A); + + memset(A, 0xFF, sizeof(A)); + + Status ws = writeSlot_(slot, A); + if (ws == Status::IoError) invalidateAlloc_(); + return ws; +} + +uint32_t KvPartition16::computeKey(const char* nameAscii) { + uint32_t crc = Crc24::init(); + crc = Crc24::update(crc, (const uint8_t*)KV_NAME_SALT, (uint16_t)strlen(KV_NAME_SALT)); + crc = Crc24::update(crc, (const uint8_t*)(nameAscii ? nameAscii : ""), (uint16_t)strlen(nameAscii ? nameAscii : "")); + return (crc & 0x00FFFFFFu); +} + +uint32_t KvPartition16::computeKey(const __FlashStringHelper* nameAsciiF) { +#if defined(ARDUINO) + if (!nameAsciiF) nameAsciiF = F(""); + + uint32_t crc = Crc24::init(); + crc = Crc24::update(crc, (const uint8_t*)KV_NAME_SALT, (uint16_t)strlen(KV_NAME_SALT)); + + const char* p = (const char*)nameAsciiF; + for (;;) { + const uint8_t c = readProgByte16_(p++); + if (c == 0) break; + crc = Crc24::updateByte(crc, c); + } + + return (crc & 0x00FFFFFFu); +#else + (void)nameAsciiF; + return computeKey(""); +#endif +} + +KvPartition16::Status KvPartition16::scrub(uint16_t* outDeleted) { + if (outDeleted) *outDeleted = 0; + + if (!vol_ || !vol_->isMounted()) return Status::NotBound; + if (!initGeom_()) return Status::BadGeom; + + uint8_t A[16]; + uint16_t deleted = 0; + + for (uint16_t i = 0; i < g_.slotCount; i++) { + const Status rs = readSlot_(i, A); + if (rs != Status::Ok) return rs; + + const uint32_t n = le24_(&A[0]) & 0x00FFFFFFu; + if (n == EMPTY_NAME24) continue; + + const Status vs = validateEntryCrc_(A); + if (vs == Status::Ok) continue; + if (vs == Status::IoError) return Status::IoError; + if (vs != Status::Corrupt) return vs; + + memset(A, 0xFF, sizeof(A)); + const Status ws = writeSlot_(i, A); + if (ws != Status::Ok) { + if (ws == Status::IoError) invalidateAlloc_(); + return ws; + } + + deleted++; + } + + const Status ms = initAllocMap_(); + if (ms != Status::Ok) { + if (ms == Status::IoError) invalidateAlloc_(); + return ms; + } + + if (outDeleted) *outDeleted = deleted; + return Status::Ok; +} + +KvPartition16::Status KvPartition16::stats(Stats& out) { + memset(&out, 0, sizeof(out)); + if (!vol_ || !vol_->isMounted()) return Status::NotBound; + if (!initGeom_()) return Status::BadGeom; + if (!allocInit_) return Status::Corrupt; + + out.dataBlocksTotal = g_.dataCount; + out.slotsTotal = g_.slotCount; + + uint16_t usedData = 0; + for (uint16_t a = 0; a < g_.dataCount; a++) { + const uint16_t b = (uint16_t)(g_.dataBegin + a); + const uint16_t byteIdx = (uint16_t)(b >> 3); + const uint8_t mask = (uint8_t)(1u << (b & 7u)); + if (byteIdx >= BITMAP_BYTES) break; + if (allocBits_[byteIdx] & mask) usedData++; + } + out.dataBlocksFree = (usedData <= g_.dataCount) ? (uint16_t)(g_.dataCount - usedData) : 0u; + + uint16_t empty = 0; + for (uint16_t i = 0; i < g_.slotCount; i++) { + uint32_t n = 0; + const Status ns = readSlotName24_(i, n); + if (ns != Status::Ok) return ns; + if (n == EMPTY_NAME24) empty++; + } + out.slotsFree = empty; + + return Status::Ok; +} diff --git a/src/lib/nv/NvKvPartition16.h b/src/lib/nv/NvKvPartition16.h new file mode 100755 index 0000000..7d15acf --- /dev/null +++ b/src/lib/nv/NvKvPartition16.h @@ -0,0 +1,302 @@ +// ----------------------------------------------------------------------------------- +// NvKvPartition16.h +// +// KV partition on 16-byte blocks (v1 format). +// +// This KV layer stores named blobs in a fixed-size partition. +// The partition is a 16-byte-block address space provided by NvVolume. +// Supported partition size: up to 8192 bytes (512 x 16B blocks). +// +// Layout +// - Table entries are stored at blocks [0 .. tableBlocks-1]. +// - Data blocks are stored at [dataBegin .. partBlocks-1], where dataBegin = tableBlocks. +// - tableBlocks targets KEY_TABLE_PERCENT (default 40%) and can slide upward +// to at most partBlocks/2 as needed so dataCount fits byte addressing. +// +// Terminology +// - Block: 16 bytes. +// - Data address (addr8): 8-bit index into the data region. +// addr8=0 -> physical block dataBegin +// addr8=1 -> physical block dataBegin+1 +// ... +// addr8=254 -> physical block dataBegin+254 +// - addr8 value 0xFF is reserved as ADDR_END sentinel. +// +// Keying +// - Each record key is name24: +// name24 = CRC24( KV_NAME_SALT + asciiName ) +// - CRC24 uses Crc24::init/update from Crc.h. +// +// Allocation model +// - Overwrite-in-place semantics; no compaction. +// - Data block allocation is top-down within the data region. +// - Addressable data region is limited to 255 blocks (0..254), clamped by partition size. +// +// =================================================================================================== +// v1 ENTRY FORMAT (16 bytes, one entry per key) +// a[0..2] : name24 (LE) +// a[3] : header = flags3 + len5 +// flags bits: +// FLAG_INLINE_ONLY : body contains inline payload only +// FLAG_INLINE_PLUS_BLOCK : body contains inline payload + one addr8 +// FLAG_TAIL : addr-list mode; len5 = bytes used in last block +// a[4..12] : body72 (9 bytes), interpreted by mode: +// - INLINE_ONLY: up to 9 inline bytes +// - INLINE_PLUS_BLOCK: 8 inline bytes + 1 addr8 +// - ADDR_LIST: up to 9 addr8 values (0xFF sentinel-terminated) +// a[13..15]: crc24 (LE), written last +// CRC covers entry (with crc bytes zeroed) and referenced payload blocks. +// +// Mode max payload sizes: +// - InlineOnly: 9 bytes +// - InlinePlusBlock: 8 + 16 = 24 bytes +// - AddrList: 9 * 16 = 144 bytes +// Overall max file size: 144 bytes +// ----------------------------------------------------------------------------------- +#pragma once + +#include +#include +#include + +#include "NvVolume.h" +#include "../math/Crc.h" + +class __FlashStringHelper; + +#ifndef MAX_BLOCKS + #define MAX_BLOCKS 2048u +#endif + +#ifndef KEY_TABLE_PERCENT + #define KEY_TABLE_PERCENT 400u // 40% table by default +#endif + +class KvPartition16 { +public: + enum class Status : uint8_t { + Ok = 0, + NotBound, + BadGeom, + IoError, + Corrupt, + NotFound, + NoSpace, + OutOfRange, + }; + + static constexpr uint8_t BLOCK_BYTES = 16u; + static constexpr uint8_t ADDR_END = 0xFFu; + static constexpr uint32_t EMPTY_NAME24 = 0x00FFFFFFu; + + static constexpr uint8_t FLAG_INLINE_ONLY = 0x01u; + static constexpr uint8_t FLAG_INLINE_PLUS_BLOCK = 0x02u; + static constexpr uint8_t FLAG_TAIL = 0x04u; + + static constexpr uint8_t INLINE_CAP = 9u; + static constexpr uint8_t INLINE_PLUS_HEAD_CAP = 8u; + static constexpr uint8_t ADDR_CAP = 9u; + static constexpr uint16_t MAX_PART_BLOCKS = 512u; + + struct Geom { + uint16_t partBlocks = 0; + uint16_t tableBlocks = 0; + uint16_t slotCount = 0; + uint16_t dataBegin = 0; + uint16_t dataCount = 0; + uint16_t mainPoolBase = 0; + }; + + struct Stats { + uint16_t dataBlocksTotal; + uint16_t dataBlocksFree; + uint16_t slotsTotal; + uint16_t slotsFree; + }; + + KvPartition16() = default; + + Status init(NvVolume& vol, uint8_t partIdx); + Status init(NvVolume& vol, uint16_t partitionName16); + Status init(NvVolume& vol, const char* partitionAscii); + + const Geom& geom() const { return g_; } + Status status() const { return status_; } + + Status get(uint32_t name24, void* dst, uint16_t dstCap, uint16_t& outLen); + Status put(uint32_t name24, const void* src, uint16_t len); + Status del(uint32_t name24); + + static uint32_t computeKey(const char* nameAscii); + static uint32_t computeKey(const __FlashStringHelper* nameAsciiF); + + Status get(const char* nameAscii, void* dst, uint16_t dstCap, uint16_t& outLen) { return get(name24_(nameAscii), dst, dstCap, outLen); } + Status put(const char* nameAscii, const void* src, uint16_t len) { return put(name24_(nameAscii), src, len); } + + Status put(const char* nameAscii, const char* zstr) { + if (!zstr) return put(nameAscii, (const void*)"", 1); + const uint16_t n = (uint16_t)strlen(zstr) + 1u; + return put(nameAscii, (const void*)zstr, n); + } + + Status del(const char* nameAscii) { return del(name24_(nameAscii)); } + + Status scrub(uint16_t* outDeleted); + + template + Status put(const char* nameAscii, const T& v) { return put(nameAscii, (const void*)&v, (uint16_t)sizeof(T)); } + + template + Status put(uint32_t name24, const T& v) { return put(name24, (const void*)&v, (uint16_t)sizeof(T)); } + + template + Status get(const char* nameAscii, T& out) { + T tmp = out; + uint16_t outLen = 0; + + Status s = get(nameAscii, (void*)&tmp, (uint16_t)sizeof(T), outLen); + if (s != Status::Ok) return s; + if (outLen != sizeof(T)) return Status::Corrupt; + + out = tmp; + return Status::Ok; + } + + template + Status get(uint32_t name24, T& out) { + T tmp = out; + uint16_t outLen = 0; + + Status s = get(name24, (void*)&tmp, (uint16_t)sizeof(T), outLen); + if (s != Status::Ok) return s; + if (outLen != sizeof(T)) return Status::Corrupt; + + out = tmp; + return Status::Ok; + } + + bool isValid() const { return (status_ == Status::Ok) && allocInit_; } + + template + bool getOrInit(const char* nameAscii, T& inOutDefaults) { + if (!nameAscii) return false; + if (!isValid()) return false; + + const Status gs = get(nameAscii, inOutDefaults); + if (gs == Status::Ok) return true; + if (gs == Status::IoError) return false; + + if (put(nameAscii, inOutDefaults) != Status::Ok) { initErrorFlag_ = true; } + return true; + } + + template + bool getOrInit(uint32_t name24, T& inOutDefaults) { + if ((name24 & 0x00FFFFFFu) == EMPTY_NAME24) return false; + if (!isValid()) return false; + + const Status gs = get(name24, inOutDefaults); + if (gs == Status::Ok) return true; + if (gs == Status::IoError) return false; + + if (put(name24, inOutDefaults) != Status::Ok) { initErrorFlag_ = true; } + return true; + } + + void resetInitErrorFlag() { initErrorFlag_ = false; } + bool getInitErrorFlag() { return initErrorFlag_; } + + Status stats(Stats& out); + +private: + enum class Mode : uint8_t { + InlineOnly = 0, // max 9 bytes + InlinePlusBlock = 1, // max 24 bytes + AddrList = 2, // max 9 * 16 = 144 bytes (sentinel terminated) + }; + + struct Decoded { + Mode mode = Mode::InlineOnly; + uint8_t flags3 = 0; + uint8_t len5 = 0; + + uint8_t inlineLen = 0; + uint8_t tailLen = 0; + + uint8_t oneBlockAddr = ADDR_END; + uint8_t blocks[ADDR_CAP + 1u] = {ADDR_END}; + uint8_t blockCount = 0; + }; + + static constexpr uint16_t BITMAP_BYTES = (MAX_BLOCKS + 7u) / 8u; + static constexpr const char* KV_NAME_SALT = "OnCueKVv1"; + + static inline uint8_t packHeader_(uint8_t flags3, uint8_t len5) { return (uint8_t)((flags3 & 0x07u) | ((len5 & 0x1Fu) << 3)); } + static inline uint8_t hdrFlags3_(uint8_t header) { return (uint8_t)(header & 0x07u); } + static inline uint8_t hdrLen5_(uint8_t header) { return (uint8_t)(header >> 3); } + + static inline uint32_t le24_(const uint8_t* p) { + return ((uint32_t)p[0]) | ((uint32_t)p[1] << 8) | ((uint32_t)p[2] << 16); + } + static inline void wrle24_(uint8_t* p, uint32_t v24) { + p[0] = (uint8_t)(v24 & 0xFFu); + p[1] = (uint8_t)((v24 >> 8) & 0xFFu); + p[2] = (uint8_t)((v24 >> 16) & 0xFFu); + } + + static inline uint32_t loadCrc24LE_(const uint8_t A[16]) { + return ((uint32_t)A[13]) | ((uint32_t)A[14] << 8) | ((uint32_t)A[15] << 16); + } + static inline void storeCrc24LE_(uint8_t A[16], uint32_t crc24) { + A[13] = (uint8_t)(crc24 & 0xFFu); + A[14] = (uint8_t)((crc24 >> 8) & 0xFFu); + A[15] = (uint8_t)((crc24 >> 16) & 0xFFu); + } + + static inline uint32_t name24_(const char* asciiName) { return computeKey(asciiName ? asciiName : ""); } + + uint16_t slotToBlockOfs_(uint16_t slotIdx) const { return slotIdx; } + uint16_t dataAddrToBlock_(uint8_t addr8) const { return (uint16_t)(g_.dataBegin + (uint16_t)addr8); } + bool dataAddrValid_(uint8_t addr8) const { return addr8 != ADDR_END && (uint16_t)addr8 < g_.dataCount; } + + Status readSlot_(uint16_t slotIdx, uint8_t A[16]); + Status writeSlot_(uint16_t slotIdx, const uint8_t A[16]); + Status readSlotName24_(uint16_t slotIdx, uint32_t& outName24); + + Status readDataBlockByAddr_(uint8_t addr8, uint8_t out16[16]) const; + Status writeDataBlockByAddr_(uint8_t addr8, const uint8_t in16[16]); + + void bodyRead_(const uint8_t A[16], uint8_t out[9]) const { memcpy(out, &A[4], 9); } + void bodyWrite_(uint8_t A[16], const uint8_t in[9]) const { memcpy(&A[4], in, 9); } + + Status decodeEntry_(const uint8_t A[16], Decoded& out) const; + uint16_t payloadLenBytes_(const Decoded& d) const; + + Status computeFullCrc24_(const uint8_t A[16], uint32_t& outCrc24) const; + Status validateEntryCrc_(const uint8_t A[16]) const; + + Status findSlot_(uint32_t name24, uint16_t& outSlot, uint8_t A[16]); + Status findOrAllocSlot_(uint32_t name24, uint16_t& outSlot, uint8_t A[16], bool& outIsExisting); + + void markUsed_(uint16_t blockIdx, bool used); + bool isUsed_(uint16_t blockIdx) const; + + Status initAllocMap_(); + Status allocDataBlocks_(uint8_t count, uint8_t outAddrs[ADDR_CAP]); + void invalidateAlloc_() { allocInit_ = false; } + + void freeEntryBlocksFromMap_(const uint8_t A[16]); + + bool initGeom_(); + +private: + NvVolume* vol_ = nullptr; + uint8_t partIdx_ = 0xFF; + Geom g_; + Status status_ = Status::NotBound; + + uint8_t allocBits_[BITMAP_BYTES] = {0}; + bool allocInit_ = false; + + bool initErrorFlag_ = false; +}; diff --git a/src/lib/nv/NvKvPartition32.cpp b/src/lib/nv/NvKvPartition32.cpp new file mode 100755 index 0000000..fedcd69 --- /dev/null +++ b/src/lib/nv/NvKvPartition32.cpp @@ -0,0 +1,653 @@ +// ----------------------------------------------------------------------------------- +// NvKvPartition32.cpp +#include "NvKvPartition32.h" + +#if defined(ARDUINO) + #include +#elif defined(ARDUINO_ARCH_AVR) + #include +#endif + +namespace { +static inline uint8_t readProgByte32_(const char* p) { +#if defined(ARDUINO_ARCH_AVR) + return (uint8_t)pgm_read_byte(p); +#else + return (uint8_t)(*p); +#endif +} +} + +bool KvPartition32::initGeom_() { + if (!vol_) return false; + + const uint16_t pb16 = vol_->partitionBlockSize(partIdx_); + if (pb16 == 0u) return false; + if ((pb16 & 1u) != 0u) return false; // virtual 32B blocks require even 16B count + + const uint16_t pb32 = (uint16_t)(pb16 / 2u); + if (pb32 < 2u) return false; + if (pb32 > MAX_BLOCKS_32) return false; + + uint32_t t = (uint32_t)pb32 * (uint32_t)KEY_TABLE_PERCENT + 500u; + t /= 1000u; + if (t < 1u) t = 1u; + + const uint16_t tableMax = (uint16_t)(pb32 / 2u); + if (t > tableMax) t = tableMax; + + const uint16_t minTableForAddr8 = (pb32 > 255u) ? (uint16_t)(pb32 - 255u) : 0u; + if (t < minTableForAddr8) t = minTableForAddr8; + if (t > tableMax) t = tableMax; + + g_.partBlocks = pb32; + g_.tableBlocks = (uint16_t)t; + g_.slotCount = g_.tableBlocks; + + if (g_.tableBlocks == 0u || g_.tableBlocks >= g_.partBlocks) return false; + + g_.dataBegin = g_.tableBlocks; + { + uint16_t dc = (uint16_t)(g_.partBlocks - g_.dataBegin); + if (dc > 255u) dc = 255u; + g_.dataCount = dc; + } + + g_.mainPoolBase = g_.dataBegin; + return g_.dataCount != 0u; +} + +KvPartition32::Status KvPartition32::init(NvVolume& vol, uint8_t partIdx) { + if (!vol.isMounted()) return status_ = Status::NotBound; + if (partIdx >= vol.partitionCount()) return status_ = Status::BadGeom; + + vol_ = &vol; + partIdx_ = partIdx; + allocInit_ = false; + memset(allocBits_, 0, sizeof(allocBits_)); + + if (!initGeom_()) return status_ = Status::BadGeom; + + const Status s = initAllocMap_(); + if (s != Status::Ok) { + allocInit_ = false; + return status_ = s; + } + + return status_ = Status::Ok; +} + +KvPartition32::Status KvPartition32::init(NvVolume& vol, uint16_t partitionName16) { + if (partitionName16 == 0u) return status_ = Status::BadGeom; + if (!vol.isMounted()) return status_ = Status::NotBound; + + const int8_t idx = vol.partitionFindByName16(partitionName16); + if (idx < 0) return status_ = Status::NotBound; + + return init(vol, (uint8_t)idx); +} + +KvPartition32::Status KvPartition32::init(NvVolume& vol, const char* partitionAscii) { + if (!partitionAscii || !partitionAscii[0]) return status_ = Status::BadGeom; + if (!vol.isMounted()) return status_ = Status::NotBound; + + uint8_t idx = 0; + if (!vol.partitionFind(partitionAscii, idx)) return status_ = Status::NotBound; + + return init(vol, idx); +} + +KvPartition32::Status KvPartition32::readBlock32_(uint16_t block32, uint8_t out32[32]) const { + if (!vol_) return Status::NotBound; + if (block32 >= g_.partBlocks) return Status::OutOfRange; + + const uint16_t bo16 = block32ToBlock16Ofs_(block32); + if (vol_->partitionReadBlock(partIdx_, bo16, out32) != NvVolume::Status::Ok) return Status::IoError; + if (vol_->partitionReadBlock(partIdx_, (uint16_t)(bo16 + 1u), out32 + 16) != NvVolume::Status::Ok) return Status::IoError; + return Status::Ok; +} + +KvPartition32::Status KvPartition32::writeBlock32_(uint16_t block32, const uint8_t in32[32]) { + if (!vol_) return Status::NotBound; + if (block32 >= g_.partBlocks) return Status::OutOfRange; + + const uint16_t bo16 = block32ToBlock16Ofs_(block32); + if (vol_->partitionWriteBlock(partIdx_, bo16, in32) != NvVolume::Status::Ok) return Status::IoError; + if (vol_->partitionWriteBlock(partIdx_, (uint16_t)(bo16 + 1u), in32 + 16) != NvVolume::Status::Ok) return Status::IoError; + return Status::Ok; +} + +KvPartition32::Status KvPartition32::readSlot_(uint16_t slotIdx, uint8_t A[32]) { + if (slotIdx >= g_.slotCount) return Status::OutOfRange; + return readBlock32_(slotToBlock32Ofs_(slotIdx), A); +} + +KvPartition32::Status KvPartition32::writeSlot_(uint16_t slotIdx, const uint8_t A[32]) { + if (slotIdx >= g_.slotCount) return Status::OutOfRange; + return writeBlock32_(slotToBlock32Ofs_(slotIdx), A); +} + +KvPartition32::Status KvPartition32::readSlotName24_(uint16_t slotIdx, uint32_t& outName24) { + if (!vol_) return Status::NotBound; + if (slotIdx >= g_.slotCount) return Status::OutOfRange; + + const uint16_t block32 = slotToBlock32Ofs_(slotIdx); + const uint16_t bo16 = block32ToBlock16Ofs_(block32); + + uint8_t n3[3]; + if (vol_->partitionReadInBlock(partIdx_, bo16, 0, n3, 3) != NvVolume::Status::Ok) return Status::IoError; + outName24 = le24_(n3) & 0x00FFFFFFu; + return Status::Ok; +} + +KvPartition32::Status KvPartition32::readDataBlockByAddr_(uint8_t addr8, uint8_t out32[32]) const { + if (!dataAddrValid_(addr8)) return Status::Corrupt; + return readBlock32_(dataAddrToBlock_(addr8), out32); +} + +KvPartition32::Status KvPartition32::writeDataBlockByAddr_(uint8_t addr8, const uint8_t in32[32]) { + if (!dataAddrValid_(addr8)) return Status::OutOfRange; + return writeBlock32_(dataAddrToBlock_(addr8), in32); +} + +KvPartition32::Status KvPartition32::decodeEntry_(const uint8_t A[32], Decoded& out) const { + out = Decoded{}; + + out.flags2 = hdrFlags2_(A[3]); + out.len6 = hdrLen6_(A[3]); + + const bool fInlineOnly = (out.flags2 & FLAG_INLINE_ONLY) != 0u; + const bool fTail = (out.flags2 & FLAG_TAIL) != 0u; + + if (fInlineOnly) { + if (fTail) return Status::Corrupt; + if (out.len6 > INLINE_CAP) return Status::Corrupt; + + out.mode = Mode::InlineOnly; + out.inlineLen = out.len6; + return Status::Ok; + } + + if (!fTail) return Status::Corrupt; + if (out.len6 < 1u || out.len6 > BLOCK_BYTES) return Status::Corrupt; + + uint8_t body[25]; + bodyRead_(A, body); + + out.mode = Mode::AddrList; + out.tailLen = out.len6; + out.blockCount = 0; + + for (uint8_t i = 0; i < ADDR_CAP; i++) { + const uint8_t a = body[i]; + if (a == ADDR_END) break; + if (!dataAddrValid_(a)) return Status::Corrupt; + out.blocks[out.blockCount++] = a; + } + + if (out.blockCount == 0u) return Status::Corrupt; + out.blocks[out.blockCount] = ADDR_END; + return Status::Ok; +} + +uint16_t KvPartition32::payloadLenBytes_(const Decoded& d) const { + if (d.mode == Mode::InlineOnly) return d.inlineLen; + + if (d.blockCount == 0u) return 0u; + return (uint16_t)(((uint16_t)(d.blockCount - 1u) * BLOCK_BYTES) + d.tailLen); +} + +KvPartition32::Status KvPartition32::computeFullCrc24_(const uint8_t A[32], uint32_t& outCrc24) const { + if (!vol_) return Status::NotBound; + + Decoded d; + const Status ds = decodeEntry_(A, d); + if (ds != Status::Ok) return ds; + + uint8_t Ac[32]; + memcpy(Ac, A, 32); + Ac[29] = 0; + Ac[30] = 0; + Ac[31] = 0; + + uint32_t crc = Crc24::init(); + crc = Crc24::update(crc, Ac, 32); + + if (d.mode == Mode::AddrList) { + for (uint8_t i = 0; i < d.blockCount; i++) { + uint8_t blk[32]; + const Status rs = readDataBlockByAddr_(d.blocks[i], blk); + if (rs != Status::Ok) return rs; + crc = Crc24::update(crc, blk, 32); + } + } + + outCrc24 = crc & 0x00FFFFFFu; + return Status::Ok; +} + +KvPartition32::Status KvPartition32::validateEntryCrc_(const uint8_t A[32]) const { + const uint32_t stored = loadCrc24LE_(A) & 0x00FFFFFFu; + uint32_t calc = 0; + const Status s = computeFullCrc24_(A, calc); + if (s != Status::Ok) return s; + return (((stored ^ calc) & 0x00FFFFFFu) == 0u) ? Status::Ok : Status::Corrupt; +} + +void KvPartition32::markUsed_(uint16_t blockIdx, bool used) { + if (blockIdx >= g_.partBlocks) return; + + const uint16_t byteIdx = (uint16_t)(blockIdx >> 3); + const uint8_t mask = (uint8_t)(1u << (blockIdx & 7u)); + if (byteIdx >= BITMAP_BYTES) return; + + if (used) allocBits_[byteIdx] |= mask; + else allocBits_[byteIdx] &= (uint8_t)~mask; +} + +bool KvPartition32::isUsed_(uint16_t blockIdx) const { + if (blockIdx >= g_.partBlocks) return true; + + const uint16_t byteIdx = (uint16_t)(blockIdx >> 3); + const uint8_t mask = (uint8_t)(1u << (blockIdx & 7u)); + if (byteIdx >= BITMAP_BYTES) return true; + + return (allocBits_[byteIdx] & mask) != 0u; +} + +void KvPartition32::freeEntryBlocksFromMap_(const uint8_t A[32]) { + Decoded d; + if (decodeEntry_(A, d) != Status::Ok) return; + + if (d.mode == Mode::AddrList) { + for (uint8_t i = 0; i < d.blockCount; i++) { + if (dataAddrValid_(d.blocks[i])) markUsed_(dataAddrToBlock_(d.blocks[i]), false); + } + } +} + +KvPartition32::Status KvPartition32::findSlot_(uint32_t name24, uint16_t& outSlot, uint8_t A[32]) { + if (!vol_) return Status::NotBound; + name24 &= 0x00FFFFFFu; + + for (uint16_t i = 0; i < g_.slotCount; i++) { + uint32_t n = 0; + const Status ns = readSlotName24_(i, n); + if (ns != Status::Ok) return ns; + if (n != name24) continue; + + const Status rs = readSlot_(i, A); + if (rs != Status::Ok) return rs; + + const Status vs = validateEntryCrc_(A); + if (vs == Status::IoError) return vs; + if (vs != Status::Ok) continue; + + outSlot = i; + return Status::Ok; + } + + return Status::NotFound; +} + +KvPartition32::Status KvPartition32::findOrAllocSlot_(uint32_t name24, uint16_t& outSlot, uint8_t A[32], bool& outIsExisting) { + int16_t firstEmpty = -1; + int16_t firstCorruptMatch = -1; + name24 &= 0x00FFFFFFu; + + for (uint16_t i = 0; i < g_.slotCount; i++) { + uint32_t n = 0; + const Status ns = readSlotName24_(i, n); + if (ns != Status::Ok) return ns; + + if (n == name24) { + const Status rs = readSlot_(i, A); + if (rs != Status::Ok) return rs; + + const Status vs = validateEntryCrc_(A); + if (vs == Status::IoError) return vs; + + if (vs != Status::Ok) { + if (firstCorruptMatch < 0) firstCorruptMatch = (int16_t)i; + continue; + } + + outSlot = i; + outIsExisting = true; + return Status::Ok; + } + + if (n == EMPTY_NAME24 && firstEmpty < 0) firstEmpty = (int16_t)i; + } + + if (firstCorruptMatch >= 0) { + outSlot = (uint16_t)firstCorruptMatch; + outIsExisting = false; + return Status::Ok; + } + + if (firstEmpty >= 0) { + outSlot = (uint16_t)firstEmpty; + outIsExisting = false; + return Status::Ok; + } + + return Status::NoSpace; +} + +KvPartition32::Status KvPartition32::initAllocMap_() { + memset(allocBits_, 0, sizeof(allocBits_)); + + for (uint16_t b = 0; b < g_.dataBegin; b++) markUsed_(b, true); + for (uint16_t b = (uint16_t)(g_.dataBegin + g_.dataCount); b < g_.partBlocks; b++) markUsed_(b, true); + + uint8_t A[32]; + + for (uint16_t i = 0; i < g_.slotCount; i++) { + Status s = readSlot_(i, A); + if (s != Status::Ok) { allocInit_ = false; return s; } + + const uint32_t n = le24_(&A[0]) & 0x00FFFFFFu; + if (n == EMPTY_NAME24) continue; + + const Status vs = validateEntryCrc_(A); + if (vs == Status::IoError) { allocInit_ = false; return Status::IoError; } + if (vs != Status::Ok) continue; + + Decoded d; + if (decodeEntry_(A, d) != Status::Ok) continue; + + if (d.mode == Mode::AddrList) { + for (uint8_t k = 0; k < d.blockCount; k++) markUsed_(dataAddrToBlock_(d.blocks[k]), true); + } + } + + allocInit_ = true; + return Status::Ok; +} + +KvPartition32::Status KvPartition32::allocDataBlocks_(uint8_t count, uint8_t outAddrs[ADDR_CAP]) { + if (count == 0u || count > ADDR_CAP) return Status::OutOfRange; + if (!allocInit_) return Status::Corrupt; + + uint8_t got = 0; + + const uint16_t first = g_.dataBegin; + const uint16_t last = (uint16_t)(g_.dataBegin + g_.dataCount - 1u); + + for (int32_t b = (int32_t)last; b >= (int32_t)first; --b) { + const uint16_t bb = (uint16_t)b; + if (isUsed_(bb)) continue; + + markUsed_(bb, true); + outAddrs[got++] = (uint8_t)(bb - g_.dataBegin); + if (got == count) return Status::Ok; + } + + for (uint8_t i = 0; i < got; i++) markUsed_(dataAddrToBlock_(outAddrs[i]), false); + return Status::NoSpace; +} + +KvPartition32::Status KvPartition32::get(uint32_t name24, void* dst, uint16_t dstCap, uint16_t& outLen) { + if (!vol_) return Status::NotBound; + name24 &= 0x00FFFFFFu; + if (name24 == EMPTY_NAME24) return Status::OutOfRange; + + uint8_t A[32]; + uint16_t slot = 0; + const Status fs = findSlot_(name24, slot, A); + (void)slot; + if (fs != Status::Ok) return fs; + + Decoded d; + const Status ds = decodeEntry_(A, d); + if (ds != Status::Ok) return ds; + + outLen = payloadLenBytes_(d); + if (!dst) return Status::Ok; + if (dstCap < outLen) return Status::OutOfRange; + + uint8_t* p = (uint8_t*)dst; + + if (d.mode == Mode::InlineOnly) { + uint8_t body[25]; + bodyRead_(A, body); + if (d.inlineLen) memcpy(p, body, d.inlineLen); + return Status::Ok; + } + + uint16_t written = 0; + for (uint8_t i = 0; i < d.blockCount; i++) { + uint8_t blk[32]; + const Status rs = readDataBlockByAddr_(d.blocks[i], blk); + if (rs != Status::Ok) return rs; + + const bool isLast = (i == (uint8_t)(d.blockCount - 1u)); + const uint8_t n = isLast ? d.tailLen : BLOCK_BYTES; + + memcpy(p + written, blk, n); + written = (uint16_t)(written + n); + } + + return (written == outLen) ? Status::Ok : Status::Corrupt; +} + +KvPartition32::Status KvPartition32::put(uint32_t name24, const void* src, uint16_t len) { + if (!vol_) return Status::NotBound; + if (!src && len) return Status::OutOfRange; + if (!allocInit_) return Status::Corrupt; + + name24 &= 0x00FFFFFFu; + if (name24 == EMPTY_NAME24) return Status::OutOfRange; + + if (len > (uint16_t)(ADDR_CAP * BLOCK_BYTES)) return Status::OutOfRange; + + uint8_t Aold[32]; + uint16_t slot = 0; + bool existing = false; + + Status s = findOrAllocSlot_(name24, slot, Aold, existing); + if (s != Status::Ok) return s; + + if (!existing) memset(Aold, 0xFF, sizeof(Aold)); + + bool freedOld = false; + { + const Status vs = validateEntryCrc_(Aold); + if (vs == Status::Ok) { + freeEntryBlocksFromMap_(Aold); + freedOld = true; + } else if (vs == Status::IoError) { + return Status::IoError; + } + } + + uint8_t A[32]; + memset(A, 0xFF, sizeof(A)); + wrle24_(&A[0], name24); + + const uint8_t* p = (const uint8_t*)src; + + if (len <= INLINE_CAP) { + A[3] = packHeader_(FLAG_INLINE_ONLY, (uint8_t)len); + + uint8_t body[25]; + memset(body, 0xFF, sizeof(body)); + if (len) memcpy(body, p, len); + bodyWrite_(A, body); + + uint32_t crc24 = 0; + Status cs = computeFullCrc24_(A, crc24); + if (cs != Status::Ok) { invalidateAlloc_(); return cs; } + storeCrc24LE_(A, crc24); + + Status ws = writeSlot_(slot, A); + if (ws == Status::IoError) invalidateAlloc_(); + return ws; + } + + const uint8_t blocksNeeded = (uint8_t)((len + (BLOCK_BYTES - 1u)) / BLOCK_BYTES); + if (blocksNeeded == 0u || blocksNeeded > ADDR_CAP) return Status::OutOfRange; + + uint8_t addrs[ADDR_CAP] = {0}; + s = allocDataBlocks_(blocksNeeded, addrs); + if (s != Status::Ok) { + if (freedOld) invalidateAlloc_(); + return s; + } + + uint8_t tmp[32]; + for (uint8_t i = 0; i < blocksNeeded; i++) { + memset(tmp, 0xFF, sizeof(tmp)); + + const uint16_t ofs = (uint16_t)i * BLOCK_BYTES; + const uint16_t avail = (len > ofs) ? (uint16_t)(len - ofs) : 0u; + const uint16_t chunk = (avail >= BLOCK_BYTES) ? BLOCK_BYTES : avail; + if (chunk) memcpy(tmp, p + ofs, chunk); + + Status ws = writeDataBlockByAddr_(addrs[i], tmp); + if (ws != Status::Ok) { + for (uint8_t k = 0; k < blocksNeeded; k++) markUsed_(dataAddrToBlock_(addrs[k]), false); + invalidateAlloc_(); + return ws; + } + } + + const uint8_t tailLen = (uint8_t)((len & (BLOCK_BYTES - 1u)) ? (len & (BLOCK_BYTES - 1u)) : BLOCK_BYTES); + A[3] = packHeader_(FLAG_TAIL, tailLen); + + uint8_t body[25]; + memset(body, ADDR_END, sizeof(body)); + for (uint8_t i = 0; i < blocksNeeded; i++) body[i] = addrs[i]; + bodyWrite_(A, body); + + uint32_t crc24 = 0; + Status cs = computeFullCrc24_(A, crc24); + if (cs != Status::Ok) { invalidateAlloc_(); return cs; } + storeCrc24LE_(A, crc24); + + Status ws = writeSlot_(slot, A); + if (ws == Status::IoError) invalidateAlloc_(); + return ws; +} + +KvPartition32::Status KvPartition32::del(uint32_t name24) { + if (!vol_) return Status::NotBound; + if (!allocInit_) return Status::Corrupt; + + name24 &= 0x00FFFFFFu; + if (name24 == EMPTY_NAME24) return Status::OutOfRange; + + uint8_t A[32]; + uint16_t slot = 0; + const Status fs = findSlot_(name24, slot, A); + if (fs != Status::Ok) return fs; + + if (validateEntryCrc_(A) == Status::Ok) freeEntryBlocksFromMap_(A); + + memset(A, 0xFF, sizeof(A)); + + Status ws = writeSlot_(slot, A); + if (ws == Status::IoError) invalidateAlloc_(); + return ws; +} + +uint32_t KvPartition32::computeKey(const char* nameAscii) { + uint32_t crc = Crc24::init(); + crc = Crc24::update(crc, (const uint8_t*)KV_NAME_SALT, (uint16_t)strlen(KV_NAME_SALT)); + crc = Crc24::update(crc, (const uint8_t*)(nameAscii ? nameAscii : ""), (uint16_t)strlen(nameAscii ? nameAscii : "")); + return (crc & 0x00FFFFFFu); +} + +uint32_t KvPartition32::computeKey(const __FlashStringHelper* nameAsciiF) { +#if defined(ARDUINO) + if (!nameAsciiF) nameAsciiF = F(""); + + uint32_t crc = Crc24::init(); + crc = Crc24::update(crc, (const uint8_t*)KV_NAME_SALT, (uint16_t)strlen(KV_NAME_SALT)); + + const char* p = (const char*)nameAsciiF; + for (;;) { + const uint8_t c = readProgByte32_(p++); + if (c == 0) break; + crc = Crc24::updateByte(crc, c); + } + + return (crc & 0x00FFFFFFu); +#else + (void)nameAsciiF; + return computeKey(""); +#endif +} + +KvPartition32::Status KvPartition32::scrub(uint16_t* outDeleted) { + if (outDeleted) *outDeleted = 0; + + if (!vol_ || !vol_->isMounted()) return Status::NotBound; + if (!initGeom_()) return Status::BadGeom; + + uint8_t A[32]; + uint16_t deleted = 0; + + for (uint16_t i = 0; i < g_.slotCount; i++) { + const Status rs = readSlot_(i, A); + if (rs != Status::Ok) return rs; + + const uint32_t n = le24_(&A[0]) & 0x00FFFFFFu; + if (n == EMPTY_NAME24) continue; + + const Status vs = validateEntryCrc_(A); + if (vs == Status::Ok) continue; + if (vs == Status::IoError) return Status::IoError; + if (vs != Status::Corrupt) return vs; + + memset(A, 0xFF, sizeof(A)); + const Status ws = writeSlot_(i, A); + if (ws != Status::Ok) { + if (ws == Status::IoError) invalidateAlloc_(); + return ws; + } + + deleted++; + } + + const Status ms = initAllocMap_(); + if (ms != Status::Ok) { + if (ms == Status::IoError) invalidateAlloc_(); + return ms; + } + + if (outDeleted) *outDeleted = deleted; + return Status::Ok; +} + +KvPartition32::Status KvPartition32::stats(Stats& out) { + memset(&out, 0, sizeof(out)); + if (!vol_ || !vol_->isMounted()) return Status::NotBound; + if (!initGeom_()) return Status::BadGeom; + if (!allocInit_) return Status::Corrupt; + + out.dataBlocksTotal = g_.dataCount; + out.slotsTotal = g_.slotCount; + + uint16_t usedData = 0; + for (uint16_t a = 0; a < g_.dataCount; a++) { + const uint16_t b = (uint16_t)(g_.dataBegin + a); + const uint16_t byteIdx = (uint16_t)(b >> 3); + const uint8_t mask = (uint8_t)(1u << (b & 7u)); + if (byteIdx >= BITMAP_BYTES) break; + if (allocBits_[byteIdx] & mask) usedData++; + } + out.dataBlocksFree = (usedData <= g_.dataCount) ? (uint16_t)(g_.dataCount - usedData) : 0u; + + uint16_t empty = 0; + for (uint16_t i = 0; i < g_.slotCount; i++) { + uint32_t n = 0; + const Status ns = readSlotName24_(i, n); + if (ns != Status::Ok) return ns; + if (n == EMPTY_NAME24) empty++; + } + out.slotsFree = empty; + + return Status::Ok; +} diff --git a/src/lib/nv/NvKvPartition32.h b/src/lib/nv/NvKvPartition32.h new file mode 100755 index 0000000..8286224 --- /dev/null +++ b/src/lib/nv/NvKvPartition32.h @@ -0,0 +1,295 @@ +// ----------------------------------------------------------------------------------- +// NvKvPartition32.h +// +// KV partition on virtual 32-byte blocks (v2 format). +// +// This KV layer stores named blobs in a fixed-size partition. +// The underlying NvVolume partition uses 16-byte blocks; this class combines pairs +// of consecutive 16-byte blocks into one virtual 32-byte block. +// +// Layout +// - Table entries are stored at blocks [0 .. tableBlocks-1]. +// - Data blocks are stored at [dataBegin .. partBlocks-1], where dataBegin = tableBlocks. +// - tableBlocks targets KEY_TABLE_PERCENT (default 40%) and can slide upward +// to at most partBlocks/2 as needed so dataCount fits byte addressing. +// +// Terminology +// - Block: 32 bytes (virtual). +// - Data address (addr8): 8-bit index into the data region. +// addr8=0 -> physical block dataBegin +// ... +// addr8=254 -> physical block dataBegin+254 +// - addr8 value 0xFF is reserved as ADDR_END sentinel. +// +// Keying +// - Each record key is name24: +// name24 = CRC24( KV_NAME_SALT + asciiName ) +// - CRC24 uses Crc24::init/update from Crc.h. +// +// Allocation model +// - Overwrite-in-place semantics; no compaction. +// - Data block allocation is top-down within the data region. +// - Addressable data region is limited to 255 blocks (0..254), clamped by partition size. +// +// =================================================================================================== +// v2 ENTRY FORMAT (32 bytes, one entry per key) +// a[0..2] : name24 (LE) +// a[3] : header = flags2 + len6 +// flags bits: +// FLAG_INLINE_ONLY : body contains inline payload only +// FLAG_TAIL : addr-list mode; len6 = bytes used in last block +// a[4..28] : body200 (25 bytes), interpreted by mode: +// - INLINE_ONLY: up to 25 inline bytes +// - ADDR_LIST: up to 25 addr8 values (0xFF sentinel-terminated) +// a[29..31]: crc24 (LE), written last +// CRC covers entry (with crc bytes zeroed) and referenced payload blocks. +// +// Mode max payload sizes: +// - InlineOnly: 25 bytes +// - AddrList: 25 * 32 = 800 bytes +// Overall max file size: 800 bytes +// ----------------------------------------------------------------------------------- +#pragma once + +#include +#include +#include + +#include "NvVolume.h" +#include "../math/Crc.h" + +class __FlashStringHelper; + +#ifndef MAX_BLOCKS_32 + #define MAX_BLOCKS_32 2048u +#endif + +#ifndef KEY_TABLE_PERCENT + #define KEY_TABLE_PERCENT 400u // 40% table by default +#endif + +class KvPartition32 { +public: + enum class Status : uint8_t { + Ok = 0, + NotBound, + BadGeom, + IoError, + Corrupt, + NotFound, + NoSpace, + OutOfRange, + }; + + static constexpr uint8_t BLOCK_BYTES = 32u; + static constexpr uint8_t ADDR_END = 0xFFu; + static constexpr uint32_t EMPTY_NAME24 = 0x00FFFFFFu; + + static constexpr uint8_t FLAG_INLINE_ONLY = 0x01u; + static constexpr uint8_t FLAG_TAIL = 0x02u; + + static constexpr uint8_t INLINE_CAP = 25u; + static constexpr uint8_t ADDR_CAP = 25u; + + struct Geom { + uint16_t partBlocks = 0; // count of 32-byte virtual blocks + uint16_t tableBlocks = 0; + uint16_t slotCount = 0; + uint16_t dataBegin = 0; + uint16_t dataCount = 0; + uint16_t mainPoolBase = 0; + }; + + struct Stats { + uint16_t dataBlocksTotal; + uint16_t dataBlocksFree; + uint16_t slotsTotal; + uint16_t slotsFree; + }; + + KvPartition32() = default; + + Status init(NvVolume& vol, uint8_t partIdx); + Status init(NvVolume& vol, uint16_t partitionName16); + Status init(NvVolume& vol, const char* partitionAscii); + + const Geom& geom() const { return g_; } + Status status() const { return status_; } + + Status get(uint32_t name24, void* dst, uint16_t dstCap, uint16_t& outLen); + Status put(uint32_t name24, const void* src, uint16_t len); + Status del(uint32_t name24); + + static uint32_t computeKey(const char* nameAscii); + static uint32_t computeKey(const __FlashStringHelper* nameAsciiF); + + Status get(const char* nameAscii, void* dst, uint16_t dstCap, uint16_t& outLen) { return get(name24_(nameAscii), dst, dstCap, outLen); } + Status put(const char* nameAscii, const void* src, uint16_t len) { return put(name24_(nameAscii), src, len); } + Status put(const char* nameAscii, const char* zstr) { + if (!zstr) return put(nameAscii, (const void*)"", 1); + const uint16_t n = (uint16_t)strlen(zstr) + 1u; + return put(nameAscii, (const void*)zstr, n); + } + Status del(const char* nameAscii) { return del(name24_(nameAscii)); } + + Status scrub(uint16_t* outDeleted); + + template + Status put(const char* nameAscii, const T& v) { return put(nameAscii, (const void*)&v, (uint16_t)sizeof(T)); } + + template + Status put(uint32_t name24, const T& v) { return put(name24, (const void*)&v, (uint16_t)sizeof(T)); } + + template + Status get(const char* nameAscii, T& out) { + T tmp = out; + uint16_t outLen = 0; + + Status s = get(nameAscii, (void*)&tmp, (uint16_t)sizeof(T), outLen); + if (s != Status::Ok) return s; + if (outLen != sizeof(T)) return Status::Corrupt; + + out = tmp; + return Status::Ok; + } + + template + Status get(uint32_t name24, T& out) { + T tmp = out; + uint16_t outLen = 0; + + Status s = get(name24, (void*)&tmp, (uint16_t)sizeof(T), outLen); + if (s != Status::Ok) return s; + if (outLen != sizeof(T)) return Status::Corrupt; + + out = tmp; + return Status::Ok; + } + + bool isValid() const { return (status_ == Status::Ok) && allocInit_; } + + template + bool getOrInit(const char* nameAscii, T& inOutDefaults) { + if (!nameAscii) return false; + if (!isValid()) return false; + + const Status gs = get(nameAscii, inOutDefaults); + if (gs == Status::Ok) return true; + if (gs == Status::IoError) return false; + + if (put(nameAscii, inOutDefaults) != Status::Ok) { initErrorFlag_ = true; } + return true; + } + + template + bool getOrInit(uint32_t name24, T& inOutDefaults) { + if ((name24 & 0x00FFFFFFu) == EMPTY_NAME24) return false; + if (!isValid()) return false; + + const Status gs = get(name24, inOutDefaults); + if (gs == Status::Ok) return true; + if (gs == Status::IoError) return false; + + if (put(name24, inOutDefaults) != Status::Ok) { initErrorFlag_ = true; } + return true; + } + + void resetInitErrorFlag() { initErrorFlag_ = false; } + bool getInitErrorFlag() { return initErrorFlag_; } + + Status stats(Stats& out); + +private: + enum class Mode : uint8_t { + InlineOnly = 0, // max 25 bytes + AddrList = 1, // max 25 * 32 = 800 bytes (sentinel terminated) + }; + + struct Decoded { + Mode mode = Mode::InlineOnly; + uint8_t flags2 = 0; + uint8_t len6 = 0; + + uint8_t inlineLen = 0; + uint8_t tailLen = 0; + + uint8_t blocks[ADDR_CAP + 1u] = {ADDR_END}; + uint8_t blockCount = 0; + }; + + static constexpr uint16_t BITMAP_BYTES = (MAX_BLOCKS_32 + 7u) / 8u; + static constexpr const char* KV_NAME_SALT = "OnCueKVv2"; + + static inline uint8_t packHeader_(uint8_t flags2, uint8_t len6) { return (uint8_t)((flags2 & 0x03u) | ((len6 & 0x3Fu) << 2)); } + static inline uint8_t hdrFlags2_(uint8_t header) { return (uint8_t)(header & 0x03u); } + static inline uint8_t hdrLen6_(uint8_t header) { return (uint8_t)(header >> 2); } + + static inline uint32_t le24_(const uint8_t* p) { + return ((uint32_t)p[0]) | ((uint32_t)p[1] << 8) | ((uint32_t)p[2] << 16); + } + static inline void wrle24_(uint8_t* p, uint32_t v24) { + p[0] = (uint8_t)(v24 & 0xFFu); + p[1] = (uint8_t)((v24 >> 8) & 0xFFu); + p[2] = (uint8_t)((v24 >> 16) & 0xFFu); + } + + static inline uint32_t loadCrc24LE_(const uint8_t A[32]) { + return ((uint32_t)A[29]) | ((uint32_t)A[30] << 8) | ((uint32_t)A[31] << 16); + } + static inline void storeCrc24LE_(uint8_t A[32], uint32_t crc24) { + A[29] = (uint8_t)(crc24 & 0xFFu); + A[30] = (uint8_t)((crc24 >> 8) & 0xFFu); + A[31] = (uint8_t)((crc24 >> 16) & 0xFFu); + } + + static inline uint32_t name24_(const char* asciiName) { return computeKey(asciiName ? asciiName : ""); } + + uint16_t block32ToBlock16Ofs_(uint16_t block32) const { return (uint16_t)(block32 * 2u); } + uint16_t slotToBlock32Ofs_(uint16_t slotIdx) const { return slotIdx; } + uint16_t dataAddrToBlock_(uint8_t addr8) const { return (uint16_t)(g_.dataBegin + (uint16_t)addr8); } + bool dataAddrValid_(uint8_t addr8) const { return addr8 != ADDR_END && (uint16_t)addr8 < g_.dataCount; } + + Status readBlock32_(uint16_t block32, uint8_t out32[32]) const; + Status writeBlock32_(uint16_t block32, const uint8_t in32[32]); + + Status readSlot_(uint16_t slotIdx, uint8_t A[32]); + Status writeSlot_(uint16_t slotIdx, const uint8_t A[32]); + Status readSlotName24_(uint16_t slotIdx, uint32_t& outName24); + + Status readDataBlockByAddr_(uint8_t addr8, uint8_t out32[32]) const; + Status writeDataBlockByAddr_(uint8_t addr8, const uint8_t in32[32]); + + void bodyRead_(const uint8_t A[32], uint8_t out[25]) const { memcpy(out, &A[4], 25); } + void bodyWrite_(uint8_t A[32], const uint8_t in[25]) const { memcpy(&A[4], in, 25); } + + Status decodeEntry_(const uint8_t A[32], Decoded& out) const; + uint16_t payloadLenBytes_(const Decoded& d) const; + + Status computeFullCrc24_(const uint8_t A[32], uint32_t& outCrc24) const; + Status validateEntryCrc_(const uint8_t A[32]) const; + + Status findSlot_(uint32_t name24, uint16_t& outSlot, uint8_t A[32]); + Status findOrAllocSlot_(uint32_t name24, uint16_t& outSlot, uint8_t A[32], bool& outIsExisting); + + void markUsed_(uint16_t blockIdx, bool used); + bool isUsed_(uint16_t blockIdx) const; + + Status initAllocMap_(); + Status allocDataBlocks_(uint8_t count, uint8_t outAddrs[ADDR_CAP]); + void invalidateAlloc_() { allocInit_ = false; } + + void freeEntryBlocksFromMap_(const uint8_t A[32]); + + bool initGeom_(); + +private: + NvVolume* vol_ = nullptr; + uint8_t partIdx_ = 0xFF; + Geom g_; + Status status_ = Status::NotBound; + + uint8_t allocBits_[BITMAP_BYTES] = {0}; + bool allocInit_ = false; + + bool initErrorFlag_ = false; +}; diff --git a/src/lib/nv/NvVolume.cpp b/src/lib/nv/NvVolume.cpp new file mode 100755 index 0000000..fed97e3 --- /dev/null +++ b/src/lib/nv/NvVolume.cpp @@ -0,0 +1,598 @@ +// NvVolume.cpp +#include "NvVolume.h" +#include "../math/Crc.h" + +uint16_t NvVolume::crc16_sb(const uint8_t* data, uint16_t lenNoCrc) { + return Crc16::compute(data, lenNoCrc); +} + +// Reserve 0 for "unnamed" sentinel +static uint16_t normalizeTag16(uint16_t t) { + if (t == 0x0000u) t = 0x0001u; + return t; +} + +uint16_t NvVolume::computeVolumeName16(const char* projectAscii, uint16_t storageVersion) { + const uint16_t base = normalizeTag16(Crc16::saltedAscii(kSalt, projectAscii)); + // Compatibility token: base(project) + storageVersion (non-cryptographic, deterministic). + return normalizeTag16((uint16_t)(base + storageVersion)); +} + +uint16_t NvVolume::computePartName16(const char* partitionAscii) { + return normalizeTag16(Crc16::saltedAscii(kSalt, partitionAscii)); +} + +// bytes11 points at sb[3..13] (11 bytes, 88 bits). bit0 is LSB of bytes11[0]. +uint32_t NvVolume::getBitsLSB(const uint8_t* bytes11, uint32_t bitIndex, uint32_t bitCount) { + uint32_t v = 0; + for (uint32_t i = 0; i < bitCount; ++i) { + const uint32_t b = bitIndex + i; + const uint32_t byte = b >> 3; + const uint32_t bit = b & 7u; + const uint32_t bitVal = (bytes11[byte] >> bit) & 1u; + v |= (bitVal << i); + } + return v; +} + +void NvVolume::setBitsLSB(uint8_t* bytes11, uint32_t bitIndex, uint32_t bitCount, uint32_t value) { + for (uint32_t i = 0; i < bitCount; ++i) { + const uint32_t b = bitIndex + i; + const uint32_t byte = b >> 3; + const uint32_t bit = b & 7u; + const uint8_t mask = (uint8_t)(1u << bit); + if ((value >> i) & 1u) bytes11[byte] |= mask; + else bytes11[byte] &= (uint8_t)~mask; + } +} + +NvVolume::Status NvVolume::init(NvDevice& dev) { + dev_ = &dev; + + uint32_t bytes = dev_->sizeBytes(); + if (bytes < kBlockSize) return status_ = Status::BadGeometry; + if (bytes > 65536u) return status_ = Status::BadGeometry; + if (bytes & (kBlockSize - 1u)) return status_ = Status::BadGeometry; + + const uint32_t blocks = bytes / kBlockSize; + if (blocks > kMaxBlocks) return status_ = Status::BadGeometry; + + blockCount_ = (uint16_t)blocks; + + mounted_ = false; + partCount_ = 0; + flags8_ = 0; + flags4_ = 0; + storedVolumeName16_ = 0; + hasPartNames_ = false; + for (uint8_t i = 0; i < kMaxParts; ++i) { + parts_[i] = Part{}; + partName16_[i] = 0; + } + + builderActive_ = false; + builderProject_ = nullptr; + builderStorageVersion_ = 0; + builderCount_ = 0; + for (uint8_t i = 0; i < kMaxParts; ++i) { + builderPartAscii_[i] = nullptr; + builderSizeBlocks_[i] = 0; + } + + status_ = Status::Ok; + return status_; +} + +NvVolume::Status NvVolume::mount() { + if (!dev_) return status_ = Status::NotReady; + if (blockCount_ < 2) return status_ = Status::BadGeometry; + + uint8_t sb0[16]; + Status rb = readBlockSt(*dev_, 0, sb0); + if (rb != Status::Ok) return status_ = rb; + + const uint16_t storedCrc0 = le16(&sb0[14]); + const uint16_t calcCrc0 = crc16_sb(&sb0[0], 14); + if (storedCrc0 != calcCrc0) { + mounted_ = false; partCount_ = 0; hasPartNames_ = false; + return status_ = Status::Unformatted; + } + + const uint8_t flags8 = sb0[2]; + const uint8_t ver = (uint8_t)(flags8 >> kFlagVersionShift); + if (ver != kSbVersionV1) { + mounted_ = false; partCount_ = 0; hasPartNames_ = false; + return status_ = Status::Unformatted; + } + + if (flags8 & kFlagReservedMask) { + mounted_ = false; partCount_ = 0; hasPartNames_ = false; + return status_ = Status::Unformatted; + } + + storedVolumeName16_ = le16(&sb0[0]); + + Status e = enumerateFromSb0(sb0); + if (e != Status::Ok) { + mounted_ = false; partCount_ = 0; hasPartNames_ = false; + return status_ = Status::Unformatted; // keep mount policy + } + + (void)loadNamesBlock(); // optional; keep prior semantics + + mounted_ = true; + return status_ = Status::Ok; +} + +NvVolume::Status NvVolume::mount(const char* projectAscii, uint16_t storageVersion) { + Status st = mount(); // call existing one + if (st != Status::Ok) return st; + + if (!projectAscii || !projectAscii[0]) { + mounted_ = false; partCount_ = 0; hasPartNames_ = false; + return status_ = Status::BadGeometry; + } + + const uint16_t expected = computeVolumeName16(projectAscii, storageVersion); + if (storedVolumeName16_ != expected) { + mounted_ = false; partCount_ = 0; hasPartNames_ = false; + return status_ = Status::Unformatted; // policy: treat as "not ours / incompatible" + } + + return status_ = Status::Ok; +} + +NvVolume::Status NvVolume::enumerateFromSb0(const uint8_t sb0[16]) { + flags8_ = sb0[2]; + + const uint8_t* packed = &sb0[3]; + flags4_ = (uint8_t)getBitsLSB(packed, 0, 4); + + uint16_t p[7]; + for (uint8_t i = 0; i < 7; ++i) { + p[i] = (uint16_t)getBitsLSB(packed, 4u + (uint32_t)i * 12u, 12u); + } + + uint16_t starts[7]; + uint8_t N = 0; + for (uint8_t i = 0; i < 7; ++i) { + const uint16_t v = (uint16_t)(p[i] & 0x0FFFu); + if (v == 0x0FFFu) break; + starts[N++] = v; + } + + const bool lastIsEndMarker = (flags8_ & kFlagLastIsEndMarker) != 0; + if (lastIsEndMarker && N < 2) return Status::BadGeometry; + + for (uint8_t i = 0; i < N; ++i) { + const uint16_t s = starts[i]; + if (s < 2) return Status::BadGeometry; + if (s >= blockCount_) return Status::OutOfRange; + if (i > 0 && starts[i - 1] >= s) return Status::BadGeometry; + } + + uint8_t partCount = N; + uint16_t limitBlock = blockCount_; + if (lastIsEndMarker) { + partCount = (uint8_t)(N - 1); + limitBlock = starts[N - 1]; + if (limitBlock >= blockCount_) return Status::OutOfRange; + } + + for (uint8_t i = 0; i < partCount; ++i) { + const uint16_t begin = starts[i]; + uint16_t end = 0; + + if (i + 1 < partCount) end = starts[i + 1]; + else end = lastIsEndMarker ? limitBlock : blockCount_; + + if (end <= begin) return Status::BadGeometry; + + parts_[i].beginBlock = begin; + parts_[i].endBlock = end; + } + + for (uint8_t i = partCount; i < kMaxParts; ++i) { + parts_[i].beginBlock = 0; + parts_[i].endBlock = 0; + } + + partCount_ = partCount; + return Status::Ok; +} + +NvVolume::Status NvVolume::loadNamesBlock() { + hasPartNames_ = false; + for (uint8_t i = 0; i < kMaxParts; ++i) partName16_[i] = 0; + + if (!dev_ || blockCount_ < 2) return Status::Ok; + + uint8_t sb1[16]; + Status rb = readBlockSt(*dev_, 1, sb1); + if (rb != Status::Ok) return Status::Ok; // optional block; treat as absent (including NotReady) + + const uint16_t stored = le16(&sb1[14]); + const uint16_t calc = crc16_sb(&sb1[0], 14); + if (stored != calc) return Status::Ok; + + for (uint8_t i = 0; i < kMaxParts; ++i) { + partName16_[i] = le16(&sb1[i * 2]); + } + hasPartNames_ = true; + return Status::Ok; +} + +NvVolume::Status NvVolume::writeNamesBlock(const uint16_t partName16[kMaxParts]) { + if (!dev_) return Status::NotReady; + if (!dev_->isWritable()) return Status::ReadOnly; + if (blockCount_ < 2) return Status::BadGeometry; + + uint8_t sb1[16] = {0}; + for (uint8_t i = 0; i < kMaxParts; ++i) { + wrle16(&sb1[i * 2], partName16[i]); + } + const uint16_t crc = crc16_sb(&sb1[0], 14); + wrle16(&sb1[14], crc); + + Status wb = writeBlockSt(*dev_, 1, sb1); + if (wb != Status::Ok) return wb; + + for (uint8_t i = 0; i < kMaxParts; ++i) partName16_[i] = partName16[i]; + hasPartNames_ = true; + return Status::Ok; +} + +NvVolume::Status NvVolume::scrubPartitionBlocksOnFormat_() { + if (!dev_) return Status::NotReady; + if (!dev_->isWritable()) return Status::ReadOnly; + + uint8_t ff[16]; + for (uint8_t i = 0; i < 16; ++i) ff[i] = 0xFF; + + for (uint8_t i = 0; i < partCount_; ++i) { + const Part& p = parts_[i]; + if (p.endBlock <= p.beginBlock) continue; + + uint16_t lo = p.beginBlock; + uint16_t hi = (uint16_t)(p.endBlock - 1u); + + if (lo >= blockCount_ || hi >= blockCount_) return Status::OutOfRange; + + // Don’t touch SB0/SB1 (physical blocks 0 and 1) + if (hi < 2u) continue; + if (lo < 2u) lo = 2u; + + for (uint16_t j = lo; j <= hi; ++j) { + Status s = writeBlockSt(*dev_, j, ff); + if (s != Status::Ok) return s; + } + } + + return Status::Ok; +} + +NvVolume::Status NvVolume::formatAll(const char* projectAscii, + uint16_t storageVersion, + const uint16_t starts[kMaxParts], + bool lastIsEndMarker, + const char* partAscii[kMaxParts]) { + if (!dev_) return status_ = Status::NotReady; + if (!dev_->isWritable()) return status_ = Status::ReadOnly; + if (blockCount_ < 3) return status_ = Status::BadGeometry; + + uint16_t prev = 0; + uint8_t N = 0; + for (uint8_t i = 0; i < kMaxParts; ++i) { + const uint16_t s = (uint16_t)(starts[i] & 0x0FFFu); + if (s == 0x0FFFu) break; + if (s < 2) return status_ = Status::BadGeometry; + if (s >= blockCount_) return status_ = Status::OutOfRange; + if (i > 0 && prev >= s) return status_ = Status::BadGeometry; + prev = s; + ++N; + } + if (lastIsEndMarker && N < 2) return status_ = Status::BadGeometry; + + uint8_t sb0[16] = {0}; + + const uint16_t volName16 = computeVolumeName16(projectAscii, storageVersion); + wrle16(&sb0[0], volName16); + + uint8_t flags8 = 0; + if (lastIsEndMarker) flags8 |= kFlagLastIsEndMarker; + flags8 |= (uint8_t)(kSbVersionV1 << kFlagVersionShift); + sb0[2] = flags8; + + uint8_t* packed = &sb0[3]; + for (uint8_t i = 0; i < 11; ++i) packed[i] = 0; + + setBitsLSB(packed, 0, 4, 0); + for (uint8_t i = 0; i < kMaxParts; ++i) { + setBitsLSB(packed, 4u + (uint32_t)i * 12u, 12u, (uint32_t)(starts[i] & 0x0FFFu)); + } + + const uint16_t crc0 = crc16_sb(&sb0[0], 14); + wrle16(&sb0[14], crc0); + + Status wb0 = writeBlockSt(*dev_, 0, sb0); + if (wb0 != Status::Ok) return status_ = wb0; + + uint16_t pn[7] = {0}; + for (uint8_t i = 0; i < kMaxParts; ++i) { + if (partAscii && partAscii[i] && partAscii[i][0]) pn[i] = computePartName16(partAscii[i]); + else pn[i] = 0; + } + + Status w1 = writeNamesBlock(pn); + if (w1 != Status::Ok) return status_ = w1; + + storedVolumeName16_ = volName16; + flags8_ = flags8; + flags4_ = 0; + + // Post-format self-check: this is our own SB0 buffer; propagate real cause. + Status e = enumerateFromSb0(sb0); + if (e != Status::Ok) { mounted_ = false; partCount_ = 0; return status_ = e; } + + Status scrub = scrubPartitionBlocksOnFormat_(); + if (scrub != Status::Ok) { mounted_ = false; partCount_ = 0; return status_ = scrub; } + + mounted_ = true; + return status_ = Status::Ok; +} + +NvVolume::Status NvVolume::formatBegin(const char* projectAscii, uint16_t storageVersion) { + if (!dev_) return status_ = Status::NotReady; + if (!dev_->isWritable()) return status_ = Status::ReadOnly; + + builderActive_ = true; + builderProject_ = projectAscii ? projectAscii : ""; + builderStorageVersion_ = storageVersion; + builderCount_ = 0; + for (uint8_t i = 0; i < kMaxParts; ++i) { + builderPartAscii_[i] = nullptr; + builderSizeBlocks_[i] = 0; + } + return status_ = Status::Ok; +} + +bool NvVolume::formatAddPartition(const char* partitionAscii, uint32_t sizeBytes) { + if (!builderActive_) return false; + if (builderCount_ >= kMaxParts) return false; + + if (sizeBytes == 0) { + for (uint8_t i = 0; i < builderCount_; ++i) { + if (builderSizeBlocks_[i] == 0) return false; + } + builderSizeBlocks_[builderCount_] = 0; + } else { + if (sizeBytes & (kBlockSize - 1u)) return false; + const uint32_t blocks = sizeBytes / kBlockSize; + if (blocks == 0 || blocks > 0xFFFFu) return false; + builderSizeBlocks_[builderCount_] = (uint16_t)blocks; + + for (uint8_t i = 0; i < builderCount_; ++i) { + if (builderSizeBlocks_[i] == 0) return false; + } + } + + builderPartAscii_[builderCount_] = partitionAscii; + ++builderCount_; + return true; +} + +NvVolume::Status NvVolume::formatCommit() { + if (!builderActive_) return status_ = Status::NotReady; + if (!dev_) return status_ = Status::NotReady; + if (!dev_->isWritable()) return status_ = Status::ReadOnly; + if (blockCount_ < 3) return status_ = Status::BadGeometry; + + if (builderCount_ == 0) return status_ = Status::BadGeometry; + + uint16_t starts[kMaxParts]; + for (uint8_t i = 0; i < kMaxParts; ++i) starts[i] = 0x0FFFu; + + uint16_t cur = 2; + for (uint8_t i = 0; i < builderCount_; ++i) { + starts[i] = cur; + + uint16_t sz = builderSizeBlocks_[i]; + if (sz == 0) { + if (cur >= blockCount_) return status_ = Status::OutOfRange; + cur = blockCount_; + break; + } else { + const uint32_t next = (uint32_t)cur + (uint32_t)sz; + if (next > (uint32_t)blockCount_) return status_ = Status::OutOfRange; + cur = (uint16_t)next; + } + } + + const char* partAscii[kMaxParts] = {nullptr}; + for (uint8_t i = 0; i < builderCount_; ++i) partAscii[i] = builderPartAscii_[i]; + + Status s = formatAll(builderProject_, builderStorageVersion_, starts, false, partAscii); + + builderActive_ = false; + builderProject_ = nullptr; + builderStorageVersion_ = 0; + builderCount_ = 0; + for (uint8_t i = 0; i < kMaxParts; ++i) { + builderPartAscii_[i] = nullptr; + builderSizeBlocks_[i] = 0; + } + + return status_ = s; +} + +uint16_t NvVolume::partitionBlockSize(uint8_t idx) const { + if (!mounted_ || idx >= partCount_) return 0; + const Part& p = parts_[idx]; + return (uint16_t)(p.endBlock - p.beginBlock); +} + +uint16_t NvVolume::partitionByteSize(uint8_t idx) const { + const uint16_t blocks = partitionBlockSize(idx); + return (uint16_t)(blocks << 4); +} + +int8_t NvVolume::partitionFindByName16(uint16_t tag) const { + if (!mounted_) return -1; + if (!hasPartNames_) return -1; + if (tag == 0) return -1; + + for (uint8_t i = 0; i < partCount_; ++i) { + if (partName16_[i] == tag) return (int8_t)i; + } + return -1; +} + +bool NvVolume::partitionFind(const char* partitionAscii, uint8_t& outIdx) const { + outIdx = 0xFF; + if (!mounted_ || !hasPartNames_ || !partitionAscii || !partitionAscii[0]) return false; + + const uint16_t tag = computePartName16(partitionAscii); + if (tag == 0) return false; + + const int8_t idx = partitionFindByName16(tag); + if (idx < 0) return false; + + outIdx = (uint8_t)idx; + return true; +} + +bool NvVolume::partitionFind(const char* partitionAscii, PartitionView16& out) const { + out = PartitionView16{}; + uint8_t idx = 0xFF; + if (!partitionFind(partitionAscii, idx)) return false; + + out.idx = idx; + out.beginBlock = parts_[idx].beginBlock; + out.endBlock = parts_[idx].endBlock; + return true; +} + +bool NvVolume::isReadable() const { + return dev_ && dev_->isReadable(); +} + +bool NvVolume::isWritable() const { + return dev_ && dev_->isWritable(); +} + +static inline NvVolume::Status checkRange_(uint16_t partBytes, uint16_t offset, uint16_t len) { + if (len == 0) return NvVolume::Status::Ok; + const uint32_t end = (uint32_t)offset + (uint32_t)len; + return (end <= (uint32_t)partBytes) ? NvVolume::Status::Ok : NvVolume::Status::OutOfRange; +} + +NvVolume::Status NvVolume::partitionRead(uint8_t partIdx, uint16_t offset, void* dst, uint16_t len) { + if (!dev_ || !mounted_) return Status::NotReady; + if (partIdx >= partCount_) return Status::OutOfRange; + if (len == 0) return Status::Ok; + if (!dst) return Status::IoError; + + const Part& p = parts_[partIdx]; + const uint16_t partBytes = (uint16_t)((p.endBlock - p.beginBlock) << 4); + + const Status chk = checkRange_(partBytes, offset, len); + if (chk != Status::Ok) return chk; + + const uint16_t absAddr = (uint16_t)((p.beginBlock << 4) + offset); + return mapIo(dev_->read(absAddr, dst, len)); +} + +NvVolume::Status NvVolume::partitionWrite(uint8_t partIdx, uint16_t offset, const void* src, uint16_t len) { + if (!dev_ || !mounted_) return Status::NotReady; + if (partIdx >= partCount_) return Status::OutOfRange; + if (!dev_->isWritable()) return Status::ReadOnly; + if (len == 0) return Status::Ok; + if (!src) return Status::IoError; + + const Part& p = parts_[partIdx]; + const uint16_t partBytes = (uint16_t)((p.endBlock - p.beginBlock) << 4); + + const Status chk = checkRange_(partBytes, offset, len); + if (chk != Status::Ok) return chk; + + const uint16_t absAddr = (uint16_t)((p.beginBlock << 4) + offset); + return mapIo(dev_->write(absAddr, src, len)); +} + +NvVolume::Status NvVolume::partitionReadBlock(uint8_t partIdx, uint16_t partBlockOfs, uint8_t out16[16]) { + if (!dev_ || !mounted_) return Status::NotReady; + if (partIdx >= partCount_) return Status::OutOfRange; + + const Part& p = parts_[partIdx]; + const uint16_t blocks = (uint16_t)(p.endBlock - p.beginBlock); + if (partBlockOfs >= blocks) return Status::OutOfRange; + + const uint16_t absBlock = (uint16_t)(p.beginBlock + partBlockOfs); + return readBlockSt(*dev_, absBlock, out16); +} + +NvVolume::Status NvVolume::partitionWriteBlock(uint8_t partIdx, uint16_t partBlockOfs, const uint8_t in16[16]) { + if (!dev_ || !mounted_) return Status::NotReady; + if (partIdx >= partCount_) return Status::OutOfRange; + if (!dev_->isWritable()) return Status::ReadOnly; + + const Part& p = parts_[partIdx]; + const uint16_t blocks = (uint16_t)(p.endBlock - p.beginBlock); + if (partBlockOfs >= blocks) return Status::OutOfRange; + + const uint16_t absBlock = (uint16_t)(p.beginBlock + partBlockOfs); + return writeBlockSt(*dev_, absBlock, in16); +} + +NvVolume::Status NvVolume::partitionReadInBlock(uint8_t partIdx, uint16_t partBlockOfs, + uint8_t byteOfs, void* dst, uint8_t len) { + if (!dev_ || !mounted_) return Status::NotReady; + if (partIdx >= partCount_) return Status::OutOfRange; + if (!dst || len == 0) return Status::OutOfRange; + if (byteOfs >= 16 || (uint16_t)byteOfs + (uint16_t)len > 16) return Status::Unaligned; + + const Part& p = parts_[partIdx]; + const uint16_t blocks = (uint16_t)(p.endBlock - p.beginBlock); + if (partBlockOfs >= blocks) return Status::OutOfRange; + + const uint16_t absBlock = (uint16_t)(p.beginBlock + partBlockOfs); + const uint16_t absAddr = (uint16_t)((absBlock << 4) + byteOfs); + + return mapIo(dev_->read(absAddr, dst, (uint16_t)len)); +} + +NvVolume::Status NvVolume::partitionWriteInBlock(uint8_t partIdx, uint16_t partBlockOfs, + uint8_t byteOfs, const void* src, uint8_t len) { + if (!dev_ || !mounted_) return Status::NotReady; + if (partIdx >= partCount_) return Status::OutOfRange; + if (!dev_->isWritable()) return Status::ReadOnly; + if (!src || len == 0) return Status::OutOfRange; + if (byteOfs >= 16 || (uint16_t)byteOfs + (uint16_t)len > 16) return Status::Unaligned; + + const Part& p = parts_[partIdx]; + const uint16_t blocks = (uint16_t)(p.endBlock - p.beginBlock); + if (partBlockOfs >= blocks) return Status::OutOfRange; + + const uint16_t absBlock = (uint16_t)(p.beginBlock + partBlockOfs); + const uint16_t absAddr = (uint16_t)((absBlock << 4) + byteOfs); + + return mapIo(dev_->write(absAddr, src, (uint16_t)len)); +} + +NvVolume::Status NvVolume::invalidateNextMount() { + if (!dev_) return status_ = Status::NotReady; + if (!dev_->isWritable()) return status_ = Status::ReadOnly; + if (blockCount_ < 1) return status_ = Status::BadGeometry; + + uint8_t sb0[16]; + Status rb = readBlockSt(*dev_, 0, sb0); + if (rb != Status::Ok) return status_ = rb; + + // Poison ONLY the stored CRC (bytes 14..15). No need to touch protected payload. + sb0[14] ^= 0x01u; + + Status wb = writeBlockSt(*dev_, 0, sb0); + if (wb != Status::Ok) return status_ = wb; + + return status_ = Status::Ok; +} diff --git a/src/lib/nv/NvVolume.h b/src/lib/nv/NvVolume.h new file mode 100755 index 0000000..48ba1fd --- /dev/null +++ b/src/lib/nv/NvVolume.h @@ -0,0 +1,184 @@ +// NvVolume.h +#pragma once +#include +#include + +#include "device/NvDeviceBase.h" + +// Superblocks v1: +// - block size = 16 bytes +// - block 0 = SB0 (layout) +// - block 1 = SB1 (partition name tags, optional) +// - partitions start at block >= 2 +class NvVolume { +public: + enum class Status : uint8_t { + Ok = 0, + NotReady, + BadGeometry, + Unaligned, + OutOfRange, + ReadOnly, + IoError, + Unformatted, + }; + + static constexpr uint16_t kBlockSize = 16; + static constexpr uint16_t kMaxBlocks = 4096; // 12-bit block indices + static constexpr uint8_t kMaxParts = 7; + static constexpr uint8_t kSbVersionV1 = 1; + + // SB0 flags8: + // bit1 LAST_IS_END_MARKER + // bits2..3 reserved (0) + // bits4..7 version (v1=1) + static constexpr uint8_t kFlagLastIsEndMarker = 0x02; + static constexpr uint8_t kFlagReservedMask = 0x0C; // bits2..3 must be 0 + static constexpr uint8_t kFlagVersionShift = 4; + + struct Part { + uint16_t beginBlock = 0; // inclusive + uint16_t endBlock = 0; // exclusive + }; + + struct PartitionView16 { + uint8_t idx = 0xFF; + uint16_t beginBlock = 0; + uint16_t endBlock = 0; + uint16_t blockCount() const { return (uint16_t)(endBlock - beginBlock); } + uint16_t byteCount() const { return (uint16_t)(blockCount() << 4); } + }; + + NvVolume() = default; + + // ---------------- device binding / identity ---------------- + Status init(NvDevice& dev); + + // Name tags (hashing lives in Crc16 now) + static uint16_t computeVolumeName16(const char* projectAscii, uint16_t storageVersion); + static uint16_t computePartName16(const char* partitionAscii); + + // ---------------- mount / format ---------------- + // Mount validates SB0 CRC/version/layout and loads partitions. + // SB1 (partition names) is optional; if its CRC fails, names are treated as absent. + Status mount(); + Status mount(const char* projectAscii, uint16_t storageVersion); + + // causes the next volume mount to fail, triggering a reset to defaults normally + Status invalidateNextMount(); + + // Format SB0 + SB1. + // Note the internal 16-bit tag is ONLY very probably unique for a unique name (65536 combinations.) + Status formatAll(const char* projectAscii, + uint16_t storageVersion, + const uint16_t starts[kMaxParts], + bool lastIsEndMarker, + const char* partAscii[kMaxParts]); + + // Builder API (chained calls style; strings must remain valid until formatCommit()). + Status formatBegin(const char* projectAscii, uint16_t storageVersion); + bool formatAddPartition(const char* partitionAscii, uint32_t sizeBytes); // sizeBytes==0 => remainder + Status formatCommit(); + + // ---------------- volume query ---------------- + bool isMounted() const { return mounted_; } + uint16_t blockCount() const { return blockCount_; } + uint32_t byteCount() const { return (uint32_t)blockCount_ << 4; } + bool hasPartNames() const { return hasPartNames_; } + + bool isReadable() const; + bool isWritable() const; + + // ---------------- partition query ---------------- + uint8_t partitionCount() const { return partCount_; } + Part partition(uint8_t idx) const { return (idx < partCount_) ? parts_[idx] : Part{}; } + uint16_t partitionName16(uint8_t idx) const { return (idx < partCount_) ? partName16_[idx] : 0; } + + uint16_t partitionBlockSize(uint8_t idx) const; + uint16_t partitionByteSize(uint8_t idx) const; + + // ---------------- partition find (requires valid SB1) ---------------- + // Find by already-computed 16-bit name tag (tag==0 reserved => "unnamed"). + int8_t partitionFindByName16(uint16_t tag) const; + + // Find by ASCII name (internally hashed to 16-bit tag). + // Note the internal 16-bit tag is ONLY very probably unique for a unique name (65536 combinations.) + bool partitionFind(const char* partitionAscii, uint8_t& outIdx) const; + bool partitionFind(const char* partitionAscii, PartitionView16& out) const; + + // ---------------- partition I/O ---------------- + // Aligned I/O (offset/len must be multiples of 16). + Status partitionRead(uint8_t partIdx, uint16_t offset, void* dst, uint16_t len); + Status partitionWrite(uint8_t partIdx, uint16_t offset, const void* src, uint16_t len); + + // Block-scoped I/O (never cross a 16B block). + Status partitionReadBlock(uint8_t partIdx, uint16_t partBlockOfs, uint8_t out16[16]); + Status partitionWriteBlock(uint8_t partIdx, uint16_t partBlockOfs, const uint8_t in16[16]); + Status partitionReadInBlock(uint8_t partIdx, uint16_t partBlockOfs, uint8_t byteOfs, void* dst, uint8_t len); + Status partitionWriteInBlock(uint8_t partIdx, uint16_t partBlockOfs, uint8_t byteOfs, const void* src, uint8_t len); + +private: + static constexpr const char* kSalt = "OnCueV1"; + + static inline uint16_t le16(const uint8_t* p) { return (uint16_t)p[0] | (uint16_t)(p[1] << 8); } + static inline void wrle16(uint8_t* p, uint16_t v) { p[0] = (uint8_t)(v & 0xFFu); p[1] = (uint8_t)(v >> 8); } + + static uint16_t crc16_sb(const uint8_t* data, uint16_t lenNoCrc); + + static uint32_t getBitsLSB(const uint8_t* bytes11, uint32_t bitIndex, uint32_t bitCount); + static void setBitsLSB(uint8_t* bytes11, uint32_t bitIndex, uint32_t bitCount, uint32_t value); + + Status enumerateFromSb0(const uint8_t sb0[16]); + Status loadNamesBlock(); + Status writeNamesBlock(const uint16_t partName16[kMaxParts]); + + static inline Status mapIo(NvDevice::IoStatus st) { + switch (st) { + case NvDevice::IoStatus::Ok: return Status::Ok; + case NvDevice::IoStatus::ReadOnly: return Status::ReadOnly; + case NvDevice::IoStatus::OutOfRange: return Status::OutOfRange; + case NvDevice::IoStatus::NotReady: return Status::NotReady; + default: return Status::IoError; + } + } + + // Status-returning 16-byte block helpers (used internally for better error propagation). + static inline Status readBlockSt(NvDevice& d, uint16_t blockIndex, uint8_t out16[16]) { + return mapIo(d.readBlock16(blockIndex, out16)); + } + + static inline Status writeBlockSt(NvDevice& d, uint16_t blockIndex, const uint8_t in16[16]) { + if (d.supportsWriteBlock16()) { + return mapIo(d.writeBlock16(blockIndex, in16)); + } + return mapIo(d.write((uint16_t)(blockIndex << 4), in16, 16)); + } + + Status scrubPartitionBlocksOnFormat_(); + +private: + NvDevice* dev_ = nullptr; + + uint16_t blockCount_ = 0; + + bool mounted_ = false; + Status status_ = Status::NotReady; + + uint16_t storedVolumeName16_ = 0; + uint8_t flags8_ = 0; + uint8_t flags4_ = 0; + + uint8_t partCount_ = 0; + Part parts_[kMaxParts]; + + uint16_t partName16_[kMaxParts] = {0}; + bool hasPartNames_ = false; + + // builder staging + bool builderActive_ = false; + const char* builderProject_ = nullptr; + uint16_t builderStorageVersion_ = 0; + uint8_t builderCount_ = 0; + const char* builderPartAscii_[kMaxParts] = {nullptr}; + uint16_t builderSizeBlocks_[kMaxParts] = {0}; // 0 => remainder +}; diff --git a/src/lib/nv/device/24xxI2C.h b/src/lib/nv/device/24xxI2C.h new file mode 100755 index 0000000..094405c --- /dev/null +++ b/src/lib/nv/device/24xxI2C.h @@ -0,0 +1,147 @@ +// NvDevice24xxI2C.h +#pragma once + +#include "NvDeviceBase.h" +#include + +#ifndef EEPROM_ACK_SKIP_MS + #define EEPROM_ACK_SKIP_MS 20 +#endif + +#ifndef EEPROM_ACK_TIMEOUT_MS + #define EEPROM_ACK_TIMEOUT_MS 50 +#endif + +template +class NvDevice24xxI2C : public NvDevice { +public: + explicit NvDevice24xxI2C(TwoWire& wire, uint8_t addr7) + : wire_(&wire), addr_(addr7) {} + + bool init() override { + wire_->begin(); + wire_->beginTransmission(addr_); + bool success = (wire_->endTransmission() == 0); + VF("MSG: NvDevice, 24xx "); V(sizeBytes()/1024); VF("KB I2C EEPROM "); + if (success) { VLF("found"); } else { VLF("NOT FOUND!"); } + return success; + } + + uint32_t sizeBytes() const override { return DeviceBytes; } + + // Device write cycle endurance + // Low < 100K writes, Mid > ~100K writes, High > ~100M writes (FRAM) + Endurance endurance() const override { return Endurance::Mid; } + + IoStatus read(uint16_t addr, void* dst, uint16_t len) override { + if (!dst) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + + uint8_t* out = (uint8_t*)dst; + + if (!waitForDevice_()) return IoStatus::NotReady; + + for (uint16_t i = 0; i < len; i++) { + const uint16_t a = (uint16_t)(addr + i); + + wire_->beginTransmission(addr_); + wire_->write((uint8_t)(a >> 8)); + wire_->write((uint8_t)(a & 0xFF)); + if (wire_->endTransmission(false) != 0) return IoStatus::IoError; + + if (wire_->requestFrom((int)addr_, (int)1) != 1) return IoStatus::IoError; + if (!wire_->available()) return IoStatus::IoError; + out[i] = (uint8_t)wire_->read(); + } + return IoStatus::Ok; + } + + IoStatus write(uint16_t addr, const void* src, uint16_t len) override { + if (!src) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + + const uint8_t* in = (const uint8_t*)src; + + for (uint16_t i = 0; i < len; i++) { + const uint16_t a = (uint16_t)(addr + i); + + if (!waitForDevice_()) return IoStatus::NotReady; + + wire_->beginTransmission(addr_); + wire_->write((uint8_t)(a >> 8)); + wire_->write((uint8_t)(a & 0xFF)); + wire_->write(in[i]); + if (wire_->endTransmission() != 0) return IoStatus::IoError; + + lastWriteTimeMs_ = millis(); + } + return IoStatus::Ok; + } + + bool supportsReadBlock16() const override { return true; } + + IoStatus readBlock16(uint16_t blockIdx, void* dst16) override { + if (!dst16) return IoStatus::OutOfRange; + + const uint16_t addr = (uint16_t)(blockIdx << 4); + if ((uint32_t)addr + 16u > sizeBytes()) return IoStatus::OutOfRange; + + if (!waitForDevice_()) return IoStatus::NotReady; + + wire_->beginTransmission(addr_); + wire_->write((uint8_t)(addr >> 8)); + wire_->write((uint8_t)(addr & 0xFF)); + if (wire_->endTransmission(false) != 0) return IoStatus::IoError; + + if (wire_->requestFrom((int)addr_, (int)16) != 16) return IoStatus::IoError; + + uint8_t* out = (uint8_t*)dst16; + for (uint8_t i = 0; i < 16; i++) { + if (!wire_->available()) return IoStatus::IoError; + out[i] = (uint8_t)wire_->read(); + } + return IoStatus::Ok; + } + + bool supportsWriteBlock16() const override { return true; } + + IoStatus writeBlock16(uint16_t blockIdx, const void* src16) override { + if (!src16) return IoStatus::OutOfRange; + + const uint16_t addr = (uint16_t)(blockIdx << 4); + if ((uint32_t)addr + 16u > sizeBytes()) return IoStatus::OutOfRange; + + if (!waitForDevice_()) return IoStatus::NotReady; + + wire_->beginTransmission(addr_); + wire_->write((uint8_t)(addr >> 8)); + wire_->write((uint8_t)(addr & 0xFF)); + + const uint8_t* p = (const uint8_t*)src16; + for (uint8_t i = 0; i < 16; i++) wire_->write(p[i]); + + if (wire_->endTransmission() != 0) return IoStatus::IoError; + + lastWriteTimeMs_ = millis(); + return IoStatus::Ok; + } + +private: + bool waitForDevice_() { + if (lastWriteTimeMs_ == 0) return true; + + const uint32_t now = millis(); + if ((uint32_t)(now - lastWriteTimeMs_) >= (uint32_t)EEPROM_ACK_SKIP_MS) return true; + + const uint32_t t0 = now; + while ((uint32_t)(millis() - t0) < (uint32_t)EEPROM_ACK_TIMEOUT_MS) { + wire_->beginTransmission(addr_); + if (wire_->endTransmission() == 0) return true; + } + return false; + } + + uint32_t lastWriteTimeMs_ = 0; + TwoWire* wire_ = nullptr; + uint8_t addr_ = 0; +}; diff --git a/src/lib/nv/device/DeviceNull.h b/src/lib/nv/device/DeviceNull.h new file mode 100755 index 0000000..3856da3 --- /dev/null +++ b/src/lib/nv/device/DeviceNull.h @@ -0,0 +1,71 @@ +// ------------------------------------------------------------------------------------------------- +// NvDeviceNull.h +// +// Null NV backend (no persistence). +// +// - Reads return 0xFF bytes (erased-state semantics). +// - Writes succeed but are discarded. +// - Useful for bring-up, unit tests, or builds without NV hardware. +// +// Contract: +// - sizeBytes() reports a usable aligned size (multiple of 16). +// - read/write are flat device-relative addressing with 16-bit addr/len. +// +// ------------------------------------------------------------------------------------------------- +#pragma once + +#include +#include + +#include "NvDeviceBase.h" + +class NvDeviceNull final : public NvDevice { +public: + // Ensure the reported size is a multiple of 16 (minimum 16). + explicit NvDeviceNull(uint32_t sizeBytes = kDefaultSizeBytes) + : sizeBytes_(align16_(sizeBytes)) {} + + void setSizeBytes(uint32_t sizeBytes) { sizeBytes_ = align16_(sizeBytes); } + + // ---- NvDevice ---- + bool init() override { return true; } + + uint32_t sizeBytes() const override { return sizeBytes_; } + + IoStatus read(uint16_t addr, void* dst, uint16_t len) override { + if (len == 0) return IoStatus::Ok; + if (!dst) return IoStatus::IoError; + + const uint32_t end = (uint32_t)addr + (uint32_t)len; + if (end > sizeBytes_) return IoStatus::OutOfRange; + + memset(dst, 0xFF, (size_t)len); + return IoStatus::Ok; + } + + IoStatus write(uint16_t addr, const void* src, uint16_t len) override { + if (len == 0) return IoStatus::Ok; + if (!src) return IoStatus::IoError; + + const uint32_t end = (uint32_t)addr + (uint32_t)len; + if (end > sizeBytes_) return IoStatus::OutOfRange; + + // Discard writes. + return IoStatus::Ok; + } + + // Advertise block16 accelerators as supported. They will call through + // the base default implementations (which call read/write). + bool supportsWriteBlock16() const override { return true; } + bool supportsReadBlock16() const override { return true; } + +private: + static constexpr uint32_t kDefaultSizeBytes = 64u * 1024u; + + static uint32_t align16_(uint32_t n) { + if (n < 16u) n = 16u; + return (n + 15u) & ~15u; + } + + uint32_t sizeBytes_ = kDefaultSizeBytes; +}; diff --git a/src/lib/nv/device/EepromArduino.h b/src/lib/nv/device/EepromArduino.h new file mode 100755 index 0000000..0f5acab --- /dev/null +++ b/src/lib/nv/device/EepromArduino.h @@ -0,0 +1,68 @@ +// NvDeviceEepromArduino.h +#pragma once +#include "NvDeviceBase.h" +#include + +#if !defined(NV_DRIVER) || (NV_DRIVER != NV_EEPROM) + #error "NvDeviceEepromArduino.h included but NV_DRIVER != NV_EEPROM" +#endif + +#ifndef E2END + #error "E2END must be defined for NV_EEPROM (set it in HAL or NvsConfig.h)" +#endif + +class NvDeviceEepromArduino : public NvDevice { +public: + bool init() override { + // Nothing to init for classic EEPROM + VLF("MSG: NvDevice, using built-in EEPROM via Arduino library"); + return true; + } + + // reports usable aligned size (multiple of 16) + uint32_t sizeBytes() const override { + const uint32_t n = (uint32_t)(E2END + 1u); + return n & ~15u; + } + + // Device write cycle endurance + // Low < 100K writes, Mid > ~100K writes, High > ~100M writes (FRAM) + Endurance endurance() const override { return Endurance::Mid; } + + IoStatus read(uint16_t addr, void* dst, uint16_t len) override { + if (!dst) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + + uint8_t* p = (uint8_t*)dst; + for (uint16_t i = 0; i < len; i++) { + p[i] = EEPROM.read((int)(addr + i)); + } + return IoStatus::Ok; + } + + IoStatus write(uint16_t addr, const void* src, uint16_t len) override { + if (!src) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + if (!isWritable()) return IoStatus::ReadOnly; + + const uint8_t* p = (const uint8_t*)src; + for (uint16_t i = 0; i < len; i++) { + const int a = (int)(addr + i); + const uint8_t v = p[i]; + + // AVR internal EEPROM: update() is supported and avoids needless wear. + #if defined(ARDUINO_ARCH_AVR) + EEPROM.update(a, v); + #elif defined(HAL_EEPROM_HAS_UPDATE) + EEPROM.update(a, v); + #else + EEPROM.write(a, v); + #endif + } + return IoStatus::Ok; + } + + bool hasCommit() const override { return false; } + IoStatus commit() override { return IoStatus::Ok; } + bool commitDone() const override { return true; } +}; diff --git a/src/lib/nv/device/EepromEmuEsp.h b/src/lib/nv/device/EepromEmuEsp.h new file mode 100755 index 0000000..636d46a --- /dev/null +++ b/src/lib/nv/device/EepromEmuEsp.h @@ -0,0 +1,81 @@ +// NvDeviceEepromEmuEsp.h +#pragma once +#include "NvDeviceBase.h" + +#if defined(ESP32) || defined(ESP8266) + #include +#endif + +class NvDeviceEepromEmuEsp : public NvDevice { +public: + bool init() override { + #if defined(ESP32) + const uint32_t sz = sizeBytes(); + VLF("MSG: NvDevice, using built-in EEPROM 4KB via. ESP32 core library"); + return EEPROM.begin((int)sz); + #elif defined(ESP8266) + const uint32_t sz = sizeBytes(); + VLF("MSG: NvDevice, using built-in EEPROM 4KB via. ESP8266 core library"); + EEPROM.begin((int)sz); + return true; + #else + VLF("MSG: NvDevice, NOT FOUND!"); + return false; + #endif + } + + uint32_t sizeBytes() const override { + return 4096u; + } + + // Device write cycle endurance + // Low < 100K writes, Mid > ~100K writes, High > ~100M writes (FRAM) + Endurance endurance() const override { return Endurance::Low; } + + IoStatus read(uint16_t addr, void* dst, uint16_t len) override { + #if !(defined(ESP32) || defined(ESP8266)) + (void)addr; (void)dst; (void)len; + return IoStatus::IoError; + #else + if (!dst) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + + uint8_t* p = (uint8_t*)dst; + for (uint16_t i = 0; i < len; i++) { + p[i] = EEPROM.read((int)(addr + i)); + } + return IoStatus::Ok; + #endif + } + + IoStatus write(uint16_t addr, const void* src, uint16_t len) override { + #if !(defined(ESP32) || defined(ESP8266)) + (void)addr; (void)src; (void)len; + return IoStatus::IoError; + #else + if (!src) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + if (!isWritable()) return IoStatus::ReadOnly; + + const uint8_t* p = (const uint8_t*)src; + for (uint16_t i = 0; i < len; i++) { + EEPROM.write((int)(addr + i), p[i]); + } + return IoStatus::Ok; + #endif + } + + bool hasCommit() const override { return true; } + + IoStatus commit() override { + #if !(defined(ESP32) || defined(ESP8266)) + return IoStatus::IoError; + #else + bool ok = EEPROM.commit(); + VLF("MSG: Nv, commit"); + return ok ? IoStatus::Ok : IoStatus::IoError; + #endif + } + + bool commitDone() const override { return true; } // synchronous in Arduino EEPROM +}; diff --git a/src/lib/nv/device/EepromEmuM0.h b/src/lib/nv/device/EepromEmuM0.h new file mode 100755 index 0000000..40d6343 --- /dev/null +++ b/src/lib/nv/device/EepromEmuM0.h @@ -0,0 +1,88 @@ +// NvDeviceEepromEmuM0.h +#pragma once + +#include "NvDeviceBase.h" + +// Arduino SAMD (M0/M0 Pro/Zero) EEPROM emulation. +// Depending on core, the header may be or . +#if defined(ARDUINO_ARCH_SAMD) + #include +#endif + +#ifndef E2END + #error "E2END must be defined for NvDeviceEepromEmuM0" +#endif + +class NvDeviceEepromEmuM0 : public NvDevice { +public: + bool init() override { + #if !defined(ARDUINO_ARCH_SAMD) + VLF("MSG: NvDevice, NOT FOUND!"); + return false; + #else + const uint32_t sz = sizeBytes(); + // Match your old guard: M0 emu is expected to be exactly 1024 bytes. + if (sz != 1024u) return false; + + // Many SAMD EEPROM emu implementations don't require begin(size). + // If your core provides EEPROM.begin(size), you can add it here. + VLF("MSG: NvDevice, using built-in 1KB EEPROM via. M0 core library"); + return true; + #endif + } + + uint32_t sizeBytes() const override { + return (uint32_t)(E2END + 1u); + } + + // Device write cycle endurance + // Low < 100K writes, Mid > ~100K writes, High > ~100M writes (FRAM) + Endurance endurance() const override { return Endurance::Low; } + + IoStatus read(uint16_t addr, void* dst, uint16_t len) override { + #if !defined(ARDUINO_ARCH_SAMD) + (void)addr; (void)dst; (void)len; + return IoStatus::IoError; + #else + if (!dst) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + + uint8_t* p = (uint8_t*)dst; + for (uint16_t i = 0; i < len; i++) { + p[i] = EEPROM.read((int)(addr + i)); + } + return IoStatus::Ok; + #endif + } + + IoStatus write(uint16_t addr, const void* src, uint16_t len) override { + #if !defined(ARDUINO_ARCH_SAMD) + (void)addr; (void)src; (void)len; + return IoStatus::IoError; + #else + if (!src) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + if (!isWritable()) return IoStatus::ReadOnly; + + const uint8_t* p = (const uint8_t*)src; + for (uint16_t i = 0; i < len; i++) { + EEPROM.write((int)(addr + i), p[i]); + } + return IoStatus::Ok; + #endif + } + + bool hasCommit() const override { return true; } + + IoStatus commit() override { + #if !defined(ARDUINO_ARCH_SAMD) + return IoStatus::IoError; + #else + // Most SAMD EEPROM emulation layers expose EEPROM.commit(). + EEPROM.commit(); + return IoStatus::Ok; + #endif + } + + bool commitDone() const override { return true; } // commit is synchronous +}; diff --git a/src/lib/nv/device/Mb85rcI2C.h b/src/lib/nv/device/Mb85rcI2C.h new file mode 100755 index 0000000..c959e12 --- /dev/null +++ b/src/lib/nv/device/Mb85rcI2C.h @@ -0,0 +1,127 @@ +// NvDeviceMb85rcI2c.h +#pragma once + +#include "NvDeviceBase.h" +#include + +template +class NvDeviceMb85rcI2C : public NvDevice { +public: + explicit NvDeviceMb85rcI2C(TwoWire& wire, uint8_t addr7) + : wire_(&wire), addr_(addr7) {} + + bool init() override { + wire_->begin(); + wire_->beginTransmission(addr_); + bool success = (wire_->endTransmission() == 0); + VF("MSG: NvDevice, MB85RC "); V(sizeBytes()/1024); VF("KB I2C FRAM "); + if (success) { VLF("found"); } else { VLF("NOT FOUND!"); } + return success; + } + + uint32_t sizeBytes() const override { return DeviceBytes; } + + // Device write cycle endurance + // Low < 100K writes, Mid > ~100K writes, High > ~100M writes (FRAM) + Endurance endurance() const override { return Endurance::High; } + + IoStatus read(uint16_t addr, void* dst, uint16_t len) override { + if (!dst) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + + uint8_t* out = (uint8_t*)dst; + + // 24xx-like simple loop (byte-at-a-time). You can later optimize to chunked streaming reads if desired. + for (uint16_t i = 0; i < len; i++) { + const uint16_t a = (uint16_t)(addr + i); + + wire_->beginTransmission(addr_); + wire_->write((uint8_t)(a >> 8)); + wire_->write((uint8_t)(a & 0xFF)); + if (wire_->endTransmission(false) != 0) return IoStatus::IoError; + + if (wire_->requestFrom((int)addr_, (int)1) != 1) return IoStatus::IoError; + if (!wire_->available()) return IoStatus::IoError; + out[i] = (uint8_t)wire_->read(); + } + + return IoStatus::Ok; + } + + IoStatus write(uint16_t addr, const void* src, uint16_t len) override { + if (!src) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > sizeBytes()) return IoStatus::OutOfRange; + if (!isWritable()) return IoStatus::ReadOnly; + + const uint8_t* in = (const uint8_t*)src; + + // 24xx-like simple loop (byte-at-a-time) + for (uint16_t i = 0; i < len; i++) { + const uint16_t a = (uint16_t)(addr + i); + + wire_->beginTransmission(addr_); + wire_->write((uint8_t)(a >> 8)); + wire_->write((uint8_t)(a & 0xFF)); + wire_->write(in[i]); + if (wire_->endTransmission() != 0) return IoStatus::IoError; + } + + return IoStatus::Ok; + } + + bool supportsReadBlock16() const override { return true; } + + // Accelerator: 16-byte block read in one I2C transaction + IoStatus readBlock16(uint16_t blockIdx, void* dst16) override { + if (!dst16) return IoStatus::OutOfRange; + const uint16_t addr = (uint16_t)(blockIdx << 4); + if ((uint32_t)addr + 16u > sizeBytes()) return IoStatus::OutOfRange; + + // Set address pointer, keep bus (repeated start) + wire_->beginTransmission(addr_); + wire_->write((uint8_t)(addr >> 8)); + wire_->write((uint8_t)(addr & 0xFF)); + if (wire_->endTransmission(false) != 0) return IoStatus::IoError; + + // Read 16 bytes + if (wire_->requestFrom((int)addr_, (int)16) != 16) return IoStatus::IoError; + + uint8_t* out = (uint8_t*)dst16; + for (uint8_t i = 0; i < 16; i++) { + if (!wire_->available()) return IoStatus::IoError; + out[i] = (uint8_t)wire_->read(); + } + + return IoStatus::Ok; + } + + bool supportsWriteBlock16() const override { return true; } + + // Accelerator: 16-byte block write in one I2C transaction + IoStatus writeBlock16(uint16_t blockIdx, const void* src16) override { + if (!src16) return IoStatus::OutOfRange; + const uint16_t addr = (uint16_t)(blockIdx << 4); + if ((uint32_t)addr + 16u > sizeBytes()) return IoStatus::OutOfRange; + if (!isWritable()) return IoStatus::ReadOnly; + + wire_->beginTransmission(addr_); + wire_->write((uint8_t)(addr >> 8)); + wire_->write((uint8_t)(addr & 0xFF)); + + const uint8_t* p = (const uint8_t*)src16; + for (uint8_t i = 0; i < 16; i++) wire_->write(p[i]); + if (wire_->endTransmission() != 0) return IoStatus::IoError; + + return IoStatus::Ok; + } + + // FRAM has no commit barrier. + bool hasCommit() const override { return false; } + IoStatus commit() override { return IoStatus::Ok; } + bool commitDone() const override { return true; } + +private: + + TwoWire* wire_ = nullptr; + uint8_t addr_ = 0; +}; diff --git a/src/lib/nv/device/NvDeviceBase.h b/src/lib/nv/device/NvDeviceBase.h new file mode 100755 index 0000000..a14e4cb --- /dev/null +++ b/src/lib/nv/device/NvDeviceBase.h @@ -0,0 +1,57 @@ +// NvDeviceBase.h +#pragma once +#include +#include +class NvDevice { +public: + enum class IoStatus : uint8_t { Ok, OutOfRange, NotReady, IoError, ReadOnly }; + enum class Endurance : uint8_t { Low, Mid, High }; + + virtual ~NvDevice() = default; + + virtual bool init() { return true; } + + // reports usable aligned size (multiple of 16) + virtual uint32_t sizeBytes() const = 0; + + // Device write cycle endurance + // Low < 100K writes, Mid > ~100K writes, High > ~100M writes (FRAM) + virtual Endurance endurance() const { return Endurance::Low; } + + // Required primitives: flat 16-bit byte addressing, device-relative + virtual IoStatus read(uint16_t addr, void* dst, uint16_t len) = 0; + virtual IoStatus write(uint16_t addr, const void* src, uint16_t len) = 0; + + // Optional service hook + virtual void poll() {} + + // Optional commit barrier (ESP/flash emu) + virtual bool hasCommit() const { return false; } + virtual IoStatus commit() { return IoStatus::Ok; } + virtual bool commitDone() const { return true; } + + // ---- Optional 16-byte block accelerator (NOT a second "public API" conceptually) ---- + // Wrappers may call this for efficiency; higher-level code can ignore it entirely. + + virtual bool supportsWriteBlock16() const { return false; } + + virtual IoStatus writeBlock16(uint16_t blockIdx, const void* src16) { + const uint32_t addr = ((uint32_t)blockIdx) << 4; + if (addr + 16u > sizeBytes()) return IoStatus::OutOfRange; + return write((uint16_t)addr, src16, 16); + } + + virtual bool supportsReadBlock16() const { return false; } + + virtual IoStatus readBlock16(uint16_t blockIdx, void* dst16) { + const uint32_t addr = ((uint32_t)blockIdx) << 4; + if (addr + 16u > sizeBytes()) return IoStatus::OutOfRange; + return read((uint16_t)addr, dst16, 16); + } + + // Optional capability hints + virtual bool isReadable() const { return true; } + virtual bool isWritable() const { return true; } + +protected: +}; diff --git a/src/lib/nv/device/ShimCached.h b/src/lib/nv/device/ShimCached.h new file mode 100755 index 0000000..1d74149 --- /dev/null +++ b/src/lib/nv/device/ShimCached.h @@ -0,0 +1,365 @@ +// ShimCached.h +#pragma once + +#include "NvDeviceBase.h" + +#include +#include +#include + +// NvShimCached +// +// Cache wrapper (old intent + fast): +// +// - Two 1-bit-per-byte bitsets: +// dirtyReadBits[i] == 1 => cache[i] invalid; must read backend before use +// dirtyWriteBits[i] == 1 => cache[i] differs; must write back +// +// - poll() scans a small window (20 bytes) each call +// - On dirty write: +// * if writeback delay elapsed: prefer 16B page-base flush IF page is fully valid in cache +// AND page has any dirty-write bytes; otherwise fall back to 1-byte write at scanIndex. +// - On dirty read: fetch 1 byte into cache +// - "Clean" is determined by a full wrap scan pass (cacheClean/cacheCleanThisPass) +// - Backends may "pretend" they support 16B page writes: we always call writeBlock16() +// for the 16B path; base-class default emulates it with write(...,16). + +#ifndef NVS_ALLOW_CACHED_ON_COMMIT_BACKENDS + // 0 = refuse to wrap flash/EEPROM emulation layers that already cache+commit internally. + #define NVS_ALLOW_CACHED_ON_COMMIT_BACKENDS 0 +#endif + +// 1-bit-per-byte bitset helpers +static inline bool bitGet_(const uint8_t* bits, uint32_t bitIndex) { + return (bits[bitIndex >> 3] >> (bitIndex & 7)) & 1u; +} +static inline void bitSet_(uint8_t* bits, uint32_t bitIndex, bool value) { + const uint8_t mask = (uint8_t)(1u << (bitIndex & 7)); + uint8_t& b = bits[bitIndex >> 3]; + b = value ? (uint8_t)(b | mask) : (uint8_t)(b & (uint8_t)~mask); +} + +class NvShimCached : public NvDevice { +public: + explicit NvShimCached(NvDevice& inner) : backend(inner) {} + ~NvShimCached() override { cleanup_(); } + + bool init() override { + cleanup_(); + + if (!backend.init()) return false; + + #if !NVS_ALLOW_CACHED_ON_COMMIT_BACKENDS + // Avoid wrapping flash/EEPROM emulation layers that already do their own caching/commit. + if (backend.hasCommit()) return false; + #endif + + capacityBytes = backend.sizeBytes(); + if (capacityBytes == 0) return false; + + // We assume upstream respects "aligned usable size (multiple of 16)" contract. + if ((capacityBytes & 0x0Fu) != 0u) return false; + + // NOTE: public read/write use uint16_t address, so > 64K is not representable. + if (capacityBytes > 65536u) return false; + + cache = new (std::nothrow) uint8_t[capacityBytes]; + if (!cache) { cleanup_(); return false; } + + bitsetBytes = (uint16_t)((capacityBytes + 7u) / 8u); + + dirtyReadBits = new (std::nothrow) uint8_t[bitsetBytes]; + dirtyWriteBits = new (std::nothrow) uint8_t[bitsetBytes]; + if (!dirtyReadBits || !dirtyWriteBits) { cleanup_(); return false; } + + // Heuristic: scan ~1 flag-byte per 512B of device, clamped [4..32]. + uint32_t count = capacityBytes >> 9; + if (count < 4) count = 4; + if (count > 32) count = 32; + flagScanCount = (uint8_t)count; + + // Semantics: + // dirtyReadBits[i] == 1 -> cache[i] invalid, must fetch before use + // dirtyWriteBits[i] == 1 -> cache[i] differs, must write back + memset(dirtyReadBits, 0xFF, bitsetBytes); // all bytes invalid initially + memset(dirtyWriteBits, 0x00, bitsetBytes); // nothing dirty initially + + scanIndex = (uint32_t)-1; + pendingWriteCount = 0; + + writebackDelayMs = 0; + writebackReadyMs = 0; + + // cache isn't "clean" because read-cache is invalid everywhere + cacheClean = false; + cacheCleanThisPass = true; + + VLF("MSG: NvDevice, memory cache active"); + return true; + } + + // ---- Capabilities / identity pass-through ---- + + uint32_t sizeBytes() const override { return capacityBytes; } + Endurance endurance() const override { return backend.endurance(); } + bool isReadable() const override { return backend.isReadable(); } + bool isWritable() const override { return backend.isWritable(); } + + // ---- Delay control (old: commitReadyTimeMs = now + waitMs) ---- + + void setWritebackDelayMs(uint32_t ms) { writebackDelayMs = ms; } + + // ---- Required primitives ---- + + IoStatus read(uint16_t addr, void* dst, uint16_t len) override { + if (!dst) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > capacityBytes) return IoStatus::OutOfRange; + + uint8_t* out = (uint8_t*)dst; + for (uint16_t i = 0; i < len; i++) { + uint8_t v = 0; + IoStatus st = readByteCached_((uint32_t)addr + i, v); + if (st != IoStatus::Ok) return st; + out[i] = v; + } + return IoStatus::Ok; + } + + IoStatus write(uint16_t addr, const void* src, uint16_t len) override { + if (!src) return IoStatus::OutOfRange; + if ((uint32_t)addr + (uint32_t)len > capacityBytes) return IoStatus::OutOfRange; + if (!isWritable()) return IoStatus::ReadOnly; + + const uint8_t* in = (const uint8_t*)src; + for (uint16_t i = 0; i < len; i++) { + // Cache staging cannot fail here (bounds already checked). + (void)writeByteCached_((uint32_t)addr + i, in[i]); + } + + // Set delay gate once per call (avoid per-byte millis()). + writebackReadyMs = millis() + writebackDelayMs; + return IoStatus::Ok; + } + + // Commit API is irrelevant when wrapping EEPROM/FRAM-like devices; keep consistent. + bool hasCommit() const override { return false; } + IoStatus commit() override { return IoStatus::Ok; } + + // "Done" for this wrapper: no dirty bytes waiting to be written back. + // (We keep an incremental counter; if you ever need "old exact recount", add a debug validator.) + bool commitDone() const override { return pendingWriteCount == 0; } + + // ---- Background servicing ---- + + void poll() override { + backend.poll(); + if (capacityBytes == 0) return; + + // cacheClean, return. + if (cacheClean) return; + + const bool canWriteback = + (writebackDelayMs == 0) || ((int32_t)(millis() - writebackReadyMs) >= 0); + + bool doWrite = false; + bool doRead = false; + + // rapidly move ahead through clean cache + const uint32_t flagBytes = bitsetBytes; + uint32_t flagIndex = (((scanIndex + 1u) >= capacityBytes) ? 0u : (scanIndex + 1u)) >> 3; + + for (uint8_t i = 0; i < flagScanCount; i++) { + if ((dirtyWriteBits[flagIndex] | dirtyReadBits[flagIndex]) != 0u) break; + + flagIndex++; + if (flagIndex >= flagBytes) { scanIndex = capacityBytes - 1u; break; } + + scanIndex = (flagIndex << 3) - 1u; + } + + // Scan small window each call + for (uint8_t step = 0; step < 16; step++) { + scanIndex++; + if (scanIndex >= capacityBytes) { + if (cacheCleanThisPass) cacheClean = true; + scanIndex = 0; + cacheCleanThisPass = true; + } + + const bool w = bitGet_(dirtyWriteBits, scanIndex); + const bool r = bitGet_(dirtyReadBits, scanIndex); + + if (w) { + // Work exists, so this pass is not clean. + cacheCleanThisPass = false; + + // If writeback delay not elapsed, keep scanning (but never mark clean). + if (!canWriteback) continue; + + doWrite = true; + break; + } + + if (r) { + cacheCleanThisPass = false; + doRead = true; + break; + } + } + + if (doWrite) { + flushOneWriteFast_(scanIndex); // page-base flush preferred + return; + } + + if (doRead) { + uint8_t tmp = 0; + (void)readByteCached_(scanIndex, tmp); + return; + } + } + +private: + void cleanup_() { + delete[] cache; cache = nullptr; + delete[] dirtyReadBits; dirtyReadBits = nullptr; + delete[] dirtyWriteBits; dirtyWriteBits = nullptr; + + capacityBytes = 0; + bitsetBytes = 0; + scanIndex = 0; + + writebackDelayMs = 0; + writebackReadyMs = 0; + + pendingWriteCount = 0; + + cacheClean = true; + cacheCleanThisPass = true; + } + + // ---- Core byte cache ops ---- + + IoStatus readByteCached_(uint32_t address, uint8_t& out) { + if (address >= capacityBytes) { out = 0; return IoStatus::OutOfRange; } + + if (bitGet_(dirtyReadBits, address)) { + uint8_t v = 0; + IoStatus st = backend.read((uint16_t)address, &v, 1); + if (st != IoStatus::Ok) { out = 0; return st; } + + cache[address] = v; + bitSet_(dirtyReadBits, address, false); + } + + out = cache[address]; + return IoStatus::Ok; + } + + // Cache staging write; always succeeds if address is in range. + // If the backend is temporarily NotReady and we can't read the old value, + // we still stage the write (dirty) and rely on poll() to flush later. + IoStatus writeByteCached_(uint32_t address, uint8_t value) { + if (address >= capacityBytes) return IoStatus::OutOfRange; + + // Any write makes cache "not clean". + cacheClean = false; + cacheCleanThisPass = false; + + // Read old value (through cache) to avoid marking dirty if same. + uint8_t oldValue = 0; + IoStatus stOld = readByteCached_(address, oldValue); + if (stOld == IoStatus::Ok && oldValue == value) return IoStatus::Ok; + + // If stOld != Ok, proceed anyway: stage new value and mark dirty. + cache[address] = value; + + // Mark write dirty (only count 0->1 transitions) + if (!bitGet_(dirtyWriteBits, address)) { + bitSet_(dirtyWriteBits, address, true); + pendingWriteCount++; + } + + // Ensure subsequent reads never overwrite our cached value. + bitSet_(dirtyReadBits, address, false); + + return IoStatus::Ok; + } + + // ---- Old intent + fast writeback ---- + // + // When a dirty byte is found at idx, prefer flushing the *page base* (idx&~0x0F) + // via writeBlock16 if: + // - the full page is valid in cache (dirtyRead == 0 for all 16 bytes) + // - and the page contains any dirtyWrite bytes + // Otherwise fall back to a 1-byte write at idx. + + void flushOneWriteFast_(uint32_t idx) { + if (!backend.isWritable()) return; + if (idx >= capacityBytes) return; + + const uint32_t base = idx & ~0x0Fu; + + if (base + 16u <= capacityBytes) { + // base is 16B aligned => also 8-bit aligned in bitset + const uint32_t bi = base >> 3; // base / 8 + + // Page is fully valid if both corresponding bitset bytes are 0. + const bool pageValid = (dirtyReadBits[bi] == 0u) && (dirtyReadBits[bi + 1] == 0u); + + if (pageValid) { + // Only flush page if any byte in it is dirty-write. + const bool anyDirtyW = (dirtyWriteBits[bi] != 0u) || (dirtyWriteBits[bi + 1] != 0u); + + if (anyDirtyW) { + const uint16_t blockIdx = (uint16_t)(base >> 4); + IoStatus st = backend.writeBlock16(blockIdx, &cache[base]); + if (st != IoStatus::Ok) return; // NotReady/IoError => leave bits set, try later + + // Clear dirty-write bits for the page; adjust pending count accurately. + for (uint8_t k = 0; k < 16; k++) { + const uint32_t a = base + k; + if (bitGet_(dirtyWriteBits, a)) { + bitSet_(dirtyWriteBits, a, false); + if (pendingWriteCount) pendingWriteCount--; + } + } + return; + } + } + } + + // Fallback: 1-byte write at idx (old behavior fallback) + if (bitGet_(dirtyReadBits, idx)) return; // cache byte isn't valid; don't write garbage + + IoStatus st = backend.write((uint16_t)idx, &cache[idx], 1); + if (st != IoStatus::Ok) return; + + if (bitGet_(dirtyWriteBits, idx)) { + bitSet_(dirtyWriteBits, idx, false); + if (pendingWriteCount) pendingWriteCount--; + } + } + +private: + // ---- Member state ---- + NvDevice& backend; + + uint32_t capacityBytes = 0; + uint8_t* cache = nullptr; + + uint8_t* dirtyReadBits = nullptr; + uint8_t* dirtyWriteBits = nullptr; + uint16_t bitsetBytes = 0; + + uint8_t flagScanCount = 4; + uint32_t scanIndex = 0; + + uint32_t writebackDelayMs = 0; + uint32_t writebackReadyMs = 0; + + uint32_t pendingWriteCount = 0; + + bool cacheClean = true; + bool cacheCleanThisPass = true; +}; diff --git a/src/lib/nv/device/ShimDelayedCommit.h b/src/lib/nv/device/ShimDelayedCommit.h new file mode 100755 index 0000000..41a57af --- /dev/null +++ b/src/lib/nv/device/ShimDelayedCommit.h @@ -0,0 +1,118 @@ +// ShimDelayedCommit.h +#pragma once + +#include "NvDeviceBase.h" + +#include + +// A tiny wrapper for backends that already buffer writes internally (ESP/STM32 EEPROM emu). +// It batches commit() calls with a quiet-period timer, but does NOT add a second cache. +// +// Behavior: +// - write() passes through to backend.write() and schedules a commit for (now + delayMs). +// - poll() calls backend.poll() then triggers commit when quiet expires or hard deadline expires. +// - commitDone() is unified: "no pending scheduled commit AND backend reports done". +// +class NvShimDelayedCommit : public NvDevice { +public: + explicit NvShimDelayedCommit(NvDevice& backendRef, uint32_t delayMs) : backend(backendRef) { this->delayMs = delayMs; } + + bool init() override { + if (!backend.init()) return false; + + // This wrapper is only meaningful for commit-capable backends. + if (!backend.hasCommit()) return false; + + capacityBytes = backend.sizeBytes(); + if (capacityBytes == 0 || capacityBytes > 65536u) return false; + + VLF("MSG: NvDevice, delayed commit active"); + + return true; + } + + uint32_t sizeBytes() const override { return capacityBytes; } + Endurance endurance() const override { return backend.endurance(); } + bool isReadable() const override { return backend.isReadable(); } + bool isWritable() const override { return backend.isWritable(); } + + // Quiet period (ms) after last write before committing. + // delay=0 means commit on next poll. + void setDelayMs(uint32_t ms) { delayMs = ms; } + + // Hard bound: commit no later than this many ms after the first write in a burst. + // maxLatencyMs=0 disables (pure debounce behavior). + // defaults to 3 hours + void setMaxLatencyMs(uint32_t ms) { maxLatencyMs = ms; } + + IoStatus read(uint16_t addr, void* dst, uint16_t len) override { + return backend.read(addr, dst, len); + } + + IoStatus write(uint16_t addr, const void* src, uint16_t len) override { + if (!isWritable()) return IoStatus::ReadOnly; + + IoStatus st = backend.write(addr, src, len); + if (st != IoStatus::Ok) { DLF("WRN: write failed!"); return st; } + + const uint32_t now = millis(); + + // If this is the first write since we were idle, start the hard deadline window. + if (!commitScheduled && (maxLatencyMs != 0)) { + commitHardDueMs = now + maxLatencyMs; + } + + // Schedule commit after quiet period (debounce). + commitScheduled = true; + commitDueMs = now + delayMs; + return IoStatus::Ok; + } + + bool hasCommit() const override { return backend.hasCommit(); } + + // Explicit commit barrier: commit immediately and clear any pending schedule. + IoStatus commit() override { + commitScheduled = false; + commitDueMs = 0; + commitHardDueMs = 0; + return backend.commit(); + } + + // Unified "done" concept: no scheduled commit pending AND backend reports done. + bool commitDone() const override { + if (commitScheduled) return false; + return backend.commitDone(); + } + + // Optional: expose whether a commit is scheduled (useful for debugging). + bool commitPending() const { return commitScheduled; } + + void poll() override { + backend.poll(); + if (!commitScheduled) { return; } + + const uint32_t now = millis(); + + const bool quietExpired = ((int32_t)(now - commitDueMs) >= 0); + const bool hardExpired = (maxLatencyMs != 0) && ((int32_t)(now - commitHardDueMs) >= 0); + + if (quietExpired || hardExpired) { + (void)backend.commit(); + commitScheduled = false; + commitDueMs = 0; + commitHardDueMs = 0; + } + } + +private: + NvDevice& backend; + uint32_t capacityBytes = 0; + + bool commitScheduled = false; + + uint32_t delayMs = 0; + uint32_t commitDueMs = 0; + + uint32_t maxLatencyMs = 10800000; // 3 hours in ms = 3*60*60*1000 + uint32_t commitHardDueMs = 0; // set on first write of a burst +}; diff --git a/src/lib/pushButton/PushButton.cpp b/src/lib/pushButton/PushButton.cpp new file mode 100755 index 0000000..cfa58b9 --- /dev/null +++ b/src/lib/pushButton/PushButton.cpp @@ -0,0 +1,131 @@ +// ----------------------------------------------------------------------------------------------------------------------------- +// Handle push buttons + +#include "PushButton.h" + +#include "../gpioEx/GpioEx.h" + +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif + +Button::Button(int pin, int initState, int32_t trigger) { + this->pin = pin; + + long activeState = (trigger & 0b00000000000000000000000000000001); + int16_t analogThresholdValue = (trigger & 0b00000000000000000000011111111110) >> 1; + int16_t analogDownValue = (trigger & 0b01111111111000000000000000000000) >> 21; + hysteresis = (trigger & 0b00000000000111111111100000000000) >> 11; + + isAnalogThreshold = analogThresholdValue != 0; + isAnalogValue = analogDownValue != 0; + + if (isAnalogThreshold) { analogCompareValue = analogThresholdValue; debounceMs = 30; } else + if (isAnalogValue) { analogCompareValue = analogDownValue; debounceMs = 30; } else debounceMs = hysteresis; + + if (activeState == LOW) { UP = HIGH; DOWN = LOW; } else + if (activeState == HIGH) { UP = LOW; DOWN = HIGH; } + + if (isAnalogThreshold || isAnalogValue) { + if (analogCompareValue > ANALOG_READ_RANGE) { + analogCompareValue = ANALOG_READ_RANGE; + DF("WRN: Button::Button(), AnalogCompareValue for pin "); D(pin); DF(" is above analog range setting to "); DL(analogCompareValue); + } + if (analogCompareValue - hysteresis < 0) { + hysteresis = analogCompareValue; + DF("WRN: Button::Button(), AnalogCompareValue - hysteresis for pin "); D(pin); DF(" is below analog range setting Hysteresis to "); DL(hysteresis); + } else + if (analogCompareValue + hysteresis > ANALOG_READ_RANGE) { + hysteresis = ANALOG_READ_RANGE - analogCompareValue; + DF("WRN: Button::Button(), AnalogCompareValue + Hysteresis for pin "); D(pin); DF(" is above analog range setting Hysteresis to "); DL(hysteresis); + } + } + + pinModeEx(pin, initState); +} + +void Button::poll() { + int lastState = state; + if (isAnalogThreshold || isAnalogValue) { + #ifdef ESP32 + int analogValue = round((analogReadMilliVolts(pin)/3300.0F)*(float)ANALOG_READ_RANGE); + #else + int analogValue = analogRead(pin); + #endif + + if (isAnalogThreshold) { + if (DOWN == HIGH) { if (analogValue >= analogCompareValue + hysteresis) state = HIGH; else state = LOW; } + if (DOWN == LOW) { if (analogValue <= analogCompareValue - hysteresis) state = LOW; else state = HIGH; } + } else + + if (isAnalogValue) { + if (analogValue >= analogCompareValue - hysteresis && analogValue <= analogCompareValue + hysteresis) state = DOWN; else state = UP; + } + + } else state = digitalReadEx(pin); + if (lastState != state) { + avgPulseDuration = ((avgPulseDuration*49.0) + (double)(millis() - stableStartMs))/50.0; + stableStartMs = millis(); + } + stableMs = (long)(millis() - stableStartMs); + if (stableMs > 3000UL) { + avgPulseDuration = ((avgPulseDuration*4.0) + 2000.0)/5.0; + } + if (stableMs > debounceMs) { + if (lastStableState == UP && state == DOWN) { + static unsigned long lastPressTime = 0; + if (pressed && millis() - lastPressTime < 500) doublePressed = true; + pressed = true; + lastPressTime = millis(); + } + lastStableState = state; + } +} + +bool Button::isDown() { + if (stableMs > debounceMs && state == DOWN) return true; else return false; +} + +bool Button::wasPressed(bool peek) { + if (pressed) { + if (!peek) pressed = false; + return true; + } else return false; +} + +bool Button::wasDoublePressed(bool peek) { + if (doublePressed) { + if (!peek) { + doublePressed = false; + pressed = false; + } return true; + } else return false; +} + +bool Button::wasClicked(bool peek) { + if (isUp()) return wasPressed(peek); else return false; +} + +void Button::clearPress() { + pressed = false; +} + +bool Button::isUp() { + if (stableMs > debounceMs && state == UP) return true; else return false; +} + +long Button::timeDown() { + if (stableMs > debounceMs && state == DOWN) return stableMs; else return 0; +} + +long Button::timeUp() { + if (stableMs > debounceMs && state == UP) return stableMs; else return 0; +} + +bool Button::hasTone() { + if (fabs(avgPulseDuration - 40.0) < TONE_FREQ_THRESHOLD) return true; else return false; +} + +double Button::toneFreq() { + if (avgPulseDuration >= 0.1 && avgPulseDuration <= 10000.0) return 0.5/(avgPulseDuration/1000.0); else return NAN; +} diff --git a/src/lib/pushButton/PushButton.h b/src/lib/pushButton/PushButton.h new file mode 100755 index 0000000..74845cf --- /dev/null +++ b/src/lib/pushButton/PushButton.h @@ -0,0 +1,68 @@ +// ----------------------------------------------------------------------------------------------------------------------------- +// Handle push buttons +#pragma once + +#include "../../Common.h" + +// threshold in milliseconds (for tone detection, 40ms/7 = +/-17.5%) +#define TONE_FREQ_THRESHOLD 7.0 + +class Button { + public: + // create object + // \param pin MCU pin + // \param initState initialization state: INPUT, INPUT_PULLUP, or INPUT_PULLDOWN + // \param trigger triggered state: HIGH or LOW, optional + // analog threshold/hysteresis |THLD(t) |HIST(h) are 10 bit values + Button(int pin, int initState, int32_t trigger); + + // must be repeatedly called to check status of button + void poll(); + + // is the button down + bool isDown(); + + // was the button down since last checked + bool wasPressed(bool peek = false); + + // was the button down since last checked + bool wasDoublePressed(bool peek = false); + + // was the button down since last checked + bool wasClicked(bool peek = false); + + // clear pressed state + void clearPress(); + + // is the button up + bool isUp(); + + // number of ms down + long timeDown(); + + // number of ms up + long timeUp(); + + // check to see if this button has the SHC tone (12.5 Hz nominal) + bool hasTone(); + + // in Hz (0.05 to 5000Hz range) returns NAN otherwise + double toneFreq(); + + private: + int pin; + int state = HIGH; + int lastStableState = HIGH; + int analogCompareValue; + int hysteresis; + unsigned long debounceMs = 0; + unsigned long stableStartMs = 0; + unsigned long stableMs = 0; + bool isAnalogThreshold = false; + bool isAnalogValue = false; + bool pressed = false; + bool doublePressed = false; + double avgPulseDuration = 2000.0; + int UP = HIGH; + int DOWN = LOW; +}; diff --git a/src/lib/sense/Sense.cpp b/src/lib/sense/Sense.cpp new file mode 100755 index 0000000..586672f --- /dev/null +++ b/src/lib/sense/Sense.cpp @@ -0,0 +1,170 @@ +// ----------------------------------------------------------------------------------- +// combined digital and analog threshold read, 10 bit analog read resolution only +// analog mode reads uses software schmitt trigger with threshold/hysteresis-band +// digital mode reads have basic hf EMI/RFI noise filtering + +#include "Sense.h" + +#include "../tasks/OnTask.h" +#include "../gpioEx/GpioEx.h" + +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif + +SenseInput::SenseInput(int pin, int initState, int32_t trigger) { + this->pin = pin; + + activeState = (trigger & 0b0000000000000000000001); + threshold = (trigger & 0b0000000000011111111110) >> 1; + hysteresis = (trigger & 0b0111111111100000000000) >> 11; + isAnalog = threshold != 0; + + VF("pin="); V(pin); V(", "); + VF("active="); V(activeState ? "HIGH" : "LOW"); V(", "); + VF("ths="); V(threshold); V(", "); + VF("hys="); VL(hysteresis); + + if (isAnalog) { + if (threshold < 0) { + threshold = 0; + DF("WRN: SenseInput::SenseInput(), Threshold for pin "); D(pin); DLF(" is below Analog range setting to "); DL(threshold); + } else + if (threshold > ANALOG_READ_RANGE) { + threshold = ANALOG_READ_RANGE; + DF("WRN: SenseInput::SenseInput(), Threshold for pin "); D(pin); DF(" is above Analog range setting to "); DL(threshold); + } + if (threshold - hysteresis < 0) { + hysteresis = threshold; + DF("WRN: SenseInput::SenseInput(), Threshold - Hysteresis for pin "); D(pin); DF(" is below Analog range setting Hysteresis to "); DL(hysteresis); + } else + if (threshold + hysteresis > ANALOG_READ_RANGE) { + hysteresis = ANALOG_READ_RANGE - threshold; + DF("WRN: SenseInput::SenseInput(), Threshold + Hysteresis for pin "); D(pin); DF(" is above Analog range setting Hysteresis to "); DL(hysteresis); + } + } + + pinModeEx(pin, initState); + + reset(); +} + +int SenseInput::isOn() { + int value = lastValue; + if (isAnalog) { + #ifdef ESP32 + int sample = round((analogReadMilliVolts(pin)/3300.0F)*(float)ANALOG_READ_RANGE); + #else + int sample = analogRead(pin); + #endif + + if (sample >= threshold + hysteresis) value = HIGH; + if (sample <= threshold - hysteresis) value = LOW; + } else { + int sample = digitalReadEx(pin); + if (stableSample != sample) { stableStartMs = millis(); stableSample = sample; } + long stableMs = (long)(millis() - stableStartMs); + if (stableMs >= hysteresis) value = stableSample; + } + if (reverseState) { if (value == LOW) value = HIGH; else value = LOW; } + lastValue = value; + return value == activeState; +} + +int SenseInput::changed() { + int value = lastChangedValue; + if (isAnalog) { + #ifdef ESP32 + int sample = round((analogReadMilliVolts(pin)/3300.0F)*(float)ANALOG_READ_RANGE); + #else + int sample = analogRead(pin); + #endif + + if (sample >= threshold + hysteresis) value = HIGH; + if (sample < threshold - hysteresis) value = LOW; + } else { + int sample = digitalReadEx(pin); + if (stableSample != sample) { stableStartMs = millis(); stableSample = sample; } + long stableMs = (long)(millis() - stableStartMs); + if (stableMs >= hysteresis) value = stableSample; + } + if (reverseState) { if (value == LOW) value = HIGH; else value = LOW; } + bool result = lastChangedValue != value; + lastChangedValue = value; + return result; +} + +void SenseInput::poll() { + int value = lastValue; + if (!isAnalog) { + int sample = digitalReadEx(pin); + if (stableSample != sample) { stableStartMs = millis(); stableSample = sample; } + long stableMs = (long)(millis() - stableStartMs); + if (stableMs > hysteresis) value = stableSample; + if (reverseState) { if (value == LOW) value = HIGH; else value = LOW; } + } + lastValue = value; +} + +void SenseInput::reset() { + if (isAnalog) { + #ifdef ESP32 + int sample = round((analogReadMilliVolts(pin)/3300.0F)*(float)ANALOG_READ_RANGE); + #else + int sample = analogRead(pin); + #endif + if (sample > threshold) lastValue = HIGH; else lastValue = LOW; + } else { + lastValue = digitalReadEx(pin); + } + + stableSample = lastValue; +} + +// Manage sense pins + +uint8_t Sense::add(int pin, int initState, int32_t trigger, bool force) { + if ((pin == OFF || trigger == OFF) && !force) return 0; + if (senseCount >= SENSE_MAX) { + DF("WRN: Sense::add(), senseCount exceeded ignoring pin "); DL(pin); + return 0; + } + if (trigger < 0 || trigger >= SENSE_MAX_TRIGGER) { + DF("WRN: Sense::add(), trigger value invalid ignoring pin "); DL(pin); + return 0; + } + if (initState != INPUT && initState != INPUT_PULLUP && initState != INPUT_PULLDOWN) { + DF("WRN: Sense::add(), initState value invalid ignoring pin "); DL(pin); + return 0; + } + VF("MSG: Sense"); V(senseCount); V(", init "); + senseInput[senseCount] = new SenseInput(pin, initState, trigger); + senseCount++; + return senseCount; +} + +int Sense::isOn(uint8_t handle) { + if (handle == 0) return false; + return senseInput[handle - 1]->isOn(); +} + +long Sense::stableMillis(uint8_t handle) { + if (handle == 0) return false; + return senseInput[handle - 1]->stableMillis(); +} + +int Sense::changed(uint8_t handle) { + if (handle == 0) return false; + return senseInput[handle - 1]->changed(); +} + +void Sense::reverse(uint8_t handle, bool state) { + if (handle == 0) return; + senseInput[handle - 1]->reverse(state); +} + +void Sense::poll() { + for (int i = 0; i < senseCount; i++) { senseInput[i]->poll(); Y; } +} + +Sense sense; diff --git a/src/lib/sense/Sense.h b/src/lib/sense/Sense.h new file mode 100755 index 0000000..7cbc63e --- /dev/null +++ b/src/lib/sense/Sense.h @@ -0,0 +1,92 @@ +// ----------------------------------------------------------------------------------- +// combined digital and analog threshold read, 10 bit analog read resolution only +// analog mode reads uses software schmitt trigger with threshold/hysteresis-band +// digital mode reads have basic hf EMI/RFI noise filtering +#pragma once + +#include "../../Common.h" + +#ifndef THLD + #define THLD(v) ((v)<<1) // 10 bit analog threshold, bits 1 through 10 +#endif +#ifndef HYST + #define HYST(v) ((v)<<11) // 10 bit hysteresis, bits 11 through 20 +#endif +#ifndef INPUT_PULLDOWN + #define INPUT_PULLDOWN INPUT +#endif + +// default provision for up to 16 sense inputs is allowed, to change use: +// #define SENSE_MAX 30 (for example) +#ifndef SENSE_MAX + #define SENSE_MAX 8 +#endif + +// largest possible trigger value == 2^21 +#define SENSE_MAX_TRIGGER 2097152 + +class SenseInput { + public: + SenseInput(int pin, int initState, int32_t trigger); + + int isOn(); + inline long stableMillis() { return isAnalog ? 0 : (long)(millis() - stableStartMs); } + + int changed(); + inline void reverse(bool state) { reverseState = state; } + + void poll(); + + private: + void reset(); + + int pin; + int activeState = OFF; + bool reverseState = false; + bool isAnalog; + int threshold; + int hysteresis; + int triggerMode; + int lastValue = LOW; + int lastChangedValue = LOW; + int lastResult = LOW; + int stableSample = 0; + unsigned long stableStartMs = 0; +}; + +class Sense { + public: + // add sense input + // \param pin MCU pin to watch + // \param initState initialization state: INPUT, INPUT_PULLUP, or INPUT_PULLDOWN + // \param trigger triggered state: HIGH or LOW, optional + // analog threshold/hysteresis |THLD(t) |HIST(h) are 10 bit values + // \param force allocates even if pin is OFF + // \returns handle to this sense if successful, 0 otherwise + uint8_t add(int pin, int initState, int32_t trigger, bool force = false); + + // read the sense associated input pin and return state as configured + // \param handle sense handle + int isOn(uint8_t handle); + + // time in milliseconds since the input last changed state + // \param handle sense handle + long stableMillis(uint8_t handle); + + // check the sense associated input pin and return true if it has changed since last read + // \param handle sense handle + int changed(uint8_t handle); + + // reverse the on state for this pin + // \param handle sense handle + void reverse(uint8_t handle, bool state); + + // call repeatedly to check inputs for changes + void poll(); + + private: + uint8_t senseCount = 0; + SenseInput *senseInput[SENSE_MAX]; +}; + +extern Sense sense; diff --git a/src/lib/serial/Serial_IP_Ethernet.cpp b/src/lib/serial/Serial_IP_Ethernet.cpp new file mode 100755 index 0000000..d5ff482 --- /dev/null +++ b/src/lib/serial/Serial_IP_Ethernet.cpp @@ -0,0 +1,123 @@ +// ----------------------------------------------------------------------------------- +// IP communication routines + +#include "Serial_IP_Ethernet.h" + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST && SERIAL_SERVER != OFF + + void IPSerial::begin(long port, unsigned long clientTimeoutMs, bool persist) { + if (active) return; + + // special case where the port is the most common baud rate + // so a standard call to begin(baud_rate) can still work + if ((port < 9000 || port >= 10000 || port == 9600) && clientTimeoutMs == 2000 && persist == false) port = 9999; + + this->port = port; + this->clientTimeoutMs = clientTimeoutMs; + this->persist = persist; + + if (!ethernetManager.init()) { + DLF("WRN: IPSerial, failed to start Ethernet"); + return; + } + + cmdSvr = new EthernetServer(port); + cmdSvr->begin(); + VF("MSG: IPSerial, started EthernetServer on port "); VL(port); + + active = true; + + delay(1000); + } + + void IPSerial::restart() { + VLF("IPSerial, restarted EthernetServer"); + cmdSvr->begin(); + } + + void IPSerial::end() { + if (cmdSvrClient.connected()) { + #if DEBUG_CMDSERVER == ON + VLF("MSG: end(), STOP cmdSvrClient"); + #endif + cmdSvrClient.stop(); + } + } + + void IPSerial::flush(void) { + if (!ethernetManager.active || !cmdSvrClient) return; + cmdSvrClient.flush(); + } + + int IPSerial::available(void) { + if (!ethernetManager.active) return 0; + + if (!cmdSvrClient) { + cmdSvrClient = cmdSvr->available(); + if (cmdSvrClient) { + #if DEBUG_CMDSERVER == ON + VLF("MSG: available(), NEW cmdSvrClient"); + #endif + clientEndTimeMs = millis() + clientTimeoutMs; + cmdSvrClient.setTimeout(1000); + } + } else { + if (!cmdSvrClient.connected()) { + #if DEBUG_CMDSERVER == ON + VLF("MSG: available(), not connected STOP cmdSvrClient"); + #endif + cmdSvrClient.stop(); + return 0; + } + if ((long)(clientEndTimeMs - millis()) < 0) { + #if DEBUG_CMDSERVER == ON + VLF("MSG: available(), timed out STOP cmdSvrClient"); + #endif + cmdSvrClient.stop(); + return 0; + } + } + + int i = cmdSvrClient.available(); + + #if DEBUG_CMDSERVER == ON + if (i > 0) { VF("MSG: available(), recv. buffer has "); V(i); VLF(" chars"); } + #endif + + return i; + } + + int IPSerial::peek(void) { + if (!ethernetManager.active || !cmdSvrClient) return -1; + return cmdSvrClient.peek(); + } + + int IPSerial::read(void) { + if (!ethernetManager.active || !cmdSvrClient) return -1; + if (persist) clientEndTimeMs = millis() + clientTimeoutMs; + int c = cmdSvrClient.read(); + #if DEBUG_CMDSERVER == ON + VF("MSG: read(), found: "); VL((char)c); + #endif + return c; + } + + size_t IPSerial::write(uint8_t data) { + if (!ethernetManager.active || !cmdSvrClient) return 0; + return cmdSvrClient.write(data); + } + + size_t IPSerial::write(const uint8_t *data, size_t count) { + if (!ethernetManager.active || !cmdSvrClient) return 0; + return cmdSvrClient.write(data, count); + } + + #if SERIAL_SERVER == STANDARD || SERIAL_SERVER == BOTH + IPSerial SerialIP; + #endif + + #if SERIAL_SERVER == PERSISTENT || SERIAL_SERVER == BOTH + IPSerial SerialPIP1; + #endif + +#endif diff --git a/src/lib/serial/Serial_IP_Ethernet.h b/src/lib/serial/Serial_IP_Ethernet.h new file mode 100755 index 0000000..5385317 --- /dev/null +++ b/src/lib/serial/Serial_IP_Ethernet.h @@ -0,0 +1,63 @@ +// ----------------------------------------------------------------------------------- +// Polling serial IP for Ethernet +#pragma once + +#include "../../Common.h" +#include "../ethernet/EthernetManager.h" + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST && SERIAL_SERVER != OFF + + #ifdef ESP8266 + #ifndef ETHERNET_W5500 + #error "The ESP8266 Ethernet option supports the W5500 only" + #endif + #include // https://github.com/adafruit/Ethernet2 + #else + #if OPERATIONAL_MODE == ETHERNET_TEENSY41 + #include + #else + #include // built-in library or my https://github.com/hjd1964/Ethernet for ESP32 and ASCOM Alpaca support + #endif + #endif + + class IPSerial : public Stream { + public: + void begin(long port, unsigned long clientTimeoutMs = 2000, bool persist = false); + void restart(); + void end(); + + void flush(void); + int available(void); + int peek(void); + int read(void); + size_t write(uint8_t data); + size_t write(const uint8_t* data, size_t count); + inline size_t write(unsigned long n) { return write((uint8_t)n); } + inline size_t write(long n) { return write((uint8_t)n); } + inline size_t write(unsigned int n) { return write((uint8_t)n); } + inline size_t write(int n) { return write((uint8_t)n); } + + using Print::write; + + private: + EthernetServer *cmdSvr; + EthernetClient cmdSvrClient; + + int port = -1; + unsigned long clientTimeoutMs; + unsigned long clientEndTimeMs = 0; + bool active = false; + bool persist = false; + }; + + #if SERIAL_SERVER == STANDARD || SERIAL_SERVER == BOTH + extern IPSerial SerialIP; + #define SERIAL_SIP SerialIP + #endif + + #if SERIAL_SERVER == PERSISTENT || SERIAL_SERVER == BOTH + extern IPSerial SerialPIP1; + #define SERIAL_PIP1 SerialPIP1 + #endif + +#endif diff --git a/src/lib/serial/Serial_IP_Ethernet_Client.cpp b/src/lib/serial/Serial_IP_Ethernet_Client.cpp new file mode 100755 index 0000000..09061e8 --- /dev/null +++ b/src/lib/serial/Serial_IP_Ethernet_Client.cpp @@ -0,0 +1,113 @@ +// ----------------------------------------------------------------------------------- +// IP communication routines + +#include "Serial_IP_Ethernet_Client.h" + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST && SERIAL_CLIENT != OFF + + #include "../tasks/OnTask.h" + + void pollIPClient() { SerialIPClient.poll(); } + + bool IPSerialClient::begin(long port, unsigned long clientTimeoutMs, bool persist) { + if (active) return true; + + // special case where the port is the most common baud rate + // so a standard call to begin(baud_rate) can still work + if ((port < 9000 || port >= 10000 || port == 9600) && clientTimeoutMs == 2000 && persist == false) port = 9999; + + this->port = port; + this->clientTimeoutMs = clientTimeoutMs; + this->persist = persist; + + if (!ethernetManager.init()) { + DLF("WRN: IPSerialClient, failed to start Ethernet"); + return false; + } + + delay(1000); + + onStep = IPAddress(ethernetManager.sta->target); + VF("MSG: IPSerialClient, target "); V(onStep[0]); V("."); V(onStep[1]); V("."); V(onStep[2]); V("."); V(onStep[3]); V(":"); VL(port); + + if (!persist) { + lastActivityTimeMs = millis(); + VF("MSG: Setup, start IPSerialClient monitor task (rate 1s priority 7)... "); + if (tasks.add(1000, 0, true, 7, pollIPClient, "PollIP")) { VLF("success"); } else { VLF("FAILED!"); } + } + + active = true; + return true; + } + + void IPSerialClient::end() { + if (!active) return; + + cmdSvrClient.stop(); + VLF("MSG: IPSerialClient, connection to target closed"); + + tasks.remove(tasks.getHandleByName("PollIP")); + + active = false; + } + + bool IPSerialClient::isConnected() { + lastActivityTimeMs = millis(); + if (Ethernet.linkStatus() != LinkOFF) { + if (!cmdSvrClient.connected()) { + cmdSvrClient.stop(); + if (cmdSvrClient.connect(onStep, port)) { + VLF("MSG: IPSerialClient, connection to target restarted"); + return true; + } else { + DLF("WRN: IPSerialClient, connection to target failed"); + return false; + } + } else return true; + } else { + DLF("WRN: IPSerialClient, connection to target failed no cable"); + return false; + } + } + + void IPSerialClient::flush(void) { + if (!active || !isConnected()) return; + + return cmdSvrClient.flush(); + } + + int IPSerialClient::available(void) { + if (!active || !isConnected()) return 0; + + return cmdSvrClient.available(); + } + + int IPSerialClient::peek(void) { + if (!active || !isConnected()) return -1; + + return cmdSvrClient.peek(); + } + + int IPSerialClient::read(void) { + if (!active || !isConnected()) return -1; + char c = cmdSvrClient.read(); + return c; + } + + size_t IPSerialClient::write(uint8_t data) { + if (!active || !isConnected()) return 0; + return cmdSvrClient.write(data); + } + + size_t IPSerialClient::write(const uint8_t *data, size_t quantity) { + if (!active || !isConnected()) return 0; + return cmdSvrClient.write(data, quantity); + } + + void IPSerialClient::poll() { + if (millis() - lastActivityTimeMs > clientTimeoutMs && cmdSvrClient.connected()) cmdSvrClient.stop(); + } + + IPSerialClient SerialIPClient; + +#endif diff --git a/src/lib/serial/Serial_IP_Ethernet_Client.h b/src/lib/serial/Serial_IP_Ethernet_Client.h new file mode 100755 index 0000000..398e8e6 --- /dev/null +++ b/src/lib/serial/Serial_IP_Ethernet_Client.h @@ -0,0 +1,60 @@ +// ----------------------------------------------------------------------------------- +// Polling serial IP for Ethernet +#pragma once + +#include "../../Common.h" +#include "../ethernet/EthernetManager.h" + +#if OPERATIONAL_MODE >= ETHERNET_FIRST && OPERATIONAL_MODE <= ETHERNET_LAST && SERIAL_CLIENT != OFF + + #ifdef ESP8266 + #ifndef ETHERNET_W5500 + #error "The ESP8266 Ethernet option supports the W5500 only" + #endif + #include // https://github.com/adafruit/Ethernet2 + #else + #if OPERATIONAL_MODE == ETHERNET_TEENSY41 + #include + #else + #include // built-in library or my https://github.com/hjd1964/Ethernet for ESP32 and ASCOM Alpaca support + #endif + #endif + + class IPSerialClient : public Stream { + public: + bool begin(long port, unsigned long clientTimeoutMs = 2000, bool persist = false); + void end(); + bool isConnected(); + + void flush(void); + int available(void); + int peek(void); + int read(void); + int availableForWrite() { return 1; } + size_t write(uint8_t data); + size_t write(const uint8_t* data, size_t count); + inline size_t write(unsigned long n) { return write((uint8_t)n); } + inline size_t write(long n) { return write((uint8_t)n); } + inline size_t write(unsigned int n) { return write((uint8_t)n); } + inline size_t write(int n) { return write((uint8_t)n); } + + using Print::write; + + void poll(); + + private: + EthernetClient cmdSvrClient; + IPAddress onStep; + + int port = -1; + unsigned long lastActivityTimeMs = 0; + unsigned long clientTimeoutMs; + unsigned long clientEndTimeMs = 0; + bool active = false; + bool persist = false; + }; + + extern IPSerialClient SerialIPClient; + #define SERIAL_IP SerialIPClient + +#endif diff --git a/src/lib/serial/Serial_IP_Wifi.cpp b/src/lib/serial/Serial_IP_Wifi.cpp new file mode 100755 index 0000000..b368d4b --- /dev/null +++ b/src/lib/serial/Serial_IP_Wifi.cpp @@ -0,0 +1,125 @@ +// ----------------------------------------------------------------------------------- +// IP communication routines + +#include "Serial_IP_Wifi.h" + +#if OPERATIONAL_MODE == WIFI && SERIAL_SERVER != OFF + + void IPSerial::begin(long port, unsigned long clientTimeoutMs, bool persist) { + if (active) return; + + // special case where the port is the most common baud rate + // so a standard call to begin(baud_rate) can still work + if ((port < 9000 || port >= 10000 || port == 9600) && clientTimeoutMs == 2000 && persist == false) port = 9999; + + this->port = port; + this->clientTimeoutMs = clientTimeoutMs; + this->persist = persist; + + if (!wifiManager.init()) { + DLF("WRN: IPSerial, failed to start WiFi"); + return; + } + + cmdSvr = new WiFiServer(port); + delay(1000); + + cmdSvr->begin(); + cmdSvr->setNoDelay(true); + VF("MSG: IPSerial, started WiFiServer on port "); VL(port); + + active = true; + + delay(1000); + } + + void IPSerial::end() { + if (cmdSvrClient.connected()) { + #if DEBUG_CMDSERVER == ON + VLF("MSG: end(), STOP cmdSvrClient"); + #endif + cmdSvrClient.stop(); + } + } + + void IPSerial::flush(void) { + if (!active || !cmdSvrClient) return; + cmdSvrClient.flush(); + } + + int IPSerial::available(void) { + if (!active) return 0; + + if (!cmdSvrClient) { + if (cmdSvr->hasClient()) { + cmdSvrClient = cmdSvr->available(); + clientEndTimeMs = millis() + clientTimeoutMs; + } + if (cmdSvrClient) { + #if DEBUG_CMDSERVER == ON + VLF("MSG: available(), NEW cmdSvrClient"); + #endif + } else return 0; + } else { + if (!cmdSvrClient.connected()) { + #if DEBUG_CMDSERVER == ON + VLF("MSG: available(), not connected STOP cmdSvrClient"); + #endif + cmdSvrClient.stop(); + return 0; + } + if ((long)(clientEndTimeMs - millis()) < 0) { + #if DEBUG_CMDSERVER == ON + VLF("MSG: available(), timed out STOP cmdSvrClient"); + #endif + cmdSvrClient.stop(); + return 0; + } + } + + int i = cmdSvrClient.available(); + + #if DEBUG_CMDSERVER == ON + if (i > 0) { VF("MSG: available(), recv. buffer has "); V(i); VLF(" chars"); } + #endif + + return i; + } + + int IPSerial::peek(void) { + if (!active || !cmdSvrClient) return -1; + return cmdSvrClient.peek(); + } + + int IPSerial::read(void) { + if (!active || !cmdSvrClient) return -1; + if (persist) clientEndTimeMs = millis() + clientTimeoutMs; + int c = cmdSvrClient.read(); + #if DEBUG_CMDSERVER == ON + VF("MSG: read(), found: "); VL((char)c); + #endif + return c; + } + + size_t IPSerial::write(uint8_t data) { + if (!active || !cmdSvrClient) return 0; + return cmdSvrClient.write(data); + } + + size_t IPSerial::write(const uint8_t *data, size_t count) { + if (!active || !cmdSvrClient) return 0; + return cmdSvrClient.write(data, count); + } + + #if SERIAL_SERVER == STANDARD || SERIAL_SERVER == BOTH + IPSerial SerialIP; + #define SERIAL_SIP SerialIP + #endif + + #if SERIAL_SERVER == PERSISTENT || SERIAL_SERVER == BOTH + IPSerial SerialPIP1; + IPSerial SerialPIP2; + IPSerial SerialPIP3; + #endif + +#endif diff --git a/src/lib/serial/Serial_IP_Wifi.h b/src/lib/serial/Serial_IP_Wifi.h new file mode 100755 index 0000000..7b6703d --- /dev/null +++ b/src/lib/serial/Serial_IP_Wifi.h @@ -0,0 +1,65 @@ +// ----------------------------------------------------------------------------------- +// Polling serial IP for ESP32 +#pragma once + +#include "../../Common.h" +#include "../wifi/WifiManager.h" + +#if OPERATIONAL_MODE == WIFI && SERIAL_SERVER != OFF + + #if defined(ESP32) + #include + #include + #include + #elif defined(ESP8266) + #include + #include + #include + #else + #error "Configuration (Config.h): No Wifi support is present for this device" + #endif + + class IPSerial : public Stream { + public: + void begin(long port, unsigned long clientTimeoutMs = 2000, bool persist = false); + void end(); + + void flush(void); + int available(void); + int peek(void); + int read(void); + size_t write(uint8_t data); + size_t write(const uint8_t* data, size_t count); + inline size_t write(unsigned long n) { return write((uint8_t)n); } + inline size_t write(long n) { return write((uint8_t)n); } + inline size_t write(unsigned int n) { return write((uint8_t)n); } + inline size_t write(int n) { return write((uint8_t)n); } + + using Print::write; + + private: + WiFiServer *cmdSvr; + WiFiClient cmdSvrClient; + + int port = -1; + unsigned long clientTimeoutMs; + unsigned long clientEndTimeMs = 0; + bool active = false; + bool persist = false; + }; + + #if SERIAL_SERVER == STANDARD || SERIAL_SERVER == BOTH + extern IPSerial SerialIP; + #define SERIAL_SIP SerialIP + #endif + + #if SERIAL_SERVER == PERSISTENT || SERIAL_SERVER == BOTH + extern IPSerial SerialPIP1; + extern IPSerial SerialPIP2; + extern IPSerial SerialPIP3; + #define SERIAL_PIP1 SerialPIP1 + #define SERIAL_PIP2 SerialPIP2 + #define SERIAL_PIP3 SerialPIP3 + #endif + +#endif diff --git a/src/lib/serial/Serial_IP_Wifi_Client.cpp b/src/lib/serial/Serial_IP_Wifi_Client.cpp new file mode 100755 index 0000000..b36679f --- /dev/null +++ b/src/lib/serial/Serial_IP_Wifi_Client.cpp @@ -0,0 +1,117 @@ +// ----------------------------------------------------------------------------------- +// IP communication routines + +// original work by jesco-t + +#include "Serial_IP_Wifi_Client.h" + +#if OPERATIONAL_MODE == WIFI && SERIAL_CLIENT == ON + + #include "../tasks/OnTask.h" + + void pollIPClient() { SerialIPClient.poll(); } + + bool IPSerialClient::begin(long port, unsigned long clientTimeoutMs, bool persist) { + if (active) return true; + + // special case where the port is the most common baud rate + // so a standard call to begin(baud_rate) can still work + if ((port < 9000 || port >= 10000 || port == 9600) && clientTimeoutMs == 2000 && persist == false) port = 9996; + + this->port = port; + this->clientTimeoutMs = clientTimeoutMs; + this->persist = persist; + + if (!wifiManager.init()) { + DLF("WRN: IPSerialClient, failed to start WiFi"); + return false; + } + + delay(1000); + + onStep = IPAddress(wifiManager.sta->target); + VF("MSG: IPSerialClient, target "); V(onStep[0]); V("."); V(onStep[1]); V("."); V(onStep[2]); V("."); V(onStep[3]); V(":"); VL(port); + + if (!persist) { + lastActivityTimeMs = millis(); + VF("MSG: Setup, start IPSerialClient monitor task (rate 1s priority 7)... "); + if (tasks.add(1000, 0, true, 7, pollIPClient, "PollIP")) { VLF("success"); } else { VLF("FAILED!"); } + } + + active = true; + return true; + } + + void IPSerialClient::end() { + if (!active) return; + + cmdSvrClient.stop(); + VLF("MSG: IPSerialClient, connection to target closed"); + + tasks.remove(tasks.getHandleByName("PollIP")); + + WiFi.disconnect(); + VLF("MSG: IPSerialClient, WiFi disconnected"); + + active = false; + } + + bool IPSerialClient::isConnected() { + lastActivityTimeMs = millis(); + if (WiFi.status() == WL_CONNECTED) { + if (!cmdSvrClient.connected()) { + cmdSvrClient.stop(); + if (cmdSvrClient.connect(onStep, port)) { + VLF("MSG: IPSerialClient, connection to target restarted"); + return true; + } else { + DLF("WRN: IPSerialClient, connection to target failed"); + return false; + } + } else return true; + } else { active = false; return false; } + } + + void IPSerialClient::flush(void) { + if (!active || !isConnected()) return; + + return cmdSvrClient.flush(); + } + + int IPSerialClient::available(void) { + if (!active || !isConnected()) return 0; + + return cmdSvrClient.available(); + } + + int IPSerialClient::peek(void) { + if (!active || !isConnected()) return -1; + + return cmdSvrClient.peek(); + } + + int IPSerialClient::read(void) { + if (!active || !isConnected()) return -1; + + return cmdSvrClient.read(); + } + + size_t IPSerialClient::write(uint8_t data) { + if (!active || !isConnected()) return 0; + + return cmdSvrClient.write(data); + } + + size_t IPSerialClient::write(const uint8_t *data, size_t quantity) { + if (!active || !isConnected()) return 0; + + return cmdSvrClient.write(data, quantity); + } + + void IPSerialClient::poll() { + if (millis() - lastActivityTimeMs > clientTimeoutMs && cmdSvrClient.connected()) cmdSvrClient.stop(); + } + + IPSerialClient SerialIPClient; + +#endif diff --git a/src/lib/serial/Serial_IP_Wifi_Client.h b/src/lib/serial/Serial_IP_Wifi_Client.h new file mode 100755 index 0000000..554e073 --- /dev/null +++ b/src/lib/serial/Serial_IP_Wifi_Client.h @@ -0,0 +1,60 @@ +// ----------------------------------------------------------------------------------- +// IP communication routines + +// original work by jesco-t + +#pragma once + +#include "../../Common.h" +#include "../wifi/WifiManager.h" + +#if OPERATIONAL_MODE == WIFI && SERIAL_CLIENT == ON + + #if defined(ESP32) + #include + #include + #include + #elif defined(ESP8266) + #include + #include + #include + #else + #error "Configuration (Config.h): No Wifi support is present for this device" + #endif + + class IPSerialClient : public Stream { + public: + bool begin(long port, unsigned long clientTimeoutMs = 2000, bool persist = false); + void end(); + bool isConnected(); + + void flush(void); + int available(void); + int peek(void); + int read(void); + int availableForWrite() { return 1; } + size_t write(uint8_t data); + size_t write(const uint8_t* data, size_t count); + inline size_t write(unsigned long n) { return write((uint8_t)n); } + inline size_t write(long n) { return write((uint8_t)n); } + inline size_t write(unsigned int n) { return write((uint8_t)n); } + inline size_t write(int n) { return write((uint8_t)n); } + + using Print::write; + + void poll(); + + private: + WiFiClient cmdSvrClient; + IPAddress onStep; + + int port = -1; + unsigned long lastActivityTimeMs = 0; + unsigned long clientTimeoutMs; + bool active = false; + bool persist = false; + }; + + extern IPSerialClient SerialIPClient; + #define SERIAL_IP SerialIPClient +#endif \ No newline at end of file diff --git a/src/lib/serial/Serial_Local.cpp b/src/lib/serial/Serial_Local.cpp new file mode 100755 index 0000000..119270b --- /dev/null +++ b/src/lib/serial/Serial_Local.cpp @@ -0,0 +1,78 @@ +// ----------------------------------------------------------------------------------- +// Local Serial for sending internal commands + +#include "Serial_Local.h" + +#if defined(SERIAL_LOCAL_MODE) && SERIAL_LOCAL_MODE == ON + +void SerialLocal::begin(long baud) { + // init the buffers + xmit_index = 0; + xmit_buffer[0] = 0; + recv_head = 0; + recv_tail = 0; + recv_buffer[0] = 0; + (void)(baud); + + #ifdef ESP32 + mutex = xSemaphoreCreateMutex(); + #endif +} + +void SerialLocal::end() { } + +void SerialLocal::transmit(const char *data) { + #ifdef ESP32 + xSemaphoreTake(mutex, portMAX_DELAY); + #endif + + int data_len = strlen(data); + for (int i = 0; i < data_len; i++) { + recv_buffer[recv_tail] = data[i]; + recv_tail++; + } + + #ifdef ESP32 + xSemaphoreGive(mutex); + #endif +} + +char *SerialLocal::receive() { + #ifdef ESP32 + xSemaphoreTake(mutex, portMAX_DELAY); + #endif + + int i = 0; + xmit_result[i] = 0; + while (xmit_buffer[xmit_index] != 0) { + xmit_result[i++] = xmit_buffer[xmit_index++]; + xmit_index &= 0b1111111; + } + xmit_result[i] = 0; + + #ifdef ESP32 + xSemaphoreGive(mutex); + #endif + return xmit_result; +} + +int SerialLocal::read(void) { + if (!available()) return -1; + + #ifdef ESP32 + xSemaphoreTake(mutex, portMAX_DELAY); + #endif + + recv_buffer[recv_tail] = 0; + char c = recv_buffer[recv_head]; + if (c) recv_head++; + + #ifdef ESP32 + xSemaphoreGive(mutex); + #endif + return c; +} + +SerialLocal serialLocal; + +#endif diff --git a/src/lib/serial/Serial_Local.h b/src/lib/serial/Serial_Local.h new file mode 100755 index 0000000..3acb1a8 --- /dev/null +++ b/src/lib/serial/Serial_Local.h @@ -0,0 +1,128 @@ +// ----------------------------------------------------------------------------------- +// Local Serial for sending internal commands +#pragma once + +#include "../../Common.h" + +#if defined(SERIAL_LOCAL_MODE) && SERIAL_LOCAL_MODE == ON + +class SerialLocal : public Stream { + public: + inline void begin() { begin(9600); } + void begin(long baud); + void end(); + + void setTimeout(long timeMs) { UNUSED(timeMs); } + + // sends a command for processing + void transmit(const char *data); + + // receive has the last commands response, if one exists + char *receive(); + + int read(void); + + inline int receiveAvailable() { + #ifdef ESP32 + xSemaphoreTake(mutex, portMAX_DELAY); + #endif + + int i = 0; + int x = xmit_index; + while (xmit_buffer[xmit_index] != 0) { + i++; + xmit_index++; + xmit_index &= 0b1111111; + } + xmit_index = x; + + #ifdef ESP32 + xSemaphoreGive(mutex); + #endif + return i; + } + + inline int available(void) { + #ifdef ESP32 + xSemaphoreTake(mutex, portMAX_DELAY); + #endif + + uint8_t p = recv_head; + uint8_t c = 0; + while (recv_buffer[p] && p != recv_tail && c < 255) { c++; p++; } + + #ifdef ESP32 + xSemaphoreGive(mutex); + #endif + return c; + } + + inline int peek(void) { + if (!available()) return -1; + + #ifdef ESP32 + xSemaphoreTake(mutex, portMAX_DELAY); + #endif + + char c = recv_buffer[recv_head]; + + #ifdef ESP32 + xSemaphoreGive(mutex); + #endif + return c; + } + + inline void flush(void) { + #ifdef ESP32 + while (receiveAvailable()) { yield(); } + #endif + } + + inline size_t write(uint8_t data) { + #ifdef ESP32 + xSemaphoreTake(mutex, portMAX_DELAY); + #endif + + xmit_buffer[xmit_tail] = data; + xmit_tail++; + xmit_tail &= 0b1111111; + xmit_buffer[xmit_tail] = 0; + + #ifdef ESP32 + xSemaphoreGive(mutex); + #endif + return 1; + } + + size_t write(const uint8_t* data, size_t count) { + for (int i = 0; i < (int)count; i++) { if (!write(data[i])) return i; } + return count; + } + + inline size_t write(unsigned long n) { return write((uint8_t)n); } + inline size_t write(long n) { return write((uint8_t)n); } + inline size_t write(unsigned int n) { return write((uint8_t)n); } + inline size_t write(int n) { return write((uint8_t)n); } + + using Print::write; + + private: + char recv_buffer[256] = ""; + uint8_t recv_head = 0; + uint8_t recv_tail = 0; + + char xmit_buffer[128] = ""; + char xmit_result[128] = ""; + uint8_t xmit_index = 0; + uint8_t xmit_tail = 0; + + #ifdef ESP32 + SemaphoreHandle_t mutex; + #endif +}; + +extern SerialLocal serialLocal; + +#define SERIAL_LOCAL serialLocal + +#endif diff --git a/src/lib/serial/Serial_MEGA2560.cpp b/src/lib/serial/Serial_MEGA2560.cpp new file mode 100755 index 0000000..3b6ebba --- /dev/null +++ b/src/lib/serial/Serial_MEGA2560.cpp @@ -0,0 +1,219 @@ +// ----------------------------------------------------------------------------------- +// Low overhead communication routines for Serial0, Serial1 + +#include "Serial_MEGA2560.h" + +#if defined(SERIAL_MEGA2560) && SERIAL_MEGA2560 == ON + +#if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__) + +#define MSB(i) (i >> 8) +#define LSB(i) (i & 0xFF) + +#ifdef HAL_POLLING_MEGA2560_SERIAL_A + +void PollingSerialA::begin(long baud) { + // init the buffers + xmit_index = 0; xmit_buffer[0] = 0; recv_head = 0; recv_tail = 0; recv_buffer[0] = 0; + + // Set baud rate + uint16_t ubrr = F_CPU/16/baud - 1; + UBRR0H = MSB(ubrr); + UBRR0L = LSB(ubrr); + + // Disable U2X mode + UCSR0A = 0; + + // Enable receiver and transmitter + UCSR0B = (1<= (char)32) { + recv_buffer[recv_tail] = c; + recv_buffer[++recv_tail] = (char)0; + return (char)0; + } else return c; + } else return (char)0; + } else return (char)0; +} + +bool SerialST4Master::trans(char *data_in) { + static bool reset = false; + static unsigned long resetFinishTime = 0; + + static int index = 18; + + uint8_t this_bit; + + static uint8_t this_data_in; + static uint8_t r_parity; + static uint8_t this_data_out; + static uint8_t s_parity; + + // force a reset of ST4 comms + if (reset) { + if ((long)(millis() - resetFinishTime) > 0) reset = false; else return false; + index = 18; + } + + switch (--index) { + case 17: // send start bit + + if (!send_error) { + if (xmit_buffer[xmit_head] != (char)0) { + this_data_out = xmit_buffer[xmit_head++]; + } else this_data_out = (char)0; + } + + s_parity = 0; + r_parity = 0; + frame_error = false; + send_error = false; + recv_error = false; + digitalWriteF(ST4_CLOCK_OUT_PIN, LOW); + digitalWriteF(ST4_DATA_OUT_PIN, LOW); + break; + case 16: // recv start bit + digitalWriteF(ST4_CLOCK_OUT_PIN, HIGH); + if (digitalReadF(ST4_DATA_IN_PIN) != LOW) { + DLF("WRN: SerialST4.poll(), frame/start error"); + frame_error = true; + resetFinishTime = millis() + 1000; + reset = true; + return false; + } + break; + case 15: case 13: case 11: case 9: case 7: case 5: case 3: case 1: // send data bits + this_bit = bitRead(this_data_out, index>>1); + s_parity += this_bit; + digitalWriteF(ST4_CLOCK_OUT_PIN, LOW); + digitalWriteF(ST4_DATA_OUT_PIN, this_bit); + break; + case 14: case 12: case 10: case 8: case 6: case 4: case 2: case 0: // recv data bits + digitalWriteF(ST4_CLOCK_OUT_PIN, HIGH); + this_bit = digitalReadF(ST4_DATA_IN_PIN); + r_parity += this_bit; + bitWrite(this_data_in, index>>1, this_bit); + break; + case -1: // send parity bit + digitalWriteF(ST4_CLOCK_OUT_PIN, LOW); + digitalWriteF(ST4_DATA_OUT_PIN, s_parity&1); + break; + case -2: // recv parity bit + digitalWriteF(ST4_CLOCK_OUT_PIN, HIGH); + if ((r_parity&1) != digitalReadF(ST4_DATA_IN_PIN)) recv_error = true; + break; + case -3: // send local parity ck bit + digitalWriteF(ST4_CLOCK_OUT_PIN, LOW); + digitalWriteF(ST4_DATA_OUT_PIN, recv_error); + break; + case -4: // recv remote parity ck bit + digitalWriteF(ST4_CLOCK_OUT_PIN, HIGH); + if (digitalReadF(ST4_DATA_IN_PIN) == HIGH) send_error = true; + break; + case -5: // send stop bit + digitalWriteF(ST4_CLOCK_OUT_PIN, LOW); + digitalWriteF(ST4_DATA_OUT_PIN, LOW); + break; + case -6: // recv stop bit + digitalWriteF(ST4_CLOCK_OUT_PIN, HIGH); + if (digitalReadF(ST4_DATA_IN_PIN) != LOW) frame_error = true; + + if (frame_error) { + DLF("WRN: SerialST4.poll(), frame/stop error"); + resetFinishTime = millis() + ST4_MAX_BIT_TIME/1000 + 1; + reset = true; + return false; + } + +// if (this_data_in >= 32 || this_data_out >= 32) { +// D("Got "); if (this_data_in >= 32) { D((char)this_data_in); } else D(" "); +// D(" Sent "); if (this_data_out >= 32) { DL((char)this_data_out); } else DL(" "); +// } + + *data_in = this_data_in; + + if (send_error) { DLF("WRN: SerialST4.poll(), send parity error"); } + if (recv_error) { DLF("WRN: SerialST4.poll(), recv parity error"); } + + index = 18; + return true; + break; + } + + return false; +} + +void SerialST4Master::begin() { + xmit_head = 0; + xmit_tail = 0; + xmit_buffer[0] = 0; + recv_head = 0; + recv_tail = 0; + recv_buffer[0] = 0; +} + +void SerialST4Master::begin(long baud) { + begin(); + (void)(baud); +} + +void SerialST4Master::end() { + xmit_head = 0; + xmit_tail = 0; + xmit_buffer[0] = 0; + recv_head = 0; + recv_tail = 0; + recv_buffer[0] = 0; +} + +size_t SerialST4Master::write(uint8_t data) { + unsigned long t_start = millis(); + uint8_t xh = xmit_head; + xh--; + while (xmit_tail == xh) { + Y; // yield from the command channel at priority level 5 (lets poll() run) + if ((millis() - t_start) > timeout) return 0; + } + xmit_buffer[xmit_tail] = data; xmit_tail++; + xmit_buffer[xmit_tail] = 0; + return 1; +} + +size_t SerialST4Master::write(const uint8_t *data, size_t quantity) { + // fail if trying to write more than the buffer can hold + if ((int)quantity > 254) return 0; + + for (int i = 0; i < (int)quantity; i++) { if (!write(data[i])) return 0; } + return 1; +} + +int SerialST4Master::available(void) { + int a=0; + for (uint8_t b = recv_head; recv_buffer[b] != (char)0; b++) a++; + return a; +} + +int SerialST4Master::read(void) { + char c = recv_buffer[recv_head]; if (c != 0) recv_head++; + if (c == 0) c = -1; + return c; +} + +int SerialST4Master::peek(void) { + int c = recv_buffer[recv_head]; + if (c == 0) c= -1; + + return c; +} + +void SerialST4Master::flush(void) { + unsigned long startMs = millis(); + int c; + do { + Y; // yield from the command channel at priority level 5 (lets poll() run) + c = xmit_buffer[xmit_head]; + } while (c != 0 || (millis() - startMs < timeout)); +} + +SerialST4Master serialST4; + +#endif diff --git a/src/lib/serial/Serial_ST4_Master.h b/src/lib/serial/Serial_ST4_Master.h new file mode 100755 index 0000000..1f5d374 --- /dev/null +++ b/src/lib/serial/Serial_ST4_Master.h @@ -0,0 +1,72 @@ +// ------------------------------------------------------------------------------------ +// Serial ST4 master +#pragma once + +/* +ST4 port data communication scheme: + +5V power ---- ESP32-S, Teensy4.0, Teensy3.2, etc. +Gnd --------- + +HC Signal OnStep +RAw ---- Data ---> Recv. data +DEs <--- Clock ---- Clock +DEn <--- Data ---- Send data +RAe ---- 12.5Hz Square wave ---> 100% sure SHC is present, switches DEs & DEn to OUTPUT + +Data is exchanged on clock edges similar to SPI so is timing insensitive (runs with interrupts enabled.) + +One data byte is exchanged (in both directions w/basic error detection and recovery.) A value 0x00 byte +means "no data" and is ignored on both sides. +*/ + +#include "../../Common.h" + +#if defined(SERIAL_ST4_MASTER) && SERIAL_ST4_MASTER == ON + +#include "Stream.h" + +class SerialST4Master : public Stream { + public: + void begin(); + void begin(long baud); + + void end(); + + // call periodically to move data to/from buffers across the SerialST4 interface + // recvd chars between 0 and 32 are returned directly and bypass the buffer + // 24 calls moves one byte of data in both directions so 100us/call results in a data rate of about 4200 bps (350 cps) + char poll(); + + virtual size_t write(uint8_t); + virtual size_t write(const uint8_t *, size_t); + virtual int available(void); + virtual int read(void); + virtual int peek(void); + virtual void flush(void); + + inline size_t write(unsigned long n) { return write((uint8_t)n); } + inline size_t write(long n) { return write((uint8_t)n); } + inline size_t write(unsigned int n) { return write((uint8_t)n); } + inline size_t write(int n) { return write((uint8_t)n); } + using Print::write; + + private: + bool trans(char *data_in); + + char xmit_buffer[256] = ""; + uint8_t xmit_head = 0; + uint8_t xmit_tail = 0; + char recv_buffer[256] = ""; + uint8_t recv_tail = 0; + bool frame_error = false; + bool send_error = false; + bool recv_error = false; + uint8_t recv_head = 0; + uint32_t timeout = 80; +}; + +extern SerialST4Master serialST4; +#define SERIAL_ST4 serialST4 + +#endif diff --git a/src/lib/serial/Serial_ST4_Slave.cpp b/src/lib/serial/Serial_ST4_Slave.cpp new file mode 100755 index 0000000..ed806bd --- /dev/null +++ b/src/lib/serial/Serial_ST4_Slave.cpp @@ -0,0 +1,298 @@ +// ----------------------------------------------------------------------------------- +// Serial ST4 slave + +#include "Serial_ST4_Slave.h" + +#if defined(SERIAL_ST4_SLAVE) && SERIAL_ST4_SLAVE == ON + +#include "../tasks/OnTask.h" + +// interval in milliseconds for generating the tone signal +#define ST4_TONE_INTERVAL 40 + +// interval in milliseconds for a clock timeout +#define ST4_MAX_BIT_TIME 100 + +#define ST4_CLOCK_PIN ST4_S_PIN +#define ST4_DATA_IN_PIN ST4_N_PIN +#define ST4_DATA_OUT_PIN ST4_W_PIN +#define ST4_TONE_PIN ST4_E_PIN + +IRAM_ATTR void dataClock() { SerialST4.poll(); } + +void SerialST4Slave::begin(long baudRate = 9600) { + if (isActive) return; + + xmit_head = 0; + xmit_tail = 0; + xmit_buffer[0] = 0; + recv_head = 0; + recv_tail = 0; + recv_buffer[0] = 0; + + VF("MSG: SerialST4Slave, start shcTone task (rate 40ms priority 0)... "); + handle = tasks.add(0, 0, true, 0, shcTone, "tone"); + if (handle) { + pinMode(ST4_CLOCK_PIN, INPUT_PULLUP); + pinMode(ST4_DATA_IN_PIN, INPUT_PULLUP); + pinMode(ST4_TONE_PIN, OUTPUT); + pinMode(ST4_DATA_OUT_PIN, OUTPUT); + + if (!tasks.requestHardwareTimer(handle, 0)) { VLF("(no hardware timer!)"); } else { VLF("success"); } + tasks.setPeriod(handle, ST4_TONE_INTERVAL); + + attachInterrupt(digitalPinToInterrupt(ST4_CLOCK_PIN), dataClock, CHANGE); + + isActive = true; + } else { + VLF("FAILED!"); + } +} + +void SerialST4Slave::end() { + if (!isActive) return; + + pinMode(ST4_TONE_PIN, INPUT_PULLUP); + pinMode(ST4_DATA_OUT_PIN, INPUT_PULLUP); + + detachInterrupt(digitalPinToInterrupt(ST4_CLOCK_PIN)); + + tasks.remove(handle); + VLF("MSG: SerialST4Slave, stopped shcTone task"); + + xmit_head = 0; + xmit_tail = 0; + xmit_buffer[0] = 0; + recv_head = 0; + recv_tail = 0; + recv_buffer[0] = 0; + + isActive = false; +} + +void SerialST4Slave::paused(bool state) { + if (!isActive) return; + + if (state) tasks.setPeriod(handle, ST4_TONE_INTERVAL); else tasks.setPeriod(handle, 0); +} + +bool SerialST4Slave::active() { + if (!isActive) return false; + + static unsigned long comp = 0; + bool result = false; + noInterrupts(); + if (comp != lastTimeInMilliseconds) { + result = true; + comp = lastTimeInMilliseconds; + } + interrupts(); + return result; +} + +size_t SerialST4Slave::write(uint8_t data) { + if (!isActive) return 0; + + // wait for room in buffer to become available or give up + unsigned long t_start = millis(); + + uint8_t xh = xmit_head; + xh--; + while (xmit_tail == xh) { + if ((millis() - t_start) > _timeout) return 0; + } + + // is this a control code command? is the buffer not empty? + if (data > 0 && data < 32 && xmit_buffer[xmit_head] != 0) { + noInterrupts(); + // insert the command into the buffer + uint8_t hd = xmit_head; + uint8_t hs = xmit_head; + hs--; + for (int i = 0; i < 254; i++) { + xmit_buffer[--hd] = xmit_buffer[--hs]; + if (xmit_buffer[hs] == 0) break; + } + xmit_head++; + xmit_buffer[xmit_head] = data; + xmit_head--; + xmit_buffer[++xmit_tail] = 0; + interrupts(); + } else { + noInterrupts(); + xmit_buffer[xmit_tail] = data; + xmit_buffer[++xmit_tail] = 0; + interrupts(); + } + return 1; +} + +size_t SerialST4Slave::write(const uint8_t *data, size_t quantity) { + if (!isActive) return 0; + + // fail if trying to write more than the buffer can hold + if ((int)quantity > 254) return 0; + + for (int i = 0; i < (int)quantity; i++) { if (!write(data[i])) return 0; } + return 1; +} + +int SerialST4Slave::available(void) { + if (!isActive) return 0; + + int a = 0; + noInterrupts(); + for (uint8_t b = recv_head; recv_buffer[b] != (char)0; b++) a++; + interrupts(); + + return a; +} + +int SerialST4Slave::read(void) { + if (!isActive) return -1; + + noInterrupts(); + int c = recv_buffer[recv_head]; if (c != 0) recv_head++; + interrupts(); + if (c == 0) c = -1; + + return c; +} + +int SerialST4Slave::peek(void) { + if (!isActive) return -1; + + noInterrupts(); + int c = recv_buffer[recv_head]; + interrupts(); + if (c == 0) c = -1; + + return c; +} + +void SerialST4Slave::flush(void) { + if (!isActive) return; + + unsigned long startMs = millis(); + int c; + do { + noInterrupts(); + c = xmit_buffer[xmit_head]; + interrupts(); + } while (c != 0 && (millis()-startMs) < _timeout); +} + +IRAM_ATTR void SerialST4Slave::poll() { + uint8_t clockState = digitalRead(ST4_CLOCK_PIN); + + static int index = 9; + + static bool frame_error = false; + static bool send_error = false; + static bool recv_error = false; + static uint8_t s_parity = 0; + static uint8_t r_parity = 0; + uint8_t this_bit; + + unsigned long timeInMilliseconds = millis(); + if ((long)((timeInMilliseconds - lastTimeInMilliseconds) - (unsigned long)ST4_MAX_BIT_TIME) > 0) { + DLF("WRN: SerialST4.poll(), timeout error"); + index = 9; + } + lastTimeInMilliseconds = timeInMilliseconds; + + if (clockState == LOW) { if (--index == -4) index = 8; } + + switch(index*2 + (int)(clockState == LOW)) { + case 17: // setup for another frame and send start bit (clock LOW) + + if (!send_error) { + data_out = SerialST4.xmit_buffer[SerialST4.xmit_head]; + if (data_out != 0) SerialST4.xmit_head++; + } else { DLF("WRN: SerialST4.poll(), send parity error"); } + + r_parity = 0; + s_parity = 0; + recv_error = false; + send_error = false; + frame_error = false; + digitalWrite(ST4_DATA_OUT_PIN, LOW); + break; + case 16: // recv start bit (clock HIGH) + if (digitalRead(ST4_DATA_IN_PIN) != LOW) { + frame_error = true; + index = 9; + DLF("WRN: SerialST4.poll(), frame/start error"); + } + break; + case 15: case 13: case 11: case 9: case 7: case 5: case 3: case 1: // send data bit (clock LOW) + this_bit = bitRead(data_out, index); + s_parity += this_bit; + digitalWrite(ST4_DATA_OUT_PIN, this_bit); + break; + case 14: case 12: case 10: case 8: case 6: case 4: case 2: case 0: // recv data bit (clock HIGH) + this_bit = digitalRead(ST4_DATA_IN_PIN); + r_parity += this_bit; + bitWrite(data_in, index, this_bit); + break; + case -1: // send parity bit (clock LOW) + digitalWrite(ST4_DATA_OUT_PIN, s_parity&1); + break; + case -2: // recv parity bit (clock HIGH) + if ((r_parity&1) != digitalRead(ST4_DATA_IN_PIN)) recv_error = true; + break; + case -3: // send local parity check (clock LOW) + digitalWrite(ST4_DATA_OUT_PIN, recv_error); + break; + case -4: // recv remote parity (clock HIGH) + if (digitalRead(ST4_DATA_IN_PIN) == HIGH) send_error = true; + break; + case -5: // send stop bit (clock LOW) + digitalWrite(ST4_DATA_OUT_PIN, LOW); + break; + case -6: // recv stop bit (clock HIGH) + if (digitalRead(ST4_DATA_IN_PIN) != LOW) frame_error = true; + + if (!frame_error) { + +// if (data_in >= 32 || data_out >= 32) { +// D("Got "); if (data_in >= 32) { D((char)data_in); } else D(" "); +// D(" Sent "); if (data_out >= 32) { DL((char)data_out); } else DL(" "); +// } + + if (!recv_error) { + if (data_in != 0) { + SerialST4.recv_buffer[SerialST4.recv_tail] = (char)data_in; + SerialST4.recv_buffer[++SerialST4.recv_tail] = (char)0; + } + } else { DLF("WRN: SerialST4.poll(), recv parity error"); } + + } else { DLF("WRN: SerialST4.poll(), frame/stop error"); } + + break; + } +} + +// this routine keeps a 12.5Hz "tone" on the RAe pin (always) but also on the +// RAw pin when the data comms clock from OnStep isn't running +IRAM_ATTR void shcTone() { + static volatile bool tone_state = false; + + if (tone_state) { + tone_state = false; + digitalWrite(ST4_TONE_PIN, HIGH); + if (millis() - SerialST4.lastTimeInMilliseconds > 2000U) { + digitalWrite(ST4_DATA_OUT_PIN, HIGH); + } + } else { + tone_state = true; + digitalWrite(ST4_TONE_PIN, LOW); + if (millis() - SerialST4.lastTimeInMilliseconds > 2000U) { + digitalWrite(ST4_DATA_OUT_PIN, LOW); + } + } +} + +SerialST4Slave SerialST4; + +#endif diff --git a/src/lib/serial/Serial_ST4_Slave.h b/src/lib/serial/Serial_ST4_Slave.h new file mode 100755 index 0000000..bfeeb93 --- /dev/null +++ b/src/lib/serial/Serial_ST4_Slave.h @@ -0,0 +1,84 @@ +// ----------------------------------------------------------------------------------- +// Serial ST4 slave +#pragma once + +/* +ST4 port data communication scheme: + +5V power ---- ESP32-S, Teensy4.0, Teensy3.2, etc. +Gnd --------- + +HC Signal OnStep +RAw ---- Data ---> Recv. data +DEs <--- Clock ---- Clock +DEn <--- Data ---- Send data +RAe ---- 12.5Hz Square wave ---> 100% sure SHC is present, switches DEs & DEn to OUTPUT + +Data is exchanged on clock edges similar to SPI so is timing insensitive (runs with interrupts enabled.) + +One data byte is exchanged (in both directions w/basic error detection and recovery.) A value 0x00 byte +means "no data" and is ignored on both sides. +*/ + +#include "../../Common.h" + +#if defined(SERIAL_ST4_SLAVE) && SERIAL_ST4_SLAVE == ON + +#include + +#if !defined(ST4_W_PIN) && !defined(ST4_S_PIN) && !defined(ST4_N_PIN) && !defined(ST4_E_PIN) + #warning "ST4 interface pins aren't defined, using defaults." + #define ST4_W_PIN 2 + #define ST4_S_PIN 3 + #define ST4_N_PIN 4 + #define ST4_E_PIN 5 +#endif + +void dataClock(); +void shcTone(); + +class SerialST4Slave : public Stream { + public: + void begin(long baudRate); + void end(); + void paused(bool state); + bool active(); + virtual size_t write(uint8_t); + virtual size_t write(const uint8_t *, size_t); + virtual int available(void); + virtual int read(void); + virtual int peek(void); + virtual void flush(void); + + inline int availableForWrite(void) { return 0; } + inline size_t write(unsigned long n) { return write((uint8_t)n); } + inline size_t write(long n) { return write((uint8_t)n); } + inline size_t write(unsigned int n) { return write((uint8_t)n); } + inline size_t write(int n) { return write((uint8_t)n); } + using Print::write; + + void poll(); + + volatile char xmit_buffer[256] = ""; + volatile uint8_t xmit_head = 0; + volatile uint8_t xmit_tail = 0; + volatile char recv_buffer[256] = ""; + volatile uint8_t recv_tail = 0; + volatile unsigned long lastTimeInMilliseconds = 0; + + private: + uint8_t recv_head = 0; + volatile uint8_t data_in = 0; + volatile uint8_t data_out = 0; + long time_out = 500; + bool isActive = false; + uint8_t handle = 0; +}; + +extern SerialST4Slave SerialST4; +#ifdef SERIAL_ST4 + #undef SERIAL_ST4 +#endif +#define SERIAL_ST4 SerialST4 + +#endif diff --git a/src/lib/softSpi/Pins.h b/src/lib/softSpi/Pins.h new file mode 100755 index 0000000..400eb1b --- /dev/null +++ b/src/lib/softSpi/Pins.h @@ -0,0 +1,5 @@ +// ----------------------------------------------------------------------------------- +// Step driver mode control pins +#pragma once + +#include diff --git a/src/lib/softSpi/SoftSpi.cpp b/src/lib/softSpi/SoftSpi.cpp new file mode 100755 index 0000000..7cf9841 --- /dev/null +++ b/src/lib/softSpi/SoftSpi.cpp @@ -0,0 +1,73 @@ +// ----------------------------------------------------------------------------------- +// Simple software SPI routines (CPOL=1, CPHA=1) just for TMC stepper drivers + +#include "SoftSpi.h" + +#include "../gpioEx/GpioEx.h" + +bool SoftSpi::init(int16_t mosi, int16_t sck, int16_t cs, int16_t miso) { + this->miso = miso; + this->mosi = mosi; + this->sck = sck; + this->cs = cs; + + #if DEBUG == VERBOSE + VF("MSG: SoftSpi, init MOSI="); if (mosi == OFF) { V("OFF"); } else { V(mosi); } + VF(", SCK="); if (sck == OFF) { V("OFF"); } else { V(sck); } + VF(", CS="); if (cs == OFF) { V("OFF"); } else { V(cs); } + VF(", MISO="); if (miso == OFF) { VL("OFF"); } else { VL(miso); } + #endif + + if (mosi == OFF || sck == OFF || cs == OFF) return false; else return true; +} + +void SoftSpi::begin() { + pinModeEx(cs, OUTPUT); + digitalWriteEx(cs, HIGH); + delayMicroseconds(1); + pinMode(sck, OUTPUT); + digitalWriteF(sck, HIGH); + pinModeEx(miso, INPUT_PULLUP); + pinMode(mosi, OUTPUT); + delayMicroseconds(1); + digitalWriteEx(cs, LOW); + delayMicroseconds(1); +} + +void SoftSpi::pause() { + digitalWriteEx(cs, HIGH); + delayMicroseconds(1); + digitalWriteEx(cs, LOW); + delayMicroseconds(1); +} + +void SoftSpi::end() { + digitalWriteEx(cs, HIGH); + delayMicroseconds(1); +} + +uint8_t SoftSpi::transfer(uint8_t data_out) { + uint8_t data_in = 0; + for(int i = 7; i >= 0; i--) { + digitalWriteF(sck, LOW); + digitalWriteF(mosi, bitRead(data_out, i)); + delayMicroseconds(1); + digitalWriteF(sck, HIGH); + if (miso != OFF) bitWrite(data_in, i, digitalReadF(miso)); else bitWrite(data_in, i, 0); + delayMicroseconds(1); + } + return data_in; +} + +uint32_t SoftSpi::transfer32(uint32_t data_out) { + uint32_t data_in = 0; + for(int i = 31; i >= 0; i--) { + digitalWriteF(sck, LOW); + digitalWriteF(mosi, bitRead(data_out, i)); + delayMicroseconds(1); + digitalWriteF(sck, HIGH); + if (miso != OFF) bitWrite(data_in, i, digitalReadF(miso)); else bitWrite(data_in, i, 0); + delayMicroseconds(1); + } + return data_in; +} diff --git a/src/lib/softSpi/SoftSpi.h b/src/lib/softSpi/SoftSpi.h new file mode 100755 index 0000000..93a8093 --- /dev/null +++ b/src/lib/softSpi/SoftSpi.h @@ -0,0 +1,26 @@ +// ----------------------------------------------------------------------------------- +// Simple software SPI routines (CPOL=1, CPHA=1) just for TMC stepper drivers +#pragma once + +#include "../../Common.h" + +class SoftSpi { + public: + // check pins and report status + bool init(int16_t mosi, int16_t sck, int16_t cs, int16_t miso); + // setup pins and activate CS + void begin(); + // cycle CS to reset conversation + void pause(); + // set CS high to disable conversation + void end(); + // send/receive an 8 bit value + uint8_t transfer(uint8_t data_out); + // send/receive an 32 bit value + uint32_t transfer32(uint32_t data_out); + // returns true if this interface only supports sending data + bool outOnly() { return miso == OFF; } + + private: + int16_t miso, mosi, sck, cs; +}; diff --git a/src/lib/sound/Sound.cpp b/src/lib/sound/Sound.cpp new file mode 100755 index 0000000..135be8c --- /dev/null +++ b/src/lib/sound/Sound.cpp @@ -0,0 +1,67 @@ +// ----------------------------------------------------------------------------------------------------------------------------- +// Sound + +#include "Sound.h" + +#ifdef STATUS_BUZZER + +#include "../tasks/OnTask.h" +#include "../gpioEx/GpioEx.h" + +void Sound::init() { + #if STATUS_BUZZER == ON + pinModeEx(STATUS_BUZZER_PIN, OUTPUT); + digitalWriteEx(STATUS_BUZZER_PIN, !STATUS_BUZZER_ON_STATE); + #endif + ready = true; +} + +#if STATUS_BUZZER == ON + uint8_t _buzzerHandle = 0; + void buzzerOff() { + digitalWriteEx(STATUS_BUZZER_PIN, !STATUS_BUZZER_ON_STATE); + tasks.setDurationComplete(_buzzerHandle); + _buzzerHandle = 0; + } +#endif + +void Sound::alert() { + if (ready && enabled) { + #if STATUS_BUZZER == ON + digitalWriteEx(STATUS_BUZZER_PIN, STATUS_BUZZER_ON_STATE); + if (_buzzerHandle) tasks.remove(_buzzerHandle); + _buzzerHandle = tasks.add(1000, 0, false, 6, buzzerOff); + #endif + #if STATUS_BUZZER >= 0 + tone(STATUS_BUZZER_PIN, STATUS_BUZZER, 1000); + #endif + } +} + +void Sound::beep() { + if (ready && enabled) { + #if STATUS_BUZZER == ON + digitalWriteEx(STATUS_BUZZER_PIN, STATUS_BUZZER_ON_STATE); + if (_buzzerHandle) tasks.remove(_buzzerHandle); + _buzzerHandle = tasks.add(250, 0, false, 6, buzzerOff); + #endif + #if STATUS_BUZZER >= 0 + tone(STATUS_BUZZER_PIN, STATUS_BUZZER, 250); + #endif + } +} + +void Sound::click() { + if (ready && enabled) { + #if STATUS_BUZZER == ON + digitalWriteEx(STATUS_BUZZER_PIN, STATUS_BUZZER_ON_STATE); + if (_buzzerHandle) tasks.remove(_buzzerHandle); + _buzzerHandle = tasks.add(50, 0, false, 6, buzzerOff); + #endif + #if STATUS_BUZZER >= 0 + tone(STATUS_BUZZER_PIN, STATUS_BUZZER, 50); + #endif + } +} + +#endif diff --git a/src/lib/sound/Sound.h b/src/lib/sound/Sound.h new file mode 100755 index 0000000..66ec7f4 --- /dev/null +++ b/src/lib/sound/Sound.h @@ -0,0 +1,21 @@ +// ----------------------------------------------------------------------------------------------------------------------------- +// Sound +#pragma once + +#include "../../Common.h" + +#ifdef STATUS_BUZZER + +class Sound { + public: + void init(); // get sound pins ready + void alert(); // sound/buzzer + void click(); // sound/beep + void beep(); // sound/click + + bool enabled = STATUS_BUZZER_DEFAULT == ON; + private: + bool ready = false; +}; + +#endif diff --git a/src/lib/tasks/HAL_ATMEGA328_HWTIMER.h b/src/lib/tasks/HAL_ATMEGA328_HWTIMER.h new file mode 100755 index 0000000..c114889 --- /dev/null +++ b/src/lib/tasks/HAL_ATMEGA328_HWTIMER.h @@ -0,0 +1,81 @@ +//-------------------------------------------------------------------------------------------------- +// ATMEGA328 hardware timers + +// provides one 16 bit timer (Timer1) with 16 bit software pre-scaler, running at 2MHz +// timer configured as ~0 to 0.032 seconds (granularity of timer is 0.5uS) /8 pre-scaler + +#define TIMER_RATE_MHZ 2L // AtMega328 motor timers run at 2 MHz +#define TIMER_RATE_16MHZ_TICKS 8L // 16L/TIMER_RATE_MHZ, 8x slower than the default 16MHz "sub-micros" + +#if defined(TASKS_HWTIMER1_ENABLE) || defined(TASKS_HWTIMER2_ENABLE) || defined(TASKS_HWTIMER3_ENABLE) || defined(TASKS_HWTIMER4_ENABLE) + // prepare hw timer for interval in sub-microseconds (1/16us) + volatile uint16_t _nextPeriod1 = 2000, _nextPeriod2 = 2000, _nextPeriod3 = 2000, _nextPeriod4 = 2000; + volatile uint16_t _nextRep1 = 0, _nextRep2 = 0, _nextRep3 = 0, _nextRep4 = 0; + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { + // maximum time is about 134 seconds for this design + uint32_t counts, reps = 0; + if (period != 0 && period <= 2144000000) { + if (period < 16) period = 16; // minimum time is 1us + period /= TIMER_RATE_16MHZ_TICKS; + reps = period/65536 + 1; + counts = period/reps - 1; // has -1 since this is dropped right into a timer register + } else counts = 2000; // set for a 1ms period, stopped + + noInterrupts(); + _nextPeriod1 = counts; _nextRep1 = reps; + interrupts(); + } +#else + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { (void)(num); (void)(period); } +#endif + +#ifdef TASKS_HWTIMER1_ENABLE + void (*HAL_HWTIMER1_FUN)() = NULL; // points to task/process callback function + + bool HAL_HWTIMER1_INIT(uint8_t priority) { + noInterrupts(); + OCR1A = 2000; // startup one millisecond + TCCR1B = (1 << WGM12) | (1 << CS11); + TCCR1A = 0; + TIMSK1 = (1 << OCIE1A); + interrupts(); + return true; + } + + void HAL_HWTIMER1_DONE() { + HAL_HWTIMER1_FUN = NULL; + TIMSK1 = 0; + } + + #define HAL_HWTIMER1_SET_PERIOD() (OCR1A = _nextPeriod1) + ISR(TIMER1_COMPA_vect) { + TASKS_HWTIMER1_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep1 > 1) { count++; if (count%_nextRep1 != 0) goto done; } + if (_nextRep1) HAL_HWTIMER1_FUN(); + HAL_HWTIMER1_SET_PERIOD(); + done: {} + TASKS_HWTIMER1_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER2_ENABLE + void (*HAL_HWTIMER2_FUN)() = NULL; + #define HAL_HWTIMER2_SET_PERIOD() + bool HAL_HWTIMER2_INIT(uint8_t priority) { return false; } + void HAL_HWTIMER2_DONE() { } +#endif + +#ifdef TASKS_HWTIMER3_ENABLE + void (*HAL_HWTIMER3_FUN)() = NULL; + #define HAL_HWTIMER3_SET_PERIOD() + bool HAL_HWTIMER3_INIT(uint8_t priority) { return false;} + void HAL_HWTIMER3_DONE() { } +#endif + +#ifdef TASKS_HWTIMER4_ENABLE + void (*HAL_HWTIMER4_FUN)() = NULL; + #define HAL_HWTIMER4_SET_PERIOD() + bool HAL_HWTIMER4_INIT(uint8_t priority) { return false; } + void HAL_HWTIMER4_DONE() { } +#endif \ No newline at end of file diff --git a/src/lib/tasks/HAL_EMPTY_HWTIMER.h b/src/lib/tasks/HAL_EMPTY_HWTIMER.h new file mode 100755 index 0000000..c46b738 --- /dev/null +++ b/src/lib/tasks/HAL_EMPTY_HWTIMER.h @@ -0,0 +1,139 @@ +//-------------------------------------------------------------------------------------------------- +// Empty hardware timers + +// minimum structure + + // a useful example for 16bit counter/timer hardware to +#define TIMER_RATE_MHZ 4L // allow sufficient resolution (0.25us) and range (134 seconds) +#define TIMER_RATE_16MHZ_TICKS 4L // timer hardware 4x slower than the default 16MHz "sub-micros" (4MHz) + +#if defined(TASKS_HWTIMER1_ENABLE) || defined(TASKS_HWTIMER2_ENABLE) || defined(TASKS_HWTIMER3_ENABLE) || defined(TASKS_HWTIMER4_ENABLE) + // prepare hw timer for interval in sub-microseconds (1/16us) + volatile uint16_t _nextPeriod1, _nextPeriod2, _nextPeriod3, _nextPeriod4; + volatile uint16_t _nextRep1, _nextRep2, _nextRep3, _nextRep4; + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { + // maximum time is about 134 seconds for this design + uint32_t counts, reps = 0; + if (period != 0 && period <= 2144000000) { + if (period < 16) period = 16; // minimum time is 1us + period /= TIMER_RATE_16MHZ_TICKS; + reps = period/65536 + 1; + counts = period/reps - 1; // has -1 since this is dropped right into a timer register + } else counts = 2000; // set for a 1ms period, stopped + + noInterrupts(); + switch (num) { + case 1: _nextPeriod1 = counts; _nextRep1 = reps; break; + case 2: _nextPeriod2 = counts; _nextRep2 = reps; break; + case 3: _nextPeriod3 = counts; _nextRep3 = reps; break; + case 4: _nextPeriod4 = counts; _nextRep4 = reps; break; + } + interrupts(); + } +#else + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { (void)(num); (void)(period); } +#endif + +#ifdef TASKS_HWTIMER1_ENABLE + void (*HAL_HWTIMER1_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER1_WRAPPER(void); // forward definition of the timer ISR + + bool HAL_HWTIMER1_INIT(uint8_t priority) { + // <--- code to init/start timer goes here + return true; + } + + void HAL_HWTIMER1_DONE() { + // <--- code to stop timer goes here + HAL_HWTIMER1_FUN = NULL; + } + + #define HAL_HWTIMER1_SET_PERIOD() {} // <--- code to set timer period goes here + void HAL_HWTIMER1_WRAPPER() { + TASKS_HWTIMER1_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep1 > 1) { count++; if (count%_nextRep1 != 0) goto done; } + if (_nextRep1) HAL_HWTIMER1_FUN(); + HAL_HWTIMER1_SET_PERIOD(); + done: {} + TASKS_HWTIMER1_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER2_ENABLE + void (*HAL_HWTIMER2_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER2_WRAPPER(void); // forward definition of the timer ISR + + bool HAL_HWTIMER2_INIT(uint8_t priority) { + // <--- code to init/start timer goes here + return true; + } + + void HAL_HWTIMER2_DONE() { + // <--- code to stop timer goes here + HAL_HWTIMER2_FUN = NULL; + } + + #define HAL_HWTIMER2_SET_PERIOD() {} // <--- code to set timer period goes here + void HAL_HWTIMER2_WRAPPER() { + TASKS_HWTIMER2_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep2 > 1) { count++; if (count%_nextRep2 != 0) goto done; } + if (_nextRep2) HAL_HWTIMER2_FUN(); + HAL_HWTIMER2_SET_PERIOD(); + done: {} + TASKS_HWTIMER2_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER3_ENABLE + void (*HAL_HWTIMER3_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER3_WRAPPER(void); // forward definition of the timer ISR + + bool HAL_HWTIMER3_INIT(uint8_t priority) { + // <--- code to init/start timer goes here + return true; + } + + void HAL_HWTIMER3_DONE() { + // <--- code to stop timer goes here + HAL_HWTIMER3_FUN = NULL; + } + + #define HAL_HWTIMER3_SET_PERIOD() {} // <--- code to set timer period goes here + void HAL_HWTIMER3_WRAPPER() { + TASKS_HWTIMER3_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep3 > 1) { count++; if (count%_nextRep3 != 0) goto done; } + if (_nextRep3) HAL_HWTIMER3_FUN(); + HAL_HWTIMER3_SET_PERIOD(); + done: {} + TASKS_HWTIMER3_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER4_ENABLE + void (*HAL_HWTIMER4_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER4_WRAPPER(void); // forward definition of the timer ISR + + bool HAL_HWTIMER4_INIT(uint8_t priority) { + // init code goes here + return false; + } + + void HAL_HWTIMER4_DONE() { + // <--- code to stop timer goes here + HAL_HWTIMER4_FUN = NULL; + } + + #define HAL_HWTIMER4_SET_PERIOD() {} // <--- code to set timer period goes here + void HAL_HWTIMER4_WRAPPER() { + TASKS_HWTIMER4_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep4 > 1) { count++; if (count%_nextRep4 != 0) goto done; } + if (_nextRep4) HAL_HWTIMER4_FUN(); + HAL_HWTIMER4_SET_PERIOD(); + done: {} + TASKS_HWTIMER4_PROFILER_SUFFIX; + } +#endif diff --git a/src/lib/tasks/HAL_ESP32_HWTIMER.h b/src/lib/tasks/HAL_ESP32_HWTIMER.h new file mode 100755 index 0000000..e6a414a --- /dev/null +++ b/src/lib/tasks/HAL_ESP32_HWTIMER.h @@ -0,0 +1,216 @@ +//-------------------------------------------------------------------------------------------------- +// ESP32 hardware timers + +// mux to block code from running simultaniously +portMUX_TYPE timerMux = portMUX_INITIALIZER_UNLOCKED; + +// provides two 32 bit interval timers with 16 bit software pre-scalers, running at 16MHz +// each timer configured as ~0 to x seconds (granularity of timer is 0.062uS) +// timer use doesn't collide with PWM or tone() on these platforms + +// notes for future improvements: +// the ESP32 timers flexible enough that we can get rid of the software pre-scalers +// also, we can more directly access the timer objects for example: +// #define HAL_HWTIMER1_SET_PERIOD() itimer1->dev->alarm_low = _nextPeriod1 + +#define TIMER_RATE_MHZ 16L // ESP32 motor timers run at 16MHz so use full resolution +#define TIMER_RATE_16MHZ_TICKS 1L // 16L/TIMER_RATE_MHZ, for the default 16MHz "sub-micros" (16MHz) + +#if defined(TASKS_HWTIMER1_ENABLE) || defined(TASKS_HWTIMER2_ENABLE) || defined(TASKS_HWTIMER3_ENABLE) || defined(TASKS_HWTIMER4_ENABLE) + // prepare hw timer for interval in sub-microseconds (1/16us) + volatile uint32_t _nextPeriod1 = 16000, _nextPeriod2 = 16000, _nextPeriod3 = 16000, _nextPeriod4 = 16000; + volatile uint16_t _nextRep1 = 0, _nextRep2 = 0, _nextRep3 = 0, _nextRep4 = 0; + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { + // maximum time is about 134 seconds for this design + uint32_t counts, reps = 0; + if (period != 0 && period <= 2144000000) { + if (period < 16) period = 16; // minimum time is 1us + period /= TIMER_RATE_16MHZ_TICKS; + reps = period/4194304UL + 1; + counts = period/reps; + } else counts = 16000; // set for a 1ms period, stopped + + noInterrupts(); + switch (num) { + case 1: _nextPeriod1 = counts; _nextRep1 = reps; break; + case 2: _nextPeriod2 = counts; _nextRep2 = reps; break; + case 3: _nextPeriod3 = counts; _nextRep3 = reps; break; + case 4: _nextPeriod4 = counts; _nextRep4 = reps; break; + } + interrupts(); + } +#else + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { (void)(num); (void)(period); } +#endif + +#ifdef TASKS_HWTIMER1_ENABLE + hw_timer_t *itimer1 = NULL; + + void (*HAL_HWTIMER1_FUN)() = NULL; // points to task/process callback function + IRAM_ATTR void HAL_HWTIMER1_WRAPPER(); + + bool HAL_HWTIMER1_INIT(uint8_t priority) { + // timer#, divider, count up + itimer1 = timerBegin(0, 5, true); // ESP32 timer frequency is 80MHz, 80/5 = 16MHz + timerAttachInterrupt(itimer1, &HAL_HWTIMER1_WRAPPER, true); + timerAlarmWrite(itimer1, 1000*16, true); // startup one millisecond + timerAlarmEnable(itimer1); + return true; + } + + void HAL_HWTIMER1_DONE() { + HAL_HWTIMER1_FUN = NULL; + timerDetachInterrupt(itimer1); + timerEnd(itimer1); + } + + #define HAL_HWTIMER1_SET_PERIOD() timerAlarmWrite(itimer1, _nextPeriod1, true) + IRAM_ATTR void HAL_HWTIMER1_WRAPPER() { + portENTER_CRITICAL_ISR(&timerMux); + TASKS_HWTIMER1_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep1 > 1) { count++; if (count % _nextRep1 != 0) goto done; } + if (_nextRep1) HAL_HWTIMER1_FUN(); + HAL_HWTIMER1_SET_PERIOD(); + done: {} + TASKS_HWTIMER1_PROFILER_SUFFIX; + portEXIT_CRITICAL_ISR ( &timerMux ); + } +#endif + +#ifdef TASKS_HWTIMER2_ENABLE + hw_timer_t *itimer2 = NULL; + + void (*HAL_HWTIMER2_FUN)() = NULL; // points to task/process callback function + IRAM_ATTR void HAL_HWTIMER2_WRAPPER(); + + bool HAL_HWTIMER2_INIT(uint8_t priority) { + // timer#, divider, count up + itimer2 = timerBegin(1, 5, true); // ESP32 timer frequency is 80MHz, 80/5 = 16MHz + timerAttachInterrupt(itimer2, &HAL_HWTIMER2_WRAPPER, true); + timerAlarmWrite(itimer2, 1000*16, true); // startup one millisecond + timerAlarmEnable(itimer2); + return true; + } + + void HAL_HWTIMER2_DONE() { + HAL_HWTIMER2_FUN = NULL; + timerDetachInterrupt(itimer2); + timerEnd(itimer2); + } + + #define HAL_HWTIMER2_SET_PERIOD() timerAlarmWrite(itimer2, _nextPeriod2, true) + IRAM_ATTR void HAL_HWTIMER2_WRAPPER() { + portENTER_CRITICAL_ISR(&timerMux); + TASKS_HWTIMER2_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep2 > 1) { count++; if (count % _nextRep2 != 0) goto done; } + if (_nextRep2) HAL_HWTIMER2_FUN(); + HAL_HWTIMER2_SET_PERIOD(); + done: {} + TASKS_HWTIMER2_PROFILER_SUFFIX; + portEXIT_CRITICAL_ISR ( &timerMux ); + } +#endif + +#ifdef TASKS_HWTIMER3_ENABLE + hw_timer_t *itimer3 = NULL; + + void (*HAL_HWTIMER3_FUN)() = NULL; // points to task/process callback function + IRAM_ATTR void HAL_HWTIMER3_WRAPPER(); + + bool HAL_HWTIMER3_INIT(uint8_t priority) { + // timer#, divider, count up + itimer3 = timerBegin(2, 5, true); // ESP32 timer frequency is 80MHz, 80/5 = 16MHz + timerAttachInterrupt(itimer3, &HAL_HWTIMER3_WRAPPER, true); + timerAlarmWrite(itimer3, 1000*16, true); // startup one millisecond + timerAlarmEnable(itimer3); + return true; + } + + void HAL_HWTIMER3_DONE() { + HAL_HWTIMER3_FUN = NULL; + timerDetachInterrupt(itimer3); + timerEnd(itimer3); + } + + #define HAL_HWTIMER3_SET_PERIOD() timerAlarmWrite(itimer3, _nextPeriod3, true) + IRAM_ATTR void HAL_HWTIMER3_WRAPPER() { + portENTER_CRITICAL_ISR(&timerMux); + TASKS_HWTIMER3_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep3 > 1) { count++; if (count % _nextRep3 != 0) goto done; } + if (_nextRep3) HAL_HWTIMER3_FUN(); + HAL_HWTIMER3_SET_PERIOD(); + done: {} + TASKS_HWTIMER3_PROFILER_SUFFIX; + portEXIT_CRITICAL_ISR ( &timerMux ); + } +#endif + +#ifdef TASKS_HWTIMER4_ENABLE + hw_timer_t *itimer4 = NULL; + + void (*HAL_HWTIMER4_FUN)() = NULL; // points to task/process callback function + IRAM_ATTR void HAL_HWTIMER4_WRAPPER(); + + bool HAL_HWTIMER4_INIT(uint8_t priority) { + // timer#, divider, count up + itimer4 = timerBegin(3, 5, true); // ESP32 timer frequency is 80MHz, 80/5 = 16MHz + timerAttachInterrupt(itimer4, &HAL_HWTIMER4_WRAPPER, true); + timerAlarmWrite(itimer4, 1000*16, true); // startup one millisecond + timerAlarmEnable(itimer4); + return true; + } + + void HAL_HWTIMER4_DONE() { + HAL_HWTIMER4_FUN = NULL; + timerDetachInterrupt(itimer4); + timerEnd(itimer4); + } + + #define HAL_HWTIMER4_SET_PERIOD() timerAlarmWrite(itimer4, _nextPeriod4, true) + IRAM_ATTR void HAL_HWTIMER4_WRAPPER() { + portENTER_CRITICAL_ISR(&timerMux); + TASKS_HWTIMER4_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep4 > 1) { count++; if (count % _nextRep4 != 0) goto done; } + if (_nextRep4) HAL_HWTIMER4_FUN(); + HAL_HWTIMER4_SET_PERIOD(); + done: {} + TASKS_HWTIMER4_PROFILER_SUFFIX; + portEXIT_CRITICAL_ISR ( &timerMux ); + } +#endif + +// disable hardware timer based tasks by clearing interrupt flag(s) +void timerAlarmsDisable() { +#ifdef TASKS_HWTIMER1_ENABLE + if (itimer1 != NULL) timerAlarmDisable(itimer1); +#endif +#ifdef TASKS_HWTIMER2_ENABLE + if (itimer2 != NULL) timerAlarmDisable(itimer2); +#endif +#ifdef TASKS_HWTIMER3_ENABLE + if (itimer3 != NULL) timerAlarmDisable(itimer3); +#endif +#ifdef TASKS_HWTIMER4_ENABLE + if (itimer4 != NULL) timerAlarmDisable(itimer4); +#endif +} + +// enable hardware timer based tasks by setting interrupt flag(s) +void timerAlarmsEnable() { +#ifdef TASKS_HWTIMER1_ENABLE + if (itimer1 != NULL) timerAlarmEnable(itimer1); +#endif +#ifdef TASKS_HWTIMER2_ENABLE + if (itimer2 != NULL) timerAlarmEnable(itimer2); +#endif +#ifdef TASKS_HWTIMER3_ENABLE + if (itimer3 != NULL) timerAlarmEnable(itimer3); +#endif +#ifdef TASKS_HWTIMER4_ENABLE + if (itimer4 != NULL) timerAlarmEnable(itimer4); +#endif +} diff --git a/src/lib/tasks/HAL_ESP32_V3_HWTIMER.h b/src/lib/tasks/HAL_ESP32_V3_HWTIMER.h new file mode 100755 index 0000000..42e43bb --- /dev/null +++ b/src/lib/tasks/HAL_ESP32_V3_HWTIMER.h @@ -0,0 +1,208 @@ +//-------------------------------------------------------------------------------------------------- +// ESP32 hardware timers + +// mux to block code from running simultaniously +portMUX_TYPE timerMux = portMUX_INITIALIZER_UNLOCKED; + +// provides two 32 bit interval timers with 16 bit software pre-scalers, running at 16MHz +// each timer configured as ~0 to x seconds (granularity of timer is 0.062uS) +// timer use doesn't collide with PWM or tone() on these platforms + +// notes for future improvements: +// the ESP32 timers flexible enough that we can get rid of the software pre-scalers +// also, we can more directly access the timer objects for example: +// #define HAL_HWTIMER1_SET_PERIOD() itimer1->dev->alarm_low = _nextPeriod1 + +#define TIMER_RATE_MHZ 16L // ESP32 motor timers run at 16MHz so use full resolution +#define TIMER_RATE_16MHZ_TICKS 1L // 16L/TIMER_RATE_MHZ, for the default 16MHz "sub-micros" (16MHz) + +#if defined(TASKS_HWTIMER1_ENABLE) || defined(TASKS_HWTIMER2_ENABLE) || defined(TASKS_HWTIMER3_ENABLE) || defined(TASKS_HWTIMER4_ENABLE) + // prepare hw timer for interval in sub-microseconds (1/16us) + volatile uint32_t _nextPeriod1 = 16000, _nextPeriod2 = 16000, _nextPeriod3 = 16000, _nextPeriod4 = 16000; + volatile uint16_t _nextRep1 = 0, _nextRep2 = 0, _nextRep3 = 0, _nextRep4 = 0; + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { + // maximum time is about 134 seconds for this design + uint32_t counts, reps = 0; + if (period != 0 && period <= 2144000000) { + if (period < 16) period = 16; // minimum time is 1us + period /= TIMER_RATE_16MHZ_TICKS; + reps = period/4194304UL + 1; + counts = period/reps; + } else counts = 16000; // set for a 1ms period, stopped + + noInterrupts(); + switch (num) { + case 1: _nextPeriod1 = counts; _nextRep1 = reps; break; + case 2: _nextPeriod2 = counts; _nextRep2 = reps; break; + case 3: _nextPeriod3 = counts; _nextRep3 = reps; break; + case 4: _nextPeriod4 = counts; _nextRep4 = reps; break; + } + interrupts(); + } +#else + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { (void)(num); (void)(period); } +#endif + +#ifdef TASKS_HWTIMER1_ENABLE + hw_timer_t *itimer1 = NULL; + + void (*HAL_HWTIMER1_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER1_WRAPPER(); + + bool HAL_HWTIMER1_INIT(uint8_t priority) { + itimer1 = timerBegin(16000000); // ESP32 timer frequency is 16MHz + timerAttachInterrupt(itimer1, &HAL_HWTIMER1_WRAPPER); + timerAlarm(itimer1, 1000*16, true, 0); // startup one millisecond + return true; + } + + void HAL_HWTIMER1_DONE() { + HAL_HWTIMER1_FUN = NULL; + timerDetachInterrupt(itimer1); + timerEnd(itimer1); + } + + #define HAL_HWTIMER1_SET_PERIOD() timerAlarm(itimer1, _nextPeriod1, true, 0) + IRAM_ATTR void HAL_HWTIMER1_WRAPPER() { + portENTER_CRITICAL_ISR(&timerMux); + TASKS_HWTIMER1_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep1 > 1) { count++; if (count % _nextRep1 != 0) goto done; } + if (_nextRep1) HAL_HWTIMER1_FUN(); + HAL_HWTIMER1_SET_PERIOD(); + done: {} + TASKS_HWTIMER1_PROFILER_SUFFIX; + portEXIT_CRITICAL_ISR ( &timerMux ); + } +#endif + +#ifdef TASKS_HWTIMER2_ENABLE + hw_timer_t *itimer2 = NULL; + + void (*HAL_HWTIMER2_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER2_WRAPPER(); + + bool HAL_HWTIMER2_INIT(uint8_t priority) { + itimer2 = timerBegin(16000000); // ESP32 timer frequency is 16MHz + timerAttachInterrupt(itimer2, &HAL_HWTIMER2_WRAPPER); + timerAlarm(itimer2, 1000*16, true, 0); // startup one millisecond + return true; + } + + void HAL_HWTIMER2_DONE() { + HAL_HWTIMER2_FUN = NULL; + timerDetachInterrupt(itimer2); + timerEnd(itimer2); + } + + #define HAL_HWTIMER2_SET_PERIOD() timerAlarm(itimer2, _nextPeriod2, true, 0) + IRAM_ATTR void HAL_HWTIMER2_WRAPPER() { + portENTER_CRITICAL_ISR(&timerMux); + TASKS_HWTIMER2_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep2 > 1) { count++; if (count % _nextRep2 != 0) goto done; } + if (_nextRep2) HAL_HWTIMER2_FUN(); + HAL_HWTIMER2_SET_PERIOD(); + done: {} + TASKS_HWTIMER2_PROFILER_SUFFIX; + portEXIT_CRITICAL_ISR ( &timerMux ); + } +#endif + +#ifdef TASKS_HWTIMER3_ENABLE + hw_timer_t *itimer3 = NULL; + + void (*HAL_HWTIMER3_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER3_WRAPPER(); + + bool HAL_HWTIMER3_INIT(uint8_t priority) { + itimer3 = timerBegin(16000000); // ESP32 timer frequency is 16MHz + timerAttachInterrupt(itimer3, &HAL_HWTIMER3_WRAPPER); + timerAlarm(itimer3, 1000*16, true, 0); // startup one millisecond + return true; + } + + void HAL_HWTIMER3_DONE() { + HAL_HWTIMER3_FUN = NULL; + timerDetachInterrupt(itimer3); + timerEnd(itimer3); + } + + #define HAL_HWTIMER3_SET_PERIOD() timerAlarm(itimer3, _nextPeriod3, true, 0) + IRAM_ATTR void HAL_HWTIMER3_WRAPPER() { + portENTER_CRITICAL_ISR(&timerMux); + TASKS_HWTIMER3_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep3 > 1) { count++; if (count % _nextRep3 != 0) goto done; } + if (_nextRep3) HAL_HWTIMER3_FUN(); + HAL_HWTIMER3_SET_PERIOD(); + done: {} + TASKS_HWTIMER3_PROFILER_SUFFIX; + portEXIT_CRITICAL_ISR ( &timerMux ); + } +#endif + +#ifdef TASKS_HWTIMER4_ENABLE + hw_timer_t *itimer4 = NULL; + + void (*HAL_HWTIMER4_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER4_WRAPPER(); + + bool HAL_HWTIMER4_INIT(uint8_t priority) { + itimer4 = timerBegin(16000000); // ESP32 timer frequency is 16MHz + timerAttachInterrupt(itimer4, &HAL_HWTIMER4_WRAPPER); + timerAlarm(itimer4, 1000*16, true, 0); // startup one millisecond + return true; + } + + void HAL_HWTIMER4_DONE() { + HAL_HWTIMER4_FUN = NULL; + timerDetachInterrupt(itimer4); + timerEnd(itimer4); + } + + #define HAL_HWTIMER4_SET_PERIOD() timerAlarm(itimer4, _nextPeriod4, true, 0) + IRAM_ATTR void HAL_HWTIMER4_WRAPPER() { + portENTER_CRITICAL_ISR(&timerMux); + TASKS_HWTIMER4_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep4 > 1) { count++; if (count % _nextRep4 != 0) goto done; } + if (_nextRep4) HAL_HWTIMER4_FUN(); + HAL_HWTIMER4_SET_PERIOD(); + done: {} + TASKS_HWTIMER4_PROFILER_SUFFIX; + portEXIT_CRITICAL_ISR ( &timerMux ); + } +#endif + +// disable hardware timer based tasks by clearing interrupt flag(s) +void timerAlarmsDisable() { +#ifdef TASKS_HWTIMER1_ENABLE + if (itimer1 != NULL) timerStop(itimer1); +#endif +#ifdef TASKS_HWTIMER2_ENABLE + if (itimer2 != NULL) timerStop(itimer2); +#endif +#ifdef TASKS_HWTIMER3_ENABLE + if (itimer3 != NULL) timerStop(itimer3); +#endif +#ifdef TASKS_HWTIMER4_ENABLE + if (itimer4 != NULL) timerStop(itimer4); +#endif +} + +// enable hardware timer based tasks by setting interrupt flag(s) +void timerAlarmsEnable() { +#ifdef TASKS_HWTIMER1_ENABLE + if (itimer1 != NULL) timerStart(itimer1); +#endif +#ifdef TASKS_HWTIMER2_ENABLE + if (itimer2 != NULL) timerStart(itimer2); +#endif +#ifdef TASKS_HWTIMER3_ENABLE + if (itimer3 != NULL) timerStart(itimer3); +#endif +#ifdef TASKS_HWTIMER4_ENABLE + if (itimer4 != NULL) timerStart(itimer4); +#endif +} diff --git a/src/lib/tasks/HAL_HWTIMERS.h b/src/lib/tasks/HAL_HWTIMERS.h new file mode 100755 index 0000000..d85552a --- /dev/null +++ b/src/lib/tasks/HAL_HWTIMERS.h @@ -0,0 +1,54 @@ +//-------------------------------------------------------------------------------------------------- +// Selects hardware timer HAL according to platform + +// these must be present even if the hardware timer isn't brought in +#ifndef TASKS_HWTIMER1_ENABLE + void (*HAL_HWTIMER1_FUN)() = NULL; + #define HAL_HWTIMER1_SET_PERIOD() + bool HAL_HWTIMER1_INIT(uint8_t priority) { (void)(priority); return false; } + void HAL_HWTIMER1_DONE() { } +#endif +#ifndef TASKS_HWTIMER2_ENABLE + void (*HAL_HWTIMER2_FUN)() = NULL; + #define HAL_HWTIMER2_SET_PERIOD() + bool HAL_HWTIMER2_INIT(uint8_t priority) { (void)(priority); return false; } + void HAL_HWTIMER2_DONE() { } +#endif +#ifndef TASKS_HWTIMER3_ENABLE + void (*HAL_HWTIMER3_FUN)() = NULL; + #define HAL_HWTIMER3_SET_PERIOD() + bool HAL_HWTIMER3_INIT(uint8_t priority) { (void)(priority); return false;} + void HAL_HWTIMER3_DONE() { } +#endif +#ifndef TASKS_HWTIMER4_ENABLE + void (*HAL_HWTIMER4_FUN)() = NULL; + #define HAL_HWTIMER4_SET_PERIOD() + bool HAL_HWTIMER4_INIT(uint8_t priority) { (void)(priority); return false; } + void HAL_HWTIMER4_DONE() { } +#endif + +// bring in hardware timer support +#if defined(__AVR_ATmega168__) || defined(__AVR_ATmega328P__) + #include "HAL_ATMEGA328_HWTIMER.h" +#elif defined(__AVR_ATmega1280__) ||defined(__AVR_ATmega2560__) + #include "HAL_MEGA2560_HWTIMER.h" +#elif defined(STM32H723xx) || defined(STM32H743xx) || defined(STM32H750xx) || \ + defined(STM32F446xx) || defined(STM32F411xE) || \ + defined(STM32F401xC) || defined(STM32F407xx) || \ + defined(STM32F303xC) || defined(STM32F103xB) + #include "HAL_STM32_HWTIMER.h" +// Teensy3.0, 3.1, 3.2, 3.5, 3.6, 4.0, and 4.1 +#elif defined(_mk20dx128_h_) || defined(__MK20DX128__) || \ + defined(__MK20DX256__) || defined(__MK64FX512__) || \ + defined(__MK66FX1M0__) || defined(__IMXRT1052__) || \ + defined(__IMXRT1062__) + #include "HAL_TEENSY_HWTIMER.h" +#elif defined(ESP32) + #if ESP_ARDUINO_VERSION >= 0x30000 + #include "HAL_ESP32_V3_HWTIMER.h" + #else + #include "HAL_ESP32_HWTIMER.h" + #endif +#else + #include "HAL_EMPTY_HWTIMER.h" +#endif diff --git a/src/lib/tasks/HAL_MEGA2560_HWTIMER.h b/src/lib/tasks/HAL_MEGA2560_HWTIMER.h new file mode 100755 index 0000000..641b55f --- /dev/null +++ b/src/lib/tasks/HAL_MEGA2560_HWTIMER.h @@ -0,0 +1,162 @@ +//-------------------------------------------------------------------------------------------------- +// MEGA2560 hardware timers + +// provides four 16 bit timers (Timer1, Timer3, Timer4, Timer5) with 16 bit software pre-scalers, running at 2MHz +// each timer configured as ~0 to 0.032 seconds (granularity of timer is 0.5uS) /8 pre-scaler +// note that timer use my collide with PWM or tone() depending on which pin is being controlled + +#define TIMER_RATE_MHZ 2L // Mega2560 motor timers run at 2 MHz +#define TIMER_RATE_16MHZ_TICKS 8L // 16L/TIMER_RATE_MHZ, 8x slower than the default 16MHz "sub-micros" + +#if defined(TASKS_HWTIMER1_ENABLE) || defined(TASKS_HWTIMER2_ENABLE) || defined(TASKS_HWTIMER3_ENABLE) || defined(TASKS_HWTIMER4_ENABLE) + // prepare hw timer for interval in sub-microseconds (1/16us) + volatile uint16_t _nextPeriod1 = 2000, _nextPeriod2 = 2000, _nextPeriod3 = 2000, _nextPeriod4 = 2000; + volatile uint16_t _nextRep1 = 0, _nextRep2 = 0, _nextRep3 = 0, _nextRep4 = 0; + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { + // maximum time is about 134 seconds for this design + uint32_t counts, reps=0; + if (period != 0 && period <= 2144000000) { + if (period < 16) period = 16; // minimum time is 1us + period /= TIMER_RATE_16MHZ_TICKS; + reps = period/65536 + 1; + counts = period/reps - 1; // has -1 since this is dropped right into a timer register + } else counts = 2000; // set for a 1ms period, stopped + + noInterrupts(); + switch (num) { + case 1: _nextPeriod1 = counts; _nextRep1 = reps; break; + case 2: _nextPeriod2 = counts; _nextRep2 = reps; break; + case 3: _nextPeriod3 = counts; _nextRep3 = reps; break; + case 4: _nextPeriod4 = counts; _nextRep4 = reps; break; + } + interrupts(); + } +#else + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { (void)(num); (void)(period); } +#endif + +// start hw timers +#ifdef TASKS_HWTIMER1_ENABLE + void (*HAL_HWTIMER1_FUN)() = NULL; // points to task/process callback function + + bool HAL_HWTIMER1_INIT(uint8_t priority) { + // period 0.5... us per count 32.767 ms max + (void)priority; + noInterrupts(); + OCR1A = 2000; // startup one millisecond + TCCR1B = (1 << WGM12) | (1 << CS11); + TCCR1A = 0; + TIMSK1 = (1 << OCIE1A); + interrupts(); + return true; + } + + void HAL_HWTIMER1_DONE() { + TIMSK1 = 0; // stop hw timer (clear register interrupt flag) + HAL_HWTIMER1_FUN = NULL; + } + + #define HAL_HWTIMER1_SET_PERIOD() OCR1A = _nextPeriod1 + ISR(TIMER1_COMPA_vect) { + TASKS_HWTIMER1_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep1 > 1) { count++; if (count%_nextRep1 != 0) goto done; } + if (_nextRep1) HAL_HWTIMER1_FUN(); + HAL_HWTIMER1_SET_PERIOD(); + done: {} + TASKS_HWTIMER1_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER2_ENABLE + void (*HAL_HWTIMER2_FUN)() = NULL; // points to task/process callback function + + bool HAL_HWTIMER2_INIT(uint8_t priority) { + (void)priority; + noInterrupts(); + OCR3A = 2000; // startup one millisecond + TCCR3B = (1 << WGM12) | (1 << CS11); + TCCR3A = 0; + TIMSK3 = (1 << OCIE3A); + interrupts(); + return true; + } + + void HAL_HWTIMER2_DONE() { + TIMSK3 = 0; // stop hw timer (clear register interrupt flag) + HAL_HWTIMER2_FUN = NULL; + } + + #define HAL_HWTIMER2_SET_PERIOD() OCR3A = _nextPeriod2 + ISR(TIMER3_COMPA_vect) { + TASKS_HWTIMER2_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep2 > 1) { count++; if (count%_nextRep2 != 0) goto done; } + if (_nextRep2) HAL_HWTIMER2_FUN(); + HAL_HWTIMER2_SET_PERIOD(); + done: {} + TASKS_HWTIMER2_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER3_ENABLE + void (*HAL_HWTIMER3_FUN)() = NULL; // points to task/process callback function + + bool HAL_HWTIMER3_INIT(uint8_t priority) { + (void)priority; + noInterrupts(); + OCR4A = 2000; // startup one millisecond + TCCR4B = (1 << WGM12) | (1 << CS11); + TCCR4A = 0; + TIMSK4 = (1 << OCIE4A); + interrupts(); + return true; + } + + void HAL_HWTIMER3_DONE() { + TIMSK4 = 0; // stop hw timer (clear register interrupt flag) + HAL_HWTIMER3_FUN = NULL; + } + + #define HAL_HWTIMER3_SET_PERIOD() OCR4A = _nextPeriod3 + ISR(TIMER4_COMPA_vect) { + TASKS_HWTIMER3_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep3 > 1) { count++; if (count%_nextRep3 != 0) goto done; } + if (_nextRep3) HAL_HWTIMER3_FUN(); + HAL_HWTIMER3_SET_PERIOD(); + done: {} + TASKS_HWTIMER3_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER4_ENABLE + void (*HAL_HWTIMER4_FUN)() = NULL; // points to task/process callback function + + bool HAL_HWTIMER4_INIT(uint8_t priority) { + (void)priority; + noInterrupts(); + OCR5A = 2000; // startup one millisecond + TCCR5B = (1 << WGM12) | (1 << CS11); + TCCR5A = 0; + TIMSK5 = (1 << OCIE5A); + interrupts(); + return true; + } + + void HAL_HWTIMER4_DONE() { + TIMSK5 = 0; // stop hw timer (clear register interrupt flag) + HAL_HWTIMER4_FUN = NULL; + } + + #define HAL_HWTIMER4_SET_PERIOD() OCR5A = _nextPeriod4 + ISR(TIMER5_COMPA_vect) { + TASKS_HWTIMER4_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep4 > 1) { count++; if (count%_nextRep4 != 0) goto done; } + if (_nextRep4) HAL_HWTIMER4_FUN(); + HAL_HWTIMER4_SET_PERIOD(); + done: {} + TASKS_HWTIMER4_PROFILER_SUFFIX; + } +#endif diff --git a/src/lib/tasks/HAL_PROFILER.h b/src/lib/tasks/HAL_PROFILER.h new file mode 100755 index 0000000..565f5ca --- /dev/null +++ b/src/lib/tasks/HAL_PROFILER.h @@ -0,0 +1,48 @@ +//-------------------------------------------------------------------------------------------------- +// Configures the profiler according to platform + +#ifdef TASKS_PROFILER_ENABLE + volatile unsigned long _task_max_runtime[4] = {0, 0, 0, 0}; + volatile unsigned long _task_total_runtime[4] = {0, 0, 0, 0}; + volatile unsigned long _task_total_runtime_count[4] = {0, 0, 0, 0}; + #ifdef TASKS_HWTIMER1_ENABLE + #define TASKS_HWTIMER1_PROFILER_PREFIX unsigned long runtime_t0 = micros() + #define TASKS_HWTIMER1_PROFILER_SUFFIX { long at = micros()-runtime_t0; _task_total_runtime[0] += at; _task_total_runtime_count[0]++; if (labs(at) > _task_max_runtime[0]) _task_max_runtime[0] = labs(at); } + #endif + #ifdef TASKS_HWTIMER2_ENABLE + #define TASKS_HWTIMER2_PROFILER_PREFIX unsigned long runtime_t0 = micros() + #define TASKS_HWTIMER2_PROFILER_SUFFIX { long at = micros()-runtime_t0; _task_total_runtime[1] += at; _task_total_runtime_count[1]++; if (labs(at) > _task_max_runtime[1]) _task_max_runtime[1] = labs(at); } + #endif + #ifdef TASKS_HWTIMER3_ENABLE + #define TASKS_HWTIMER3_PROFILER_PREFIX unsigned long runtime_t0 = micros() + #define TASKS_HWTIMER3_PROFILER_SUFFIX { long at = micros()-runtime_t0; _task_total_runtime[2] += at; _task_total_runtime_count[2]++; if (labs(at) > _task_max_runtime[2]) _task_max_runtime[2] = labs(at); } + #endif + #ifdef TASKS_HWTIMER4_ENABLE + #define TASKS_HWTIMER4_PROFILER_PREFIX unsigned long runtime_t0 = micros() + #define TASKS_HWTIMER4_PROFILER_SUFFIX { long at = micros()-runtime_t0; _task_total_runtime[3] += at; _task_total_runtime_count[3]++; if (labs(at) > _task_max_runtime[3]) _task_max_runtime[3] = labs(at); } + #endif + + #define TASKS_PROFILER_PREFIX \ + long at = time_to_next_task - period; \ + average_arrival_time += at; \ + average_arrival_time_count++; \ + if (labs(at + period) > max_arrival_time) max_arrival_time = labs(at + period); \ + unsigned long runtime_t0 = micros(); + #define TASKS_PROFILER_SUFFIX \ + at = micros()-runtime_t0; \ + total_runtime += at; \ + total_runtime_count++; \ + if (labs(at) > max_runtime) max_runtime = labs(at); + +#else + #define TASKS_HWTIMER1_PROFILER_PREFIX + #define TASKS_HWTIMER1_PROFILER_SUFFIX + #define TASKS_HWTIMER2_PROFILER_PREFIX + #define TASKS_HWTIMER2_PROFILER_SUFFIX + #define TASKS_HWTIMER3_PROFILER_PREFIX + #define TASKS_HWTIMER3_PROFILER_SUFFIX + #define TASKS_HWTIMER4_PROFILER_PREFIX + #define TASKS_HWTIMER4_PROFILER_SUFFIX + #define TASKS_PROFILER_PREFIX + #define TASKS_PROFILER_SUFFIX +#endif diff --git a/src/lib/tasks/HAL_STM32_HWTIMER.h b/src/lib/tasks/HAL_STM32_HWTIMER.h new file mode 100755 index 0000000..4f42a0a --- /dev/null +++ b/src/lib/tasks/HAL_STM32_HWTIMER.h @@ -0,0 +1,202 @@ +//---------------------------------------------------------------------------------------------------- +// STM32 hardware timers + +// provides four 16 bit timers with 16 bit software pre-scalers, running at 4MHz +// each timer configured as ~0 to 0.016 seconds (granularity of timer is 0.25uS) +// note that timer use may collide with PWM depending on which pin is being controlled +// I tried to stay away from tone() and use the most basic timers first where possible + +#define TIMER_RATE_MHZ 4L // STM32 motor timers run at 4 MHz +#define TIMER_RATE_16MHZ_TICKS 4L // 16L/TIMER_RATE_MHZ, 4x slower than the default 16MHz "sub micros" + +#if defined(TASKS_HWTIMER1_ENABLE) || defined(TASKS_HWTIMER2_ENABLE) || defined(TASKS_HWTIMER3_ENABLE) || defined(TASKS_HWTIMER4_ENABLE) + // prepare hw timer for interval in sub-microseconds (1/16us) + volatile uint16_t _nextPeriod1 = 4000, _nextPeriod2 = 4000, _nextPeriod3 = 4000, _nextPeriod4 = 4000; + volatile uint16_t _nextRep1 = 0, _nextRep2 = 0, _nextRep3 = 0, _nextRep4 = 0; + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { + // maximum time is about 134 seconds for this design + uint32_t counts, reps=0; + if (period != 0 && period <= 2144000000) { + if (period < 16) period = 16; // minimum time is 1us + period /= TIMER_RATE_16MHZ_TICKS; + reps = period/65536 + 1; + counts = period/reps - 1; // has -1 since this is dropped right into a timer register + } else counts = 4000; // set for a 1ms period, stopped + + noInterrupts(); + switch (num) { + case 1: _nextPeriod1 = counts; _nextRep1 = reps; break; + case 2: _nextPeriod2 = counts; _nextRep2 = reps; break; + case 3: _nextPeriod3 = counts; _nextRep3 = reps; break; + case 4: _nextPeriod4 = counts; _nextRep4 = reps; break; + } + interrupts(); + } +#else + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { (void)(num); (void)(period); } +#endif + +#define TIMER_CHANNEL 1 // always use timer channel 1 +#define F_COMP 4000000 // timer clocks at 4MHz + +// search "TIMER_TONE" in github.com/stm32duino/Arduino_Core_STM32/blob/main/variants to find the timer use +#if defined(STM32H723xx) || defined(STM32H743xx) || defined(STM32H750xx) + #define STM32_TIMER1 TIM17 // this can use any type of timer AFAIK + #define STM32_TIMER2 TIM16 // tone uses TIM 6, servo TIM7, PWM is unknown + #define STM32_TIMER3 TIM15 // TIM 1/8 are advanced, TIM2/5 are 32bit (no library support for 32 bit) + #define STM32_TIMER4 TIM3 // TIM 3/4/12/13/14/15/16/17 are general purpose and TIM 6/7 are basic +#elif defined(STM32F446xx) + #define STM32_TIMER1 TIM1 // for STM32F446 (tone uses timer6, servo uses timer2, serial uses timer7) + #define STM32_TIMER2 TIM10 + #define STM32_TIMER3 TIM11 // same use as prior to this point (but different order) + #define STM32_TIMER4 TIM14 +#elif defined(STM32F411xE) || defined(STM32F401xC) + #define STM32_TIMER1 TIM11 // for STM32F401 and STM32F411 (tone uses timer10, servo uses timer11) + #define STM32_TIMER2 TIM9 + #define STM32_TIMER3 TIM4 // same use as prior to this point (but different order) + #define STM32_TIMER4 TIM5 +#elif defined(STM32F407xx) + #define STM32_TIMER1 TIM3 // TIM1 is used for PWM on Axis1 and Axis2 step pins (for DC servo control) + #define STM32_TIMER2 TIM10 // TIM9 is used for PWM reticle and the buzzer (I think) + #define STM32_TIMER3 TIM11 // supports timers TIM1 to TIM14, TIM 1/8 are advanced, TIM2/5 are 32bit (no library support for 32 bit) + #define STM32_TIMER4 TIM14 // the rest and general purpose or basic TIM 6/7 (this can use any type AFAIK) +#elif defined(STM32F303xC) + #define STM32_TIMER1 TIM17 // for STM32F303 (tone uses timer6, servo uses timer2) + #define STM32_TIMER2 TIM16 + #define STM32_TIMER3 TIM15 // same use as prior to this point (but different order) + #define STM32_TIMER4 TIM7 +#elif defined(STM32F103xB) + #define STM32_TIMER1 TIM4 // for STM32F103 (tone uses timer3, servo uses timer2) + #define STM32_TIMER2 TIM2 // don't use the tone() function + #define STM32_TIMER3 TIM1 // same use as prior to this point (but different order) + #define STM32_TIMER4 TIM3 +#endif +#if defined(TASKS_HWTIMER1_ENABLE) || defined(TASKS_HWTIMER2_ENABLE) || defined(TASKS_HWTIMER3_ENABLE) || defined(TASKS_HWTIMER4_ENABLE) +bool HAL_HWTIMER_INIT(uint8_t priority, HardwareTimer * hwtimer, void (*wrapper)()) { + hwtimer->pause(); + hwtimer->setMode(TIMER_CHANNEL, TIMER_OUTPUT_COMPARE); + hwtimer->setCaptureCompare(TIMER_CHANNEL, 1); // Interrupt 1 count after each update + hwtimer->attachInterrupt(TIMER_CHANNEL, wrapper); + + // period 0.25... us per count (72/18 = 4MHz) 16.384 ms max + uint32_t prescaleFactor = hwtimer->getTimerClkFreq()/F_COMP; // for example, 72000000/4000000 = 18 + hwtimer->setPrescaleFactor(prescaleFactor); + hwtimer->setOverflow(4000); // startup one millisecond + + // the sub-priority is which interrupt to handle first if both fire at the + // same time, which isn't supported in this HAL so all are set to 0 + // setInterruptPriority(priority, sub-priority) + hwtimer->setInterruptPriority(priority, 0); + hwtimer->resume(); // start the timer counting + hwtimer->refresh(); // refresh the timer's count, prescale, and overflow + return true; + } +#endif + +#ifdef TASKS_HWTIMER1_ENABLE + HardwareTimer *hwtimer1 = new HardwareTimer(STM32_TIMER1); + + void (*HAL_HWTIMER1_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER1_WRAPPER(); // forward definition of the timer ISR + + bool HAL_HWTIMER1_INIT(uint8_t priority) { + return HAL_HWTIMER_INIT(priority, hwtimer1, HAL_HWTIMER1_WRAPPER); + } + + void HAL_HWTIMER1_DONE() { + hwtimer1->pause(); + HAL_HWTIMER1_FUN = NULL; + } + + #define HAL_HWTIMER1_SET_PERIOD() WRITE_REG(STM32_TIMER1->ARR, _nextPeriod1) + void HAL_HWTIMER1_WRAPPER() { + TASKS_HWTIMER1_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep1 > 1) { count++; if (count%_nextRep1 != 0) goto done; } + if (_nextRep1) HAL_HWTIMER1_FUN(); + HAL_HWTIMER1_SET_PERIOD(); + done: {} + TASKS_HWTIMER1_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER2_ENABLE + HardwareTimer *hwtimer2 = new HardwareTimer(STM32_TIMER2); + + void (*HAL_HWTIMER2_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER2_WRAPPER(); // forward definition of the timer ISR + + bool HAL_HWTIMER2_INIT(uint8_t priority) { + return HAL_HWTIMER_INIT(priority, hwtimer2, HAL_HWTIMER2_WRAPPER); + } + + void HAL_HWTIMER2_DONE() { + hwtimer2->pause(); + HAL_HWTIMER2_FUN = NULL; + } + + #define HAL_HWTIMER2_SET_PERIOD() WRITE_REG(STM32_TIMER2->ARR, _nextPeriod2) + void HAL_HWTIMER2_WRAPPER() { + TASKS_HWTIMER2_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep2 > 1) { count++; if (count%_nextRep2 != 0) goto done; } + if (_nextRep2) HAL_HWTIMER2_FUN(); + HAL_HWTIMER2_SET_PERIOD(); + done: {} + TASKS_HWTIMER2_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER3_ENABLE + HardwareTimer *hwtimer3 = new HardwareTimer(STM32_TIMER3); + + void (*HAL_HWTIMER3_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER3_WRAPPER(); // forward definition of the timer ISR + + bool HAL_HWTIMER3_INIT(uint8_t priority) { + return HAL_HWTIMER_INIT(priority, hwtimer3, HAL_HWTIMER3_WRAPPER); + } + + void HAL_HWTIMER3_DONE() { + hwtimer3->pause(); + HAL_HWTIMER3_FUN = NULL; + } + + #define HAL_HWTIMER3_SET_PERIOD() WRITE_REG(STM32_TIMER3->ARR, _nextPeriod3) + void HAL_HWTIMER3_WRAPPER() { + TASKS_HWTIMER3_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep3 > 1) { count++; if (count%_nextRep3 != 0) goto done; } + if (_nextRep3) HAL_HWTIMER3_FUN(); + HAL_HWTIMER3_SET_PERIOD(); + done: {} + TASKS_HWTIMER3_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER4_ENABLE + HardwareTimer *hwtimer4 = new HardwareTimer(STM32_TIMER4); + + void (*HAL_HWTIMER4_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER4_WRAPPER(); // forward definition of the timer ISR + + bool HAL_HWTIMER4_INIT(uint8_t priority) { + return HAL_HWTIMER_INIT(priority, hwtimer4, HAL_HWTIMER4_WRAPPER); + } + + void HAL_HWTIMER4_DONE() { + hwtimer4->pause(); + HAL_HWTIMER4_FUN = NULL; + } + + #define HAL_HWTIMER4_SET_PERIOD() WRITE_REG(STM32_TIMER4->ARR, _nextPeriod4) + void HAL_HWTIMER4_WRAPPER() { + TASKS_HWTIMER4_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep4 > 1) { count++; if (count%_nextRep4 != 0) goto done; } + if (_nextRep4) HAL_HWTIMER4_FUN(); + HAL_HWTIMER4_SET_PERIOD(); + done: {} + TASKS_HWTIMER4_PROFILER_SUFFIX; + } +#endif diff --git a/src/lib/tasks/HAL_TEENSY_HWTIMER.h b/src/lib/tasks/HAL_TEENSY_HWTIMER.h new file mode 100755 index 0000000..31c6721 --- /dev/null +++ b/src/lib/tasks/HAL_TEENSY_HWTIMER.h @@ -0,0 +1,150 @@ +//-------------------------------------------------------------------------------------------------- +// Teensyduino hardware timers + +// provides four 32 bit pit timers with 16 bit software pre-scalers +// each timer configured as ~0 to x seconds (granularity of timer is 0.062uS) +// timer use doesn't collide with PWM or tone() on these platforms + +#define F_BUS2 16000000L // Pretend the timers are running at 0.062us/tick +#define TIMER_RATE_MHZ (F_BUS2/1000000.0) // Teensy PIT timers run at F_BUS Hz but we use the interval timer library +#define TIMER_RATE_16MHZ_TICKS (16.0/TIMER_RATE_MHZ) // 16.0/TIMER_RATE_MHZ for the default 16MHz "sub micros" + +#if defined(TASKS_HWTIMER1_ENABLE) || defined(TASKS_HWTIMER2_ENABLE) || defined(TASKS_HWTIMER3_ENABLE) || defined(TASKS_HWTIMER4_ENABLE) + // prepare hw timer for interval in sub-microseconds (1/16us) + volatile double _nextPeriod1 = 1000.0, _nextPeriod2 = 1000.0, _nextPeriod3 = 1000.0, _nextPeriod4 = 1000.0; + volatile uint16_t _nextRep1 = 0, _nextRep2 = 0, _nextRep3 = 0, _nextRep4 = 0; + const double timerRate16MHzTicks = TIMER_RATE_16MHZ_TICKS; + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { + double counts; + uint16_t reps = 0; + if (period != 0 && period <= 2144000000) { + if (period < 16) period = 16; // minimum time is 1us + double fperiod = period/timerRate16MHzTicks; + reps = fperiod/4194304.0 + 1.0; + counts = fperiod/reps/16.0; + } else counts = 1000.0; // set for a 1ms period, stopped + + noInterrupts(); + switch (num) { + case 1: _nextPeriod1 = counts; _nextRep1 = reps; break; + case 2: _nextPeriod2 = counts; _nextRep2 = reps; break; + case 3: _nextPeriod3 = counts; _nextRep3 = reps; break; + case 4: _nextPeriod4 = counts; _nextRep4 = reps; break; + } + interrupts(); + } +#else + void HAL_HWTIMER_PREPARE_PERIOD(uint8_t num, unsigned long period) { (void)(num); (void)(period); } +#endif + +#ifdef TASKS_HWTIMER1_ENABLE + IntervalTimer itimer1; + + void (*HAL_HWTIMER1_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER1_WRAPPER(); // forward definition of the timer ISR + + bool HAL_HWTIMER1_INIT(uint8_t priority) { + itimer1.priority(priority); + return itimer1.begin(HAL_HWTIMER1_WRAPPER, 1000); // startup one millisecond + } + + void HAL_HWTIMER1_DONE() { + HAL_HWTIMER1_FUN = NULL; + itimer1.end(); + } + + #define HAL_HWTIMER1_SET_PERIOD() itimer1.update(_nextPeriod1) + void HAL_HWTIMER1_WRAPPER() { + TASKS_HWTIMER1_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep1 > 1) { count++; if (count%_nextRep1 != 0) goto done; } + if (_nextRep1) HAL_HWTIMER1_FUN(); + HAL_HWTIMER1_SET_PERIOD(); + done: {} + TASKS_HWTIMER1_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER2_ENABLE + IntervalTimer itimer2; + + void (*HAL_HWTIMER2_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER2_WRAPPER(); // forward definition of the timer ISR + + bool HAL_HWTIMER2_INIT(uint8_t priority) { + itimer2.priority(priority); + return itimer2.begin(HAL_HWTIMER2_WRAPPER, 1000); // startup one millisecond + } + + void HAL_HWTIMER2_DONE() { + HAL_HWTIMER2_FUN = NULL; + itimer2.end(); + } + + #define HAL_HWTIMER2_SET_PERIOD() itimer2.update(_nextPeriod2) + void HAL_HWTIMER2_WRAPPER() { + TASKS_HWTIMER2_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep2 > 1) { count++; if (count%_nextRep2 != 0) goto done; } + if (_nextRep2) HAL_HWTIMER2_FUN(); + HAL_HWTIMER2_SET_PERIOD(); + done: {} + TASKS_HWTIMER2_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER3_ENABLE + IntervalTimer itimer3; + + void (*HAL_HWTIMER3_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER3_WRAPPER(); // forward definition of the timer ISR + + bool HAL_HWTIMER3_INIT(uint8_t priority) { + itimer3.priority(priority); + return itimer3.begin(HAL_HWTIMER3_WRAPPER, 1000); // startup one millisecond + } + + void HAL_HWTIMER3_DONE() { + HAL_HWTIMER3_FUN = NULL; + itimer3.end(); + } + + #define HAL_HWTIMER3_SET_PERIOD() itimer3.update(_nextPeriod3) + void HAL_HWTIMER3_WRAPPER() { + TASKS_HWTIMER3_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep3 > 1) { count++; if (count%_nextRep3 != 0) goto done; } + if (_nextRep3) HAL_HWTIMER3_FUN(); + HAL_HWTIMER3_SET_PERIOD(); + done: {} + TASKS_HWTIMER3_PROFILER_SUFFIX; + } +#endif + +#ifdef TASKS_HWTIMER4_ENABLE + IntervalTimer itimer4; + + void (*HAL_HWTIMER4_FUN)() = NULL; // points to task/process callback function + void HAL_HWTIMER4_WRAPPER(); // forward definition of the timer ISR + + bool HAL_HWTIMER4_INIT(uint8_t priority) { + itimer4.priority(priority); + return itimer4.begin(HAL_HWTIMER4_WRAPPER, 1000); // startup one millisecond + } + + void HAL_HWTIMER4_DONE() { + HAL_HWTIMER4_FUN = NULL; + itimer4.end(); + } + + #define HAL_HWTIMER4_SET_PERIOD() itimer4.update(_nextPeriod4) + void HAL_HWTIMER4_WRAPPER() { + TASKS_HWTIMER4_PROFILER_PREFIX; + static uint16_t count = 0; + if (_nextRep4 > 1) { count++; if (count%_nextRep4 != 0) goto done; } + if (_nextRep4) HAL_HWTIMER4_FUN(); + HAL_HWTIMER4_SET_PERIOD(); + done: {} + TASKS_HWTIMER4_PROFILER_SUFFIX; + } +#endif diff --git a/src/lib/tasks/OnTask.cpp b/src/lib/tasks/OnTask.cpp new file mode 100755 index 0000000..bf5ee1c --- /dev/null +++ b/src/lib/tasks/OnTask.cpp @@ -0,0 +1,660 @@ +/* + * Title OnTask + * by Howard Dutton + * + * Copyright (C) 2021 Howard Dutton + * www.stellarjourney.com + * + * 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 . + * +*/ + +// this line allows configuration of OnTask from the a given project, if this library is used stand-alone remove it +#include "../../Common.h" + +// Enabling the profiler inserts time logging code into the process calls. This provides the average +// and largest start time delta and run time for each process. To enable the profiler uncomment: +//#define TASKS_PROFILER_ENABLE + +// Normally tasks are skipped if they become too late, to instead delay them for later processing uncomment: +//#define TASKS_QUEUE_MISSED + +#include "OnTask.h" + +#include "HAL_PROFILER.h" +#include "HAL_HWTIMERS.h" + +#define roundPeriod(x) ((unsigned long)((x)+(double)0.5L)) + +unsigned char _task_postpone = false; +volatile unsigned long _task_ppsAverageSubMicros = 16000000UL; +double _task_masterFrequencyRatio = 1.0L; + +// Task object +Task::Task(uint32_t period, uint32_t duration, bool repeat, uint8_t priority, void (*callback)()) { + idle = period == 0; + this->period = period; + period_units = PU_MILLIS; + this->duration = duration; + this->repeat = repeat; + if (!repeat) immediate = false; + this->priority = priority; + this->callback = callback; + + start_time = millis(); + uint32_t spread_phase = 0; + if (repeat && period >= 4) { + uint32_t h = (uint32_t)(uintptr_t)callback ^ ((uint32_t)(uintptr_t)this >> 4) ^ start_time; + spread_phase = h % period; + } + next_task_time = start_time + spread_phase; + + strcpy(processName, ""); +} + +Task::~Task() { + switch (hardware_timer) { + case 1: HAL_HWTIMER1_DONE(); break; + case 2: HAL_HWTIMER2_DONE(); break; + case 3: HAL_HWTIMER3_DONE(); break; + case 4: HAL_HWTIMER4_DONE(); break; + } +} + +bool Task::requestHardwareTimer(uint8_t num, uint8_t hwPriority) { + if (num < 1 || num > 4) { DLF("ERR: Task::requestHardwareTimer(), timer number out of range"); return false; } + if (repeat != true) { DLF("ERR: Task::requestHardwareTimer(), repeat must be true"); return false; } + if (priority != 0) { DLF("ERR: Task::requestHardwareTimer(), s/w priority must be 0 (highest)"); return false; } + switch (num) { + case 1: + if (HAL_HWTIMER1_FUN != NULL) { DLF("ERR: Task::requestHardwareTimer(), channel1 already in use"); return false; } + break; + case 2: + if (HAL_HWTIMER2_FUN != NULL) { DLF("ERR: Task::requestHardwareTimer(), channel2 already in use"); return false; } + break; + case 3: + if (HAL_HWTIMER3_FUN != NULL) { DLF("ERR: Task::requestHardwareTimer(), channel3 already in use"); return false; } + break; + case 4: + if (HAL_HWTIMER4_FUN != NULL) { DLF("ERR: Task::requestHardwareTimer(), channel4 already in use"); return false; } + break; + } + + unsigned long hardware_timer_period = period; + if (period_units == PU_NONE) hardware_timer_period = 0; else + if (period_units == PU_MILLIS) hardware_timer_period *= 16000U; else + if (period_units == PU_MICROS) hardware_timer_period *= 16U; + + HAL_HWTIMER_PREPARE_PERIOD(num, roundPeriod((double)hardware_timer_period*_task_masterFrequencyRatio)); + + bool success = true; + switch (num) { + case 1: + HAL_HWTIMER1_FUN = callback; + if (!HAL_HWTIMER1_INIT(hwPriority)) { success = false; HAL_HWTIMER1_FUN = NULL; } + break; + case 2: + HAL_HWTIMER2_FUN = callback; + if (!HAL_HWTIMER2_INIT(hwPriority)) { success = false; HAL_HWTIMER2_FUN = NULL; } + break; + case 3: + HAL_HWTIMER3_FUN = callback; + if (!HAL_HWTIMER3_INIT(hwPriority)) { success = false; HAL_HWTIMER3_FUN = NULL; } + break; + case 4: + HAL_HWTIMER4_FUN = callback; + if (!HAL_HWTIMER4_INIT(hwPriority)) { success = false; HAL_HWTIMER4_FUN = NULL; } + break; + } + if (!success) { DF("ERR: Task::requestHardwareTimer(), HAL_HWTIMER"); D(num); DLF("_INIT() failed"); return false; } + hardware_timer = num; + + period = hardware_timer_period; + period_units = PU_SUB_MICROS; + next_period = period; + next_period_units = PU_NONE; + return true; +} + +void Task::setCallback(void (*callback)()) { + this->callback = callback; + noInterrupts(); + switch (hardware_timer) { + case 1: + HAL_HWTIMER1_FUN = callback; + break; + case 2: + HAL_HWTIMER2_FUN = callback; + break; + case 3: + HAL_HWTIMER3_FUN = callback; + break; + case 4: + HAL_HWTIMER4_FUN = callback; + break; + } + interrupts(); +} + +void Task::setTimingMode(TimingMode mode) { + timingMode = mode; +} + +bool Task::poll() { + if (hardware_timer || running) return false; + + if (period != 0) { + unsigned long t, time_to_next_task; + + if (period_units == PU_MICROS) t = micros(); else t = millis(); + if (immediate) { immediate = false; next_task_time = t; } + time_to_next_task = next_task_time - t; + + if ((long)time_to_next_task < 0) { + running = true; + + TASKS_PROFILER_PREFIX; + callback(); + TASKS_PROFILER_SUFFIX; + + running = false; + + if (_task_postpone) { _task_postpone = false; return false; } + + // set timing for guaranteed minimum (or gap) period + if (timingMode != TM_BALANCED) { + if (timingMode == TM_GAP) { + if (period_units == PU_MICROS) t = micros(); else t = millis(); + } + time_to_next_task = 0; + } + + // adopt next period + if (next_period_units != PU_NONE) { + time_to_next_task = 0; + period = roundPeriod((double)next_period*_task_masterFrequencyRatio); + period_units = next_period_units; + next_period_units = PU_NONE; + } + + // set adjusted period + #ifndef TASKS_QUEUE_MISSED + if ((long)(period + time_to_next_task) < 0) time_to_next_task = -period; + #endif + next_task_time = t + (long)(period + time_to_next_task); + if (!repeat) period = 0; + } + } else immediate = true; + + return false; +} + +void Task::refreshPeriod() { + if (hardware_timer) { + next_period_units = PU_SUB_MICROS; + setHardwareTimerPeriod(); + } +} + +void Task::setPeriod(unsigned long period, PeriodUnits units) { + if (hardware_timer) { + next_period = period; + next_period_units = units; + setHardwareTimerPeriod(); + } else { + if (units == PU_SUB_MICROS) { period = lroundf(period/16.0F); units = PU_MICROS; } + if (units == PU_MILLIS && period < 1000) { period *= 1000; units = PU_MICROS; } + if (this->period == 0) { + idle = true; + this->period = period; + period_units = units; + next_period_units = PU_NONE; + if (period_units == PU_MICROS) next_task_time = micros() + period; else next_task_time = millis() + period; + } else { + idle = false; + next_period = period; + next_period_units = units; + } + } +} + +void Task::setFrequency(float freq) { + if (freq > 0.0F) { + freq = 1.0F / freq; // seconds per call + float f = freq * 16000000.0F; // sub-micros per call + if (f <= 4294967295.0F) { + setPeriod(lroundf(f), PU_SUB_MICROS); + return; + } + f = freq * 1000000.0F; // micros per call + if (f <= 4294967295.0F) { + setPeriod(lroundf(f), PU_MICROS); + return; + } + f = freq * 1000.0F; // millis per call + if (f <= 4294967295.0F) { + setPeriod(lroundf(f)); + return; + } + } + setPeriod(0); +} + +void Task::setDuration(unsigned long duration) { + this->duration = duration; +} + +bool Task::isDurationComplete() { + return (duration > 0 && ((long)(millis() - (start_time + duration)) >= 0)); +} + +void Task::setDurationComplete() { + duration = 1; + start_time--; +} + +void Task::setRepeat(bool repeat) { + if (hardware_timer) return; + this->repeat = repeat; +} + +void Task::setPriority(uint8_t priority) { + if (hardware_timer) return; + this->priority = priority; +} + +uint8_t Task::getPriority() { + return priority; +} + +void Task::setNameStr(const char name[]) { + strncpy(processName, name, 7); + processName[7] = 0; +} + +char* Task::getNameStr() { + return processName; +} + +#ifdef TASKS_PROFILER_ENABLE +float Task::getArrivalAvg() { + if (hardware_timer) return 0; + if (average_arrival_time_count == 0) return 0; + float value = -average_arrival_time/average_arrival_time_count; + average_arrival_time = 0; + average_arrival_time_count = 0; + return value; +} +float Task::getArrivalMax() { + if (hardware_timer) return 0; + float value = max_arrival_time; + max_arrival_time = 0; + return value; +} +float Task::getRuntimeTotal() { + if (hardware_timer) { noInterrupts(); total_runtime = _task_total_runtime[hardware_timer-1]; _task_total_runtime[hardware_timer-1] = 0; total_runtime_count=_task_total_runtime_count[hardware_timer-1]; interrupts(); }; + float value = total_runtime; + if (value > 2147483647) value = 0.0; + total_runtime = 0; + return value; +} +long Task::getRuntimeTotalCount() { + if (hardware_timer) { noInterrupts(); total_runtime_count = _task_total_runtime_count[hardware_timer-1]; _task_total_runtime_count[hardware_timer-1] = 0; interrupts(); }; + long value = total_runtime_count; + total_runtime_count = 0; + return value; +} +float Task::getRuntimeMax() { + if (hardware_timer) { noInterrupts(); max_runtime = _task_max_runtime[hardware_timer-1]; _task_max_runtime[hardware_timer-1] = 0; interrupts(); }; + float value = max_runtime; + max_runtime = 0; + return value; +} +#endif + +void Task::setHardwareTimerPeriod() { + // adopt next period + if (next_period_units != PU_NONE) { + if (next_period_units == PU_MILLIS) next_period *= 16000UL; else if (next_period_units == PU_MICROS) next_period *= 16UL; + next_period_units = PU_NONE; + period_units = PU_SUB_MICROS; + + unsigned long lastPeriod = period; + + period = roundPeriod((double)next_period*_task_masterFrequencyRatio); + HAL_HWTIMER_PREPARE_PERIOD(hardware_timer, period); + + // if the current period is > 0.1 seconds and the new period < lastPeriod adopt the new rate immediately + if (lastPeriod > 1600000UL && period < lastPeriod) { + switch (hardware_timer) { + case 1: HAL_HWTIMER1_SET_PERIOD(); break; + case 2: HAL_HWTIMER2_SET_PERIOD(); break; + case 3: HAL_HWTIMER3_SET_PERIOD(); break; + case 4: HAL_HWTIMER4_SET_PERIOD(); break; + } + } + } +} + +void tasksMonitor() { + static unsigned long _lastPpsAverageSubMicros = 16000000UL; + if (_lastPpsAverageSubMicros != _task_ppsAverageSubMicros) { + _task_masterFrequencyRatio = (double)_task_ppsAverageSubMicros/16000000.0L; + + uint8_t handle = tasks.getFirstHandle(); + for (int i = 0; i < TASKS_MAX; i++) { + if (handle == 0) break; + tasks.refreshPeriod(handle); + handle = tasks.getNextHandle(handle); + } + + _lastPpsAverageSubMicros = _task_ppsAverageSubMicros; + } +} + +Tasks::Tasks() { + // clear tasks + for (uint8_t c = 0; c < TASKS_MAX; c++) { + task[c] = NULL; + allocated[c] = false; + } + + // start the task monitor + tasks.add(1000, 0, true, 7, tasksMonitor, "TaskMon"); +} + +Tasks::~Tasks() { + // find active tasks and remove + for (uint8_t c = 0; c < TASKS_MAX; c++) { + if (allocated[c]) delete task[c]; + } +} + +uint8_t Tasks::add(uint32_t period, uint32_t duration, bool repeat, uint8_t priority, void (*callback)()) { + // check priority + if (priority > 7) return false; + if (priority > highest_priority) highest_priority = priority; + + // find the next free task + int8_t e = -1; + for (uint8_t c = 0; c < TASKS_MAX; c++) { + if (!allocated[c]) { e = c; break; } + } + // no tasks available + if (e == -1) return false; + + // create the task handler + task[e] = new Task(period, duration, repeat, priority, callback); + if (task[e] != NULL) allocated[e] = true; else return false; + + updateEventRange(); + return e + 1; +} + +uint8_t Tasks::add(uint32_t period, uint32_t duration, bool repeat, uint8_t priority, void (*callback)(), const char name[]) { + uint8_t handle = add(period, duration, repeat, priority, callback); + setNameStr(handle, name); + return handle; +} + +bool Tasks::requestHardwareTimer(uint8_t handle) { + return requestHardwareTimer(handle, 128); +} + +bool Tasks::requestHardwareTimer(uint8_t handle, uint8_t hwPriority) { + if (handle != 0 && allocated[handle - 1] && TASKS_HWTIMERS > 0) { + for (int num = 0; num < TASKS_HWTIMERS; num++) { + if (!hardware_timer_allocated[num]) { + hardware_timer_allocated[num] = task[handle - 1]->requestHardwareTimer(num + 1, hwPriority); + return hardware_timer_allocated[num]; + } + } + } + return false; +} + +bool Tasks::setCallback(uint8_t handle, void (*callback)()) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setCallback(callback); + return true; + } else return false; +} + +bool Tasks::setTimingMode(uint8_t handle, TimingMode mode) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setTimingMode(mode); + return true; + } else return false; +} + +void Tasks::remove(uint8_t handle) { + if (handle != 0 && allocated[handle - 1]) { + uint8_t hw_timer_number = task[handle - 1]->hardware_timer; + if (hw_timer_number) hardware_timer_allocated[hw_timer_number - 1] = false; + delete task[handle - 1]; + allocated[handle - 1] = false; + updateEventRange(); + updatePriorityRange(); + } +} + +void Tasks::refreshPeriod(uint8_t handle) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->refreshPeriod(); + } +} + +void Tasks::setPeriod(uint8_t handle, unsigned long period) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setPeriod(period); + } +} + +void Tasks::setPeriodMicros(uint8_t handle, unsigned long period) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setPeriod(period, PU_MICROS); + } +} + +void Tasks::setPeriodSubMicros(uint8_t handle, unsigned long period) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setPeriod(period, PU_SUB_MICROS); + } +} + +void Tasks::setFrequency(uint8_t handle, double freq) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setFrequency(freq); + } +} + +IRAM_ATTR void Tasks::setPeriodRatioSubMicros(unsigned long value) { + _task_ppsAverageSubMicros = value; +} + +void Tasks::setDuration(uint8_t handle, unsigned long duration) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setDuration(duration); + } +} + +void Tasks::setDurationComplete(uint8_t handle) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setDurationComplete(); + } +} + +void Tasks::setRepeat(uint8_t handle, bool repeat) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setRepeat(repeat); + } +} + +void Tasks::setPriority(uint8_t handle, uint8_t priority) { + if (handle != 0 && allocated[handle - 1]) { + if (priority > 7) return; + task[handle - 1]->setPriority(priority); + updateEventRange(); + updatePriorityRange(); + } +} + +void Tasks::setNameStr(uint8_t handle, const char name[]) { + if (handle != 0 && allocated[handle - 1]) { + task[handle - 1]->setNameStr(name); + } +} + +char* Tasks::getNameStr(uint8_t handle) { + static char empty[1]; + strcpy(empty, ""); + if (handle != 0 && allocated[handle - 1]) { + return task[handle - 1]->getNameStr(); + } else return empty; +} + +uint8_t Tasks::getFirstHandle() { + return getNextHandle(0); +} + +uint8_t Tasks::getNextHandle(uint8_t handle) { + if (handle > highest_task) return 0; + do { + if (allocated[handle]) { + return handle + 1; + } + } while (++handle <= highest_task); + return 0; +} + +uint8_t Tasks::getHandleByName(const char name[]) { + char *candidate; + uint8_t handle = getFirstHandle(); + while (handle) { + candidate = getNameStr(handle); + if (strstr(candidate, name)) { + if (strlen(candidate) == strlen(name)) break; + } + handle = getNextHandle(handle); + } + + return handle; +} + +#ifdef TASKS_PROFILER_ENABLE + double Tasks::getArrivalAvg(uint8_t handle) { + if (handle != 0 && allocated[handle - 1]) { + return task[handle - 1]->getArrivalAvg(); + } else return 0; + } + double Tasks::getArrivalMax(uint8_t handle) { + if (handle != 0 && allocated[handle - 1]) { + return task[handle - 1]->getArrivalMax(); + } else return 0; + } + double Tasks::getRuntimeTotal(uint8_t handle) { + if (handle != 0 && allocated[handle - 1]) { + return task[handle - 1]->getRuntimeTotal(); + } else return 0; + } + long Tasks::getRuntimeTotalCount(uint8_t handle) { + if (handle != 0 && allocated[handle - 1]) { + return task[handle - 1]->getRuntimeTotalCount(); + } else return 0; + } + double Tasks::getRuntimeMax(uint8_t handle) { + if (handle != 0 && allocated[handle - 1]) { + return task[handle - 1]->getRuntimeMax(); + } else return 0; + } +#endif + +void Tasks::yield() { + static uint8_t highest_priority_active = 8; + ::yield(); + for (uint8_t priority = 0; priority <= highest_priority; priority++) { + uint8_t last_priority = highest_priority_active; + if (priority < highest_priority_active) { + highest_priority_active = priority; + for (uint8_t i = 0; i <= highest_task; i++) { + if (++number[priority] > highest_task) number[priority] = 0; + if (allocated[number[priority]]) { + if (task[number[priority]]->getPriority() == priority) { + if (task[number[priority]]->isDurationComplete()) { remove(number[priority] + 1); highest_priority_active = last_priority; return; } + if (task[number[priority]]->poll()) { highest_priority_active = last_priority; return; } + } + } + } + highest_priority_active = last_priority; + } + } +} + +void Tasks::yield(unsigned long milliseconds) { + unsigned long endTime = millis() + milliseconds; + while ((long)(millis() - endTime) < 0) this->yield(); +} + +void Tasks::yieldMicros(unsigned long microseconds) { + unsigned long endTime = micros() + microseconds; + while ((long)(micros() - endTime) < 0) this->yield(); +} + +void Tasks::yieldAll() { + for (uint8_t priority = 0; priority <= highest_priority; priority++) { + for (uint8_t i = 0; i <= highest_task; i++) { + if (++number[priority] > highest_task) number[priority] = 0; + if (allocated[number[priority]]) { + if (task[number[priority]]->getPriority() == priority) { + if (task[number[priority]]->isDurationComplete()) { remove(number[priority] + 1); return; } + if (task[number[priority]]->poll()) return; + } + } + } + } +} + +void Tasks::yieldAll(unsigned long milliseconds) { + unsigned long endTime = millis() + milliseconds; + while ((long)(millis() - endTime) < 0) this->yieldAll(); +} + +void Tasks::yieldAllMicros(unsigned long microseconds) { + unsigned long endTime = micros() + microseconds; + while ((long)(micros() - endTime) < 0) this->yieldAll(); +} + +void Tasks::updatePriorityRange() { + // scan for highest priority + highest_priority = 0; + for (uint8_t e = 0; e <= highest_task; e++) { + if (allocated[e]) { + uint8_t p = task[e]->getPriority(); + if (p > highest_priority) highest_priority = p; + } + } +} + +void Tasks::updateEventRange() { + // scan for highest task handle + highest_task = 0; + for (int8_t e = TASKS_MAX - 1; e >= 0 ; e--) { + if (allocated[e]) { + highest_task = e; + break; + } + } +} + +Tasks tasks; diff --git a/src/lib/tasks/OnTask.h b/src/lib/tasks/OnTask.h new file mode 100755 index 0000000..cc48305 --- /dev/null +++ b/src/lib/tasks/OnTask.h @@ -0,0 +1,380 @@ +/* + * Title OnTask + * by Howard Dutton + * + * Copyright (C) 2021 Howard Dutton + * www.stellarjourney.com + * + * 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 . + * + * + * DESCRIPTION: + * + * Software timer based processes must use "tasks.yield();" (or the "Y;" macro, which is the same exact thing) + * during any processing that requires a significant amount of time. This allows for the processing of other tasks + * while it is working. What a "significant amount of time" is depends on the program's requirements. It might + * be measured in micro-seconds, or milli-seconds, or seconds. Yield should not be used for hardware timer based + * processes + * +*/ + +#pragma once +#include + +#ifndef IRAM_ATTR + #define IRAM_ATTR +#endif + +// To enable the option to use a given hardware timer (1..4), if available, uncomment that line: +#ifndef TASKS_HWTIMERS + #define TASKS_HWTIMERS -1 +#endif +#if TASKS_HWTIMERS < -1 || TASKS_HWTIMERS > 4 + #error "OnTask: TASKS_HWTIMERS must be OFF, or 1 to 4." +#endif +#if TASKS_HWTIMERS >= 1 + #define TASKS_HWTIMER1_ENABLE +#endif +#if TASKS_HWTIMERS >= 2 + #define TASKS_HWTIMER2_ENABLE +#endif +#if TASKS_HWTIMERS >= 3 + #define TASKS_HWTIMER3_ENABLE +#endif +#if TASKS_HWTIMERS == 4 + #define TASKS_HWTIMER4_ENABLE +#endif + +// default provision is for 8 tasks, up to 255 are allowed, to change use: +// #define TASKS_MAX 200 (for example) +#ifndef TASKS_MAX + #define TASKS_MAX 8 +#endif + +// ESP32 override cli/sei and use muxes to block the h/w timer ISR's instead +#ifdef ESP32 + // on the ESP32 noInterrupts()/interrupts() are #defined to be cli()/sei() + // cli()/sei() are empty and do nothing, below we use them for our purposes + // to the block execution of all four timer interrupts + extern portMUX_TYPE timerMux; + #undef cli + // disable hardware timer based tasks by FreeRTOS mux + #define cli() portENTER_CRITICAL(&timerMux) + #undef sei + // enable hardware timer based tasks by FreeRTOS mux + #define sei() portEXIT_CRITICAL(&timerMux) + // disable hardware timer based tasks by clearing interrupt flag(s) + extern void timerAlarmsDisable(); + // enable hardware timer based tasks by setting interrupt flag(s) + extern void timerAlarmsEnable(); +#endif + +// runs tasks at their prescribed interval +// \note allows only higher priority tasks to run +// \note each call can trigger running at most a single process +#define Y tasks.yield() + +// short macro to allow momentary postponement of the current task +extern unsigned char __task_postpone; +// postpone currently executing task (scheduler picks task up ASAP again on exit) +#define task_postpone() __task_postpone = true; + +enum PeriodUnits: uint8_t {PU_NONE, PU_MILLIS, PU_MICROS, PU_SUB_MICROS}; + +// Timing modes +// TM_BALANCED (default) to maintain the specified frequency/period where a task that runs late is next run early to compensate +// TM_MINIMUM to run the task at an interval not less than the specified frequency/period from task start to next start +// TM_GAP to run the task at an interval not less than the specified frequency/period from task exit to next start +enum TimingMode: uint8_t {TM_BALANCED, TM_MINIMUM, TM_GAP}; + +class Task { + public: + Task(uint32_t period, uint32_t duration, bool repeat, uint8_t priority, void (*callback)()); + ~Task(); + + bool requestHardwareTimer(uint8_t num, uint8_t hwPriority); + uint8_t hardware_timer = 0; + + void setCallback(void (*callback)()); + + void setTimingMode(TimingMode mode); + + // run task at the prescribed interval + // note: tasks are timed in such a way as to achieve an accurate average frequency, if + // the task occurs late the next call is scheduled earlier to make up the difference + bool poll(); + + void refreshPeriod(); + void setPeriod(unsigned long period, PeriodUnits units = PU_MILLIS); + void setFrequency(float freq); + + void setDuration(unsigned long duration); + bool isDurationComplete(); + void setDurationComplete(); + + void setRepeat(bool repeat); + + void setPriority(uint8_t priority); + uint8_t getPriority(); + + void setNameStr(const char name[]); + char *getNameStr(); + + #ifdef TASKS_PROFILER_ENABLE + float getArrivalAvg(); + float getArrivalMax(); + float getRuntimeTotal(); + long getRuntimeTotalCount(); + float getRuntimeMax(); + #endif + + volatile bool immediate = true; + + private: + + void setHardwareTimerPeriod(); + + char processName[8]; + unsigned long period = 0; + unsigned long next_period = 0; + unsigned long duration = 0; + bool repeat = false; + uint8_t priority = 0; + bool idle = true; + bool running = false; + PeriodUnits period_units = PU_MILLIS; + PeriodUnits next_period_units = PU_NONE; + unsigned long start_time = 0; + unsigned long last_task_time = 0; + unsigned long next_task_time = 0; + TimingMode timingMode = TM_BALANCED; + void (*volatile callback)() = NULL; + + #ifdef TASKS_PROFILER_ENABLE + volatile double average_arrival_time = 0; + volatile unsigned long average_arrival_time_count = 0; + volatile long max_arrival_time = 0; + volatile double total_runtime = 0; + volatile unsigned long total_runtime_count = 0; + volatile long max_runtime = 0; + #endif +}; + +class Tasks { + public: + Tasks(); + ~Tasks(); + + // add process task + // \param period between process calls in milliseconds, use 0 to disable + // software timers are limited to <= 49 days, hardware timers are limited to <= 139 seconds + // \param duration in milliseconds the task is valid for, use 0 for unlimited (deletes the task on completion) + // \param repeat true if the task is allowed to repeat, false to run once (sets period to 0 on completion) + // \param priority software level highest 0 to 7 lowest. hardware tasks are always higher priority than software tasks + // for software timed tasks level 0 must be complete before level 1 are serviced, etc. + // tasks run round robin in ea priority level, the most recently serviced task will be the last visited again + // only higher priority tasks are allowed to run when a lower priority task yields + // \param callback function to handle this tasks processing + // \return handle to the task on success, or 0 on failure + uint8_t add(uint32_t period, uint32_t duration, bool repeat, uint8_t priority, void (*callback)()); + + // add process task + // \param period between process calls in milliseconds, use 0 to disable + // software timers are limited to <= 49 days, hardware timers are limited to <= 139 seconds + // \param duration in milliseconds the task is valid for, use 0 for unlimited (deletes the task on completion) + // \param repeat true if the task is allowed to repeat, false to run once (sets period to 0 on completion) + // \param priority software level highest 0 to 7 lowest. hardware tasks are always higher priority than software tasks + // for software timed tasks level 0 must be complete before level 1 are serviced, etc. + // tasks run round robin in ea priority level, the most recently serviced task will be the last visited again + // only higher priority tasks are allowed to run when a lower priority task yields + // \param callback function to handle this tasks processing + // \param name an optional short (max length 7) char str describing the task + // \return handle to the task on success, or 0 on failure + uint8_t add(uint32_t period, uint32_t duration, bool repeat, uint8_t priority, void (*callback)(), const char name[]); + + // allocates a hardware timer, if available, for this task. Note: for the associated task: *repeat* must be true, + // *priority* must be 0 (all are higher than s/w task priority 0.) + // \param handle task handle + // \param hwPriority optional hardware interrupt priority, default is 128 if not specified + // \return true if successful, or false (in which case the standard polling timer will still be available) + bool requestHardwareTimer(uint8_t handle, uint8_t hwPriority); + bool requestHardwareTimer(uint8_t handle); + + // change task callback + // \param handle task handle + // \param callback function to handle this tasks processing + // \return true if successful, or false if unable to find the associated task + bool setCallback(uint8_t handle, void (*callback)()); + + // change task timing mode + // \param handle task handle + // \param mode either TM_BALANCED (default) or TM_MINIMUM + // \return true if successful, or false if unable to find the associated task + bool setTimingMode(uint8_t handle, TimingMode mode); + + // remove process task. Note: do not remove a task if the task process is running + // \param handle task handle + // \return nothing + void remove(uint8_t handle); + + // refresh process period, causes setPeriodRatioSubMicros() ratio to be recognized by hardware timers + // handle: task handle + void refreshPeriod(uint8_t handle); + + // set process period ms. Note: the period/frequency change takes effect on the next task cycle, + // if the period is > the hardware timers maximum period the task is disabled + // \param handle task handle + // \param period in milliseconds, use 0 for disabled + // \return nothing + void setPeriod(uint8_t handle, unsigned long period); + + // set process period us + // \param handle: task handle + // \param period: in milliseconds, use 0 for disabled + // \return nothing + // \note the period/frequency change takes effect on the next task cycle + // \note if the period is > the hardware timers maximum period the task is disabled + void setPeriodMicros(uint8_t handle, unsigned long period); + + // set process period sub-us + // \param handle: task handle + // \param period: in sub-microseconds (1/16 microsecond units), use 0 for disabled + // \return nothing + // \note the period/frequency change takes effect on the next task cycle + // \note if the period is > the hardware timers maximum period the task is disabled + void setPeriodSubMicros(uint8_t handle, unsigned long period); + + // change process period Hz + // \param handle: task handle + // \param freq: in Hertz, use 0 for disabled + // \return nothing + // \note the period/frequency change takes effect on the next task cycle + // \note when setting a frequency the most appropriate setPeriod is used automatically + // \note if the period is > ~49 days (or > the hardware timers maximum period) the task is disabled + void setFrequency(uint8_t handle, double freq); + + // set the period ratio to compensate for MCU clock inaccuracy + // \param value: in submicros per second (default 16000000) + // \note values above 16M cause the timers to compensate by running slower + // \note values below 16M cause the timers to compensate by running faster + void setPeriodRatioSubMicros(unsigned long value); + + // set process to run immediately on the next pass (within its priority level) + // \param handle: task handle + IRAM_ATTR inline void immediate(uint8_t handle) { if (handle != 0 && allocated[handle - 1]) { task[handle - 1]->immediate = true; } } + + // change process duration + // \param handle: task handle + // \param duration: in milliseconds use 0 to disable + void setDuration(uint8_t handle, unsigned long duration); + + // late removal of process task + // \param handle: task handle + // \param note removes a task process, even if it is running + void setDurationComplete(uint8_t handle); + + // change process repeat + // \param handle: task handle + // \param repeat: true to repeat indefinately + void setRepeat(uint8_t handle, bool repeat); + + // change process priority level + // \param handle: task handle + // \param priority: highest 0 to 7 lowest + void setPriority(uint8_t handle, uint8_t priority); + + // gets process priority level, highest 0 to 7 lowest or -1 on failure + // \param handle: task handle + inline int getPriority(uint8_t handle) { if (handle != 0 && allocated[handle - 1]) { return task[handle - 1]->getPriority(); } else return -1; } + + // set the process name + // \param handle: task handle + // \param name: up to 7 chars + void setNameStr(uint8_t handle, const char name[]); + + // get the process name + // \param handle: task handle + char *getNameStr(uint8_t handle); + + // get first task, returns handle or 0 if no tasks are found + uint8_t getFirstHandle(); + + // get next task, returns handle or 0 if no tasks are found + uint8_t getNextHandle(uint8_t handle); + + // search for task by name, returns handle or 0 if not found + // \param name: up to 7 chars + uint8_t getHandleByName(const char name[]); + + #ifdef TASKS_PROFILER_ENABLE + double getArrivalAvg(uint8_t handle); + double getArrivalMax(uint8_t handle); + double getRuntimeTotal(uint8_t handle); + long getRuntimeTotalCount(uint8_t handle); + double getRuntimeMax(uint8_t handle); + #endif + + // runs higher priority tasks at their prescribed interval + // \note processes that are already running are ignored so it's ok to yield() within a process + // \note processes assigned to hardware timers run outside this mechanism + // \note each call can trigger running at most a single process + void yield(); + + // runs higher priority tasks at their prescribed interval + // \param milliseconds: time to repeatedly run any tasks that need servicing + // \note processes that are already running are ignored so it's ok to yield() within a process + // \note processes assigned to hardware timers run outside this mechanism + void yield(unsigned long milliseconds); + + // runs higher priority tasks at their prescribed interval + // \param microseconds: time to repeatedly run any tasks that need servicing + // \note processes that are already running are ignored so it's ok to yield() within a process + // \note processes assigned to hardware timers run outside this mechanism + void yieldMicros(unsigned long microseconds); + + // runs all other tasks at their prescribed interval + // \note processes that are already running are ignored so it's ok to yield() within a process + // \note processes assigned to hardware timers run outside this mechanism + // \note each call can trigger running at most a single process + void yieldAll(); + + // runs all other tasks at their prescribed interval + // \param milliseconds: time to repeatedly run any tasks that need servicing + // \note processes that are already running are ignored so it's ok to yield() within a process + // \note processes assigned to hardware timers run outside this mechanism + void yieldAll(unsigned long milliseconds); + + // runs all other tasks at their prescribed interval + // \param microseconds: time to repeatedly run any tasks that need servicing + // \note processes that are already running are ignored so it's ok to yield() within a process + // \note processes assigned to hardware timers run outside this mechanism + void yieldAllMicros(unsigned long microseconds); + + private: + // keep track of the range of priorities so we don't waste cycles looking at empty ones + void updatePriorityRange(); + // keep track of the range of tasks so we don't waste cycles looking at empty ones + void updateEventRange(); + + uint8_t highest_task = 0; // the highest task# assigned + uint8_t highest_priority = 0; // the highest task priority + uint8_t count = 0; + uint8_t num_tasks = 0; // the total number of tasks + uint8_t number[8] = {255, 255, 255, 255, 255, 255, 255, 255}; // the task# we are servicing at this priority level + bool allocated[TASKS_MAX]; + bool hardware_timer_allocated[4] = {false, false, false, false}; + Task *task[TASKS_MAX]; +}; + +extern Tasks tasks; diff --git a/src/lib/tasks/OnTaskExample.ino.txt b/src/lib/tasks/OnTaskExample.ino.txt new file mode 100755 index 0000000..e1973ae --- /dev/null +++ b/src/lib/tasks/OnTaskExample.ino.txt @@ -0,0 +1,189 @@ +/* + * Title OnTask + * by Howard Dutton + * + * Copyright (C) 2021 Howard Dutton + * + * 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 . + * + * + * Author: Howard Dutton + * http://www.stellarjourney.com + * hjd1964@gmail.com + * + */ + +// ----------------------------------------------------------------------------------- +// some constants +#define OFF 0 +#define ON 1 + +// ----------------------------------------------------------------------------------- +// configure settings in this section to experiment, enable/disable the various tasks + +#define SERIAL_BAUD 115200 + +// feature name ON/OFF state +#define CLOCK_TICK ON +#define CLOCK_EXTRA_NOTHING ON +#define SHOW_CLOCK_EVERY_SEC OFF +#define SHOW_MESSAGE_FOUR_TIMES ON +#define SHOW_MESSAGE_10SEC ON +#define SHOW_MESSAGE_HALFSEC_FOR_4SEC ON +#define PROFILER_VT100 ON +#define SHOW_TASKS_PROFILER_EVERY_SEC ON + +// uncomment the line below to enable using an hardware timer for the CLOCK_TICK +#define TASKS_HWTIMER1_ENABLE + +// ----------------------------------------------------------------------------------- + +#if SHOW_TASKS_PROFILER_EVERY_SEC == ON + #define TASKS_PROFILER_ENABLE +#endif + +#include "OnTask.h" + +#if SHOW_TASKS_PROFILER_EVERY_SEC == ON + #include "profiler.h" +#endif + +// handles to keep track of tasks +int clockCountHandle=0; +int fourTimesHandle =0; +int profilerHandle =0; + +void setup() { + Serial.begin(SERIAL_BAUD); + Serial1.begin(SERIAL_BAUD); + + Serial.println(); + Serial.println("Creating tasks..."); + Serial.println(); + + // this helps show what the parameters are: + // handle = tasks.add(period_ms, duration_ms, repeat_true_or_false, priority_0to7, callback_function); + // success = tasks.requestHardwareTimer(handle, hardware_timer_number_1to4, hardware_timer_priority_0to255); + + // create an task, the callback function "clockCount" is the process for this handler +#if CLOCK_TICK == ON + clockCountHandle = tasks.add(1, 0, true, 0, clockCount, "ClkCnt"); + Serial.print("ClockCount running every millisecond"); + // move this task to a hardware timer + bool success = tasks.requestHardwareTimer(clockCountHandle,1); + if (success) Serial.println(" on HardwareTimer1"); else Serial.println(); +#endif + + // create/start another task to throw some extra work at the task manager +#if CLOCK_EXTRA_NOTHING == ON + tasks.add(1, 0, true, 0, clockExtraNothing, "EtraNth"); +#endif + + // create/start another task to show the clock at 1 second intervals +#if SHOW_CLOCK_EVERY_SEC == ON + tasks.add(1000, 0, true, 2, showClock, "ShowClk"); + Serial.println("ShowClock: running every second"); +#endif + + // start another task with a period of 1 second which it then adds 2 seconds to each time it runs (before it stops itself) +#if SHOW_MESSAGE_FOUR_TIMES == ON + fourTimesHandle=tasks.add(1000, 0, true, 2, fourTimes, "FourTms"); + Serial.println("FourTimes: running every 1,2,4,6 seconds"); +#endif + + // create/start another task with a period of 10 seconds +#if SHOW_MESSAGE_10SEC == ON + tasks.add(10000, 0, true, 4, longCalc, "LngCalc"); + Serial.println("TenSec: running every 10 seconds"); +#endif + + // create/start another task with a period of 0.5 seconds and a duration of 4 seconds +#if SHOW_MESSAGE_HALFSEC_FOR_4SEC == ON + tasks.add(2000, 4000, true, 3, twoSec, "TwoSecs"); + Serial.println("TwoSec: running every 2 seconds, for 4 seconds"); + Serial.println(); +#endif + + // create/start a task to show the profiler at work +#if SHOW_TASKS_PROFILER_EVERY_SEC == ON + profilerHandle = tasks.add(250, 0, true, 2, profiler, "Profilr"); + Serial.println("Profiler: running every second"); + Serial.println(); +#endif +} + +void loop() { + tasks.yield(); +} + +// ----------------------------------------------------------------------------------- +// task processes + +// runs 1000 times a second in a hardware timer, if available, for a millisecond clock +volatile long cs=0; +void clockCount() { + cs++; +} + +// runs 1000 times a second in the task scheduler, to waste some time +void clockExtraNothing() { + noInterrupts(); + cs++; + cs--; + interrupts(); +} + +// show the clock time +void showClock() { + // Y macros allow any higher priority processes to run + Serial.print("[ShowClock ] timer vs. millis() = "); Y; + noInterrupts(); + long centiSec = cs; + interrupts(); + Serial.print((long)(millis()-centiSec)); Y; + Serial.println(" ms"); +} + +// show a long process working in the background +void longCalc() { + Serial.println("[LongCalc ] started (sending progress to Serial1)"); + for (long j=0; j<100; j++) { + for (long i=0; i<300; i++) { + delayMicroseconds(50); Y; // burn some time + } + Serial1.print("."); + } + Serial1.println(); Y; + Serial.println("[LongCalc ] done"); +} + +// run four times then stop, first at 1 seconds, then 2 seconds, etc. +void fourTimes() { + static int period = 0; + if (period <= 4000) { + period += 2000; + tasks.setPeriod(fourTimesHandle,period); + Serial.print("[FourTimes ] next pass in "); Y; + Serial.print(period); Y; + Serial.println(" ms"); + } else { + tasks.setPeriod(fourTimesHandle,0); + Serial.println("[FourTimes ] done"); + } +} + +// run four times then stop, first at 1 seconds, then 2 seconds, etc. +void twoSec() { + Serial.println("[TwoSec ] ran"); Y; +} diff --git a/src/lib/tls/PPS.cpp b/src/lib/tls/PPS.cpp new file mode 100755 index 0000000..b73efe0 --- /dev/null +++ b/src/lib/tls/PPS.cpp @@ -0,0 +1,38 @@ +// ----------------------------------------------------------------------------------- +// Pulse Per Second precision timer skew + +#include "PPS.h" + +#if defined(TIME_LOCATION_PPS_SENSE) && (TIME_LOCATION_PPS_SENSE) != OFF + +#include "../tasks/OnTask.h" + +void ppsIsr() { + unsigned long t = micros(); + unsigned long oneSecond = t - pps.lastMicros; + if (oneSecond > 1000000UL - PPS_WINDOW_MICROS && oneSecond < 1000000UL + PPS_WINDOW_MICROS) { + pps.averageSubMicros = (pps.averageSubMicros*(PPS_SECS_TO_AVERAGE - 1) + (oneSecond*16))/PPS_SECS_TO_AVERAGE; + pps.synced = true; + tasks.setPeriodRatioSubMicros((long)pps.averageSubMicros + pps.averageSubMicrosSkew); + } else { + pps.synced = false; + tasks.setPeriodRatioSubMicros(16000000UL); + } + pps.lastMicros = t; +} + +void Pps::init() { + VLF("MSG: PPS, attaching ISR to sense input"); + pinMode(PPS_SENSE_PIN, INPUT_PULLUP); + #if (TIME_LOCATION_PPS_SENSE) == HIGH + attachInterrupt(digitalPinToInterrupt(PPS_SENSE_PIN), ppsIsr, RISING); + #elif (TIME_LOCATION_PPS_SENSE) == LOW + attachInterrupt(digitalPinToInterrupt(PPS_SENSE_PIN), ppsIsr, FALLING); + #elif (TIME_LOCATION_PPS_SENSE) == BOTH + attachInterrupt(digitalPinToInterrupt(PPS_SENSE_PIN), ppsIsr, CHANGE); + #endif +} + +Pps pps; + +#endif diff --git a/src/lib/tls/PPS.h b/src/lib/tls/PPS.h new file mode 100755 index 0000000..ffe8515 --- /dev/null +++ b/src/lib/tls/PPS.h @@ -0,0 +1,30 @@ +// handle PPS interrupt +#pragma once + +#include "../../Common.h" + +#if defined(TIME_LOCATION_PPS_SENSE) && (TIME_LOCATION_PPS_SENSE) != OFF + +#define PPS_SECS_TO_AVERAGE 40 // running average of 40 samples (1 per second) +#define PPS_WINDOW_MICROS 20000 // +/- window in microseconds to meet synced criteria (2%) + +#if !defined(PPS_SENSE_PIN) || PPS_SENSE_PIN == OFF + #error "Configuration (Config.h): PPS_SENSE_PIN must be defined for TIME_LOCATION_PPS_SENSE ON" +#endif + +class Pps { + public: + // attach interrupt and start PPS + void init(); + + volatile bool synced = false; + + volatile unsigned long averageSubMicros = 16000000UL; + long averageSubMicrosSkew = 0; + volatile unsigned long lastMicros = 0UL; + private: +}; + +extern Pps pps; + +#endif diff --git a/src/lib/tls/Tls.h b/src/lib/tls/Tls.h new file mode 100755 index 0000000..e21efe4 --- /dev/null +++ b/src/lib/tls/Tls.h @@ -0,0 +1,13 @@ + +// ----------------------------------------------------------------------------------- +// Time/Location source +#pragma once + +#include "ds3231/DS3231.h" +#include "ds3234/DS3234.h" +#include "gps/GPS.h" +#include "ntp/NTP.h" +#include "sd3031/SD3031.h" +#include "teensy/Teensy.h" + +#include "PPS.h" diff --git a/src/lib/tls/TlsBase.cpp b/src/lib/tls/TlsBase.cpp new file mode 100755 index 0000000..96a93d5 --- /dev/null +++ b/src/lib/tls/TlsBase.cpp @@ -0,0 +1,2 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source diff --git a/src/lib/tls/TlsBase.h b/src/lib/tls/TlsBase.h new file mode 100755 index 0000000..da47de4 --- /dev/null +++ b/src/lib/tls/TlsBase.h @@ -0,0 +1,45 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source +#pragma once + +#include "../../Common.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE != OFF + +#include "../calendars/Calendars.h" + +class TimeLocationSource { + public: + // initialize (also enables the RTC PPS if available) + virtual bool init(); + + // restart the device + virtual void restart() {} + + // true if date/time ready + inline bool isReady() { return ready; } + + // set the RTC's time + virtual void set(JulianDate ut1); + virtual void set(int year, int month, int day, int hour, int minute, int second); + + // get the RTC's time, returns true if current + virtual bool get(JulianDate &ut1); + + // get the location + virtual void getSite(double &latitude, double &longitude, float &elevation) { UNUSED(latitude); UNUSED(longitude); UNUSED(elevation); } + + // secondary way to enable PPS + virtual void ppsEnable() {} + + // update from GPS or NTP + virtual void poll() {} + + // not used, date/time is stored as UT1 + double DUT1 = 0.0L; + + protected: + bool ready = false; +}; + +#endif diff --git a/src/lib/tls/ds3231/DS3231.cpp b/src/lib/tls/ds3231/DS3231.cpp new file mode 100755 index 0000000..55e02cb --- /dev/null +++ b/src/lib/tls/ds3231/DS3231.cpp @@ -0,0 +1,111 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source DS3231 RTC support +// uses the default I2C port in most cases; though HAL_WIRE can redirect to another port (as is done for the Teensy3.5/3.6) + +#include "DS3231.h" + +#if (defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == DS3231) || \ + (defined(TIME_LOCATION_SOURCE_FALLBACK) && TIME_LOCATION_SOURCE_FALLBACK == DS3231) + +#ifdef TLS_TIMELIB + #include // https://github.com/PaulStoffregen/Time/archive/master.zip +#endif + +#include // https://github.com/Makuna/Rtc/archive/master.zip +RtcDS3231 rtcDS3231(HAL_WIRE); + +#include "../PPS.h" + +bool TlsDs3231::init() { + HAL_WIRE.begin(); + HAL_WIRE_SET_CLOCK(); + + HAL_WIRE.beginTransmission(0x68); + bool error = HAL_WIRE.endTransmission() != 0; + if (!error) { + rtcDS3231.Begin(); + HAL_WIRE_SET_CLOCK(); + + if (!rtcDS3231.GetIsRunning()) rtcDS3231.SetIsRunning(true); + + // see if the RTC is present + if (rtcDS3231.GetIsRunning()) { + #if TIME_LOCATION_SOURCE == DS3231 + ppsEnable(); + #endif + + #ifdef TLS_TIMELIB + RtcDateTime now = rtcDS3231.GetDateTime(); + setTime(now.Hour(), now.Minute(), now.Second(), now.Day(), now.Month(), now.Year()); + #endif + + ready = true; + } else { DLF("WRN: tls.init(), DS3231 GetIsRunning() false"); } + } else { DLF("WRN: tls.init(), DS3231 (I2C 0x68) not found"); } + #ifdef HAL_WIRE_RESET_AFTER_CONNECT + HAL_WIRE.end(); + HAL_WIRE.begin(); + HAL_WIRE_SET_CLOCK(); + #endif + return ready; +} + +void TlsDs3231::set(JulianDate ut1) { + if (!ready) return; + + GregorianDate greg = calendars.julianDayToGregorian(ut1); + + double f1 = fabs(ut1.hour) + TLS_CLOCK_SKEW; + int h = floor(f1); + double m = (f1 - h)*60.0; + double s = (m - floor(m))*60.0; + + set(greg.year, greg.month, greg.day, h, floor(m), floor(s)); +} + +void TlsDs3231::set(int year, int month, int day, int hour, int minute, int second) { + #ifdef TLS_TIMELIB + setTime(hour, minute, second, day, month, year); + #endif + RtcDateTime updateTime = RtcDateTime(year, month, day, hour, minute, second); + rtcDS3231.SetDateTime(updateTime); +} + +bool TlsDs3231::get(JulianDate &ut1) { + if (!ready) return false; + + unsigned long t = 0.5; + #if defined(TIME_LOCATION_PPS_SENSE) && (TIME_LOCATION_PPS_SENSE) != OFF + // wait until we're roughly in the middle of a second + if (pps.synced) { + do { t = micros() - pps.lastMicros; } while (t < 400000 || t > 600000); + } + #endif + + GregorianDate greg; + RtcDateTime now = rtcDS3231.GetDateTime(); + if (now.Year() >= 2018 && now.Year() <= 3000 && now.Month() >= 1 && now.Month() <= 12 && now.Day() >= 1 && now.Day() <= 31 && + now.Hour() <= 23 && now.Minute() <= 59 && now.Second() <= 59) { + greg.year = now.Year(); + greg.month = now.Month(); + greg.day = now.Day(); + ut1 = calendars.gregorianToJulianDay(greg); + ut1.hour = now.Hour() + now.Minute()/60.0 + (now.Second() + t/1000000.0)/3600.0; + } else { + greg.year = 2000; + greg.month = 1; + greg.day = 1; + ut1 = calendars.gregorianToJulianDay(greg); + ut1.hour = 0.0; + } + + return true; +} + +void TlsDs3231::ppsEnable() { + // frequency 0 (1Hz) on the SQW pin + rtcDS3231.SetSquareWavePin(DS3231SquareWavePin_ModeClock); + rtcDS3231.SetSquareWavePinClockFrequency(DS3231SquareWaveClock_1Hz); +} + +#endif diff --git a/src/lib/tls/ds3231/DS3231.h b/src/lib/tls/ds3231/DS3231.h new file mode 100755 index 0000000..dc4b430 --- /dev/null +++ b/src/lib/tls/ds3231/DS3231.h @@ -0,0 +1,36 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source DS3231 RTC support +// uses the default I2C port in most cases; though HAL_WIRE can redirect to another port (as is done for the Teensy3.5/3.6) +#pragma once + +#include "../TlsBase.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == DS3231 || \ + (defined(TIME_LOCATION_SOURCE_FALLBACK) && TIME_LOCATION_SOURCE_FALLBACK == DS3231) + +#ifndef TLS_CLOCK_SKEW + #define TLS_CLOCK_SKEW 0.000139 // in hours, +5 seconds ahead when setting time +#endif + +class TlsDs3231 : public TimeLocationSource { + public: + // initialize (also enables the RTC PPS if available) + bool init(); + + // set the RTC's time + void set(JulianDate ut1); + void set(int year, int month, int day, int hour, int minute, int second); + + // get the RTC's time + bool get(JulianDate &ut1); + + // secondary way to enable PPS + void ppsEnable(); + + // not used, date/time is stored as UT1 + double DUT1 = 0.0L; + + private: +}; + +#endif diff --git a/src/lib/tls/ds3234/DS3234.cpp b/src/lib/tls/ds3234/DS3234.cpp new file mode 100755 index 0000000..0a2dea4 --- /dev/null +++ b/src/lib/tls/ds3234/DS3234.cpp @@ -0,0 +1,99 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source DS3234 RTC support +// uses the default SPI port + +#include "DS3234.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == DS3234 || \ + (defined(TIME_LOCATION_SOURCE_FALLBACK) && TIME_LOCATION_SOURCE_FALLBACK == DS3234) + + +#ifdef TLS_TIMELIB + #include // https://github.com/PaulStoffregen/Time/archive/master.zip +#endif + +#include +#include // https://github.com/Makuna/Rtc/archive/master.zip +RtcDS3234 rtcDS3234(SPI, DS3234_CS_PIN); + +bool TlsDs3234::init() { + SPI.begin(); + rtcDS3234.Begin(); + if (!rtcDS3234.GetIsRunning()) rtcDS3234.SetIsRunning(true); + + // see if the RTC is present + if (rtcDS3234.GetIsRunning()) { + // frequency 0 (1Hz) on the SQW pin + rtcDS3234.SetSquareWavePin(DS3234SquareWavePin_ModeClock); + rtcDS3234.SetSquareWavePinClockFrequency(DS3234SquareWaveClock_1Hz); + + #ifdef TLS_TIMELIB + RtcDateTime now = rtcDS3234.GetDateTime(); + setTime(now.Hour(), now.Minute(), now.Second(), now.Day(), now.Month(), now.Year()); + #endif + + ready = true; + } else DLF("WRN: tls.init(), DS3234 GetIsRunning() false"); + #ifdef SSPI_SHARED + SPI.end(); + #endif + return ready; +} + +void TlsDs3234::set(JulianDate ut1) { + if (!ready) return; + + GregorianDate greg = calendars.julianDayToGregorian(ut1); + + double f1 = fabs(ut1.hour) + TLS_CLOCK_SKEW; + int h = floor(f1); + double m = (f1 - h)*60.0; + double s = (m - floor(m))*60.0; + + set(greg.year, greg.month, greg.day, h, floor(m), floor(s)); +} + +void TlsDs3234::set(int year, int month, int day, int hour, int minute, int second) { + #ifdef TLS_TIMELIB + setTime(hour, minute, second, day, month, year); + #endif + #ifdef SSPI_SHARED + SPI.begin(); + #endif + RtcDateTime updateTime = RtcDateTime(year, month, day, hour, minute, second); + rtcDS3234.SetDateTime(updateTime); + #ifdef SSPI_SHARED + SPI.end(); + #endif +} + +bool TlsDs3234::get(JulianDate &ut1) { + if (!ready) return false; + + #ifdef SSPI_SHARED + SPI.begin(); + #endif + GregorianDate greg; + RtcDateTime now = rtcDS3234.GetDateTime(); + if (now.Year() >= 2018 && now.Year() <= 3000 && now.Month() >= 1 && now.Month() <= 12 && now.Day() >= 1 && now.Day() <= 31 && + now.Hour() <= 23 && now.Minute() <= 59 && now.Second() <= 59) { + greg.year = now.Year(); + greg.month = now.Month(); + greg.day = now.Day(); + ut1 = calendars.gregorianToJulianDay(greg); + ut1.hour = now.Hour() + now.Minute()/60.0 + now.Second()/3600.0; + } else { + greg.year = 2000; + greg.month = 1; + greg.day = 1; + ut1 = calendars.gregorianToJulianDay(greg); + ut1.hour = 0.0; + } + #ifdef SSPI_SHARED + SPI.end(); + #endif + + return true; +} + +#endif \ No newline at end of file diff --git a/src/lib/tls/ds3234/DS3234.h b/src/lib/tls/ds3234/DS3234.h new file mode 100755 index 0000000..9ec32d6 --- /dev/null +++ b/src/lib/tls/ds3234/DS3234.h @@ -0,0 +1,37 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source DS3234 RTC support +// uses the default SPI port +#pragma once + +#include "../TlsBase.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == DS3234 || \ + (defined(TIME_LOCATION_SOURCE_FALLBACK) && TIME_LOCATION_SOURCE_FALLBACK == DS3234) + +#if !defined(DS3234_CS_PIN) || DS3234_CS_PIN == OFF + #error "Configuration (Config.h): DS3234_CS_PIN must be defined for TIME_LOCATION_SOURCE DS3234" +#endif + +#ifndef TLS_CLOCK_SKEW +#define TLS_CLOCK_SKEW 0.000139 // in hours, +5 seconds ahead when setting time +#endif + +class TlsDs3234 : public TimeLocationSource { + public: + // initialize (also enables the RTC PPS if available) + bool init(); + + // set the RTC's time + void set(JulianDate ut1); + void set(int year, int month, int day, int hour, int minute, int second); + + // get the RTC's time + bool get(JulianDate &ut1); + + // not used, date/time is stored as UT1 + double DUT1 = 0.0L; + + private: +}; + +#endif \ No newline at end of file diff --git a/src/lib/tls/gps/GPS.cpp b/src/lib/tls/gps/GPS.cpp new file mode 100755 index 0000000..b2f77fa --- /dev/null +++ b/src/lib/tls/gps/GPS.cpp @@ -0,0 +1,208 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source GPS support +// uses the specified serial port + +#include "GPS.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == GPS + +#ifdef TLS_TIMELIB + #include // https://github.com/PaulStoffregen/Time/archive/master.zip +#endif + +#ifndef SERIAL_GPS + #error "SERIAL_GPS must be set to the serial port object if TIME_LOCATION_SOURCE GPS is used" +#endif + +#ifndef SERIAL_GPS_BAUD + #error "SERIAL_GPS_BAUD must be set to the baud rate if TIME_LOCATION_SOURCE GPS is used" +#endif + +#if SERIAL_GPS == SoftSerial || SERIAL_GPS == HardSerial + #ifndef SERIAL_GPS_RX + #error "SERIAL_GPS_RX must be set to the serial port RX pin if SoftSerial or HardSerial is used" + #endif + #ifndef SERIAL_GPS_TX + #error "SERIAL_GPS_TX must be set to the serial port TX pin if SoftSerial or HardSerial is used" + #endif +#endif + +#include "../PPS.h" +#include "../../tasks/OnTask.h" + +#include // https://github.com/mikalhart/TinyGPSPlus/releases +TinyGPSPlus gps; + +// provide for using software serial +#if SERIAL_GPS == SoftSerial + #include + #undef SERIAL_GPS + SoftwareSerial SWSerialGPS(SERIAL_GPS_RX, SERIAL_GPS_TX); + #define SERIAL_GPS SWSerialGPS + #define SERIAL_GPS_RXTX_SET +#endif + +// provide for using hardware serial +#if SERIAL_GPS == HardSerial + #include + #undef SERIAL_GPS + HardwareSerial HWSerialGPS(SERIAL_GPS_RX, SERIAL_GPS_TX); + #define SERIAL_GPS HWSerialGPS + #define SERIAL_GPS_RXTX_SET +#endif + +TlsGPS *tlsGps; + +void gpsPoll() { + #if (TIME_LOCATION_PPS_SENSE) != OFF + if (pps.synced) { + #endif + + if (!tlsGps->isReady()) tlsGps->poll(); + + #if (TIME_LOCATION_PPS_SENSE) != OFF + } + #endif +} + +// initialize +bool TlsGPS::init() { + tlsGps = this; + + #if defined(SERIAL_GPS_RX) && defined(SERIAL_GPS_TX) && !defined(SERIAL_GPS_RXTX_SET) + SERIAL_GPS.begin(SERIAL_GPS_BAUD, SERIAL_8N1, SERIAL_GPS_RX, SERIAL_GPS_TX); + #else + SERIAL_GPS.begin(SERIAL_GPS_BAUD); + #endif + activeLink = true; + + // check to see if the GPS is present + tasks.yield(1000); + if (!SERIAL_GPS.available()) { + DLF("WRN: TLS, GPS serial RX interface is quiet!"); + return false; + } else { + unsigned long timeout = millis() + 1000U; + while (SERIAL_GPS.available() > 0) { + if (gps.encode(SERIAL_GPS.read())) break; + if ((long)(millis() - timeout) > 0) { + DLF("WRN: TLS, GPS serial RX interface no NMEA sentences detected!"); + return false; + } + Y; + } + } + + VF("MSG: TLS, GPS start monitor task (rate 10ms priority 7)... "); + if (tasks.add(10, 0, true, 7, gpsPoll, "gpsPoll")) { VLF("success"); active = true; } else { VLF("FAILED!"); } + + return active; +} + +void TlsGPS::set(JulianDate ut1) { + ut1 = ut1; +} + +void TlsGPS::set(int year, int month, int day, int hour, int minute, int second) { + #ifdef TLS_TIMELIB + setTime(hour, minute, second, day, month, year); + #else + (void)year; (void)month; (void)day; (void)hour; (void)minute; (void)second; + #endif +} + +bool TlsGPS::get(JulianDate &ut1) { + if (!ready) return false; + if (!timeIsValid()) return false; + + // get the date/time right now if the serial link is active + bool sentence = true; + if (activeLink) { + while (SERIAL_GPS.available() > 0) { + sentence = gps.encode(SERIAL_GPS.read()); + } + } + + GregorianDate greg; + greg.year = gps.date.year(); + greg.month = gps.date.month(); + greg.day = gps.date.day(); + ut1 = calendars.gregorianToJulianDay(greg); + // DUT1 = UT1 − UTC + // UT1 = DUT1 + UTC + + double second = gps.time.second() + gps.time.age()/1000.0; + #if defined(TIME_LOCATION_PPS_SENSE) && (TIME_LOCATION_PPS_SENSE) != OFF + if (pps.synced) { + unsigned long t; + // wait until we're roughly in the middle of a second + do { t = micros() - pps.lastMicros; } while (t < 400000 || t > 600000); + second = floor(gps.time.second() + gps.time.age()/1000.0) + t/1000000.0; + } + #endif + + ut1.hour = gps.time.hour() + gps.time.minute()/60.0 + (second + DUT1)/3600.0; + + // adjust date/time for DUT1 as needed + if (ut1.hour >= 24.0L) { ut1.hour -= 24.0L; ut1.day += 1.0L; } else + if (ut1.hour < 0.0L) { ut1.hour += 24.0L; ut1.day -= 1.0L; } + + // shutdown the link if the date/time is current + if (sentence && activeLink) { + VLF("MSG: TLS, closing GPS serial port"); + SERIAL_GPS.end(); + activeLink = false; + } + + return sentence; +} + +void TlsGPS::getSite(double &latitude, double &longitude, float &elevation) { + if (!ready) return; + if (!siteIsValid()) return; + + latitude = gps.location.lat(); + longitude = -gps.location.lng(); + elevation = gps.altitude.meters(); +} + +void TlsGPS::poll() { + while (SERIAL_GPS.available() > 0) { + gps.encode(SERIAL_GPS.read()); + } + + if (gps.location.isValid() && siteIsValid()) { + if (gps.date.isValid() && gps.time.isValid() && timeIsValid()) { + if (waitIsValid()) { + VLF("MSG: TLS, GPS date/time/location is ready"); + + VLF("MSG: TLS, stopping GPS monitor task"); + tasks.setDurationComplete(tasks.getHandleByName("gpsPoll")); + + #ifdef TLS_TIMELIB + setTime(gps.time.hour(), gps.time.minute(), gps.time.second(), gps.date.day(), gps.date.month(), gps.date.year()); + #endif + + ready = true; + } + } + } +} + +// starts keeping track of the wait once (PPS is synced, if applicable) and GPS has a lock +bool TlsGPS::waitIsValid() { + if (startTime == 0) startTime = millis(); + unsigned long t = millis() - startTime; + return (t/1000UL)/60UL >= GPS_MIN_WAIT_MINUTES; +} + +bool TlsGPS::timeIsValid() { + if (gps.date.year() <= 3000 && gps.date.month() >= 1 && gps.date.month() <= 12 && gps.date.day() >= 1 && gps.date.day() <= 31 && + gps.time.hour() <= 23 && gps.time.minute() <= 59 && gps.time.second() <= 59) return true; else return false; +} + +bool TlsGPS::siteIsValid() { + if (gps.location.lat() >= -90 && gps.location.lat() <= 90 && gps.location.lng() >= -360 && gps.location.lng() <= 360) return true; else return false; +} + +#endif diff --git a/src/lib/tls/gps/GPS.h b/src/lib/tls/gps/GPS.h new file mode 100755 index 0000000..5494ccc --- /dev/null +++ b/src/lib/tls/gps/GPS.h @@ -0,0 +1,55 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source GPS support +// uses the specified serial port +#pragma once + +#include "../TlsBase.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == GPS + +#ifndef GPS_TIMEOUT_MINUTES + #define GPS_TIMEOUT_MINUTES 10 // wait up to 10 minutes to get lock, use 0 to disable timeout +#endif +#ifndef GPS_MIN_WAIT_MINUTES + #define GPS_MIN_WAIT_MINUTES 2 // minimum wait for stabilization in minutes, use 0 to disable +#endif + +class TlsGPS : public TimeLocationSource { + public: + // initialize (also enables the RTC PPS if available) + // pass a hook to the tls you created so it can be called + bool init(); + + // set the RTC's time + void set(JulianDate ut1); + void set(int year, int month, int day, int hour, int minute, int second); + + // get the RTC's time + bool get(JulianDate &ut1); + + // get the location + void getSite(double &latitude, double &longitude, float &elevation); + + // update from GPS + void poll(); + + // for conversion from UTC to UT1 + double DUT1 = 0.0L; + + private: + // validate wait time + bool waitIsValid(); + + // validate time + bool timeIsValid(); + + // validate site + bool siteIsValid(); + + unsigned long startTime = 0; + + bool active = false; + bool activeLink = false; +}; + +#endif diff --git a/src/lib/tls/ntp/NTP.cpp b/src/lib/tls/ntp/NTP.cpp new file mode 100755 index 0000000..9bc5faa --- /dev/null +++ b/src/lib/tls/ntp/NTP.cpp @@ -0,0 +1,143 @@ +// ----------------------------------------------------------------------------------------------------------------- +// NTP time code +// from here: https://github.com/PaulStoffregen/Time + +#include "NTP.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == NTP + +#include // https://github.com/PaulStoffregen/Time/archive/master.zip + +#if OPERATIONAL_MODE == WIFI + WiFiUDP Udp; +#else + EthernetUDP Udp; +#endif + +#include "../../tasks/OnTask.h" + +IPAddress timeServer = IPAddress TIME_IP_ADDR; + +// local port to listen for UDP packets +unsigned int localPort = 8888; + +TlsNTP *tlsNtp; + +void ntpWrapper() { + if (!tlsNtp->isReady()) tlsNtp->poll(); +} + +// initialize +bool TlsNTP::init() { + tlsNtp = this; + + VF("MSG: TLS, start NTP monitor task (rate 5 min priority 7)... "); + handle = tasks.add(5*60*1000L, 0, true, 7, ntpWrapper, "ntp"); + if (handle) { + VLF("success"); + active = true; + } else { + VLF("FAILED!"); + active = false; + } + + // flag that start time is unknown + startTime = 0; + + ready = false; + + return active; +} + +void TlsNTP::restart() { +} + +void TlsNTP::set(JulianDate ut1) { + ut1 = ut1; +} + +void TlsNTP::set(int year, int month, int day, int hour, int minute, int second) { + #ifdef TLS_TIMELIB + setTime(hour, minute, second, day, month, year); + #else + (void)year; (void)month; (void)day; (void)hour; (void)minute; (void)second; + #endif +} + +bool TlsNTP::get(JulianDate &ut1) { + if (!ready) return false; + + if (year() >= 0 && year() <= 3000 && month() >= 1 && month() <= 12 && day() >= 1 && day() <= 31 && + hour() <= 23 && minute() <= 59 && second() <= 59) { + GregorianDate greg; greg.year = year(); greg.month = month(); greg.day = day(); + ut1 = calendars.gregorianToJulianDay(greg); + ut1.hour = hour() + minute()/60.0 + (second() + DUT1)/3600.0; + } + + return true; +} + +void TlsNTP::poll() { + Udp.begin(localPort); + + // discard any previously received packets + unsigned long tOut = millis() + 3000U; + while ((Udp.parsePacket() > 0) && ((long)(millis() - tOut) < 0)) Y; + + VLF("MSG: TLS, transmit NTP Request"); + sendNTPpacket(timeServer); + + unsigned long beginWait = millis(); + while (millis() - beginWait < 1500U) { + int size = Udp.parsePacket(); + if (size >= NTP_PACKET_SIZE) { + VLF("MSG: TLS, receive NTP Response"); + // read packet into the buffer + Udp.read(packetBuffer, NTP_PACKET_SIZE); + unsigned long secsSince1900; + // convert four bytes starting at location 40 to a long integer + secsSince1900 = (unsigned long)packetBuffer[40] << 24; + secsSince1900 |= (unsigned long)packetBuffer[41] << 16; + secsSince1900 |= (unsigned long)packetBuffer[42] << 8; + secsSince1900 |= (unsigned long)packetBuffer[43]; + time_t ntpTime = secsSince1900 - 2208988800UL; + setTime(ntpTime); + DLF("MSG: TLS, next NTP query in 24 hours"); + tasks.setPeriod(handle, 24L*60L*60L*1000L); + ready = true; + + Udp.stop(); + return; + } + Y; + } + DLF("MSG: TLS, no NTP Response :-("); + DLF("MSG: TLS, next NTP query in 5 minutes"); + tasks.setPeriod(handle, 5*60*1000L); + + Udp.stop(); +} + +// send an NTP request to the time server at the given address +void TlsNTP::sendNTPpacket(IPAddress &address) { + // set all bytes in the buffer to 0 + memset(packetBuffer, 0, NTP_PACKET_SIZE); + // Initialize values needed to form NTP request + // (see URL above for details on the packets) + packetBuffer[0] = 0b11100011; // LI, Version, Mode + packetBuffer[1] = 0; // Stratum, or type of clock + packetBuffer[2] = 6; // Polling Interval + packetBuffer[3] = 0xEC; // Peer Clock Precision + // 8 bytes of zero for Root Delay & Root Dispersion + packetBuffer[12] = 49; + packetBuffer[13] = 0x4E; + packetBuffer[14] = 49; + packetBuffer[15] = 52; + // all NTP fields have been given values, now + // you can send a packet requesting a timestamp: + Udp.beginPacket(address, 123); //NTP requests are to port 123 + Udp.write(packetBuffer, NTP_PACKET_SIZE); + Udp.endPacket(); +} + +#endif diff --git a/src/lib/tls/ntp/NTP.h b/src/lib/tls/ntp/NTP.h new file mode 100755 index 0000000..bd5d6f5 --- /dev/null +++ b/src/lib/tls/ntp/NTP.h @@ -0,0 +1,60 @@ +// ----------------------------------------------------------------------------------------------------------------- +// NTP time code +// from here: https://github.com/PaulStoffregen/Time +#pragma once + +#include "../TlsBase.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == NTP + +#if OPERATIONAL_MODE == WIFI + #include +#elif OPERATIONAL_MODE == ETHERNET_TEENSY41 + #include +#else + #include +#endif + +#ifndef NTP_TIMEOUT_SECONDS + #define NTP_TIMEOUT_SECONDS 300 // wait up to 5 minutes to get date/time, use 0 to disable timeout +#endif + +class TlsNTP : public TimeLocationSource { + public: + // initialize (also enables the RTC PPS if available) + bool init(); + + // restart UDP server + void restart(); + + // set the RTC's time + void set(JulianDate ut1); + void set(int year, int month, int day, int hour, int minute, int second); + + // get the RTC's time + bool get(JulianDate &ut1); + + // update from NTP + void poll(); + + // for conversion from UTC to UT1 + double DUT1 = 0.0L; + + private: + // send an NTP request to the time server at the given address + void sendNTPpacket(IPAddress &address); + + // NTP time is in the first 48 bytes of message + static const int NTP_PACKET_SIZE = 48; + + // buffer to hold incoming & outgoing packets + uint8_t packetBuffer[NTP_PACKET_SIZE]; + + unsigned long startTime = 0; + + bool active = false; + uint8_t handle = 0; + +}; + +#endif diff --git a/src/lib/tls/sd3031/SD3031.cpp b/src/lib/tls/sd3031/SD3031.cpp new file mode 100755 index 0000000..9e6c3ed --- /dev/null +++ b/src/lib/tls/sd3031/SD3031.cpp @@ -0,0 +1,85 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source SD3031 RTC support +// uses the default I2C port in most cases; though HAL_WIRE can redirect to another port (as is done for the Teensy3.5/3.6) + +#include "SD3031.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == SD3031 || \ + (defined(TIME_LOCATION_SOURCE_FALLBACK) && TIME_LOCATION_SOURCE_FALLBACK == SD3031) + +#ifdef TLS_TIMELIB + #include // https://github.com/PaulStoffregen/Time/archive/master.zip +#endif + +#include // https://github.com/cdjq/DFRobot_SD3031 +DFRobot_SD3031 rtcSD3031(&HAL_WIRE); + +bool TlsSd3031::init() { + HAL_WIRE.begin(); + HAL_WIRE_SET_CLOCK(); + + bool error = rtcSD3031.begin(); + if (!error) { + HAL_WIRE_SET_CLOCK(); + + rtcSD3031.setHourSystem(rtcSD3031.e24hours); + + #ifdef TLS_TIMELIB + sTimeData_t dateTime = rtcSD3031.getRTCTime(); + setTime(dateTime.hour, dateTime.minute, dateTime.second, dateTime.day, dateTime.month, dateTime.year); + #endif + + ready = true; + } else { DLF("WRN: tls.init(), SD3031 (I2C 0x32) not found"); } + #ifdef HAL_WIRE_RESET_AFTER_CONNECT + HAL_WIRE.end(); + HAL_WIRE.begin(); + HAL_WIRE_SET_CLOCK(); + #endif + return ready; +} + +void TlsSd3031::set(JulianDate ut1) { + if (!ready) return; + + GregorianDate greg = calendars.julianDayToGregorian(ut1); + + double f1 = fabs(ut1.hour) + TLS_CLOCK_SKEW; + int h = floor(f1); + double m = (f1 - h)*60.0; + double s = (m - floor(m))*60.0; + + set(greg.year, greg.month, greg.day, h, floor(m), floor(s)); +} + +void TlsSd3031::set(int year, int month, int day, int hour, int minute, int second) { + #ifdef TLS_TIMELIB + setTime(hour, minute, second, day, month, year); + #endif + rtcSD3031.setTime(year, month, day, hour, minute, second); +} + +bool TlsSd3031::get(JulianDate &ut1) { + if (!ready) return false; + + sTimeData_t dateTime = rtcSD3031.getRTCTime(); + + if (dateTime.year >= 2018 && dateTime.year <= 3000 && + dateTime.month >= 1 && dateTime.month <= 12 && + dateTime.day >= 1 && dateTime.day <= 31 && + dateTime.hour <= 23 && dateTime.minute <= 59 && dateTime.second <= 59) { + GregorianDate greg; + greg.year = dateTime.year; greg.month = dateTime.month; greg.day = dateTime.day; + ut1 = calendars.gregorianToJulianDay(greg); + ut1.hour = dateTime.hour + dateTime.minute/60.0 + dateTime.second/3600.0; + } + + return true; +} + +void TlsSd3031::ppsEnable() { + // frequency 0 (1Hz) on the SQW pin + rtcSD3031.enableFrequency(rtcSD3031.eHz_1Second); +} + +#endif diff --git a/src/lib/tls/sd3031/SD3031.h b/src/lib/tls/sd3031/SD3031.h new file mode 100755 index 0000000..df87169 --- /dev/null +++ b/src/lib/tls/sd3031/SD3031.h @@ -0,0 +1,36 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source SD3031 RTC support +// uses the default I2C port in most cases; though HAL_WIRE can redirect to another port (as is done for the Teensy3.5/3.6) +#pragma once + +#include "../TlsBase.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == SD3031 || \ + (defined(TIME_LOCATION_SOURCE_FALLBACK) && TIME_LOCATION_SOURCE_FALLBACK == SD3031) + +#ifndef TLS_CLOCK_SKEW + #define TLS_CLOCK_SKEW 0.0 // in hours +#endif + +class TlsSd3031 : public TimeLocationSource { + public: + // initialize (also enables the RTC PPS if available) + bool init(); + + // set the RTC's time + void set(JulianDate ut1); + void set(int year, int month, int day, int hour, int minute, int second); + + // get the RTC's time + bool get(JulianDate &ut1); + + // secondary way to enable PPS + void ppsEnable(); + + // not used, date/time is stored as UT1 + double DUT1 = 0.0L; + + private: +}; + +#endif diff --git a/src/lib/tls/teensy/Teensy.cpp b/src/lib/tls/teensy/Teensy.cpp new file mode 100755 index 0000000..9996671 --- /dev/null +++ b/src/lib/tls/teensy/Teensy.cpp @@ -0,0 +1,49 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source TEENSY 3.2 RTC support + +#include "Teensy.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == TEENSY || \ + (defined(TIME_LOCATION_SOURCE_FALLBACK) && TIME_LOCATION_SOURCE_FALLBACK == TEENSY) + +#include // https://github.com/PaulStoffregen/Time/archive/master.zip + +bool TlsTeensy::init() { + ready = true; + return ready; +} + +void TlsTeensy::set(JulianDate ut1) { + GregorianDate greg = calendars.julianDayToGregorian(ut1); + + double f1 = fabs(ut1.hour) + TLS_CLOCK_SKEW; + int h = floor(f1); + double m = (f1 - h)*60.0; + double s = (m - floor(m))*60.0; + + set(greg.year, greg.month, greg.day, h, floor(m), floor(s)); +} + +void TlsTeensy::set(int year, int month, int day, int hour, int minute, int second) { + setTime(hour, minute, second, day, month, year); + unsigned long TeensyTime = now(); // get time in epoch + Teensy3Clock.set(TeensyTime); // set Teensy time +} + +bool TlsTeensy::get(JulianDate &ut1) { + if (!ready) return false; + + unsigned long TeensyTime = Teensy3Clock.get(); // get time from Teensy RTC + setTime(TeensyTime); // set system time + + if (year() >= 0 && year() <= 3000 && month() >= 1 && month() <= 12 && day() >= 1 && day() <= 31 && + hour() <= 23 && minute() <= 59 && second() <= 59) { + GregorianDate greg; greg.year = year(); greg.month = month(); greg.day = day(); + ut1 = calendars.gregorianToJulianDay(greg); + ut1.hour = hour() + minute()/60.0 + second()/3600.0; + } + + return true; +} + +#endif \ No newline at end of file diff --git a/src/lib/tls/teensy/Teensy.h b/src/lib/tls/teensy/Teensy.h new file mode 100755 index 0000000..d974820 --- /dev/null +++ b/src/lib/tls/teensy/Teensy.h @@ -0,0 +1,32 @@ +// ----------------------------------------------------------------------------------- +// Time/Location source TEENSY 3.2 RTC support +#pragma once + +#include "../TlsBase.h" + +#if defined(TIME_LOCATION_SOURCE) && TIME_LOCATION_SOURCE == TEENSY || \ + (defined(TIME_LOCATION_SOURCE_FALLBACK) && TIME_LOCATION_SOURCE_FALLBACK == TEENSY) + +#ifndef TLS_CLOCK_SKEW + #define TLS_CLOCK_SKEW 0.000139 // in hours, +5 seconds ahead when setting time +#endif + +class TlsTeensy : public TimeLocationSource { + public: + // initialize (also enables the RTC PPS if available) + bool init(); + + // set the RTC's time + void set(JulianDate ut1); + void set(int year, int month, int day, int hour, int minute, int second); + + // get the RTC's time + bool get(JulianDate &ut1); + + // not used, date/time is stored as UT1 + double DUT1 = 0.0L; + + private: +}; + +#endif diff --git a/src/lib/watchdog/Watchdog.cpp b/src/lib/watchdog/Watchdog.cpp new file mode 100755 index 0000000..9729f36 --- /dev/null +++ b/src/lib/watchdog/Watchdog.cpp @@ -0,0 +1,63 @@ +// ----------------------------------------------------------------------------------------------------------------------------- +// General purpose "virtual" watchdog +#include "Watchdog.h" + +#if defined(WATCHDOG) && WATCHDOG != OFF || true + +#ifndef __AVR_ATmega2560__ + #include "../tasks/OnTask.h" + void watchdogWrapper() { watchdog.poll(); } +#else + void (*mega2560restart) (void) = 0; + #include +#endif + +void Watchdog::enable(int seconds) { + #ifndef __AVR_ATmega2560__ + if (this->seconds == -1) { + this->seconds = seconds; + + VF("MSG: Watchdog, start monitor task (100ms rate priority 0)... "); + uint8_t taskHandle = tasks.add(100, 0, true, 0, watchdogWrapper, "wdog"); + + if (taskHandle) { + VLF("success"); + if (!tasks.requestHardwareTimer(taskHandle, 0)) { DLF("WRN: Watchdog::enable(), didn't get h/w timer (using s/w timer!!!)"); } + } else { + VLF("FAILED!"); + return; + } + } + #else + if (seconds == 1) wdt_enable(WDTO_1S); else + if (seconds == 2) wdt_enable(WDTO_2S); else + if (seconds == 4) wdt_enable(WDTO_4S); else + if (seconds == 8) wdt_enable(WDTO_8S); else return; + #endif + enabled = true; +} + +void Watchdog::disable() { + #ifndef __AVR_ATmega2560__ + enabled = false; + #else + wdt_disable(); + #endif +} + +void Watchdog::reset() { + #ifndef __AVR_ATmega2560__ + count = 0; + #else + wdt_reset(); + #endif +} + +void Watchdog::poll() { + if (!enabled) return; + if (count++ > 10 * seconds) { HAL_RESET(); } +} + +Watchdog watchdog; + +#endif diff --git a/src/lib/watchdog/Watchdog.h b/src/lib/watchdog/Watchdog.h new file mode 100755 index 0000000..37c79da --- /dev/null +++ b/src/lib/watchdog/Watchdog.h @@ -0,0 +1,31 @@ +// ----------------------------------------------------------------------------------------------------------------------------- +// General purpose "virtual" watchdog +#pragma once + +#include "../../Common.h" + +#if defined(WATCHDOG) && WATCHDOG != OFF || true + +class Watchdog { + public: + // initialize and start the watchdog with timeout (to reset MCU) of seconds + void enable(int seconds); + + // call at least once per timeout period or the MCU will be reset if the WD is enabled + void reset(); + + // disable the watchdog + void disable(); + + // for internal use + void poll(); + + private: + volatile int16_t count = 0; + volatile int16_t seconds = -1; + volatile bool enabled = false; +}; + +extern Watchdog watchdog; + +#endif diff --git a/src/lib/wifi/WifiManager.cpp b/src/lib/wifi/WifiManager.cpp new file mode 100755 index 0000000..7413486 --- /dev/null +++ b/src/lib/wifi/WifiManager.cpp @@ -0,0 +1,251 @@ +// wifi manager, used by the webserver and wifi serial IP +#include "WifiManager.h" + +#if OPERATIONAL_MODE == WIFI + +#include "../tasks/OnTask.h" +#include "../nv/Nv.h" + +#if STA_AUTO_RECONNECT == true + void reconnectStationWrapper() { wifiManager.reconnectStation(); } +#endif + +bool WifiManager::init() { + if (!active) { + + readSettings(); + + setStation(stationNumber); + + IPAddress ap_ip = IPAddress(settings.ap.ip); + IPAddress ap_gw = IPAddress(settings.ap.gw); + IPAddress ap_sn = IPAddress(settings.ap.sn); + + IPAddress sta_ip = IPAddress(sta->ip); + IPAddress sta_gw = IPAddress(sta->gw); + IPAddress sta_sn = IPAddress(sta->sn); + + char name[32] = HOST_NAME; + strtohostname(name); + + #if MDNS_SERVER == ON + WiFi.hostname(name); + #endif + + if (settings.accessPointEnabled == false && settings.stationEnabled == false) { + VF("MSG: WiFi, re-enabling access point mode to prevent lock-out!"); + settings.accessPointEnabled = true; + } + + TryAgain: + if (settings.accessPointEnabled && !settings.stationEnabled) { + VF("MSG: WiFi, starting Soft AP for SSID "); V(settings.ap.ssid); V(" PWD "); V(settings.ap.pwd); V(" CH "); VL(settings.ap.channel); + WiFi.softAP(settings.ap.ssid, settings.ap.pwd, settings.ap.channel); + #if defined(CONFIG_IDF_TARGET_ESP32S2) || defined(CONFIG_IDF_TARGET_ESP32C3) + WiFi.setTxPower(WIFI_POWER_8_5dBm); + #endif + WiFi.mode(WIFI_AP); + } else + if (!settings.accessPointEnabled && settings.stationEnabled) { + VF("MSG: WiFi, starting Station for SSID "); V(sta->ssid); V(" PWD "); VL(staPwd->password); + WiFi.begin(sta->ssid, staPwd->password); + #if defined(CONFIG_IDF_TARGET_ESP32S2) || defined(CONFIG_IDF_TARGET_ESP32C3) + WiFi.setTxPower(WIFI_POWER_8_5dBm); + #endif + WiFi.mode(WIFI_STA); + } else + if (settings.accessPointEnabled && settings.stationEnabled) { + VF("MSG: WiFi, starting Soft AP for SSID "); V(settings.ap.ssid); V(" PWD "); V(settings.ap.pwd); V(" CH "); VL(settings.ap.channel); + WiFi.softAP(settings.ap.ssid, settings.ap.pwd, settings.ap.channel); + VF("MSG: WiFi, starting Station for SSID "); V(sta->ssid); V(" PWD "); VL(staPwd->password); + WiFi.begin(sta->ssid, staPwd->password); + #if defined(CONFIG_IDF_TARGET_ESP32S2) || defined(CONFIG_IDF_TARGET_ESP32C3) + WiFi.setTxPower(WIFI_POWER_8_5dBm); + #endif + WiFi.mode(WIFI_AP_STA); + } + + delay(100); + + if (settings.stationEnabled && !sta->dhcpEnabled) WiFi.config(sta_ip, sta_gw, sta_sn); + if (settings.accessPointEnabled) WiFi.softAPConfig(ap_ip, ap_gw, ap_sn); + + // wait for connection + if (settings.stationEnabled) { + for (int i = 0; i < 8; i++) if (WiFi.status() != WL_CONNECTED) delay(1000); else break; + } + + if (settings.stationEnabled && WiFi.status() != WL_CONNECTED) { + + // if connection fails fall back to access-point mode + if (settings.stationApFallback && !settings.accessPointEnabled) { + VLF("MSG: WiFi, starting station failed"); + WiFi.disconnect(); + delay(3000); + VLF("MSG: WiFi, switching to SoftAP mode"); + settings.stationEnabled = false; + settings.accessPointEnabled = true; + goto TryAgain; + } + + // no fallback but the AP is still enabled + if (settings.accessPointEnabled) { + active = true; + VLF("MSG: WiFi, started AP but station failed"); + } else { + // the station failed to connect and the AP isn't enabled + DLF("WRN: WiFi, starting station failed"); + WiFi.disconnect(); + } + } else { + active = true; + VLF("MSG: WiFi, started"); + + #if MDNS_SERVER == ON && !defined(ESP8266) + sstrcpy(name, MDNS_NAME); + strtohostname2(name); + if (MDNS.begin(name)) { VF("MSG: WiFi, mDNS started for "); VL(name); } else { DF("WRN: WiFi, mDNS start FAILED for "); DL(name); } + #endif + + if (staNameLookup && strlen(wifiManager.sta->host) > 0) { + IPAddress ip; + char name[32] = ""; + sstrcpy(name, wifiManager.sta->host); + strtohostname(name); + + if (WiFi.hostByName(name, ip)) { + VF("MSG: WiFi, host name "); V(name); VF(" DNS resolved to "); VL(ip.toString().c_str()); + ip4toip4(wifiManager.sta->target, ip); + } else { + VF("MSG: WiFi, host name "); V(name); VLF(" DNS resolution failed!"); + #if MDNS_CLIENT == ON && !defined(ESP8266) + strtohostname2(name); + ip = MDNS.queryHost(name); + if (validip4(ip)) { + ip4toip4(wifiManager.sta->target, ip); + VF("MSG: WiFi, host name "); V(name); VF(" mDNS resolved to "); VL(ip.toString().c_str()); + } else { + VF("MSG: WiFi, host name "); V(name); VLF(" mDNS resolution failed!"); + } + #endif + } + } + + #if STA_AUTO_RECONNECT == true + if (settings.stationEnabled) { + VF("MSG: WiFi, start connection check task (rate 8s priority 7)... "); + if (tasks.add(8000, 0, true, 7, reconnectStationWrapper, "WifiChk")) { VLF("success"); } else { VLF("FAILED!"); } + } + #endif + } + } + + return active; +} + +#if STA_AUTO_RECONNECT == true + void WifiManager::reconnectStation() { + if (WiFi.status() != WL_CONNECTED) { + VLF("MSG: WiFi, attempting reconnect"); + WiFi.disconnect(); + WiFi.reconnect(); + } + } +#endif + +void WifiManager::setStation(int number) { + if (number >= 1 && number <= WifiStationCount) stationNumber = number; + sta = &station[stationNumber - 1]; + staPwd = &stationPassword[stationNumber - 1]; +} + +void WifiManager::disconnect() { + WiFi.disconnect(); + WiFi.softAPdisconnect(true); + active = false; + VLF("MSG: WiFi, disconnected"); +} + +void WifiManager::readSettings() { + if (settingsReady) return; + + #ifdef NV_WIFI_SETTINGS + VLF("MSG: WifiManager, reading settings from NV"); + + if (!nv().kv().getOrInit("WIFI_SETTINGS", settings)) { DLF("WRN: Nv, init failed for WIFI_SETTINGS"); } + + for (uint8_t i = 1; i <= WifiStationCount; i++) { + char keyStr[24]; + snprintf(keyStr, sizeof(keyStr), "WIFI_STATION%u", i); + if (!nv().kv().getOrInit(keyStr, station[i - 1])) { DF("WRN: Nv, init failed for "); DL(keyStr); } + snprintf(keyStr, sizeof(keyStr), "WIFI_STATION%u_PWD", i); + if (!nv().kv().getOrInit(keyStr, stationPassword[i - 1])) { DF("WRN: Nv, init failed for "); DL(keyStr); } + } + #endif + + #if DEBUG != OFF + IPAddress ap_ip = IPAddress(settings.ap.ip); + IPAddress ap_gw = IPAddress(settings.ap.gw); + IPAddress ap_sn = IPAddress(settings.ap.sn); + + VF("MSG: WiFi, Master Pwd = "); VL(settings.masterPassword); + + VF("MSG: WiFi, AP Enable = "); VL(settings.accessPointEnabled); + VF("MSG: WiFi, AP Fallback = "); VL(settings.stationApFallback); + + VF("MSG: WiFi, AP SSID = "); VL(settings.ap.ssid); + VF("MSG: WiFi, AP PWD = "); VL(settings.ap.pwd); + VF("MSG: WiFi, AP CH = "); VL(settings.ap.channel); + VF("MSG: WiFi, AP IP = "); VL(ap_ip.toString()); + VF("MSG: WiFi, AP GATEWAY = "); VL(ap_gw.toString()); + VF("MSG: WiFi, AP SN = "); VL(ap_sn.toString()); + + int currentStationNumber = stationNumber; + + VF("MSG: WiFi, Sta Enable = "); VL(settings.stationEnabled); + + VF("MSG: WiFi, Sta Select = "); VL(stationNumber); + + for (int i = 1; i <= WifiStationCount; i++) { + setStation(i); + + IPAddress sta_ip = IPAddress(sta->ip); UNUSED(sta_ip); + IPAddress sta_gw = IPAddress(sta->gw); UNUSED(sta_gw); + IPAddress sta_sn = IPAddress(sta->sn); UNUSED(sta_sn); + IPAddress target = IPAddress(sta->target); UNUSED(target); + + VF("MSG: WiFi, Sta"); V(stationNumber); VF(" SSID = "); VL(sta->ssid); + VF("MSG: WiFi, Sta"); V(stationNumber); VF(" PWD = "); VL(staPwd->password); + VF("MSG: WiFi, Sta"); V(stationNumber); VF(" DHCP En = "); VL(sta->dhcpEnabled); + VF("MSG: WiFi, Sta"); V(stationNumber); VF(" IP = "); VL(sta_ip.toString()); + VF("MSG: WiFi, Sta"); V(stationNumber); VF(" GATEWAY = "); VL(sta_gw.toString()); + VF("MSG: WiFi, Sta"); V(stationNumber); VF(" SN = "); VL(sta_sn.toString()); + VF("MSG: WiFi, Sta"); V(stationNumber); VF(" NAME = "); VL(sta->host); + VF("MSG: WiFi, Sta"); V(stationNumber); VF(" TARGET = "); VL(target.toString()); + } + stationNumber = currentStationNumber; + #endif + + settingsReady = true; +} + +void WifiManager::writeSettings() { + if (!settingsReady) return; + + #ifdef NV_WIFI_SETTINGS + VLF("MSG: WifiManager, writing settings to NV"); + nv().kv().put("WIFI_SETTINGS", settings); + + for (uint8_t i = 1; i <= WifiStationCount; i++) { + char keyStr[24]; + snprintf(keyStr, sizeof(keyStr), "WIFI_STATION%u", i); + nv().kv().put(keyStr, station[i - 1]); + snprintf(keyStr, sizeof(keyStr), "WIFI_STATION%u_PWD", i); + nv().kv().put(keyStr, stationPassword[i - 1]); + } + #endif +} + +WifiManager wifiManager; + +#endif diff --git a/src/lib/wifi/WifiManager.defaults.h b/src/lib/wifi/WifiManager.defaults.h new file mode 100755 index 0000000..9f7332f --- /dev/null +++ b/src/lib/wifi/WifiManager.defaults.h @@ -0,0 +1,337 @@ +#pragma once + +// ------------------------------------------------------------------------------------------------- +// general ip settings + +#ifndef HOST_NAME +#define HOST_NAME "Unknown" +#endif + +// default WIFI disabled +#ifndef OPERATIONAL_MODE +#define OPERATIONAL_MODE OFF +#endif + +// optional web-server +#ifndef WEB_SERVER +#define WEB_SERVER OFF // ON for website at port 80 +#endif + +// optional LX200 command server IP channels 9996 to 9999 (listens to clients) used by SWS +// OFF or STANDARD (port 9999), or PERSISTENT (ports 9996 to 9998), or BOTH +#ifndef COMMAND_SERVER +#define COMMAND_SERVER OFF +#endif + +// optional Arduino Serial class work-alike IP channels 9996 to 9999 as a server (listens to clients) +// OFF or STANDARD (port 9999), or PERSISTENT (ports 9996 to 9998), or BOTH +#ifndef SERIAL_SERVER +#define SERIAL_SERVER OFF // SERIAL_SIP, SERIAL_PIP1, etc. +#endif + +// optional Arduino Serial class work-alike IP channel (ports 9996 to 9998) as a client (connects to a server) +#ifndef SERIAL_CLIENT +#define SERIAL_CLIENT OFF // ON to enable SERIAL_IP +#endif + +// mDNS defaults +#ifndef MDNS_SERVER +#define MDNS_SERVER OFF +#endif + +#ifndef MDNS_CLIENT +#define MDNS_CLIENT OFF +#endif + +#ifndef MDNS_NAME +#define MDNS_NAME HOST_NAME +#endif + +// ------------------------------------------------------------------------------------------------- +// wifi manager settings + +#ifndef PASSWORD_DEFAULT +#define PASSWORD_DEFAULT "password" // default pwd for wifi settings +#endif + +#ifndef AP_ENABLED +#define AP_ENABLED false // to disable the soft AP +#endif + +#ifndef AP_SSID +#define AP_SSID HOST_NAME // Wifi Access Point SSID +#endif + +#ifndef AP_PASSWORD +#define AP_PASSWORD "password" // Wifi Access Point password +#endif + +#ifndef AP_CHANNEL +#define AP_CHANNEL 7 // Wifi Access Point channel +#endif + +#ifndef AP_IP_ADDR +#define AP_IP_ADDR {192,168,0,1} // Wifi Access Point IP Address +#endif + +#ifndef AP_GW_ADDR +#define AP_GW_ADDR {192,168,0,1} // Wifi Access Point GATEWAY Address +#endif + +#ifndef AP_SN_MASK +#define AP_SN_MASK {255,255,255,0} // Wifi Access Point SUBNET Mask +#endif + +// station + +#ifndef STA_AP_FALLBACK +#define STA_AP_FALLBACK false // activate SoftAP if station fails to connect +#endif + +#ifndef STA_ENABLED +#define STA_ENABLED false // normally not enabled +#endif + +#ifndef STA_AUTO_RECONNECT +#define STA_AUTO_RECONNECT false // normally not enabled +#endif + +#ifndef STA_SSID +#define STA_SSID "Home" // Wifi Station SSID to connnect to +#endif + +#ifndef STA_PASSWORD +#define STA_PASSWORD "password" // Wifi Station mode password +#endif + +#ifndef STA_DHCP_ENABLED +#define STA_DHCP_ENABLED false // true to use LAN DHCP addresses +#endif +#define STA_DHCP STA_DHCP_ENABLED + +#ifndef STA_IP_ADDR +#define STA_IP_ADDR {192,168,0,2} // Wifi Station IP Address +#endif + +#ifndef STA_GW_ADDR +#define STA_GW_ADDR {192,168,0,1} // Wifi Station GATEWAY Address +#endif + +#ifndef STA_SN_MASK +#define STA_SN_MASK {255,255,255,0} // Wifi Station SUBNET Mask +#endif + +#ifndef STA_HOST_NAME +#define STA_HOST_NAME "Home" // Host name to connect to (OnStep for example) +#endif + +#ifndef STA_TARGET_IP_ADDR +#define STA_TARGET_IP_ADDR {192,168,0,1} // IP Address to connect to +#endif +#ifndef STA_TARGET +#define STA_TARGET STA_TARGET_IP_ADDR +#endif + +// station 1 + +#ifndef STA1_HOST_NAME +#define STA1_HOST_NAME STA_HOST_NAME +#endif + +#ifndef STA1_SSID +#define STA1_SSID STA_SSID +#endif + +#ifndef STA1_PASSWORD +#define STA1_PASSWORD STA_PASSWORD +#endif + +#ifndef STA1_DHCP_ENABLED +#define STA1_DHCP_ENABLED STA_DHCP +#endif + +#ifndef STA1_TARGET_IP_ADDR +#define STA1_TARGET_IP_ADDR STA_TARGET +#endif + +#ifndef STA1_IP_ADDR +#define STA1_IP_ADDR STA_IP_ADDR +#endif + +#ifndef STA1_GW_ADDR +#define STA1_GW_ADDR STA_GW_ADDR +#endif + +#ifndef STA1_SN_MASK +#define STA1_SN_MASK STA_SN_MASK +#endif + +// station 2 + +#ifndef STA2_SSID +#define STA2_SSID "" +#endif + +#ifndef STA2_PASSWORD +#define STA2_PASSWORD "" +#endif + +#ifndef STA2_DHCP_ENABLED +#define STA2_DHCP_ENABLED false +#endif + +#ifndef STA2_IP_ADDR +#define STA2_IP_ADDR {192,168,0,2} +#endif + +#ifndef STA2_GW_ADDR +#define STA2_GW_ADDR {192,168,0,1} +#endif + +#ifndef STA2_SN_MASK +#define STA2_SN_MASK {255,255,255,0} +#endif + +#ifndef STA2_HOST_NAME +#define STA2_HOST_NAME "" +#endif + +#ifndef STA2_TARGET_IP_ADDR +#define STA2_TARGET_IP_ADDR {192,168,0,1} +#endif + +// station 3 + +#ifndef STA3_SSID +#define STA3_SSID "" +#endif + +#ifndef STA3_PASSWORD +#define STA3_PASSWORD "" +#endif + +#ifndef STA3_DHCP_ENABLED +#define STA3_DHCP_ENABLED false +#endif + +#ifndef STA3_IP_ADDR +#define STA3_IP_ADDR {192,168,0,2} +#endif + +#ifndef STA3_GW_ADDR +#define STA3_GW_ADDR {192,168,0,1} +#endif + +#ifndef STA3_SN_MASK +#define STA3_SN_MASK {255,255,255,0} +#endif + +#ifndef STA3_HOST_NAME +#define STA3_HOST_NAME "" +#endif + +#ifndef STA3_TARGET_IP_ADDR +#define STA3_TARGET_IP_ADDR {192,168,0,1} +#endif + +// station 4 + +#ifndef STA4_SSID +#define STA4_SSID "" +#endif + +#ifndef STA4_PASSWORD +#define STA4_PASSWORD "" +#endif + +#ifndef STA4_DHCP_ENABLED +#define STA4_DHCP_ENABLED false +#endif + +#ifndef STA4_IP_ADDR +#define STA4_IP_ADDR {192,168,0,2} +#endif + +#ifndef STA4_GW_ADDR +#define STA4_GW_ADDR {192,168,0,1} +#endif + +#ifndef STA4_SN_MASK +#define STA4_SN_MASK {255,255,255,0} +#endif + +#ifndef STA4_HOST_NAME +#define STA4_HOST_NAME "" +#endif + +#ifndef STA4_TARGET_IP_ADDR +#define STA4_TARGET_IP_ADDR {192,168,0,1} +#endif + +// station 5 + +#ifndef STA5_SSID +#define STA5_SSID "" +#endif + +#ifndef STA5_PASSWORD +#define STA5_PASSWORD "" +#endif + +#ifndef STA5_DHCP_ENABLED +#define STA5_DHCP_ENABLED false +#endif + +#ifndef STA5_IP_ADDR +#define STA5_IP_ADDR {192,168,0,2} +#endif + +#ifndef STA5_GW_ADDR +#define STA5_GW_ADDR {192,168,0,1} +#endif + +#ifndef STA5_SN_MASK +#define STA5_SN_MASK {255,255,255,0} +#endif + +#ifndef STA5_HOST_NAME +#define STA5_HOST_NAME "" +#endif + +#ifndef STA5_TARGET_IP_ADDR +#define STA5_TARGET_IP_ADDR {192,168,0,1} +#endif + +// station 6 + +#ifndef STA6_SSID +#define STA6_SSID "" +#endif + +#ifndef STA6_PASSWORD +#define STA6_PASSWORD "" +#endif + +#ifndef STA6_DHCP_ENABLED +#define STA6_DHCP_ENABLED false +#endif + +#ifndef STA6_IP_ADDR +#define STA6_IP_ADDR {192,168,0,2} +#endif + +#ifndef STA6_GW_ADDR +#define STA6_GW_ADDR {192,168,0,1} +#endif + +#ifndef STA6_SN_MASK +#define STA6_SN_MASK {255,255,255,0} +#endif + +#ifndef STA6_HOST_NAME +#define STA6_HOST_NAME "" +#endif + +#ifndef STA6_TARGET_IP_ADDR +#define STA6_TARGET_IP_ADDR {192,168,0,1} +#endif diff --git a/src/lib/wifi/WifiManager.h b/src/lib/wifi/WifiManager.h new file mode 100755 index 0000000..6eaccae --- /dev/null +++ b/src/lib/wifi/WifiManager.h @@ -0,0 +1,174 @@ +// wifi manager, used by the webserver and wifi serial IP +#pragma once + +#include "../../Common.h" + +#ifndef OPERATIONAL_MODE +#define OPERATIONAL_MODE OFF +#endif + +#if OPERATIONAL_MODE == WIFI + +#include "WifiManager.defaults.h" + +#if defined(ESP32) + #include + #include + #include + #if MDNS_SERVER == ON || MDNS_CLIENT == ON + #include + #endif +#elif defined(ESP8266) + #include + #include + #include +#else + #error "Configuration (Config.h): No Wifi support is present for this device" +#endif + +#ifndef WifiStationCount + // number of wifi stations supported, between 1 and 6 + #define WifiStationCount 1 +#endif + +#pragma pack(1) + +#define WifiStationPasswordSize 64 +typedef struct StationPassword { + char password[64]; +} StationPassword; + +#define WifiStationSize 82 +typedef struct StationSettings { + char ssid[33]; + bool dhcpEnabled; + uint8_t ip[4]; + uint8_t gw[4]; + uint8_t sn[4]; + char host[32]; + uint8_t target[4]; +} StationSettings; + +typedef struct AccessPointSettings { + char ssid[32]; + char pwd[32]; + unsigned char channel; + uint8_t ip[4]; + uint8_t gw[4]; + uint8_t sn[4]; +} AccessPointSettings; + +#define WifiSettingsSize 112 +typedef struct WifiSettings { + char masterPassword[32]; + + bool accessPointEnabled; + AccessPointSettings ap; + + bool stationEnabled; + bool stationApFallback; +} WifiSettings; + +#pragma pack() + +class WifiManager { + public: + // starts WiFi + bool init(); + + // stops WiFi + void disconnect(); + + #if STA_AUTO_RECONNECT == true + void reconnectStation(); + #endif + + // set the currently active station + // \param number from 1 to WifiStationCount + void setStation(int number); + + // read settings from NV + void readSettings(); + + // write settings to NV + void writeSettings(); + + // currently selected station + StationSettings *sta; + + // currently selected station password + StationPassword *staPwd; + + // currently selected station number + int stationNumber = 1; + + // optional station host name lookup overrides target IP + bool staNameLookup = false; + + // true if the WiFi AP or Station is active + bool active = false; + + WifiSettings settings = { + PASSWORD_DEFAULT, + + AP_ENABLED, + { + AP_SSID, AP_PASSWORD, AP_CHANNEL, + AP_IP_ADDR, AP_GW_ADDR, AP_SN_MASK + }, + + STA_ENABLED, + STA_AP_FALLBACK, + }; + + private: + bool settingsReady = false; + + StationPassword stationPassword[WifiStationCount] = + { + #if WifiStationCount > 0 + {STA1_PASSWORD}, + #endif + #if WifiStationCount > 1 + {STA2_PASSWORD}, + #endif + #if WifiStationCount > 2 + {STA3_PASSWORD}, + #endif + #if WifiStationCount > 3 + {STA4_PASSWORD}, + #endif + #if WifiStationCount > 4 + {STA5_PASSWORD}, + #endif + #if WifiStationCount > 5 + {STA6_PASSWORD}, + #endif + }; + + StationSettings station[WifiStationCount] = + { + #if WifiStationCount > 0 + {STA1_SSID, STA1_DHCP_ENABLED, STA1_IP_ADDR, STA1_GW_ADDR, STA1_SN_MASK, STA1_HOST_NAME, STA1_TARGET_IP_ADDR}, + #endif + #if WifiStationCount > 1 + {STA2_SSID, STA2_DHCP_ENABLED, STA2_IP_ADDR, STA2_GW_ADDR, STA2_SN_MASK, STA2_HOST_NAME, STA2_TARGET_IP_ADDR}, + #endif + #if WifiStationCount > 2 + {STA3_SSID, STA3_DHCP_ENABLED, STA3_IP_ADDR, STA3_GW_ADDR, STA3_SN_MASK, STA3_HOST_NAME, STA3_TARGET_IP_ADDR}, + #endif + #if WifiStationCount > 3 + {STA4_SSID, STA4_DHCP_ENABLED, STA4_IP_ADDR, STA4_GW_ADDR, STA4_SN_MASK, STA4_HOST_NAME, STA4_TARGET_IP_ADDR}, + #endif + #if WifiStationCount > 4 + {STA5_SSID, STA5_DHCP_ENABLED, STA5_IP_ADDR, STA5_GW_ADDR, STA5_SN_MASK, STA5_HOST_NAME, STA5_TARGET_IP_ADDR}, + #endif + #if WifiStationCount > 5 + {STA6_SSID, STA6_DHCP_ENABLED, STA6_IP_ADDR, STA6_GW_ADDR, STA6_SN_MASK, STA6_HOST_NAME, STA6_TARGET_IP_ADDR}, + #endif + }; +}; + +extern WifiManager wifiManager; + +#endif diff --git a/src/lib/wifi/cmdServer/CmdServer.cpp b/src/lib/wifi/cmdServer/CmdServer.cpp new file mode 100755 index 0000000..1ac067a --- /dev/null +++ b/src/lib/wifi/cmdServer/CmdServer.cpp @@ -0,0 +1,81 @@ +// wifi IP command server +#include "CmdServer.h" + +#if OPERATIONAL_MODE == WIFI && COMMAND_SERVER != OFF + + #include "../../tasks/OnTask.h" + #include "../../../libApp/cmd/Cmd.h" + + CmdServer::CmdServer(uint32_t port, long clientTimeoutMs, bool persist) { + cmdSvr = nullptr; + cmdBuffer[0] = 0; + cmdBufferPos = 0; + clientEndTimeMs = 0; + this->clientTimeoutMs = clientTimeoutMs; + this->persist = persist; + this->port = port; + } + + void CmdServer::begin() { + cmdSvr = new WiFiServer(port); + cmdSvr->begin(); + cmdSvr->setNoDelay(true); + } + + void CmdServer::handleClient() { + const unsigned long now = millis(); + + // drop stale client socket (disconnected or timed out/hung) + if (cmdSvrClient && + (!cmdSvrClient.connected() || (long)(clientEndTimeMs - now) < 0)) { + cmdSvrClient.stop(); + cmdBuffer[0] = 0; + cmdBufferPos = 0; + } + + // new client + if (!cmdSvrClient && cmdSvr->hasClient()) { + cmdSvrClient = cmdSvr->available(); + if (cmdSvrClient) { + clientEndTimeMs = now + clientTimeoutMs; + cmdBuffer[0] = 0; + cmdBufferPos = 0; + } + } + + // check clients for data, if found get the command, pass to OnStep and pickup the response, then return the response to client + while (cmdSvrClient && cmdSvrClient.connected() && cmdSvrClient.available() > 0) { + // still active? push back disconnect + if (persist) clientEndTimeMs = millis() + clientTimeoutMs; + + // get the data + int c = cmdSvrClient.read(); + if (c < 0 || c > 255) break; + + // insert into the command buffer + cmdBuffer[cmdBufferPos] = (char)c; + cmdBufferPos++; + if (cmdBufferPos > 39) cmdBufferPos = 39; + cmdBuffer[cmdBufferPos] = 0; + + // send cmd and pickup the response + if (c == '#' || (strlen(cmdBuffer) == 1 && c == (char)6)) { + char result[40] = ""; + + onStep.processCommand(cmdBuffer, result, cmdTimeout); + + // pickup response + if (strlen(result) > 0) { + if (cmdSvrClient && cmdSvrClient.connected()) { + cmdSvrClient.print(result); // there was a delay(2); after this + } + } + + // reset command buffer + cmdBuffer[0] = 0; + cmdBufferPos = 0; + } else tasks.yield(); + } + } + +#endif diff --git a/src/lib/wifi/cmdServer/CmdServer.h b/src/lib/wifi/cmdServer/CmdServer.h new file mode 100755 index 0000000..563edcf --- /dev/null +++ b/src/lib/wifi/cmdServer/CmdServer.h @@ -0,0 +1,28 @@ +// wifi IP command server +#pragma once + +#include "../../../Common.h" +#include "../WifiManager.h" + +#if OPERATIONAL_MODE == WIFI && COMMAND_SERVER != OFF + + class CmdServer { + public: + CmdServer(uint32_t port, long clientTimeoutMs, bool persist = false); + void begin(); + void handleClient(); + + private: + WiFiServer *cmdSvr; + WiFiClient cmdSvrClient; + + char cmdBuffer[40]; + int cmdBufferPos; + + unsigned long clientTimeoutMs; + unsigned long clientEndTimeMs; + bool persist; + long port; + }; + +#endif diff --git a/src/lib/wifi/webServer/WebServer.cpp b/src/lib/wifi/webServer/WebServer.cpp new file mode 100755 index 0000000..6ff041c --- /dev/null +++ b/src/lib/wifi/webServer/WebServer.cpp @@ -0,0 +1,14 @@ +// ----------------------------------------------------------------------------------- +// Web server + +#include "WebServer.h" + +#if OPERATIONAL_MODE == WIFI && WEB_SERVER == ON + + #if defined(ESP32) + WebServer www(80); + #elif defined(ESP8266) + ESP8266WebServer www(80); + #endif + +#endif diff --git a/src/lib/wifi/webServer/WebServer.h b/src/lib/wifi/webServer/WebServer.h new file mode 100755 index 0000000..d5a95a6 --- /dev/null +++ b/src/lib/wifi/webServer/WebServer.h @@ -0,0 +1,26 @@ +// ----------------------------------------------------------------------------------- +// Web server +#pragma once + +#include "../../../Common.h" +#include "../WifiManager.h" + +#if OPERATIONAL_MODE == WIFI && WEB_SERVER == ON + + #if defined(ESP32) + #include + #elif defined(ESP8266) + #include + #else + #error "Configuration (Config.h): No Wifi support is present for this device" + #endif + + #if defined(ESP32) + extern WebServer www; + #define sendContentAndClear(x) sendContent(x); x = ""; + #elif defined(ESP8266) + extern ESP8266WebServer www; + #define sendContentAndClear(x) sendContent(x); x = ""; delay(1); + #endif + +#endif diff --git a/src/libApp/commands/CommandBroker.cpp b/src/libApp/commands/CommandBroker.cpp new file mode 100755 index 0000000..862214c --- /dev/null +++ b/src/libApp/commands/CommandBroker.cpp @@ -0,0 +1,197 @@ +// ----------------------------------------------------------------------------------- +// Local command broker + +#include "CommandBroker.h" + +#if defined(SERIAL_LOCAL_MODE) && SERIAL_LOCAL_MODE == ON + +#include "../../lib/serial/Serial_Local.h" +#include "../../lib/tasks/OnTask.h" + +void commandBrokerWrapper() { commandBroker.poll(); } + +bool CommandBroker::init() { + if (initialized) return true; + + #ifdef ESP32 + mutex = xSemaphoreCreateMutex(); + if (mutex == NULL) return false; + #endif + + for (uint8_t i = 0; i < COMMAND_BROKER_SLOTS; i++) { + requests[i].state = CB_FREE; + requests[i].generation = 0; + } + + VF("MSG: System, start command broker task (rate 3ms priority 5)... "); + if (tasks.add(3, 0, true, 5, commandBrokerWrapper, "CmdBrkr")) { + initialized = true; + VLF("success"); + return true; + } else { + VLF("FAILED!"); + return false; + } +} + +uint8_t CommandBroker::request(const char *command, unsigned long timeoutMs) { + return enqueue(command, timeoutMs, true); +} + +bool CommandBroker::send(const char *command) { + return enqueue(command, 0, false) != 0; +} + +uint8_t CommandBroker::enqueue(const char *command, unsigned long timeoutMs, bool replyExpected) { + if (!initialized || command == NULL || command[0] == 0) return 0; + + lock(); + for (uint8_t i = 0; i < COMMAND_BROKER_SLOTS; i++) { + if (requests[i].state == CB_FREE) { + sstrcpy(requests[i].command, command); + requests[i].reply[0] = 0; + requests[i].timeoutMs = timeoutMs; + requests[i].deadline = 0; + requests[i].replyExpected = replyExpected; + requests[i].generation++; + if (requests[i].generation == 0) requests[i].generation = 1; + requests[i].state = CB_PENDING; + uint8_t handle = makeHandle(i); + unlock(); + return handle; + } + } + unlock(); + return 0; +} + +CommandBrokerStatus CommandBroker::status(uint8_t handle) { + if (!initialized) return CB_FREE; + + int8_t slot = handleToSlot(handle); + if (slot < 0) return CB_FREE; + + lock(); + CommandBrokerStatus state = handleValid(handle, slot) ? requests[slot].state : CB_FREE; + unlock(); + return state; +} + +CommandBrokerStatus CommandBroker::result(uint8_t &handle, char *reply, size_t replySize) { + if (reply != NULL && replySize > 0) reply[0] = 0; + if (reply == NULL || replySize == 0) { handle = 0; return CB_FREE; } + if (!initialized) { handle = 0; return CB_FREE; } + + int8_t slot = handleToSlot(handle); + if (slot < 0) { handle = 0; return CB_FREE; } + + lock(); + CommandBrokerStatus state = handleValid(handle, slot) ? requests[slot].state : CB_FREE; + if (state == CB_DONE) { + sstrcpyex(reply, requests[slot].reply, replySize); + requests[slot].state = CB_FREE; + handle = 0; + } else if (state == CB_TIMEOUT) { + requests[slot].state = CB_FREE; + handle = 0; + } else if (state == CB_FREE) { + handle = 0; + } + unlock(); + return state; +} + +void CommandBroker::release(uint8_t handle) { + if (!initialized) return; + + int8_t slot = handleToSlot(handle); + if (slot < 0) return; + + lock(); + if (handleValid(handle, slot) && requests[slot].state != CB_SENT) requests[slot].state = CB_FREE; + unlock(); +} + +void CommandBroker::poll() { + if (!initialized) return; + + if (active < 0) { + lock(); + for (uint8_t i = 0; i < COMMAND_BROKER_SLOTS; i++) { + if (requests[i].state == CB_PENDING) { + if (requests[i].replyExpected) requests[i].deadline = millis() + requests[i].timeoutMs; + requests[i].state = CB_SENT; + active = i; + break; + } + } + unlock(); + + if (active >= 0) { + SERIAL_LOCAL.receive(); + SERIAL_LOCAL.transmit(requests[active].command); + if (!requests[active].replyExpected) { + lock(); + requests[active].state = CB_FREE; + active = -1; + unlock(); + } + } + } + + if (active < 0) return; + + if (SERIAL_LOCAL.receiveAvailable()) { + char *reply = SERIAL_LOCAL.receive(); + lock(); + sstrcpy(requests[active].reply, reply); + requests[active].state = CB_DONE; + active = -1; + unlock(); + } else { + lock(); + bool timedOut = requests[active].timeoutMs == 0 || (long)(millis() - requests[active].deadline) >= 0; + if (timedOut) { + requests[active].reply[0] = 0; + requests[active].state = CB_TIMEOUT; + active = -1; + } + unlock(); + } +} + +uint8_t CommandBroker::makeHandle(uint8_t slot) { + return ((requests[slot].generation & 0x0F) << 4) | ((slot + 1) & 0x0F); +} + +int8_t CommandBroker::handleToSlot(uint8_t handle) { + if (handle == 0) return -1; + + uint8_t slot = (handle & 0x0F) - 1; + if (slot >= COMMAND_BROKER_SLOTS) return -1; + return slot; +} + +bool CommandBroker::handleValid(uint8_t handle, uint8_t slot) { + return (requests[slot].generation & 0x0F) == (handle >> 4) && requests[slot].state != CB_FREE; +} + +void CommandBroker::lock() { + #ifdef ESP32 + xSemaphoreTake(mutex, portMAX_DELAY); + #else + noInterrupts(); + #endif +} + +void CommandBroker::unlock() { + #ifdef ESP32 + xSemaphoreGive(mutex); + #else + interrupts(); + #endif +} + +CommandBroker commandBroker; + +#endif diff --git a/src/libApp/commands/CommandBroker.h b/src/libApp/commands/CommandBroker.h new file mode 100755 index 0000000..abebf57 --- /dev/null +++ b/src/libApp/commands/CommandBroker.h @@ -0,0 +1,84 @@ +// ----------------------------------------------------------------------------------- +// Local command broker +#pragma once + +#include "../../Common.h" + +#if defined(SERIAL_LOCAL_MODE) && SERIAL_LOCAL_MODE == ON + +#ifndef COMMAND_BROKER_SLOTS + #define COMMAND_BROKER_SLOTS 8 +#endif + +#ifndef COMMAND_BROKER_COMMAND_LEN + #define COMMAND_BROKER_COMMAND_LEN 40 +#endif + +#ifndef COMMAND_BROKER_REPLY_LEN + #define COMMAND_BROKER_REPLY_LEN 80 +#endif + +#ifndef COMMAND_BROKER_TIMEOUT_MS + #define COMMAND_BROKER_TIMEOUT_MS 100 +#endif + +#if COMMAND_BROKER_SLOTS > 15 + #error "COMMAND_BROKER_SLOTS must be 15 or less." +#endif + +enum CommandBrokerStatus : uint8_t { + CB_FREE, + CB_PENDING, + CB_SENT, + CB_DONE, + CB_TIMEOUT +}; + +class CommandBroker { + public: + bool init(); + + // Queue commands here when a caller expects a reply. Do not mix brokered + // request/reply traffic with direct SERIAL_LOCAL.receive() calls. + uint8_t request(const char *command, unsigned long timeoutMs = COMMAND_BROKER_TIMEOUT_MS); + // Queue commands here only when no reply will be consumed. + bool send(const char *command); + + CommandBrokerStatus status(uint8_t handle); + inline bool ready(uint8_t handle) { return status(handle) == CB_DONE; } + inline bool timeout(uint8_t handle) { return status(handle) == CB_TIMEOUT; } + CommandBrokerStatus result(uint8_t &handle, char *reply, size_t replySize); + void release(uint8_t handle); + + void poll(); + + private: + struct Request { + CommandBrokerStatus state = CB_FREE; + char command[COMMAND_BROKER_COMMAND_LEN] = ""; + char reply[COMMAND_BROKER_REPLY_LEN] = ""; + unsigned long timeoutMs = COMMAND_BROKER_TIMEOUT_MS; + unsigned long deadline = 0; + bool replyExpected = true; + uint8_t generation = 0; + }; + + Request requests[COMMAND_BROKER_SLOTS]; + int8_t active = -1; + bool initialized = false; + + uint8_t enqueue(const char *command, unsigned long timeoutMs, bool replyExpected); + uint8_t makeHandle(uint8_t slot); + int8_t handleToSlot(uint8_t handle); + bool handleValid(uint8_t handle, uint8_t slot); + void lock(); + void unlock(); + + #ifdef ESP32 + SemaphoreHandle_t mutex = NULL; + #endif +}; + +extern CommandBroker commandBroker; + +#endif diff --git a/src/libApp/commands/ProcessCmds.cpp b/src/libApp/commands/ProcessCmds.cpp new file mode 100755 index 0000000..3cc25ba --- /dev/null +++ b/src/libApp/commands/ProcessCmds.cpp @@ -0,0 +1,315 @@ +// ----------------------------------------------------------------------------------- +// Command processing + +#include "../../Common.h" +#include "../../lib/tasks/OnTask.h" +#include "../../lib/convert/Convert.h" +#include "ProcessCmds.h" + +#include "../../telescope/Telescope.h" + +#ifdef MOUNT_PRESENT + #if ST4_INTERFACE == ON && ST4_HAND_CONTROL == ON + #include "../../lib/serial/Serial_ST4_Master.h" + #endif + #include "../../lib/serial/Serial_Local.h" +#endif +#ifdef SERIAL_LOCAL + #include "CommandBroker.h" +#endif + +#if DEBUG != OFF + #define L_CE_NONE "no errors" + #define L_CE_1 "no error true" + #define L_CE_0 "no error false/fail" + #define L_CE_CMD_UNKNOWN "command unknown" + #define L_CE_REPLY_UNKNOWN "invalid reply" + #define L_CE_PARAM_RANGE "parameter out of range" + #define L_CE_PARAM_FORM "bad parameter format" + #define L_CE_ALIGN_FAIL "align failed" + #define L_CE_ALIGN_NOT_ACTIVE "align not active" + #define L_CE_NOT_PARKED_OR_AT_HOME "not parked or at home" + #define L_CE_PARKED "already parked" + #define L_CE_PARK_FAILED "park failed" + #define L_CE_NOT_PARKED "not parked" + #define L_CE_NO_PARK_POSITION_SET "no park position set" + #define L_CE_SLEW_FAIL "goto failed" + #define L_CE_LIBRARY_FULL "library full" + #define L_CE_SLEW_ERR_BELOW_HORIZON "goto below horizon" + #define L_CE_SLEW_ERR_ABOVE_OVERHEAD "goto above overhead" + #define L_CE_SLEW_ERR_IN_STANDBY "slew in standby" + #define L_CE_SLEW_ERR_IN_PARK "slew in park" + #define L_CE_SLEW_ERR_SLEW "already in goto" + #define L_CE_SLEW_ERR_OUTSIDE_LIMITS "outside limits" + #define L_CE_SLEW_ERR_HARDWARE_FAULT "hardware fault" + #define L_CE_MOUNT_IN_MOTION "mount in motion" + #define L_CE_SLEW_ERR_UNSPECIFIED "other" + #define L_CE_UNK "unknown" + + static const char commandErrorStr[26][25] = { + L_CE_NONE, L_CE_1, L_CE_0, L_CE_CMD_UNKNOWN, L_CE_REPLY_UNKNOWN, L_CE_PARAM_RANGE, + L_CE_PARAM_FORM, L_CE_ALIGN_FAIL, L_CE_ALIGN_NOT_ACTIVE, L_CE_NOT_PARKED_OR_AT_HOME, + L_CE_PARKED, L_CE_PARK_FAILED, L_CE_NOT_PARKED, L_CE_NO_PARK_POSITION_SET, L_CE_SLEW_FAIL, + L_CE_LIBRARY_FULL, L_CE_SLEW_ERR_BELOW_HORIZON, L_CE_SLEW_ERR_ABOVE_OVERHEAD, + L_CE_SLEW_ERR_IN_STANDBY, L_CE_SLEW_ERR_IN_PARK, L_CE_SLEW_ERR_SLEW, L_CE_SLEW_ERR_OUTSIDE_LIMITS, + L_CE_SLEW_ERR_HARDWARE_FAULT, L_CE_MOUNT_IN_MOTION, L_CE_SLEW_ERR_UNSPECIFIED, L_CE_UNK + }; +#endif + +// command processors +#ifdef SERIAL_A + CommandProcessor processCommandsA(SERIAL_A_BAUD_DEFAULT,'A'); + void processCmdsA() { processCommandsA.poll(); } +#endif +#ifdef SERIAL_B + CommandProcessor processCommandsB(SERIAL_B_BAUD_DEFAULT,'B'); + void processCmdsB() { processCommandsB.poll(); } +#endif +#ifdef SERIAL_C + CommandProcessor processCommandsC(SERIAL_C_BAUD_DEFAULT,'C'); + void processCmdsC() { processCommandsC.poll(); } +#endif +#ifdef SERIAL_D + CommandProcessor processCommandsD(SERIAL_D_BAUD_DEFAULT,'D'); + void processCmdsD() { processCommandsD.poll(); } +#endif +#ifdef SERIAL_ST4 + CommandProcessor processCommandsST4(9600,'S'); + void processCmdsST4() { processCommandsST4.poll(); } +#endif +#if SERIAL_BT_MODE == SLAVE + CommandProcessor processCommandsBT(9600,'T'); + void processCmdsBT() { processCommandsBT.poll(); } +#endif +#ifdef SERIAL_PIP1 + CommandProcessor processCommandsPIP1(9600,'1'); + void processCmdsPIP1() { ::yield(); processCommandsPIP1.poll(); } +#endif +#ifdef SERIAL_PIP2 + CommandProcessor processCommandsPIP2(9600,'2'); + void processCmdsPIP2() { ::yield(); processCommandsPIP2.poll(); } +#endif +#ifdef SERIAL_PIP3 + CommandProcessor processCommandsPIP3(9600,'3'); + void processCmdsPIP3() { ::yield(); processCommandsPIP3.poll(); } +#endif +#ifdef SERIAL_SIP + CommandProcessor processCommandsIP(9600,'I'); + void processCmdsIP() { ::yield(); processCommandsIP.poll(); } +#endif +#ifdef SERIAL_LOCAL + CommandProcessor processCommandsLocal(9600,'L'); + void processCmdsLocal() { processCommandsLocal.poll(); } +#endif + +CommandProcessor::CommandProcessor(long baud, char channel) { + this->channel = channel; + serialBaud = baud; +} + +CommandProcessor::~CommandProcessor() { + SerialPort.end(); +} + +void CommandProcessor::poll() { + if (!serialReady) { delay(200); SerialPort.begin(serialBaud); serialReady = true; } + + unsigned long tout = micros() + 500; + while (SerialPort.available()) { char c = SerialPort.read(); buffer.add(c); if (buffer.ready() || (long)(micros() - tout) > 0) break; } + + if (buffer.ready()) { + char reply[80] = ""; + constexpr size_t replyCapacity = sizeof(reply); + bool numericReply = true; + bool suppressFrame = false; + + commandError = command(reply, buffer.getCmd(), buffer.getParameter(), &suppressFrame, &numericReply); + + if (numericReply) { + if (commandError != CE_NONE && commandError != CE_1) strcpy(reply,"0"); else strcpy(reply,"1"); + suppressFrame = true; + } + if (strlen(reply) > 0 || buffer.checksum) { + if (buffer.checksum) { + sstrreserveex(reply, 4, replyCapacity); + appendChecksum(reply, replyCapacity); + sstrcatcex(reply, buffer.getSeq()[0], replyCapacity); + suppressFrame = false; + } + if (!suppressFrame) { + sstrreserveex(reply, 1, replyCapacity); + sstrcatcex(reply, '#', replyCapacity); + } + SerialPort.write(reply); + } + + // debug, log errors and/or commands + #ifdef DEBUG_ECHO_COMMANDS_CH + if (DEBUG_ECHO_COMMANDS_CH == channel) { + #endif + #if DEBUG_ECHO_COMMANDS != OFF + if (DEBUG_ECHO_COMMANDS == ON || commandError > CE_0) { + DF("MSG: cmd"); D(channel); D(" = "); D(buffer.getCmd()); D(buffer.getParameter()); DF(", reply = "); D(reply); + } + #endif + if (commandError != CE_NULL) { + lastCommandError = commandError; + #if DEBUG_ECHO_COMMANDS != OFF + if (commandError > CE_0) { DF(", Error "); D(commandErrorStr[commandError]); } + #endif + } + #if DEBUG_ECHO_COMMANDS != OFF + if (DEBUG_ECHO_COMMANDS == ON || commandError > CE_0) { DL(""); } + #endif + #ifdef DEBUG_ECHO_COMMANDS_CH + } + #endif + + buffer.flush(); + } +} + +CommandError CommandProcessor::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply) { + commandError = CE_NONE; + + // handle telescope commands + if (telescope.command(reply, command, parameter, suppressFrame, numericReply, &commandError)) return commandError; + + // silent bool "errors" allow processing commands more than once + if (commandError == CE_0 || commandError == CE_1) return commandError; + + // (char)6 - Special + if (command[0] == (char)6) { + if (command[1] == '0') { + reply[0] = command[1]; + strcpy(reply,"CK_FAIL"); // last cmd checksum failed + } else { + reply[0] = command[1]; + reply[1] = 0; // Equatorial or Horizon mode, A or P + *suppressFrame = true; + } + *numericReply = false; + return commandError; + } else + + // :SB[n]# Set Baud Rate where n is an ASCII digit (1..9) with the following interpertation + // B=460.8K, A=230.4K, 0=115.2K, 1=56.7K, 2=38.4K, 3=28.8K, 4=19.2K, 5=14.4K, 6=9600, 7=4800, 8=2400, 9=1200 + // Returns: 1 (at the current baud rate and then changes to the new rate for further communication) + if (command[0] == 'S' && command[1] == 'B') { + int rate = parameter[0] - '0'; + if (parameter[0] == 'A') { + SerialPort.print("1"); + tasks.yield(50); + SerialPort.begin(230400); + *numericReply = false; + } else + if (parameter[0] == 'B') { + SerialPort.print("1"); + tasks.yield(50); + SerialPort.begin(460800); + *numericReply = false; + } else + if (rate >= 0 && rate <= 9) { + const static long baud[10] = {115200, 56700, 38400, 28800, 19200, 14400, 9600, 4800, 2400, 1200}; + SerialPort.print("1"); + tasks.yield(50); + SerialPort.begin(baud[rate]); + *numericReply = false; + } else commandError = CE_PARAM_RANGE; + return commandError; + } else + + // :GE# Get last command error numeric code + // Returns: CC# + if (command[0] == 'G' && command[1] == 'E' && parameter[0] == 0) { + sprintf(reply, "%02d", lastCommandError); + *numericReply = false; + return commandError; + } else + + return CE_CMD_UNKNOWN; +} + +void CommandProcessor::appendChecksum(char *s, size_t capacity) { + char HEXS[3] = ""; + uint8_t cks = 0; for (unsigned int cksCount0 = 0; cksCount0 < strlen(s); cksCount0++) { cks += s[cksCount0]; } + snprintf(HEXS, sizeof(HEXS), "%02X", cks); + sstrcatex(s, HEXS, capacity); +} + +void commandChannelInit() { + // Command processing + // add tasks to process commands + // period ms (0=idle), duration ms (0=forever), repeat, priority (highest 0..7 lowest), task_handle + uint8_t handle; + #ifdef HAL_SLOW_PROCESSOR + long comPollRate = 5000; + #else + long comPollRate = 2500; + #endif + #ifdef SERIAL_A + VF("MSG: System, start command channel A task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsA, "SysCmdA"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate); + #endif + #ifdef SERIAL_B + VF("MSG: System, start command channel B task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsB, "SysCmdB"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate); + #endif + #ifdef SERIAL_C + VF("MSG: System, start command channel C task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsC, "SysCmdC"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate); + #endif + #ifdef SERIAL_D + VF("MSG: System, start command channel D task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsD, "SysCmdD"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate); + #endif + #ifdef SERIAL_ST4 + VF("MSG: System, start command channel ST4 task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsST4, "SysCmdS"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate*4); + #endif + #if SERIAL_BT_MODE == SLAVE + VF("MSG: System, start command channel BT task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsBT, "SysCmdT"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate); + #endif + #ifdef SERIAL_PIP1 + VF("MSG: System, start command channel PIP1 task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsPIP1, "SysCmd1"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate); + #endif + #ifdef SERIAL_PIP2 + VF("MSG: System, start command channel PIP2 task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsPIP2, "SysCmd2"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate); + #endif + #ifdef SERIAL_PIP3 + VF("MSG: System, start command channel PIP3 task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsPIP3, "SysCmd3"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate); + #endif + #ifdef SERIAL_SIP + VF("MSG: System, start command channel IP task (priority 5)... "); + handle = tasks.add(0, 0, true, 5, processCmdsIP, "SysCmdI"); + if (handle) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handle, comPollRate); + #endif + #ifdef SERIAL_LOCAL + VF("MSG: System, start command channel Local task (priority 5)... "); + if (tasks.add(3, 0, true, 5, processCmdsLocal, "SysCmdL")) { VLF("success"); } else { VLF("FAILED!"); } + commandBroker.init(); + #endif +} diff --git a/src/libApp/commands/ProcessCmds.h b/src/libApp/commands/ProcessCmds.h new file mode 100755 index 0000000..cc22b2a --- /dev/null +++ b/src/libApp/commands/ProcessCmds.h @@ -0,0 +1,36 @@ +// ----------------------------------------------------------------------------------- +// Command processing +#pragma once + +#include +#include "../../lib/commands/BufferCmds.h" +#include "../../lib/commands/SerialWrapper.h" +#include "../../lib/commands/CommandErrors.h" + +class CommandProcessor { + public: + // start and stop the serial port for the associated command channel + CommandProcessor(long baud, char channel); + ~CommandProcessor(); + + // check for incomming commands and send responses + void poll(); + + // pass along commands as required for processing + CommandError command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply); + + private: + void logErrors(char *cmd, char *param, char *reply, CommandError e); + void appendChecksum(char *s, size_t capacity); + + CommandError commandError = CE_NONE; + CommandError lastCommandError = CE_NONE; + bool serialReady = false; + long serialBaud = 9600; + char channel = '?'; + + Buffer buffer; + SerialWrapper SerialPort; +}; + +extern void commandChannelInit(); diff --git a/src/libApp/temperature/Ds1820.cpp b/src/libApp/temperature/Ds1820.cpp new file mode 100755 index 0000000..06234b5 --- /dev/null +++ b/src/libApp/temperature/Ds1820.cpp @@ -0,0 +1,150 @@ +// ----------------------------------------------------------------------------------- +// Dallas/Maxim 1-Wire DS1820 device support + +#include "Ds1820.h" + +#ifdef DS1820_DEVICES_PRESENT + +#include "../../lib/tasks/OnTask.h" + +#include "../../lib/1wire/1Wire.h" +#include // my Dallas Temperature library https://github.com/hjd1964/Arduino-DS1820-Temperature-Library +DallasTemperature DS18X20(&oneWire); + +#include "../weather/Weather.h" + +void ds1820Wrapper() { temperature.poll(); } + +// scan for DS18B20 devices on the 1-wire bus and prepare for operation +bool Ds1820::init() { + static bool initialized = false; + if (initialized) return found; + + // clear then pre-load any user defined DS1820 addresses + deviceCount = 0; + for (int i = 0; i < 9; i++) { + // check that it's not OFF and also not an (auto assigned) DS1820, so must be an DS1820 address + if (device[i] != (uint64_t)OFF && device[i] != DS1820) { + for (int j = 0; j < 8; j++) address[i][j] = (device[i] >> (7 - j)*8) & 0xff; + deviceCount++; + } else for (int j = 0; j < 8; j++) address[i][j] = 0; + } + + // scan the 1-wire bus and record the devices found + oneWire.reset_search(); + + // only search out DS1820's IF none are explicitly specified + bool search = deviceCount == 0; + #if DEBUG == VERBOSE + bool detected = false; + #endif + + VLF("*********************************************"); + VLF("MSG: Dallas/Maxim 1-wire DS1820 device s/n's:"); + + int index = 0; + uint8_t addressfound[8] = { 0, 0, 0, 0, 0, 0, 0, 0 }; + while (oneWire.search(addressfound)) { + if (oneWire.crc8(addressfound, 7) == addressfound[7]) { + if (addressfound[0] == 0x10 || addressfound[0] == 0x28) { + if (search) { + if (index <= 8) { while (device[index] != DS1820 && index <= 8) index++; } + if (index <= 8) { for (int j = 0; j < 8; j++) { address[index][j] = addressfound[j]; deviceCount++; } } + index++; + } + + #if DEBUG == VERBOSE + if (addressfound[0] == 0x10) { VF("DS18S20: 0x"); } else { VF("DS18B20: 0x"); } + for (int i = 0; i < 8; i++) { + if (addressfound[i] < 16) { V("0"); } + if (DEBUG != OFF) SERIAL_DEBUG.print(addressfound[i], HEX); + } + if (search) { + if (index == 1) { VLF(" auto-assigned to FOCUSER_TEMPERATURE"); } else + if (index <= 9) { VF(" auto-assigned to FEATURE"); V(index - 1); VLF("_TEMP"); } else { VLF(" not assigned"); } + } else { VLF(" auto-assign disabled"); } + detected = true; + #endif + } + } + } + + #if DEBUG == VERBOSE + if (!detected) { VLF("No DS1820 devices found"); } + #endif + + VLF("*********************************************"); + + DS18X20.setWaitForConversion(false); + if (deviceCount > 0) { + found = true; + VF("MSG: Temperature, start DS1820 monitor task (rate 250ms priority 7)... "); + if (tasks.add(250, 0, true, 7, ds1820Wrapper, "ds1820")) { VLF("success"); } else { VLF("FAILED!"); } + } else found = false; + + initialized = true; + return found; +} + +// read devices +void Ds1820::poll() { + static int index = -1; + static unsigned long requestTime = 0; + + if (found) { + if (index < 0) { requestTime = millis(); if (DS18X20.requestTemperatures(true)) index++; } + if (millis() - requestTime < 200U) return; + + if (device[index] != (uint64_t)OFF) { + // loop to read the temperature + // tasks.yield() during the 1-wire command sequence is ok since: + // 1. only higher priority level tasks are allowed to run during a yield + // 2. all 1-wire task polling is run at the lowest priority level + float rawTemperature = NAN; + for (int i = 0; i < 22; i++) { + rawTemperature = DS18X20.getTempC(address[index], true); + if (polling(rawTemperature)) tasks.yield(2); else break; + } + + float temperature = validated(rawTemperature); + if (!isnan(temperature)) { + if (isnan(averageTemperature[index])) averageTemperature[index] = temperature; + averageTemperature[index] = (averageTemperature[index]*9.0F + temperature)/10.0F; + goodUntil[index] = millis() + 30000U; + } else { + // we must get a reading at least once every 30 seconds otherwise flag the failure with a NAN + if ((long)(millis() - goodUntil[index]) > 0) averageTemperature[index] = NAN; + } + } + } + index++; + if (index > 8) index = -1; +} + +// nine temperature sensors are supported, this gets the averaged temperature +// in deg. C otherwise it falls back to the weather sensor temperature +// index 0 is the ambient temperature, 1 through 8 are point temperatures #1, #2, etc. +// returns NAN if no temperature source is available or if a communications failure +// results in no valid readings for > 30 seconds +float Ds1820::getChannel(int index) { + if (found && index >= 0 && index <= 7) { + if (device[index] == (uint64_t)OFF) averageTemperature[index] = weather.getTemperature(); + return averageTemperature[index]; + } else return NAN; +} + +// checks for polling status code from DS1820 library +bool Ds1820::polling(float f) { + return (fabs(f - DEVICE_POLLING_C) < 0.001F); +} + +// checks for validated status code from DS1820 library +float Ds1820::validated(float f) { + if (fabs(f - DEVICE_DISCONNECTED_C) < 0.001F) return NAN; + if (f < -100 || f > 70) return NAN; + return f; +} + +Ds1820 temperature; + +#endif diff --git a/src/libApp/temperature/Ds1820.h b/src/libApp/temperature/Ds1820.h new file mode 100755 index 0000000..8763213 --- /dev/null +++ b/src/libApp/temperature/Ds1820.h @@ -0,0 +1,42 @@ +// ----------------------------------------------------------------------------------- +// Dallas/Maxim 1-Wire DS1820 device support +#pragma once + +#include "../../Common.h" + +#ifdef DS1820_DEVICES_PRESENT + +class Ds1820 { + public: + // scan for DS18B20 devices on the 1-wire bus and prepare for operation + bool init(); + + // read devices + void poll(); + + // nine temperature sensors are supported, this gets the averaged + // temperature in deg. C otherwise it falls back to the weather sensor temperature + // index 0 is the ambient temperature, 1 through 8 are point temperatures #1, #2, etc. + // returns NAN if no temperature source is available or if a communications failure + // results in no valid readings for > 30 seconds + float getChannel(int index); + + private: + // checks for polling status code from DS1820 library + bool polling(float f); + + // checks for validated status code from DS1820 library + float validated(float f); + + bool found = false; + uint8_t deviceCount = 0; + uint8_t address[9][8]; + uint64_t device[9] = { (uint64_t)FOCUSER_TEMPERATURE, (uint64_t)FEATURE1_TEMP, (uint64_t)FEATURE2_TEMP, (uint64_t)FEATURE3_TEMP, (uint64_t)FEATURE4_TEMP, (uint64_t)FEATURE5_TEMP, (uint64_t)FEATURE6_TEMP, (uint64_t)FEATURE7_TEMP, (uint64_t)FEATURE8_TEMP }; + + float averageTemperature[9] = { NAN, NAN, NAN, NAN, NAN, NAN, NAN, NAN, NAN }; + unsigned long goodUntil[9] = { 0, 0, 0, 0, 0, 0, 0, 0, 0 }; +}; + +extern Ds1820 temperature; + +#endif diff --git a/src/libApp/temperature/Temperature.cpp b/src/libApp/temperature/Temperature.cpp new file mode 100755 index 0000000..c0871b0 --- /dev/null +++ b/src/libApp/temperature/Temperature.cpp @@ -0,0 +1,21 @@ +// ----------------------------------------------------------------------------------- +// Spot temperature measurements + +#include "Temperature.h" + +#ifdef TEMPERATURE_PRESENT + +#include "../weather/Weather.h" + +bool Temperature::init() { + return false; +} + +float Temperature::getChannel(int index) { + UNUSED(index); + return weather.getTemperature(); +} + +Temperature temperature; + +#endif diff --git a/src/libApp/temperature/Temperature.h b/src/libApp/temperature/Temperature.h new file mode 100755 index 0000000..bca5cb8 --- /dev/null +++ b/src/libApp/temperature/Temperature.h @@ -0,0 +1,27 @@ +// ----------------------------------------------------------------------------------- +// Spot temperature measurements +#pragma once + +#include "../../Common.h" + +#include "Ds1820.h" +#ifndef DS1820_DEVICES_PRESENT + +#include "Thermistor.h" +#ifndef THERMISTOR_DEVICES_PRESENT + +#define TEMPERATURE_PRESENT + +class Temperature { + public: + bool init(); + + float getChannel(int index); + + private: +}; + +extern Temperature temperature; + +#endif +#endif diff --git a/src/libApp/temperature/Thermistor.cpp b/src/libApp/temperature/Thermistor.cpp new file mode 100755 index 0000000..4964850 --- /dev/null +++ b/src/libApp/temperature/Thermistor.cpp @@ -0,0 +1,135 @@ +// ----------------------------------------------------------------------------------- +// Thermistor device support + +#include "Thermistor.h" + +#ifdef THERMISTOR_DEVICES_PRESENT + +#include "../../lib/tasks/OnTask.h" + +#include "../weather/Weather.h" + +#ifndef ANALOG_READ_RANGE + #define ANALOG_READ_RANGE 1023 +#endif + +void thermistorWrapper() { temperature.poll(); } + +// prepare for operation +bool Thermistor::init() { + static bool initialized = false; + if (initialized) return found; + + deviceCount = 1; + + if (deviceCount > 0) { + found = true; + VF("MSG: Temperature, start Thermistor monitor task (rate 500ms priority 6)... "); + if (tasks.add(500, 0, true, 6, thermistorWrapper, "therm")) { VLF("success"); } else { VLF("FAILED!"); } + } else found = false; + + found = true; + initialized = true; + + return found; +} + +// read devices, designed for a 0.5s polling interval +void Thermistor::poll() { + static int index = 0; + + if (found) { + int thermistorType = -1; + if (device[index] == THERMISTOR1) thermistorType = 0; else + if (device[index] == THERMISTOR2) thermistorType = 1; + + if (thermistorType >= 0 && devicePin[index] != OFF) { + + #ifdef ESP32 + float voltage = analogReadMilliVolts(devicePin[index])/1000.0F; + #else + float voltage = (analogRead(devicePin[index])/(float)ANALOG_READ_RANGE)*HAL_VCC; + #endif + + // calculate the device resistance + float resistance = NAN; + + const float eps = 0.001F; // 1 mV + if (voltage > eps && voltage < (HAL_VCC - eps)) { + + // handle special case where we add a resistor (say 10k) parallel to the thermistor (say 10k 3950) + #if defined(THERMISTOR_RPARALLEL_NEW) + float Req = settings[thermistorType].rSeries*(voltage/(HAL_VCC - voltage)); + float inv = (1.0F/Req) - (1.0F/THERMISTOR_RPARALLEL_NEW); + resistance = (inv > 0.0F) ? (1.0F/inv) : NAN; + + #elif defined(THERMISTOR_RPARALLEL) + float RtLow = settings[thermistorType].rNom/30.0F; + float RtHigh = settings[thermistorType].rNom*30.0F; + float Rpr = 1.0F/THERMISTOR_RPARALLEL; + bool vOutLowChanged = true; + bool vOutHighChanged = true; + float vOutLow, vOutHigh; + for (int i = 0; i < 100; i++) { + if (vOutLowChanged) { + resistance = 1.0F/(Rpr + 1.0F/RtLow); + vOutLow = HAL_VCC * (resistance/(settings[thermistorType].rSeries + resistance)); + vOutLowChanged = false; + } + if (vOutHighChanged) { + resistance = 1.0F/(Rpr + 1.0F/RtHigh); + vOutHigh = HAL_VCC * (resistance/(settings[thermistorType].rSeries + resistance)); + vOutHighChanged = false; + } + if (voltage < vOutLow) { RtLow /= 1.5F; vOutLowChanged = true; } else + if (voltage > vOutHigh) { RtHigh *= 1.5F; vOutHighChanged = true; } else + if (voltage > (vOutLow + vOutHigh)/2.0F) { RtLow = (RtLow*4.0F + RtHigh)/5.0F; vOutLowChanged = true; } else + if (voltage < (vOutLow + vOutHigh)/2.0F) { RtHigh = (RtLow + RtHigh*4.0F)/5.0F; vOutHighChanged = true; }; + } + resistance = 1.0F/((1.0F/resistance) - Rpr); + #else + // standard thermistor with pullup (say 10k 3950) + resistance = settings[thermistorType].rSeries*(voltage/(HAL_VCC - voltage)); + #endif + } + + // convert to temperature in degrees C + float f = log(resistance/settings[thermistorType].rNom)/settings[thermistorType].beta; + f += 1.0F/(settings[thermistorType].tNom + 273.15F); + float temperature = 1.0F/f - 273.15F; + + // constrain to a reasonable range, outside of this something is definately wrong + if (temperature < THERMISTOR_TEMPERATURE_MINIMUM || temperature > THERMISTOR_TEMPERATURE_MAXIMUM) temperature = NAN; + + // do a running average on the temperature + if (!isnan(temperature)) { + if (isnan(averageTemperature[index])) averageTemperature[index] = temperature; + averageTemperature[index] = (averageTemperature[index]*19.0F + temperature)/20.0F; + goodUntil[index] = millis() + 30000U; + } else { + // we must get a reading at least once every 30 seconds otherwise flag the failure with a NAN + if ((long)(millis() - goodUntil[index]) > 0) averageTemperature[index] = NAN; + } + + } + } + + index++; + if (index > 8) index = 0; +} + +// nine temperature sensors are supported, this gets the averaged temperature +// in deg. C otherwise it falls back to the weather sensor temperature +// index 0 is the ambient temperature, 1 through 8 are point temperatures #1, #2, etc. +// returns NAN if no temperature source is available or if a communications failure +// results in no valid readings for > 30 seconds +float Thermistor::getChannel(int index) { + if (found && index >= 0 && index <= 7) { + if (device[index] == (uint64_t)OFF) averageTemperature[index] = weather.getTemperature(); + return averageTemperature[index]; + } else return NAN; +} + +Thermistor temperature; + +#endif diff --git a/src/libApp/temperature/Thermistor.h b/src/libApp/temperature/Thermistor.h new file mode 100755 index 0000000..ce3f66c --- /dev/null +++ b/src/libApp/temperature/Thermistor.h @@ -0,0 +1,56 @@ +// ----------------------------------------------------------------------------------- +// Thermistor device support +#pragma once + +#include "../../Common.h" + +#ifdef THERMISTOR_DEVICES_PRESENT + +#ifndef THERMISTOR_TEMPERATURE_MINIMUM + #define THERMISTOR_TEMPERATURE_MINIMUM -30.0F +#endif + +#ifndef THERMISTOR_TEMPERATURE_MAXIMUM + #define THERMISTOR_TEMPERATURE_MAXIMUM 60.0F +#endif + +typedef struct ThermistorSettings { + float tNom; + float rNom; + float beta; + float rSeries; +} ThermistorSettings; + +class Thermistor { + public: + // prepare for operation + bool init(); + + // read devices, designed for a 0.1s polling interval + void poll(); + + // nine temperature sensors are supported, this gets the averaged + // temperature in deg. C otherwise it falls back to the weather sensor temperature + // index 0 is the ambient temperature, 1 through 8 are point temperatures #1, #2, etc. + // returns NAN if no temperature source is available or if a communications failure + // results in no valid readings for > 30 seconds + float getChannel(int index); + + private: + bool found = false; + uint8_t deviceCount = 0; + uint64_t device[9] = { (uint64_t)FOCUSER_TEMPERATURE, (uint64_t)FEATURE1_TEMP, (uint64_t)FEATURE2_TEMP, (uint64_t)FEATURE3_TEMP, (uint64_t)FEATURE4_TEMP, (uint64_t)FEATURE5_TEMP, (uint64_t)FEATURE6_TEMP, (uint64_t)FEATURE7_TEMP, (uint64_t)FEATURE8_TEMP }; + int16_t devicePin[9] = { FOCUSER_TEMPERATURE_PIN, FEATURE1_TEMPERATURE_PIN, FEATURE2_TEMPERATURE_PIN, FEATURE3_TEMPERATURE_PIN, FEATURE4_TEMPERATURE_PIN, FEATURE5_TEMPERATURE_PIN, FEATURE6_TEMPERATURE_PIN, FEATURE7_TEMPERATURE_PIN, FEATURE8_TEMPERATURE_PIN }; + + float averageTemperature[9] = { NAN, NAN, NAN, NAN, NAN, NAN, NAN, NAN, NAN }; + unsigned long goodUntil[9] = { 0, 0, 0, 0, 0, 0, 0, 0, 0 }; + + ThermistorSettings settings[2] = { + { THERMISTOR1_TNOM, THERMISTOR1_RNOM, THERMISTOR1_BETA, THERMISTOR1_RSERIES }, + { THERMISTOR2_TNOM, THERMISTOR2_RNOM, THERMISTOR2_BETA, THERMISTOR2_RSERIES } + }; +}; + +extern Thermistor temperature; + +#endif diff --git a/src/libApp/weather/Weather.cpp b/src/libApp/weather/Weather.cpp new file mode 100755 index 0000000..6bdf5f0 --- /dev/null +++ b/src/libApp/weather/Weather.cpp @@ -0,0 +1,204 @@ +// ----------------------------------------------------------------------------------------------------------------------------- +// Weather related functions + +#include "Weather.h" + +#include "../../lib/tasks/OnTask.h" + +extern bool xBusy; + +#if WEATHER == BME280 || WEATHER == BME280_0x76 || WEATHER == BME280_SPI + #include // https://github.com/adafruit/Adafruit_BME280_Library + // and https://github.com/adafruit/Adafruit_Sensor + #if WEATHER == BME280 + #define BME_ADDRESS 0x77 + Adafruit_BME280 bmx; + #elif WEATHER == BME280_0x76 + #define BME_ADDRESS 0x76 + Adafruit_BME280 bmx; + #elif WEATHER == BME280_SPI && defined(SSPI_SHARED) + Adafruit_BME280 bmx(BMx280_CS_PIN, SSPI_MOSI, SSPI_MISO, SSPI_SCK); // software SPI + #elif WEATHER == BME280_SPI + Adafruit_BME280 bmx(BMx280_CS_PIN); // hardware SPI + #endif +#endif + +// BMP280 is the BME280 without humidity +#if WEATHER == BMP280 || WEATHER == BMP280_0x76 || WEATHER == BMP280_SPI + #include // https://github.com/adafruit/Adafruit_BMP280_Library + // and https://github.com/adafruit/Adafruit_Sensor + #if WEATHER == BMP280 + #define BMP_ADDRESS 0x77 + Adafruit_BMP280 bmx(&HAL_WIRE); + #elif WEATHER == BMP280_0x76 + #define BMP_ADDRESS 0x76 + Adafruit_BMP280 bmx(&HAL_WIRE); + #elif WEATHER == BMP280_SPI + Adafruit_BMP280 bmx(BMx280_CS_PIN); // hardware SPI + #endif +#endif + +void weatherPollWrapper() { weather.poll(); } + +bool Weather::init() { + #if WEATHER != OFF + success = false; + #if WEATHER == BME280 || WEATHER == BME280_0x76 + if (bmx.begin(BME_ADDRESS, &HAL_WIRE)) { + bmx.setSampling(Adafruit_BME280::MODE_FORCED, Adafruit_BME280::SAMPLING_X1, Adafruit_BME280::SAMPLING_X1, Adafruit_BME280::SAMPLING_X1, Adafruit_BME280::FILTER_OFF); + weatherSensor = WS_BME280; success = true; + } else { DF("WRN: Weather.init(), BME280 (I2C 0x"); if (DEBUG != OFF) SERIAL_DEBUG.print(BME_ADDRESS, HEX); DLF(") not found"); } + #elif WEATHER == BMP280 || WEATHER == BMP280_0x76 + if (bmx.begin(BMP_ADDRESS)) { + bmx.setSampling(Adafruit_BMP280::MODE_FORCED, Adafruit_BMP280::SAMPLING_X1, Adafruit_BMP280::SAMPLING_X1, Adafruit_BMP280::FILTER_OFF); + weatherSensor = WS_BMP280; success = true; + } else { DF("WRN: Weather.init(), BMP280 (I2C 0x"); if (DEBUG != OFF) SERIAL_DEBUG.print(BMP_ADDRESS, HEX); DLF(") not found"); } + #elif WEATHER == BME280_SPI + if (bmx.begin()) { + bmx.setSampling(Adafruit_BME280::MODE_FORCED, Adafruit_BME280::SAMPLING_X1, Adafruit_BME280::SAMPLING_X1, Adafruit_BME280::SAMPLING_X1, Adafruit_BME280::FILTER_OFF); + weatherSensor = WS_BME280; success = true; + } else { DLF("WRN: Weather.init(), BME280 (SPI) not found"); } + #elif WEATHER == BMP280_SPI + if (bmx.begin()) { + bmx.setSampling(Adafruit_BMP280::MODE_FORCED, Adafruit_BMP280::SAMPLING_X1, Adafruit_BMP280::SAMPLING_X1, Adafruit_BMP280::FILTER_OFF); + weatherSensor = WS_BMP280; success = true; + } else { DLF("WRN: Weather.init(), BMP280 (SPI) not found"); } + #else + #error "Configuration: Setting WEATHER unknown sensor value!" + #endif + + // follow any I2C device in-library init with a reset of the I2C bus speed + #if WEATHER == BME280 || WEATHER == BME280_0x76 || WEATHER == BMP280_0x76 || WEATHER == BMP280 + #ifdef HAL_WIRE_RESET_AFTER_CONNECT + HAL_WIRE.end(); + HAL_WIRE.begin(); + HAL_WIRE_SET_CLOCK(); + #endif + #endif + + if (success) { + VF("MSG: Weather, start weather monitor task (rate 5000ms priority 7)... "); + if (tasks.add(1000, 0, true, 7, weatherPollWrapper, "WeaPoll")) { VLF("success"); } else { VLF("FAILED!"); } + } + #else + success = true; + #endif + return success; +} + +// poll the weather sensor once every 5 seconds +void Weather::poll() { + #if WEATHER != OFF + if (success && !xBusy) { + static int phase = 0; + switch (++phase) { + case 1: + temperature = bmx.readTemperature(); + if (!isnan(temperature) && (temperature < -60.0F || temperature > 60.0F)) temperature = NAN; + return; + break; + case 2: + pressure = bmx.readPressure()/100.0F; + if (!isnan(pressure) && (pressure < 100.0F || pressure > 1100.0F)) pressure = NAN; + return; + break; + case 3: + #if WEATHER == BME280 || WEATHER == BME280_0x76 || WEATHER == BME280_SPI + humidity = bmx.readHumidity(); + if (!isnan(humidity) && (humidity < 0.0F || humidity > 100.0F)) humidity = NAN; + #endif + phase = 0; + break; + } + bmx.takeForcedMeasurement(); + + // if any measurements are anomalous assume all are invalid + #if WEATHER == BME280 || WEATHER == BME280_0x76 || WEATHER == BME280_SPI + if (isnan(temperature) || isnan(pressure) || isnan(humidity)) { + temperature = NAN; + pressure = NAN; + humidity = NAN; + } + #else + if (isnan(temperature) || isnan(pressure)) { + temperature = NAN; + pressure = NAN; + } + #endif + + // apply a 10 sample rolling average to the ambient temperature + static uint8_t nanCount = 0; + static bool firstSample = true; + if (firstSample) { + firstSample = false; + averageTemperature = temperature; + } + + if (!isnan(temperature)) { + nanCount = 0; + averageTemperature = (averageTemperature*9.0F + temperature)/10.0F; + } else { + if (nanCount < 15) { + nanCount++; + DLF("WRN: Weather.poll(), ambient temp. invalid"); + } else { + averageTemperature = NAN; + firstSample = true; + DLF("WRN: Weather.poll(), ambient temp. reset"); + } + } + } + #if WEATHER_SUPRESS_ERRORS == OFF + else { temperature = NAN; pressure = NAN; humidity = NAN; } + #endif + #endif +} + +// get temperature in deg. C +float Weather::getTemperature() { + return averageTemperature; +} + +// set temperature in deg. C +bool Weather::setTemperature(float t) { + if (weatherSensor == WS_NONE) { + if (t >= -60.0F && t <= 60.0F) { temperature = t; averageTemperature = t; } else return false; + } + return true; +} + +// get barometric pressure in hPa/mb +float Weather::getPressure() { + return pressure; +} + +// set barometric pressure in hPa/mb +bool Weather::setPressure(float p) { + if (weatherSensor == WS_NONE) { + if (p >= 100.0F && p <= 1100.0F) pressure = p; else return false; + } + return true; +} + +// get relative humidity in % +float Weather::getHumidity() { + return humidity; +} + +// set relative humidity in % +bool Weather::setHumidity(float h) { + if (weatherSensor == WS_NONE || weatherSensor == WS_BMP280) { + if (h >= 0.0F && h <= 100.0F) humidity = h; else return false; + } + return true; +} + +// get dew point in deg. C +// accurate to +/- 1 deg. C for RH above 50% +float Weather::getDewPoint() { + return averageTemperature - ((100.0F - humidity)/5.0F); + // a more accurate formula? + // return 243.04*(log(humidity/100.0) + ((17.625*averageTemperature)/(243.04 + averageTemperature)))/(17.625 - log(humidity/100.0) - ((17.625*averageTemperature)/(243.04 + averageTemperature))); +} + +Weather weather; diff --git a/src/libApp/weather/Weather.h b/src/libApp/weather/Weather.h new file mode 100755 index 0000000..1633db5 --- /dev/null +++ b/src/libApp/weather/Weather.h @@ -0,0 +1,49 @@ +// ----------------------------------------------------------------------------------------------------------------------------- +// Weather related functions +#pragma once + +#include "../../Common.h" + +enum WeatherSensor: uint8_t {WS_NONE, WS_BMP280, WS_BME280}; + +class Weather { + public: + bool init(); + + // designed for a 2s polling interval + void poll(); + + // get temperature in deg. C + float getTemperature(); + + // set temperature in deg. C + bool setTemperature(float t); + + // get barometric pressure in hPa/mb + float getPressure(); + + // get barometric pressure in hPa/mb + bool setPressure(float p); + + // get relative humidity in % + float getHumidity(); + + // set relative humidity in % + bool setHumidity(float h); + + // get dew point in deg. C + // accurate to +/- 1 deg. C for RH above 50% + float getDewPoint(); + + private: + WeatherSensor weatherSensor = WS_NONE; + + bool success = false; + + float temperature = NAN; + float averageTemperature = NAN; + float pressure = NAN; + float humidity = NAN; +}; + +extern Weather weather; diff --git a/src/pinmaps/Models.h b/src/pinmaps/Models.h new file mode 100755 index 0000000..e9512ad --- /dev/null +++ b/src/pinmaps/Models.h @@ -0,0 +1,101 @@ +// ------------------------------------------------------------------------------------------------- +// Loads pinmap model for current configuration +#pragma once + +#if PINMAP == MiniPCB + #define PINMAP_STR "MiniPCB v1" + #include "Pins.MiniPCB.h" +#endif +#if PINMAP == MiniPCB13 + #define PINMAP_STR "MiniPCB v1.3" + #include "Pins.MiniPCB.h" +#endif +#if PINMAP == MiniPCB2 + #define PINMAP_STR "MiniPCB v2" + #include "Pins.MiniPCB.h" +#endif +#if PINMAP == MaxPCB + #define PINMAP_STR "MaxPCB v1" + #include "Pins.MaxPCB.h" +#endif +#if PINMAP == MaxPCB2 + #define PINMAP_STR "MaxPCB v2" + #include "Pins.MaxPCB.h" +#endif +#if PINMAP == MaxPCB3 + #ifdef ARDUINO_TEENSY41 + #define PINMAP_STR "MaxPCB v3.6" + #include "Pins.MaxPCB36.h" + #else + #define PINMAP_STR "MaxPCB v3" + #include "Pins.MaxPCB3.h" + #endif +#endif +#if PINMAP == MaxPCB4 + #define PINMAP_STR "MaxPCB v4" + #include "Pins.MaxPCB4.h" +#endif +#if PINMAP == MaxESP3 + #define PINMAP_STR "MaxESP v3" + #include "Pins.MaxESP3.h" +#endif +#if PINMAP == MaxESP4 + #define PINMAP_STR "MaxESP v4" + #include "Pins.MaxESP4.h" +#endif +#if PINMAP == CNC3 + #define PINMAP_STR "CNC v3" + #include "Pins.CNC3.h" +#endif +#if PINMAP == MicroScope // Experimental and may be removed at any point! USE AY YOUR OWN RISK!!! + #define PINMAP_STR "MicroScope v0.2" + #include "Pins.MicroScope.h" +#endif +#if PINMAP == STM32Blue + #define PINMAP_STR "STM32 Bluepill" + #include "Pins.STM32B.h" +#endif +#if PINMAP == FYSETC_E4 + #define PINMAP_STR "FYSETC E4" + #include "Pins.FYSETC_E4.h" +#endif +#if PINMAP == FYSETC_S6 + #define PINMAP_STR "FYSETC S6" + #include "Pins.FYSETC_S6.h" +#endif +#if PINMAP == FYSETC_S6_2 + #define PINMAP_STR "FYSETC S6 v2" + #include "Pins.FYSETC_S6.h" +#endif +#if PINMAP == BTT_SKR_PRO + #define PINMAP_STR "BTT SKR PRO v1.2" + #include "Pins.SKR_PRO.h" +#endif +#if PINMAP == BTT_OCTOPUS_PRO + #define PINMAP_STR "BTT OCTOPUS PRO v1.1" + #include "Pins.OctopusPro.h" +#endif +#if PINMAP == JTWSTM + #define PINMAP_STR "JTWSTM v2.1" + #include "Pins.JTWPCB2.h" +#endif +#if PINMAP == MANTICORE + #define PINMAP_STR "JTW MANTICORE v1.0" + #include "Pins.Manticore.h" +#endif +#if PINMAP == MaxSTM3 || PINMAP == MaxSTM3I + #define PINMAP_STR "MaxSTM v3" + #include "Pins.MaxSTM.h" +#endif +#if PINMAP == SAL_XB1 + #define PINMAP_STR "SAL-XB1" + #include "Pins.SAL_XB1.h" +#endif +#ifndef PINMAP_STR + #define PINMAP_STR "Unknown" +#endif + +// all unassigned pins OFF +#include "Pins.defaults.h" + +#include "Validate.h" \ No newline at end of file diff --git a/src/pinmaps/Pins.CNC3.h b/src/pinmaps/Pins.CNC3.h new file mode 100755 index 0000000..b12a100 --- /dev/null +++ b/src/pinmaps/Pins.CNC3.h @@ -0,0 +1,130 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for CNC Shield Version 3 (with WeMos D1 R32) +#pragma once + +// Note: SPI for TMC drivers: GPIO32 (MOSI), GPIO33 (SCK), GPIO15 (CS Axis1) +// on WeMos D1 R32 PCB are somewhat difficult to wire into, but optional +// GPIO18 (CS Axis2) is on top + +#if defined(ESP32) + +// Serial0: RX Pin GPIO3, TX Pin GPIO1 (to USB serial adapter) +// Serial1: RX1 Pin GPIO10, TX1 Pin GPIO9 (on SPI Flash pins, must be moved to be used) +// Serial2: RX2 Pin GPIO13, TX2 Pin GPIO5 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial2 + #define SERIAL_B_RX 13 + #define SERIAL_B_TX 5 +#endif + +// Uses default ESP32 I2C GPIO21 (SDA) and GPIO22 (SCL) + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX2_PIN 18 // ESP8266 RST control, or SPI MISO Axis1&2 +#define AUX3_PIN 21 // Home SW for Axis1, or I2C SDA {assuming default SCL/SDA pins are present} +#define AUX4_PIN 22 // Home SW for Axis2, or I2C SCL +#define AUX7_PIN 39 // Limit SW, PPS, etc. +#define AUX8_PIN 23 // 1-Wire, Status LED1, Status LED2, Reticle LED, etc. + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX8_PIN // Default Pin for 1-wire bus +#endif +#define ADDON_GPIO0_PIN 27 // ESP8266 GPIO0 (Dir2) +#define ADDON_RESET_PIN AUX2_PIN // ESP8266 RST + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN 36 // [input only 36] (also analog A0) +#endif + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif +#define MOUNT_LED_PIN STATUS_LED_PIN // Default LED Cathode (-) +#define RETICLE_LED_PIN STATUS_LED_PIN // Default LED Cathode (-) + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN 2 // [must be low at boot 2] +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN AUX7_PIN // PPS time source, GPS for example +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX7_PIN +#endif + +#define SHARED_DIRECTION_PINS // Hint that the direction pins are shared +#define SHARED_ENABLE_PIN 12 // Hint that the enable pins are shared + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN SHARED // [must be low at boot 12] +#define AXIS1_M0_PIN 32 // SPI MOSI +#define AXIS1_M1_PIN 33 // SPI SCK +#define AXIS1_M2_PIN 15 // SPI CS (UART TX) +#define AXIS1_M3_PIN AUX2_PIN // SPI MISO (UART RX) +#define AXIS1_STEP_PIN 26 +#define AXIS1_DIR_PIN 16 +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN SHARED +#define AXIS2_M0_PIN 32 // SPI MOSI +#define AXIS2_M1_PIN 33 // SPI SCK +#define AXIS2_M2_PIN 0 // [must be high at boot 0] SPI CS (UART TX) +#define AXIS2_M3_PIN AUX2_PIN // SPI MISO (UART RX) +#define AXIS2_STEP_PIN 25 +#define AXIS2_DIR_PIN 27 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN SHARED +#define AXIS3_M0_PIN OFF // SPI MOSI +#define AXIS3_M1_PIN OFF // SPI SCK +#define AXIS3_M2_PIN OFF // SPI CS (UART TX) +#define AXIS3_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS3_STEP_PIN 19 +#define AXIS3_DIR_PIN 14 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN SHARED +#define AXIS4_M0_PIN OFF // SPI MOSI +#define AXIS4_M1_PIN OFF // SPI SCK +#define AXIS4_M2_PIN OFF // SPI CS (UART TX) +#define AXIS4_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS4_STEP_PIN 17 +#define AXIS4_DIR_PIN 14 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN SHARED +#define AXIS5_M0_PIN OFF // SPI MOSI +#define AXIS5_M1_PIN OFF // SPI SCK +#define AXIS5_M2_PIN OFF // SPI CS (UART TX) +#define AXIS5_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS5_STEP_PIN 19 +#define AXIS5_DIR_PIN 14 + +// ST4 interface +#define ST4_RA_W_PIN 34 // [input only 34] ST4 RA- West +#define ST4_DEC_S_PIN 18 // ST4 DE- South +#define ST4_DEC_N_PIN 4 // ST4 DE+ North +#define ST4_RA_E_PIN 35 // [input only 35] ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.FYSETC_E4.h b/src/pinmaps/Pins.FYSETC_E4.h new file mode 100755 index 0000000..8f0c315 --- /dev/null +++ b/src/pinmaps/Pins.FYSETC_E4.h @@ -0,0 +1,182 @@ +// ------------------------------------------------------------------------------------------------- +// Pinmap for FYSETC E4 Version 1.0 (ESP32) +#pragma once + +#if defined(ESP32) + +// Serial0: RX Pin GPIO3, TX Pin GPIO1 (to USB serial adapter) +// Serial1: RX1 Pin GPIO10, TX1 Pin GPIO9 (on SPI Flash pins, must be moved to be used) +// Serial2: RX2 Pin GPIO16, TX2 Pin GPIO17 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif + +// Uses default ESP32 I2C GPIO21 (SDA) and GPIO22 (SCL) + +// Use the following settings for the 4x TMC UART drivers +#if defined(STEP_DIR_TMC_UART_PRESENT) || defined(SERVO_TMC2209_PRESENT) + #define SERIAL_TMC_HARDWARE_UART + #define SERIAL_TMC Serial1 // Use a single hardware serial port to up to four drivers + #define SERIAL_TMC_BAUD 460800 // Baud rate + #if SERIAL_A_BAUD_DEFAULT == OFF + // if SERIAL_A is OFF map the hardware serial UART to the Serial0 pins + // you will need to remove jumpers to allow USB to work for an E4 fimware update + #define SERIAL_TMC_RX 3 // Recieving data + #define SERIAL_TMC_TX 1 // Transmit data + #define SPARE_RX_PIN OFF // Set _RX above to 0 (GPIO0) and use 3 here + #else + #ifndef SERIAL_TMC_RX + #define SERIAL_TMC_RX 0 // Recieving data (GPIO0 unused except for flashing) + #endif + #define SERIAL_TMC_TX 15 // Transmit data (Z-MIN) + #define SPARE_RX_PIN OFF // Not supported in this case + #endif + // map the driver addresses so axis Axis1(0) is X, Axis2(1) is Y, Axis3(2) is Z, Axis4(3) is E0... + // Axis1(0) is 1, Axis2(1) is 3, Axis3(2) is 0, Axis4(3) is 2, Axis5(4) is 0 + #define SERIAL_TMC_ADDRESS_MAP(x) (((x)==0)?1 : (((x)==1)?3 : (((x)==2)?0 : ((x)==3)?2 : 0))) +#endif + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX3_PIN 34 // [input only 34] Home SW for Axis1 (X_MIN) +#define AUX4_PIN 35 // [input only 35] Home SW for Axis2 (Y_MIN) +#define AUX5_PIN 2 // [must be low at boot 2] Dew heater, etc. (HEAT_E0) +#define AUX6_PIN 4 // Dew heater, etc. (HEAT_BED) +#define AUX7_PIN SPARE_RX_PIN // Option for 1-Wire, etc. +#define AUX8_PIN 13 // Status LED or Buzzer, Dew heater, etc. (FAN_E0) + +// Thermistor (temperature) sensor inputs have built-in 4.7K Ohm pullups and a 10uF cap for noise supression +#define TEMP0_PIN 36 // [input only 36] PEC (TE) +#define TEMP1_PIN 39 // [input only 39] Limit (TB) + +#ifndef FOCUSER_TEMPERATURE_PIN + #define FOCUSER_TEMPERATURE_PIN TEMP0_PIN +#endif +#ifndef FEATURE1_TEMPERATURE_PIN + #define FEATURE1_TEMPERATURE_PIN TEMP0_PIN +#endif +#ifndef FEATURE2_TEMPERATURE_PIN + #define FEATURE2_TEMPERATURE_PIN TEMP1_PIN +#endif + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX7_PIN // Default Pin for OneWire bus +#endif + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN 36 // [input only 36] PEC Sense, analog or digital (TE) +#endif + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif +#define MOUNT_LED_PIN STATUS_LED_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN STATUS_LED_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN AUX8_PIN // Tone +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN OFF +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN 39 // [input only 39] (TB) +#endif + +#define SHARED_ENABLE_PIN 25 // Hint that the enable pins are shared + +// Axis1 RA/Azm step/dir driver (X-AXIS) +#define AXIS1_ENABLE_PIN SHARED +#define AXIS1_M0_PIN OFF // SPI MOSI +#define AXIS1_M1_PIN OFF // SPI SCK +#define AXIS1_M2_PIN OFF // SPI CS (UART TX) +#define AXIS1_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS1_STEP_PIN 27 +#define AXIS1_DIR_PIN 26 +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif +#ifndef AXIS1_SERVO_PH1_PIN + #define AXIS1_SERVO_PH1_PIN OFF +#endif +#ifndef AXIS1_SERVO_PH2_PIN + #define AXIS1_SERVO_PH2_PIN OFF +#endif +#ifndef AXIS1_ENCODER_A_PIN + #define AXIS1_ENCODER_A_PIN OFF +#endif +#ifndef AXIS1_ENCODER_B_PIN + #define AXIS1_ENCODER_B_PIN OFF +#endif + +// Axis2 Dec/Alt step/dir driver (Y-AXIS) +#define AXIS2_ENABLE_PIN SHARED +#define AXIS2_M0_PIN OFF // SPI MOSI +#define AXIS2_M1_PIN OFF // SPI SCK +#define AXIS2_M2_PIN OFF // SPI CS (UART TX) +#define AXIS2_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS2_STEP_PIN 33 +#define AXIS2_DIR_PIN 32 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif +#ifndef AXIS2_SERVO_PH1_PIN + #define AXIS2_SERVO_PH1_PIN OFF +#endif +#ifndef AXIS2_SERVO_PH2_PIN + #define AXIS2_SERVO_PH2_PIN OFF +#endif +#ifndef AXIS2_ENCODER_PH1_PIN + #define AXIS2_ENCODER_A_PIN OFF +#endif +#ifndef AXIS2_ENCODER_B_PIN + #define AXIS2_ENCODER_B_PIN OFF +#endif + +// For rotator stepper driver (Z-AXIS) +#define AXIS3_ENABLE_PIN SHARED +#define AXIS3_M0_PIN OFF // SPI MOSI +#define AXIS3_M1_PIN OFF // SPI SCK +#define AXIS3_M2_PIN OFF // SPI CS (UART TX) +#define AXIS3_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS3_STEP_PIN 14 +#define AXIS3_DIR_PIN 12 // [must be low at boot 12] + +// For focuser1 stepper driver (E0-AXIS) +#define AXIS4_ENABLE_PIN SHARED +#define AXIS4_M0_PIN OFF // SPI MOSI +#define AXIS4_M1_PIN OFF // SPI SCK +#define AXIS4_M2_PIN OFF // SPI CS (UART TX) +#define AXIS4_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS4_STEP_PIN 16 +#define AXIS4_DIR_PIN 17 + +// For focuser2 stepper driver (Z-AXIS) +#define AXIS5_ENABLE_PIN SHARED +#define AXIS5_M0_PIN OFF // SPI MOSI +#define AXIS5_M1_PIN OFF // SPI SCK +#define AXIS5_M2_PIN OFF // SPI CS (UART TX) +#define AXIS5_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS5_STEP_PIN 14 +#define AXIS5_DIR_PIN 12 // [must be low at boot 12] + +// ST4 interface +#define ST4_RA_W_PIN OFF // ST4 RA- West +#define ST4_DEC_S_PIN OFF // ST4 DE- South +#define ST4_DEC_N_PIN OFF // ST4 DE+ North +#define ST4_RA_E_PIN OFF // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.FYSETC_S6.h b/src/pinmaps/Pins.FYSETC_S6.h new file mode 100755 index 0000000..066b094 --- /dev/null +++ b/src/pinmaps/Pins.FYSETC_S6.h @@ -0,0 +1,204 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for FYSETC S6 +#pragma once + +#if defined(STM32F446xx) + +// TX2/RX2 (PA2/PA3) is on the Y+ and Z+ end stops and is reserved for GPS (etc, no command channel is associated with this port) + +// Schematic isn't entirely clear, best guess: +// Serial1 RX1 Pin PB7, TX1 Pin PB6 +// Serial2 RX2 Pin PA3, TX2 Pin PA2 +// Serial3 RX3 Pin PC11, TX3 Pin PC10 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial1 +#endif +#if SERIAL_C_BAUD_DEFAULT != OFF + #define SERIAL_C Serial3 +#endif + +// Auto assign the Serial2 port pins for GPS +#if SERIAL_GPS_BAUD != OFF + #ifndef SERIAL_GPS + #define SERIAL_GPS SoftSerial + #define SERIAL_GPS_RX PA3 + #define SERIAL_GPS_TX PA2 + #endif +#endif + +// Thermistor (temperature) sensor inputs have built-in 4.7K Ohm pullups and a 10uF cap for noise supression +#define TEMP0_PIN PC0 // Temp0 (on TE0, THERMO0) +#define TEMP1_PIN PC1 // Temp1 (on TE1, THERMO1) +#define TEMP2_PIN PC2 // Temp2 (on TE2, THERMO2) +#define TEMP3_PIN PC3 // Temp3 (on TB , THERMO3) + +#ifndef FOCUSER_TEMPERATURE_PIN + #define FOCUSER_TEMPERATURE_PIN TEMP0_PIN +#endif +#ifndef FEATURE1_TEMPERATURE_PIN + #define FEATURE1_TEMPERATURE_PIN TEMP1_PIN +#endif +#ifndef FEATURE2_TEMPERATURE_PIN + #define FEATURE2_TEMPERATURE_PIN TEMP2_PIN +#endif +#ifndef FEATURE3_TEMPERATURE_PIN + #define FEATURE3_TEMPERATURE_PIN TEMP3_PIN +#endif + +// Fans (From Marlin) we use for Auxiliary Features (switches etc.) Probably with a little crafty wiring these can be 3V3 or 5V. +#define FAN0_PIN PB0 // Fan0 (on FAN0) +#define FAN1_PIN PB1 // Fan1 (on FAN1) +#define FAN2_PIN PB2 // Fan2 (on FAN2) + +// Heaters (From Marlin) we use for Auxiliary Features (switches, dew heaters, etc.) +#define HEATER0_PIN PB3 // Heater0 (on E0-OUT, E0-Heater) +#define HEATER1_PIN PB4 // Heater1 (on E1-OUT, E1-Heater) +#define HEATER2_PIN PB15 // Heater2 (on E2-OUT, E2-Heater) +#define HEATER3_PIN PC8 // Heater3 (on BED-OUT, Heated-Bed) + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +// I defined 7 Aux pins so they match up with the first 7 Auxiliary Feature slots avaliable in OnStep +// Aux1-3 can be used for pretty much anything +// Aux4-7 are more for dew-heaters +#define AUX1_PIN FAN0_PIN +#define AUX2_PIN FAN1_PIN +#define AUX3_PIN FAN2_PIN +#define AUX4_PIN HEATER0_PIN +#define AUX5_PIN HEATER1_PIN +#define AUX6_PIN HEATER2_PIN +#define AUX7_PIN HEATER3_PIN + +// Misc. pins +#ifndef DS3234_CS_PIN + #define DS3234_CS_PIN PA4 // Default CS Pin for DS3234 on SPI (on EXP2 shared with the ESP8266 RST pin) +#endif +#ifndef BMx280_CS_PIN + #define BMx280_CS_PIN PC7 // Default CS Pin for BME280/BMP280 on SPI (on EXP2 shared with LED2/Reticle) +#endif +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN PE0 // Default Pin for OneWire bus (on E2-MOT PD-EN, right hand pin) +#endif +#define ADDON_GPIO0_PIN PD0 // ESP8266 GPIO0 (on EXP1) +#define ADDON_RESET_PIN PA4 // ESP8266 RST (on EXP2 shared with the DS3234 CS pin) + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN +#define PEC_SENSE_PIN PA1 // PEC Sense, analog or digital (on X+ so it can have 3v3 or 5v on adjacent pin) +#endif + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN PC6 // Drain (on EXP2) One could perhaps move these to the RGB leds, there's a header but no +5V present on it. +#endif +#ifndef MOUNT_LED_PIN + #define MOUNT_LED_PIN PC6 // Drain (on EXP2 shared with Reticle/BME280_CS) +#endif +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN PC7 // Drain (on EXP2 shared with LED2/BME280_CS) +#endif + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN PC9 // Tone (on BEEP/EXP1) +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN PB10 // PPS time source, GPS for example (on EXP2) +#endif + +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN PA0 // Limit switch sense (on Z-) +#endif + +// Soft SPI bus to stepper drivers +#if PINMAP == FYSETC_S6_2 + #define SS_MOSI PE14 + #define SS_SCK PE12 + #define SS_MISO PE13 +#else + #define SS_MOSI PA7 + #define SS_SCK PA5 + #define SS_MISO PA6 +#endif + +// Axis1 RA/Azm step/dir driver +#if PINMAP == FYSETC_S6_2 + #define AXIS1_ENABLE_PIN PE9 +#else + #define AXIS1_ENABLE_PIN PE12 +#endif +#define AXIS1_M0_PIN SS_MOSI // SPI MOSI +#define AXIS1_M1_PIN SS_SCK // SPI SCK +#define AXIS1_M2_PIN PE7 // SPI CS (UART TX) +#define AXIS1_M3_PIN SS_MISO // SPI MISO (UART RX) +#define AXIS1_STEP_PIN PE11 +#define AXIS1_DIR_PIN PE10 +#define AXIS1_FAULT_PIN AXIS1_M3_PIN +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN PB14 // (on X-) +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN PD9 +#define AXIS2_M0_PIN SS_MOSI // SPI MOSI +#define AXIS2_M1_PIN SS_SCK // SPI SCK +#define AXIS2_M2_PIN PE15 // SPI CS (UART TX) +#define AXIS2_M3_PIN SS_MISO // SPI MISO (UART RX) +#define AXIS2_STEP_PIN PD8 +#define AXIS2_DIR_PIN PB12 +#define AXIS2_FAULT_PIN AXIS2_M3_PIN +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN PB13 // (on Y-) +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN PD15 +#define AXIS3_M0_PIN SS_MOSI // SPI MOSI +#define AXIS3_M1_PIN SS_SCK // SPI SCK +#define AXIS3_M2_PIN PD10 // SPI CS (UART TX) +#define AXIS3_M3_PIN SS_MISO // SPI MISO (UART RX) +#define AXIS3_STEP_PIN PD14 +#define AXIS3_DIR_PIN PD13 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN PD4 +#define AXIS4_M0_PIN SS_MOSI // SPI MOSI +#define AXIS4_M1_PIN SS_SCK // SPI SCK +#define AXIS4_M2_PIN PD7 // SPI CS (UART TX) +#define AXIS4_M3_PIN SS_MISO // SPI MISO (UART RX) +#define AXIS4_STEP_PIN PD5 +#define AXIS4_DIR_PIN PD6 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN PE5 +#define AXIS5_M0_PIN SS_MOSI // SPI MOSI +#define AXIS5_M1_PIN SS_SCK // SPI SCK +#define AXIS5_M2_PIN PC14 // SPI CS (UART TX) +#define AXIS5_M3_PIN SS_MISO // SPI MISO (UART RX) +#define AXIS5_STEP_PIN PE6 +#define AXIS5_DIR_PIN PC13 + +// For focuser3 stepper driver +#define AXIS6_ENABLE_PIN PE3 +#define AXIS6_M0_PIN SS_MOSI // SPI MOSI +#define AXIS6_M1_PIN SS_SCK // SPI SCK +#define AXIS6_M2_PIN PC15 // SPI CS (UART TX) +#define AXIS6_M3_PIN SS_MISO // SPI MISO (UART RX) +#define AXIS6_STEP_PIN PE2 +#define AXIS6_DIR_PIN PE4 + +// ST4 interface +#define ST4_RA_W_PIN PA8 // ST4 RA- West (on EXP1) +#define ST4_DEC_S_PIN PD2 // ST4 DE- South (on EXP1) +#define ST4_DEC_N_PIN PC12 // ST4 DE+ North (on EXP1) +#define ST4_RA_E_PIN PD1 // ST4 RA+ East (on EXP1) + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.JTWPCB2.h b/src/pinmaps/Pins.JTWPCB2.h new file mode 100755 index 0000000..97a4d0b --- /dev/null +++ b/src/pinmaps/Pins.JTWPCB2.h @@ -0,0 +1,66 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep JTW PCB rev 2.1 STM32F411CE PCB (or the Blackpill https://github.com/WeActTC/MiniF4-STM32F4x1) +#pragma once + +#if defined(STM32F411xE) || defined(STM32F401xC) + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A HardSerial + #define SERIAL_A_RX PA10 + #define SERIAL_A_TX PA9 +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B HardSerial + #define SERIAL_B_RX PA3 + #define SERIAL_B_TX PA2 +#endif + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX0_PIN PB12 // Status LED +#define AUX2_PIN PC14 // PPS +#define AUX5_PIN PA9 // TX1 +#define AUX6_PIN PA10 // RX1 + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#define STATUS_LED_PIN AUX0_PIN // Default LED Cathode (-) +#define MOUNT_LED_PIN AUX0_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#define STATUS_BUZZER_PIN PC15 // Tone + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN AUX2_PIN // PPS time source, GPS for example (MaxSTM version 3.61 and later) +#endif + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN PB13 +#define AXIS1_M0_PIN PA7 // SPI MOSI +#define AXIS1_M1_PIN PA5 // SPI SCK +#define AXIS1_M2_PIN PA1 // SPI CS (UART TX) +#define AXIS1_M3_PIN PA6 // SPI MISO (UART RX) +#define AXIS1_STEP_PIN PB10 +#define AXIS1_DIR_PIN PB2 + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN PB14 +#define AXIS2_M0_PIN PA7 // SPI MOSI +#define AXIS2_M1_PIN PA5 // SPI SCK +#define AXIS2_M2_PIN PA0 // SPI CS (UART TX) +#define AXIS2_M3_PIN PA6 // SPI MISO (UART RX) +#define AXIS2_STEP_PIN PA4 +#define AXIS2_DIR_PIN PB0 + +// ST4 interface +#define ST4_RA_W_PIN PA15 // ST4 RA- West +#define ST4_DEC_S_PIN PB3 // ST4 DE- South +#define ST4_DEC_N_PIN PB4 // ST4 DE+ North +#define ST4_RA_E_PIN PB5 // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.Manticore.h b/src/pinmaps/Pins.Manticore.h new file mode 100755 index 0000000..71705bf --- /dev/null +++ b/src/pinmaps/Pins.Manticore.h @@ -0,0 +1,137 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for JTW Manticore (ESP32S) +#pragma once + +#if defined(ESP32) + +// let any special processing the pinmap needs happen +#define PIN_INIT() { \ + pinMode(33, INPUT_PULLDOWN); \ + delay(100); \ + if (digitalRead(33) != HIGH) { \ + do { \ + SERIAL_DEBUG.begin(SERIAL_DEBUG_BAUD); \ + SERIAL_DEBUG.println("ERR: OnStepX firmware detected the SWS MCU; you must upload the SWS firmware here!"); \ + SERIAL_DEBUG.println(analogRead(33)); \ + delay(2000); \ + } while (true); \ + } \ + pinMode(33, INPUT); \ +} + +// Serial0: RX Pin GPIO3, TX Pin GPIO1 (to USB serial adapter) +// Serial1: RX1 Pin GPIO17, TX1 Pin GPIO16 (for TMC2209 UART COMMS) +// Serial2: RX2 Pin GPIO39, TX2 Pin GPIO18 (to secondary MCU) + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial2 + #define SERIAL_B_RX 39 + #define SERIAL_B_TX 18 +#endif + +#ifndef SERIAL_GPS + #define SERIAL_GPS SoftSerial + #define SERIAL_GPS_RX 19 + #define SERIAL_GPS_TX 2 +#endif + +// Use the following settings for any TMC UART driver (TMC2209) that may be present +#if defined(STEP_DIR_TMC_UART_PRESENT) || defined(SERVO_TMC2209_PRESENT) + #define SERIAL_TMC_HARDWARE_UART + #define SERIAL_TMC Serial1 // Use a single hardware serial port to up to four drivers + #define SERIAL_TMC_BAUD 460800 // Baud rate + #define SERIAL_TMC_RX 17 // Recieving data + #define SERIAL_TMC_TX 16 // Transmit data + #define SERIAL_TMC_ADDRESS_MAP(x) ((x==4)?2 : x) // Axis1(0) is 0, Axis2(1) is 1, Axis3(2) is 2, Axis4(3) is 3, Axis5(4) is 2 +#endif + +// Uses default ESP32 I2C GPIO21 (SDA) and GPIO22 (SCL) + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX3_PIN OFF // Home SW for Axis1 +#define AUX4_PIN OFF // Home SW for Axis2 + +#define ADDON_SELECT_PIN 15 + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN OFF // Default Pin for OneWire bus +#endif + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN 36 // PEC Sense, analog (A0) or digital +#endif + +// The status LED w/ 4.7k resistor in series to limit the current to the LED +#ifdef STATUS_LED_ON_STATE + #undef STATUS_LED_ON_STATE +#endif +#define STATUS_LED_ON_STATE HIGH +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN 2 // Default LED Anode (+) +#endif +#define MOUNT_LED_PIN STATUS_LED_PIN // Default LED Anode (+) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN OFF // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN 2 // Tone +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN 23 // PPS time source, GPS for example +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN GPIO_PIN(4) +#endif + +#define SHARED_DIRECTION_PINS // Hint that the direction pins are shared +#define SHARED_ENABLE_PIN 5 // Hint that the enable pins are shared + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN SHARED // Enable pin control +#define AXIS1_M0_PIN OFF // hardwired for TMC UART address 0 +#define AXIS1_M1_PIN OFF // hardwired for TMC UART address 0 +#define AXIS1_M2_PIN OFF // UART TX +#define AXIS1_M3_PIN OFF // UART RX +#define AXIS1_STEP_PIN 4 +#define AXIS1_DIR_PIN 0 // [must be high at boot 0] +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN GPIO_PIN(0) +#endif +#define AXIS1_ENCODER_A_PIN 14 +#define AXIS1_ENCODER_B_PIN 27 + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN SHARED +#define AXIS2_M0_PIN OFF // hardwired for TMC UART address 1 +#define AXIS2_M1_PIN OFF // hardwired for TMC UART address 1 +#define AXIS2_M2_PIN OFF // N/C +#define AXIS2_M3_PIN OFF // UART RX +#define AXIS2_STEP_PIN 12 // [low at boot] +#define AXIS2_DIR_PIN 13 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN GPIO_PIN(1) +#endif +#define AXIS2_ENCODER_A_PIN 26 +#define AXIS2_ENCODER_B_PIN 25 + +// ST4 interface +#define ST4_RA_W_PIN 34 // [input only 34] ST4 RA- West +#define ST4_DEC_S_PIN 32 // ST4 DE- South +#define ST4_DEC_N_PIN 33 // ST4 DE+ North +#define ST4_RA_E_PIN 35 // [input only 35] ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.MaxESP3.h b/src/pinmaps/Pins.MaxESP3.h new file mode 100755 index 0000000..84f9f20 --- /dev/null +++ b/src/pinmaps/Pins.MaxESP3.h @@ -0,0 +1,145 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep MaxESP Version 3.x (ESP32S) +#pragma once + +#if defined(ESP32) + +// Serial0: RX Pin GPIO3, TX Pin GPIO1 (to USB serial adapter) +// Serial1: RX1 Pin GPIO10, TX1 Pin GPIO9 (on SPI Flash pins, must be moved to be used) +// Serial2: RX2 Pin GPIO16, TX2 Pin GPIO17 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial2 +#endif + +// Use the following settings for any TMC UART driver (TMC2209) that may be present +#if defined(STEP_DIR_TMC_UART_PRESENT) || defined(SERVO_TMC2209_PRESENT) + #if defined(SERIAL_TMC_HARDWARE_UART) + #define SERIAL_TMC Serial1 // Use a single hardware serial port to up to four drivers + #define SERIAL_TMC_BAUD 460800 // Baud rate + #define SERIAL_TMC_RX 39 // Recieving data + #define SERIAL_TMC_TX 23 // Transmit data + #define SERIAL_TMC_ADDRESS_MAP(x) ((x==4)?2 : x) // Axis1(0) is 0, Axis2(1) is 1, Axis3(2) is 2, Axis4(3) is 3, Axis5(4) is 2 + #endif +#endif + +// Uses default ESP32 I2C GPIO21 (SDA) and GPIO22 (SCL) + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX2_PIN 4 // ESP8266 RST control, or MISO for Axis1&2, or Axis4 EN support +#define AUX3_PIN 21 // Home SW for Axis1, or I2C SDA +#define AUX4_PIN 22 // Home SW for Axis2, or I2C SCL +#define AUX7_PIN 39 // Limit SW, PPS, etc. +#define AUX8_PIN 25 // 1-Wire, Status LED, Reticle LED, Tone, etc. + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX8_PIN // Default Pin for OneWire bus +#endif +#define ADDON_GPIO0_PIN 26 // ESP8266 GPIO0 (Dir2) +#ifndef ADDON_RESET_PIN + #define ADDON_RESET_PIN AUX2_PIN // ESP8266 RST +#endif + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN 36 // [input only 36] PEC Sense, analog (A0) or digital (GPIO36) +#endif + +// The status LED is a two wire jumper with a 2k resistor in series to limit the current to the LED +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif +#define MOUNT_LED_PIN STATUS_LED_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN STATUS_LED_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN AUX8_PIN // Tone +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN AUX7_PIN // PPS time source, GPS for example +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX7_PIN +#endif + +#define SHARED_DIRECTION_PINS // Hint that the direction pins are shared +#define SHARED_ENABLE_PIN 12 // Hint that the enable pins are shared + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN SHARED // [must be low at boot 12] +#define AXIS1_M0_PIN 13 // SPI MOSI +#define AXIS1_M1_PIN 14 // SPI SCK +#define AXIS1_M2_PIN 23 // SPI CS (UART TX) +#if AXIS4_POWER_DOWN != ON + #define AXIS1_M3_PIN AUX2_PIN // SPI MISO (UART RX) +#endif +#define AXIS1_STEP_PIN 18 +#define AXIS1_DIR_PIN 0 // [must be high at boot 0] +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN SHARED +#define AXIS2_M0_PIN 13 // SPI MOSI +#define AXIS2_M1_PIN 14 // SPI SCK +#define AXIS2_M2_PIN 5 // SPI CS (UART TX) +#if AXIS4_POWER_DOWN != ON + #define AXIS2_M3_PIN AUX2_PIN // SPI MISO (UART RX) +#endif +#define AXIS2_STEP_PIN 27 +#define AXIS2_DIR_PIN 26 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN OFF // No enable pin control (always enabled) +#define AXIS3_M0_PIN OFF // SPI MOSI +#define AXIS3_M1_PIN OFF // SPI SCK +#define AXIS3_M2_PIN OFF // SPI CS (UART TX) +#define AXIS3_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS3_STEP_PIN 2 // [must be low at boot 2] +#define AXIS3_DIR_PIN 15 + +// For focuser1 stepper driver +#if !defined(SERIAL_TMC_HARDWARE_UART) && AXIS4_POWER_DOWN == ON + #define AXIS4_ENABLE_PIN AUX2_PIN +#endif +#define AXIS4_M0_PIN OFF // SPI MOSI +#define AXIS4_M1_PIN OFF // SPI SCK +#define AXIS4_M2_PIN OFF // SPI CS (UART TX) +#define AXIS4_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS4_STEP_PIN 19 +#define AXIS4_DIR_PIN 15 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN OFF // No enable pin control (always enabled) +#define AXIS5_M0_PIN OFF // SPI MOSI +#define AXIS5_M1_PIN OFF // SPI SCK +#define AXIS5_M2_PIN OFF // SPI CS (UART TX) +#define AXIS5_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS5_STEP_PIN 2 +#define AXIS5_DIR_PIN 15 + +// ST4 interface +#define ST4_RA_W_PIN 34 // [input only 34] ST4 RA- West +#define ST4_DEC_S_PIN 32 // ST4 DE- South +#define ST4_DEC_N_PIN 33 // ST4 DE+ North +#define ST4_RA_E_PIN 35 // [input only 35] ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.MaxESP4.h b/src/pinmaps/Pins.MaxESP4.h new file mode 100755 index 0000000..90b477c --- /dev/null +++ b/src/pinmaps/Pins.MaxESP4.h @@ -0,0 +1,151 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep MaxESP4 (ESP32S) +#pragma once + +#if defined(ESP32) + +// Serial0: RX Pin GPIO3, TX Pin GPIO1 (to USB serial adapter) +// Serial1: RX1 Pin GPIO10, TX1 Pin GPIO9 (on SPI Flash pins, must be moved to be used) +// Serial2: RX2 Pin GPIO16, TX2 Pin GPIO17 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial2 +#endif + +// Use the following settings for any TMC UART driver (TMC2209) that may be present +#if defined(STEP_DIR_TMC_UART_PRESENT) || defined(SERVO_TMC2209_PRESENT) + #define SERIAL_TMC_HARDWARE_UART + #define SERIAL_TMC Serial1 // Use a single hardware serial port to up to four drivers + #define SERIAL_TMC_BAUD 460800 // Baud rate + #define SERIAL_TMC_RX 39 // Recieving data + #ifndef SERIAL_TMC_TX + #define SERIAL_TMC_TX 4 // Transmit data + #endif + #define SERIAL_TMC_ADDRESS_MAP(x) ((x==4)?2 : x) // Axis1(0) is 0, Axis2(1) is 1, Axis3(2) is 2, Axis4(3) is 3, Axis5(4) is 2 +#endif + +// Uses default ESP32 I2C GPIO21 (SDA) and GPIO22 (SCL) + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX2_PIN 39 // M3 pin TMC UART RX +#define AUX3_PIN 14 // Home SW for Axis1 +#define AUX4_PIN 13 // Home SW for Axis2 +#define AUX5_PIN 1 // TX0 main USB, etc. +#define AUX6_PIN 3 // RX0 main USB, etc. +#define AUX7_PIN 23 // Limit SW, PPS, etc. +#define AUX8_PIN 25 // 1-Wire, Status LED, Reticle LED, Tone, etc. + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX8_PIN // Default Pin for OneWire bus +#endif + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN 36 // [input only 36] PEC Sense, analog (A0) or digital (GPIO36) +#endif + +// The status LED w/ 4.7k resistor in series to limit the current to the LED +#ifdef STATUS_LED_ON_STATE + #undef STATUS_LED_ON_STATE +#endif +#define STATUS_LED_ON_STATE HIGH +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN 12 // Default LED Anode (+) +#endif +#ifdef MOUNT_LED_ON_STATE + #undef MOUNT_LED_ON_STATE +#endif +#define MOUNT_LED_ON_STATE HIGH +#define MOUNT_LED_PIN STATUS_LED_PIN // Default LED Anode (+) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN 12 // [must be low at boot 12] Tone +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN AUX7_PIN // PPS time source, GPS for example +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX7_PIN +#endif + +#define SHARED_DIRECTION_PINS // Hint that the direction pins are shared +#ifndef SHARED_ENABLE_PIN + #define SHARED_ENABLE_PIN 5 // Hint that the enable pins are shared +#endif + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN SHARED // Enable pin control +#define AXIS1_M0_PIN OFF // hardwired for TMC UART address 0 +#define AXIS1_M1_PIN OFF // hardwired for TMC UART address 0 +#define AXIS1_M2_PIN OFF // UART TX +#define AXIS1_M3_PIN OFF // UART RX +#define AXIS1_STEP_PIN 18 +#define AXIS1_DIR_PIN 0 // [must be high at boot 0] +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN SHARED +#define AXIS2_M0_PIN OFF // hardwired for TMC UART address 1 +#define AXIS2_M1_PIN OFF // hardwired for TMC UART address 1 +#define AXIS2_M2_PIN OFF // N/C +#define AXIS2_M3_PIN OFF // UART RX +#define AXIS2_STEP_PIN 27 +#define AXIS2_DIR_PIN 26 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif +#ifndef AXIS2_ENCODER_B_PIN + #define AXIS2_ENCODER_B_PIN AUX2_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN SHARED +#define AXIS3_M0_PIN OFF // hardwired for TMC UART address 2 +#define AXIS3_M1_PIN OFF // hardwired for TMC UART address 2 +#define AXIS3_M2_PIN OFF // N/C +#define AXIS3_M3_PIN OFF // UART RX +#define AXIS3_STEP_PIN 2 // [must be low at boot 2] +#define AXIS3_DIR_PIN 15 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN SHARED +#define AXIS4_M0_PIN OFF // hardwired for TMC UART address 3 +#define AXIS4_M1_PIN OFF // hardwired for TMC UART address 3 +#define AXIS4_M2_PIN OFF // N/C +#define AXIS4_M3_PIN OFF // UART RX +#define AXIS4_STEP_PIN 19 +#define AXIS4_DIR_PIN 15 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN SHARED +#define AXIS5_M0_PIN OFF // hardwired for TMC UART address 2 +#define AXIS5_M1_PIN OFF // hardwired for TMC UART address 2 +#define AXIS5_M2_PIN OFF // N/C +#define AXIS5_M3_PIN OFF // UART RX +#define AXIS5_STEP_PIN 2 +#define AXIS5_DIR_PIN 15 + +// ST4 interface +#define ST4_RA_W_PIN 34 // [input only 34] ST4 RA- West +#define ST4_DEC_S_PIN 32 // ST4 DE- South +#define ST4_DEC_N_PIN 33 // ST4 DE+ North +#define ST4_RA_E_PIN 35 // [input only 35] ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.MaxPCB.h b/src/pinmaps/Pins.MaxPCB.h new file mode 100755 index 0000000..18735fb --- /dev/null +++ b/src/pinmaps/Pins.MaxPCB.h @@ -0,0 +1,138 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep MaxPCB (Teensy3.5/3.6) +#pragma once + +#if defined(__MK64FX512__) || defined(__MK66FX1M0__) + +// Serial1: RX1 Pin 0, TX1 Pin 1 +// Serial4: RX4 Pin 31, TX4 Pin 32 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial1 +#endif +#if SERIAL_C_BAUD_DEFAULT != OFF + #define SERIAL_C Serial4 +#endif +#if defined(USB_DUAL_SERIAL) || defined(USB_TRIPLE_SERIAL) + #define SERIAL_D SerialUSB1 + #define SERIAL_D_BAUD_DEFAULT 9600 +#endif +#if defined(USB_TRIPLE_SERIAL) + #define SERIAL_E SerialUSB2 + #define SERIAL_E_BAUD_DEFAULT 9600 +#endif + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX0_PIN 19 // Status LED +#define AUX1_PIN 18 // ESP8266 GPIO0, SPI MISO/Fault +#define AUX2_PIN 5 // ESP8266 RST, SPI MISO/Fault +#define AUX3_PIN 36 // Home SW +#define AUX4_PIN 39 // OneWire, Home SW +#define AUX5_PIN DAC_PIN(A21) // AXIS3_EN_PIN; true analog output +#define AUX6_PIN DAC_PIN(A22) // AXIS4_EN_PIN; true analog output +#define AUX7_PIN 4 // Limit SW +#define AUX8_PIN 22 // Reticle LED + +// Misc. pins +#ifndef DS3234_CS_PIN + #define DS3234_CS_PIN 10 // Default CS Pin for DS3234 on SPI +#endif +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX4_PIN // Default Pin for OneWire bus (note: this pin has a 0.1uF capacitor that must be removed for OneWire to function) +#endif +#define ADDON_GPIO0_PIN AUX1_PIN // ESP8266 GPIO0 or SPI MISO/Fault +#define ADDON_RESET_PIN AUX2_PIN // ESP8266 RST or SPI MISO/Fault + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN 23 // PEC Sense, analog or digital +#endif + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#define STATUS_LED_PIN AUX0_PIN // Default LED Cathode (-) +#define MOUNT_LED_PIN AUX0_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#define STATUS_BUZZER_PIN 29 // Tone + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN 28 // PPS time source, GPS for example +#endif + +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX7_PIN // The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#endif + +// hint that the driver mode pins are dedicated (not shared SPI bus except possibly MISO) +#define DEDICATED_MODE_PINS + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN 14 +#define AXIS1_M0_PIN 15 // SPI MOSI +#define AXIS1_M1_PIN 16 // SPI SCK +#define AXIS1_M2_PIN 17 // SPI CS (UART TX) +#define AXIS1_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS1_STEP_PIN 20 +#define AXIS1_DIR_PIN 21 +#define AXIS1_FAULT_PIN AXIS1_M3_PIN +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN 9 +#define AXIS2_M0_PIN 8 // SPI MOSI +#define AXIS2_M1_PIN 7 // SPI SCK +#define AXIS2_M2_PIN 6 // SPI CS (UART TX) +#define AXIS2_M3_PIN AUX2_PIN // SPI MISO (UART RX) +#define AXIS2_STEP_PIN 3 +#define AXIS2_DIR_PIN 2 +#define AXIS2_FAULT_PIN AXIS2_M3_PIN +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN AUX5_PIN +#define AXIS3_M0_PIN OFF // SPI MOSI +#define AXIS3_M1_PIN OFF // SPI SCK +#define AXIS3_M2_PIN OFF // SPI CS +#define AXIS3_M3_PIN OFF // SPI MISO +#define AXIS3_STEP_PIN 30 +#define AXIS3_DIR_PIN 33 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN AUX6_PIN +#define AXIS4_M0_PIN OFF // SPI MOSI +#define AXIS4_M1_PIN OFF // SPI SCK +#define AXIS4_M2_PIN OFF // SPI CS +#define AXIS4_M3_PIN OFF // SPI MISO +#define AXIS4_STEP_PIN 34 +#define AXIS4_DIR_PIN 35 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN AUX5_PIN +#define AXIS5_M0_PIN OFF // SPI MOSI +#define AXIS5_M1_PIN OFF // SPI SCK +#define AXIS5_M2_PIN OFF // SPI CS +#define AXIS5_M3_PIN OFF // SPI MISO +#define AXIS5_STEP_PIN 30 +#define AXIS5_DIR_PIN 33 + +// ST4 interface +#define ST4_RA_W_PIN 24 // ST4 RA- West +#define ST4_DEC_S_PIN 25 // ST4 DE- South +#define ST4_DEC_N_PIN 26 // ST4 DE+ North +#define ST4_RA_E_PIN 27 // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.MaxPCB3.h b/src/pinmaps/Pins.MaxPCB3.h new file mode 100755 index 0000000..4772285 --- /dev/null +++ b/src/pinmaps/Pins.MaxPCB3.h @@ -0,0 +1,134 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep MaxPCB 3.0 and 3.5 (Teensy3.5/3.6) +#pragma once + +#if defined(__MK64FX512__) || defined(__MK66FX1M0__) + +// Serial1: RX1 Pin 0, TX1 Pin 1 +// Serial4: RX4 Pin 31, TX4 Pin 32 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial1 +#endif +#if SERIAL_C_BAUD_DEFAULT != OFF + #define SERIAL_C Serial4 +#endif +#if defined(USB_DUAL_SERIAL) || defined(USB_TRIPLE_SERIAL) + #define SERIAL_D SerialUSB1 + #define SERIAL_D_BAUD_DEFAULT 9600 +#endif +#if defined(USB_TRIPLE_SERIAL) + #define SERIAL_E SerialUSB2 + #define SERIAL_E_BAUD_DEFAULT 9600 +#endif + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX0_PIN 19 // Status LED +#define AUX1_PIN 18 // ESP8266 GPIO0, SPI MISO/Fault +#define AUX2_PIN 5 // ESP8266 RST, SPI MISO/Fault +#define AUX3_PIN 36 // Home SW +#define AUX4_PIN 39 // OneWire, Home SW +#define AUX5_PIN DAC_PIN(A21) // AXIS3_EN_PIN; true analog output +#define AUX6_PIN DAC_PIN(A22) // AXIS4_EN_PIN; true analog output +#define AUX7_PIN 4 // Limit SW +#define AUX8_PIN 22 // Reticle LED, 1-Wire alternate + +// Misc. pins +#ifndef DS3234_CS_PIN + #define DS3234_CS_PIN 10 // Default CS Pin for DS3234 on SPI +#endif +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX4_PIN // Default Pin for OneWire bus (note: this pin has a 0.1uF capacitor that must be removed for OneWire to function) +#endif +#define ADDON_GPIO0_PIN 2 // ESP8266 GPIO0 (shared with AXIS2_DIR_PIN) +#define ADDON_RESET_PIN AUX2_PIN // ESP8266 RST or Fault + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#define PEC_SENSE_PIN 23 // PEC Sense, analog or digital + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#define STATUS_LED_PIN AUX0_PIN // Default LED Cathode (-) +#define MOUNT_LED_PIN AUX0_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#define STATUS_BUZZER_PIN 29 // Tone + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN 28 // PPS time source, GPS for example +#endif + +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX7_PIN // The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#endif + +// hint that the driver mode pins are dedicated (not shared SPI bus except possibly MISO) +#define DEDICATED_MODE_PINS + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN 14 +#define AXIS1_M0_PIN 15 // SPI MOSI +#define AXIS1_M1_PIN 16 // SPI SCK +#define AXIS1_M2_PIN 17 // SPI CS +#define AXIS1_M3_PIN AUX1_PIN // SPI MISO +#define AXIS1_STEP_PIN 20 +#define AXIS1_DIR_PIN 21 +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN 9 +#define AXIS2_M0_PIN 15 // SPI MOSI +#define AXIS2_M1_PIN 16 // SPI SCK +#define AXIS2_M2_PIN 6 // SPI CS +#define AXIS2_M3_PIN AUX1_PIN // SPI MISO +#define AXIS2_STEP_PIN 3 +#define AXIS2_DIR_PIN 2 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN AUX5_PIN +#define AXIS3_M0_PIN 15 // SPI MOSI +#define AXIS3_M1_PIN 16 // SPI SCK +#define AXIS3_M2_PIN 7 // SPI CS +#define AXIS3_M3_PIN AUX1_PIN // SPI MISO +#define AXIS3_STEP_PIN 30 +#define AXIS3_DIR_PIN 33 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN AUX6_PIN +#define AXIS4_M0_PIN 15 // SPI MOSI +#define AXIS4_M1_PIN 16 // SPI SCK +#define AXIS4_M2_PIN 8 // SPI CS +#define AXIS4_M3_PIN AUX1_PIN // SPI MISO +#define AXIS4_STEP_PIN 34 +#define AXIS4_DIR_PIN 35 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN AUX5_PIN +#define AXIS5_M0_PIN 15 // SPI MOSI +#define AXIS5_M1_PIN 16 // SPI SCK +#define AXIS5_M2_PIN 7 // SPI CS +#define AXIS5_M3_PIN AUX1_PIN // SPI MISO +#define AXIS5_STEP_PIN 30 +#define AXIS5_DIR_PIN 33 + +// ST4 interface +#define ST4_RA_W_PIN 24 // ST4 RA- West +#define ST4_DEC_S_PIN 25 // ST4 DE- South +#define ST4_DEC_N_PIN 26 // ST4 DE+ North +#define ST4_RA_E_PIN 27 // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.MaxPCB36.h b/src/pinmaps/Pins.MaxPCB36.h new file mode 100755 index 0000000..1a00dd2 --- /dev/null +++ b/src/pinmaps/Pins.MaxPCB36.h @@ -0,0 +1,130 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep MaxPCB 3.6 Teensy4.1 PCB +#pragma once + +#if defined(ARDUINO_TEENSY41) + +// Serial1: RX1 Pin 0, TX1 Pin 1 +// Serial2: RX2 Pin 7, TX2 Pin 8 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial2 +#endif +#if SERIAL_C_BAUD_DEFAULT != OFF + #define SERIAL_C Serial1 +#endif +#if defined(USB_DUAL_SERIAL) || defined(USB_TRIPLE_SERIAL) + #define SERIAL_D SerialUSB1 + #define SERIAL_D_BAUD_DEFAULT 9600 +#endif +#if defined(USB_TRIPLE_SERIAL) + #define SERIAL_E SerialUSB2 + #define SERIAL_E_BAUD_DEFAULT 9600 +#endif + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX0_PIN 23 // Status LED +#define AUX1_PIN 37 // TMC SPI MISO/Fault +#define AUX2_PIN 20 // PPS +#define AUX3_PIN 21 // Home SW +#define AUX4_PIN 22 // 1-Wire, Home SW +#define AUX5_PIN 1 // TX1 +#define AUX6_PIN 0 // RX1 +#define AUX7_PIN 9 // Limit SW +#define AUX8_PIN 10 // Reticle LED, 1-Wire alternate + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX4_PIN // Default Pin for OneWire bus (note: this pin has a 0.1uF capacitor that must be removed for OneWire to function) +#endif +#define ADDON_GPIO0_PIN OFF // ESP8266 GPIO0 (shared with AXIS2_DIR_PIN) +#define ADDON_RESET_PIN OFF // ESP8266 RST + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#define PEC_SENSE_PIN 2 // PEC Sense, analog or digital + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#define STATUS_LED_PIN AUX0_PIN // Default LED Cathode (-) +#define MOUNT_LED_PIN AUX0_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#define STATUS_BUZZER_PIN 17 // Tone + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN AUX2_PIN // PPS time source, GPS for example (MaxSTM version 3.61 and later) +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX7_PIN +#endif + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN 33 +#define AXIS1_M0_PIN 34 // SPI MOSI +#define AXIS1_M1_PIN 35 // SPI SCK +#define AXIS1_M2_PIN 36 // SPI CS (UART TX) +#define AXIS1_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS1_STEP_PIN 38 +#define AXIS1_DIR_PIN 39 +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN 40 +#define AXIS2_M0_PIN 41 // SPI MOSI +#define AXIS2_M1_PIN 13 // SPI SCK +#define AXIS2_M2_PIN 14 // SPI CS (UART TX) +#define AXIS2_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS2_STEP_PIN 15 +#define AXIS2_DIR_PIN 16 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN 11 +#define AXIS3_M0_PIN 12 // SPI MOSI +#define AXIS3_M1_PIN 24 // SPI SCK +#define AXIS3_M2_PIN 25 // SPI CS (UART TX) +#define AXIS3_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS3_STEP_PIN 26 +#define SHARED_DIRECTION_PINS // Hint that the direction pins are shared +#define AXIS3_DIR_PIN 27 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN 28 +#define AXIS4_M0_PIN 29 // SPI MOSI +#define AXIS4_M1_PIN 30 // SPI SCK +#define AXIS4_M2_PIN 31 // SPI CS (UART TX) +#define AXIS4_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS4_STEP_PIN 32 +#define AXIS4_DIR_PIN 27 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN 11 +#define AXIS5_M0_PIN 12 // SPI MOSI +#define AXIS5_M1_PIN 24 // SPI SCK +#define AXIS5_M2_PIN 25 // SPI CS (UART TX) +#define AXIS5_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS5_STEP_PIN 26 +#define AXIS5_DIR_PIN 27 + +// ST4 interface +#define ST4_RA_W_PIN 3 // ST4 RA- West +#define ST4_DEC_S_PIN 4 // ST4 DE- South +#define ST4_DEC_N_PIN 5 // ST4 DE+ North +#define ST4_RA_E_PIN 6 // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.MaxPCB4.h b/src/pinmaps/Pins.MaxPCB4.h new file mode 100755 index 0000000..1d54483 --- /dev/null +++ b/src/pinmaps/Pins.MaxPCB4.h @@ -0,0 +1,145 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep MaxPCB4 Teensy4.1 PCB +#pragma once + +#if defined(ARDUINO_TEENSY41) + +// Serial1: RX1 Pin 0, TX1 Pin 1 +// Serial2: RX2 Pin 7, TX2 Pin 8 +// Serial8: RX8 Pin 34, TX8 Pin 35 (TMC2209 UART) + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial2 +#endif +#if SERIAL_C_BAUD_DEFAULT != OFF + #define SERIAL_C Serial1 +#endif +#if defined(USB_DUAL_SERIAL) || defined(USB_TRIPLE_SERIAL) + #define SERIAL_D SerialUSB1 + #define SERIAL_D_BAUD_DEFAULT 9600 +#endif +#if defined(USB_TRIPLE_SERIAL) + #define SERIAL_E SerialUSB2 + #define SERIAL_E_BAUD_DEFAULT 9600 +#endif + +// Use the following settings for the 4x TMC UART drivers +#if defined(STEP_DIR_TMC_UART_PRESENT) || defined(SERVO_TMC2209_PRESENT) + #define SERIAL_TMC_HARDWARE_UART + #define DRIVER_TMC_STEPPER + #define SERIAL_TMC Serial8 // Use a single hardware serial port to up to four drivers + #define SERIAL_TMC_BAUD 460800 // Baud rate + #define SERIAL_TMC_ADDRESS_MAP(x) ((x==4)?2 : x) // Axis1(0) is 0, Axis2(1) is 1, Axis3(2) is 2, Axis4(3) is 3, Axis5(4) is 2 +#endif + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX0_PIN 23 // Status LED +#define AUX1_PIN 34 // TMC SPI MISO or UART RX (Serial8) +#define AUX2_PIN 20 // PPS +#define AUX3_PIN 21 // Home SW +#define AUX4_PIN 22 // Home SW +#define AUX5_PIN 1 // 1-Wire, TX1 +#define AUX6_PIN 0 // RX1 +#define AUX7_PIN 9 // Limit SW +#define AUX8_PIN 10 // Reticle LED, 1-Wire alternate + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX5_PIN // Default Pin for 1-Wire bus +#endif +#define ADDON_GPIO0_PIN OFF // ESP8266 GPIO0 (shared with AXIS2_DIR_PIN) +#define ADDON_RESET_PIN OFF // ESP8266 RST + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#define PEC_SENSE_PIN 2 // PEC Sense, analog or digital + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#define STATUS_LED_PIN AUX0_PIN // Default LED Cathode (-) +#define MOUNT_LED_PIN AUX0_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN 17 // Tone +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN AUX2_PIN // PPS time source, GPS for example (MaxSTM version 3.61 and later) +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX7_PIN +#endif + +// hint that the driver mode pins are dedicated (not shared SPI bus except possibly MISO) +#define DEDICATED_MODE_PINS + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN 33 +#define AXIS1_M0_PIN 37 // SPI MOSI +#define AXIS1_M1_PIN 36 // SPI SCK +#define AXIS1_M2_PIN 35 // SPI CS (UART TX) +#define AXIS1_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS1_STEP_PIN 38 +#define AXIS1_DIR_PIN 39 +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN 40 +#define AXIS2_M0_PIN 41 // SPI MOSI +#define AXIS2_M1_PIN 13 // SPI SCK +#define AXIS2_M2_PIN 14 // SPI CS (UART TX) +#define AXIS2_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS2_STEP_PIN 15 +#define AXIS2_DIR_PIN 16 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN 11 +#define AXIS3_M0_PIN 12 // SPI MOSI +#define AXIS3_M1_PIN 24 // SPI SCK +#define AXIS3_M2_PIN 25 // SPI CS (UART TX) +#define AXIS3_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS3_STEP_PIN 26 +#define SHARED_DIRECTION_PINS // Hint that the direction pins are shared +#define AXIS3_DIR_PIN 27 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN 28 +#define AXIS4_M0_PIN 29 // SPI MOSI +#define AXIS4_M1_PIN 30 // SPI SCK +#define AXIS4_M2_PIN 31 // SPI CS (UART TX) +#define AXIS4_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS4_STEP_PIN 32 +#define AXIS4_DIR_PIN 27 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN 11 +#define AXIS5_M0_PIN 12 // SPI MOSI +#define AXIS5_M1_PIN 24 // SPI SCK +#define AXIS5_M2_PIN 25 // SPI CS (UART TX) +#define AXIS5_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS5_STEP_PIN 26 +#define AXIS5_DIR_PIN 27 + +// ST4 interface +#define ST4_RA_W_PIN 3 // ST4 RA- West +#define ST4_DEC_S_PIN 4 // ST4 DE- South +#define ST4_DEC_N_PIN 5 // ST4 DE+ North +#define ST4_RA_E_PIN 6 // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.MaxSTM.h b/src/pinmaps/Pins.MaxSTM.h new file mode 100755 index 0000000..8a08ea5 --- /dev/null +++ b/src/pinmaps/Pins.MaxSTM.h @@ -0,0 +1,148 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep MaxSTM STM32F411CE/STM32F401CE PCB (or the Blackpill https://github.com/WeActTC/MiniF4-STM32F4x1) +#pragma once + +#if defined(STM32F411xE) || defined(STM32F401xC) + +// For an 8KB EEPROM on the MaxSTM3.6I +#if PINMAP == MaxSTM3I + #define NV_M24C32 +#endif + +// Serial ports (see Pins.defaults.h for SERIAL_A) +// Serial1 RX1 Pin PA10, TX1 Pin PA9 +// Serial2 RX2 Pin PA3 , TX2 Pin PA2 +// Serial6 RX6 Pin PA12, TX6 Pin PA11 (used for USB virtual serial) + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B HardSerial + #define SERIAL_B_RX PA3 + #define SERIAL_B_TX PA2 +#endif +#if SERIAL_C_BAUD_DEFAULT != OFF + #define SERIAL_C HardSerial + #define SERIAL_C_RX PA10 + #define SERIAL_C_TX PA9 +#endif + +// Auto assign the Serial1 port pins for GPS +#if SERIAL_GPS_BAUD != OFF + #ifndef SERIAL_GPS + #define SERIAL_GPS HardSerial + #define SERIAL_GPS_RX PA10 + #define SERIAL_GPS_TX PA9 + #endif +#endif + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX0_PIN PB12 // Status LED +#define AUX1_PIN PA6 // TMC SPI MISO/Fault +#define AUX2_PIN PA13 // PPS +#define AUX3_PIN PB13 // Home SW +#define AUX4_PIN PB14 // 1-Wire, Home SW +#define AUX5_PIN PA9 // TX1 +#define AUX6_PIN PA10 // RX1 +#define AUX7_PIN PB15 // Limit SW +#define AUX8_PIN PA8 // Reticle LED, 1-Wire alternate + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX4_PIN // Default Pin for OneWire bus (note: this pin has a 0.1uF capacitor that must be removed for OneWire to function) +#endif +#define ADDON_GPIO0_PIN OFF // ESP8266 GPIO0 (shared with AXIS2_DIR_PIN) +#define ADDON_RESET_PIN OFF // ESP8266 RST + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN PB1 // PEC Sense, analog or digital +#endif + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#define STATUS_LED_PIN AUX0_PIN // Default LED Cathode (-) +#define MOUNT_LED_PIN AUX0_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#define STATUS_BUZZER_PIN PA14 // Tone + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #ifdef MAXSTM_AUX0_PPS + #define PPS_SENSE_PIN AUX0_PIN // PPS time source, GPS for example (MaxSTM version 3.6) + #else + #define PPS_SENSE_PIN AUX2_PIN // PPS time source, GPS for example (MaxSTM version 3.61 and later) + #endif +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX7_PIN +#endif + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN OFF +#define AXIS1_M0_PIN PA7 // SPI MOSI +#define AXIS1_M1_PIN PA5 // SPI SCK +#define AXIS1_M2_PIN PA1 // SPI CS (UART TX) +#define AXIS1_M3_PIN PA6 // SPI MISO (UART RX) +#define AXIS1_STEP_PIN PB10 +#define AXIS1_DIR_PIN PB2 +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN OFF +#define AXIS2_M0_PIN PA7 // SPI MOSI +#define AXIS2_M1_PIN PA5 // SPI SCK +#define AXIS2_M2_PIN PA0 // SPI CS (UART TX) +#define AXIS2_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS2_STEP_PIN PA4 +#define AXIS2_DIR_PIN PB0 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif + +// For rotator stepper driver +#define SHARED_DIRECTION_PINS // Hint that the direction pins are shared +#define AXIS3_ENABLE_PIN OFF +#define AXIS3_M0_PIN PA7 // SPI MOSI +#define AXIS3_M1_PIN PA5 // SPI SCK +#define AXIS3_M2_PIN PC15 // SPI CS (UART TX) +#define AXIS3_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS3_STEP_PIN PB8 +#define AXIS3_DIR_PIN PC13 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN OFF +#define AXIS4_M0_PIN PA7 // SPI MOSI +#define AXIS4_M1_PIN PA5 // SPI SCK +#define AXIS4_M2_PIN PC14 // SPI CS (UART TX) +#define AXIS4_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS4_STEP_PIN PB9 +#define AXIS4_DIR_PIN PC13 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN OFF +#define AXIS5_M0_PIN PA7 // SPI MOSI +#define AXIS5_M1_PIN PA5 // SPI SCK +#define AXIS5_M2_PIN PC15 // SPI CS (UART TX) +#define AXIS5_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS5_STEP_PIN PB8 +#define AXIS5_DIR_PIN PC13 + +// ST4 interface +#define ST4_RA_W_PIN PA15 // ST4 RA- West +#define ST4_DEC_S_PIN PB3 // ST4 DE- South +#define ST4_DEC_N_PIN PB4 // ST4 DE+ North +#define ST4_RA_E_PIN PB5 // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.MicroScope.h b/src/pinmaps/Pins.MicroScope.h new file mode 100755 index 0000000..1f71e74 --- /dev/null +++ b/src/pinmaps/Pins.MicroScope.h @@ -0,0 +1,119 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for Microscope PCB Version 0.2 (ESP32S, experimental and may be removed at any point!) + +// !!! USE AT YOUR OWN RISK !!! + +#pragma once + +#if defined(ESP32) + +// Serial0: RX Pin GPIO3, TX Pin GPIO1 (to USB serial adapter) +// Serial1: RX1 Pin GPIO10, TX1 Pin GPIO9 (on SPI Flash pins, must be moved to be used) +// Serial2: RX2 Pin GPIO16, TX2 Pin GPIO17 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial2 +#endif + +// Uses default ESP32 I2C GPIO21 (SDA) and GPIO22 (SCL) + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN 26 // Default Pin for OneWire bus +#endif +#define ADDON_GPIO0_PIN OFF // 26 ESP8266 GPIO0 (Dir2) +#ifndef ADDON_RESET_PIN + #define ADDON_RESET_PIN OFF // 4 ESP8266 RST +#endif + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN 36 // [input only 36] PEC Sense, analog (A0) or digital (GPIO36) +#endif + +// The status LED is a two wire jumper with a 2k resistor in series to limit the current to the LED +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN 25 // 25 Default LED Cathode (-) +#endif +#define MOUNT_LED_PIN 25 // 25 Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN 25 // 25 Default LED Cathode (-) +#endif + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN OFF // 25 Tone +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN 39 // 37 PPS time source, GPS for example +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN OFF // 37 +#endif + +#define SHARED_ENABLE_PIN GPIO_PIN(13) // Hint that the enable pins are shared + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN SHARED // [must be low at boot 12] +#define AXIS1_M0_PIN 23 // 13 SPI MOSI +#define AXIS1_M1_PIN 18 // 14 SPI SCK +#define AXIS1_M2_PIN 25 // 23 SPI CS (UART TX) +#define AXIS1_M3_PIN 19 // 4 SPI MISO (UART RX) +#define AXIS1_STEP_PIN 2 // 18 +#define AXIS1_DIR_PIN GPIO_PIN(15) // [must be high at boot 0] +#define AXIS1_SENSE_HOME_PIN GPIO_PIN(1) // 21 + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN SHARED +#define AXIS2_M0_PIN 23 // 13 SPI MOSI +#define AXIS2_M1_PIN 18 // 14 SPI SCK +#define AXIS2_M2_PIN 14 // 5 SPI CS (UART TX) +#define AXIS2_M3_PIN 19 // 4 SPI MISO (UART RX) +#define AXIS2_STEP_PIN 12 // 27 +#define AXIS2_DIR_PIN GPIO_PIN(16) // 26 +#define AXIS2_SENSE_HOME_PIN GPIO_PIN(0) // 22 + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN SHARED // No enable pin control (always enabled) +#define AXIS3_M0_PIN 23 // SPI MOSI +#define AXIS3_M1_PIN 18 // SPI SCK +#define AXIS3_M2_PIN 4 // SPI CS (UART TX) +#define AXIS3_M3_PIN 19 // SPI MISO (UART RX) +#define AXIS3_STEP_PIN 15 // [must be low at boot 2] +#define AXIS3_DIR_PIN GPIO_PIN(17) // 15 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN SHARED // 4s +#define AXIS4_M0_PIN 23 // SPI MOSI +#define AXIS4_M1_PIN 18 // SPI SCK +#define AXIS4_M2_PIN OFF // SPI CS (UART TX) +#define AXIS4_M3_PIN 19 // SPI MISO (UART RX) +#define AXIS4_STEP_PIN 5 // 19 +#define AXIS4_DIR_PIN GPIO_PIN(14) // 15 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN SHARED // No enable pin control (always enabled) +#define AXIS5_M0_PIN 23 // SPI MOSI +#define AXIS5_M1_PIN 18 // SPI SCK +#define AXIS5_M2_PIN 4 // SPI CS (UART TX) +#define AXIS5_M3_PIN 19 // SPI MISO (UART RX) +#define AXIS5_STEP_PIN 15 // 2 +#define AXIS5_DIR_PIN GPIO_PIN(17) // 15 + +// ST4 interface +#define ST4_RA_W_PIN 33 // [input only 34] ST4 RA- West +#define ST4_DEC_S_PIN 32 // [i/o 32] ST4 DE- South +#define ST4_DEC_N_PIN 35 // [i/o 33] ST4 DE+ North +#define ST4_RA_E_PIN 34 // [input only 35] ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.MiniPCB.h b/src/pinmaps/Pins.MiniPCB.h new file mode 100755 index 0000000..a573994 --- /dev/null +++ b/src/pinmaps/Pins.MiniPCB.h @@ -0,0 +1,143 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep MiniPCB (Teensy3.0, 3.1, 3.2, and 4.0) +#pragma once + +#if defined(__MK20DX256__) || defined(_mk20dx128_h_) || defined(__MK20DX128__) || defined(__IMXRT1052__) || defined(__IMXRT1062__) + +// Serial ports (see Pins.defaults.h for SERIAL_A) +// Serial1: RX1 Pin 0, TX1 Pin 1 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial1 +#endif +#if SERIAL_C_BAUD_DEFAULT != OFF + #error "Configuration (Config.h): SerialC isn't supported, disable this option." +#endif +#if defined(USB_DUAL_SERIAL) || defined(USB_TRIPLE_SERIAL) + #define SERIAL_D SerialUSB1 + #define SERIAL_D_BAUD_DEFAULT 9600 +#endif +#if defined(USB_TRIPLE_SERIAL) + #define SERIAL_E SerialUSB2 + #define SERIAL_E_BAUD_DEFAULT 9600 +#endif + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX0_PIN 19 // Status LED +#define AUX1_PIN 18 // ESP8266 GPIO0, SPI MISO/Fault +#define AUX2_PIN 5 // ESP8266 RST, SPI MISO/Fault +#define AUX3_PIN 4 // Limit SW, Home SW +#define AUX4_PIN 22 // Reticle LED, Home SW +#if !defined(_mk20dx128_h_) && !defined(__MK20DX128__) && !defined(__IMXRT1052__) && !defined(__IMXRT1062__) + #define AUX5_PIN DAC_PIN(A14) // true analog output +#endif + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN 24 // Default Pin for OneWire bus +#endif +#if PINMAP == MiniPCB13 + #define ADDON_GPIO0_PIN 2 // ESP8266 GPIO0 (Dir2) + #define ADDON_RESET_PIN AUX2_PIN // ESP8266 RST +#else + #define ADDON_GPIO0_PIN AUX1_PIN // ESP8266 GPIO0 or SPI MISO/Fault + #define ADDON_RESET_PIN AUX2_PIN // ESP8266 RST or SPI MISO/Fault +#endif + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#define PEC_SENSE_PIN 23 // PEC Sense, analog or digital + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#define STATUS_LED_PIN AUX0_PIN // Default LED Cathode (-) +#define MOUNT_LED_PIN AUX0_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX4_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN 29 // Tone +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN 28 // PPS time source, GPS for example +#endif + +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX3_PIN // The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#endif + +// hint that the driver mode pins are dedicated (not shared SPI bus except possibly MISO) +#define DEDICATED_MODE_PINS + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN 14 +#define AXIS1_M0_PIN 15 // SPI MOSI +#define AXIS1_M1_PIN 16 // SPI SCK +#define AXIS1_M2_PIN 17 // SPI CS (UART TX) +#define AXIS1_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS1_STEP_PIN 20 +#define AXIS1_DIR_PIN 21 +#define AXIS1_FAULT_PIN AXIS1_M3_PIN // SPI MISO +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN 9 +#define AXIS2_M0_PIN 8 // SPI MOSI +#define AXIS2_M1_PIN 7 // SPI SCK +#define AXIS2_M2_PIN 6 // SPI CS (UART TX) +#if PINMAP == MiniPCB13 + #define AXIS2_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#else + #define AXIS2_M3_PIN AUX2_PIN // SPI MISO (UART RX) +#endif +#define AXIS2_STEP_PIN 3 +#define AXIS2_DIR_PIN 2 +#define AXIS2_FAULT_PIN AXIS2_M3_PIN +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN OFF +#define AXIS3_M0_PIN OFF // SPI MOSI +#define AXIS3_M1_PIN OFF // SPI SCK +#define AXIS3_M2_PIN OFF // SPI CS (UART TX) +#define AXIS3_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS3_STEP_PIN 30 +#define AXIS3_DIR_PIN 33 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN OFF +#define AXIS4_M0_PIN OFF // SPI MOSI +#define AXIS4_M1_PIN OFF // SPI SCK +#define AXIS4_M2_PIN OFF // SPI CS (UART TX) +#define AXIS4_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS4_STEP_PIN 31 +#define AXIS4_DIR_PIN 32 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN OFF +#define AXIS5_M0_PIN OFF // SPI MOSI +#define AXIS5_M1_PIN OFF // SPI SCK +#define AXIS5_M2_PIN OFF // SPI CS (UART TX) +#define AXIS5_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS5_STEP_PIN 30 +#define AXIS5_DIR_PIN 33 + +// ST4 interface +#define ST4_RA_W_PIN 10 // ST4 RA- West +#define ST4_DEC_S_PIN 11 // ST4 DE- South +#define ST4_DEC_N_PIN 12 // ST4 DE+ North +#define ST4_RA_E_PIN 13 // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.OctopusPro.h b/src/pinmaps/Pins.OctopusPro.h new file mode 100755 index 0000000..4d9283d --- /dev/null +++ b/src/pinmaps/Pins.OctopusPro.h @@ -0,0 +1,182 @@ +// ------------------------------------------------------------------------------------------------- +// Pinmap for the BTT Octopus Pro Version 1.1 (STM32H723) +#pragma once + +#if defined(STM32H723xx) + +// Serial: Built in USB (not TTL) +// Serial2: RX2 Pin PD6, TX2 Pin PD5 +// Serial3: RX3 Pin PD9, TX3 Pin PD8 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B HardSerial + #define SERIAL_B_RX PD9 + #define SERIAL_B_TX PD8 +#endif +#if SERIAL_C_BAUD_DEFAULT != OFF + #define SERIAL_C HardSerial + #define SERIAL_C_RX PD6 + #define SERIAL_C_TX PD5 +#endif + +// Connector Labeled I2C uses PB8 (SCL) and PB9 (SDA) which are forced in the HAL +#define I2C_SCL_PIN PB8 +#define I2C_SDA_PIN PB9 + +// Use software serial for GPS + +// The multi-purpose pins (automatically associated with Auxiliary Features) +#define AUX1_PIN PA0 // Connector Labeled HE0 +#define AUX2_PIN PA3 // Connector Labeled HE1 +#define AUX3_PIN PB0 // Connector Labeled HE2 +#define AUX4_PIN PB11 // Connector Labeled HE3 +#define AUX5_PIN PA1 // Connector Labeled BED-OUT +#define AUX6_PIN PA8 // Connector Labeled FAN0 +#define AUX7_PIN PE5 // Connector Labeled FAN1 +#define AUX8_PIN PD12 // Connector Labeled FAN2 + +// Thermistor (temperature) sensor inputs have built-in 4.7K Ohm pullups and a 10uF cap for noise supression +#ifndef FEATURE1_TEMPERATURE_PIN + #define FEATURE1_TEMPERATURE_PIN PF4 // Connector Labeled T0 +#endif +#ifndef FEATURE2_TEMPERATURE_PIN + #define FEATURE2_TEMPERATURE_PIN PF5 // Connector Labeled T1 +#endif +#ifndef FEATURE3_TEMPERATURE_PIN + #define FEATURE3_TEMPERATURE_PIN PF6 // Connector Labeled T2 +#endif +#ifndef FEATURE4_TEMPERATURE_PIN + #define FEATURE4_TEMPERATURE_PIN PF7 // Connector Labeled T3 +#endif +#ifndef FEATURE5_TEMPERATURE_PIN + #define FEATURE5_TEMPERATURE_PIN PF3 // Connector Labeled THB +#endif +#ifndef FOCUSER_TEMPERATURE_PIN + #define FOCUSER_TEMPERATURE_PIN PF7 // Connector Labeled T3 +#endif + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN PB7 // Connector labeled Probe (Analog or Digital) +#endif + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN PD13 // Connector Labeled FAN3 +#endif +#ifndef MOUNT_LED_PIN + #define MOUNT_LED_PIN PD14 // Connector Labeled FAN4 +#endif +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN PB2 // Connector Labeled EXP2 +#endif + +#ifdef STATUS_LED_ON_STATE +#undef STATUS_LED_ON_STATE +#endif +#define STATUS_LED_ON_STATE HIGH +#ifdef MOUNT_LED_ON_STATE +#undef MOUNT_LED_ON_STATE +#endif +#define MOUNT_LED_ON_STATE HIGH + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN PD15 // Connector Labeled FAN5 +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN PC15 // Connector Labeled EXP2 +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN PG6 // Limit Connector +#endif + +// Axis1 RA/Azm step/dir driver (Labeled S1) +#define AXIS1_ENABLE_PIN PF14 +#define AXIS1_M0_PIN PA7 // SPI MOSI +#define AXIS1_M1_PIN PA5 // SPI SCK +#define AXIS1_M2_PIN PC4 // SPI CS +#define AXIS1_M3_PIN PA6 // SPI MISO +#define AXIS1_STEP_PIN PF13 +#define AXIS1_DIR_PIN PF12 + +// Axis2 RA/Azm step/dir driver (Labeled S2) +#define AXIS2_ENABLE_PIN PF15 +#define AXIS2_M0_PIN PA7 // SPI MOSI +#define AXIS2_M1_PIN PA5 // SPI SCK +#define AXIS2_M2_PIN PD11 // SPI CS +#define AXIS2_M3_PIN PA6 // SPI MISO +#define AXIS2_STEP_PIN PG0 +#define AXIS2_DIR_PIN PG1 + +// Axis3 RA/Azm step/dir driver (Labeled S3) +#define AXIS3_ENABLE_PIN PG5 +#define AXIS3_M0_PIN PA7 // SPI MOSI +#define AXIS3_M1_PIN PA5 // SPI SCK +#define AXIS3_M2_PIN PC6 // SPI CS +#define AXIS3_M3_PIN PA6 // SPI MISO +#define AXIS3_STEP_PIN PF11 +#define AXIS3_DIR_PIN PG3 + +// Axis4 RA/Azm step/dir driver (Labeled S4) +#define AXIS4_ENABLE_PIN PA2 +#define AXIS4_M0_PIN PA7 // SPI MOSI +#define AXIS4_M1_PIN PA5 // SPI SCK +#define AXIS4_M2_PIN PC7 // SPI CS +#define AXIS4_M3_PIN PA6 // SPI MISO +#define AXIS4_STEP_PIN PG4 +#define AXIS4_DIR_PIN PC1 + +// Axis5 RA/Azm step/dir driver (Labeled S5) +#define AXIS5_ENABLE_PIN PG2 +#define AXIS5_M0_PIN PA7 // SPI MOSI +#define AXIS5_M1_PIN PA5 // SPI SCK +#define AXIS5_M2_PIN PF2 // SPI CS +#define AXIS5_M3_PIN PA6 // SPI MISO +#define AXIS5_STEP_PIN PF9 +#define AXIS5_DIR_PIN PF10 + +// Axis6 RA/Azm step/dir driver (Labeled S6) +#define AXIS6_ENABLE_PIN PF1 +#define AXIS6_M0_PIN PA7 // SPI MOSI +#define AXIS6_M1_PIN PA5 // SPI SCK +#define AXIS6_M2_PIN PE4 // SPI CS +#define AXIS6_M3_PIN PA6 // SPI MISO +#define AXIS6_STEP_PIN PC13 +#define AXIS6_DIR_PIN PF0 + +// Axis7 RA/Azm step/dir driver (Labeled S7) +#define AXIS7_ENABLE_PIN PD4 +#define AXIS7_M0_PIN PA7 // SPI MOSI +#define AXIS7_M1_PIN PC6 // SPI SCK +#define AXIS7_M2_PIN PE1 // SPI CS +#define AXIS7_M3_PIN PA6 // SPI MISO +#define AXIS7_STEP_PIN PE2 +#define AXIS7_DIR_PIN PE3 + +// Axis8 RA/Azm step/dir driver (Labeled S8) +#define AXIS8_ENABLE_PIN PE0 +#define AXIS8_M0_PIN PA7 // SPI MOSI +#define AXIS8_M1_PIN PA5 // SPI SCK +#define AXIS8_M2_PIN PD3 // SPI CS +#define AXIS8_M3_PIN PA6 // SPI MISO +#define AXIS8_STEP_PIN PE6 +#define AXIS8_DIR_PIN PA14 + +// ST4 interface (Connector Labeled EXP1 which has Gnd and +5V so near ideal) +#define ST4_RA_W_PIN PE14 // ST4 RA- West +#define ST4_DEC_S_PIN PE15 // ST4 DE- South +#define ST4_DEC_N_PIN PE12 // ST4 DE+ North +#define ST4_RA_E_PIN PE13 // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.SAL_XB1.h b/src/pinmaps/Pins.SAL_XB1.h new file mode 100755 index 0000000..4b2e129 --- /dev/null +++ b/src/pinmaps/Pins.SAL_XB1.h @@ -0,0 +1,149 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for SAL_XB1 (ESP32S) +#pragma once + +#if defined(ESP32) + +// Serial0: RX Pin GPIO3, TX Pin GPIO1 (to USB serial adapter) +// Serial1: RX1 Pin GPIO10, TX1 Pin GPIO9 (on SPI Flash pins, must be moved to be used) +// Serial2: RX2 Pin GPIO16, TX2 Pin GPIO17 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B Serial2 +#endif + +// Use the following settings for any TMC UART driver (TMC2209) that may be present +#if defined(STEP_DIR_TMC_UART_PRESENT) || defined(SERVO_TMC2209_PRESENT) + #define SERIAL_TMC_HARDWARE_UART + #define SERIAL_TMC Serial1 // Use a single hardware serial port to up to four drivers + #define SERIAL_TMC_BAUD 460800 // Baud rate + #define SERIAL_TMC_RX 39 // Recieving data + #define SERIAL_TMC_TX 4 // Transmit data + #define SERIAL_TMC_ADDRESS_MAP(x) ((x==4)?2 : x) // Axis1(0) is 0, Axis2(1) is 1, Axis3(2) is 2, Axis4(3) is 3, Axis5(4) is 2 +#endif + +// Specify the ESP32 I2C pins +#define I2C_SDA_PIN 21 +#define I2C_SCL_PIN 22 + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX2_PIN 39 // M3 pin TMC UART RX +#define AUX3_PIN 14 // Home SW for Axis1 +#define AUX4_PIN 13 // Home SW for Axis2 +#define AUX5_PIN 1 // TX0 main USB, etc. +#define AUX6_PIN 3 // RX0 main USB, etc. +#define AUX7_PIN 23 // Limit SW, PPS, etc. +#define AUX8_PIN 25 // 1-Wire, Status LED, Reticle LED, Tone, etc. + +// Misc. pins +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX8_PIN // Default Pin for OneWire bus +#endif + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN 36 // [input only 36] PEC Sense, analog (A0) or digital (GPIO36) +#endif + +// The status LED w/ 4.7k resistor in series to limit the current to the LED +#ifdef STATUS_LED_ON_STATE + #undef STATUS_LED_ON_STATE +#endif +#define STATUS_LED_ON_STATE HIGH +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN 12 // Default LED Anode (+) +#endif +#ifdef MOUNT_LED_ON_STATE + #undef MOUNT_LED_ON_STATE +#endif +#define MOUNT_LED_ON_STATE HIGH +#define MOUNT_LED_PIN STATUS_LED_PIN // Default LED Anode (+) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX8_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN 12 // [must be low at boot 12] Tone +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN AUX7_PIN // PPS time source, GPS for example +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN AUX7_PIN +#endif + +#define SHARED_DIRECTION_PINS // Hint that the direction pins are shared +#define SHARED_ENABLE_PIN 5 // Hint that the enable pins are shared + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN SHARED // Enable pin control +#define AXIS1_M0_PIN OFF // hardwired for TMC UART address 0 +#define AXIS1_M1_PIN OFF // hardwired for TMC UART address 0 +#define AXIS1_M2_PIN OFF // UART TX +#define AXIS1_M3_PIN OFF // UART RX +#define AXIS1_STEP_PIN 18 +#define AXIS1_DIR_PIN 19 // +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN SHARED +#define AXIS2_M0_PIN OFF // hardwired for TMC UART address 1 +#define AXIS2_M1_PIN OFF // hardwired for TMC UART address 1 +#define AXIS2_M2_PIN OFF // N/C +#define AXIS2_M3_PIN OFF // UART RX +#define AXIS2_STEP_PIN 27 +#define AXIS2_DIR_PIN 26 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif +#ifndef AXIS2_ENCODER_B_PIN + #define AXIS2_ENCODER_B_PIN AUX2_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN SHARED +#define AXIS3_M0_PIN OFF // hardwired for TMC UART address 2 +#define AXIS3_M1_PIN OFF // hardwired for TMC UART address 2 +#define AXIS3_M2_PIN OFF // N/C +#define AXIS3_M3_PIN OFF // UART RX +#define AXIS3_STEP_PIN 2 // [must be low at boot 2] +#define AXIS3_DIR_PIN 15 + +// For focuser1 stepper driver +#define AXIS4_ENABLE_PIN SHARED +#define AXIS4_M0_PIN OFF // hardwired for TMC UART address 3 +#define AXIS4_M1_PIN OFF // hardwired for TMC UART address 3 +#define AXIS4_M2_PIN OFF // N/C +#define AXIS4_M3_PIN OFF // UART RX +#define AXIS4_STEP_PIN 19 +#define AXIS4_DIR_PIN 15 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN SHARED +#define AXIS5_M0_PIN OFF // hardwired for TMC UART address 2 +#define AXIS5_M1_PIN OFF // hardwired for TMC UART address 2 +#define AXIS5_M2_PIN OFF // N/C +#define AXIS5_M3_PIN OFF // UART RX +#define AXIS5_STEP_PIN 2 +#define AXIS5_DIR_PIN 15 + +// ST4 interface +#define ST4_RA_W_PIN 34 // [input only 34] ST4 RA- West +#define ST4_DEC_S_PIN 32 // ST4 DE- South +#define ST4_DEC_N_PIN 33 // ST4 DE+ North +#define ST4_RA_E_PIN 35 // [input only 35] ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif \ No newline at end of file diff --git a/src/pinmaps/Pins.SKR_PRO.h b/src/pinmaps/Pins.SKR_PRO.h new file mode 100755 index 0000000..4e68ee4 --- /dev/null +++ b/src/pinmaps/Pins.SKR_PRO.h @@ -0,0 +1,234 @@ +// ------------------------------------------------------------------------------------------------- +// Pinmap for the BTT SKR PRO Version 1.2 (STM32F407) +#pragma once + +#if defined(STM32F407xx) + +// Serial: Built in USB (not TTL) +// Serial1: RX1 Pin PA10, TX1 Pin PA9 (Connector Labeled TFT) +// Serial3: RX3 Pin PD9, TX3 Pin PD8 (Connector Labeled SERIAL3) +// Serial6: RX6 Pin PC7, TX6 Pin PC6 (Connector Labeled ESP-01) + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B HardSerial + #define SERIAL_B_RX PC7 + #define SERIAL_B_TX PC6 +#endif +#if SERIAL_C_BAUD_DEFAULT != OFF + #define SERIAL_C HardSerial + #define SERIAL_C_RX PA10 + #define SERIAL_C_TX PA9 + // #define SERIAL_C Serial1 +#endif + +// Connector Labeled I2C uses PB6 (SCL) and PB7 (SDA) which are forced in the HAL + +// Auto assign the Serial3 port pins for GPS +#if SERIAL_GPS_BAUD != OFF + #ifndef SERIAL_GPS + #define SERIAL_GPS HardSerial + #define SERIAL_GPS_RX PD9 + #define SERIAL_GPS_TX PD8 + #endif +#endif + +// allow RX from TMC UART drivers +#ifndef SERIAL_TMC_RX_DISABLE + #define SERIAL_TMC_RX_DISABLE false +#endif + +// Allow resetting ESP8266 into firmware upload mode +#ifndef ADDON_GPIO0_PIN + #define ADDON_GPIO0_PIN PF14 // ESP8266 GPIO0 +#endif +#ifndef ADDON_RESET_PIN + #define ADDON_RESET_PIN PG1 // ESP8266 RST +#endif + +#define HEATER0_PIN PB1 // Connector Labeled HEAT0 +#define HEATER1_PIN PD14 // Connector Labeled HEAT1 +#define HEATER2_PIN PB0 // Connector Labeled HEAT2 +#define HEATER3_PIN PD12 // Connector Labeled BED +#define HEATER4_PIN PC8 // Connector Labeled FAN0 + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX1_PIN HEATER0_PIN +#define AUX2_PIN HEATER1_PIN +#define AUX3_PIN HEATER2_PIN +#define AUX4_PIN HEATER3_PIN +#define AUX5_PIN HEATER4_PIN + +// Thermistor (temperature) sensor inputs have built-in 4.7K Ohm pullups and a 10uF cap for noise supression +#define TEMP0_PIN PF3 // Connector Labeled T0 +#define TEMP1_PIN PF4 // Connector Labeled T1 +#define TEMP2_PIN PF5 // Connector Labeled T2 +#define TEMP3_PIN PF6 // Connector Labeled T3 + +#ifndef FEATURE1_TEMPERATURE_PIN + #define FEATURE1_TEMPERATURE_PIN TEMP0_PIN +#endif +#ifndef FEATURE2_TEMPERATURE_PIN + #define FEATURE2_TEMPERATURE_PIN TEMP1_PIN +#endif +#ifndef FEATURE3_TEMPERATURE_PIN + #define FEATURE3_TEMPERATURE_PIN TEMP2_PIN +#endif +#ifndef FOCUSER_TEMPERATURE_PIN + #define FOCUSER_TEMPERATURE_PIN TEMP3_PIN +#endif + +// The PEC index sense is a logic level input, resets the PEC index on rising edge then waits for 60 seconds before allowing another reset +#ifndef PEC_SENSE_PIN + #define PEC_SENSE_PIN PF12 // Connector labeled EXP2 (Analog or Digital) +#endif + +// The status LED is a two wire jumper with a 10k resistor in series to limit the current to the LED +#ifndef STATUS_LED_PIN + #define STATUS_LED_PIN PE6 // Connector Labeled FAN2 (has an LED built in too) +#endif +#define MOUNT_LED_PIN PE6 // Connector Labeled FAN2 (shared) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN PE5 // Connector Labeled FAN1 (has an LED built in too) TIM9 +#endif + +#ifdef STATUS_LED_ON_STATE +#undef STATUS_LED_ON_STATE +#endif +#define STATUS_LED_ON_STATE HIGH +#ifdef MOUNT_LED_ON_STATE +#undef MOUNT_LED_ON_STATE +#endif +#define MOUNT_LED_ON_STATE HIGH + +// For a piezo buzzer +#ifndef STATUS_BUZZER_PIN + #define STATUS_BUZZER_PIN PF11 // Connector Labeled EXP2 +#endif + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN PF13 // Connector Labeled EXP2 +#endif + +// The limit switch sense is a logic level input normally pull high (2k resistor,) shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN PB10 // Limit Connector Labeled E0 +#endif + +// Axis1 RA/Azm step/dir driver (Labeled X) +#define AXIS1_ENABLE_PIN PF2 +#define AXIS1_M0_PIN PC12 // SPI MOSI +#define AXIS1_M1_PIN PC10 // SPI SCK +#if defined(STEP_DIR_TMC_UART_PRESENT) && !defined(SERIAL_TMC_HARDWARE_UART) + #define AXIS1_M2_PIN PE4 // TX + #define AXIS1_M3_PIN PC13 // RX +#else + #define AXIS1_M2_PIN PA15 // SPI CS + #define AXIS1_M3_PIN PC11 // SPI MISO +#endif +#define AXIS1_STEP_PIN PE9 // TIM1 +#define AXIS1_DIR_PIN PF1 +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN PE10 // Home SW for Axis1 (Limit Connector Labeled E1) +#endif + +// Axis2 Dec/Alt step/dir driver (Labeled Y) +#define AXIS2_ENABLE_PIN PD7 +#define AXIS2_M0_PIN PC12 +#define AXIS2_M1_PIN PC10 +#if defined(STEP_DIR_TMC_UART_PRESENT) && !defined(SERIAL_TMC_HARDWARE_UART) + #define AXIS2_M2_PIN PE2 // TX + #define AXIS2_M3_PIN PE3 // RX +#else + #define AXIS2_M2_PIN PB8 // SPI CS + #define AXIS2_M3_PIN PC11 +#endif +#define AXIS2_STEP_PIN PE11 // TIM1 +#define AXIS2_DIR_PIN PE8 +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN PG5 // Home SW for Axis1 (Limit Connector Labeled E2) +#endif + +// For rotator stepper driver (Labeled Z) +#define AXIS3_ENABLE_PIN PC0 +#define AXIS3_M0_PIN PC12 +#define AXIS3_M1_PIN PC10 +#if defined(STEP_DIR_TMC_UART_PRESENT) && !defined(SERIAL_TMC_HARDWARE_UART) + #define AXIS3_M2_PIN PE0 // TX + #define AXIS3_M3_PIN PE1 // RX +#else + #define AXIS3_M2_PIN PB9 // SPI CS + #define AXIS3_M3_PIN PC11 +#endif +#define AXIS3_STEP_PIN PE13 +#define AXIS3_DIR_PIN PC2 + +// For focuser1 stepper driver (Labeled E0) +#define AXIS4_ENABLE_PIN PC3 +#define AXIS4_M0_PIN PC12 +#define AXIS4_M1_PIN PC10 +#if defined(STEP_DIR_TMC_UART_PRESENT) && !defined(SERIAL_TMC_HARDWARE_UART) + #define AXIS4_M2_PIN PD2 // TX + #define AXIS4_M3_PIN PD4 // RX +#else + #define AXIS4_M2_PIN PB3 // SPI CS + #define AXIS4_M3_PIN PC11 +#endif +#define AXIS4_STEP_PIN PE14 +#define AXIS4_DIR_PIN PA0 + +// For focuser2 stepper driver (Labeled E1) +#define AXIS5_ENABLE_PIN PA3 +#define AXIS5_M0_PIN PC12 +#define AXIS5_M1_PIN PC10 +#if defined(STEP_DIR_TMC_UART_PRESENT) && !defined(SERIAL_TMC_HARDWARE_UART) + #define AXIS5_M2_PIN PD0 // TX + #define AXIS5_M3_PIN PD1 // RX +#else + #define AXIS5_M2_PIN PG15 // SPI CS + #define AXIS5_M3_PIN PC11 +#endif +#define AXIS5_STEP_PIN PD15 +#define AXIS5_DIR_PIN PE7 + +// For focuser3 stepper driver (Labeled E2) +#define AXIS6_ENABLE_PIN PF0 +#define AXIS6_M0_PIN PC12 +#define AXIS6_M1_PIN PC10 +#if defined(STEP_DIR_TMC_UART_PRESENT) && !defined(SERIAL_TMC_HARDWARE_UART) + #define AXIS6_M2_PIN PD5 // TX + #define AXIS6_M3_PIN PD6 // RX +#else + #define AXIS6_M2_PIN PG12 // SPI CS + #define AXIS6_M3_PIN PC11 +#endif +#define AXIS6_STEP_PIN PD13 +#define AXIS6_DIR_PIN PG9 + +// For focuser4 stepper driver (Labeled Z) +#define AXIS7_ENABLE_PIN PC0 +#define AXIS7_M0_PIN PC12 +#define AXIS7_M1_PIN PC10 +#if defined(STEP_DIR_TMC_UART_PRESENT) && !defined(SERIAL_TMC_HARDWARE_UART) + #define AXIS7_M2_PIN PE0 // TX + #define AXIS7_M3_PIN PE1 // RX +#else + #define AXIS7_M2_PIN PB9 // SPI CS + #define AXIS7_M3_PIN PC11 +#endif +#define AXIS7_STEP_PIN PE13 +#define AXIS7_DIR_PIN PC2 + +// ST4 interface (Connector Labeled EXTENSION-2 which has Gnd and +5V so near ideal) +#define ST4_RA_W_PIN PD0 // ST4 RA- West +#define ST4_DEC_S_PIN PD2 // ST4 DE- South +#define ST4_DEC_N_PIN PD5 // ST4 DE+ North +#define ST4_RA_E_PIN PE0 // ST4 RA+ East + +#else +#error "Wrong processor for this configuration!" + +#endif diff --git a/src/pinmaps/Pins.STM32B.h b/src/pinmaps/Pins.STM32B.h new file mode 100755 index 0000000..faecf38 --- /dev/null +++ b/src/pinmaps/Pins.STM32B.h @@ -0,0 +1,146 @@ +// ------------------------------------------------------------------------------------------------- +// Pin map for OnStep on STM32 +#pragma once + +// This pin map is for the STM32F103CB (or C8 with 128KB) +// and STM32F303xC "Blue Pill" boards... +// They run at 72MHz, with 48K of RAM, and 256K of flash +// +// More info, schematic at: +// http://wiki.stm32duino.com/index.php?title=Blue_Pill +// +// Cost on eBay and AliExpress is less than US $2.50 + +#if defined(STM32F103xB) || defined(STM32F303xC) + +// Serial ports +// Serial1 RX1 Pin PA10, TX1 Pin PA9 (to CP2102 USB serial adapter) +// Serial2 RX2 Pin PA3 , TX2 Pin PA2 (pins are used for other purposes) +// Serial3 RX3 Pin PB11, TX3 Pin PB10 + +#if SERIAL_A_BAUD_DEFAULT != OFF + #define SERIAL_A Serial1 +#endif +#if SERIAL_B_BAUD_DEFAULT != OFF + #define SERIAL_B HardSerial + #define SERIAL_B_RX PB11 + #define SERIAL_B_TX PB10 +#endif + +// === Pins for DS3231 RTC/EEPROM +// The STM32 has no built in EEPROM. Therefore, we use a DS3231 RTC module +// which has an EEPROM chip on the board. HAL takes care of its address and size: +// +// STM32 pin PB6 -> SCL on DS3231 +// STM32 pin PB7 -> SDA on DS3231 + +#if PINMAP == STM32Blue + +// The multi-purpose pins (Aux3..Aux8 can be analog pwm/dac if supported) +#define AUX0_PIN PC13 // Status LED +#define AUX1_PIN PB14 // ESP8266 GPIO0, SPI MISO/Fault +#define AUX2_PIN PA1 // ESP8266 RST, SPI MISO/Fault +#define AUX3_PIN PB8 // Reticle, Home SW +#define AUX4_PIN PA13 // OneWire, Home SW + +#ifndef ONE_WIRE_PIN + #define ONE_WIRE_PIN AUX4_PIN // Default Pin for OneWire bus +#endif + +// For ESP8266 control +#define ADDON_GPIO0_PIN AUX1_PIN // ESP8266 GPIO0 +#define ADDON_RESET_PIN AUX2_PIN // ESP8266 RST + +// The PEC index sense is a logic level input, resets the PEC index on rising +// edge then waits for 60 seconds before allowing another reset +#define PEC_SENSE_PIN PC14 // PEC Sense + +// This is the built in LED for the Black Pill board. There is a pin +// available from it too, in case you want to power another LED with a wire +#define STATUS_LED_PIN AUX0_PIN // Default LED Cathode (-) +#define MOUNT_LED_PIN AUX0_PIN // Default LED Cathode (-) +#ifndef RETICLE_LED_PIN + #define RETICLE_LED_PIN AUX3_PIN // Default LED Cathode (-) +#endif + +// For a piezo buzzer +#define STATUS_BUZZER_PIN PB9 // Tone + +// The PPS pin is a 3.3V logic input, OnStep measures time between rising edges and +// adjusts the internal sidereal clock frequency +#ifndef PPS_SENSE_PIN + #define PPS_SENSE_PIN PB5 // Pulse Per Second time source, e.g. GPS, RTC +#endif + +// The limit switch sense is a logic level input which uses the internal pull up, +// shorted to ground it stops gotos/tracking +#ifndef LIMIT_SENSE_PIN + #define LIMIT_SENSE_PIN PA14 +#endif + +// Axis1 RA/Azm step/dir driver +#define AXIS1_ENABLE_PIN PA12 +#define AXIS1_M0_PIN PA11 // SPI MOSI +#define AXIS1_M1_PIN PA8 // SPI CLK +#define AXIS1_M2_PIN PB15 // SPI CS (UART TX) +#define AXIS1_M3_PIN AUX1_PIN // SPI MISO (UART RX) +#define AXIS1_STEP_PIN PB13 +#define AXIS1_DIR_PIN PB12 +#define AXIS1_FAULT_PIN AXIS1_M3_PIN +#ifndef AXIS1_SENSE_HOME_PIN + #define AXIS1_SENSE_HOME_PIN AUX3_PIN +#endif + +// Axis2 Dec/Alt step/dir driver +#define AXIS2_ENABLE_PIN PA5 +#define AXIS2_M0_PIN PA4 // SPI MOSI +#define AXIS2_M1_PIN PA3 // SPI CLK +#define AXIS2_M2_PIN PA2 // SPI CS (UART TX) +#define AXIS2_M3_PIN AUX2_PIN // SPI MISO (UART RX) +#define AXIS2_STEP_PIN PA0 +#define AXIS2_DIR_PIN PC15 +#define AXIS2_FAULT_PIN AXIS2_M3_PIN +#ifndef AXIS2_SENSE_HOME_PIN + #define AXIS2_SENSE_HOME_PIN AUX4_PIN +#endif + +// For rotator stepper driver +#define AXIS3_ENABLE_PIN PB4 +#define AXIS3_M0_PIN OFF // SPI MOSI +#define AXIS3_M1_PIN OFF // SPI SCK +#define AXIS3_M2_PIN OFF // SPI CS (UART TX) +#define AXIS3_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS3_STEP_PIN PB3 +#define AXIS3_DIR_PIN PA15 + +// Pins to focuser1 stepper driver +#define AXIS4_ENABLE_PIN PB4 +#define AXIS4_M0_PIN OFF // SPI MOSI +#define AXIS4_M1_PIN OFF // SPI SCK +#define AXIS4_M2_PIN OFF // SPI CS (UART TX) +#define AXIS4_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS4_STEP_PIN PB3 +#define AXIS4_DIR_PIN PA15 + +// For focuser2 stepper driver +#define AXIS5_ENABLE_PIN OFF +#define AXIS5_M0_PIN OFF // SPI MOSI +#define AXIS5_M1_PIN OFF // SPI SCK +#define AXIS5_M2_PIN OFF // SPI CS (UART TX) +#define AXIS5_M3_PIN OFF // SPI MISO (UART RX) +#define AXIS5_STEP_PIN OFF +#define AXIS5_DIR_PIN OFF + +// ST4 interface +#define ST4_DEC_N_PIN PA7 // ST4 DE+ North +#define ST4_DEC_S_PIN PA6 // ST4 DE- South +#define ST4_RA_W_PIN PB1 // ST4 RA- West +#define ST4_RA_E_PIN PB0 // ST4 RA+ East + +#else + #error "Unknown STM32 Board. This pinmap is only for Blue and Black Pill variants" +#endif + +#else + #error "Wrong processor for this configuration!" +#endif diff --git a/src/pinmaps/Pins.defaults.h b/src/pinmaps/Pins.defaults.h new file mode 100755 index 0000000..c42f0f6 --- /dev/null +++ b/src/pinmaps/Pins.defaults.h @@ -0,0 +1,685 @@ +// ------------------------------------------------------------------------------------------------- +// Null pin map, assigns OFF to all values not already assigned +#pragma once + +// -------------------------------------------------------------------------------------------------------- +// Serial, SPI, and I2C interface pins + +// usually the default serial port +#if SERIAL_A_BAUD_DEFAULT != OFF +#ifndef SERIAL_A +#define SERIAL_A Serial +#endif +#endif + +// automatic setup of serial passthrough +#if SERIAL_B_ESP_FLASHING == ON +#define SERIAL_PASSTHROUGH SERIAL_B +#define SERIAL_PASSTHROUGH_BAUD_DEFAULT SERIAL_B_BAUD_DEFAULT +#ifdef SERIAL_B_RX +#define SERIAL_PASSTHROUGH_RX SERIAL_B_RX +#endif +#ifdef SERIAL_B_TX +#define SERIAL_PASSTHROUGH_TX SERIAL_B_TX +#endif +#ifdef SERIAL_B_RXTX_SET +#define SERIAL_PASSTHROUGH_RXTX_SET SERIAL_B_RXTX_SET +#endif +#endif + +// default settings for any TMC UART drivers that may be present +#if defined(STEP_DIR_TMC_UART_PRESENT) +#ifndef SERIAL_TMC +#define SERIAL_TMC SoftSerial // Use software serial with TX on M3 (CS) of each axis +#endif +#ifndef SERIAL_TMC_RX_DISABLE +#define SERIAL_TMC_RX_DISABLE true // Recieving data often doesn't work with software serial +#endif +#ifndef SERIAL_TMC_BAUD +#define SERIAL_TMC_BAUD 115200 // Baud rate +#endif +#ifndef SERIAL_TMC_ADDRESS_MAP +#define SERIAL_TMC_ADDRESS_MAP(x) (0) // driver addresses are 0 for all axes +#endif +#ifndef SERIAL_TMC_INVERT +#define SERIAL_TMC_INVERT OFF // invert the serial interface signal logic +#endif +#endif + +// pin# for controlling the reset of W5500 so it comes up properly +#ifndef ETHERNET_RESET_PIN +#define ETHERNET_RESET_PIN OFF +#endif + +// default settings for I2C +#ifndef I2C_SDA_PIN +#define I2C_SDA_PIN OFF +#endif + +#ifndef I2C_SCL_PIN +#define I2C_SCL_PIN OFF +#endif + +#ifdef ESP32 + #if (defined(I2C_SCL_PIN) && I2C_SCL_PIN != OFF) && (defined(I2C_SDA_PIN) && I2C_SDA_PIN != OFF) + #define WIRE_INIT() HAL_WIRE.begin(I2C_SDA_PIN, I2C_SCL_PIN); HAL_WIRE_SET_CLOCK() + #else + #define WIRE_INIT() HAL_WIRE.begin(); HAL_WIRE_SET_CLOCK() + #endif +#else + #if (defined(I2C_SCL_PIN) && I2C_SCL_PIN != OFF) && (defined(I2C_SDA_PIN) && I2C_SDA_PIN != OFF) + #define WIRE_INIT() HAL_WIRE.setSDA(I2C_SDA_PIN); HAL_WIRE.setSCL(I2C_SCL_PIN); HAL_WIRE_SET_CLOCK() + #else + #define WIRE_INIT() HAL_WIRE_SET_CLOCK() + #endif +#endif + +// -------------------------------------------------------------------------------------------------------- +// GPIO SSR74HC595 pins +#ifndef GPIO_SSR74HC595_LATCH_PIN +#define GPIO_SSR74HC595_LATCH_PIN OFF // If used, only pins 0 to 31 are supported on the ESP32 +#endif + +#ifndef GPIO_SSR74HC595_CLOCK_PIN +#define GPIO_SSR74HC595_CLOCK_PIN OFF // If used, only pins 0 to 31 are supported on the ESP32 +#endif + +#ifndef GPIO_SSR74HC595_DATA_PIN +#define GPIO_SSR74HC595_DATA_PIN OFF // If used, only pins 0 to 31 are supported on the ESP32 +#endif + +#ifndef GPIO_SSR74HC595_COUNT +#define GPIO_SSR74HC595_COUNT 8 // 8, 16, 24, or 32 (for 1, 2, 3, or 4 74HC595's) +#endif + +// -------------------------------------------------------------------------------------------------------- +// define standard pins as inactive +#ifndef AUX0_PIN +#define AUX0_PIN OFF +#endif + +#ifndef AUX1_PIN +#define AUX1_PIN OFF +#endif + +#ifndef AUX2_PIN +#define AUX2_PIN OFF +#endif + +#ifndef AUX3_PIN +#define AUX3_PIN OFF +#endif + +#ifndef AUX4_PIN +#define AUX4_PIN OFF +#endif + +#ifndef AUX5_PIN +#define AUX5_PIN OFF +#endif + +#ifndef AUX6_PIN +#define AUX6_PIN OFF +#endif + +#ifndef AUX7_PIN +#define AUX7_PIN OFF +#endif + +#ifndef AUX8_PIN +#define AUX8_PIN OFF +#endif + +#ifndef ONE_WIRE_PIN +#define ONE_WIRE_PIN OFF +#endif + +#ifndef ADDON_TRIGR_PIN +#define ADDON_TRIGR_PIN OFF +#endif + +#ifndef ADDON_SELECT_PIN +#define ADDON_SELECT_PIN OFF +#endif + +#ifndef ADDON_GPIO0_PIN +#define ADDON_GPIO0_PIN OFF +#endif + +#ifndef ADDON_RESET_PIN +#define ADDON_RESET_PIN OFF +#endif + +#ifndef PARK_SENSE_PIN +#define PARK_SENSE_PIN OFF +#endif + +#ifndef PARK_SIGNAL_PIN +#define PARK_SIGNAL_PIN OFF +#endif + +#ifndef PARK_STATUS_PIN +#define PARK_STATUS_PIN OFF +#endif + +#ifndef PEC_SENSE_PIN +#define PEC_SENSE_PIN OFF +#endif + +#ifndef STATUS_LED_PIN +#define STATUS_LED_PIN OFF +#endif + +#ifndef MOUNT_LED_PIN +#define MOUNT_LED_PIN OFF +#endif + +#ifndef RETICLE_LED_PIN +#define RETICLE_LED_PIN OFF +#endif + +#ifndef STATUS_BUZZER_PIN +#define STATUS_BUZZER_PIN OFF +#endif + +#ifndef PPS_SENSE_PIN +#define PPS_SENSE_PIN OFF +#endif + +#ifndef LIMIT_SENSE_PIN +#define LIMIT_SENSE_PIN OFF +#endif + +#ifndef ST4_RA_W_PIN +#define ST4_RA_W_PIN OFF +#endif +#ifndef ST4_DEC_S_PIN +#define ST4_DEC_S_PIN OFF +#endif +#ifndef ST4_DEC_N_PIN +#define ST4_DEC_N_PIN OFF +#endif +#ifndef ST4_RA_E_PIN +#define ST4_RA_E_PIN OFF +#endif + +#ifndef AXIS1_ENABLE_PIN +#define AXIS1_ENABLE_PIN OFF +#endif +#ifndef AXIS1_M0_PIN +#define AXIS1_M0_PIN OFF +#endif +#ifndef AXIS1_M1_PIN +#define AXIS1_M1_PIN OFF +#endif +#ifndef AXIS1_M2_PIN +#define AXIS1_M2_PIN OFF +#endif +#ifndef AXIS1_M3_PIN +#define AXIS1_M3_PIN OFF +#endif +#ifndef AXIS1_STEP_PIN +#define AXIS1_STEP_PIN OFF +#endif +#ifndef AXIS1_DIR_PIN +#define AXIS1_DIR_PIN OFF +#endif +#ifndef AXIS1_DECAY_PIN +#define AXIS1_DECAY_PIN OFF +#endif +#ifndef AXIS1_SERVO_PH1_PIN +#define AXIS1_SERVO_PH1_PIN AXIS1_DIR_PIN +#endif +#ifndef AXIS1_SERVO_PH2_PIN +#define AXIS1_SERVO_PH2_PIN AXIS1_STEP_PIN +#endif +#ifndef AXIS1_FAULT_PIN +#define AXIS1_FAULT_PIN OFF +#endif +#ifndef AXIS1_SENSE_HOME_PIN +#define AXIS1_SENSE_HOME_PIN OFF +#endif +#ifndef AXIS1_SENSE_LIMIT_MIN_PIN +#define AXIS1_SENSE_LIMIT_MIN_PIN LIMIT_SENSE_PIN +#endif +#ifndef AXIS1_SENSE_LIMIT_MAX_PIN +#define AXIS1_SENSE_LIMIT_MAX_PIN LIMIT_SENSE_PIN +#endif + +#ifndef AXIS2_ENABLE_PIN +#define AXIS2_ENABLE_PIN OFF +#endif +#ifndef AXIS2_M0_PIN +#define AXIS2_M0_PIN OFF +#endif +#ifndef AXIS2_M1_PIN +#define AXIS2_M1_PIN OFF +#endif +#ifndef AXIS2_M2_PIN +#define AXIS2_M2_PIN OFF +#endif +#ifndef AXIS2_M3_PIN +#define AXIS2_M3_PIN OFF +#endif +#ifndef AXIS2_STEP_PIN +#define AXIS2_STEP_PIN OFF +#endif +#ifndef AXIS2_DIR_PIN +#define AXIS2_DIR_PIN OFF +#endif +#ifndef AXIS2_DECAY_PIN +#define AXIS2_DECAY_PIN OFF +#endif +#ifndef AXIS2_SERVO_PH1_PIN +#define AXIS2_SERVO_PH1_PIN AXIS2_DIR_PIN +#endif +#ifndef AXIS2_SERVO_PH2_PIN +#define AXIS2_SERVO_PH2_PIN AXIS2_STEP_PIN +#endif +#ifndef AXIS2_FAULT_PIN +#define AXIS2_FAULT_PIN OFF +#endif +#ifndef AXIS2_SENSE_HOME_PIN +#define AXIS2_SENSE_HOME_PIN OFF +#endif +#ifndef AXIS2_SENSE_LIMIT_MIN_PIN +#define AXIS2_SENSE_LIMIT_MIN_PIN LIMIT_SENSE_PIN +#endif +#ifndef AXIS2_SENSE_LIMIT_MAX_PIN +#define AXIS2_SENSE_LIMIT_MAX_PIN LIMIT_SENSE_PIN +#endif + +#ifndef AXIS3_ENABLE_PIN +#define AXIS3_ENABLE_PIN OFF +#endif +#ifndef AXIS3_M0_PIN +#define AXIS3_M0_PIN OFF +#endif +#ifndef AXIS3_M1_PIN +#define AXIS3_M1_PIN OFF +#endif +#ifndef AXIS3_M2_PIN +#define AXIS3_M2_PIN OFF +#endif +#ifndef AXIS3_M3_PIN +#define AXIS3_M3_PIN OFF +#endif +#ifndef AXIS3_STEP_PIN +#define AXIS3_STEP_PIN OFF +#endif +#ifndef AXIS3_DIR_PIN +#define AXIS3_DIR_PIN OFF +#endif +#ifndef AXIS3_DECAY_PIN +#define AXIS3_DECAY_PIN OFF +#endif +#ifndef AXIS3_SERVO_PH1_PIN +#define AXIS3_SERVO_PH1_PIN OFF +#endif +#ifndef AXIS3_SERVO_PH2_PIN +#define AXIS3_SERVO_PH2_PIN OFF +#endif +#ifndef AXIS3_ENCODER_A_PIN +#define AXIS3_ENCODER_A_PIN OFF +#endif +#ifndef AXIS3_ENCODER_B_PIN +#define AXIS3_ENCODER_B_PIN OFF +#endif +#ifndef AXIS3_FAULT_PIN +#define AXIS3_FAULT_PIN OFF +#endif +#ifndef AXIS3_SENSE_HOME_PIN +#define AXIS3_SENSE_HOME_PIN OFF +#endif +#ifndef AXIS3_SENSE_LIMIT_MIN_PIN +#define AXIS3_SENSE_LIMIT_MIN_PIN OFF +#endif +#ifndef AXIS3_SENSE_LIMIT_MAX_PIN +#define AXIS3_SENSE_LIMIT_MAX_PIN OFF +#endif + +#ifndef AXIS4_ENABLE_PIN +#define AXIS4_ENABLE_PIN OFF +#endif +#ifndef AXIS4_M0_PIN +#define AXIS4_M0_PIN OFF +#endif +#ifndef AXIS4_M1_PIN +#define AXIS4_M1_PIN OFF +#endif +#ifndef AXIS4_M2_PIN +#define AXIS4_M2_PIN OFF +#endif +#ifndef AXIS4_M3_PIN +#define AXIS4_M3_PIN OFF +#endif +#ifndef AXIS4_STEP_PIN +#define AXIS4_STEP_PIN OFF +#endif +#ifndef AXIS4_DIR_PIN +#define AXIS4_DIR_PIN OFF +#endif +#ifndef AXIS4_DECAY_PIN +#define AXIS4_DECAY_PIN OFF +#endif +#ifndef AXIS4_SERVO_PH1_PIN +#define AXIS4_SERVO_PH1_PIN OFF +#endif +#ifndef AXIS4_SERVO_PH2_PIN +#define AXIS4_SERVO_PH2_PIN OFF +#endif +#ifndef AXIS4_ENCODER_A_PIN +#define AXIS4_ENCODER_A_PIN OFF +#endif +#ifndef AXIS4_ENCODER_B_PIN +#define AXIS4_ENCODER_B_PIN OFF +#endif +#ifndef AXIS4_FAULT_PIN +#define AXIS4_FAULT_PIN OFF +#endif +#ifndef AXIS4_SENSE_HOME_PIN +#define AXIS4_SENSE_HOME_PIN OFF +#endif +#ifndef AXIS4_SENSE_LIMIT_MIN_PIN +#define AXIS4_SENSE_LIMIT_MIN_PIN OFF +#endif +#ifndef AXIS4_SENSE_LIMIT_MAX_PIN +#define AXIS4_SENSE_LIMIT_MAX_PIN OFF +#endif + +#ifndef AXIS1_ENCODER_A_PIN +#define AXIS1_ENCODER_A_PIN AXIS3_STEP_PIN +#endif +#ifndef AXIS1_ENCODER_B_PIN +#define AXIS1_ENCODER_B_PIN AXIS3_DIR_PIN +#endif +#ifndef AXIS2_ENCODER_A_PIN +#define AXIS2_ENCODER_A_PIN AXIS4_STEP_PIN +#endif +#ifndef AXIS2_ENCODER_B_PIN + #if AXIS4_DIR_PIN != AXIS3_DIR_PIN || AXIS4_DIR_PIN == OFF + #define AXIS2_ENCODER_B_PIN AXIS4_DIR_PIN + #else + #define AXIS2_ENCODER_B_PIN AXIS2_M3_PIN + #endif +#endif + +#ifndef AXIS5_ENABLE_PIN +#define AXIS5_ENABLE_PIN OFF +#endif +#ifndef AXIS5_M0_PIN +#define AXIS5_M0_PIN OFF +#endif +#ifndef AXIS5_M1_PIN +#define AXIS5_M1_PIN OFF +#endif +#ifndef AXIS5_M2_PIN +#define AXIS5_M2_PIN OFF +#endif +#ifndef AXIS5_M3_PIN +#define AXIS5_M3_PIN OFF +#endif +#ifndef AXIS5_STEP_PIN +#define AXIS5_STEP_PIN OFF +#endif +#ifndef AXIS5_DIR_PIN +#define AXIS5_DIR_PIN OFF +#endif +#ifndef AXIS5_DECAY_PIN +#define AXIS5_DECAY_PIN OFF +#endif +#ifndef AXIS5_SERVO_PH1_PIN +#define AXIS5_SERVO_PH1_PIN OFF +#endif +#ifndef AXIS5_SERVO_PH2_PIN +#define AXIS5_SERVO_PH2_PIN OFF +#endif +#ifndef AXIS5_ENCODER_A_PIN +#define AXIS5_ENCODER_A_PIN OFF +#endif +#ifndef AXIS5_ENCODER_B_PIN +#define AXIS5_ENCODER_B_PIN OFF +#endif +#ifndef AXIS5_FAULT_PIN +#define AXIS5_FAULT_PIN OFF +#endif +#ifndef AXIS5_SENSE_HOME_PIN +#define AXIS5_SENSE_HOME_PIN OFF +#endif +#ifndef AXIS5_SENSE_LIMIT_MIN_PIN +#define AXIS5_SENSE_LIMIT_MIN_PIN OFF +#endif +#ifndef AXIS5_SENSE_LIMIT_MAX_PIN +#define AXIS5_SENSE_LIMIT_MAX_PIN OFF +#endif + +#ifndef AXIS6_ENABLE_PIN +#define AXIS6_ENABLE_PIN OFF +#endif +#ifndef AXIS6_M0_PIN +#define AXIS6_M0_PIN OFF +#endif +#ifndef AXIS6_M1_PIN +#define AXIS6_M1_PIN OFF +#endif +#ifndef AXIS6_M2_PIN +#define AXIS6_M2_PIN OFF +#endif +#ifndef AXIS6_M3_PIN +#define AXIS6_M3_PIN OFF +#endif +#ifndef AXIS6_STEP_PIN +#define AXIS6_STEP_PIN OFF +#endif +#ifndef AXIS6_DIR_PIN +#define AXIS6_DIR_PIN OFF +#endif +#ifndef AXIS6_DECAY_PIN +#define AXIS6_DECAY_PIN OFF +#endif +#ifndef AXIS6_SERVO_PH1_PIN +#define AXIS6_SERVO_PH1_PIN OFF +#endif +#ifndef AXIS6_SERVO_PH2_PIN +#define AXIS6_SERVO_PH2_PIN OFF +#endif +#ifndef AXIS6_ENCODER_A_PIN +#define AXIS6_ENCODER_A_PIN OFF +#endif +#ifndef AXIS6_ENCODER_B_PIN +#define AXIS6_ENCODER_B_PIN OFF +#endif +#ifndef AXIS6_FAULT_PIN +#define AXIS6_FAULT_PIN OFF +#endif +#ifndef AXIS6_SENSE_HOME_PIN +#define AXIS6_SENSE_HOME_PIN OFF +#endif +#ifndef AXIS6_SENSE_LIMIT_MIN_PIN +#define AXIS6_SENSE_LIMIT_MIN_PIN OFF +#endif +#ifndef AXIS6_SENSE_LIMIT_MAX_PIN +#define AXIS6_SENSE_LIMIT_MAX_PIN OFF +#endif + +#ifndef AXIS7_ENABLE_PIN +#define AXIS7_ENABLE_PIN OFF +#endif +#ifndef AXIS7_M0_PIN +#define AXIS7_M0_PIN OFF +#endif +#ifndef AXIS7_M1_PIN +#define AXIS7_M1_PIN OFF +#endif +#ifndef AXIS7_M2_PIN +#define AXIS7_M2_PIN OFF +#endif +#ifndef AXIS7_M3_PIN +#define AXIS7_M3_PIN OFF +#endif +#ifndef AXIS7_STEP_PIN +#define AXIS7_STEP_PIN OFF +#endif +#ifndef AXIS7_DIR_PIN +#define AXIS7_DIR_PIN OFF +#endif +#ifndef AXIS7_DECAY_PIN +#define AXIS7_DECAY_PIN OFF +#endif +#ifndef AXIS7_SERVO_PH1_PIN +#define AXIS7_SERVO_PH1_PIN OFF +#endif +#ifndef AXIS7_SERVO_PH2_PIN +#define AXIS7_SERVO_PH2_PIN OFF +#endif +#ifndef AXIS7_ENCODER_A_PIN +#define AXIS7_ENCODER_A_PIN OFF +#endif +#ifndef AXIS7_ENCODER_B_PIN +#define AXIS7_ENCODER_B_PIN OFF +#endif +#ifndef AXIS7_FAULT_PIN +#define AXIS7_FAULT_PIN OFF +#endif +#ifndef AXIS7_SENSE_HOME_PIN +#define AXIS7_SENSE_HOME_PIN OFF +#endif +#ifndef AXIS7_SENSE_LIMIT_MIN_PIN +#define AXIS7_SENSE_LIMIT_MIN_PIN OFF +#endif +#ifndef AXIS7_SENSE_LIMIT_MAX_PIN +#define AXIS7_SENSE_LIMIT_MAX_PIN OFF +#endif + +#ifndef AXIS8_ENABLE_PIN +#define AXIS8_ENABLE_PIN OFF +#endif +#ifndef AXIS8_M0_PIN +#define AXIS8_M0_PIN OFF +#endif +#ifndef AXIS8_M1_PIN +#define AXIS8_M1_PIN OFF +#endif +#ifndef AXIS8_M2_PIN +#define AXIS8_M2_PIN OFF +#endif +#ifndef AXIS8_M3_PIN +#define AXIS8_M3_PIN OFF +#endif +#ifndef AXIS8_STEP_PIN +#define AXIS8_STEP_PIN OFF +#endif +#ifndef AXIS8_DIR_PIN +#define AXIS8_DIR_PIN OFF +#endif +#ifndef AXIS8_DECAY_PIN +#define AXIS8_DECAY_PIN OFF +#endif +#ifndef AXIS8_SERVO_PH1_PIN +#define AXIS8_SERVO_PH1_PIN OFF +#endif +#ifndef AXIS8_SERVO_PH2_PIN +#define AXIS8_SERVO_PH2_PIN OFF +#endif +#ifndef AXIS8_ENCODER_A_PIN +#define AXIS8_ENCODER_A_PIN OFF +#endif +#ifndef AXIS8_ENCODER_B_PIN +#define AXIS8_ENCODER_B_PIN OFF +#endif +#ifndef AXIS8_FAULT_PIN +#define AXIS8_FAULT_PIN OFF +#endif +#ifndef AXIS8_SENSE_HOME_PIN +#define AXIS8_SENSE_HOME_PIN OFF +#endif +#ifndef AXIS8_SENSE_LIMIT_MIN_PIN +#define AXIS8_SENSE_LIMIT_MIN_PIN OFF +#endif +#ifndef AXIS8_SENSE_LIMIT_MAX_PIN +#define AXIS8_SENSE_LIMIT_MAX_PIN OFF +#endif + +#ifndef AXIS9_ENABLE_PIN +#define AXIS9_ENABLE_PIN OFF +#endif +#ifndef AXIS9_M0_PIN +#define AXIS9_M0_PIN OFF +#endif +#ifndef AXIS9_M1_PIN +#define AXIS9_M1_PIN OFF +#endif +#ifndef AXIS9_M2_PIN +#define AXIS9_M2_PIN OFF +#endif +#ifndef AXIS9_M3_PIN +#define AXIS9_M3_PIN OFF +#endif +#ifndef AXIS9_STEP_PIN +#define AXIS9_STEP_PIN OFF +#endif +#ifndef AXIS9_DIR_PIN +#define AXIS9_DIR_PIN OFF +#endif +#ifndef AXIS9_DECAY_PIN +#define AXIS9_DECAY_PIN OFF +#endif +#ifndef AXIS9_SERVO_PH1_PIN +#define AXIS9_SERVO_PH1_PIN OFF +#endif +#ifndef AXIS9_SERVO_PH2_PIN +#define AXIS9_SERVO_PH2_PIN OFF +#endif +#ifndef AXIS9_ENCODER_A_PIN +#define AXIS9_ENCODER_A_PIN OFF +#endif +#ifndef AXIS9_ENCODER_B_PIN +#define AXIS9_ENCODER_B_PIN OFF +#endif +#ifndef AXIS9_FAULT_PIN +#define AXIS9_FAULT_PIN OFF +#endif +#ifndef AXIS9_SENSE_HOME_PIN +#define AXIS9_SENSE_HOME_PIN OFF +#endif +#ifndef AXIS9_SENSE_LIMIT_MIN_PIN +#define AXIS9_SENSE_LIMIT_MIN_PIN OFF +#endif +#ifndef AXIS9_SENSE_LIMIT_MAX_PIN +#define AXIS9_SENSE_LIMIT_MAX_PIN OFF +#endif + +#ifndef FOCUSER_TEMPERATURE_PIN +#define FOCUSER_TEMPERATURE_PIN OFF // analog pin +#endif +#ifndef FOCUSER_BUTTON_SENSE_IN_PIN +#define FOCUSER_BUTTON_SENSE_IN_PIN OFF +#endif +#ifndef FOCUSER_BUTTON_SENSE_OUT_PIN +#define FOCUSER_BUTTON_SENSE_OUT_PIN OFF +#endif + +#ifndef FEATURE1_TEMPERATURE_PIN +#define FEATURE1_TEMPERATURE_PIN OFF // analog pin +#endif +#ifndef FEATURE2_TEMPERATURE_PIN +#define FEATURE2_TEMPERATURE_PIN OFF +#endif +#ifndef FEATURE3_TEMPERATURE_PIN +#define FEATURE3_TEMPERATURE_PIN OFF +#endif +#ifndef FEATURE4_TEMPERATURE_PIN +#define FEATURE4_TEMPERATURE_PIN OFF +#endif +#ifndef FEATURE5_TEMPERATURE_PIN +#define FEATURE5_TEMPERATURE_PIN OFF +#endif +#ifndef FEATURE6_TEMPERATURE_PIN +#define FEATURE6_TEMPERATURE_PIN OFF +#endif +#ifndef FEATURE7_TEMPERATURE_PIN +#define FEATURE7_TEMPERATURE_PIN OFF +#endif +#ifndef FEATURE8_TEMPERATURE_PIN +#define FEATURE8_TEMPERATURE_PIN OFF +#endif diff --git a/src/pinmaps/Validate.h b/src/pinmaps/Validate.h new file mode 100755 index 0000000..d6e3c7d --- /dev/null +++ b/src/pinmaps/Validate.h @@ -0,0 +1,276 @@ +// ------------------------------------------------------------------------------------------------- +// Validates pinmap model for current configuration +#pragma once + +// -------------------------------------------------------------------------------------- + +#if !defined(SERIAL_A) && SERIAL_A_BAUD_DEFAULT != OFF + #error "Configuration (Config.h): SERIAL_A isn't defined, SERIAL_A_BAUD_DEFAULT should be OFF." +#endif + +#if !defined(SERIAL_B) && SERIAL_B_BAUD_DEFAULT != OFF + #error "Configuration (Config.h): SERIAL_B isn't defined, SERIAL_B_BAUD_DEFAULT should be OFF." +#endif + +#if !defined(SERIAL_C) && SERIAL_C_BAUD_DEFAULT != OFF + #error "Configuration (Config.h): SERIAL_C isn't defined, SERIAL_C_BAUD_DEFAULT should be OFF." +#endif + +#if !defined(SERIAL_D) && SERIAL_D_BAUD_DEFAULT != OFF + #error "Configuration (Config.h): SERIAL_D isn't defined, SERIAL_D_BAUD_DEFAULT should be OFF." +#endif + +#if !defined(SERIAL_E) && SERIAL_E_BAUD_DEFAULT != OFF + #error "Configuration (Config.h): SERIAL_E isn't defined, SERIAL_E_BAUD_DEFAULT should be OFF." +#endif + +// can we flash an ESP8266? +#if SERIAL_B_ESP_FLASHING == ON && (!defined(ADDON_GPIO0_PIN) || !defined(ADDON_RESET_PIN)) + #error "Configuration (Config.h): SERIAL_B_ESP_FLASHING not supported for this PINMAP" +#endif + +// make sure a serial interface is available for any TMC UART driver +#if defined(STEP_DIR_TMC_UART_PRESENT) && !defined(SERIAL_TMC) + #error "Configuration (Config.h): SERIAL_TMC is required for TMC UART drivers" +#endif + +// powering down Dec supported only if EN is available and not shared with Axis1 +#if AXIS2_POWER_DOWN == ON && (AXIS2_EN_PIN == OFF || AXIS2_EN_PIN == SHARED) + #error "Configuration (Config.h): AXIS2_POWER_DOWN not supported on this PINMAP" +#endif + +// TIME_LOCATION_SOURCE DS3234 SPI allowed? +#if TIME_LOCATION_SOURCE == DS3234 && !defined(DS3234_CS_PIN) + #if PINMAP == Classic + #error "Configuration (Config.h): DS3234 TIME_LOCATION_SOURCE using SPI is not supported, use PINMAP ClassicShield or add '#define ST4_ALTERNATE_PINS_ON' to move the ST4 port pins" + #else + #error "Configuration (Config.h): DS3234 TIME_LOCATION_SOURCE using SPI is not supported for this PINMAP" + #endif +#endif + +// focuser/rotators invalid combination? +#if ROTATOR == ON && FOCUSER1 == ON + #if AXIS3_STEP_PIN == AXIS4_STEP_PIN + #error "Configuration (Config.h): AXIS3 and AXIS4 step/dir interface is shared, so enabling both is not supported on this PINMAP" + #endif +#endif + +#if ROTATOR == ON && FOCUSER2 == ON + #if AXIS3_STEP_PIN == AXIS5_STEP_PIN + #error "Configuration (Config.h): AXIS3 and AXIS5 step/dir interface is shared, so enabling both is not supported on this PINMAP" + #endif +#endif + +// -------------------------------------------------------------------------------------- +// check AUX0 pin assignments +#if AUX0_PIN != OFF + #if AUX0_PIN == MOUNT_LED_PIN && STATUS_MOUNT_LED != OFF + #ifdef AUX0_PIN_IN_USE + #error "Configuration (Config.h): STATUS_MOUNT_LED enabled but AUX0_PIN is already in use, choose one feature on AUX0_PIN" + #endif + #define AUX0_PIN_IN_USE + #endif +#endif + +// check AUX1 pin assignments +#if AUX1_PIN != OFF + #if AUX1_PIN == ADDON_GPIO0_PIN && SERIAL_B_ESP_FLASHING != OFF + #ifdef AUX1_PIN_IN_USE + #error "Configuration (Config.h): SERIAL_B_ESP_FLASHING enabled but AUX1_PIN is already in use, choose one feature on AUX1_PIN" + #endif + #define AUX1_PIN_IN_USE + #endif + #if (AUX1_PIN == AXIS1_M3_PIN && AXIS1_DRIVER_STATUS != OFF) || \ + (AUX1_PIN == AXIS2_M3_PIN && AXIS2_DRIVER_STATUS != OFF) || \ + (AUX1_PIN == AXIS3_M3_PIN && AXIS3_DRIVER_STATUS != OFF) || \ + (AUX1_PIN == AXIS4_M3_PIN && AXIS4_DRIVER_STATUS != OFF) || \ + (AUX1_PIN == AXIS5_M3_PIN && AXIS5_DRIVER_STATUS != OFF) || \ + (AUX1_PIN == AXIS6_M3_PIN && AXIS6_DRIVER_STATUS != OFF) || \ + (AUX1_PIN == AXIS7_M3_PIN && AXIS7_DRIVER_STATUS != OFF) || \ + (AUX1_PIN == AXIS8_M3_PIN && AXIS8_DRIVER_STATUS != OFF) || \ + (AUX1_PIN == AXIS9_M3_PIN && AXIS9_DRIVER_STATUS != OFF) + #ifdef AUX1_PIN_IN_USE + #error "Configuration (Config.h): AXISn_DRIVER_STATUS enabled but AUX1_PIN is already in use, choose one feature on AUX1_PIN" + #endif + #define AUX1_PIN_IN_USE + #endif +#endif + +// check AUX2 pin assignments +#if AUX2_PIN != OFF + #if AUX2_PIN == ADDON_RESET_PIN && SERIAL_B_ESP_FLASHING != OFF + #ifdef AUX2_PIN_IN_USE + #error "Configuration (Config.h): SERIAL_B_ESP_FLASHING enabled but AUX2_PIN is already in use, choose one feature on AUX2_PIN" + #endif + #define AUX1_PIN_IN_USE + #endif + #if (AUX2_PIN == AXIS1_M3_PIN && AXIS1_DRIVER_STATUS != OFF) || \ + (AUX2_PIN == AXIS2_M3_PIN && AXIS2_DRIVER_STATUS != OFF) || \ + (AUX2_PIN == AXIS3_M3_PIN && AXIS3_DRIVER_STATUS != OFF) || \ + (AUX2_PIN == AXIS4_M3_PIN && AXIS4_DRIVER_STATUS != OFF) || \ + (AUX2_PIN == AXIS5_M3_PIN && AXIS5_DRIVER_STATUS != OFF) || \ + (AUX2_PIN == AXIS6_M3_PIN && AXIS6_DRIVER_STATUS != OFF) || \ + (AUX2_PIN == AXIS7_M3_PIN && AXIS7_DRIVER_STATUS != OFF) || \ + (AUX2_PIN == AXIS8_M3_PIN && AXIS8_DRIVER_STATUS != OFF) || \ + (AUX2_PIN == AXIS9_M3_PIN && AXIS9_DRIVER_STATUS != OFF) + #ifdef AUX2_PIN_IN_USE + #error "Configuration (Config.h): AXISn_DRIVER_STATUS enabled but AUX2_PIN is already in use, choose one feature on AUX2_PIN" + #endif + #define AUX2_PIN_IN_USE + #endif +#endif + +// check AUX3 pin assignments +#if AUX3_PIN != OFF + #if (AUX3_PIN) == (AXIS1_SENSE_HOME_PIN) && (AXIS1_SENSE_HOME) != OFF + #ifdef AUX3_PIN_IN_USE + #error "Configuration (Config.h): AXIS1_SENSE_HOME enabled but AUX3_PIN is already in use, choose one feature on AUX3_PIN" + #endif + #define AUX3_PIN_IN_USE + #endif + #if (AUX3_PIN) == (LIMIT_SENSE_PIN) && (LIMIT_SENSE) != OFF + #ifdef AUX3_PIN_IN_USE + #error "Configuration (Config.h): LIMIT_SENSE enabled but AUX3_PIN is already in use, choose one feature on AUX3_PIN" + #endif + #define AUX3_PIN_IN_USE + #endif + #if AUX3_PIN == RETICLE_LED_PIN && RETICLE_LED_DEFAULT != OFF + #if AUX3_PIN == STATUS_LED_PIN && STATUS_LED != OFF + #error "Configuration (Config.h): RETICLE_LED_DEFAULT and STATUS_LED can't both be enabled on the same AUX3_PIN" + #endif + #ifdef AUX3_PIN_IN_USE + #error "Configuration (Config.h): RETICLE_LED_DEFAULT enabled but AUX3_PIN is already in use, choose one feature on AUX3_PIN" + #endif + #define AUX3_PIN_IN_USE + #endif +#endif + +// check AUX4 pin assignments +#if AUX4_PIN != OFF + #if (AUX4_PIN) == (AXIS2_SENSE_HOME_PIN) && (AXIS2_SENSE_HOME) != OFF + #ifdef AUX4_PIN_IN_USE + #error "Configuration (Config.h): AXIS2_SENSE_HOME enabled but AUX4_PIN is already in use, choose one feature on AUX4_PIN" + #endif + #define AUX4_PIN_IN_USE + #endif + #if AUX4_PIN == RETICLE_LED_PIN && RETICLE_LED_DEFAULT != OFF + #ifdef AUX4_PIN_IN_USE + #error "Configuration (Config.h): RETICLE_LED_DEFAULT enabled but AUX4_PIN is already in use, choose one feature on AUX4_PIN" + #endif + #define AUX4_PIN_IN_USE + #endif +#endif + +// check AUX5 pin assignments +// not checked, for Axis3 enable or Serial + +// check AUX6 pin assignments +// not checked, for Axis4 enable or Serial + +// check AUX7 pin assignments +#if AUX7_PIN != OFF + #if (AUX7_PIN) == (LIMIT_SENSE_PIN) && (LIMIT_SENSE) != OFF + #ifdef AUX7_PIN_IN_USE + #error "Configuration (Config.h): LIMIT_SENSE enabled but AUX7_PIN is already in use, choose one feature on AUX7_PIN" + #endif + #define AUX7_PIN_IN_USE + #endif + #if (AUX7_PIN) == (PPS_SENSE_PIN) && (TIME_LOCATION_PPS_SENSE) != OFF + #ifdef AUX7_PIN_IN_USE + #error "Configuration (Config.h): TIME_LOCATION_PPS_SENSE enabled but AUX7_PIN is already in use, choose one feature on AUX7_PIN" + #endif + #define AUX7_PIN_IN_USE + #endif +#endif + +// check AUX8 pin assignments +#if AUX8_PIN != OFF + #if AUX8_PIN == MOUNT_LED_PIN && STATUS_MOUNT_LED != OFF + #ifdef AUX8_PIN_IN_USE + #error "Configuration (Config.h): STATUS_MOUNT_LED enabled but AUX8_PIN is already in use, choose one feature on AUX8_PIN" + #endif + #define AUX8_PIN_IN_USE + #endif + #if AUX8_PIN == RETICLE_LED_PIN && RETICLE_LED_DEFAULT != OFF + #if AUX8_PIN == STATUS_LED_PIN && STATUS_LED != OFF + #error "Configuration (Config.h): RETICLE_LED_DEFAULT and STATUS_LED can't both be enabled on the same AUX8_PIN" + #endif + #ifdef AUX8_PIN_IN_USE + #error "Configuration (Config.h): RETICLE_LED_DEFAULT enabled but AUX8_PIN is already in use, choose one feature on AUX8_PIN" + #endif + #define AUX8_PIN_IN_USE + #endif + #if AUX8_PIN == STATUS_BUZZER_PIN && STATUS_BUZZER != OFF + #ifdef AUX8_PIN_IN_USE + #error "Configuration (Config.h): STATUS_BUZZER enabled but AUX8_PIN is already in use, choose one feature on AUX8_PIN" + #endif + #define AUX8_PIN_IN_USE + #endif +#endif + +// -------------------------------------------------------------------------------------- +// check/assign AUX pins to auxiliary features +#if FEATURE1_PURPOSE != OFF && FEATURE1_PIN == AUX && AUX1_PIN != OFF + #ifdef AUX1_PIN_IN_USE + #error "Configuration (Config.h): FEATURE1_PIN AUX enabled but AUX1_PIN is already in use, choose one feature on AUX1_PIN" + #endif + #undef FEATURE1_PIN + #define FEATURE1_PIN AUX1_PIN + #define AUX1_PIN_IN_USE +#endif +#if FEATURE2_PURPOSE != OFF && FEATURE2_PIN == AUX && AUX2_PIN != OFF + #ifdef AUX2_PIN_IN_USE + #error "Configuration (Config.h): FEATURE2_PIN AUX enabled but AUX2_PIN is already in use, choose one feature on AUX2_PIN" + #endif + #undef FEATURE2_PIN + #define FEATURE2_PIN AUX2_PIN + #define AUX2_PIN_IN_USE +#endif +#if FEATURE3_PURPOSE != OFF && FEATURE3_PIN == AUX && AUX3_PIN != OFF + #ifdef AUX3_PIN_IN_USE + #error "Configuration (Config.h): FEATURE3_PIN AUX enabled but AUX3_PIN is already in use, choose one feature on AUX3_PIN" + #endif + #undef FEATURE3_PIN + #define FEATURE3_PIN AUX3_PIN + #define AUX3_PIN_IN_USE +#endif +#if FEATURE4_PURPOSE != OFF && FEATURE4_PIN == AUX && AUX4_PIN != OFF + #ifdef AUX4_PIN_IN_USE + #error "Configuration (Config.h): FEATURE4_PIN AUX enabled but AUX4_PIN is already in use, choose one feature on AUX4_PIN" + #endif + #undef FEATURE4_PIN + #define FEATURE4_PIN AUX4_PIN + #define AUX4_PIN_IN_USE +#endif +#if FEATURE5_PURPOSE != OFF && FEATURE5_PIN == AUX && AUX5_PIN != OFF + #ifdef AUX5_PIN_IN_USE + #error "Configuration (Config.h): FEATURE5_PIN AUX enabled but AUX5_PIN is already in use, choose one feature on AUX5_PIN" + #endif + #undef FEATURE5_PIN + #define FEATURE5_PIN AUX5_PIN + #define AUX5_PIN_IN_USE +#endif +#if FEATURE6_PURPOSE != OFF && FEATURE6_PIN == AUX && AUX6_PIN != OFF + #ifdef AUX6_PIN_IN_USE + #error "Configuration (Config.h): FEATURE6_PIN AUX enabled but AUX6_PIN is already in use, choose one feature on AUX6_PIN" + #endif + #undef FEATURE6_PIN + #define FEATURE6_PIN AUX6_PIN + #define AUX6_PIN_IN_USE +#endif +#if FEATURE7_PURPOSE != OFF && FEATURE7_PIN == AUX && AUX7_PIN != OFF + #ifdef AUX7_PIN_IN_USE + #error "Configuration (Config.h): FEATURE7_PIN AUX enabled but AUX7_PIN is already in use, choose one feature on AUX7_PIN" + #endif + #undef FEATURE7_PIN + #define FEATURE7_PIN AUX7_PIN + #define AUX7_PIN_IN_USE +#endif +#if FEATURE8_PURPOSE != OFF && FEATURE8_PIN == AUX && AUX8_PIN != OFF + #ifdef AUX8_PIN_IN_USE + #error "Configuration (Config.h): FEATURE8_PIN AUX enabled but AUX8_PIN is already in use, choose one feature on AUX8_PIN" + #endif + #undef FEATURE8_PIN + #define FEATURE8_PIN AUX8_PIN + #define AUX8_PIN_IN_USE +#endif diff --git a/src/telescope/Telescope.command.cpp b/src/telescope/Telescope.command.cpp new file mode 100755 index 0000000..00ce48d --- /dev/null +++ b/src/telescope/Telescope.command.cpp @@ -0,0 +1,285 @@ +//-------------------------------------------------------------------------------------------------- +// OnStepX telescope control + +#include "../Common.h" + +#include "Telescope.h" + +#include "../lib/tasks/OnTask.h" +#include "../lib/gpioEx/GpioEx.h" +#include "../lib/nv/Nv.h" + +#include "../lib/analog/Analog.h" +#include "../lib/convert/Convert.h" + +#include "../libApp/commands/ProcessCmds.h" +#include "../libApp/weather/Weather.h" + +#include "addonFlasher/AddonFlasher.h" +#include "mount/Mount.h" +#include "mount/goto/Goto.h" +#include "mount/guide/Guide.h" +#include "mount/home/Home.h" +#include "mount/library/Library.h" +#include "mount/limits/Limits.h" +#include "mount/park/Park.h" +#include "mount/pec/Pec.h" +#include "mount/site/Site.h" +#include "mount/status/Status.h" +#include "rotator/Rotator.h" +#include "focuser/Focuser.h" +#include "auxiliary/Features.h" +#include "../plugins/Plugins.config.h" + +// possible reset function for this MCU +#ifdef HAL_RESET_FUNC + HAL_RESET_FUNC; +#endif + +bool Telescope::command(char reply[], char command[], char parameter[], bool *suppressFrame, bool *numericReply, CommandError *commandError) { + + #if PLUGIN1 != OFF && PLUGIN1_COMMAND_PROCESSING == ON + if (PLUGIN1.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + #if PLUGIN2 != OFF && PLUGIN2_COMMAND_PROCESSING == ON + if (PLUGIN2.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + #if PLUGIN3 != OFF && PLUGIN3_COMMAND_PROCESSING == ON + if (PLUGIN3.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + #if PLUGIN4 != OFF && PLUGIN4_COMMAND_PROCESSING == ON + if (PLUGIN4.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + #if PLUGIN5 != OFF && PLUGIN5_COMMAND_PROCESSING == ON + if (PLUGIN5.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + #if PLUGIN6 != OFF && PLUGIN6_COMMAND_PROCESSING == ON + if (PLUGIN6.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + #if PLUGIN7 != OFF && PLUGIN7_COMMAND_PROCESSING == ON + if (PLUGIN7.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + #if PLUGIN8 != OFF && PLUGIN8_COMMAND_PROCESSING == ON + if (PLUGIN8.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + + #ifdef MOUNT_PRESENT + if (mount.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (guide.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #if GPIO_DEVICE != OFF + if (gpio.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + if (mountStatus.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (goTo.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (park.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (library.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (site.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (limits.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (home.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (pec.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (axis1.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + if (axis2.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + + #if defined(ROTATOR_PRESENT) || defined(ROTATOR_CLIENT_PRESENT) + if (rotator.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + + #if defined(FOCUSER_PRESENT) || defined(FOCUSER_CLIENT_PRESENT) + if (focuser.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + + #if defined(FEATURES_PRESENT) || defined(FEATURES_CLIENT_PRESENT) + if (features.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + #endif + + // B - Reticle/Accessory Control + // :B+# Increase reticle Brightness + // Returns: Nothing + // :B-# Decrease Reticle Brightness + // Returns: Nothing + if (command[0] == 'B' && (command[1] == '+' || command[1] == '-') && parameter[0] == 0) { + #if RETICLE_LED_DEFAULT >= 0 && RETICLE_LED_PIN != OFF + int scale; + if (reticleBrightness > 255 - 8) scale = 1; else + if (reticleBrightness > 255 - 32) scale = 4; else + if (reticleBrightness > 255 - 64) scale = 12; else + if (reticleBrightness > 255 - 128) scale = 32; else scale = 64; + if (command[1] == '-') reticleBrightness += scale; + if (reticleBrightness > 255) reticleBrightness = 255; + if (command[1] == '+') reticleBrightness -= scale; + if (reticleBrightness < 0) reticleBrightness = 0; + + float duty = (float)reticleBrightness*(1.0F/255.0F); + analog.write(RETICLE_LED_PIN, RETICLE_LED_INVERT == ON ? duty : 1.0F - duty); + + #if RETICLE_LED_MEMORY == ON + nv().kv().put("TELESCOPE_SETTINGS", reticleBrightness); + #endif + #endif + *numericReply = false; + } else + + // E - Enter special mode + if (command[0] == 'E') { + // :EC[s]# Echo string [s] as a debug message + // Return: Nothing + if (command[1] == 'C') { + // spaces are encoded as '_' + for (unsigned int i = 0; i < strlen(parameter); i++) if (parameter[i] == '_') parameter[i] = ' '; + // prefix with "REM> " + if (strstr(parameter, "ERR:") == parameter || strstr(parameter, "WRN:") == parameter || strstr(parameter, "MSG:") == parameter) { D("REM> "); } + // a newline is encoded as '&' in the last char of message + int l = strlen(parameter); + if (l > 0 && parameter[l - 1] == '&') { parameter[l - 1] = 0; DL(parameter); } else { D(parameter); } + *numericReply = false; + } else + + // :ERESET# Reset the MCU + // Returns: Nothing + if (command[1] == 'R' && parameter[0] == 'E' && parameter[1] == 'S' && parameter[2] == 'E' && parameter[3] == 'T' && parameter[4] == 0) { + + #ifdef HAL_RESET + VLF("MSG: Mount, resetting OnStep..."); + if (nv().device().hasCommit()) { nv().device().commit(); } + const uint32_t startMs = millis(); + const uint32_t timeoutMs = 30000; + while (!nv().device().commitDone() && (uint32_t)(millis() - startMs) < timeoutMs) { tasks.yield(1000); } + tasks.yield(1000); + HAL_RESET(); + #endif + + *numericReply = false; + } else + + // :ENVRESET# Wipe flash + if (command[1] == 'N' && parameter[0] == 'V' && parameter[1] == 'R' && parameter[2] == 'E' && parameter[3] == 'S' && parameter[4] == 'E' && parameter[5] == 'T' && parameter[6] == 0) { + nv().volume().invalidateNextMount(); + strcpy(reply, "NV memory will be cleared on the next boot."); + *numericReply = false; + } else + + // :ESPFLASH# ESP8266 device flash mode + // Return: 1 on completion (after up to one minute from start of command.) + #if SERIAL_B_ESP_FLASHING == ON + if (command[1] == 'S' && parameter[0] == 'P' && parameter[1] == 'F' && parameter[2] == 'L' && parameter[3] == 'A' && parameter[4] == 'S' && parameter[5] == 'H' && parameter[6] == 0) { + SERIAL_A.println("The SWS microcontroller will now be placed in flash upload mode (at 115200 Baud.)"); + SERIAL_A.println("Arduino's 'Tools -> Upload Speed' should be set to 115200 Baud."); + SERIAL_A.println("Waiting for data, you have one minute to start the upload."); + tasks.yield(1000); + addonFlasher.go(); + SERIAL_A.println("SWS microcontroller reset and in run mode, resuming operation..."); + tasks.yield(1000); + } else + #elif ADDON_SELECT_PIN != OFF + if (command[1] == 'S' && parameter[0] == 'P' && parameter[1] == 'F' && parameter[2] == 'L' && parameter[3] == 'A' && parameter[4] == 'S' && parameter[5] == 'H' && parameter[6] == 0) { + SERIAL_A.println("The SWS microcontroller will now be connected to USB for flashing firmware."); + SERIAL_A.println("Once done uploading power cycle or reboot to restore normal operation."); + tasks.yield(1000); + pinModeEx(ADDON_SELECT_PIN, OUTPUT); + digitalWriteEx(ADDON_SELECT_PIN, LOW); + } else + #endif + *commandError = CE_CMD_UNKNOWN; + } else + + if (command[0] == 'G') { + // :GVD# Get OnStepX Firmware Date + // Returns: MTH DD YYYY# + // :GVM# General Message + // Returns: s# (where s is a string up to 16 chars) + // :GVN# Get Firmware Number + // Returns: M.mp# + // :GVP# Get Product Name + // Returns: s# + // :GVT# Get Firmware Time + // Returns: HH:MM:SS# + // :GVC# Get Firmware Config Name + // Returns: s# + // :GVH# Get Firmware Hardware + // Returns: s# + if (command[1] == 'V' && parameter[1] == 0) { + if (parameter[0] == 'D') strcpy(reply, firmware.date); else + if (parameter[0] == 'M') sprintf(reply, "%s %i.%02i%s", firmware.name, firmware.version.major, firmware.version.minor, firmware.version.patch); else + if (parameter[0] == 'N') sprintf(reply, "%i.%02i%s", firmware.version.major, firmware.version.minor, firmware.version.patch); else + if (parameter[0] == 'P') strcpy(reply, firmware.name); else + if (parameter[0] == 'T') strcpy(reply, firmware.time); else + if (parameter[0] == 'C') { strncpy(reply, PRODUCT_DESCRIPTION, 40); } else + if (parameter[0] == 'H') strcpy(reply, PINMAP_STR); else *commandError = CE_CMD_UNKNOWN; + *numericReply = false; + } else + + if (command[1] == 'X' && parameter[2] == 0) { + if (parameter[0] == '9') { + // :GX9A# temperature in deg. C + // Returns: +/-n.n + if (parameter[1] == 'A') { + sprintF(reply, "%3.1f", weather.getTemperature()); + *numericReply = false; + } else + + // :GX9B# pressure in mb + // Returns: +/-n.n + if (parameter[1] == 'B') { + sprintF(reply, "%3.1f", weather.getPressure()); + *numericReply = false; + } else + + // :GX9C# relative humidity in % + // Returns: +/-n.n + if (parameter[1] == 'C') { + sprintF(reply, "%3.1f", weather.getHumidity()); + *numericReply = false; + } else + + // :GX9E# dew point in deg. C + // Returns: +/-n.n + if (parameter[1] == 'E') { + sprintF(reply, "%3.1f", weather.getDewPoint()); + *numericReply = false; + } else + + // :GX9F# MCU temperature in deg. C + // Returns: +/-n.n + if (parameter[1] == 'F') { + if (!isnan(telescope.mcuTemperature)) { + sprintF(reply, "%1.0f", telescope.mcuTemperature); + *numericReply = false; + } else { + *numericReply = true; + *commandError = CE_0; + } + } else return false; + } else return false; + + } else return false; + } else + + if (command[0] == 'S' && command[1] == 'X' && parameter[2] == ',') { + if (parameter[0] == '9') { + char *conv_end; + float f = strtod(¶meter[3], &conv_end); + if (¶meter[3] == conv_end) f = NAN; + // :SX9A,[sn.n]# + // Set temperature in deg. C + // Return: 0 failure, 1 success + if (parameter[1] == 'A') { + if (!weather.setTemperature(f)) *commandError = CE_PARAM_RANGE; + } else + // :SX9B,[n.n]# + // Set pressure in mb + // Return: 0 failure, 1 success + if (parameter[1] == 'B') { + if (!weather.setPressure(f)) *commandError = CE_PARAM_RANGE; + } else + // :SX9C,[n.n]# + // relative humidity in % + // Return: 0 failure, 1 success + if (parameter[1] == 'C') { + if (!weather.setHumidity(f)) *commandError = CE_PARAM_RANGE; + } else return false; + } else return false; + } else return false; + + return true; +} diff --git a/src/telescope/Telescope.cpp b/src/telescope/Telescope.cpp new file mode 100755 index 0000000..1bcfafa --- /dev/null +++ b/src/telescope/Telescope.cpp @@ -0,0 +1,334 @@ +//-------------------------------------------------------------------------------------------------- +// OnStepX telescope control + +#include "../Common.h" + +#include "../lib/tasks/OnTask.h" +#include "../lib/gpioEx/GpioEx.h" +#include "../lib/nv/Nv.h" +#include "../lib/analog/Analog.h" +#include "../lib/convert/Convert.h" +#include "../lib/canPlus/CanPlus.h" + +#include "../libApp/commands/ProcessCmds.h" +#include "../libApp/weather/Weather.h" +#include "../libApp/temperature/Temperature.h" + +#include "Telescope.h" + +#include "addonFlasher/AddonFlasher.h" +#include "mount/Mount.h" +#include "mount/goto/Goto.h" +#include "mount/guide/Guide.h" +#include "mount/home/Home.h" +#include "mount/library/Library.h" +#include "mount/limits/Limits.h" +#include "mount/park/Park.h" +#include "mount/pec/Pec.h" +#include "mount/site/Site.h" +#include "mount/status/Status.h" +#include "rotator/Rotator.h" +#include "focuser/Focuser.h" +#include "auxiliary/Features.h" + +bool xBusy = false; +InitError initError; + +void mcuTempWrapper() { telescope.mcuTemperature = (telescope.mcuTemperature*9.0F + HAL_TEMP())/10.0F; } + +#if STATUS_LED != OFF && STATUS_LED_PIN != OFF + void statusFlash() { + static uint8_t cycle = 0; + if (cycle++ > 16) cycle = 0; + + #if GPIO_DEVICE != OFF + if (gpio.lateInitError) initError.gpio = true; + #endif + + // show only the most severe error (in order) + uint8_t flashes = 0; + if (initError.nv) flashes = 1; else + if (initError.value) flashes = 2; else + if (initError.gpio) flashes = 3; else + if (initError.driver) flashes = 4; else + if (initError.tls) flashes = 5; else + if (initError.weather) flashes = 6; + + int pin = STATUS_LED_PIN; + + // everything is ok, turn on LED and exit + if (flashes == 0) { digitalWriteEx(pin, STATUS_LED_ON_STATE); return; } + + // flash the LED if there's an error + if (cycle%2 == 0) { digitalWriteEx(pin, !STATUS_LED_ON_STATE); } else { if (cycle/2 < flashes) digitalWriteEx(pin, STATUS_LED_ON_STATE); } + } +#endif + +Telescope::Telescope() { + // early init for stepper drivers + #ifdef AXIS1_STEP_DIR_PRESENT + if (AXIS1_STEP_PIN >= 0 && AXIS1_STEP_PIN <= 255) pinMode(AXIS1_STEP_PIN, OUTPUT); + #endif + #ifdef AXIS2_STEP_DIR_PRESENT + if (AXIS2_STEP_PIN >= 0 && AXIS2_STEP_PIN <= 255) pinMode(AXIS2_STEP_PIN, OUTPUT); + #endif + #ifdef AXIS3_STEP_DIR_PRESENT + if (AXIS3_STEP_PIN >= 0 && AXIS3_STEP_PIN <= 255) pinMode(AXIS3_STEP_PIN, OUTPUT); + #endif + #ifdef AXIS4_STEP_DIR_PRESENT + if (AXIS4_STEP_PIN >= 0 && AXIS4_STEP_PIN <= 255) pinMode(AXIS4_STEP_PIN, OUTPUT); + #endif + #ifdef AXIS5_STEP_DIR_PRESENT + if (AXIS5_STEP_PIN >= 0 && AXIS5_STEP_PIN <= 255) pinMode(AXIS5_STEP_PIN, OUTPUT); + #endif + #ifdef AXIS6_STEP_DIR_PRESENT + if (AXIS6_STEP_PIN >= 0 && AXIS6_STEP_PIN <= 255) pinMode(AXIS6_STEP_PIN, OUTPUT); + #endif + #ifdef AXIS7_STEP_DIR_PRESENT + if (AXIS7_STEP_PIN >= 0 && AXIS7_STEP_PIN <= 255) pinMode(AXIS7_STEP_PIN, OUTPUT); + #endif + #ifdef AXIS8_STEP_DIR_PRESENT + if (AXIS8_STEP_PIN >= 0 && AXIS8_STEP_PIN <= 255) pinMode(AXIS8_STEP_PIN, OUTPUT); + #endif + #ifdef AXIS9_STEP_DIR_PRESENT + if (AXIS9_STEP_PIN >= 0 && AXIS9_STEP_PIN <= 255) pinMode(AXIS9_STEP_PIN, OUTPUT); + #endif + + if (AXIS1_ENABLE_PIN >= 0 && AXIS1_ENABLE_PIN <= 255) { pinMode(AXIS1_ENABLE_PIN, OUTPUT); digitalWrite(AXIS1_ENABLE_PIN, !AXIS1_ENABLE_STATE); } + if (AXIS2_ENABLE_PIN >= 0 && AXIS2_ENABLE_PIN <= 255) { pinMode(AXIS2_ENABLE_PIN, OUTPUT); digitalWrite(AXIS2_ENABLE_PIN, !AXIS2_ENABLE_STATE); } + if (AXIS3_ENABLE_PIN >= 0 && AXIS3_ENABLE_PIN <= 255) { pinMode(AXIS3_ENABLE_PIN, OUTPUT); digitalWrite(AXIS3_ENABLE_PIN, !AXIS3_ENABLE_STATE); } + if (AXIS4_ENABLE_PIN >= 0 && AXIS4_ENABLE_PIN <= 255) { pinMode(AXIS4_ENABLE_PIN, OUTPUT); digitalWrite(AXIS4_ENABLE_PIN, !AXIS4_ENABLE_STATE); } + if (AXIS5_ENABLE_PIN >= 0 && AXIS5_ENABLE_PIN <= 255) { pinMode(AXIS5_ENABLE_PIN, OUTPUT); digitalWrite(AXIS5_ENABLE_PIN, !AXIS5_ENABLE_STATE); } + if (AXIS6_ENABLE_PIN >= 0 && AXIS6_ENABLE_PIN <= 255) { pinMode(AXIS6_ENABLE_PIN, OUTPUT); digitalWrite(AXIS6_ENABLE_PIN, !AXIS6_ENABLE_STATE); } + if (AXIS7_ENABLE_PIN >= 0 && AXIS7_ENABLE_PIN <= 255) { pinMode(AXIS7_ENABLE_PIN, OUTPUT); digitalWrite(AXIS7_ENABLE_PIN, !AXIS7_ENABLE_STATE); } + if (AXIS8_ENABLE_PIN >= 0 && AXIS8_ENABLE_PIN <= 255) { pinMode(AXIS8_ENABLE_PIN, OUTPUT); digitalWrite(AXIS8_ENABLE_PIN, !AXIS8_ENABLE_STATE); } + if (AXIS9_ENABLE_PIN >= 0 && AXIS9_ENABLE_PIN <= 255) { pinMode(AXIS9_ENABLE_PIN, OUTPUT); digitalWrite(AXIS9_ENABLE_PIN, !AXIS9_ENABLE_STATE); } + #ifdef SHARED_ENABLE_PIN + if (SHARED_ENABLE_PIN >= 0 && SHARED_ENABLE_PIN <= 255) { pinMode(SHARED_ENABLE_PIN, OUTPUT); digitalWrite(SHARED_ENABLE_PIN, !SHARED_ENABLE_STATE); } + #endif + #ifdef SHARED_ENABLE_PIN2 + if (SHARED_ENABLE_PIN2 >= 0 && SHARED_ENABLE_PIN2 <= 255) { pinMode(SHARED_ENABLE_PIN2, OUTPUT); digitalWrite(SHARED_ENABLE_PIN2, !SHARED2_ENABLE_STATE); } + #endif + #ifdef SHARED_ENABLE_PIN3 + if (SHARED_ENABLE_PIN3 >= 0 && SHARED_ENABLE_PIN3 <= 255) { pinMode(SHARED_ENABLE_PIN3, OUTPUT); digitalWrite(SHARED_ENABLE_PIN3, !SHARED3_ENABLE_STATE); } + #endif +} + +void Telescope::init(const char *fwName, int fwMajor, int fwMinor, const char *fwPatch, int fwConfig) { + sstrcpy(firmware.name, fwName); + firmware.version.major = fwMajor; + firmware.version.minor = fwMinor; + sstrcpy(firmware.version.patch, fwPatch); + firmware.version.config = fwConfig; + sstrcpy(firmware.date, __DATE__); + sstrcpy(firmware.time, __TIME__); + + // -------------------------------------------------------------------------------------------------- + // start the NV/EEPROM subsystem for settings storage + initError.nv = false; + initError.value = false; + bool success = nv().init(); + NvVolume &nvVolume = nv().volume(); + + success = success && (nvVolume.mount("OnStepX", NV_VOLUME_SIGNATURE) == NvVolume::Status::Ok); + VF("MSG: Nv, volume "); + if (success) { VLF("'OnStepX' mounted"); } else { VLF("invalid/unformatted"); } + + if (!success) { + + // automatic kv partition sizing + uint32_t vSize = nvVolume.byteCount() - 32; + uint32_t kvSize = vSize; + if (vSize > 1039) { + + // start the volume format + success = nvVolume.formatBegin("OnStepX", NV_VOLUME_SIGNATURE) == NvVolume::Status::Ok; + if (success) { VF("MSG: Nv, volume 'OnStepX' format started ("); V(vSize); VLF(" bytes)"); } + + // first add the KV partition + if (vSize < 1536) kvSize = 1040; // 1080 class (no PEC/Lib) + else if (vSize < 3072) kvSize = 1536; // 2KB class (~0.5K for Lib) + else if (vSize < 6144) kvSize = 2048; // 4KB class (~2K for PEC/Lib) + else if (vSize < 16384) kvSize = 3072; // 8KB class (~5K for PEC/Lib) + else kvSize = 4080; // and up + + success = success && nvVolume.formatAddPartition("KV", kvSize); + if (success) { VF("MSG: Nv, volume format added 'KV' partition ("); V(kvSize); VLF(" bytes)"); } + + // next any PEC partition + uint32_t pecSize = 0; + #if AXIS1_PEC == ON + pecSize = ((PEC_BUFFER_SIZE_LIMIT) >> 4) << 4; + if (kvSize + pecSize > vSize) { pecSize = 0; } + + if (pecSize > 15) { + success = success && nvVolume.formatAddPartition("PEC", pecSize); + if (success) { VF("MSG: Nv, volume format added 'PEC' partition ("); V(pecSize); VLF(" bytes)"); } + } + #endif + + // next any Library partition + uint32_t libSize = vSize - pecSize - kvSize; + if (libSize >= 16) { + success = success && nvVolume.formatAddPartition("LIBRARY", 0); + if (success) { VF("MSG: Nv, volume format added 'LIBRARY' partition ("); V(libSize); VLF(" bytes)"); } + } + + // finally commit the volume format + success = success && (nvVolume.formatCommit() == NvVolume::Status::Ok); + if (success) { VLF("MSG: Nv, volume format done"); } + + // try to mount the volume again + success = success && (nvVolume.mount("OnStepX", NV_VOLUME_SIGNATURE) == NvVolume::Status::Ok); + if (success) { VLF("MSG: Nv, volume 'OnStepX' mounted"); } else { DLF("WRN: Nv, volume 'OnStepX' mount FAILED!"); } + + } else { + DLF("WRN: Nv, volume compatible storage device NOT FOUND!"); + success = false; + } + } + + // Bind global KV instance to the KV partition index + success = success && (nv().kv().init(nvVolume, "KV") == KvPartition::Status::Ok); + if (success) { VLF("MSG: Nv, partition 'KV' mounted"); } else { DLF("WRN: Nv, partition 'KV' mount FAILED!"); } + + if (!success) { + VLF("WRN: Nv, init FAILED!"); + initError.nv = true; + } + nv().kv().resetInitErrorFlag(); + // -------------------------------------------------------------------------------------------------- + + #if RETICLE_LED_DEFAULT >= 0 && RETICLE_LED_PIN != OFF + analog.pwmInit(RETICLE_LED_DEFAULT); + #endif + + #ifdef USES_HW_SPI + SPI.begin(); + #endif + + #if CAN_PLUS != OFF + canPlus.init(); + #endif + + #if GPIO_DEVICE != OFF + if (!gpio.init()) initError.gpio = true; + #endif + + #ifdef SHARED_ENABLE_PIN + pinModeEx(SHARED_ENABLE_PIN, OUTPUT); + digitalWriteEx(SHARED_ENABLE_PIN, !SHARED_ENABLE_STATE); + #endif + #ifdef SHARED_ENABLE_PIN2 + pinModeEx(SHARED_ENABLE_PIN2, OUTPUT); + digitalWriteEx(SHARED_ENABLE_PIN2, !SHARED2_ENABLE_STATE); + #endif + #ifdef SHARED_ENABLE_PIN3 + pinModeEx(SHARED_ENABLE_PIN3, OUTPUT); + digitalWriteEx(SHARED_ENABLE_PIN3, !SHARED3_ENABLE_STATE); + #endif + + #if SERIAL_B_ESP_FLASHING == ON + addonFlasher.init(); + #endif + + mcuTemperature = HAL_TEMP(); + if (!isnan(mcuTemperature)) { + VF("MSG: System, start MCU temperature monitor task (rate 500ms priority 7)... "); + if (tasks.add(500, 0, true, 6, mcuTempWrapper, "SysTemp")) { VLF("success"); } else { VLF("FAILED!"); } + } + weather.init(); + temperature.init(); + + #if OPERATIONAL_MODE == WIFI && WEB_SERVER == ON + wifiManager.init(); + #endif + + #ifdef MOUNT_PRESENT + #if defined(ESP32) && STATUS_BUZZER >= 0 + // hack to trigger one-time ESP32 code debug message to get it out of the way early + tone(STATUS_BUZZER_PIN, STATUS_BUZZER, 1); + #endif + mount.init(); + mountStatus.init(); + #endif + + #if defined(ROTATOR_PRESENT) || defined(ROTATOR_CLIENT_PRESENT) + rotator.init(); + #endif + + #if defined(FOCUSER_PRESENT) || defined(FOCUSER_CLIENT_PRESENT) + focuser.init(); + #endif + + #if defined(FEATURES_PRESENT) || defined(FEATURES_CLIENT_PRESENT) + features.init(); + #endif + + delay(1000); + + #ifdef SHARED_ENABLE_PIN + digitalWriteEx(SHARED_ENABLE_PIN, SHARED_ENABLE_STATE); + #endif + #ifdef SHARED_ENABLE_PIN2 + digitalWriteEx(SHARED_ENABLE_PIN2, SHARED2_ENABLE_STATE); + #endif + #ifdef SHARED_ENABLE_PIN3 + digitalWriteEx(SHARED_ENABLE_PIN3, SHARED3_ENABLE_STATE); + #endif + + #ifdef MOUNT_PRESENT + mount.begin(); + #endif + + #if defined(ROTATOR_PRESENT) || defined(ROTATOR_CLIENT_PRESENT) + rotator.begin(); + #endif + + #if defined(FOCUSER_PRESENT) || defined(FOCUSER_CLIENT_PRESENT) + focuser.begin(); + #endif + + #if defined(FEATURES_PRESENT) || defined(FEATURES_CLIENT_PRESENT) + features.begin(); + #endif + + #if RETICLE_LED_DEFAULT != OFF && RETICLE_LED_PIN != OFF + #if RETICLE_LED_MEMORY == ON + if (!nv().kv().getOrInit("TELESCOPE_SETTINGS", reticleBrightness)) { DLF("WRN: Nv, init failed for TELESCOPE_SETTINGS"); } + reticleBrightness = constrain(reticleBrightness, 0, 255); + #endif + + pinMode(RETICLE_LED_PIN, OUTPUT); + + float duty = (float)reticleBrightness*(1.0F/255.0F); + analog.write(RETICLE_LED_PIN, RETICLE_LED_INVERT == ON ? duty : 1.0F - duty); + #endif + + // bring up status LED and flash error codes + #if STATUS_LED != OFF && STATUS_LED_PIN != OFF + int pin = STATUS_LED_PIN; + pinModeEx(pin, OUTPUT); + VF("MSG: Telescope, start status LED task (rate 500ms priority 4)... "); + if (tasks.add(500, 0, true, 4, statusFlash, "StaLed")) { VLF("success"); } else { VLF("FAILED!"); } + #endif + + // -------------------------------------------------------------------------------------------------- + // init is done let the user see what's in the KV + #if DEBUG != OFF + KvPartition::Stats stats; + if (success && nv().kv().stats(stats) == KvPartition::Status::Ok) { + VF("MSG: Nv, partition 'KV' data blocks used = "); + V(stats.dataBlocksTotal - stats.dataBlocksFree); VF(" (of "); V(stats.dataBlocksTotal); VF(")"); + VF(" key slots used = "); + V(stats.slotsTotal - stats.slotsFree); VF(" (of "); V(stats.slotsTotal); VLF(")"); + } + #endif + + // and capture any errors + if (nv().kv().getInitErrorFlag()) initError.nv = true; + // -------------------------------------------------------------------------------------------------- + +} + +Telescope telescope; diff --git a/src/telescope/Telescope.h b/src/telescope/Telescope.h new file mode 100755 index 0000000..baea0ed --- /dev/null +++ b/src/telescope/Telescope.h @@ -0,0 +1,68 @@ +//-------------------------------------------------------------------------------------------------- +// OnStepX telescope control +#pragma once + +#include "../Common.h" +#include "../libApp/commands/ProcessCmds.h" + +#ifndef ANALOG_WRITE_RANGE + #define ANALOG_WRITE_RANGE 255 +#endif + +enum ParkState: uint8_t {PS_UNPARKED, PS_PARKING, PS_PARKED, PS_PARK_FAILED, PS_UNPARKING}; + +typedef struct InitError { + uint8_t nv:1; // NV data size/structure error (disables writes to NV) + uint8_t value:1; // invalid value error + uint8_t driver:1; // the stepper driver wasn't detected properly (TMC SPI drivers only) + uint8_t weather:1; // the weather source (BME280, etc.) was not found + uint8_t tls:1; // the time location source (DS3231, GPS, etc.) was not found + uint8_t gpio:1; // the GPIO device was not found +} InitError; + +extern InitError initError; + +typedef struct Version { + uint8_t major; + uint8_t minor; + char patch[2]; + uint8_t config; +} Version; + +typedef struct Firmware { + char name[8]; + Version version; + char date[20]; + char time[20]; +} Firmware; + +class Telescope { + public: + Telescope(); + + // setup the location, time keeping, and coordinate converson + void init(const char *fwName, int fwMajor, int fwMinor, const char *fwPatch, int fwConfig); + + // update the location for time keeping and coordinate conversion + void updateSite(); + + // handle commands + bool command(char reply[], char command[], char parameter[], bool *suppressFrame, bool *numericReply, CommandError *commandError); + + void statusInit(); + + bool ready = false; + + float mcuTemperature; + + private: + Firmware firmware; + int16_t reticleBrightness = RETICLE_LED_DEFAULT; +}; + +// true during timing sensitive operations (for disabling I2C etc.) +extern bool xBusy; + +#define analog8BitToAnalogRange(v) ((v)*ANALOG_WRITE_RANGE/255) + +extern Telescope telescope; diff --git a/src/telescope/addonFlasher/AddonFlasher.cpp b/src/telescope/addonFlasher/AddonFlasher.cpp new file mode 100755 index 0000000..dd67170 --- /dev/null +++ b/src/telescope/addonFlasher/AddonFlasher.cpp @@ -0,0 +1,135 @@ +// Flashes an esp8266 based SWS on the SERIAL_PASSTHROUGH interface by passing data to/from SERIAL_A + +#include "AddonFlasher.h" + +#include "../../lib/tasks/OnTask.h" +#include "../../lib/gpioEx/GpioEx.h" + +#if SERIAL_PASSTHROUGH == HardSerial +#define SERIAL_PASSTHROUGH_RXTX_SET +extern HardwareSerial HWSerialB; +#undef SERIAL_PASSTHROUGH +#define SERIAL_PASSTHROUGH HWSerialB +#endif + +// ADDON_TRIGR_PIN HIGH for run and LOW for trigger serial passthrough mode +// ADDON_RESET_PIN HIGH for run and LOW for reset +// ADDON_GPIO0_PIN HIGH for run and LOW for firmware upload + +#if defined(SERIAL_PASSTHROUGH) + + #if ADDON_TRIGR_PIN != OFF + void addonFlasherWrapper() { addonFlasher.poll(); } + #endif + + void AddonFlasher::init() { + VF("MSG: AddonFlasher, init gpio0="); V(ADDON_GPIO0_PIN); VF(", reset="); VL(ADDON_RESET_PIN); + pinModeEx(ADDON_GPIO0_PIN, OUTPUT); + pinModeEx(ADDON_RESET_PIN, OUTPUT); + + run(); + + #if ADDON_TRIGR_PIN != OFF + pinModeEx(ADDON_TRIGR_PIN, INPUT); + VF("MSG: AddonFlasher, trigger pin monitor (rate 100ms priority 5)... "); + if (tasks.add(100, 0, true, 5, addonFlasherWrapper, "adonTgr")) { VLF("success"); } else { VLF("FAILED!"); } + #endif + } + + void AddonFlasher::go(bool timeout) { + // program mode and 115200 serial comms + flash(); + + VLF("MSG: AddonFlasher, activating serial passthrough..."); + + // so we have a total of 1.5 minutes to start the upload + unsigned long lastRead = millis() + 85000U; + while (true) { + // read from port 1, send to port 0: + if (SERIAL_PASSTHROUGH.available()) { + int inByte = SERIAL_PASSTHROUGH.read(); + delayMicroseconds(5); + SERIAL_A.write(inByte); + delayMicroseconds(5); + } + + // read from port 0, send to port 1: + if (SERIAL_A.available()) { + int inByte = SERIAL_A.read(); + delayMicroseconds(5); + SERIAL_PASSTHROUGH.write(inByte); + delayMicroseconds(5); + if ((long)(millis() - lastRead > 0)) lastRead = millis(); + } + //tasks.yield(); + + // wait 30 seconds w/no traffic before resuming normal operation + if (timeout && (millis() - lastRead > 30000U)) break; + } + VLF("MSG: AddonFlasher, serial passthrough deactivated"); + + // back to run mode and normal serial comms + run(true); + } + + void AddonFlasher::run(bool setSerial) { + VLF("MSG: AddonFlasher, setting addon run mode"); + + // enter run mode + digitalWriteEx(ADDON_GPIO0_PIN, HIGH); + reset(); + + if (setSerial) { + #if defined(SERIAL_PASSTHROUGH_RX) && defined(SERIAL_PASSTHROUGH_TX) && !defined(SERIAL_PASSTHROUGH_RXTX_SET) + SERIAL_PASSTHROUGH.begin(SERIAL_PASSTHROUGH_BAUD_DEFAULT, SERIAL_8N1, SERIAL_PASSTHROUGH_RX, SERIAL_PASSTHROUGH_TX); + #else + SERIAL_PASSTHROUGH.begin(SERIAL_PASSTHROUGH_BAUD_DEFAULT); + #endif + + #if defined(SERIAL_A_RX) && defined(SERIAL_A_TX) && !defined(SERIAL_A_RXTX_SET) + SERIAL_A.begin(SERIAL_A_BAUD_DEFAULT, SERIAL_8N1, SERIAL_A_RX, SERIAL_A_TX); + #else + SERIAL_A.begin(SERIAL_A_BAUD_DEFAULT); + #endif + tasks.yield(1000); + } + } + + void AddonFlasher::flash() { + VLF("MSG: AddonFlasher, setting addon program mode"); + + #if defined(SERIAL_A_RX) && defined(SERIAL_A_TX) && !defined(SERIAL_A_RXTX_SET) + SERIAL_A.begin(115200, SERIAL_8N1, SERIAL_A_RX, SERIAL_A_TX); + #else + SERIAL_A.begin(115200); + #endif + + #if defined(SERIAL_PASSTHROUGH_RX) && defined(SERIAL_PASSTHROUGH_TX) && !defined(SERIAL_PASSTHROUGH_RXTX_SET) + SERIAL_PASSTHROUGH.begin(115200, SERIAL_8N1, SERIAL_PASSTHROUGH_RX, SERIAL_PASSTHROUGH_TX); + #else + SERIAL_PASSTHROUGH.begin(115200); + #endif + tasks.yield(1000); + + // enter program mode + digitalWriteEx(ADDON_GPIO0_PIN, LOW); + reset(); + } + + void AddonFlasher::reset() { + // reset LOW (active) HIGH (inactive) + tasks.yield(200); + digitalWriteEx(ADDON_RESET_PIN, LOW); + tasks.yield(200); + digitalWriteEx(ADDON_RESET_PIN, HIGH); + tasks.yield(200); + } + + void AddonFlasher::poll() { + #if ADDON_TRIGR_PIN == ON + if (ADDON_TRIGR_PIN != OFF && digitalRead(ADDON_TRIGR_PIN) == LOW) go(false); + #endif + } + + AddonFlasher addonFlasher; +#endif diff --git a/src/telescope/addonFlasher/AddonFlasher.h b/src/telescope/addonFlasher/AddonFlasher.h new file mode 100755 index 0000000..97c8f69 --- /dev/null +++ b/src/telescope/addonFlasher/AddonFlasher.h @@ -0,0 +1,29 @@ +// Flashes an esp8266 based SWS on the SERIAL_B interface by passing data to/from SERIAL_A +#pragma once +#include "../../Common.h" + +#if defined(SERIAL_PASSTHROUGH) + class AddonFlasher { + public: + // startup the addon flasher, monitors the ADDON_TRIGR_PIN if present + void init(); + + // flashes the addon + void go(bool timeout = true); + + // set the addon for run mode + void run(bool setSerial = false); + + // set the addon for flash mode + void flash(); + + // reset the addon + void reset(); + + // monitors for flash button press + void poll(); + private: + }; + + extern AddonFlasher addonFlasher; +#endif diff --git a/src/telescope/auxiliary/Features.h b/src/telescope/auxiliary/Features.h new file mode 100755 index 0000000..c652775 --- /dev/null +++ b/src/telescope/auxiliary/Features.h @@ -0,0 +1,21 @@ +//-------------------------------------------------------------------------------------------------- +// local and remote Auxiliary Features control switchboard +// ----------------------------------------------------------------------------------- +#pragma once + +#include "../../Common.h" + +#include "FeaturesBase.h" + +// ----------------------------------------------------------------------------- +// Include the chosen implementation +// - CLIENT: Features is a proxy class +// - otherwise (local present): Features is the local hardware class +// and REMOTE (server) support is compiled in as additional code paths. +// ----------------------------------------------------------------------------- +#if defined(FEATURES_CAN_CLIENT_PRESENT) + #include "remote/Features.h" // defines class Features (proxy) +#elif defined(FEATURES_PRESENT) + #include "local/Features.h" // defines class Features (local hardware) + // conditionally includes/declares server hooks when FEATURES_CAN_SERVER_PRESENT is defined +#endif diff --git a/src/telescope/auxiliary/FeaturesBase.h b/src/telescope/auxiliary/FeaturesBase.h new file mode 100755 index 0000000..26df391 --- /dev/null +++ b/src/telescope/auxiliary/FeaturesBase.h @@ -0,0 +1,108 @@ +// ----------------------------------------------------------------------------- +// CAN Auxiliary Features switchboard +// ----------------------------------------------------------------------------- +#pragma once + +#include "../../Common.h" + +// ----------------------------------------------------------------------------- +// Where the base CAN ID's start for this CANbus transport +// ----------------------------------------------------------------------------- + +#ifndef CAN_FEATURES_REQ_ID + #define CAN_FEATURES_REQ_ID (0x0F + 0x00) +#endif + +#ifndef CAN_FEATURES_RSP_ID + #define CAN_FEATURES_RSP_ID (CAN_FEATURES_REQ_ID + 0x10) +#endif + +#ifndef CAN_FEATURES_HB_ID_BASE + #define CAN_FEATURES_HB_ID_BASE (CAN_FEATURES_REQ_ID + 0x20) +#endif + +// ----------------------------------------------------------------------------- +// CAN_FEATURES role selection +// OFF : no CAN auxiliary feature support +// ON : telescope forwards auxiliary feature commands over CAN (client/proxy) +// REMOTE : remote node answers auxiliary feature commands over CAN (server/local FEATURES) +// ----------------------------------------------------------------------------- + +#ifndef CAN_FEATURES + #define CAN_FEATURES OFF +#endif + +// ----------------------------------------------------------------------------- +// Validate CAN requirements +// ----------------------------------------------------------------------------- +#if (CAN_FEATURES != OFF) + #if !defined(CAN_PLUS) || (CAN_PLUS == OFF) + #error "Features: CAN_FEATURES requires CAN_PLUS to be enabled." + #endif +#endif + +// ----------------------------------------------------------------------------- +// Derive presence macros used by Telescope.cpp command router +// ----------------------------------------------------------------------------- +#if (CAN_FEATURES == ON) + // Local FEATURES_PRESENT must NOT exist in this build; commands are proxied. + #define FEATURES_CLIENT_PRESENT // remote auxiliary features may be present + #define FEATURES_CAN_CLIENT_PRESENT // client implementation using CAN +#elif (CAN_FEATURES == REMOTE) + // Must have a local Features implementation to serve anything. + #define FEATURES_CAN_SERVER_PRESENT // server implementation (compiled into local Features) +#endif + +// ----------------------------------------------------------------------------- +// Enforce “only one auxiliary-features provider” contract +// ----------------------------------------------------------------------------- + +// CLIENT build must NOT also have local FEATURES_PRESENT. +#if defined(FEATURES_PRESENT) && defined(FEATURES_CLIENT_PRESENT) + #error "Config: both local FEATURES_PRESENT and CAN_FEATURES ON are enabled. Choose one." +#endif + +// REMOTE build MUST have local FEATURES_PRESENT (otherwise it can't serve anything). +#if !defined(FEATURES_PRESENT) && defined(FEATURES_CAN_SERVER_PRESENT) + #error "Config: CAN_FEATURES REMOTE requires local FEATURES_PRESENT." +#endif + +// ----------------------------------------------------------------------------- +// CANbus command opcode set (5-bit). Per-ID namespace, so Features "owns" these. +// These ops map to the LX200-ish AF commands shown in Features.command.cpp. +// ----------------------------------------------------------------------------- + +// Suggested v1 set (keep lean; expand as needed): +#define FEAT_OP_GET_ACTIVE_Y0 0x01 // :GXY0# -> RX: bitmap of active features (8 bits) +#define FEAT_OP_SET_VALUE_Xn 0x02 // :SXXn,* -> RX: status only (single frame) +#define FEAT_OP_GET_INFO_Yn 0x1E // :GXYn# -> RX: purpose + short name (2-frame) +#define FEAT_OP_GET_VALUE_Xn 0x1F // :GXXn# -> RX: per-purpose packed values (2-frame) + +// ----------------------------------------------------------------------------- +// Power telemetry packing (appended to :GXXn# replies when POWER_MONITOR_PRESENT) +// ----------------------------------------------------------------------------- +// Encoding matches the LX200 :GXXn# ASCII additions from Features::strCatPower(): +// ,,, +// where / are formatted as %1.1f or "NAN" and is 5 chars: +// P (present) or !, then C/v/V/T each replaced by ! on fault. +// +// On-wire, we use signed int16 fixed-point with 0.1 units (LE), and a flags bitfield. +// +// Voltage/current encoding: +// enc = round(value * 10) +// enc = FEAT_POWER_NAN_I16 (0x8000) means NAN +// +// Flags bitfield (fault bits are 1 when faulted): +// bit0: present (P) +// bit1: over-current fault (C -> !) +// bit2: under-voltage fault (v -> !) +// bit3: over-voltage fault (V -> !) +// bit4: over-temperature fault (T -> !) +#define FEAT_POWER_NAN_I16 0x8000 +#define FEAT_POWER_FLAGS_PRESENT 0x01 +#define FEAT_POWER_FAULT_OC 0x02 +#define FEAT_POWER_FAULT_UV 0x04 +#define FEAT_POWER_FAULT_OV 0x08 +#define FEAT_POWER_FAULT_OT 0x10 + +// (Reserve additional opcodes here for future AF expansions.) diff --git a/src/telescope/auxiliary/dewHeater/DewHeater.cpp b/src/telescope/auxiliary/dewHeater/DewHeater.cpp new file mode 100755 index 0000000..58e4d58 --- /dev/null +++ b/src/telescope/auxiliary/dewHeater/DewHeater.cpp @@ -0,0 +1,92 @@ +// ----------------------------------------------------------------------------------- +// Dew Heater control + +#include "DewHeater.h" + +#ifdef FEATURES_PRESENT + +#include "../../../lib/nv/Nv.h" + +void DewHeater::init(uint8_t index) { + if (index > 7) return; + this->index = index; + + char keyStr[26]; + snprintf(keyStr, sizeof(keyStr), "FEATURE%u_DEW_SETTINGS", index); + nvKey = nv().kv().computeKey(keyStr); + + // write the default settings to NV + if (!nv().kv().getOrInit(nvKey, settings)) { DF("WRN: Nv, init failed for "); VL(keyStr); } + settings.zero = constrain(settings.zero, -5, 20); + settings.span = constrain(settings.span, settings.zero, 20); + + if (settings.zero >= settings.span) { + if (settings.span > -5.0) settings.zero = settings.span - 0.1; else settings.span = settings.zero + 0.1; + DLF("ERR: dewHeater::init(), NV zero >= span (corrected)"); + } +} + +void DewHeater::poll(float deltaAboveDewPointC) { + if (isnan(deltaAboveDewPointC)) { heaterOn = false; return; } + + if (!enabled) return; + + int switchTimeMs = 0; + switchTimeMs = map(lroundf(deltaAboveDewPointC*10.0F), lroundf(settings.zero*10.0F), lroundf(settings.span*10.0F), DEW_HEATER_PULSE_WIDTH_MS, 0); + switchTimeMs = constrain(switchTimeMs, 0, DEW_HEATER_PULSE_WIDTH_MS); + #ifdef DEW_HEATER_MAX_POWER + switchTimeMs = lroundf(switchTimeMs*(DEW_HEATER_MAX_POWER/100.0)); + #endif + + currentTime = millis(); + if ((long)(currentTime - (lastHeaterCycle + DEW_HEATER_PULSE_WIDTH_MS)) > 0) { + lastHeaterCycle = currentTime; + } else + + if (!heaterOn && (long)(currentTime - (lastHeaterCycle + switchTimeMs)) <= 0) { + heaterOn = true; + } else + + if (heaterOn && (long)(currentTime - (lastHeaterCycle + switchTimeMs)) > 0) { + heaterOn = false; + } +} + +float DewHeater::getZero() { + return settings.zero; +} + +void DewHeater::setZero(float t) { + if (t >= -5.0 && t <= 20.0) { + settings.zero = t; + if (settings.zero >= settings.span) settings.zero = settings.span - 0.1; + nv().kv().put(nvKey, settings); + } +} + +float DewHeater::getSpan() { + return settings.span; +} + +void DewHeater::setSpan(float t) { + if (t >= -5.0 && t <= 20.0) { + settings.span = t; + if (settings.span <= settings.zero) settings.span = settings.zero + 0.1; + nv().kv().put(nvKey, settings); + } +} + +bool DewHeater::isEnabled() { + return enabled; +} + +void DewHeater::enable(bool state) { + heaterOn = false; + enabled = state; +} + +bool DewHeater::isOn() { + return heaterOn; +} + +#endif diff --git a/src/telescope/auxiliary/dewHeater/DewHeater.h b/src/telescope/auxiliary/dewHeater/DewHeater.h new file mode 100755 index 0000000..2dcfcf7 --- /dev/null +++ b/src/telescope/auxiliary/dewHeater/DewHeater.h @@ -0,0 +1,55 @@ +// ----------------------------------------------------------------------------------- +// Dew Heater control +#pragma once + +#include "../../../Common.h" + +#if FEATURE1_PURPOSE != OFF || FEATURE2_PURPOSE != OFF || FEATURE3_PURPOSE != OFF || FEATURE4_PURPOSE != OFF || FEATURE5_PURPOSE != OFF || FEATURE6_PURPOSE != OFF || FEATURE7_PURPOSE != OFF || FEATURE8_PURPOSE != OFF + #ifndef FEATURES_PRESENT + #define FEATURES_PRESENT + #endif +#endif + +#ifdef FEATURES_PRESENT + +#ifndef DEW_HEATER_PULSE_WIDTH_MS + #define DEW_HEATER_PULSE_WIDTH_MS 2000 +#endif + +typedef struct FeatureDewSettings { + float zero; + float span; +} FeatureDewSettings; + +class DewHeater { + public: + void init(uint8_t index); + + void poll(float deltaAboveDewPointC); + + float getZero(); + void setZero(float t); + + float getSpan(); + void setSpan(float t); + + bool isEnabled(); + void enable(bool state); + + bool isOn(); + + private: + unsigned long lastHeaterCycle = 0; + unsigned long currentTime = 0; + + bool heaterOn = false; + bool enabled = false; + + FeatureDewSettings settings = {-5.0F, 15.0F}; + + uint8_t index = 0; + + uint32_t nvKey; +}; + +#endif \ No newline at end of file diff --git a/src/telescope/auxiliary/intervalometer/Intervalometer.cpp b/src/telescope/auxiliary/intervalometer/Intervalometer.cpp new file mode 100755 index 0000000..be3f5e0 --- /dev/null +++ b/src/telescope/auxiliary/intervalometer/Intervalometer.cpp @@ -0,0 +1,107 @@ +// ----------------------------------------------------------------------------------- +// Intervalometer control + +#include "Intervalometer.h" + +#ifdef FEATURES_PRESENT + +#include "../../../lib/nv/Nv.h" + +void Intervalometer::init(uint8_t index) { + if (index > 7) return; + this->index = index; + + char keyStr[26]; + snprintf(keyStr, sizeof(keyStr), "FEATURE%u_INTV_SETTINGS", index); + nvKey = nv().kv().computeKey(keyStr); + + if (!nv().kv().getOrInit(nvKey, settings)) { DF("WRN: Nv, init failed for "); VL(keyStr); } + settings.expCount = constrain(settings.expCount, 0, 255); + settings.expDelay = constrain(settings.expDelay, 1, 3600); + settings.expTime = constrain(settings.expTime, 0, 3600); +} + +void Intervalometer::poll() { + if (!enabled) return; + + if (pressed == P_EXP_START) { + // count and stop when done + if (thisCount == 0) { pressed = P_STANDBY; enabled = false; return; } + thisCount--; + + // start a new exposure + pressed = P_EXP_DONE; + expDone = millis() + (unsigned long)(settings.expTime*1000.0); // set exposure time in ms + } else + + // wait until exposure is done + if (pressed == P_EXP_DONE && (long)(millis() - expDone) > 0) { + // finish an exposure + pressed = P_WAIT; + waitDone = millis() + (unsigned long)(settings.expDelay*1000.0); // set wait time in ms + } else + + // wait until pause between exposures is done + if (pressed == P_WAIT && (long)(millis() - waitDone) > 0) { + // start next count + pressed = P_EXP_START; + } +} + +float Intervalometer::getExposure() { + return settings.expTime; +} + +void Intervalometer::setExposure(float t) { + if (pressed == P_STANDBY && t >= 0 && t <= 3600) { + settings.expTime = t; + nv().kv().put(nvKey, settings); + } +} + +float Intervalometer::getDelay() { + return settings.expDelay; +} + +void Intervalometer::setDelay(float t) { + if (pressed == P_STANDBY && t >= 1 && t <= 3600) { + settings.expDelay = t; + nv().kv().put(nvKey, settings); + } +} + +float Intervalometer::getCurrentCount() { + return thisCount; +} + +float Intervalometer::getCount() { + return settings.expCount; +} + +void Intervalometer::setCount(float count) { + long c = lroundf(count); + if (pressed == P_STANDBY && c >= 0 && c <= 255) { + settings.expCount = c; + } +} + +bool Intervalometer::isEnabled() { + return enabled; +} + +void Intervalometer::enable(bool state) { + enabled = state; + if (enabled) { + thisCount = settings.expCount; + pressed = P_EXP_START; + } else { + thisCount = 0; + pressed = P_STANDBY; + } +} + +bool Intervalometer::isOn() { + return pressed == P_EXP_DONE; +} + +#endif diff --git a/src/telescope/auxiliary/intervalometer/Intervalometer.h b/src/telescope/auxiliary/intervalometer/Intervalometer.h new file mode 100755 index 0000000..6f42841 --- /dev/null +++ b/src/telescope/auxiliary/intervalometer/Intervalometer.h @@ -0,0 +1,58 @@ +// ----------------------------------------------------------------------------------- +// Intervalometer control +#pragma once + +#include "../../../Common.h" + +#if FEATURE1_PURPOSE != OFF || FEATURE2_PURPOSE != OFF || FEATURE3_PURPOSE != OFF || FEATURE4_PURPOSE != OFF || FEATURE5_PURPOSE != OFF || FEATURE6_PURPOSE != OFF || FEATURE7_PURPOSE != OFF || FEATURE8_PURPOSE != OFF + #ifndef FEATURES_PRESENT + #define FEATURES_PRESENT + #endif +#endif + +#ifdef FEATURES_PRESENT + +typedef struct FeatureIntervalometerSettings { + float expTime; + float expDelay; + uint8_t expCount; +} FeatureIntervalometerSettings; + +class Intervalometer { + public: + void init(uint8_t index); + + void poll(); + + float getExposure(); + void setExposure(float t); + + float getDelay(); + void setDelay(float t); + + float getCurrentCount(); + float getCount(); + void setCount(float c); + + bool isEnabled(); + void enable(bool state); + + bool isOn(); + + private: + enum Pressed { P_STANDBY, P_EXP_START, P_EXP_START_PHASE2, P_EXP_DONE, P_EXP_DONE_PHASE2, P_WAIT }; + + Pressed pressed = P_STANDBY; + bool enabled = false; + + FeatureIntervalometerSettings settings = {0.0F, 0.0F, 0}; + uint8_t thisCount = 0; + + unsigned long expDone = 0; + unsigned long waitDone = 0; + + uint8_t index = 0; + + int16_t nvKey; +}; +#endif diff --git a/src/telescope/auxiliary/local/Features.can.command.cpp b/src/telescope/auxiliary/local/Features.can.command.cpp new file mode 100755 index 0000000..027476f --- /dev/null +++ b/src/telescope/auxiliary/local/Features.can.command.cpp @@ -0,0 +1,256 @@ +//-------------------------------------------------------------------------------------------------- +// local auxiliary features control, using the CANbus interface (CAN server) + +#include "Features.h" + +#if defined(FEATURES_CAN_SERVER_PRESENT) + +#include "../FeaturesBase.h" +#include "../../../lib/convert/Convert.h" +#include "../../../libApp/weather/Weather.h" +#include "../../../telescope/Telescope.h" + +// Dew heater: -5.0..+20.0C encoded as 0..250 in 0.1C steps (one byte). +static inline uint8_t packDew01C(float v) { + if (v < -5.0f) v = -5.0f; + if (v > 20.0f) v = 20.0f; + long enc = lroundf((v + 5.0f) * 10.0f); + if (enc < 0) enc = 0; + if (enc > 250) enc = 250; + return (uint8_t)enc; +} + +static inline float unpackDew01C(uint8_t enc) { + return ((float)enc / 10.0f) - 5.0f; +} + +void Features::processCommand() { + + bool handled = true; + bool numericReply = true; + bool suppressFrame = false; + CommandError commandError = CE_NONE; + + switch (opCode()) { + + // ------------------------------------------------------------ + // :GXY0# -> bitmap of active features (8 bits) + // Payload: [u8 bitmap] + // ------------------------------------------------------------ + case FEAT_OP_GET_ACTIVE_Y0: { + uint8_t bitmap = 0; + for (uint8_t i = 0; i < 8; i++) { + if (device[i].purpose != OFF) bitmap |= (uint8_t)(1U << i); + } + writeU8(bitmap); + numericReply = false; + } break; + + // ------------------------------------------------------------ + // :GXYn# (wire: idx 0..7) -> purpose + short name + // Payload: [u8 purpose][name bytes... up to 10] + // (No terminator; client adds it.) + // ------------------------------------------------------------ + case FEAT_OP_GET_INFO_Yn: { + uint8_t idx = 0; + if (!readU8(idx)) { commandError = CE_PARAM_FORM; break; } + if (idx > 7) { commandError = CE_PARAM_RANGE; break; } + + const int pRaw = device[idx].purpose; + if (pRaw == OFF) { commandError = CE_0; break; } + + // Match Features.command.cpp: report MOMENTARY/COVER as SWITCH in purpose field. + int p = pRaw; + if (p == MOMENTARY_SWITCH || p == COVER_SWITCH) p = SWITCH; + + writeU8((uint8_t)p); + + char name10[10]; + memset(name10, 0, sizeof(name10)); + sstrcpy(name10, device[idx].name); + + const uint8_t n = (uint8_t)strnlen(name10, 10); + if (n > 0) writeBytes((const uint8_t*)name10, n); + + // payload <= 11 bytes -> fits dual (12 max) + numericReply = false; + } break; + + // ------------------------------------------------------------ + // :GXXn# (wire: idx 0..7) -> per-purpose packed values + // Payload always begins with [u8 purpose] + // Then purpose-specific bytes: + // SWITCH/ANALOG: [u8 value] + // DEW_HEATER: [u8 en][u8 zEnc][u8 sEnc][u8 dEnc(0.5C int8 as u8)] + // INTERVALOMETER: [u8 cur][u8 expB][u8 delB][u8 count] + // Optional (when POWER_MONITOR_PRESENT): append 5 bytes: + // [i16 volts_q0.1][i16 amps_q0.1][u8 flags] + // Total stays <= 12. + // ------------------------------------------------------------ + case FEAT_OP_GET_VALUE_Xn: { + uint8_t idx = 0; + if (!readU8(idx)) { commandError = CE_PARAM_FORM; break; } + if (idx > 7) { commandError = CE_PARAM_RANGE; break; } + + const int p = device[idx].purpose; + if (p == OFF) { commandError = CE_CMD_UNKNOWN; break; } + + writeU8((uint8_t)p); + + if (p == SWITCH || p == MOMENTARY_SWITCH || p == COVER_SWITCH) { + writeU8((uint8_t)device[idx].value); + } else + + if (p == ANALOG_OUTPUT) { + writeU8((uint8_t)device[idx].value); + } else + + if (p == DEW_HEATER) { + const uint8_t en = (uint8_t)(device[idx].dewHeater->isEnabled() ? 1 : 0); + const uint8_t zEnc = packDew01C(device[idx].dewHeater->getZero()); + const uint8_t sEnc = packDew01C(device[idx].dewHeater->getSpan()); + const float delta = (float)(temperature.getChannel((int)idx + 1) - weather.getDewPoint()); + + writeU8(en); + writeU8(zEnc); + writeU8(sEnc); + writeFixedI16(delta, 10); + } else + + if (p == INTERVALOMETER) { + const uint8_t cur = (uint8_t)device[idx].intervalometer->getCurrentCount(); + const uint8_t expB = (uint8_t)convert.packSeconds(device[idx].intervalometer->getExposure()); + const uint8_t delB = (uint8_t)convert.packSeconds(device[idx].intervalometer->getDelay()); + const uint8_t count = (uint8_t)device[idx].intervalometer->getCount(); + + writeU8(cur); + writeU8(expB); + writeU8(delB); + writeU8(count); + } else { + // Unknown purpose: return stored value byte + writeU8((uint8_t)device[idx].value); + } + + // Power telemetry: always append when compiled in so client sees remaining()==5. + #ifdef POWER_MONITOR_PRESENT + uint8_t flags = 0; + + const bool present = powerMonitor.hasChannel((int)idx); + if (present) flags |= FEAT_POWER_FLAGS_PRESENT; + + if (powerMonitor.errOverCurrent((int)idx)) flags |= FEAT_POWER_FAULT_OC; + if (powerMonitor.errUnderVoltage((int)idx)) flags |= FEAT_POWER_FAULT_UV; + if (powerMonitor.errOverVoltage((int)idx)) flags |= FEAT_POWER_FAULT_OV; + if (powerMonitor.errOverTemperature((int)idx)) flags |= FEAT_POWER_FAULT_OT; + + float volts = NAN; + float amps = NAN; + if (powerMonitor.hasVoltage((int)idx)) volts = powerMonitor.getVoltage((int)idx); + if (powerMonitor.hasCurrent((int)idx)) amps = powerMonitor.getCurrent((int)idx); + + // Exactly 5 bytes appended + writeFixedI16(volts, 10); + writeFixedI16(amps, 10); + writeU8(flags); + #endif + + numericReply = false; + } break; + + // ------------------------------------------------------------ + // :SXXn,... (wire: [idx1 1..8][sub][u8 payload]) + // Response is numeric-only (numericReply=true). Success = CE_NONE. + // ------------------------------------------------------------ + case FEAT_OP_SET_VALUE_Xn: { + uint8_t idx1 = 0; + uint8_t sub = 0; + if (!readU8(idx1) || !readU8(sub)) { commandError = CE_PARAM_FORM; break; } + if (idx1 < 1 || idx1 > 8) { commandError = CE_PARAM_RANGE; break; } + + const uint8_t idx = (uint8_t)(idx1 - 1); + const int p = device[idx].purpose; + if (p == OFF) { commandError = CE_CMD_UNKNOWN; break; } + + if (sub == (uint8_t)'V') { + uint8_t v = 0; + if (!readU8(v)) { commandError = CE_PARAM_FORM; break; } + device[idx].value = (long)v; + + if (p == SWITCH || p == MOMENTARY_SWITCH || p == COVER_SWITCH) { + if (v > 1) { commandError = CE_PARAM_RANGE; break; } + + #ifdef COVER_SWITCH_SERVO_PRESENT + if (p == COVER_SWITCH) { + if (v == 0) cover[idx].target = COVER_SWITCH_SERVO_OPEN_DEG; + else cover[idx].target = COVER_SWITCH_SERVO_CLOSED_DEG; + } else + #endif + { + digitalWriteEx(device[idx].pin, (v != 0) == device[idx].active); + if (p == MOMENTARY_SWITCH && device[idx].value) momentarySwitchTime[idx] = 50; + } + } else + + if (p == ANALOG_OUTPUT) { + analogWriteEx(device[idx].pin, analog8BitToAnalogRange(v)); + } else + + if (p == DEW_HEATER) { + if (v > 1) { commandError = CE_PARAM_RANGE; break; } + device[idx].dewHeater->enable(v != 0); + } else + + if (p == INTERVALOMETER) { + if (v > 1) { commandError = CE_PARAM_RANGE; break; } + device[idx].intervalometer->enable(v != 0); + } + + } else + + if (sub == (uint8_t)'Z' || sub == (uint8_t)'S') { + uint8_t enc = 0; + if (!readU8(enc)) { commandError = CE_PARAM_FORM; break; } + if (p != DEW_HEATER) { commandError = CE_CMD_UNKNOWN; break; } + + const float f = unpackDew01C(enc); + if (sub == (uint8_t)'Z') device[idx].dewHeater->setZero(f); + else device[idx].dewHeater->setSpan(f); + + } else + + if (sub == (uint8_t)'E' || sub == (uint8_t)'D') { + uint8_t tb = 0; + if (!readU8(tb)) { commandError = CE_PARAM_FORM; break; } + if (p != INTERVALOMETER) { commandError = CE_CMD_UNKNOWN; break; } + + const float sec = convert.unpackSeconds(tb); + if (sub == (uint8_t)'E') device[idx].intervalometer->setExposure(sec); + else device[idx].intervalometer->setDelay(sec); + + } else + + if (sub == (uint8_t)'C') { + uint8_t c = 0; + if (!readU8(c)) { commandError = CE_PARAM_FORM; break; } + if (p != INTERVALOMETER) { commandError = CE_CMD_UNKNOWN; break; } + + device[idx].intervalometer->setCount((float)c); + + } else { + commandError = CE_PARAM_FORM; + } + + // numericReply stays true + } break; + + default: + handled = false; + commandError = CE_CMD_UNKNOWN; + break; + } + + sendResponse(handled, suppressFrame, numericReply, commandError); +} + +#endif diff --git a/src/telescope/auxiliary/local/Features.command.cpp b/src/telescope/auxiliary/local/Features.command.cpp new file mode 100755 index 0000000..e6bdde4 --- /dev/null +++ b/src/telescope/auxiliary/local/Features.command.cpp @@ -0,0 +1,218 @@ +// ----------------------------------------------------------------------------------- +// Auxiliary Features + +#include "Features.h" + +#ifdef FEATURES_PRESENT + +#include "../../../lib/convert/Convert.h" +#include "../../../libApp/weather/Weather.h" +#include "../../../telescope/Telescope.h" + +void Features::strCatPower(char *reply, int index) { + #ifdef POWER_MONITOR_PRESENT + if (index < 0 || index > 7) return; + + char s[40]; + if (powerMonitor.hasVoltage(index)) sprintF(s, ";%1.1f", powerMonitor.getVoltage(index)); else strcpy(s, ";NAN"); + strcat(reply, s); + if (powerMonitor.hasCurrent(index)) sprintF(s, ",%1.1f", powerMonitor.getCurrent(index)); else strcpy(s, ",NAN"); + strcat(reply, s); + if (!powerMonitor.hasChannel(index)) strcat(reply, ",P"); else strcat(reply, ",!"); + if (powerMonitor.errOverCurrent(index)) strcat(reply, "C"); else strcat(reply, "!"); + if (powerMonitor.errUnderVoltage(index)) strcat(reply, "U"); else strcat(reply, "!"); + if (powerMonitor.errOverVoltage(index)) strcat(reply, "V"); else strcat(reply, "!"); + if (powerMonitor.errOverTemperature(index)) strcat(reply, "T"); else strcat(reply, "!"); + #else + UNUSED(reply); + UNUSED(index); + #endif +} + +// by default reply[80] == "", suppressFrame == false, numericReply == true, and commandError == CE_NONE +// return true if the command has been completely handled and no further command() will be called, or false if not +// for commands that are handled repeatedly commandError might contain CE_NONE or CE_1 to indicate success +// numericReply=true means boolean/numeric-style responses (e.g., CE_1/CE_0/errors) rather than a payload +bool Features::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + if (!ready) return false; + + // get auXiliary feature + if (command[0] == 'G' && command[1] == 'X' && parameter[2] == 0) { + // :GXX[n]# + if (parameter[0] == 'X') { + int i = parameter[1] - '1'; + if (i < 0 || i > 7) { *commandError = CE_PARAM_FORM; return true; } + + char s[255]; + if (device[i].purpose == SWITCH || device[i].purpose == MOMENTARY_SWITCH || device[i].purpose == COVER_SWITCH) { + snprintf(s, sizeof(s), "%d", device[i].value); + strcat(reply, s); + strCatPower(reply, i); + } else + + if (device[i].purpose == ANALOG_OUTPUT) { + snprintf(s, sizeof(s), "%d", device[i].value); + strcat(reply, s); + strCatPower(reply, i); + } else + + if (device[i].purpose == DEW_HEATER) { + snprintf(s, sizeof(s), "%d", (int)device[i].dewHeater->isEnabled()); + strcat(reply, s); + strcat(reply, ","); + + sprintF(s, "%3.1f", device[i].dewHeater->getZero()); + strcat(reply, s); + strcat(reply, ","); + + sprintF(s, "%3.1f", device[i].dewHeater->getSpan()); + strcat(reply, s); + strcat(reply, ","); + + float deltaT = temperature.getChannel(i + 1) - weather.getDewPoint(); + if (isnan(deltaT)) strcpy(s,"NAN"); else sprintF(s, "%3.1f", deltaT); + strcat(reply, s); + + strCatPower(reply, i); + } else + + if (device[i].purpose == INTERVALOMETER) { + snprintf(s, sizeof(s), "%d", (int)device[i].intervalometer->getCurrentCount()); + strcat(reply, s); + strcat(reply, ","); + + float v; + int d; + v = device[i].intervalometer->getExposure(); + if (v < 1.0) d = 3; else if (v < 10.0) d = 2; else if (v < 30.0) d = 1; else d = 0; + dtostrf(v, 0, d, s); + strcat(reply, s); + strcat(reply, ","); + + v = device[i].intervalometer->getDelay(); + if (v < 10.0) d = 2; else if (v < 30.0) d = 1; else d = 0; + dtostrf(v, 0, d, s); + strcat(reply, s); + strcat(reply, ","); + + snprintf(s, sizeof(s), "%d", (int)device[i].intervalometer->getCount()); + strcat(reply, s); + } else { *commandError = CE_CMD_UNKNOWN; return true; } + + *numericReply = false; + } else + + // :GXY[n]# + // where [n] = 1..8 to get auXiliary feature name and purpose + // :GXY0# + // return active auXiliary features + if (parameter[0] == 'Y') { + int i = parameter[1] - '1'; + + if (i == -1) { + for (int j = 0; j < 8; j++) { + if (device[j].purpose == OFF) reply[j] = '0'; else reply[j] = '1'; + reply[j + 1] = 0; + } + *numericReply = false; + return true; + } + + if (i < 0 || i > 7) { *commandError = CE_PARAM_FORM; return true; } + if (device[i].purpose == OFF) { *commandError = CE_0; return true; } + + char s[255]; + sstrcpy(s, device[i].name); + if (strlen(s) > 10) s[10] = 0; + strcpy(reply, s); + strcat(reply, ","); + + int p = device[i].purpose; + if (p == MOMENTARY_SWITCH || p == COVER_SWITCH) p = SWITCH; + snprintf(s, sizeof(s), "%d", p); + strcat(reply, s); + + *numericReply = false; + } else return false; + + } else + + // set auXiliary feature + if (command[0] == 'S' && command[1] == 'X' && parameter[2] == ',') { + // :SXX[n],V[Z][S][v]# + // for example :SXX1,V1# :SXX1,Z0.5# + if (parameter[0] == 'X') { + int i = parameter[1] - '1'; + if (i < 0 || i > 7) { *commandError = CE_PARAM_FORM; return true; } + if (device[i].purpose == OFF) { *commandError = CE_CMD_UNKNOWN; return true; } + + char* conv_end; + float f = strtof(¶meter[4], &conv_end); + if (¶meter[4] == conv_end) { *commandError = CE_PARAM_FORM; return true; } + long v = lroundf(f); + + if (parameter[3] == 'V' && v >= 0 && v <= 255) device[i].value = v; + + if (device[i].purpose == SWITCH || device[i].purpose == MOMENTARY_SWITCH || device[i].purpose == COVER_SWITCH) { + if (parameter[3] == 'V') { + if (v >= 0 && v <= 1) { // value 0..1 for enabled or not + #ifdef COVER_SWITCH_SERVO_PRESENT + if (device[i].purpose == COVER_SWITCH) { + if (v == 0) cover[i].target = COVER_SWITCH_SERVO_OPEN_DEG; else + if (v == 1) cover[i].target = COVER_SWITCH_SERVO_CLOSED_DEG; + } else + #endif + + digitalWriteEx(device[i].pin, v == device[i].active); + if (device[i].purpose == MOMENTARY_SWITCH && device[i].value) momentarySwitchTime[i] = 50; + + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + if (device[i].purpose == ANALOG_OUTPUT) { + if (parameter[3] == 'V') { // value 0..255 for 0..100% power + if (v >= 0 && v <= 255) { + analogWriteEx(device[i].pin, analog8BitToAnalogRange(v)); + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + if (device[i].purpose == DEW_HEATER) { + if (parameter[3] == 'V') { // value 0..1 for enabled or not + if (v >= 0 && v <= 1) device[i].dewHeater->enable(v); else *commandError = CE_PARAM_RANGE; + } else + + if (parameter[3] == 'Z') { // zero + if (f >= -5.0F && f <= 20.0F) device[i].dewHeater->setZero(f); else *commandError = CE_PARAM_RANGE; + } else + + if (parameter[3] == 'S') { // span + if (f >= -5.0F && f <= 20.0F) device[i].dewHeater->setSpan(f); else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + if (device[i].purpose == INTERVALOMETER) { + if (parameter[3] == 'V') { // value 0..1 for enabled or not + if (v >= 0 && v <= 1) device[i].intervalometer->enable(v); else *commandError = CE_PARAM_RANGE; + } else + + if (parameter[3] == 'E') { // exposure length + if (f >= 0.0F && f <= 3600.0F) device[i].intervalometer->setExposure(f); else *commandError = CE_PARAM_RANGE; + } else + + if (parameter[3] == 'D') { // delay + if (f >= 1.0F && f <= 3600.0F) device[i].intervalometer->setDelay(f); else *commandError = CE_PARAM_RANGE; + } else + + if (parameter[3] == 'C') { // count + if (f >= 0.0F && f <= 255.0F) device[i].intervalometer->setCount(f); else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } + } else return false; + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/auxiliary/local/Features.cpp b/src/telescope/auxiliary/local/Features.cpp new file mode 100755 index 0000000..e9aef60 --- /dev/null +++ b/src/telescope/auxiliary/local/Features.cpp @@ -0,0 +1,166 @@ +// ----------------------------------------------------------------------------------- +// Auxiliary Features + +#include "Features.h" + +#ifdef FEATURES_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../../../libApp/weather/Weather.h" +#include "../../../telescope/Telescope.h" + +void featuresPollWrapper() { features.poll(); } + +#if defined(FEATURES_CAN_SERVER_PRESENT) +// 1 Hz heartbeat TX for this AF node +static void auxHeartbeatWrapper() { + if (!canPlus.ready) return; + const uint16_t hbId = (uint16_t)(CAN_FEATURES_HB_ID_BASE); + const uint8_t b = 0; // payload reserved; currently unused + canPlus.writePacket((int)hbId, &b, 1); +} +#endif + +bool Features::init() { + + #if defined(FEATURES_CAN_SERVER_PRESENT) + if (!CanTransportServer::init(true, 2)) return false; + #endif + + #ifdef POWER_MONITOR_PRESENT + if (!powerMonitor.init()) return false; + #endif + + for (uint8_t i = 0; i < 8; i++) { + if (device[i].pin == AUX) device[i].pin = auxPins[i]; + + if (device[i].value == ON) device[i].value = 1; else + if (device[i].value < 0 || device[i].value > 255) device[i].value = 0; + + if (device[i].memory == ON) { + if (device[i].purpose == SWITCH || + device[i].purpose == ANALOG_OUTPUT || + device[i].purpose == DEW_HEATER) { + + char keyStr[26]; + snprintf(keyStr, sizeof(keyStr), "FEATURE%u_VALUE", i); + nvKey[i] = nv().kv().computeKey(keyStr); + + if (!nv().kv().getOrInit(nvKey[i], device[i].value)) { DF("WRN: Nv, init failed for "); VL(keyStr); } + } + } + + if (device[i].purpose == SWITCH || device[i].purpose == MOMENTARY_SWITCH || device[i].purpose == HIDDEN_SWITCH) { + pinModeEx(device[i].pin, OUTPUT); + digitalWriteEx(device[i].pin, device[i].value == device[i].active); + if (device[i].purpose == MOMENTARY_SWITCH && device[i].value) momentarySwitchTime[i] = 50; + if (device[i].purpose == HIDDEN_SWITCH) device[i].purpose = OFF; + } else + + #ifdef COVER_SWITCH_SERVO_PRESENT + if (device[i].purpose == COVER_SWITCH) { + cover[i].servo = new Servo; + #ifdef ESP32 + cover[i].servo->setPeriodHertz(COVER_SWITCH_SERVO_PERIOD_HZ); + #endif + cover[i].servo->attach(device[i].pin, COVER_SWITCH_SERVO_MIN, COVER_SWITCH_SERVO_MAX); + cover[i].servo->write(COVER_SWITCH_SERVO_CLOSED_DEG); + cover[i].position = COVER_SWITCH_SERVO_CLOSED_DEG; + } else + #endif + + if (device[i].purpose == ANALOG_OUTPUT) { + pinModeEx(device[i].pin, OUTPUT); + analogWriteEx(device[i].pin, analog8BitToAnalogRange(device[i].value)); + } else + + if (device[i].purpose == DEW_HEATER) { + device[i].dewHeater = new DewHeater; + device[i].dewHeater->init(i); + pinModeEx(device[i].pin, OUTPUT); + device[i].dewHeater->enable(device[i].value); + } else + + if (device[i].purpose == INTERVALOMETER) { + device[i].intervalometer = new Intervalometer; + device[i].intervalometer->init(i); + pinModeEx(device[i].pin, OUTPUT); + digitalWriteEx(device[i].pin, device[i].value == device[i].active); + } + } + + VF("MSG: Auxiliary, start feature monitor task (rate 20ms priority 6)... "); + if (tasks.add(20, 0, true, 6, featuresPollWrapper, "AuxPoll")) { VLF("success"); } else { VLF("FAILED!"); return false; } + + ready = true; + + return true; +} + +void Features::begin() { + if (!ready) return; + + // start heartbeat task + #if defined(FEATURES_CAN_SERVER_PRESENT) + VF("MSG: Auxiliary, starting CAN heartbeat task (rate 1s priority 6)... "); + if (tasks.add(1000, 0, true, 6, auxHeartbeatWrapper, "AuxHB")) { VLF("success"); } else { VLF("FAILED!"); } + #endif +} + +void Features::poll() { + for (int i = 0; i < 8; i++) { + if (device[i].memory == ON) { + if (device[i].value != lastValue[i]) { + if (device[i].purpose == SWITCH || + device[i].purpose == ANALOG_OUTPUT || + device[i].purpose == DEW_HEATER) { + nv().kv().put(nvKey[i], device[i].value); + } + lastValue[i] = device[i].value; + } + } + + if (device[i].purpose == MOMENTARY_SWITCH) { + if (momentarySwitchTime[i] > 0) { + momentarySwitchTime[i]--; + if (momentarySwitchTime[i] == 0) { + device[i].value = 0; + digitalWriteEx(device[i].pin, device[i].value == device[i].active); + } + } + } else + + if (device[i].purpose == DEW_HEATER) { + device[i].dewHeater->poll(temperature.getChannel(i + 1) - weather.getDewPoint()); + digitalWriteEx(device[i].pin, device[i].dewHeater->isOn() == device[i].active); +// if (gpio.failure(i)) device[i].dewHeater->enable(false); + } else + + if (device[i].purpose == INTERVALOMETER) { + device[i].intervalometer->poll(); + digitalWriteEx(device[i].pin, device[i].intervalometer->isOn() == device[i].active); +// if (gpio.failure(i)) device[i].intervalometer->enable(false); + } + } + + #ifdef COVER_SWITCH_SERVO_PRESENT + // default moves at 25 degrees/second + static int toggle = 0; + if (toggle++ % (100/COVER_SWITCH_SERVO_SPEED_PERCENT) == 0) { + for (int i = 0; i < 8; i++) { + if (device[i].purpose == COVER_SWITCH) { + if (cover[i].position > cover[i].target) cover[i].position--; else + if (cover[i].position < cover[i].target) cover[i].position++; + cover[i].servo->write(cover[i].position); + } + } + } + #endif + +} + +Features features; + +#endif diff --git a/src/telescope/auxiliary/local/Features.h b/src/telescope/auxiliary/local/Features.h new file mode 100755 index 0000000..307ae04 --- /dev/null +++ b/src/telescope/auxiliary/local/Features.h @@ -0,0 +1,118 @@ +// ----------------------------------------------------------------------------------- +// Auxiliary Features +#pragma once + +#include "../../../Common.h" + +#include "../FeaturesBase.h" + +#ifdef FEATURES_PRESENT + +#include "../../../lib/gpioEx/GpioEx.h" + +#include "../../../libApp/commands/ProcessCmds.h" +#include "../../../libApp/temperature/Temperature.h" +#include "../dewHeater/DewHeater.h" +#include "../intervalometer/Intervalometer.h" +#include "../powerMonitor/PowerMonitor.h" + +#ifdef COVER_SWITCH_SERVO_PRESENT + #ifdef ESP32 + #include // https://www.arduino.cc/reference/en/libraries/esp32servo/ + #else + #include + #endif + #ifndef COVER_SWITCH_SERVO_PERIOD_HZ + #define COVER_SWITCH_SERVO_PERIOD_HZ 50 + #endif + #ifndef COVER_SWITCH_SERVO_SPEED_PERCENT + #define COVER_SWITCH_SERVO_SPEED_PERCENT 50 + #endif + #ifndef COVER_SWITCH_SERVO_MIN + #define COVER_SWITCH_SERVO_MIN 1000 + #endif + #ifndef COVER_SWITCH_SERVO_MAX + #define COVER_SWITCH_SERVO_MAX 2000 + #endif + #ifndef COVER_SWITCH_SERVO_CLOSED_DEG + #define COVER_SWITCH_SERVO_CLOSED_DEG 0 + #endif + #ifndef COVER_SWITCH_SERVO_OPEN_DEG + #define COVER_SWITCH_SERVO_OPEN_DEG 100 + #endif + + typedef struct DeviceCoverServo { + int target; + int position; + Servo *servo; + } DeviceCoverServo; + +#endif + +typedef struct Device { + const char* name; + int16_t purpose; + const int64_t temp; + int16_t pin; + int16_t value; + const int16_t active; + const int8_t memory; + DewHeater *dewHeater; + Intervalometer *intervalometer; +} Device; + +#ifdef FEATURES_CAN_SERVER_PRESENT +#include "../../../lib/canTransport/CanTransportServer.h" +class Features : public CanTransportServer { +private: + void processCommand() override; +public: + Features() : CanTransportServer((uint16_t)(CAN_FEATURES_REQ_ID), (uint16_t)(CAN_FEATURES_RSP_ID), 0x1E) {} +#else +class Features { +public: +#endif + + // initialize the aux features + bool init(); + void begin(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + void poll(); + + inline void deviceOff(int index) { device[index].value = 0; digitalWriteEx(device[index].pin, LOW); } + + private: + void strCatPower(char *reply, int index); + + bool ready = false; + + int16_t auxPins[8] = { AUX1_PIN, AUX2_PIN, AUX3_PIN, AUX4_PIN, AUX5_PIN, AUX6_PIN, AUX7_PIN, AUX8_PIN }; + Device device[8] = { + { FEATURE1_NAME, FEATURE1_PURPOSE, FEATURE1_TEMP, FEATURE1_PIN, FEATURE1_VALUE_DEFAULT, FEATURE1_ON_STATE, FEATURE1_VALUE_MEMORY, NULL, NULL }, + { FEATURE2_NAME, FEATURE2_PURPOSE, FEATURE2_TEMP, FEATURE2_PIN, FEATURE2_VALUE_DEFAULT, FEATURE2_ON_STATE, FEATURE2_VALUE_MEMORY, NULL, NULL }, + { FEATURE3_NAME, FEATURE3_PURPOSE, FEATURE3_TEMP, FEATURE3_PIN, FEATURE3_VALUE_DEFAULT, FEATURE3_ON_STATE, FEATURE3_VALUE_MEMORY, NULL, NULL }, + { FEATURE4_NAME, FEATURE4_PURPOSE, FEATURE4_TEMP, FEATURE4_PIN, FEATURE4_VALUE_DEFAULT, FEATURE4_ON_STATE, FEATURE4_VALUE_MEMORY, NULL, NULL }, + { FEATURE5_NAME, FEATURE5_PURPOSE, FEATURE5_TEMP, FEATURE5_PIN, FEATURE5_VALUE_DEFAULT, FEATURE5_ON_STATE, FEATURE5_VALUE_MEMORY, NULL, NULL }, + { FEATURE6_NAME, FEATURE6_PURPOSE, FEATURE6_TEMP, FEATURE6_PIN, FEATURE6_VALUE_DEFAULT, FEATURE6_ON_STATE, FEATURE6_VALUE_MEMORY, NULL, NULL }, + { FEATURE7_NAME, FEATURE7_PURPOSE, FEATURE7_TEMP, FEATURE7_PIN, FEATURE7_VALUE_DEFAULT, FEATURE7_ON_STATE, FEATURE7_VALUE_MEMORY, NULL, NULL }, + { FEATURE8_NAME, FEATURE8_PURPOSE, FEATURE8_TEMP, FEATURE8_PIN, FEATURE8_VALUE_DEFAULT, FEATURE8_ON_STATE, FEATURE8_VALUE_MEMORY, NULL, NULL } + }; + #ifdef COVER_SWITCH_SERVO_PRESENT + DeviceCoverServo cover[8] = { + { 0, 0, NULL }, { 0, 0, NULL }, { 0, 0, NULL }, { 0, 0, NULL }, { 0, 0, NULL }, { 0, 0, NULL }, { 0, 0, NULL }, { 0, 0, NULL } + }; + #endif + uint8_t momentarySwitchTime[8] = { 0, 0, 0, 0, 0, 0, 0, 0 }; + int16_t lastValue[8] = { + FEATURE1_VALUE_DEFAULT, FEATURE2_VALUE_DEFAULT, FEATURE3_VALUE_DEFAULT, FEATURE4_VALUE_DEFAULT, + FEATURE5_VALUE_DEFAULT, FEATURE6_VALUE_DEFAULT, FEATURE7_VALUE_DEFAULT, FEATURE8_VALUE_DEFAULT + }; + + uint16_t nvKey[8]; +}; + +extern Features features; + +#endif diff --git a/src/telescope/auxiliary/powerMonitor/PowerMonitor.cpp b/src/telescope/auxiliary/powerMonitor/PowerMonitor.cpp new file mode 100755 index 0000000..0fbf5e9 --- /dev/null +++ b/src/telescope/auxiliary/powerMonitor/PowerMonitor.cpp @@ -0,0 +1,179 @@ +//-------------------------------------------------------------------------------------------------- +// Power monitor + safety (auxiliary/AF) + +#include "PowerMonitor.h" + +#ifdef POWER_MONITOR_PRESENT + +#include "../../../lib/tasks/OnTask.h" + +// Adjust these two includes to match your tree (these are the typical locations) +#include "../Features.h" +#include "../../Telescope.h" + +static void powerWrapper() { powerMonitor.poll(); } + +bool PowerMonitor::init() { + VLF("MSG: PowerMonitor, starting: power monitor"); + + VF("MSG: PowerMonitor, start voltage/current monitoring task (rate 200ms priority 7)... "); + if (tasks.add(200, 0, true, 7, powerWrapper, "pwrMtr")) { VLF("success"); } else { VLF("FAILED!"); return false; } + + #if defined(FAN_PIN) + fanMode = FM_OFF; + #endif + + return true; +} + +void PowerMonitor::poll() { + float v = 0.0F; + bool disableFeatures = false; + + // clear fault flags; they are re-asserted on each poll if the condition is present + for (int j = 0; j < 8; j++) { + ocFault[j] = false; + uvFault[j] = false; + ovFault[j] = false; + otFault[j] = false; + } + + // ---------------- Voltage sampling ---------------- + #if defined(POWER_MONITOR_VOLTAGE_PRESENT) + const int voltageSensePin[8] = V_SENSE_PINS; + + for (int j = 0; j < 8; j++) { + if (voltageSensePin[j] >= 0) { + if (isnan(averagedVoltage[j])) delay(10); + + v = analog.readV((int16_t)voltageSensePin[j]); + + const float scaledVoltage = (float)(V_SENSE_FORMULA); + + if (isnan(averagedVoltage[j])) averagedVoltage[j] = scaledVoltage; + else averagedVoltage[j] = (averagedVoltage[j] * 6.0F + scaledVoltage) / 7.0F; + + #if defined(V_SENSE_LIMIT_LOW) && defined(V_SENSE_LIMIT_HIGH) + if (j != V_SENSE_LIMIT_EXCLUDE && + (averagedVoltage[j] < V_SENSE_LIMIT_LOW || averagedVoltage[j] > V_SENSE_LIMIT_HIGH)) { + VLF("MSG: PowerMonitor, OV/UV"); + if (averagedVoltage[j] < V_SENSE_LIMIT_LOW) uvFault[j] = true; + if (averagedVoltage[j] > V_SENSE_LIMIT_HIGH) ovFault[j] = true; + disableFeatures = true; + } + #endif + } + } + #endif + + Y; + + // ---------------- Current sampling ---------------- + #if defined(POWER_MONITOR_CURRENT_PRESENT) + + const int currentSensePin[8] = I_SENSE_PINS; + #if defined(I_SENSE_CHANNEL_MAX) && (I_SENSE_COMBINED_MAX) + float currentSenseTotal = 0.0F; + #endif + + for (int j = 0; j < 8; j++) { + if (currentSensePin[j] >= 0) { + if (isnanf(averagedCurrent[j])) delay(10); + + v = analog.readV((int16_t)currentSensePin[j]); + + const float currentI = (float)(I_SENSE_FORMULA); + + if (isnanf(averagedCurrent[j])) averagedCurrent[j] = currentI; + else averagedCurrent[j] = (averagedCurrent[j] * 6.0F + currentI) / 7.0F; + + #if defined(I_SENSE_CHANNEL_MAX) + const float currentSenseMax[8] = I_SENSE_CHANNEL_MAX; + + if (fabsf(averagedCurrent[j]) > currentSenseMax[j]) { + VF("MSG: PowerMonitor, OC channel"); V(j); + VF(" current="); V(averagedCurrent[j]); VLF("A"); + ocFault[j] = true; + features.deviceOff(j); + } + + #if defined(I_SENSE_COMBINED_MAX) + currentSenseTotal += fabsf(averagedCurrent[j]); + if (currentSenseTotal > I_SENSE_COMBINED_MAX) { + VF("MSG: PowerMonitor, OC combined"); + VF(" current="); V(currentSenseTotal); VLF("A"); + for (int k = 0; k < 8; k++) ocFault[k] = true; + disableFeatures = true; + } + #endif + #endif + } + } + #endif + + Y; + + // ---------------- Fan / OT safety ---------------- + #if defined(FAN_PIN) + FanMode lastFanMode = fanMode; + + // telescope.mcuTemperature exists; NAN means unavailable. + if (!isnan(telescope.mcuTemperature) && (int32_t)(millis() - nextFanModeChangeTime) > 0) { + + #if defined(FAN_THRESHOLD_OT) + if (telescope.mcuTemperature > FAN_THRESHOLD_OT) { + VLF("MSG: PowerMonitor, MCU OT"); + for (int k = 0; k < 8; k++) otFault[k] = true; + disableFeatures = true; + } + #endif + + #if defined(FAN_THRESHOLD_HIGH) && defined(FAN_POWER_HIGH) + if (telescope.mcuTemperature > FAN_THRESHOLD_HIGH) { + if (fanMode != FM_HIGH) { + VLF("MSG: PowerMonitor, fan high"); + analog.write((int16_t)FAN_PIN, (float)(FAN_POWER_HIGH/100.0F)); + fanMode = FM_HIGH; + } + } else + #endif + + #if defined(FAN_THRESHOLD_MID) && defined(FAN_POWER_MID) + if (telescope.mcuTemperature > FAN_THRESHOLD_MID) { + if (fanMode != FM_MID) { + VLF("MSG: PowerMonitor, fan mid"); + analog.write((int16_t)FAN_PIN, (float)(FAN_POWER_MID/100.0F)); + fanMode = FM_MID; + } + } else + #endif + + #if defined(FAN_THRESHOLD_LOW) && defined(FAN_POWER_LOW) + if (telescope.mcuTemperature > FAN_THRESHOLD_LOW) { + if (fanMode != FM_LOW) { + VLF("MSG: PowerMonitor, fan low"); + analog.write((int16_t)FAN_PIN, (float)(FAN_POWER_LOW/100.0F)); + fanMode = FM_LOW; + } + } else + #endif + + if (fanMode != FM_OFF) { + VLF("MSG: PowerMonitor, fan off"); + analog.write((int16_t)FAN_PIN, 0.0F); + fanMode = FM_OFF; + } + } + + if (lastFanMode != fanMode) nextFanModeChangeTime = millis() + 30000UL; + #endif + + if (disableFeatures) { + VLF("MSG: PowerMonitor, disable all features"); + for (int j = 0; j < 8; j++) features.deviceOff(j); + } +} + +PowerMonitor powerMonitor; + +#endif diff --git a/src/telescope/auxiliary/powerMonitor/PowerMonitor.h b/src/telescope/auxiliary/powerMonitor/PowerMonitor.h new file mode 100755 index 0000000..fd90b3e --- /dev/null +++ b/src/telescope/auxiliary/powerMonitor/PowerMonitor.h @@ -0,0 +1,59 @@ +//-------------------------------------------------------------------------------------------------- +// Power monitor + safety (auxiliary/AF) +// +// - Samples V/I channels (optional) with smoothing +// - Applies safety shutoffs to Features (per-channel OC, combined OC, OV/UV, MCU OT) +// - Optional fan control based on telescope.mcuTemperature (NAN => unavailable) +// + +#pragma once + +#include "../../../Common.h" + +#ifdef POWER_MONITOR_PRESENT + +#include "../../../lib/analog/Analog.h" +#include + +class Features; +class Telescope; + +class PowerMonitor { +public: + bool init(); + + // telemetry access (NAN if never sampled / pin not present) + float getVoltage(uint8_t ch) const { return (ch < 8) ? averagedVoltage[ch] : NAN; } + float getCurrent(uint8_t ch) const { return (ch < 8) ? averagedCurrent[ch] : NAN; } + + bool hasVoltage(uint8_t ch) const { return (ch < 8) && !isnan(averagedVoltage[ch]); } + bool hasCurrent(uint8_t ch) const { return (ch < 8) && !isnan(averagedCurrent[ch]); } + + // channel exists if any telemetry is available + bool hasChannel(uint8_t ch) const { return hasVoltage(ch) || hasCurrent(ch); } + + // fault flags (best-effort; cleared each poll unless fault re-triggers) + bool errOverCurrent(uint8_t ch) const { return (ch < 8) ? ocFault[ch] : false; } + bool errUnderVoltage(uint8_t ch) const { return (ch < 8) ? uvFault[ch] : false; } + bool errOverVoltage(uint8_t ch) const { return (ch < 8) ? ovFault[ch] : false; } + bool errOverTemperature(uint8_t ch) const { return (ch < 8) ? otFault[ch] : false; } + + void poll(); + +private: + float averagedVoltage[8] = {NAN, NAN, NAN, NAN, NAN, NAN, NAN, NAN}; + float averagedCurrent[8] = {NAN, NAN, NAN, NAN, NAN, NAN, NAN, NAN}; + + bool ocFault[8] = {false, false, false, false, false, false, false, false}; + bool uvFault[8] = {false, false, false, false, false, false, false, false}; + bool ovFault[8] = {false, false, false, false, false, false, false, false}; + bool otFault[8] = {false, false, false, false, false, false, false, false}; + + enum FanMode : uint8_t { FM_OFF = 0, FM_LOW, FM_MID, FM_HIGH }; + FanMode fanMode = FM_OFF; + uint32_t nextFanModeChangeTime = 0; +}; + +extern PowerMonitor powerMonitor; + +#endif diff --git a/src/telescope/auxiliary/remote/Features.can.decode.cpp b/src/telescope/auxiliary/remote/Features.can.decode.cpp new file mode 100755 index 0000000..7e8d3c3 --- /dev/null +++ b/src/telescope/auxiliary/remote/Features.can.decode.cpp @@ -0,0 +1,173 @@ +//-------------------------------------------------------------------------------------------------- +// remote telescope features control, using the CANbus interface (CAN client decode) + +#include "Features.h" + +#if defined(FEATURES_CAN_CLIENT_PRESENT) + +#include "../FeaturesBase.h" +#include "../../../lib/convert/Convert.h" + +// ---------- helpers ---------- + +// Dew heater: -5.0..+20.0C encoded as 0..250 in 0.1C steps (one byte). +static inline float unpackDew01C(uint8_t enc) { + return ((float)enc / 10.0f) - 5.0f; +} + +static inline void fmtSeconds(char *out, float v, bool isExposure) { + // Match the formatting intent from Features.command.cpp: + // exposure: <1 => 3dp, <10 => 2dp, <30 => 1dp, else 0dp + // delay: <10 => 2dp, <30 => 1dp, else 0dp + int d = 0; + if (isExposure) { + if (v < 1.0f) d = 3; + else if (v < 10.0f) d = 2; + else if (v < 30.0f) d = 1; + else d = 0; + } else { + if (v < 10.0f) d = 2; + else if (v < 30.0f) d = 1; + else d = 0; + } + dtostrf(v, 0, d, out); +} + +bool Features::decodeResponse(char *reply) { + if (!reply) return false; + reply[0] = 0; + + switch (opCode()) { + + // :GXY0# -> "01010101" (8 chars, no terminator transmitted on CAN; we add it locally) + case FEAT_OP_GET_ACTIVE_Y0: { + uint8_t bitmap = 0; + if (!readU8(bitmap)) return false; + + for (uint8_t i = 0; i < 8; i++) { reply[i] = (bitmap & (1U << i)) ? '1' : '0'; } + reply[8] = 0; + } break; + + // :GXYn# -> "NAME,PURPOSE" (NAME up to 10 chars; PURPOSE numeric) + // Wire: + // frame0 data: [purpose][name0..name4] + // frame1 data: [name5..name10] (up to 6 bytes) + case FEAT_OP_GET_INFO_Yn: { + uint8_t purpose = 0; + if (!readU8(purpose)) return false; + + char name[14]; + int len = readRemainingBytes((uint8_t*)name); + name[len] = 0; + + sprintf(reply, "%s,%u", name, (unsigned)purpose); + } break; + + // :GXXn# -> per-purpose value reply, rendered as original comma-separated ASCII, + // with optional power monitor telemetry appended (matches Features::strCatPower()). + // + // Wire (frame0 data is always 6 bytes; purpose is included): + // frame0 data: [purpose][value bytes...] + // frame1 data: optional [intervalometerCount] + optional [V i16 0.1][I i16 0.1][flags] + // + // Voltage/current fixed-point: enc = round(x * 10), int16 LE; 0x8000 => NAN. + // Flags: FEAT_POWER_FLAGS_PRESENT + FEAT_POWER_FAULT_* (see FeaturesBase.h). + case FEAT_OP_GET_VALUE_Xn: { + uint8_t purpose = 0; + if (!readU8(purpose)) return false; + + // -------- value decode -------- + if (purpose == SWITCH || purpose == MOMENTARY_SWITCH || purpose == COVER_SWITCH) { + uint8_t v = 0; + if (!readU8(v)) return false; + sprintf(reply, "%u", (unsigned)v); + } else + + if (purpose == ANALOG_OUTPUT) { + uint8_t v = 0; + if (!readU8(v)) return false; + sprintf(reply, "%u", (unsigned)v); + } else + + if (purpose == DEW_HEATER) { + uint8_t en = 0; + uint8_t zEnc = 0; + uint8_t sEnc = 0; + float delta = 0; + if (!readU8(en) || !readU8(zEnc) || !readU8(sEnc) || !readFixedI16(delta, 10)) return false; + + const float zero = unpackDew01C(zEnc); + const float span = unpackDew01C(sEnc); + + char s1[16], s2[16], s3[16]; + dtostrf(zero, 0, 1, s1); + dtostrf(span, 0, 1, s2); + if (isnan(delta)) strcpy(s3, "NAN"); else dtostrf(delta, 0, 1, s3); + sprintf(reply, "%u,%s,%s,%s", (unsigned)en, s1, s2, s3); + } else + + if (purpose == INTERVALOMETER) { + uint8_t cur = 0; + uint8_t expB = 0; + uint8_t delB = 0; + uint8_t count = 0; + + if (!readU8(cur) || !readU8(expB) || !readU8(delB) || !readU8(count)) return false; + + const float exposure = convert.unpackSeconds(expB); + const float delay = convert.unpackSeconds(delB); + + char sExp[20], sDel[20]; + fmtSeconds(sExp, exposure, true); + fmtSeconds(sDel, delay, false); + sprintf(reply, "%u,%s,%s,%u", (unsigned)cur, sExp, sDel, (unsigned)count); + } else { + // Unknown purpose; return first value byte as integer + uint8_t v = 0; + if (!readU8(v)) return false; + sprintf(reply, "%u", (unsigned)v); + } + + // optional power telemetry append + if (remaining() == 5) { + float volts = NAN; + float amps = NAN; + uint8_t flags = 0; + + if (!readFixedI16(volts, 10) || !readFixedI16(amps, 10) || !readU8(flags)) return false; + + const bool present = ((flags & FEAT_POWER_FLAGS_PRESENT) != 0); + + if (!present) { strcat(reply, ",NAN,NAN,!!!!!"); return true; } + + if (isnan(volts)) { strcat(reply, ",NAN"); } else { char s[24]; sprintF(s, ",%1.1f", volts); strcat(reply, s); } + + if (isnan(amps)) { strcat(reply, ",NAN"); } else { char s[24]; sprintF(s, ",%1.1f", amps); strcat(reply, s); } + + // Flags string: ",P" + (C/v/V/T or !) + char fs[8]; + fs[0] = ','; + fs[1] = 'P'; + fs[2] = (flags & FEAT_POWER_FAULT_OC) ? '!' : 'C'; + fs[3] = (flags & FEAT_POWER_FAULT_UV) ? '!' : 'v'; + fs[4] = (flags & FEAT_POWER_FAULT_OV) ? '!' : 'V'; + fs[5] = (flags & FEAT_POWER_FAULT_OT) ? '!' : 'T'; + fs[6] = 0; + strcat(reply, fs); + } + + } break; + + // SET op is normally numericReply=true (so decodeResponse won't be called), + // but keep it harmless if it is. + case FEAT_OP_SET_VALUE_Xn: + default: + reply[0] = 0; + return true; + break; + } + + return true; +} + +#endif diff --git a/src/telescope/auxiliary/remote/Features.can.encode.cpp b/src/telescope/auxiliary/remote/Features.can.encode.cpp new file mode 100755 index 0000000..3ab5154 --- /dev/null +++ b/src/telescope/auxiliary/remote/Features.can.encode.cpp @@ -0,0 +1,98 @@ +//-------------------------------------------------------------------------------------------------- +// remote auxiliary features control, using the CANbus interface (CAN client encode) + +#include "Features.h" + +#if defined(FEATURES_CAN_CLIENT_PRESENT) + +#include "../FeaturesBase.h" +#include "../../../lib/convert/Convert.h" + +// ---------- helpers ---------- + +// Dew heater: -5.0..+20.0C encoded as 0..250 in 0.1C steps (one byte). +static inline uint8_t packDew01C(float v) { + if (v < -5.0f) v = -5.0f; + if (v > 20.0f) v = 20.0f; + const int enc = (int)lroundf((v + 5.0f) * 10.0f); + if (enc < 0) return 0; + if (enc > 250) return 250; + return (uint8_t)enc; +} + +bool Features::encodeRequest(char *command, char *parameter) { + + if (command[0] == 'G' && command[1] == 'X') { + + // :GXY0# + if (parameter[0] == 'Y' && parameter[1] == '0' && parameter[2] == 0) { + if (!beginNewRequest(FEAT_OP_GET_ACTIVE_Y0)) return false; + } else + + // :GXY[n]# where [n]=1..8 + if (parameter[0] == 'Y' && parameter[2] == 0) { + const char c = parameter[1]; + if (c < '1' || c > '8') return false; + + const uint8_t idx = (uint8_t)(c - '1'); // 0..7 + if (!beginNewRequest(FEAT_OP_GET_INFO_Yn)) return false; + if (!writeU8(idx)) return false; + } else + + // :GXX[n]# where [n]=1..8 + if (parameter[0] == 'X' && parameter[2] == 0) { + const char c = parameter[1]; + if (c < '1' || c > '8') return false; + + const uint8_t idx = (uint8_t)(c - '1'); // 0..7 + if (!beginNewRequest(FEAT_OP_GET_VALUE_Xn)) return false; + if (!writeU8(idx)) return false; + } else return false; + + } else + + if (command[0] == 'S' && command[1] == 'X') { + + // Expected: "Xn,..." (per Features.command.cpp) + // Examples: "X1,V1" "X2,V255" "X1,Z0.5" "X3,E12.3" + if (parameter[0] != 'X' || parameter[2] != ',') return false; + + const uint8_t sub = (uint8_t)parameter[3]; + int idx = parameter[1] - '0'; + if (idx < 1 || idx > 8) return false; + + char* conv_end; + float f = strtof(¶meter[4], &conv_end); + if (¶meter[4] == conv_end) return false; + long i = lroundf(f); + + if (!beginNewRequest(FEAT_OP_SET_VALUE_Xn)) return false; + + if (!writeU8(idx)) return false; + if (!writeU8(sub)) return false; + + // Subcommand packing + if (sub == (uint8_t)'V') { + if (!writeU8(i)) return false; + } else + + if (sub == (uint8_t)'Z' || sub == (uint8_t)'S') { + // Z/S: dew heater params packed as 0.1C steps in one byte + if (!writeU8(packDew01C(f))) return false; + } else + + if (sub == (uint8_t)'E' || sub == (uint8_t)'D') { + if (!writeU8(convert.packSeconds(f))) return false; + } else + + if (sub == (uint8_t)'C') { + // C: intervalometer count (0..255) packed u8 + if (!writeU8(i)) return false; + } else return false; + + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/auxiliary/remote/Features.cpp b/src/telescope/auxiliary/remote/Features.cpp new file mode 100755 index 0000000..042c75a --- /dev/null +++ b/src/telescope/auxiliary/remote/Features.cpp @@ -0,0 +1,65 @@ +//-------------------------------------------------------------------------------------------------- +// remote telescope auxiliary features control, using the CANbus interface + +#include "Features.h" + +#ifdef FEATURES_CAN_CLIENT_PRESENT + +// -------------------------------------------------------------------------- +// Heartbeat RX (local node): update last-heard timestamp for features +// -------------------------------------------------------------------------- +static void feaHb(uint8_t data[8], uint8_t len) { (void)data; (void)len; features.heartbeat(); } + +void Features::begin() { + canPlus.callbackRegisterId((int)(CAN_FEATURES_HB_ID_BASE), feaHb); +} + +// by default reply[80] == "", suppressFrame == false, numericReply == true, and commandError == CE_NONE +// return true if the command has been completely handled and no further command() will be called, or false if not +// for commands that are handled repeatedly commandError might contain CE_NONE or CE_1 to indicate success +// numericReply=true means boolean/numeric-style responses (e.g., CE_1/CE_0/errors) rather than a payload +bool Features::command(char *reply, char *command, char *parameter, + bool *suppressFrame, bool *numericReply, CommandError *commandError) { + if (!canPlus.ready) return false; + + // Only handle aux Feature command family: + // :GXXn# :GXYn# :SXXn,*# + if (!((command[0] == 'G' && command[1] == 'X' && (parameter[0] == 'X' || parameter[0] == 'Y')) || + (command[0] == 'S' && command[1] == 'X' && parameter[0] == 'X'))) return false; + + // Presence gate + if (!heartbeatFresh()) return false; + + // Build CAN request (also sets opCode()/tidop internally per your new design) + if (!encodeRequest(command, parameter)) return false; + + // Transport failure => reply unknown + bool handled = false; + if (!transactRequest(handled, *suppressFrame, *numericReply, *commandError)) { *commandError = CE_REPLY_UNKNOWN; return true; } + + // Remote explicitly did not recognize/handle the command + if (!handled) { + *commandError = CE_CMD_UNKNOWN; + *numericReply = true; + *suppressFrame = false; + reply[0] = 0; + return true; + } + + // Numeric reply: nothing to decode; caller will render numeric based on commandError + if (*numericReply) return true; + + // Payload reply: decode into reply buffer; decode failure => reply unknown + if (!decodeResponse(reply)) { + *commandError = CE_REPLY_UNKNOWN; + *numericReply = true; + *suppressFrame = false; + reply[0] = 0; + } + + return true; +} + +Features features; + +#endif diff --git a/src/telescope/auxiliary/remote/Features.h b/src/telescope/auxiliary/remote/Features.h new file mode 100755 index 0000000..2cad691 --- /dev/null +++ b/src/telescope/auxiliary/remote/Features.h @@ -0,0 +1,46 @@ +//-------------------------------------------------------------------------------------------------- +// remote telescope auxiliary FEATURES control, using the CANbus interface +#pragma once + +#include "../../../Common.h" + +#include "../FeaturesBase.h" + +#ifdef FEATURES_CAN_CLIENT_PRESENT + +#include "../../../lib/canTransport/CanTransportClient.h" +#include "../../../libApp/commands/ProcessCmds.h" + +class Features : public CanTransportClient { +public: + Features() + : CanTransportClient((uint16_t)(CAN_FEATURES_REQ_ID), (uint16_t)(CAN_FEATURES_RSP_ID), 0x1E) {} + + // initialize the aux features + void begin(); + + bool command(char *reply, char *command, char *parameter, + bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // Heartbeat event + inline void heartbeat() { lastHeartbeatMs = hb_stamp_2ms_odd(); } + +private: + bool encodeRequest(char *command, char *parameter); + bool decodeResponse(char *reply); + + static inline uint32_t hb_stamp_2ms_odd() { return millis() | 1UL; } + + inline bool heartbeatFresh() const { + const uint32_t last = ATOMIC_LOAD(lastHeartbeatMs); + if (last == 0U) return false; + const uint32_t now = hb_stamp_2ms_odd(); + return (uint32_t)(now - last) <= 2000U; + } + + volatile uint32_t lastHeartbeatMs = 0; +}; + +extern Features features; + +#endif diff --git a/src/telescope/focuser/Focuser.h b/src/telescope/focuser/Focuser.h new file mode 100755 index 0000000..d12394d --- /dev/null +++ b/src/telescope/focuser/Focuser.h @@ -0,0 +1,21 @@ +//-------------------------------------------------------------------------------------------------- +// local and remote telescope focuser control switchboard + +#pragma once + +#include "../../Common.h" + +#include "FocuserBase.h" + +// ----------------------------------------------------------------------------- +// Include the chosen implementation +// - CLIENT: Focuser is a proxy class +// - otherwise (local present): Focuser is the local hardware class +// and REMOTE (server) support is compiled in as additional code paths. +// ----------------------------------------------------------------------------- +#if defined(FOCUSER_CAN_CLIENT_PRESENT) + #include "remote/Focuser.h" // defines class Focuser (proxy) +#elif defined(FOCUSER_PRESENT) + #include "local/Focuser.h" // defines class Focuser (local hardware) + // conditionally includes/declares server hooks when FOCUSER_CAN_SERVER_PRESENT is defined +#endif diff --git a/src/telescope/focuser/FocuserBase.h b/src/telescope/focuser/FocuserBase.h new file mode 100755 index 0000000..3fdd032 --- /dev/null +++ b/src/telescope/focuser/FocuserBase.h @@ -0,0 +1,114 @@ +#pragma once + +#include "../../Common.h" + +// ----------------------------------------------------------------------------- +// CAN focuser transport base definitions (shared by local + remote) +// ----------------------------------------------------------------------------- + +// ----------------------------------------------------------------------------- +// CAN IDs +// ----------------------------------------------------------------------------- +#ifndef CAN_FOCUSER_REQ_ID + #define CAN_FOCUSER_REQ_ID (0x00 + 4) +#endif + +#ifndef CAN_FOCUSER_RSP_ID + #define CAN_FOCUSER_RSP_ID (CAN_FOCUSER_REQ_ID + 0x10) +#endif + +// Heartbeats are separate IDs (one per focuser 1..6). +#ifndef CAN_FOCUSER_HB_ID_BASE + #define CAN_FOCUSER_HB_ID_BASE (CAN_FOCUSER_REQ_ID + 0x20) +#endif + +// ----------------------------------------------------------------------------- +// CAN_FOCUSER role selection +// OFF : no CAN focuser support +// ON : telescope/mount forwards focuser commands over CAN (client/proxy) +// REMOTE : remote node answers focuser commands over CAN (server/local AXIS4) +// ----------------------------------------------------------------------------- +#ifndef CAN_FOCUSER + #define CAN_FOCUSER OFF +#endif + +#if (CAN_FOCUSER == REMOTE) + #ifndef CAN_FOCUSER_NUMBER + #define CAN_FOCUSER_NUMBER 1 + #endif + #if (CAN_FOCUSER_NUMBER < 1) || (CAN_FOCUSER_NUMBER > 6) + #error "Config: CAN_FOCUSER_NUMBER must be 1..6 when CAN_FOCUSER == REMOTE." + #endif +#endif + +// ----------------------------------------------------------------------------- +// Validate CAN requirements +// ----------------------------------------------------------------------------- +#if (CAN_FOCUSER != OFF) + #if !defined(CAN_PLUS) || (CAN_PLUS == OFF) + #error "Focuser: CAN_FOCUSER requires CAN_PLUS to be enabled." + #endif +#endif + +// ----------------------------------------------------------------------------- +// Derive presence macros used by Telescope.cpp command router +// ----------------------------------------------------------------------------- +#if (CAN_FOCUSER == ON) + #define FOCUSER_CLIENT_PRESENT + #define FOCUSER_CAN_CLIENT_PRESENT +#elif (CAN_FOCUSER == REMOTE) + #define FOCUSER_CAN_SERVER_PRESENT +#endif + +// CLIENT build must NOT also have local Axis4..Axis9 focusers. +#if defined(FOCUSER_PRESENT) && defined(FOCUSER_CLIENT_PRESENT) + #error "Config: both local focusers (FOCUSER_PRESENT) and CAN_FOCUSER ON are enabled. Choose one." +#endif + +// REMOTE build MUST have local Axis4 focuser. +#if (CAN_FOCUSER == REMOTE) && (AXIS4_DRIVER_MODEL == OFF) + #error "Config: CAN_FOCUSER REMOTE requires a local AXIS4 focuser (AXIS4_DRIVER_MODEL != OFF)." +#endif + +// ----------------------------------------------------------------------------- +// Control byte (requestPayload[1]) +// ----------------------------------------------------------------------------- +#define FOC_CTRL_FOCUSER_MASK 0x07 // bits 0..2 store focuser number 1..6 +#define FOC_CTRL_UNIT_MICRONS 0x08 // bit 3: 1=microns, 0=steps + +// ----------------------------------------------------------------------------- +// CAN opcode set (5-bit) +// ----------------------------------------------------------------------------- +#define FOC_OP_GET_STATUS_T 0x00 +#define FOC_OP_GET_MODE_p 0x01 +#define FOC_OP_GET_MIN_I 0x02 +#define FOC_OP_GET_MAX_M 0x03 +#define FOC_OP_GET_TEMPDIFF_e 0x04 +#define FOC_OP_GET_TEMP_t 0x05 +#define FOC_OP_GET_UM_PER_STEP_u 0x06 + +#define FOC_OP_BACKLASH_B 0x07 // get: no args, set: i32LE +#define FOC_OP_PARK_HP 0x08 +#define FOC_OP_UNPARK_HR 0x09 + +#define FOC_OP_TCF_COEF_C 0x0A // get: no args, set: f32LE +#define FOC_OP_TCF_ENABLE_c 0x0B // get: no args, set: u8 (0/1) +#define FOC_OP_TCF_DEADBAND_D 0x0C // get: no args, set: i32LE +#define FOC_OP_DC_POWER_P 0x0D // get: no args, set: u8 (0..100) + +#define FOC_OP_STOP_Q 0x0E +#define FOC_OP_SET_RATE_1_9 0x0F // u8 digit 1..9 +#define FOC_OP_GET_WORKRATE_W 0x10 // i32LE (um/s) + +#define FOC_OP_MOVE_IN_PLUS 0x11 +#define FOC_OP_MOVE_OUT_MINUS 0x12 + +#define FOC_OP_GET_POS_G 0x13 // i32LE position (units) +#define FOC_OP_GOTO_REL_R 0x14 // i32LE delta (units) +#define FOC_OP_GOTO_ABS_S 0x15 // i32LE target (units) + +#define FOC_OP_ZERO_Z 0x16 +#define FOC_OP_SET_HOME_H 0x17 +#define FOC_OP_GOTO_HOME_h 0x18 + +#define FOC_OP_DRIVER_STATUS 0x19 // :GXU[n]# diff --git a/src/telescope/focuser/local/Focuser.axis.prototype.cpp b/src/telescope/focuser/local/Focuser.axis.prototype.cpp new file mode 100755 index 0000000..915f48b --- /dev/null +++ b/src/telescope/focuser/local/Focuser.axis.prototype.cpp @@ -0,0 +1,109 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control, axis@ + +#include "Focuser.h" + +// note there is a prototype file that should be copy/pasted to build files +// for axes 4 to 9 by replacing all occurances of '@' with the axis number + +//#if AXIS@_DRIVER_MODEL != OFF +#if false + namespace { + + #if defined(AXIS@_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis@ = {AXIS@_DRIVER_MODEL, AXIS@_DRIVER_STATUS}; + KTechMotor motor_@(@, AXIS@_REVERSE, &DriverSettingsAxis@); + + #elif defined(AXIS@_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis@ = {AXIS@_DRIVER_MODEL, AXIS@_DRIVER_STATUS}; + Mks42DMotor motor_@(@, AXIS@_REVERSE, &DriverSettingsAxis@, AXIS@_STEPS_PER_DEGREE); + + #elif defined(AXIS@_SERVO_PRESENT) + ServoControl servoControlAxis@; + + #if AXIS@_ENCODER == AB + Quadrature encAxis@(@, AXIS@_ENCODER_A_PIN, AXIS@_ENCODER_B_PIN); + #elif AXIS@_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis@(@, AXIS@_ENCODER_A_PIN, AXIS@_ENCODER_B_PIN); + #elif AXIS@_ENCODER == CW_CCW + CwCcw encAxis@(@, AXIS@_ENCODER_A_PIN, AXIS@_ENCODER_B_PIN); + #elif AXIS@_ENCODER == PULSE_DIR + PulseDir encAxis@(@, AXIS@_ENCODER_A_PIN, AXIS@_ENCODER_B_PIN); + #elif AXIS@_ENCODER == PULSE_ONLY + PulseOnly encAxis@(@, AXIS@_ENCODER_A_PIN, &servoControlAxis@.directionHint); + #elif AXIS@_ENCODER == VIRTUAL + VirtualEnc encAxis@(@); + #elif AXIS@_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis@(@); + #endif + + #if AXIS@_SERVO_FEEDBACK == PID + Pid feedbackAxis@(AXIS@_PID_P, AXIS@_PID_I, AXIS@_PID_D); + #elif AXIS@_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis@(AXIS@_PID_P, AXIS@_PID_I, AXIS@_PID_D, AXIS@_PID_P_GOTO, AXIS@_PID_I_GOTO, AXIS@_PID_D_GOTO, AXIS@_PID_SENSITIVITY); + #endif + + #if AXIS@_SERVO_FLTR == KALMAN + KalmanFilter filterAxis@(AXIS@_SERVO_FLTR_MEAS_U, AXIS@_SERVO_FLTR_VARIANCE); + #elif AXIS@_SERVO_FLTR == ROLLING + RollingFilter filterAxis@(AXIS@_SERVO_FLTR_WSIZE); + #elif AXIS@_SERVO_FLTR == OFF + Filter filterAxis@; + #endif + + const ServoPins DriverPinsAxis@ = {AXIS@_SERVO_PH1_PIN, AXIS@_SERVO_PH1_STATE, AXIS@_SERVO_PH2_PIN, AXIS@_SERVO_PH2_STATE, AXIS@_ENABLE_PIN, AXIS@_ENABLE_STATE, AXIS@_M0_PIN, AXIS@_M1_PIN, AXIS@_M2_PIN, AXIS@_M3_PIN, AXIS@_FAULT_PIN}; + const ServoSettings DriverSettingsAxis@ = {AXIS@_DRIVER_MODEL, AXIS@_DRIVER_STATUS, AXIS@_SERVO_ACCELERATION}; + + #if AXIS@_DRIVER_MODEL == SERVO_EE + ServoEE driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_SERVO_DC_PWR_MIN, AXIS@_SERVO_DC_PWR_MAX); + #elif AXIS@_DRIVER_MODEL == SERVO_PE + ServoPE driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_SERVO_DC_PWR_MIN, AXIS@_SERVO_DC_PWR_MAX); + #elif AXIS@_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc2130DC driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_SERVO_DC_PWR_MIN, AXIS@_SERVO_DC_PWR_MAX); + #elif AXIS@_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc5160DC driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_SERVO_DC_PWR_MIN, AXIS@_SERVO_DC_PWR_MAX); + #elif AXIS@_DRIVER_MODEL == TMC2209 || AXIS@_DRIVER_MODEL == TMC2226 + ServoTmc2209 driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_MOTOR_STEPS_PER_MICRON/AXIS@_STEPS_PER_MICRON, AXIS@_DRIVER_MICROSTEPS, AXIS@_DRIVER_IRUN, AXIS@_DRIVER_DECAY, AXIS@_DRIVER_DECAY_GOTO); + #elif AXIS@_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_MOTOR_STEPS_PER_MICRON/AXIS@_STEPS_PER_MICRON, AXIS@_DRIVER_MICROSTEPS, AXIS@_DRIVER_IRUN, AXIS@_DRIVER_DECAY, AXIS@_DRIVER_DECAY_GOTO); + #elif AXIS@_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver@(@, &DriverSettingsAxis@, AXIS@_MOTOR_STEPS_PER_MICRON/AXIS@_STEPS_PER_MICRON); + #endif + + ServoMotor motor_@(@, AXIS@_REVERSE, ((ServoDriver*)&driver@), &filterAxis@, &encAxis@, AXIS@_ENCODER_ORIGIN, AXIS@_ENCODER_REVERSE == ON, &feedbackAxis@, &servoControlAxis@); + + #elif defined(AXIS@_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis@ = {AXIS@_M0_PIN, AXIS@_M1_PIN, AXIS@_M2_PIN, AXIS@_M2_ON_STATE, AXIS@_M3_PIN, AXIS@_DECAY_PIN, AXIS@_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis@ = {AXIS@_DRIVER_MODEL, AXIS@_DRIVER_STATUS, AXIS@_DRIVER_MICROSTEPS, AXIS@_DRIVER_MICROSTEPS_GOTO, AXIS@_DRIVER_DECAY, AXIS@_DRIVER_DECAY_GOTO}; + #if AXIS@_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS@_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@); + #elif AXIS@_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_DRIVER_IHOLD, AXIS@_DRIVER_IRUN, AXIS@_DRIVER_IGOTO, AXIS@_DRIVER_INTPOL); + #elif AXIS@_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_DRIVER_IHOLD, AXIS@_DRIVER_IRUN, AXIS@_DRIVER_IGOTO, AXIS@_DRIVER_INTPOL); + #elif AXIS@_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_DRIVER_IHOLD, AXIS@_DRIVER_IRUN, AXIS@_DRIVER_IGOTO, AXIS@_DRIVER_INTPOL); + #elif AXIS@_DRIVER_MODEL == TMC2209 || AXIS@_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_DRIVER_IHOLD, AXIS@_DRIVER_IRUN, AXIS@_DRIVER_IGOTO, AXIS@_DRIVER_INTPOL); + #elif AXIS@_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_DRIVER_IHOLD, AXIS@_DRIVER_IRUN, AXIS@_DRIVER_IGOTO, AXIS@_DRIVER_INTPOL); + #elif AXIS@_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_DRIVER_IHOLD, AXIS@_DRIVER_IRUN, AXIS@_DRIVER_IGOTO, AXIS@_DRIVER_INTPOL); + #elif AXIS@_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver@(@, &DriverPinsAxis@, &DriverSettingsAxis@, AXIS@_DRIVER_IHOLD, AXIS@_DRIVER_IRUN, AXIS@_DRIVER_IGOTO, AXIS@_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis@ = {AXIS@_STEP_PIN, AXIS@_STEP_STATE, AXIS@_DIR_PIN, AXIS@_ENABLE_PIN, AXIS@_ENABLE_STATE}; + StepDirMotor motor_@(@, AXIS@_REVERSE, &StepDirPinsAxis@, ((StepDirDriver*)&driver@)); + #else + #error "Configuration (Config.h): Focuser has an unrecognized AXIS@_DRIVER_MODEL this should never happen!" + #endif + + const AxisPins PinsAxis@ = {AXIS@_SENSE_LIMIT_MIN_PIN, AXIS@_SENSE_HOME_PIN, AXIS@_SENSE_LIMIT_MAX_PIN, {AXIS@_SENSE_HOME, AXIS@_SENSE_HOME_INIT, AXIS@_SENSE_HOME_DIST_LIMIT*1000.0F, AXIS@_SENSE_LIMIT_MIN, AXIS@_SENSE_LIMIT_MAX, AXIS@_SENSE_LIMIT_INIT}}; + const AxisSettings SettingsAxis@ = {AXIS@_STEPS_PER_MICRON, {AXIS@_LIMIT_MIN*1000.0F, AXIS@_LIMIT_MAX*1000.0F}, AXIS@_BACKLASH_RATE}; + } + + Motor& motor@ = motor_@; + + Axis axis@(@, &PinsAxis@, &SettingsAxis@, AXIS_MEASURE_MICRONS); +#endif diff --git a/src/telescope/focuser/local/Focuser.axis4.cpp b/src/telescope/focuser/local/Focuser.axis4.cpp new file mode 100755 index 0000000..c70544e --- /dev/null +++ b/src/telescope/focuser/local/Focuser.axis4.cpp @@ -0,0 +1,109 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control, axis4 + +#include "Focuser.h" + +// note there is a prototype file that should be copy/pasted to build files +// for axes 4 to 9 by replacing all occurances of '@' with the axis number + +#if AXIS4_DRIVER_MODEL != OFF + + namespace { + + #if defined(AXIS4_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis4 = {AXIS4_DRIVER_MODEL, AXIS4_DRIVER_STATUS}; + KTechMotor motor_4(4, AXIS4_REVERSE, &DriverSettingsAxis4); + + #elif defined(AXIS4_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis4 = {AXIS4_DRIVER_MODEL, AXIS4_DRIVER_STATUS}; + Mks42DMotor motor_4(4, AXIS4_REVERSE, &DriverSettingsAxis4, AXIS4_STEPS_PER_DEGREE); + + #elif defined(AXIS4_SERVO_PRESENT) + ServoControl servoControlAxis4; + + #if AXIS4_ENCODER == AB + Quadrature encAxis4(4, AXIS4_ENCODER_A_PIN, AXIS4_ENCODER_B_PIN); + #elif AXIS4_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis4(4, AXIS4_ENCODER_A_PIN, AXIS4_ENCODER_B_PIN); + #elif AXIS4_ENCODER == CW_CCW + CwCcw encAxis4(4, AXIS4_ENCODER_A_PIN, AXIS4_ENCODER_B_PIN); + #elif AXIS4_ENCODER == PULSE_DIR + PulseDir encAxis4(4, AXIS4_ENCODER_A_PIN, AXIS4_ENCODER_B_PIN); + #elif AXIS4_ENCODER == PULSE_ONLY + PulseOnly encAxis4(4, AXIS4_ENCODER_A_PIN, &servoControlAxis4.directionHint); + #elif AXIS4_ENCODER == VIRTUAL + VirtualEnc encAxis4(4); + #elif AXIS4_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis4(4); + #endif + + #if AXIS4_SERVO_FEEDBACK == PID + Pid feedbackAxis4(AXIS4_PID_P, AXIS4_PID_I, AXIS4_PID_D); + #elif AXIS4_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis4(AXIS4_PID_P, AXIS4_PID_I, AXIS4_PID_D, AXIS4_PID_P_GOTO, AXIS4_PID_I_GOTO, AXIS4_PID_D_GOTO, AXIS4_PID_SENSITIVITY); + #endif + + #if AXIS4_SERVO_FLTR == KALMAN + KalmanFilter filterAxis4(AXIS4_SERVO_FLTR_MEAS_U, AXIS4_SERVO_FLTR_VARIANCE); + #elif AXIS4_SERVO_FLTR == ROLLING + RollingFilter filterAxis4(AXIS4_SERVO_FLTR_WSIZE); + #elif AXIS4_SERVO_FLTR == OFF + Filter filterAxis4; + #endif + + const ServoPins DriverPinsAxis4 = {AXIS4_SERVO_PH1_PIN, AXIS4_SERVO_PH1_STATE, AXIS4_SERVO_PH2_PIN, AXIS4_SERVO_PH2_STATE, AXIS4_ENABLE_PIN, AXIS4_ENABLE_STATE, AXIS4_M0_PIN, AXIS4_M1_PIN, AXIS4_M2_PIN, AXIS4_M3_PIN, AXIS4_FAULT_PIN}; + const ServoSettings DriverSettingsAxis4 = {AXIS4_DRIVER_MODEL, AXIS4_DRIVER_STATUS, AXIS4_SERVO_ACCELERATION}; + + #if AXIS4_DRIVER_MODEL == SERVO_EE + ServoEE driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_SERVO_DC_PWR_MIN, AXIS4_SERVO_DC_PWR_MAX); + #elif AXIS4_DRIVER_MODEL == SERVO_PE + ServoPE driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_SERVO_DC_PWR_MIN, AXIS4_SERVO_DC_PWR_MAX); + #elif AXIS4_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc2130DC driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_SERVO_DC_PWR_MIN, AXIS4_SERVO_DC_PWR_MAX); + #elif AXIS4_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc5160DC driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_SERVO_DC_PWR_MIN, AXIS4_SERVO_DC_PWR_MAX); + #elif AXIS4_DRIVER_MODEL == TMC2209 || AXIS4_DRIVER_MODEL == TMC2226 + ServoTmc2209 driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_MOTOR_STEPS_PER_MICRON/AXIS4_STEPS_PER_MICRON, AXIS4_DRIVER_MICROSTEPS, AXIS4_DRIVER_IRUN, AXIS4_DRIVER_DECAY, AXIS4_DRIVER_DECAY_GOTO); + #elif AXIS4_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_MOTOR_STEPS_PER_MICRON/AXIS4_STEPS_PER_MICRON, AXIS4_DRIVER_MICROSTEPS, AXIS4_DRIVER_IRUN, AXIS4_DRIVER_DECAY, AXIS4_DRIVER_DECAY_GOTO); + #elif AXIS4_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver4(4, &DriverSettingsAxis4, AXIS4_MOTOR_STEPS_PER_MICRON/AXIS4_STEPS_PER_MICRON); + #endif + + ServoMotor motor_4(4, AXIS4_REVERSE, ((ServoDriver*)&driver4), &filterAxis4, &encAxis4, AXIS4_ENCODER_ORIGIN, AXIS4_ENCODER_REVERSE == ON, &feedbackAxis4, &servoControlAxis4); + + #elif defined(AXIS4_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis4 = {AXIS4_M0_PIN, AXIS4_M1_PIN, AXIS4_M2_PIN, AXIS4_M2_ON_STATE, AXIS4_M3_PIN, AXIS4_DECAY_PIN, AXIS4_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis4 = {AXIS4_DRIVER_MODEL, AXIS4_DRIVER_STATUS, AXIS4_DRIVER_MICROSTEPS, AXIS4_DRIVER_MICROSTEPS_GOTO, AXIS4_DRIVER_DECAY, AXIS4_DRIVER_DECAY_GOTO}; + #if AXIS4_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS4_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4); + #elif AXIS4_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_DRIVER_IHOLD, AXIS4_DRIVER_IRUN, AXIS4_DRIVER_IGOTO, AXIS4_DRIVER_INTPOL); + #elif AXIS4_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_DRIVER_IHOLD, AXIS4_DRIVER_IRUN, AXIS4_DRIVER_IGOTO, AXIS4_DRIVER_INTPOL); + #elif AXIS4_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_DRIVER_IHOLD, AXIS4_DRIVER_IRUN, AXIS4_DRIVER_IGOTO, AXIS4_DRIVER_INTPOL); + #elif AXIS4_DRIVER_MODEL == TMC2209 || AXIS4_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_DRIVER_IHOLD, AXIS4_DRIVER_IRUN, AXIS4_DRIVER_IGOTO, AXIS4_DRIVER_INTPOL); + #elif AXIS4_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_DRIVER_IHOLD, AXIS4_DRIVER_IRUN, AXIS4_DRIVER_IGOTO, AXIS4_DRIVER_INTPOL); + #elif AXIS4_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_DRIVER_IHOLD, AXIS4_DRIVER_IRUN, AXIS4_DRIVER_IGOTO, AXIS4_DRIVER_INTPOL); + #elif AXIS4_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver4(4, &DriverPinsAxis4, &DriverSettingsAxis4, AXIS4_DRIVER_IHOLD, AXIS4_DRIVER_IRUN, AXIS4_DRIVER_IGOTO, AXIS4_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis4 = {AXIS4_STEP_PIN, AXIS4_STEP_STATE, AXIS4_DIR_PIN, AXIS4_ENABLE_PIN, AXIS4_ENABLE_STATE}; + StepDirMotor motor_4(4, AXIS4_REVERSE, &StepDirPinsAxis4, ((StepDirDriver*)&driver4)); + #else + #error "Configuration (Config.h): Focuser has an unrecognized AXIS4_DRIVER_MODEL this should never happen!" + #endif + + const AxisPins PinsAxis4 = {AXIS4_SENSE_LIMIT_MIN_PIN, AXIS4_SENSE_HOME_PIN, AXIS4_SENSE_LIMIT_MAX_PIN, {AXIS4_SENSE_HOME, AXIS4_SENSE_HOME_INIT, AXIS4_SENSE_HOME_DIST_LIMIT*1000.0F, AXIS4_SENSE_LIMIT_MIN, AXIS4_SENSE_LIMIT_MAX, AXIS4_SENSE_LIMIT_INIT}}; + const AxisSettings SettingsAxis4 = {AXIS4_STEPS_PER_MICRON, {AXIS4_LIMIT_MIN*1000.0F, AXIS4_LIMIT_MAX*1000.0F}, AXIS4_BACKLASH_RATE}; + } + + Motor& motor4 = motor_4; + + Axis axis4(4, &PinsAxis4, &SettingsAxis4, AXIS_MEASURE_MICRONS); +#endif diff --git a/src/telescope/focuser/local/Focuser.axis5.cpp b/src/telescope/focuser/local/Focuser.axis5.cpp new file mode 100755 index 0000000..5802163 --- /dev/null +++ b/src/telescope/focuser/local/Focuser.axis5.cpp @@ -0,0 +1,109 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control, axis5 + +#include "Focuser.h" + +// note there is a prototype file that should be copy/pasted to build files +// for axes 4 to 9 by replacing all occurances of '@' with the axis number + +#if AXIS5_DRIVER_MODEL != OFF + + namespace { + + #if defined(AXIS5_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis5 = {AXIS5_DRIVER_MODEL, AXIS5_DRIVER_STATUS}; + KTechMotor motor_5(5, AXIS5_REVERSE, &DriverSettingsAxis5); + + #elif defined(AXIS5_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis5 = {AXIS5_DRIVER_MODEL, AXIS5_DRIVER_STATUS}; + Mks42DMotor motor_5(5, AXIS5_REVERSE, &DriverSettingsAxis5, AXIS5_STEPS_PER_DEGREE); + + #elif defined(AXIS5_SERVO_PRESENT) + ServoControl servoControlAxis5; + + #if AXIS5_ENCODER == AB + Quadrature encAxis5(5, AXIS5_ENCODER_A_PIN, AXIS5_ENCODER_B_PIN); + #elif AXIS5_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis5(5, AXIS5_ENCODER_A_PIN, AXIS5_ENCODER_B_PIN); + #elif AXIS5_ENCODER == CW_CCW + CwCcw encAxis5(5, AXIS5_ENCODER_A_PIN, AXIS5_ENCODER_B_PIN); + #elif AXIS5_ENCODER == PULSE_DIR + PulseDir encAxis5(5, AXIS5_ENCODER_A_PIN, AXIS5_ENCODER_B_PIN); + #elif AXIS5_ENCODER == PULSE_ONLY + PulseOnly encAxis5(5, AXIS5_ENCODER_A_PIN, &servoControlAxis5.directionHint); + #elif AXIS5_ENCODER == VIRTUAL + VirtualEnc encAxis5(5); + #elif AXIS5_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis5(5); + #endif + + #if AXIS5_SERVO_FEEDBACK == PID + Pid feedbackAxis5(AXIS5_PID_P, AXIS5_PID_I, AXIS5_PID_D); + #elif AXIS5_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis5(AXIS5_PID_P, AXIS5_PID_I, AXIS5_PID_D, AXIS5_PID_P_GOTO, AXIS5_PID_I_GOTO, AXIS5_PID_D_GOTO, AXIS5_PID_SENSITIVITY); + #endif + + #if AXIS5_SERVO_FLTR == KALMAN + KalmanFilter filterAxis5(AXIS5_SERVO_FLTR_MEAS_U, AXIS5_SERVO_FLTR_VARIANCE); + #elif AXIS5_SERVO_FLTR == ROLLING + RollingFilter filterAxis5(AXIS5_SERVO_FLTR_WSIZE); + #elif AXIS5_SERVO_FLTR == OFF + Filter filterAxis5; + #endif + + const ServoPins DriverPinsAxis5 = {AXIS5_SERVO_PH1_PIN, AXIS5_SERVO_PH1_STATE, AXIS5_SERVO_PH2_PIN, AXIS5_SERVO_PH2_STATE, AXIS5_ENABLE_PIN, AXIS5_ENABLE_STATE, AXIS5_M0_PIN, AXIS5_M1_PIN, AXIS5_M2_PIN, AXIS5_M3_PIN, AXIS5_FAULT_PIN}; + const ServoSettings DriverSettingsAxis5 = {AXIS5_DRIVER_MODEL, AXIS5_DRIVER_STATUS, AXIS5_SERVO_ACCELERATION}; + + #if AXIS5_DRIVER_MODEL == SERVO_EE + ServoEE driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_SERVO_DC_PWR_MIN, AXIS5_SERVO_DC_PWR_MAX); + #elif AXIS5_DRIVER_MODEL == SERVO_PE + ServoPE driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_SERVO_DC_PWR_MIN, AXIS5_SERVO_DC_PWR_MAX); + #elif AXIS5_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc2130DC driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_SERVO_DC_PWR_MIN, AXIS5_SERVO_DC_PWR_MAX); + #elif AXIS5_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc5160DC driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_SERVO_DC_PWR_MIN, AXIS5_SERVO_DC_PWR_MAX); + #elif AXIS5_DRIVER_MODEL == TMC2209 || AXIS5_DRIVER_MODEL == TMC2226 + ServoTmc2209 driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_MOTOR_STEPS_PER_MICRON/AXIS5_STEPS_PER_MICRON, AXIS5_DRIVER_MICROSTEPS, AXIS5_DRIVER_IRUN, AXIS5_DRIVER_DECAY, AXIS5_DRIVER_DECAY_GOTO); + #elif AXIS5_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_MOTOR_STEPS_PER_MICRON/AXIS5_STEPS_PER_MICRON, AXIS5_DRIVER_MICROSTEPS, AXIS5_DRIVER_IRUN, AXIS5_DRIVER_DECAY, AXIS5_DRIVER_DECAY_GOTO); + #elif AXIS5_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver5(5, &DriverSettingsAxis5, AXIS5_MOTOR_STEPS_PER_MICRON/AXIS5_STEPS_PER_MICRON); + #endif + + ServoMotor motor_5(5, AXIS5_REVERSE, ((ServoDriver*)&driver5), &filterAxis5, &encAxis5, AXIS5_ENCODER_ORIGIN, AXIS5_ENCODER_REVERSE == ON, &feedbackAxis5, &servoControlAxis5); + + #elif defined(AXIS5_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis5 = {AXIS5_M0_PIN, AXIS5_M1_PIN, AXIS5_M2_PIN, AXIS5_M2_ON_STATE, AXIS5_M3_PIN, AXIS5_DECAY_PIN, AXIS5_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis5 = {AXIS5_DRIVER_MODEL, AXIS5_DRIVER_STATUS, AXIS5_DRIVER_MICROSTEPS, AXIS5_DRIVER_MICROSTEPS_GOTO, AXIS5_DRIVER_DECAY, AXIS5_DRIVER_DECAY_GOTO}; + #if AXIS5_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS5_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5); + #elif AXIS5_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_DRIVER_IHOLD, AXIS5_DRIVER_IRUN, AXIS5_DRIVER_IGOTO, AXIS5_DRIVER_INTPOL); + #elif AXIS5_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_DRIVER_IHOLD, AXIS5_DRIVER_IRUN, AXIS5_DRIVER_IGOTO, AXIS5_DRIVER_INTPOL); + #elif AXIS5_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_DRIVER_IHOLD, AXIS5_DRIVER_IRUN, AXIS5_DRIVER_IGOTO, AXIS5_DRIVER_INTPOL); + #elif AXIS5_DRIVER_MODEL == TMC2209 || AXIS5_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_DRIVER_IHOLD, AXIS5_DRIVER_IRUN, AXIS5_DRIVER_IGOTO, AXIS5_DRIVER_INTPOL); + #elif AXIS5_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_DRIVER_IHOLD, AXIS5_DRIVER_IRUN, AXIS5_DRIVER_IGOTO, AXIS5_DRIVER_INTPOL); + #elif AXIS5_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_DRIVER_IHOLD, AXIS5_DRIVER_IRUN, AXIS5_DRIVER_IGOTO, AXIS5_DRIVER_INTPOL); + #elif AXIS5_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver5(5, &DriverPinsAxis5, &DriverSettingsAxis5, AXIS5_DRIVER_IHOLD, AXIS5_DRIVER_IRUN, AXIS5_DRIVER_IGOTO, AXIS5_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis5 = {AXIS5_STEP_PIN, AXIS5_STEP_STATE, AXIS5_DIR_PIN, AXIS5_ENABLE_PIN, AXIS5_ENABLE_STATE}; + StepDirMotor motor_5(5, AXIS5_REVERSE, &StepDirPinsAxis5, ((StepDirDriver*)&driver5)); + #else + #error "Configuration (Config.h): Focuser has an unrecognized AXIS5_DRIVER_MODEL this should never happen!" + #endif + + const AxisPins PinsAxis5 = {AXIS5_SENSE_LIMIT_MIN_PIN, AXIS5_SENSE_HOME_PIN, AXIS5_SENSE_LIMIT_MAX_PIN, {AXIS5_SENSE_HOME, AXIS5_SENSE_HOME_INIT, AXIS5_SENSE_HOME_DIST_LIMIT*1000.0F, AXIS5_SENSE_LIMIT_MIN, AXIS5_SENSE_LIMIT_MAX, AXIS5_SENSE_LIMIT_INIT}}; + const AxisSettings SettingsAxis5 = {AXIS5_STEPS_PER_MICRON, {AXIS5_LIMIT_MIN*1000.0F, AXIS5_LIMIT_MAX*1000.0F}, AXIS5_BACKLASH_RATE}; + } + + Motor& motor5 = motor_5; + + Axis axis5(5, &PinsAxis5, &SettingsAxis5, AXIS_MEASURE_MICRONS); +#endif diff --git a/src/telescope/focuser/local/Focuser.axis6.cpp b/src/telescope/focuser/local/Focuser.axis6.cpp new file mode 100755 index 0000000..d25eb5a --- /dev/null +++ b/src/telescope/focuser/local/Focuser.axis6.cpp @@ -0,0 +1,109 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control, axis6 + +#include "Focuser.h" + +// note there is a prototype file that should be copy/pasted to build files +// for axes 4 to 9 by replacing all occurances of '@' with the axis number + +#if AXIS6_DRIVER_MODEL != OFF + + namespace { + + #if defined(AXIS6_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis6 = {AXIS6_DRIVER_MODEL, AXIS6_DRIVER_STATUS}; + KTechMotor motor_6(6, AXIS6_REVERSE, &DriverSettingsAxis6); + + #elif defined(AXIS6_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis6 = {AXIS6_DRIVER_MODEL, AXIS6_DRIVER_STATUS}; + Mks42DMotor motor_6(6, AXIS6_REVERSE, &DriverSettingsAxis6, AXIS6_STEPS_PER_DEGREE); + + #elif defined(AXIS6_SERVO_PRESENT) + ServoControl servoControlAxis6; + + #if AXIS6_ENCODER == AB + Quadrature encAxis6(6, AXIS6_ENCODER_A_PIN, AXIS6_ENCODER_B_PIN); + #elif AXIS6_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis6(6, AXIS6_ENCODER_A_PIN, AXIS6_ENCODER_B_PIN); + #elif AXIS6_ENCODER == CW_CCW + CwCcw encAxis6(6, AXIS6_ENCODER_A_PIN, AXIS6_ENCODER_B_PIN); + #elif AXIS6_ENCODER == PULSE_DIR + PulseDir encAxis6(6, AXIS6_ENCODER_A_PIN, AXIS6_ENCODER_B_PIN); + #elif AXIS6_ENCODER == PULSE_ONLY + PulseOnly encAxis6(6, AXIS6_ENCODER_A_PIN, &servoControlAxis6.directionHint); + #elif AXIS6_ENCODER == VIRTUAL + VirtualEnc encAxis6(6); + #elif AXIS6_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis6(6); + #endif + + #if AXIS6_SERVO_FEEDBACK == PID + Pid feedbackAxis6(AXIS6_PID_P, AXIS6_PID_I, AXIS6_PID_D); + #elif AXIS6_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis6(AXIS6_PID_P, AXIS6_PID_I, AXIS6_PID_D, AXIS6_PID_P_GOTO, AXIS6_PID_I_GOTO, AXIS6_PID_D_GOTO, AXIS6_PID_SENSITIVITY); + #endif + + #if AXIS6_SERVO_FLTR == KALMAN + KalmanFilter filterAxis6(AXIS6_SERVO_FLTR_MEAS_U, AXIS6_SERVO_FLTR_VARIANCE); + #elif AXIS6_SERVO_FLTR == ROLLING + RollingFilter filterAxis6(AXIS6_SERVO_FLTR_WSIZE); + #elif AXIS6_SERVO_FLTR == OFF + Filter filterAxis6; + #endif + + const ServoPins DriverPinsAxis6 = {AXIS6_SERVO_PH1_PIN, AXIS6_SERVO_PH1_STATE, AXIS6_SERVO_PH2_PIN, AXIS6_SERVO_PH2_STATE, AXIS6_ENABLE_PIN, AXIS6_ENABLE_STATE, AXIS6_M0_PIN, AXIS6_M1_PIN, AXIS6_M2_PIN, AXIS6_M3_PIN, AXIS6_FAULT_PIN}; + const ServoSettings DriverSettingsAxis6 = {AXIS6_DRIVER_MODEL, AXIS6_DRIVER_STATUS, AXIS6_SERVO_ACCELERATION}; + + #if AXIS6_DRIVER_MODEL == SERVO_EE + ServoEE driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_SERVO_DC_PWR_MIN, AXIS6_SERVO_DC_PWR_MAX); + #elif AXIS6_DRIVER_MODEL == SERVO_PE + ServoPE driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_SERVO_DC_PWR_MIN, AXIS6_SERVO_DC_PWR_MAX); + #elif AXIS6_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc2130DC driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_SERVO_DC_PWR_MIN, AXIS6_SERVO_DC_PWR_MAX); + #elif AXIS6_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc5160DC driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_SERVO_DC_PWR_MIN, AXIS6_SERVO_DC_PWR_MAX); + #elif AXIS6_DRIVER_MODEL == TMC2209 || AXIS6_DRIVER_MODEL == TMC2226 + ServoTmc2209 driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_MOTOR_STEPS_PER_MICRON/AXIS6_STEPS_PER_MICRON, AXIS6_DRIVER_MICROSTEPS, AXIS6_DRIVER_IRUN, AXIS6_DRIVER_DECAY, AXIS6_DRIVER_DECAY_GOTO); + #elif AXIS6_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_MOTOR_STEPS_PER_MICRON/AXIS6_STEPS_PER_MICRON, AXIS6_DRIVER_MICROSTEPS, AXIS6_DRIVER_IRUN, AXIS6_DRIVER_DECAY, AXIS6_DRIVER_DECAY_GOTO); + #elif AXIS6_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver6(6, &DriverSettingsAxis6, AXIS6_MOTOR_STEPS_PER_MICRON/AXIS6_STEPS_PER_MICRON); + #endif + + ServoMotor motor_6(6, AXIS6_REVERSE, ((ServoDriver*)&driver6), &filterAxis6, &encAxis6, AXIS6_ENCODER_ORIGIN, AXIS6_ENCODER_REVERSE == ON, &feedbackAxis6, &servoControlAxis6); + + #elif defined(AXIS6_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis6 = {AXIS6_M0_PIN, AXIS6_M1_PIN, AXIS6_M2_PIN, AXIS6_M2_ON_STATE, AXIS6_M3_PIN, AXIS6_DECAY_PIN, AXIS6_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis6 = {AXIS6_DRIVER_MODEL, AXIS6_DRIVER_STATUS, AXIS6_DRIVER_MICROSTEPS, AXIS6_DRIVER_MICROSTEPS_GOTO, AXIS6_DRIVER_DECAY, AXIS6_DRIVER_DECAY_GOTO}; + #if AXIS6_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS6_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6); + #elif AXIS6_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_DRIVER_IHOLD, AXIS6_DRIVER_IRUN, AXIS6_DRIVER_IGOTO, AXIS6_DRIVER_INTPOL); + #elif AXIS6_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_DRIVER_IHOLD, AXIS6_DRIVER_IRUN, AXIS6_DRIVER_IGOTO, AXIS6_DRIVER_INTPOL); + #elif AXIS6_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_DRIVER_IHOLD, AXIS6_DRIVER_IRUN, AXIS6_DRIVER_IGOTO, AXIS6_DRIVER_INTPOL); + #elif AXIS6_DRIVER_MODEL == TMC2209 || AXIS6_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_DRIVER_IHOLD, AXIS6_DRIVER_IRUN, AXIS6_DRIVER_IGOTO, AXIS6_DRIVER_INTPOL); + #elif AXIS6_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_DRIVER_IHOLD, AXIS6_DRIVER_IRUN, AXIS6_DRIVER_IGOTO, AXIS6_DRIVER_INTPOL); + #elif AXIS6_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_DRIVER_IHOLD, AXIS6_DRIVER_IRUN, AXIS6_DRIVER_IGOTO, AXIS6_DRIVER_INTPOL); + #elif AXIS6_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver6(6, &DriverPinsAxis6, &DriverSettingsAxis6, AXIS6_DRIVER_IHOLD, AXIS6_DRIVER_IRUN, AXIS6_DRIVER_IGOTO, AXIS6_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis6 = {AXIS6_STEP_PIN, AXIS6_STEP_STATE, AXIS6_DIR_PIN, AXIS6_ENABLE_PIN, AXIS6_ENABLE_STATE}; + StepDirMotor motor_6(6, AXIS6_REVERSE, &StepDirPinsAxis6, ((StepDirDriver*)&driver6)); + #else + #error "Configuration (Config.h): Focuser has an unrecognized AXIS6_DRIVER_MODEL this should never happen!" + #endif + + const AxisPins PinsAxis6 = {AXIS6_SENSE_LIMIT_MIN_PIN, AXIS6_SENSE_HOME_PIN, AXIS6_SENSE_LIMIT_MAX_PIN, {AXIS6_SENSE_HOME, AXIS6_SENSE_HOME_INIT, AXIS6_SENSE_HOME_DIST_LIMIT*1000.0F, AXIS6_SENSE_LIMIT_MIN, AXIS6_SENSE_LIMIT_MAX, AXIS6_SENSE_LIMIT_INIT}}; + const AxisSettings SettingsAxis6 = {AXIS6_STEPS_PER_MICRON, {AXIS6_LIMIT_MIN*1000.0F, AXIS6_LIMIT_MAX*1000.0F}, AXIS6_BACKLASH_RATE}; + } + + Motor& motor6 = motor_6; + + Axis axis6(6, &PinsAxis6, &SettingsAxis6, AXIS_MEASURE_MICRONS); +#endif diff --git a/src/telescope/focuser/local/Focuser.axis7.cpp b/src/telescope/focuser/local/Focuser.axis7.cpp new file mode 100755 index 0000000..a33df53 --- /dev/null +++ b/src/telescope/focuser/local/Focuser.axis7.cpp @@ -0,0 +1,109 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control, axis7 + +#include "Focuser.h" + +// note there is a prototype file that should be copy/pasted to build files +// for axes 4 to 9 by replacing all occurances of '@' with the axis number + +#if AXIS7_DRIVER_MODEL != OFF + + namespace { + + #if defined(AXIS7_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis7 = {AXIS7_DRIVER_MODEL, AXIS7_DRIVER_STATUS}; + KTechMotor motor_7(7, AXIS7_REVERSE, &DriverSettingsAxis7); + + #elif defined(AXIS7_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis7 = {AXIS7_DRIVER_MODEL, AXIS7_DRIVER_STATUS}; + Mks42DMotor motor_7(7, AXIS7_REVERSE, &DriverSettingsAxis7, AXIS7_STEPS_PER_DEGREE); + + #elif defined(AXIS7_SERVO_PRESENT) + ServoControl servoControlAxis7; + + #if AXIS7_ENCODER == AB + Quadrature encAxis7(7, AXIS7_ENCODER_A_PIN, AXIS7_ENCODER_B_PIN); + #elif AXIS7_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis7(7, AXIS7_ENCODER_A_PIN, AXIS7_ENCODER_B_PIN); + #elif AXIS7_ENCODER == CW_CCW + CwCcw encAxis7(7, AXIS7_ENCODER_A_PIN, AXIS7_ENCODER_B_PIN); + #elif AXIS7_ENCODER == PULSE_DIR + PulseDir encAxis7(7, AXIS7_ENCODER_A_PIN, AXIS7_ENCODER_B_PIN); + #elif AXIS7_ENCODER == PULSE_ONLY + PulseOnly encAxis7(7, AXIS7_ENCODER_A_PIN, &servoControlAxis7.directionHint); + #elif AXIS7_ENCODER == VIRTUAL + VirtualEnc encAxis7(7); + #elif AXIS7_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis7(7); + #endif + + #if AXIS7_SERVO_FEEDBACK == PID + Pid feedbackAxis7(AXIS7_PID_P, AXIS7_PID_I, AXIS7_PID_D); + #elif AXIS7_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis7(AXIS7_PID_P, AXIS7_PID_I, AXIS7_PID_D, AXIS7_PID_P_GOTO, AXIS7_PID_I_GOTO, AXIS7_PID_D_GOTO, AXIS7_PID_SENSITIVITY); + #endif + + #if AXIS7_SERVO_FLTR == KALMAN + KalmanFilter filterAxis7(AXIS7_SERVO_FLTR_MEAS_U, AXIS7_SERVO_FLTR_VARIANCE); + #elif AXIS7_SERVO_FLTR == ROLLING + RollingFilter filterAxis7(AXIS7_SERVO_FLTR_WSIZE); + #elif AXIS7_SERVO_FLTR == OFF + Filter filterAxis7; + #endif + + const ServoPins DriverPinsAxis7 = {AXIS7_SERVO_PH1_PIN, AXIS7_SERVO_PH1_STATE, AXIS7_SERVO_PH2_PIN, AXIS7_SERVO_PH2_STATE, AXIS7_ENABLE_PIN, AXIS7_ENABLE_STATE, AXIS7_M0_PIN, AXIS7_M1_PIN, AXIS7_M2_PIN, AXIS7_M3_PIN, AXIS7_FAULT_PIN}; + const ServoSettings DriverSettingsAxis7 = {AXIS7_DRIVER_MODEL, AXIS7_DRIVER_STATUS, AXIS7_SERVO_ACCELERATION}; + + #if AXIS7_DRIVER_MODEL == SERVO_EE + ServoEE driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_SERVO_DC_PWR_MIN, AXIS7_SERVO_DC_PWR_MAX); + #elif AXIS7_DRIVER_MODEL == SERVO_PE + ServoPE driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_SERVO_DC_PWR_MIN, AXIS7_SERVO_DC_PWR_MAX); + #elif AXIS7_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc2130DC driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_SERVO_DC_PWR_MIN, AXIS7_SERVO_DC_PWR_MAX); + #elif AXIS7_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc5160DC driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_SERVO_DC_PWR_MIN, AXIS7_SERVO_DC_PWR_MAX); + #elif AXIS7_DRIVER_MODEL == TMC2209 || AXIS7_DRIVER_MODEL == TMC2226 + ServoTmc2209 driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_MOTOR_STEPS_PER_MICRON/AXIS7_STEPS_PER_MICRON, AXIS7_DRIVER_MICROSTEPS, AXIS7_DRIVER_IRUN, AXIS7_DRIVER_DECAY, AXIS7_DRIVER_DECAY_GOTO); + #elif AXIS7_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_MOTOR_STEPS_PER_MICRON/AXIS7_STEPS_PER_MICRON, AXIS7_DRIVER_MICROSTEPS, AXIS7_DRIVER_IRUN, AXIS7_DRIVER_DECAY, AXIS7_DRIVER_DECAY_GOTO); + #elif AXIS7_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver7(7, &DriverSettingsAxis7, AXIS7_MOTOR_STEPS_PER_MICRON/AXIS7_STEPS_PER_MICRON); + #endif + + ServoMotor motor_7(7, AXIS7_REVERSE, ((ServoDriver*)&driver7), &filterAxis7, &encAxis7, AXIS7_ENCODER_ORIGIN, AXIS7_ENCODER_REVERSE == ON, &feedbackAxis7, &servoControlAxis7); + + #elif defined(AXIS7_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis7 = {AXIS7_M0_PIN, AXIS7_M1_PIN, AXIS7_M2_PIN, AXIS7_M2_ON_STATE, AXIS7_M3_PIN, AXIS7_DECAY_PIN, AXIS7_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis7 = {AXIS7_DRIVER_MODEL, AXIS7_DRIVER_STATUS, AXIS7_DRIVER_MICROSTEPS, AXIS7_DRIVER_MICROSTEPS_GOTO, AXIS7_DRIVER_DECAY, AXIS7_DRIVER_DECAY_GOTO}; + #if AXIS7_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS7_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7); + #elif AXIS7_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_DRIVER_IHOLD, AXIS7_DRIVER_IRUN, AXIS7_DRIVER_IGOTO, AXIS7_DRIVER_INTPOL); + #elif AXIS7_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_DRIVER_IHOLD, AXIS7_DRIVER_IRUN, AXIS7_DRIVER_IGOTO, AXIS7_DRIVER_INTPOL); + #elif AXIS7_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_DRIVER_IHOLD, AXIS7_DRIVER_IRUN, AXIS7_DRIVER_IGOTO, AXIS7_DRIVER_INTPOL); + #elif AXIS7_DRIVER_MODEL == TMC2209 || AXIS7_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_DRIVER_IHOLD, AXIS7_DRIVER_IRUN, AXIS7_DRIVER_IGOTO, AXIS7_DRIVER_INTPOL); + #elif AXIS7_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_DRIVER_IHOLD, AXIS7_DRIVER_IRUN, AXIS7_DRIVER_IGOTO, AXIS7_DRIVER_INTPOL); + #elif AXIS7_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_DRIVER_IHOLD, AXIS7_DRIVER_IRUN, AXIS7_DRIVER_IGOTO, AXIS7_DRIVER_INTPOL); + #elif AXIS7_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver7(7, &DriverPinsAxis7, &DriverSettingsAxis7, AXIS7_DRIVER_IHOLD, AXIS7_DRIVER_IRUN, AXIS7_DRIVER_IGOTO, AXIS7_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis7 = {AXIS7_STEP_PIN, AXIS7_STEP_STATE, AXIS7_DIR_PIN, AXIS7_ENABLE_PIN, AXIS7_ENABLE_STATE}; + StepDirMotor motor_7(7, AXIS7_REVERSE, &StepDirPinsAxis7, ((StepDirDriver*)&driver7)); + #else + #error "Configuration (Config.h): Focuser has an unrecognized AXIS7_DRIVER_MODEL this should never happen!" + #endif + + const AxisPins PinsAxis7 = {AXIS7_SENSE_LIMIT_MIN_PIN, AXIS7_SENSE_HOME_PIN, AXIS7_SENSE_LIMIT_MAX_PIN, {AXIS7_SENSE_HOME, AXIS7_SENSE_HOME_INIT, AXIS7_SENSE_HOME_DIST_LIMIT*1000.0F, AXIS7_SENSE_LIMIT_MIN, AXIS7_SENSE_LIMIT_MAX, AXIS7_SENSE_LIMIT_INIT}}; + const AxisSettings SettingsAxis7 = {AXIS7_STEPS_PER_MICRON, {AXIS7_LIMIT_MIN*1000.0F, AXIS7_LIMIT_MAX*1000.0F}, AXIS7_BACKLASH_RATE}; + } + + Motor& motor7 = motor_7; + + Axis axis7(7, &PinsAxis7, &SettingsAxis7, AXIS_MEASURE_MICRONS); +#endif diff --git a/src/telescope/focuser/local/Focuser.axis8.cpp b/src/telescope/focuser/local/Focuser.axis8.cpp new file mode 100755 index 0000000..89433cc --- /dev/null +++ b/src/telescope/focuser/local/Focuser.axis8.cpp @@ -0,0 +1,109 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control, axis8 + +#include "Focuser.h" + +// note there is a prototype file that should be copy/pasted to build files +// for axes 4 to 9 by replacing all occurances of '@' with the axis number + +#if AXIS8_DRIVER_MODEL != OFF + + namespace { + + #if defined(AXIS8_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis8 = {AXIS8_DRIVER_MODEL, AXIS8_DRIVER_STATUS}; + KTechMotor motor_8(8, AXIS8_REVERSE, &DriverSettingsAxis8); + + #elif defined(AXIS8_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis8 = {AXIS8_DRIVER_MODEL, AXIS8_DRIVER_STATUS}; + Mks42DMotor motor_8(8, AXIS8_REVERSE, &DriverSettingsAxis8, AXIS8_STEPS_PER_DEGREE); + + #elif defined(AXIS8_SERVO_PRESENT) + ServoControl servoControlAxis8; + + #if AXIS8_ENCODER == AB + Quadrature encAxis8(8, AXIS8_ENCODER_A_PIN, AXIS8_ENCODER_B_PIN); + #elif AXIS8_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis8(8, AXIS8_ENCODER_A_PIN, AXIS8_ENCODER_B_PIN); + #elif AXIS8_ENCODER == CW_CCW + CwCcw encAxis8(8, AXIS8_ENCODER_A_PIN, AXIS8_ENCODER_B_PIN); + #elif AXIS8_ENCODER == PULSE_DIR + PulseDir encAxis8(8, AXIS8_ENCODER_A_PIN, AXIS8_ENCODER_B_PIN); + #elif AXIS8_ENCODER == PULSE_ONLY + PulseOnly encAxis8(8, AXIS8_ENCODER_A_PIN, &servoControlAxis8.directionHint); + #elif AXIS8_ENCODER == VIRTUAL + VirtualEnc encAxis8(8); + #elif AXIS8_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis8(8); + #endif + + #if AXIS8_SERVO_FEEDBACK == PID + Pid feedbackAxis8(AXIS8_PID_P, AXIS8_PID_I, AXIS8_PID_D); + #elif AXIS8_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis8(AXIS8_PID_P, AXIS8_PID_I, AXIS8_PID_D, AXIS8_PID_P_GOTO, AXIS8_PID_I_GOTO, AXIS8_PID_D_GOTO, AXIS8_PID_SENSITIVITY); + #endif + + #if AXIS8_SERVO_FLTR == KALMAN + KalmanFilter filterAxis8(AXIS8_SERVO_FLTR_MEAS_U, AXIS8_SERVO_FLTR_VARIANCE); + #elif AXIS8_SERVO_FLTR == ROLLING + RollingFilter filterAxis8(AXIS8_SERVO_FLTR_WSIZE); + #elif AXIS8_SERVO_FLTR == OFF + Filter filterAxis8; + #endif + + const ServoPins DriverPinsAxis8 = {AXIS8_SERVO_PH1_PIN, AXIS8_SERVO_PH1_STATE, AXIS8_SERVO_PH2_PIN, AXIS8_SERVO_PH2_STATE, AXIS8_ENABLE_PIN, AXIS8_ENABLE_STATE, AXIS8_M0_PIN, AXIS8_M1_PIN, AXIS8_M2_PIN, AXIS8_M3_PIN, AXIS8_FAULT_PIN}; + const ServoSettings DriverSettingsAxis8 = {AXIS8_DRIVER_MODEL, AXIS8_DRIVER_STATUS, AXIS8_SERVO_ACCELERATION}; + + #if AXIS8_DRIVER_MODEL == SERVO_EE + ServoEE driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_SERVO_DC_PWR_MIN, AXIS8_SERVO_DC_PWR_MAX); + #elif AXIS8_DRIVER_MODEL == SERVO_PE + ServoPE driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_SERVO_DC_PWR_MIN, AXIS8_SERVO_DC_PWR_MAX); + #elif AXIS8_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc2130DC driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_SERVO_DC_PWR_MIN, AXIS8_SERVO_DC_PWR_MAX); + #elif AXIS8_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc5160DC driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_SERVO_DC_PWR_MIN, AXIS8_SERVO_DC_PWR_MAX); + #elif AXIS8_DRIVER_MODEL == TMC2209 || AXIS8_DRIVER_MODEL == TMC2226 + ServoTmc2209 driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_MOTOR_STEPS_PER_MICRON/AXIS8_STEPS_PER_MICRON, AXIS8_DRIVER_MICROSTEPS, AXIS8_DRIVER_IRUN, AXIS8_DRIVER_DECAY, AXIS8_DRIVER_DECAY_GOTO); + #elif AXIS8_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_MOTOR_STEPS_PER_MICRON/AXIS8_STEPS_PER_MICRON, AXIS8_DRIVER_MICROSTEPS, AXIS8_DRIVER_IRUN, AXIS8_DRIVER_DECAY, AXIS8_DRIVER_DECAY_GOTO); + #elif AXIS8_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver8(8, &DriverSettingsAxis8, AXIS8_MOTOR_STEPS_PER_MICRON/AXIS8_STEPS_PER_MICRON); + #endif + + ServoMotor motor_8(8, AXIS8_REVERSE, ((ServoDriver*)&driver8), &filterAxis8, &encAxis8, AXIS8_ENCODER_ORIGIN, AXIS8_ENCODER_REVERSE == ON, &feedbackAxis8, &servoControlAxis8); + + #elif defined(AXIS8_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis8 = {AXIS8_M0_PIN, AXIS8_M1_PIN, AXIS8_M2_PIN, AXIS8_M2_ON_STATE, AXIS8_M3_PIN, AXIS8_DECAY_PIN, AXIS8_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis8 = {AXIS8_DRIVER_MODEL, AXIS8_DRIVER_STATUS, AXIS8_DRIVER_MICROSTEPS, AXIS8_DRIVER_MICROSTEPS_GOTO, AXIS8_DRIVER_DECAY, AXIS8_DRIVER_DECAY_GOTO}; + #if AXIS8_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS8_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8); + #elif AXIS8_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_DRIVER_IHOLD, AXIS8_DRIVER_IRUN, AXIS8_DRIVER_IGOTO, AXIS8_DRIVER_INTPOL); + #elif AXIS8_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_DRIVER_IHOLD, AXIS8_DRIVER_IRUN, AXIS8_DRIVER_IGOTO, AXIS8_DRIVER_INTPOL); + #elif AXIS8_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_DRIVER_IHOLD, AXIS8_DRIVER_IRUN, AXIS8_DRIVER_IGOTO, AXIS8_DRIVER_INTPOL); + #elif AXIS8_DRIVER_MODEL == TMC2209 || AXIS8_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_DRIVER_IHOLD, AXIS8_DRIVER_IRUN, AXIS8_DRIVER_IGOTO, AXIS8_DRIVER_INTPOL); + #elif AXIS8_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_DRIVER_IHOLD, AXIS8_DRIVER_IRUN, AXIS8_DRIVER_IGOTO, AXIS8_DRIVER_INTPOL); + #elif AXIS8_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_DRIVER_IHOLD, AXIS8_DRIVER_IRUN, AXIS8_DRIVER_IGOTO, AXIS8_DRIVER_INTPOL); + #elif AXIS8_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver8(8, &DriverPinsAxis8, &DriverSettingsAxis8, AXIS8_DRIVER_IHOLD, AXIS8_DRIVER_IRUN, AXIS8_DRIVER_IGOTO, AXIS8_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis8 = {AXIS8_STEP_PIN, AXIS8_STEP_STATE, AXIS8_DIR_PIN, AXIS8_ENABLE_PIN, AXIS8_ENABLE_STATE}; + StepDirMotor motor_8(8, AXIS8_REVERSE, &StepDirPinsAxis8, ((StepDirDriver*)&driver8)); + #else + #error "Configuration (Config.h): Focuser has an unrecognized AXIS8_DRIVER_MODEL this should never happen!" + #endif + + const AxisPins PinsAxis8 = {AXIS8_SENSE_LIMIT_MIN_PIN, AXIS8_SENSE_HOME_PIN, AXIS8_SENSE_LIMIT_MAX_PIN, {AXIS8_SENSE_HOME, AXIS8_SENSE_HOME_INIT, AXIS8_SENSE_HOME_DIST_LIMIT*1000.0F, AXIS8_SENSE_LIMIT_MIN, AXIS8_SENSE_LIMIT_MAX, AXIS8_SENSE_LIMIT_INIT}}; + const AxisSettings SettingsAxis8 = {AXIS8_STEPS_PER_MICRON, {AXIS8_LIMIT_MIN*1000.0F, AXIS8_LIMIT_MAX*1000.0F}, AXIS8_BACKLASH_RATE}; + } + + Motor& motor8 = motor_8; + + Axis axis8(8, &PinsAxis8, &SettingsAxis8, AXIS_MEASURE_MICRONS); +#endif diff --git a/src/telescope/focuser/local/Focuser.axis9.cpp b/src/telescope/focuser/local/Focuser.axis9.cpp new file mode 100755 index 0000000..991ba07 --- /dev/null +++ b/src/telescope/focuser/local/Focuser.axis9.cpp @@ -0,0 +1,109 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control, axis9 + +#include "Focuser.h" + +// note there is a prototype file that should be copy/pasted to build files +// for axes 4 to 9 by replacing all occurances of '@' with the axis number + +#if AXIS9_DRIVER_MODEL != OFF + + namespace { + + #if defined(AXIS9_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis9 = {AXIS9_DRIVER_MODEL, AXIS9_DRIVER_STATUS}; + KTechMotor motor_9(9, AXIS9_REVERSE, &DriverSettingsAxis9); + + #elif defined(AXIS9_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis9 = {AXIS9_DRIVER_MODEL, AXIS9_DRIVER_STATUS}; + Mks42DMotor motor_9(9, AXIS9_REVERSE, &DriverSettingsAxis9, AXIS9_STEPS_PER_DEGREE); + + #elif defined(AXIS9_SERVO_PRESENT) + ServoControl servoControlAxis9; + + #if AXIS9_ENCODER == AB + Quadrature encAxis9(9, AXIS9_ENCODER_A_PIN, AXIS9_ENCODER_B_PIN); + #elif AXIS9_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis9(9, AXIS9_ENCODER_A_PIN, AXIS9_ENCODER_B_PIN); + #elif AXIS9_ENCODER == CW_CCW + CwCcw encAxis9(9, AXIS9_ENCODER_A_PIN, AXIS9_ENCODER_B_PIN); + #elif AXIS9_ENCODER == PULSE_DIR + PulseDir encAxis9(9, AXIS9_ENCODER_A_PIN, AXIS9_ENCODER_B_PIN); + #elif AXIS9_ENCODER == PULSE_ONLY + PulseOnly encAxis9(9, AXIS9_ENCODER_A_PIN, &servoControlAxis9.directionHint); + #elif AXIS9_ENCODER == VIRTUAL + VirtualEnc encAxis9(9); + #elif AXIS9_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis9(9); + #endif + + #if AXIS9_SERVO_FEEDBACK == PID + Pid feedbackAxis9(AXIS9_PID_P, AXIS9_PID_I, AXIS9_PID_D); + #elif AXIS9_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis9(AXIS9_PID_P, AXIS9_PID_I, AXIS9_PID_D, AXIS9_PID_P_GOTO, AXIS9_PID_I_GOTO, AXIS9_PID_D_GOTO, AXIS9_PID_SENSITIVITY); + #endif + + #if AXIS9_SERVO_FLTR == KALMAN + KalmanFilter filterAxis9(AXIS9_SERVO_FLTR_MEAS_U, AXIS9_SERVO_FLTR_VARIANCE); + #elif AXIS9_SERVO_FLTR == ROLLING + RollingFilter filterAxis9(AXIS9_SERVO_FLTR_WSIZE); + #elif AXIS9_SERVO_FLTR == OFF + Filter filterAxis9; + #endif + + const ServoPins DriverPinsAxis9 = {AXIS9_SERVO_PH1_PIN, AXIS9_SERVO_PH1_STATE, AXIS9_SERVO_PH2_PIN, AXIS9_SERVO_PH2_STATE, AXIS9_ENABLE_PIN, AXIS9_ENABLE_STATE, AXIS9_M0_PIN, AXIS9_M1_PIN, AXIS9_M2_PIN, AXIS9_M3_PIN, AXIS9_FAULT_PIN}; + const ServoSettings DriverSettingsAxis9 = {AXIS9_DRIVER_MODEL, AXIS9_DRIVER_STATUS, AXIS9_SERVO_ACCELERATION}; + + #if AXIS9_DRIVER_MODEL == SERVO_EE + ServoEE driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_SERVO_DC_PWR_MIN, AXIS9_SERVO_DC_PWR_MAX); + #elif AXIS9_DRIVER_MODEL == SERVO_PE + ServoPE driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_SERVO_DC_PWR_MIN, AXIS9_SERVO_DC_PWR_MAX); + #elif AXIS9_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc2130DC driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_SERVO_DC_PWR_MIN, AXIS9_SERVO_DC_PWR_MAX); + #elif AXIS9_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc5160DC driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_SERVO_DC_PWR_MIN, AXIS9_SERVO_DC_PWR_MAX); + #elif AXIS9_DRIVER_MODEL == TMC2209 || AXIS9_DRIVER_MODEL == TMC2226 + ServoTmc2209 driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_MOTOR_STEPS_PER_MICRON/AXIS9_STEPS_PER_MICRON, AXIS9_DRIVER_MICROSTEPS, AXIS9_DRIVER_IRUN, AXIS9_DRIVER_DECAY, AXIS9_DRIVER_DECAY_GOTO); + #elif AXIS9_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_MOTOR_STEPS_PER_MICRON/AXIS9_STEPS_PER_MICRON, AXIS9_DRIVER_MICROSTEPS, AXIS9_DRIVER_IRUN, AXIS9_DRIVER_DECAY, AXIS9_DRIVER_DECAY_GOTO); + #elif AXIS9_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver9(9, &DriverSettingsAxis9, AXIS9_MOTOR_STEPS_PER_MICRON/AXIS9_STEPS_PER_MICRON); + #endif + + ServoMotor motor_9(9, AXIS9_REVERSE, ((ServoDriver*)&driver9), &filterAxis9, &encAxis9, AXIS9_ENCODER_ORIGIN, AXIS9_ENCODER_REVERSE == ON, &feedbackAxis9, &servoControlAxis9); + + #elif defined(AXIS9_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis9 = {AXIS9_M0_PIN, AXIS9_M1_PIN, AXIS9_M2_PIN, AXIS9_M2_ON_STATE, AXIS9_M3_PIN, AXIS9_DECAY_PIN, AXIS9_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis9 = {AXIS9_DRIVER_MODEL, AXIS9_DRIVER_STATUS, AXIS9_DRIVER_MICROSTEPS, AXIS9_DRIVER_MICROSTEPS_GOTO, AXIS9_DRIVER_DECAY, AXIS9_DRIVER_DECAY_GOTO}; + #if AXIS9_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS9_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9); + #elif AXIS9_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_DRIVER_IHOLD, AXIS9_DRIVER_IRUN, AXIS9_DRIVER_IGOTO, AXIS9_DRIVER_INTPOL); + #elif AXIS9_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_DRIVER_IHOLD, AXIS9_DRIVER_IRUN, AXIS9_DRIVER_IGOTO, AXIS9_DRIVER_INTPOL); + #elif AXIS9_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_DRIVER_IHOLD, AXIS9_DRIVER_IRUN, AXIS9_DRIVER_IGOTO, AXIS9_DRIVER_INTPOL); + #elif AXIS9_DRIVER_MODEL == TMC2209 || AXIS9_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_DRIVER_IHOLD, AXIS9_DRIVER_IRUN, AXIS9_DRIVER_IGOTO, AXIS9_DRIVER_INTPOL); + #elif AXIS9_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_DRIVER_IHOLD, AXIS9_DRIVER_IRUN, AXIS9_DRIVER_IGOTO, AXIS9_DRIVER_INTPOL); + #elif AXIS9_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_DRIVER_IHOLD, AXIS9_DRIVER_IRUN, AXIS9_DRIVER_IGOTO, AXIS9_DRIVER_INTPOL); + #elif AXIS9_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver9(9, &DriverPinsAxis9, &DriverSettingsAxis9, AXIS9_DRIVER_IHOLD, AXIS9_DRIVER_IRUN, AXIS9_DRIVER_IGOTO, AXIS9_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis9 = {AXIS9_STEP_PIN, AXIS9_STEP_STATE, AXIS9_DIR_PIN, AXIS9_ENABLE_PIN, AXIS9_ENABLE_STATE}; + StepDirMotor motor_9(9, AXIS9_REVERSE, &StepDirPinsAxis9, ((StepDirDriver*)&driver9)); + #else + #error "Configuration (Config.h): Focuser has an unrecognized AXIS9_DRIVER_MODEL this should never happen!" + #endif + + const AxisPins PinsAxis9 = {AXIS9_SENSE_LIMIT_MIN_PIN, AXIS9_SENSE_HOME_PIN, AXIS9_SENSE_LIMIT_MAX_PIN, {AXIS9_SENSE_HOME, AXIS9_SENSE_HOME_INIT, AXIS9_SENSE_HOME_DIST_LIMIT*1000.0F, AXIS9_SENSE_LIMIT_MIN, AXIS9_SENSE_LIMIT_MAX, AXIS9_SENSE_LIMIT_INIT}}; + const AxisSettings SettingsAxis9 = {AXIS9_STEPS_PER_MICRON, {AXIS9_LIMIT_MIN*1000.0F, AXIS9_LIMIT_MAX*1000.0F}, AXIS9_BACKLASH_RATE}; + } + + Motor& motor9 = motor_9; + + Axis axis9(9, &PinsAxis9, &SettingsAxis9, AXIS_MEASURE_MICRONS); +#endif diff --git a/src/telescope/focuser/local/Focuser.can.command.cpp b/src/telescope/focuser/local/Focuser.can.command.cpp new file mode 100755 index 0000000..92ebbc9 --- /dev/null +++ b/src/telescope/focuser/local/Focuser.can.command.cpp @@ -0,0 +1,272 @@ +//-------------------------------------------------------------------------------------------------- +// local telescope focuser control, CAN server (remote node) + +#include "Focuser.h" + +#ifdef FOCUSER_CAN_SERVER_PRESENT + +#include "../../../lib/axis/Axis.h" + +extern Axis axis4; +#define FOCUSER_CAN_INDEX 0 // for the first focuser at axis 4 + +// default command semantics (mirrors the common command contract): +// handled=true, numericReply=true, suppressFrame=false, commandError=CE_NONE +// numericReply=true means boolean/numeric-style responses (e.g., CE_1/CE_0/errors) rather than a payload +void Focuser::processCommand() { + if (!ready) return; + + bool handled = true; + bool numericReply = true; + bool suppressFrame = false; + CommandError commandError = CE_NONE; + + // scratchpad variables + CommandError e = CE_NONE; + float f; + int32_t i; + uint8_t u; + + // ctrl byte: focuser number + units bit (1=microns, 0=steps) + uint8_t ctrl; + if (!readU8(ctrl)) ctrl = 0; + const uint8_t FocuserNumber = (uint8_t)(ctrl & FOC_CTRL_FOCUSER_MASK); // 1..6 + const bool UseMicrons = (ctrl & FOC_CTRL_UNIT_MICRONS) != 0; + + // Gate: make sure we're ready and only answer requests meant for this node + if (!ready || FocuserNumber != (uint8_t)CAN_FOCUSER_NUMBER) return; + + // Unit conversions (apply ONLY to I/M/G/R/S/B/D) + const float MicronsToSteps = axis4.getStepsPerMeasure(); // steps per micron + const float StepsToMicrons = MicronsToSteps != 0.0F ? (1.0F / MicronsToSteps) : 0.0F; + float MicronsToUnits = 1.0F; + float StepsToUnits = StepsToMicrons; + float UnitsToSteps = MicronsToSteps; + if (UseMicrons) { + MicronsToUnits = MicronsToSteps; + StepsToUnits = 1.0F; + UnitsToSteps = 1.0F; + } + + switch (opCode()) { + + // :hP# -> numeric 1/0 + case FOC_OP_PARK_HP: + e = park(FOCUSER_CAN_INDEX); + commandError = (e == CE_NONE) ? CE_1 : e; + break; + + // :hR# -> numeric 1/0 + case FOC_OP_UNPARK_HR: + e = unpark(FOCUSER_CAN_INDEX); + commandError = (e == CE_NONE) ? CE_1 : e; + break; + + // :FT# -> "M"/"S" + rateDigit (ASCII) + case FOC_OP_GET_STATUS_T: + writeU8(axis4.isSlewing() ? (uint8_t)'M' : (uint8_t)'S'); + writeU8((uint8_t)('0' + getGotoRate(FOCUSER_CAN_INDEX))); + numericReply = false; + break; + + // :Fp# -> status-only boolean (matches local: CE_0 if not DC) + case FOC_OP_GET_MODE_p: + if (!isDC(FOCUSER_CAN_INDEX)) commandError = CE_0; // numeric 0/1 synthesized by caller + // numericReply stays true, no payload + break; + + // :FI# -> i32 units + case FOC_OP_GET_MIN_I: + writeI32(axis4.getLimitMin()*MicronsToUnits); + numericReply = false; + break; + + // :FM# -> i32 units + case FOC_OP_GET_MAX_M: + writeI32(axis4.getLimitMax()*MicronsToUnits); + numericReply = false; + break; + + // :Fe# -> f32 (deg C) + case FOC_OP_GET_TEMPDIFF_e: + // Local behavior: if TCF disabled, diff = 0 + writeF32(getTcfEnable(FOCUSER_CAN_INDEX) ? (getTemperature() - getTcfT0(FOCUSER_CAN_INDEX)) : 0.0F); + numericReply = false; + break; + + // :Ft# -> f32 (deg C) + case FOC_OP_GET_TEMP_t: + writeF32(getTemperature()); + numericReply = false; + break; + + // :Fu# -> f32 (microns per step) + case FOC_OP_GET_UM_PER_STEP_u: + writeF32((MicronsToSteps != 0.0F) ? (1.0F/MicronsToSteps) : 0.0F); + numericReply = false; + break; + + // :FB# (get) or :FB[n]# (set) -> values in units (microns or steps) + case FOC_OP_BACKLASH_B: + if (remaining() == 0) { + writeI32(getBacklashSteps(FOCUSER_CAN_INDEX)*StepsToUnits); + numericReply = false; + } else { + if (!readI32(i)) { commandError = CE_PARAM_FORM; break; } + const long vSteps = (long)i*UnitsToSteps; + CommandError e = setBacklashSteps(FOCUSER_CAN_INDEX, vSteps); + commandError = (e == CE_NONE) ? CE_1 : e; + } + break; + + // :FC# (get f32) or :FC[sn.n]# (set f32) + case FOC_OP_TCF_COEF_C: + if (remaining() == 0) { + writeF32(getTcfCoef(FOCUSER_CAN_INDEX)); + numericReply = false; + } else { + if (!readF32(f)) { commandError = CE_PARAM_FORM; break; } + if (!setTcfCoef(FOCUSER_CAN_INDEX, f)) commandError = CE_PARAM_RANGE; + } + break; + + // :Fc# (get) or :Fc[n]# (set) -> status-only boolean (matches local) + case FOC_OP_TCF_ENABLE_c: + if (remaining() == 0) { + if (!getTcfEnable(FOCUSER_CAN_INDEX)) commandError = CE_0; // disabled => "0" + } else { + if (!readU8(u)) { commandError = CE_PARAM_FORM; break; } + commandError = setTcfEnable(FOCUSER_CAN_INDEX, u != 0); + } + break; + + // :FD# (get) or :FD[n]# (set) -> values in units + case FOC_OP_TCF_DEADBAND_D: + if (remaining() == 0) { + writeI32(getTcfDeadband(FOCUSER_CAN_INDEX)*StepsToUnits); + numericReply = false; + } else { + if (!readI32(i)) { commandError = CE_PARAM_FORM; break; } + if (!setTcfDeadband(FOCUSER_CAN_INDEX, i*UnitsToSteps)) commandError = CE_PARAM_RANGE; + } + break; + + // :FP# (get) or :FP[n]# (set) -> u8 percent (no unit-bit conversion) + case FOC_OP_DC_POWER_P: + if (!isDC(FOCUSER_CAN_INDEX)) { commandError = CE_CMD_UNKNOWN; break; } + if (remaining() == 0) { + writeU8(getDcPower(FOCUSER_CAN_INDEX)); + numericReply = false; + } else { + if (!readU8(u)) { commandError = CE_PARAM_FORM; break; } + if (!setDcPower(FOCUSER_CAN_INDEX, u)) commandError = CE_PARAM_RANGE; + } + break; + + // :FQ# -> no reply text + case FOC_OP_STOP_Q: + if (axis4.isHoming()) { + axis4.autoSlewAbort(); + homing[FOCUSER_CAN_INDEX] = true; + } else + axis4.autoSlewStop(); + numericReply = false; + break; + + // :F[1..9]# -> no reply text + case FOC_OP_SET_RATE_1_9: + if (!readU8(u)) { commandError = CE_PARAM_FORM; break; } + if (u < 1 || u > 9) { commandError = CE_PARAM_RANGE; break; } + if (u < 5) setMoveRate(FOCUSER_CAN_INDEX, (int)u); else setGotoRate(FOCUSER_CAN_INDEX, (int)u - 4); + numericReply = false; + break; + + // :FW# -> i32 µm/s (NO unit-bit conversion per your clarification) + case FOC_OP_GET_WORKRATE_W: + writeI32(settings[FOCUSER_CAN_INDEX].gotoRate); + numericReply = false; + break; + + // :F+# / :F-# -> no reply text + case FOC_OP_MOVE_IN_PLUS: + commandError = move(FOCUSER_CAN_INDEX, DIR_FORWARD); + numericReply = false; + break; + + case FOC_OP_MOVE_OUT_MINUS: + commandError = move(FOCUSER_CAN_INDEX, DIR_REVERSE); + numericReply = false; + break; + + // :FG# -> i32 units (position) + case FOC_OP_GET_POS_G: + // Mirror local: (instrumentSteps - tcfSteps) converted to units + i = (int32_t)(axis4.getInstrumentCoordinateSteps() - tcfSteps[FOCUSER_CAN_INDEX]); + writeI32(i*StepsToUnits); + numericReply = false; + break; + + // :FR[sn]# -> no reply text (relative) + case FOC_OP_GOTO_REL_R: + if (!readI32(i)) { commandError = CE_PARAM_FORM; break; } + commandError = gotoTarget(FOCUSER_CAN_INDEX, target[FOCUSER_CAN_INDEX] + i*UnitsToSteps); + numericReply = false; + break; + + // :FS[n]# -> numeric 1/0 (absolute) + case FOC_OP_GOTO_ABS_S: + if (!readI32(i)) { commandError = CE_PARAM_FORM; break; } + commandError = gotoTarget(FOCUSER_CAN_INDEX, i*UnitsToSteps); + // numericReply stays true to match local :FS behavior + break; + + // :FZ# -> no reply text + case FOC_OP_ZERO_Z: + commandError = resetTarget(FOCUSER_CAN_INDEX, 0); + numericReply = false; + break; + + // :FH# -> no reply text (set home) + case FOC_OP_SET_HOME_H: + commandError = resetTarget(FOCUSER_CAN_INDEX, lround(getHomePosition(FOCUSER_CAN_INDEX)*MicronsToSteps)); + numericReply = false; + break; + + // :Fh# -> no reply text (goto home) + case FOC_OP_GOTO_HOME_h: + if (axis4.hasHomeSense()) + commandError = moveHome(FOCUSER_CAN_INDEX); + else + commandError = gotoTarget(FOCUSER_CAN_INDEX, lround(getHomePosition(FOCUSER_CAN_INDEX)*MicronsToSteps)); + numericReply = false; + break; + + // :GXU[n]# + case FOC_OP_DRIVER_STATUS: { + DriverStatus status = axis4.motor->getDriverStatus(); + + if (status.active) { + uint8_t packedStatus = 0; + packedStatus |= (status.standstill ? 1: 0); + packedStatus |= (status.outputA.openLoad ? 1 : 0) << 1; + packedStatus |= (status.outputB.openLoad ? 1 : 0) << 2; + packedStatus |= (status.outputA.shortToGround ? 1 : 0) << 3; + packedStatus |= (status.outputB.shortToGround ? 1 : 0) << 4; + packedStatus |= (status.overTemperature ? 1 : 0) << 5; + packedStatus |= (status.overTemperatureWarning ? 1 : 0) << 6; + packedStatus |= (status.fault ? 1 : 0) << 7; + writeU8(packedStatus); + numericReply = false; + } else commandError = CE_0; + } break; + + default: + handled = false; + commandError = CE_CMD_UNKNOWN; + break; + } + + sendResponse(handled, suppressFrame, numericReply, commandError); +} + +#endif diff --git a/src/telescope/focuser/local/Focuser.command.cpp b/src/telescope/focuser/local/Focuser.command.cpp new file mode 100755 index 0000000..1705f8d --- /dev/null +++ b/src/telescope/focuser/local/Focuser.command.cpp @@ -0,0 +1,341 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control, commands + +#include "Focuser.h" + +#ifdef FOCUSER_PRESENT + +#include "../../../lib/convert/Convert.h" +#include "../../../lib/axis/Axis.h" + +extern Axis *axes[6]; + +// by default reply[80] == "", suppressFrame == false, numericReply == true, and commandError == CE_NONE +// return true if the command has been completely handled and no further command() will be called, or false if not +// for commands that are handled repeatedly commandError might contain CE_NONE or CE_1 to indicate success +// numericReply=true means boolean/numeric-style responses (e.g., CE_1/CE_0/errors) rather than a payload +bool Focuser::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + if (!ready) return false; + + static int index = 0; + + // process any focuser axis commands + for (int index = 0; index < FOCUSER_MAX; index++) { + if (axes[index] != NULL) { + if (axes[index]->command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + } + } + + if (command[0] == 'h') { + // :hP# Moves focuser(s) to the park position + // Return: 0 on failure + // 1 on success + if (command[1] == 'P' && parameter[0] == 0) { + CommandError e = CE_NONE; + for (int index = 0; index < FOCUSER_MAX; index++) { + CommandError e1 = park(index); + if (e1 != CE_NONE) e = e1; + } + if (e == CE_NONE) *commandError = CE_1; else { VF("MSG: Focusers, park error "); VL(e); *commandError = e; } + return false; + } else + + // :hR# Restore parked focuser(s) to operation + // Return: 0 on failure + // 1 on success + if (command[1] == 'R' && parameter[0] == 0) { + CommandError e = CE_NONE; + for (int index = 0; index < FOCUSER_MAX; index++) { + CommandError e1 = unpark(index); + if (e1 != CE_NONE) e = e1; + } + if (e == CE_NONE) *commandError = CE_1; else { VF("MSG: Focusers, unpark error "); VL(e); *commandError = e; } + return false; + } else return false; + } else + + if (command[0] == 'F' && command[1] == 'A') { + // :FA# Focuser Active? + // Return: 0 on failure (no focusers) + // 1 to 6 on success + if (parameter[0] == 0) { + if (active < 0 || axes[active] == NULL) { *commandError = CE_0; return true; } + sprintf(reply, "%d", active + 1); + *numericReply = false; + *suppressFrame = true; + } else + + // :FA[n]# Select focuser where [n] = 1 to 6 + // Return: 0 on failure + // 1 on success + if (parameter[1] == 0) { + int i = parameter[0] - '1'; + if (i >= 0 && i < FOCUSER_MAX && axes[i] != NULL) active = i; else *commandError = CE_PARAM_RANGE; + } else return false; + } else + + // :F[...]# Use selected focuser (defaults to the first focuser) + // :F1[...]# Focuser #1 (Axis4) + // :F2[...]# Focuser #2 (Axis5) + // :F3[...]# Focuser #3 (Axis6) + // :F4[...]# Focuser #4 (Axis7) + // :F5[...]# Focuser #5 (Axis8) + // :F6[...]# Focuser #6 (Axis9) + if (command[0] == 'F') { + + // check that the requested focuser is active + int i = command[1] - '1'; + if (i >= 0 && i < 6 && parameter[0] != 0) { + // if not active return false so other focuser devices may process the command + if (axes[i] == NULL) return false; + index = i; + command[1] = parameter[0]; + char temp[32]; + strcpy(temp, ¶meter[1]); + strcpy(¶meter[0], temp); + } else index = active; + + // check for no default focuser + if (index < 0) { *commandError = CE_CMD_UNKNOWN; return true; } + + // check for commands that shouldn't have a parameter + if (strchr("aTpIMtuQF1234+-GZHh", command[1]) && parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + + // get ready for commands that convert to microns or steps (these commands are upper-case for microns OR lower-case for steps) + const float MicronsToSteps = axes[index]->getStepsPerMeasure(); + const float StepsToMicrons = MicronsToSteps != 0.0F ? (1.0F / MicronsToSteps) : 0.0F; + float MicronsToUnits = 1.0F; + float StepsToUnits = StepsToMicrons; + float UnitsToSteps = MicronsToSteps; + if (strchr("bdgimrs", command[1])) { + MicronsToUnits = MicronsToSteps; + StepsToUnits = 1.0F; + UnitsToSteps = 1.0F; + } + + // :Fa# Get primary focuser + // Returns: 1 true if active + if (command[1] == 'a') { + // always return true + } else + + // :FT# Get status + // Returns: s# + if (command[1] == 'T') { + if (axes[index]->isSlewing()) strcpy(reply,"M"); else strcpy(reply,"S"); // [M] for moving or [S] for stopped + char temp[2] = "0"; + temp[0] = '0' + getGotoRate(index); + strcat(reply, temp); // [1] to [5] for 0.5x to 2x goto rate + *numericReply = false; + } else + + // :Fp# Get mode + // Return: 0 for absolute + // 1 for pseudo absolute + if (command[1] == 'p') { + if (!isDC(index)) *commandError = CE_0; + } else + + // :FI# Get full in position (in microns or steps) + // Returns: n# + if (toupper(command[1]) == 'I') { + sprintf(reply, "%ld", lround(axes[index]->getLimitMin()*MicronsToUnits)); + *numericReply = false; + } else + + // :FM# Get max position (in microns or steps) + // Returns: n# + if (toupper(command[1]) == 'M') { + sprintf(reply, "%ld", lround(axes[index]->getLimitMax()*MicronsToUnits)); + *numericReply = false; + } else + + // :Fe# Get focuser temperature differential + // Returns: n# temperature in deg. C + if (command[1] == 'e') { + if (getTcfEnable(index)) sprintF(reply, "%3.1f", getTemperature() - getTcfT0(index)); else sprintF(reply, "%3.1f", 0.0); + *numericReply = false; + } else + + // :Ft# Get focuser temperature + // Returns: n# temperature in deg. C + if (command[1] == 't') { + sprintF(reply, "%3.1f", getTemperature()); + *numericReply = false; + } else + + // :Fu# Get focuser microns per step + // Returns: n.n# + if (command[1] == 'u') { + sprintF(reply, "%7.5f", (MicronsToSteps != 0.0F) ? (1.0F/MicronsToSteps) : 0.0F); + *numericReply = false; + } else + + // :FB# Get focuser backlash amount (in steps or microns) + // Return: n# + if (toupper(command[1]) == 'B' && parameter[0] == 0) { + sprintf(reply, "%ld", lround(getBacklashSteps(index)*StepsToUnits)); + *numericReply = false; + } else + + // :FB[n]# Set focuser backlash amount (in steps or microns) + // Return: 0 on failure + // 1 on success + if (toupper(command[1]) == 'B') { + *commandError = setBacklashSteps(index, lround(atol(parameter)*UnitsToSteps)); + } else + + // :FC# Get focuser temperature compensation coefficient in microns per °C) + // Return: n.n# + if (command[1] == 'C' && parameter[0] == 0) { + sprintF(reply, "%7.5f", getTcfCoef(index)); + *numericReply = false; + } else + + // :FC[sn.n]# Set focuser temperature compensation coefficient in microns per °C (+ moves out as temperature falls) + // Return: 0 on failure + // 1 on success + if (command[1] == 'C') { + float value = atof(parameter); + if (!setTcfCoef(index, value)) *commandError = CE_PARAM_RANGE; + } else + + // :Fc# Get focuser temperature compensation enable status + // Return: 0 if disabled + // 1 if enabled + if (command[1] == 'c' && parameter[0] == 0) { + if (!getTcfEnable(index)) *commandError = CE_0; + } else + + // :Fc[n]# Enable/disable focuser temperature compensation where [n] = 0 or 1 + // Return: 0 on failure + // 1 on success + if (command[1] == 'c' && parameter[1] == 0) { + *commandError = setTcfEnable(index, parameter[0] != '0'); + } else + + // :FD# Get focuser temperature compensation deadband amount (in steps or microns) + // Return: n# + if (toupper(command[1]) == 'D' && parameter[0] == 0) { + sprintf(reply, "%ld", lround(getTcfDeadband(index)*StepsToUnits)); + *numericReply = false; + } else + + // :FD[n]# Set focuser temperature compensation deadband amount (in steps or microns) + // Return: 0 on failure + // 1 on success + if (toupper(command[1]) == 'D') { + if (!setTcfDeadband(index, lround(atol(parameter)*UnitsToSteps))) *commandError = CE_PARAM_RANGE; + } else + + // :FP# Get focuser DC Motor Power Level (in %) + // Returns: n# + // :FP[n]# Set focuser DC Motor Power Level (in %) + // Return: 0 on failure + // 1 on success + if (command[1] == 'P') { + if (isDC(index)) { + if (parameter[0] == 0) { + sprintf(reply, "%d",(int)getDcPower(index)); *numericReply = false; + } else { + if (!setDcPower(index, atol(parameter))) *commandError = CE_PARAM_RANGE; + } + } else *commandError = CE_CMD_UNKNOWN; + } else + + // :FQ# Stop the focuser + // Returns: Nothing + if (command[1] == 'Q') { + if (axes[index]->isHoming()) { + axes[index]->autoSlewAbort(); + homing[index] = true; + } else axes[index]->autoSlewStop(); + *numericReply = false; + } else + + // :F[n]# Set focuser move or goto rate + // move rate where n = 1 for 1um/sec, 2 for 10um/sec, 3 for 100um/sec, 4 for 0.5x goto rate + // goto rate where n = 5 for 0.5x, 6 for 0.66x, 7 for 1x, 8 for 1.5x, 9 for 2x AXISn_SLEW_RATE_BASE_DESIRED + // Returns: Nothing + if (command[1] >= '1' && command[1] <= '9') { + if (strlen(parameter) == 0) { + int v = command[1] - '0'; + if (v < 5) setMoveRate(index, v); else setGotoRate(index, v - 4); + } else *commandError = CE_PARAM_FORM; + *numericReply = false; + } else + + // :FW# Get focuser working slew rate + // goto rate in um/s + // Returns: n# + if (command[1] == 'W') { + sprintf(reply, "%d", settings[index].gotoRate); + *numericReply = false; + } else + + // :F+# Move focuser in (toward objective) + // Returns: Nothing + if (command[1] == '+') { + *commandError = move(index, DIR_FORWARD); + *numericReply = false; + } else + + // :F-# Move focuser out (away from objective) + // Returns: Nothing + if (command[1] == '-') { + *commandError = move(index, DIR_REVERSE); + *numericReply = false; + } else + + // :FG# Get focuser current position (in microns or steps) + // Returns: sn# + if (toupper(command[1]) == 'G') { + sprintf(reply, "%ld", lround((axes[index]->getInstrumentCoordinateSteps() - tcfSteps[index])*StepsToUnits)); + *numericReply = false; + } else + + // :FR[sn]# Goto focuser target position relative (in microns or steps) + // Returns: Nothing + if (toupper(command[1]) == 'R') { + if (strlen(parameter) > 0) *commandError = gotoTarget(index, target[index] + atol(parameter)*UnitsToSteps); else *commandError = CE_PARAM_FORM; + *numericReply = false; + } else + + // :FS[n]# Goto focuser target position (in microns or steps) + // Return: 0 on failure + // 1 on success + if (toupper(command[1]) == 'S') { + if (strlen(parameter) > 0) *commandError = gotoTarget(index, atol(parameter)*UnitsToSteps); else *commandError = CE_PARAM_FORM; + } else + + // :FZ# Set focuser position as zero + // Returns: Nothing + if (command[1] == 'Z') { + *commandError = resetTarget(index, 0); + *numericReply = false; + } else + + // :FH# Set focuser position as home + // Returns: Nothing + if (command[1] == 'H') { + *commandError = resetTarget(index, lround(getHomePosition(index)*MicronsToSteps)); + *numericReply = false; + } else + + // :Fh# Move focuser target position to home + // Returns: Nothing + if (command[1] == 'h') { + if (axes[index]->hasHomeSense()) { + *commandError = moveHome(index); + } else { + *commandError = gotoTarget(index, lround(getHomePosition(index)*MicronsToSteps)); + } + *numericReply = false; + } else *commandError = CE_CMD_UNKNOWN; + + } else return false; + + return true; +} + +#endif \ No newline at end of file diff --git a/src/telescope/focuser/local/Focuser.cpp b/src/telescope/focuser/local/Focuser.cpp new file mode 100755 index 0000000..09b10dd --- /dev/null +++ b/src/telescope/focuser/local/Focuser.cpp @@ -0,0 +1,700 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control + +#include "Focuser.h" + +#ifdef FOCUSER_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/sense/Sense.h" +#include "../../../lib/nv/Nv.h" + +#include "../../../libApp/weather/Weather.h" +#include "../../../libApp/temperature/Temperature.h" + +#include "../../Telescope.h" + +typedef struct FocuserConfiguration { + bool present; + int32_t homeDefault; + uint16_t slewRateDesired; + uint8_t slewRateMinimum; + float accelerationTime; + float rapidStopTime; + bool powerDown; + uint16_t powerDownTime; + uint8_t slavedToFocuser; +} FocuserConfiguration; + +static const FocuserConfiguration configuration[] = { +#if FOCUSER_MAX >= 1 + {AXIS4_DRIVER_MODEL != OFF, AXIS4_HOME_DEFAULT, AXIS4_SLEW_RATE_BASE_DESIRED, AXIS4_SLEW_RATE_MINIMUM, AXIS4_ACCELERATION_TIME, AXIS4_RAPID_STOP_TIME, AXIS4_POWER_DOWN == ON, AXIS4_POWER_DOWN_TIME, AXIS4_SLAVED_TO_FOCUSER}, +#endif +#if FOCUSER_MAX >= 2 + {AXIS5_DRIVER_MODEL != OFF, AXIS5_HOME_DEFAULT, AXIS5_SLEW_RATE_BASE_DESIRED, AXIS5_SLEW_RATE_MINIMUM, AXIS5_ACCELERATION_TIME, AXIS5_RAPID_STOP_TIME, AXIS5_POWER_DOWN == ON, AXIS5_POWER_DOWN_TIME, AXIS5_SLAVED_TO_FOCUSER}, +#endif +#if FOCUSER_MAX >= 3 + {AXIS6_DRIVER_MODEL != OFF, AXIS6_HOME_DEFAULT, AXIS6_SLEW_RATE_BASE_DESIRED, AXIS6_SLEW_RATE_MINIMUM, AXIS6_ACCELERATION_TIME, AXIS6_RAPID_STOP_TIME, AXIS6_POWER_DOWN == ON, AXIS6_POWER_DOWN_TIME, AXIS6_SLAVED_TO_FOCUSER}, +#endif +#if FOCUSER_MAX >= 4 + {AXIS7_DRIVER_MODEL != OFF, AXIS7_HOME_DEFAULT, AXIS7_SLEW_RATE_BASE_DESIRED, AXIS7_SLEW_RATE_MINIMUM, AXIS7_ACCELERATION_TIME, AXIS7_RAPID_STOP_TIME, AXIS7_POWER_DOWN == ON, AXIS7_POWER_DOWN_TIME, AXIS7_SLAVED_TO_FOCUSER}, +#endif +#if FOCUSER_MAX >= 5 + {AXIS8_DRIVER_MODEL != OFF, AXIS8_HOME_DEFAULT, AXIS8_SLEW_RATE_BASE_DESIRED, AXIS8_SLEW_RATE_MINIMUM, AXIS8_ACCELERATION_TIME, AXIS8_RAPID_STOP_TIME, AXIS8_POWER_DOWN == ON, AXIS8_POWER_DOWN_TIME, AXIS8_SLAVED_TO_FOCUSER}, +#endif +#if FOCUSER_MAX >= 6 + {AXIS9_DRIVER_MODEL != OFF, AXIS9_HOME_DEFAULT, AXIS9_SLEW_RATE_BASE_DESIRED, AXIS9_SLEW_RATE_MINIMUM, AXIS9_ACCELERATION_TIME, AXIS9_RAPID_STOP_TIME, AXIS9_POWER_DOWN == ON, AXIS9_POWER_DOWN_TIME, AXIS9_SLAVED_TO_FOCUSER}, +#endif +}; + +static int slavedToFocuser[6] = {-1, -1, -1, -1, -1, -1}; + +static void focWrapper() { focuser.monitor(); } + +#if FOCUSER_BUTTON_SENSE_IN != OFF && FOCUSER_BUTTON_SENSE_OUT != OFF +static void focButtonsWrapper() { focuser.buttons(); } +#endif + +#if defined(FOCUSER_CAN_SERVER_PRESENT) +// 1 Hz heartbeat TX for this remote focuser node +static void focHeartbeatWrapper() { + if (!canPlus.ready) return; + const uint16_t hbId = (uint16_t)(CAN_FOCUSER_HB_ID_BASE + (CAN_FOCUSER_NUMBER - 1)); + const uint8_t b = 0; // payload reserved; currently unused + canPlus.writePacket((int)hbId, &b, 1); +} +#endif + +// setup arrays for easy access to focuser axes +Axis *axes[6] = {NULL, NULL, NULL, NULL, NULL, NULL}; + +bool Focuser::init() { + #if defined(FOCUSER_CAN_SERVER_PRESENT) + if (!CanTransportServer::init(true, 2)) return false; + #endif + + // get the motion controllers ready + #if AXIS4_DRIVER_MODEL != OFF + if (!axis4.init(&motor4)) { initError.driver = true; DLF("ERR: Focuser::init(), no motion controller for Axis4!"); return false; } else { + VLF("MSG: Focuser1, init (Axis4)"); + axes[0] = &axis4; + } + #endif + #if AXIS5_DRIVER_MODEL != OFF + if (!axis5.init(&motor5)) { initError.driver = true; DLF("ERR: Focuser::init(), no motion controller for Axis5!"); return false; } else { + VLF("MSG: Focuser2, init (Axis5)"); + axes[1] = &axis5; + } + #endif + #if AXIS6_DRIVER_MODEL != OFF + if (!axis6.init(&motor6)) { initError.driver = true; DLF("ERR: Focuser::init(), no motion controller for Axis6!"); return false; } else { + VLF("MSG: Focuser3, init (Axis6)"); + axes[2] = &axis6; + } + #endif + #if AXIS7_DRIVER_MODEL != OFF + if (!axis7.init(&motor7)) { initError.driver = true; DLF("ERR: Focuser::init(), no motion controller for Axis7!"); return false; } else { + VLF("MSG: Focuser4, init (Axis7)"); + axes[3] = &axis7; + } + #endif + #if AXIS8_DRIVER_MODEL != OFF + if (!axis8.init(&motor8)) { initError.driver = true; DLF("ERR: Focuser::init(), no motion controller for Axis8!"); return false; } else { + VLF("MSG: Focuser5, init (Axis8)"); + axes[4] = &axis8; + } + #endif + #if AXIS9_DRIVER_MODEL != OFF + if (!axis9.init(&motor9)) { initError.driver = true; DLF("ERR: Focuser::init(), no motion controller for Axis9!"); return false; } else { + VLF("MSG: Focuser6, init (Axis9)"); + axes[5] = &axis9; + } + #endif + + // time to wait before writing position to nv after last movement of focuser + if (nv().device().endurance() == NvDevice::Endurance::Mid) writeDelay = 60; else + if (nv().device().endurance() == NvDevice::Endurance::High) writeDelay = 5; + + // init settings stored in NV + for (uint8_t index = 0; index < FOCUSER_MAX; index++) { + // make sure defaults are set + settings[index].tcf.enabled = false; + settings[index].tcf.coef = 0.0F; + settings[index].tcf.deadband = 1; + settings[index].tcf.t0 = 0.0F; + settings[index].parkState = PS_UNPARKED; + settings[index].backlash = 0; + settings[index].position = 0.0F; + settings[index].gotoRate = configuration[index].slewRateDesired; + + // create a nvKey to hold this focusers settings + char keyStr[26]; + snprintf(keyStr, sizeof(keyStr), "FOCUSER%u_SETTINGS", index); + nvKey[index] = nv().kv().computeKey(keyStr); + + if (!nv().kv().getOrInit(nvKey[index], settings[index])) { DF("WRN: Nv, init failed for "); VL(keyStr[index]); } + settings[index].tcf.enabled = constrain(settings[index].tcf.enabled, false, true); + settings[index].tcf.coef = constrain(settings[index].tcf.coef, 0, 999); + settings[index].tcf.deadband = constrain(settings[index].tcf.deadband, 1, 10000); + settings[index].tcf.t0 = constrain(settings[index].tcf.t0, -60, 60); + settings[index].parkState = constrain(settings[index].parkState, PS_UNPARKED, PS_UNPARKING); + settings[index].backlash = constrain(settings[index].backlash, 0, 10000); + settings[index].position = constrain(settings[index].position, axes[index]->getLimitMin(), axes[index]->getLimitMax()); + settings[index].gotoRate = constrain(settings[index].gotoRate, configuration[index].slewRateDesired/2.0, configuration[index].slewRateDesired*2.0); + } + + // get settings + for (int index = 0; index < FOCUSER_MAX; index++) { + moveRate[index] = 100; + tcfSteps[index] = 0; + target[index] = 0; + writeTime[index] = 0; + parkHandle[index] = 0; + homing[index] = false; + + if (validIndex(index)) { + if (active == -1) active = index; + + // TCF defaults to disabled at startup + settings[index].tcf.enabled = false; + + if (settings[index].position < axes[index]->getLimitMin()) { + settings[index].position = axes[index]->getLimitMin(); + initError.value = true; + DLF("ERR: Focuser.init(), bad NV park pos < _LIMIT_MIN (set to _LIMIT_MIN)"); + } + + if (settings[index].position > axes[index]->getLimitMax()) { + settings[index].position = axes[index]->getLimitMax(); + initError.value = true; + DLF("ERR: Focuser.init(), bad NV park pos > _LIMIT_MAX steps (set to _LIMIT_MAX)"); + } + + axes[index]->resetPositionSteps(0); + axes[index]->setBacklashSteps(settings[index].backlash); + axes[index]->setFrequencyMax(configuration[index].slewRateDesired*2.0F); + axes[index]->setFrequencyMin(configuration[index].slewRateMinimum); + axes[index]->setFrequencySlew(configuration[index].slewRateDesired); + axes[index]->setSlewAccelerationTime(configuration[index].accelerationTime); + axes[index]->setSlewAccelerationTimeAbort(configuration[index].rapidStopTime); + if (configuration[index].powerDown) axes[index]->setPowerDownTime(configuration[index].powerDownTime); + slavedToFocuser[index] = configuration[index].slavedToFocuser - 1; + if (slavedToFocuser[index] < -1 || slavedToFocuser[index] >= FOCUSER_MAX) slavedToFocuser[index] = -1; + } + } + + // some final initialization + bool recursionDetected = false; + for (int index = 0; index < FOCUSER_MAX; index++) { + if (validIndex(index) && hasSlaveCycle(index)) { recursionDetected = true; break; } + } + if (recursionDetected) { + for (int index = 0; index < FOCUSER_MAX; index++) slavedToFocuser[index] = -1; + DLF("WRN: Focusers, slaved focusers have recurse on themselves and are disabled!"); + } + + ready = true; + return true; +} + +void Focuser::begin() { + if (!ready) return; + + // some final initialization + for (int index = 0; index < FOCUSER_MAX; index++) { if (validIndex(index)) axes[index]->calibrateDriver(); } + + // start task for temperature compensated focusing + VF("MSG: Focusers, starting TCF task (rate 1s priority 6)... "); + if (tasks.add(1000, 0, true, 6, focWrapper, "FocPoll")) { VLF("success"); } else { VLF("FAILED!"); } + + // start task for monitor for focuser buttons + #if FOCUSER_BUTTON_SENSE_IN != OFF && FOCUSER_BUTTON_SENSE_OUT != OFF + if (FOCUSER_BUTTON_FOCUSER_INDEX - 1 < 0 || + FOCUSER_BUTTON_FOCUSER_INDEX - 1 >= FOCUSER_MAX || + axes[FOCUSER_BUTTON_FOCUSER_INDEX - 1] == NULL) { + DLF("WRN: Focusers, starting button monitor failed invalid FOCUSER_BUTTON_FOCUSER_INDEX"); + return; + } + + VF("MSG: Focusers, starting button monitor task (rate 10ms priority 6)... "); + if (tasks.add(10, 0, true, 6, focButtonsWrapper, "FocBtns")) { + VLF("success"); + VLF("Focusers, adding any in and out button senses"); + inButtonHandle = sense.add(FOCUSER_BUTTON_SENSE_IN_PIN, FOCUSER_BUTTON_SENSE_INIT, FOCUSER_BUTTON_SENSE_IN); + outButtonHandle = sense.add(FOCUSER_BUTTON_SENSE_OUT_PIN, FOCUSER_BUTTON_SENSE_INIT, FOCUSER_BUTTON_SENSE_OUT); + } else { VLF("FAILED!"); } + #endif + + #if defined(FOCUSER_CAN_SERVER_PRESENT) + VF("MSG: Focusers, starting CAN heartbeat task (rate 1s priority 6)... "); + if (tasks.add(1000, 0, true, 6, focHeartbeatWrapper, "FocHB")) { VLF("success"); } else { VLF("FAILED!"); } + #endif + + for (int index = 0; index < FOCUSER_MAX; index++) { + if (configuration[index].present && axes[index] != NULL) unpark(index); + } +} + +bool Focuser::validIndex(int index) { + if (index < 0 || index >= FOCUSER_MAX) return false; + if (!configuration[index].present) return false; + if (axes[index] == nullptr) return false; + return true; +} + +// get focuser temperature in deg. C +float Focuser::getTemperature() { + float t = temperature.getChannel(0); + return t; +} + +// check for DC motor focuser +bool Focuser::isDC(int index) { + UNUSED(index); + return false; +} + +// get DC power in % +int Focuser::getDcPower(int index) { + UNUSED(index); + return 0; +} + +// set DC power in % +bool Focuser::setDcPower(int index, int value) { + UNUSED(index); + if (value < 0 || value > 100) return false; + return true; +} + +// get TCF enable +bool Focuser::getTcfEnable(int index) { + if (!validIndex(index)) return false; + if (isnan(getTemperature())) setTcfEnable(index, false); + return settings[index].tcf.enabled; +} + +// set TCF enable +CommandError Focuser::setTcfEnable(int index, bool value) { + if (!validIndex(index)) return CE_CMD_UNKNOWN; + if (settings[index].parkState >= PS_PARKED) return CE_PARKED; + + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) setTcfEnable(si, value); } + + if (isnan(getTemperature())) value = false; + settings[index].tcf.enabled = value; + if (value) { + settings[index].tcf.t0 = getTemperature(); + } else { + target[index] += tcfSteps[index]; + tcfSteps[index] = 0; + } + nv().kv().put(nvKey[index], settings[index]); + return CE_NONE; +} + +// get TCF coefficient, in microns per deg. C +float Focuser::getTcfCoef(int index) { + if (!validIndex(index)) return 0.0F; + return settings[index].tcf.coef; +} + +// set TCF coefficient, in microns per deg. C +bool Focuser::setTcfCoef(int index, float value) { + if (!validIndex(index)) return false; + if (fabs(value) >= 1000.0F) return false; + + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) setTcfCoef(si, value); } + + settings[index].tcf.coef = value; + nv().kv().put(nvKey[index], settings[index]); + return true; +} + +// get TCF deadband, in steps +int Focuser::getTcfDeadband(int index) { + if (!validIndex(index)) return 0; + return settings[index].tcf.deadband; +} + +// set TCF deadband, in steps +bool Focuser::setTcfDeadband(int index, int value) { + if (!validIndex(index)) return false; + if (value < 1 || value > 10000) return false; + + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) setTcfDeadband(si, value); } + + settings[index].tcf.deadband = value; + nv().kv().put(nvKey[index], settings[index]); + return true; +} + +// get TCF T0, in deg. C +float Focuser::getTcfT0(int index) { + if (!validIndex(index)) return 0.0F; + return settings[index].tcf.t0; +} + +// set TCF T0, in deg. C +bool Focuser::setTcfT0(int index, float value) { + if (!validIndex(index)) return false; + if (fabs(value) > 60.0F) return false; + + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) setTcfT0(si, value); } + + settings[index].tcf.t0 = value; + nv().kv().put(nvKey[index], settings[index]); + return true; +} + +// get home position in microns +float Focuser::getHomePosition(int index) { + if (!validIndex(index)) return 0; + + int mi = slavedToFocuser[index]; + if (mi >= 0 && mi < FOCUSER_MAX && axes[mi] != NULL) { return axes[mi]->getInstrumentCoordinate(); } + + if (configuration[index].homeDefault >= 0 && configuration[index].homeDefault <= 500000) return configuration[index].homeDefault; + + switch (configuration[index].homeDefault) { + case MAXIMUM: + return lround(axes[index]->getLimitMax()); + case MIDDLE: + return lround((axes[index]->getLimitMax() + axes[index]->getLimitMin())/2.0F); + case MINIMUM: + default: + return lround(axes[index]->getLimitMin()); + } +} + +// get backlash in steps +int Focuser::getBacklashSteps(int index) { + if (!validIndex(index)) return 0; + return settings[index].backlash; +} + +// set backlash in steps +CommandError Focuser::setBacklashSteps(int index, int value) { + if (!validIndex(index)) return CE_CMD_UNKNOWN; + if (value < 0 || value > 10000) return CE_PARAM_RANGE; + if (settings[index].parkState >= PS_PARKED) return CE_PARKED; + + #if FOCUSER_SLAVE_BACKLASH == ON + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) setBacklashSteps(si, value); } + #endif + + settings[index].backlash = value; + nv().kv().put(nvKey[index], settings[index]); + axes[index]->setBacklashSteps(getBacklashSteps(index)); + return CE_NONE; +} + +// set move rate, 1 for 1um/sec slew, 2 for 10um/sec, 3 for 100um/sec, 4 for 0.5x goto rate +void Focuser::setMoveRate(int index, int value) { + if (!validIndex(index)) return; + if (value < 1 || value > 4) return; + + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) setMoveRate(si, value); } + + switch (value) { + case 1: moveRate[index] = 1; break; + case 2: moveRate[index] = 10; break; + case 3: moveRate[index] = 100; break; + case 4: moveRate[index] = settings[index].gotoRate/2; break; + default: moveRate[index] = 10; break; + } +} + +// start move in the specified direction +CommandError Focuser::move(int index, Direction dir) { + if (!validIndex(index)) return CE_CMD_UNKNOWN; + if (settings[index].parkState >= PS_PARKED) return CE_PARKED; + + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) move(si, dir); } + + axes[index]->enable(true); + if (!axes[index]->isSlewing()) { + axes[index]->setSynchronizedFrequency(0.0F); + axes[index]->resetTargetToMotorPosition(); + } + return axes[index]->autoSlew(dir, moveRate[index]); +} + +// start move to the home position +CommandError Focuser::moveHome(int index) { + if (!validIndex(index)) return CE_CMD_UNKNOWN; + if (settings[index].parkState >= PS_PARKED) return CE_PARKED; + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) moveHome(si); } + + axes[index]->enable(true); + axes[index]->setFrequencySlew(settings[index].gotoRate); + CommandError e = axes[index]->autoSlewHome(); + if (e == CE_NONE) homing[index] = true; + + return e; +} + +// get goto rate, 1 for 0.5x base, 2 for 0.66x base, 3 for base, 4 for 1.5x base, 5 for 2x base +int Focuser::getGotoRate(int index) { + if (!validIndex(index)) return 1; + + if (settings[index].gotoRate < configuration[index].slewRateDesired/1.75) return 1; + if (settings[index].gotoRate < configuration[index].slewRateDesired/1.25) return 2; + if (settings[index].gotoRate < configuration[index].slewRateDesired*1.25) return 3; + if (settings[index].gotoRate < configuration[index].slewRateDesired*1.75) return 4; else return 5; +} + +// set goto rate, 1 for 0.5x base, 2 for 0.66x base, 3 for base, 4 for 1.5x base, 5 for 2x base +void Focuser::setGotoRate(int index, int value) { + if (!validIndex(index)) return; + if (value < 1 || value > 5) value = 1; + + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) setGotoRate(si, value); } + + switch (value) { + case 1: settings[index].gotoRate = configuration[index].slewRateDesired/2.0; break; + case 2: settings[index].gotoRate = configuration[index].slewRateDesired/1.5; break; + case 3: settings[index].gotoRate = configuration[index].slewRateDesired*1.0; break; + case 4: settings[index].gotoRate = configuration[index].slewRateDesired*1.5; break; + case 5: settings[index].gotoRate = configuration[index].slewRateDesired*2.0; break; + default: settings[index].gotoRate = configuration[index].slewRateDesired; break; + } + nv().kv().put(nvKey[index], settings[index]); +} + +// move focuser to a specific location (in steps) +CommandError Focuser::gotoTarget(int index, long target) { + if (!validIndex(index)) return CE_CMD_UNKNOWN; + if (settings[index].parkState >= PS_PARKED) return CE_PARKED; + + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) gotoTarget(si, target); } + + VF("MSG: Focuser"); V(index + 1); VF(", goto target coordinate set ("); V(target/axes[index]->getStepsPerMeasure()); VLF("um)"); + VF("MSG: Focuser"); V(index + 1); VLF(", attempting goto"); + + axes[index]->enable(true); + axes[index]->setSynchronizedFrequency(0.0F); + axes[index]->setTargetCoordinateSteps(target + tcfSteps[index]); + CommandError e = axes[index]->autoGoto(settings[index].gotoRate); + if (e != CE_NONE) { VF("MSG: Focuser"); V(index + 1); VLF(", goto failed"); } + + return e; +} + +// reset focuser to a specific location (in steps) +CommandError Focuser::resetTarget(int index, long target) { + if (!validIndex(index)) return CE_CMD_UNKNOWN; + if (settings[index].parkState >= PS_PARKED) return CE_PARKED; + + for (int i = 0; i < FOCUSER_MAX; i++) { int si = slavedFocuserIndex(index, i); if (si >= 0) resetTarget(si, target); } + + VF("MSG: Focuser"); V(index + 1); VF(", reset target coordinate set ("); V(target/axes[index]->getStepsPerMeasure()); VLF("um)"); + + CommandError e = axes[index]->resetPositionSteps(target); + axes[index]->setBacklashSteps(getBacklashSteps(index)); + + if (e != CE_NONE) { VF("MSG: Focuser"); V(index + 1); VLF(", reset failed"); } + + return e; +} + +// park focuser at its current location +CommandError Focuser::park(int index) { + if (!validIndex(index)) return CE_PARAM_RANGE; + if (settings[index].parkState == PS_PARKED) return CE_NONE; + if (settings[index].parkState == PS_PARKING) return CE_PARK_FAILED; + if (settings[index].parkState == PS_UNPARKING) return CE_PARK_FAILED; + if (settings[index].parkState == PS_PARK_FAILED) return CE_PARK_FAILED; + + setTcfEnable(index, false); + + axes[index]->enable(true); + VF("MSG: Focuser"); V(index + 1); VLF(", parking"); + axes[index]->setBacklashSteps(0); + float targetMicrons = axes[index]->getInstrumentCoordinate(); + axes[index]->setTargetCoordinatePark(targetMicrons); + + CommandError e = axes[index]->autoGoto(settings[index].gotoRate); + + if (e == CE_NONE) { + settings[index].position = targetMicrons; + settings[index].parkState = PS_PARKING; + nv().kv().put(nvKey[index], settings[index]); + } + + return e; +} + +// unpark focuser +CommandError Focuser::unpark(int index) { + if (!validIndex(index)) return CE_PARAM_RANGE; + if (settings[index].parkState == PS_PARKING) return CE_PARK_FAILED; + if (settings[index].parkState == PS_UNPARKING) return CE_PARK_FAILED; + if (settings[index].parkState == PS_PARK_FAILED) return CE_PARK_FAILED; + + // setting write delay to 0 disables on-the-fly position writes and forces strict parking + if (writeDelay == 0) { + if (settings[index].parkState != PS_PARKED) return CE_NOT_PARKED; + } + + axes[index]->enable(true); + VF("MSG: Focuser"); V(index + 1); VF(", unpark position "); V(settings[index].position); VL("um"); + + // simple unpark if we didn't actually park + if (settings[index].parkState == PS_UNPARKED) { + axes[index]->setInstrumentCoordinate(settings[index].position); + target[index] = lround(settings[index].position*axes[index]->getStepsPerMeasure()) - tcfSteps[index]; + nv().kv().put(nvKey[index], settings[index]); + return CE_NONE; + } + + axes[index]->setBacklashSteps(0); + axes[index]->setInstrumentCoordinatePark(settings[index].position); + + axes[index]->setBacklashSteps(settings[index].backlash); + axes[index]->setTargetCoordinate(settings[index].position); + + CommandError e = axes[index]->autoGoto(settings[index].gotoRate); + + if (e == CE_NONE) { + settings[index].parkState = PS_UNPARKING; + target[index] = lround(settings[index].position*axes[index]->getStepsPerMeasure()) - tcfSteps[index]; + nv().kv().put(nvKey[index], settings[index]); + } + + return e; +} + +// poll focusers to handle parking and TCF +void Focuser::monitor() { + secs++; + + float t = getTemperature(); + for (int index = 0; index < FOCUSER_MAX; index++) { + if (axes[index] != NULL) { + + target[index] = axes[index]->getTargetCoordinateSteps() - tcfSteps[index]; + float targetMicrons = target[index]/axes[index]->getStepsPerMeasure(); + + if (axes[index]->isSlewing() || settings[index].position == targetMicrons) writeTime[index] = secs + writeDelay; + + if (!axes[index]->isSlewing()) { + + if (settings[index].parkState == PS_PARKING) { + if (axes[index]->atTarget()) { + axes[index]->enable(false); + settings[index].parkState = PS_PARKED; + nv().kv().put(nvKey[index], settings[index]); + #if DEBUG == VERBOSE + long offset = axes[index]->getInstrumentCoordinateSteps() - axes[index]->getMotorPositionSteps(); + VF("MSG: Focuser"); V(index + 1); VF(", park motor target "); VL(axes[index]->getTargetCoordinateSteps() - offset); + VF("MSG: Focuser"); V(index + 1); VF(", park motor position "); VL(axes[index]->getMotorPositionSteps()); + #endif + } + } else + + if (settings[index].parkState == PS_UNPARKING) { + if (axes[index]->atTarget()) { + settings[index].parkState = PS_UNPARKED; + nv().kv().put(nvKey[index], settings[index]); + } + } else + + if (settings[index].parkState == PS_UNPARKED) { + if (settings[index].tcf.enabled) { + Y; + if (!isnan(t)) { + float offset = settings[index].tcf.coef * (settings[index].tcf.t0 - t); + offset *= (float)axes[index]->getStepsPerMeasure(); + long steps = lroundf(offset/settings[index].tcf.deadband)*settings[index].tcf.deadband; + if (tcfSteps[index] != steps) { + VF("MSG: Focuser"); V(index + 1); VF(", TCF offset changed moving to target "); + if (steps >= 0) { V("+ "); } else { VF("- "); } V(fabs(steps/axes[index]->getStepsPerMeasure())); VLF("um"); + tcfSteps[index] = steps; + axes[index]->setTargetCoordinateSteps(target[index] + tcfSteps[index]); + } + } + if (!axes[index]->atTarget()) { + axes[index]->setSynchronized(false); + axes[index]->setSynchronizedFrequency(20.0F); // 20um/s + } else { + axes[index]->setSynchronizedFrequency(0.0F); + } + } else tcfSteps[index] = 0; + + if (homing[index]) { + long p = round((axes[index]->getLimitMax() + axes[index]->getLimitMin())/2.0F)*axes[index]->getStepsPerMeasure(); + axes[index]->resetPositionSteps(p); + axes[index]->setBacklashSteps(getBacklashSteps(index)); + homing[index] = false; + } + + // delayed write of focuser position + if (writeDelay != 0) { + if (secs > writeTime[index]) { + settings[index].position = targetMicrons; + nv().kv().put(nvKey[index], settings[index]); + VF("MSG: Focuser"); V(index + 1); VF(", writing position ("); V(targetMicrons); VLF("um) to NV"); + } + } + + } + } + } + } +} + +int Focuser::slavedFocuserIndex(int masterIndex, int candidateIndex) { + if (candidateIndex < 0 || candidateIndex >= FOCUSER_MAX) return -1; + + if (configuration[candidateIndex].present && + axes[candidateIndex] != NULL && + slavedToFocuser[candidateIndex] == masterIndex) { + return candidateIndex; + } + + return -1; +} + +bool Focuser::hasSlaveCycle(int candidateIndex) { + bool seen[FOCUSER_MAX] = {false}; + int i = candidateIndex; + + while (true) { + int mi = slavedToFocuser[i]; + + // no master => chain ends cleanly + if (mi < 0 || mi >= FOCUSER_MAX) return false; + + // broken chain => treat as invalid (block) + if (!configuration[mi].present || axes[mi] == NULL) return true; + + if (mi == i || seen[mi]) return true; + seen[mi] = true; + i = mi; + } +} + +// poll focuser buttons to start/stop movement +#if FOCUSER_BUTTON_SENSE_IN != OFF && FOCUSER_BUTTON_SENSE_OUT != OFF + void Focuser::buttons() { + if (sense.changed(inButtonHandle) || sense.changed(outButtonHandle)) { + bool in = sense.isOn(inButtonHandle); + bool out = sense.isOn(outButtonHandle); + if (in && out) { in = false; out = false; } + if (in) { + if (FOCUSER_BUTTON_MOVE_RATE > 0) moveRate[FOCUSER_BUTTON_FOCUSER_INDEX - 1] = FOCUSER_BUTTON_MOVE_RATE; + move(FOCUSER_BUTTON_FOCUSER_INDEX - 1, DIR_FORWARD); + } else + if (out) { + if (FOCUSER_BUTTON_MOVE_RATE > 0) moveRate[FOCUSER_BUTTON_FOCUSER_INDEX - 1] = FOCUSER_BUTTON_MOVE_RATE; + move(FOCUSER_BUTTON_FOCUSER_INDEX - 1, DIR_REVERSE); + } else + axes[FOCUSER_BUTTON_FOCUSER_INDEX - 1]->autoSlewStop(); + } + } +#endif + +Focuser focuser; + +#endif diff --git a/src/telescope/focuser/local/Focuser.h b/src/telescope/focuser/local/Focuser.h new file mode 100755 index 0000000..3a36275 --- /dev/null +++ b/src/telescope/focuser/local/Focuser.h @@ -0,0 +1,230 @@ +//-------------------------------------------------------------------------------------------------- +// OnStepX focuser control +#pragma once + +#include "../../../Common.h" + +#include "../FocuserBase.h" + +#ifdef FOCUSER_PRESENT + +#include "../../../lib/nv/Nv.h" +#include "../../../lib/axis/Axis.h" +#include "../../../libApp/commands/ProcessCmds.h" +#include "../../Telescope.h" + +#if AXIS9_DRIVER_MODEL != OFF + #define FOCUSER_MAX 6 +#else + #if AXIS8_DRIVER_MODEL != OFF + #define FOCUSER_MAX 5 + #else + #if AXIS7_DRIVER_MODEL != OFF + #define FOCUSER_MAX 4 + #else + #if AXIS6_DRIVER_MODEL != OFF + #define FOCUSER_MAX 3 + #else + #if AXIS5_DRIVER_MODEL != OFF + #define FOCUSER_MAX 2 + #else + #if AXIS4_DRIVER_MODEL != OFF + #define FOCUSER_MAX 1 + #else + #define FOCUSER_MAX 0 + #endif + #endif + #endif + #endif + #endif +#endif + +// switch to allow backlash to be slaved +#ifndef FOCUSER_SLAVE_BACKLASH + #define FOCUSER_SLAVE_BACKLASH OFF +#endif + +#pragma pack(1) +typedef struct Tcf { + bool enabled; + float coef; // in um/°C + int16_t deadband; // in steps + float t0; // in °C, temperature when first enabled +} Tcf; + +#define FocuserSettingsSize 20 +typedef struct FocuserSettings { + Tcf tcf; + ParkState parkState; + int16_t backlash; // in steps + float position; // in microns + int16_t gotoRate; // in microns/s +} FocuserSettings; +#pragma pack() + +#ifdef FOCUSER_CAN_SERVER_PRESENT +#include "../../../lib/canTransport/CanTransportServer.h" +class Focuser : public CanTransportServer { +private: + void processCommand() override; +public: + Focuser() : CanTransportServer((uint16_t)(CAN_FOCUSER_REQ_ID), (uint16_t)(CAN_FOCUSER_RSP_ID)) {} +#else +class Focuser { +public: +#endif + + bool init(); + void begin(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // poll focusers to handle parking and TCF + void monitor(); + + // poll focuser buttons to start/stop movement + #if FOCUSER_BUTTON_SENSE_IN != OFF && FOCUSER_BUTTON_SENSE_OUT != OFF + void buttons(); + #endif + + private: + // make sure our index is valid for this focuser + bool validIndex(int index); + + // get focuser temperature in deg. C + float getTemperature(); + + // check for DC motor focuser + bool isDC(int index); + + // get DC power in % + int getDcPower(int index); + + // set DC power in % + bool setDcPower(int index, int value); + + // get TCF enable + bool getTcfEnable(int index); + + // set TCF enable + CommandError setTcfEnable(int index, bool value); + + // get TCF coefficient, in microns per deg. C + float getTcfCoef(int index); + + // set TCF coefficient, in microns per deg. C + bool setTcfCoef(int index, float value); + + // get TCF deadband, in steps + int getTcfDeadband(int index); + + // set TCF deadband, in steps + bool setTcfDeadband(int index, int value); + + // get TCF T0, in deg. C + float getTcfT0(int index); + + // set TCF T0, in deg. C + bool setTcfT0(int index, float value); + + // get home position in microns + float getHomePosition(int index); + + // get backlash in steps + int getBacklashSteps(int index); + + // set backlash in steps + CommandError setBacklashSteps(int index, int value); + + // set move rate + void setMoveRate(int index, int value); + + // start move in the specified direction + CommandError move(int index, Direction dir); + + // start move to the home position + CommandError moveHome(int index); + + // get goto rate, 1 for 0.5x base, 2 for 0.66x base, 3 for base, 4 for 1.5x base, 5 for 2x base + int getGotoRate(int index); + + // set goto rate, 1 for 0.5x base, 2 for 0.66x base, 3 for base, 4 for 1.5x base, 5 for 2x base + void setGotoRate(int index, int value); + + // move focuser to a specific location (in steps) + CommandError gotoTarget(int index, long target); + + // reset focuser to a specific location (in steps) + CommandError resetTarget(int index, long target); + + // park focuser at its current location + CommandError park(int index); + + // unpark focuser + CommandError unpark(int index); + + int slavedFocuserIndex(int masterIndex, int candidateIndex); + bool hasSlaveCycle(int candidateIndex); + + bool ready = false; + + int moveRate[FOCUSER_MAX]; + long tcfSteps[FOCUSER_MAX]; + + FocuserSettings settings[FOCUSER_MAX]; + + long target[FOCUSER_MAX]; // in steps + + unsigned long writeTime[FOCUSER_MAX]; + + uint8_t parkHandle[FOCUSER_MAX]; + + bool homing[FOCUSER_MAX]; + + unsigned long secs = 0; + + // the default focuser is the first found + int active = -1; + + #if FOCUSER_BUTTON_SENSE_IN != OFF && FOCUSER_BUTTON_SENSE_OUT != OFF + uint8_t inButtonHandle = 0; + uint8_t outButtonHandle = 0; + #endif + + uint16_t writeDelay = 300; + uint16_t nvKey[6]; +}; + +#if AXIS4_DRIVER_MODEL != OFF + extern Motor& motor4; + extern Axis axis4; +#endif + +#if AXIS5_DRIVER_MODEL != OFF + extern Motor& motor5; + extern Axis axis5; +#endif + +#if AXIS6_DRIVER_MODEL != OFF + extern Motor& motor6; + extern Axis axis6; +#endif + +#if AXIS7_DRIVER_MODEL != OFF + extern Motor& motor7; + extern Axis axis7; +#endif + +#if AXIS8_DRIVER_MODEL != OFF + extern Motor& motor8; + extern Axis axis8; +#endif + +#if AXIS9_DRIVER_MODEL != OFF + extern Motor& motor9; + extern Axis axis9; +#endif + +extern Focuser focuser; + +#endif diff --git a/src/telescope/focuser/remote/Focuser.can.decode.cpp b/src/telescope/focuser/remote/Focuser.can.decode.cpp new file mode 100755 index 0000000..54ec4de --- /dev/null +++ b/src/telescope/focuser/remote/Focuser.can.decode.cpp @@ -0,0 +1,126 @@ +//-------------------------------------------------------------------------------------------------- +// remote telescope focuser control, using the CANbus interface (CAN client decode) + +#include "Focuser.h" + +#if defined(FOCUSER_CAN_CLIENT_PRESENT) + +#include "../../../lib/convert/Convert.h" + +bool Focuser::decodeResponse(char *reply) { + if (!reply) return false; + reply[0] = 0; + + // scratchpad variables + float f; + int32_t i; + uint8_t u; + + switch (opCode()) { + + // :FT# -> RX: ASCII bytes "M"/"S" + rateDigit + case FOC_OP_GET_STATUS_T: + u = readRemainingBytes((uint8_t*)reply); + reply[u] = 0; + break; + + // :FI# / :FM# -> RX: i32LE (units already selected by ctrl on request) + case FOC_OP_GET_MIN_I: + case FOC_OP_GET_MAX_M: + if (!readI32(i)) return false; + sprintf(reply, "%ld", (long)i); + break; + + // :Fe# / :Ft# -> RX: f32LE temperature values + case FOC_OP_GET_TEMPDIFF_e: + case FOC_OP_GET_TEMP_t: + if (!readF32(f)) return false; + // local code uses "%3.1f" + sprintF(reply, "%3.1f", f); + break; + + // :Fu# -> RX: f32LE microns per step + case FOC_OP_GET_UM_PER_STEP_u: + if (!readF32(f)) return false; + // local code uses "%7.5f" + sprintF(reply, "%7.5f", f); + break; + + // :FB# (get) -> RX: i32LE backlash (units) + // :FB[n]# (set) -> typically no payload (status-only) + case FOC_OP_BACKLASH_B: + if (remaining() == 0) return true; + if (!readI32(i)) return false; + sprintf(reply, "%ld", (long)i); + break; + + // :FC# (get) -> RX: f32LE + // :FC[sn.n]# (set) -> usually no payload + case FOC_OP_TCF_COEF_C: + if (remaining() == 0) return true; + if (!readF32(f)) return false; + // local code uses "%7.5f" + sprintF(reply, "%7.5f", f); + break; + + // :Fc# (get) -> RX: u8 0/1 (if server returns payload) OR status-only + // :Fc[n]# (set) -> no payload + case FOC_OP_TCF_ENABLE_c: + if (remaining() == 0) return true; + if (!readU8(u)) return false; + sprintf(reply, "%u", (unsigned)(u ? 1 : 0)); + break; + + // :FD# (get) -> RX: i32LE (units) + // :FD[n]# (set) -> no payload + case FOC_OP_TCF_DEADBAND_D: + if (remaining() == 0) return true; + if (!readI32(i)) return false; + sprintf(reply, "%ld", (long)i); + break; + + // :FP# (get) -> RX: u8 percent (or i32 if you choose; server I gave uses u8) + // :FP[n]# (set) -> no payload + case FOC_OP_DC_POWER_P: + if (remaining() == 0) return true; + if (!readU8(u)) return false; + sprintf(reply, "%u", (unsigned)u); + break; + + // :FW# -> RX: i32LE work rate (um/s or whatever your server returns) + case FOC_OP_GET_WORKRATE_W: + if (remaining() == 0) return true; + if (!readI32(i)) return false; + sprintf(reply, "%ld", (long)i); + break; + + // :FG# -> RX: i32LE position (units) + case FOC_OP_GET_POS_G: + if (!readI32(i)) return false; + sprintf(reply, "%ld", (long)i); + break; + + // :GXU[n]# -> RX u8 packed status + case FOC_OP_DRIVER_STATUS: { + uint8_t packedStatus; + readU8(packedStatus); + strcat(reply, ( packedStatus & 1) ? "ST," : ","); + strcat(reply, ((packedStatus << 1) & 1) ? "OA," : ","); + strcat(reply, ((packedStatus << 2) & 1) ? "OB," : ","); + strcat(reply, ((packedStatus << 3) & 1) ? "GA," : ","); + strcat(reply, ((packedStatus << 4) & 1) ? "GB," : ","); + strcat(reply, ((packedStatus << 5) & 1) ? "OT," : ","); // > 150C + strcat(reply, ((packedStatus << 6) & 1) ? "PW," : ","); // > 120C + strcat(reply, ((packedStatus << 7) & 1) ? "GF" : ""); + } break; + + default: + // Most ops are "no reply payload"; empty reply is fine. + reply[0] = 0; + break; + } + + return true; +} + +#endif diff --git a/src/telescope/focuser/remote/Focuser.can.encode.cpp b/src/telescope/focuser/remote/Focuser.can.encode.cpp new file mode 100755 index 0000000..97eb9a5 --- /dev/null +++ b/src/telescope/focuser/remote/Focuser.can.encode.cpp @@ -0,0 +1,208 @@ +//-------------------------------------------------------------------------------------------------- +// remote telescope focuser control, using the CANbus interface + +#include "Focuser.h" + +#if defined(FOCUSER_CAN_CLIENT_PRESENT) + +#include "../../../lib/convert/Convert.h" + +bool Focuser::encodeRequest(char *command, char *parameter) { + + // on explicit focuser override the active focuser and reform the command/parameter + uint8_t selectedFocuser = (uint8_t)(active + 1); // 1..6 + + if (command[0] == 'F') { + if (command[1] >= '1' && command[1] <= '6' && parameter[0] != 0) { + selectedFocuser = (uint8_t)(command[1] - '0'); // 1..6 + command[1] = parameter[0]; + int len = strlen(parameter); + for (int i = 0; i <= len; i++) { parameter[i] = parameter[i + 1]; } + } + + // check to see if the selected focuser is present + if (!heartbeatFresh(selectedFocuser - 1)) return false; + + // check for commands that shouldn't have a parameter + if (strchr("aTpIMtuQF1234+-GZHh", command[1]) && parameter[0] != 0) return false; + + // flag if this command is using microns + bool useMicrons = strchr("bdgimrs", command[1]); + + // ctrl byte: focuser number + units bit (1=microns, 0=steps) + uint8_t ctrl = (uint8_t)(selectedFocuser & FOC_CTRL_FOCUSER_MASK); + if (useMicrons) ctrl |= FOC_CTRL_UNIT_MICRONS; + + // :FT# + if (command[1] == 'T') { + if (!beginNewRequest(FOC_OP_GET_STATUS_T)) return false; else writeU8(ctrl); + } else + + // :Fp# + if (command[1] == 'p') { + if (!beginNewRequest(FOC_OP_GET_MODE_p)) return false; else writeU8(ctrl); + } else + + // :FI# / :Fi# (min) (units via ctrl) + if (toupper(command[1]) == 'I') { + if (!beginNewRequest(FOC_OP_GET_MIN_I)) return false; else writeU8(ctrl); + } else + + // :FM# / :Fm# (max) (units via ctrl) + if (toupper(command[1]) == 'M') { + if (!beginNewRequest(FOC_OP_GET_MAX_M)) return false; else writeU8(ctrl); + } else + + // :Fe# + if (command[1] == 'e') { + if (!beginNewRequest(FOC_OP_GET_TEMPDIFF_e)) return false; else writeU8(ctrl); + } else + + // :Ft# + if (command[1] == 't') { + if (!beginNewRequest(FOC_OP_GET_TEMP_t)) return false; else writeU8(ctrl); + } else + + // :Fu# + if (command[1] == 'u') { + if (!beginNewRequest(FOC_OP_GET_UM_PER_STEP_u)) return false; else writeU8(ctrl); + } else + + // :FB# (get) or :FB[n]# (set) (units via ctrl) + if (toupper(command[1]) == 'B') { + if (!beginNewRequest(FOC_OP_BACKLASH_B)) return false; else writeU8(ctrl); + if (parameter[0] != 0) { + const long v = atol(parameter); + if (!writeI32((int32_t)v)) return false; + } + } else + + // :FC# (get f32) or :FC[sn.n]# (set f32) + if (command[1] == 'C') { + if (!beginNewRequest(FOC_OP_TCF_COEF_C)) return false; else writeU8(ctrl); + if (parameter[0] != 0) { + const float v = (float)atof(parameter); + if (!writeF32(v)) return false; + } + } else + + // :Fc# (get) or :Fc[n]# (set u8) + if (command[1] == 'c') { + if (!beginNewRequest(FOC_OP_TCF_ENABLE_c)) return false; else writeU8(ctrl); + if (parameter[0] != 0) { + if (parameter[1] != 0) return false; + const uint8_t en = (parameter[0] != '0') ? 1 : 0; + if (!writeU8(en)) return false; + } + } else + + // :FD# (get) or :FD[n]# (set i32) + if (toupper(command[1]) == 'D') { + if (!beginNewRequest(FOC_OP_TCF_DEADBAND_D)) return false; else writeU8(ctrl); + if (parameter[0] != 0) { + const long v = atol(parameter); + if (!writeI32((int32_t)v)) return false; + } + } else + + // :FP# (get) or :FP[n]# (set u8) + if (command[1] == 'P') { + if (!beginNewRequest(FOC_OP_DC_POWER_P)) return false; else writeU8(ctrl); + if (parameter[0] != 0) { + const long v = atol(parameter); + if (v < 0 || v > 100) return false; + if (!writeU8((uint8_t)v)) return false; + } + } else + + // :FQ# + if (command[1] == 'Q') { + if (!beginNewRequest(FOC_OP_STOP_Q)) return false; else writeU8(ctrl); + } else + + // :F[1..9]# (rate digit; no param) + if (command[1] >= '1' && command[1] <= '9') { + if (parameter[0] != 0) return false; + const uint8_t digit = (uint8_t)(command[1] - '0'); // 1..9 + if (!beginNewRequest(FOC_OP_SET_RATE_1_9)) return false; else writeU8(ctrl); + if (!writeU8(digit)) return false; + } else + + // :FW# + if (command[1] == 'W') { + if (!beginNewRequest(FOC_OP_GET_WORKRATE_W)) return false; else writeU8(ctrl); + } else + + // :F+# + if (command[1] == '+') { + if (!beginNewRequest(FOC_OP_MOVE_IN_PLUS)) return false; else writeU8(ctrl); + } else + + // :F-# + if (command[1] == '-') { + if (!beginNewRequest(FOC_OP_MOVE_OUT_MINUS)) return false; else writeU8(ctrl); + } else + + // :FG# / :Fg# (get pos i32 units via ctrl) + if (toupper(command[1]) == 'G') { + if (!beginNewRequest(FOC_OP_GET_POS_G)) return false; else writeU8(ctrl); + } else + + // :FR[sn]# / :Fr[sn]# (relative i32 units via ctrl) + if (toupper(command[1]) == 'R') { + if (parameter[0] == 0) return false; + if (!beginNewRequest(FOC_OP_GOTO_REL_R)) return false; else writeU8(ctrl); + if (!writeI32((int32_t)atol(parameter))) return false; + } else + + // :FS[n]# / :Fs[n]# (absolute i32 units via ctrl) + if (toupper(command[1]) == 'S') { + if (parameter[0] == 0) return false; + if (!beginNewRequest(FOC_OP_GOTO_ABS_S)) return false; else writeU8(ctrl); + if (!writeI32((int32_t)atol(parameter))) return false; + } else + + // :FZ# (zero) + if (command[1] == 'Z') { + if (!beginNewRequest(FOC_OP_ZERO_Z)) return false; else writeU8(ctrl); + } else + + // :FH# (set home) + if (command[1] == 'H') { + if (!beginNewRequest(FOC_OP_SET_HOME_H)) return false; else writeU8(ctrl); + } else + + // :Fh# (goto home) + if (command[1] == 'h') { + if (!beginNewRequest(FOC_OP_GOTO_HOME_h)) return false; else writeU8(ctrl); + } else + return false; + + return true; + } else + + if (command[0] == 'G' && command[1] == 'X') { + // :GXU[n]# Get focuser driver status + if (parameter[0] == 'U' && parameter[1] >= '4' && parameter[1] <= '9' && parameter[2] == 0) { + + // figure out which CAN focuser this would logically map to + uint8_t associatedFocuser = parameter[1] - '3'; // 1..6 + + // ctrl byte: focuser number + uint8_t ctrl = (uint8_t)(associatedFocuser & FOC_CTRL_FOCUSER_MASK); + + // check to see if the associated focuser is present + if (!heartbeatFresh(associatedFocuser - 1)) return false; + + // if present get its driver status + if (!beginNewRequest(FOC_OP_DRIVER_STATUS)) return false; else writeU8(ctrl); + } else + return false; + + return true; + } + + return true; +} + +#endif diff --git a/src/telescope/focuser/remote/Focuser.cpp b/src/telescope/focuser/remote/Focuser.cpp new file mode 100755 index 0000000..ad3e729 --- /dev/null +++ b/src/telescope/focuser/remote/Focuser.cpp @@ -0,0 +1,166 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control local node, using the CANbus interface + +#include "Focuser.h" + +#ifdef FOCUSER_CAN_CLIENT_PRESENT + +// -------------------------------------------------------------------------- +// Heartbeat RX (local node): update last-heard timestamps for focuser 1..6. +// -------------------------------------------------------------------------- +static void focHb0(uint8_t data[8], uint8_t len) { (void)data; (void)len; focuser.heartbeat(0); } +static void focHb1(uint8_t data[8], uint8_t len) { (void)data; (void)len; focuser.heartbeat(1); } +static void focHb2(uint8_t data[8], uint8_t len) { (void)data; (void)len; focuser.heartbeat(2); } +static void focHb3(uint8_t data[8], uint8_t len) { (void)data; (void)len; focuser.heartbeat(3); } +static void focHb4(uint8_t data[8], uint8_t len) { (void)data; (void)len; focuser.heartbeat(4); } +static void focHb5(uint8_t data[8], uint8_t len) { (void)data; (void)len; focuser.heartbeat(5); } + +void Focuser::begin() { + canPlus.callbackRegisterId((int)(CAN_FOCUSER_HB_ID_BASE + 0), focHb0); + canPlus.callbackRegisterId((int)(CAN_FOCUSER_HB_ID_BASE + 1), focHb1); + canPlus.callbackRegisterId((int)(CAN_FOCUSER_HB_ID_BASE + 2), focHb2); + canPlus.callbackRegisterId((int)(CAN_FOCUSER_HB_ID_BASE + 3), focHb3); + canPlus.callbackRegisterId((int)(CAN_FOCUSER_HB_ID_BASE + 4), focHb4); + canPlus.callbackRegisterId((int)(CAN_FOCUSER_HB_ID_BASE + 5), focHb5); +} + +// by default reply[80] == "", suppressFrame == false, numericReply == true, and commandError == CE_NONE +// return true if the command has been completely handled and no further command() will be called, or false if not +// for commands that are handled repeatedly commandError might contain CE_NONE or CE_1 to indicate success +// numericReply=true means boolean/numeric-style responses (e.g., CE_1/CE_0/errors) rather than a payload +bool Focuser::command(char *reply, char *command, char *parameter, + bool *suppressFrame, bool *numericReply, CommandError *commandError) { + if (!canPlus.ready) return false; + + // find the default focuser if the current one isn't active + // if the current focuser is unassigned (-1) or disappears scan again + if (!heartbeatFresh(active)) { + active = -1; + for (int focuserIdx = 0; focuserIdx < 6; focuserIdx++) { + if (heartbeatFresh(focuserIdx)) { active = focuserIdx; break; } + } + } + + // -------------------------------------------------------------------------- + // :hP# / :hR# park/unpark ALL present focusers + // Numeric result only. Defaults: numericReply==true, suppressFrame==false. + // -------------------------------------------------------------------------- + if (command[0] == 'h' && (command[1] == 'P' || command[1] == 'R') && parameter[0] == 0) { + const uint8_t op = (command[1] == 'P') ? (uint8_t)FOC_OP_PARK_HP : (uint8_t)FOC_OP_UNPARK_HR; + + bool anySent = false; + CommandError worst = CE_NONE; + + for (uint8_t focuserIdx = 0; focuserIdx < 6; focuserIdx++) { + uint8_t ctrl = (uint8_t)(focuserIdx & FOC_CTRL_FOCUSER_MASK); + + if (!heartbeatFresh(focuserIdx)) continue; + anySent = true; + + if (beginNewRequest(op)) { + writeU8(ctrl); + bool handled = false; + if (transactRequest(handled, *suppressFrame, *numericReply, *commandError)) { + if (!handled) worst = CE_CMD_UNKNOWN; + } else *commandError = CE_REPLY_UNKNOWN; + } + + if (*commandError != CE_NONE && *commandError != CE_1) worst = *commandError; + } + + *commandError = (!anySent) ? CE_0 : ((worst == CE_NONE) ? CE_1 : worst); + return true; + } + + // -------------------------------------------------------------------------- + // active focuser return / selection + // -------------------------------------------------------------------------- + + if (command[0] == 'F' && command[1] == 'A') { + + // :FA# Focuser Active? + // Return: 0 on failure (no focusers) + // 1 to 6 on success + if (parameter[0] == 0) { + if (active < 0) { *commandError = CE_0; return true; } + + const uint8_t focuserNum = (uint8_t)(active + 1); + sprintf(reply, "%u", (unsigned)focuserNum); + *numericReply = false; + *suppressFrame = true; + *commandError = CE_NONE; + return true; + } else + + // :FA[n]# Select focuser where [n] = 1 to 6 + // Return: 0 on failure + // 1 on success + if (parameter[1] == 0) { + const int i = parameter[0] - '1'; + if (i < 0 || i > 5 || !heartbeatFresh(i)) { *commandError = CE_PARAM_RANGE; return true; } + active = i; + return true; + } else return false; + } + + // -------------------------------------------------------------------------- + // :Fa# Focuser presence detection + // Returns: 1 true if present + // -------------------------------------------------------------------------- + if (command[0] && command[1] == 'a' && parameter[0] == 0) { + const int i = parameter[0] - '1'; + if (i < 0 || i > 5 || !heartbeatFresh(i)) { *commandError = CE_PARAM_RANGE; return true; } + return true; + } + + // :F[n]a# Focuser presence detection + if ((command[0] == 'F' && command[1] >= '1' && command[1] <= '6' && parameter[0] == 'a' && parameter[1] == 0)) { + sprintf(reply, "%u", heartbeatFresh((int)(command[1] - '1')) ? 1u : 0u); + *numericReply = false; + *suppressFrame = true; + *commandError = CE_NONE; + return true; + } + + // -------------------------------------------------------------------------- + // F - focuser commands only + // -------------------------------------------------------------------------- + if (!(command[0] == 'F') && + !(command[0] == 'G' && command[1] == 'X' && parameter[0] == 'U')) return false; + + // -------------------------------------------------------------------------- + // Generic CAN request/response path + // -------------------------------------------------------------------------- + + if (!encodeRequest(command, parameter)) return false; + + // Transport failure => reply unknown + bool handled = false; + if (!transactRequest(handled, *suppressFrame, *numericReply, *commandError)) { *commandError = CE_REPLY_UNKNOWN; return true; } + + // Remote explicitly did not recognize/handle the command + if (!handled) { + *commandError = CE_CMD_UNKNOWN; + *numericReply = true; + *suppressFrame = false; + reply[0] = 0; + return true; + } + + // Numeric reply: nothing to decode; caller will render numeric based on commandError + if (*numericReply) return true; + + // Payload reply: decode into reply buffer; decode failure => reply unknown + if (!decodeResponse(reply)) { + *commandError = CE_REPLY_UNKNOWN; + *numericReply = true; + *suppressFrame = false; + reply[0] = 0; + } + + return true; +} + +Focuser focuser; + +#endif diff --git a/src/telescope/focuser/remote/Focuser.h b/src/telescope/focuser/remote/Focuser.h new file mode 100755 index 0000000..e6b2d2b --- /dev/null +++ b/src/telescope/focuser/remote/Focuser.h @@ -0,0 +1,51 @@ +//-------------------------------------------------------------------------------------------------- +// telescope focuser control local node, using the CANbus interface +#pragma once + +#include "../../../Common.h" + +#include "../FocuserBase.h" + +#ifdef FOCUSER_CAN_CLIENT_PRESENT + +#include "../../../lib/canTransport/CanTransportClient.h" +#include "../../../libApp/commands/ProcessCmds.h" + +class Focuser : public CanTransportClient { + public: + Focuser() : CanTransportClient((uint16_t)(CAN_FOCUSER_REQ_ID), (uint16_t)(CAN_FOCUSER_RSP_ID)) {} + + void begin(); + + bool command(char *reply, char *command, char *parameter, + bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // Heartbeat event, indexed by focuser 1..6 => focuserIdx 0..5 + inline void heartbeat(uint8_t focuserIdx) { lastHeartbeatMs[focuserIdx] = hb_stamp_2ms_odd(); } + + private: + bool encodeRequest(char *command, char *parameter); + bool decodeResponse(char *reply); + + static inline uint32_t hb_stamp_2ms_odd() { + return millis() | 1UL; + } + + // Heartbeat presence, indexed by focuser 1..6 => focuserIdx 0..5 + inline bool heartbeatFresh(int focuserIdx) const { + if (focuserIdx < 0 || focuserIdx > 5) return false; + const uint32_t last = lastHeartbeatMs[focuserIdx]; + if (last == 0U) return false; + const uint32_t now = hb_stamp_2ms_odd(); + return (uint32_t)(now - last) <= 2000U; + } + + int active = -1; + + // Heartbeat timestamps (ms), indexed by focuser 1..6 => [0..5] + volatile uint32_t lastHeartbeatMs[6] = {0, 0, 0, 0, 0, 0}; +}; + +extern Focuser focuser; + +#endif diff --git a/src/telescope/mount/Mount.axis.cpp b/src/telescope/mount/Mount.axis.cpp new file mode 100755 index 0000000..90f27b4 --- /dev/null +++ b/src/telescope/mount/Mount.axis.cpp @@ -0,0 +1,242 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, axis2 and axis3 + +#include "Mount.h" + +#ifdef MOUNT_PRESENT + +// Axis2 motion controller + +namespace { + +#if defined(AXIS1_ODRIVE_PRESENT) + const ODriveDriverSettings DriverSettingsAxis1 = {AXIS1_DRIVER_MODEL, AXIS1_DRIVER_STATUS}; + ODriveMotor motor_1(1, AXIS1_REVERSE, &DriverSettingsAxis1, (AXIS1_STEPS_PER_DEGREE*RAD_DEG_RATIO)); + +#elif defined(AXIS1_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis1 = {AXIS1_DRIVER_MODEL, AXIS1_DRIVER_STATUS}; + KTechMotor motor_1(1, AXIS1_REVERSE, &DriverSettingsAxis1, AXIS1_STEPS_PER_DEGREE); + +#elif defined(AXIS1_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis1 = {AXIS1_DRIVER_MODEL, AXIS1_DRIVER_STATUS}; + Mks42DMotor motor_1(1, AXIS1_REVERSE, &DriverSettingsAxis1, AXIS1_STEPS_PER_DEGREE); + +#elif defined(AXIS1_SERVO_PRESENT) + ServoControl servoControlAxis1; + + #if AXIS1_ENCODER == AB + Quadrature encAxis1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + #elif AXIS1_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + #elif AXIS1_ENCODER == CW_CCW + CwCcw encAxis1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + #elif AXIS1_ENCODER == PULSE_DIR + PulseDir encAxis1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + #elif AXIS1_ENCODER == PULSE_ONLY + PulseOnly encAxis1(1, AXIS1_ENCODER_A_PIN, &servoControlAxis1.directionHint); + #elif AXIS1_ENCODER == VIRTUAL + VirtualEnc encAxis1(1); + #elif AXIS1_ENCODER == AS37_H39B_B + As37h39bb encAxis1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + #elif AXIS1_ENCODER == JTW_24BIT + Jtw24 encAxis1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + #elif AXIS1_ENCODER == JTW_26BIT + Jtw26 encAxis1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + #elif AXIS1_ENCODER == LIKA_ASC85 + LikaAsc85 encAxis1(1, AXIS1_ENCODER_A_PIN, AXIS1_ENCODER_B_PIN); + #elif AXIS1_ENCODER == KTECH_IME + KTechIME encAxis1(1); + #elif AXIS1_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis1(1); + #endif + + #if AXIS1_SERVO_FEEDBACK == PID + Pid feedbackAxis1(AXIS1_PID_P, AXIS1_PID_I, AXIS1_PID_D); + #elif AXIS1_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis1(AXIS1_PID_P, AXIS1_PID_I, AXIS1_PID_D, AXIS1_PID_P_GOTO, AXIS1_PID_I_GOTO, AXIS1_PID_D_GOTO, AXIS1_PID_SENSITIVITY); + #endif + + #if AXIS1_SERVO_FLTR == KALMAN + KalmanFilter filterAxis1(AXIS1_SERVO_FLTR_MEAS_U, AXIS1_SERVO_FLTR_VARIANCE); + #elif AXIS1_SERVO_FLTR == LEARNING + // nothing to do as this is auotmatically created... LearningFilter filterAxis1(AXIS1_SERVO_FLTR_WSIZE, 240); + #elif AXIS1_SERVO_FLTR == ROLLING + RollingFilter filterAxis1(AXIS1_SERVO_FLTR_WSIZE); + #elif AXIS1_SERVO_FLTR == OFF + Filter filterAxis1; + #endif + + const ServoPins DriverPinsAxis1 = {AXIS1_SERVO_PH1_PIN, AXIS1_SERVO_PH1_STATE, AXIS1_SERVO_PH2_PIN, AXIS1_SERVO_PH2_STATE, AXIS1_ENABLE_PIN, AXIS1_ENABLE_STATE, AXIS1_M0_PIN, AXIS1_M1_PIN, AXIS1_M2_PIN, AXIS1_M3_PIN, AXIS1_FAULT_PIN}; + const ServoSettings DriverSettingsAxis1 = {AXIS1_DRIVER_MODEL, AXIS1_DRIVER_STATUS, AXIS1_SERVO_ACCELERATION}; + + #if AXIS1_DRIVER_MODEL == SERVO_EE + ServoEE driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_SERVO_DC_PWR_MIN, AXIS1_SERVO_DC_PWR_MAX); + #elif AXIS1_DRIVER_MODEL == SERVO_PE + ServoPE driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_SERVO_DC_PWR_MIN, AXIS1_SERVO_DC_PWR_MAX); + #elif AXIS1_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc5160DC driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_SERVO_DC_PWR_MIN, AXIS1_SERVO_DC_PWR_MAX); + #elif AXIS1_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc2130DC driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_SERVO_DC_PWR_MIN, AXIS1_SERVO_DC_PWR_MAX); + #elif AXIS1_DRIVER_MODEL == SERVO_TMC2209 + ServoTmc2209 driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_MOTOR_STEPS_PER_DEGREE/AXIS1_STEPS_PER_DEGREE, AXIS1_DRIVER_MICROSTEPS, AXIS1_DRIVER_IRUN, AXIS1_DRIVER_DECAY, AXIS1_DRIVER_DECAY_GOTO); + #elif AXIS1_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_MOTOR_STEPS_PER_DEGREE/AXIS1_STEPS_PER_DEGREE, AXIS1_DRIVER_MICROSTEPS, AXIS1_DRIVER_IRUN, AXIS1_DRIVER_DECAY, AXIS1_DRIVER_DECAY_GOTO); + #elif AXIS1_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver1(1, &DriverSettingsAxis1, AXIS1_MOTOR_STEPS_PER_DEGREE/AXIS1_STEPS_PER_DEGREE); + #endif + + ServoMotor motor_1(1, AXIS1_REVERSE, ((ServoDriver*)&driver1), &filterAxis1, &encAxis1, AXIS1_ENCODER_ORIGIN, AXIS1_ENCODER_REVERSE == ON, &feedbackAxis1, &servoControlAxis1); + +#elif defined(AXIS1_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis1 = {AXIS1_M0_PIN, AXIS1_M1_PIN, AXIS1_M2_PIN, AXIS1_M2_ON_STATE, AXIS1_M3_PIN, AXIS1_DECAY_PIN, AXIS1_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis1 = {AXIS1_DRIVER_MODEL, AXIS1_DRIVER_STATUS, AXIS1_DRIVER_MICROSTEPS, AXIS1_DRIVER_MICROSTEPS_GOTO, AXIS1_DRIVER_DECAY, AXIS1_DRIVER_DECAY_GOTO}; + #if AXIS1_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS1_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1); + #elif AXIS1_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_DRIVER_IHOLD, AXIS1_DRIVER_IRUN, AXIS1_DRIVER_IGOTO, AXIS1_DRIVER_INTPOL); + #elif AXIS1_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_DRIVER_IHOLD, AXIS1_DRIVER_IRUN, AXIS1_DRIVER_IGOTO, AXIS1_DRIVER_INTPOL); + #elif AXIS1_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_DRIVER_IHOLD, AXIS1_DRIVER_IRUN, AXIS1_DRIVER_IGOTO, AXIS1_DRIVER_INTPOL); + #elif AXIS1_DRIVER_MODEL == TMC2209 || AXIS1_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_DRIVER_IHOLD, AXIS1_DRIVER_IRUN, AXIS1_DRIVER_IGOTO, AXIS1_DRIVER_INTPOL); + #elif AXIS1_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_DRIVER_IHOLD, AXIS1_DRIVER_IRUN, AXIS1_DRIVER_IGOTO, AXIS1_DRIVER_INTPOL); + #elif AXIS1_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_DRIVER_IHOLD, AXIS1_DRIVER_IRUN, AXIS1_DRIVER_IGOTO, AXIS1_DRIVER_INTPOL); + #elif AXIS1_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver1(1, &DriverPinsAxis1, &DriverSettingsAxis1, AXIS1_DRIVER_IHOLD, AXIS1_DRIVER_IRUN, AXIS1_DRIVER_IGOTO, AXIS1_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis1 = {AXIS1_STEP_PIN, AXIS1_STEP_STATE, AXIS1_DIR_PIN, AXIS1_ENABLE_PIN, AXIS1_ENABLE_STATE}; + StepDirMotor motor_1(1, AXIS1_REVERSE, &StepDirPinsAxis1, ((StepDirDriver*)&driver1)); + +#else + #error "Configuration (Config.h): MOUNT_PRESENT without AXIS1_DRIVER_MODEL should never happen!" +#endif + +const AxisPins PinsAxis1 = {AXIS1_SENSE_LIMIT_MIN_PIN, AXIS1_SENSE_HOME_PIN, AXIS1_SENSE_LIMIT_MAX_PIN, {AXIS1_SENSE_HOME, AXIS1_SENSE_HOME_INIT, degToRadF(AXIS1_SENSE_HOME_DIST_LIMIT), AXIS1_SENSE_LIMIT_MIN, AXIS1_SENSE_LIMIT_MAX, AXIS1_SENSE_LIMIT_INIT}}; +const AxisSettings SettingsAxis1 = {AXIS1_STEPS_PER_DEGREE*RAD_DEG_RATIO, {degToRadF(AXIS1_LIMIT_MIN), degToRadF(AXIS1_LIMIT_MAX)}, siderealToRad(TRACK_BACKLASH_RATE)}; +} + +Motor& motor1 = motor_1; + +Axis axis1(1, &PinsAxis1, &SettingsAxis1, AXIS_MEASURE_RADIANS, arcsecToRad(AXIS1_TARGET_TOLERANCE)); + +// Axis2 motion controller + +namespace { + +#if defined(AXIS2_ODRIVE_PRESENT) + const ODriveDriverSettings DriverSettingsAxis2 = {AXIS2_DRIVER_MODEL, AXIS2_DRIVER_STATUS}; + ODriveMotor motor_2(2, AXIS2_REVERSE, &DriverSettingsAxis2, (AXIS2_STEPS_PER_DEGREE*RAD_DEG_RATIO)); + +#elif defined(AXIS2_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis2 = {AXIS2_DRIVER_MODEL, AXIS2_DRIVER_STATUS}; + KTechMotor motor_2(2, AXIS2_REVERSE, &DriverSettingsAxis2); + +#elif defined(AXIS2_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis2 = {AXIS2_DRIVER_MODEL, AXIS2_DRIVER_STATUS}; + Mks42DMotor motor_2(2, AXIS2_REVERSE, &DriverSettingsAxis2, AXIS2_STEPS_PER_DEGREE); + +#elif defined(AXIS2_SERVO_PRESENT) + ServoControl servoControlAxis2; + + #if AXIS2_ENCODER == AB + Quadrature encAxis2(2, AXIS2_ENCODER_A_PIN, AXIS2_ENCODER_B_PIN); + #elif AXIS2_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis2(2, AXIS2_ENCODER_A_PIN, AXIS2_ENCODER_B_PIN); + #elif AXIS2_ENCODER == CW_CCW + CwCcw encAxis2(2, AXIS2_ENCODER_A_PIN, AXIS2_ENCODER_B_PIN); + #elif AXIS2_ENCODER == PULSE_DIR + PulseDir encAxis2(2, AXIS2_ENCODER_A_PIN, AXIS2_ENCODER_B_PIN); + #elif AXIS2_ENCODER == PULSE_ONLY + PulseOnly encAxis2(2, AXIS2_ENCODER_A_PIN, &servoControlAxis2.directionHint); + #elif AXIS2_ENCODER == VIRTUAL + VirtualEnc encAxis2(2); + #elif AXIS2_ENCODER == AS37_H39B_B + As37h39bb encAxis2(2, AXIS2_ENCODER_A_PIN, AXIS2_ENCODER_B_PIN); + #elif AXIS2_ENCODER == JTW_24BIT + Jtw24 encAxis2(2, AXIS2_ENCODER_A_PIN, AXIS2_ENCODER_B_PIN); + #elif AXIS2_ENCODER == JTW_26BIT + Jtw26 encAxis2(2, AXIS2_ENCODER_A_PIN, AXIS2_ENCODER_B_PIN); + #elif AXIS2_ENCODER == LIKA_ASC85 + LikaAsc85 encAxis2(2, AXIS2_ENCODER_A_PIN, AXIS2_ENCODER_B_PIN); + #elif AXIS2_ENCODER == KTECH_IME + KTechIME encAxis2(2); + #elif AXIS2_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis2(2); + #endif + + #if AXIS2_SERVO_FEEDBACK == PID + Pid feedbackAxis2(AXIS2_PID_P, AXIS2_PID_I, AXIS2_PID_D); + #elif AXIS2_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis2(AXIS2_PID_P, AXIS2_PID_I, AXIS2_PID_D, AXIS2_PID_P_GOTO, AXIS2_PID_I_GOTO, AXIS2_PID_D_GOTO, AXIS2_PID_SENSITIVITY); + #endif + + #if AXIS2_SERVO_FLTR == KALMAN + KalmanFilter filterAxis2(AXIS2_SERVO_FLTR_MEAS_U, AXIS2_SERVO_FLTR_VARIANCE); + #elif AXIS2_SERVO_FLTR == ROLLING + RollingFilter filterAxis2(AXIS2_SERVO_FLTR_WSIZE); + #elif AXIS2_SERVO_FLTR == OFF + Filter filterAxis2; + #endif + + const ServoPins DriverPinsAxis2 = {AXIS2_SERVO_PH1_PIN, AXIS2_SERVO_PH1_STATE, AXIS2_SERVO_PH2_PIN, AXIS2_SERVO_PH2_STATE, AXIS2_ENABLE_PIN, AXIS2_ENABLE_STATE, AXIS2_M0_PIN, AXIS2_M1_PIN, AXIS2_M2_PIN, AXIS2_M3_PIN, AXIS2_FAULT_PIN}; + const ServoSettings DriverSettingsAxis2 = {AXIS2_DRIVER_MODEL, AXIS2_DRIVER_STATUS, AXIS2_SERVO_ACCELERATION}; + + #if AXIS2_DRIVER_MODEL == SERVO_EE + ServoEE driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_SERVO_DC_PWR_MIN, AXIS2_SERVO_DC_PWR_MAX); + #elif AXIS2_DRIVER_MODEL == SERVO_PE + ServoPE driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_SERVO_DC_PWR_MIN, AXIS2_SERVO_DC_PWR_MAX); + #elif AXIS2_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc2130DC driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_SERVO_DC_PWR_MIN, AXIS2_SERVO_DC_PWR_MAX); + #elif AXIS2_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc5160DC driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_SERVO_DC_PWR_MIN, AXIS2_SERVO_DC_PWR_MAX); + #elif AXIS2_DRIVER_MODEL == SERVO_TMC2209 + ServoTmc2209 driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_MOTOR_STEPS_PER_DEGREE/AXIS2_STEPS_PER_DEGREE, AXIS2_DRIVER_MICROSTEPS, AXIS2_DRIVER_IRUN, AXIS2_DRIVER_DECAY, AXIS2_DRIVER_DECAY_GOTO); + #elif AXIS2_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_MOTOR_STEPS_PER_DEGREE/AXIS2_STEPS_PER_DEGREE, AXIS2_DRIVER_MICROSTEPS, AXIS2_DRIVER_IRUN, AXIS2_DRIVER_DECAY, AXIS2_DRIVER_DECAY_GOTO); + #elif AXIS2_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver2(2, &DriverSettingsAxis2, AXIS2_MOTOR_STEPS_PER_DEGREE/AXIS2_STEPS_PER_DEGREE); + #endif + + ServoMotor motor_2(2, AXIS2_REVERSE, ((ServoDriver*)&driver2), &filterAxis2, &encAxis2, AXIS2_ENCODER_ORIGIN, AXIS2_ENCODER_REVERSE == ON, &feedbackAxis2, &servoControlAxis2); + +#elif defined(AXIS2_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis2 = {AXIS2_M0_PIN, AXIS2_M1_PIN, AXIS2_M2_PIN, AXIS2_M2_ON_STATE, AXIS2_M3_PIN, AXIS2_DECAY_PIN, AXIS2_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis2 = {AXIS2_DRIVER_MODEL, AXIS2_DRIVER_STATUS, AXIS2_DRIVER_MICROSTEPS, AXIS2_DRIVER_MICROSTEPS_GOTO, AXIS2_DRIVER_DECAY, AXIS2_DRIVER_DECAY_GOTO}; + #if AXIS2_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS2_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2); + #elif AXIS2_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_DRIVER_IHOLD, AXIS2_DRIVER_IRUN, AXIS2_DRIVER_IGOTO, AXIS2_DRIVER_INTPOL); + #elif AXIS2_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_DRIVER_IHOLD, AXIS2_DRIVER_IRUN, AXIS2_DRIVER_IGOTO, AXIS2_DRIVER_INTPOL); + #elif AXIS2_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_DRIVER_IHOLD, AXIS2_DRIVER_IRUN, AXIS2_DRIVER_IGOTO, AXIS2_DRIVER_INTPOL); + #elif AXIS2_DRIVER_MODEL == TMC2209 || AXIS2_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_DRIVER_IHOLD, AXIS2_DRIVER_IRUN, AXIS2_DRIVER_IGOTO, AXIS2_DRIVER_INTPOL); + #elif AXIS2_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_DRIVER_IHOLD, AXIS2_DRIVER_IRUN, AXIS2_DRIVER_IGOTO, AXIS2_DRIVER_INTPOL); + #elif AXIS2_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_DRIVER_IHOLD, AXIS2_DRIVER_IRUN, AXIS2_DRIVER_IGOTO, AXIS2_DRIVER_INTPOL); + #elif AXIS2_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver2(2, &DriverPinsAxis2, &DriverSettingsAxis2, AXIS2_DRIVER_IHOLD, AXIS2_DRIVER_IRUN, AXIS2_DRIVER_IGOTO, AXIS2_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis2 = {AXIS2_STEP_PIN, AXIS2_STEP_STATE, AXIS2_DIR_PIN, AXIS2_ENABLE_PIN, AXIS2_ENABLE_STATE}; + StepDirMotor motor_2(2, AXIS2_REVERSE, &StepDirPinsAxis2, ((StepDirDriver*)&driver2)); + +#else + #error "Configuration (Config.h): MOUNT_PRESENT without AXIS2_DRIVER_MODEL should never happen!" +#endif + +const AxisPins PinsAxis2 = {AXIS2_SENSE_LIMIT_MIN_PIN, AXIS2_SENSE_HOME_PIN, AXIS2_SENSE_LIMIT_MAX_PIN, {AXIS2_SENSE_HOME, AXIS2_SENSE_HOME_INIT, degToRadF(AXIS2_SENSE_HOME_DIST_LIMIT), AXIS2_SENSE_LIMIT_MIN, AXIS2_SENSE_LIMIT_MAX, AXIS2_SENSE_LIMIT_INIT}}; +const AxisSettings SettingsAxis2 = {AXIS2_STEPS_PER_DEGREE*RAD_DEG_RATIO, {degToRadF(AXIS2_LIMIT_MIN), degToRadF(AXIS2_LIMIT_MAX)}, siderealToRad(TRACK_BACKLASH_RATE)}; +} + +Motor& motor2 = motor_2; + +Axis axis2(2, &PinsAxis2, &SettingsAxis2, AXIS_MEASURE_RADIANS, arcsecToRad(AXIS2_TARGET_TOLERANCE)); + +#endif diff --git a/src/telescope/mount/Mount.command.cpp b/src/telescope/mount/Mount.command.cpp new file mode 100755 index 0000000..4f8a963 --- /dev/null +++ b/src/telescope/mount/Mount.command.cpp @@ -0,0 +1,489 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, commands + +#include "Mount.h" + +#ifdef MOUNT_PRESENT + +#include "../../lib/tasks/OnTask.h" +#include "../../lib/nv/Nv.h" + +#include "site/Site.h" +#include "coordinates/Transform.h" +#include "goto/Goto.h" +#include "guide/Guide.h" +#include "limits/Limits.h" +#include "park/Park.h" + +bool Mount::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + char *conv_end; + PrecisionMode precisionMode = PM_HIGH; + + if (command[0] == 'G') { + // :GA# Get Mount Altitude + // Returns: sDD*MM# or sDD*MM'SS# (based on precision setting) + // :GAH# High precision + // Returns: sDD*MM'SS.SSS# (high precision) + if (command[1] == 'A' && (parameter[0] == 0 || parameter[1] == 0)) { + if (parameter[0] == 'H') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + double a = getPosition(CR_MOUNT_ALT).a; + #if AXIS1_SECTOR_GEAR == OFF && AXIS2_TANGENT_ARM == OFF + if (guide.state == GU_HOME_GUIDE || guide.state == GU_HOME_GUIDE_ABORT) { + Coordinate homePosition = home.getPosition(CR_MOUNT_ALT); + a = transform.mountToNative(&homePosition).a; + } + #endif + convert.doubleToDms(reply, radToDeg(a), false, true, precisionMode); + *numericReply = false; + } else + + // :GD# Get Mount Declination + // Returns: sDD*MM# or sDD*MM:SS# (based on precision setting) + // :GDH# Returns: sDD*MM:SS.SSS# (high precision) + if (command[1] == 'D' && (parameter[0] == 0 || parameter[1] == 0)) { + if (parameter[0] == 'H' || parameter[0] == 'e') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + double d = getPosition().d; + #if AXIS1_SECTOR_GEAR == OFF && AXIS2_TANGENT_ARM == OFF + if (guide.state == GU_HOME_GUIDE || guide.state == GU_HOME_GUIDE_ABORT) { + Coordinate homePosition = home.getPosition(); + d = transform.mountToNative(&homePosition).d; + } + #endif + convert.doubleToDms(reply, radToDeg(d), false, true, precisionMode); + *numericReply = false; + } else + + // :GR# Get Mount Right Ascension + // Returns: HH:MM.T# or HH:MM:SS# (based on precision setting) + // :GRH# Returns: HH:MM:SS.SSSS# (high precision) + if (command[1] == 'R' && (parameter[0] == 0 || parameter[1] == 0)) { + if (parameter[0] == 'H' || parameter[0] == 'a') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + double r = getPosition().r; + #if AXIS1_SECTOR_GEAR == OFF && AXIS2_TANGENT_ARM == OFF + if (guide.state == GU_HOME_GUIDE || guide.state == GU_HOME_GUIDE_ABORT) { + Coordinate homePosition = home.getPosition(); + r = transform.mountToNative(&homePosition).r; + } + #endif + convert.doubleToHms(reply, radToHrs(r), false, precisionMode); + *numericReply = false; + } else + + // :GT# Get tracking rate, 0.0 unless TrackingSidereal + // Returns: n.n# (OnStep returns more decimal places than LX200 standard) + if (command[1] == 'T' && parameter[0] == 0) { + if (trackingState == TS_NONE) strcpy(reply,"0"); else sprintF(reply, "%0.5f", siderealToHz(trackingRate)); + *numericReply = false; + } else + + // :GX OnStep extended command + if (command[1] == 'X' && parameter[2] == 0) { + + // :GX4[n]# Get angles [n] + // (0 and 1) Returns instrument angle in: DDD:MM:SS# + // (2 and 3) Returns instrument angle in: n.nnnnnn# + // (4 and 5) Returns encoder angle in counts: n# + if (parameter[0] == '4') { + *numericReply = false; + switch (parameter[1]) { + case '0': convert.doubleToDms(reply, radToDeg(axis1.getInstrumentCoordinate()), true, true, PM_HIGH); break; + case '1': convert.doubleToDms(reply, radToDeg(axis2.getInstrumentCoordinate()), true, true, PM_HIGH); break; + case '2': sprintF(reply, "%0.6f", radToDeg(axis1.getInstrumentCoordinate())); break; + case '3': sprintF(reply, "%0.6f", radToDeg(axis2.getInstrumentCoordinate())); break; + case '4': sprintf(reply, "%ld", (long)axis1.motor->getEncoderCount()); break; + case '5': sprintf(reply, "%ld", (long)axis2.motor->getEncoderCount()); break; + default: *numericReply = true; *commandError = CE_CMD_UNKNOWN; + } + } else + + // :GXE[m]# Get mount setting + // Returns: n# + if (parameter[0] == 'E') { + switch (parameter[1]) { + case '4': sprintf(reply, "%ld", lround(axis1.getStepsPerMeasure()/RAD_DEG_RATIO)); *numericReply = false; break; + case '5': sprintf(reply, "%ld", lround(axis2.getStepsPerMeasure()/RAD_DEG_RATIO)); *numericReply = false; break; + case 'E': reply[0] = '0' + (MOUNT_COORDS - 1); *suppressFrame = true; *numericReply = false; break; + case 'F': if (AXIS2_TANGENT_ARM != ON) *commandError = CE_0; break; + case 'G': if (AXIS1_SECTOR_GEAR != ON) *commandError = CE_0; break; + case 'M': sprintf(reply, "%d", (int)settings.mountType); *numericReply = false; break; + default: + return false; + } + } else + + // :GXFn# Get frequency setting and workload + // Returns: Value + if (parameter[0] == 'F') { + switch (parameter[1]) { + case '3': sprintF(reply, "%0.6f", (axis1.getDirection() == DIR_FORWARD) ? axis1.getFrequencySteps() : -axis1.getFrequencySteps()); *numericReply = false; break; + case '4': sprintF(reply, "%0.6f", (axis2.getDirection() == DIR_FORWARD) ? axis2.getFrequencySteps() : -axis2.getFrequencySteps()); *numericReply = false; break; + case 'A': sprintf(reply, "%d%%", 50); *numericReply = false; break; // workload + case 'F': // index position for Axis1 + sprintF(reply, "%0.6f", radToDeg(transform.instrumentToMount(axis1.getIndexPosition(), axis2.getIndexPosition()).a1)); + *numericReply = false; + break; + case 'G': // index position for Axis2 + sprintF(reply, "%0.6f", radToDeg(transform.instrumentToMount(axis1.getIndexPosition(), axis2.getIndexPosition()).a2)); + *numericReply = false; + break; + default: + return false; + } + } else + + // :GXTD# Get tracking rate offset Dec in arc-seconds/sidereal second + // Returns: n.nnnnnn# + if (parameter[0] == 'T' && parameter[1] == 'D' && parameter[2] == 0) { + sprintF(reply, "%0.8f", trackingRateOffsetDec*15.0F); + *numericReply = false; + } else + + // :GXTR# Get tracking rate offset RA in arc-seconds/sidereal second + // Returns: n.nnnnnn# + if (parameter[0] == 'T' && parameter[1] == 'R' && parameter[2] == 0) { + sprintF(reply, "%0.8f", trackingRateOffsetRA*15.0F); + *numericReply = false; + } else return false; + + } else + + // :GZ# Get Mount Azimuth + // Returns: DDD*MM# or DDD*MM'SS# (based on precision setting) + // :GZH# High precision + // Returns: DDD*MM'SS.SSS# (high precision) + if (command[1] == 'Z' && (parameter[0] == 0 || parameter[1] == 0)) { + if (parameter[0] == 'H') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + double z = getPosition(CR_MOUNT_HOR).z; + #if AXIS1_SECTOR_GEAR == OFF && AXIS2_TANGENT_ARM == OFF + if (guide.state == GU_HOME_GUIDE || guide.state == GU_HOME_GUIDE_ABORT) { + Coordinate homePosition = home.getPosition(CR_MOUNT_ALT); + z = transform.mountToNative(&homePosition).z; + } + #endif + convert.doubleToDms(reply, NormalizeAzimuth(radToDeg(z)), true, false, precisionMode); + *numericReply = false; + } else return false; + } else + + if (command[0] == 'S') { + // :ST[H.H]# Set Tracking Rate in Hz where 60.0 is the solar rate + // Return: 0 on failure + // 1 on success + if (command[1] == 'T') { + double f = strtod(parameter,&conv_end); + if (¶meter[0] != conv_end && ((f >= 30.0 && f < 90.0) || fabs(f) < 0.1)) { + if (fabs(f) < 0.1) tracking(false); else { + #if GOTO_FEATURE == ON + if (park.state != PS_PARKED) { + trackingRate = hzToSidereal(f); + tracking(true); + } + #endif + } + } else *commandError = CE_PARAM_RANGE; + } else + + // :SEO# Set coordinate origin for absolute encoders or mount coordinate memory + // Return: 0 on failure + // 1 on success + if (command[1] == 'E' && parameter[0] == 'O' && parameter[1] == 0) { + if (park.state == PS_PARKED) { *commandError = CE_PARKED; return true; } + if (!mount.isTracking() && !mount.isSlewing()) { + bool handled = false; + + #ifdef HAS_ABSOLUTE_ENCODER_SERVO + handled = true; + VLF("MSG: Mount, setting absolute encoder origin"); + + #if AXIS1_ENCODER == SERIAL_BRIDGE && AXIS2_ENCODER == SERIAL_BRIDGE && defined(SERIAL_ENCODER) + SERIAL_ENCODER.print(":SO#"); + #else + uint32_t zero = (uint32_t)axis1.motor->encoderZero(); + V("MSG: Mount, absolute encoder saving AXIS1_ENCODER_OFFSET "); V(uint32_t(zero)); VLF(" to NV/EEPROM"); + nv().kv().put("AXIS1_ENCODER_ORIGIN", zero); + + zero = (uint32_t)axis2.motor->encoderZero(); + V("MSG: Mount, absolute encoder saving AXIS2_ENCODER_OFFSET "); V(uint32_t(zero)); VLF(" to NV/EEPROM"); + nv().kv().put("AXIS2_ENCODER_ORIGIN", zero); + #endif + + #ifdef HAL_RESET + enable(false); + VLF("MSG: Mount, resetting OnStep..."); + if (nv().device().hasCommit()) { nv().device().commit(); } + const uint32_t startMs = millis(); + const uint32_t timeoutMs = 5000; + while (!nv().device().commitDone() && (uint32_t)(millis() - startMs) < timeoutMs) { tasks.yield(1); } + tasks.yield(1000); + HAL_RESET(); + #endif + #endif + + #if MOUNT_COORDS_MEMORY == ON + if (!handled && !goTo.absoluteEncodersPresent) { + CommandError e = home.reset(true, true); + if (e != CE_NONE) { *commandError = e; return true; } + + limits.enabled(site.isDateTimeReady()); + + syncFromOnStepToEncoders = true; + handled = true; + + VLF("MSG: Mount, setting mount coordinate memory origin"); + } + #endif + + if (!handled) { + *commandError = CE_0; + DLF("MSG: Mount, setting coordinate origin failed; feature unavailable"); + } + } else { + *commandError = CE_0; + DLF("MSG: Mount, setting coordinate origin failed; the mount is in motion!"); + } + } else + + if (command[1] == 'X') { + if (parameter[2] != ',') { *commandError = CE_PARAM_FORM; return true; } + + // :SX4[m],[n]# Set encoder axis [m] to value [n] + // Return: 0 on failure + // 1 on success + if (parameter[0] == '4') { + double d; + static double encoderAxis1 = NAN; + static double encoderAxis2 = NAN; + + switch (parameter[1]) { + + // stage encoder Axis1 value (depreciated) + case '0': + d = strtod(¶meter[3], &conv_end); + if (¶meter[3] != conv_end && fabs(d) <= 360.0L) { encoderAxis1 = degToRad(d); } else { encoderAxis1 = NAN; *commandError = CE_PARAM_RANGE; } + break; + + // stage encoder Axis2 value (depreciated) + case '1': + d = strtod(¶meter[3], &conv_end); + if (¶meter[3] != conv_end && fabs(d) <= 360.0L) { encoderAxis2 = degToRad(d); } else { encoderAxis2 = NAN; *commandError = CE_PARAM_RANGE; } + break; + + // sync from encoder values (depreciated) + case '2': + if (parameter[3] == '1' && parameter[4] == 0) { + #if GOTO_FEATURE == ON + CommandError e = goTo.validate(); + if (e != CE_NONE) { *commandError = e; return true; } + #endif + if (isnan(encoderAxis1) || isnan(encoderAxis2) || syncFromOnStepToEncoders) { *commandError = CE_0; return true; } + *commandError = limits.validateInstrumentCoordinate(1, encoderAxis1, true); + if (*commandError == CE_NONE) *commandError = limits.validateInstrumentCoordinate(2, encoderAxis2, true); + if (*commandError != CE_NONE) return true; + *commandError = limits.setInstrumentCoordinate(1, encoderAxis1, true); + if (*commandError == CE_NONE) *commandError = limits.setInstrumentCoordinate(2, encoderAxis2, true); + if (*commandError != CE_NONE) return true; + } + break; + + // allow sws to control sync mode + case '3': syncFromOnStepToEncoders = false; break; + + // set and sync from encoder Axis1 and Axis2 values + // append 'a' if both SWS encoder values are absolute and trusted + case '4': { + bool absoluteAuthority = false; + d = strtod(¶meter[3], &conv_end); + if (¶meter[3] != conv_end && fabs(d) <= 360.0L) { encoderAxis1 = degToRad(d); } else { encoderAxis1 = NAN; } + + char *parameter2 = strchr(¶meter[3], ','); parameter2++; + d = strtod(parameter2, &conv_end); + if (parameter2 != conv_end && fabs(d) <= 360.0L) { + encoderAxis2 = degToRad(d); + if (conv_end[0] == 'a' && conv_end[1] == 0) absoluteAuthority = true; else + if (conv_end[0] != 0) encoderAxis2 = NAN; + } else { encoderAxis2 = NAN; } + + #if GOTO_FEATURE == ON + CommandError e = goTo.validate(); + if (e != CE_NONE && e != CE_SLEW_ERR_IN_STANDBY && e != CE_SLEW_IN_SLEW) { *commandError = e; return true; } + #endif + + if ( isnan(encoderAxis1) || + isnan(encoderAxis2) || + syncFromOnStepToEncoders || + (goTo.state != GS_NONE && goTo.stage != GG_NEAR_DESTINATION_WAIT) || + guide.state != GU_NONE) { *commandError = CE_0; return true; } + + *commandError = limits.validateInstrumentCoordinate(1, encoderAxis1, true); + if (*commandError == CE_NONE) *commandError = limits.validateInstrumentCoordinate(2, encoderAxis2, true); + if (*commandError != CE_NONE) return true; + *commandError = limits.setInstrumentCoordinate(1, encoderAxis1, true); + if (*commandError == CE_NONE) *commandError = limits.setInstrumentCoordinate(2, encoderAxis2, true); + if (*commandError != CE_NONE) return true; + if (absoluteAuthority) { + captureNominalIndexPositions(); + setStartupAuthorityTrusted(true); + goTo.absoluteEncodersPresent = true; + goTo.encodersPresent = true; + VLF("MSG: Mount, sync from trusted paired absolute SWS encoders"); + } + break; } + + default: *commandError = CE_CMD_UNKNOWN; break; + } + } else + + // :SXEM,[n]# Set mount type (for next restart) where n=0 for default + // Return: 0 on failure + // 1 on success + if (parameter[0] == 'E' && parameter[1] == 'M') { + long mountType = atol(¶meter[3]); + if (mountType == 0 || + (mountType == GEM && AXIS1_WRAP == OFF) || + (mountType == FORK && AXIS1_WRAP == OFF) || + (mountType == ALTAZM && AXIS2_TANGENT_ARM == OFF)) { + settings.mountType = mountType; + nv().kv().put(nvKey, settings); + } else *commandError = CE_PARAM_RANGE; + } else + + // :SXTD,n.n# Set tracking rate offset Dec in arc-seconds/sidereal second + // Return: 0 on failure + // 1 on success + if (parameter[0] == 'T' && parameter[1] == 'D') { + float f = strtod(¶meter[3], &conv_end); + if (f < -1800.0F) f = -1800.0F; + if (f > 1800.0F) f = 1800.0F; + trackingRateOffsetDec = f/15.0F; + } else + + // :SXTR,n.n# Set tracking rate offset RA in arc-seconds/sidereal second + // Return: 0 failure, 1 success + if (parameter[0] == 'T' && parameter[1] == 'R') { + float f = strtod(¶meter[3], &conv_end); + if (f < -1800.0F) f = -1800.0F; + if (f > 1800.0F) f = 1800.0F; + trackingRateOffsetRA = f/15.0F; + } else return false; + + } else return false; + } else + + // T - Tracking Commands + // + // :TS# Track rate solar 60Hz + // :TK# Track rate king 60.136Hz + // :TL# Track rate lunar 57.9Hz + // :TQ# Track rate sidereal 60.164Hz + // + // :T+# Master sidereal clock faster by 0.02 Hertz (stored in EEPROM) + // :T-# Master sidereal clock slower by 0.02 Hertz (stored in EEPROM) + // :TR# Master sidereal clock reset (to calculated sidereal rate, stored in EEPROM) + // Returns: Nothing + // + // :Te# Tracking enable + // :Td# Tracking disable + // + // :To# Track full compensation on + // :Tr# Track refraction compensation on + // :Tn# Track compensation off + // :T1# Track dual axis off (disable Dec tracking on Eq mounts) + // :T2# Track dual axis on + // Return: 0 on failure + // 1 on success + if (command[0] == 'T' && parameter[0] == 0) { + if (command[1] == 'o') { settings.rc = RC_MODEL; } else + if (command[1] == 'r') { settings.rc = RC_REFRACTION; } else + if (command[1] == 'n') { settings.rc = RC_NONE; } else + if (command[1] == '1') { + if (settings.rc == RC_REFRACTION_DUAL) settings.rc = RC_REFRACTION; else + if (settings.rc == RC_MODEL_DUAL) settings.rc = RC_MODEL; + } else + if (command[1] == '2') { + if (settings.rc == RC_REFRACTION) settings.rc = RC_REFRACTION_DUAL; else + if (settings.rc == RC_MODEL) settings.rc = RC_MODEL_DUAL; + } else + if (command[1] == 'S') { trackingRate = hzToSidereal(SOLAR_RATE_HZ); } else + if (command[1] == 'K') { trackingRate = hzToSidereal(KING_RATE_HZ); } else + if (command[1] == 'L') { trackingRate = hzToSidereal(LUNAR_RATE_HZ); } else + if (command[1] == 'Q') { trackingRate = hzToSidereal(SIDEREAL_RATE_HZ); } else + if (command[1] == '+') { site.setSiderealPeriod(site.getSiderealPeriod() - hzToSubMicros(0.02F)); } else + if (command[1] == '-') { site.setSiderealPeriod(site.getSiderealPeriod() + hzToSubMicros(0.02F)); } else + if (command[1] == 'R') { site.setSiderealPeriod(SIDEREAL_PERIOD); } else + if (command[1] == 'e') { + #if GOTO_FEATURE == ON + if (park.state != PS_PARKED) { + #endif + tracking(true); + #if GOTO_FEATURE == ON + } else *commandError = CE_PARKED; + #endif + } else + if (command[1] == 'd') { + tracking(false); + } else *commandError = CE_CMD_UNKNOWN; + + if (!transform.isEquatorial()) { + if (settings.rc == RC_MODEL) settings.rc = RC_MODEL_DUAL; + if (settings.rc == RC_REFRACTION) settings.rc = RC_REFRACTION_DUAL; + } + + if (*commandError == CE_NONE) { + switch (command[1]) { case 'S': case 'K': case 'L': case 'Q': case '+': case '-': case 'R': *numericReply = false; } + nv().kv().put(nvKey, settings); + update(); + } + } else + + // $ - Set parameter + // :$BD[n]# Set Dec/Alt backlash in arc-seconds + // Return: 0 on failure + // 1 on success + // :$BR[n]# Set RA/Azm backlash in arc-seconds + // Return: 0 on failure + // 1 on success + // Set the Backlash values. Units are arc-seconds + if (command[0] == '$' && command[1] == 'B') { + int16_t arcSecs; + if (convert.atoi2((char*)¶meter[1], &arcSecs)) { + if (arcSecs >= 0 && arcSecs <= 3600) { + if (parameter[0] == 'D') { + settings.backlash.axis2 = arcsecToRad(arcSecs); + axis2.setBacklash(settings.backlash.axis2); + nv().kv().put(nvKey, settings); + } else + if (parameter[0] == 'R') { + settings.backlash.axis1 = arcsecToRad(arcSecs); + axis1.setBacklash(settings.backlash.axis1); + nv().kv().put(nvKey, settings); + } else *commandError = CE_CMD_UNKNOWN; + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + // % - Return parameter + // :%BD# Get Dec/Alt Antibacklash value in arc-seconds + // Return: n# + // :%BR# Get RA/Azm Antibacklash value in arc-seconds + // Return: n# + if (command[0] == '%' && command[1] == 'B' && parameter[1] == 0) { + if (parameter[0] == 'D') { + int arcSec = round(radToArcsec(settings.backlash.axis2)); + if (arcSec < 0) arcSec = 0; + if (arcSec > 3600) arcSec = 3600; + sprintf(reply, "%d", arcSec); + *numericReply = false; + } else + if (parameter[0] == 'R') { + int arcSec = round(radToArcsec(settings.backlash.axis1)); + if (arcSec < 0) arcSec = 0; + if (arcSec > 3600) arcSec = 3600; + sprintf(reply, "%d", arcSec); + *numericReply = false; + } else *commandError = CE_CMD_UNKNOWN; + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/mount/Mount.cpp b/src/telescope/mount/Mount.cpp new file mode 100755 index 0000000..f13f9af --- /dev/null +++ b/src/telescope/mount/Mount.cpp @@ -0,0 +1,597 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control + +#include "Mount.h" + +#ifdef MOUNT_PRESENT + +#include "../../lib/tasks/OnTask.h" +#include "../../lib/nv/Nv.h" + +#include "../Telescope.h" +#include "coordinates/Transform.h" +#include "goto/Goto.h" +#include "guide/Guide.h" +#include "home/Home.h" +#include "library/Library.h" +#include "limits/Limits.h" +#include "park/Park.h" +#include "pec/Pec.h" +#include "site/Site.h" +#include "st4/St4.h" +#include "status/Status.h" + +#if MOUNT_COORDS_MEMORY == ON && (NV_DRIVER != NV_MB85RC32 && NV_DRIVER != NV_MB85RC64 && NV_DRIVER != NV_MB85RC256) + #error "Configuration (Config.h): Setting MOUNT_COORDS_MEMORY requires a NV storage device with very high write endurance (FRAM)" +#endif + +inline void mountWrapper() { mount.poll(); } +inline void autostartWrapper() { mount.autostartPostponed(); } + +void Mount::init() { + absoluteCoordinateOriginsEstablished = true; + + nvKey = nv().kv().computeKey("MOUNT_SETTINGS"); + if (!nv().kv().getOrInit(nvKey, settings)) { DLF("WRN: Nv, init failed for MOUNT_SETTINGS"); } + + // get the main axes ready + delay(100); + if (!axis1.init(&motor1)) { initError.driver = true; DLF("ERR: Mount::init(), no motion controller for Axis1!"); } else { + axis1.setBacklash(settings.backlash.axis1); + axis1.setMotionLimitsCheck(false); + if (AXIS1_POWER_DOWN == ON) axis1.setPowerDownTime(AXIS1_POWER_DOWN_TIME); + #ifdef AXIS1_ENCODER_ORIGIN + uint32_t origin = UINT32_MAX; + if (AXIS1_ENCODER_ORIGIN == 0) { + nv().kv().getOrInit("AXIS1_ENCODER_ORIGIN", origin); + if (origin != UINT32_MAX) axis1.motor->encoderSetOrigin(origin); else absoluteCoordinateOriginsEstablished = false; + } + #endif + } + + delay(100); + if (!axis2.init(&motor2)) { initError.driver = true; DLF("ERR: Mount::init(), no motion controller for Axis2!"); } else { + axis2.setBacklash(settings.backlash.axis2); + axis2.setMotionLimitsCheck(false); + if (AXIS2_POWER_DOWN == ON) axis2.setPowerDownTime(AXIS2_POWER_DOWN_TIME); + #ifdef AXIS2_ENCODER_ORIGIN + uint32_t origin = UINT32_MAX; + if (AXIS2_ENCODER_ORIGIN == 0) { + nv().kv().getOrInit("AXIS2_ENCODER_ORIGIN", origin); + if (origin != UINT32_MAX) axis2.motor->encoderSetOrigin(origin); else absoluteCoordinateOriginsEstablished = false; + } + #endif + } +} + +void Mount::begin() { + startupAuthorityTrustedValue = false; + + axis1.calibrateDriver(); + axis1.enable(MOUNT_ENABLE_IN_STANDBY == ON); + axis2.calibrateDriver(); + axis2.enable(MOUNT_ENABLE_IN_STANDBY == ON); + + // initialize the critical subsystems + site.init(); + + // invalid mount type, set default + if (settings.mountType < MOUNT_SUBTYPE_FIRST || settings.mountType > MOUNT_SUBTYPE_LAST) { + settings.mountType = MOUNT_SUBTYPE; + nv().kv().put(nvKey, settings); + VLF("MSG: Transform, revert mount type to default"); + } + + if (MOUNT_TYPE == ALTALT) settings.mountType = MOUNT_SUBTYPE; + transform.init(settings.mountType); + + // setup compensated tracking as configured + if (TRACK_COMPENSATION_MEMORY == OFF) settings.rc = RC_DEFAULT; + if (!transform.isEquatorial()) { + if (settings.rc == RC_MODEL) settings.rc = RC_MODEL_DUAL; + if (settings.rc == RC_REFRACTION) settings.rc = RC_REFRACTION_DUAL; + } + + // initialize the other subsystems + // Paired mount-axis absolute position sources can establish the initial + // coordinate basis at startup, so allow reset() to bypass sync-threshold + // checks only in that case. + const bool absoluteAxisAuthority = axis1.motor->hasAbsoluteEncoder() && axis2.motor->hasAbsoluteEncoder(); + home.reset(true, absoluteAxisAuthority && absoluteCoordinateOriginsEstablished); + limits.init(); + guide.init(); + + if (AXIS1_WRAP == ON) { + axis1.coordinateWrap(Deg360); + axis1.setLimitMin(-Deg360); + axis1.setLimitMax(Deg360); + } + + goTo.init(); + library.init(); + park.init(); + + #if AXIS1_PEC == ON + pec.init(); + #endif + + #if ST4_INTERFACE == ON + st4.init(); + #endif + + tracking(false); + + // restore where we were pointing + #if MOUNT_COORDS_MEMORY == ON + lastPosition.a1 = (float)axis1.getInstrumentCoordinate(); + lastPosition.a2 = (float)axis2.getInstrumentCoordinate(); + lastPosition.mountType = (uint8_t)(transform.mountType & 0x0Fu); + lastPosition.seq = 0; + lastPosition.untrusted = true; + + nvKeyLastA = nv().kv().computeKey("MOUNT_LAST_POS_A"); + nvKeyLastB = nv().kv().computeKey("MOUNT_LAST_POS_B"); + + if (!goTo.absoluteEncodersPresent && park.state != PS_PARKED) { + + MountPositionMemory a{}, b{}; + const bool foundA = (nv().kv().get(nvKeyLastA, a) == KvPartition::Status::Ok); + const bool foundB = (nv().kv().get(nvKeyLastB, b) == KvPartition::Status::Ok); + + const bool va = foundA && (a.mountType == (uint8_t)(transform.mountType & 0x0Fu)) && !a.untrusted; + const bool vb = foundB && (b.mountType == (uint8_t)(transform.mountType & 0x0Fu)) && !b.untrusted; + + const MountPositionMemory* best = nullptr; + + if (va && vb) { + const uint8_t d = (uint8_t)((a.seq - b.seq) & 3u); + best = (d == 1u) ? &a : (d == 3u) ? &b : &a; + } else if (va) { + best = &a; + } else if (vb) { + best = &b; + } + + if (best) { + lastPosition = *best; + if (limits.validateInstrumentCoordinate(1, lastPosition.a1, true) == CE_NONE && + limits.validateInstrumentCoordinate(2, lastPosition.a2, true) == CE_NONE) { + CommandError e = limits.setInstrumentCoordinate(1, lastPosition.a1, true); + if (e == CE_NONE) e = limits.setInstrumentCoordinate(2, lastPosition.a2, true); + if (e == CE_NONE) { + captureNominalIndexPositions(); + mount.syncFromOnStepToEncoders = true; + setStartupAuthorityTrusted(true); + } else { DLF("WRN: Mount, coordinate memory restore failed"); } + } else { + DLF("WRN: Mount, coordinate memory restore failed"); + } + } + } + #endif + + #if ALIGN_MAX_NUM_STARS > 1 && ALIGN_MODEL_MEMORY == ON + transform.align.modelRead(); + #endif + + #if MOUNT_STARTUP_MODE == SA_PERMISSIVE + setStartupAuthorityTrusted(true); + #elif MOUNT_STARTUP_MODE == SA_AUTO + #if MOUNT_COORDS_MEMORY == OFF + if (!axis1.motor->hasAbsoluteEncoder() && !axis2.motor->hasAbsoluteEncoder()) { + setStartupAuthorityTrusted(true); + } + #endif + #endif + + VF("MSG: Mount, start tracking monitor task (rate 1000ms priority 6)... "); + if (tasks.add(1000, 0, true, 6, mountWrapper, "MtTrack")) { VLF("success"); } else { VLF("FAILED!"); } + + update(); + autostart(); +} + +void Mount::setStartupAuthorityTrusted(bool state) { + #if NV_INIT_ERROR_REVOKES_AUTHORITY == ON + if (state && initError.nv) return; + #endif + + startupAuthorityTrustedValue = state; + + // If we have a trusted coordinate basis and date/time is ready, limits can + // be enforced immediately without waiting for a later goto/reset/unpark path. + if (startupAuthorityTrustedValue && site.isDateTimeReady()) limits.enabled(true); +} + +void Mount::captureNominalIndexPositions() { + nominalIndexAxis1Steps = axis1.getIndexPositionSteps(); + nominalIndexAxis2Steps = axis2.getIndexPositionSteps(); +} + +long Mount::getNominalIndexPositionSteps(uint8_t axisNumber) const { + switch (axisNumber) { + case 1: return nominalIndexAxis1Steps; + case 2: return nominalIndexAxis2Steps; + default: return 0; + } +} + +#if MOUNT_COORDS_MEMORY == ON +void Mount::saveCoordinateMemory(bool trusted) { + if (goTo.absoluteEncodersPresent) return; + if (nv().device().endurance() != NvDevice::Endurance::High) return; + + lastPosition.a1 = (float)axis1.getInstrumentCoordinate(); + lastPosition.a2 = (float)axis2.getInstrumentCoordinate(); + lastPosition.mountType = (uint8_t)(transform.mountType & 0x0Fu); + lastPosition.untrusted = !trusted; + if (lastPosition.seq == 3) lastPosition.seq = 0; else lastPosition.seq++; + nv().kv().put((lastPosition.seq & 1)? nvKeyLastA : nvKeyLastB, lastPosition); +} +#endif + +// get current equatorial position (Native coordinate system) +Coordinate Mount::getPosition(CoordReturn coordReturn) { + updatePosition(coordReturn); + return transform.mountToNative(¤t, false); +} + +// get current equatorial position (Mount coordinate system) +Coordinate Mount::getMountPosition(CoordReturn coordReturn) { + updatePosition(coordReturn); + return current; +} + +// handle all autostart tasks +void Mount::autostart() { + tasks.setDurationComplete(tasks.getHandleByName("MtAuto")); + tasks.add(2000, 0, true, 7, autostartWrapper, "MtAuto"); +} + +void Mount::autostartPostponed() { + // wait until OnStepX is fully up and running + if (!telescope.ready) return; + + // stop this task if already completed + static bool autoStartDone = false; + if (autoStartDone) { + tasks.setDurationComplete(tasks.getHandleByName("MtAuto")); + return; + } + + // handle the one case where this completes without the date/time available + static bool autoTrackDone = false; + if (!autoTrackDone && TRACK_AUTOSTART == ON && transform.isEquatorial() && park.state != PS_PARKED && !home.settings.automaticAtBoot) { + VLF("MSG: Mount, autostart tracking"); + tracking(true); + autoStartDone = true; + return; + } + + // wait for the date/time to be set + if (!site.isDateTimeReady()) return; + + // auto unpark + static bool autoUnparkDone = false; + if (!autoUnparkDone && park.state == PS_PARKED) { + #if GOTO_FEATURE == ON + VLF("MSG: Mount, autostart park restore"); + CommandError e = park.restore(TRACK_AUTOSTART == ON); + if (e != CE_NONE) { + DF("WRN: Mount, autostart park restore failed with code "); DL(e); + autoStartDone = true; + return; + } + #endif + } + autoUnparkDone = true; + + // auto home + static bool autoHomeDone = false; + if (!autoHomeDone && home.settings.automaticAtBoot) { + VLF("MSG: Mount, autostart home"); + CommandError e = home.request(); + if (e != CE_NONE) { + DF("WRN: Mount, autostart home request failed with code "); DL(e); + autoStartDone = true; + return; + } + } + autoHomeDone = true; + + // wait for any homing operation to complete + if (home.state == HS_HOMING) return; + if (home.failed) { + DLF("WRN: Mount, autostart home failed"); + autoStartDone = true; + return; + } + + // auto tracking + if (!autoTrackDone && TRACK_AUTOSTART == ON) { + VLF("MSG: Mount, autostart tracking"); + tracking(true); + } + autoTrackDone = true; + + autoStartDone = true; +} + +// enables or disables tracking, enabling tracking powers on the motors if necessary +void Mount::tracking(bool state) { + if (state == true) { + enable(state); + if (isEnabled()) trackingState = TS_SIDEREAL; + } else + + if (state == false) { + trackingState = TS_NONE; + } + + update(); +} + +// enables or disables power to the mount motors +void Mount::enable(bool state) { + if (state == true) { + #if LIMIT_STRICT == ON + if (!site.dateIsReady || !site.timeIsReady) return; + #endif + + mountStatus.wake(); + } else { + trackingState = TS_NONE; + update(); + } + + axis1.enable(state); + axis2.enable(state); +} + +// updates the tracking rates, etc. as appropriate for the mount state +// called once a second by poll() but available here for immediate action +void Mount::update() { + static int lastStatusFlashMs = 0; + int statusFlashMs = 0; + + #if GOTO_FEATURE == ON + if (goTo.state == GS_NONE && guide.state < GU_GUIDE) { + #else + if (guide.state < GU_GUIDE) { + #endif + + if (trackingState != TS_SIDEREAL) { + trackingRateAxis1 = 0.0F; + trackingRateAxis2 = 0.0F; + } + + float f1 = 0, f2 = 0; + if (!guide.activeAxis1() || guide.state == GU_PULSE_GUIDE) { + f1 = trackingRateAxis1; + if (transform.mountType != ALTAZM && transform.mountType != ALTALT) { + f1 += guide.rateAxis1; + #if AXIS1_PEC == ON + f1 += pec.rate; + #endif + } + axis1.setSynchronizedFrequency(siderealToRadF(f1)*SIDEREAL_RATIO_F*site.getSiderealRatio()); + } + + if (!guide.activeAxis2() || guide.state == GU_PULSE_GUIDE) { + f2 = trackingRateAxis2; + if (transform.mountType != ALTAZM && transform.mountType != ALTALT) f2 += guide.rateAxis2; + axis2.setSynchronizedFrequency(siderealToRadF(f2)*SIDEREAL_RATIO_F*site.getSiderealRatio()); + } + + f1 = fabs(f1); + f2 = fabs(f2); + if (f2 > f1) f1 = f2; + if (f1 < 0.20F) statusFlashMs = SF_STOPPED; else + if (f1 > 3.0F) statusFlashMs = SF_SLEWING; else statusFlashMs = 500.0F/f1; + } else { + statusFlashMs = SF_SLEWING; + axis2.setSynchronizedFrequency(0.0F); + } + + if (statusFlashMs != lastStatusFlashMs) { + lastStatusFlashMs = statusFlashMs; + mountStatus.flashRate(statusFlashMs); + xBusy = statusFlashMs == SF_SLEWING; + } +} + +void Mount::poll() { + #if NV_INIT_ERROR_REVOKES_AUTHORITY == ON + if (initError.nv && startupAuthorityTrustedValue) { + startupAuthorityTrustedValue = false; + DLF("WRN: Mount, startup authority trust cleared due to NV fault"); + } + #endif + + // stop any movement then disable on motor hardware fault + if (mount.motorFault()) { + if (startupAuthorityTrustedValue) { + startupAuthorityTrustedValue = false; + DLF("WRN: Mount, startup authority trust cleared due to motor/encoder fault"); + } + if (goTo.state > GS_NONE) goTo.abort(); else + if (guide.state > GU_NONE) guide.abort(); else + if (axis1.isEnabled() || axis2.isEnabled()) enable(false); + } + + #ifdef HAL_NO_DOUBLE_PRECISION + #define DiffRange 0.0087266463F // 30 arc-minutes in radians + #define DiffRange2 0.017453292F // 60 arc-minutes in radians + #else + #define DiffRange 2.908882086657216e-4L // 1 arc-minute in radians + #define DiffRange2 5.817764173314432e-4L // 2 arc-minutes in radians + #endif + #define DegenerateRange (DiffRange*1.5) // we were using Deg85 + + // keep track of where we are pointing + #if MOUNT_COORDS_MEMORY == ON + saveCoordinateMemory(startupAuthorityTrustedValue && home.state != HS_HOMING); + #endif + + if (trackingState == TS_NONE) { + trackingRateAxis1 = 0.0F; + trackingRateAxis2 = 0.0F; + update(); + return; + } + + if (transform.isEquatorial() && settings.rc == RC_NONE && trackingRateOffsetRA == 0.0F && trackingRateOffsetDec == 0.0F) { + trackingRateAxis1 = trackingRate; + trackingRateAxis2 = 0.0F; + update(); + return; + } + + // get positions 1 (or 30) arc-min ahead and behind the current + updatePosition(CR_MOUNT_ALL); + double altitude = current.a; + double declination = current.d; + double altitude2 = current.aa2; + + // on fast processors calculate true coordinate for a little more accuracy + #ifndef HAL_SLOW_PROCESSOR + transform.mountToTopocentric(¤t); + if (transform.mountType == ALTAZM) transform.horToEqu(¤t); else + if (transform.mountType == ALTALT) transform.aaToEqu(¤t); + #endif + + Y; + Coordinate ahead = current; + Coordinate behind = current; + double trackingRange = DiffRange*trackingRate; + ahead.h += trackingRange; + behind.h -= trackingRange; + + // create horizon coordinates that would exist ahead and behind the current position + if (transform.mountType == ALTAZM) { transform.equToHor(&ahead); transform.equToHor(&behind); Y; } else + if (transform.mountType == ALTALT) { transform.equToAa(&ahead); transform.equToAa(&behind); Y; } + + // apply (optional) pointing model and refraction + if (settings.rc == RC_MODEL || settings.rc == RC_MODEL_DUAL) { + transform.topocentricToObservedPlace(&ahead); Y; + transform.topocentricToObservedPlace(&behind); Y; + transform.observedPlaceToMount(&ahead); Y; + transform.observedPlaceToMount(&behind); Y; + } else if (settings.rc == RC_REFRACTION || settings.rc == RC_REFRACTION_DUAL) { + transform.topocentricToObservedPlace(&ahead); Y; + transform.topocentricToObservedPlace(&behind); Y; + } + + // drop the dual axis if not enabled + if (settings.rc != RC_REFRACTION_DUAL && settings.rc != RC_MODEL_DUAL) { behind.d = ahead.d; } + + // apply tracking rate offset to equatorial coordinates + float timeInSeconds = radToHrs(DiffRange)*3600.0F; + float trackingRateOffsetRadsRA = siderealToRad(trackingRateOffsetRA)*timeInSeconds; + float trackingRateOffsetRadsDec = siderealToRad(trackingRateOffsetDec)*timeInSeconds; + ahead.h -= trackingRateOffsetRadsRA; + behind.h += trackingRateOffsetRadsRA; + ahead.d += trackingRateOffsetRadsDec; + behind.d -= trackingRateOffsetRadsDec; + + // apply non-equatorial guide rate offset to equatorial coordinates + if (guide.state == GU_PULSE_GUIDE && (transform.mountType == ALTAZM || transform.mountType == ALTALT)) { + float trackingRateGuideRadsRA = siderealToRad(guide.rateAxis1)*timeInSeconds*2.0; + float trackingRateGuideRadsDec = siderealToRad(guide.rateAxis2)*timeInSeconds*2.0; + ahead.h += trackingRateGuideRadsRA; + behind.h -= trackingRateGuideRadsRA; + ahead.d += trackingRateGuideRadsDec; + behind.d -= trackingRateGuideRadsDec; + } + + // transfer to variables named appropriately for mount coordinates + float aheadAxis1, aheadAxis2, behindAxis1, behindAxis2; + if (transform.mountType == ALTAZM) { + transform.equToHor(&ahead); + aheadAxis1 = ahead.z; + aheadAxis2 = ahead.a; + behindAxis1 = behind.z; + behindAxis2 = behind.a; + } else + if (transform.mountType == ALTALT) { + transform.equToAa(&ahead); + aheadAxis1 = ahead.aa1; + aheadAxis2 = ahead.aa2; + behindAxis1 = behind.aa1; + behindAxis2 = behind.aa2; + } else { + aheadAxis1 = ahead.h; + aheadAxis2 = ahead.d; + behindAxis1 = behind.h; + behindAxis2 = behind.d; + } + + // calculate the Axis1 tracking rate + if (aheadAxis1 < -Deg90 && behindAxis1 > Deg90) aheadAxis1 += Deg360; + if (behindAxis1 < -Deg90 && aheadAxis1 > Deg90) behindAxis1 += Deg360; + float rate1 = (aheadAxis1 - behindAxis1)/DiffRange2; + if (fabs(trackingRateAxis1 - rate1) <= 0.005F) trackingRateAxis1 = (trackingRateAxis1*9.0F + rate1)/10.0F; else trackingRateAxis1 = rate1; + + // calculate the Axis2 Dec/Alt tracking rate + float rate2 = (aheadAxis2 - behindAxis2)/DiffRange2; + if (current.pierSide == PIER_SIDE_WEST) rate2 = -rate2; + if (fabs(trackingRateAxis2 - rate2) <= 0.005F) trackingRateAxis2 = (trackingRateAxis2*9.0F + rate2)/10.0F; else trackingRateAxis2 = rate2; + + // override for special case of near a celestial pole + if (fabs(declination) > Deg90 - DegenerateRange) { + if (transform.isEquatorial()) trackingRateAxis1 = trackingRate; else + if (transform.mountType == ALTAZM) trackingRateAxis1 = 0.0F; else + if (transform.mountType == ALTALT) trackingRateAxis1 = 0.0F; + trackingRateAxis2 = 0.0F; + } + + // override for both rates for special case near the Azm axis of rotation (Zenith) + if (altitude > Deg90 - DegenerateRange) { +// if (transform.isEquatorial()) trackingRateAxis1 = ztr(current.a); else +// if (transform.mountType == ALTALT) trackingRateAxis1 = ztr(current.a); else + if (transform.mountType == ALTAZM) trackingRateAxis1 = 0.0F; + trackingRateAxis2 = 0.0F; + } + + // override for both rates for special case near the aa1 axis of rotation + if (transform.mountType == ALTALT && fabs(altitude2) > Deg90 - DegenerateRange) { trackingRateAxis1 = 0.0F; } + + update(); +} + +// alternate tracking rate calculation method +float Mount::ztr(float a) { + if (a > degToRadF(89.8F)) return 0.99998667F; else if (a > degToRadF(89.5F)) return 0.99996667F; + + float altH = a + degToRadF(0.25F); if (altH < 0.0F) altH = 0.0F; + float altL = a - degToRadF(0.25F); if (altL < 0.0F) altL = 0.0F; + + float altHr = altH - transform.trueRefrac(altH); + float altLr = altL - transform.trueRefrac(altL); + + float r = (altH - altL)/(altHr - altLr); if (r > 1.0F) r = 1.0F; + return r; +} + +// update where we are pointing *now* +void Mount::updatePosition(CoordReturn coordReturn) { + current = transform.instrumentToMount(axis1.getInstrumentCoordinate(), axis2.getInstrumentCoordinate()); + if (isHome()) { + transform.mountToInstrument(¤t, ¤t.a1, ¤t.a2); + current.pierSide = PIER_SIDE_NONE; + } + + if (transform.mountType == ALTAZM) { + if (coordReturn == CR_MOUNT_EQU || coordReturn == CR_MOUNT_ALL) transform.horToEqu(¤t); + } else + if (transform.mountType == ALTALT) { + transform.aaToEqu(¤t); + } else { + if (coordReturn == CR_MOUNT_ALT) transform.equToAlt(¤t); else + if (coordReturn == CR_MOUNT_HOR || coordReturn == CR_MOUNT_ALL) transform.equToHor(¤t); + } +} + +Mount mount; + +#endif diff --git a/src/telescope/mount/Mount.h b/src/telescope/mount/Mount.h new file mode 100755 index 0000000..3bda29e --- /dev/null +++ b/src/telescope/mount/Mount.h @@ -0,0 +1,163 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control +#pragma once + +#include "../../Common.h" + +#ifdef MOUNT_PRESENT + +#include "../../lib/axis/Axis.h" +#include "../../libApp/commands/ProcessCmds.h" +#include "coordinates/Transform.h" +#include "home/Home.h" + +enum RateCompensation: uint8_t {RC_NONE, RC_REFRACTION, RC_REFRACTION_DUAL, RC_MODEL, RC_MODEL_DUAL}; + +#if TRACK_COMPENSATION_DEFAULT == OFF + #define RC_DEFAULT RC_NONE +#elif TRACK_COMPENSATION_DEFAULT == REFRACTION + #define RC_DEFAULT RC_REFRACTION +#elif TRACK_COMPENSATION_DEFAULT == REFRACTION_DUAL + #define RC_DEFAULT RC_REFRACTION_DUAL +#elif TRACK_COMPENSATION_DEFAULT == MODEL + #define RC_DEFAULT RC_FULL +#elif TRACK_COMPENSATION_DEFAULT == MODEL_DUAL + #define RC_DEFAULT RC_MODEL_DUAL +#endif + +enum TrackingState: uint8_t {TS_NONE, TS_SIDEREAL}; + +#pragma pack(1) +#define MountSettingsSize 9 + +typedef struct Backlash { + float axis1; + float axis2; +} Backlash; + +typedef struct MountSettings { + RateCompensation rc; + Backlash backlash; + uint8_t mountType; +} MountSettings; + +typedef struct MountPositionMemory { + float a1; + float a2; + uint8_t mountType:4; + uint8_t seq:2; + uint8_t untrusted:1; + uint8_t reserved:1; +} MountPositionMemory; + +#pragma pack() + +extern Axis axis1; +extern Axis axis2; + +class Mount { + public: + void init(); + void begin(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // get current equatorial position (Native coordinate system) + Coordinate getPosition(CoordReturn coordReturn = CR_MOUNT_EQU); + + // get current equatorial position (Mount coordinate system) + Coordinate getMountPosition(CoordReturn coordReturn = CR_MOUNT_EQU); + + // returns true if either of the mount motor drivers report a fault + inline bool motorFault() { return axis1.motorFault() || axis2.motorFault(); } + + // returns true if the mount is at the home (startup) position + inline bool isHome() { + return abs(axis1.getInstrumentCoordinate() - home.getPosition(CR_MOUNT).a1) <= arcsecToRad(AXIS1_HOME_TOLERANCE) && + abs(axis2.getInstrumentCoordinate() - home.getPosition(CR_MOUNT).a2) <= arcsecToRad(AXIS2_HOME_TOLERANCE); + } + + // returns true if the mount is slewing (doing a goto or guide > 2X) + inline bool isSlewing() { return axis1.isSlewing() || axis2.isSlewing(); } + + // one time initialization of tracking + void autostart(); + void autostartPostponed(); + + // enables or disables tracking, enabling tracking powers on the motors if necessary + void tracking(bool state); + + // returns true if the mount is tracking + inline bool isTracking() { return trackingState == TS_SIDEREAL; } + + // enables or disables power to the mount motors + // first enable starts the mount status indications + void enable(bool state); + + // returns true if the mount motors are powered on + inline bool isEnabled() { return axis1.isEnabled() && axis2.isEnabled(); } + + // true if syncing only from OnStep to the Encoders + bool syncFromOnStepToEncoders = false; + + inline bool startupAuthorityTrusted() const { return startupAuthorityTrustedValue; } + void setStartupAuthorityTrusted(bool state); + void captureNominalIndexPositions(); + long getNominalIndexPositionSteps(uint8_t axisNumber) const; + + #if MOUNT_COORDS_MEMORY == ON + void saveCoordinateMemory(bool trusted); + #endif + + // updates the tracking rates, etc. as appropriate for the mount state + // called once a second by poll() but available here for immediate action + void update(); + + void poll(); + + // all in sidereal units 1x = 15 arc-seconds/sidereal second + float trackingRate = hzToSidereal(TRACKING_RATE_DEFAULT_HZ); + float trackingRateAxis1 = 0.0F; + float trackingRateAxis2 = 0.0F; + float trackingRateOffsetRA = 0.0F; + float trackingRateOffsetDec = 0.0F; + + MountSettings settings = {RC_DEFAULT, { 0, 0 }, MOUNT_SUBTYPE}; + + private: + // alternate tracking rate calculation method + float ztr(float a); + + // update where we are pointing *now* + void updatePosition(CoordReturn coordReturn); + + // current position in Mount coordinates (Observed Place with no corrections except index offset) + // coordinates are either Horizon (a, z) or Equatorial (h, d) depending on the mountType + // also includes Mount normalized axis coordinates (a1, a2) where a2 is an instrument coordinate in tangent arm mode + Coordinate current; + + TrackingState trackingState = TS_NONE; + + uint32_t nvKey; + + #if MOUNT_COORDS_MEMORY == ON + uint32_t nvKeyLastA, nvKeyLastB; + MountPositionMemory lastPosition; + #endif + + long nominalIndexAxis1Steps = 0; + long nominalIndexAxis2Steps = 0; + + bool absoluteCoordinateOriginsEstablished = true; + bool startupAuthorityTrustedValue = false; +}; + +extern Motor& motor1; +extern Axis axis1; + +extern Motor& motor2; +extern Axis axis2; + +extern Mount mount; + +#endif diff --git a/src/telescope/mount/coordinates/Align.hs.cpp b/src/telescope/mount/coordinates/Align.hs.cpp new file mode 100755 index 0000000..6feee1d --- /dev/null +++ b/src/telescope/mount/coordinates/Align.hs.cpp @@ -0,0 +1,569 @@ +// ----------------------------------------------------------------------------------- +// GOTO ASSIST GEOMETRIC ALIGN FOR ALT/AZM AND EQ MOUNTS (HIGH SPEED) +// +// by Howard Dutton +// +// Copyright (C) 2012 to 2024 Howard Dutton +// + +#include "Align.hs.h" + +#if defined(MOUNT_PRESENT) && defined(HIGH_SPEED_ALIGN) + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../coordinates/Transform.h" +#include "../../Telescope.h" + +#if ALIGN_MAX_NUM_STARS > 1 + +uint8_t modelNumberStars = 0; +void autoModelWrapper() { transform.align.autoModel(modelNumberStars); } + +void GeoAlign::init(int8_t mountType, float latitude) { + modelClear(); + + this->mountType = mountType; + if (mountType == ALTAZM) { + cosLat = cosf(Deg90); + sinLat = sinf(Deg90); + } else + if (mountType == ALTALT) { + cosLat = cosf(0.0F); + sinLat = sinf(0.0F); + } else { + cosLat = cosf(latitude); + sinLat = sinf(latitude); + } +} + +void GeoAlign::modelRead() { + if (!nv().kv().getOrInit("ALIGN_MODEL", model)) { DLF("WRN: Nv, init failed for ALIGN_MODEL"); } + + if (model.ax1Cor < -Deg360 || model.ax1Cor > Deg360) { model.ax1Cor = 0; DLF("ERR: GeoAlign::readModel(), bad NV ax1Cor"); } + if (model.ax2Cor < -Deg360 || model.ax2Cor > Deg360) { model.ax2Cor = 0; DLF("ERR: GeoAlign::readModel(), bad NV ax2Cor"); } + if (model.dfCor < -256 || model.dfCor > 256) { model.dfCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV dfCor"); } + if (model.tfCor < -128 || model.tfCor > 128) { model.tfCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV tfCor"); } + if (model.doCor < -8192 || model.doCor > 8192) { model.doCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV doCor"); } + if (model.pdCor < -256 || model.pdCor > 256) { model.pdCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV pdCor"); } + if (model.altCor < -16384 || model.altCor > 16384) { model.altCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV altCor"); } + if (model.azmCor < -16384 || model.azmCor > 16384) { model.azmCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV azmCor"); } + if (model.hcp < -Deg360 || model.hcp > Deg360) { model.hcp = 0; DLF("ERR: GeoAlign::readModel(), bad NV hcp"); } + if (model.hca < -16384 || model.hca > 16384) { model.hca = 0; DLF("ERR: GeoAlign::readModel(), bad NV hca"); } + if (model.dcp < -Deg360 || model.dcp > Deg360) { model.dcp = 0; DLF("ERR: GeoAlign::readModel(), bad NV dcp"); } + if (model.dca < -16384 || model.dca > 16384) { model.dca = 0; DLF("ERR: GeoAlign::readModel(), bad NV dca"); } +} + +void GeoAlign::modelWrite() { + nv().kv().put("ALIGN_MODEL", model); +} + +void GeoAlign::modelClear() { + modelNumberStars = 0; + model.ax1Cor = 0; // align internal index for Axis1 + model.ax2Cor = 0; // align internal index for Axis2 + model.altCor = 0; // polar error relative to NCP/SCP/Zenith, - is below & + above + model.azmCor = 0; // - is right & + is left + model.doCor = 0; // altitude axis/optics orthogonal correction + model.pdCor = 0; // altitude axis/Azimuth orthogonal correction + model.dfCor = 0; // altitude axis axis flex + model.tfCor = 0; // tube flex + model.hcp = 0; // cos(Axis1) phase + model.hca = 0; // cos(Axis1) amplitude + model.dcp = 0; // cos(Axis2) phase + model.dca = 0; // cos(Axis2) amplitude + modelIsReady = false; +} + +bool GeoAlign::modelReady() { + return modelIsReady; +} + +CommandError GeoAlign::addStar(int thisStar, int numberStars, Coordinate *actual, Coordinate *mount) { + // just return if we are processing a model or the star count is out of range, this should never happen + if (autoModelTask != 0 || thisStar < 1 || thisStar > ALIGN_MAX_NUM_STARS || numberStars < 1 || numberStars > ALIGN_MAX_NUM_STARS) return CE_ALIGN_FAIL; + + int i = thisStar - 1; + + this->mount[i].h = mount->h; + this->mount[i].d = mount->d; + this->actual[i].h = actual->h; + this->actual[i].d = actual->d; + + if (mountType == ALTAZM) { + transform.equToHor(mount); + this->mount[i].ax1 = mount->z; + this->mount[i].ax2 = mount->a; + + transform.equToHor(actual); + this->actual[i].ax1 = actual->z; + this->actual[i].ax2 = actual->a; + } else + if (mountType == ALTALT) { + transform.equToAa(mount); + this->mount[i].ax1 = mount->aa1; + this->mount[i].ax2 = mount->aa2; + + transform.equToAa(actual); + this->actual[i].ax1 = actual->aa1; + this->actual[i].ax2 = actual->aa2; + } else { + this->mount[i].ax1 = mount->h; + this->mount[i].ax2 = mount->d; + + this->actual[i].ax1 = actual->h; + this->actual[i].ax2 = actual->d; + } + + if (mount->pierSide == PIER_SIDE_WEST) { + this->actual[i].side = -1; + this->mount[i].side = -1; + } else { + this->actual[i].side = 1; + this->mount[i].side = 1; + } + + // two or more stars and finished + if (thisStar >= 2 && thisStar == numberStars) { + createModel(numberStars); + } + + return CE_NONE; +} + +void GeoAlign::createModel(int numberStars) { + if (autoModelTask != 0) return; + + // start a task to solve for the model + modelNumberStars = numberStars; + autoModelTask = tasks.add(1, 0, false, 6, autoModelWrapper, "Align"); +} + +// returns the correction to be added to the requested RA,Dec to yield the actual RA,Dec that we will arrive at +void GeoAlign::correct(AlignCoordinate &mount, float sf, float _deo, float _pd, float _pz, float _pe, float _df, float _ff, float _tf, float *a1r, float *a2r) { + float DO1,DOh; + float PD,PDh; + float PZ,PA; + float DF,DFd,TF,FF,FFd,TFh,TFd; + + // ------------------------------------------------------------ + // A. Misalignment due to tube/optics not being perp. to Dec axis + // negative numbers are further (S) from the NCP, swing to the + // equator and the effect on declination is 0. At the SCP it + // becomes a (N) offset. Unchanged with meridian flips. + DO1 = _deo*sf; + // works on HA. meridian flips effect this in HA + DOh = DO1*(1.0F/mount.cosA2)*mount.side; + + // ------------------------------------------------------------ + // B. Misalignment, Declination axis relative to Polar axis + // expressed as a correction to where the Polar axis is pointing + // negative numbers are further (S) from the NCP, swing to the + // equator and the effect on declination is 0. + // At the SCP it is, again, a (S) offset + PD = _pd*sf; + // works on HA. + PDh = -PD*mount.tanA2*mount.side; + + // ------------------------------------------------------------ + // Misalignment, relative to NCP + // negative numbers are east of the pole + // C. polar left-right misalignment + PZ = _pz*sf; + // D. negative numbers are below the pole + // polar below-above misalignment + PA = _pe*sf; + + // ------------------------------------------------------------ + // Axis flex + DF = _df*sf; + DFd = -DF*(cosLat*mount.cosA1 + sinLat*mount.tanA2); + + // ------------------------------------------------------------ + // Fork flex + FF = _ff*sf; + FFd = FF*mount.cosA1; + + // ------------------------------------------------------------ + // Optical axis sag + TF = _tf*sf; + + TFh = TF*(cosLat*mount.sinA1*(1.0/mount.cosA2)); + TFd = TF*(cosLat*mount.cosA1*mount.sinA2-sinLat*mount.cosA2); + + // ------------------------------------------------------------ + *a1r = (-PZ*mount.cosA1*mount.tanA2 + PA*mount.sinA1*mount.tanA2 + DOh + PDh + TFh); + *a2r = (+PZ*mount.sinA1 + PA*mount.cosA1 + DFd + FFd + TFd); +} + +void GeoAlign::doSearch(float sf, int p1, int p2, int p3, int p4, int p5, int p6, int p7, int p8, int p9) { + long l, + + _deo_m,_deo_p, + _pd_m,_pd_p, + _pz_m,_pz_p, + _pe_m,_pe_p, + _df_m,_df_p, + _tf_m,_tf_p, + _ff_m,_ff_p, + _oh_m,_oh_p, + _od_m,_od_p, + + _deo,_pd,_pz,_pe, _df,_tf,_ff, _ode,_ohe; + + float sf1 = arcsecToRad(sf); + + // search + // set Parameter Space + _deo_m= -p1 + round(best_deo/sf); _deo_p= p1 + round(best_deo/sf); + _pd_m = -p2 + round(best_pd/sf); _pd_p = p2 + round(best_pd/sf); + _pz_m = -p3 + round(best_pz/sf); _pz_p = p3 + round(best_pz/sf); + _pe_m = -p4 + round(best_pe/sf); _pe_p = p4 + round(best_pe/sf); + _tf_m = -p5 + round(best_tf/sf); _tf_p = p5 + round(best_tf/sf); + _ff_m = -p6 + round(best_ff/sf); _ff_p = p6 + round(best_ff/sf); + _df_m = -p7 + round(best_df/sf); _df_p = p7 + round(best_df/sf); + _od_m = -p8 + round(best_ode/sf); _od_p = p8 + round(best_ode/sf); + _oh_m = -p9 + round(best_ohe/sf); _oh_p = p9 + round(best_ohe/sf); + + float ma2, ma1; + for (_ohe = _oh_m; _ohe <= _oh_p; _ohe++) + for (_ode = _od_m; _ode <= _od_p; _ode++) { + ode = _ode*sf1; + odw = -ode; + ohe = _ohe*sf1; + ohw = ohe; + + for (l = 0; l < num; l++) { + ma1 = mount[l].ax1; + ma2 = mount[l].ax2; + + if (mount[l].side == -1) // west of the mount + { + ma1 = ma1 + ohw; + ma2 = ma2 + odw; + } else + if (mount[l].side == 1) // east of the mount, default (fork mounts) + { + ma1 = ma1 + ohe; + ma2 = ma2 + ode; + } + + mount[l].ma1 = ma1; + mount[l].ma2 = ma2; + mount[l].sinA1 = sinf(ma1); + mount[l].cosA1 = cosf(ma1); + mount[l].sinA2 = sinf(ma2); + mount[l].cosA2 = cosf(ma2); + mount[l].tanA2 = mount[l].sinA2/mount[l].cosA2; + } + + for (_deo = _deo_m; _deo <= _deo_p; _deo++) + for (_pd = _pd_m; _pd <= _pd_p; _pd++) + for (_pz = _pz_m; _pz <= _pz_p; _pz++) + for (_pe = _pe_m; _pe <= _pe_p; _pe++) + for (_df = _df_m; _df <= _df_p; _df++) + for (_ff = _ff_m; _ff <= _ff_p; _ff++) + for (_tf = _tf_m; _tf <= _tf_p; _tf++) { + + // check the combinations for all samples + for (l = 0; l < num; l++) { + float ma1r, ma2r; + correct(mount[l], sf1, _deo, _pd, _pz, _pe, _df, _ff, _tf, &ma1r, &ma2r); + + delta[l].ax1 = actual[l].ax1 - (mount[l].ma1 - ma1r); + if (delta[l].ax1 > Deg180) delta[l].ax1 = delta[l].ax1 - Deg360; else + if (delta[l].ax1 < -Deg180) delta[l].ax1 = delta[l].ax1 + Deg360; + delta[l].ax2 = actual[l].ax2 - (mount[l].ma2 - ma2r); + delta[l].side = mount[l].side; + } + + // calculate the standard deviations + float a, b; + + sum1 = 0.0; + for (l = 0; l < num; l++) sum1 = sum1 + sq(delta[l].ax1*cosf(actual[l].ax2)); + a = sum1/(num - 1); // was sqrt(sum1/(num - 1)) + + sum1 = 0.0; + for (l = 0; l < num; l++) sum1 = sum1 + sq(delta[l].ax2); + b = sum1/(num - 1); // was sqrt(sum1/(num - 1)) + + max_dist = sqrtf(a + b); // was sq(a) + sq(b) + + // remember the best fit + if (max_dist < best_dist) { + best_dist = max_dist; + best_deo = _deo*sf; + best_pd = _pd*sf; + best_pz = _pz*sf; + best_pe = _pe*sf; + + best_tf = _tf*sf; + best_df = _df*sf; + best_ff = _ff*sf; + + if (p8 != 0) best_odw = radToArcsec(odw); else best_odw = best_pe/2.0; + if (p8 != 0) best_ode = radToArcsec(ode); else best_ode = -best_pe/2.0; + if (p9 != 0) best_ohw = radToArcsec(ohw); + if (p9 != 0) best_ohe = radToArcsec(ohe); + } + + Y; + } + } +} + +void GeoAlign::autoModel(int n) { + modelIsReady = false; + + VLF("MSG: Align, calculate pointing model start"); + + // how many stars? + num = n; + + best_dist = 3600.0F*180.0F; + best_deo = 0.0F; + best_pd = 0.0F; + best_pz = 0.0F; + best_pe = 0.0F; + best_tf = 0.0F; + best_ff = 0.0F; + best_df = 0.0F; + best_ode = 0.0F; + best_ohe = 0.0F; + + // figure out the average Axis1 offset as a starting point + ohe = 0; + float diff; + for (l = 0; l < num; l++) { + diff = actual[l].ax1 - mount[l].ax1; + if (diff > Deg180) diff = diff - Deg360; + if (diff < -Deg180) diff = diff + Deg360; + ohe = ohe + diff; + } + ohe = ohe/num; + best_ohe = round(radToArcsec(ohe)); + best_ohw = best_ohe; + + // fork flex or dec axis flex, as appropriate + if (mountType == ALTAZM) { Ff = 0; Df = 0; } else + if (mountType == FORK) { Ff = 1; Df = 0; } else { Ff = 0; Df = 1; } + + // only search for cone error if > 2 stars + int Do = 0; + if (num > 2) Do = 1; + + // search, this can handle about 9 degrees of polar misalignment, and 4 degrees of cone error + // DoPdPzPeTfFf Df OdOh + doSearch(16384,0 ,0,1,1,0, 0, 0,1,1); + doSearch( 8192,Do,0,1,1,0, 0, 0,1,1); + doSearch( 4096,Do,0,1,1,0, 0, 0,1,1); + doSearch( 2048,Do,0,1,1,0, 0, 0,1,1); + doSearch( 1024,Do,0,1,1,0, 0, 0,1,1); + doSearch( 512,Do,0,1,1,0, 0, 0,1,1); + #ifdef HAL_SLOW_PROCESSOR + doSearch(256,Do,0,1,1,0, 0, 0,1,1); + doSearch(128,Do,0,1,1,0, 0, 0,1,1); + doSearch( 64,Do,0,1,1,0, 0, 0,1,1); + #else + if (num > 4) { + doSearch(256,Do,1,1,1,0,Ff,Df,1,1); + doSearch(128,Do,1,1,1,1,Ff,Df,1,1); + doSearch( 64,Do,1,1,1,1,Ff,Df,1,1); + #ifdef HAL_FAST_PROCESSOR + doSearch( 32,Do,1,1,1,1,Ff,Df,1,1); + doSearch( 16,Do,1,1,1,1,Ff,Df,1,1); + doSearch( 8,Do,1,1,1,1,Ff,Df,1,1); + #ifdef HAL_VFAST_PROCESSOR + doSearch( 4,Do,1,1,1,1,Ff,Df,1,1); + #endif + #endif + } else { + doSearch(256,Do,0,1,1,0, 0, 0,1,1); + doSearch(128,Do,0,1,1,0, 0, 0,1,1); + doSearch( 64,Do,0,1,1,0, 0, 0,1,1); + doSearch( 32,Do,0,1,1,0, 0, 0,1,1); + #ifdef HAL_FAST_PROCESSOR + doSearch( 16,Do,0,1,1,0, 0, 0,1,1); + doSearch( 8,Do,0,1,1,0, 0, 0,1,1); + #ifdef HAL_VFAST_PROCESSOR + doSearch( 4,Do,0,1,1,0, 0, 0,1,1); + #endif + #endif + } + #endif + + // geometric corrections + model.doCor = arcsecToRad(best_deo); + model.pdCor = arcsecToRad(best_pd); + model.azmCor = arcsecToRad(best_pz); + model.altCor = arcsecToRad(best_pe); + + model.tfCor = arcsecToRad(best_tf); + if (mountType == FORK || mountType == ALTAZM) model.dfCor = arcsecToRad(best_ff); else model.dfCor = arcsecToRad(best_df); + + model.ax1Cor = arcsecToRad(best_ohw); + model.ax2Cor = arcsecToRad(best_odw); + + model.hcp = 0; + model.hca = 0; + model.dcp = 0; + model.dca = 0; + + // update status and exit + modelIsReady = true; + + VLF("MSG: Align, calculate pointing model done"); + tasks.setDurationComplete(autoModelTask); + autoModelTask = 0; +} + +void GeoAlign::observedPlaceToMount(Coordinate *coord) { + if (!modelIsReady) return; + + float p = 1.0F; + if (coord->pierSide == PIER_SIDE_WEST) p = -1.0F; + + float ax1, ax2; + if (mountType == ALTAZM) { ax1 = coord->z; ax2 = coord->a; } else + if (mountType == ALTALT) { ax1 = coord->aa1; ax2 = coord->aa2; } else { ax1 = coord->h; ax2 = coord->d; } + + if (ax2 > Deg90) ax2 = Deg90; + if (ax2 < -Deg90) ax2 = -Deg90; + + // initial rough guess at instrument coordinate + float a1 = ax1; + float a2 = ax2; + + // breaks-down near the poles (limited to > 1' from pole) + if (fabs(ax2) < degToRadF(89.98333333F)) { + for (int pass = 0; pass < 3; pass++) { + float sinAx2 = sinf(a2); + float cosAx2 = cosf(a2); + float sinAx1 = sinf(a1); + float cosAx1 = cosf(a1); + + // ------------------------------------------------------------ + // misalignment due to tube/optics not being perp. to Alt axis + // negative numbers are further (down) from the Zenith, swing to the + // horizon and the effect on Alt is 0. At the Nadir it + // becomes an (up) offset. Unchanged with meridian flips. + // expressed as a correction to the Zenith axis misalignment + float DOh = model.doCor*(1.0F/cosAx2)*p; + + // ------------------------------------------------------------ + // misalignment due to Alt axis being perp. to Azm axis + float PDh = -model.pdCor*(sinAx2/cosAx2)*p; + + // Fork or Axis flex + float DFd; + if (mountType == FORK || mountType == ALTAZM) DFd = model.dfCor*cosAx1; else DFd = -model.dfCor*(cosLat*cosAx1 + sinLat*(sinAx2/cosAx2)); + + // Tube flex + float TFh = model.tfCor*(cosLat*sinAx1*(1.0F/cosAx2)); + float TFd = model.tfCor*(cosLat*cosAx1*sinAx2 - sinLat*cosAx2); + + // polar misalignment + float ax1c = -model.azmCor*cosAx1*(sinAx2/cosAx2) + model.altCor*sinAx1*(sinAx2/cosAx2); + float ax2c = +model.azmCor*sinAx1 + model.altCor*cosAx1; + + // cos() linearization for main drive mechanism runout etc. + float COSh = cos(a1 + model.hcp)*model.hca*p; + float COSd = cos(a2 + model.dcp)*model.dca*p; + + // improved guess at instrument coordinate + a1 = ax1 + (ax1c + PDh + DOh + TFh + COSh); + a2 = ax2 + (ax2c + DFd + TFd + COSd); + } + } + + // finally, apply the index offsets + a1 = a1 - model.ax1Cor; + a2 = a2 - model.ax2Cor*-p; + + if (mountType == ALTAZM) { coord->z = a1; coord->a = a2; } else + if (mountType == ALTALT) { coord->aa1 = a1; coord->aa2 = a2; } else { coord->h = a1; coord->d = a2; } +} + +void GeoAlign::mountToObservedPlace(Coordinate *coord) { + if (!modelIsReady) return; + + float p = 1.0F; + if (coord->pierSide == PIER_SIDE_WEST) p = -1.0F; + + float ax1, ax2; + if (mountType == ALTAZM) { ax1 = coord->z; ax2 = coord->a; } else + if (mountType == ALTALT) { ax1 = coord->aa1; ax2 = coord->aa2; } else { ax1 = coord->h; ax2 = coord->d; } + + ax1 = ax1 + model.ax1Cor; + ax2 = ax2 + model.ax2Cor*-p; + + if (ax2 > Deg90) ax2 = Deg90; + if (ax2 < -Deg90) ax2 = -Deg90; + + // breaks-down near the Zenith (limited to > 1' from Zenith) + if (fabs(ax2) < degToRadF(89.98333333F)) { + float sinAx2 = sinf(ax2); + float cosAx2 = cosf(ax2); + float sinAx1 = sinf(ax1); + float cosAx1 = cosf(ax1); + + // ------------------------------------------------------------ + // misalignment due to tube/optics not being perp. to Alt axis + // negative numbers are further (S) from the Zenith, swing to the + // horizon and the effect on Alt is 0. At the Nadir it + // becomes a (N) offset. Unchanged with meridian flips. + // expressed as a correction to the Azm axis misalignment + float DOh = model.doCor*(1.0F/cosAx2)*p; + + // as the above offset becomes zero near the horizon, the affect + // works on Azm instead. meridian flips affect this in Azm + float PDh = -model.pdCor*(sinAx2/cosAx2)*p; + + // Fork or Axis flex + float DFd; + if (mountType == FORK || mountType == ALTAZM) DFd = model.dfCor*cosAx1; else DFd = -model.dfCor*(cosLat*cosAx1 + sinLat*(sinAx2/cosAx2)); + + // Tube flex + float TFh = model.tfCor*(cosLat*sinAx1*(1.0F/cosAx2)); + float TFd = model.tfCor*(cosLat*cosAx1*sinAx2 - sinLat*cosAx2); + + // ------------------------------------------------------------ + // polar misalignment + float a1 = -model.azmCor*cosAx1*(sinAx2/cosAx2) + model.altCor*sinAx1*(sinAx2/cosAx2); + float a2 = +model.azmCor*sinAx1 + model.altCor*cosAx1; + + // cos() linearization for main drive mechanism runout etc. + float COSh = cos(a1 + model.hcp)*model.hca*p; + float COSd = cos(a2 + model.dcp)*model.dca*p; + + ax1 = ax1 - (a1 + PDh + DOh + TFh + COSh); + ax2 = ax2 - (a2 + DFd + TFd + COSd); + } + + if (ax2 > Deg90) ax2 = Deg90; + if (ax2 < -Deg90) ax2 = -Deg90; + + if (mountType == ALTAZM) { + while (ax1 > Deg360) ax1 -= Deg360; + while (ax1 < -Deg360) ax1 += Deg360; + coord->z = ax1; + coord->a = ax2; + } else + if (mountType == ALTALT) { + while (ax1 > Deg360) ax1 -= Deg360; + while (ax1 < -Deg360) ax1 += Deg360; + coord->aa1 = ax1; + coord->aa2 = ax2; + } else { + while (ax1 > Deg180) ax1 -= Deg360; + while (ax1 < -Deg180) ax1 += Deg360; + coord->h = ax1; + coord->d = ax2; + } +} + +#endif + +#endif diff --git a/src/telescope/mount/coordinates/Align.hs.h b/src/telescope/mount/coordinates/Align.hs.h new file mode 100755 index 0000000..560b499 --- /dev/null +++ b/src/telescope/mount/coordinates/Align.hs.h @@ -0,0 +1,134 @@ +// ----------------------------------------------------------------------------------- +// GOTO ASSIST GEOMETRIC ALIGN FOR ALT/AZM AND EQ MOUNTS (HIGH SPEED) +// +// by Howard Dutton +// +// Copyright (C) 2012 to 2024 Howard Dutton +// +#pragma once + +#include "../../../Common.h" + +#if defined(MOUNT_PRESENT) && defined(HIGH_SPEED_ALIGN) + +#include "../../../libApp/commands/ProcessCmds.h" + +#if defined(ALIGN_MAX_STARS) && ALIGN_MAX_STARS != AUTO + #if (ALIGN_MAX_STARS < 3 || ALIGN_MAX_STARS > 9) && ALIGN_MAX_STARS != 1 + #error "ALIGN_MAX_STARS must be 1, or in the range of 3 to 9" + #endif + #define ALIGN_MAX_NUM_STARS ALIGN_MAX_STARS +#else + #if defined(HAL_FAST_PROCESSOR) + #define ALIGN_MAX_NUM_STARS 9 + #else + #define ALIGN_MAX_NUM_STARS 6 + #endif +#endif + +enum PierSide: uint8_t {PIER_SIDE_NONE, PIER_SIDE_EAST, PIER_SIDE_WEST}; + +typedef struct Coordinate { + double r; + double h; + double d; + double a; + double z; + double aa1; + double aa2; + double a1; + double a1Correction; + double a2; + PierSide pierSide; +} Coordinate; + +#if ALIGN_MAX_NUM_STARS > 1 + +// ----------------------------------------------------------------------------------- +// ADVANCED GEOMETRIC ALIGN FOR EQUATORIAL MOUNTS (GOTO ASSIST) + +typedef struct AlignCoordinate { + float ax1, ma1; + float ax2, ma2; + float cosA1, sinA1, cosA2, sinA2, tanA2; + float h; + float d; + int side; +} AlignCoordinate; + +#define AlignModelSize 48 +typedef struct AlignModel { + float ax1Cor; + float ax2Cor; + float altCor; + float azmCor; + float doCor; + float pdCor; + float dfCor; + float tfCor; + float hcp; + float hca; + float dcp; + float dca; +} AlignModel; + +class GeoAlign +{ + public: + // prepare goto assist for operation, also clears the alignment model; + void init(int8_t mountType, float latitude); + + // reads the last saved alignment model from NV + void modelRead(); + // writes the alignment model to NV + void modelWrite(); + // clear the alignment model + void modelClear(); + // reports if ready for operation + bool modelReady(); + + // add a star to an alignment model + // thisStar: 1 for 1st star, 2 for 2nd star, etc. up to numberStars (at which point the mount model is calculated) + // numberStars: total number of stars for this align (1 to 9) + // actual: equatorial or horizon coordinate (depending on the mount type) for where the star should be (in mount coordinates) + // mount: equatorial or horizon coordinate (depending on the mount type) for where the star is (in mount coordinates) + CommandError addStar(int thisStar, int numberStars, Coordinate *actual, Coordinate *mount); + + void createModel(int numberStars); + + // convert equatorial (h,d) or horizon (a,z) coordinate from observed place to mount + void observedPlaceToMount(Coordinate *coord); + // convert equatorial (h,d) or horizon (a,z) coordinate from mount to observed place + void mountToObservedPlace(Coordinate *coord); + + void autoModel(int n); + + bool modelIsReady = false; + + AlignCoordinate mount[ALIGN_MAX_NUM_STARS]; + AlignCoordinate actual[ALIGN_MAX_NUM_STARS]; + AlignCoordinate delta[ALIGN_MAX_NUM_STARS]; + AlignModel model; + + private: + void correct(AlignCoordinate &mount, float sf, float _deo, float _pd, float _pz, float _pe, float _da, float _ff, float _tf, float *h1, float *d1); + void doSearch(float sf, int p1, int p2, int p3, int p4, int p5, int p6, int p7, int p8, int p9); + + int8_t mountType; + float cosLat, sinLat; + + long num, l; + long Ff, Df; + float best_deo, best_pd, best_pz, best_pe, best_ohw, best_odw, best_ohe, best_ode, best_tf, best_df, best_ff; + float avg_ha, avg_dec; + float dist, sumd, rms; + float best_dist; + float ohe, ode, ohw, odw, dh; + float sum1; + float max_dist; + + uint8_t autoModelTask = 0; +}; + +#endif +#endif diff --git a/src/telescope/mount/coordinates/Align.ref.cpp b/src/telescope/mount/coordinates/Align.ref.cpp new file mode 100755 index 0000000..e19d660 --- /dev/null +++ b/src/telescope/mount/coordinates/Align.ref.cpp @@ -0,0 +1,543 @@ +// ----------------------------------------------------------------------------------- +// GOTO ASSIST GEOMETRIC ALIGN FOR ALT/AZM AND EQ MOUNTS (REFERENCE DESIGN) +// +// by Howard Dutton +// +// Copyright (C) 2012 to 2024 Howard Dutton +// + +#include "Align.ref.h" + +#if defined(MOUNT_PRESENT) && !defined(HIGH_SPEED_ALIGN) + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../coordinates/Transform.h" +#include "../../Telescope.h" + +#if ALIGN_MAX_NUM_STARS > 1 + +uint8_t modelNumberStars = 0; +void autoModelWrapper() { transform.align.autoModel(modelNumberStars); } + +void GeoAlign::init(int8_t mountType, float latitude) { + modelClear(); + + this->mountType = mountType; + if (mountType == ALTAZM) { + cosLat = cosf(Deg90); + sinLat = sinf(Deg90); + } else { + cosLat = cosf(latitude); + sinLat = sinf(latitude); + } +} + +void GeoAlign::modelRead() { + if (!nv().kv().getOrInit("ALIGN_MODEL", model)) { DLF("WRN: Nv, init failed for ALIGN_MODEL"); } + + if (model.ax1Cor < -Deg360 || model.ax1Cor > Deg360) { model.ax1Cor = 0; DLF("ERR: GeoAlign::readModel(), bad NV ax1Cor"); } + if (model.ax2Cor < -Deg360 || model.ax2Cor > Deg360) { model.ax2Cor = 0; DLF("ERR: GeoAlign::readModel(), bad NV ax2Cor"); } + if (model.dfCor < -256 || model.dfCor > 256) { model.dfCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV dfCor"); } + if (model.tfCor < -128 || model.tfCor > 128) { model.tfCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV tfCor"); } + if (model.doCor < -8192 || model.doCor > 8192) { model.doCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV doCor"); } + if (model.pdCor < -256 || model.pdCor > 256) { model.pdCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV pdCor"); } + if (model.altCor < -16384 || model.altCor > 16384) { model.altCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV altCor"); } + if (model.azmCor < -16384 || model.azmCor > 16384) { model.azmCor = 0; DLF("ERR: GeoAlign::readModel(), bad NV azmCor"); } + if (model.hcp < -Deg360 || model.hcp > Deg360) { model.hcp = 0; DLF("ERR: GeoAlign::readModel(), bad NV hcp"); } + if (model.hca < -16384 || model.hca > 16384) { model.hca = 0; DLF("ERR: GeoAlign::readModel(), bad NV hca"); } + if (model.dcp < -Deg360 || model.dcp > Deg360) { model.dcp = 0; DLF("ERR: GeoAlign::readModel(), bad NV dcp"); } + if (model.dca < -16384 || model.dca > 16384) { model.dca = 0; DLF("ERR: GeoAlign::readModel(), bad NV dca"); } +} + +void GeoAlign::modelWrite() { + nv().kv().put("ALIGN_MODEL", model); +} + +void GeoAlign::modelClear() { + modelNumberStars = 0; + model.ax1Cor = 0; // align internal index for Axis1 + model.ax2Cor = 0; // align internal index for Axis2 + model.altCor = 0; // polar error relative to NCP/SCP/Zenith, - is below & + above + model.azmCor = 0; // - is right & + is left + model.doCor = 0; // altitude axis/optics orthogonal correction + model.pdCor = 0; // altitude axis/Azimuth orthogonal correction + model.dfCor = 0; // altitude axis axis flex + model.tfCor = 0; // tube flex + model.hcp = 0; // cos(Axis1) phase + model.hca = 0; // cos(Axis1) amplitude + model.dcp = 0; // cos(Axis2) phase + model.dca = 0; // cos(Axis2) amplitude + modelIsReady = false; +} + +bool GeoAlign::modelReady() { + return modelIsReady; +} + +CommandError GeoAlign::addStar(int thisStar, int numberStars, Coordinate *actual, Coordinate *mount) { + // just return if we are processing a model or the star count is out of range, this should never happen + if (autoModelTask != 0 || thisStar < 1 || thisStar > ALIGN_MAX_NUM_STARS || numberStars < 1 || numberStars > ALIGN_MAX_NUM_STARS) return CE_ALIGN_FAIL; + + int i = thisStar - 1; + + this->mount[i].h = mount->h; + this->mount[i].d = mount->d; + this->actual[i].h = actual->h; + this->actual[i].d = actual->d; + + if (mountType == ALTAZM) { + transform.equToHor(mount); + this->mount[i].ax1 = mount->z; + this->mount[i].ax2 = mount->a; + + transform.equToHor(actual); + this->actual[i].ax1 = actual->z; + this->actual[i].ax2 = actual->a; + } else { + this->mount[i].ax1 = mount->h; + this->mount[i].ax2 = mount->d; + + this->actual[i].ax1 = actual->h; + this->actual[i].ax2 = actual->d; + } + + if (mount->pierSide == PIER_SIDE_WEST) { + this->actual[i].side = -1; + this->mount[i].side = -1; + } else { + this->actual[i].side = 1; + this->mount[i].side = 1; + } + + // two or more stars and finished + if (thisStar >= 2 && thisStar == numberStars) { + createModel(numberStars); + } + + return CE_NONE; +} + +void GeoAlign::createModel(int numberStars) { + if (autoModelTask != 0) return; + + // start a task to solve for the model + modelNumberStars = numberStars; + autoModelTask = tasks.add(1, 0, false, 6, autoModelWrapper, "Align"); +} + +// returns the correction to be added to the requested RA,Dec to yield the actual RA,Dec that we will arrive at +void GeoAlign::correct(float a1, float a2, float pierSide, float sf, float _deo, float _pd, float _pz, float _pe, float _df, float _ff, float _tf, float *a1r, float *a2r) { + float DO1,DOh; + float PD,PDh; + float PZ,PA; + float DF,DFd,TF,FF,FFd,TFh,TFd; + + float cosA2 = cosf(a2); + float sinA2 = sinf(a2); + float tanA2 = sinA2/cosA2; + float sinA1 = sinf(a1); + float cosA1 = cosf(a1); + + // ------------------------------------------------------------ + // A. Misalignment due to tube/optics not being perp. to Dec axis + // negative numbers are further (S) from the NCP, swing to the + // equator and the effect on declination is 0. At the SCP it + // becomes a (N) offset. Unchanged with meridian flips. + DO1 = _deo*sf; + // works on HA. meridian flips effect this in HA + DOh = DO1*(1.0F/cosA2)*pierSide; + + // ------------------------------------------------------------ + // B. Misalignment, Declination axis relative to Polar axis + // expressed as a correction to where the Polar axis is pointing + // negative numbers are further (S) from the NCP, swing to the + // equator and the effect on declination is 0. + // At the SCP it is, again, a (S) offset + PD = _pd*sf; + // works on HA. + PDh = -PD*tanA2*pierSide; + + // ------------------------------------------------------------ + // Misalignment, relative to NCP + // negative numbers are east of the pole + // C. polar left-right misalignment + PZ = _pz*sf; + // D. negative numbers are below the pole + // polar below-above misalignment + PA = _pe*sf; + + // ------------------------------------------------------------ + // Axis flex + DF = _df*sf; + DFd = -DF*(cosLat*cosA1 + sinLat*tanA2); + + // ------------------------------------------------------------ + // Fork flex + FF = _ff*sf; + FFd = FF*cosA1; + + // ------------------------------------------------------------ + // Optical axis sag + TF = _tf*sf; + + TFh = TF*(cosLat*sinA1*(1.0/cosA2)); + TFd = TF*(cosLat*cosA1*sinA2-sinLat*cosA2); + + // ------------------------------------------------------------ + *a1r = (-PZ*cosA1*tanA2 + PA*sinA1*tanA2 + DOh + PDh + TFh); + *a2r = (+PZ*sinA1 + PA*cosA1 + DFd + FFd + TFd); +} + +void GeoAlign::doSearch(float sf, int p1, int p2, int p3, int p4, int p5, int p6, int p7, int p8, int p9) { + long l, + + _deo_m,_deo_p, + _pd_m,_pd_p, + _pz_m,_pz_p, + _pe_m,_pe_p, + _df_m,_df_p, + _tf_m,_tf_p, + _ff_m,_ff_p, + _oh_m,_oh_p, + _od_m,_od_p, + + _deo,_pd,_pz,_pe, _df,_tf,_ff, _ode,_ohe; + + float sf1 = arcsecToRad(sf); + + // search + // set Parameter Space + _deo_m= -p1 + round(best_deo/sf); _deo_p= p1 + round(best_deo/sf); + _pd_m = -p2 + round(best_pd/sf); _pd_p = p2 + round(best_pd/sf); + _pz_m = -p3 + round(best_pz/sf); _pz_p = p3 + round(best_pz/sf); + _pe_m = -p4 + round(best_pe/sf); _pe_p = p4 + round(best_pe/sf); + _tf_m = -p5 + round(best_tf/sf); _tf_p = p5 + round(best_tf/sf); + _ff_m = -p6 + round(best_ff/sf); _ff_p = p6 + round(best_ff/sf); + _df_m = -p7 + round(best_df/sf); _df_p = p7 + round(best_df/sf); + _od_m = -p8 + round(best_ode/sf); _od_p = p8 + round(best_ode/sf); + _oh_m = -p9 + round(best_ohe/sf); _oh_p = p9 + round(best_ohe/sf); + + float ma2, ma1; + for (_deo = _deo_m; _deo <= _deo_p; _deo++) + for (_pd = _pd_m; _pd <= _pd_p; _pd++) + for (_pz = _pz_m; _pz <= _pz_p; _pz++) + for (_pe = _pe_m; _pe <= _pe_p; _pe++) + for (_df = _df_m; _df <= _df_p; _df++) + for (_ff = _ff_m; _ff <= _ff_p; _ff++) + for (_tf = _tf_m; _tf <= _tf_p; _tf++) + for (_ohe = _oh_m; _ohe <= _oh_p; _ohe++) + for (_ode = _od_m; _ode <= _od_p; _ode++) { + ode = _ode*sf1; + odw = -ode; + ohe = _ohe*sf1; + ohw = ohe; + + // check the combinations for all samples + for (l = 0; l < num; l++) { + ma1 = mount[l].ax1; + ma2 = mount[l].ax2; + + if (mount[l].side == -1) // west of the mount + { + ma1 = ma1 + ohw; + ma2 = ma2 + odw; + } else + if (mount[l].side == 1) // east of the mount, default (fork mounts) + { + ma1 = ma1 + ohe; + ma2 = ma2 + ode; + } + + float ma1r, ma2r; + correct(ma1, ma2, mount[l].side, sf1, _deo, _pd, _pz, _pe, _df, _ff, _tf, &ma1r, &ma2r); + + delta[l].ax1 = actual[l].ax1 - (ma1 - ma1r); + if (delta[l].ax1 > Deg180) delta[l].ax1 = delta[l].ax1 - Deg360; else + if (delta[l].ax1 < -Deg180) delta[l].ax1 = delta[l].ax1 + Deg360; + delta[l].ax2 = actual[l].ax2 - (ma2 - ma2r); + delta[l].side = mount[l].side; + } + + // calculate the standard deviations + float a, b; + sum1 = 0.0; for (l = 0; l < num; l++) sum1 = sum1 + sq(delta[l].ax1*cosf(actual[l].ax2)); a = sqrtf(sum1/(num - 1)); + sum1 = 0.0; for (l = 0; l < num; l++) sum1 = sum1 + sq(delta[l].ax2); b = sqrtf(sum1/(num - 1)); + max_dist = sqrtf(sq(a) + sq(b)); + + // remember the best fit + if (max_dist < best_dist) { + best_dist = max_dist; + best_deo = _deo*sf; + best_pd = _pd*sf; + best_pz = _pz*sf; + best_pe = _pe*sf; + + best_tf = _tf*sf; + best_df = _df*sf; + best_ff = _ff*sf; + + if (p8 != 0) best_odw = radToArcsec(odw); else best_odw = best_pe/2.0; + if (p8 != 0) best_ode = radToArcsec(ode); else best_ode = -best_pe/2.0; + if (p9 != 0) best_ohw = radToArcsec(ohw); + if (p9 != 0) best_ohe = radToArcsec(ohe); + } + + Y; + } +} + +void GeoAlign::autoModel(int n) { + modelIsReady = false; + + VLF("MSG: Align, calculate pointing model start"); + + // how many stars? + num = n; + + best_dist = 3600.0F*180.0F; + best_deo = 0.0F; + best_pd = 0.0F; + best_pz = 0.0F; + best_pe = 0.0F; + best_tf = 0.0F; + best_ff = 0.0F; + best_df = 0.0F; + best_ode = 0.0F; + best_ohe = 0.0F; + + // figure out the average Axis1 offset as a starting point + ohe = 0; + float diff; + for (l = 0; l < num; l++) { + diff = actual[l].ax1 - mount[l].ax1; + if (diff > Deg180) diff = diff - Deg360; + if (diff < -Deg180) diff = diff + Deg360; + ohe = ohe + diff; + } + ohe = ohe/num; + best_ohe = round(radToArcsec(ohe)); + best_ohw = best_ohe; + + // fork flex or dec axis flex, as appropriate + if (mountType == ALTAZM) { Ff = 0; Df = 0; } else if (mountType == FORK) { Ff = 1; Df = 0; } else { Ff = 0; Df = 1; } + + // only search for cone error if > 2 stars + int Do = 0; + if (num > 2) Do = 1; + + // search, this can handle about 9 degrees of polar misalignment, and 4 degrees of cone error + // DoPdPzPeTfFf Df OdOh + doSearch(16384,0 ,0,1,1,0, 0, 0,1,1); + doSearch( 8192,Do,0,1,1,0, 0, 0,1,1); + doSearch( 4096,Do,0,1,1,0, 0, 0,1,1); + doSearch( 2048,Do,0,1,1,0, 0, 0,1,1); + doSearch( 1024,Do,0,1,1,0, 0, 0,1,1); + doSearch( 512,Do,0,1,1,0, 0, 0,1,1); + #ifdef HAL_SLOW_PROCESSOR + doSearch(256,Do,0,1,1,0, 0, 0,1,1); + doSearch(128,Do,0,1,1,0, 0, 0,1,1); + #else + if (num > 4) { + doSearch(256,Do,1,1,1,0,Ff,Df,1,1); + doSearch(128,Do,1,1,1,1,Ff,Df,1,1); + doSearch( 64,Do,1,1,1,1,Ff,Df,1,1); + #ifdef HAL_FAST_PROCESSOR + doSearch( 32,Do,1,1,1,1,Ff,Df,1,1); + doSearch( 16,Do,1,1,1,1,Ff,Df,1,1); + #endif + } else { + doSearch(256,Do,0,1,1,0, 0, 0,1,1); + doSearch(128,Do,0,1,1,0, 0, 0,1,1); + doSearch( 64,Do,0,1,1,0, 0, 0,1,1); + doSearch( 32,Do,0,1,1,0, 0, 0,1,1); + #ifdef HAL_FAST_PROCESSOR + doSearch( 16,Do,0,1,1,0, 0, 0,1,1); + #endif + } + #endif + + // geometric corrections + model.doCor = arcsecToRad(best_deo); + model.pdCor = arcsecToRad(best_pd); + model.azmCor = arcsecToRad(best_pz); + model.altCor = arcsecToRad(best_pe); + + model.tfCor = arcsecToRad(best_tf); + if (mountType == FORK || mountType == ALTAZM) model.dfCor = arcsecToRad(best_ff); else model.dfCor = arcsecToRad(best_df); + + model.ax1Cor = arcsecToRad(best_ohw); + model.ax2Cor = arcsecToRad(best_odw); + + model.hcp = 0; + model.hca = 0; + model.dcp = 0; + model.dca = 0; + + // update status and exit + modelIsReady = true; + + VLF("MSG: Align, calculate pointing model done"); + tasks.setDurationComplete(autoModelTask); + autoModelTask = 0; +} + +void GeoAlign::observedPlaceToMount(Coordinate *coord) { + if (!modelIsReady) return; + + float p = 1.0F; + if (coord->pierSide == PIER_SIDE_WEST) p = -1.0F; + + float ax1, ax2; + if (mountType == ALTAZM) { + ax1 = coord->z; + ax2 = coord->a; + } else { + ax1 = coord->h; + ax2 = coord->d; + } + + if (ax2 > Deg90) ax2 = Deg90; + if (ax2 < -Deg90) ax2 = -Deg90; + + // initial rough guess at instrument coordinate + float a1 = ax1; + float a2 = ax2; + + // breaks-down near the poles (limited to > 1' from pole) + if (fabs(ax2) < degToRadF(89.98333333F)) { + for (int pass = 0; pass < 3; pass++) { + float sinAx2 = sinf(a2); + float cosAx2 = cosf(a2); + float sinAx1 = sinf(a1); + float cosAx1 = cosf(a1); + + // ------------------------------------------------------------ + // misalignment due to tube/optics not being perp. to Alt axis + // negative numbers are further (down) from the Zenith, swing to the + // horizon and the effect on Alt is 0. At the Nadir it + // becomes an (up) offset. Unchanged with meridian flips. + // expressed as a correction to the Zenith axis misalignment + float DOh = model.doCor*(1.0F/cosAx2)*p; + + // ------------------------------------------------------------ + // misalignment due to Alt axis being perp. to Azm axis + float PDh = -model.pdCor*(sinAx2/cosAx2)*p; + + // Fork or Axis flex + float DFd; + if (mountType == FORK || mountType == ALTAZM) DFd = model.dfCor*cosAx1; else DFd = -model.dfCor*(cosLat*cosAx1 + sinLat*(sinAx2/cosAx2)); + + // Tube flex + float TFh = model.tfCor*(cosLat*sinAx1*(1.0F/cosAx2)); + float TFd = model.tfCor*(cosLat*cosAx1*sinAx2 - sinLat*cosAx2); + + // polar misalignment + float ax1c = -model.azmCor*cosAx1*(sinAx2/cosAx2) + model.altCor*sinAx1*(sinAx2/cosAx2); + float ax2c = +model.azmCor*sinAx1 + model.altCor*cosAx1; + + // cos() linearization for main drive mechanism runout etc. + float COSh = cos(a1 + model.hcp)*model.hca*p; + float COSd = cos(a2 + model.dcp)*model.dca*p; + + // improved guess at instrument coordinate + a1 = ax1 + (ax1c + PDh + DOh + TFh + COSh); + a2 = ax2 + (ax2c + DFd + TFd + COSd); + } + } + + // finally, apply the index offsets + a1 = a1 - model.ax1Cor; + a2 = a2 - model.ax2Cor*-p; + + if (mountType == ALTAZM) { coord->z = a1; coord->a = a2; } else { + if (mountType == ALTALT) { coord->aa1 = a1; coord->aa2 = a2; } else { coord->h = a1; coord->d = a2; } +} + +void GeoAlign::mountToObservedPlace(Coordinate *coord) { + if (!modelIsReady) return; + + float p = 1.0F; + if (coord->pierSide == PIER_SIDE_WEST) p = -1.0F; + + float ax1, ax2; + if (mountType == ALTAZM) { + ax1 = coord->z; + ax2 = coord->a; + } else { + ax1 = coord->h; + ax2 = coord->d; + } + + ax1 = ax1 + model.ax1Cor; + ax2 = ax2 + model.ax2Cor*-p; + + if (ax2 > Deg90) ax2 = Deg90; + if (ax2 < -Deg90) ax2 = -Deg90; + + // breaks-down near the Zenith (limited to > 1' from Zenith) + if (fabs(ax2) < degToRadF(89.98333333F)) { + float sinAx2 = sinf(ax2); + float cosAx2 = cosf(ax2); + float sinAx1 = sinf(ax1); + float cosAx1 = cosf(ax1); + + // ------------------------------------------------------------ + // misalignment due to tube/optics not being perp. to Alt axis + // negative numbers are further (S) from the Zenith, swing to the + // horizon and the effect on Alt is 0. At the Nadir it + // becomes a (N) offset. Unchanged with meridian flips. + // expressed as a correction to the Azm axis misalignment + float DOh = model.doCor*(1.0F/cosAx2)*p; + + // as the above offset becomes zero near the horizon, the affect + // works on Azm instead. meridian flips affect this in Azm + float PDh = -model.pdCor*(sinAx2/cosAx2)*p; + + // Fork or Axis flex + float DFd; + if (mountType == FORK || mountType == ALTAZM) DFd = model.dfCor*cosAx1; else DFd = -model.dfCor*(cosLat*cosAx1 + sinLat*(sinAx2/cosAx2)); + + // Tube flex + float TFh = model.tfCor*(cosLat*sinAx1*(1.0F/cosAx2)); + float TFd = model.tfCor*(cosLat*cosAx1*sinAx2 - sinLat*cosAx2); + + // ------------------------------------------------------------ + // polar misalignment + float a1 = -model.azmCor*cosAx1*(sinAx2/cosAx2) + model.altCor*sinAx1*(sinAx2/cosAx2); + float a2 = +model.azmCor*sinAx1 + model.altCor*cosAx1; + + // cos() linearization for main drive mechanism runout etc. + float COSh = cos(a1 + model.hcp)*model.hca*p; + float COSd = cos(a2 + model.dcp)*model.dca*p; + + ax1 = ax1 - (a1 + PDh + DOh + TFh + COSh); + ax2 = ax2 - (a2 + DFd + TFd + COSd); + } + + if (ax2 > Deg90) ax2 = Deg90; + if (ax2 < -Deg90) ax2 = -Deg90; + + if (mountType == ALTAZM) { + while (ax1 > Deg360) ax1 -= Deg360; + while (ax1 < -Deg360) ax1 += Deg360; + coord->z = ax1; + coord->a = ax2; + } else + if (mountType == ALTALT) { + while (ax1 > Deg360) ax1 -= Deg360; + while (ax1 < -Deg360) ax1 += Deg360; + coord->aa1 = ax1; + coord->aa2 = ax2; + } else { + while (ax1 > Deg180) ax1 -= Deg360; + while (ax1 < -Deg180) ax1 += Deg360; + coord->h = ax1; + coord->d = ax2; + } +} + +#endif + +#endif diff --git a/src/telescope/mount/coordinates/Align.ref.h b/src/telescope/mount/coordinates/Align.ref.h new file mode 100755 index 0000000..d2d0f04 --- /dev/null +++ b/src/telescope/mount/coordinates/Align.ref.h @@ -0,0 +1,132 @@ +// ----------------------------------------------------------------------------------- +// GOTO ASSIST GEOMETRIC ALIGN FOR ALT/AZM AND EQ MOUNTS (REFERENCE DESIGN) +// +// by Howard Dutton +// +// Copyright (C) 2012 to 2024 Howard Dutton +// +#pragma once + +#include "../../../Common.h" + +#if defined(MOUNT_PRESENT) && !defined(HIGH_SPEED_ALIGN) + +#include "../../../libApp/commands/ProcessCmds.h" + +#if defined(ALIGN_MAX_STARS) && ALIGN_MAX_STARS != AUTO + #if (ALIGN_MAX_STARS < 3 || ALIGN_MAX_STARS > 9) && ALIGN_MAX_STARS != 1 + #error "ALIGN_MAX_STARS must be 1, or in the range of 3 to 9" + #endif + #define ALIGN_MAX_NUM_STARS ALIGN_MAX_STARS +#else + #if defined(HAL_FAST_PROCESSOR) + #define ALIGN_MAX_NUM_STARS 9 + #else + #define ALIGN_MAX_NUM_STARS 6 + #endif +#endif + +enum PierSide: uint8_t {PIER_SIDE_NONE, PIER_SIDE_EAST, PIER_SIDE_WEST}; + +typedef struct Coordinate { + double r; + double h; + double d; + double a; + double z; + double aa1; + double aa2; + double a1; + double a1Correction; + double a2; + PierSide pierSide; +} Coordinate; + +#if ALIGN_MAX_NUM_STARS > 1 + +// ----------------------------------------------------------------------------------- +// ADVANCED GEOMETRIC ALIGN FOR EQUATORIAL MOUNTS (GOTO ASSIST) + +typedef struct AlignCoordinate { + float ax1; + float ax2; + float h; + float d; + int side; +} AlignCoordinate; + +#define AlignModelSize 48 +typedef struct AlignModel { + float ax1Cor; + float ax2Cor; + float altCor; + float azmCor; + float doCor; + float pdCor; + float dfCor; + float tfCor; + float hcp; + float hca; + float dcp; + float dca; +} AlignModel; + +class GeoAlign +{ + public: + // prepare goto assist for operation, also clears the alignment model; + void init(int8_t mountType, float latitude); + + // reads the last saved alignment model from NV + void modelRead(); + // writes the alignment model to NV + void modelWrite(); + // clear the alignment model + void modelClear(); + // reports if ready for operation + bool modelReady(); + + // add a star to an alignment model + // thisStar: 1 for 1st star, 2 for 2nd star, etc. up to numberStars (at which point the mount model is calculated) + // numberStars: total number of stars for this align (1 to 9) + // actual: equatorial or horizon coordinate (depending on the mount type) for where the star should be (in mount coordinates) + // mount: equatorial or horizon coordinate (depending on the mount type) for where the star is (in mount coordinates) + CommandError addStar(int thisStar, int numberStars, Coordinate *actual, Coordinate *mount); + + void createModel(int numberStars); + + // convert equatorial (h,d) or horizon (a,z) coordinate from observed place to mount + void observedPlaceToMount(Coordinate *coord); + // convert equatorial (h,d) or horizon (a,z) coordinate from mount to observed place + void mountToObservedPlace(Coordinate *coord); + + void autoModel(int n); + + AlignCoordinate mount[ALIGN_MAX_NUM_STARS]; + AlignCoordinate actual[ALIGN_MAX_NUM_STARS]; + AlignCoordinate delta[ALIGN_MAX_NUM_STARS]; + AlignModel model; + + private: + void correct(float ha, float dec, float pierSide, float sf, float _deo, float _pd, float _pz, float _pe, float _da, float _ff, float _tf, float *h1, float *d1); + void doSearch(float sf, int p1, int p2, int p3, int p4, int p5, int p6, int p7, int p8, int p9); + + bool modelIsReady = false; + int8_t mountType; + float cosLat, sinLat; + + long num, l; + long Ff, Df; + float best_deo, best_pd, best_pz, best_pe, best_ohw, best_odw, best_ohe, best_ode, best_tf, best_df, best_ff; + float avg_ha, avg_dec; + float dist, sumd, rms; + float best_dist; + float ohe, ode, ohw, odw, dh; + float sum1; + float max_dist; + + uint8_t autoModelTask = 0; +}; + +#endif +#endif diff --git a/src/telescope/mount/coordinates/Transform.cpp b/src/telescope/mount/coordinates/Transform.cpp new file mode 100755 index 0000000..f90e04f --- /dev/null +++ b/src/telescope/mount/coordinates/Transform.cpp @@ -0,0 +1,310 @@ +//-------------------------------------------------------------------------------------------------- +// coordinate transformation + +#include "Transform.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/nv/Nv.h" + +#include "../../../libApp/weather/Weather.h" + +#include "../../Telescope.h" + +extern volatile unsigned long fracLAST; + +#define fsToRad(x) ((x)/(13750.98708313976*FRACTIONAL_SEC)) +#define radToFs(x) ((x)*(13750.98708313976*FRACTIONAL_SEC)) + +#if DEBUG != OFF + void Transform::print(Coordinate *coord) { + UNUSED(coord); + VF("(a="); V(radToDeg(coord->a)); VF(", z="); V(radToDeg(coord->z)); + VF("), (r="); V(radToDeg(coord->r)); VF(", h="); V(radToDeg(coord->h)); VF(", d="); V(radToDeg(coord->d)); + VF("), pierSide="); VL(coord->pierSide); + } +#endif + +void Transform::init(uint8_t mountType) { + this->mountType = mountType; + + #if DEBUG == VERBOSE + const char* MountTypeStr[5] = {"", "GEM", "FORK", "ALTAZM", "ALTALT"}; + VF("MSG: Mount, type "); VL(MountTypeStr[mountType]); + #endif + + if (mountType == GEM) meridianFlips = true; else meridianFlips = (MOUNT_ALTERNATE_ORIENTATION == ON); + + #if ALIGN_MAX_NUM_STARS > 1 + align.init(mountType, site.location.latitude); + #endif +} + +Coordinate Transform::mountToNative(Coordinate *coord, bool returnHorizonCoords) { + Coordinate result = *coord; + + #if MOUNT_COORDS == OBSERVED_PLACE + mountToObservedPlace(&result); + #elif MOUNT_COORDS == TOPOCENTRIC || MOUNT_COORDS == TOPO_STRICT + mountToTopocentric(&result); + #else + #error "Configuration (Config.h): MOUNT_COORDS, Unknown native mount coordinate system!" + #endif + + if (mountType == ALTAZM) horToEqu(&result); else + if (mountType == ALTALT) aaToEqu(&result); + + if (isEquatorial() && returnHorizonCoords) equToHor(&result); + + hourAngleToRightAscension(&result, true); + return result; +} + +void Transform::nativeToMount(Coordinate *coord, double *a1, double *a2) { + rightAscensionToHourAngle(coord, true); + + if (mountType == ALTAZM) equToHor(coord); else + if (mountType == ALTALT) equToAa(coord); + + #if MOUNT_COORDS == OBSERVED_PLACE + observedPlaceToMount(coord); + #elif MOUNT_COORDS == TOPOCENTRIC || MOUNT_COORDS == TOPO_STRICT + topocentricToMount(coord); + #else + #error "Configuration (Config.h): MOUNT_COORDS, Unknown native mount coordinate system!" + #endif + + if (a1 != NULL && a2 != NULL) { + if (mountType == ALTAZM) { *a1 = coord->z; *a2 = coord->a; } else + if (mountType == ALTALT) { *a1 = coord->aa1; *a2 = coord->aa2; } else + if (isEquatorial()) { *a1 = coord->h; *a2 = coord->d; } + } +} + +void Transform::mountToTopocentric(Coordinate *coord) { + mountToObservedPlace(coord); + observedPlaceToTopocentric(coord); +} + +void Transform::mountToObservedPlace(Coordinate *coord) { + #if ALIGN_MAX_NUM_STARS > 1 + if (coord->pierSide != PIER_SIDE_NONE) align.mountToObservedPlace(coord); + #else + (void)(*coord); + #endif +} + +void Transform::observedPlaceToTopocentric(Coordinate *coord) { + if (mountType != ALTAZM) { + // within about 1/20 arc-second of the "refracted" NCP or SCP + #if MOUNT_COORDS == TOPO_STRICT + if (fabs(coord->d - Deg90) < OneArcSec) { coord->z = 0.0; coord->a = site.latitude.value; } else + if (fabs(coord->d + Deg90) < OneArcSec) { coord->z = Deg180; coord->a = -site.latitude.value; } else equToHor(coord); + #else + if (fabs(coord->d - Deg90) < OneArcSec || fabs(coord->d + Deg90) < OneArcSec) return; else equToHor(coord); + #endif + coord->a -= apparentRefrac(coord->a); + horToEqu(coord); + } else coord->a -= apparentRefrac(coord->a); +} + +void Transform::topocentricToMount(Coordinate *coord) { + topocentricToObservedPlace(coord); + observedPlaceToMount(coord); +} + +void Transform::observedPlaceToMount(Coordinate *coord) { + #if ALIGN_MAX_NUM_STARS > 1 + if (coord->pierSide != PIER_SIDE_NONE) align.observedPlaceToMount(coord); + #else + (void)(*coord); + #endif + + if (mountType == ALTAZM) { + coord->a1 = coord->z; + coord->a2 = coord->a; + } else { + coord->a1 = coord->h; + coord->a2 = coord->d; + } +} + +void Transform::topocentricToObservedPlace(Coordinate *coord) { + if (mountType != ALTAZM) { + // within about 1/20 arc-second of NCP or SCP + #if MOUNT_COORDS == TOPO_STRICT + if (fabs(coord->d - Deg90) < OneArcSec) { coord->z = 0.0; coord->a = site.latitude.value; } else + if (fabs(coord->d + Deg90) < OneArcSec) { coord->z = Deg180; coord->a = -site.latitude.value; } else equToHor(coord); + #else + if (fabs(coord->d - Deg90) < OneArcSec || fabs(coord->d + Deg90) < OneArcSec) return; else equToHor(coord); + #endif + coord->a += trueRefrac(coord->a); + horToEqu(coord); + } else coord->a += trueRefrac(coord->a); +} + +Coordinate Transform::instrumentToMount(double a1, double a2) { + Coordinate mount = {0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, PIER_SIDE_NONE}; + + #if AXIS2_TANGENT_ARM_CORRECTION == ON + a2 = TANGENT_ARM_INSTRUMENT_TO_MOUNT(a2) + #endif + + if (site.location.latitude >= 0.0 || mountType == ALTAZM) { + if (a2 > Deg90) { + mount.pierSide = PIER_SIDE_WEST; + a1 -= Deg180; + a2 = Deg180 - a2; + } else mount.pierSide = PIER_SIDE_EAST; + } else { + if (a2 < -Deg90) { + mount.pierSide = PIER_SIDE_WEST; + a1 -= Deg180; + a2 = (-Deg180) - a2; + } else mount.pierSide = PIER_SIDE_EAST; + } + + if (mountType == ALTAZM) { mount.z = a1; mount.a = a2; } else + if (mountType == ALTALT) { mount.aa1 = a1; mount.aa2 = a2; } else + if (isEquatorial()) { mount.h = a1; mount.d = a2; } + + mount.a1 = a1; + mount.a2 = a2; + + mount.a1Correction = 0.0; + + return mount; +} + +void Transform::mountToInstrument(Coordinate *coord, double *a1, double *a2) { + if (mountType == ALTAZM) { *a1 = coord->z; *a2 = coord->a; } else + if (mountType == ALTALT) { *a1 = coord->aa1; *a2 = coord->aa2; } else + if (isEquatorial()) { *a1 = coord->h; *a2 = coord->d; } + + if (site.location.latitude >= 0.0 || !isEquatorial()) { + if (coord->pierSide == PIER_SIDE_WEST) { + *a1 += Deg180; + *a2 = Deg180 - *a2; + } + } else { + if (coord->pierSide == PIER_SIDE_WEST) { + *a1 += Deg180; + *a2 = (-Deg180) - *a2; + } + } + + #if AXIS2_TANGENT_ARM_CORRECTION == ON + *a2 = TANGENT_ARM_MOUNT_TO_INSTRUMENT(*a2) + #endif +} + +void Transform::hourAngleToRightAscension(Coordinate *coord, bool native) { + noInterrupts(); + unsigned long fs = fracLAST; + interrupts(); + coord->r = fsToRad(fs) - coord->h; + if (native) coord->r = backInRads(coord->r); +} + +void Transform::rightAscensionToHourAngle(Coordinate *coord, bool native) { + if (isnan(coord->r)) return; // NAN flags mount coordinates + noInterrupts(); + unsigned long fs = fracLAST; + interrupts(); + coord->h = fsToRad(fs) - coord->r; + if (native) coord->h = backInRads2(coord->h); +} + +void Transform::equToHor(Coordinate *coord) { + double cosHA = cos(coord->h); + double sinAlt = sin(coord->d)*site.locationEx.latitude.sine + cos(coord->d)*site.locationEx.latitude.cosine*cosHA; + coord->a = asin(sinAlt); + double t1 = sin(coord->h); + double t2 = cosHA*site.locationEx.latitude.sine - tan(coord->d)*site.locationEx.latitude.cosine; + // handle degenerate coordinates near the poles + if (fabs(coord->d - Deg90) < TenthArcSec) coord->z = 0.0; else + if (fabs(coord->d + Deg90) < TenthArcSec) coord->z = Deg180; else { + coord->z = atan2(t1, t2); + coord->z += Deg180; + } + if (coord->z > Deg180) coord->z -= Deg360; +} + +void Transform::equToAlt(Coordinate *coord) { + double cosHA = cos(coord->h); + double sinAlt = sin(coord->d)*site.locationEx.latitude.sine + cos(coord->d)*site.locationEx.latitude.cosine*cosHA; + coord->a = asin(sinAlt); +} + +void Transform::horToEqu(Coordinate *coord) { + double cosAzm = cos(coord->z); + double sinDec = sin(coord->a)*site.locationEx.latitude.sine + cos(coord->a)*site.locationEx.latitude.cosine*cosAzm; + coord->d = asin(sinDec); + double t1 = sin(coord->z); + double t2 = cosAzm*site.locationEx.latitude.sine - tan(coord->a)*site.locationEx.latitude.cosine; + coord->h = atan2(t1, t2); + coord->h += Deg180; + if (coord->h > Deg180) coord->h -= Deg360; +} + +void Transform::aaToHor(Coordinate *coord) { + double cosAA1 = cos(coord->aa1); + double sinAlt = cos(coord->aa2)*cosAA1; + coord->a = asin(sinAlt); + double t1 = sin(coord->aa1); + double t2 = -tan(coord->aa2); + // handle degenerate coordinates near the poles + if (fabs(coord->aa2 - Deg90) < TenthArcSec) coord->z = 0.0; else + if (fabs(coord->aa2 + Deg90) < TenthArcSec) coord->z = Deg180; else { + coord->z = atan2(t1, t2); + coord->z += Deg180; + } + if (coord->z > Deg180) coord->z -= Deg360; +} + +void Transform::horToAa(Coordinate *coord) { + double cosAzm = cos(coord->z); + double sinAA2 = cos(coord->a)*cosAzm; + coord->aa2 = asin(sinAA2); + double t1 = sin(coord->z); + double t2 = -tan(coord->a); + coord->aa1 = atan2(t1, t2); + coord->aa1 += Deg180; + if (coord->aa1 > Deg180) coord->aa1 -= Deg360; +} + +double Transform::trueRefrac(double altitude) { + float pressure = 1010.0F; + float temperature = 10.0F; + if (!isnan(weather.getPressure())) pressure = weather.getPressure(); + if (!isnan(weather.getTemperature())) temperature = weather.getTemperature(); + float TPC = (pressure/1010.0F)*(283.0F/(273.0F + temperature)); + float r = 2.9670597e-4F*cotf(altitude + 0.0031375594F/(altitude + 0.089186324F))*TPC; + if (r < 0.0F) r = 0.0F; + return r; +} + +double Transform::apparentRefrac(double altitude) { + double r = trueRefrac(altitude); + return trueRefrac(altitude - r); +} + +float Transform::cotf(float n) { + return 1.0F/tanf(n); +} + +double Transform::backInRads(double angle) { + while (angle >= Deg360) angle -= Deg360; + while (angle < 0.0) angle += Deg360; + return angle; +} + +double Transform::backInRads2(double angle) { + while (angle >= Deg180) angle -= Deg360; + while (angle < -Deg180) angle += Deg360; + return angle; +} + +Transform transform; + +#endif \ No newline at end of file diff --git a/src/telescope/mount/coordinates/Transform.h b/src/telescope/mount/coordinates/Transform.h new file mode 100755 index 0000000..198dc60 --- /dev/null +++ b/src/telescope/mount/coordinates/Transform.h @@ -0,0 +1,114 @@ +//-------------------------------------------------------------------------------------------------- +// coordinate transformation +#pragma once + +#include "../../../Common.h" + +#ifdef MOUNT_PRESENT + +#include +#include "../site/Site.h" +#include "Align.ref.h" +#include "Align.hs.h" + +// MOTOR <--> apply index offset and backlash <--> INSTRUMENT (Axis) +// INSTRUMENT <--> apply celestial coordinate conventions <--> MOUNT (Transform) +// MOUNT <--> apply pointing model <--> OBSERVED (Transform) +// OBSERVED <--> apply refraction <--> TOPOCENTRIC (Transform) + +// CR_MOUNT for Horizon or Equatorial mount coordinates, depending on the mount type +// CR_MOUNT_EQU for Equatorial mount coordinates +// CR_MOUNT_ALT for altitude (a) and Horizon or Equatorial mount coordinates +// CR_MOUNT_HOR for Horizon mount coordinates +// CR_MOUNT_ALL for both Equatorial and Horizon mount coordinates +enum CoordReturn: uint8_t {CR_MOUNT, CR_MOUNT_EQU, CR_MOUNT_ALT, CR_MOUNT_HOR, CR_MOUNT_ALL}; + +class Transform { + public: + // setup for coordinate transformation + void init(uint8_t mountType); + + #if DEBUG != OFF + // prints a coordinate to the debug serial port + void print(Coordinate *coord); + #endif + + // converts from Mount (equatorial or horizon) to Native (equatorial and optionally horizon also) coordinates + // returns equatorial RA + Coordinate mountToNative(Coordinate *coord, bool returnHorizonCoords = false); + // converts from Native (equatorial) to Mount (equatorial or horizon) coordinates (optional: a1 is h or z, a2 is d or a) + // accepts equatorial RA + void nativeToMount(Coordinate *coord, double *a1 = NULL, double *a2 = NULL); + + // converts from Mount to Topocentric coordinates (removes pointing model and refraction from equatorial coordinates) + void mountToTopocentric(Coordinate *coord); + // converts from Topocentric to Mount coordinates (adds pointing model and refraction to equatorial coordinates) + void topocentricToMount(Coordinate *coord); + + // converts from Mount to Observed coordinates (removes pointing model from coordinates) + void mountToObservedPlace(Coordinate *coord); + // converts from Observed to Mount coordinates (adds pointing model to coordinates) + void observedPlaceToMount(Coordinate *coord); + + // converts from Instrument (angular) to Mount (equatorial or horizon) coordinates + Coordinate instrumentToMount(double a1, double a2); + // converts from Mount (equatorial or horizon) to Instrument (angular) coordinates + void mountToInstrument(Coordinate *coord, double *a1, double *a2); + + // converts from Topocentric to Observed coordinates (removes refraction effects from equatorial coordinates) + void topocentricToObservedPlace(Coordinate *coord); + // converts from Observed to Topocentric coordinates (adds refraction effects to equatorial coordinates) + void observedPlaceToTopocentric(Coordinate *coord); + + // converts from Hour Angle (h) to Right Ascension (r) coordinates + void hourAngleToRightAscension(Coordinate *coord, bool native); + // converts from Right Ascension (r) to Hour Angle (h) coordinates + // set RA to NAN to use the Hour Angle coordinate as (h) + void rightAscensionToHourAngle(Coordinate *coord, bool native); + + // converts from Equatorial (h,d) to Horizon (a,z) coordinates + void equToHor(Coordinate *coord); + // converts from Equatorial (h,d) to Horizon (a) altitude coordinate + void equToAlt(Coordinate *coord); + // converts from Horizon (a,z) to Equatorial (h,d) coordinates + void horToEqu(Coordinate *coord); + + // converts from AltAlt (aa1,aa2) to Horizon (a,z) coordinates + void aaToHor(Coordinate *coord); + // converts from Horizon (a,z) to AltAlt (aa1,aa2) coordinates + void horToAa(Coordinate *coord); + // converts from AltAlt (aa1,aa2) to Equatorial (h,d) coordinates + void aaToEqu(Coordinate *coord) { aaToHor(coord); horToEqu(coord); }; + // converts from equatorial (h,d) to AltAlt (aa1,aa2) coordinates + void equToAa(Coordinate *coord) { equToHor(coord); horToAa(coord); }; + + // refraction at altitude, pressure (millibars), and temperature (celsius) + // returns amount of refraction at the true altitude + double trueRefrac(double altitude); + // refraction at altitude, pressure (millibars), and temperature (celsius) + // returns the amount of refraction at the apparent altitude + double apparentRefrac(double altitude); + + // flag if this mount is equatorial or not + bool isEquatorial() { return mountType == GEM || mountType == FORK; }; + + #if ALIGN_MAX_NUM_STARS > 1 + GeoAlign align; + #endif + + int8_t mountType = MOUNT_SUBTYPE; + bool meridianFlips; + + private: + + float cotf(float n); + + // adjust coordinate back into 0 to 360 "degrees" range (in radians) + double backInRads(double angle); + // adjust coordinate back into -180 to 180 "degrees" range (in radians) + double backInRads2(double angle); +}; + +extern Transform transform; + +#endif diff --git a/src/telescope/mount/coordinates/coordinates.ino b/src/telescope/mount/coordinates/coordinates.ino new file mode 100755 index 0000000..0f91199 --- /dev/null +++ b/src/telescope/mount/coordinates/coordinates.ino @@ -0,0 +1,4 @@ +// Placeholder file +// Nothing to see here ... +// +// This file is only present so the Arduino IDE can edit the .h file(s) diff --git a/src/telescope/mount/goto/Goto.command.cpp b/src/telescope/mount/goto/Goto.command.cpp new file mode 100755 index 0000000..c4ecb7b --- /dev/null +++ b/src/telescope/mount/goto/Goto.command.cpp @@ -0,0 +1,583 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, commands + +#include "Goto.h" + +#if defined(MOUNT_PRESENT) + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../site/Site.h" +#include "../Mount.h" +#include "../guide/Guide.h" +#include "../home/Home.h" +#include "../limits/Limits.h" +#include "../status/Status.h" + +bool Goto::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + PrecisionMode precisionMode = PM_HIGH; + + if (command[0] == 'A') { + // :AW# Align Write to EEPROM + // Returns: 1 on success + if (command[1] == 'W' && parameter[0] == 0) { + #if ALIGN_MAX_NUM_STARS > 1 + transform.align.modelWrite(); + #endif + } else + + // :A?# Align status + // Returns: mno# + // where m is the maximum number of alignment stars + // n is the current alignment star (0 otherwise) note: this is always 1 greater than the number + // of alignment stars accepted and so can range from '0' to ':' (':' = '0' + 10) + // o is the last required alignment star when an alignment is in progress (0 otherwise) + if (command[1] == '?' && parameter[0] == 0) { + reply[0] = '0' + ALIGN_MAX_NUM_STARS; + reply[1] = '0' + alignState.currentStar; + reply[2] = '0' + alignState.lastStar; + reply[3] = 0; + *numericReply = false; + } else + + // :A[n]# Start Telescope Manual Alignment Sequence + // This is to initiate a n-star alignment for 1..MAX_NUM_ALIGN_STARS: + // 1) Before calling this function, the telescope should be in the polar-home position + // 2) Call this function with the # of align stars you'd like to use + // 3) Set the target location (RA/Dec) to a bright star, etc. (not too near the NCP/SCP) + // 4) Issue a goto command + // 5) Center the star/object using the guide commands (as needed) + // 6) Call :A+# command to accept the correction + // ( for two+ star alignment ) + // 7) Back to #3 above until done, except where possible choose at least one star on both meridian sides + // Return: 0 on failure + // 1 on success + if (command[1] >= '1' && command[1] <= ALIGN_MAX_NUM_STARS + '0' && parameter[0] == 0) { + // set current time and date before calling this routine + #if ALIGN_AUTO_HOME == ON && GOTO_FEATURE == ON + home.requestWithReset(); + #else + home.reset(); + #endif + mount.tracking(true); + + // start align... + alignState.lastStar = command[1] - '0'; + alignState.currentStar = 1; + VLF("MSG: Mount, align requested"); + } else + + // :A+# Align accept target location + // Return: 0 on failure + // 1 on success + if (command[1] == '+' && parameter[0] == 0) { + if (alignActive()) { + CommandError e = alignAddStar(); + if (e != CE_NONE) { + alignState.lastStar = 0; + alignState.currentStar = 0; + *commandError = e; + DLF("ERR: Mount, failed to add align point"); + } else { VLF("MSG: Mount, align point added"); } + } else *commandError = CE_ALIGN_NOT_ACTIVE; + } else *commandError = CE_CMD_UNKNOWN; + } else + + // C - Sync Control + // :CS# Synchonize the telescope with the current right ascension and declination coordinates + // Returns: Nothing (Sync's fail silently) + // :CM# Synchonize the telescope with the current database object (as above) + // Returns: "N/A#" on success, "En#" on failure where n is the error code per the :MS# command + if (command[0] == 'C' && (command[1] == 'S' || command[1] == 'M') && parameter[0] == 0) { + CommandError e; + + if (alignActive()) { + e = alignAddStar(true); + if (e != CE_NONE) { + alignState.lastStar = 0; + alignState.currentStar = 0; + *commandError = e; + DLF("ERR: Mount, failed to add align point"); + } else { VLF("MSG: Mount, align point added"); } + } else { + Coordinate before = mount.getMountPosition(CR_MOUNT); + PierSideSelect pps = settings.preferredPierSide; + if (!mount.isHome() && PIER_SIDE_SYNC_CHANGE_SIDES == OFF) pps = PSS_SAME_ONLY; + e = requestSync(gotoTarget, pps); + Coordinate after = mount.getMountPosition(CR_MOUNT); + if (before.pierSide != PIER_SIDE_NONE && before.pierSide != after.pierSide) mountStatus.soundAlert(); + } + + if (command[1] == 'M') { + if (e == CE_NONE) strcpy(reply, "N/A"); else + if (e >= CE_SLEW_ERR_BELOW_HORIZON && e <= CE_SLEW_ERR_UNSPECIFIED) { + strcpy(reply, "E0"); + reply[1] = (char)(e - CE_SLEW_ERR_BELOW_HORIZON) + '1'; + } else { + DF("ERR: Mount, sync unspecified error occured ("); D(e); DLF(")"); + strcpy(reply, "E9"); + } + } + *numericReply = false; + } else + + // D - Distance Bars + // :D# Return: "\0x7f#" if the mount is moving, otherwise "#". + if (command[0] == 'D' && command[1] == 0) { + if (goTo.state == GS_GOTO) { + reply[0] = (char)127; + reply[1] = 0; + } else { + reply[0] = '#'; + reply[1] = 0; + *suppressFrame = true; + } + *numericReply = false; + } else + + if (command[0] == 'G') { + // :Gr# Get target Right Ascension + // Returns: HH:MM.T# or HH:MM:SS (based on precision setting) + // :GrH# Returns: HH:MM:SS.SSSS# (high precision) + if (command[1] == 'r' && (parameter[0] == 0 || parameter[1] == 0)) { + if (parameter[0] == 'H' || parameter[0] == 'a') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + convert.doubleToHms(reply, radToHrs(gotoTarget.r), false, precisionMode); + *numericReply = false; + } else + + // :Gd# Get target Declination + // Returns: HH:MM.T# or HH:MM:SS (based on precision setting) + // :GdH# High precision + // Returns: HH:MM:SS.SSS# (high precision) + if (command[1] == 'd' && (parameter[0] == 0 || parameter[1] == 0)) { + if (parameter[0] == 'H' || parameter[0] == 'e') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + convert.doubleToDms(reply, radToDeg(gotoTarget.d), false, true, precisionMode); + *numericReply = false; + } else + + // :Gal# Get target Altitude + // Returns: sDD*MM# or sDD*MM'SS# (based on precision setting) + // :GaH# High precision + // Returns: sDD*MM'SS.SSS# (high precision) + if (command[1] == 'a' && (parameter[0] == 'H' || parameter[0] == 'l') && parameter[1] == 0) { + if (parameter[0] == 'H') precisionMode = PM_HIGHEST; + convert.doubleToHms(reply, radToDeg(gotoTarget.a), false, precisionMode); + *numericReply = false; + } else + + // :Gz# Get target Azimuth + // Returns: DDD*MM# or DDD*MM'SS# (based on precision setting) + // :GzH# High precision + // Returns: DDD*MM'SS.SSS# (high precision) + if (command[1] == 'z' ) { + if (parameter[0] == 'H') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + convert.doubleToDms(reply, radToDeg(gotoTarget.z), true, false, precisionMode); + *numericReply = false; + } else + + if (command[1] == 'X' && parameter[2] == 0) { + #if ALIGN_MAX_NUM_STARS > 1 + // :GX0[n]# Get align setting [n] + // Returns: Value + if (parameter[0] == '0') { + static int star = 0; + *numericReply = false; + switch (parameter[1]) { + case '0': sprintf(reply, "%ld",(long)round((radToArcsec(transform.align.model.ax1Cor)))); break; // ax1Cor + case '1': sprintf(reply, "%ld",(long)round((radToArcsec(transform.align.model.ax2Cor)))); break; // ax2Cor + case '2': sprintf(reply, "%ld",(long)round((radToArcsec(transform.align.model.altCor)))); break; // altCor + case '3': sprintf(reply, "%ld",(long)round((radToArcsec(transform.align.model.azmCor)))); break; // azmCor + case '4': sprintf(reply, "%ld",(long)round((radToArcsec(transform.align.model.doCor)))); break; // doCor + case '5': sprintf(reply, "%ld",(long)round((radToArcsec(transform.align.model.pdCor)))); break; // pdCor + case '6': if (transform.mountType == FORK || transform.mountType == ALTAZM) // ffCor + sprintf(reply, "%ld",(long)(round(radToArcsec(transform.align.model.dfCor)))); else sprintf(reply, "%ld",(long)(0)); + break; + case '7': if (transform.mountType != FORK && transform.mountType != ALTAZM) // dfCor + sprintf(reply, "%ld",(long)(round(radToArcsec(transform.align.model.dfCor)))); else sprintf(reply, "%ld",(long)(0)); + break; + case '8': sprintf(reply, "%ld",(long)(round(radToArcsec(transform.align.model.tfCor)))); break; // tfCor + case 'a': sprintf(reply, "%ld",(long)(round(radToDeg(transform.align.model.hcp)))); break; // hcp + case 'b': sprintf(reply, "%ld",(long)(round(radToArcsec(transform.align.model.hca)))); break; // hca + case 'c': sprintf(reply, "%ld",(long)(round(radToDeg(transform.align.model.dcp)))); break; // dcp + case 'd': sprintf(reply, "%ld",(long)(round(radToArcsec(transform.align.model.dca)))); break; // dca + // number of stars, reset to first star + case '9': { int n = 0; if (alignState.currentStar > alignState.lastStar) n = alignState.lastStar; sprintf(reply, "%ld",(long)(n)); star = 0; } break; + case 'A': { convert.doubleToHms(reply,radToHrs(transform.align.actual[star].h),true,PM_HIGH); } break; + case 'B': { convert.doubleToDms(reply,radToDeg(transform.align.actual[star].d),false,true,PM_HIGH); } break; + case 'C': { convert.doubleToHms(reply,radToHrs(transform.align.mount[star].h),true,PM_HIGH); } break; + case 'D': { convert.doubleToDms(reply,radToDeg(transform.align.mount[star].d),false,true,PM_HIGH); } break; + // pier side (and increment n) + case 'E': sprintf(reply, "%ld",(long)(transform.align.mount[star].side)); star++; break; + default: *numericReply = true; *commandError = CE_CMD_UNKNOWN; + } + } else + #endif + + // :GX9[n]# Get setting [n] + // Returns: Value + if (parameter[0] == '9') { + switch (parameter[1]) { + // current rate in us/step + case '2': sprintF(reply, "%0.3f", settings.usPerStepCurrent); break; + // default base rate in us/step + case '3': sprintF(reply, "%0.3f", usPerStepBase); break; + // pierSide 0 = None, 1 = East, 2 = West (with suffix 'N' if meridian flips are disabled) + case '4': sprintf(reply, "%d%s", (int)mount.getMountPosition().pierSide, (!transform.meridianFlips)?" N":""); break; + // autoMeridianFlip + case '5': sprintf(reply, "%d", (int)isAutoFlipEnabled()); break; + // preferred pier side + case '6': reply[0] = transform.meridianFlips ? "EWBA"[settings.preferredPierSide - 1] : 'E'; reply[1] = 0; break; + // current step rate in deg/s + case '7': sprintF(reply, "%0.1f", (1000000.0F/settings.usPerStepCurrent)/degToRadF(axis1.getStepsPerMeasure())); break; + // fastest step rate in us/step + case '9': sprintF(reply, "%0.3f",usPerStepLowerLimit()); break; + default: return false; + } + *numericReply = false; + } else return false; + } else return false; + } else + + if (command[0] == 'M') { + // :MA# Goto the target Alt and Az + // Returns: 0..9, see :MS# + if (command[1] == 'A' && parameter[0] == 0) { + transform.horToEqu(&gotoTarget); + transform.hourAngleToRightAscension(&gotoTarget, true); + CommandError e = request(gotoTarget, settings.preferredPierSide); + strcpy(reply,"0"); + if (e >= CE_SLEW_ERR_BELOW_HORIZON && e <= CE_SLEW_ERR_UNSPECIFIED) reply[0] = (char)(e - CE_SLEW_ERR_BELOW_HORIZON) + '1'; + if (e == CE_NONE) reply[0] = '0'; + *numericReply = false; + *suppressFrame = true; + *commandError = e; + } else + + // :MD# Goto Destination pier side for the Target Object + // Returns: + // 0=destination is East of the pier + // 1=destination is West of the pier + // 2=destination is Unknown + if (command[1] == 'D' && parameter[0] == 0) { + Coordinate coords = gotoTarget; + coords.pierSide = PIER_SIDE_NONE; + transform.nativeToMount(&coords); + CommandError e = setTarget(&coords, settings.preferredPierSide); + strcpy(reply, "2"); + if (e == CE_NONE && target.pierSide == PIER_SIDE_EAST) reply[0] = '0'; + if (e == CE_NONE && target.pierSide == PIER_SIDE_WEST) reply[0] = '1'; + *numericReply = false; + *suppressFrame = true; + *commandError = e; + } else + + // :MN# Goto current RA/Dec but opposite Pier side (within meridian limit overlap) + // :MNe# Goto current RA/Dec but East of the Pier (within meridian limit overlap) + // :MNw# Goto current RA/Dec but West of the Pier (within meridian limit overlap) + // Returns: 0..9, see :MS# + if (command[1] == 'N') { + if (transform.meridianFlips) { + Coordinate newTarget = mount.getPosition(); + CommandError e = CE_NONE; + + if (parameter[0] == 0) { + parameter[1] = 0; + if (newTarget.pierSide == PIER_SIDE_EAST) parameter[0] = 'w'; else + if (newTarget.pierSide == PIER_SIDE_WEST) parameter[0] = 'e'; else e = CE_SLEW_ERR_UNSPECIFIED; + } + + if (e != CE_SLEW_ERR_UNSPECIFIED) { + if (parameter[0] == 'e' && parameter[1] == 0) e = request(newTarget, PSS_EAST_ONLY); else + if (parameter[0] == 'w' && parameter[1] == 0) e = request(newTarget, PSS_WEST_ONLY); else e = CE_CMD_UNKNOWN; + } + + if (e != CE_CMD_UNKNOWN) { + if (e >= CE_SLEW_ERR_BELOW_HORIZON && e <= CE_SLEW_ERR_UNSPECIFIED) reply[0] = (char)(e - CE_SLEW_ERR_BELOW_HORIZON) + '1'; + if (e == CE_NONE) reply[0] = '0'; + reply[1] = 0; + *numericReply = false; + *suppressFrame = true; + } + *commandError = e; + } else *commandError = CE_CMD_UNKNOWN; + } else + + // :MP# Goto the Current Position for Polar Align + // Returns: 0..9, see :MS# + if (command[1] == 'P' && parameter[0] == 0) { + if (transform.isEquatorial()) { + Coordinate newTarget = mount.getPosition(); + CommandError e = validate(); + if (e == CE_NONE) e = limits.validateTarget(&newTarget, true); + if (e == CE_NONE) { + #if ALIGN_MAX_NUM_STARS > 1 + transform.align.model.altCor = 0.0; + transform.align.model.azmCor = 0.0; + #endif + e = request(newTarget, PSS_SAME_ONLY); + } + if (e >= CE_SLEW_ERR_BELOW_HORIZON && e <= CE_SLEW_ERR_UNSPECIFIED) reply[0] = (char)(e - CE_SLEW_ERR_BELOW_HORIZON) + '1'; + if (e == CE_NONE) reply[0] = '0'; + reply[1] = 0; + *numericReply = false; + *suppressFrame = true; + *commandError = e; + } else *commandError = CE_CMD_UNKNOWN; + } else + + // :MS# Goto the Target Object + // Returns: + // 0=goto is possible + // 1=below the horizon limit + // 2=above overhead limit + // 3=controller in standby + // 4=mount is parked + // 5=goto in progress + // 6=outside limits + // 7=hardware fault + // 8=already in motion + // 9=unspecified error + if (command[1] == 'S' && parameter[0] == 0) { + CommandError e = request(gotoTarget, settings.preferredPierSide); + strcpy(reply,"0"); + if (e >= CE_SLEW_ERR_BELOW_HORIZON && e <= CE_SLEW_ERR_UNSPECIFIED) reply[0] = (char)(e - CE_SLEW_ERR_BELOW_HORIZON) + '1'; + if (e == CE_NONE) reply[0] = '0'; + *numericReply = false; + *suppressFrame = true; + *commandError = e; + } else return false; + } else + + if (command[0] == 'S') { + // :Sr[HH:MM.T]# or :Sr[HH:MM:SS]# or :Sr[HH:MM:SS.SSSS]# + // Set Target Right Ascension + // Return: 0 on failure + // 1 on success + if (command[1] == 'r') { + if (!convert.hmsToDouble(&gotoTarget.r, parameter)) *commandError = CE_PARAM_RANGE; else + gotoTarget.r = hrsToRad(gotoTarget.r); + } else + + // :Sd[sDD*MM]# or :Sd[sDD*MM:SS]# or :Sd[sDD*MM:SS.SSS]# + // Set Target Declination + // Return: 0 on failure + // 1 on success + if (command[1] == 'd') { + if (!convert.dmsToDouble(&gotoTarget.d, parameter, true)) *commandError = CE_PARAM_RANGE; else + gotoTarget.d = degToRad(gotoTarget.d); + } else + + // :Sa[sDD*MM]# or :Sa[sDD*MM'SS]# or :Sa[sDD*MM'SS.SSS]# + // Set Target Altitude + // Return: 0 on failure + // 1 on success + if (command[1] == 'a') { + if (!convert.dmsToDouble(&gotoTarget.a, parameter, true)) *commandError = CE_PARAM_RANGE; else + gotoTarget.a = degToRad(gotoTarget.a); + } else + + // :Sz[DDD*MM]# or :Sz[DDD*MM'SS]# or :Sz[DDD*MM'SS.SSS]# + // Set Target Azmuith + // Return: 0 on failure + // 1 on success + if (command[1] == 'z') { + if (!convert.dmsToDouble(&gotoTarget.z, parameter, false)) *commandError = CE_PARAM_RANGE; else + gotoTarget.z = degToRad(gotoTarget.z); + } else + + if (command[1] == 'X') { + if (parameter[2] != ',') { *commandError = CE_PARAM_FORM; return true; } + + #if ALIGN_MAX_NUM_STARS > 1 + // :SX0[m],[n]# Set align model coefficient [m] to value [n] + // Return: 0 on failure + // 1 on success + if (parameter[0] == '0') { + static int star; + double d; + switch (parameter[1]) { + case '0': transform.align.model.ax1Cor = arcsecToRad(atol(¶meter[3])); break; // ax1Cor + case '1': transform.align.model.ax2Cor = arcsecToRad(atol(¶meter[3])); break; // ax2Cor + case '2': transform.align.model.altCor = arcsecToRad(atol(¶meter[3])); break; // altCor + case '3': transform.align.model.azmCor = arcsecToRad(atol(¶meter[3])); break; // azmCor + case '4': transform.align.model.doCor = arcsecToRad(atol(¶meter[3])); break; // doCor + case '5': transform.align.model.pdCor = arcsecToRad(atol(¶meter[3])); break; // pdCor + case '6': + if (transform.mountType == FORK || transform.mountType == ALTAZM) // fdCor or ffCor + transform.align.model.dfCor = arcsecToRad(atol(¶meter[3])); + break; + case '7': + if (transform.mountType != FORK && transform.mountType != ALTAZM) // fdCor or ffCor + transform.align.model.dfCor = arcsecToRad(atol(¶meter[3])); + break; + case '8': transform.align.model.tfCor = arcsecToRad(atol(¶meter[3])); break; // tfCor + case 'a': transform.align.model.hcp = degToRad(atol(¶meter[3])); break; // hcp + case 'b': transform.align.model.hca = arcsecToRad(atol(¶meter[3])); break; // hca + case 'c': transform.align.model.dcp = degToRad(atol(¶meter[3])); break; // dcp + case 'd': transform.align.model.dca = arcsecToRad(atol(¶meter[3])); break; // dca + // use :SX09,0# to start upload of stars for align, when done use :SX09,1# to calculate the pointing model, or :SX09,2# to force model activation + case '9': { + int n = atol(¶meter[3]); + if (n == 0) { + star = 0; + alignReset(); + } else + if (n == 1) { + if (star >= 1) { + alignState.lastStar = star; + alignState.currentStar = star + 1; + transform.align.createModel(star); + } + } else + if (n == 2) { + transform.align.modelIsReady = true; + } else *commandError = CE_PARAM_RANGE; + } + break; + // Actual HA (n) + case 'A': if (!convert.hmsToDouble(&d, ¶meter[3], PM_HIGH)) *commandError = CE_PARAM_FORM; else transform.align.actual[star].h = hrsToRad(d); break; + // Actual Dec (n) + case 'B': if (!convert.dmsToDouble(&d, ¶meter[3], true, PM_HIGH)) *commandError = CE_PARAM_FORM; else transform.align.actual[star].d = degToRad(d); break; + // Mount HA (n) + case 'C': if (!convert.hmsToDouble(&d, ¶meter[3], PM_HIGH)) *commandError = CE_PARAM_FORM; else transform.align.mount[star].h = hrsToRad(d); break; + // Mount Dec (n) + case 'D': if (!convert.dmsToDouble(&d, ¶meter[3], true, PM_HIGH)) *commandError = CE_PARAM_FORM; else transform.align.mount[star].d = degToRad(d); break; + // Mount PierSide (and increment n) + case 'E': + if (star <= 8) { + transform.align.actual[star].side = transform.align.mount[star].side = atol(¶meter[3]); + if (transform.mountType == ALTAZM) { + Coordinate temp; + temp.h = transform.align.actual[star].h; + temp.d = transform.align.actual[star].d; + transform.equToHor(&temp); + transform.align.actual[star].ax1 = temp.z; + transform.align.actual[star].ax2 = temp.a; + temp.h = transform.align.mount[star].h; + temp.d = transform.align.mount[star].d; + transform.equToHor(&temp); + transform.align.mount[star].ax1 = temp.z; + transform.align.mount[star].ax2 = temp.a; + } else + if (transform.mountType == ALTALT) { + Coordinate temp; + temp.h = transform.align.actual[star].h; + temp.d = transform.align.actual[star].d; + transform.equToAa(&temp); + transform.align.actual[star].ax1 = temp.aa1; + transform.align.actual[star].ax2 = temp.aa2; + temp.h = transform.align.mount[star].h; + temp.d = transform.align.mount[star].d; + transform.equToAa(&temp); + transform.align.mount[star].ax1 = temp.aa1; + transform.align.mount[star].ax2 = temp.aa2; + } else { + transform.align.actual[star].ax1 = transform.align.actual[star].h; + transform.align.actual[star].ax2 = transform.align.actual[star].d; + transform.align.mount[star].ax1 = transform.align.mount[star].h; + transform.align.mount[star].ax2 = transform.align.mount[star].d; + } + star++; + } + break; + default: *commandError = CE_CMD_UNKNOWN; + } + } else + #endif + + // :SX9[m],[n]# Set mount misc. + // Return: see below + if (parameter[0] == '9') { + switch (parameter[1]) { + // set new slew rate (returns 1 success or 0 failure) + case '2': + if (state == GS_NONE && guide.state == GU_NONE) { + char *conv_end; + settings.usPerStepCurrent = strtod(¶meter[3], &conv_end); + if (settings.usPerStepCurrent < usPerStepBase/2.0) settings.usPerStepCurrent = usPerStepBase/2.0; + if (settings.usPerStepCurrent > usPerStepBase*2.0) settings.usPerStepCurrent = usPerStepBase*2.0; + if (settings.usPerStepCurrent < usPerStepLowerLimit()) settings.usPerStepCurrent = usPerStepLowerLimit(); + if (GOTO_FEATURE == OFF) settings.usPerStepCurrent = usPerStepBase; // force base rate + nv().kv().put(nvKey, settings); + updateAccelerationRates(); + } else *commandError = CE_SLEW_IN_MOTION; + break; + // slew rate preset (returns nothing) + case '3': + *numericReply = false; + if (state == GS_NONE && guide.state == GU_NONE) { + switch (parameter[3]) { + case '5': settings.usPerStepCurrent = usPerStepBase*2.0; break; // 50% + case '4': settings.usPerStepCurrent = usPerStepBase*1.5; break; // 66.7% (2/3x) + case '3': settings.usPerStepCurrent = usPerStepBase; break; // 100% + case '2': settings.usPerStepCurrent = usPerStepBase/1.5; break; // 150% + case '1': settings.usPerStepCurrent = usPerStepBase/2.0; break; // 200% + default: settings.usPerStepCurrent = usPerStepBase; + } + if (settings.usPerStepCurrent < usPerStepLowerLimit()) settings.usPerStepCurrent = usPerStepLowerLimit(); + if (GOTO_FEATURE == OFF) settings.usPerStepCurrent = usPerStepBase; // force base rate + nv().kv().put(nvKey, settings); + updateAccelerationRates(); + } else *commandError = CE_SLEW_IN_MOTION; + break; + + // autoMeridianFlip + case '5': + if ((transform.isEquatorial()) && transform.meridianFlips && GOTO_FEATURE != OFF) { + if (parameter[3] == '0' || parameter[3] == '1') { + settings.meridianFlipAuto = parameter[3] - '0'; + #if MFLIP_AUTOMATIC_MEMORY == ON + nv().kv().put(nvKey, settings); + #endif + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_CMD_UNKNOWN; + break; + // preferred pier side + case '6': + if (transform.meridianFlips && GOTO_FEATURE != OFF) { + switch (parameter[3]) { + case 'E': settings.preferredPierSide = PSS_EAST; break; + case 'W': settings.preferredPierSide = PSS_WEST; break; + case 'B': settings.preferredPierSide = PSS_BEST; break; + case 'A': settings.preferredPierSide = PSS_AUTO; break; + default: *commandError = CE_PARAM_RANGE; + } + #if PIER_SIDE_PREFERRED_MEMORY == ON + nv().kv().put(nvKey, settings); + #endif + } else *commandError = CE_CMD_UNKNOWN; + break; + // pause at home on meridian flip + case '8': + if (transform.meridianFlips && GOTO_FEATURE != OFF) { + if (parameter[3] == '0' || parameter[3] == '1') { + #if GOTO_FEATURE == ON + settings.meridianFlipPause = parameter[3] - '0'; + #if MFLIP_PAUSE_HOME_MEMORY == ON + nv().kv().put(nvKey, settings); + #endif + #endif + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_CMD_UNKNOWN; + break; + // continue if paused at home + case '9': + if (transform.meridianFlips && GOTO_FEATURE != OFF) { + if (parameter[3] == '1') { + #if GOTO_FEATURE == ON + if (meridianFlipHome.paused) meridianFlipHome.resume = true; + #endif + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_CMD_UNKNOWN; + break; + default: return false; + } + } else return false; + } else return false; + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/mount/goto/Goto.cpp b/src/telescope/mount/goto/Goto.cpp new file mode 100755 index 0000000..b72977d --- /dev/null +++ b/src/telescope/mount/goto/Goto.cpp @@ -0,0 +1,734 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, sync and goto + +#include "Goto.h" + +#if defined(MOUNT_PRESENT) + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../../Telescope.h" +#include "../Mount.h" +#include "../coordinates/Transform.h" +#include "../guide/Guide.h" +#include "../home/Home.h" +#include "../park/Park.h" +#include "../limits/Limits.h" +#include "../status/Status.h" + +#if GOTO_FEATURE == ON +inline void gotoWrapper() { goTo.poll(); } +#endif + +void Goto::init() { + + nvKey = nv().kv().computeKey("GOTO_SETTINGS"); + if (!nv().kv().getOrInit(nvKey, settings)) { DLF("WRN: Nv, init failed for GOTO_SETTINGS"); } + + settings.meridianFlipAuto = constrain(settings.meridianFlipAuto, false, true); + settings.meridianFlipPause = constrain(settings.meridianFlipPause, false, true); + settings.preferredPierSide = constrain(settings.preferredPierSide, PSS_NONE, PSS_SAME_ONLY); + + // force defaults if needed + #if MFLIP_PAUSE_HOME_MEMORY != ON + settings.meridianFlipPause = (MFLIP_PAUSE_HOME_DEFAULT == ON); + #endif + + if (MFLIP_AUTOMATIC_MEMORY != ON || !transform.meridianFlips) settings.meridianFlipAuto = (MFLIP_AUTOMATIC_DEFAULT == ON); + + #if PIER_SIDE_PREFERRED_MEMORY != ON + settings.preferredPierSide = (PierSideSelect)PIER_SIDE_PREFERRED_DEFAULT; + #endif + + // calculate base and current maximum step rates + #if GOTO_FEATURE == ON + usPerStepBase = 1000000.0F/((axis1.getStepsPerMeasure()/RAD_DEG_RATIO)*SLEW_RATE_BASE_DESIRED); + #if SLEW_RATE_MEMORY != ON + settings.usPerStepCurrent = usPerStepBase; + #endif + #else + usPerStepBase = 1000000.0F/((axis1.getStepsPerMeasure()/RAD_DEG_RATIO)*1.0F); + settings.usPerStepCurrent = usPerStepBase; + #endif + + settings.usPerStepCurrent = constrain(settings.usPerStepCurrent, usPerStepBase/2.0F, usPerStepBase*2.0F); + if (usPerStepBase < usPerStepLowerLimit()) usPerStepBase = usPerStepLowerLimit()*2.0F; + if (settings.usPerStepCurrent > 1000000.0F) settings.usPerStepCurrent = usPerStepBase; + if (settings.usPerStepCurrent < usPerStepBase/2.0F) settings.usPerStepCurrent = usPerStepBase/2.0F; + if (settings.usPerStepCurrent > usPerStepBase*2.0F) settings.usPerStepCurrent = usPerStepBase*2.0F; + + axis1.setFrequencyMax(((1000000.0F/usPerStepBase)/axis1.getStepsPerMeasure())*2.0F); + axis2.setFrequencyMax(((1000000.0F/usPerStepBase)/axis2.getStepsPerMeasure())*2.0F); + + absoluteEncodersPresent = axis1.motor->hasAbsoluteEncoder() || axis2.motor->hasAbsoluteEncoder(); + if (AXIS1_HOME_TOLERANCE != 0.0F || AXIS2_HOME_TOLERANCE != 0.0F || + AXIS1_TARGET_TOLERANCE != 0.0F || AXIS2_TARGET_TOLERANCE != 0.0F || absoluteEncodersPresent) encodersPresent = true; + + updateAccelerationRates(); +} + +// goto to equatorial target position (Native coordinate system) using the defaut preferredPierSide +CommandError Goto::request() { + return request(target, settings.preferredPierSide); +} + +#if GOTO_FEATURE == ON + +// goto equatorial position (Native or Mount coordinate system) +CommandError Goto::request(Coordinate coords, PierSideSelect pierSideSelect, bool native) { + if (!mount.startupAuthorityTrusted()) { + DLF("WRN: Mount, goto rejected because startup authority is not trusted"); + return CE_SLEW_ERR_UNSPECIFIED; + } + + if (native) { + coords.pierSide = PIER_SIDE_NONE; + transform.nativeToMount(&coords); + } + + CommandError e = setTarget(&coords, pierSideSelect); + if (e == CE_SLEW_IN_SLEW) { abort(); return e; } + if (e != CE_NONE) return e; + + lastAlignTarget = target; + + #if AXIS1_SECTOR_GEAR == ON || AXIS2_TANGENT_ARM == ON + double a1, a2; + + // handle special case of a sector gear RA + #if AXIS1_SECTOR_GEAR == ON + transform.mountToInstrument(&target, &a1, &a2); + a1 = a1 - axis1.getIndexPosition(); + if (a1 < axis1.getLimitMin()) return CE_SLEW_ERR_OUTSIDE_LIMITS; + if (a1 > axis1.getLimitMax()) return CE_SLEW_ERR_OUTSIDE_LIMITS; + #endif + + // handle special case of a tangent arm Dec + #if AXIS2_TANGENT_ARM == ON + transform.mountToInstrument(&target, &a1, &a2); + a2 = a2 - axis2.getIndexPosition(); + if (a2 < axis2.getLimitMin()) return CE_SLEW_ERR_OUTSIDE_LIMITS; + if (a2 > axis2.getLimitMax()) return CE_SLEW_ERR_OUTSIDE_LIMITS; + #endif + #endif + + limits.enabled(true); + mount.syncFromOnStepToEncoders = false; + if (firstGoto) { + mount.tracking(true); + firstGoto = false; + } + guide.backlashEnableControl(true); + + // allow slewing near target for Eq modes but disable for alt/az, parking, homing if encoders are not present + nearDestinationRefineStages = 0; + slewDestinationDistHA = 0.0; + slewDestinationDistDec = 0.0; + if ((encodersPresent || (park.state != PS_PARKING && home.state != HS_HOMING))) { + nearDestinationRefineStages = GOTO_REFINE_STAGES; + if (transform.isEquatorial()) { + slewDestinationDistHA = degToRad(GOTO_OFFSET); + slewDestinationDistDec = degToRad(GOTO_OFFSET); + if (target.pierSide == PIER_SIDE_WEST) slewDestinationDistDec = -slewDestinationDistDec; + } + } + + // prepare for goto + Coordinate current = mount.getMountPosition(CR_MOUNT_HOR); + state = GS_GOTO; + stage = GG_NEAR_DESTINATION_START; + start = current; + destination = target; + + // add waypoint if needed + if (transform.isEquatorial() && MFLIP_SKIP_HOME == OFF && start.pierSide != destination.pierSide) { + VLF("MSG: Mount, goto changes pier side, setting waypoint at home"); + waypoint(¤t); + } + + // allow goto and enable tracking after any of the limits below are exceeded + // typically these are triggered by tracking into the relevant limit and + // a goto is safe since it should always move away from the limit else it wouldn't be allowed + // finally I enabling tracking again since that allows for easy recovery + #if LIMIT_RECOVERY == ON + if (limits.isBelowHorizon() || limits.isPastMeridianW() || limits.isPastAxis1Max()) { + limits.limitsDisablePeriod(1.0F); + #if LIMIT_RECOVERY_WITH_TRACKING == ON + if (home.state != HS_HOMING && park.state != PS_PARKING) mount.tracking(true); + #endif + } + #endif + + // start the goto monitor + if (taskHandle != 0) tasks.remove(taskHandle); + taskHandle = tasks.add(0, 0, true, 3, gotoWrapper, "MntGoto"); + if (taskHandle) { + VLF("MSG: Mount, create goto monitor task (idle, priority 3)... success"); + VLF("MSG: Mount, attempting goto"); + + e = startAutoSlew(); + if (e != CE_NONE) { + VF("MSG: Mount, goto failed with error "); VL(e); + return e; + } + + tasks.setPeriodMicros(taskHandle, FRACTIONAL_SEC_US); + VF("MSG: Mount, goto monitor task set rate "); V(FRACTIONAL_SEC_US); VL("us"); + + mountStatus.soundAlert(); + + } else { DLF("WRN: Mount, start goto monitor task... FAILED!"); } + + return CE_NONE; +} +#else + +// sync replaces goto to equatorial position (Native or Mount coordinate system) when GOTO_FEATURE is OFF +CommandError Goto::request(Coordinate coords, PierSideSelect pierSideSelect, bool native) { + mountStatus.soundAlert(); + + return requestSync(coords, pierSideSelect, native); +} +#endif + +// sync to equatorial target position (Native coordinate system) using the default preferredPierSide +CommandError Goto::requestSync() { + return requestSync(target, settings.preferredPierSide); +} + +// sync to equatorial position (Native or Mount coordinate system) +CommandError Goto::requestSync(Coordinate coords, PierSideSelect pierSideSelect, bool native) { + if (!mount.startupAuthorityTrusted()) { + DLF("WRN: Mount, sync rejected because startup authority is not trusted"); + return CE_SLEW_ERR_UNSPECIFIED; + } + + if (native) { + coords.pierSide = PIER_SIDE_NONE; + transform.nativeToMount(&coords); + } + + CommandError e = setTarget(&coords, pierSideSelect, false); + if (e != CE_NONE) return e; + + if (mount.isHome()) mount.tracking(true); + + double a1, a2; + transform.mountToInstrument(&target, &a1, &a2); + a1 += target.a1Correction; + + e = limits.validateInstrumentCoordinate(1, a1); + if (e != CE_NONE) return e; + e = limits.validateInstrumentCoordinate(2, a2); + if (e != CE_NONE) return e; + e = limits.setInstrumentCoordinate(1, a1, true); + if (e == CE_NONE) e = limits.setInstrumentCoordinate(2, a2, true); + if (e != CE_NONE) return e; + + limits.enabled(true); + mount.syncFromOnStepToEncoders = true; + + VLF("MSG: Mount, sync instrument coordinates updated"); + + return CE_NONE; +} + +// checks for valid target and determines pier side (Mount coordinate system) +CommandError Goto::setTarget(Coordinate *coords, PierSideSelect pierSideSelect, bool isGoto) { + CommandError e = validate(); + if (e == CE_SLEW_ERR_IN_STANDBY && (encodersPresent || mount.isHome())) { + mount.enable(true); + e = validate(); + } + if (e == CE_NONE && isGoto && limits.isAboveOverhead()) e = CE_SLEW_ERR_OUTSIDE_LIMITS; + if (e != CE_NONE) return e; + + target = *coords; + + if (transform.mountType == ALTAZM) transform.horToEqu(&target); else + if (transform.mountType == ALTALT) transform.aaToEqu(&target); else transform.equToHor(&target); + + // east side of pier is always the default polar-home position + // east side of pier - we're in the western sky and the HA's are positive + // west side of pier - we're in the eastern sky and the HA's are negative + + Coordinate current = mount.getMountPosition(CR_MOUNT); + + if (!transform.meridianFlips) pierSideSelect = PSS_EAST_ONLY; + + bool pierSideBest = false; + if (pierSideSelect == PSS_AUTO) { + if (transform.mountType != ALTAZM && transform.mountType != ALTALT) { + if (isGoto && (current.h < -Deg90 || current.h > Deg90)) pierSideSelect = PSS_WEST; else pierSideSelect = PSS_EAST; + } else pierSideSelect = PSS_BEST; + } + if (pierSideSelect == PSS_BEST) { + if (current.pierSide == PIER_SIDE_WEST) pierSideSelect = PSS_WEST; else pierSideSelect = PSS_EAST; + pierSideBest = true; + } + if (pierSideSelect == PSS_SAME_ONLY) { + if (current.pierSide == PIER_SIDE_WEST) pierSideSelect = PSS_WEST_ONLY; else pierSideSelect = PSS_EAST_ONLY; + } + + bool eastReachable, westReachable; + + target.pierSide = current.pierSide; + target.a1Correction = 0.0; + + double axis1TargetCorrectionE = 0.0; + double axis1TargetCorrectionW = 0.0; + e = limits.validateTarget(&target, &eastReachable, &westReachable, &axis1TargetCorrectionE, &axis1TargetCorrectionW, isGoto); + if (e != CE_NONE) return e; + + double a1, a2, a1e, a1w, a2e, a2w; + a1 = axis1.getInstrumentCoordinate(); + a2 = axis2.getInstrumentCoordinate(); + + target.pierSide = PIER_SIDE_EAST; + transform.mountToInstrument(&target, &a1e, &a2e); + a1e += axis1TargetCorrectionE; + + target.pierSide = PIER_SIDE_WEST; + transform.mountToInstrument(&target, &a1w, &a2w); + a1w += axis1TargetCorrectionW; + + target.pierSide = current.pierSide; + + VF("MSG: Mount, set-target current axis1 "); V(radToDeg(a1)); VF(" and axis2 "); VL(radToDeg(a2)); + VF("MSG: Mount, set-target targetE axis1 "); V(radToDeg(a1e)); VF(" and axis2 "); VL(radToDeg(a2e)); + VF("MSG: Mount, set-target targetW axis1 "); V(radToDeg(a1w)); VF(" and axis2 "); VL(radToDeg(a2w)); + + double eastDistance, westDistance; + if (dist(a1, a1e) > dist(a2, a2e)) eastDistance = dist(a1, a1e); else eastDistance = dist(a2, a2e); + if (dist(a1, a1w) > dist(a2, a2w)) westDistance = dist(a1, a1w); else westDistance = dist(a2, a2w); + + if (mount.isHome() && transform.mountType == GEM) { + VLF("MSG: Mount, set-target destination from home based on HA"); + if (target.h < 0) pierSideSelect = PSS_WEST; else pierSideSelect = PSS_EAST; + pierSideBest = true; + } + + target.pierSide = PIER_SIDE_NONE; + + if (pierSideSelect == PSS_EAST_ONLY) { + VLF("MSG: Mount, set-target using PPS_EAST_ONLY"); + if (eastReachable) target.pierSide = PIER_SIDE_EAST; + } else + if (pierSideSelect == PSS_WEST_ONLY) { + VLF("MSG: Mount, set-target using PPS_WEST_ONLY"); + if (westReachable) target.pierSide = PIER_SIDE_WEST; + } else + if (pierSideSelect == PSS_EAST) { + VLF("MSG: Mount, set-target using PPS_EAST"); + if (westReachable && !eastReachable) target.pierSide = PIER_SIDE_WEST; else + if (isGoto && westReachable && pierSideBest && westDistance < eastDistance) { + VLF("MSG: Mount, set-target destination in alternate (W) orientation is closer"); + target.pierSide = PIER_SIDE_WEST; + } else + if (eastReachable) target.pierSide = PIER_SIDE_EAST; + } else + if (pierSideSelect == PSS_WEST) { + VLF("MSG: Mount, set-target using PPS_WEST"); + if (eastReachable && !westReachable) target.pierSide = PIER_SIDE_EAST; else + if (isGoto && eastReachable && pierSideBest && eastDistance < westDistance) { + VLF("MSG: Mount, set-target destination in normal (E) orientation is closer"); + target.pierSide = PIER_SIDE_EAST; + } else + if (westReachable) target.pierSide = PIER_SIDE_WEST; + } + + if (target.pierSide == PIER_SIDE_NONE) { + VLF("MSG: Mount, set-target destination outside limits"); + return CE_SLEW_ERR_OUTSIDE_LIMITS; + } + + VF("MSG: Mount, set-target destination "); + if (current.pierSide == PIER_SIDE_NONE) { VF("NONE"); } else + if (current.pierSide == PIER_SIDE_EAST) { VF("EAST"); } else + if (current.pierSide == PIER_SIDE_WEST) { VF("WEST"); } else { VF("?"); } + if (current.pierSide == target.pierSide) { VF(" stays "); } else { VF(" to "); } + if (target.pierSide == PIER_SIDE_NONE) { VLF("NONE"); } else + if (target.pierSide == PIER_SIDE_EAST) { VLF("EAST"); } else + if (target.pierSide == PIER_SIDE_WEST) { VLF("WEST"); } else { VLF("?"); } + + if (target.pierSide != PIER_SIDE_EAST && target.pierSide != PIER_SIDE_WEST) { + VLF("MSG: Mount, set-target destination pier side defaults to EAST"); + target.pierSide = PIER_SIDE_EAST; + } + + // adjust Axis1 coordinate range as needed to allow going past +/-180 degrees + if (target.pierSide == PIER_SIDE_EAST) target.a1Correction = axis1TargetCorrectionE; + if (target.pierSide == PIER_SIDE_WEST) target.a1Correction = axis1TargetCorrectionW; + + transform.observedPlaceToMount(&target); + if (transform.mountType == ALTAZM) transform.horToEqu(&target); else + if (transform.mountType == ALTALT) transform.aaToEqu(&target); else transform.equToHor(&target); + + transform.hourAngleToRightAscension(&target, false); + + return CE_NONE; +} + +// stop any presently active goto +void Goto::abort() { + if (state == GS_GOTO && stage > GG_READY_ABORT) stage = GG_READY_ABORT; +} + +// general status checks ahead of sync or goto +CommandError Goto::validate() { + if (!axis1.isEnabled()) return CE_SLEW_ERR_IN_STANDBY; + if (!axis2.isEnabled()) return CE_SLEW_ERR_IN_STANDBY; + if (park.state == PS_PARKED) return CE_SLEW_ERR_IN_PARK; + if (state != GS_NONE) return CE_SLEW_IN_SLEW; + if (guide.state != GU_NONE) return CE_SLEW_IN_MOTION; + if (mount.isSlewing()) return CE_SLEW_IN_MOTION; + if (limits.isGotoError()) return CE_SLEW_ERR_OUTSIDE_LIMITS; + if (mount.motorFault()) return CE_SLEW_ERR_HARDWARE_FAULT; + return CE_NONE; +} + +// add an align star (at the current position relative to target) +CommandError Goto::alignAddStar(bool sync) { + if (alignState.currentStar > alignState.lastStar) return CE_PARAM_RANGE; + + CommandError e = CE_NONE; + + // first star, get ready for a new pointing model, init/sync then call gta.addStar + if (alignState.currentStar == 1) { + #if ALIGN_MAX_NUM_STARS > 1 + transform.align.init(transform.mountType, site.location.latitude); + #endif + e = requestSync(gotoTarget, PSS_SAME_ONLY); + lastAlignTarget = mount.getMountPosition(CR_MOUNT_ALL); + transform.hourAngleToRightAscension(&lastAlignTarget, true); + } + + // add an align star + if (e == CE_NONE) { + Coordinate mountPosition = mount.getMountPosition(CR_MOUNT_ALL); + if (sync) { lastAlignTarget = gotoTarget; } + + // update the targets HA and Horizon coords as necessary + transform.rightAscensionToHourAngle(&lastAlignTarget, true); + if (transform.mountType == ALTAZM) transform.equToHor(&lastAlignTarget); else + if (transform.mountType == ALTALT) transform.equToAa(&lastAlignTarget); + + #if ALIGN_MAX_NUM_STARS > 1 + e = transform.align.addStar(alignState.currentStar, alignState.lastStar, &lastAlignTarget, &mountPosition); + #else + UNUSED(mountPosition); + #endif + + if (e == CE_NONE) alignState.currentStar++; + } + + return e; +} + +// reset the alignment model +void Goto::alignReset() { + alignState.currentStar = 0; + alignState.lastStar = 0; + #if ALIGN_MAX_NUM_STARS > 1 + transform.align.modelClear(); + #endif +} + +#if GOTO_FEATURE == ON +// set any additional destinations required for a goto +void Goto::waypoint(Coordinate *current) { + // HA goes from +90...0..-90 + // W . E + // meridian flip, only happens for equatorial mounts + + stage = GG_WAYPOINT_HOME; + + // default goes straight to the home position + destination = home.getPosition(CR_MOUNT); + + // if the home position is at 0 hours, we're done + if (destination.h == 0.0) return; + + double d60 = degToRad(120); + double d45 = degToRad(135); + if (current->pierSide == PIER_SIDE_EAST) { d60 = Deg180 - d60; d45 = Deg180 - d45; } + + // decide if we should first move to 60 deg. HA (4 hours) to get away from the horizon limits + if (current->a < Deg10 && fabs(start.h) > Deg90) { destination.h = d60; stage = GG_WAYPOINT_AVOID; return; } + + // decide if we should first move to 45 deg. HA (3 hours) to get away from the horizon limits + // if at a low latitude and in the opposite sky, |HA| = 6 is very low on the horizon and we need + // to delay arriving there during a meridian flip. In the extreme case, where the user is very + // near the Earths equator an Horizon limit of -10 or -15 may be necessary for proper operation + if (current->a < Deg20 && site.locationEx.latitude.absval < Deg45) { + if (site.location.latitude >= 0) { + if (current->d <= Deg90 - site.location.latitude) { destination.h = d45; stage = GG_WAYPOINT_AVOID; } + } else { + if (current->d >= -Deg90 - site.location.latitude) { destination.h = d45; stage = GG_WAYPOINT_AVOID; } + } + } +} + +// monitor goto +void Goto::poll() { + // abort if either axis encounters a limit + if (stage != GG_ABORT && + (stage == GG_READY_ABORT || axis1.motionError(DIR_BOTH) || axis2.motionError(DIR_BOTH))) { + VLF("MSG: Mount, goto abort requested"); + stage = GG_ABORT; + meridianFlipHome.paused = false; + meridianFlipHome.resume = false; + axis1.autoSlewAbort(); + axis2.autoSlewAbort(); + } + + const unsigned long now = millis(); + + // abort any goto that might hang! + if (axis1.isSlewing()) { + if (!axis1.nearTarget()) nearTargetTimeoutAxis1 = now; + if (now - nearTargetTimeoutAxis1 > 15000U) { + DLF("WRN: Mount, goto axis1 timed out aborting slew!"); + axis1.autoSlewAbort(); + } + } + if (axis2.isSlewing()) { + if (!axis2.nearTarget()) nearTargetTimeoutAxis2 = now; + if (now - nearTargetTimeoutAxis2 > 15000U) { + DLF("WRN: Mount, goto axis2 timed out aborting slew!"); + axis2.autoSlewAbort(); + } + } + + if (!mount.isSlewing()) { + if (stage == GG_WAYPOINT_AVOID) { + VLF("MSG: Mount, goto waypoint reached"); + stage = GG_WAYPOINT_HOME; + destination = home.getPosition(CR_MOUNT); + startAutoSlew(); + } else + + if (stage == GG_WAYPOINT_HOME) { + if (settings.meridianFlipPause && !meridianFlipHome.resume) { meridianFlipHome.paused = true; goto skip; } + meridianFlipHome.paused = false; + meridianFlipHome.resume = false; + + VLF("MSG: Mount, goto home reached"); + stage = GG_NEAR_DESTINATION_START; + destination = target; + startAutoSlew(); + } else + + if (stage == GG_NEAR_DESTINATION_START) { + if (nearDestinationRefineStages >= 1) { + VLF("MSG: Mount, goto near destination wait started"); + nearDestinationTimeout = now + GOTO_SETTLE_TIME; + stage = GG_NEAR_DESTINATION_WAIT; + } else stage = GG_NEAR_DESTINATION; + } else + + if (stage == GG_NEAR_DESTINATION_WAIT) { + if ((long)(now - nearDestinationTimeout) > 0) { + VLF("MSG: Mount, goto near destination wait done"); + stage = GG_NEAR_DESTINATION; + } + } else + + if (stage == GG_NEAR_DESTINATION) { + if (nearDestinationRefineStages >= 1) { + + if (--nearDestinationRefineStages) stage = GG_NEAR_DESTINATION_START; else stage = GG_DESTINATION; + + VLF("MSG: Mount, goto near destination reached"); + destination = target; + if (!alignActive() || GOTO_OFFSET_ALIGN == OFF) { + slewDestinationDistHA = 0.0; + slewDestinationDistDec = 0.0; + } + startAutoSlew(); + } else { + stage = GG_DESTINATION; + VLF("MSG: Mount, goto near destination skipped"); + } + } else + + if (stage == GG_DESTINATION || stage == GG_ABORT) { + VLF("MSG: Mount, goto destination reached"); + state = GS_NONE; + mount.update(); + + // back to normal motor frequencies + axis1.setFrequencyScale(1.0F); + axis2.setFrequencyScale(1.0F); + + // kill this monitor + tasks.setDurationComplete(taskHandle); + taskHandle = 0; + VLF("MSG: Mount, goto monitor task terminated"); + + // check if parking and mark as finished or unparked as needed + if (park.state == PS_PARKING) { + if (stage == GG_ABORT) park.requestAborted(); else park.requestDone(); + } + + // check if homing + if (home.state == HS_HOMING) { + if (stage == GG_ABORT) home.requestAborted(); else home.requestDone(); + } + + // reset goto stage + stage = GG_NONE; + + mountStatus.soundAlert(); + + return; + } + } + + // adjust rates near the horizon to help avoid exceeding the minimum altitude limit + if (transform.isEquatorial() && MOUNT_HORIZON_AVOIDANCE == ON) { + if (site.locationEx.latitude.absval > degToRad(10.0)) { + static float last_a2 = 0; + Coordinate coords = mount.getMountPosition(CR_MOUNT_ALT); + float a2 = site.locationEx.latitude.sign*coords.d; + + // range 0.2 to 1.0, where a larger distance has less slowdown effect + float slowdownFactor = radToDeg(coords.a - limits.settings.altitude.min)/(SLEW_ACCELERATION_DIST*2.0); + + // constrain + if (slowdownFactor > 1.0F) slowdownFactor = 1.0F; + if (slowdownFactor < 0.2F) slowdownFactor = 0.2F; + + // if Dec is decreasing slow down the Dec axis, if Dec is increasing slow down the RA axis + float sfr = 0.5F/FRACTIONAL_SEC; + float slowdownFactor1 = 1.0F; + float slowdownFactor2 = 1.0F; + static float slowdownFactor1a = 1.0F; + static float slowdownFactor2a = 1.0F; + if (a2 < last_a2) slowdownFactor2 = slowdownFactor; else slowdownFactor1 = slowdownFactor; + + if (slowdownFactor1a < slowdownFactor1) { slowdownFactor1a += sfr; } + if (slowdownFactor1a > slowdownFactor1) { slowdownFactor1a -= sfr; } + if (slowdownFactor1a > 1.0F) slowdownFactor1a = 1.0F; + if (slowdownFactor1a < 0.2F) slowdownFactor1a = 0.2F; + if (slowdownFactor2a < slowdownFactor2) { slowdownFactor2a += sfr; } + if (slowdownFactor2a > slowdownFactor2) { slowdownFactor2a -= sfr; } + if (slowdownFactor2a > 1.0F) slowdownFactor2a = 1.0F; + if (slowdownFactor2a < 0.2F) slowdownFactor2a = 0.2F; + + axis1.setFrequencyScale(slowdownFactor1a); + axis2.setFrequencyScale(slowdownFactor2a); + + last_a2 = a2; + } else { + axis1.setFrequencyScale(1.0F); + axis2.setFrequencyScale(1.0F); + } + } + + skip: + + // keep updating the axis targets to match the mount target + // but allow timeout to stop tracking to guarantee synchronization + if (AXIS1_TARGET_TOLERANCE != 0.0F || AXIS2_TARGET_TOLERANCE != 0.0F || !axis1.nearTarget() || !axis2.nearTarget()) nearTargetTimeout = millis(); + + if (mount.isTracking()) { + target.r += siderealToRad(mount.trackingRateOffsetRA)/FRACTIONAL_SEC; + target.d += siderealToRad(mount.trackingRateOffsetDec)/FRACTIONAL_SEC; + transform.rightAscensionToHourAngle(&target, false); + if (stage >= GG_NEAR_DESTINATION_START) { + if (millis() - nearTargetTimeout < 5000U) { + Coordinate nearTarget = target; + nearTarget.h -= slewDestinationDistHA; + nearTarget.d -= slewDestinationDistDec; + + if (transform.mountType == ALTAZM) transform.equToHor(&nearTarget); else + if (transform.mountType == ALTALT) transform.equToAa(&nearTarget); + + double a1, a2; + transform.mountToInstrument(&nearTarget, &a1, &a2); + + axis1.setTargetCoordinate(a1 + nearTarget.a1Correction); + axis2.setTargetCoordinate(a2); + } + } + } +} + +// start slews with approach correction and parking/homing support +CommandError Goto::startAutoSlew() { + CommandError e; + + const unsigned long now = millis(); + nearTargetTimeoutAxis1 = now; + nearTargetTimeoutAxis2 = now; + + if (stage == GG_NEAR_DESTINATION || stage == GG_DESTINATION) { + destination.h -= slewDestinationDistHA; + destination.d -= slewDestinationDistDec; + } + + double a1, a2; + transform.mountToInstrument(&destination, &a1, &a2); + + if (stage == GG_DESTINATION && park.state == PS_PARKING) { + axis1.setTargetCoordinatePark(a1 + destination.a1Correction); + axis2.setTargetCoordinatePark(a2); + } else { + axis1.setTargetCoordinate(a1 + destination.a1Correction); + axis2.setTargetCoordinate(a2); + } + + VF("MSG: Mount, goto target coordinates set (a1="); V(radToDeg(a1)); VF(" deg, a2="); V(radToDeg(a2)); VLF(" deg)"); + + e = axis1.autoGoto(radsPerSecondCurrent); + if (e == CE_NONE) e = axis2.autoGoto(radsPerSecondCurrent*((float)(AXIS2_SLEW_RATE_PERCENT)/100.0F)); + + nearTargetTimeout = millis(); + + return e; +} +#endif + +// update acceleration rates for goto and guiding +void Goto::updateAccelerationRates() { + radsPerSecondCurrent = (1000000.0F/settings.usPerStepCurrent)/(float)axis1.getStepsPerMeasure(); + rate = radsPerSecondCurrent; + #if GOTO_FEATURE == ON + float secondsToAccelerate = (degToRadF((float)(SLEW_ACCELERATION_DIST))/radsPerSecondCurrent)*2.0F; + float secondsToAccelerateAbort = (degToRadF((float)(SLEW_RAPID_STOP_DIST))/radsPerSecondCurrent)*2.0F; + #else + float secondsToAccelerate = (degToRadF((float)(5.0F))/radsPerSecondCurrent)*2.0F; + float secondsToAccelerateAbort = (degToRadF((float)(2.0F))/radsPerSecondCurrent)*2.0F; + #endif + axis1.setSlewAccelerationRate(radsPerSecondCurrent/secondsToAccelerate); + axis1.setSlewAccelerationRateAbort(radsPerSecondCurrent/secondsToAccelerateAbort); + axis2.setSlewAccelerationRate(radsPerSecondCurrent/secondsToAccelerate); + axis2.setSlewAccelerationRateAbort(radsPerSecondCurrent/secondsToAccelerateAbort); +} + +// estimate average microseconds per step lower limit +float Goto::usPerStepLowerLimit() { + // basis is platform/clock-rate specific (for square wave) + float r_us = HAL_MAXRATE_LOWER_LIMIT; + + // higher speed ISR code path? + #if STEP_WAVE_FORM == PULSE || STEP_WAVE_FORM == DEDGE + r_us /= 1.6F; + #endif + + // average required goto us rates for each axis with any micro-step mode switching applied + float r_us_axis1 = r_us/axis1.getStepsPerStepSlewing(); + float r_us_axis2 = r_us/axis2.getStepsPerStepSlewing(); + + // average in axis2 step rate scaling for drives where the reduction ratio isn't equal + r_us = (1.0F/(1.0F/r_us_axis1 + 1.0F/r_us_axis2))*2.0F; + + // return rate in us units + return r_us; +} + +Goto goTo; + +#endif diff --git a/src/telescope/mount/goto/Goto.h b/src/telescope/mount/goto/Goto.h new file mode 100755 index 0000000..fd57e85 --- /dev/null +++ b/src/telescope/mount/goto/Goto.h @@ -0,0 +1,170 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control +#pragma once + +#include "../../../Common.h" + +#if defined(MOUNT_PRESENT) + +#include "../../../libApp/commands/ProcessCmds.h" +#include "../coordinates/Transform.h" + +enum MeridianFlip: uint8_t {MF_NEVER, MF_ALWAYS}; +enum GotoState: uint8_t {GS_NONE, GS_GOTO}; +enum GotoStage: uint8_t {GG_NONE, GG_ABORT, GG_READY_ABORT, GG_WAYPOINT_HOME, GG_WAYPOINT_AVOID, GG_NEAR_DESTINATION_START, GG_NEAR_DESTINATION_WAIT, GG_NEAR_DESTINATION, GG_DESTINATION}; +enum GotoType: uint8_t {GT_NONE, GT_HOME, GT_PARK}; +enum PierSideSelect: uint8_t {PSS_NONE, PSS_EAST, PSS_WEST, PSS_BEST, PSS_AUTO, PSS_EAST_ONLY, PSS_WEST_ONLY, PSS_SAME_ONLY}; + +typedef struct MeridianFlipHome { + bool paused; + bool resume; +} MeridianFlipHome; + +#pragma pack(1) +#define GotoSettingsSize 6 +typedef struct GotoSettings { + bool meridianFlipAuto :1; + bool meridianFlipPause :1; + PierSideSelect preferredPierSide; + float usPerStepCurrent; +} GotoSettings; +#pragma pack() + +typedef struct AlignState { + uint8_t currentStar; + uint8_t lastStar; +} AlignState; + +class Goto { + public: + void init(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // goto to equatorial target position (Native coordinate system) using the defaut preferredPierSide + CommandError request(); + + // goto equatorial position (Native or Mount coordinate system) + CommandError request(Coordinate coords, PierSideSelect pierSideSelect, bool native = true); + + // sync to equatorial target position (Native coordinate system) using the default preferredPierSide + CommandError requestSync(); + + // sync to equatorial position (Native or Mount coordinate system) + CommandError requestSync(Coordinate coords, PierSideSelect pierSideSelect, bool native = true); + + // get target equatorial position (Native coordinate system) + inline Coordinate getGotoTarget() { return gotoTarget; } + + // set target equatorial position (Native coordinate system) + inline void setGotoTarget(Coordinate *coords) { gotoTarget = *coords; } + + // checks for valid target and determines pier side (Mount coordinate system) + CommandError setTarget(Coordinate *coords, PierSideSelect pierSideSelect, bool isGoto = true); + + // abort any presently active goto + void abort(); + + // general status checks ahead of sync or goto + CommandError validate(); + + // add an align star (at the current position relative to target) + CommandError alignAddStar(bool sync = false); + + // reset the alignment model + void alignReset(); + + // check if an align is in progress + inline bool alignActive() { return alignState.lastStar > 0 && alignState.currentStar <= alignState.lastStar; } + + // check if an align is done + inline bool alignDone() { return alignState.lastStar > 0 && alignState.currentStar > alignState.lastStar; } + + // returns true if the pause at home feature is enabled + inline bool isHomePauseEnabled() { return settings.meridianFlipPause; } + + // returns true if paused at the home position, waiting to continue, during a goto + inline bool isHomePaused() { return meridianFlipHome.paused; } + + // if paused at the home position, continue the goto + inline void homeContinue() { meridianFlipHome.resume = true; } + + // returns true if the automatic meridian flip feature is enabled + inline bool isAutoFlipEnabled() { return settings.meridianFlipAuto && transform.isEquatorial() && transform.meridianFlips; } + + // return selected slew rate + inline float getRadsPerSecond() { return radsPerSecondCurrent; } + + // monitor goto + void poll(); + + // for determining goto state + GotoState state = GS_NONE; + GotoStage stage = GG_NONE; + + // current goto rate in radians per second + float rate; + + // flag to start tracking if this is the first goto + bool firstGoto = true; + + // flag to indicate that encoders are present + bool absoluteEncodersPresent = false; + bool encodersPresent = false; + + private: + + #if GOTO_FEATURE == ON + // set any additional destinations required for a goto + void waypoint(Coordinate *current); + + // start slews with approach correction and parking/homing support + CommandError startAutoSlew(); + #endif + + // update acceleration rates for goto and guiding + void updateAccelerationRates(); + + // estimate average microseconds per step lower limit + float usPerStepLowerLimit(); + + // get least distance between coordinates + inline double dist(double a, double b) { if (a > b) return a - b; else return b - a; } + + // requested goto/sync destination Native coordinate (eq or hor) + Coordinate gotoTarget = {0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, PIER_SIDE_NONE}; + // goto starts from this Mount coordinate (eq or hor) + Coordinate start; + // goto next destination Mount coordinate (eq or hor) + Coordinate destination; + // goto final destination Mount coordinate (eq or hor) + Coordinate target = {0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, PIER_SIDE_NONE}; + // last align (goto) target Mount coordinate (eq or hor) + Coordinate lastAlignTarget = {0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, PIER_SIDE_NONE}; + GotoState stateAbort = GS_NONE; + GotoState stateLast = GS_NONE; + uint8_t taskHandle = 0; + int nearDestinationRefineStages; + unsigned long nearTargetTimeout = 0; + unsigned long nearTargetTimeoutAxis1 = 0; + unsigned long nearTargetTimeoutAxis2 = 0; + unsigned long nearDestinationTimeout = 0; + + MeridianFlipHome meridianFlipHome = {false, false}; + + AlignState alignState = {0, 0}; + + float usPerStepBase = 128.0F; + float radsPerSecondCurrent; + + double slewDestinationDistHA = 0.0; + double slewDestinationDistDec = 0.0; + + GotoSettings settings = {MFLIP_AUTOMATIC_DEFAULT == ON, MFLIP_PAUSE_HOME_DEFAULT == ON, (PierSideSelect)PIER_SIDE_PREFERRED_DEFAULT, 1000001.0F}; + + uint32_t nvKey; +}; + +extern Goto goTo; + +#endif diff --git a/src/telescope/mount/guide/Guide.command.cpp b/src/telescope/mount/guide/Guide.command.cpp new file mode 100755 index 0000000..88ff347 --- /dev/null +++ b/src/telescope/mount/guide/Guide.command.cpp @@ -0,0 +1,196 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, commands + +#include "Guide.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../site/Site.h" +#include "../goto/Goto.h" + +bool Guide::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + *suppressFrame = false; + + // :GX90# Get setting pulse guide rate + // Returns: n.nn# + if (command[0] == 'G' && command[1] == 'X' && parameter[0] == '9' && parameter[1] == '0' && parameter[2] == 0) { + sprintF(reply, "%0.2f", rateSelectToRate(settings.pulseRateSelect)); + *numericReply = false; + } else + + // M - Telescope Movement (Guiding) Commands + if (command[0] == 'M') { + + // :Mgd[n]# Pulse guide command where n is the guide time in milliseconds + // Returns: Nothing + // :MGd[n]# Pulse guide command where n is the guide time in milliseconds + // Return: 0 on failure + // 1 on success + if (command[1] == 'g' || command[1] == 'G') { + int16_t timeMs; + if (convert.atoi2(¶meter[1], &timeMs)) { + if (timeMs >= 0) { + if (parameter[0] == 'w') { + *commandError = startAxis1(GA_FORWARD, (GUIDE_SEPARATE_PULSE_RATE == ON) ? settings.pulseRateSelect : settings.axis1RateSelect, timeMs); + } else + if (parameter[0] == 'e') { + *commandError = startAxis1(GA_REVERSE, (GUIDE_SEPARATE_PULSE_RATE == ON) ? settings.pulseRateSelect : settings.axis1RateSelect, timeMs); + } else + if (parameter[0] == 'n') { + *commandError = startAxis2(GA_FORWARD, (GUIDE_SEPARATE_PULSE_RATE == ON) ? settings.pulseRateSelect : settings.axis2RateSelect, timeMs); + } else + if (parameter[0] == 's') { + *commandError = startAxis2(GA_REVERSE, (GUIDE_SEPARATE_PULSE_RATE == ON) ? settings.pulseRateSelect : settings.axis2RateSelect, timeMs); + } else *commandError = CE_CMD_UNKNOWN; + if (command[1] == 'g') *numericReply = false; + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + // :Mw# Move Telescope West at current guide rate + // Returns: Nothing + if (command[1] == 'w' && parameter[0] == 0) { + *commandError = startAxis1(GA_FORWARD, settings.axis1RateSelect, GUIDE_TIME_LIMIT*1000); + *numericReply = false; + } else + // :Me# Move Telescope East at current guide rate + // Returns: Nothing + if (command[1] == 'e' && parameter[0] == 0) { + *commandError = startAxis1(GA_REVERSE, settings.axis1RateSelect, GUIDE_TIME_LIMIT*1000); + *numericReply = false; + } else + // :Mn# Move Telescope North at current guide rate + // Returns: Nothing + if (command[1] == 'n' && parameter[0] == 0) { + *commandError = startAxis2(GA_FORWARD, settings.axis2RateSelect, GUIDE_TIME_LIMIT*1000); + *numericReply = false; + } else + // :Ms# Move Telescope South at current guide rate + // Returns: Nothing + if (command[1] == 's' && parameter[0] == 0) { + *commandError = startAxis2(GA_REVERSE, settings.axis2RateSelect, GUIDE_TIME_LIMIT*1000); + *numericReply = false; + } else + // :Mp# Move Telescope for sPiral search at current guide rate + // Returns: Nothing + if (command[1] == 'p' && parameter[0] == 0) { + *commandError = startSpiral(settings.axis1RateSelect, GUIDE_SPIRAL_TIME_LIMIT*1000); + *numericReply = false; + } else return false; + } else + + // Q - Movement Commands + // :Q# Halt all slews, stops goto + // Returns: Nothing + if (command[0] == 'Q') { + if (command[1] == 0) { + #if GOTO_FEATURE == ON + goTo.abort(); + #endif + stop(); + *numericReply = false; + } else + // :Qe# Qw# Halt east/westward Slews + // Returns: Nothing + if ((command[1] == 'e' || command[1] == 'w') && parameter[0] == 0) { + stopAxis1(); + *numericReply = false; + } else + // :Qn# Qs# Halt north/southward Slews + // Returns: Nothing + if ((command[1] == 'n' || command[1] == 's') && parameter[0] == 0) { + stopAxis2(); + *numericReply = false; + } else return false; + } else + + // R - Guide Rate Commands + if (command[0] == 'R') { + + #if GOTO_FEATURE == ON + float maxDegsPerSec = radToDegF(goTo.rate); + #else + float maxDegsPerSec = 0.083333333F; + #endif + + // :RA[n.n]# Set Axis1 Guide rate to n.n degrees per second + // Returns: Nothing + // Note: Tracking, if active, is suspended in this mode of operation + if (command[1] == 'A') { + char* conv_end; + float f = strtod(parameter, &conv_end); + if (¶meter[0] != conv_end) { + if (f < 0.0001F/3600.0F) f = 0.0001F/3600.0F; + if (f > maxDegsPerSec) f = maxDegsPerSec; + VF("MSG: set Axis1 custom guide rate to "); + if (f < 0.1F) { + V(f*3600.0F); VLF(" arc-sec/s"); + } else { + V(f); VLF(" deg/s"); + } + settings.axis1RateSelect = GR_CUSTOM; + customRateAxis1 = f*240.0F; + } else *commandError = CE_PARAM_FORM; + *numericReply = false; + } else + + // :RE[n.n]# Set Axis2 Guide rate to n.n degrees per second + // Returns: Nothing + // Note: Tracking, if active, is suspended in this mode of operation + if (command[1] == 'E') { + char* conv_end; + float f = strtod(parameter, &conv_end); + if (¶meter[0] != conv_end) { + if (f < 0.0001F/3600.0F) f = 0.0001F/3600.0F; + if (f > maxDegsPerSec) f = maxDegsPerSec; + VF("MSG: set Axis2 custom guide rate to "); + if (f < 0.1F) { + V(f*3600.0F); VLF(" arc-sec/s"); + } else { + V(f); VLF(" deg/s"); + } + settings.axis2RateSelect = GR_CUSTOM; + customRateAxis2 = f*240.0F; + } else *commandError = CE_PARAM_FORM; + *numericReply = false; + } else + + // :RG# Set guide rate: Guiding 1X + // :RC# Set guide rate: Centering 8X + // :RM# Set guide rate: Find 20X + // :RF# Set guide rate: Fast 48X + // :RS# Set guide rate: Slew ?X (1/2 of current goto rate) + // :Rn# Set guide rate to n, where n = 0..9 + // Returns: Nothing + // Note: Tracking, if active, is integrated in this mode of operation + if (strchr("GCMFS0123456789", command[1]) && parameter[0] == 0) { + int r; + if (command[1] == 'G') r = 2; else + if (command[1] == 'C') r = 5; else + if (command[1] == 'M') r = 6; else + if (command[1] == 'F') r = 7; else + if (command[1] == 'S') r = 8; else r = command[1] - '0'; + + if (r >= 0 && r <= 9) { + #if GOTO_FEATURE != ON + if (r > 6) r = 6; + #endif + settings.axis1RateSelect = (GuideRateSelect)r; + settings.axis2RateSelect = (GuideRateSelect)r; + VF("MSG: Guide rate "); V(r); VLF(" selected"); + if (GUIDE_SEPARATE_PULSE_RATE == ON && (GuideRateSelect)r <= GR_1X) { + settings.pulseRateSelect = (GuideRateSelect)r; + nv().kv().put(nvKey, settings); + } + } else *commandError = CE_PARAM_RANGE; + *numericReply = false; + } else return false; + } else return false; + + return true; +} + +#endif \ No newline at end of file diff --git a/src/telescope/mount/guide/Guide.cpp b/src/telescope/mount/guide/Guide.cpp new file mode 100755 index 0000000..ffe457b --- /dev/null +++ b/src/telescope/mount/guide/Guide.cpp @@ -0,0 +1,484 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, guiding + +#include "Guide.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../../../libApp/commands/ProcessCmds.h" + +#include "../../Telescope.h" +#include "../Mount.h" +#include "../goto/Goto.h" +#include "../home/Home.h" +#include "../park/Park.h" +#include "../home/Home.h" +#include "../limits/Limits.h" +#include "../status/Status.h" + +inline void guideWrapper() { guide.poll(); } + +void Guide::init() { + + nvKey = nv().kv().computeKey("GUIDE_SETTINGS"); + if (!nv().kv().getOrInit(nvKey, settings.pulseRateSelect)) { DLF("WRN: Nv, init failed for GUIDE_SETTINGS"); } + + settings.axis1RateSelect = GR_20X; + settings.axis2RateSelect = GR_20X; + settings.pulseRateSelect = constrain(settings.pulseRateSelect, GR_QUARTER, GR_1X); + + // start guide monitor task + VF("MSG: Mount, start guide monitor task (rate "); V(FRACTIONAL_SEC_US/2); VF("us priority 3)... "); + int taskHandle = tasks.add(0, 0, true, 3, guideWrapper, "MtGuide"); + tasks.setPeriodMicros(taskHandle, FRACTIONAL_SEC_US/2); + if (taskHandle) { VLF("success"); } else { VLF("FAILED!"); } +} + +// start guide at a given direction and rate on Axis1 +CommandError Guide::startAxis1(GuideAction guideAction, GuideRateSelect rateSelect, unsigned long guideTimeLimit) { + if (guideAction == GA_NONE) return CE_NONE; + if (state == GU_HOME_GUIDE || state == GU_HOME_GUIDE_ABORT) return CE_NONE; + + CommandError e = validate(1, guideAction); + if (e != CE_NONE) return e; + + guideActionAxis1 = guideAction; + float rate = rateSelectToRate(rateSelect, 1); + + // unlimited 0 means the maximum period, about 49 days + if (guideTimeLimit == 0) guideTimeLimit = 0x1FFFFFFF; + guideFinishTimeAxis1 = millis() + guideTimeLimit; + + if (rate <= 2) { + axis1.setPowerDownOverrideTime(300000UL); + axis2.setPowerDownOverrideTime(300000UL); + } + + if (limits.isEnabled() && rate <= 2 && rateSelect != GR_CUSTOM) { + backlashEnableControl(false); + state = GU_PULSE_GUIDE; + if (guideAction == GA_REVERSE) { VF("MSG: Guide, Axis1 rev @"); rateAxis1 = -rate; } else { VF("MSG: Guide, Axis1 fwd @"); rateAxis1 = rate; } + V(rate); VL("X"); + mount.update(); + } else { + state = GU_GUIDE; + backlashEnableControl(true); + if (rateSelect != GR_CUSTOM) { + if (guideAction == GA_REVERSE) rate -= mount.trackingRateAxis1; else rate += mount.trackingRateAxis1; + } + axis1.setFrequencySlew(degToRadF(rate/240.0F)); + axis1AutoSlew(guideAction); + } + + return CE_NONE; +} + +// stop guide on Axis1, use GA_BREAK to stop in either direction or specifiy the direction to be stopped GA_FORWARD or GA_REVERSE +// set abort true to rapidly stop (broken limit, etc) +void Guide::stopAxis1(GuideAction stopDirection, bool abort) { + if (state == GU_HOME_GUIDE && !abort) { this->abort(); return; } + + if (guideActionAxis1 > GA_BREAK) { + if (stopDirection != GA_BREAK && guideActionAxis1 != stopDirection && guideActionAxis1 != GA_HOME) return; + if (rateAxis1 == 0.0F) { + guideActionAxis1 = GA_BREAK; + if (abort) axis1.autoSlewAbort(); else axis1.autoSlewStop(); + } else { + VLF("MSG: Guide, Axis1 stopped"); + guideActionAxis1 = GA_NONE; + rateAxis1 = 0.0F; + mount.update(); + } + } +} + +// start guide at a given direction and rate on Axis2 +CommandError Guide::startAxis2(GuideAction guideAction, GuideRateSelect rateSelect, unsigned long guideTimeLimit) { + if (guideAction == GA_NONE) return CE_NONE; + if (state == GU_HOME_GUIDE || state == GU_HOME_GUIDE_ABORT) return CE_NONE; + + CommandError e = validate(2, guideAction); // if successful always sets pierSide + if (e != CE_NONE) return e; + + guideActionAxis2 = guideAction; + float rate = rateSelectToRate(rateSelect, 2); + float fastestRate = rateSelectToRate(GR_MAX, 2)*((float)(AXIS2_SLEW_RATE_PERCENT)/100.0F); + if (rate > fastestRate) rate = fastestRate; + + // unlimited 0 means the maximum period, about 49 days + if (guideTimeLimit == 0) guideTimeLimit = 0x1FFFFFFF; + guideFinishTimeAxis2 = millis() + guideTimeLimit; + + if (rate <= 2) { + axis1.setPowerDownOverrideTime(300000UL); + axis2.setPowerDownOverrideTime(300000UL); + } + + if (limits.isEnabled() && rate <= 2 && rateSelect != GR_CUSTOM) { + state = GU_PULSE_GUIDE; + backlashEnableControl(false); + if (pierSide == PIER_SIDE_WEST) { if (guideAction == GA_FORWARD) guideAction = GA_REVERSE; else guideAction = GA_FORWARD; }; + if (guideAction == GA_REVERSE) { VF("MSG: Guide, Axis2 rev @"); rateAxis2 = -rate; } else { VF("MSG: Guide, Axis2 fwd @"); rateAxis2 = rate; } + V(rate); VL("X"); + mount.update(); + } else { + state = GU_GUIDE; + backlashEnableControl(true); + if (rateSelect != GR_CUSTOM) { + if (guideAction == GA_REVERSE) rate -= mount.trackingRateAxis2; else rate += mount.trackingRateAxis2; + } + axis2.setFrequencySlew(degToRadF(rate/240.0F)); + axis2AutoSlew(guideAction); + } + + return CE_NONE; +} + +// stop guide on Axis2, use GA_BREAK to stop in either direction or specifiy the direction to be stopped GA_FORWARD or GA_REVERSE +// set abort true to rapidly stop (broken limit, etc) +void Guide::stopAxis2(GuideAction stopDirection, bool abort) { + if (state == GU_HOME_GUIDE && !abort) { this->abort(); return; } + + if (guideActionAxis2 > GA_BREAK) { + if (stopDirection != GA_BREAK && guideActionAxis2 != stopDirection && guideActionAxis2 != GA_HOME) return; + if (rateAxis2 == 0.0F) { + guideActionAxis2 = GA_BREAK; + if (abort) axis2.autoSlewAbort(); else axis2.autoSlewStop(); + } else { + VLF("MSG: Guide, Axis2 stopped"); + guideActionAxis2 = GA_NONE; + rateAxis2 = 0.0F; + mount.update(); + } + } +} + +// start spiral guide at the specified rate (spiral size is porportional to rate) +CommandError Guide::startSpiral(GuideRateSelect rateSelect, unsigned long guideTimeLimit) { + if (state == GU_SPIRAL_GUIDE) { stop(); return CE_NONE; } + if (guideActionAxis1 != GA_NONE || guideActionAxis2 != GA_NONE) return CE_SLEW_IN_MOTION; + CommandError e = validate(0, GA_SPIRAL); if (e != CE_NONE) return e; + + backlashEnableControl(true); + + if (rateSelect < GR_2X) rateSelect = GR_2X; + if (rateSelect > GR_HALF_MAX) rateSelect = GR_HALF_MAX; + spiralGuideRateSelect = rateSelect; + + VF("MSG: guideSpiralStart(), using guide rates to "); V(rateSelectToRate(spiralGuideRateSelect)); VL("X"); + + // unlimited 0 means the maximum period, about 49 days + if (guideTimeLimit == 0) guideTimeLimit = 0x1FFFFFFF; + spiralStartTime = millis(); + guideFinishTimeAxis1 = spiralStartTime + guideTimeLimit; + guideFinishTimeAxis2 = guideFinishTimeAxis1; + + // setup and call the polling routine once to start the guides + Coordinate location = mount.getMountPosition(CR_MOUNT); + spiralScaleAxis1 = cos(location.a2); + spiralPoll(); + + state = GU_SPIRAL_GUIDE; + return CE_NONE; +} + +// start guide home (for use with home switches) +CommandError Guide::startHome() { + #if GOTO_FEATURE == ON + if (state == GU_HOME_GUIDE) { abort(); return CE_NONE; } + if (guideActionAxis1 != GA_NONE || guideActionAxis2 != GA_NONE) return CE_SLEW_IN_MOTION; + CommandError e = validate(0, GA_HOME); if (e != CE_NONE) return e; + + backlashEnableControl(true); + + // use guiding and switches to find home + mountStatus.soundAlert(); + state = GU_HOME_GUIDE; + + #if AXIS1_SECTOR_GEAR == ON || AXIS2_TANGENT_ARM == OFF + guideFinishTimeAxis1 = millis() + (unsigned long)(GUIDE_HOME_TIME_LIMIT * 1000.0); + guideActionAxis1 = GA_HOME; + axis1.setFrequencySlew(goTo.rate); + axis1.autoSlewHome(); + #endif + + guideFinishTimeAxis2 = millis() + (unsigned long)(GUIDE_HOME_TIME_LIMIT * 1000.0); + guideActionAxis2 = GA_HOME; + axis2.setFrequencySlew(goTo.rate*((float)(AXIS2_SLEW_RATE_PERCENT)/100.0F)); + axis2.autoSlewHome(); + #else + DLF("WRN: Mount, sensed home rejected because goto is disabled"); + return CE_SLEW_ERR_UNSPECIFIED; + #endif + return CE_NONE; +} + +// stop both axes of guide +void Guide::stop() { + stopAxis1(); + stopAxis2(); +} + +// abort both axes of guide +void Guide::abort() { + if (state == GU_HOME_GUIDE) { + VLF("MSG: Mount, aborting home guide"); + state = GU_HOME_GUIDE_ABORT; + } + stopAxis1(GA_BREAK, true); + stopAxis2(GA_BREAK, true); +} + +// keep guide rate <= half max +float Guide::limitGuideRate(float rate) { + #if GOTO_FEATURE == ON + float rateLimit = radToDegF(goTo.rate)*120.0F; + if (rate > rateLimit) rate = rateLimit; + #endif + return rate; +} + +// return guide rate (sidereal x) for guide rate selection +float Guide::rateSelectToRate(GuideRateSelect rateSelect, uint8_t axis) { + switch (rateSelect) { + case GR_QUARTER: return 0.25F; + case GR_HALF: return 0.5F; + case GR_1X: return 1.0F; + case GR_2X: return 2.0F; + case GR_4X: return limitGuideRate(4.0F); + case GR_8X: return limitGuideRate(8.0F); + case GR_20X: return limitGuideRate(20.0F); + #if GOTO_FEATURE == ON + case GR_48X: return limitGuideRate(48.0F); + case GR_HALF_MAX: return radToDegF(goTo.rate)*120.0F; + case GR_MAX: return radToDegF(goTo.rate)*240.0F; + #else + case GR_48X: return limitGuideRate(20.0F); + case GR_HALF_MAX: return limitGuideRate(20.0F); + case GR_MAX: return limitGuideRate(20.0F); + #endif + case GR_CUSTOM: if (axis == 1) return customRateAxis1; else if (axis == 2) return customRateAxis2; else return 0.0F; + default: return 0.0F; + } +} + +// valid guide for Axis1 +bool Guide::validAxis1(GuideAction guideAction) { + Coordinate location = mount.getMountPosition(CR_MOUNT_ALT); + + if (!limits.isEnabled()) return true; + + #if AXIS1_SECTOR_GEAR == ON + location.a1 = axis1.getMotorPosition(); + #endif + + // for Fork and Alt/Azm mounts limits are based on shaft angles + // so convert axis1 into normal PIER_SIDE_EAST coordinates + if (transform.mountType != GEM && location.pierSide == PIER_SIDE_WEST) location.a1 += Deg180; + + if (guideAction == GA_REVERSE || guideAction == GA_SPIRAL) { + if (transform.mountType == GEM && location.pierSide == PIER_SIDE_EAST) { + if (location.h < -limits.settings.pastMeridianE) return false; + } + if (location.a1 < axis1.getLimitMin()) return false; + } + + if (guideAction == GA_FORWARD || guideAction == GA_SPIRAL) { + if (transform.mountType == GEM && location.pierSide == PIER_SIDE_WEST) { + if (location.h > limits.settings.pastMeridianW) return false; + } + if (location.a1 > axis1.getLimitMax()) return false; + } + return true; +} + +// valid guide for Axis2 +bool Guide::validAxis2(GuideAction guideAction) { + Coordinate location = mount.getMountPosition(CR_MOUNT_ALT); + pierSide = location.pierSide; + + if (!limits.isEnabled()) return true; + + #if AXIS2_TANGENT_ARM == ON + location.a2 = axis2.getMotorPosition(); + #endif + + if (guideAction == GA_REVERSE || guideAction == GA_SPIRAL) { + if (pierSide == PIER_SIDE_WEST) { + if (fgt(location.a2, axis2.getLimitMax())) return false; + } else { + if (flt(location.a2, axis2.getLimitMin())) return false; + } + } + + if (guideAction == GA_FORWARD || guideAction == GA_SPIRAL) { + if (pierSide == PIER_SIDE_WEST) { + if (flt(location.a2, axis2.getLimitMin())) return false; + } else { + if (fgt(location.a2, axis2.getLimitMax())) return false; + } + } + if (guideAction == GA_SPIRAL) { + if (fabs(location.a2) > degToRad(75.0)) return false; + } + return true; +} + +// general validation of guide request +CommandError Guide::validate(int axis, GuideAction guideAction) { + if (!mount.isEnabled()) { + mount.enable(true); + if (!mount.isEnabled()) return CE_SLEW_ERR_IN_STANDBY; + } + + if ((guideAction == GA_SPIRAL || guideAction == GA_HOME) && mount.isSlewing()) return CE_SLEW_IN_MOTION; + + #if GOTO_FEATURE == ON + if (park.state == PS_PARKED) return CE_SLEW_ERR_IN_PARK; + if (goTo.state != GS_NONE) { goTo.abort(); return CE_SLEW_IN_MOTION; } + #endif + + if (axis == 1 || guideAction == GA_SPIRAL) { + if (!validAxis1(guideAction)) return CE_SLEW_ERR_OUTSIDE_LIMITS; + if (settings.axis1RateSelect < 3) { + if (limits.isError() || axis1.motionError(DIR_BOTH)) return CE_SLEW_ERR_OUTSIDE_LIMITS; + } + } + + if (axis == 2 || guideAction == GA_SPIRAL) { + if (!validAxis2(guideAction)) return CE_SLEW_ERR_OUTSIDE_LIMITS; + if (settings.axis2RateSelect < 3) { + if (limits.isError() || axis2.motionError(DIR_BOTH)) return CE_SLEW_ERR_OUTSIDE_LIMITS; + } + } + + if (mount.motorFault()) return CE_SLEW_ERR_HARDWARE_FAULT; + + return CE_NONE; +} + +// start axis1 movement +void Guide::axis1AutoSlew(GuideAction guideAction) { + if (guideAction == GA_REVERSE) axis1.autoSlew(DIR_REVERSE); else + if (guideAction == GA_FORWARD) axis1.autoSlew(DIR_FORWARD); +} + +// start axis2 movement +void Guide::axis2AutoSlew(GuideAction guideAction) { + Coordinate location = mount.getMountPosition(CR_MOUNT); + if (location.pierSide == PIER_SIDE_WEST) { + if (guideAction == GA_REVERSE) axis2.autoSlew(DIR_FORWARD); else + if (guideAction == GA_FORWARD) axis2.autoSlew(DIR_REVERSE); + } else { + if (guideAction == GA_REVERSE) axis2.autoSlew(DIR_REVERSE); else + if (guideAction == GA_FORWARD) axis2.autoSlew(DIR_FORWARD); + } +} + +// set guide spiral rates in RA/Azm and Dec/Alt, rate is in x-sidereal, guide elapsed time is in ms +void Guide::spiralPoll() { + // current elapsed time in seconds + float T = ((long)(millis() - spiralStartTime))/1000.0; + + // actual rate we'll be using (in sidereal X) + float rate = rateSelectToRate(spiralGuideRateSelect); + float maxRate = rateSelectToRate(GR_MAX); + if (rate > maxRate/2.0) rate = maxRate/2.0; + float fastestRate = rateSelectToRate(GR_MAX, 2)*((float)(AXIS2_SLEW_RATE_PERCENT)/100.0F); + if (rate > fastestRate) rate = fastestRate; + + // apparaent FOV (in arc-seconds) = rate*15.0*2.0; + // current radius assuming movement at 2 seconds per fov + double radius = pow(T/6.28318, 1.0/1.74); + + // current angle in radians + float angle = (radius - trunc(radius))*6.28318; + + // calculate the Axis rates for this moment (in sidereal X) + customRateAxis1 = rate*cos(angle); + customRateAxis2 = rate*sin(angle); + + // add the current tracking rates + customRateAxis1 += mount.trackingRateAxis1; + customRateAxis2 += mount.trackingRateAxis2; + + // set any new directions + guideActionAxis1 = GA_FORWARD; + guideActionAxis2 = GA_FORWARD; + if (customRateAxis1 < 0) { customRateAxis1 = fabs(customRateAxis1); guideActionAxis1 = GA_REVERSE; } + if (customRateAxis2 < 0) { customRateAxis2 = fabs(customRateAxis2); guideActionAxis2 = GA_REVERSE; } + axis1AutoSlew(guideActionAxis1); + axis2AutoSlew(guideActionAxis2); + + // adjust Axis1 rate due to spherical coordinates and limit it to rates we can reach. worst case the + // shape of the spiral will degrade to an 2:1 aspect oval at half max rate (fastest allowed) and |Axis2| = 75 deg + customRateAxis1 /= spiralScaleAxis1; + if (customRateAxis1 > maxRate) customRateAxis1 = maxRate; + + // set the new guide rates + axis1.setFrequencySlew(siderealToRadF(customRateAxis1)); + axis2.setFrequencySlew(siderealToRadF(customRateAxis2)); +} + +void Guide::poll() { + // just return if no guide is active + if (state == GU_NONE) return; + + // check fast guide completion axis1 + if (guideActionAxis1 == GA_BREAK && rateAxis1 == 0.0F && !axis1.isSlewing()) { + guideActionAxis1 = GA_NONE; + mount.update(); + } else { + if (guideActionAxis1 > GA_BREAK && (long)(millis() - guideFinishTimeAxis1) >= 0) stopAxis1(); + } + + // check fast guide completion axis2 + if (guideActionAxis2 == GA_BREAK && rateAxis2 == 0.0F && !axis2.isSlewing()) { + guideActionAxis2 = GA_NONE; + mount.update(); + } else { + if (guideActionAxis2 > GA_BREAK && (long)(millis() - guideFinishTimeAxis2) >= 0) stopAxis2(); + } + + // do spiral guiding, change rates and stop both axes at once + if (state == GU_SPIRAL_GUIDE) { + if (guideActionAxis1 > GA_BREAK && guideActionAxis2 > GA_BREAK) spiralPoll(); else + if (guideActionAxis1 > GA_BREAK || guideActionAxis2 > GA_BREAK) stop(); + } + + // handle end of home guiding + if ((state == GU_HOME_GUIDE || state == GU_HOME_GUIDE_ABORT) && !mount.isSlewing()) { + guideActionAxis1 = GA_NONE; + guideActionAxis2 = GA_NONE; + mountStatus.soundAlert(); + if (state == GU_HOME_GUIDE) { + VLF("MSG: Guide, arrival at home detected"); + state = GU_NONE; + home.guideDone(true); + } else { + VLF("MSG: Guide, aborted homing"); + state = GU_NONE; + home.guideDone(false); + } + } + + // watch for finished guides + if (guideActionAxis1 == GA_NONE && guideActionAxis2 == GA_NONE) state = GU_NONE; +} + +// enables or disables backlash for the GUIDE_DISABLE_BACKLASH option +void Guide::backlashEnableControl(bool enable) { + #if GUIDE_DISABLE_BACKLASH == ON + axis1.setBacklash(enable ? mount.settings.backlash.axis1 : 0.0F); + axis2.setBacklash(enable ? mount.settings.backlash.axis2 : 0.0F); + #else + UNUSED(enable); + #endif +} + +Guide guide; + +#endif diff --git a/src/telescope/mount/guide/Guide.h b/src/telescope/mount/guide/Guide.h new file mode 100755 index 0000000..44f20d0 --- /dev/null +++ b/src/telescope/mount/guide/Guide.h @@ -0,0 +1,135 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control +#pragma once + +#include "../../../Common.h" + +#ifdef MOUNT_PRESENT + +#include "../../../libApp/commands/ProcessCmds.h" +#include "../../../lib/sound/Sound.h" +#include "../../../lib/axis/Axis.h" +#include "../coordinates/Transform.h" + +// default time limit for guiding home is 10 minutes +#define GUIDE_HOME_TIME_LIMIT 600.0 + +// default time for spiral guides is 103.4 seconds +#define GUIDE_SPIRAL_TIME_LIMIT 103.4 +enum GuideState: uint8_t {GU_NONE, GU_PULSE_GUIDE, GU_GUIDE, GU_SPIRAL_GUIDE, GU_HOME_GUIDE, GU_HOME_GUIDE_ABORT}; +enum GuideRateSelect: uint8_t {GR_QUARTER, GR_HALF, GR_1X, GR_2X, GR_4X, GR_8X, GR_20X, GR_48X, GR_HALF_MAX, GR_MAX, GR_CUSTOM}; +enum GuideAction: uint8_t {GA_NONE, GA_BREAK, GA_FORWARD, GA_REVERSE, GA_SPIRAL, GA_HOME }; + +#pragma pack(1) +#define GuideSettingsSize 3 +typedef struct GuideSettings { + GuideRateSelect pulseRateSelect; + GuideRateSelect axis1RateSelect; + GuideRateSelect axis2RateSelect; +} GuideSettings; +#pragma pack() + +class Guide { + public: + void init(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // start guide at a given direction and rate on Axis1 + CommandError startAxis1(GuideAction guideAction, GuideRateSelect rateSelect, unsigned long guideTimeLimit); + + // stop guide on Axis1, use GA_BREAK to stop in either direction or specifiy the direction to be stopped GA_FORWARD or GA_REVERSE + // set abort true to rapidly stop (broken limit, etc) + void stopAxis1(GuideAction stopDirection = GA_BREAK, bool abort = false); + + // start guide at a given direction and rate on Axis2 + CommandError startAxis2(GuideAction guideAction, GuideRateSelect rateSelect, unsigned long guideTimeLimit); + + // stop guide on Axis2, use GA_BREAK to stop in either direction or specifiy the direction to be stopped GA_FORWARD or GA_REVERSE + // set abort true to rapidly stop (broken limit, etc) + void stopAxis2(GuideAction stopDirection = GA_BREAK, bool abort = false); + + // start spiral guide at the specified rate (spiral size is porportional to rate) + CommandError startSpiral(GuideRateSelect rateSelect, unsigned long guideTimeLimit); + + // start guide home (for use with home switches) + CommandError startHome(); + + // stop both axes of guide + void stop(); + + // abort both axes of guide + void abort(); + + // returns true if a pulse guide is happening + inline bool activePulseGuide() { return state == GU_PULSE_GUIDE; } + + // returns true if a guide is happening + inline bool active() { + return (guideActionAxis1 != GA_NONE || guideActionAxis2 != GA_NONE) && !activePulseGuide(); + } + + // returns true if any guide is happening on Axis1 + inline bool activeAxis1() { return guideActionAxis1 != GA_NONE; } + + // returns true if any guide is happening on Axis2 + inline bool activeAxis2() { return guideActionAxis2 != GA_NONE; } + + void poll(); + + void spiralPoll(); + + // enables or disables backlash for the GUIDE_DISABLE_BACKLASH option + void backlashEnableControl(bool enable); + + GuideState state = GU_NONE; + + float rateAxis1 = 0.0F; + float rateAxis2 = 0.0F; + + GuideSettings settings = { GR_HALF, GR_20X, GR_20X }; + + private: + // keep guide rate <= half max + float limitGuideRate(float rate); + + // return guide rate (sidereal x) for guide rate selection + float rateSelectToRate(GuideRateSelect rateSelect, uint8_t axis = 1); + + // valid guide for Axis1 + bool validAxis1(GuideAction guideAction); + + // valid guide for Axis2 + bool validAxis2(GuideAction guideAction); + + // general validation of guide request + CommandError validate(int axis, GuideAction guideAction); + + // start axis1 movement + void axis1AutoSlew(GuideAction guideAction); + + // start axis2 movement + void axis2AutoSlew(GuideAction guideAction); + + GuideRateSelect spiralGuideRateSelect = GR_20X; + + GuideAction guideActionAxis1 = GA_NONE; + GuideAction guideActionAxis2 = GA_NONE; + + PierSide pierSide = PIER_SIDE_NONE; + + float customRateAxis1 = 0.0F; + float customRateAxis2 = 0.0F; + + float spiralScaleAxis1 = 0.0F; + unsigned long spiralStartTime = 0; + + unsigned long guideFinishTimeAxis1 = 0; + unsigned long guideFinishTimeAxis2 = 0; + + uint32_t nvKey; +}; + +extern Guide guide; + +#endif diff --git a/src/telescope/mount/home/Home.command.cpp b/src/telescope/mount/home/Home.command.cpp new file mode 100755 index 0000000..262cf08 --- /dev/null +++ b/src/telescope/mount/home/Home.command.cpp @@ -0,0 +1,94 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, home commands + +#include "Home.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/nv/Nv.h" + +#include "../limits/Limits.h" +#include "../park/Park.h" +#include "../site/Site.h" + +bool Home::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + UNUSED(reply); + UNUSED(suppressFrame); + if (command[0] == 'h') { + // :h?# Get home status - has sense, auto home enabled, offset axis1, offset axis2 (in arcseconds.) + // Returns: n,n,n,n# + if (command[1] == '?' && parameter[0] == 0) { + sprintf(reply, "%d,%ld,%ld", (int)hasSense, settings.axis1.senseOffset, settings.axis2.senseOffset); + *numericReply = false; + } else + + // :hAn# Set auto home state. + // Returns: Nothing + if (command[1] == 'A' && parameter[1] == 0) { + switch (parameter[0]) { + case '0': settings.automaticAtBoot = false; break; + case '1': settings.automaticAtBoot = true; break; + default: *commandError = CE_PARAM_RANGE; break; + } + nv().kv().put(nvKey, settings); + + *numericReply = false; + } else + + // :hC# Moves mount to the home position + // Returns: Nothing + if (command[1] == 'C' && parameter[0] == 0) { + *commandError = request(); + *numericReply = false; + } else + + // :hC1,n# Set home sense direction and home offset for axis1 arcseconds + // Returns: Nothing + if (command[1] == 'C' && parameter[0] == '1' && parameter[1] == ',') { + if (parameter[2] == 'R' && parameter[3] == 0) { + settings.axis1.senseReverse = !settings.axis1.senseReverse; + V("MSG: Set Axis1 home reverse "); VL(settings.axis1.senseReverse); + setReversal(); + } else { + long l = atol(¶meter[2]); + if (l >= -648000 || l <= 648000) { + settings.axis1.senseOffset = l; + } else *commandError = CE_PARAM_RANGE; + } + nv().kv().put(nvKey, settings); + *numericReply = false; + } else + + // :hC2,n# Set home sense direction and home offset for axis2 arcseconds + // Returns: Nothing + if (command[1] == 'C' && parameter[0] == '2' && parameter[1] == ',') { + if (parameter[2] == 'R' && parameter[3] == 0) { + settings.axis2.senseReverse = !settings.axis2.senseReverse; + V("MSG: Set Axis2 home reverse "); VL(settings.axis2.senseReverse); + setReversal(); + } else { + long l = atol(¶meter[2]); + if (l >= -648000 || l <= 648000) { + settings.axis2.senseOffset = l; + } else *commandError = CE_PARAM_RANGE; + } + nv().kv().put(nvKey, settings); + *numericReply = false; + } else + + // :hF# Reset mount at the home position. This position is required for a cold Start. + // Point to the celestial pole. GEM w/counterweights pointing downwards (CWD position). Equatorial fork mounts at HA = 0. + // Returns: Nothing + if (command[1] == 'F' && parameter[0] == 0) { + *commandError = reset(true); + park.reset(); + limits.enabled(site.isDateTimeReady()); + *numericReply = false; + } else return false; + + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/mount/home/Home.cpp b/src/telescope/mount/home/Home.cpp new file mode 100755 index 0000000..4cd6594 --- /dev/null +++ b/src/telescope/mount/home/Home.cpp @@ -0,0 +1,424 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, homing + +#include "Home.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../../Telescope.h" +#include "../Mount.h" +#include "../goto/Goto.h" +#include "../guide/Guide.h" +#include "../limits/Limits.h" + +// init the home position (according to settings and mount type) +void Home::init() { + nvKey = nv().kv().computeKey("HOME_SETTINGS"); + if (!nv().kv().getOrInit(nvKey, settings)) { DLF("WRN: Nv, init failed for HOME_SETTINGS"); } + + settings.automaticAtBoot = constrain(settings.automaticAtBoot, false, true); + settings.axis1.senseOffset = constrain(settings.axis1.senseOffset, degToArcsecF(-180), degToArcsecF(180)); + settings.axis1.senseReverse = constrain(settings.axis1.senseReverse, false, true); + settings.axis2.senseOffset = constrain(settings.axis2.senseOffset, degToArcsecF(-180), degToArcsecF(180)); + settings.axis2.senseReverse = constrain(settings.axis2.senseReverse, false, true); + + #ifndef AXIS1_HOME_DEFAULT + if (transform.mountType == GEM) position.h = Deg90; else { position.h = 0.0L; position.z = 0.0L; position.aa1 = 0.0L; } + #else + if (transform.mountType == ALTAZM) position.z = degToRad(AXIS1_HOME_DEFAULT); else + if (transform.mountType == ALTALT) position.aa1 = degToRad(AXIS1_HOME_DEFAULT); else position.h = degToRad(AXIS1_HOME_DEFAULT); + #endif + + #ifndef AXIS2_HOME_DEFAULT + if (transform.mountType == ALTAZM) position.a = 0.0; else + if (transform.mountType == ALTALT) position.aa2 = 0.0; else position.d = site.locationEx.latitude.sign*Deg90; + #else + if (transform.mountType == ALTAZM) position.a = degToRad(AXIS2_HOME_DEFAULT); + if (transform.mountType == ALTALT) position.aa2 = degToRad(AXIS2_HOME_DEFAULT); else position.d = degToRad(AXIS2_HOME_DEFAULT); + #endif + + setReversal(); + + position.pierSide = PIER_SIDE_NONE; +} + +// move mount to the home position +CommandError Home::request() { + #if GOTO_FEATURE == OFF + DLF("WRN: Mount, home rejected because goto is disabled"); + return CE_SLEW_ERR_UNSPECIFIED; + #endif + + failed = false; + if (!mount.startupAuthorityTrusted() && !hasSense) { + DLF("WRN: Mount, home rejected because startup authority is not trusted and no home switches are present"); + return CE_SLEW_ERR_UNSPECIFIED; + } + if (!site.dateIsReady || !site.timeIsReady) return CE_SLEW_ERR_IN_STANDBY; + if (goTo.state != GS_NONE) return CE_SLEW_IN_MOTION; + if (guide.state != GU_NONE) { + if (guide.state == GU_HOME_GUIDE) guide.stop(); + return CE_SLEW_IN_MOTION; + } + + wasTracking = mount.isTracking(); + #if AXIS1_SECTOR_GEAR == ON || AXIS2_TANGENT_ARM == OFF + mount.tracking(false); + #endif + + // make sure the motors are powered on + mount.enable(true); + goTo.firstGoto = false; + + Coordinate homePosition = getPosition(CR_MOUNT_EQU); + + if (hasSense) { + CommandError e; + + #if AXIS1_SECTOR_GEAR == OFF && AXIS2_TANGENT_ARM == OFF + double a1 = axis1.getInstrumentCoordinate() - homePosition.a1; + double a2 = axis2.getInstrumentCoordinate() - homePosition.a2; + + // both -180 to 180 + VF("MSG: Mount, homing from a1="); V(radToDeg(a1)); VF(" degrees a2="); V(radToDeg(a2)); VLF(" degrees"); + if (abs(a1) > degToRad(AXIS1_SENSE_HOME_DIST_LIMIT) - abs(arcsecToRad(settings.axis1.senseOffset))) return CE_SLEW_ERR_OUTSIDE_LIMITS; + if (abs(a2) > degToRad(AXIS2_SENSE_HOME_DIST_LIMIT) - abs(arcsecToRad(settings.axis2.senseOffset))) return CE_SLEW_ERR_OUTSIDE_LIMITS; + + e = reset(false); + if (e != CE_NONE) return e; + #endif + + VLF("MSG: Mount, guiding to home"); + state = HS_HOMING; + isRequestWithReset = false; + #if MOUNT_COORDS_MEMORY == ON + mount.saveCoordinateMemory(false); + #endif + e = guide.startHome(); + if (e != CE_NONE) { + state = HS_NONE; + return e; + } + } else { + #if AXIS1_SECTOR_GEAR == OFF && AXIS2_TANGENT_ARM == OFF + VLF("MSG: Mount, moving to home"); + state = HS_HOMING; + + CommandError result = goTo.request(homePosition, PSS_EAST_ONLY, false); + if (result != CE_NONE) { + DF("WRN: Mount, moving to home goto failed (code "); D(result); DLF(")"); + state = HS_NONE; + } + return result; + #else + #if AXIS1_SECTOR_GEAR == ON + VLF("MSG: Mount, moving SG to home"); + axis1.setFrequencySlew(goTo.rate); + axis1.setTargetCoordinate(axis1.getIndexPosition()); + VLF("Mount, axis1 home target coordinates set"); + axis1.autoGoto(degToRadF((float)(SLEW_ACCELERATION_DIST))); + #endif + #if AXIS2_TANGENT_ARM == ON + VLF("MSG: Mount, moving TA to home"); + axis2.setFrequencySlew(goTo.rate*((float)(AXIS2_SLEW_RATE_PERCENT)/100.0F)); + axis2.setTargetCoordinate(axis2.getIndexPosition()); + VLF("Mount, axis2 home target coordinates set"); + axis2.autoGoto(degToRadF((float)(SLEW_ACCELERATION_DIST))); + #endif + #endif + } + return CE_NONE; +} + +// reset mount, moves to the home position first if home switches are present +CommandError Home::requestWithReset() { + #if GOTO_FEATURE == OFF + DLF("WRN: Mount, reset/home rejected because goto is disabled"); + return CE_SLEW_ERR_UNSPECIFIED; + #endif + + if (!mount.startupAuthorityTrusted() && !hasSense) { + DLF("WRN: Mount, reset/home rejected because startup authority is not trusted and no home switches are present"); + return CE_SLEW_ERR_UNSPECIFIED; + } + if (hasSense) { + CommandError result = request(); + isRequestWithReset = true; + return result; + } else return reset(); +} + +// clear home state on abort +void Home::requestAborted() { + state = HS_NONE; + failed = true; + mount.tracking(wasTracking); +} + +// after finding home switches displace the mount axes as specified +void Home::guideDone(bool success) { + if (!success) { + state = HS_NONE; + failed = true; + CommandError e = reset(isRequestWithReset); + if (e != CE_NONE) { + DF("WRN: Home::guideDone(), reset after sensed home failure failed (code "); D(e); DLF(")"); + } else { + DLF("WRN: Home::guideDone(), sensed home failed"); + } + return; + } + + #if AXIS1_SECTOR_GEAR == OFF && AXIS2_TANGENT_ARM == OFF + if (useOffset()) { + CommandError e = reset(isRequestWithReset, true); + if (e != CE_NONE) { + state = HS_NONE; + failed = true; + DF("WRN: Home::guideDone(), reset after sensed home failed (code "); D(e); DLF(")"); + return; + } + + #if MOUNT_HOME_AT_OFFSETS == OFF + VF("MSG: Mount, finishing move to home with goto to ("); + double a1 = axis1.getInstrumentCoordinate() - arcsecToRad(site.locationEx.latitude.sign*settings.axis1.senseOffset); + double a2 = axis2.getInstrumentCoordinate() - arcsecToRad(settings.axis2.senseOffset); + V(radToDeg(a1)); VF(","); V(radToDeg(a2)); VLF(")"); + axis1.setTargetCoordinate(a1); + axis1.autoGoto(goTo.getRadsPerSecond()); + axis2.setTargetCoordinate(a2); + axis2.autoGoto(goTo.getRadsPerSecond()); + #endif + mount.syncFromOnStepToEncoders = true; + + state = HS_NONE; + failed = false; + } else { + state = HS_NONE; + CommandError e = reset(isRequestWithReset, true); + if (e != CE_NONE) { + failed = true; + DF("WRN: Home::guideDone(), reset after sensed home failed (code "); D(e); DLF(")"); + } else { + failed = false; + mount.syncFromOnStepToEncoders = true; + } + } + #else + state = HS_NONE; + failed = false; + + #if AXIS1_SECTOR_GEAR == ON + VLF("MSG: Mount, sector gear set origin"); + double h = axis1.getInstrumentCoordinate(); + if (axis1.resetPosition(0.0L) != 0) { DLF("WRN: Home::guideDone(), failed to resetPosition Axis1"); exit; } + if (limits.setInstrumentCoordinate(1, h, true) != CE_NONE) { DLF("WRN: Home::guideDone(), failed to setInstrumentCoordinate Axis1"); exit; } + mount.tracking(wasTracking); + #endif + + #if AXIS2_TANGENT_ARM == ON + VLF("MSG: Mount, tangent arm set origin"); + double d = axis2.getInstrumentCoordinate(); + if (axis2.resetPosition(0.0L) != 0) { DLF("WRN: Home::guideDone(), failed to resetPosition Axis2"); exit; } + if (limits.setInstrumentCoordinate(2, d, true) != CE_NONE) { DLF("WRN: Home::guideDone(), failed to setInstrumentCoordinate Axis2"); exit; } + #endif + + mount.captureNominalIndexPositions(); + #endif +} + +// once homed mark as done +void Home::requestDone() { + state = HS_NONE; + failed = false; + reset(false); +} + +// reset mount at home +CommandError Home::reset(bool fullReset, bool authoritative) { + #if GOTO_FEATURE == ON + if (goTo.state != GS_NONE) { + axis1.autoSlewAbort(); + axis2.autoSlewAbort(); + return CE_SLEW_IN_MOTION; + } + #endif + if (guide.state != GU_NONE) { + if (guide.state == GU_HOME_GUIDE) guide.stop(); + return CE_SLEW_IN_MOTION; + } + + // refresh the home position + init(); + + // stop tracking and set default rate + mount.tracking(false); + mount.trackingRate = hzToSidereal(TRACKING_RATE_DEFAULT_HZ); + mount.trackingRateOffsetRA = 0.0F; + mount.trackingRateOffsetDec = 0.0F; + goTo.firstGoto = true; + + tasks.yieldMicros(10000); + + Coordinate homePosition = getPosition(CR_MOUNT); + + if (!goTo.absoluteEncodersPresent) { + #if MOUNT_HOME_AT_OFFSETS == OFF + if (useOffset() && state == HS_HOMING && !fullReset) { + homePosition.a1 += arcsecToRad(site.locationEx.latitude.sign*settings.axis1.senseOffset); + homePosition.a2 += arcsecToRad(settings.axis2.senseOffset); + } + #endif + + bool bypassCoordinateLimit = authoritative; + #if MOUNT_STARTUP_MODE == SA_AUTO && MOUNT_COORDS_MEMORY == OFF + if (!bypassCoordinateLimit && !axis1.motor->hasAbsoluteEncoder() && !axis2.motor->hasAbsoluteEncoder()) { + bypassCoordinateLimit = true; + } + #endif + + CommandError e = limits.validateInstrumentCoordinate(1, homePosition.a1, bypassCoordinateLimit); + if (e == CE_NONE) e = limits.validateInstrumentCoordinate(2, homePosition.a2, bypassCoordinateLimit); + if (e != CE_NONE) { + DLF("WRN: Home::reset(), coordinate reset rejected by sync threshold"); + if (fullReset) mount.enable(MOUNT_ENABLE_IN_STANDBY == ON); + return CE_SLEW_ERR_OUTSIDE_LIMITS; + } + + if (axis1.resetPosition(0.0L) != 0) { + DLF("WRN: Home::reset(), failed to resetPosition Axis1"); + if (fullReset) mount.enable(MOUNT_ENABLE_IN_STANDBY == ON); + return CE_SLEW_IN_MOTION; + } + if (axis2.resetPosition(0.0L) != 0) { + DLF("WRN: Home::reset(), failed to resetPosition Axis2"); + if (fullReset) mount.enable(MOUNT_ENABLE_IN_STANDBY == ON); + return CE_SLEW_IN_MOTION; + } + + e = limits.setInstrumentCoordinate(1, homePosition.a1, true); + if (e == CE_NONE) e = limits.setInstrumentCoordinate(2, homePosition.a2, true); + if (e != CE_NONE) { + if (fullReset) mount.enable(MOUNT_ENABLE_IN_STANDBY == ON); + return e; + } + } + + mount.captureNominalIndexPositions(); + + axis1.setBacklash(mount.settings.backlash.axis1); + axis2.setBacklash(mount.settings.backlash.axis2); + + axis1.setFrequencySlew(degToRadF(0.1F)); + axis2.setFrequencySlew(degToRadF(0.1F)); + + // make sure the motors are powered off + if (fullReset) { + mount.enable(MOUNT_ENABLE_IN_STANDBY == ON); + + #if GOTO_FEATURE == ON + goTo.alignReset(); + #endif + + VF("MSG: Mount, reset at home ("); + V(radToDeg(homePosition.a1)); VF(","); V(radToDeg(homePosition.a2)); + VLF(") and in standby"); + } else { + VF("MSG: Mount, reset at home ("); + V(radToDeg(homePosition.a1)); VF(","); V(radToDeg(homePosition.a2)); + VLF(")"); + } + + if (authoritative) mount.setStartupAuthorityTrusted(true); + + return CE_NONE; +} + +// get the home position (Mount coordinate system) +Coordinate Home::getPosition(CoordReturn coordReturn) { + Coordinate homePosition = position; + + homePosition.pierSide = PIER_SIDE_EAST; + + #if MOUNT_HOME_AT_OFFSETS == ON + if (useOffset()) { + if (transform.mountType == ALTAZM) { + homePosition.z += arcsecToRad(settings.axis1.senseOffset); + homePosition.a += arcsecToRad(settings.axis2.senseOffset); + } else + if (transform.mountType == ALTALT) { + homePosition.aa1 += arcsecToRad(settings.axis1.senseOffset); + homePosition.aa2 += arcsecToRad(settings.axis2.senseOffset); + } else { + homePosition.h += arcsecToRad(site.locationEx.latitude.sign*settings.axis1.senseOffset); + homePosition.d += arcsecToRad(settings.axis2.senseOffset); + } + } + #endif + + if (transform.mountType == ALTAZM) { + homePosition.a1 = homePosition.z; + homePosition.a2 = homePosition.a; + } else + if (transform.mountType == ALTALT) { + homePosition.a1 = homePosition.aa1; + homePosition.a2 = homePosition.aa2; + } else { + homePosition.a1 = homePosition.h; + homePosition.a2 = homePosition.d; + + if (site.location.latitude >= 0.0) { + if (homePosition.d > Deg90) { + homePosition.pierSide = PIER_SIDE_WEST; + homePosition.h -= Deg180; + homePosition.d = Deg180 - homePosition.d; + } + } else { + if (homePosition.d < -Deg90) { + homePosition.pierSide = PIER_SIDE_WEST; + homePosition.h -= Deg180; + homePosition.d = (-Deg180) - homePosition.d; + } + } + } + + switch (coordReturn) { + case CR_MOUNT: + break; + case CR_MOUNT_EQU: + if (transform.mountType == ALTAZM) transform.horToEqu(&homePosition); + if (transform.mountType == ALTALT) transform.aaToEqu(&homePosition); + transform.hourAngleToRightAscension(&homePosition, true); + break; + case CR_MOUNT_ALT: + case CR_MOUNT_HOR: + if (transform.isEquatorial()) transform.equToHor(&homePosition); + else if (transform.mountType == ALTALT) transform.aaToHor(&homePosition); + break; + case CR_MOUNT_ALL: + if (transform.mountType == ALTAZM) transform.horToEqu(&homePosition); else + if (transform.mountType == ALTALT) transform.aaToEqu(&homePosition); else transform.equToHor(&homePosition); + transform.hourAngleToRightAscension(&homePosition, true); + break; + } + + return homePosition; +} + +bool Home::useOffset() { + if (hasSense && (settings.axis1.senseOffset != 0 || settings.axis2.senseOffset != 0)) return true; else return false; +} + +void Home::setReversal() { + bool latitudeReversal = transform.isEquatorial() && site.locationEx.latitude.sign < 0.0; + axis1.setReverse(latitudeReversal); + if (!settings.axis1.senseReverse) axis1.setHomeReverse(latitudeReversal); else axis1.setHomeReverse(!latitudeReversal); + axis2.setHomeReverse(settings.axis2.senseReverse); +} + +Home home; + +#endif diff --git a/src/telescope/mount/home/Home.h b/src/telescope/mount/home/Home.h new file mode 100755 index 0000000..a103e3d --- /dev/null +++ b/src/telescope/mount/home/Home.h @@ -0,0 +1,81 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount home control +#pragma once + +#include "../../../Common.h" + +#ifdef MOUNT_PRESENT + +#include "../../../libApp/commands/ProcessCmds.h" +#include "../coordinates/Transform.h" + +enum HomeState: uint8_t {HS_NONE, HS_HOMING}; + +#pragma pack(1) +#define SettingsSize 11 +typedef struct HomeSense { + long senseOffset; + bool senseReverse; +} HomeSense; +typedef struct Settings { + bool automaticAtBoot; + HomeSense axis1; + HomeSense axis2; +} Settings; +#pragma pack() + +class Home { + public: + // init the home position (according to settings and mount type) + void init(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // move mount to the home position + CommandError request(); + + // reset mount, moves to the home position first if home switches are present + CommandError requestWithReset(); + + // clear home state on abort + void requestAborted(); + + // after finding home switches displace the mount axes as specified + void guideDone(bool success); + + // once homed mark as done + void requestDone(); + + // reset mount at home + CommandError reset(bool fullReset = true, bool authoritative = false); + + // get the home position (Mount coordinate system) + Coordinate getPosition(CoordReturn coordReturn = CR_MOUNT_EQU); + + // home sensing + bool useOffset(); + + // allow axis1 by latitude reversal and home switch reversal + void setReversal(); + + bool hasSense = (((AXIS1_SENSE_HOME) != OFF) && ((AXIS2_SENSE_HOME) != OFF)) || \ + (((AXIS1_SECTOR_GEAR) == ON) && ((AXIS1_SENSE_HOME) != OFF)) || \ + (((AXIS2_TANGENT_ARM) == ON) && ((AXIS2_SENSE_HOME) != OFF)); + + Settings settings = {MOUNT_AUTO_HOME_DEFAULT == ON, {AXIS1_SENSE_HOME_OFFSET, false}, {AXIS2_SENSE_HOME_OFFSET, false}}; + + bool isRequestWithReset = false; + bool failed = false; + + HomeState state; + + private: + bool wasTracking = false; + Coordinate position; + + uint32_t nvKey; +}; + +extern Home home; + +#endif diff --git a/src/telescope/mount/library/Library.command.cpp b/src/telescope/mount/library/Library.command.cpp new file mode 100755 index 0000000..f440bbe --- /dev/null +++ b/src/telescope/mount/library/Library.command.cpp @@ -0,0 +1,183 @@ +//-------------------------------------------------------------------------------------------------- +// telescope celestial object library, commands + +#include "Library.h" + +#if defined(MOUNT_PRESENT) + +#include "../coordinates/Transform.h" +#include "../goto/Goto.h" + +char const *ObjectStr[] = {"UNK", "OC", "GC", "PN", "DN", "SG", "EG", "IG", "KNT", "SNR", "GAL", "CN", "STR", "PLA", "CMT", "AST"}; + +bool Library::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + *suppressFrame = false; + + // L - Object Library Commands + if (command[0] == 'L') { + + // :LB# Find previous catalog object subject to the current constraints + // Returns: Nothing + if (command[1] == 'B' && parameter[0] == 0) { + prevRec(); + *numericReply = false; + } else + + // :LC[n]# Set current target object to catalog object number + // Returns: Nothing + if (command[1] == 'C') { + int16_t i; + if (convert.atoi2(parameter, &i)) { + if (i >= 0) { + gotoRec(i); + *numericReply = false; + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + // :LI# Get Object Information + // Returns: s# (string containing the current target object’s name and object type) + if (command[1] == 'I' && parameter[0] == 0) { + int i; + Coordinate target; + readVars(reply, &i, &target.r, &target.d); + + char const *objType = ObjectStr[i]; + strcat(reply, ","); + strcat(reply, objType); + *numericReply = false; + } else + + // :LIG# Get catalog object information and goto target + // Returns: Nothing + if (command[1] == 'I' && parameter[0] == 'G' && parameter[1] == 0) { + int i; + Coordinate target; + readVars(reply, &i, &target.r, &target.d); + goTo.setGotoTarget(&target); + *numericReply = false; + } else + + // :LR# Get catalog object information including RA and Dec, with advance to next record + // Returns: s# (string containing the current target object’s name, type, RA, and Dec) + if (command[1] == 'R' && parameter[0] == 0) { + int i; + Coordinate target; + readVars(reply, &i, &target.r, &target.d); + goTo.setGotoTarget(&target); + + char const * objType = ObjectStr[i]; + char ws[20]; + + strcat(reply, ","); + strcat(reply, objType); + if (strcmp(reply, ",UNK") != 0) { + convert.doubleToHms(ws, radToHrs(target.r), false, PM_HIGH); strcat(reply, ","); strcat(reply, ws); + convert.doubleToDms(ws, radToDeg(target.d), false, true, PM_HIGH); strcat(reply, ","); strcat(reply, ws); + } + + nextRec(); + *numericReply = false; + } else + + // :LW[s]# Write catalog object information including current target RA,Dec to next available empty record + // If at the end of the object list (:LI# command returns an empty string "#") a new item is automatically added + // [s] is a string of up to eleven chars followed by a comma and a type designation for ex. ":LWM31 AND,GAL#" + // Returns: 0 on failure (memory full, for example) + // 1 on success + if (command[1] == 'W') { + char name[12]; + char objType[4]; + + // extract object name + int l = 0; + do { + name[l] = 0; + if (parameter[l] == ',') break; + name[l] = parameter[l]; + name[l + 1] = 0; + l++; + } while (l < 12); + + // extract object type + int16_t i = 0; + if (parameter[l] == ',') { + l++; + int16_t m = 0; + do { + objType[m + 1] = 0; + objType[m] = parameter[l]; + l++; + m++; + } while (parameter[l] != 0); + // encode + // 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 + // "UNK", "OC", "GC", "PN", "DN", "SG", "EG", "IG", "KNT", "SNR", "GAL", "CN", "STR", "PLA", "CMT", "AST" + for (l = 0; l <= 15; l++) { if (strcmp(objType, ObjectStr[l]) == 0) i = l; } + } + + Coordinate target = goTo.getGotoTarget(); + if (firstFreeRec()) writeVars(name, i, target.r, target.d); else *commandError = CE_LIBRARY_FULL; + } else + + // :LN# Find next catalog object subject to the current constraints + // Returns: Nothing + if (command[1] == 'N' && parameter[0] == 0) { + nextRec(); + *numericReply = false; + } else + + // :L$# Move to catalog name record + // Returns: 1 + if (command[1] == '$' && parameter[0] == 0) { + nameRec(); + *numericReply = true; + } else + + // :LD# Clear current record + // Returns: Nothing + if (command[1] == 'D' && parameter[0] == 0) { + clearCurrentRec(); + *numericReply = false; + } else + + // :LL# Clear current catalog + // Returns: Nothing + if (command[1] == 'L' && parameter[0] == 0) { + clearLib(); + *numericReply = false; + } else + + // :L!# Clear library (all catalogs) + // Returns: Nothing + if (command[1] == '!' && parameter[0] == 0) { + clearAll(); + *numericReply = false; + } else + + // :L?# Get library free records (all catalogs) + // Returns: n# + if (command[1] == '?' && parameter[0] == 0) { + sprintf(reply, "%u", recFreeAll()); + *numericReply = false; + } else + + // :Lo[n]# Select Library catalog by catalog number n + // Catalog number ranges from 0..14, catalogs 0..6 are user defined, the remainder are reserved + // Return: 0 on failure + // 1 on success + if (command[1] == 'o') { + int16_t i; + if (convert.atoi2(parameter, &i)) { + if (i >= 0 && i <= 14) { + setCatalog(i); + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else *commandError = CE_CMD_UNKNOWN; + + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/mount/library/Library.cpp b/src/telescope/mount/library/Library.cpp new file mode 100755 index 0000000..a01f30e --- /dev/null +++ b/src/telescope/mount/library/Library.cpp @@ -0,0 +1,324 @@ +// ----------------------------------------------------------------------------------- +// telescope celestial object library + +#include "Library.h" + +#if defined(MOUNT_PRESENT) + +#include "../../../lib/nv/Nv.h" + +#include "../../Telescope.h" + +char const * objectStr[] = {"UNK", "OC", "GC", "PN", "DN", "SG", "EG", "IG", "KNT", "SNR", "GAL", "CN", "STR", "PLA", "CMT", "AST"}; + +bool Library::init() { + if (ready) return true; + + catalog = 0; + NvVolume& nvVolume = nv().volume(); + if (!nvVolume.isMounted()) { + DLF("WRN: Library::init(); NV volume not mounted"); + return false; + } + + // Bind IvPartition to the LIBRARY partition by name. + if (nvIv.init(nvVolume, "LIBRARY")) { + VLF("MSG: Nv, partition 'LIBRARY' mounted"); + } else { + DLF("WRN: Library::init(); can't find library partition!"); + return false; + } + + recMax = nvIv.sizeBytes()/rec_size; // maximum number of records + + if (recMax == 0) { + DLF("WRN: Library::init(); recMax == 0, no library space available"); + return false; + } + + VF("MSG: Mount, library allocated "); V(recMax); VLF(" catalog records"); + + ready = true; + + firstRec(); + + return true; +} + +// select catalog by number (0 to 14) +bool Library::setCatalog(int num) { + if (!ready) return false; + if (num < 0 || num > 14) return false; + + catalog = num; + return firstRec(); +} + +// write current record from data +// \param name: object name (to 12 chars) +// \param code: object classification (0 to 15) +// \param RA: in radians +// \param Dec: in radians +void Library::writeVars(char* name, int code, double RA, double Dec) { + if (!ready) return; + + libRec_t work; + + for (int16_t l = 0; l < 11; l++) work.libRec.name[l] = name[l]; + work.libRec.code = (code | (catalog << 4)); + + // convert from radians to degrees + RA = radToDeg(RA); + Dec = radToDeg(Dec); + + // convert into an unsigned int, RA=0..360 + RA = degRange(RA)/360.0; + // convert into an unsigned int, Dec=0..180 + if (Dec > 90.0) Dec = 90.0; + if (Dec < -90.0) Dec = -90.0; + Dec = Dec + 90.0; Dec = Dec/180.0; + uint16_t r = round(RA*65536.0); + uint16_t d = round(Dec*65536.0); + + work.libRec.RA = r; + work.libRec.Dec = d; + + writeRec(recPos, work); +} + +// read data for the current record +// \param name: object name (to 12 chars) +// \param code: object classification (0 to 15) +// \param RA: in radians +// \param Dec: in radians +void Library::readVars(char* name, int* code, double* RA, double* Dec) { + if (!ready) { name[0] = 0; *code = 0; *RA = 0.0; *Dec = 0.0; return; } + + libRec_t work; + work = readRec(recPos); + + int16_t cat = work.libRec.code >> 4; + + // empty? or not found + if (cat == 15 || cat != catalog) { name[0] = 0; *code = 0; *RA = 0.0; *Dec = 0.0; return; } + + for (int16_t l = 0; l < 11; l++) name[l] = work.libRec.name[l]; + name[11] = 0; + + *code = work.libRec.code & 15; + uint16_t r = work.libRec.RA; + uint16_t d = work.libRec.Dec; + + // convert from unsigned int + *RA = (double)r; + *RA = (*RA/65536.0)*360.0; + *Dec = (double)d; + *Dec = ((*Dec/65536.0)*180.0)-90.0; + + // convert from degrees to radians + *RA = degToRad(*RA); + *Dec = degToRad(*Dec); +} + +// move to catalogs first rec +bool Library::firstRec() { + if (!ready) return false; + + libRec_t work; + + // see if first record is for the currentLib + recPos = 0; + work = readRec(recPos); + int16_t cat = (int16_t)work.libRec.code >> 4; + if (work.libRec.name[0] != '$' && cat == catalog) return true; + + // otherwise find the first one, if it exists + return nextRec(); +} + +// move to the catalog name rec +bool Library::nameRec() { + if (!ready) return false; + + for (recPos = 0; recPos < recMax; ++recPos) { + const libRec_t work = readRec(recPos); + const int16_t cat = (int16_t)(work.libRec.code >> 4); + + if (work.libRec.name[0] == '$' && cat == catalog) return true; + } + + // not found, point at the last record + recPos = (uint16_t)(recMax - 1); + return false; +} + +// move to the first unused record for this catalog +bool Library::firstFreeRec() { + if (!ready) return false; + + for (recPos = 0; recPos < recMax; ++recPos) { + const libRec_t work = readRec(recPos); + const int16_t cat = (int16_t)(work.libRec.code >> 4); + + if (cat == 15) return true; // unused slot + } + + // not found, point at the last record + recPos = (uint16_t)(recMax - 1); + return false; +} + +bool Library::prevRec() { + if (!ready) return false; + + while (true) { + if (recPos == 0) return false; // no earlier record + + recPos--; + libRec_t work = readRec(recPos); + int16_t cat = (int16_t)(work.libRec.code >> 4); + + if (work.libRec.name[0] != '$' && cat == catalog) return true; + } +} + +// move to the next record, if it exists +bool Library::nextRec() { + if (!ready) return false; + + while (true) { + if (recPos >= (uint16_t)(recMax - 1)) return false; + + ++recPos; + + libRec_t work = readRec(recPos); + int16_t cat = (int16_t)(work.libRec.code >> 4); + + if (work.libRec.name[0] != '$' && cat == catalog) return true; + } +} + +// move to the specified record (of this catalog), if it exists +bool Library::gotoRec(uint16_t num) { + if (!ready) return false; + + libRec_t work; + int16_t cat; + uint16_t lastAddress = 0; + uint16_t count = 0; + + for (uint16_t address = 0; address < recMax; address++) { + work = readRec(address); + lastAddress = address; + + cat = (int16_t)work.libRec.code >> 4; + if (work.libRec.name[0] != '$' && cat == catalog) count++; + if (count == num) break; + } + if (count == num) { recPos = lastAddress; return true; } else return false; +} + +// actual number of records for this catalog +uint16_t Library::recCount() { + if (!ready) return 0; + + libRec_t work; + int16_t cat; + uint16_t count = 0; + + for (uint16_t address = 0; address < recMax; address++) { + work = readRec(address); + + cat = (int16_t)work.libRec.code >> 4; + if (work.libRec.name[0] != '$' && cat == catalog) count++; + } + + return count; +} + +// actual number of records for this library +uint16_t Library::recCountAll() { + if (!ready) return 0; + + libRec_t work; + int16_t cat; + uint16_t c = 0; + + for (uint16_t address = 0; address < recMax; address++) { + work = readRec(address); + + cat = (int16_t)work.libRec.code >> 4; + if (cat >= 0 && cat <= 14) c++; + } + + return c; +} + +// clears this record +void Library::clearCurrentRec() { + if (!ready) return; + + libRec_t work; + int16_t cat; + + work = readRec(recPos); + + cat = (int16_t)work.libRec.code >> 4; + if (cat == catalog) clearRec(recPos); +} + +// clears this library +void Library::clearLib() { + if (!ready) return; + + libRec_t work; + int16_t cat; + + for (uint16_t address = 0; address < recMax; address++) { + work = readRec(address); + + cat = (int16_t)work.libRec.code >> 4; + if (cat == catalog) clearRec(address); + } +} + +// clear library (clear all catalogs) +void Library::clearAll() { + if (!ready) return; + for (uint16_t l = 0; l < recMax; l++) clearRec(l); +} + +// number records available for this library +uint16_t Library::recFreeAll() { + if (!ready) return 0; + return recMax - recCountAll(); +} + +libRec_t Library::readRec(uint16_t address) { + libRec_t work{}; + if (!ready) return work; + if (address >= recMax) return work; + + nvIv.readBlock(address, work.libRecBytes); + return work; +} + +void Library::writeRec(uint16_t address, libRec_t data) { + if (!ready) return; + if (address >= recMax) return; + + nvIv.writeBlock(address, data.libRecBytes); +} + +void Library::clearRec(uint16_t address) { + if (!ready) return; + if (address >= recMax) return; + + uint16_t index = address*rec_size; + uint8_t code = 0xF0; + nvIv.writeBytes(index + 11, &code, 1); // catalog code 15 = unused +} + +Library library; + +#endif \ No newline at end of file diff --git a/src/telescope/mount/library/Library.h b/src/telescope/mount/library/Library.h new file mode 100755 index 0000000..865010b --- /dev/null +++ b/src/telescope/mount/library/Library.h @@ -0,0 +1,119 @@ +// ----------------------------------------------------------------------------------- +// telescope celestial object library +#pragma once + +#include "../../../Common.h" + +#if defined(MOUNT_PRESENT) + +#include "../../../lib/convert/Convert.h" +#include "../../../lib/nv/NvIvPartition.h" +#include "../../../libApp/commands/ProcessCmds.h" + +#if AXIS1_PEC == ON + #define NV_LIBRARY_DATA_BASE NV_PEC_BUFFER_BASE + PEC_BUFFER_SIZE_LIMIT +#else + #define NV_LIBRARY_DATA_BASE NV_PEC_BUFFER_BASE + 0 +#endif + +#pragma pack(1) +const int rec_size = 16; +typedef struct { + char name[11]; // 11 + byte code; // 1 (low 4 bits are object class, high are catalog #) + uint16_t RA; // 2 + uint16_t Dec; // 2 +} libRecBase_t; + +typedef union { + libRecBase_t libRec; + byte libRecBytes[rec_size]; +} libRec_t; +#pragma pack() + +class Library +{ + public: + bool init(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // select catalog by number (0 to 14) + bool setCatalog(int num); + + // write current record from data + // \param name: object name (to 12 chars) + // \param code: object classification (0 to 15) + // \param RA: in radians + // \param Dec: in radians + void writeVars(char* name, int code, double RA, double Dec); + + // read data for the current record + // \param name: object name (to 12 chars) + // \param code: object classification (0 to 15) + // \param RA: in radians + // \param Dec: in radians + void readVars(char* name, int* code, double* RA, double* Dec); + + // move to catalogs first rec + bool firstRec(); + + // move to the catalog name rec + bool nameRec(); + + // move to the first unused record for this catalog + bool firstFreeRec(); + + // move to the previous record, if it exists + bool prevRec(); + + // move to the next record, if it exists + bool nextRec(); + + // move to the specified record (of this catalog), if it exists + bool gotoRec(uint16_t num); + + // actual number of records for this catalog + uint16_t recCount(); + + // actual number of records for this library + uint16_t recCountAll(); + + // clears this record + void clearCurrentRec(); + + // clears this library + void clearLib(); + + // clears all libraries + void clearAll(); + + // number records available for this library + uint16_t recFreeAll(); + + private: + // flag for successful initialization + bool ready = false; + + // currently selected record# + uint16_t recPos; + + // last record# + uint16_t recMax; + + // 16 byte record + libRec_t list; + + libRec_t readRec(uint16_t address); + void writeRec(uint16_t address, libRec_t data); + void clearRec(uint16_t address); + inline double degRange(double d) { while (d >= 360.0) d -= 360.0; while (d < 0.0) d += 360.0; return d; } + + int catalog; + + IvPartition nvIv; +}; + +extern Library library; + +#endif diff --git a/src/telescope/mount/limits/Limits.command.cpp b/src/telescope/mount/limits/Limits.command.cpp new file mode 100755 index 0000000..8b0fcbf --- /dev/null +++ b/src/telescope/mount/limits/Limits.command.cpp @@ -0,0 +1,107 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount limits commands + +#include "Limits.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../../Telescope.h" +#include "../Mount.h" +#include "../site/Site.h" + +bool Limits::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + *suppressFrame = false; + + if (command[0] == 'G') { + // :Gh# Get Horizon Limit, the minimum elevation of the mount relative to the horizon + // Returns: sDD*# + if (command[1] == 'h' && parameter[0] == 0) { + sprintf(reply, "%+02ld*", lroundf(radToDegF(settings.altitude.min))); + *numericReply = false; + } else + + // :Go# Get Overhead Limit + // Returns: DD*# + // The highest elevation above the horizon that the telescope will goto + if (command[1] == 'o' && parameter[0] == 0) { + sprintf(reply, "%02ld*", lroundf(radToDegF(settings.altitude.max))); + *numericReply=false; + } else + + // :GXE[m]# Get Other Limit [m] + // Returns: n# + if (command[1] == 'X' && parameter[0] == 'E' && parameter[2] == 0) { + *numericReply = false; + switch (parameter[1]) { + case '9': sprintf(reply, "%ld",lroundf(radToDegF(settings.pastMeridianE)*4.0F)); break; // minutes past meridianE + case 'A': sprintf(reply, "%ld",lroundf(radToDegF(settings.pastMeridianW)*4.0F)); break; // minutes past meridianW + case 'e': sprintf(reply, "%ld",lroundf(radToDegF(axis1.getLimitMin()))); break; // RA east or -Az limit, in degrees + case 'w': sprintf(reply, "%ld",lroundf(radToDegF(axis1.getLimitMax()))); break; // RA west or +Az limit, in degrees + case 'B': sprintf(reply, "%ld",lroundf(radToDegF(axis1.getLimitMax())/15.0F)); break; // RA west or +Az limit, in hours + case 'C': sprintf(reply, "%ld",lroundf(radToDegF(axis2.getLimitMin()))); break; // Dec south or -Alt limit, in degrees + case 'D': sprintf(reply, "%ld",lroundf(radToDegF(axis2.getLimitMax()))); break; // Dec north or +Alt limit, in degrees + default: return false; + } + } else return false; + } else + + if (command[0] == 'S') { + // :Sh[sDD]# + // Set the elevation lower limit + // Return: 0 on failure + // 1 on success + if (command[1] == 'h') { + int16_t deg; + if (convert.atoi2(parameter, °)) { + if (deg >= -30.0F && deg <= 30.0F) { + settings.altitude.min = degToRadF(deg); + nv().kv().put(nvKey, settings); + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + // :So[DD]# + // Set the overhead elevation limit in degrees relative to the horizon + // Return: 0 on failure + // 1 on success + if (command[1] == 'o') { + int16_t deg; + if (convert.atoi2(parameter, °)) { + if (deg >= 60.0F && deg <= 90.0F) { + settings.altitude.max = degToRadF(deg); + nv().kv().put(nvKey, settings); + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + // :SXE9,[n]# + // :SXEA,[n]# + // Set meridian limit east (9) or west (A) to value [n] in minutes + // Return: 0 on failure or 1 on success + if (command[1] == 'X' && parameter[0] == 'E' && parameter[2] == ',') { + long l = atol(¶meter[3]); float degs = l/4.0; + switch (parameter[1]) { + case '9': + if (degs >= -360.0F && degs <= 360.0F) { + settings.pastMeridianE = degToRadF(degs); + nv().kv().put(nvKey, settings); + } else *commandError = CE_PARAM_RANGE; + break; + case 'A': + if (degs >= -360.0F && degs <= 360.0F) { + settings.pastMeridianW = degToRadF(degs); + nv().kv().put(nvKey, settings); + } else *commandError = CE_PARAM_RANGE; + break; + default: return false; + } + } else return false; + } else return false; + + return true; +} + +#endif \ No newline at end of file diff --git a/src/telescope/mount/limits/Limits.cpp b/src/telescope/mount/limits/Limits.cpp new file mode 100755 index 0000000..73dbde8 --- /dev/null +++ b/src/telescope/mount/limits/Limits.cpp @@ -0,0 +1,504 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, limits + +#include "Limits.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../../../telescope/Telescope.h" +#include "../Mount.h" +#include "../goto/Goto.h" +#include "../guide/Guide.h" +#include "../site/Site.h" + +inline void limitsWrapper() { limits.poll(); } + +void Limits::init() { + + nvKey = nv().kv().computeKey("LIMIT_SETTINGS"); + if (!nv().kv().getOrInit(nvKey, settings)) { DLF("WRN: Nv, init failed for LIMIT_SETTINGS"); } + + settings.altitude.min = constrain(settings.altitude.min, degToRadF(-30), degToRadF(30)); + settings.altitude.max = constrain(settings.altitude.max, degToRadF(60), degToRadF(90)); + settings.pastMeridianE = constrain(settings.pastMeridianE, degToRadF(-360), degToRadF(360)); + settings.pastMeridianW = constrain(settings.pastMeridianW, degToRadF(-360), degToRadF(360)); + + // start limit monitor task + VF("MSG: Mount, start limits monitor task (rate 100ms priority 2)... "); + if (tasks.add(100, 0, true, 2, limitsWrapper, "MtLimit")) { VLF("success"); } else { VLF("FAILED!"); } +} + +// target coordinate check ahead of sync, goto, etc. +CommandError Limits::validateTarget(Coordinate *coords, bool isGoto) { + bool eastReachable, westReachable; + double eastCorrection, westCorrection; + return validateTarget(coords, &eastReachable, &westReachable, &eastCorrection, &westCorrection, isGoto); +} + +CommandError Limits::validateInstrumentCoordinate(uint8_t axisNumber, double value, bool bypass) { + if (bypass) return CE_NONE; + if (!limitsEnabled) return CE_NONE; + + #if AXIS1_WRAP == ON + return CE_NONE; + #else + #if AXIS1_SECTOR_GEAR == ON || AXIS2_TANGENT_ARM == ON + return CE_NONE; + #endif + + double delta; + long proposedIndexSteps; + long nominalIndexSteps; + + switch (axisNumber) { + case 1: + if (AXIS1_LIMIT_SYNC == OFF) return CE_NONE; + proposedIndexSteps = lround(value*axis1.getStepsPerMeasure()) - (axis1.getInstrumentCoordinateSteps() - axis1.getIndexPositionSteps()); + nominalIndexSteps = mount.getNominalIndexPositionSteps(1); + delta = fabs((double)(proposedIndexSteps - nominalIndexSteps))/axis1.getStepsPerMeasure(); + if (delta > degToRadF((float)AXIS1_LIMIT_SYNC)) { + VLF("MSG: Mount, sync axis1 rejected (exceeds threshold)"); + return CE_SLEW_ERR_OUTSIDE_LIMITS; + } + break; + case 2: + if (AXIS2_LIMIT_SYNC == OFF) return CE_NONE; + proposedIndexSteps = lround(value*axis2.getStepsPerMeasure()) - (axis2.getInstrumentCoordinateSteps() - axis2.getIndexPositionSteps()); + nominalIndexSteps = mount.getNominalIndexPositionSteps(2); + delta = fabs((double)(proposedIndexSteps - nominalIndexSteps))/axis2.getStepsPerMeasure(); + if (delta > degToRadF((float)AXIS2_LIMIT_SYNC)) { + VLF("MSG: Mount, sync axis2 rejected (exceeds threshold)"); + return CE_SLEW_ERR_OUTSIDE_LIMITS; + } + break; + default: + return CE_PARAM_RANGE; + } + + return CE_NONE; + #endif +} + +CommandError Limits::setInstrumentCoordinate(uint8_t axisNumber, double value, bool bypass) { + CommandError e = validateInstrumentCoordinate(axisNumber, value, bypass); + if (e != CE_NONE) return e; + + switch (axisNumber) { + case 1: + axis1.setInstrumentCoordinate(value); + break; + case 2: + axis2.setInstrumentCoordinate(value); + break; + default: + return CE_PARAM_RANGE; + } + + return CE_NONE; +} + +// target coordinate check ahead of sync, goto, etc. +CommandError Limits::validateTarget(Coordinate *coords, bool *eastReachable, bool *westReachable, double *eastCorrection, double *westCorrection, bool isGoto) { + if (flt(coords->a, settings.altitude.min)) return CE_SLEW_ERR_BELOW_HORIZON; + if (fgt(coords->a, settings.altitude.max)) return CE_SLEW_ERR_ABOVE_OVERHEAD; + + double a1e, a2e, a1w, a2w; + + PierSide lastPierSide = coords->pierSide; + coords->pierSide = PIER_SIDE_EAST; + transform.mountToInstrument(coords, &a1e, &a2e); + coords->pierSide = PIER_SIDE_WEST; + transform.mountToInstrument(coords, &a1w, &a2w); + coords->pierSide = lastPierSide; + + float eastLimitMin = axis1.getLimitMin(); + float eastLimitMax = axis1.getLimitMax(); + float westLimitMin = axis1.getLimitMin(); + float westLimitMax = axis1.getLimitMax(); + + if (AXIS1_SECTOR_GEAR == ON) { + if (isGoto) { + *eastReachable = true; + *westReachable = true; + return CE_NONE; + } else { + eastLimitMin = -Deg180; + eastLimitMax = Deg180; + westLimitMin = -Deg180; + westLimitMax = Deg180; + } + } + + if (transform.mountType == GEM) { + if (-limits.settings.pastMeridianE > eastLimitMin) eastLimitMin = -limits.settings.pastMeridianE; + if (limits.settings.pastMeridianW < westLimitMax) westLimitMax = limits.settings.pastMeridianW; + westLimitMin += Deg180; + westLimitMax += Deg180; + } + + double a1 = axis1.getInstrumentCoordinate(); + + bool inRange; + if ((a1e >= eastLimitMin) && (a1e <= eastLimitMax)) inRange = true; else inRange = false; + + if ((a1e + Deg360 > eastLimitMin) && (a1e + Deg360 < eastLimitMax) && inRange && (dist(a1, a1e) > dist(a1, a1e + Deg360))) { + a1e += Deg360; + *eastCorrection = Deg360; + VF("MSG: Mount, validate destination east axis1 best normalized to "); VL(radToDeg(a1e)); + } else + if ((a1e - Deg360 > eastLimitMin) && (a1e - Deg360 < eastLimitMax) && inRange && (dist(a1, a1e) > dist(a1, a1e - Deg360))) { + a1e -= Deg360; + *eastCorrection = -Deg360; + VF("MSG: Mount, validate destination east axis1 best normalized to "); VL(radToDeg(a1e)); + } + + if ((a1e + Deg360 > eastLimitMin) && (a1e + Deg360 < eastLimitMax) && !inRange) { + a1e += Deg360; + *eastCorrection = Deg360; + VF("MSG: Mount, validate destination east axis1 normalized to "); VL(radToDeg(a1e)); + } else + if ((a1e - Deg360 > eastLimitMin) && (a1e - Deg360 < eastLimitMax) && !inRange) { + a1e -= Deg360; + *eastCorrection = -Deg360; + VF("MSG: Mount, validate destination east axis1 normalized to "); VL(radToDeg(a1e)); + } + + if ((a1w >= westLimitMin) && (a1w <= westLimitMax)) inRange = true; else inRange = false; + + if ((a1w + Deg360 > westLimitMin) && (a1w + Deg360 < westLimitMax) && inRange && (dist(a1, a1w) > dist(a1, a1w + Deg360))) { + a1w += Deg360; + *westCorrection = Deg360; + VF("MSG: Mount, validate destination best west axis1 normalized to "); VL(radToDeg(a1w)); + } else + if ((a1w - Deg360 > westLimitMin) && (a1w - Deg360 < westLimitMax) && inRange && (dist(a1, a1w) > dist(a1, a1w - Deg360))) { + a1w -= Deg360; + *westCorrection = -Deg360; + VF("MSG: Mount, validate destination best west axis1 normalized to "); VL(radToDeg(a1w)); + } + + if ((a1w + Deg360 > westLimitMin) && (a1w + Deg360 < westLimitMax) && !inRange) { + a1w += Deg360; + *westCorrection = Deg360; + VF("MSG: Mount, validate destination west axis1 normalized to "); VL(radToDeg(a1w)); + } else + if ((a1w - Deg360 > westLimitMin) && (a1w - Deg360 < westLimitMax) && !inRange) { + a1w -= Deg360; + *westCorrection = -Deg360; + VF("MSG: Mount, validate destination west axis1 normalized to "); VL(radToDeg(a1w)); + } + + *eastReachable = a1e >= eastLimitMin && a1e <= eastLimitMax; + *westReachable = a1w >= westLimitMin && a1w <= westLimitMax; + + VF("MSG: Mount, validate east target axis1 "); V(radToDeg(eastLimitMin)); VF(" < "); V(radToDeg(a1e)); VF(" < "); V(radToDeg(eastLimitMax)); + if (*eastReachable) { VLF(" TRUE"); } else { VLF(" FALSE"); } + VF("MSG: Mount, validate west target axis1 "); V(radToDeg(westLimitMin)); VF(" < "); V(radToDeg(a1w)); VF(" < "); V(radToDeg(westLimitMax)); + if (*westReachable) { VLF(" TRUE"); } else { VLF(" FALSE"); } + + if (!*eastReachable && !*westReachable) { + VLF("MSG: Mount, validate target outside limits"); + *eastCorrection = 0.0; + *westCorrection = 0.0; + return CE_SLEW_ERR_OUTSIDE_LIMITS; + } + + #if AXIS2_TANGENT_ARM == OFF + if (transform.isEquatorial()) { + if (flt(coords->d, axis2.getLimitMin())) { + VF("MSG: Mount, validate failed Dec past min limit by "); + V(radToDeg(coords->d - axis2.getLimitMin())*3600.0); VLF(" arc-secs"); + return CE_SLEW_ERR_OUTSIDE_LIMITS; + } + if (fgt(coords->d, axis2.getLimitMax())) { + VF("MSG: Mount, validate failed Dec past max limit by "); + V(radToDeg(coords->d - axis2.getLimitMax())*3600.0); VLF(" arc-secs"); + return CE_SLEW_ERR_OUTSIDE_LIMITS; + } + } + #endif + + return CE_NONE; +} + +// true if an error exists +bool Limits::isError() { + return initError.nv || + initError.value || + initError.tls || + error.altitude.min || + error.altitude.max || + error.limit.axis1.min || + error.limit.axis1.max || + error.limit.axis2.min || + error.limit.axis2.max || + error.limitSense.axis1.min || + error.limitSense.axis1.max || + error.limitSense.axis2.min || + error.limitSense.axis2.max || + error.meridian.east || + error.meridian.west; +} + +// true if an error exists that impacts goto safety +bool Limits::isGotoError() { + return initError.nv || + initError.value || + !site.dateIsReady || + !site.timeIsReady || + error.limitSense.axis1.min || + error.limitSense.axis1.max || + error.limitSense.axis2.min || + error.limitSense.axis2.max; +} + +// return general error code +uint8_t Limits::errorCode() { + enum GeneralErrors: uint8_t { + ERR_NONE, ERR_MOTOR_FAULT, ERR_ALT_MIN, ERR_LIMIT_SENSE, ERR_DEC, ERR_AZM, + ERR_UNDER_POLE, ERR_MERIDIAN, ERR_SYNC, ERR_PARK, ERR_GOTO_SYNC, ERR_UNSPECIFIED, + ERR_ALT_MAX, ERR_WEATHER_INIT, ERR_SITE_INIT, ERR_NV_INIT}; + + // priority highest to lowest + if (mount.motorFault()) return (uint8_t)ERR_MOTOR_FAULT; + if (error.limitSense.axis1.min || error.limitSense.axis1.max || + error.limitSense.axis2.min || error.limitSense.axis2.max) return (uint8_t)ERR_LIMIT_SENSE; + if (error.altitude.min) return (uint8_t)ERR_ALT_MIN; + if (error.altitude.max) return (uint8_t)ERR_ALT_MAX; + if (transform.isEquatorial()) { + if (error.limit.axis1.min || error.limit.axis1.max) return (uint8_t)ERR_UNDER_POLE; + if (error.limit.axis2.min || error.limit.axis2.max) return (uint8_t)ERR_DEC; + } else { + if (error.limit.axis1.min || error.limit.axis1.max) return (uint8_t)ERR_AZM; + if (error.limit.axis2.min) return (uint8_t)ERR_ALT_MIN; + if (error.limit.axis2.max) return (uint8_t)ERR_ALT_MAX; + } + if (error.meridian.east || error.meridian.west) return (uint8_t)ERR_MERIDIAN; + if (initError.nv || initError.value) return (uint8_t)ERR_NV_INIT; + if (initError.tls) return (uint8_t)ERR_SITE_INIT; + if (initError.weather) return (uint8_t)ERR_WEATHER_INIT; + return ERR_NONE; +} + +void Limits::stop() { + #if GOTO_FEATURE == ON + goTo.abort(); + #endif + guide.stopAxis1(GA_BREAK, true); + guide.stopAxis2(GA_BREAK, true); + mount.tracking(false); +} + +void Limits::stopAxis1(GuideAction stopDirection) { + #if GOTO_FEATURE == ON + goTo.abort(); + #endif + guide.stopAxis1(stopDirection, true); + if (stopDirection == GA_FORWARD || !transform.isEquatorial()) mount.tracking(false); +} + +void Limits::stopAxis2(GuideAction stopDirection) { + #if GOTO_FEATURE == ON + goTo.abort(); + #endif + guide.stopAxis2(stopDirection, true); + if (!transform.isEquatorial()) mount.tracking(false); +} + +void Limits::poll() { + if (limitsDisablePeriodDs > 0) limitsDisablePeriodDs--; + + LimitsError lastError = error; + + Coordinate current = mount.getMountPosition(CR_MOUNT_ALT); + + #if TRACK_AUTOSTART == OFF && TRACK_WITHOUT_LIMITS == OFF + if (!limitsEnabled && mount.isTracking()) { + VLF("MSG: Mount, tracking without limits disallowed"); + mount.tracking(false); + } + #endif + + if (limitsEnabled && guide.state != GU_HOME_GUIDE && guide.state != GU_HOME_GUIDE_ABORT) { + // overhead and horizon limits + if (current.a < settings.altitude.min && limitsDisablePeriodDs == 0) error.altitude.min = true; else error.altitude.min = false; + + if (fabs(settings.altitude.max - Deg90) > OneArcSec) { + if (current.a > settings.altitude.max) error.altitude.max = true; else error.altitude.max = false; + } else error.altitude.max = false; + + // meridian limits + if (transform.mountType == GEM && current.pierSide == PIER_SIDE_EAST) { + if (current.h < -settings.pastMeridianE) { + stopAxis1(GA_REVERSE); + error.meridian.east = true; + } else error.meridian.east = false; + } else error.meridian.east = false; + + if (transform.mountType == GEM && current.pierSide == PIER_SIDE_WEST) { + if (current.h > settings.pastMeridianW && limitsDisablePeriodDs == 0) { + #if GOTO_FEATURE == ON && AXIS1_SECTOR_GEAR == OFF && AXIS2_TANGENT_ARM == OFF + if (goTo.isAutoFlipEnabled() && mount.isTracking()) { + limitsDisablePeriod(1.0F); + VLF("MSG: Mount, start automatic meridian flip"); + Coordinate target = mount.getMountPosition(); + CommandError e = goTo.request(target, PSS_EAST_ONLY, false); + if (e != CE_NONE) { + stopAxis1(GA_FORWARD); + error.meridian.west = true; + DF("WRN: Limits::limitPoll(), goto for automatic meridian flip failed ("); D(e); DL(")"); + } + } else + #endif + { + stopAxis1(GA_FORWARD); + error.meridian.west = true; + } + } else error.meridian.west = false; + } else error.meridian.west = false; + + // for Fork and Alt/Azm mounts limits are based on shaft angles + // so convert axis1 into normal PIER_SIDE_EAST coordinates + if (transform.mountType != GEM && current.pierSide == PIER_SIDE_WEST) current.a1 += Deg180; + + if (mount.isHome()) current.a1 = home.getPosition(CR_MOUNT).a1; + + #if AXIS1_SECTOR_GEAR == ON + current.a1 = axis1.getMotorPosition(); + #endif + + // min and max limits + if (flt(current.a1, axis1.getLimitMin())) { + stopAxis1(GA_REVERSE); + error.limit.axis1.min = true; + // --------------------------------------------------------- + if (lastError.limit.axis1.min != error.limit.axis1.min) { + D("WRN: Mount, limits min axis1 "); D(radToDeg(current.a1)); D(" > "); D(radToDeg(axis1.getLimitMin())); + D(" ("); D(current.pierSide == PIER_SIDE_WEST ? "W" : "E"); D(")"); + DLF(" FAILED"); + V("MSG: Mount, axis1 = "); VL(degToRad(axis1.getInstrumentCoordinate())); + } + // --------------------------------------------------------- + } else error.limit.axis1.min = false; + + if (fgt(current.a1, axis1.getLimitMax()) && limitsDisablePeriodDs == 0) { + #if GOTO_FEATURE == ON && AXIS1_SECTOR_GEAR == OFF && AXIS2_TANGENT_ARM == OFF + if (current.pierSide == PIER_SIDE_EAST && goTo.isAutoFlipEnabled() && mount.isTracking()) { + limitsDisablePeriod(1.0F); + VLF("MSG: Mount, start automatic meridian flip"); + Coordinate target = mount.getMountPosition(); + CommandError e = goTo.request(target, PSS_WEST_ONLY, false); + if (e != CE_NONE) { + stopAxis1(GA_FORWARD); + error.limit.axis1.max = true; + DF("WRN: Limits::limitPoll(), goto for automatic meridian flip failed ("); D(e); DL(")"); + } + } else + #endif + { + stopAxis1(GA_FORWARD); + error.limit.axis1.max = true; + // ------------------------------------------------------------- + if (lastError.limit.axis1.max != error.limit.axis1.max) { + D("WRN: Mount, limits max axis1 "); D(radToDeg(current.a1)); D(" < "); D(radToDeg(axis1.getLimitMax())); + DLF(" FAILED"); + } + // ------------------------------------------------------------- + } + } else error.limit.axis1.max = false; + + if (mount.isHome()) current.a2 = home.getPosition(CR_MOUNT).a2; + + #if AXIS2_TANGENT_ARM == ON + current.a2 = axis2.getMotorPosition(); + #endif + + if (flt(current.a2, axis2.getLimitMin())) { + stopAxis2((current.pierSide == PIER_SIDE_EAST) ? GA_REVERSE : GA_FORWARD); + error.limit.axis2.min = true; + } else error.limit.axis2.min = false; + + if (fgt(current.a2, axis2.getLimitMax())) { + stopAxis2((current.pierSide == PIER_SIDE_EAST) ? GA_FORWARD : GA_REVERSE); + error.limit.axis2.max = true; + } else error.limit.axis2.max = false; + + } else { + error.altitude.min = false; + error.altitude.max = false; + error.limit.axis1.min = false; + error.limit.axis1.max = false; + error.limit.axis2.min = false; + error.limit.axis2.max = false; + error.meridian.east = false; + error.meridian.west = false; + } + + // min and max limit switches + error.limitSense.axis1.min = axis1.motionErrorSensed(DIR_REVERSE); + if (error.limitSense.axis1.min) { + if (!axis1.commonMinMaxSense || lastError.limitSense.axis1.min != error.limitSense.axis1.min) stopAxis1(GA_REVERSE); + } + + error.limitSense.axis1.max = axis1.motionErrorSensed(DIR_FORWARD); + if (error.limitSense.axis1.max) { + if (!axis1.commonMinMaxSense || lastError.limitSense.axis1.max != error.limitSense.axis1.max) stopAxis1(GA_FORWARD); + } + + error.limitSense.axis2.min = axis2.motionErrorSensed(DIR_REVERSE); + if (error.limitSense.axis2.min) { + if (!axis2.commonMinMaxSense || lastError.limitSense.axis2.min != error.limitSense.axis2.min) + stopAxis2((current.pierSide == PIER_SIDE_EAST) ? GA_REVERSE : GA_FORWARD); + } + + error.limitSense.axis2.max = axis2.motionErrorSensed(DIR_FORWARD); + if (error.limitSense.axis2.max) { + if (!axis2.commonMinMaxSense || lastError.limitSense.axis2.max != error.limitSense.axis2.max) + stopAxis2((current.pierSide == PIER_SIDE_EAST) ? GA_FORWARD : GA_REVERSE); + } + + #if DEBUG == VERBOSE + const char* errPre = "MSG: Mount, limit state: "; + if (lastError.altitude.min != error.altitude.min || + lastError.altitude.max != error.altitude.max || + lastError.meridian.east != error.meridian.east || + lastError.meridian.west != error.meridian.west || + lastError.limit.axis1.min != error.limit.axis1.min || + lastError.limit.axis1.max != error.limit.axis1.max || + lastError.limit.axis2.min != error.limit.axis2.min || + lastError.limit.axis2.max != error.limit.axis2.max) { + V(errPre); + V(error.altitude.min? "Alt-< " :"Alt- "); + V(error.altitude.max? "Alt+< " :"Alt+ "); + V(error.meridian.east? "ME< " :"ME " ); + V(error.meridian.west? "MW< " :"MW " ); + V(error.limit.axis1.min? "A1L-< " :"A1L- "); + V(error.limit.axis1.max? "A1L+< " :"A1L+ "); + V(error.limit.axis2.min? "A2L-< " :"A2L- "); + V(error.limit.axis2.max? "A2L+< " :"A2L+ "); + } + #endif + + // respond to overhead and horizon limits + if (transform.mountType == ALTAZM) { + if (error.altitude.min) stopAxis2(GA_REVERSE); + if (error.altitude.max) stopAxis2(GA_FORWARD); + } else { + if (!lastError.altitude.min && error.altitude.min) stop(); + if (!lastError.altitude.max && error.altitude.max) stop(); + } + + // if first time breaking a meridian or min/max limit stop all guides + if ((!lastError.meridian.east && error.meridian.east) || + (!lastError.meridian.west && error.meridian.west) || + (!lastError.limit.axis1.min && error.limit.axis1.min) || + (!lastError.limit.axis1.max && error.limit.axis1.max) || + (!lastError.limit.axis2.min && error.limit.axis2.min) || + (!lastError.limit.axis2.max && error.limit.axis2.max)) stop(); +} + +Limits limits; + +#endif diff --git a/src/telescope/mount/limits/Limits.h b/src/telescope/mount/limits/Limits.h new file mode 100755 index 0000000..eed9fbc --- /dev/null +++ b/src/telescope/mount/limits/Limits.h @@ -0,0 +1,126 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control +#pragma once + +#include "../../../Common.h" + +#ifdef MOUNT_PRESENT + +#include "../guide/Guide.h" + +// Limit defaults +#ifndef LIMIT_HORIZON +#define LIMIT_HORIZON -10.0F +#endif +#ifndef LIMIT_OVERHEAD +#define LIMIT_OVERHEAD 80.0F +#endif +#ifndef LIMIT_MERIDIAN_EAST +#define LIMIT_MERIDIAN_EAST 15.0F +#endif +#ifndef LIMIT_MERIDIAN_WEST +#define LIMIT_MERIDIAN_WEST 15.0F +#endif + +#pragma pack(1) +typedef struct AltitudeLimits { + float min; // in radians + float max; // in radians +} AltitudeLimits; + +#define LimitSettingsSize 16 +typedef struct LimitSettings { + AltitudeLimits altitude; + float pastMeridianE; // in radians + float pastMeridianW; // in radians +} LimitSettings; +#pragma pack() + +typedef struct MerdianError { + uint8_t east; + uint8_t west; +} MerdianError; + +typedef struct MinMaxError { + uint8_t min; + uint8_t max; +} MinMaxError; + +typedef struct AxisMinMaxError { + MinMaxError axis1; + MinMaxError axis2; +} AxisMinMaxError; + +typedef struct LimitsError { + MinMaxError altitude; + AxisMinMaxError limit; + AxisMinMaxError limitSense; + MerdianError meridian; +} LimitsError; + +class Limits { + public: + void init(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // target coordinate check ahead of sync, goto, etc. + CommandError validateTarget(Coordinate *coords, bool isGoto); + CommandError validateTarget(Coordinate *coords, bool *eastReachable, bool *westReachable, double *eastCorrection, double *westCorrection, bool isGoto); + + // validate and apply an instrument coordinate change for a mount axis + CommandError validateInstrumentCoordinate(uint8_t axisNumber, double value, bool bypass = false); + CommandError setInstrumentCoordinate(uint8_t axisNumber, double value, bool bypass = false); + + // true if an limit related error is exists + bool isError(); + + // true if an error exists that impacts goto safety + bool isGotoError(); + + // true if an below horizon limit + inline bool isBelowHorizon() { return error.altitude.min; } + + // true if an above overhead limit + inline bool isAboveOverhead() { return error.altitude.max; } + + // true if past meridian limit west + inline bool isPastMeridianW() { return error.meridian.west; } + + // true if past the axis1 max limit + inline bool isPastAxis1Max() { return error.limit.axis1.max; } + + // return general error code + uint8_t errorCode(); + + // enable or disable limit enforcement + inline void enabled(bool state) { limitsEnabled = state; } + + // check if limits are being enforced + inline bool isEnabled() { return limitsEnabled; } + + // disable meridian limits for the specified period in seconds + void limitsDisablePeriod(float seconds) { limitsDisablePeriodDs = lroundf(seconds*10.0F); } + + void poll(); + + LimitSettings settings = { { degToRadF(LIMIT_HORIZON), degToRadF(LIMIT_OVERHEAD) }, degToRadF(LIMIT_MERIDIAN_EAST), degToRadF(LIMIT_MERIDIAN_WEST) }; + + private: + void stop(); + void stopAxis1(GuideAction stopDirection = GA_BREAK); + void stopAxis2(GuideAction stopDirection = GA_BREAK); + // get least distance between coordinates + inline double dist(double a, double b) { if (a > b) return a - b; else return b - a; } + + bool limitsEnabled = false; + LimitsError error; + + int limitsDisablePeriodDs = 0; // in deciseconds (0.1s) + + uint32_t nvKey; +}; + +extern Limits limits; + +#endif diff --git a/src/telescope/mount/park/Park.command.cpp b/src/telescope/mount/park/Park.command.cpp new file mode 100755 index 0000000..efd97bc --- /dev/null +++ b/src/telescope/mount/park/Park.command.cpp @@ -0,0 +1,37 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, park commands + +#include "Park.h" + +#if defined(MOUNT_PRESENT) + +bool Park::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + UNUSED(reply); + UNUSED(suppressFrame); + UNUSED(numericReply); + if (command[0] == 'h') { + // :hP# Moves mount to the park position + // Return: 0 on failure + // 1 on success + if (command[1] == 'P' && parameter[0] == 0) { + CommandError e = request(); + if (e == CE_NONE) *commandError = CE_1; else { VF("MSG: Mount, park error "); VL(e); *commandError = e; } + } else + + // :hQ# Set the mount park position + // Return: 0 on failure + // 1 on success + if (command[1] == 'Q' && parameter[0] == 0) *commandError = set(); else + + // :hR# Restore parked mount to operation + // Return: 0 on failure + // 1 on success + if (command[1] == 'R' && parameter[0] == 0) { + CommandError e = restore(true); + if (e == CE_NONE) *commandError = CE_1; else { VF("MSG: Mount, unpark error "); VL(e); *commandError = e; } + } else return false; + } else return false; + + return true; +} +#endif diff --git a/src/telescope/mount/park/Park.cpp b/src/telescope/mount/park/Park.cpp new file mode 100755 index 0000000..81f06af --- /dev/null +++ b/src/telescope/mount/park/Park.cpp @@ -0,0 +1,323 @@ +// ----------------------------------------------------------------------------------- +// telescope mount control, parking + +#include "Park.h" + +#if defined(MOUNT_PRESENT) + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../../Telescope.h" +#include "../Mount.h" +#include "../goto/Goto.h" +#include "../guide/Guide.h" +#include "../home/Home.h" +#include "../limits/Limits.h" +#include "../../../lib/sense/Sense.h" + +void parkSignalWrapper() { park.signal(); } + +void Park::init() { + nvKey = nv().kv().computeKey("PARK_SETTINGS"); + if (!nv().kv().getOrInit(nvKey, settings)) { DLF("WRN: Nv, init failed for PARK_SETTINGS"); } + state = settings.state; + if (!settings.saved) set(true); + + // configure any associated sense/signal pins + #if (PARK_SENSE) != OFF && (PARK_SENSE_PIN) != OFF + VLF("MSG: Mount, park adding sense"); + parkSenseHandle = sense.add(PARK_SENSE_PIN, PARK_SENSE_INIT, PARK_SENSE); + #endif + + #if (PARK_SIGNAL) != OFF && (PARK_SIGNAL_PIN) != OFF + VLF("MSG: Mount, park adding signal"); + parkSignalHandle = sense.add(PARK_SIGNAL_PIN, PARK_SIGNAL_INIT, PARK_SIGNAL); + + VF("MSG: Mount, start park signal monitor task (rate 1000ms priority 4)... "); + if (tasks.add(1000, 0, true, 4, parkSignalWrapper, "ParkSgl")) { VLF("success"); } else { VLF("FAILED!"); } + #endif +} + +// sets the park position +CommandError Park::set(bool ignoreTrust) { + if (state == PS_PARK_FAILED) return CE_PARK_FAILED; + if (state == PS_PARKED) return CE_PARKED; + if (goTo.state != GS_NONE) return CE_SLEW_IN_MOTION; + if (guide.state != GU_NONE) return CE_SLEW_IN_MOTION; + if (mount.motorFault()) return CE_SLEW_ERR_HARDWARE_FAULT; + if (!ignoreTrust && !mount.startupAuthorityTrusted()) { + DLF("WRN: Mount, set park rejected because startup authority is not trusted"); + return CE_SLEW_ERR_UNSPECIFIED; + } + + VLF("MSG: Mount, setting park position"); + + bool wasTracking = mount.isTracking(); + mount.tracking(false); + + // get our current position in equatorial coordinates + Coordinate current = mount.getPosition(CR_MOUNT_EQU); + + // save as the park position + settings.state = state; + settings.position.h = current.h; + settings.position.d = current.d; + settings.position.pierSide = current.pierSide; + if (settings.position.pierSide == PIER_SIDE_NONE) { + if (transform.meridianFlips) { + if (current.h < 0) settings.position.pierSide = PIER_SIDE_WEST; else settings.position.pierSide = PIER_SIDE_EAST; + } else settings.position.pierSide = PIER_SIDE_EAST; + } + settings.saved = true; + nv().kv().put(nvKey, settings); + + #if ALIGN_MAX_NUM_STARS > 1 + transform.align.modelWrite(); + #endif + + mount.tracking(wasTracking); + + VLF("MSG: Mount, setting park done"); + return CE_NONE; +} + +// move the mount to the park position +CommandError Park::request() { + if (!settings.saved) return CE_NO_PARK_POSITION_SET; + if (state == PS_PARKED) return CE_NONE; + if (state == PS_PARKING) return CE_PARK_FAILED; + if (state == PS_PARK_FAILED) return CE_PARK_FAILED; + if (!mount.startupAuthorityTrusted()) { + DLF("WRN: Mount, park rejected because startup authority is not trusted"); + return CE_SLEW_ERR_UNSPECIFIED; + } + if (!mount.isEnabled()) return CE_SLEW_ERR_IN_STANDBY; + if (goTo.state != GS_NONE) return CE_SLEW_IN_MOTION; + if (guide.state != GU_NONE) return CE_SLEW_IN_MOTION; + if (mount.motorFault()) return CE_SLEW_ERR_HARDWARE_FAULT; + + CommandError e = goTo.validate(); + if (e != CE_NONE) return e; + + // stop tracking + wasTracking = mount.isTracking(); + mount.tracking(false); + mount.enable(true); + goTo.firstGoto = false; + + #if AXIS1_PEC == ON + // turn off PEC while we park + pecDisable(); + pec.state = PEC_NONE; + settings.wormSensePositionSteps = wormSenseSteps; + #endif + + // record our park status + ParkState priorParkState = state; + + // update state to parking + state = PS_PARKING; + settings.state = state; + nv().kv().put(nvKey, settings); + + // get the park coordinate ready + axis1.setBacklash(0.0L); + axis2.setBacklash(0.0L); + Coordinate parkTarget; + parkTarget.h = settings.position.h; + parkTarget.d = settings.position.d; + parkTarget.pierSide = settings.position.pierSide; + if (transform.mountType == ALTAZM) transform.equToHor(&parkTarget); else + if (transform.mountType == ALTALT) transform.equToAa(&parkTarget); + + // goto the park (mount) target coordinate + VLF("MSG: Mount, parking"); + if (parkTarget.pierSide == PIER_SIDE_EAST) e = goTo.request(parkTarget, PSS_EAST_ONLY, false); else + if (parkTarget.pierSide == PIER_SIDE_WEST) e = goTo.request(parkTarget, PSS_WEST_ONLY, false); + + if (e != CE_NONE) { + mount.tracking(wasTracking); + axis1.setBacklash(mount.settings.backlash.axis1); + axis2.setBacklash(mount.settings.backlash.axis2); + + state = priorParkState; + settings.state = state; + nv().kv().put(nvKey, settings); + + VF(": Mount::parkGoto(), Failed to start goto (CE "); V(e); VL(")"); + return e; + } + return CE_NONE; +} + +// clear park state on abort +void Park::requestAborted() { + state = PS_UNPARKED; + settings.state = state; + nv().kv().put(nvKey, settings); + + // restore backlash settings + axis1.setBacklash(mount.settings.backlash.axis1); + axis2.setBacklash(mount.settings.backlash.axis2); + + mount.tracking(wasTracking); +} + +// once parked save the park state +void Park::requestDone() { + + #if (PARK_SENSE) != OFF && (PARK_SENSE_PIN) != OFF + if (sense.isOn(parkSenseHandle)) { + VLF("MSG: Mount, park sense state indicates success."); + } else { + DLF("WRN: Mount, park sense state failed!"); + axis1.setBacklash(mount.settings.backlash.axis1); + axis2.setBacklash(mount.settings.backlash.axis2); + state = PS_PARK_FAILED; + settings.state = state; + nv().kv().put(nvKey, settings); + } + #endif + + if (state != PS_PARK_FAILED) { + #if DEBUG == VERBOSE + long index = axis1.getInstrumentCoordinateSteps() - axis1.getMotorPositionSteps(); + VF("MSG: Mount, park axis1 motor target "); VL(axis1.getTargetCoordinateSteps() - index); + VF("MSG: Mount, park axis1 motor position "); VL(axis1.getMotorPositionSteps()); + index = axis2.getInstrumentCoordinateSteps() - axis2.getMotorPositionSteps(); + VF("MSG: Mount, park axis2 motor target "); VL(axis2.getTargetCoordinateSteps() - index); + VF("MSG: Mount, park axis2 motor position "); VL(axis2.getMotorPositionSteps()); + #endif + + // save the axis state + state = PS_PARKED; + settings.state = state; + nv().kv().put(nvKey, settings); + + #if ALIGN_MAX_NUM_STARS > 1 + transform.align.modelWrite(); + #endif + + VLF("MSG: Mount, parking done"); + } else { DLF("ERR: Mount::parkFinish(), Parking failed"); } + + mount.enable(MOUNT_ENABLE_IN_STANDBY == ON); +} + +// returns a parked telescope to operation +CommandError Park::restore(bool withTrackingOn) { + if (!settings.saved) return CE_NO_PARK_POSITION_SET; + if (!mount.startupAuthorityTrusted()) { + DLF("WRN: Mount, unpark rejected because startup authority is not trusted"); + return CE_SLEW_ERR_UNSPECIFIED; + } + if (state != PS_PARKED) { + #if MOUNT_STARTUP_MODE == SA_STRICT || MOUNT_COORDS_MEMORY == ON + VLF("MSG: Mount, unpark from home disabled by startup authority policy"); + return CE_NOT_PARKED; + #else + if (goTo.absoluteEncodersPresent) { + VLF("MSG: Mount, unpark from home disabled when absolute position sources are present"); + return CE_NOT_PARKED; + } + if (!mount.isHome()) { + VLF("MSG: Mount, unpark when not parked allowed at home only"); + return CE_NOT_PARKED; + } + #endif + } + if (!site.isDateTimeReady()) { + VLF("MSG: Mount, unpark postponed no date/time"); + return CE_PARKED; + } + if (mount.motorFault()) return CE_SLEW_ERR_HARDWARE_FAULT; + + if (withTrackingOn) { + VLF("MSG: Mount, unparking"); + } else { + VLF("MSG: Mount, recovering unpark position"); + } + + #if AXIS1_PEC == ON + wormSenseSteps = settings.wormSensePositionSteps; + #endif + + if (!goTo.absoluteEncodersPresent) { + + // reset the mount, zero backlash + CommandError e = home.reset(); + if (e != CE_NONE) { + DF("WRN: Mount, unpark reset failed (code "); D(e); DLF(")"); + return e; + } + axis1.setBacklashSteps(0); + axis2.setBacklashSteps(0); + + // load the pointing model + #if ALIGN_MAX_NUM_STARS > 1 + transform.align.modelRead(); + #endif + + // get the park coordinate ready + Coordinate parkTarget; + parkTarget.h = settings.position.h; + parkTarget.d = settings.position.d; + parkTarget.pierSide = settings.position.pierSide; + if (transform.mountType == GEM) { + if (parkTarget.pierSide == PIER_SIDE_EAST && parkTarget.h < -limits.settings.pastMeridianE) parkTarget.h += PI*2.0; + if (parkTarget.pierSide == PIER_SIDE_WEST && parkTarget.h > limits.settings.pastMeridianW) parkTarget.h -= PI*2.0; + } + + // set the mount target + double a1, a2; + if (transform.mountType == ALTAZM) transform.equToHor(&parkTarget); else + if (transform.mountType == ALTALT) transform.equToAa(&parkTarget); + + transform.mountToInstrument(&parkTarget, &a1, &a2); + axis1.setInstrumentCoordinatePark(a1); + axis2.setInstrumentCoordinatePark(a2); + mount.captureNominalIndexPositions(); + + VF("MSG: Mount, unpark axis1 motor position "); VL(axis1.getMotorPositionSteps()); + VF("MSG: Mount, unpark axis2 motor position "); VL(axis2.getMotorPositionSteps()); + + // restore backlash settings + axis1.setBacklash(mount.settings.backlash.axis1); + axis2.setBacklash(mount.settings.backlash.axis2); + } + + limits.enabled(true); + if (!goTo.absoluteEncodersPresent) mount.syncFromOnStepToEncoders = true; + + if (withTrackingOn) { + state = PS_UNPARKED; + settings.state = state; + nv().kv().put(nvKey, settings); + mount.tracking(true); + VLF("MSG: Mount, unparking done"); + } else { + VLF("MSG: Mount, recovering unpark position done"); + } + + return CE_NONE; +} + +void Park::reset() { + state = PS_UNPARKED; + settings.state = state; + nv().kv().put(nvKey, settings); +} + +// check input pin to initiate a park operation, if allowed +void Park::signal() { + #if PARK_SIGNAL != OFF && PARK_SIGNAL_PIN != OFF + if (sense.isOn(parkSignalHandle) && state == PS_UNPARKED && !mount.isSlewing() && !mount.isHome()) { + request(); + } + #endif +} + +Park park; + +#endif diff --git a/src/telescope/mount/park/Park.h b/src/telescope/mount/park/Park.h new file mode 100755 index 0000000..512447d --- /dev/null +++ b/src/telescope/mount/park/Park.h @@ -0,0 +1,69 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control +#pragma once + +#include "../../../Common.h" + +#if defined(MOUNT_PRESENT) + +#include "../../Telescope.h" +#include "../coordinates/Transform.h" + +#pragma pack(1) +typedef struct ParkPosition { + float h; + float d; + PierSide pierSide; +} ParkPosition; + +#define ParkSettingsSize 15 +typedef struct ParkSettings { + ParkPosition position; + bool saved; + ParkState state; + long wormSensePositionSteps; +} ParkSettings; +#pragma pack() + +class Park { + public: + void init(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // sets a park position + CommandError set(bool ignoreTrust = false); + + // move the mount to the park position + CommandError request(); + + // clear park state on abort + void requestAborted(); + + // once parked save the park state + void requestDone(); + + // returns a parked telescope to operation + CommandError restore(bool withTrackingOn); + + // resets park state, clears any errors but does not erase the park position + void reset(); + + // check input pin to initiate park operation + void signal(); + + ParkState state = PS_UNPARKED; + + ParkSettings settings = {{0, 0, PIER_SIDE_NONE}, false, PS_UNPARKED, 0}; + + private: + uint8_t parkSenseHandle = 0; + uint8_t parkSignalHandle = 0; + bool wasTracking = false; + + uint32_t nvKey; +}; + +extern Park park; + +#endif diff --git a/src/telescope/mount/pec/Pec.command.cpp b/src/telescope/mount/pec/Pec.command.cpp new file mode 100755 index 0000000..3084717 --- /dev/null +++ b/src/telescope/mount/pec/Pec.command.cpp @@ -0,0 +1,251 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, commands + +#include "Pec.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../site/Site.h" + +bool Pec::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + *suppressFrame = false; + *commandError = CE_NONE; + + if (command[0] == 'G' && command[1] == 'X' && parameter[2] == 0) { + #if AXIS1_PEC == ON + // :GX91# Get PEC analog value + // Returns: n# + if (parameter[0] == '9' && parameter[1] == '1') { + sprintf(reply, "%d", 0); + *numericReply = false; + } else + #endif + + // :GXE6# Get number of steps per sidereal second + // Returns: n# + if (parameter[0] == 'E' && parameter[1] == '6') { + sprintF(reply, "%0.6f", (axis1.getStepsPerMeasure()/RAD_DEG_RATIO_F)/240.0F); + *numericReply = false; + } else + + // :GXE7# Get PEC worm rotation steps (from NV) + // Returns: n# + if (parameter[0] == 'E' && parameter[1] == '7') { + PecSettings nextSettings = { false, PEC_NONE, PEC_STEPS_PER_WORM_ROTATION }; + nv().kv().get(nvKey, nextSettings); + sprintf(reply, "%ld", nextSettings.wormRotationSteps); + *numericReply = false; + } else + + // :GXE8# Get PEC buffer size in seconds + // Returns: n# + if (parameter[0] == 'E' && parameter[1] == '8') { + sprintf(reply, "%ld", bufferSize); + *numericReply = false; + } else return false; + } else + + #if AXIS1_PEC == ON + // :SXE7,[n]# + // Set PEC steps per worm rotation [n] + // Return: 0 on failure or 1 on success + if (command[0] == 'S' && command[1] == 'X' && parameter[0] == 'E' && parameter[1] == '7' && parameter[2] == ',') { + if (parameter[2] != ',') { *commandError = CE_PARAM_FORM; return true; } + long l = atol(¶meter[3]); + if (l >= 0 && l < 129600000) { + PecSettings nextSettings = settings; + nextSettings.wormRotationSteps = l; + nv().kv().put(nvKey, nextSettings); + } else *commandError = CE_PARAM_RANGE; + } else + #endif + + // V - PEC Readout + if (command[0] == 'V') { + #if AXIS1_PEC == ON + // :VH# PEC index sense position in sidereal seconds + // Returns: n# + if (command[1] == 'H' && parameter[0] == 0) { + long s = lroundf(wormSenseSteps/stepsPerSiderealSecond); + while (s > wormRotationSeconds) s -= wormRotationSeconds; + while (s < 0) s += wormRotationSeconds; + sprintf(reply, "%05ld",s); + *numericReply = false; + } else + + // :VR[n]# Read PEC table entry rate adjustment (in steps +/-) for worm segment n (in seconds) + // Returns: sn# + // :VR# Read PEC table entry rate adjustment (in steps +/-) for currently playing segment and its rate adjustment (in steps +/-) + // Returns: sn,n# + if (command[1] == 'R') { + int16_t i, j; + bool conv_result = true; + if (parameter[0] == 0) i = bufferIndex; else conv_result = convert.atoi2(parameter, &i); + if (conv_result) { + if (i >= 0 && i < bufferSize) { + if (parameter[0] == 0) { + i -= 1; + if (i < 0) i += wormRotationSeconds; + if (i >= wormRotationSeconds) i -= wormRotationSeconds; + j = buffer[i]; + sprintf(reply, "%+04i,%03i", j, i); + } else { + j = buffer[i]; + sprintf(reply, "%+04i", j); + } + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + *numericReply = false; + } else + + // :Vr[n]# Read out RA PEC ten byte frame in hex format starting at worm segment n (in seconds) + // Returns: x0x1x2x3x4x5x6x7x8x9# (hex one byte integers) + // Ten rate adjustment factors for 1s worm segments in steps +/- (steps = x0 - 128, etc.) + if (command[1] == 'r') { + int16_t i, j; + if (convert.atoi2(parameter, &i)) { + if (i >= 0 && i < bufferSize) { + j = 0; + uint8_t b; + char s[3] = " "; + for (j = 0; j < 10; j++) { + if (i + j < bufferSize) b = (int)buffer[i + j] + 128; else b = 128; + snprintf(s, sizeof(s), "%02X", b); + strcat(reply, s); + } + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + *numericReply = false; + } else + #endif + + // :VS# Get PEC number of steps per sidereal second of worm rotation + // Returns: n.n# + if (command[1] == 'S' && parameter[0] == 0) { + stepsPerSiderealSecond = (axis1.getStepsPerMeasure()/RAD_DEG_RATIO_F)/240.0F; + sprintF(reply, "%0.6f", stepsPerSiderealSecond); + *numericReply = false; + } else + + // :VW# Get pec worm rotation steps + // Returns: n# + if (command[1] == 'W' && parameter[0] == 0) { + long steps = 0; + #if AXIS1_PEC == ON + steps = settings.wormRotationSteps; + #endif + sprintf(reply, "%06ld", steps); + *numericReply = false; + } else return false; + } else + + // W - PEC Write + if (command[0] == 'W') { + #if AXIS1_PEC == ON + // :WR+# Move PEC Table ahead by one sidereal second + // Return: 0 on failure + // 1 on success + if (command[1] == 'R' && parameter[0] == '+' && parameter[1] == 0) { + int8_t i = buffer[wormRotationSeconds - 1]; + memmove(&buffer[1], &buffer[0], wormRotationSeconds - 1); + buffer[0] = i; + } else + + // :WR-# Move PEC Table back by one sidereal second + // Return: 0 on failure + // 1 on success + if (command[1] == 'R' && parameter[0] == '-' && parameter[1] == 0) { + int8_t i = buffer[0]; + memmove(&buffer[0], &buffer[1], wormRotationSeconds - 1); + buffer[wormRotationSeconds - 1] = i; + } else + + // :WR[n,sn]# Write PEC table entry for worm segment [n] (in sidereal seconds) + // where [sn] is the correction in steps +/- for this 1 second segment + // Returns: Nothing + if (command[1] == 'R') { + char *parameter2 = strchr(parameter, ','); + if (parameter2) { + int16_t i, j; + parameter2[0] = 0; + parameter2++; + if (convert.atoi2(parameter, &i)) { + if (i >= 0 && i < bufferSize) { + if (convert.atoi2(parameter2, &j)) { + if (j >= -128 && j <= 127) { + buffer[i] = j; + settings.recorded = true; + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else *commandError = CE_PARAM_FORM; + *numericReply = false; + } else + #endif + return false; + } else + + // $QZ - PEC Control + if (command[0] == '$' && command[1] == 'Q' && parameter[0] == 'Z' && parameter[2] == 0) { + *numericReply = false; + #if AXIS1_PEC == ON + // :$QZ+# Enable RA PEC compensation + // Returns: nothing + if (parameter[1] == '+') { + if (settings.state == PEC_NONE && settings.recorded) settings.state = PEC_READY_PLAY; else *commandError = CE_0; + nv().kv().put(nvKey, settings); + } else + // :$QZ-# Disable RA PEC Compensation + // Returns: nothing + if (parameter[1] == '-') { + settings.state = PEC_NONE; + nv().kv().put(nvKey, settings); + } else + // :$QZ/# Ready Record PEC + // Returns: nothing + if (parameter[1] == '/') { + if (settings.state == PEC_NONE && mount.isTracking()) { + settings.state = PEC_READY_RECORD; + nv().kv().put(nvKey, settings); + } else *commandError = CE_0; + } else + // :$QZZ# Clear the PEC data buffer + // Return: Nothing + if (parameter[1] == 'Z') { + for (int i = 0; i < bufferSize; i++) buffer[i] = 0; + settings.state = PEC_NONE; + settings.recorded = false; + nv().kv().put("PEC_SETTINGS", settings); + } else + // :$QZ!# Write PEC data to NV + // Returns: nothing + if (parameter[1] == '!') { + settings.recorded = true; + nv().kv().put("PEC_SETTINGS", settings); + nvIv.writeBytes(0, buffer, bufferSize); + } else + #endif + // :$QZ?# Get PEC status + // Returns: s#, one of "IpPrR" (I)gnore, get ready to (p)lay, (P)laying, get ready to (r)ecord, (R)ecording + // or an optional (.) to indicate an index detect + if (parameter[1] == '?') { + const char *pecStateStr = "IpPrR"; + uint8_t state = 0; + #if AXIS1_PEC == ON + state = settings.state; + #endif + reply[0] = pecStateStr[state]; reply[1] = 0; reply[2] = 0; + #if AXIS1_PEC == ON + if (wormIndexSenseThisSecond) reply[1] = '.'; + #endif + } else { *numericReply = true; return false; } + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/mount/pec/Pec.cpp b/src/telescope/mount/pec/Pec.cpp new file mode 100755 index 0000000..c334dd6 --- /dev/null +++ b/src/telescope/mount/pec/Pec.cpp @@ -0,0 +1,334 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control, PEC + +#include "Pec.h" + +#ifdef MOUNT_PRESENT + +#if AXIS1_PEC == ON + #include "../../../lib/tasks/OnTask.h" + #include "../../../lib/nv/Nv.h" + + #include "../../../lib/sense/Sense.h" + #include "../../Telescope.h" + #include "../goto/Goto.h" + #include "../guide/Guide.h" + #include "../park/Park.h" + + #if (PEC_SENSE) == OFF + bool wormSenseFirst = true; + #else + bool wormSenseFirst = false; + #endif + + inline void pecWrapper() { pec.poll(); } + + void Pec::init() { + nvKey = nv().kv().computeKey("PEC_SETTINGS"); + if (!nv().kv().getOrInit(nvKey, settings)) { DLF("WRN: Nv, init failed for PEC_SETTINGS"); } + + settings.recorded = constrain(settings.recorded, false, true); + settings.state = constrain(settings.state, PEC_NONE, PEC_RECORD); + settings.wormRotationSteps = constrain(settings.wormRotationSteps, 0, 129600000); + + NvVolume& nvVolume = nv().volume(); + if (!nvVolume.isMounted()) { + DLF("WRN: Pec::init(); NV volume not mounted"); + return; + } + + // Bind IvPartition to the PEC partition by name. + if (nvIv.init(nvVolume, "PEC")) { + VLF("MSG: Nv, partition 'PEC' mounted"); + } else { + DLF("WRN: Pec::init(); can't find PEC partition!"); + return; + } + + stepsPerSiderealSecond = (axis1.getStepsPerMeasure()/RAD_DEG_RATIO)/240.0L; + stepsPerSiderealSecondI = lroundf(stepsPerSiderealSecond); + stepsPerMicroSecond = (stepsPerSiderealSecond*SIDEREAL_RATIO)/1000000.0L; + + wormRotationSeconds = round(settings.wormRotationSteps/stepsPerSiderealSecond); + bufferSize = wormRotationSeconds; + + if (bufferSize > 0) { + if (bufferSize < 61) { + DLF("WRN: Pec::init(), invalid bufferSize (minimum worm rotation 61 seconds)"); + bufferSize = 0; + initError.value = true; + } else + if (bufferSize > nvIv.sizeBytes()) { + DLF("WRN: Pec::init(), bufferSize exceeds PEC partition size - PEC disabled"); + bufferSize = 0; + initError.value = true; + } else { + buffer = (int8_t*)malloc(bufferSize * sizeof(*buffer)); + if (buffer == NULL) { + bufferSize = 0; + initError.value = true; + DLF("WRN: Pec::init(), bufferSize exceeds available RAM - PEC disabled"); + } else { + VF("MSG: Mount, PEC allocated buffer "); V(bufferSize * (long)sizeof(*buffer)); VLF(" bytes"); + + bool bufferNeedsInit = true; + nvIv.readBytes(0, buffer, bufferSize); + for (int i = 0; i < bufferSize; i++) { if (buffer[i] != 0) bufferNeedsInit = false; } + if (bufferNeedsInit) { + for (int i = 0; i < bufferSize; i++) buffer[i] = 0; + nvIv.writeBytes(0, buffer, bufferSize); + } + + if (settings.state > PEC_RECORD) { + settings.state = PEC_NONE; + initError.value = true; + DLF("ERR: Pec::init(), bad NV settings.state"); + } + + if (!settings.recorded) settings.state = PEC_NONE; + + #if (PEC_SENSE) == OFF + #if GOTO_FEATURE == ON + park.settings.wormSensePositionSteps = 0; + #endif + settings.state = PEC_NONE; + #else + VLF("MSG: Mount, PEC adding sense"); + senseHandle = sense.add(PEC_SENSE_PIN, PEC_SENSE_INIT, PEC_SENSE); + #endif + + VF("MSG: Mount, PEC start monitor task (rate 10ms priority 3)... "); + monitorHandle = tasks.add(10, 0, true, 3, pecWrapper, "MntPec"); + if (monitorHandle) { VLF("success"); } else { VLF("FAILED!"); } + } + } + } + if (bufferSize <= 0) { bufferSize = 0; settings.state = PEC_NONE; settings.recorded = false; } + if (wormRotationSeconds > bufferSize) wormRotationSeconds = bufferSize; + } + + void Pec::poll() { + // PEC is only active when we're tracking at the sidereal rate with a guide rate that makes sense + #if GOTO_FEATURE == ON + if (park.state > PS_UNPARKED) { disable(); return; } + #endif + if (!mount.isTracking() || guide.state > GU_PULSE_GUIDE) { disable(); return; } + + // keep track of our current step position, and when the step position on the worm wraps during playback + long axis1Steps = axis1.getMotorPositionSteps(); + + #if (PEC_SENSE) == OFF + wormSenseFirst = true; + #else + static int lastState; + lastState = wormIndexState; + wormIndexState = sense.isOn(senseHandle); + + // digital or analog pec sense, with 60 second delay before redetect + long dist; + if (wormSenseSteps > axis1Steps) dist = wormSenseSteps - axis1Steps; else dist = axis1Steps - wormSenseSteps; + + if (wormIndexSenseThisSecond && dist > stepsPerSiderealSecond*2.0) wormIndexSenseThisSecond = false; + + if (dist > stepsPerSiderealSecond*60.0 && wormIndexState != lastState && wormIndexState == true) { + VLF("MSG: Mount, PEC index detected"); + wormSenseSteps = axis1Steps; + wormSenseFirst = true; + bufferStart = true; + wormIndexSenseThisSecond = true; + } else bufferStart = false; + + #endif + + if (settings.state == PEC_NONE) { rate = 0.0F; return; } + if (!wormSenseFirst) return; + + // worm step position corrected for any index found + #if (PEC_SENSE) == OFF + static long lastWormRotationSteps = wormRotationSteps; + #endif + wormRotationSteps = axis1Steps - wormSenseSteps; + while (wormRotationSteps >= settings.wormRotationSteps) wormRotationSteps -= settings.wormRotationSteps; + while (wormRotationSteps < 0) wormRotationSteps += settings.wormRotationSteps; + + #if (PEC_SENSE) == OFF + if (wormRotationSteps - lastWormRotationSteps < 0) { + VLF("MSG: Mount, PEC virtual index detected"); + bufferStart = true; + } else bufferStart = false; + #endif + + // handle playing back and recording PEC + noInterrupts(); + unsigned long lastFs = fracLAST; + interrupts(); + + // start playing PEC + if (settings.state == PEC_READY_PLAY) { + // makes sure the index is at the start of a second before resuming play + if ((long)fmod(wormRotationSteps, stepsPerSiderealSecond) == 0) { + VLF("MSG: Mount, PEC started playing"); + settings.state = PEC_PLAY; + bufferIndex = lroundf(wormRotationSteps/stepsPerSiderealSecond); + wormRotationStartTimeFs = lastFs; + } + } else + // start recording PEC + if (settings.state == PEC_READY_RECORD) { + if ((long)fmod(wormRotationSteps, stepsPerSiderealSecond) == 0) { + VF("MSG: Mount, PEC started recording at "); + settings.state = PEC_RECORD; + bufferIndex = lroundf(wormRotationSteps/stepsPerSiderealSecond); + firstRecording = !settings.recorded; + wormRotationStartTimeFs = lastFs; + V(wormRotationStartTimeFs); + recordStopTimeFs = wormRotationStartTimeFs + (uint32_t)(wormRotationSeconds*(long)FRACTIONAL_SEC); + V(" and stopping at "); VL(recordStopTimeFs); + accGuideAxis1 = 0.0L; + } + } else + // and once the PEC data is all stored, indicate that it's valid and start using it + if (settings.state == PEC_RECORD && (long)(lastFs - recordStopTimeFs) > 0) { + VLF("MSG: Mount, PEC recording complete switched to playing"); + settings.state = PEC_PLAY; + settings.recorded = true; + cleanup(); + } + + // reset the buffer index to match the worm index + if (bufferStart && settings.state != PEC_RECORD) { + bufferIndex = 0; + wormRotationStartTimeFs = lastFs; + } + + // Increment the PEC index once a second and make it go back to zero when the + // worm finishes a rotation, this code works when crossing zero + if (lastFs - wormRotationStartTimeFs >= FRACTIONAL_SEC) { wormRotationStartTimeFs = lastFs; bufferIndex++; } + bufferIndex = ((bufferIndex % wormRotationSeconds) + wormRotationSeconds) % wormRotationSeconds; + + // accumulate guide steps for PEC + if (guide.rateAxis1 != 0.0F) { + if (accGuideStartTime != 0) accGuideAxis1 += stepsPerMicroSecond*(micros() - accGuideStartTime)*guide.rateAxis1; + accGuideStartTime = micros(); + if (accGuideStartTime == 0) accGuideStartTime = 1; + } else accGuideStartTime = 0; + + // falls in whenever the pecIndex changes, which is once a sidereal second + static long lastBufferIndex = 0; + if (bufferIndex != lastBufferIndex) { + lastBufferIndex = bufferIndex; + + // assume no change to tracking rate + rate = 0.0F; + + if (settings.state == PEC_RECORD) { + // get guide steps taken from the accumulator + int i = round(accGuideAxis1); + + // stay within +/- one sidereal rate for corrections + if (i < -stepsPerSiderealSecondI) i = -stepsPerSiderealSecondI; + if (i > stepsPerSiderealSecondI) i = stepsPerSiderealSecondI; + + // apply weighted average + if (!firstRecording) i = (i + (int)buffer[bufferIndex]*2)/3; + + // restrict to valid range and store + if (i < -127) i = -127; else if (i > 127) i = 127; + + // remove steps from the accumulator + accGuideAxis1 -= i; + + buffer[bufferIndex] = i; + } + + if (settings.state == PEC_PLAY) { + // adjust one second before the value was recorded, an estimate of the latency between image acquisition and response + // if sending values directly to OnStep from PECprep, etc. be sure to account for this + // number of steps ahead or behind for this 1 second slot, up to +/-127 + int j = bufferIndex - 1; if (j == -1) j += wormRotationSeconds; + int i = buffer[j]; + if (i > stepsPerSiderealSecondI) i = stepsPerSiderealSecondI; + if (i < -stepsPerSiderealSecondI) i = -stepsPerSiderealSecondI; + rate = i/stepsPerSiderealSecond; + } + } + } + + // disable PEC + void Pec::disable() { + // give up recording if we stop tracking at the sidereal rate + // don't zero the PEC offset, we don't want things moving and it really doesn't matter + if (settings.state == PEC_RECORD || settings.state == PEC_READY_RECORD) { + VLF("MSG: Mount, PEC recording stopped"); + settings.state = PEC_NONE; + rate = 0.0F; + } + // get ready to re-index when tracking comes back + if (settings.state == PEC_PLAY) { + VLF("MSG: Mount, PEC playing paused"); + settings.state = PEC_READY_PLAY; + rate = 0.0F; + } + } + + // applies low pass filter to smooth noise in PEC data and linear regression + void Pec::cleanup() { + VLF("MSG: Mount, applying low pass filter to PEC data"); + int i,J1,J4,J9,J17; + for (int scc = 3; scc < wormRotationSeconds + 3; scc++) { + i = buffer[scc % wormRotationSeconds]; + + J1 = lroundf(i*0.01F); + J4 = lroundf(i*0.04F); + J9 = lroundf(i*0.09F); + J17 = lroundf(i*0.17F); + buffer[(scc - 4) % wormRotationSeconds] = (buffer[(scc - 4) % wormRotationSeconds]) + J1; + buffer[(scc - 3) % wormRotationSeconds] = (buffer[(scc - 3) % wormRotationSeconds]) + J4; + buffer[(scc - 2) % wormRotationSeconds] = (buffer[(scc - 2) % wormRotationSeconds]) + J9; + buffer[(scc - 1) % wormRotationSeconds] = (buffer[(scc - 1) % wormRotationSeconds]) + J17; + buffer[(scc ) % wormRotationSeconds] = (buffer[(scc ) % wormRotationSeconds]) - (J17+J17+J9+J9+J4+J4+J1+J1); + buffer[(scc + 1) % wormRotationSeconds] = (buffer[(scc + 1) % wormRotationSeconds]) + J17; + buffer[(scc + 2) % wormRotationSeconds] = (buffer[(scc + 2) % wormRotationSeconds]) + J9; + buffer[(scc + 3) % wormRotationSeconds] = (buffer[(scc + 3) % wormRotationSeconds]) + J4; + buffer[(scc + 4) % wormRotationSeconds] = (buffer[(scc + 4) % wormRotationSeconds]) + J1; + } + + // linear regression + VLF("MSG: Mount, applying linear regression to PEC data"); + // the number of steps added should equal the number of steps subtracted (from the cycle) + // first, determine how far we've moved ahead or backward in steps + long stepsSum = 0; for (int scc = 0; scc < wormRotationSeconds; scc++) stepsSum += buffer[scc]; + + // this is the correction coefficient for a given location in the sequence + float Ccf = (float)stepsSum/wormRotationSeconds; + + // now, apply the correction to the sequence to make the PEC adjustments null out + // this process was simulated in a spreadsheet and the roundoff error might leave us at +/- a step which is tacked on at the beginning + long lp2 = 0; stepsSum = 0; + for (int scc = 0; scc < wormRotationSeconds; scc++) { + // the correction, "now" + long lp1 = lroundf(-scc*Ccf); + + // if the correction increases or decreases then add or subtract that many steps + buffer[scc] = buffer[scc] + (lp1 - lp2); + + // sum the values for a final adjustment, if necessary + stepsSum += buffer[scc]; + lp2 = lp1; + } + buffer[0] -= stepsSum; + + // a reality check, make sure the buffer data looks good, if not forget it + if (stepsSum < -2 || stepsSum > 2) { + DF("ERR: Pec::cleanup(), linear regression residual "); D(stepsSum); + if (stepsSum > 2) { DLF(" > threshold of 2"); } else { DLF(" < threshold of -2"); } + settings.recorded = false; + settings.state = PEC_NONE; + } + } + +#endif + + Pec pec; + +#endif diff --git a/src/telescope/mount/pec/Pec.h b/src/telescope/mount/pec/Pec.h new file mode 100755 index 0000000..5492e99 --- /dev/null +++ b/src/telescope/mount/pec/Pec.h @@ -0,0 +1,84 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control +#pragma once + +#include "../../../Common.h" + +#ifdef MOUNT_PRESENT + +#if PEC_BUFFER_SIZE_LIMIT == 0 || PEC_STEPS_PER_WORM_ROTATION == 0 + #define AXIS1_PEC OFF +#else + #define AXIS1_PEC ON +#endif + +#include "../../../lib/nv/NvIvPartition.h" +#include "../Mount.h" + +enum PecState: uint8_t {PEC_NONE, PEC_READY_PLAY, PEC_PLAY, PEC_READY_RECORD, PEC_RECORD}; + +#pragma pack(1) +#define PecSettingsSize 6 +typedef struct PecSettings { + bool recorded:1; + PecState state; + long wormRotationSteps; +} PecSettings; +#pragma pack() + +class Pec { + public: + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // tracking rate (in x) due to PEC playing + float rate = 0.0F; + + #if AXIS1_PEC == ON + void init(); + void poll(); + + PecSettings settings = { false, PEC_NONE, PEC_STEPS_PER_WORM_ROTATION }; + #endif + + private: + #if AXIS1_PEC == ON + // disable PEC + void disable(); + + // applies low pass filter to smooth noise in PEC data and linear regression + void cleanup(); + #endif + + double stepsPerSiderealSecond = 0.0L; + int stepsPerSiderealSecondI = 0; + double stepsPerMicroSecond = 0.0L; + long bufferSize = 0; // in bytes + #if AXIS1_PEC == ON + uint8_t monitorHandle = 0; + uint8_t senseHandle = 0; + + bool wormIndexState = false; + bool wormIndexSenseThisSecond = false; + long wormRotationSteps = 0; // step position in worm rotation sequence + long wormSenseSteps = 0; // step position + + bool firstRecording = false; + uint32_t recordStopTimeFs = 0; + uint32_t wormRotationStartTimeFs = 0; // start time of worm rotation sequence, in fracsecs or milliseconds + long wormRotationSeconds = 0; // time for a worm rotation, in seconds + unsigned long accGuideStartTime = 0; + + double accGuideAxis1 = 0.0L; + + bool bufferStart = false; + long bufferIndex = 0; // index into the pec buffer + int8_t* buffer; + #endif + + IvPartition nvIv; + uint32_t nvKey; +}; + +extern Pec pec; + +#endif diff --git a/src/telescope/mount/site/Site.command.cpp b/src/telescope/mount/site/Site.command.cpp new file mode 100755 index 0000000..ce46941 --- /dev/null +++ b/src/telescope/mount/site/Site.command.cpp @@ -0,0 +1,282 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount time and location, commands + +#include "Site.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/nv/Nv.h" + +#include "../../../libApp/commands/ProcessCmds.h" + +#include "../../Telescope.h" +#include "../home/Home.h" +#include "../Mount.h" + +bool Site::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + *suppressFrame = false; + PrecisionMode precisionMode = convert.precision; + + if (command[0] == 'G') { + // :Ga# Get standard time in 12 hour format + // Returns: HH:MM:SS# + if (command[1] == 'a' && parameter[0] == 0) { + double time = rangeAmPm(getTime() - location.timezone); + convert.doubleToHms(reply, time, false, PM_HIGH); + *numericReply = false; + } else + + // :GC# Get standard calendar date + // Returns: MM/DD/YY# + if (command[1] == 'C' && parameter[0] == 0) { + GregorianDate local = calendars.julianToGregorian(UT1ToLocal(getDateTime())); + sprintf(reply, "%02d/%02d/%02d", (int)local.month, (int)local.day, (int)local.year % 100); + *numericReply = false; + } else + + // :Gc# Get the Local Standard Time format + // Returns: 24# + if (command[1] == 'c' && parameter[0] == 0) { + strcpy(reply, "24"); + *numericReply = false; + } else + + // :GG# Get UTC offset time, hours and minutes to add to local time to convert to UTC + // Returns: [s]HH:MM# + if (command[1] == 'G' && parameter[0] == 0) { + convert.doubleToHms(reply, location.timezone, true, PM_LOWEST); + *numericReply = false; + } else + + // :Gg# Get Current Site Longitude, east is negative + // Returns: sDDD*MM# + // :GgH# Get current site Longitude + // Returns: sDD*MM:SS.SSS# (high precision) + if (command[1] == 'g' && (parameter[0] == 0 || parameter[1] == 0)) { + precisionMode = PM_LOW; + if (parameter[0] == 'H') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + convert.doubleToDms(reply, radToDeg(location.longitude), true, true, precisionMode); + *numericReply = false; + } else + + // :GL# Get Local Standard Time in 24 hour format + // Returns: HH:MM:SS# + // :GLH# Returns: HH:MM:SS.SSSS# (high precision) + if (command[1] == 'L' && (parameter[0] == 0 || parameter[1] == 0)) { + if (parameter[0] == 'H') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + convert.doubleToHms(reply, rangeHours(getTime() - location.timezone), false, precisionMode); + *numericReply = false; + } else + + // :GM# Get site 1 name + // :GN# Get site 2 name + // :GO# Get site 3 name + // :GP# Get site 4 name + // Returns: s# + if ((command[1] == 'M' || command[1] == 'N' || command[1] == 'O' || command[1] == 'P') && parameter[0] == 0) { + Location tempLocation; + tempLocation.name[0] = 0; + uint8_t locationNumber = command[1] - 'M'; + if (locationNumber <= 3) { nv().kv().get(nvKey[locationNumber], tempLocation); } + strcpy(reply, tempLocation.name); + if (reply[0] == 0) { strcat(reply,"None"); } + *numericReply = false; + } else + + // :GS# Get the Sidereal Time as sexagesimal value in 24 hour format + // Returns: HH:MM:SS# + // :GSH# Returns: HH:MM:SS.ss# (high precision) + if (command[1] == 'S' && (parameter[0] == 0 || parameter[1] == 0)) { + if (parameter[0] == 'H') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + convert.doubleToHms(reply, getSiderealTime(), false, precisionMode); + *numericReply = false; + } else + + // :Gt# Get current site Latitude, positive for North latitudes + // Returns: sDD*MM# + // :GtH# Get current site Latitude, positive for North latitudes + // Returns: sDD*MM:SS.SSS# (high precision) + if (command[1] == 't' && (parameter[0] == 0 || parameter[1] == 0)) { + precisionMode = PM_LOW; + if (parameter[0] == 'H') precisionMode = PM_HIGHEST; else if (parameter[0] != 0) { *commandError = CE_PARAM_FORM; return true; } + convert.doubleToDms(reply, radToDeg(location.latitude), false, true, precisionMode); + *numericReply = false; + } else + + // :Gv# Get the site eleVation in meters + // Returns: +/-n.n + if (command[1] == 'v' && parameter[0] == 0) { + sprintF(reply, "%3.1f", location.elevation); + *numericReply = false; + } else + + if (command[1] == 'X' && parameter[0] == '8' && parameter[2] == 0) { + // :GX80# Get the UT1 Time as sexagesimal value in 24 hour format + // Returns: HH:MM:SS.ss# + if (parameter[1] == '0') { + convert.doubleToHms(reply, rangeHours(getTime()), false, PM_HIGH); + *numericReply = false; + } else + + // :GX81# Get the UT1 Date + // Returns: MM/DD/YY# + if (parameter[1] == '1') { + JulianDate julianDay = ut1; + double hour = getTime(); + while (hour >= 24.0) { hour -= 24.0; julianDay.day += 1.0; } + if (hour < 0.0) { hour += 24.0; julianDay.day -= 1.0; } + GregorianDate date = calendars.julianDayToGregorian(julianDay); + sprintf(reply, "%02d/%02d/%02d", (int)date.month, (int)date.day, (int)date.year % 100); + *numericReply = false; + } else + + // :GX89# Date/time ready status + // Return: 0 ready, 1 not ready + if (parameter[1] == '9') { + if (dateIsReady && timeIsReady) *commandError = CE_0; else *commandError = CE_1; + } else return false; + + } else return false; + } else + + if (command[0] == 'S') { + // :SC[MM/DD/YY]# or :SC[MM/DD/YYYY]# + // Change local standard date + // Return: 0 on failure, 1 on success + if (command[1] == 'C') { + GregorianDate local = calendars.julianToGregorian(UT1ToLocal(getDateTime())); + if (strToDate(parameter, &local)) { + dateIsReady = true; + setDateTime(localToUT1(calendars.gregorianToJulian(local))); + updateTLS(); + } else *commandError = CE_PARAM_FORM; + } else + + // :SG[sHH]# or :SG[sHH:MM]# (where MM is 00, 30, or 45) + // Set the number of hours added to local time to yield UT1 + // Return: 0 failure, 1 success + if (command[1] == 'G') { + double hour; + if (convert.tzToDouble(&hour, parameter)) { + if (hour >= -13.75 || hour <= 12.0) { + location.timezone = hour; + nv().kv().put(nvKey[locationNumber], location); + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + // :Sg[(s)DDD*MM]# or :Sg[(s)DDD*MM:SS]# or :Sg[(s)DDD*MM:SS.SSS]# + // Set current site longitude, east longitudes can be negative or > 180 degrees + // Return: 0 failure, 1 success + if (command[1] == 'g') { + double degs; + int i; + if (parameter[0] == '-' || parameter[0] == '+') i = 1; else i = 0; + if (convert.dmsToDouble(°s, (char *)¶meter[i], false)) { + if (degs >= -180.0 && degs <= 360.0) { + if (degs >= 180.0) degs -= 360.0; + location.longitude = degToRad(degs); + if (parameter[0] == '-') location.longitude = -location.longitude; + updateLocation(); + nv().kv().put(nvKey[locationNumber], location); + } else *commandError = CE_PARAM_RANGE; + } else *commandError = CE_PARAM_FORM; + } else + + // :SL[HH:MM:SS]# or :SL[HH:MM:SS.SSS]# + // Set the local Time + // Return: 0 failure, 1 success + if (command[1] == 'L') { + GregorianDate local = calendars.julianToGregorian(UT1ToLocal(getDateTime())); + if (convert.hmsToDouble(&local.hour, parameter, PM_HIGH) || convert.hmsToDouble(&local.hour, parameter, PM_HIGHEST)) { + timeIsReady = true; + setDateTime(localToUT1(calendars.gregorianToJulian(local))); + updateTLS(); + } else *commandError = CE_PARAM_FORM; + } else + + // :SM[s]# or :SN[s]# or :SO[s]# or :SP[s]# + // Set site name, string may be up to 15 characters + // Return: 0 on failure + // 1 on success + if ((command[1] == 'M' || command[1] == 'N' || command[1] == 'O' || command[1] == 'P')) { + uint8_t tempLocationNumber = command[1] - 'M'; + if (strlen(parameter) <= 15) { + Location tempLocation; + tempLocation.latitude = 0.0; + tempLocation.longitude = 0.0; + tempLocation.timezone = 0.0; + tempLocation.elevation = 100.0; + nv().kv().get(nvKey[tempLocationNumber], tempLocation); + strcpy(tempLocation.name, parameter); + nv().kv().put(nvKey[tempLocationNumber], tempLocation); + if (locationNumber == tempLocationNumber) strcpy(location.name, parameter); + } else *commandError = CE_PARAM_RANGE; + } else + + // :St[sDD*MM]# or :St[sDD*MM:SS]# or :St[sDD*MM:SS.SSS]# + // Set current site latitude in degrees + // Return: 0 failure, 1 success + if (command[1] == 't') { + double degs; + if (convert.dmsToDouble(°s, parameter, true)) { + location.latitude = degToRad(degs); + updateLocation(); + nv().kv().put(nvKey[locationNumber], location); + if (mount.isHome()) home.init(); + } else *commandError = CE_PARAM_FORM; + } else + + // :SU[s.s]# + // Set the number of seconds (up to +/-0.9) added to UTC to yield UT1 (DUT1) + // presently only applied to GPS and NTP UTC time for UT1 conversion + // see: https://datacenter.iers.org/data/latestVersion/bulletinB.txt + // Return: 0 failure, 1 success + if (command[1] == 'U') { + char *conv_end; + double dut1 = strtod(parameter, &conv_end); + if (dut1 >= -0.9 && dut1 <= 0.9) { + #if TIME_LOCATION_SOURCE != OFF + tls->DUT1 = dut1; + #endif + #if TIME_LOCATION_SOURCE_FALLBACK != OFF + tlsFallback->DUT1 = dut1; + #endif + } else *commandError = CE_PARAM_FORM; + } else + + // :Sv[sn.n]# + // Sets current site eleVation in meters + // Return: 0 failure, 1 success + if (command[1] == 'v') { + char *conv_end; + float f = strtod(¶meter[0], &conv_end); + if (¶meter[0] == conv_end) f = NAN; + if (!setElevation(f)) *commandError = CE_PARAM_RANGE; + nv().kv().put(nvKey[locationNumber], location); + } else return false; + } else + + if (command[0] == 'W') { + // :W[n]# Sets current site to n, where n = 0..3 + // Returns: Nothing + if ((command[1] >= '0' && command[1] <= '3') && parameter[0] == 0) { + locationNumber = command[1] - '0'; + readLocation(locationNumber); + updateLocation(); + if (mount.isHome()) home.init(); + *numericReply = false; + } else + + // :W?# Queries current site + // Returns: n# + if (command[1] == '?' && parameter[0] == 0) { + sprintf(reply, "%d", (int)locationNumber); + *numericReply = false; + } else return false; + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/mount/site/Site.cpp b/src/telescope/mount/site/Site.cpp new file mode 100755 index 0000000..18fdd34 --- /dev/null +++ b/src/telescope/mount/site/Site.cpp @@ -0,0 +1,459 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount, time and location + +#include "Site.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../../Telescope.h" +#include "../park/Park.h" +#include "../home/Home.h" +#include "../limits/Limits.h" +#include "../Mount.h" + +// fractional second sidereal clock (fracsec or millisecond) +volatile unsigned long fracLAST; +IRAM_ATTR void clockTickWrapper() { fracLAST++; } + +#define fsToHours(x) ((x)/(3600.0*FRACTIONAL_SEC)) +#define hoursToFs(x) ((x)*(3600.0*FRACTIONAL_SEC)) +#define fsToDays(x) ((x)/(86400.0*FRACTIONAL_SEC)) +#define daysToFs(x) ((x)*(86400.0*FRACTIONAL_SEC)) + +#if TIME_LOCATION_SOURCE == GPS + void gpsCheck() { + if (site.tls->isReady()) { + VLF("MSG: Mount, getting site from GPS"); + double latitude, longitude; + float elevation; + site.tls->getSite(latitude, longitude, elevation); + site.location.latitude = degToRad(latitude); + site.location.longitude = degToRad(longitude); + site.location.elevation = degToRad(elevation); + strcpy(site.location.name, "GPS"); + site.updateLocation(); + if (mount.isHome()) home.init(); + + JulianDate jd; + VLF("MSG: Mount, getting date/time from GPS"); + unsigned long syncTimeout = millis() + 1000U; + while (!site.tls->get(jd) && (long)(millis() - syncTimeout) < 0) { }; + if ((long)(millis() - syncTimeout) < 0) { + site.dateIsReady = true; + site.timeIsReady = true; + site.setDateTime(jd); + site.updateTLS(); + } else { + VLF("MSG: Mount, GPS timed out getting date/time from GPS"); + initError.tls = true; + } + + VLF("MSG: Mount, stopping GPS monitor task"); + tasks.setDurationComplete(tasks.getHandleByName("gpsChk")); + } else + + if ((long)(millis() - site.updateTimeoutTime) > 0) { + DLF("WRN: Mount, GPS timed out stopping monitor task"); + tasks.setDurationComplete(tasks.getHandleByName("gpsChk")); + DLF("WRN: TLS, GPS timed out stopping GPS polling task"); + tasks.setDurationComplete(tasks.getHandleByName("gpsPoll")); + initError.tls = true; + } + } +#endif + +#if TIME_LOCATION_SOURCE == NTP + void ntpCheck() { + if (site.tls->isReady()) { + VLF("MSG: Mount, getting date/time from NTP"); + JulianDate jd; + site.tls->get(jd); + site.dateIsReady = true; + site.timeIsReady = true; + site.setDateTime(jd); + site.updateTLS(); + + VLF("MSG: Mount, stopping NTP monitor task"); + tasks.setDurationComplete(tasks.getHandleByName("ntpChk")); + } else + + if ((long)(millis() - site.updateTimeoutTime) > 0) { + DLF("MSG: Mount, NTP timed out stopping monitor task"); + tasks.setDurationComplete(tasks.getHandleByName("ntpChk")); + DLF("WRN: TLS, NTP timed out stopping monitor task"); + tasks.setDurationComplete(tasks.getHandleByName("ntp")); + initError.tls = true; + } + } +#endif + +#if (TIME_LOCATION_PPS_SENSE) != OFF && TIME_LOCATION_PPS_SYNC == ON + void ppsMonitor() { + static long deltaAvg = 0; + + // monitor and adapt to keep PPS in sync with our UT1 + static unsigned long lastMicros = 0; + long p = micros() - pps.lastMicros; + if (pps.lastMicros == lastMicros || p < 250000L) { + // DF("MSG: Site,"); D(pps.synced ? ' ' : '!'); DF("sub-micro delta="); D((long)pps.averageSubMicros - 16000000L); DLF("us"); + return; + } + lastMicros = pps.lastMicros; + + double h = site.getDateTime().hour*3600.0; + char syncc = ' '; + long s = round((h - floor(h))*1000000.0); + if (!pps.synced) { syncc = '!'; p = 1000000L; s = 1000000L; } + + long delta = p - s; + deltaAvg = (delta + deltaAvg*19L)/20L; + // DF("MSG: Site,"); D(syncc); DF("sub-micro delta="); D((long)pps.averageSubMicros - 16000000L); DF("us, pps="); D(p/1000L); DF("ms, time.sec="); D(s/1000L); DF("ms, delta="); D(delta/1000); DLF("ms"); + + if (abs(deltaAvg) < 3000L) return; + pps.averageSubMicrosSkew = (-deltaAvg*SITE_MIN_PPS_SUB_MICRO)/2000L; + if (pps.averageSubMicrosSkew < -128) pps.averageSubMicrosSkew = -128; else + if (pps.averageSubMicrosSkew > 128) pps.averageSubMicrosSkew = 128; + } +#endif + +void Site::init() { + // get location + VLF("MSG: Mount, site get Latitude/Longitude from NV"); + readLocation(locationNumber); + updateLocation(); + + // get date/time from a TLS or NV + #if TIME_LOCATION_SOURCE != OFF + + #if TIME_LOCATION_SOURCE_FALLBACK == DS3231 + tlsFallback = new TlsDs3231; + #elif TIME_LOCATION_SOURCE_FALLBACK == DS3234 + tlsFallback = new TlsDs3234; + #elif TIME_LOCATION_SOURCE_FALLBACK == SD3031 + tlsFallback = new TlsSd3031; + #elif TIME_LOCATION_SOURCE_FALLBACK == TEENSY + tlsFallback = new TlsTeensy; + #endif + + #if TIME_LOCATION_SOURCE == DS3231 + tls = new TlsDs3231; + #elif TIME_LOCATION_SOURCE == DS3234 + tls = new TlsDs3234; + #elif TIME_LOCATION_SOURCE == GPS + tls = new TlsGPS; + #elif TIME_LOCATION_SOURCE == NTP + tls = new TlsNTP; + #elif TIME_LOCATION_SOURCE == SD3031 + tls = new TlsSd3031; + #elif TIME_LOCATION_SOURCE == TEENSY + tls = new TlsTeensy; + #endif + + initError.tls = !tls->init(); + if (!initError.tls) { + if (tls->isReady()) { + tls->get(ut1); + dateIsReady = true; + timeIsReady = true; + VLF("MSG: Mount, site get Date/Time from TLS"); + } else { + #if TIME_LOCATION_SOURCE == GPS + updateTimeoutTime = millis() + GPS_TIMEOUT_MINUTES*60000U; + VF("MSG: Site, start GPS check task (rate 5000ms priority 7)... "); + if (tasks.add(5000, 0, true, 7, gpsCheck, "gpsChk")) { VLF("success"); } else { VLF("FAILED!"); } + #endif + #if TIME_LOCATION_SOURCE == NTP + updateTimeoutTime = millis() + NTP_TIMEOUT_SECONDS*1000U; + VF("MSG: Site, start NTP check task (rate 5000ms priority 7)... "); + if (tasks.add(5000, 0, true, 7, ntpCheck, "ntpChk")) { VLF("success"); } else { VLF("FAILED!"); } + #endif + } + } + + #if TIME_LOCATION_SOURCE_FALLBACK != OFF + if (tlsFallback->init() && tlsFallback->isReady()) { + tlsFallback->get(ut1); + dateIsReady = true; + timeIsReady = true; + #if TIME_LOCATION_SOURCE_FALLBACK == DS3231 + if (initError.tls) tlsFallback->ppsEnable(); + #endif + initError.tls = false; + VLF("MSG: Mount, site get Date/Time from fallback TLS"); + } + #endif + + if (initError.tls) { + DLF("WRN: Site::init(), Warning TLS initialization failed"); + DLF("WRN: Site::init(), fallback to last Date/Time from NV"); + readJD(); + } + #else + VLF("MSG: Mount, site get Date/Time from NV"); + readJD(); + #endif + + setSiderealTime(ut1); + + VF("MSG: Mount, site start sidereal timer task (rate 10ms priority 0)... "); + delay(100); + // period ms (0=idle), duration ms (0=forever), repeat, priority (highest 0..7 lowest), task_handle + taskHandle = tasks.add(0, 0, true, 0, clockTickWrapper, "MtTick"); + if (taskHandle) { + VLF("success"); + if (!tasks.requestHardwareTimer(taskHandle, 1)) { DLF("WRN: Site::init(), didn't get h/w timer for Clock (using s/w timer)"); } + } else { VLF("FAILED!"); } + + setSiderealPeriod(SIDEREAL_PERIOD); + + #if (TIME_LOCATION_PPS_SENSE) != OFF + pps.init(); + #if TIME_LOCATION_PPS_SYNC == ON + VF("MSG: Mount, site start PPS monitor task (rate 333ms priority 6)... "); + delay(100); + // period ms (0=idle), duration ms (0=forever), repeat, priority (highest 0..7 lowest), task_handle + if (tasks.add(333, 0, true, 6, ppsMonitor, "ppsMon")) { VLF("success"); } else { VLF("FAILED!"); } + #endif + #endif +} + +// update/apply the site latitude and longitude, necessary for LAST calculations etc. +void Site::updateLocation() { + locationEx.latitude.cosine = cos(location.latitude); + locationEx.latitude.sine = sin(location.latitude); + locationEx.latitude.absval = fabs(location.latitude); + if (location.latitude >= 0.0) locationEx.latitude.sign = 1.0; else locationEx.latitude.sign = -1.0; + + // same date and time, just calculates the sidereal time again + ut1.hour = getTime(); + setSiderealTime(ut1); +} + +// update the initError status and restore the park position if necessary +void Site::updateTLS() { + #if TIME_LOCATION_SOURCE != OFF + tls->set(ut1); + #endif + #if TIME_LOCATION_SOURCE_FALLBACK != OFF + tlsFallback->set(ut1); + #endif + + if (isDateTimeReady()) { + if (initError.tls) initError.tls = false; + #if GOTO_FEATURE == ON + if (park.state == PS_PARKED) park.restore(false); + #endif + } +} + +// gets the UT1 Julian date/time +JulianDate Site::getDateTime() { + JulianDate now = ut1; + + now.hour = getTime(); + while (now.hour >= 24.0) { now.hour -= 24.0; now.day += 1.0; } + while (now.hour < 0.0) { now.hour += 24.0; now.day -= 1.0; } + + return now; +} + +// sets the UT1 Julian date/time and updates sidereal time +void Site::setDateTime(JulianDate julianDate) { + ut1 = julianDate; + setSiderealTime(julianDate); + + if (writeTime) nv().kv().put("DATE_TIME", ut1); + + if (nv().device().endurance() < NvDevice::Endurance::Mid) writeTime = false; + + #if LIMIT_STRICT == ON + limits.enabled(isDateTimeReady()); + #endif + + if (isDateTimeReady() && mount.startupAuthorityTrusted()) limits.enabled(true); +} + +// gets the time in sidereal hours +double Site::getSiderealTime() { + long fs; + noInterrupts(); + fs = fracLAST; + interrupts(); + return rangeHours(fsToHours(fs)); +} + +// sets the UT time (in hours) that have passed in this Julian Day +void Site::setSiderealTime(JulianDate julianDate) { + setLAST(julianDate, julianDateToLAST(julianDate)); +} + +// checks if the date and time were set +bool Site::isDateTimeReady() { + return dateIsReady && timeIsReady; +} + +// gets sidereal period, in sub-micro counts per second +unsigned long Site::getSiderealPeriod() { + return siderealPeriod; +} + +// sets sidereal period, in sub-micro counts per second +void Site::setSiderealPeriod(unsigned long period) { + siderealPeriod = period; + tasks.setPeriodSubMicros(taskHandle, lround(siderealPeriod/FRACTIONAL_SEC)); +} + +// gets the time in hours that have passed since Julian Day was set (UT1) +double Site::getTime() { + unsigned long cs; + noInterrupts(); + cs = fracLAST; + interrupts(); + return fracHOUR + fsToHours((cs - fracSTART)/SIDEREAL_RATIO); +} + +// sets the time in sidereal hours +void Site::setLAST(JulianDate julianDate, double time) { + long fs = lround(hoursToFs(time)); + fracHOUR = julianDate.hour; + fracSTART = fs; + noInterrupts(); + fracLAST = fs; + interrupts(); +} + +// convert julian date/time to local apparent sidereal time +double Site::julianDateToLAST(JulianDate julianDate) { + // DL("ST 1"); delay(100); + double gast = julianDateToGAST(julianDate); + // DL("ST 2"); delay(100); + return rangeHours(gast - radToHrs(location.longitude)); +} + +// convert julian date/time to greenwich apparent sidereal time +double Site::julianDateToGAST(JulianDate julianDate) { + GregorianDate date; + + date = calendars.julianDayToGregorian(julianDate); + JulianDate julianDay0 = calendars.gregorianToJulianDay(date); + double D= (julianDate.day - 2451545.0) + julianDate.hour/24.0; + double D0=(julianDay0.day - 2451545.0); + double H = julianDate.hour; + double T = D/36525.0; + double gmst = 6.697374558 + 0.06570982441908*D0; + gmst = gmst + SIDEREAL_RATIO*H + 0.000026*T*T; + + // equation of the equinoxes + double O = 125.04 - 0.052954 *D; + double L = 280.47 + 0.98565 *D; + double E = 23.4393 - 0.0000004*D; + double W = -0.000319*sin(degToRad(O)) - 0.000024*sin(degToRad(2*L)); + double eqeq = W*cos(degToRad(E)); + double gast = gmst + eqeq; + + return rangeHours(gast); +} + +// reads the julian date information from NV +void Site::readJD() { + ut1.day = 2451544.5; + ut1.hour = 0.0; + + if (!nv().kv().getOrInit("DATE_TIME", ut1)) { DLF("WRN: Nv, init failed for DATE_TIME"); } + ut1.day = constrain(ut1.day, 2451544.5, 2816787.5); + ut1.hour = constrain(ut1.hour, 0, 24); +} + +// reads the location information from NV +// locationNumber can be 0..3 +void Site::readLocation(uint8_t n) { + if (n > 3) return; + + locationNumber = n; + location.latitude = 0.0; + location.longitude = 0.0; + location.timezone = 0.0; + location.elevation = 100.0; + strcpy(location.name, ""); + + char keyStr[26]; + snprintf(keyStr, sizeof(keyStr), "LOCATION%u_SETTINGS", locationNumber); + nvKey[locationNumber] = nv().kv().computeKey(keyStr); + if (!nv().kv().getOrInit(nvKey[locationNumber], location)) { DF("WRN: Nv, init failed for "); VL(keyStr); } + + location.latitude = constrain(location.latitude, -Deg90, Deg90); + location.longitude = constrain(location.longitude, -Deg360, Deg360); + location.elevation = constrain(location.elevation, -418, 8848); // in meters + location.timezone = constrain(location.timezone, -14, 12); +} + +// sets the site altitude in meters +bool Site::setElevation(float e) { + if (e >= -100.0 && e < 20000.0) location.elevation = e; else return false; + return true; +} + +// convert UT1 to local standard date/time +JulianDate Site::UT1ToLocal(JulianDate ut1) { + ut1.hour -= location.timezone; + while (ut1.hour >= 24.0) { ut1.hour -= 24.0; ut1.day += 1.0; } + while (ut1.hour < 0.0) { ut1.hour += 24.0; ut1.day -= 1.0; } + return ut1; +} + +// convert local standard to UT1 date/time +JulianDate Site::localToUT1(JulianDate local) { + local.hour += location.timezone; + while (local.hour >= 24.0) { local.hour -= 24.0; local.day += 1.0; } + while (local.hour < 0.0) { local.hour += 24.0; local.day -= 1.0; } + return local; +} + +// adjust into the 0 to 24 range +double Site::rangeHours(double time) { + while (time >= 24.0) time -= 24.0; + while (time < 0.0) time += 24.0; + return time; +} + +// adjust into the 0 to 12 range +double Site::rangeAmPm(double time) { + while (time >= 12.0) time -= 12.0; + while (time < 0.0) time += 12.0; + return time; +} + +// convert string in format MM/DD/YY or MM/DD/YYYY to Date (changes only date) +bool Site::strToDate(char *ymd, GregorianDate *date) { + GregorianDate temp; + char m[3], d[3], y[5]; + + if (strlen(ymd) != 8 && strlen(ymd) != 10) return false; + + m[0] = *ymd++; m[1] = *ymd++; m[2] = 0; + if (!convert.atoi2(m, &temp.month, false)) return false; + if (*ymd++ != '/') return false; + + d[0] = *ymd++; d[1] = *ymd++; d[2] = 0; + if (!convert.atoi2(d, &temp.day, false)) return false; + if (*ymd++ != '/') return false; + + y[0] = *ymd++; y[1] = *ymd++; y[2] = 0; + if (strlen(ymd) == 10) { y[2] = *ymd++; y[3] = *ymd++; y[4] = 0; } + if (!convert.atoi2(y, &temp.year, false)) return false; + if (temp.year < 100) { if (temp.year > 20) temp.year += 2000; else temp.year += 2100; } + + if (temp.month < 1 || temp.month > 12 || temp.day < 1 || temp.day > 31 || temp.year < 2000 || temp.year > 2300) return false; + + date->year = temp.year; + date->month = temp.month; + date->day = temp.day; + return true; +} + +Site site; + +#endif diff --git a/src/telescope/mount/site/Site.h b/src/telescope/mount/site/Site.h new file mode 100755 index 0000000..d7caec6 --- /dev/null +++ b/src/telescope/mount/site/Site.h @@ -0,0 +1,158 @@ +//-------------------------------------------------------------------------------------------------- +// observatory time +#pragma once + +#include "../../../Common.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/convert/Convert.h" +#include "../../../libApp/commands/ProcessCmds.h" +#include "../../../lib/calendars/Calendars.h" +#include "../../../lib/tls/Tls.h" + +#ifndef SITE_MIN_PPS_SUB_MICRO + #define SITE_MIN_PPS_SUB_MICRO 4 +#endif + +extern volatile unsigned long fracLAST; + +typedef struct LatitudeExtras { + double sine; + double cosine; + double absval; + double sign; +} Latitude; + +typedef struct LocationExtras { + LatitudeExtras latitude; + bool ready; +} LocationExtras; + +#pragma pack(1) +#define LocationSize 40 +typedef struct Location { + double latitude; // in radians + double longitude; // in radians + float elevation; // in meters + float timezone; + char name[16]; +} Location; +#pragma pack() + +class Site { + public: + void init(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // update/apply the site latitude and longitude, necessary for LAST calculations etc. + void updateLocation(); + + // update the initError status and restore the park position if necessary + void updateTLS(); + + // gets the UT1 Julian date/time + JulianDate getDateTime(); + + // sets the UT1 Julian date/time and updates sidereal time + void setDateTime(JulianDate julianDate); + + // gets the time in sidereal hours + double getSiderealTime(); + + // sets the sidereal time from the UT date/time + void setSiderealTime(JulianDate julianDate); + + // checks if the date and time were set + bool isDateTimeReady(); + + // gets sidereal period, in sub-micro counts per second + unsigned long getSiderealPeriod(); + + // sets sidereal period, in sub-micro counts per second + void setSiderealPeriod(unsigned long period); + + // gets sidereal ratio + // slower rates are < 1.0, faster rates are > 1.0 + inline float getSiderealRatio() { return (float)SIDEREAL_PERIOD/siderealPeriod; } + + Location location; + LocationExtras locationEx; + + // for internal use, when to timeout date/time updates + unsigned long updateTimeoutTime = 0; + + bool dateIsReady = false; + bool timeIsReady = false; + + #if TIME_LOCATION_SOURCE != OFF + TimeLocationSource *tls; + #endif + + #if TIME_LOCATION_SOURCE_FALLBACK != OFF + TimeLocationSource *tlsFallback; + #endif + + private: + // gets the time in hours that have passed since Julian Day was set (UT1) + double getTime(); + + // sets the time in sidereal hours + void setLAST(JulianDate julianDate, double time); + + // convert julian date/time to local apparent sidereal time + double julianDateToLAST(JulianDate julianDate); + + // convert julian date/time to greenwich apparent sidereal time + double julianDateToGAST(JulianDate julianDate); + + // reads the julian date information from NV + void readJD(); + + // reads the location information from NV + // locationNumber can be 0..3 + void readLocation(uint8_t number); + + // sets the site altitude in meters + bool setElevation(float e); + + // convert UT1 to local standard date/time + JulianDate UT1ToLocal(JulianDate ut1); + + // convert local standard to UT1 date/time + JulianDate localToUT1(JulianDate local); + + // adjust into the 0 to 24 range + double rangeHours(double time); + + // adjust into the 0 to 12 range + double rangeAmPm(double time); + + // convert string in format MM/DD/YY or MM/DD/YYYY to Date (changes only date) + bool strToDate(char *ymd, GregorianDate *date); + + // the current UT1 date and time + JulianDate ut1; + double fracHOUR = 0; + unsigned long fracSTART = 0; + + bool writeDate = true; + bool writeTime = true; + + // sidereal period in sub-microsecond counts + unsigned long siderealPeriod = 0; + + // handle to sidereal timer LAST task + uint8_t taskHandle = 0; + + // site number 0..3 + uint8_t locationNumber = 0; + + // site nv keys + uint16_t nvKey[4]; +}; + +extern Site site; + +#endif \ No newline at end of file diff --git a/src/telescope/mount/st4/St4.cpp b/src/telescope/mount/st4/St4.cpp new file mode 100755 index 0000000..c1caaec --- /dev/null +++ b/src/telescope/mount/st4/St4.cpp @@ -0,0 +1,301 @@ +// --------------------------------------------------------------------------------------------------- +// Guide, commands to move the mount in any direction at a series of fixed rates + +#include "St4.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/tasks/OnTask.h" + +#include "../../Telescope.h" +#include "../Mount.h" +#include "../guide/Guide.h" +#include "../goto/Goto.h" +#include "../status/Status.h" + +#if ST4_INTERFACE == ON + #include "../../../lib/pushButton/PushButton.h" + + #if ST4_HAND_CONTROL == ON + #include "../../../lib/serial/Serial_ST4_Master.h" + #define debounceMs 100L + #else + #define debounceMs 5L + #endif + + #include "../../../lib/serial/Serial_Local.h" + + Button st4Axis1Rev(ST4_RA_E_PIN, ST4_INTERFACE_INIT, LOW | HYST(debounceMs)); + Button st4Axis1Fwd(ST4_RA_W_PIN, ST4_INTERFACE_INIT, LOW | HYST(debounceMs)); + Button st4Axis2Fwd(ST4_DEC_N_PIN, ST4_INTERFACE_INIT, LOW | HYST(debounceMs)); + Button st4Axis2Rev(ST4_DEC_S_PIN, ST4_INTERFACE_INIT, LOW | HYST(debounceMs)); + + // Single byte guide commands + #define ccMe 14 + #define ccMw 15 + #define ccMn 16 + #define ccMs 17 + #define ccQe 18 + #define ccQw 19 + #define ccQn 20 + #define ccQs 21 + + void st4Wrapper() { + st4.poll(); + } + + void serialSt4Wrapper() { + st4.pollSerial(); + } + + void St4::init() { + long rate = round(1000.0F/HAL_FRACTIONAL_SEC); + VF("MSG: Mount, ST4 start monitor task (rate "); V(rate); VF("ms priority 2)... "); + if (tasks.add(rate, 0, true, 2, st4Wrapper, "St4Mntr")) { VLF("success"); } else { VLF("FAILED!"); } + } + + void St4::poll() { + static bool shcActive = false; + + st4Axis1Rev.poll(); + if (!shcActive) { + st4Axis1Fwd.poll(); + st4Axis2Fwd.poll(); + st4Axis2Rev.poll(); + } + + #if ST4_HAND_CONTROL == ON + + if (shcActive) { + // Smart Hand Controller deactivate + if (!st4Axis1Rev.hasTone()) { + pinMode(ST4_DEC_S_PIN, ST4_INTERFACE_INIT); + pinMode(ST4_DEC_N_PIN, ST4_INTERFACE_INIT); + + serialST4.end(); + + // stop the SHC task + VLF("MSG: Mount, stop SerialST4 comms task"); + tasks.remove(handleSerialST4); + handleSerialST4 = 0; + + VLF("MSG: SerialST4, deactivated"); + shcActive = false; + } + return; + } + + // Smart Hand Controller activate + if (!shcActive && st4Axis1Rev.hasTone() && st4Axis1Fwd.hasTone()) { + pinMode(ST4_DEC_S_PIN, OUTPUT); // SerialST4 clock + pinMode(ST4_DEC_N_PIN, OUTPUT); // SerialST4 data out + + serialST4.begin(); + + // start the SHC comms task + VF("MSG: Mount, start SerialST4 comms task (rate 100us priority 1)... "); + handleSerialST4 = tasks.add(0, 0, true, 1, serialSt4Wrapper, "St4Comm"); + if (handleSerialST4) { VLF("success"); } else { VLF("FAILED!"); } + tasks.setPeriodMicros(handleSerialST4, 100); + tasks.setTimingMode(handleSerialST4, TM_MINIMUM); + + VLF("MSG: SerialST4, activated"); + shcActive = true; + return; + } + + // standard hand control + const long Shed_ms = 4000; + + // stop any guide that might be triggered by combination button presses + if (st4Axis1Rev.isDown() && st4Axis1Fwd.isDown()) guide.stopAxis1(); + if (st4Axis2Fwd.isDown() && st4Axis2Rev.isDown()) guide.stopAxis2(); + + // see if a combination was down for long enough for an alternate mode + static bool altModeA = false; + static bool altModeB = false; + + #if GOTO_FEATURE == ON + const long AltMode_ms = 2000; + if (goTo.state == GS_NONE && !goTo.isHomePaused()) { + if (st4Axis1Rev.timeDown() > AltMode_ms && st4Axis1Fwd.timeDown() > AltMode_ms && !altModeB) { + if (!altModeA) { altModeA = true; mountStatus.soundBeep(); } + } + if (st4Axis2Fwd.timeDown() > AltMode_ms && st4Axis2Rev.timeDown() > AltMode_ms && !altModeA) { + if (!altModeB) { altModeB = true; mountStatus.soundBeep(); } + } + } + #endif + + // if the alternate mode is allowed & selected & hasn't timed out, handle it + if ( (altModeA || altModeB) && (st4Axis2Fwd.timeUp() < Shed_ms || st4Axis2Rev.timeUp() < Shed_ms || st4Axis1Rev.timeUp() < Shed_ms || st4Axis1Fwd.timeUp() < Shed_ms) ) { + + if (altModeA) { + uint8_t currentRateSelect = ((uint8_t)guide.settings.axis1RateSelect) & 0b11111110; + + // adjust guide rate faster + if (st4Axis1Fwd.wasPressed() && !st4Axis1Rev.wasPressed()) { + if (!mount.isTracking()) { SERIAL_LOCAL.transmit(":B+#"); mountStatus.soundClick(); } else { + if (currentRateSelect <= (GOTO_FEATURE == ON ? 6 : 4)) { + guide.settings.axis1RateSelect = (GuideRateSelect)(currentRateSelect + 2); + guide.settings.axis2RateSelect = (GuideRateSelect)(currentRateSelect + 2); + if (GUIDE_SEPARATE_PULSE_RATE == ON && guide.settings.axis1RateSelect <= GR_1X) guide.settings.pulseRateSelect = guide.settings.axis1RateSelect; + mountStatus.soundClick(); + } + } + } + + // adjust guide rate slower + if (st4Axis1Rev.wasPressed() && !st4Axis1Fwd.wasPressed()) { + if (!mount.isTracking()) { SERIAL_LOCAL.transmit(":B-#"); mountStatus.soundClick(); } else { + if (currentRateSelect >= 2) { + guide.settings.axis1RateSelect = (GuideRateSelect)(currentRateSelect - 2); + guide.settings.axis2RateSelect = (GuideRateSelect)(currentRateSelect - 2); + if (GUIDE_SEPARATE_PULSE_RATE == ON && guide.settings.axis1RateSelect <= GR_1X) guide.settings.pulseRateSelect = guide.settings.axis1RateSelect; + mountStatus.soundClick(); } + } + } + + // tracking on/off + if (st4Axis2Fwd.wasPressed() && !st4Axis2Rev.wasPressed()) { + mount.tracking(!mount.isTracking()); + mountStatus.soundClick(); + } + + // sync or accept align + if (st4Axis2Rev.wasPressed() && !st4Axis2Fwd.wasPressed()) { + #if GOTO_FEATURE == ON + if (goTo.alignDone()) SERIAL_LOCAL.transmit(":CS#"); else goTo.alignAddStar(); + #else + SERIAL_LOCAL.transmit(":CS#"); + #endif + mountStatus.soundClick(); + } + } + + if (altModeB) { + #if ST4_HAND_CONTROL_FOCUSER == ON + const char moveSlow[2][8] = {":F12#", ":F22#"}; + const char moveFast[2][8] = {":F14#", ":F24#"}; + const char moveIn[2][8] = {":F1-#", ":F2-#"}; + const char moveOut[2][8] = {":F1+#", ":F2+#"}; + static int fs = 0; + static int fn = 0; + static int focuserNumber = 0; + + // select focuser 1 or 2 + if (!fn && !fs) { + if (st4Axis1Fwd.wasPressed() && !st4Axis1Rev.wasPressed()) { focuserNumber = 1; mountStatus.soundClick(); } + if (st4Axis1Rev.wasPressed() && !st4Axis1Fwd.wasPressed()) { focuserNumber = 0; mountStatus.soundClick(); } + } + + // move selected focuser out + if (!fn) { + if (st4Axis2Rev.isDown() && st4Axis2Fwd.isUp()) { + if (fs == 0) { SERIAL_LOCAL.transmit(moveSlow[focuserNumber]); fs++; } else + if (fs == 1) { SERIAL_LOCAL.transmit(moveIn[focuserNumber]); fs++; } else + if (fs == 2 && st4Axis2Rev.timeDown() > 4000) { SERIAL_LOCAL.transmit(moveFast[focuserNumber]); fs++; } else + if (fs == 3) { SERIAL_LOCAL.transmit(moveIn[focuserNumber]); fs++; } + } + if (st4Axis2Rev.isUp()) { if (fs > 0) { SERIAL_LOCAL.transmit(":F1Q#:F2Q#"); fs = 0; } } + } + + // move selected focuser in + if (!fs) { + if (st4Axis2Fwd.isDown() && st4Axis2Rev.isUp()) { + if (fn == 0) { SERIAL_LOCAL.transmit(moveSlow[focuserNumber]); fn++; } else + if (fn == 1) { SERIAL_LOCAL.transmit(moveOut[focuserNumber]); fn++; } else + if (fn == 2 && st4Axis2Fwd.timeDown() > 4000) { SERIAL_LOCAL.transmit(moveFast[focuserNumber]); fn++; } else + if (fn == 3) { SERIAL_LOCAL.transmit(moveOut[focuserNumber]); fn++; } + } + if (st4Axis2Fwd.isUp()) { if (fn > 0) { SERIAL_LOCAL.transmit(":F1Q#:F2Q#"); fn = 0; } } + } + #else + // select next user catalog item + if (st4Axis1Fwd.wasPressed() && !st4Axis1Rev.wasPressed()) { SERIAL_LOCAL.transmit(":LN#"); mountStatus.soundClick(); } + + // select previous user catalog item + if (st4Axis1Rev.wasPressed() && !st4Axis1Fwd.wasPressed()) { SERIAL_LOCAL.transmit(":LB#"); mountStatus.soundClick(); } + + // goto user catalog item + if (st4Axis2Fwd.wasPressed() && !st4Axis2Rev.wasPressed()) { SERIAL_LOCAL.transmit(":LIG#"); mountStatus.soundClick(); } + + // turn sound on/off + if (st4Axis2Rev.wasPressed() && !st4Axis2Fwd.wasPressed()) { mountStatus.soundClick(); mountStatus.soundToggleEnable(); mountStatus.soundClick(); } + #endif + } + } else { + if (altModeA || altModeB) { + #if ST4_HAND_CONTROL_FOCUSER == ON + SERIAL_LOCAL.transmit(":F1Q#:F2Q#"); + #endif + altModeA = false; + altModeB = false; + mountStatus.soundBeep(); + } + #endif + + if (mount.isEnabled()) { + // guide E/W + bool pulseGuiding = GUIDE_SEPARATE_PULSE_RATE == ON && ST4_HAND_CONTROL != ON; + GuideAction st4GuideActionAxis1 = GA_BREAK; + static GuideAction lastSt4GuideActionAxis1 = GA_BREAK; + if (st4Axis1Fwd.isDown() && st4Axis1Rev.isUp()) st4GuideActionAxis1 = GA_FORWARD; + if (st4Axis1Rev.isDown() && st4Axis1Fwd.isUp()) st4GuideActionAxis1 = GA_REVERSE; + + if (st4GuideActionAxis1 != lastSt4GuideActionAxis1) { + lastSt4GuideActionAxis1 = st4GuideActionAxis1; + if (st4GuideActionAxis1 != GA_BREAK) { + #if ST4_HAND_CONTROL == ON && GOTO_FEATURE == ON + if (goTo.isHomePaused()) goTo.homeContinue(); else + if (goTo.state == GS_GOTO) goTo.abort(); else + #endif + guide.startAxis1(st4GuideActionAxis1, pulseGuiding ? guide.settings.pulseRateSelect : guide.settings.axis1RateSelect, GUIDE_TIME_LIMIT*1000); + } else guide.stopAxis1(); + } + + // guide N/S + GuideAction st4GuideActionAxis2 = GA_BREAK; + static GuideAction lastSt4GuideActionAxis2 = GA_BREAK; + if (st4Axis2Fwd.isDown() && st4Axis2Rev.isUp()) st4GuideActionAxis2 = GA_FORWARD; + if (st4Axis2Rev.isDown() && st4Axis2Fwd.isUp()) st4GuideActionAxis2 = GA_REVERSE; + + if (st4GuideActionAxis2 != lastSt4GuideActionAxis2) { + lastSt4GuideActionAxis2 = st4GuideActionAxis2; + if (st4GuideActionAxis2 != GA_BREAK) { + #if ST4_HAND_CONTROL == ON && GOTO_FEATURE == ON + if (goTo.isHomePaused()) goTo.homeContinue(); else + if (goTo.state == GS_GOTO) goTo.abort(); else + #endif + guide.startAxis2(st4GuideActionAxis2, pulseGuiding ? guide.settings.pulseRateSelect : guide.settings.axis2RateSelect, GUIDE_TIME_LIMIT*1000); + } else guide.stopAxis2(); + } + + } + + #if ST4_HAND_CONTROL == ON + } + #endif + } + + #if ST4_HAND_CONTROL == ON + void St4::pollSerial() { + char c = serialST4.poll(); + + // process any single byte guide commands + switch (c) { + case ccMe: guide.startAxis1(GA_REVERSE, guide.settings.axis1RateSelect, GUIDE_TIME_LIMIT*1000); break; + case ccMw: guide.startAxis1(GA_FORWARD, guide.settings.axis1RateSelect, GUIDE_TIME_LIMIT*1000); break; + case ccMn: guide.startAxis2(GA_FORWARD, guide.settings.axis2RateSelect, GUIDE_TIME_LIMIT*1000); break; + case ccMs: guide.startAxis2(GA_REVERSE, guide.settings.axis2RateSelect, GUIDE_TIME_LIMIT*1000); break; + case ccQe: case ccQw: guide.stopAxis1(); break; + case ccQn: case ccQs: guide.stopAxis2(); break; + } + } + #endif + +#endif + +St4 st4; + +#endif diff --git a/src/telescope/mount/st4/St4.h b/src/telescope/mount/st4/St4.h new file mode 100755 index 0000000..9404823 --- /dev/null +++ b/src/telescope/mount/st4/St4.h @@ -0,0 +1,27 @@ +//-------------------------------------------------------------------------------------------------- +// telescope mount control +#pragma once + +#include "../../../Common.h" + +#ifdef MOUNT_PRESENT + +class St4 { + public: + void init(); + + // monitor ST4 port for guiding, basic hand controller, and smart hand controller activation + void poll(); + + #if ST4_HAND_CONTROL == ON + // transmit and recieve the smart hand controller data + void pollSerial(); + #endif + + private: + uint8_t handleSerialST4 = 0; +}; + +extern St4 st4; + +#endif diff --git a/src/telescope/mount/status/Status.command.cpp b/src/telescope/mount/status/Status.command.cpp new file mode 100755 index 0000000..ac0e4f5 --- /dev/null +++ b/src/telescope/mount/status/Status.command.cpp @@ -0,0 +1,202 @@ +// --------------------------------------------------------------------------------------------------- +// Mount status LED and buzzer + +#include "Status.h" + +#if defined(MOUNT_PRESENT) + +#include "../../../lib/nv/Nv.h" + +#include "../../../lib/tls/PPS.h" + +#include "../Mount.h" +#include "../coordinates/Transform.h" +#include "../goto/Goto.h" +#include "../guide/Guide.h" +#include "../home/Home.h" +#include "../park/Park.h" +#include "../pec/Pec.h" +#include "../limits/Limits.h" +#include "../status/Status.h" + +bool Status::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + UNUSED(suppressFrame); + + if (command[0] == 'G') { + // :Gm# Gets the meridian pier-side + // Returns: E#, W#, N# (none/parked) + if (command[1] == 'm' && parameter[0] == 0) { + strcpy(reply, "?"); + Coordinate current = mount.getMountPosition(CR_MOUNT); + if (guide.state == GU_HOME_GUIDE || guide.state == GU_HOME_GUIDE_ABORT) current.pierSide = PIER_SIDE_NONE; + if (current.pierSide == PIER_SIDE_NONE) reply[0]='N'; + if (current.pierSide == PIER_SIDE_EAST) reply[0]='E'; + if (current.pierSide == PIER_SIDE_WEST) reply[0]='W'; + *numericReply = false; + } else + + // :GU# Get telescope Status + // Returns: s# + if (command[1] == 'U' && parameter[0] == 0) { + int i = 0; + if (!mount.isTracking()) reply[i++]='n'; // [n]ot tracking + if (goTo.state == GS_NONE) reply[i++]='N'; // [N]o goto + if (park.state == PS_UNPARKED) reply[i++]='p'; else // Not [p]arked + if (park.state == PS_PARKING) reply[i++]='I'; else // Parking [I]n-progress + if (park.state == PS_PARKED) reply[i++]='P'; else // [P]arked + if (park.state == PS_PARK_FAILED) reply[i++]='F'; // Park [F]ailed + if (mount.syncFromOnStepToEncoders) reply[i++]='e'; // Sync to [e]ncoders only + if (mount.isHome()) reply[i++]='H'; // At [H]ome + if (home.state == HS_HOMING) reply[i++]='h'; // Slewing [h]ome + if (home.settings.automaticAtBoot) reply[i++]='B'; // Auto home at [B]oot + #if (TIME_LOCATION_PPS_SENSE) != OFF + if (pps.synced) reply[i++]='S'; // PPS [S]ync + #endif + if (guide.activePulseGuide()) reply[i++]='G'; // Pulse [G]uide active + if (guide.active()) reply[i++]='g'; // [g]uide active + + if (mount.settings.rc == RC_REFRACTION) { reply[i++]='r'; reply[i++]='s'; } // [r]efr enabled [s]ingle axis + if (mount.settings.rc == RC_REFRACTION_DUAL) { reply[i++]='r'; } // [r]efr enabled + if (mount.settings.rc == RC_MODEL) { reply[i++]='t'; reply[i++]='s'; } // On[t]rack enabled [s]ingle axis + if (mount.settings.rc == RC_MODEL_DUAL) { reply[i++]='t'; } // On[t]rack enabled + if (mount.settings.rc == RC_NONE) { + float r = siderealToHz(mount.trackingRate); + if (fequal(r, 57.900F)) reply[i++]='('; else // Lunar rate selected + if (fequal(r, 60.000F)) reply[i++]='O'; else // SOlar rate selected + if (fequal(r, 60.136F)) reply[i++]='k'; // King rate selected + } + + if (goTo.isHomePaused()) reply[i++]='w'; // [w]aiting at home + if (goTo.isHomePauseEnabled()) reply[i++]='u'; // Pa[u]se at home enabled? + if (sound.enabled) reply[i++]='z'; // Bu[z]zer enabled? + if (goTo.isAutoFlipEnabled()) reply[i++]='a'; // [a]uto meridian flip + #if AXIS1_PEC == ON + if (pec.settings.recorded) reply[i++]='R'; // PEC data has been [R]ecorded + if (transform.isEquatorial()) + reply[i++]="/,~;^"[(int)pec.settings.state]; // PEC State (/)gnore, ready (,)lay, (~)laying, ready (;)ecord, (^)ecording + #endif + if (transform.mountType == GEM) reply[i++]='E'; else // GEM + if (transform.mountType == FORK) reply[i++]='K'; else // FORK + if (transform.mountType == ALTAZM) reply[i++]='A'; else // ALTAZM + if (transform.mountType == ALTALT) reply[i++]='L'; // ALTALT + + Coordinate current = mount.getMountPosition(CR_MOUNT); + if (guide.state == GU_HOME_GUIDE || guide.state == GU_HOME_GUIDE_ABORT) current.pierSide = PIER_SIDE_NONE; + if (current.pierSide == PIER_SIDE_NONE) reply[i++]='o'; else // Pier side n[o]ne + if (current.pierSide == PIER_SIDE_EAST) reply[i++]='T'; else // Pier side eas[T] + if (current.pierSide == PIER_SIDE_WEST) reply[i++]='W'; // Pier side [W]est + + reply[i++]='0' + guide.settings.pulseRateSelect; // Provide pulse-guide rate + reply[i++]='0' + guide.settings.axis1RateSelect; // Provide guide rate + + reply[i++]='0' + mountStatus.errorCode(); // Provide general error code + reply[i++]=0; + + *numericReply = false; + } else + + // :Gu# Get bit packed telescope status + // Returns: s# + if (command[1] == 'u' && parameter[0] == 0) { + memset(reply, (char)0b10000000, 9); + if (!mount.isTracking()) reply[0]|=0b10000001; // Not tracking + if (goTo.state == GS_NONE) reply[0]|=0b10000010; // No goto + #if (TIME_LOCATION_PPS_SENSE) != OFF + if (pps.synced) reply[0]|=0b10000100; // PPS sync + #endif + if (guide.activePulseGuide()) reply[0]|=0b10001000; // Pulse guide active + + if (mount.settings.rc == RC_REFRACTION) reply[0]|=0b11010000; // Refr enabled Single axis + if (mount.settings.rc == RC_REFRACTION_DUAL) reply[0]|=0b10010000; // Refr enabled + if (mount.settings.rc == RC_MODEL) reply[0]|=0b11100000; // OnTrack enabled Single axis + if (mount.settings.rc == RC_MODEL_DUAL) reply[0]|=0b10100000; // OnTrack enabled + if (mount.settings.rc == RC_NONE) { + float r = siderealToHz(mount.trackingRate); + if (fequal(r, 57.900F)) reply[1]|=0b10000001; else // Lunar rate selected + if (fequal(r, 60.000F)) reply[1]|=0b10000010; else // Solar rate selected + if (fequal(r, 60.136F)) reply[1]|=0b10000011; // King rate selected + } + + if (mount.syncFromOnStepToEncoders) reply[1]|=0b10000100; // Sync to encoders only + if (guide.active()) reply[1]|=0b10001000; // Guide active + if (mountStatus.startupAuthorityTrusted()) reply[1]|=0b10010000; // Startup authority trusted + if (mount.isHome()) reply[2]|=0b10000001; // At home + if (home.state == HS_HOMING) reply[2]|=0b10100000; // Slewing home + if (home.settings.automaticAtBoot) reply[2]|=0b11000000; // Auto home at boot + if (goTo.isHomePaused()) reply[2]|=0b10000010; // Waiting at home + if (goTo.isHomePauseEnabled()) reply[2]|=0b10000100; // Pause at home enabled? + if (sound.enabled) reply[2]|=0b10001000; // Buzzer enabled? + if (goTo.isAutoFlipEnabled()) reply[2]|=0b10010000; // Auto meridian flip + + if (transform.mountType == GEM) reply[3]|=0b10000001; else // GEM + if (transform.mountType == FORK) reply[3]|=0b10000010; else // FORK + if (transform.mountType == ALTAZM) reply[3]|=0b10001000; else // ALTAZM + if (transform.mountType == ALTALT) reply[3]|=0b10000100; // ALTALT + + Coordinate current = mount.getMountPosition(CR_MOUNT); + if (guide.state == GU_HOME_GUIDE || guide.state == GU_HOME_GUIDE_ABORT) current.pierSide = PIER_SIDE_NONE; + if (current.pierSide == PIER_SIDE_NONE) reply[3]|=0b10010000; else // Pier side none + if (current.pierSide == PIER_SIDE_EAST) reply[3]|=0b10100000; else // Pier side east + if (current.pierSide == PIER_SIDE_WEST) reply[3]|=0b11000000; // Pier side west + + #if AXIS1_PEC == ON + if (transform.isEquatorial()) + reply[4] = (int)pec.settings.state|0b10000000; // PEC state: 0 ignore, 1 ready play, 2 playing, 3 ready record, 4 recording + if (pec.settings.recorded) reply[4]|=0b11000000; // PEC state: data has been recorded + #endif + reply[5] = (int)park.state|0b10000000; // Park state: 0 not parked, 1 parking in-progress, 2 parked, 3 park failed + reply[6] = (int)guide.settings.pulseRateSelect|0b10000000; // Pulse-guide selection + reply[7] = (int)guide.settings.axis1RateSelect|0b10000000; // Guide selection + reply[8] = mountStatus.errorCode()|0b10000000; // General error + reply[9] = 0; + *numericReply = false; + } else + + // :GW# Get tracking and basic mount state + // Returns: s# + if (command[1] == 'W' && parameter[0] == 0) { + int i = 0; + if (transform.mountType == GEM) reply[i++] = 'G'; else + if (transform.mountType == FORK) reply[i++] = 'P'; else + if (transform.mountType == ALTAZM) reply[i++] = 'A'; else + if (transform.mountType == ALTALT) reply[i++] = 'L'; + if (mount.isTracking()) reply[i++] = 'T'; else reply[i++] = 'N'; + if (park.state == PS_PARKED) reply[i++] = 'P'; else + if (mount.isHome()) reply[i++] = 'H'; else + if (goTo.alignDone()) reply[i++] = '1'; else reply[i++] = '0'; + reply[i++] = 0; + *numericReply = false; + } else return false; + + } else + + // :SX97,[n]# Set buzzer state + // Return: see below + if (command[0] == 'S' && command[1] == 'X' && parameter[0] == '9' && parameter[1] == '7' && parameter[2] == ',' && parameter[4] == 0) { + switch (parameter[3]) { + case '0': case '1': + sound.enabled = parameter[3] - '0'; + #if STATUS_BUZZER_MEMORY == ON + settings.soundEnabled = sound.enabled; + nv().kv().put("STATUS_SETTINGS", settings); + #endif + break; + case '2': + soundBeep(); + break; + case '3': + soundAlert(); + break; + case '4': + soundClick(); + break; + default: + *commandError = CE_PARAM_RANGE; + break; + } + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/mount/status/Status.cpp b/src/telescope/mount/status/Status.cpp new file mode 100755 index 0000000..0fe01c5 --- /dev/null +++ b/src/telescope/mount/status/Status.cpp @@ -0,0 +1,105 @@ +// --------------------------------------------------------------------------------------------------- +// Mount status LED and buzzer + +#include "Status.h" + +#ifdef MOUNT_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/gpioEx/GpioEx.h" +#include "../../../lib/nv/Nv.h" + +#include "../Mount.h" +#include "../limits/Limits.h" +#include "../park/Park.h" + +#if STATUS_MOUNT_LED != OFF && MOUNT_LED_PIN != OFF + bool ledOn = false; + bool ledOff = false; + void flash() { + if (ledOff) { digitalWriteEx(MOUNT_LED_PIN, !MOUNT_LED_ON_STATE); return; } + if (ledOn) { digitalWriteEx(MOUNT_LED_PIN, MOUNT_LED_ON_STATE); return; } + static uint8_t cycle = 0; + if ((cycle++)%2 == 0) { + digitalWriteEx(MOUNT_LED_PIN, !MOUNT_LED_ON_STATE); + } else { + digitalWriteEx(MOUNT_LED_PIN, MOUNT_LED_ON_STATE); + } + } +#endif + +void generalWrapper() { mountStatus.general(); } + +// get mount status ready +void Status::init() { + #if STATUS_BUZZER_MEMORY == ON + if (!nv().kv().getOrInit("STATUS_SETTINGS", settings)) { DLF("WRN: Nv, init failed for STATUS_SETTINGS"); } + sound.enabled = settings.soundEnabled; + #endif + + #if PARK_STATUS != OFF && PARK_STATUS_PIN != OFF + pinModeEx(PARK_STATUS_PIN, OUTPUT); + #endif + + VF("MSG: Mount, status start general status task (1s rate priority 4)... "); + if (tasks.add(1000, 0, true, 4, generalWrapper, "MtStat")) { VLF("success"); } else { VLF("FAILED!"); } +} + +// mount status wake on demand +void Status::wake() { + static bool ready = false; + + if (!ready) { + #if STATUS_LED == ON + // if Mount buzzer or status LED are using the Telescope status LED pin, disable it and use here now + if (STATUS_MOUNT_LED != OFF && MOUNT_LED_PIN == STATUS_LED_PIN) tasks.remove(tasks.getHandleByName("StaLed")); + if (STATUS_BUZZER != OFF && STATUS_BUZZER_PIN == STATUS_LED_PIN) tasks.remove(tasks.getHandleByName("StaLed")); + #endif + + #if STATUS_MOUNT_LED != OFF && MOUNT_LED_PIN != OFF + if (!tasks.getHandleByName("mntLed")) { + pinModeEx(MOUNT_LED_PIN, OUTPUT); + VF("MSG: Mount, status start LED task (variable rate priority 4)... "); + statusTaskHandle = tasks.add(0, 0, true, 4, flash, "mntLed"); + if (statusTaskHandle) { VLF("success"); } else { VLF("FAILED!"); } + } + #endif + + #if STATUS_BUZZER != OFF + VLF("MSG: Mount, status start buzzer"); + sound.init(); + #endif + + ready = true; + } +} + +// mount status LED flash rate (in ms) +void Status::flashRate(int period) { + #if STATUS_MOUNT_LED != OFF && MOUNT_LED_PIN != OFF + if (period == 0) { period = 500; ledOff = true; } else ledOff = false; + if (period == 1) { period = 500; ledOn = true; } else ledOn = false; + tasks.setPeriod(statusTaskHandle, period/2UL); + #else + period = period; + #endif +} + +uint8_t Status::errorCode() { + return limits.errorCode(); +} + +bool Status::startupAuthorityTrusted() { + return mount.startupAuthorityTrusted(); +} + +// mount misc. general status indicators +void Status::general() { + #if PARK_STATUS != OFF && PARK_STATUS_PIN != OFF + digitalWriteEx(PARK_STATUS_PIN, (park.state == PS_PARKED) ? PARK_STATUS : !PARK_STATUS) + #endif +} + +Status mountStatus; + +#endif diff --git a/src/telescope/mount/status/Status.h b/src/telescope/mount/status/Status.h new file mode 100755 index 0000000..adfa91f --- /dev/null +++ b/src/telescope/mount/status/Status.h @@ -0,0 +1,52 @@ +//-------------------------------------------------------------------------------------------------- +// Mount status LED and buzzer +#pragma once + +#include "../../../Common.h" + +#ifdef MOUNT_PRESENT + +#include "../../../libApp/commands/ProcessCmds.h" +#include "../../../lib/sound/Sound.h" + +#define SF_STOPPED 0 +#define SF_SLEWING 1 + +typedef struct StatusSettings { + bool soundEnabled; +} StatusSettings; + +class Status { + public: + // get mount status ready + void init(); + + // mount status wake on demand + void wake(); + + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // current mount fault/status code for external reporting + uint8_t errorCode(); + bool startupAuthorityTrusted(); + + // mount status LED flash rate (in ms) + void flashRate(int period); + + // mount misc. general status indicators + void general(); + + inline void soundAlert() { if (sound.enabled) wake(); sound.alert(); } + inline void soundBeep() { if (sound.enabled) wake(); sound.beep(); } + inline void soundClick() { if (sound.enabled) wake(); sound.click(); } + inline void soundToggleEnable() { sound.enabled = !sound.enabled; } + + private: + uint8_t statusTaskHandle = 0; + Sound sound; + StatusSettings settings = {false}; +}; + +extern Status mountStatus; + +#endif diff --git a/src/telescope/rotator/Rotator.h b/src/telescope/rotator/Rotator.h new file mode 100755 index 0000000..630396f --- /dev/null +++ b/src/telescope/rotator/Rotator.h @@ -0,0 +1,19 @@ +//-------------------------------------------------------------------------------------------------- +// local and remote telescope rotator control switchboard + +#pragma once + +#include "RotatorBase.h" + +// ----------------------------------------------------------------------------- +// Include the chosen implementation +// - CLIENT: Rotator is a proxy class +// - otherwise (local present): Rotator is the local hardware class +// and REMOTE (server) support is compiled in as additional code paths. +// ----------------------------------------------------------------------------- +#if defined(ROTATOR_CAN_CLIENT_PRESENT) + #include "remote/Rotator.h" // defines class Rotator (proxy) +#elif defined(ROTATOR_PRESENT) + #include "local/Rotator.h" // defines class Rotator (local hardware) + // conditionally includes/declares server hooks when ROTATOR_CAN_SERVER_PRESENT is defined +#endif diff --git a/src/telescope/rotator/RotatorBase.h b/src/telescope/rotator/RotatorBase.h new file mode 100755 index 0000000..f57c932 --- /dev/null +++ b/src/telescope/rotator/RotatorBase.h @@ -0,0 +1,110 @@ + +// ----------------------------------------------------------------------------- +// Where the base CAN ID's start for this CANbus transport +// ----------------------------------------------------------------------------- +#pragma once + +#include "../../Common.h" + +#ifndef CAN_ROTATOR_REQ_ID + #define CAN_ROTATOR_REQ_ID (0x00 + 3) +#endif + +#ifndef CAN_ROTATOR_RSP_ID + #define CAN_ROTATOR_RSP_ID (CAN_ROTATOR_REQ_ID + 0x10) +#endif + +#ifndef CAN_ROTATOR_HB_ID_BASE + #define CAN_ROTATOR_HB_ID_BASE (CAN_ROTATOR_REQ_ID + 0x20) +#endif + +// ----------------------------------------------------------------------------- +// CAN_ROTATOR role selection +// OFF : no CAN rotator support +// ON : telescope/mount forwards rotator commands over CAN (client/proxy) +// REMOTE : remote node answers rotator commands over CAN (server/local axis3) +// ----------------------------------------------------------------------------- + +#ifndef CAN_ROTATOR + #define CAN_ROTATOR OFF +#endif + +// ----------------------------------------------------------------------------- +// Validate CAN requirements +// ----------------------------------------------------------------------------- +#if (CAN_ROTATOR != OFF) + #if !defined(CAN_PLUS) || (CAN_PLUS == OFF) + #error "Rotator: CAN_ROTATOR requires CAN_PLUS to be enabled." + #endif +#endif + +// ----------------------------------------------------------------------------- +// Derive presence macros used by Telescope.cpp command router +// ----------------------------------------------------------------------------- +#if (CAN_ROTATOR == ON) + // ROTATOR_PRESENT must NOT exist + #define ROTATOR_CLIENT_PRESENT // a remote rotator may be present + #define ROTATOR_CAN_CLIENT_PRESENT // client implementation using CAN +#elif (CAN_ROTATOR == REMOTE) + // ROTATOR_PRESENT must exist since we need Axis3 + #define ROTATOR_CAN_SERVER_PRESENT // server implementation (compiled into local rotator) +#endif + +// ----------------------------------------------------------------------------- +// Enforce “only one rotator” contract +// ----------------------------------------------------------------------------- + +// CLIENT build must NOT also have a local Axis3 rotator. +#if defined(ROTATOR_PRESENT) && defined(ROTATOR_CLIENT_PRESENT) + #error "Config: both local AXIS3 rotator (ROTATOR_PRESENT) and CAN_ROTATOR ON are enabled. Choose one." +#endif + +// REMOTE build MUST have local Axis3 rotator (otherwise it can't serve anything). +#if !defined(ROTATOR_PRESENT) && defined(ROTATOR_CAN_SERVER_PRESENT) + #error "Config: CAN_ROTATOR REMOTE requires a local AXIS3 rotator (ROTATOR_PRESENT)." +#endif + +// ----------------------------------------------------------------------------- +// CANbus command opcode set (5-bit). Per-ID namespace, so rotator "owns" these. +// ----------------------------------------------------------------------------- + +#define ROT_OP_PARK_HP 0x08 // :hP# | TX: none -> RX: none (numericReply=1; CE_1 on success) +#define ROT_OP_UNPARK_HR 0x09 // :hR# | TX: none -> RX: none (numericReply=1; CE_1 on success) + +#define ROT_OP_ACTIVE_RA 0x0A // :rA# | TX: none -> RX: none (numericReply=1; CE_1 on success) + +#define ROT_OP_GET_STATUS_T 0x01 // :rT# | TX: none -> RX: ASCII bytes "M"/"S"["D"]["R"] + rateDigit ('1'..'5') +#define ROT_OP_GET_MIN_I 0x0B // :rI# | TX: none -> RX: i32LE deg (rounded) +#define ROT_OP_GET_MAX_M 0x0C // :rM# | TX: none -> RX: i32LE deg (rounded) +#define ROT_OP_GET_DEG_PERSTEP_D 0x0D // :rD# | TX: none -> RX: f32LE deg_per_step + +#define ROT_OP_BACKLASH_b 0x0E // :rb# | TX: (none) -> RX: i16LE steps (numericReply=0) + // :rb[n]# | TX: i16LE steps -> RX: none (numericReply=1; CE_1 on success) + +#define ROT_OP_STOP_Q 0x02 // :rQ# | TX: none -> RX: none (numericReply=0) +#define ROT_OP_SET_RATE_1_9 0x0F // :r[1..9]# | TX: u8 rateDigit (1..9) -> RX: none (numericReply=0) + +#define ROT_OP_GET_WORKRATE_W 0x10 // :rW# | TX: none -> RX: f32LE deg_per_sec (settings.gotoRate) +#define ROT_OP_CONTINUOUS_c 0x11 // :rc# | TX: none -> RX: none (numericReply=0) // ignored/no-op + +#define ROT_OP_MOVE_CW_GT 0x03 // :r># | TX: none -> RX: none (numericReply=0) +#define ROT_OP_MOVE_CCW_LT 0x04 // :r<# | TX: none -> RX: none (numericReply=0) + +#define ROT_OP_GET_ANGLE_G 0x06 // :rG# | TX: none -> RX: f32LE deg (axis3.getInstrumentCoordinate()) +#define ROT_OP_GOTO_REL_rr 0x12 // :rr[deg]# | TX: f32LE deg_relative -> RX: none (numericReply=0) + +#define ROT_OP_GOTO_S 0x05 // :rS[deg]# | TX: f32LE deg_absolute -> RX: none (numericReply=1; CE_1 on success else error) + +#define ROT_OP_ZERO_Z 0x07 // :rZ# | TX: none -> RX: none (numericReply=0) +#define ROT_OP_HALFTRAVEL_F 0x13 // :rF# | TX: none -> RX: none (numericReply=0) +#define ROT_OP_HALFTARGET_C 0x14 // :rC# | TX: none -> RX: none (numericReply=0) + +#define ROT_OP_DEROT_EN_PLUS 0x15 // :r+# | TX: none -> RX: none (numericReply=0) +#define ROT_OP_DEROT_DIS_MINUS 0x16 // :r-# | TX: none -> RX: none (numericReply=0) + +#define ROT_OP_GOTO_PAR_P 0x17 // :rP# | TX: none -> RX: none (numericReply=0) +#define ROT_OP_DEROT_REV_R 0x18 // :rR# | TX: none -> RX: none (numericReply=0) + +#define ROT_OP_AVAIL_GX98 0x19 // :GX98# | TX: none -> RX: u8 ASCII 'D'/'R'/'N' (numericReply=0) + +#define ROT_OP_DRIVER_STATUS 0x20 // :GXU3# | TX: none -> RX: u8 packedStatus diff --git a/src/telescope/rotator/local/Rotator.axis.cpp b/src/telescope/rotator/local/Rotator.axis.cpp new file mode 100755 index 0000000..1552953 --- /dev/null +++ b/src/telescope/rotator/local/Rotator.axis.cpp @@ -0,0 +1,108 @@ +//-------------------------------------------------------------------------------------------------- +// local telescope rotator control, axis3 + +#include "Rotator.h" + +#ifdef ROTATOR_PRESENT + +namespace { + +#if defined(AXIS3_KTECH_PRESENT) + const KTechDriverSettings DriverSettingsAxis3 = {AXIS3_DRIVER_MODEL, AXIS3_DRIVER_STATUS}; + KTechMotor motor_3(3, AXIS3_REVERSE, &DriverSettingsAxis3); + +#elif defined(AXIS3_MKS42D_PRESENT) + const MksDriverSettings DriverSettingsAxis3 = {AXIS3_DRIVER_MODEL, AXIS3_DRIVER_STATUS}; + Mks42DMotor motor_3(3, AXIS3_REVERSE, &DriverSettingsAxis3, AXIS3_STEPS_PER_DEGREE); + +#elif defined(AXIS3_SERVO_PRESENT) + ServoControl servoControlAxis3; + + #if AXIS3_ENCODER == AB + Quadrature encAxis3(3, AXIS3_ENCODER_A_PIN, AXIS3_ENCODER_B_PIN); + #elif AXIS3_ENCODER == AB_ESP32 + QuadratureEsp32 encAxis3(3, AXIS3_ENCODER_A_PIN, AXIS3_ENCODER_B_PIN); + #elif AXIS3_ENCODER == CW_CCW + CwCcw encAxis3(3, AXIS3_ENCODER_A_PIN, AXIS3_ENCODER_B_PIN); + #elif AXIS3_ENCODER == PULSE_DIR + PulseDir encAxis3(3, AXIS3_ENCODER_A_PIN, AXIS3_ENCODER_B_PIN); + #elif AXIS3_ENCODER == PULSE_ONLY + PulseOnly encAxis3(3, AXIS3_ENCODER_A_PIN, &servoControlAxis3.directionHint); + #elif AXIS3_ENCODER == VIRTUAL + VirtualEnc encAxis3(3); + #elif AXIS3_ENCODER == SERIAL_BRIDGE + SerialBridge encAxis3(3); + #endif + + #if AXIS3_SERVO_FEEDBACK == PID + Pid feedbackAxis3(AXIS3_PID_P, AXIS3_PID_I, AXIS3_PID_D); + #elif AXIS3_SERVO_FEEDBACK == DUAL_PID + DualPid feedbackAxis3(AXIS3_PID_P, AXIS3_PID_I, AXIS3_PID_D, AXIS3_PID_P_GOTO, AXIS3_PID_I_GOTO, AXIS3_PID_D_GOTO, AXIS3_PID_SENSITIVITY); + #endif + + #if AXIS3_SERVO_FLTR == KALMAN + KalmanFilter filterAxis3(AXIS3_SERVO_FLTR_MEAS_U, AXIS3_SERVO_FLTR_VARIANCE); + #elif AXIS3_SERVO_FLTR == ROLLING + RollingFilter filterAxis3(AXIS3_SERVO_FLTR_WSIZE); + #elif AXIS3_SERVO_FLTR == OFF + Filter filterAxis3; + #endif + + const ServoPins DriverPinsAxis3 = {AXIS3_SERVO_PH1_PIN, AXIS3_SERVO_PH1_STATE, AXIS3_SERVO_PH2_PIN, AXIS3_SERVO_PH2_STATE, AXIS3_ENABLE_PIN, AXIS3_ENABLE_STATE, AXIS3_M0_PIN, AXIS3_M1_PIN, AXIS3_M2_PIN, AXIS3_M3_PIN, AXIS3_FAULT_PIN}; + const ServoSettings DriverSettingsAxis3 = {AXIS3_DRIVER_MODEL, AXIS3_DRIVER_STATUS, AXIS3_SERVO_ACCELERATION}; + + #if AXIS3_DRIVER_MODEL == SERVO_EE + ServoEE driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3); + #elif AXIS3_DRIVER_MODEL == SERVO_PE + ServoPE driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3); + #elif AXIS3_DRIVER_MODEL == SERVO_TMC2130_DC + ServoTmc2130DC driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3); + #elif AXIS3_DRIVER_MODEL == SERVO_TMC5160_DC + ServoTmc5160DC driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3); + #elif AXIS3_DRIVER_MODEL == SERVO_TMC2209 + ServoTmc2209 driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3, AXIS3_MOTOR_STEPS_PER_DEGREE/AXIS3_STEPS_PER_DEGREE, AXIS3_DRIVER_MICROSTEPS, AXIS3_DRIVER_IRUN, AXIS3_DRIVER_DECAY, AXIS3_DRIVER_DECAY_GOTO); + #elif AXIS3_DRIVER_MODEL == SERVO_TMC5160 + ServoTmc5160 driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3, AXIS3_MOTOR_STEPS_PER_DEGREE/AXIS3_STEPS_PER_DEGREE, AXIS3_DRIVER_MICROSTEPS, AXIS3_DRIVER_IRUN, AXIS3_DRIVER_DECAY, AXIS3_DRIVER_DECAY_GOTO); + #elif AXIS3_DRIVER_MODEL == SERVO_KTECH + ServoKTech driver3(3, &DriverSettingsAxis3, AXIS3_MOTOR_STEPS_PER_DEGREE/AXIS3_STEPS_PER_DEGREE); + #endif + + ServoMotor motor_3(3, AXIS3_REVERSE, ((ServoDriver*)&driver3), &filterAxis3, &encAxis3, AXIS3_ENCODER_ORIGIN, AXIS3_ENCODER_REVERSE == ON, &feedbackAxis3, &servoControlAxis3); + +#elif defined(AXIS3_STEP_DIR_PRESENT) + const StepDirDriverPins DriverPinsAxis3 = {AXIS3_M0_PIN, AXIS3_M1_PIN, AXIS3_M2_PIN, AXIS3_M2_ON_STATE, AXIS3_M3_PIN, AXIS3_DECAY_PIN, AXIS3_FAULT_PIN}; + const StepDirDriverSettings DriverSettingsAxis3 = {AXIS3_DRIVER_MODEL, AXIS3_DRIVER_STATUS, AXIS3_DRIVER_MICROSTEPS, AXIS3_DRIVER_MICROSTEPS_GOTO, AXIS3_DRIVER_DECAY, AXIS3_DRIVER_DECAY_GOTO}; + #if AXIS3_DRIVER_MODEL >= STEP_DIR_DRIVER_FIRST && AXIS3_DRIVER_MODEL < TMC_DRIVER_FIRST + StepDirGeneric driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3); + #elif AXIS3_DRIVER_MODEL == TMC2130 + StepDirTmc2130 driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3, AXIS3_DRIVER_IHOLD, AXIS3_DRIVER_IRUN, AXIS3_DRIVER_IGOTO, AXIS3_DRIVER_INTPOL); + #elif AXIS3_DRIVER_MODEL == TMC2160 + StepDirTmc2160 driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3, AXIS3_DRIVER_IHOLD, AXIS3_DRIVER_IRUN, AXIS3_DRIVER_IGOTO, AXIS3_DRIVER_INTPOL); + #elif AXIS3_DRIVER_MODEL == TMC2208 + StepDirTmc2208 driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3, AXIS3_DRIVER_IHOLD, AXIS3_DRIVER_IRUN, AXIS3_DRIVER_IGOTO, AXIS3_DRIVER_INTPOL); + #elif AXIS3_DRIVER_MODEL == TMC2209 || AXIS3_DRIVER_MODEL == TMC2226 + StepDirTmc2209 driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3, AXIS3_DRIVER_IHOLD, AXIS3_DRIVER_IRUN, AXIS3_DRIVER_IGOTO, AXIS3_DRIVER_INTPOL); + #elif AXIS3_DRIVER_MODEL == TMC2660 + StepDirTmc2660 driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3, AXIS3_DRIVER_IHOLD, AXIS3_DRIVER_IRUN, AXIS3_DRIVER_IGOTO, AXIS3_DRIVER_INTPOL); + #elif AXIS3_DRIVER_MODEL == TMC5160 + StepDirTmc5160 driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3, AXIS3_DRIVER_IHOLD, AXIS3_DRIVER_IRUN, AXIS3_DRIVER_IGOTO, AXIS3_DRIVER_INTPOL); + #elif AXIS3_DRIVER_MODEL == TMC5161 + StepDirTmc5161 driver3(3, &DriverPinsAxis3, &DriverSettingsAxis3, AXIS3_DRIVER_IHOLD, AXIS3_DRIVER_IRUN, AXIS3_DRIVER_IGOTO, AXIS3_DRIVER_INTPOL); + #endif + + const StepDirPins StepDirPinsAxis3 = {AXIS3_STEP_PIN, AXIS3_STEP_STATE, AXIS3_DIR_PIN, AXIS3_ENABLE_PIN, AXIS3_ENABLE_STATE}; + StepDirMotor motor_3(3, AXIS3_REVERSE, &StepDirPinsAxis3, ((StepDirDriver*)&driver3)); + +#else + #error "Configuration (Config.h): ROTATOR_PRESENT without AXIS3_DRIVER_MODEL should never happen!" +#endif + +const AxisPins PinsAxis3 = {AXIS3_SENSE_LIMIT_MIN_PIN, AXIS3_SENSE_HOME_PIN, AXIS3_SENSE_LIMIT_MAX_PIN, {AXIS3_SENSE_HOME, AXIS3_SENSE_HOME_INIT, AXIS3_SENSE_HOME_DIST_LIMIT, AXIS3_SENSE_LIMIT_MIN, AXIS3_SENSE_LIMIT_MAX, AXIS3_SENSE_LIMIT_INIT}}; +const AxisSettings SettingsAxis3 = {AXIS3_STEPS_PER_DEGREE, {AXIS3_LIMIT_MIN, AXIS3_LIMIT_MAX}, AXIS3_BACKLASH_RATE}; +} + +Motor& motor3 = motor_3; + +Axis axis3(3, &PinsAxis3, &SettingsAxis3, AXIS_MEASURE_DEGREES); + +#endif diff --git a/src/telescope/rotator/local/Rotator.can.command.cpp b/src/telescope/rotator/local/Rotator.can.command.cpp new file mode 100755 index 0000000..d1aa410 --- /dev/null +++ b/src/telescope/rotator/local/Rotator.can.command.cpp @@ -0,0 +1,264 @@ +//-------------------------------------------------------------------------------------------------- +// local telescope rotator control, using the CANbus interface + +#include "Rotator.h" + +#ifdef ROTATOR_CAN_SERVER_PRESENT + +#include "../../../lib/convert/Convert.h" +#include "../../../lib/axis/Axis.h" + +#include "../../mount/Mount.h" + +extern Axis axis3; + +// default command semantics (mirrors the common command contract): +// handled=true, numericReply=true, suppressFrame=false, commandError=CE_NONE +// numericReply=true means boolean/numeric-style responses (e.g., CE_1/CE_0/errors) rather than a payload +void Rotator::processCommand() { + if (!ready) return; + + bool handled = true; + bool numericReply = true; + bool suppressFrame = false; + CommandError commandError = CE_NONE; + + switch (opCode()) { + + // :hP# + case ROT_OP_PARK_HP: { + CommandError e = park(); + commandError = (e == CE_NONE) ? CE_1 : e; + } break; + + // :hR# + case ROT_OP_UNPARK_HR: { + CommandError e = unpark(); + commandError = (e == CE_NONE) ? CE_1 : e; + } break; + + // :rA# + case ROT_OP_ACTIVE_RA: { + commandError = CE_1; + } break; + + // :rT# + case ROT_OP_GET_STATUS_T: { + // "M" or "S" + optional "D" + optional "R" + rateDigit + writeU8(axis3.isSlewing() ? (uint8_t)'M' : (uint8_t)'S'); + if (!axis3.isSlewing()) { + if (derotatorEnabled) writeU8((uint8_t)'D'); + if (derotatorReverse) writeU8((uint8_t)'R'); + } + writeU8((uint8_t)('0' + getGotoRate())); + numericReply = false; + } break; + + // :rI# + case ROT_OP_GET_MIN_I: { + const int32_t deg = (int32_t)lround(axis3.getLimitMin()); + writeI32(deg); + numericReply = false; + } break; + + // :rM# + case ROT_OP_GET_MAX_M: { + const int32_t deg = (int32_t)lround(axis3.getLimitMax()); + writeI32(deg); + numericReply = false; + } break; + + // :rD# + case ROT_OP_GET_DEG_PERSTEP_D: { + const float degPerStep = (float)(1.0 / axis3.getStepsPerMeasure()); + writeF32(degPerStep); + numericReply = false; + } break; + + // :rb# or :rb[n]# + case ROT_OP_BACKLASH_b: { + // If args present, this is a set; otherwise it's a get. + if (remaining() == 0) { + const int16_t steps = (int16_t)lround(getBacklash()); + writeI16(steps); + numericReply = false; + } else { + int16_t steps = 0; + if (!readI16(steps)) { commandError = CE_PARAM_FORM; break; } + CommandError e = setBacklash((long)steps); + commandError = (e == CE_NONE) ? CE_1 : e; + } + } break; + + // :rQ# + case ROT_OP_STOP_Q: + if (axis3.isHoming()) { axis3.autoSlewAbort(); homing = false; } + else axis3.autoSlewStop(); + numericReply = false; + break; + + // :r[1..9]# + case ROT_OP_SET_RATE_1_9: { + uint8_t digit = 0; + if (!readU8(digit)) { commandError = CE_PARAM_FORM; break; } + if (digit < 1 || digit > 9) { commandError = CE_PARAM_RANGE; break; } + if (digit < 5) setMoveRate((int)digit); + else setGotoRate((int)digit - 4); + numericReply = false; + } break; + + // :rW# + case ROT_OP_GET_WORKRATE_W: { + const float dps = (float)settings.gotoRate; + writeF32(dps); + numericReply = false; + } break; + + // :rc# (ignored/no-op) + case ROT_OP_CONTINUOUS_c: + numericReply = false; + break; + + // :r># + case ROT_OP_MOVE_CW_GT: + commandError = move(DIR_FORWARD); + numericReply = false; + break; + + // :r<# + case ROT_OP_MOVE_CCW_LT: + commandError = move(DIR_REVERSE); + numericReply = false; + break; + + // :rG# + case ROT_OP_GET_ANGLE_G: { + const float deg = (float)axis3.getInstrumentCoordinate(); + writeF32(deg); + numericReply = false; + } break; + + // :rr[deg]# + case ROT_OP_GOTO_REL_rr: { + float rel = 0.0F; + if (!readF32(rel)) { commandError = CE_PARAM_FORM; break; } + const double t = axis3.getTargetCoordinate(); + commandError = gotoTarget((double)t + (double)rel); + numericReply = false; + } break; + + // :rS[deg]# + case ROT_OP_GOTO_S: { + float deg = 0.0F; + if (!readF32(deg)) { commandError = CE_PARAM_FORM; break; } + commandError = gotoTarget(deg); + // numericReply left as default (true) + } break; + + // :rZ# + case ROT_OP_ZERO_Z: + settings.parkState = PS_UNPARKED; + commandError = axis3.resetPosition(0.0); + axis3.setBacklashSteps(getBacklash()); + numericReply = false; + break; + + // :rF# + case ROT_OP_HALFTRAVEL_F: + settings.parkState = PS_UNPARKED; + commandError = axis3.resetPosition((axis3.getLimitMax() + axis3.getLimitMin())/2.0F); + axis3.setBacklashSteps(getBacklash()); + numericReply = false; + break; + + // :rC# + case ROT_OP_HALFTARGET_C: { + if (AXIS3_SENSE_HOME != OFF) { + if (settings.parkState == PS_UNPARKED) { + axis3.enable(true); + axis3.setFrequencySlew(settings.gotoRate); + commandError = axis3.autoSlewHome(); + if (commandError == CE_NONE) homing = true; + } else commandError = CE_PARKED; + } else { + commandError = gotoTarget((axis3.getLimitMax() + axis3.getLimitMin())/2.0F); + } + numericReply = false; + } break; + + // :r+# + case ROT_OP_DEROT_EN_PLUS: + #ifdef MOUNT_PRESENT + if (transform.mountType == ALTAZM) { + if (settings.parkState == PS_UNPARKED) derotatorEnabled = true; + else commandError = CE_PARKED; + } + #endif + numericReply = false; + break; + + // :r-# + case ROT_OP_DEROT_DIS_MINUS: + derotatorEnabled = false; + axis3.setSynchronizedFrequency(0.0F); + numericReply = false; + break; + + // :rP# + case ROT_OP_GOTO_PAR_P: + #ifdef MOUNT_PRESENT + { + Coordinate current = mount.getPosition(); + commandError = gotoTarget(parallacticAngle(¤t)); + } + #endif + numericReply = false; + break; + + // :rR# + case ROT_OP_DEROT_REV_R: + derotatorReverse = !derotatorReverse; + numericReply = false; + break; + + // :GX98# + case ROT_OP_AVAIL_GX98: { + uint8_t c = (uint8_t)'N'; + #if defined(MOUNT_PRESENT) + if (transform.mountType == ALTAZM) c = (uint8_t)'D'; + else c = (uint8_t)'R'; + #else + c = (uint8_t)'R'; + #endif + writeU8(c); + numericReply = false; + } break; + + // :GXU3# + case ROT_OP_DRIVER_STATUS: { + DriverStatus status = axis3.motor->getDriverStatus(); + if (status.active) { + uint8_t packedStatus = 0; + packedStatus |= (status.standstill ? 1: 0); + packedStatus |= (status.outputA.openLoad ? 1 : 0) << 1; + packedStatus |= (status.outputB.openLoad ? 1 : 0) << 2; + packedStatus |= (status.outputA.shortToGround ? 1 : 0) << 3; + packedStatus |= (status.outputB.shortToGround ? 1 : 0) << 4; + packedStatus |= (status.overTemperature ? 1 : 0) << 5; + packedStatus |= (status.overTemperatureWarning ? 1 : 0) << 6; + packedStatus |= (status.fault ? 1 : 0) << 7; + writeU8(packedStatus); + numericReply = false; + } else commandError = CE_0; + } break; + + default: + handled = false; + commandError = CE_CMD_UNKNOWN; + break; + } + + sendResponse(handled, suppressFrame, numericReply, commandError); +} + +#endif diff --git a/src/telescope/rotator/local/Rotator.command.cpp b/src/telescope/rotator/local/Rotator.command.cpp new file mode 100755 index 0000000..e5c0ce4 --- /dev/null +++ b/src/telescope/rotator/local/Rotator.command.cpp @@ -0,0 +1,270 @@ +//-------------------------------------------------------------------------------------------------- +// local telescope rotator control, commands + +#include "Rotator.h" + +#ifdef ROTATOR_PRESENT + +#include "../../../lib/convert/Convert.h" +#include "../../../lib/axis/Axis.h" +#include "../../mount/Mount.h" + +extern Axis axis3; + +// by default reply[80] == "", suppressFrame == false, numericReply == true, and commandError == CE_NONE +// return true if the command has been completely handled and no further command() will be called, or false if not +// for commands that are handled repeatedly commandError might contain CE_NONE or CE_1 to indicate success +// numericReply=true means boolean/numeric-style responses (e.g., CE_1/CE_0/errors) rather than a payload +bool Rotator::command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError) { + if (!ready) return false; + + // process any rotator axis commands + if (axis3.command(reply, command, parameter, suppressFrame, numericReply, commandError)) return true; + + if (command[0] == 'h') { + // :hP# Moves rotator to the park position + // Return: 0 on failure + // 1 on success + if (command[1] == 'P' && parameter[0] == 0) { + CommandError e = park(); + if (e == CE_NONE) *commandError = CE_1; else { VF("MSG: Rotator, park error "); VL(e); *commandError = e; } + return false; + } else + + // :hR# Restore parked rotator to operation + // Return: 0 on failure + // 1 on success + if (command[1] == 'R' && parameter[0] == 0) { + CommandError e = unpark(); + if (e == CE_NONE) *commandError = CE_1; else { VF("MSG: Rotator, unpark error "); VL(e); *commandError = e; } + return false; + } else return false; + } else + + // r - rotator Commands + if (command[0] == 'r') { + + // :rA# rotator Active? + // Return: 0 on failure (no rotator) + // 1 on success + if (command[1] == 'A' && parameter[0] == 0) { + // empty command for success response 1 + } else + + // :rT# Get rotator sTatus + // Returns: s# + if (command[1] == 'T') { + if (axis3.isSlewing()) strcat(reply, "M"); else { // [M]oving + strcat(reply, "S"); // [S]topped) + if (derotatorEnabled) strcat(reply, "D"); // [D]e-Rotate enabled + if (derotatorReverse) strcat(reply, "R"); // De-Rotate [R]everse + } + char temp[2] = "0"; temp[0] = '0' + getGotoRate(); strcat(reply, temp); // [1] to [5] for 0.5x to 2x goto rate + *numericReply = false; + } else + + // :rI# Get rotator mInimum position (in degrees) + // Returns: n# + if (command[1] == 'I') { + sprintf(reply, "%ld",(long)round(axis3.getLimitMin())); + *numericReply = false; + } else + + // :rM# Get rotator Max position (in degrees) + // Returns: n# + if (command[1] == 'M') { + sprintf(reply, "%ld",(long)round(axis3.getLimitMax())); + *numericReply = false; + } else + + // :rD# Get rotator degrees per step + // Returns: n.n# + if (command[1] == 'D') { + sprintF(reply, "%7.5f", 1.0/axis3.getStepsPerMeasure()); + *numericReply = false; + } else + + // :rb# Get rotator Backlash amount (in steps) + // Return: n# + if (command[1] == 'b' && parameter[0] == 0) { + sprintf(reply, "%ld",(long)round(getBacklash())); + *numericReply = false; + } else + + // :rb[n]# Set rotator Backlash amount (in steps) + // Return: 0 on failure + // 1 on success + if (command[1] == 'b') { + *commandError = setBacklash(atol(parameter)); + } else + + // :rQ# Stop (Quit) rotator movement + // Returns: Nothing + if (command[1] == 'Q') { + if (axis3.isHoming()) { + axis3.autoSlewAbort(); + homing = false; + } else axis3.autoSlewStop(); + *numericReply = false; + } else + + // :r[n]# Set rotator move or goto rate + // move where n = 1 for 0.01 deg/s, 2 for 0.1 deg/s, 3 for 1.0 deg/s, 4 for 0.5x goto rate + // goto rate where n = 5 for 0.5x, 6 for 0.66x, 7 for 1x, 8 for 1.5x, 9 for 2x AXISn_SLEW_RATE_BASE_DESIRED + // Returns: Nothing + if (command[1] >= '1' && command[1] <= '9') { + if (strlen(parameter) == 0) { + int v = command[1] - '0'; + if (v < 5) setMoveRate(v); else setGotoRate(v - 4); + } else *commandError = CE_PARAM_FORM; + *numericReply = false; + } else + + // :rW# Get working slew rate in deg/s + // Returns: d.d# + if (command[1] == 'W') { + sprintF(reply, "%0.1f", settings.gotoRate); + *numericReply = false; + } else + + // :rc# Set continious move + // Returns: Nothing + if (command[1] == 'c') { + // this command is ignored, all rotator movement in OnStepX is continious + *numericReply = false; + } else + + // :r># Move rotator CW + // Returns: Nothing + if (command[1] == '>') { + *commandError = move(DIR_FORWARD); + *numericReply = false; + } else + + // :r<# Move rotator CCW + // Returns: Nothing + if (command[1] == '<') { + *commandError = move(DIR_REVERSE); + *numericReply = false; + } else + + // :rG# Get rotator current angle + // Returns: sDDD*MM# + if (command[1] == 'G') { + convert.doubleToDms(reply, axis3.getInstrumentCoordinate(), true, true, PM_LOW); + *numericReply = false; + } else + + // :rr[sDDD*MM, etc.]# + // Set rotator target angle relative (in degrees) + // Returns: Nothing + if (command[1] == 'r') { + double r, t; + convert.dmsToDouble(&r, parameter, true); + t = axis3.getTargetCoordinate(); + *commandError = gotoTarget(t + r); + *numericReply = false; + } else + + // :rS[sDDD*MM, etc.]# + // Move rotator to Set target angle (in degrees) + // Return: 0 on failure + // 1 on success + if (command[1] == 'S') { + int i = 0; + double t, s = 1.0; + if (parameter[0] == '-') s = -1.0; + if (parameter[0] == '+' || parameter[0] == '-') i = 1; + if (convert.dmsToDouble(&t, ¶meter[i], false)) *commandError = gotoTarget(s*t); else *commandError = CE_PARAM_FORM; + } else + + // :rZ# Set rotator position to Zero degrees + // Returns: Nothing + if (command[1] == 'Z') { + settings.parkState = PS_UNPARKED; + *commandError = axis3.resetPosition(0.0); + axis3.setBacklashSteps(getBacklash()); + *numericReply = false; + } else + + // :rF# Set rotator position as Half-travel + // Returns: Nothing + if (command[1] == 'F') { + settings.parkState = PS_UNPARKED; + *commandError = axis3.resetPosition((axis3.getLimitMax() + axis3.getLimitMin())/2.0F); + axis3.setBacklashSteps(getBacklash()); + *numericReply = false; + } else + + // :rC# Move rotator to half-travel target position + // Returns: Nothing + if (command[1] == 'C') { + if (AXIS3_SENSE_HOME != OFF) { + if (settings.parkState == PS_UNPARKED) { + axis3.enable(true); + axis3.setFrequencySlew(settings.gotoRate); + *commandError = axis3.autoSlewHome(); + if (*commandError == CE_NONE) { + homing = true; + } + } else *commandError = CE_PARKED; + } else { + *commandError = gotoTarget((axis3.getLimitMax() + axis3.getLimitMin())/2.0F); + } + *numericReply = false; + } else + + // :r+# Derotator Enable + // Returns: Nothing + if (command[1] == '+') { + #ifdef MOUNT_PRESENT + if (transform.mountType == ALTAZM) { + if (settings.parkState == PS_UNPARKED) derotatorEnabled = true; else *commandError = CE_PARKED; + } + #endif + *numericReply = false; + } else + + // :r-# Derotator Disable + // Returns: Nothing + if (command[1] == '-') { + derotatorEnabled = false; + axis3.setSynchronizedFrequency(0.0F); + *numericReply = false; + } else + + // :rP# Rotator move to parallactic angle + // Returns: Nothing + if (command[1] == 'P') { + #ifdef MOUNT_PRESENT + Coordinate current = mount.getPosition(); + *commandError = gotoTarget(parallacticAngle(¤t)); + #endif + *numericReply = false; + } else + + // :rR# Derotator Reverse direction + // Returns: Nothing + if (command[1] == 'R') { + derotatorReverse = !derotatorReverse; + *numericReply = false; + } else *commandError = CE_CMD_UNKNOWN; + + } else + + // :GX98# Get rotator availablity + // Returns: D# for rotate/derotate + // R# for rotate only + // N# for none + if (command[0] == 'G' && command[1] == 'X' && parameter[0] == '9' && parameter[1] == '8' && parameter[2] == 0) { + *numericReply = false; + #if defined(MOUNT_PRESENT) + if (transform.mountType == ALTAZM) strcpy(reply, "D"); else + #endif + strcpy(reply, "R"); + } else return false; + + return true; +} + +#endif diff --git a/src/telescope/rotator/local/Rotator.cpp b/src/telescope/rotator/local/Rotator.cpp new file mode 100755 index 0000000..005071c --- /dev/null +++ b/src/telescope/rotator/local/Rotator.cpp @@ -0,0 +1,320 @@ +//-------------------------------------------------------------------------------------------------- +// local telescope rotator control + +#include "Rotator.h" + +#ifdef ROTATOR_PRESENT + +#include "../../../lib/tasks/OnTask.h" +#include "../../../lib/nv/Nv.h" + +#include "../../Telescope.h" +#include "../../mount/Mount.h" +#include "../../mount/site/Site.h" + +void rotWrapper() { rotator.monitor(); } + +#if defined(ROTATOR_CAN_SERVER_PRESENT) +// 1 Hz heartbeat TX for this remote rotator node +static void rotHeartbeatWrapper() { + if (!canPlus.ready) return; + const uint16_t hbId = (uint16_t)(CAN_ROTATOR_HB_ID_BASE); + const uint8_t b = 0; // payload reserved; currently unused + canPlus.writePacket((int)hbId, &b, 1); +} +#endif + +// initialize rotator +bool Rotator::init() { + if (ready) return true; + + // time to wait before writing position to nv after last movement of rotator + if (nv().device().endurance() == NvDevice::Endurance::Mid) writeDelay = 60; else + if (nv().device().endurance() == NvDevice::Endurance::High) writeDelay = 5; + + #if defined(ROTATOR_CAN_SERVER_PRESENT) + if (!CanTransportServer::init(true, 2)) return false; + #endif + + nvKey = nv().kv().computeKey("ROTATOR_SETTINGS"); + if (!nv().kv().getOrInit(nvKey, settings)) { DLF("WRN: Nv, init failed for ROTATOR_SETTINGS"); } + + settings.backlash = constrain(settings.backlash, 0, 10000); + settings.gotoRate = constrain(settings.gotoRate, 0.125, 20); + settings.parkState = constrain(settings.parkState, PS_PARK_FAILED, PS_UNPARKING); + settings.position = constrain(settings.position, AXIS3_LIMIT_MIN, AXIS3_LIMIT_MAX); + + VLF("MSG: Rotator, init (Axis3)"); + if (!axis3.init(&motor3)) { + initError.driver = true; + DLF("ERR: Rotator::init(), no motion controller for Axis3!"); + return false; + } + axis3.resetPositionSteps(0); + axis3.setBacklashSteps(settings.backlash); + axis3.setFrequencyMax(AXIS3_SLEW_RATE_BASE_DESIRED*2.0F); + axis3.setFrequencyMin(0.01F); + axis3.setFrequencySlew(AXIS3_SLEW_RATE_BASE_DESIRED); + axis3.setSlewAccelerationTime(AXIS3_ACCELERATION_TIME); + axis3.setSlewAccelerationTimeAbort(AXIS3_RAPID_STOP_TIME); + if (AXIS3_POWER_DOWN == ON) axis3.setPowerDownTime(AXIS3_POWER_DOWN_TIME); + + ready = true; + + return true; +} + +void Rotator::begin() { + if (!ready) return; + + axis3.calibrateDriver(); + + // start monitor task + VF("MSG: Rotator, start derotation task (rate 1s priority 6)... "); + if (tasks.add(1000, 0, true, 6, rotWrapper, "RotMon")) { VLF("success"); } else { VLF("FAILED!"); } + + // start heartbeat task + #if defined(ROTATOR_CAN_SERVER_PRESENT) + VF("MSG: Rotator, starting CAN heartbeat task (rate 1s priority 6)... "); + if (tasks.add(1000, 0, true, 6, rotHeartbeatWrapper, "RotHB")) { VLF("success"); } else { VLF("FAILED!"); } + #endif + + unpark(); +} + +// get backlash in steps +int Rotator::getBacklash() { + return settings.backlash; +} + +// set backlash in steps +CommandError Rotator::setBacklash(int value) { + if (!ready) return CE_CMD_UNKNOWN; + + if (value < 0 || value > 10000) return CE_PARAM_RANGE; + if (settings.parkState >= PS_PARKED) return CE_PARKED; + + settings.backlash = value; + nv().kv().put(nvKey, settings); + axis3.setBacklashSteps(settings.backlash); + + return CE_NONE; +} + +#ifdef MOUNT_PRESENT + // returns parallactic angle in degrees + double Rotator::parallacticAngle(Coordinate *coord) { + return radToDeg(atan2(sin(coord->h), cos(coord->d)*tan(site.location.latitude) - sin(coord->d)*cos(coord->h))); + } + + // returns parallactic rate in degrees per second + double Rotator::parallacticRate(Coordinate *coord) { + // one minute of hour angle in degrees = 15/60 = 0.25 + Coordinate ahead = *coord; + ahead.h += degToRad(0.125); + Coordinate behind = *coord; + behind.h -= degToRad(0.125); + double b = parallacticAngle(&behind); + double a = parallacticAngle(&ahead); + if (b > 90.0 && a < -90.0) a += 360.0; + if (b < -90.0 && a > 90.0) b += 360.0; + return (a - b)/60.0; + } +#endif + +// set move rate, 1 for 0.01 deg/sec slew, 2 for 0.1 deg/sec, 3 for 1 deg/sec, 4 for 0.5x goto rate +void Rotator::setMoveRate(int value) { + if (!ready) return; + + switch (value) { + case 1: moveRate = 0.01F; break; + case 2: moveRate = 0.1F; break; + case 3: moveRate = 1.0F; break; + case 4: moveRate = settings.gotoRate/2.0F; break; + default: moveRate = 0.1F; break; + } + if (moveRate > settings.gotoRate/2.0F) moveRate = settings.gotoRate/2.0F; +} + +// start slew in the specified direction +CommandError Rotator::move(Direction dir) { + if (!ready) return CE_CMD_UNKNOWN; + + if (settings.parkState >= PS_PARKED) return CE_PARKED; + + axis3.enable(true); + axis3.setSynchronizedFrequency(0.0F); + + return axis3.autoSlew(dir, moveRate); +} + +// get goto rate, 1 for 0.5x base, 2 for 0.66x base, 3 for base, 4 for 1.5x base, 5 for 2x base +int Rotator::getGotoRate() { + if (settings.gotoRate < AXIS3_SLEW_RATE_BASE_DESIRED/1.75) return 1; + if (settings.gotoRate < AXIS3_SLEW_RATE_BASE_DESIRED/1.25) return 2; + if (settings.gotoRate < AXIS3_SLEW_RATE_BASE_DESIRED*1.25) return 3; + if (settings.gotoRate < AXIS3_SLEW_RATE_BASE_DESIRED*1.75) return 4; else return 5; +} + +// set goto rate, 1 for 0.5x base, 2 for 0.66x base, 3 for base, 4 for 1.5x base, 5 for 2x base +void Rotator::setGotoRate(int value) { + switch (value) { + case 1: settings.gotoRate = AXIS3_SLEW_RATE_BASE_DESIRED/2.0; break; + case 2: settings.gotoRate = AXIS3_SLEW_RATE_BASE_DESIRED/1.5; break; + case 3: settings.gotoRate = AXIS3_SLEW_RATE_BASE_DESIRED*1.0; break; + case 4: settings.gotoRate = AXIS3_SLEW_RATE_BASE_DESIRED*1.5; break; + case 5: settings.gotoRate = AXIS3_SLEW_RATE_BASE_DESIRED*2.0; break; + default: settings.gotoRate = AXIS3_SLEW_RATE_BASE_DESIRED; break; + } + nv().kv().put(nvKey, settings); +} + +// move rotator to a specific location +CommandError Rotator::gotoTarget(float target) { + if (!ready) return CE_CMD_UNKNOWN; + + if (settings.parkState >= PS_PARKED) return CE_PARKED; + + VF("MSG: Rotator, goto target coordinate set ("); V(target); VL(" deg)"); + VLF("MSG: Rotator, attempting goto"); + + axis3.enable(true); + axis3.setSynchronizedFrequency(0.0F); + axis3.setTargetCoordinate(target); + + CommandError e = axis3.autoGoto(settings.gotoRate); + if (e != CE_NONE) { VLF("MSG: Rotator, goto failed"); } + + return e; +} + +// parks rotator at current position +CommandError Rotator::park() { + if (!ready) return CE_CMD_UNKNOWN; + + if (settings.parkState == PS_PARKED) return CE_NONE; + if (settings.parkState == PS_PARKING) return CE_PARK_FAILED; + if (settings.parkState == PS_UNPARKING) return CE_PARK_FAILED; + if (settings.parkState == PS_PARK_FAILED) return CE_PARK_FAILED; + + derotatorEnabled = false; + + VLF("MSG: Rotator, parking"); + + axis3.enable(true); + axis3.setBacklash(0.0F); + settings.position = axis3.getInstrumentCoordinate(); + axis3.setTargetCoordinatePark(settings.position); + + CommandError e = axis3.autoGoto(settings.gotoRate); + + if (e == CE_NONE) { + settings.parkState = PS_PARKING; + nv().kv().put(nvKey, settings); + } + + return e; +} + +// unparks rotator +CommandError Rotator::unpark() { + if (!ready) return CE_CMD_UNKNOWN; + + if (settings.parkState == PS_PARKING) return CE_PARK_FAILED; + if (settings.parkState == PS_UNPARKING) return CE_PARK_FAILED; + if (settings.parkState == PS_PARK_FAILED) return CE_PARK_FAILED; + + // setting write delay to 0 disables on-the-fly position writes and forces strict parking + if (writeDelay == 0) { + if (settings.parkState != PS_PARKED) return CE_NOT_PARKED; + } + + axis3.enable(true); + VF("MSG: Rotator, unpark position "); V(settings.position); VL(" deg"); + + // simple unpark if we didn't actually park + if (settings.parkState == PS_UNPARKED) { + axis3.setInstrumentCoordinate(settings.position); + nv().kv().put(nvKey, settings); + return CE_NONE; + } + + axis3.setBacklash(0.0F); + axis3.setInstrumentCoordinatePark(settings.position); + + axis3.setBacklash(settings.backlash); + axis3.setTargetCoordinate(settings.position); + + CommandError e = axis3.autoGoto(settings.gotoRate); + + if (e == CE_NONE) { + settings.parkState = PS_UNPARKING; + nv().kv().put(nvKey, settings); + } + + return e; +} + +// poll rotator to handle parking and derotation +void Rotator::monitor() { + secs++; + + if (axis3.isSlewing() || settings.position == axis3.getInstrumentCoordinate()) writeTime = secs + writeDelay; + + if (!axis3.isSlewing()) { + + if (settings.parkState == PS_PARKING) { + if (axis3.atTarget()) { + axis3.enable(false); + settings.parkState = PS_PARKED; + nv().kv().put(nvKey, settings); + #if DEBUG == VERBOSE + long offset = axis3.getInstrumentCoordinateSteps() - axis3.getMotorPositionSteps(); + VF("MSG: Rotator, park motor target "); VL(axis3.getTargetCoordinateSteps() - offset); + VF("MSG: Rotator, park motor position "); VL(axis3.getMotorPositionSteps()); + #endif + } + } else + + if (settings.parkState == PS_UNPARKING) { + if (axis3.atTarget()) { + settings.parkState = PS_UNPARKED; + nv().kv().put(nvKey, settings); + } + } else + + if (settings.parkState == PS_UNPARKED) { + #ifdef MOUNT_PRESENT + if (derotatorEnabled && transform.mountType == ALTAZM) { + float pr = 0.0F; + if (!axis3.getSynchronized()) axis3.setSynchronized(true); + Coordinate current = mount.getPosition(); + pr = parallacticRate(¤t); + if (derotatorReverse) pr = -pr; + axis3.setSynchronized(true); + axis3.setSynchronizedFrequency(pr); + } + #endif + + if (homing) { + axis3.resetPosition((axis3.getLimitMax() + axis3.getLimitMin())/2.0F); + axis3.setBacklashSteps(getBacklash()); + homing = false; + } + + // delayed write of rotator position + if (writeDelay != 0) { + if (secs > writeTime) { + settings.position = axis3.getInstrumentCoordinate(); + nv().kv().put(nvKey, settings); + VF("MSG: Rotator, writing position ("); V(settings.position); VL(" deg) to NV"); + } + } + } + + } +} + +Rotator rotator; + +#endif diff --git a/src/telescope/rotator/local/Rotator.h b/src/telescope/rotator/local/Rotator.h new file mode 100755 index 0000000..c89f5a0 --- /dev/null +++ b/src/telescope/rotator/local/Rotator.h @@ -0,0 +1,109 @@ +//-------------------------------------------------------------------------------------------------- +// local telescope rotator control +#pragma once + +#include "../../../Common.h" + +#include "../RotatorBase.h" + +#ifdef ROTATOR_PRESENT + +#include "../../../lib/nv/Nv.h" +#include "../../../lib/axis/Axis.h" +#include "../../../libApp/commands/ProcessCmds.h" +#include "../../Telescope.h" +#include "../../mount/coordinates/Transform.h" + +#pragma pack(1) +#define RotatorSettingsSize 11 +typedef struct RotatorSettings { + ParkState parkState; + int16_t backlash; // in steps + float position; // in degrees + float gotoRate; // in degrees/s +} RotatorSettings; +#pragma pack() + +#ifdef ROTATOR_CAN_SERVER_PRESENT +#include "../../../lib/canTransport/CanTransportServer.h" +class Rotator : public CanTransportServer { +private: + void processCommand() override; +public: + Rotator() : CanTransportServer((uint16_t)(CAN_ROTATOR_REQ_ID), (uint16_t)(CAN_ROTATOR_RSP_ID)) {} +#else +class Rotator { +public: +#endif + + // initialize rotator + bool init(); + void begin(); + + // process rotator commands + bool command(char *reply, char *command, char *parameter, bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // poll rotator to handle parking and derotation + void monitor(); + +private: + // get backlash in steps + int getBacklash(); + + // set backlash in steps + CommandError setBacklash(int value); + + #ifdef MOUNT_PRESENT + // returns parallactic angle in degrees + double parallacticAngle(Coordinate *coord); + + // returns parallactic rate in degrees per second + double parallacticRate(Coordinate *coord); + #endif + + // set move rate + void setMoveRate(int value); + + // start slew in the specified direction + CommandError move(Direction dir); + + // get goto rate, 1 for 0.5x base, 2 for 0.66x base, 3 for base, 4 for 1.5x base, 5 for 2x base + int getGotoRate(); + + // set goto rate, 1 for 0.5x base, 2 for 0.66x base, 3 for base, 4 for 1.5x base, 5 for 2x base + void setGotoRate(int value); + + // move rotator to a specific location + CommandError gotoTarget(float target); + + // parks rotator at current position + CommandError park(); + + // unparks rotator + CommandError unpark(); + + float moveRate = 0.1; // in degs/sec + + RotatorSettings settings = {PS_UNPARKED, 0, 0.0F, AXIS3_SLEW_RATE_BASE_DESIRED}; + + bool ready = false; + + bool derotatorEnabled = false; + bool derotatorReverse = false; + bool homing = false; + + unsigned long writeTime = 0; + unsigned long secs = 0; + + uint8_t parkHandle = 0; + + uint16_t writeDelay = 600; // time in seconds + uint32_t nvKey; +}; + +extern Motor& motor3; +extern Axis axis3; + +extern Rotator rotator; + +#endif diff --git a/src/telescope/rotator/remote/Rotator.can.decode.cpp b/src/telescope/rotator/remote/Rotator.can.decode.cpp new file mode 100755 index 0000000..332aae8 --- /dev/null +++ b/src/telescope/rotator/remote/Rotator.can.decode.cpp @@ -0,0 +1,95 @@ +//-------------------------------------------------------------------------------------------------- +// remote telescope rotator control, using the CANbus interface (CAN client decode) + +#include "Rotator.h" + +#if defined(ROTATOR_CAN_CLIENT_PRESENT) + +#include "../../../lib/convert/Convert.h" + +bool Rotator::decodeResponse(char *reply) { + if (!reply) return false; + reply[0] = 0; + + switch (opCode()) { + + // :rT# -> RX: ASCII bytes "M"/"S"["D"]["R"] + rateDigit + // Accept variable length and copy as-is. + case ROT_OP_GET_STATUS_T: { + int16_t dataLen = readRemainingBytes((uint8_t*)reply); + reply[dataLen] = 0; + } break; + + // :rG# -> RX: f32 degrees; convert to DMS string for LX200 output + case ROT_OP_GET_ANGLE_G: { + float deg = 0.0f; + if (!readF32(deg)) return false; + convert.doubleToDms(reply, (double)deg, true, true, PM_LOW); + } break; + + // :rI# -> RX: i32 degrees (rounded) + case ROT_OP_GET_MIN_I: { + int32_t deg = 0; + if (!readI32(deg)) return false; + sprintf(reply, "%ld", (long)deg); + } break; + + // :rM# -> RX: i32 degrees (rounded) + case ROT_OP_GET_MAX_M: { + int32_t deg = 0; + if (!readI32(deg)) return false; + sprintf(reply, "%ld", (long)deg); + } break; + + // :rD# -> RX: f32 deg_per_step + case ROT_OP_GET_DEG_PERSTEP_D: { + float dps = 0.0f; + if (!readF32(dps)) return false; + sprintF(reply, "%7.5f", dps); + } break; + + // :rb# -> RX: i16 steps (read mode) OR no payload (write mode) + case ROT_OP_BACKLASH_b: { + int16_t steps = 0; + if (!readI16(steps)) return false; + sprintf(reply, "%ld", (long)steps); + } break; + + // :rW# -> RX: f32 deg_per_sec (settings.gotoRate) + case ROT_OP_GET_WORKRATE_W: { + float dps = 0.0f; + if (!readF32(dps)) return false; + sprintF(reply, "%0.1f", dps); + } break; + + // :GX98# -> RX: u8 ASCII 'D'/'R'/'N' + case ROT_OP_AVAIL_GX98: { + uint8_t c = 0; + if (!readU8(c)) return false; + reply[0] = (char)c; + reply[1] = 0; + } break; + + // :GXU3# -> RX u8 packed status + case ROT_OP_DRIVER_STATUS: { + uint8_t packedStatus; + readU8(packedStatus); + strcat(reply, ( packedStatus & 1) ? "ST," : ","); + strcat(reply, ((packedStatus << 1) & 1) ? "OA," : ","); + strcat(reply, ((packedStatus << 2) & 1) ? "OB," : ","); + strcat(reply, ((packedStatus << 3) & 1) ? "GA," : ","); + strcat(reply, ((packedStatus << 4) & 1) ? "GB," : ","); + strcat(reply, ((packedStatus << 5) & 1) ? "OT," : ","); // > 150C + strcat(reply, ((packedStatus << 6) & 1) ? "PW," : ","); // > 120C + strcat(reply, ((packedStatus << 7) & 1) ? "GF" : ""); + } break; + + default: + // Most ops are "no reply payload"; empty reply is fine + reply[0] = 0; + } + + return true; +} + +#endif diff --git a/src/telescope/rotator/remote/Rotator.can.encode.cpp b/src/telescope/rotator/remote/Rotator.can.encode.cpp new file mode 100755 index 0000000..f04a8e2 --- /dev/null +++ b/src/telescope/rotator/remote/Rotator.can.encode.cpp @@ -0,0 +1,187 @@ +//-------------------------------------------------------------------------------------------------- +// remote telescope rotator control, using the CANbus interface + +#include "Rotator.h" + +#if defined(ROTATOR_CAN_CLIENT_PRESENT) + +#include "../../../lib/convert/Convert.h" + +bool Rotator::encodeRequest(char *command, char *parameter) { + // Contract: both pointers are always provided by the command router. + if (!command || !parameter) return false; + + // -------------------------------------------------------------------------- + // h - park/unpark + // -------------------------------------------------------------------------- + if (command[0] == 'h') { + + // :hP# + if (command[1] == 'P' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_PARK_HP)) return false; + } else + + // :hR# + if (command[1] == 'R' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_UNPARK_HR)) return false; + } else + return false; + + } else + + // -------------------------------------------------------------------------- + // r - rotator commands (keep same order as Rotator.command.cpp) + // -------------------------------------------------------------------------- + if (command[0] == 'r') { + + // :rA# + if (command[1] == 'A' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_ACTIVE_RA)) return false; + } else + + // :rT# + if (command[1] == 'T' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_GET_STATUS_T)) return false; + } else + + // :rI# + if (command[1] == 'I' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_GET_MIN_I)) return false; + } else + + // :rM# + if (command[1] == 'M' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_GET_MAX_M)) return false; + } else + + // :rD# + if (command[1] == 'D' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_GET_DEG_PERSTEP_D)) return false; + } else + + // :rb# (get) + if (command[1] == 'b' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_BACKLASH_b)) return false; + } else + + // :rb[n]# (set) + if (command[1] == 'b' && parameter[0] != 0) { + if (!beginNewRequest(ROT_OP_BACKLASH_b)) return false; + if (!writeI16((int16_t)atol(parameter))) return false; + } else + + // :rQ# + if (command[1] == 'Q' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_STOP_Q)) return false; + } else + + // :r[1..9]# (no parameter allowed) + if (command[1] >= '1' && command[1] <= '9') { + if (parameter[0] != 0) return false; + if (!beginNewRequest(ROT_OP_SET_RATE_1_9)) return false; + if (!writeU8((uint8_t)(command[1] - '0'))) return false; + } else + + // :rW# + if (command[1] == 'W' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_GET_WORKRATE_W)) return false; + } else + + // :rc# + if (command[1] == 'c' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_CONTINUOUS_c)) return false; + } else + + // :r># + if (command[1] == '>' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_MOVE_CW_GT)) return false; + } else + + // :r<# + if (command[1] == '<' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_MOVE_CCW_LT)) return false; + } else + + // :rG# + if (command[1] == 'G' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_GET_ANGLE_G)) return false; + } else + + // :rr[sDDD*MM, etc.]# + if (command[1] == 'r' && parameter[0] != 0) { + double r = 0.0; + if (!convert.dmsToDouble(&r, parameter, true)) return false; + if (!beginNewRequest(ROT_OP_GOTO_REL_rr)) return false; + if (!writeF32((float)r)) return false; + } else + + // :rS[sDDD*MM, etc.]# + if (command[1] == 'S' && parameter[0] != 0) { + int i = 0; + double t = 0.0, s = 1.0; + if (parameter[0] == '-') s = -1.0; + if (parameter[0] == '+' || parameter[0] == '-') i = 1; + if (!convert.dmsToDouble(&t, ¶meter[i], false)) return false; + + if (!beginNewRequest(ROT_OP_GOTO_S)) return false; + if (!writeF32((float)(s * t))) return false; + } else + + // :rZ# + if (command[1] == 'Z' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_ZERO_Z)) return false; + } else + + // :rF# + if (command[1] == 'F' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_HALFTRAVEL_F)) return false; + } else + + // :rC# + if (command[1] == 'C' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_HALFTARGET_C)) return false; + } else + + // :r+# + if (command[1] == '+' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_DEROT_EN_PLUS)) return false; + } else + + // :r-# + if (command[1] == '-' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_DEROT_DIS_MINUS)) return false; + } else + + // :rP# + if (command[1] == 'P' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_GOTO_PAR_P)) return false; + } else + + // :rR# + if (command[1] == 'R' && parameter[0] == 0) { + if (!beginNewRequest(ROT_OP_DEROT_REV_R)) return false; + } else + return false; + + return true; + } else + + if (command[0] == 'G' && command[1] == 'X') { + // :GX98# Get rotator availability + if (parameter[0] == '9' && parameter[1] == '8' && parameter[2] == 0) { + if (!beginNewRequest(ROT_OP_AVAIL_GX98)) return false; + } else + + // :GXU3# Get rotator driver status + if (parameter[0] == 'U' && parameter[1] == '3' && parameter[2] == 0) { + if (!beginNewRequest(ROT_OP_DRIVER_STATUS)) return false; + } else + return false; + + return true; + } + + return false; +} + +#endif diff --git a/src/telescope/rotator/remote/Rotator.cpp b/src/telescope/rotator/remote/Rotator.cpp new file mode 100755 index 0000000..4b43923 --- /dev/null +++ b/src/telescope/rotator/remote/Rotator.cpp @@ -0,0 +1,66 @@ +//-------------------------------------------------------------------------------------------------- +// remote telescope rotator control, using the CANbus interface + +#include "Rotator.h" + +#ifdef ROTATOR_CAN_CLIENT_PRESENT + +// -------------------------------------------------------------------------- +// Heartbeat RX (local node): update last-heard timestamp for rotator +// -------------------------------------------------------------------------- +static void rotHb(uint8_t data[8], uint8_t len) { (void)data; (void)len; rotator.heartbeat(); } + +void Rotator::begin() { + canPlus.callbackRegisterId((int)(CAN_ROTATOR_HB_ID_BASE), rotHb); +} + +// by default reply[80] == "", suppressFrame == false, numericReply == true, and commandError == CE_NONE +// return true if the command has been completely handled and no further command() will be called, or false if not +// for commands that are handled repeatedly commandError might contain CE_NONE or CE_1 to indicate success +// numericReply=true means boolean/numeric-style responses (e.g., CE_1/CE_0/errors) rather than a payload +bool Rotator::command(char *reply, char *command, char *parameter, + bool *suppressFrame, bool *numericReply, CommandError *commandError) { + if (!canPlus.ready) return false; + + // r?, hP, hR, GX98 - rotator commands only + if (!(command[0] == 'r') && + !(command[0] == 'h' && command[1] == 'P') && + !(command[0] == 'h' && command[1] == 'R') && + !(command[0] == 'G' && command[1] == 'X' && (parameter[0] == '9' || parameter[0] == 'U'))) return false; + + // Presence gate + if (!heartbeatFresh()) return false; + + // Build CAN request + if (!encodeRequest(command, parameter)) return false; + + // Transport failure => reply unknown + bool handled = false; + if (!transactRequest(handled, *suppressFrame, *numericReply, *commandError)) { *commandError = CE_REPLY_UNKNOWN; return true; } + + // Remote explicitly did not recognize/handle the command + if (!handled) { + *commandError = CE_CMD_UNKNOWN; + *numericReply = true; + *suppressFrame = false; + reply[0] = 0; + return true; + } + + // Numeric reply: nothing to decode; caller will render numeric based on commandError + if (*numericReply) return true; + + // Payload reply: decode into reply buffer; decode failure => reply unknown + if (!decodeResponse(reply)) { + *commandError = CE_REPLY_UNKNOWN; + *numericReply = true; + *suppressFrame = false; + reply[0] = 0; + } + + return true; +} + +Rotator rotator; + +#endif diff --git a/src/telescope/rotator/remote/Rotator.h b/src/telescope/rotator/remote/Rotator.h new file mode 100755 index 0000000..b933b58 --- /dev/null +++ b/src/telescope/rotator/remote/Rotator.h @@ -0,0 +1,48 @@ +//-------------------------------------------------------------------------------------------------- +// remote telescope rotator control, using the CANbus interface +#pragma once + +#include "../../../Common.h" + +#include "../RotatorBase.h" + +#ifdef ROTATOR_CAN_CLIENT_PRESENT + +#include "../../../lib/canTransport/CanTransportClient.h" +#include "../../../libApp/commands/ProcessCmds.h" + +class Rotator : public CanTransportClient { + public: + Rotator() : CanTransportClient((uint16_t)(CAN_ROTATOR_REQ_ID), (uint16_t)(CAN_ROTATOR_RSP_ID)) {} + + void begin(); + + bool command(char *reply, char *command, char *parameter, + bool *suppressFrame, bool *numericReply, CommandError *commandError); + + // Heartbeat event + inline void heartbeat() { lastHeartbeatMs = hb_stamp_2ms_odd(); } + + private: + bool encodeRequest(char *command, char *parameter); + bool decodeResponse(char *reply); + + static inline uint32_t hb_stamp_2ms_odd() { + return millis() | 1UL; + } + + // Heartbeat presence + inline bool heartbeatFresh() const { + const uint32_t last = ATOMIC_LOAD(lastHeartbeatMs); + if (last == 0U) return false; + const uint32_t now = hb_stamp_2ms_odd(); + return (uint32_t)(now - last) <= 2000U; + } + + // Heartbeat timestamps (ms) + volatile uint32_t lastHeartbeatMs = 0; +}; + +extern Rotator rotator; + +#endif

    mQR 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

  2. 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 zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM z7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b* z1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd z0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwA zz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEj zFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r z3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@ z0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VK zfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5 zV8DO@0|pEjFkrxd0RsjM7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM r7%*VKfB^#r3>YwAz<>b*1`HT5V8DO@0|pEjFkrxd0RsjM7}x^=2I+6M literal 0 HcmV?d00001 diff --git a/docs/CAN_NOTES.md b/docs/CAN_NOTES.md new file mode 100755 index 0000000..7cc0953 --- /dev/null +++ b/docs/CAN_NOTES.md @@ -0,0 +1,437 @@ +# CAN Notes + +## Purpose + +These notes describe the current CAN interface in its most useful practical +role: interconnecting remote OnStepX peripheral features. + +This note is mainly about using CAN so the main controller can talk to: + +- a remote rotator +- one or more remote focusers +- a remote auxiliary-features node + +It is not mainly about low-level motor/axis CAN protocols. Those are better +left for a later axis-oriented note. + +## Quick Summary + +The cleanest mental model is: + +1. the main OnStepX controller runs the mount as usual +2. some peripherals can live on their own CAN-connected nodes +3. the main controller forwards the normal rotator, focuser, or auxiliary + feature operations to those remote nodes + +So the current CAN feature set is best thought of as a way to distribute +peripherals around the system, not as "the whole mount over CAN." + +## What CAN Is Good For Here + +This design is most useful when you want the mount controller and some +peripheral functions to be physically separate. + +Typical reasons include: + +- keeping focuser or rotator electronics close to the OTA +- reducing long motor/sensor wiring runs +- letting one small remote node host accessory features near where they are used +- building a more modular system where peripherals can be added or moved more + easily + +In this arrangement: + +- the rotator, focusers, and auxiliary-feature controllers can stay with an OTA +- plugging in one CAN/power cable brings that whole peripheral set online +- the correct functionality and settings can then appear at the mount + controller immediately and work as one integrated system from Android App, + Smart Hand Controller, Smart Web Server, ASCOM, and similar clients + +So the CAN link is not just carrying commands. It also helps turn an OTA +assembly into a more self-contained module that can be moved from one mount +controller to another with much less rework. + +In other words, CAN is being used here as a practical interconnect between +cooperating OnStepX feature nodes. + +## Connectors And Cable + +For this CAN interconnect role, the preferred connector choices are: + +- RJ12 as the standard light-duty connector +- GX12-6 as the standard rugged connector + +The standard 6-pin wiring order is: + +1. `GND` +2. `+12V` +3. `CAN_L` +4. `CAN_H` +5. `+12V` +6. `GND` + +This duplicates power and ground at the outer pairs and keeps the CAN pair +together in the middle. + +With quality connectors and cables, this arrangement is intended to carry: + +- `12V @ 2A` + +Recommended cable guidance: + +- twisted-pair `24 AWG` is optimal +- straight quality RJ12 cable of `26 AWG` is acceptable for short runs of about + `2 to 3 meters` + +So the practical idea is: + +- use RJ12 for lighter-duty short interconnects +- use GX12-6 where a more rugged connector is needed +- keep cable quality high if you expect the same cable to carry both CAN and + accessory power + +## Termination + +The mount controller is treated as one terminating end of the CAN bus. + +In the standard arrangement: + +- the mount controller has a built-in `120 Ohm` termination resistor +- the remote nodes are daisy-chained in the normal CAN fashion +- the far end of the chain gets the second `120 Ohm` termination resistor + +For this system, that far-end termination can be provided by plugging a custom +terminating modular jack or `GX12-6` connector into the last node in the chain. + +So the intended layout is the normal two-ended CAN termination pattern: + +- one `120 Ohm` terminator at the mount controller +- one `120 Ohm` terminator at the last node + +not a terminator at every intermediate node. + +## The Current Remote Peripheral Types + +The current CAN remote-node support is centered on three feature families: + +### Rotator + +The main controller can treat a rotator as remote. + +That means: + +- the rotator logic still looks like rotator functionality from the user side +- but the actual rotator feature can live on a CAN-connected node +- the remote node hosts the local Axis3 rotator implementation and answers the + requests + +This is a natural fit when the rotator hardware is physically mounted on the +instrument side and you do not want all of that wiring returning to the main +controller. + +### Focusers + +The focuser support is especially useful for distributed systems. + +The current model allows: + +- up to six remote focusers +- heartbeat-based discovery/presence tracking +- the main controller to proxy focuser operations over CAN + +This is a good fit for: + +- separate main and guide focusers +- multiple optical trains +- distributed focus hardware mounted near different instruments + +From the system-design point of view, this is one of the more attractive uses +of CAN in the current tree because focusers are naturally peripheral and often +benefit from being located close to the mechanics they drive. + +### Auxiliary Features + +Auxiliary features can also live on a remote CAN node. + +This is useful for things such as: + +- switches +- dew-heater style outputs +- analog outputs +- intervalometer or related accessory functions +- other feature-board style I/O that is convenient to place away from the main + controller + +So a remote auxiliary node can act like a small distributed utility board for +the telescope system. + +## The Main Idea: Proxy And Remote Roles + +For these feature families, CAN is used in a client/server style arrangement. + +On the main controller: + +- `ON` means "this feature is reached through CAN" +- the main controller becomes a client/proxy for that feature + +On the remote feature node: + +- `REMOTE` means "this node hosts the real implementation" +- that node answers the CAN requests for its local feature + +So the usual pattern is: + +- the mount/main controller proxies +- the physically-near peripheral node serves + +## Example Assignments + +Here is a typical main-controller configuration when the mount controller is +meant to talk to remote CAN-connected peripheral nodes: + +```c +#define CAN_ROTATOR ON +#define CAN_FOCUSER ON +#define CAN_FEATURES ON +#define CAN_SEND_RATE_MS 2 +#define CAN_RECV_RATE_MS 10 +#define CAN_PLUS CAN2_TEENSY4 +#define CAN_BAUD 250000 +``` + +In that role: + +- `CAN_ROTATOR ON` means the main controller expects the rotator to be remote +- `CAN_FOCUSER ON` means the main controller expects focuser control to be remote +- `CAN_FEATURES ON` means the main controller expects the auxiliary-features + provider to be remote + +Typical remote-node assignments then look like this. + +Remote rotator node: + +```c +#define CAN_ROTATOR REMOTE +#define CAN_SEND_RATE_MS 2 +#define CAN_RECV_RATE_MS 10 +#define CAN_PLUS CAN2_TEENSY4 +#define CAN_BAUD 250000 +``` + +Remote focuser node: + +```c +#define CAN_FOCUSER REMOTE +#define CAN_FOCUSER_NUMBER 1 +#define CAN_SEND_RATE_MS 2 +#define CAN_RECV_RATE_MS 10 +#define CAN_PLUS CAN2_TEENSY4 +#define CAN_BAUD 250000 +``` + +Remote auxiliary-features node: + +```c +#define CAN_FEATURES REMOTE +#define CAN_SEND_RATE_MS 2 +#define CAN_RECV_RATE_MS 10 +#define CAN_PLUS CAN2_TEENSY4 +#define CAN_BAUD 250000 +``` + +These examples mirror the common case where the CAN interface is on the ST4 +port through `CAN2_TEENSY4`, with `250000` baud and the faster `2ms` send +pacing. + +The repeated send/receive-rate lines in those examples are mainly there for +documentation clarity. They make the intended CAN setup obvious in one place, +not because every line is a special non-default requirement. + +## Platform Guidance + +In current practical use, a Teensy 4.1 makes a very good mount controller when +CAN is involved. + +That is the preferred direction because: + +- it has worked well as the main controller side +- `CAN2_TEENSY4` on the ST4 port is a natural fit for this role + +ESP32 is a different story. + +Using the built-in TWAI interface on ESP32: + +- ESP32 can feel slow as a CAN client/proxy on the main controller side +- but ESP32 is perfectly reasonable as a remote CAN server for things like a + rotator, focuser, or auxiliary-features node + +The push toward `250000` baud is intentional. + +The reason is mainly practical: + +- `250000` gives more wiring freedom +- it is a better fit for the kind of real-world cable runs and connectors these + distributed peripheral nodes are likely to use + +This whole CAN peripheral-interconnect feature set is still fairly new and +experimental. + +So the current practical guidance is: + +- prefer Teensy 4.1 as the CAN mount controller +- ESP32 is fine for remote peripheral-server roles +- treat `250000` as the preferred default unless there is a clear reason to do + otherwise +- do not assume other CAN platforms are equally proven + +Important reality check: + +- other platforms have not really been tested in this role yet + +## Important Rule: Remote Or Local, Never Both + +For each feature family, a build must choose whether that feature is local or +reached through CAN. + +That means: + +- if `CAN_ROTATOR == ON`, do not also configure a normal local rotator in that + same build +- if `CAN_FOCUSER == ON`, do not also configure normal local focusers in that + same build +- if `CAN_FEATURES == ON`, do not also configure local auxiliary features in + that same build + +`REMOTE` is the opposite role: + +- a `REMOTE` rotator node must actually host the local rotator it is serving +- a `REMOTE` focuser node must actually host the local focuser it is serving +- a `REMOTE` auxiliary node must actually host the local features it is serving + +So the rule is not "both local and remote at once." The rule is: + +- main controller build: client/proxy +- remote peripheral build: local provider/server + +## What This Feels Like In Practice + +From the user-facing point of view, this is meant to feel like the feature is +still part of the overall system. + +Conceptually: + +- you talk to the main controller in the ordinary way +- the main controller forwards the relevant focuser/rotator/auxiliary operation + over CAN +- the remote node performs the work and reports back + +So the goal is not to create a second separate user workflow. The goal is to +let the feature live somewhere else electrically and physically while still +participating in the same overall system. + +## Presence And Heartbeats + +The remote-node model uses simple heartbeats. + +That matters because the main controller should not treat a remote feature as +available just because it was configured at compile time. + +Instead: + +- remote nodes emit a heartbeat about once per second +- the client side considers the feature present only while that heartbeat + remains fresh + +This is especially helpful for distributed peripherals because it gives the +main controller a simple way to decide whether a remote focuser, rotator, or +feature board is really there and alive right now. + +For focusers, the model is a little richer: + +- each remote focuser has its own heartbeat slot +- the main controller can therefore keep track of multiple remote focusers + independently + +## Typical System Layouts + +Some natural ways to use the current CAN feature set are: + +### Main Mount Controller Plus Remote Rotator + +Use the main controller for the mount itself, and put the rotator logic on a +CAN-connected node near the camera train. + +That helps when: + +- the rotator is physically far from the main controller +- you want cleaner wiring through the moving instrument area + +### Main Mount Controller Plus Remote Focusers + +Keep the mount local, but move one or more focusers onto remote CAN nodes. + +That is useful when: + +- focusers are spread around the instrument package +- you have more than one focuser role +- you want each focuser controller physically near its motor and sensors + +### Main Mount Controller Plus Remote Auxiliary Board + +Use a CAN-connected auxiliary node as a distributed accessory board. + +That is a good fit for: + +- dew-heater outputs +- power or switch functions +- intervalometer or small observatory accessory control + +### Mixed Peripheral Layout + +These roles can be mixed. + +For example: + +- main controller handles the mount +- a remote node handles the rotator +- one or more remote nodes handle focusers +- another remote node hosts accessory features + +That is the real strength of this CAN feature set: it lets the system be +physically distributed while still acting like one coordinated instrument. + +## What This Note Is Not Trying To Cover + +This note is intentionally not trying to go deep into: + +- low-level frame packing details +- backend-specific controller quirks +- direct CAN motor/encoder protocols +- a future "axis over CAN" design + +Those are all real topics, but they are different topics. + +For this note, the important point is simply: + +- CAN is currently a practical interconnect for remote rotator, focuser, and + auxiliary-feature nodes + +## Related Notes + +For the current command-family coverage, see +[COMMAND_REFERENCE.md](COMMAND_REFERENCE.md). + +For serial transport/background comparison, see +[SERIAL_NOTES.md](SERIAL_NOTES.md). + +## Good Mental Summary + +The cleanest way to think about the current CAN feature set in OnStepX is: + +- the mount controller stays central +- selected peripherals can live on their own CAN-connected nodes +- rotator, focusers, and auxiliary features are the current distributed-feature + sweet spot + +So CAN is best understood here as a practical peripheral-interconnect feature +for building a cleaner, more modular telescope system. diff --git a/docs/COMMAND_REFERENCE.md b/docs/COMMAND_REFERENCE.md new file mode 100755 index 0000000..c590cd7 --- /dev/null +++ b/docs/COMMAND_REFERENCE.md @@ -0,0 +1,861 @@ +# OnStepX Command Reference + +This reference is derived from the current command handlers in the source tree, primarily the `*.command.cpp` files plus the shared command processor in `src/libApp/commands/ProcessCmds.cpp`. + +Scope notes: + +- This covers the command families implemented in the current tree, not older wiki pages. +- Many commands are compile-time feature gated. If a subsystem is not enabled in the build, its commands will not exist. +- Plugin-defined commands are not documented here because they come from the active plugin set, not the core command handlers. +- A few command comments in source are stale. Where the code and comment disagree, this document follows the code path. + +## Protocol Basics + +### Frames + +- Normal ASCII command frame: `:CC...#` +- Checksummed frame: `;CC...CCS#` + - `;` starts a checksummed command. + - The command processor validates the checksum and sequence character before dispatch. +- The parser ignores ASCII space, LF, and CR. +- Internal command buffer size is 80 bytes including framing, so current implementations are not limited to the older 40-character LX200 convention. + +### Command Parsing + +- `CC` is effectively a 1- or 2-character command family. The rest of the payload is the parameter string. +- Replies are either: + - payload replies, usually terminated with `#` + - numeric/boolean replies, returned as `1` for success and `0` for failure +- Some commands suppress the trailing `#` on purpose. + +### Global Reply/Error Behavior + +- Commands that leave `numericReply=true` return: + - `1` for `CE_NONE` or `CE_1` + - `0` for any other error +- `:GE#` returns the last command error code as a 2-digit payload. + +### Command Error Codes + +These are the codes returned by `:GE#`: + +| Code | Symbol | Meaning | +| --- | --- | --- | +| 00 | `CE_NONE` | No error | +| 01 | `CE_0` | False/fail without a protocol error | +| 02 | `CE_CMD_UNKNOWN` | Unknown command | +| 03 | `CE_REPLY_UNKNOWN` | Invalid reply | +| 04 | `CE_PARAM_RANGE` | Parameter out of range | +| 05 | `CE_PARAM_FORM` | Bad parameter format | +| 06 | `CE_ALIGN_FAIL` | Align failed | +| 07 | `CE_ALIGN_NOT_ACTIVE` | Align not active | +| 08 | `CE_NOT_PARKED_OR_AT_HOME` | Not parked or at home | +| 09 | `CE_PARKED` | Already parked | +| 10 | `CE_PARK_FAILED` | Park failed | +| 11 | `CE_NOT_PARKED` | Not parked | +| 12 | `CE_NO_PARK_POSITION_SET` | No park position set | +| 13 | `CE_GOTO_FAIL` | Goto failed | +| 14 | `CE_LIBRARY_FULL` | Library full | +| 15 | `CE_SLEW_ERR_BELOW_HORIZON` | Target below horizon limit | +| 16 | `CE_SLEW_ERR_ABOVE_OVERHEAD` | Target above overhead limit | +| 17 | `CE_SLEW_ERR_IN_STANDBY` | Controller in standby | +| 18 | `CE_SLEW_ERR_IN_PARK` | Mount parked | +| 19 | `CE_SLEW_IN_SLEW` | Goto already active | +| 20 | `CE_SLEW_ERR_OUTSIDE_LIMITS` | Outside configured limits | +| 21 | `CE_SLEW_ERR_HARDWARE_FAULT` | Hardware fault | +| 22 | `CE_SLEW_IN_MOTION` | Mount already in motion | +| 23 | `CE_SLEW_ERR_UNSPECIFIED` | Other slew error | +| 25 | `CE_1` | Explicit true/success | + +## Global Processor Commands + +These come from `ProcessCmds.cpp`, not from a subsystem `*.command.cpp`. + +| Command | Reply | Description | +| --- | --- | --- | +| `:SBB#` | `1` then switches to 460800 baud | Set serial baud rate | +| `:SBA#` | `1` then switches to 230400 baud | Set serial baud rate | +| `:SB0#` | `1` then switches to 115200 baud | Set serial baud rate | +| `:SB1#` | `1` then switches to 56700 baud | Set serial baud rate | +| `:SB2#` | `1` then switches to 38400 baud | Set serial baud rate | +| `:SB3#` | `1` then switches to 28800 baud | Set serial baud rate | +| `:SB4#` | `1` then switches to 19200 baud | Set serial baud rate | +| `:SB5#` | `1` then switches to 14400 baud | Set serial baud rate | +| `:SB6#` | `1` then switches to 9600 baud | Set serial baud rate | +| `:SB7#` | `1` then switches to 4800 baud | Set serial baud rate | +| `:SB8#` | `1` then switches to 2400 baud | Set serial baud rate | +| `:SB9#` | `1` then switches to 1200 baud | Set serial baud rate | +| `:GE#` | `CC#` | Get last command error code | +| `<0x06>` | `A`, `P`, or `CK_FAIL` style response | Special LX200 status query/checksum-fail path handled by the buffer/processor | + +## Dispatcher Notes + +In the full telescope build, command dispatch order is: + +1. mount +2. guide +3. GPIO/plugin status helpers +4. goto +5. park +6. library +7. site +8. limits +9. home +10. PEC +11. axis 1 / axis 2 +12. rotator +13. focuser +14. auxiliary features + +That matters because some command names are reused by different subsystems, especially `:hP#` and `:hR#`. In an integrated mount build, mount park/unpark wins before the rotator/focuser handlers ever see those frames. The rotator/focuser `h*` commands are still valid for standalone or remote-node builds. + +## Core Telescope / Firmware / Environment + +| Command | Reply | Description | +| --- | --- | --- | +| `:B+#` | none | Increase reticle brightness | +| `:B-#` | none | Decrease reticle brightness | +| `:ECtext#` | none | Echo text to debug output. `_` becomes space, trailing `&` becomes newline. | +| `:ERESET#` | none | Reset the MCU | +| `:ENVRESET#` | text | Mark NV storage to be cleared on next boot | +| `:ESPFLASH#` | `1`/none depending on build path | Put addon/ESP device into firmware flashing mode when supported | +| `:GVD#` | `MTH DD YYYY#` | Firmware build date | +| `:GVM#` | `name version#` | Firmware name plus version | +| `:GVN#` | `M.mm...#` | Firmware version number | +| `:GVP#` | `name#` | Product name | +| `:GVT#` | `HH:MM:SS#` | Firmware build time | +| `:GVC#` | `string#` | Firmware config/product description | +| `:GVH#` | `string#` | Firmware hardware/pinmap string | +| `:GX9A#` | `sn.n#` | Ambient temperature in C | +| `:GX9B#` | `n.n#` | Pressure in mbar | +| `:GX9C#` | `n.n#` | Relative humidity in percent | +| `:GX9E#` | `sn.n#` | Dew point in C | +| `:GX9F#` | `n#` or `0` | MCU temperature in C | +| `:SX9A,sn.n#` | `0/1` | Set ambient temperature | +| `:SX9B,n.n#` | `0/1` | Set pressure | +| `:SX9C,n.n#` | `0/1` | Set humidity | + +## Time / Date / Site + +| Command | Reply | Description | +| --- | --- | --- | +| `:Ga#` | `HH:MM:SS#` | Local standard time, 12-hour format | +| `:GC#` | `MM/DD/YY#` | Local standard calendar date | +| `:Gc#` | `24#` | Local time format indicator | +| `:GG#` | `sHH:MM#` | UTC offset to add to local time to get UT1 | +| `:Gg#` | `sDDD*MM#` | Current longitude | +| `:GgH#` | `sDDD*MM:SS.SSS#` | Longitude, highest precision | +| `:GL#` | `HH:MM:SS#` | Local standard time, 24-hour format | +| `:GLH#` | `HH:MM:SS.SSSS#` | Local standard time, highest precision | +| `:GM#` | `string#` | Site 1 name | +| `:GN#` | `string#` | Site 2 name | +| `:GO#` | `string#` | Site 3 name | +| `:GP#` | `string#` | Site 4 name | +| `:GS#` | `HH:MM:SS#` | Sidereal time | +| `:GSH#` | `HH:MM:SS.ss#` | Sidereal time, highest precision | +| `:Gt#` | `sDD*MM#` | Current latitude | +| `:GtH#` | `sDD*MM:SS.SSS#` | Latitude, highest precision | +| `:Gv#` | `sn.n#` | Elevation in meters | +| `:GX80#` | `HH:MM:SS.ss#` | UT1 time | +| `:GX81#` | `MM/DD/YY#` | UT1 date | +| `:GX89#` | `0` or `1` | Date/time ready status. `0` means ready, `1` means not ready. | +| `:SCMM/DD/YY#` | `0/1` | Set local date | +| `:SCMM/DD/YYYY#` | `0/1` | Set local date | +| `:SGsHH#` | `0/1` | Set UTC offset | +| `:SGsHH:MM#` | `0/1` | Set UTC offset. Comments indicate `MM` should be `00`, `30`, or `45`. | +| `:Sg(s)DDD*MM#` | `0/1` | Set longitude | +| `:Sg(s)DDD*MM:SS#` | `0/1` | Set longitude | +| `:Sg(s)DDD*MM:SS.SSS#` | `0/1` | Set longitude | +| `:SLHH:MM:SS#` | `0/1` | Set local time | +| `:SLHH:MM:SS.SSS#` | `0/1` | Set local time | +| `:SMname#` | `0/1` | Set site 1 name, max 15 chars | +| `:SNname#` | `0/1` | Set site 2 name, max 15 chars | +| `:SOname#` | `0/1` | Set site 3 name, max 15 chars | +| `:SPname#` | `0/1` | Set site 4 name, max 15 chars | +| `:StsDD*MM#` | `0/1` | Set latitude | +| `:StsDD*MM:SS#` | `0/1` | Set latitude | +| `:StsDD*MM:SS.SSS#` | `0/1` | Set latitude | +| `:SUs.s#` | `0/1` | Set DUT1 correction in seconds, nominally `-0.9` to `+0.9` | +| `:Svsn.n#` | `0/1` | Set elevation in meters | +| `:W0#` .. `:W3#` | none | Select active site slot | +| `:W?#` | `n#` | Query active site slot | + +## Mount Position / Tracking / Rates + +Available when `MOUNT_PRESENT` is enabled. + +| Command | Reply | Description | +| --- | --- | --- | +| `:GA#` | `sDD*MM#` or `sDD*MM'SS#` | Current mount altitude | +| `:GAH#` | `sDD*MM'SS.SSS#` | Current mount altitude, highest precision | +| `:GD#` | `sDD*MM#` or `sDD*MM:SS#` | Current declination | +| `:GDH#` | `sDD*MM:SS.SSS#` | Current declination, highest precision | +| `:GR#` | `HH:MM.T#` or `HH:MM:SS#` | Current right ascension | +| `:GRH#` | `HH:MM:SS.SSSS#` | Current right ascension, highest precision | +| `:GT#` | `n.nnnnn#` or `0#` | Tracking rate in Hz, `0` if not tracking | +| `:GZ#` | `DDD*MM#` or `DDD*MM'SS#` | Current azimuth | +| `:GZH#` | `DDD*MM'SS.SSS#` | Current azimuth, highest precision | +| `:GXTD#` | `n.nnnnnnnn#` | Tracking rate offset, Dec, arcsec per sidereal second | +| `:GXTR#` | `n.nnnnnnnn#` | Tracking rate offset, RA, arcsec per sidereal second | +| `:GX40#` | `DDD*MM:SS#` | Axis1 instrument angle | +| `:GX41#` | `DDD*MM:SS#` | Axis2 instrument angle | +| `:GX42#` | `n.nnnnnn#` | Axis1 instrument angle in decimal degrees | +| `:GX43#` | `n.nnnnnn#` | Axis2 instrument angle in decimal degrees | +| `:GX44#` | `n#` | Axis1 encoder count | +| `:GX45#` | `n#` | Axis2 encoder count | +| `:GXE4#` | `n#` | Axis1 steps per degree | +| `:GXE5#` | `n#` | Axis2 steps per degree | +| `:GXEE#` | `0#`, `1#`, ... | Mount coordinate mode (`MOUNT_COORDS - 1`) | +| `:GXEF#` | `1` or `0` | Axis2 tangent-arm presence flag | +| `:GXEG#` | `1` or `0` | Axis1 sector-gear presence flag | +| `:GXEM#` | `n#` | Current mount type | +| `:GXF3#` | `sn.nnnnnn#` | Axis1 step frequency | +| `:GXF4#` | `sn.nnnnnn#` | Axis2 step frequency | +| `:GXFA#` | `50%#` | Reported workload placeholder | +| `:GXFF#` | `n.nnnnnn#` | Axis1 index position | +| `:GXFG#` | `n.nnnnnn#` | Axis2 index position | +| `:STn.n#` | `0/1` | Set tracking rate in Hz. `0` stops tracking. | +| `:SEO#` | `0/1` | Save absolute encoder origin, or initialize mount coordinate memory at home, when supported | +| `:SX40,n#` | `0/1` | Stage encoder axis1 angle in degrees | +| `:SX41,n#` | `0/1` | Stage encoder axis2 angle in degrees | +| `:SX42,1#` | `0/1` | Sync mount from staged encoder axis values | +| `:SX43,0#` | `0/1` | Allow SWS to control sync mode | +| `:SX44,deg1,deg2[a]#` | `0/1` | Stage and sync both encoder axes, append `a` when both SWS encoder values are absolute and trusted | +| `:SXEM,n#` | `0/1` | Set mount type for next restart | +| `:SXTD,n.n#` | `0/1` | Set Dec tracking rate offset, arcsec per sidereal second | +| `:SXTR,n.n#` | `0/1` | Set RA tracking rate offset, arcsec per sidereal second | +| `:TS#` | none | Solar tracking rate | +| `:TK#` | none | King tracking rate | +| `:TL#` | none | Lunar tracking rate | +| `:TQ#` | none | Sidereal tracking rate | +| `:T+#` | none | Increase master sidereal clock by 0.02 Hz | +| `:T-#` | none | Decrease master sidereal clock by 0.02 Hz | +| `:TR#` | none | Reset master sidereal clock | +| `:Te#` | `0/1` | Enable tracking | +| `:Td#` | `0/1` | Disable tracking | +| `:To#` | `0/1` | Enable full compensation model | +| `:Tr#` | `0/1` | Enable refraction compensation | +| `:Tn#` | `0/1` | Disable compensation | +| `:T1#` | `0/1` | Single-axis tracking mode | +| `:T2#` | `0/1` | Dual-axis tracking mode | +| `:$BDn#` | `0/1` | Set Dec/Alt backlash in arcsec | +| `:$BRn#` | `0/1` | Set RA/Azm backlash in arcsec | +| `:%BD#` | `n#` | Get Dec/Alt backlash in arcsec | +| `:%BR#` | `n#` | Get RA/Azm backlash in arcsec | + +### Mount Type Values + +Current core constants are: + +| Value | Mount type | +| --- | --- | +| `1` | GEM | +| `2` | FORK | +| `3` | ALTAZM | +| `4` | ALTALT | +| `5` | GEM_TA | +| `6` | GEM_TAC | +| `7` | FORK_TA | +| `8` | FORK_TAC | +| `9` | ALTAZM_UNL | + +## Goto / Sync / Alignment + +| Command | Reply | Description | +| --- | --- | --- | +| `:AW#` | `1` | Write alignment model to NV | +| `:A?#` | `mno#` | Alignment status: max stars, current star, last required star | +| `:A1#` .. `:A9#` | `0/1` | Start manual alignment with that many stars | +| `:A+#` | `0/1` | Accept current align point | +| `:CS#` | none | Sync to current target coordinates | +| `:CM#` | `N/A#` or `E1#`..`E9#` | Sync to current catalog/database object | +| `:D#` | `0x7f#` while moving, otherwise raw `#` | LX200 distance-bar style motion indicator | +| `:Gr#` | `HH:MM.T#` or `HH:MM:SS#` | Get target RA | +| `:GrH#` | `HH:MM:SS.SSSS#` | Get target RA, highest precision | +| `:Gd#` | `sDD*MM#` or `sDD*MM:SS#` | Get target Dec | +| `:GdH#` | `sDD*MM:SS.SSS#` | Get target Dec, highest precision | +| `:Gal#` | `sDD*MM#` or `sDD*MM'SS#` | Get target altitude | +| `:GaH#` | `sDD*MM'SS.SSS#` | Get target altitude, highest precision | +| `:Gz#` | `DDD*MM#` or `DDD*MM'SS#` | Get target azimuth | +| `:GzH#` | `DDD*MM'SS.SSS#` | Get target azimuth, highest precision | +| `:MA#` | `0`..`9` | Goto target Alt/Az | +| `:MD#` | `0`, `1`, or `2` | Destination pier side for current target | +| `:MN#` | `0`..`9` | Goto current position on opposite pier side | +| `:MNe#` | `0`..`9` | Force same-position goto to east pier side | +| `:MNw#` | `0`..`9` | Force same-position goto to west pier side | +| `:MP#` | `0`..`9` | Polar-align goto | +| `:MS#` | `0`..`9` | Goto current target | +| `:SrHH:MM.T#` | `0/1` | Set target RA | +| `:SrHH:MM:SS#` | `0/1` | Set target RA | +| `:SrHH:MM:SS.SSSS#` | `0/1` | Set target RA | +| `:SdsDD*MM#` | `0/1` | Set target Dec | +| `:SdsDD*MM:SS#` | `0/1` | Set target Dec | +| `:SdsDD*MM:SS.SSS#` | `0/1` | Set target Dec | +| `:SasDD*MM#` | `0/1` | Set target altitude | +| `:SasDD*MM'SS#` | `0/1` | Set target altitude | +| `:SasDD*MM'SS.SSS#` | `0/1` | Set target altitude | +| `:SzDDD*MM#` | `0/1` | Set target azimuth | +| `:SzDDD*MM'SS#` | `0/1` | Set target azimuth | +| `:SzDDD*MM'SS.SSS#` | `0/1` | Set target azimuth | + +### `:MS#` / `:MA#` / `:MN#` / `:MP#` Return Codes + +| Value | Meaning | +| --- | --- | +| `0` | Goto accepted | +| `1` | Below horizon limit | +| `2` | Above overhead limit | +| `3` | Controller in standby | +| `4` | Mount parked | +| `5` | Goto already in progress | +| `6` | Outside limits | +| `7` | Hardware fault | +| `8` | Already in motion | +| `9` | Unspecified error | + +### Alignment Model Extended Commands + +`ALIGN_MAX_NUM_STARS > 1` builds expose: + +| Command | Reply | Description | +| --- | --- | --- | +| `:GX00#` | `n#` | `ax1Cor` in arcsec | +| `:GX01#` | `n#` | `ax2Cor` in arcsec | +| `:GX02#` | `n#` | `altCor` in arcsec | +| `:GX03#` | `n#` | `azmCor` in arcsec | +| `:GX04#` | `n#` | `doCor` in arcsec | +| `:GX05#` | `n#` | `pdCor` in arcsec | +| `:GX06#` | `n#` | `ffCor` for FORK/ALTAZM, else `0` | +| `:GX07#` | `n#` | `dfCor` for GEM-style mounts, else `0` | +| `:GX08#` | `n#` | `tfCor` in arcsec | +| `:GX0a#` | `n#` | `hcp` in degrees | +| `:GX0b#` | `n#` | `hca` in arcsec | +| `:GX0c#` | `n#` | `dcp` in degrees | +| `:GX0d#` | `n#` | `dca` in arcsec | +| `:GX09#` | `n#` | Number of uploaded stars, then resets internal star index | +| `:GX0A#` | `HH:MM:SS#` | Uploaded star actual HA | +| `:GX0B#` | `sDD*MM:SS#` | Uploaded star actual Dec | +| `:GX0C#` | `HH:MM:SS#` | Uploaded star mount HA | +| `:GX0D#` | `sDD*MM:SS#` | Uploaded star mount Dec | +| `:GX0E#` | `n#` | Uploaded star pier side, then advances star index | +| `:SX00,n#` .. `:SX0d,n#` | `0/1` | Set alignment model coefficients listed above | +| `:SX09,0#` | `0/1` | Reset alignment upload state | +| `:SX09,1#` | `0/1` | Build model from uploaded stars | +| `:SX09,2#` | `0/1` | Force model active | +| `:SX0A,HH:MM:SS#` | `0/1` | Upload actual HA for current star | +| `:SX0B,sDD*MM:SS#` | `0/1` | Upload actual Dec for current star | +| `:SX0C,HH:MM:SS#` | `0/1` | Upload mount HA for current star | +| `:SX0D,sDD*MM:SS#` | `0/1` | Upload mount Dec for current star | +| `:SX0E,n#` | `0/1` | Upload pier side and advance to next star | + +### Goto Extended Settings + +| Command | Reply | Description | +| --- | --- | --- | +| `:GX92#` | `n.nnn#` | Current slew period in us/step | +| `:GX93#` | `n.nnn#` | Base/default slew period in us/step | +| `:GX94#` | `n` plus optional ` N` | Current pier side: `0` none, `1` east, `2` west | +| `:GX95#` | `0` or `1` | Auto meridian flip enabled | +| `:GX96#` | `E`, `W`, `B`, or `A` | Preferred pier side | +| `:GX97#` | `n.n#` | Current step rate in deg/s | +| `:GX99#` | `n.nnn#` | Fastest allowed slew period in us/step | +| `:SX92,n.nnn#` | `0/1` | Set current slew period in us/step | +| `:SX93,[1-5]#` | none | Slew preset: `5`=50%, `4`=66.7%, `3`=100%, `2`=150%, `1`=200% | +| `:SX95,0#` or `:SX95,1#` | `0/1` | Disable/enable automatic meridian flip | +| `:SX96,E#` | `0/1` | Preferred pier side east | +| `:SX96,W#` | `0/1` | Preferred pier side west | +| `:SX96,B#` | `0/1` | Preferred pier side best | +| `:SX96,A#` | `0/1` | Preferred pier side automatic | +| `:SX98,0#` or `:SX98,1#` | `0/1` | Disable/enable pause at home during meridian flip | +| `:SX99,1#` | `0/1` | Continue after pause at home | + +## Guide / Manual Motion + +| Command | Reply | Description | +| --- | --- | --- | +| `:GX90#` | `n.nn#` | Pulse guide rate | +| `:Mgdn#` | none | Pulse guide for `n` ms in direction `d` where `d` is `w`, `e`, `n`, or `s` | +| `:MGdn#` | `0/1` | Same as `:Mgdn#`, numeric form | +| `:Mw#` | none | Move west at current guide rate | +| `:Me#` | none | Move east at current guide rate | +| `:Mn#` | none | Move north at current guide rate | +| `:Ms#` | none | Move south at current guide rate | +| `:Mp#` | none | Spiral-search motion | +| `:Q#` | none | Stop all slews, abort goto | +| `:Qe#` / `:Qw#` | none | Stop east/west motion | +| `:Qn#` / `:Qs#` | none | Stop north/south motion | +| `:RAn.n#` | none | Set axis1 custom guide rate in deg/s | +| `:REn.n#` | none | Set axis2 custom guide rate in deg/s | +| `:RG#` | none | Guide rate preset 1x | +| `:RC#` | none | Centering rate preset 8x | +| `:RM#` | none | Find rate preset 20x | +| `:RF#` | none | Fast rate preset 48x | +| `:RS#` | none | Slew rate preset, half current goto rate | +| `:R0#` .. `:R9#` | none | Numeric guide-rate preset | + +## Park / Home / Limits / Status + +### Park + +| Command | Reply | Description | +| --- | --- | --- | +| `:hP#` | `0/1` | Park mount | +| `:hQ#` | `0/1` | Set current position as park | +| `:hR#` | `0/1` | Unpark mount | + +### Home + +| Command | Reply | Description | +| --- | --- | --- | +| `:h?#` | `hasSense,axis1Offset,axis2Offset#` | Home status. Source comment mentions auto-home, but current code returns 3 fields only. | +| `:hA0#` / `:hA1#` | none | Disable/enable automatic home at boot | +| `:hC#` | none | Move to home | +| `:hC1,R#` | none | Toggle axis1 home-sense reversal | +| `:hC1,n#` | none | Set axis1 home offset in arcsec | +| `:hC2,R#` | none | Toggle axis2 home-sense reversal | +| `:hC2,n#` | none | Set axis2 home offset in arcsec | +| `:hF#` | none | Reset mount at home/cold-start position | + +### Limits + +For a visual explanation of confusing GEM east/west pier-side limit geometry, +see [GOTO_NOTES.md](GOTO_NOTES.md#workflow-4-reachability-and-target-unwinding). + +| Command | Reply | Description | +| --- | --- | --- | +| `:Gh#` | `sDD*#` | Horizon limit | +| `:Go#` | `DD*#` | Overhead limit | +| `:GXE9#` | `n#` | East meridian limit in minutes | +| `:GXEA#` | `n#` | West meridian limit in minutes | +| `:GXEe#` | `n#` | Axis1 minimum limit in degrees | +| `:GXEw#` | `n#` | Axis1 maximum limit in degrees | +| `:GXEB#` | `n#` | Axis1 maximum limit in hours | +| `:GXEC#` | `n#` | Axis2 minimum limit in degrees | +| `:GXED#` | `n#` | Axis2 maximum limit in degrees | +| `:ShsDD#` | `0/1` | Set lower altitude limit | +| `:SoDD#` | `0/1` | Set overhead altitude limit | +| `:SXE9,n#` | `0/1` | Set east meridian limit in minutes | +| `:SXEA,n#` | `0/1` | Set west meridian limit in minutes | + +### Status + +| Command | Reply | Description | +| --- | --- | --- | +| `:Gm#` | `E#`, `W#`, or `N#` | Meridian pier side | +| `:GU#` | status string | Human-readable packed status | +| `:Gu#` | packed bytes | Bit-packed status | +| `:GW#` | 4-char status | Mount type, tracking, parked/home, align-done | +| `:SX97,0#` | `0/1` | Disable buzzer | +| `:SX97,1#` | `0/1` | Enable buzzer | +| `:SX97,2#` | `0/1` | Beep | +| `:SX97,3#` | `0/1` | Alert tone | +| `:SX97,4#` | `0/1` | Click | + +#### `:GU#` Status Characters + +The reply is an ordered string assembled from active conditions. Characters currently used by the code include: + +| Char | Meaning | +| --- | --- | +| `n` | Not tracking | +| `N` | No goto active | +| `p` | Not parked | +| `I` | Parking in progress | +| `P` | Parked | +| `F` | Park failed | +| `e` | Sync-to-encoders-only mode | +| `H` | At home | +| `h` | Homing | +| `B` | Auto-home at boot | +| `S` | PPS synced | +| `G` | Pulse guide active | +| `g` | Guide active | +| `r` | Refraction compensation enabled | +| `s` | Single-axis compensation mode | +| `t` | Full compensation model enabled | +| `(` | Lunar tracking rate selected | +| `O` | Solar tracking rate selected | +| `k` | King tracking rate selected | +| `w` | Meridian flip paused at home | +| `u` | Pause-at-home enabled | +| `z` | Buzzer enabled | +| `a` | Automatic meridian flip enabled | +| `R` | PEC data recorded | +| `/`, `,`, `~`, `;`, `^` | PEC state | +| `E`, `K`, `A`, `L` | GEM, FORK, ALTAZM, ALTALT | +| `o`, `T`, `W` | Pier side none, east, west | +| final digits | pulse-guide rate, guide rate, general error code | + +#### `:Gu#` Packed Status Layout + +`Gu` is the binary/pseudo-binary status form. The current implementation fills bytes as: + +| Byte | Contents | +| --- | --- | +| `0` | tracking/goto/PPS/pulse-guide plus compensation mode | +| `1` | tracking-rate selection plus sync-to-encoders and guide-active | +| `2` | home/homing/auto-home/home-pause/buzzer/auto-flip | +| `3` | mount type plus pier side | +| `4` | PEC state and PEC-recorded flag | +| `5` | park state | +| `6` | pulse-guide selection | +| `7` | guide-rate selection | +| `8` | general limits/error code | + +## Object Library + +| Command | Reply | Description | +| --- | --- | --- | +| `:LB#` | none | Previous object matching current constraints | +| `:LCn#` | none | Select record number `n` | +| `:LI#` | `name,type#` | Current object name and type | +| `:LIG#` | none | Load current object into goto target | +| `:LR#` | `name,type,ra,dec#` | Current object info, then advance to next record | +| `:LWname,type#` | `0/1` | Write current target RA/Dec to next free record | +| `:LN#` | none | Next object matching current constraints | +| `:L$#` | `1` | Move to catalog name record | +| `:LD#` | none | Clear current record | +| `:LL#` | none | Clear current catalog | +| `:L!#` | none | Clear all catalogs | +| `:L?#` | `n#` | Free records across all catalogs | +| `:Lon#` | `0/1` | Select catalog `0..14` | + +Object type codes written/read by library commands are: + +`UNK`, `OC`, `GC`, `PN`, `DN`, `SG`, `EG`, `IG`, `KNT`, `SNR`, `GAL`, `CN`, `STR`, `PLA`, `CMT`, `AST` + +## PEC + +Available when PEC support is enabled for axis 1. + +| Command | Reply | Description | +| --- | --- | --- | +| `:GX91#` | `n#` | PEC analog value | +| `:GXE6#` | `n.nnnnnn#` | Steps per sidereal second | +| `:GXE7#` | `n#` | Worm rotation steps from NV | +| `:GXE8#` | `n#` | PEC buffer size in seconds | +| `:SXE7,n#` | `0/1` | Set worm rotation steps | +| `:VH#` | `nnnnn#` | PEC index sense position in sidereal seconds | +| `:VR#` | `snnn,nnn#` | Current PEC segment correction plus segment index | +| `:VRn#` | `snnn#` | PEC correction for segment `n` | +| `:Vrn#` | `x0x1...x9#` | Ten-byte hex frame of PEC data starting at segment `n` | +| `:VS#` | `n.nnnnnn#` | Steps per sidereal second of worm rotation | +| `:VW#` | `nnnnnn#` | Worm rotation steps | +| `:WR+#` | `0/1` | Rotate PEC table forward one second | +| `:WR-#` | `0/1` | Rotate PEC table backward one second | +| `:WRn,sn#` | none | Write PEC correction for segment `n` | +| `:$QZ+#` | none | Enable PEC playback | +| `:$QZ-#` | none | Disable PEC | +| `:$QZ/#` | none | Arm PEC recording | +| `:$QZZ#` | none | Clear PEC buffer | +| `:$QZ!#` | none | Save PEC data to NV | +| `:$QZ?#` | `I#`, `p#`, `P#`, `r#`, `R#`, optionally with `.#` | PEC status | + +PEC status characters from `:$QZ?#`: + +| Char | Meaning | +| --- | --- | +| `I` | Ignore/off | +| `p` | Ready to play | +| `P` | Playing | +| `r` | Ready to record | +| `R` | Recording | +| `.` | Index detected this second | + +### `:GXUa#` Driver Status Flags + +Local ASCII replies are comma-separated flag mnemonics: + +| Flag | Meaning | +| --- | --- | +| `ST` | Standstill | +| `OA` | Output A open load | +| `OB` | Output B open load | +| `GA` | Output A short to ground | +| `GB` | Output B short to ground | +| `OT` | Over-temperature | +| `PW` | Over-temperature warning | +| `GF` | Driver fault | + +## Focuser + +Available in focuser-enabled or remote-focuser builds. + +Addressing rules: + +- `:FA#` returns the currently selected focuser number. +- `:FA1#` .. `:FA6#` selects the active focuser. +- `:F...#` uses the active focuser. +- `:F1...#` .. `:F6...#` directs a command to a specific focuser immediately. + +Unit rules for local ASCII focuser commands: + +- Uppercase `B`, `D`, `G`, `I`, `M`, `R`, `S` use microns. +- Lowercase `b`, `d`, `g`, `i`, `m`, `r`, `s` use raw steps. +- Other focuser commands are unitless or fixed-unit as noted below. + +| Command | Reply | Description | +| --- | --- | --- | +| `:FA#` | `n` | Get active focuser number | +| `:FA1#` .. `:FA6#` | `0/1` | Select active focuser | +| `:hP#` | `0/1` | Park all focusers in standalone/remote focuser builds | +| `:hR#` | `0/1` | Unpark all focusers in standalone/remote focuser builds | +| `:Fa#` | `1` | Primary focuser present/selected | +| `:FT#` | `M1#`, `S3#`, etc. | Focuser status plus goto-rate digit | +| `:Fp#` | `0` or `1` | Mode. Current implementation returns `1` for DC/pseudo-absolute, `0` otherwise. | +| `:FI#` / `:Fi#` | `n#` | Full-in/min position | +| `:FM#` / `:Fm#` | `n#` | Maximum position | +| `:Fe#` | `n.n#` | Temperature delta from TCF baseline | +| `:Ft#` | `n.n#` | Focuser temperature in C | +| `:Fu#` | `n.nnnnn#` | Microns per step | +| `:FB#` / `:Fb#` | `n#` | Backlash | +| `:FBn#` / `:Fbn#` | `0/1` | Set backlash | +| `:FC#` | `n.nnnnn#` | TCF coefficient in microns per C | +| `:FCsn.n#` | `0/1` | Set TCF coefficient | +| `:Fc#` | `0` or `1` | TCF enabled status | +| `:Fc0#` / `:Fc1#` | `0/1` | Disable/enable TCF | +| `:FD#` / `:Fd#` | `n#` | TCF deadband | +| `:FDn#` / `:Fdn#` | `0/1` | Set TCF deadband | +| `:FP#` | `n#` | DC motor power percent | +| `:FPn#` | `0/1` | Set DC motor power percent | +| `:FQ#` | none | Stop focuser | +| `:F1#` .. `:F9#` | none | Set move/goto rate preset | +| `:FW#` | `n#` | Working goto rate in um/s | +| `:F+#` | none | Move inward | +| `:F-#` | none | Move outward | +| `:FG#` / `:Fg#` | `sn#` | Current position | +| `:FRsn#` / `:Frsn#` | none | Relative goto | +| `:FSn#` / `:Fsn#` | `0/1` | Absolute goto | +| `:FZ#` | none | Zero current position | +| `:FH#` | none | Set current position as home | +| `:Fh#` | none | Move to home | +| `:GXU4#` .. `:GXU9#` | flags | Driver status for focuser axes that expose `Axis.command.cpp` | + +Rate preset meaning: + +| Preset | Meaning | +| --- | --- | +| `1` | 1 um/s move rate | +| `2` | 10 um/s move rate | +| `3` | 100 um/s move rate | +| `4` | 0.5x goto rate, move mode | +| `5` | 0.5x goto rate | +| `6` | 0.66x goto rate | +| `7` | 1x goto rate | +| `8` | 1.5x goto rate | +| `9` | 2x goto rate | + +## Rotator + +Available in rotator-enabled or remote-rotator builds. + +| Command | Reply | Description | +| --- | --- | --- | +| `:rA#` | `0/1` | Rotator active | +| `:hP#` | `0/1` | Park rotator in standalone/remote rotator builds | +| `:hR#` | `0/1` | Unpark rotator in standalone/remote rotator builds | +| `:rT#` | `M1#`, `SD3#`, etc. | Status string plus rate digit | +| `:rI#` | `n#` | Minimum angle in degrees | +| `:rM#` | `n#` | Maximum angle in degrees | +| `:rD#` | `n.n#` | Degrees per step | +| `:rb#` | `n#` | Backlash in steps | +| `:rbn#` | `0/1` | Set backlash | +| `:rQ#` | none | Stop motion | +| `:r1#` .. `:r9#` | none | Set move/goto rate preset | +| `:rW#` | `n.n#` | Working slew rate in deg/s | +| `:rc#` | none | Continuous-move no-op, accepted for compatibility | +| `:r>#` | none | Move clockwise | +| `:r<#` | none | Move counter-clockwise | +| `:rG#` | `sDDD*MM#` | Current angle | +| `:rrsDDD*MM#` | none | Relative goto | +| `:rSsDDD*MM#` | `0/1` | Absolute goto | +| `:rZ#` | none | Zero position | +| `:rF#` | none | Set current position to half travel | +| `:rC#` | none | Move to half-travel / home target | +| `:r+#` | none | Enable derotation | +| `:r-#` | none | Disable derotation | +| `:rP#` | none | Move to parallactic angle | +| `:rR#` | none | Toggle derotator reverse direction | +| `:GX98#` | `D#`, `R#`, or `N#` | Rotator capability: derotate, rotate-only, or none | +| `:GXU3#` | flags | Driver status for rotator axis in standalone/remote builds | + +Rotator rate presets: + +| Preset | Meaning | +| --- | --- | +| `1` | 0.01 deg/s move rate | +| `2` | 0.1 deg/s move rate | +| `3` | 1.0 deg/s move rate | +| `4` | 0.5x goto rate used as move rate | +| `5` | 0.5x goto rate | +| `6` | 0.66x goto rate | +| `7` | 1x goto rate | +| `8` | 1.5x goto rate | +| `9` | 2x goto rate | + +## Auxiliary Features + +Available when auxiliary features are enabled. + +Feature slots are numbered `1..8`. + +### Discovery + +| Command | Reply | Description | +| --- | --- | --- | +| `:GXY0#` | `xxxxxxxx#` | Eight-character bitmap of active feature slots, `1` = present | +| `:GXYn#` | `name,purpose#` | Slot name plus purpose code | + +### Slot State + +| Command | Reply | Description | +| --- | --- | --- | +| `:GXXn#` | purpose-specific payload | Get current state for slot `n` | +| `:SXXn,Vv#` | `0/1` | Generic value set | +| `:SXXn,Zf#` | `0/1` | Dew-heater zero temperature | +| `:SXXn,Sf#` | `0/1` | Dew-heater span temperature | +| `:SXXn,Ef#` | `0/1` | Intervalometer exposure seconds | +| `:SXXn,Df#` | `0/1` | Intervalometer delay seconds | +| `:SXXn,Cf#` | `0/1` | Intervalometer count | + +### `:GXXn#` Reply Shapes + +The payload depends on the slot purpose: + +| Purpose | Reply shape | +| --- | --- | +| Switch / momentary switch / cover switch | `value` plus optional power telemetry | +| Analog output | `value` plus optional power telemetry | +| Dew heater | `enabled,zero,span,deltaT` plus optional power telemetry | +| Intervalometer | `currentCount,exposure,delay,count` | + +When power monitoring is compiled in, the local ASCII implementation appends: + +`;,,` + +Where flags are a five-character string using `P`, `C`, `U`, `V`, `T` or `!`. + +## Axis / Motor / Driver Service Commands + +Axis service commands are implemented by `Axis.command.cpp`. For the main telescope/mount build these are reachable for axis 1 and axis 2, if present. The rotator exposes axis3, if present. The focuser(s) expose any of axis 4 to axis 9, if present. + +| Command | Reply | Description | +| --- | --- | --- | +| `:GXAa,p#` | `value,min,max,type,name#` | Get axis parameter `p` for axis `a` (`1..9`) | +| `:GXAa,M#` | `name#` | Motor/driver name for axis `a` | +| `:GXAa,0#` | `n#` | Parameter count for axis `a` | +| `:GXSa#` | `delta,velocity#` | Servo-only delta and velocity for axis `a` | +| `:GXUa#` | `flags#` | Stepper driver status for axis `a` | +| `:SXAC,0#` | `0/1` | Use runtime NV axis settings | +| `:SXAC,1#` | `0/1` | Use compile-time `Config.h` axis settings | +| `:SXAa,R#` | `0/1` | Revert axis `a` settings to defaults on next boot | +| `:SXAa,p,value#` | `0/1` | Set axis parameter `p` for axis `a` | + +### `:GXAa,p#` Reply Format + +The reply is: + +`value,min,max,type,name#` + +Where: + +- `value` is the current NV value +- `min` and `max` are the documented range +- `type` is the axis parameter type code returned by firmware +- `name` is the parameter name from the axis parameter table +- some `name` values are locale tokens such as `$1` or `$12` rather than literal English labels + +Axis parameter type codes: + +| Code | Symbol | Meaning | +| --- | --- | --- | +| `0` | `AXP_INVALID` | Invalid / placeholder entry | +| `1` | `AXP_BOOLEAN` | Boolean value stored in NV and applied on restart/reinit | +| `2` | `AXP_BOOLEAN_IMMEDIATE` | Boolean value applied immediately when set | +| `3` | `AXP_INTEGER` | Integer value stored in NV and applied on restart/reinit | +| `4` | `AXP_INTEGER_IMMEDIATE` | Integer value applied immediately when set | +| `5` | `AXP_FLOAT` | Floating-point value stored in NV and reported as a plain numeric field | +| `6` | `AXP_FLOAT_IMMEDIATE` | Floating-point value applied immediately when set | +| `7` | `AXP_FLOAT_RAD` | Angular float stored internally in radians | +| `8` | `AXP_FLOAT_RAD_INV` | Inverse angular float stored internally with radian/degree conversion | +| `9` | `AXP_POW2` | Power-of-two constrained integer-like value | +| `10` | `AXP_DECAY` | Driver decay-mode selector | + +Protocol note: + +- `:GXAa,p#` normalizes `AXP_FLOAT_RAD` and `AXP_FLOAT_RAD_INV` to reply type code `5` and converts the value/range to degree-based units for transport. +- Axis parameter values are float-backed in firmware; values are always float even when the logical type is boolean or integer so the UI can show the appropriate controls. +- Boolean parameters: some use logical `0`/`1`, while others use the firmware constants `OFF = -1` and `ON = -2`; so any UI can show 'True'/'False' or 'On'/'Off'. +- For `AXP_DECAY`, the UI shows the matching decay-mode text for the numeric value `1=MIXED`, `2=FAST`, `3=SLOW`, `4=SPREADCYCLE`, `5=STEALTHCHOP`. + +Locale-backed axis parameter name tokens currently used by firmware: + +| Token | Meaning | +| --- | --- | +| `$1` | Steps/degree | +| `$2` | Min limit, degs | +| `$3` | Max limit, degs | +| `$4` | Steps/um | +| `$5` | Min limit, um | +| `$6` | Max limit, um | +| `$7` | Reverse | +| `$8` | Microsteps | +| `$9` | Microsteps Goto | +| `$10` | Decay mode | +| `$11` | Decay mode Goto | +| `$12` | mA Hold | +| `$13` | mA Run | +| `$14` | mA Goto | +| `$15` | 256x Interpolate | +| `$16` | P tracking | +| `$17` | I tracking | +| `$18` | D tracking | +| `$19` | P slewing | +| `$20` | I slewing | +| `$21` | D slewing | +| `$22` | Rads/count | +| `$23` | Steps/count ratio | +| `$24` | Max accel, %/s/s | +| `$25` | Min power, % | +| `$26` | Max power, % | + +## CAN Remote-Node Variants + +For architecture, configuration, and current scope, see +[CAN_NOTES.md](CAN_NOTES.md). + +The following files implement the same logical command families over packed CAN messages rather than the ASCII LX200-style transport: + +- `src/telescope/focuser/local/Focuser.can.command.cpp` +- `src/telescope/rotator/local/Rotator.can.command.cpp` +- `src/telescope/auxiliary/local/Features.can.command.cpp` + +These are not separate end-user command names. They are binary transport implementations of the same focuser, rotator, and auxiliary-feature command sets above. + +Notable transport differences: + +- CAN replies are binary-packed, not ASCII text. +- `:GXY0#` for CAN features returns a single bitmask byte rather than an eight-character ASCII bitmap. +- CAN focuser/rotator driver-status replies are packed bitfields rather than comma-separated text flags. + +## Source Coverage + +This document was built from the current handlers in: + +- `src/telescope/Telescope.command.cpp` +- `src/telescope/mount/Mount.command.cpp` +- `src/telescope/mount/goto/Goto.command.cpp` +- `src/telescope/mount/guide/Guide.command.cpp` +- `src/telescope/mount/home/Home.command.cpp` +- `src/telescope/mount/library/Library.command.cpp` +- `src/telescope/mount/limits/Limits.command.cpp` +- `src/telescope/mount/park/Park.command.cpp` +- `src/telescope/mount/pec/Pec.command.cpp` +- `src/telescope/mount/site/Site.command.cpp` +- `src/telescope/mount/status/Status.command.cpp` +- `src/lib/axis/Axis.command.cpp` +- `src/telescope/focuser/local/Focuser.command.cpp` +- `src/telescope/rotator/local/Rotator.command.cpp` +- `src/telescope/auxiliary/local/Features.command.cpp` +- plus the corresponding CAN transport handlers +- plus `src/libApp/commands/ProcessCmds.cpp` diff --git a/docs/GEM LIMITS EXAMPLE EAST OF PIER.jpg b/docs/GEM LIMITS EXAMPLE EAST OF PIER.jpg new file mode 100755 index 0000000000000000000000000000000000000000..796071770520defac9eb12d32686e952bf40086f GIT binary patch literal 49542 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 PFN#NUZ;NgyN`B!nbXBrGJn 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≥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 literal 0 HcmV?d00001 diff --git a/docs/GEM LIMITS EXAMPLE KEEP OUT ZONE.jpg b/docs/GEM LIMITS EXAMPLE KEEP OUT ZONE.jpg new file mode 100755 index 0000000000000000000000000000000000000000..a954d9cc1008dae01fce231afd5dda65618985a3 GIT binary patch literal 37253 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