forked from epics_driver_modules/motorBase
Kevin Peterson
53 lines
2.7 KiB
Markdown
53 lines
2.7 KiB
Markdown
# motor
|
|
[](https://github.com/epics-modules/motor/actions/workflows/ci-scripts-build.yml)
|
|
<!--[](https://travis-ci.org/epics-modules/motor)-->
|
|
|
|
This module contains motor support for the Experimental Physics and Industrial Control System (EPICS).
|
|
|
|
The core motor functionality resides in this respository. Starting with R7-0 the drivers have been moved from motor to standalone github repositories, which have been added to motor as submodules. The driver repositories can be found here: https://github.com/epics-motor
|
|
|
|
## Getting started
|
|
|
|
### Updating clones created before 2019-04-02
|
|
Use the following procedure to update clones that were created before the beginning of the motor split:
|
|
```bash
|
|
$ cd motor
|
|
$ make distclean
|
|
$ git fetch origin
|
|
$ git status
|
|
<behind by many commits and can be fast-forwarded>
|
|
$ git stash
|
|
$ git rebase origin/master
|
|
$ git stash apply
|
|
$ git submodule init
|
|
$ git submodule update
|
|
```
|
|
Failure to 'make distclean' before rebasing will result in many driver source directories in motorApp with "O.*" directories that need to be removed manually.
|
|
|
|
### Cloning motor with support for all motor controllers
|
|
The following command results in a motor directory that contains all of the driver submodules:
|
|
```bash
|
|
$ git clone --recursive https://github.com/epics-modules/motor.git
|
|
```
|
|
|
|
### Cloning motor with support for a single motor controller
|
|
The following procedure allows only required drivers to be built, which can significantly reduce build times:
|
|
```bash
|
|
$ git clone https://github.com/epics-modules/motor.git
|
|
$ cd motor
|
|
$ git submodule init
|
|
$ git submodule update modules/motorMotorSim
|
|
```
|
|
|
|
## Additional Info
|
|
For more information, see:
|
|
* [main page](https://epics-modules.github.io/motor)
|
|
* [release notes](https://github.com/epics-modules/motor/blob/master/docs/RELEASE.md)
|
|
* [motor wiki](https://github.com/epics-modules/motor/wiki)
|
|
* http://www.aps.anl.gov/bcda/synApps
|
|
* [HTML documentation](https://github.com/epics-modules/motor/blob/master/docs/README.md)
|
|
|
|
[Report an issue with Motor](https://github.com/epics-modules/motor/issues/new?title=%20ISSUE%20NAME%20HERE&body=**Describe%20the%20issue**%0A%0A**Steps%20to%20reproduce**%0A1.%20Step%20one%0A2.%20Step%20two%0A3.%20Step%20three%0A%0A**Expected%20behaivour**%0A%0A**Actual%20behaviour**%0A%0A**Build%20Environment**%0AArchitecture:%0AEpics%20Base%20Version:%0ADependent%20Module%20Versions:&labels=bug)
|
|
[Request a feature](https://github.com/epics-modules/motor/issues/new?title=%20FEATURE%20SHORT%20DESCRIPTION&body=**Feature%20Long%20Description**%0A%0A**Why%20should%20this%20be%20added?**%0A&labels=enhancement)
|
|
|