Matlab PacketHandler

• Description

Base functions for packet construction.

• Members

  None

• Methods

• Enumerator

Method References

packetHandler

• Syntax

  void packetHandler()
  

• Parameters

  None

• Detailed Description

  This function initializes the parameters for packet construction. The function resizes packetData struct and initialzes struct members.

printTxRxResult

• Syntax

  void printTxRxResult(int protocol_version, int result)
  

• Parameters

• Detailed Description

  This function calls either printTxRxResult1 or printTxRxResult2 function depending on the protocol_version. The function prints out on the console window what communication result value means.

printRxPacketError

• Syntax

  void printRxPacketError(int protocol_version, int error)
  

• Parameters

• Detailed Description

  This function calls either printRxPacketError1 or printRxPacketError2 function depending on the protocol_version. The function prints out on the console window what hardware error value means.

getLastTxRxResult

• Syntax

  int getLastTxRxResult(int port_num, int protocol_version)
  

• Parameters

• Detailed Description

  This function calls either getLastTxRxResult1 or getLastTxRxResult2 function depending on the protocol_version. The function returns the communication result of #port_num port.

getLastRxPacketError

• Syntax

  byte getLastRxPacketError(int port_num, int protocol_version)
  

• Parameters

• Detailed Description

  This function calls either getLastRxPacketError1 or getLastRxPacketError2 function depending on the protocol_version. The function returns the hardware error of #port_num port.

setDataWrite

• Syntax

  void setDataWrite(int port_num, int protocol_version, int data_length, int data_pos, int data)
  

• Parameters

• Detailed Description

  This function calls either setDataWrite1 or setDataWrite2 function depending on the protocol_version. The function puts Data length bytes of Data into data_pos element of array for writing data at #port_num port tx buffer.

getDataRead

• Syntax

  int getDataRead(int port_num, int protocol_version, int data_length, int data_pos)
  

• Parameters

• Detailed Description

  This function calls either getDataRead1 or getDataRead2 function depending on the protocol_version. The function gets data_length bytes of the data located in data_pos position of read data array that from #port_num port rx buffer.

txPacket

• Syntax

   void txPacket(int port_num, int protocol_version)
  

• Parameters

• Detailed Description

  This function calls either txPacket1 or txPacket2 function depending on the protocol_version. The function transmits the packet. The function clears the port by clearPort function at first, and stores data in the txpacket storage of #port_num port. The communication result and the hardware error are available when the function is terminated.

rxPacket

• Syntax

  void rxPacket(int port_num, int protocol_version)
  

• Parameters

• Detailed Description

  This function calls either rxPacket1 or rxPacket2 function depending on the protocol_version. The function repeatedly tries to receive packets from #port_num port rx buffer until whole packets that it waits to get have arrived, or the packet wait time limit is over, while it filters garbage signals and verify correctness of received signal. The communication result and the hardware error are available when the function is terminated.

txRxPacket

• Syntax ```c void txRxPacket(int port_num, int protocol_version)

- Parameters

| Parameters       | Description      |
|:-----------------|:-----------------|
| port_num         | Port number      |
| protocol_version | Protocol version |

- Detailed Description

   This function calls either `txRxPacket1` or `txRxPacket2` function depending on the `protocol_version`. The function stores data for being written into the array for packet transmission and gets data read from rx buffer of #`port_num` port by `txPacket` and `rxPacket` functions. When `txPacket` function succeeds to communicate, it will continue to `rxPacket` and finishes the process if the packet succeeds to be received. In particular, the group handler functions for write, such as SyncWrite, and BulkWrite, don’t use `rxPacket` so the function finishes its operation immediately after the 'txPacket2'. Before the `rxPacket`, it sets packet timeout if the instruction of received packet is for read. The communication result and the hardware error are available when the function is terminated.


##### ping
- Syntax
```c
void ping (int port_num, int protocol_version, int id)

• Parameters

• Detailed Description

  This function calls either ping1 or ping2 function depending on the protocol_version. The function uses pingGetModelNum without requesting DYNAMIXEL to send its the model number. The communication result and the hardware error are available when the function is terminated.

pingGetModelNum

• Syntax ```c int pingGetModelNum (int port_num, int protocol_version, int id)

- Parameters

| Parameters       | Description      |
|:-----------------|:-----------------|
| port_num         | Port number      |
| protocol_version | Protocol version |
| id               | DYNAMIXEL ID     |

- Detailed Description

   This function calls either `pingGetModelNum1` or `pingGetModelNum2` function depending on the `protocol_version`. The function constructs the transmission packet for ping, and stats `txRxPacket`. Then, the function tries to get the model number of the DYNAMIXEL by `readTxRx` function. When it succeeds to receive the packet, it returns the model number. The communication result and the hardware error are available when the function is terminated.


##### broadcastPing
- Syntax
```c
void broadcastPing(int port_num, int protocol_version)

