1

-------------------------------------------------------------------------------

     2

     3

$Id$

     4

     5

vim: spelllang=en spell tw=78

     6

     7

-------------------------------------------------------------------------------

     8

     9

Changes since 1.5.2:

    10

    11

* Fixed FoE timeout calculation bug.

    12

    13

Changes in 1.5.2:

    14

    15

* API extensions (find the complete description in include/ecrt.h)

    16

    * Added redundancy features; enable using --with-devices.

    17

    * Re-designed and seamlessly integrated RTDM interface.

    18

    * Added ecrt_sdo_request_index() method to change index and subindex.

    19

    * Changed the data types of the shift times in ecrt_slave_config_dc()

    20

      to int32_t to correctly display negative shift times.

    21

    * Added API for querying CoE emergency requests.

    22

    * Added interface to read/write register contents; re-worked register

    23

      requests.

    24

    * Added interface to select the reference clock and to sync to it.

    25

    * Exported ecrt_domain_size() to userspace.

    26

    * Added ecrt_slave_config_reg_so_entry_pos() to register non-unique

    27

      PDO entries.

    28

* Ethernet drivers

    29

    * Added 8139too driver for 3.0, 3.2, 3.4.

    30

    * Added r8169 driver for 2.6.36 (J. Kunz), 3.2 (J. Kunz), 3.4 (F. Pose).

    31

    * Added e1000 driver for 3.0, 3.4.

    32

    * Added e1000e driver for 3.2 (J. Kunz), 3.4 (F. Pose).

    33

    * Added e100 driver for 3.0, 3.4.

    34

    * Fixes regarding 8139too driver for 2.6.36.

    35

    * Some fixes for all e1000 and e1000e drivers.

    36

* General behaviour

    37

    * Avoided semaphore locking from userspace/rtdm library: Implemented

    38

      datagram ring instead of queue.

    39

    * Assign SII to PDI during PREOP transition; Introduced

    40

      --enable-sii-assign to switch this on.

    41

    * Avoided re-allocating memory in userspace library implementations of

    42

      ecrt_sdo_request_state() and in VoE handlers.

    43

    * Send sync datagrams only if reference clock is found.

    44

    * Adjusted some DC clock discipline parameters.

    45

    * Fixed AL status code lookup.

    46

    * Fixed some ioctl() return values and permissions.

    47

    * Fixed FoE data OpCode, thanks to R. Roesch.

    48

    * Fixed and improved cancelling requests when clearing configuration.

    49

    * Using common wait queue for requests.

    50

    * Removed some unnecessary request types.

    51

    * Output slave FSM datagram statistics.

    52

    * Removed some state-dependent datagram skip messages.

    53

    * Immediately restart slave FSM on several failed requests.

    54

    * Reset master state machine when going to orphaned phase.

    55

* Command-line tool:

    56

    * Show complete access flag in config view.

    57

    * Added EtherLab skin for 'ethercat pdos' command.

    58

    * Fixed 'String too large' bug.

    59

* Infrastructure:

    60

    * Added AM_PROG_AR necessary for autoconf 1.12.

    61

    * Avoided use of AM_CFLAGS, which is not used in some situations.

    62

    * Added vmalloc() include fix for ARM architecture, thanks to Andrea

    63

      Scian.

    64

    * Install ethercat service to multi-user target by default.

    65

    * Fixed COPYING.LESSER to be LGPL 2.1 (like in file headers).

    66

    * More detailed output of configure script.

    67

    * Added rtai_rtdm_dc example, thanks to Graeme Foot.

    68

    69

Changes in 1.5.1:

    70

    71

* Fixed reset of allow_scanning flag if ecrt_master_activate() was not called.

    72

* Fixed missing distribution for r8169 for 2.6.32 and e1000 driver for 2.6.31.

    73

* Added e100 for 2.6.35.

    74

* Added r8169 driver for 2.6.35 (F. Pose).

    75

* Added e1000e driver for 2.6.35 (F. Pose).

    76

* Added fix for ESC port order (DC delay calculation).

    77

* Added e1000 driver for 2.6.35.

    78

    79

Changes in 1.5.0:

    80

    81

