Skip to content

Commit

Permalink
Add more info to manual
Browse files Browse the repository at this point in the history
  • Loading branch information
anderssandstrom committed Sep 29, 2024
1 parent c536e8c commit ef5e00a
Show file tree
Hide file tree
Showing 5 changed files with 36 additions and 23 deletions.
2 changes: 1 addition & 1 deletion hugo/content/manual/knowledgebase/hardware/EL1xxx.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ These terminals are very powerful since they can latch the time of the positive

**IMPORTANT**
Sine the EL1252-0050 is a 5V terminal, it needs to be powered with **5V** if the terminal is powered with 24V, the terminal will burn. The simplest way to achieve a correct power supply is by adding an EL9505 (or similar) before the EL1252-0050.
See above for more information [5v-and-24v-terminals](../elxxxx#5v-and-24v-terminals)
See above for more information [5v-and-24v-terminals](../elxxxx#power-bus-5v-and-24v-terminals)

{{% notice warning %}}
**Make sure the EL1252-0050 has a 5V power supply by an EL9505 (or similar), before powering the system. If the terminal is powered with the normal 24V it will most likely break**
Expand Down
18 changes: 17 additions & 1 deletion hugo/content/manual/knowledgebase/hardware/EL70x1.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,8 @@ chapter = false

## Topics
1. [error/warning](#error/warning)
2. [Tuning](#tuning)
2. [tuning](#tuning)
3. [Speed range](#speed-range)

### error/warning
If the El70x1 is in error or warning state, further information about the reason for the error/warning can be read from the drives diagnostic register by using the ethercat command. See [command line interface](ethercatcli).
Expand Down Expand Up @@ -115,3 +116,18 @@ This is the current loop settings and this is also what affect the performance.
For most applications it is important to keep a ration of 40:1.
Default is 400 / 10, if you want a stiffer loop, then change to f ex 800 / 20 and onwards.
Increase until the motor misbehaves and go back to a safe setting.

### speed range
The EL704x stepper drives are default setup to a maximum velocity range of +-2000 full-steps/s. The 16bit velocity setpoint that are sent to the drive corresponds to this range. The speed range for the EL704x can however be changed by setting SDO 8012:05:
```
0 for 1000 full-steps/second
1 for 2000 full-steps/second (default)
2 for 4000 full-steps/second
3 for 8000 full-steps/second
4 for 16000 full-steps/second
5 for 32000 full-steps/second
```

{{% notice info %}}
The drive scaling in the axis yaml configuration must be updated if the speed range is changed. See [scaling](../../../motion_cfg/scaling/).
{{% /notice %}}
6 changes: 3 additions & 3 deletions hugo/content/manual/knowledgebase/hardware/ELxxxx.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ weight = 16
chapter = false
+++

# 5V and 24V terminals
24V is the most common signal level for the terminals, however, a few terminals also support other voltage levels, for instance 5V.
# Power bus - 5V or 24V terminals
24V is the most common signal level for the terminals, however, some also support other voltage levels, for instance 5V, or 12V or....
In that case, normally the terminal needs to be powered with the same voltage.
For 5V terminals, normally this is handled by adding a EL9505 before the 5v terminal in the ethercat chain. The EL9505 will supply the power bus with 5V instead of the normal 24V .
For 5V terminals, normally a EL9505 is added before the 5v terminal in the ethercat chain supplying the power bus with 5V.

Example of slaves needing 5V power supply:
* EL1124
Expand Down
4 changes: 2 additions & 2 deletions hugo/content/manual/knowledgebase/host.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,10 +5,10 @@ chapter = false
+++

## Topics
1. [latency issues](#latency-issues)
1. [latency issues / lost frames](#latency-issues--lost-frames)
2. [EtherCAT rate (EC_RATE)](#EtherCAT-rate-(EC_RATE))

### latency issues
### latency issues / lost frames

High latency, more than 10% of the ethercat cycle time, can in worse case result, in lost ethercat frames, which of course is not an ideal situation. High latency of the ecmc_rt thread can be related to:
1. The generic device driver is used
Expand Down
29 changes: 13 additions & 16 deletions hugo/content/manual/knowledgebase/motion.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,7 @@ chapter = false

## Topics
1. [both_limits error](#both_limits-error)
2. [position lag error, (following error), tuning](#position-lag-error)
3. [latency issues](#latency-issues)
2. [position lag error, (following error)](#position-lag-error)
4. [drive refuse to enable](#drive-refuse-to-enable)
5. [force manual motion](#force-manual-motion)

Expand Down Expand Up @@ -48,8 +47,8 @@ Before increase current to the motor, make sure that both motor and drive can ha
{{% /notice %}}

### 2. scaling factors are wrong
Check the scaling documentation [here](https://paulscherrerinstitute.github.io/ecmccfg/manual/axis/scaling/).
One way to test if the scaling is correct is to set all controller parameters (except Kff) to 0 and then initiate a move. Basically the actual position of the axis should follow the setpoint closely with teh same slope. If the slope differs, then the scaling factors are wrong.
Check the scaling documentation [here](../../motion_cfg/scaling/).
One way to test if the scaling is correct is to set all controller parameters (except Kff) to 0 and then initiate a move. Basically the actual position of the axis should follow the setpoint closely with the same slope. If the slope differs, then the scaling factors are wrong.

### 3. the velocity setpoint is too high resulting in stall
If a stepper motor stalls because of too high velocity there's a few thing that can be done in order to improve the ability to reach higher velocities:
Expand All @@ -62,24 +61,22 @@ Before increase current to the motor, make sure that both motor and drive can ha
{{% /notice %}}

### 4. velocity higher than allowed by driver
For EL704x stepper drives are default setup to maximum velocity range of +-2000 full-steps/s. The 16bit velocity setpoint that are sent to the drive corresponds to this range. Basically trying to write a higher value than that will saturate the velocity setpoint resulting in that the required speed is not achieved, resulting in position lag error. The speed range for the EL704x can however be changed by setting SDO 8012:05:
```
0 for 1000 full-steps/second
1 for 2000 full-steps/second (default)
2 for 4000 full-steps/second
3 for 8000 full-steps/second
4 for 16000 full-steps/second
5 for 32000 full-steps/second
```
After changing this value you also need to change the drive scaling in the axis yaml file.
The velocity setpoint of drives covers a certain velocity range:
* EL70xx stepper drives default: 16bit setpoint that corresponds to a velocity range of +-2000full-steps/s.
* EL72xx servo drives default: 32bit setpoint that corresponds to a velocity range of either +-6000Hz or +-8000Hz depending on the motor pole count.

If a velocity outside the velocity range is requested, the velocity setpoint will be saturated and the requested velocity will not be reached resulting in a position lag error.

For EL70xx drives the velocity range can be configured to other values than the default +-2000full-steps/s. See
[el70x1 speed range](../hardware/el70x1#speed-range) for setting other velocity range.

## drive refuse to enable
First check the dedicated hardware drive panel for diagnostics. If the drive is in warning or error state the diagnose the problem with the tool described in [hardware](hardware).
First check the dedicated hardware drive panel for diagnostics. If the drive is in warning or error state then, if an EL70x1 drive, diagnose the problem further with the tool described in [hardware](../hardware/el70x1).

Possible reasons:
1. For systems with safety, tripp off STO or power to the drive removed by contactor. Check status of safety system.
2. Over current protection of 48V tripped.
3. No 48V connected.
3. No motor power connected (48V or24V).
4. ecmc PLC disabling axis, check PLC sources.
5. Motion axis in error state. Some errors prevent the axis from being enabled. Check axis error state
6. Drive hardware enable input not set high (valid for EP7211-0034, EL70xx if special cfgs).
Expand Down

0 comments on commit ef5e00a

Please sign in to comment.