• Parameters

• Detailed Description

  This function calls either broadcastPing1 or broadcastPing2 function depending on the protocol_version. The function finds all connected dynamixels and store their id in the list. The function is unavailable in protocol 1.0.

getBroadcastPingResult

• Syntax ```c bool getBroadcastPingResult(int port_num, int protocol_version, int id)

- Parameters

| Parameters       | Description      |
|:-----------------|:-----------------|
| port_num         | Port number      |
| protocol_version | Protocol version |
| id               | DYNAMIXEL ID     |

- Detailed Description

   This function calls either `getBroadcastPingResult1` or `getBroadcastPingResult2` function depending on the `protocol_version`. The function returns whether #`id` DYNAMIXEL responded by `broadcastPing` function. The function is unavailable in protocol 1.0.


##### action
- Syntax
```c
void action(int port_num, int protocol_version, int id)

• Parameters

• Detailed Description

  This function calls either action1 or action2 function depending on the protocol_version. The function pulls the trigger of sending txpacket previously set by regWriteTxOnly or regWriteTxRx function, using txRxPacket function. The communication result and the hardware error are available when the function is terminated.

reboot

• Syntax

  void reboot(int port_num, int protocol_version, int id)
  

• Parameters

• Detailed Description

  This function calls either reboot1 or reboot2 function depending on the protocol_version. The function constructs the transmission packet with reboot instruction, and starts txRxPacket. The function may perform its role when the DYNAMIXEL stops working caused by hardware error. The communication result and the hardware error are available when the function is terminated. The function is unavailable in protocol 1.0.

factoryReset

• Syntax ```c void factoryReset(int port_num, int protocol_version, int id, int option)

- Parameters

| Parameters       | Description      |
|:-----------------|:-----------------|
| port_num         | Port number      |
| protocol_version | Protocol version |
| id               | DYNAMIXEL ID     |
| option           | Reset option     |

- Detailed Description

   This function calls either `factoryReset1` or `factoryReset2` function depending on the `protocol_version`. The function constructs the transmission packet for reset DYNAMIXEL, and starts `txRxPacket`. The resets targeted DYNAMIXEL's settings to the factory default settings. The `option` indicates the range of which items on the control table should be reset: `0xFF` for resetting all values, `0x01` for resetting all values except ID, `0x02` for resetting all values except ID and Baudrate. The communication result and the hardware error are available when the function is terminated. In protocol 1.0, `option` is selectable with only full-reset mode `0x00`.

##### readTx
- Syntax
```c
void readTx(int port_num, int protocol_version, int id, int address, int length)

• Parameters

• Detailed Description

  This function calls either readTx1 or readTx2 function depending on the protocol_version. The function constructs the transmission packet with read instruction, and starts txPacket. Then the function calls setPacketTimeout function when packet transmission succeeds. The function can’t control more than one DYNAMIXEL at once. The communication result and the hardware error are available when the function is terminated.

readRx

• Syntax

  void readRx(int port_num, int protocol_version, int length)
  

• Parameters

• Detailed Description

  This function calls either readRx1 or readRx2 function depending on the protocol_version. The function calls rxPacket2 function and gets the packet from read data storage if the communication succeeds. The communication result and the hardware error are available when the function is terminated.

readTxRx

• Syntax

   void readTxRx(int port_num, int protocol_version, int id, int address, int length)
  

• Parameters

• Detailed Description

  This function calls either readTxRx1 or readTxRx2 function depending on the protocol_version. The function calls readTx function and readRx function. readRx function will be called when readTx succeeds. The communication result and the hardware error are available when the function is terminated.

read1ByteTx

• Syntax

  void read1ByteTx(int port_num, int protocol_version, int id, int address)
  

• Parameters

• Detailed Description

  This function calls either read1ByteTx1 or read1ByteTx2 function depending on the protocol_version. The function calls readTx function to send 1 Byte read intended packet transmission. The communication result and the hardware error are available when the function is terminated.

read1ByteRx

• Syntax

  byte read1ByteRx(int port_num, int protocol_version)
  

• Parameters

• Detailed Description

  This function calls either read1ByteRx1 or read1ByteRx2 function depending on the protocol_version. The function calls readRx function to receive response packet of 1 Byte read intended packet transmission. The communication result and the hardware error are available when the function is terminated.

read1ByteTxRx

