Skip to content

Commit

Permalink
Merge pull request #1654 from ROBOTIS-Yang/Dynamixel-Y
Browse files Browse the repository at this point in the history
Add DY en E-manual
  • Loading branch information
ROBOTIS-Yang authored Mar 22, 2024
2 parents 856c2b1 + 80ac351 commit 4428eb9
Show file tree
Hide file tree
Showing 89 changed files with 3,896 additions and 5 deletions.
8 changes: 4 additions & 4 deletions _data/navigation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19184,7 +19184,7 @@ ym070-210-r051-rh:
children:
- title: "Output Bearing Specifications (L10=7,000hours@rated output speed)"
titlekr: "출력 베어링 사양 (L10=7,000hours@rated output speed)"
url: /dxl/y/ym070-210-r051-rh/output-bearing-specifications-l107000hoursrated-output-speed
url: /dxl/y/ym070-210-r051-rh/#output-bearing-specifications-l107000hoursrated-output-speed
urlkr: /dxl/y/ym070-210-r051-rh/#출력-베어링-사양-l107000hoursrated-output-speed
- title: "Bearing Life"
titlekr: "베어링 수명"
Expand Down Expand Up @@ -19512,7 +19512,7 @@ ym070-210-r099-rh:
children:
- title: "Output Bearing Specifications (L10=7,000hours@rated output speed)"
titlekr: "출력 베어링 사양 (L10=7,000hours@rated output speed)"
url: /dxl/y/ym070-210-r099-rh/output-bearing-specifications-l107000hoursrated-output-speed
url: /dxl/y/ym070-210-r099-rh/#output-bearing-specifications-l107000hoursrated-output-speed
urlkr: /dxl/y/ym070-210-r099-rh/#출력-베어링-사양-l107000hoursrated-output-speed
- title: "Bearing Life"
titlekr: "베어링 수명"
Expand Down Expand Up @@ -20139,7 +20139,7 @@ ym080-230-r051-rh:
children:
- title: "Output Bearing Specifications (L10=7,000hours@rated output speed)"
titlekr: "출력 베어링 사양 (L10=7,000hours@rated output speed)"
url: /dxl/y/ym080-230-r051-rh/output-bearing-specifications-l107000hoursrated-output-speed
url: /dxl/y/ym080-230-r051-rh/#output-bearing-specifications-l107000hoursrated-output-speed
urlkr: /dxl/y/ym080-230-r051-rh/#출력-베어링-사양-l107000hoursrated-output-speed
- title: "Bearing Life"
titlekr: "베어링 수명"
Expand Down Expand Up @@ -20467,7 +20467,7 @@ ym080-230-r099-rh:
children:
- title: "Output Bearing Specifications (L10=7,000hours@rated output speed)"
titlekr: "출력 베어링 사양 (L10=7,000hours@rated output speed)"
url: /dxl/y/ym080-230-r099-rh/output-bearing-specifications-l107000hoursrated-output-speed
url: /dxl/y/ym080-230-r099-rh/#output-bearing-specifications-l107000hoursrated-output-speed
urlkr: /dxl/y/ym080-230-r099-rh/#출력-베어링-사양-l107000hoursrated-output-speed
- title: "Bearing Life"
titlekr: "베어링 수명"
Expand Down
39 changes: 39 additions & 0 deletions _includes/en/dxl/common_link.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,45 @@
[Goal Position(564)]: #goal-position564
[Velocity Limit(44)]: #velocity-limit44

<!-- DXL-Y -->

