Commit Graph

42 Commits

Author SHA1 Message Date
Mark Rivers 302d4d61fc Merge branch 'master' of github.com:epics-modules/motor 2022-10-10 08:15:13 -05:00
Mark Rivers 382c8324e5 New documentation file 2022-10-10 08:14:57 -05:00
Xiaoqiang Wang b0cabdf66d fix some field types according to motorRecord.dbd 2022-09-14 13:09:24 +02:00
Kevin Peterson da3bfab4c1 Added R7-2-2 to RELEASE.md 2021-02-02 12:18:21 -06:00
Kevin Peterson f47a376423 Corrected typo 2020-06-11 17:30:40 -05:00
Torsten Bögershausen 2906f3d8f9 Add field RSTM: Restore Mode
Partly revert the following commit:
  commit 3090983c31
  Author: Ron Sluiter <rsluiter@users.noreply.github.com>
  Date:   Wed Jul 29 15:50:23 2015 +0000
      Bug fix for target position (VAL/DVAL/RVAL) initialization error
      when the motor record is configured to do retries.
And from the release notes:

6) Kevin Peterson discovered an initialization bug when the motor record is
    configured to do retries. When configured to do retries, the motor
    record issues incremental rather than absolute moves. If the motor
    behaves badly (e.g., a piezo stiction motor) the controller's absolute
    step count can be far from its' absolute readback position. The motor
    record initialization logic that determines how the target positions
    are initialized at boot-up was not taking into consideration whether
    or not the motor record is configured to do retries, and therefore,
    whether or not absolute or incremental moves were issued by the motor
    record. With this release, if the motor record is configured to do
    retries, then the controller's absolute position is ignored (because
    the controller's absolute position was "corrupted" by retries) and the
    autosave/restore position is used to set the controllers position.

    Switching between retries on and off (relative vs. absolute moves)
    between reboots will cause unpredictable results and is not covered
    by this bug fix.

   Files modified: motor_init_record_com() in MotorSrc/motordevCom.cc
                   init_controller()       in MotorSrc/devMotorAsyn.c

Commit 3090983c improves the situation for setups where autosave is
used, and makes things worse when autosave is not used.
When autosave is not used and the motor is configured to do retries,
the the DVAL field is loaded into the controller regardless.
And because DVAL is 0.0 at startup, the controller position is lost.

The first issue report is found here:
"Problem with R6-10 issue 6 fix - controller position can be lost on reboot"
https://github.com/epics-modules/motor/issues/85

And the we have another issue report here:
"IOC zeroes encoder on startup"
https://github.com/motorapp/Galil-3-0/issues/13

A possible way forward is discussed here:
"Add a field to the motor record to allow always restoring the
 autosaved position"
https://github.com/epics-modules/motor/issues/151

This commit adds the "RSTM" field:
- 0 Disables restoring the autosaved position
- 1 Always restores the autosaved position
- 2 Uses the same logic as motorRecord 6.9 (or older)
- 3 Uses the same logic as motorRecord 6.10

This numbering maps 0 and 1 somewhat to false/true, uses 2/3 for
special handlings and leaves room for more choices.

E.g. "use the encoder value, if valid, fall back to autosave if not.
Or "use the URIP/RDBL" if possible.
I am getting off-topic,
those improvements should be done in later commits anyway.
2020-06-10 07:55:22 +02:00
Kevin Peterson cafd96b0e9 Also omit the patch version from the 'Motor Version' column in index.html 2020-05-14 15:36:55 -05:00
Kevin Peterson 8d6b6cf33d Omit the patch version from the 'Module Version' column in index.html 2020-05-14 15:34:31 -05:00
Kevin Peterson ae9114e96c Updated documentation for R7-2-1 2020-05-14 15:31:02 -05:00
Kevin Peterson 3f207f6662 Fixed typo 2020-05-13 17:36:26 -05:00
Kevin Peterson 7fe4b35aa6 Updated the html documentation for version 7.2 2020-05-13 17:31:15 -05:00
Kevin Peterson 57d9f53728 Minor changes to the formatting of RELEASE.md 2020-05-13 17:16:24 -05:00
Kevin Peterson 2508548009 Updated RELEASE.md for R7-2 2020-05-13 17:12:18 -05:00
Torsten Bögershausen 8b43d40d18 send_mess() uses 'const char *' (and more const char*)
The 2nd and 3rd parameter in send_mess() can and should
be a 'const char *' instead of just 'char *'.
Modern compilers complain here, so that the signature now
gets the const.

Update drivers from the following list to use the new send_mess():
    modules/motorAcs
    modules/motorAcsTech80
    modules/motorAerotech
    modules/motorFaulhaber
    modules/motorIms
    modules/motorKohzu
    modules/motorMclennan
    modules/motorMicos
    modules/motorMicroMo
    modules/motorNewFocus
    modules/motorNewport
    modules/motorOms
    modules/motorOriel
    modules/motorPI
    modules/motorParker
    modules/motorPiJena
    modules/motorSmartMotor
    modules/motorThorLabs

