include/ecrt.h
changeset 1441 27a8d6f97a95
parent 1438 1d30b96bb04f
child 1448 d7ba0c408a07
--- a/include/ecrt.h	Mon May 04 13:53:41 2009 +0000
+++ b/include/ecrt.h	Tue May 05 08:15:02 2009 +0000
@@ -55,6 +55,8 @@
  * - Renamed ec_sdo_request_state_t to ec_request_state_t, because it is also
  *   used by VoE handlers.
  * - Added ecrt_master_slave() to get information about a certain slave.
+ * - Added ecrt_slave_sdo_upload() and ecrt_slave_sdo_download() methods to
+ *   let an application transfer SDOs before activating the master.
  * - Removed 'const' from argument of ecrt_sdo_request_state(), because the
  *   userspace library has to modify object internals.
  * - Added 64-bit data access macros.
@@ -448,6 +450,8 @@
         uint32_t product_code /**< Expected product code. */
         );
 
+#ifndef __KERNEL__
+
 /** Obtains slave information.
  *
  * Tries to find the slave with the given ring position. The obtained
@@ -465,6 +469,8 @@
                                       information */
         );
 
+#endif /* ifndef __KERNEL__ */
+
 /** Finishes the configuration phase and prepares for cyclic operation.
  *
  * This function tells the master that the configuration phase is finished and
@@ -551,6 +557,50 @@
         ec_master_t *master /**< EtherCAT master. */
         );
 
+#ifndef __KERNEL__
+
+/** Executes an SDO write request to download data.
+ *
+ * This function operates aside of the normal way to request SDOs. Before the
+ * activation of the master, these requests are processed by the master state
+ * machine itself. After activation the user has to ensure cyclic processing.
+ *
+ * \retval  0 Success.
+ * \retval -1 An error occured.
+ */
+int ecrt_slave_sdo_download(
+        ec_master_t* master, /**< EtherCAT master. */
+        uint16_t slave_position, /**< Slave position. */
+        uint16_t index, /**< Index of the SDO. */
+        uint8_t subindex, /**< Subindex of the SDO. */
+        uint8_t *data, /**< Data buffer to download. */
+        size_t data_size, /**< Size of the data buffer. */
+        uint32_t *abort_code /**< Abort code of the SDO download. */
+        );
+
+/** Executes a SDO read request to upload data.
+ *
+ * This function operates aside of the normal way to request SDOs. Before the
+ * activation of the master, these requests are processed by the master state
+ * machine itself. After activation the user have to ensure cyclic
+ * processing.
+ *
+ * \retval  0 Success.
+ * \retval -1 Error occured.
+ */
+int ecrt_slave_sdo_upload(
+        ec_master_t* master, /**< EtherCAT master. */
+        uint16_t slave_position, /**< Slave position. */
+        uint16_t index, /**< Index of the SDO. */
+        uint8_t subindex, /**< Subindex of the SDO. */
+        uint8_t *target, /**< Target buffer for the upload. */
+        size_t target_size, /**< Size of the target buffer. */
+        size_t *result_size, /**< Uploaded data size. */
+        uint32_t *abort_code /**< Abort code of the SDO upload. */
+        );
+
+#endif /* ifndef __KERNEL__ */
+
 /******************************************************************************
  * Slave configuration methods
  *****************************************************************************/