[Status Return Level(15)]: status-return-level15
[Drive Mode(32)]: #drive-mode32
[Operating Mode(33)]: #operating-mode33
[Position Limit Threshold(38)]: #position-limit-threshold38
[Following Error Threshold(44)]: #following-error-threshold44
[Inverter Temperature Limit(56)]: #invertermotor-temperature-limit56-57
[Motor Temperature Limit(57)]: #invertermotor-temperature-limit56-57
[Max Voltage Limit(60)]: #maxmin-voltage-limit60-62
[Min Voltage Limit(62)]: #maxmin-voltage-limit60-62
[Max/Min Voltage Limit(60, 62)]: #maxmin-voltage-limit60-62
[PWM Limit(64)]: #pwm-limit64
[Current Limit(66)]: #current-limit66
[Stuatus Return Level (68)]: #stuatus-returnlevel68
[Velocity Limit(72)]: #velocity-limit72
[Max position limit(76)]: #maxmin-position-limit76-84
[Min Position limit(84)]: #maxmin-position-limit76-84
[Gear Ratio Num(96)/Den(100)]: #electronic-gear-ratio-numeratordenominator96-100
[Controller State(152)]: #controller-state152
[Error Code(153)]: #error-code153
[Gain Save(170)]: #gain-save170
[Profile Acceleration(240)]: #profile-acceleration240-profile-velocity244
[Profile Velocity(244)]: #profile-acceleration240-profile-velocity244
[Torque Enable(512)]: #torque-enable512
[Goal PWM(524)]: #goal-pwm524
[Goal Current(526)]: #goal-current526
[Goal Velocity(528)]: #goal-velocity528
[Goal Position(532)]: #goal-position532
[Moving Status(541)]: #moving-status541
[Present Velocity(548)]: #present-velocity548
[Present Position(552)]: #present-position552
[Position Trajectory(560)]: #position-trajectory560
[Velocity Trajectory(564)]: #velocity-trajectory564
[Present Input Voltage(568)]: #present-input-voltage568
[Present Inverter Temperature(570)]: #present-inverter-temperature570
[Present Motor Temperature(571)]: #present-motor-temperature571
[Error Clear Packet]: #error-clear-packet

<!--Common Links -->

[Compatibility Guide]: http://en.robotis.com/service/compatibility_table.php?cate=dx
Expand Down
57 changes: 57 additions & 0 deletions _includes/en/dxl/y/clear_packet.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
| Packet Type | P1 | P2 ~ P5 | Description |
|:----------------:|:----:|:--------------------------------------:|:--------------------------------------------------------------------------------|
| Multi-Turn Clear | 0x01 | Fixed value<br />(0x44 0x58 0x4C 0x22) | Sets the current position (Present Position) value to an absolute position within one revolution based on the motor. Can be cleared only when the motor is not in motion.<br />If the Clear Instruction Packet is sent while Torque Enable is active, the Error field in the Status Packet will display Result Fail (0x01). |
| Error Clear | 0x02 | Fixed value<br />(0x45 0x52 0x43 0x4C) | Clear errors that occurred in DYNAMIXEL.<br />If an error cannot be cleared or the conditions for clearance are not met, the error remains uncleared, and Result Fail (0x01) is displayed in the Error field of the Status Packet. |



## [Multi-Turn Clear Packet](#multi-turn-clear-packet)

DYNAMIXEL-Y is capable of backing up Multi-Turn information, ensuring that it is preserved even after a power outage. A Multi-Turn Clear Packet is required to reset this value. After Multi-Turn Clear, DYNAMIXEL will undergo a reboot.
After replacing the Multi-Turn backup battery, it is essential to perform this process to ensure normal operation.


**Note**: Multi-Turn Clear resets the absolute position value to within one motor revolution. Models with an attached reducer may lose their reducer-based absolute position. Please set the absolute position of the reducer to 0 and proceed with Multi-Turn Clear.
{: .notice}

### [Multi-Turn Clear Method](#multi-turn-clear-method)

![](/assets/images/dxl/y/multi-turn_clear_guide.PNG)

1. Click the 'Packet' button at the top of DYNAMIXEL Wizard 2.0 to open the packet window. If connected to DYNAMIXEL, click 'Disconnect' to terminate the connection.
2. Set the COM Port and Baud Rate, then click the 'Open' button.
3. Select 'Clear Instruction' from the Instruction tab.
4. Enter the correct DYNAMIXEL ID and click the 'Send' button to transmit the packet.
5. Wait until the Status Packet is received. Check the received packet for errors.


**Note**: For more detailed information, please refer to [DYNAMIXEL Wizard 2.0] and [DYNAMIXEL Protocol 2.0]
{: .notice}

## [Error Clear Packet](#error-clear-packet)

If an error occurs in DYNAMIXEL-Y, it can be cleared.
If the [Error Code(153)] is not 0, Error Clear can be initialized using the [Clear Instruction Packet]. If initialization is not possible, the Error field in the Status Packet will result in Fail (0x01).

# [Multi-Turn backup Battery Replacement](#multi-turn-backup-battery-replacement)