• Syntax

   byte read1ByteTxRx(int port_num, int protocol_version, int id, int address)
  

• Parameters

• Detailed Description

  This function calls either read1ByteTxRx1 or read1ByteTxRx2 function depending on the protocol_version. The function calls readTxRx function to read 1 Byte data from DYNAMIXEL. The communication result and the hardware error are available when the function is terminated.

read2ByteTx

• Syntax

  void read2ByteTx(int port_num, int protocol_version, int id, int address)
  

• Parameters

• Detailed Description

  This function calls either read2ByteTx1 or read2ByteTx2 function depending on the protocol_version. The function calls readTx function to send 2 Byte read intended packet transmission. The communication result and the hardware error are available when the function is terminated.

read2ByteRx

• Syntax

   int read2ByteRx(int port_num, int protocol_version)
  

• Parameters

• Detailed Description

  This function calls either read2ByteRx1 or read2ByteRx2 function depending on the protocol_version. The function calls readRx function to receive response packet of 2 Byte read intended packet transmission. The communication result and the hardware error are available when the function is terminated.

read2ByteTxRx

• Syntax

   int read2ByteTxRx(int port_num, int protocol_version, int id, int address)
  

• Parameters

• Detailed Description

  This function calls either read2ByteTxRx1 or read2ByteTxRx2 function depending on the protocol_version. The function calls readTxRx function to read 2 Byte data from DYNAMIXEL. The communication result and the hardware error are available when the function is terminated.

read4ByteTx

• Syntax

  void read4ByteTx(int port_num, int protocol_version, int id, int address)
  

• Parameters

• Detailed Description

  This function calls either read4ByteTx1 or read4ByteTx2 function depending on the protocol_version. The function calls readTx function to send 4 Byte read intended packet transmission. The communication result and the hardware error are available when the function is terminated. The function is unavailable in protocol 1.0.

read4ByteRx

• Syntax

  int read4ByteRx(int port_num, int protocol_version)
  

• Parameters

• Detailed Description

  This function calls either read4ByteRx1 or read4ByteRx2 function depending on the protocol_version. The function calls readRx function to receive response packet of 4 Byte read intended packet transmission. The communication result and the hardware error are available when the function is terminated. The function is unavailable in protocol 1.0.

read4ByteTxRx

• Syntax

  int read4ByteTxRx(int port_num, int protocol_version, UIN8_T id, int address)
  

• Parameters

• Detailed Description

  This function calls either read4ByteTxRx1 or read4ByteTxRx2 function depending on the protocol_version. The function calls readTxRx function to read 4 Byte data from DYNAMIXEL. The communication result and the hardware error are available when the function is terminated. The function is unavailable in protocol 1.0.

writeTxOnly

• Syntax

  void writeTxOnly(int port_num, int protocol_version, int id, int address, int length)
  

• Parameters

• Detailed Description

  This function calls either writeTxOnly1 or writeTxOnly2 function depending on the protocol_version. The function constructs the transmission packet with write instruction, and starts txPacket. The communication result and the hardware error are available when the function is terminated.

writeTxRx

• Syntax

  void writeTxRx(int port_num, int protocol_version, int id, int address, int length)
  

• Parameters

• Detailed Description

  This function calls either writeTxRx1 or writeTxRx2 function depending on the protocol_version. The function constructs the transmission packet with write instruction, and starts txRxPacket. The communication result and the hardware error are available when the function is terminated.

write1ByteTxOnly

• Syntax

  void write1ByteTxOnly(int port_num, int protocol_version, int id, int address, int data)
  

• Parameters

• Detailed Description

  This function calls either write1ByteTxOnly1 or write1ByteTxOnly2 function depending on the protocol_version. The function calls writeTxOnly function to send 1 Byte write intended packet transmission. The communication result and the hardware error are available when the function is terminated.

write1ByteTxRx

• Syntax

  void write1ByteTxRx(int port_num, int protocol_version, int id, int address, int data)
  

• Parameters

• Detailed Description

  This function calls either write1ByteTxRx1 or write1ByteTxRx2 function depending on the protocol_version. The function calls writeTxRx function to send 1 Byte write intended packet transmission (and reception). The communication result and the hardware error are available when the function is terminated.

write2ByteTxOnly

• Syntax

  void write2ByteTxOnly(int port_num, int protocol_version, int id, int address, int data)
  

• Parameters

• Detailed Description

  This function calls either write2ByteTxOnly1 or write2ByteTxOnly2 function depending on the protocol_version. The function calls writeTxOnly function to send 2 Byte write intended packet transmission. The communication result and the hardware error are available when the function is terminated.

write2ByteTxRx