And while there, fix one more "const char *" in motordrvCom.cc
2019-09-30 13:15:35 +02:00
kpetersn 5189abaf68 Updated documentation for R7-1 2019-08-13 16:05:10 -05:00
kpetersn 8bf48f992e Added note about EPICS base versions. 2019-04-19 10:16:32 -05:00
kpetersn 32dd84f4f2 Updated R7-0 release date. 2019-04-19 10:04:00 -05:00
kpetersn fe070f67b6 Changed the date format to YYYY-MM-DD 2019-04-19 10:02:52 -05:00
Kevin Peterson 1b381267c3 Updated RELEASE.md
Changed phrasing and added emphasis.
2019-04-18 16:50:05 -05:00
Kevin Peterson d06e182411 Update RELEASE.md
Fixed the table
2019-04-18 16:42:11 -05:00
kpetersn effbd1af18 Added R7-0 to RELEASE.md 2019-04-18 16:38:53 -05:00
kpetersn dda978d6aa Updated index.html 2019-04-18 15:39:15 -05:00
kpetersn 91c0b96a72 Updated index.html 2019-04-17 15:50:42 -05:00
kpetersn 78883155b5 Updated modification date on motorRecord.html 2019-04-17 14:58:09 -05:00
kpetersn a26623048f Updated notice in RELEASE.txt 2019-04-17 14:57:07 -05:00
kpetersn 4c401140d8 Simplified the Files section 2019-04-17 14:55:38 -05:00
kpetersn b97dc3edff Order the controller manufacturers alphabetically 2019-04-17 12:10:50 -05:00
kpetersn b62ab38f02 Updated motorRecord.html to contain links to driver repos, which will be the definitive location for the list of supported controllers. 2019-04-17 12:01:54 -05:00
kpetersn 8825ef22a2 Use bullets instead of roman numerals. 2019-04-16 12:13:21 -05:00
kpetersn 8b031327f7 Added links to RELEASE.md 2019-04-16 12:06:13 -05:00
kpetersn 27c6a6a2c1 Added docs/RELEASE.md; Moved README to docs/RELEASE.txt 2019-04-16 11:43:36 -05:00
kpetersn 8f9d18e008 Removed AerotechSrc; Added motorAerotech submodule 2019-04-11 12:59:05 -05:00
kpetersn 88079ac80c Corrected R6-11's release date. 2018-12-12 10:54:19 -06:00
kpetersn e704f89f23 Added R6-11 documentation 2018-12-12 10:52:25 -06:00
kpetersn 2a7544a7a0 Corrected SPDB documentation in motorRecord.html. Added SPDB to basic_motor_settings.req 2018-12-12 10:40:44 -06:00
Torsten Bögershausen 0ea2d9ec87 Add field SPDB, "Set Point Dead Band"
This is from Matthew Pearson, pearsonmr@ornl.gov

A number of users and staff have requested that the motor record have a
setpoint deadband field (eg. SPDB), which prevents any motion from
happening if the readback position is within SPDB.
Without a SPDB we have issues with motors moving unnecessarily.

For example, if the RBV is 0.001 and we set VAL to 0.0, if we have a
non-zero backlash correction then the motor will move unnecessarily
to take out backlash.
Even without backlash correction we often enable and disable the
drive amplifier for no good reason.

Currently the effective setpoint deadband is equal to MRES,
but this is often too small to be an effective setpoint deadband.

The new SPDB field would default to 0.0

The new code hooks into do_work():
When the new setpoint is within DPDB, set too_small and don't move.

The new code does not use snipptes like "abs(npos - rpos)", these
already produce warnings on 64 bit sytems.
abs() is declared to work on int, but we feed long values.
Simply compare the coordinates in engineering units.
2018-11-20 08:51:49 +01:00
Mark Rivers 8b5d5f92bd Added note at the end that the file is incomplete 2018-08-25 17:14:47 -05:00
kpetersn 4fb9e1c934 Changes to motor_notes.txt from Ron Sluiter on 2018-01-10 2018-08-08 16:18:48 -05:00
kpetersn 70b489f2de Corrected my email address. 2018-08-03 09:51:53 -05:00
kpetersn d739f5c1dd Use github pages links instead of htmlpreview links 2018-08-01 13:37:13 -05:00
kpetersn 3b75e3096f Renamed motor.html to index.html so that it can be used with github pages. 2018-08-01 13:26:17 -05:00
kpetersn fd4641f267 Renamed documentation directory so that it can be used with github pages. 2018-08-01 13:23:40 -05:00