DYNAMIXEL-Y features an internal battery for Multi-Turn Position Backup. After replacing the battery, it is necessary to perform the Multi-Turn Clear operation to reset the Multi-Turn settings for proper operation.

## [Procedure for Battery Replacement](#procedure-for-battery-replacement)

![](/assets/images/dxl/y/brtterry_replacement_guide_en.PNG)

1. Prepare the DYNAMIXEL-Y and a new battery.
2. After supplying power and searching for DYNAMIXEL-Y through DYNAMIXEL Wizard 2.0, click
Tools → Encoder Battery Replacement menu.
3. In the case of a reducer model, check if the origin position matches and click the Next button.
(If the origin position doesn't match, please adjust it accordingly.)
4. Open the battery cover, replace it with a new battery, close the cover, and click the Next button.
5. Wait for the operation to proceed.
6. Once finished, exit the menu by clicking the OK button.



[DYNAMIXEL Wizard 2.0]: https://emanual.robotis.com/docs/en/software/dynamixel/dynamixel_wizard2/
[Dynamixel Protocol 2.0]: https://emanual.robotis.com/docs/en/dxl/protocol2/
[Clear Instruction Packet]: https://emanual.robotis.com/docs/en/dxl/protocol2/#clear-0x10
12 changes: 12 additions & 0 deletions _includes/en/dxl/y/connector_y070.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@

| Item | RS-485 | | Power | |
|:------------:|:-----------------------------------------------------:|:-------:|:------------------------------------------------------------------------------------------:|:--:|
| Pinout | `1` DATA+<br />`2` DATA- | | `1` GND<br /> `2` VDD |
| Diagram | ![](/assets/images/dxl/y/molex_505565-0200_diagram.jpg) | ![](/assets/images/dxl/y/molex_39500-0002_diagram.jpg) | ![](/assets/images/dxl/y/molex_39503-2002_diagram.jpg) | ![](/assets/images/dxl/y/molex_39503-3002_diagram.jpg) |
| Housing | ![](/assets/images/dxl/y/molex_505565-0200.jpg)<br />Molex 505565-0200 | S/T type<br />![](/assets/images/dxl/y/molex_39500-0002.jpg)<br />Molex 39500-0002 | R/A type 1<br />![](/assets/images/dxl/y/molex_39503-2002.jpg)<br />Molex 39503-2002 | R/A type 2<br />![](/assets/images/dxl/y/molex_39503-3002.jpg)<br />Molex 39503-3002 |
| PCB Header | ![](/assets/images/dxl/y/molex_505568-0381.jpg)<br />Molex 505568-0381 | | ![](/assets/images/dxl/y/molex_39501-1002.jpg)<br />Molex 39501-1002 | |
| Crimp Terminal | ![](/assets/images/dxl/y/molex_504185-1000.png)<br />Molex 504185-1000 | | ![](/assets/images/dxl/y/option_ce007508.png)<br />(Option) CE007508(0.75SQ, L14, P8) | |
| Wire Specification | 26 AWG | | 20 AWG | |

**Caution**: Before operation, ensure that 24V power is supplied through the power port. During setup, take special care to ensure that the polarity of all connections are correct. Incorrect connection may result in serious damage to the DYNAMIXEL.
{: .notice--warning}
12 changes: 12 additions & 0 deletions _includes/en/dxl/y/connector_y080.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@

| Item | RS-485 | | Power | |
|:------------:|:-----------------------------------------------------:|:-------:|:------------------------------------------------------------------------------------------:|:--:|
| Pinout | `1` DATA+<br />`2` DATA- | | `1` GND<br /> `2` VDD |
| Diagram | ![](/assets/images/dxl/y/molex_505565-0200_diagram.jpg) | ![](/assets/images/dxl/y/molex_39500-0002_diagram.jpg) | ![](/assets/images/dxl/y/molex_39503-2002_diagram.jpg) | ![](/assets/images/dxl/y/molex_39503-3002_diagram.jpg) |
| Housing | ![](/assets/images/dxl/y/molex_505565-0200.jpg)<br />Molex 505565-0200 | S/T type<br />![](/assets/images/dxl/y/molex_39530-0002.jpg)<br />Molex 39530-0002 | R/A type 1<br />![](/assets/images/dxl/y/molex_39533-2002.jpg)<br />Molex 39533-2002 | R/A type 2<br />![](/assets/images/dxl/y/molex_39533-3002.jpg)<br />Molex 39533-3002 |
| PCB Header | ![](/assets/images/dxl/y/molex_505568-0381.jpg)<br />Molex 505568-0381 | | ![](/assets/images/dxl/y/molex_39531-1002.jpg)<br />Molex 39531-1002 | |
| Crimp Terminal | ![](/assets/images/dxl/y/molex_504185-1000.png)<br />Molex 504185-1000 | | ![](/assets/images/dxl/y/option_ce010010.png)<br />(Option) CE010010(1.0SQ, L16, P10) | |
| Wire Specification | 26 AWG | | 20 AWG | |

**Caution**: Before operation, ensure that 24V power is supplied through the power port. During setup, take special care to ensure that the polarity of all connections are correct. Incorrect connection may result in serious damage to the DYNAMIXEL.
{: .notice--warning}
1 change: 1 addition & 0 deletions _includes/en/dxl/y/control_table_0_model_number.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
The DYNAMIXEL model number.
9 changes: 9 additions & 0 deletions _includes/en/dxl/y/control_table_104_safe_stop_time.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
When the value of [Torque Enable(512)] is changed from '1' (Torque ON) to '0' (Torque OFF), the device stops its operation and cuts off the signal supplied to the inverter. If the device is rotating, it slows the rotation speed to zero according to the duration specified by Safe Stop Time (104) to prevent damage.

| Unit | Range | Initial Value |
|:----:|:------------:|:-------------:|
| [ms] | 0 ~ 32,767 | 200 |


**Note** : In Current Control mode, only Dynamic Brake deceleration is used.
{: .notice}
9 changes: 9 additions & 0 deletions _includes/en/dxl/y/control_table_106_brake_delay.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
Sets the delay time until Brake operation and Goal Update are activated.

| Address| Label | Unit | Range | Description |
|:------:|:-----------------:|:----:|:----------:|:-------------------------------------------------------------------------------------------|
| 106 | Brake Delay | [ms] | 0 ~ 32,767 |Torque ON: Brake Release occurs after Brake Delay (106)[ms] from the time that the [Torque Enable(512)] value is changed to 1.<br>Torque OFF: The controller turns OFF 100[ms] after the Brake Lock is enabled. |
| 108 | Goal Update Delay | [ms] | 0 ~ 32,767 | Update of Goal Position, Velocity, Current, and PWM values begins after Goal Update Delay(108)[ms] from the point of Brake Release. |



29 changes: 29 additions & 0 deletions _includes/en/dxl/y/control_table_10_secondary_id.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
The Secondary ID (10) is used to identify devices, similar to ID (7).
There are several important differences between ID (7)and Secondary ID (10):
1. The Secondary ID does not need to be a unique value. This means that multiple devices can share the same Secondary ID value, allowing the creation of device groups.
2. The primary ID has a higher priority than the Secondary ID. If the Secondary ID and ID are the same, the primary ID takes precedence.
You cannot use the Secondary ID to change values in the EEPROM area of the control table. Only values in the RAM area can be changed.
3. If a command is sent to a servo’s Secondary ID, no Status Packet will be returned.
4. If the value of the Secondary ID is 253 or higher, the Secondary ID functionality is disabled.


| Value | Description |
|:---------:|:----------------------------------------------------------|
| 0 ~ 252 | Enable Secondary ID function |
| 253 ~ 255 | Disable Secondary ID function,<br />Default value : ‘255’ |

Here is an example scenario with 5 devices with IDs (7) ranging from 1 to 5:

{% capture secondary_id_ex1 %}
1. Set the Secondary ID (12) to '5' for all 5 devices.
2. Send a Write Instruction Packet (ID = 1, LED (513) = 255).
3. The device with ID '1' turns on its LED and returns a Status Packet.
4. Send a Write Instruction Packet (ID = 5, LED (513) = 255):
5. All 5 devices turn on their LEDs.
6. However, only device ID '5' returns a Status Packet.
7. Set the Secondary ID (12) to '100' for all 5 devices.
8. Send a Write Instruction Packet (ID = 100, LED (513) = 0): All 5 devices turn off their LEDs. Since there is no device with ID '100', no Status Packet is returned.
{% endcapture %}

<div class="notice">{{ secondary_id_ex1 | markdownify }}</div>

Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
These are the values for controlling the brake input voltage. According to the brake demand value, set the Overexcitation Voltage(110), Normal Excitation Voltage(111), and Overexcitation Time(112) in the timing chart below.

![](/assets/images/dxl/y/overexcitation_voltage.PNG)

| item | Unit | Range |
|:-------------------------------|:---------|:-----------|
| Overexcitation Voltage(110) | 1.0 [%] | 0 ~ 100 |
| Normal Excitation Voltage(111) | 1.0 [%] | 0 ~ 100 |
| Overexcitation Time(112) | 1.0 [ms] | 0 ~ 32,767 |
13 changes: 13 additions & 0 deletions _includes/en/dxl/y/control_table_11_protocol_type.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
The communications protocol of the DYNAMIXEL can be set to either "DYNAMIXEL Protocol 2.0" or "Modbus-RTU." The Modbus-RTU will be supported in the future.

| Value | Description |
|:-------:|:------------------------------------------------------------------|
| 2 | [DYNAMIXEL Protocol 2.0] |
| 10(TBD) | [Modbus-RTU, Industrial Standard Protocol] |

[DYNAMIXEL Protocol 2.0]: /docs/en/dxl/protocol2/
[Modbus-RTU, Industrial Standard Protocol]: http://modbus.org/docs/PI_MBUS_300.pdf

**Note** : The Modbus-RTU Protocol will be available for DYNAMIXEL servos in the future.
{: .notice}

11 changes: 11 additions & 0 deletions _includes/en/dxl/y/control_table_126_notch_filter_frequency.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
목표 전류 Value의 Notch Filter의 설정 Value입니다. Notch Filter를 사용하면 특정 주파수의 신호를 제거할 수 있습니다. 시스템 공진 주파수 등 시스템의 제어 성능 하락을 유발하는 주파수를 제거함으로써 제어 성능을 향상시킬 수 있습니다.

| 컨트롤 테이블 item | Unit | Range |
|:----------------------------|:------|:------------------|
| Notch Filter Frequency(126) | [Hz] | 0 ~ 2,147,483,647 |
| Notch Filter Bandwidth(128) | [Hz] | 0 ~ 2,147,483,647 |
| Notch Filter Depth(130) | - | 0 ~ 2,147,483,647 |

![](/assets/images/dxl/y/notch_filter_frequency.PNG)

**Note** : Notch Filter Depth(130) Value이 커질수록 Phase가 급격하게 변하게 되어 시스템의 발산을 유발할 수 있습니다. Notch Filter Depth(130) Value을 조금씩 키우면서 설정하시기 바랍니다.
20 changes: 20 additions & 0 deletions _includes/en/dxl/y/control_table_12_baud_rate.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
The communication speed for communication between the controller and servo over the RS485 serial bus is called the "Baud Rate."

| Value | Baud Rate<br>[bps] | Actual Baud Rate<br>[bps] | Error Rate<br>[%] |
|:---------------:|:---------------------:|:-------------------------:|:------------------:|
| 9 | 10.5M | 10,500,000 | 0.000 |
| 8 | 6M | 6,000,000 | 0.000 |
| 7 | 4.5M | 4,421,053 | -1.176 |
| 6 | 4M | 4,000,000 | 0.000 |
| 5 | 3M | 3,000,000 | 0.000 |
| 4 | 2M | 2,000,000 | 0.000 |
| 3 | 1M | 1,000,000 | 0.000 |
| 2 | 115,200 | 115,226 | 0.023 |
| 1 (Default) | 57,600 | 57,613 | 0.023 |
| 0 | 9,600 | 9,600 | 0.000 |

**Caution** : Communication between the controller and the device requires a Baud rate error margin under 3[%].
{: .notice--warning}

**Note** : When using a U2D2, to ensure stable communication at higher Baud rates, please reduce the [response latency of the USB port](/docs/en/software/dynamixel/dynamixel_wizard2/#graph-optimization)
{: .notice}
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
The frequency of the Low-Pass Filter used for [Present Velocity(548)]. This is the setting value of [Present Velocity Filter] in the block diagram of the Operating Mode(33). Adjusting this value can lead to improved control performance if there is noise in the calculated current velocity value.

| Unit | Range |
|:---------|:-----------|
| 0.1[Hz] | 0 ~ 65,535 |


[Present Velocity Filter]: #operating-mode
Loading

0 comments on commit 4428eb9

Please sign in to comment.