* Added a userspace library for accessing the application interface. This

    82

  library is licensed under LGPLv2.

    83

* Added distributed clocks support.

    84

* Added watchdog configuration via application interface (thanks to J. Mohre).

    85

* Added VoE mailbox protocol support.

    86

* Added SoE mailbox protocol support.

    87

* Improved the callback mechanism. ecrt_master_callbacks() now takes two

    88

  callback functions for sending and receiving datagrams.

    89

  ecrt_master_send_ext() is used to execute the sending of non-application

    90

  datagrams.

    91

* Separated datagram initialization from filling the payload with zeros.

    92

  Introduced new method ec_datagram_zero() for that.

    93

* Added phy_read and phy_write commands to ethercat tool.

    94

* Added e100 driver for Intel PRO/100 NICs.

    95

    - Added e100 driver for 2.6.27.

    96

    - Added e100 driver for 2.6.28, thanks to Kim. H. Madsen.

    97

    - Added e100 driver for 2.6.29, thanks to Andre Puschmann.

    98

    - Added e100 driver for 2.6.31.

    99

    - Added e100 driver for 2.6.32.

   100

    - Added e100 driver for 2.6.33, thanks to J. Kunz.

   101

    - Added e100 driver for 2.6.37.

   102

* Added 8139too driver for kernels 2.6.25 (F. Pose), 2.6.26 (M. Luescher),

   103

  2.6.27, 2.6.28, 2.6.29 (M. Goetze), 2.6.31 (F. Pose), 2.6.32 (F. Pose),

   104

  2.6.33 (J. Kunz), 2.6.34 (Malcolm Lewis), 2.6.35 (B. Benner),

   105

  2.6.36 (F. Pose) and 2.6.37 (F. Pose).

   106

* Added e1000 driver for 2.6.26 (M. Luescher), 2.6.27, 2.6.28, 2.6.29, 2.6.32,

   107

  2.6.33 (J. Kunz), 2.6.35, 2.6.37.

   108

* Added r8169 driver for 2.6.24, 2.6.27, 2.6.28, 2.6.29, 2.6.31, 2.6.32

   109

  (Robbie K), 2.6.33 (J. Kunz), 2.6.35, 2.6.37.

   110

* Added e1000e driver for 2.6.32, 2.6.33, 2.6.34 (thanks to Siwei Zhuang).

   111

* Debug interfaces are created with the Ethernet addresses of the attached

   112

  physical device.

   113

* Improved error case return codes of many functions.

   114

* Implemented the File Access over EtherCAT (FoE) mailbox protocol, thanks to

   115

  O. Zarges.

   116

* Going to the Bootstrap state is now supported by the state machines and the

   117

  command-line tool.

   118

* Added ecrt_open_master() and ecrt_master_reserve() separation for

   119

  the userspace library (thanks to Martin Troxler).

   120

* Added bus information interface (methods ecrt_master(),

   121

  ecrt_master_get_slave(), ecrt_master_get_sync_manager(),

   122

  ecrt_master_get_pdo() and ecrt_master_get_pdo_entry()) to get information

   123

  about the currently connected slaves and the PDO entries provided (thanks to

   124

  Martin Troxler and Stefan Weiser).

   125

* Added ecrt_master_sdo_download() and ecrt_master_sdo_upload()

   126

  methods to let an application transfer SDOs before activating the master

   127

  (thanks to Stefan Weiser).

   128

* Fixed SDO upload segment response (thanks to Christoph Peter).

   129

* Fixed SDO upload segment response for 10 bytes mailbox length (thanks to

   130

  Joerg Mohre).

   131

* SDO entry access rights are shown in 'ethercat sdos'.

   132

* Added 64-bit data access macros to application header.

   133

* Added debug level for all masters as a module parameter. Thanks to Erwin

   134

  Burgstaller.

   135

* Clear slave list on link down.

   136

* Output device link state in 'ethercat master'.

   137

* Added 'ethercat graph' command which outputs the bus topology in

   138

  DOT language.

   139

* Changed EC_MAX_SII_SIZE to 4096.

   140