• Syntax

   void write2ByteTxRx(int port_num, int protocol_version, int id, int address, int data)
  

• Parameters

• Detailed Description

  This function calls either write2ByteTxRx1 or write2ByteTxRx2 function depending on the protocol_version. The function calls writeTxRx function to send 2 Byte write intended packet transmission (and reception). The communication result and the hardware error are available when the function is terminated.

write4ByteTxOnly

• Syntax

  void write4ByteTxOnly(int port_num, int protocol_version, int id, int address, int data)
  

• Parameters

• Detailed Description

  This function calls either write4ByteTxOnly1 or write4ByteTxOnly2 function depending on the protocol_version. The function calls writeTxOnly function to send 4 Byte write intended packet transmission. The communication result and the hardware error are available when the function is terminated. The function is unavailable in protocol 1.0.

write4ByteTxRx

• Syntax

  void write4ByteTxRx(int port_num, int protocol_version, int id, int address)
  

• Parameters

• Detailed Description

  This function calls either write4ByteTxRx1 or write4ByteTxRx2 function depending on the protocol_version. The function calls writeTxRx function to send 4 Byte write intended packet transmission (and reception). The communication result and the hardware error are available when the function is terminated. The function is unavailable in protocol 1.0.

regWriteTxOnly

• Syntax

   void regWriteTxOnly(int port_num, int protocol_version, int id, int address, int length)
  

• Parameters

• Detailed Description

  This function calls either RegWriteTxOnly1 or RegWriteTxOnly2 function depending on the protocol_version. The function intends simultaneous control of more than one DYNAMIXEL. The function writes the data without requesting an action of DYNAMIXEL. The DYNAMIXEL works when the trigger action function is executed. The function needs previous setting of the data to write on the DYNAMIXEL. The communication result and the hardware error are available when the function is terminated.

regWriteTxRx

• Syntax

   void regWriteTxRx(int port_num, int protocol_version, int id, int address, int length)
  

• Parameters

• Detailed Description

  This function calls either regWriteTxRx1 or regWriteTxRx2 function depending on the protocol_version. The function intends simultaneous multiple DYNAMIXEL’s control. The function writes the data without requesting an action of DYNAMIXEL. The DYNAMIXEL works when the trigger action function is executed. The function needs previous setting of the data to write on the DYNAMIXEL. The communication result and the hardware error are available when the function is terminated.

syncReadTx

• Syntax

  void syndReadTx(int port_num, int protocol_version, int address, int data_length, int param_length)
  

• Parameters

• Detailed Description

  This function calls either syncReadTx1 or syncReadTx2 function depending on the protocol_version. The function intends simultanoues multiple DYNAMIXEL’s control by reading same length of data from the same address on the DYNAMIXEL control table. The function constructs the transmission packet with sync read instruction, and starts ‘txPacket2’. Then the function calls setPacketTimeout function when txPacket succeeds. The communication result and the hardware error are available when the function is terminated. The function is unavailable in protocol 1.0.

syncWriteTxOnly

• Syntax

   void syncWriteTxOnly(int port_num, int protocol_version, int start_address, int data_length, int param_length)
  

• Parameters

• Detailed Description

  This function calls either syncWriteTxOnly1 or syncWriteTxOnly2 function depending on the protocol_version. The function intends simultaneous multiple DYNAMIXEL’s control by writing same length of data to the same address on the DYNAMIXEL control table. The function constructs the transmission packet with sync write instruction, and starts txRxPacket. The communication result and the hardware error are available when the function is terminated.

bulkReadTx

• Syntax

   void bulkReadTx(int port_num, int protocol_version, int param_length)
  

• Parameters

• Detailed Description

  This function calls either bulkReadTx1 or bulkReadTx2 function depending on the protocol_version. The function intends simultaneous multiple DYNAMIXEL’s control by writing different length of data to the different address on the DYNAMIXEL control table. The function constructs the transmission packet with bulk read instruction, and starts txPacket. Then the function calls setPacketTimeout function when txPacket succeeds. The communication result and the hardware error are available when the function is terminated.

bulkWriteTxOnly

• Syntax

   void bulkWriteTxOnly(int port_num, int protocol_version, int param_length)
  

• Parameters

• Detailed Description

  This function calls either bulkWriteTxOnly1 or bulkWriteTxOnly2 function depending on the protocol_version. The function intends simultaneous multiple DYNAMIXEL’s control by writing different length of data from the different address on the DYNAMIXEL control table. The function constructs the transmission packet with bulk write instruction, and starts TxRxPacket. The communication result and the hardware error are available when the function is terminated. The function is unavailable in protocol 1.0.