* 'ethercat xml' creates valid XML <EtherCATInfoList> for more than one slave

   141

  (thanks to E. Burgstaller).

   142

* Added 'ethercat eoe' command to display Ethernet over EtherCAT statistics.

   143

* Added 'ethercat cstruct' command to output PDO information in C language.

   144

* Significantly improved EoE bandwidth by running EoE processing in a kthread.

   145

* Switched version control from Subversion to Mercurial.

   146

* Implemented CompleteAccess for SDO downloads.

   147

* ethercat tool is now able to handle multiple masters. The --masters option

   148

  supports ranges like '0,3,8-10'.

   149

* A sync manager is always enabled, if it contains registered process data.

   150

* Added a configuration switch --enable-wildcards to use 0xffffffff as a

   151

  wildcard for vendor ID and product code.

   152

* Added support for systemd.

   153

   154

Changes in 1.4.0:

   155

   156

* Fixed race condition in jiffy-based frame timeout calculation.

   157

* Fixed race condition concerning the ec_slave_config_state->operational flag.

   158

* Fixed wrong calculation of the expected working counter if the process data

   159

  of a domain span several datagrams.

   160

* Fixed a kernel oops when a slave configuration is detached while the actual

   161

  configuration is in progress.

   162

* Fixed typo in logging output.

   163

* Removed 'bashisms' from init script ('function' keyword).

   164

* Fixed bug in e1000 drivers. Memory was allocated when sending the first

   165

  frame.

   166

* Modified licence headers to avoid conflicts with the GPL.

   167

* Restricted licence to GPLv2 only.

   168

* Fixed spelling of 'PDO', 'SDO' (all uppercase) and 'xx over EtherCAT'

   169

  (without hyphens).

   170

   171

Changes in 1.4.0-rc3:

   172

   173

* Ported the master thread to the kthread interface.

   174

* Added missing semaphore up() in an ioctl(). In rare cases, the master

   175

  semaphore was not released.

   176

* Minor fix in 'slaves' command that fixed duplicate display of supported

   177

  mailbox protocols.

   178

* The SDO Information Service is only queried, if the slave has the

   179

  corresponding SII bit set.

   180

* Added some missing header files in the command-line-tool code.

   181

* Removed unstable e100, forcedeth, and r8169 drivers.

   182

   183

Changes in version 1.4.0-rc2:

   184

   185

* Fixed a deadlock causing race condition concerning thread signaling when the

   186

  master thread had no opportunity to run, but shall be killed immediately

   187

  after creation.

   188

* Added missing up()s causing a semaphore being not released in some rare

   189

  cases.

   190

* Minor fixes.

   191

* Removed some deprecated files.

   192

   193

Changes in version 1.4.0-rc1:

   194

   195

* Realtime interface changes:

   196

    - Replaced ec_slave_t with ec_slave_config_t, separating the bus

   197

      configuration from the actual slaves. Therefore, renamed

   198

      ecrt_master_get_slave() to ecrt_master_slave_config().

   199

    - Replaced slave address string with alias and position values. See

   200

      ecrt_master_slave_config().

   201

    - Removed ecrt_master_get_slave_by_pos(), because it is no longer

   202

      necessary due to alias/position addressing.

   203

    - Added ec_slave_config_state_t for the new method

   204

      ecrt_slave_config_state().

   205

    - Process data memory for a domain can now be allocated externally. This

   206

      offers the possibility to use a shared-memory region. Therefore,

   207

      added the domain methods ecrt_domain_size() and

   208

      ecrt_domain_external_memory().

   209

    - PDO entry registration functions do not return a process data pointer,

   210

      but an offset in the domain's process data. In addition, an optional bit

   211

      position can be requested. This was necessary for the external domain

   212

      memory. An additional advantage is, that the returned offset is

   213

      immediately valid. If the domain's process data is allocated internally,

   214

      the start address can be retrieved with ecrt_domain_data().

   215

    - Replaced ecrt_slave_pdo_mapping/add/clear() with

   216

      ecrt_slave_config_pdo_assign_add() to add a PDO to a sync manager's PDO

   217

      assignment and ecrt_slave_config_pdo_mapping_add() to add a PDO entry to a

   218

      PDO's mapping. ecrt_slave_config_pdos() is a convenience function

   219

      for both, that uses the new data types ec_pdo_info_t and

   220

      ec_pdo_entry_info_t. PDO entries, that are mapped with these functions

   221

      can now immediately be registered, even if the bus is offline.

   222

    - Renamed ec_bus_status_t, ec_master_status_t to ec_bus_state_t and

   223

      ec_master_state_t, respectively. Renamed ecrt_master_get_status() to

   224

      ecrt_master_state(), for consistency reasons.

   225

    - Added ec_domain_state_t and ec_wc_state_t for a new output parameter

   226

      of ecrt_domain_state(). The domain state object does now contain

   227

      information, if the process data was exchanged completely.

   228

    - Former "PDO registration" meant PDO entry registration in fact, therefore

   229

      renamed ec_pdo_reg_t to ec_pdo_entry_reg_t and ecrt_domain_register_pdo()

   230

      to ecrt_slave_config_reg_pdo_entry().

   231

    - Removed ecrt_domain_register_pdo_range(), because it's functionality can

   232

      be reached by specifying an explicit PDO assignment/mapping and

   233

      registering the mapped PDO entries.

   234

    - Added an SDO access interface, working with SDO requests. These can be

   235

      scheduled for reading and writing during realtime operation.

   236

    - Exported ecrt_slave_config_sdo(), the generic SDO configuration function.

   237

    - Removed the bus_state and bus_tainted flags from ec_master_state_t.

   238

* Device interface changes:

   239

    - Moved device output parameter of ecdev_offer() to return value.

   240

* Replaced the Sysfs interface with a new 'ethercat' command-line tool, that

   241

  communicates with the master via a character device and ioctls. The device

   242

  is created via udev. The tool is able to

   243

    - Write alias addresses.

   244

    - Show the bus configuration.

   245

    - Output binary domain process data.

   246

    - Set the master's debug level.

   247

    - Show domain information.

   248

    - Show master information.

   249

    - List PDO assignment/mapping.

   250

    - Write an SDO entry.

   251

    - List SDO dictionaries.

   252

    - Read an SDO entry.

   253

    - Output a slave's SII contents.

   254

    - Write slave's SII contents.

   255

    - Show slaves.

   256

    - Request slave states.

   257

    - Generate slave information xmls.

   258

* Removed include/ecdb.h.

   259

* Using the timestamp counter is now optional (configure --enable-cycles),

   260

  because it is only available on Intel architectures.

   261

* SDO dictionaries will now also be fetched in operation mode.

   262

* SII write requests will now also be processed in operation mode.

   263

* Mapping of PDO entries is now supported.

   264

* Current PDO assignment/mapping is now read via CoE during bus scan, using

   265

  direct SDO access, independent of the dictionary.

   266

* Network driver news:

   267

    - Added 8139too driver for kernel 2.6.22, thanks to Erwin Burgstaller.

   268

    - Added 8139too driver for kernel 2.6.23, thanks to Richard Hacker.

   269

    - Added 8139too driver for kernel 2.6.24.

   270

    - Added e1000 driver for kernel 2.6.22.

   271

    - Added e1000 driver for kernel 2.6.24, thanks to Matthias Luescher.

   272

    - Added alpha support for the Realtek r8169 chipset, thanks to Scott

   273

      Hassan.

   274

    - Fixed unnecessary watchdog executions in e1000 drivers (thanks to

   275

      Olav Zarges).

   276

    - Fixed missing protection for a spin_lock_irqrestore() call in e1000

   277

      drivers from 2.6.20 to 2.6.24 (thanks to Olav Zarges).

   278

* Removed the "bus validation" routines. Slave scanning is now done any time

   279

  the bus topology changes, even during realtime operation. Because of this,

   280

  the bus_tainted flag was deprecated and removed.

   281

* Slave configuration is not done during ecrt_master_activate() any more, but

   282

  later during realtime operation. The state of the configuration can be

   283

  queried via the ecrt_domain_state() and ecrt_slave_config_state() functions.

   284

* Added support for slaves that do not support the LRW datagram type. Separate

   285

  domains have to be used for inputs and output.

   286

* CoE implementation:

   287

    - Use expedites transfer type for SDOs <= 4 byte (thanks to J. Mohre).

   288

    - Allow gaps in PDO mapping (thanks to R. Roesch).

   289

    - Added some transfer timeouts.

   290

    - Asynchronous handling of Emergency requests.

   291

    - Bug fixes.

   292

* Sync managers are disabled, if the size is zero.

   293

* Renamed ec_master module parameters main and backup to main_devices and

   294

  backup_devices to avoid warnings of some compilers.

   295

* List end evaluate CoE detail flags from general category.

   296

* Added MODPROBE_FLAGS variable in start script and sysconfig file.

   297

* Implemented missing datagram types.

   298

* Changed all occurrences of 'EEPROM' to 'SII'

   299

* Allow multiple sync manager categories in SII.

   300

   301

-------------------------------------------------------------------------------

   302

   303

Changes in version 1.3.2:

   304

   305

* New feature: Read dynamic PDO mapping from SDO dictionary.

   306

* Implemented SII writing workaround for some broken slaves.

   307

* Improved handling for spontaneous AL state changes.

   308

* Master takes mailbox sync manager configurations from EEPROM words

   309

  0x0018-0x001b, if no sync manager configurations are provided.

   310

* Calculate checksum when writing EEPROM or alias address.

   311

* Fixed source MAC address setting bug.

   312

* Removed config.kbuild and replaced Kbuild files by Kbuild.in files.

   313

   314

-------------------------------------------------------------------------------

   315

   316

Changes in version 1.3.1:

   317

   318

* Improved EoE handling: Avoided skipping of datagrams and release lock

   319

  while processing.

   320

* Added some statistics to the datagram structure.

   321

* Master state machine clears all station addresses with a broadcast datagram

   322

  before setting them.

   323

* Added --enable-eoe conditional.

   324

* Minor extensions of the master info file.

   325

* Improved handling of unexpected working counters.

   326

* Create network interfaces for EoE devices with alias as eoeXaY.

   327

* Fixed problems on big-endian systems.

   328

* Added documentation on how to set up an EoE network.

   329

   330

-------------------------------------------------------------------------------

   331

   332

Changes in version 1.3.0:

   333

   334

* Added Intel PRO/1000 Gigabit Ethernet driver (e1000).

   335

* Added testing version of Intel PRO/100 Ethernet driver (e100).

   336

* Added testing version of NVIDIA nForce Ethernet driver (forcedeth).

   337

* Removed "ec_eoeif_count" master module parameter. EoE handlers are created

   338

  dynamically instead.

   339

* Added "main" and "backup" parameters to master module to hand over the

   340

  MAC addresses of the devices to wait for. This made the ec_device_index

   341

  parameter of the Ethernet drivers obsolete. The broadcast MAC address means,

   342

  that the master accepts the first device offered by any Ethernet driver.

   343

* Changed format of sysconfig file and accordingly adjusted functionality

   344

  of the init script to handle the above MAC address lists.

   345

* Realtime interface changes:

   346

  - ecrt_master_run() became obsolete, because the master state machine is now

   347

    run in process context.

   348

  - Parameter changes in PDO registration functions ecrt_domain_register_pdo()

   349

    and ecrt_register_pdo_range(): Replaced slave_address, vendor ID and

   350

    product code arguments with a slave pointer, which has to be obtained with

   351

    a prior call to ecrt_master_get_slave().

   352

  - ecrt_master_get_slave() got additional parameters to check for vendor ID

   353

    and product code.

   354

  - Removed addressing scheme "X:Y" for ecrt_master_get_slave().

   355

  - Added ecrt_master_get_slave_by_pos() to avoid the string handling of

   356

    ecrt_master_get_slave().

   357

  - Added ecrt_master_get_status() to get status information about the bus.

   358

  - Added functions to set up an alternative PDO mapping for a slave, i. e.

   359

    ec_slave_pdo_mapping_clear(), ec_slave_pdo_mapping_add() and

   360

    ec_slave_pdo_mapping().

   361

* Device interface changes:

   362

  - Replaced ecdev_register() and ecdev_unregister() with ecdev_offer() and

   363

    ecdev_withdraw(), respectively. The device modules now offer all their

   364

    devices to the master. The master then decides, which ones to register.

   365

  - Replaced ecdev_link_state() with ecdev_set_link(); added ecdev_get_link().

   366

* All EEPROM write operations from user space are now blocking until

   367

  writing has finished. Appropriate error codes are returned.

   368

* Implemented setting of the "Secondary slave address" (alias) via sysfs.

   369

* Implemented SDO reading in operation mode via sysfs.

   370

* Removed annoying eeprom_write_enable file. EEPROM writing always enabled.

   371

* Slave configuration is now done exclusively from the master thread. Removed

   372

  ec_master_sync_io(). Userspace threads are now waiting for events in the

   373

  state machine.

   374

* Master state machine scheduled with timeout if idle, otherwise is executed

   375

  as fast as possible (with schedule()).

   376

* Added dummy module for simulation purposes.

   377

* Limited infinite EEPROM reading, if 0xffff limiter word is missing.

   378

* Init script works now properly on non-SUSE distros (no rc.status dependency

   379

  any more).

   380

* Removed EtherCAT line comments from 8139too drivers.

   381

   382

-------------------------------------------------------------------------------

   383

   384

Changes in version 1.2.0:

   385

   386

* Several fixes of bugs and stability issues. Master should now run fine

   387

  with kernels 2.6.17 to 2.6.19.

   388

* Realtime interface changes:

   389

  - Re-introduced ecrt_domain_queue() to allow datagram queuing apart

   390

    from datagram processing. The queuing of a domain's datagrams is not

   391

    done in ecrt_domain_process() any more!

   392

  - Removed ecrt_master_deactivate(). Its functionality was moved into

   393

    ecrt_master_release().

   394

  - Removed ecrt_master_prepare(). Its functionality was moved into

   395

    ecrt_master_activate().

   396

  - Renamed ecdev_start() and ecdev_stop() to ecdev_open() and ecdev_close().

   397

    These two functions now take a pointer to ec_device_t as their arguments.

   398

  - The data_ptr parameter of ecrt_domain_register_pdo(),

   399

    ecrt_domain_register_pdo_list() and ecrt_domain_register_pdo_range() may

   400

    not be NULL any more.

   401

  - Removed ecrt_slave_pdo_size(). This function was deprecated long before.

   402

  - Introduced ECRT_VERSION_MAGIC macro and ecrt_version_magic() function.

   403

* Device interface changes:

   404

  - ec_isr_t was replaced by ec_pollfunc_t, the device driver has to supply

   405

    a poll function to call its ISR. This was introduced because some network

   406

    drivers' interrupt functions have different arguments.

   407

* State machines now try to re-send datagrams on datagram timeout.

   408

* New option -c of the lsec script, displays slave current consumptions and

   409

  remaining current.

   410

* Added frame counter in master info file.

   411

   412

-------------------------------------------------------------------------------

   413

   414

Changes in version 1.1.1:

   415

   416

* State change FSM: Clearing of sync managers before PREOP.

   417

* Added modules_install make target.

   418

* Device modules for kernel 2.6.17.

   419

* SDO configurations available in Sysfs.

   420

* FMMU configurations cleared when going to INIT.

   421

* Slave-specific logs only at debug level 1 (for large buses).

   422

* Slave flags (error, online) available in Sysfs.

   423

* Acknowledging of spontaneous state changes in master FSMs.

   424

* ecrt_master_deactivate() deprecated.

   425

* Persistent slave lists. Slave structures are only regenerated on topology

   426

  change in IDLE mode.

   427

* SDO reading via Sysfs.

   428

* Added ecrt_domain_register_pdo_range()

   429

* Fetching of SDO dictionary.

   430

* Better timing behaviour when starting up under high CPU load.

   431

* Applied Autotools.

   432

* Improved output of lsec.

   433

* SDO download state machine.

   434

   435

-------------------------------------------------------------------------------

   436

   437

Changes in version 1.1:

   438

   439

* Improved realtime interface.

   440

   441

-------------------------------------------------------------------------------