Migrate from Gen3 to Gen4 platforms

Introduction

For customers who have used Gen3 API, migrating to the Gen4 API will require substantial changes in any interfacing software used. Some commands have been changed, and some new commands have been introduced. This quick-start section is intended to help guide users through these changes to ensure a smooth transition.

Identifying a Gen4 platform

Identifying a platform running the Gen4 API can be easily identified via the fwtype parameter of the id command.

In the case of the L3.5 platform (Gen4 API), one would obtain:

>> id fwtype
<< id fwtype=120

Whereas, in the case of the L3 platform (Gen3 API), one would obtain:

>> id fwtype
<< id fwtype = 104

Removed commands

The following commands have been removed:

• bsl: replaced by the instrument flash command

• channels: replaced by the channel command

• confirmation: replaced by the settings command

• ddsampling: replaced by the schedule command

• fetch: replaced by the poll command.
  With L3 platform:

  TEXT

  >> fetch
  << 2023-01-04 11:50:49.000, 12.7052 dbar, 18.1745 C

  With L4 platform:

  TEXT

  >> poll
  << 2024-10-21 11:50:49.000 18.1745130 12.7052970 2.69308210
  ( The exact form of the output will also depend on the settings of the outputformat command. )

• getall: replaced by the instrument dump command

• hwrev: replaced by the pcba command

• info: replaced by the instrument command

• memclear: replaced by the dataset delete command

• memformat: not replaced

• meminfo: replaced by the storage command

• outputformat: replaced by the instrument outputformat command

• pauseresume: not replaced

• permit: not replaced.

• power: replaced by the instrument power command

• powerexternal: replaced by the instrument power external command

• powerinternal: replaced by the instrument power internal command

• prompt: replaced by the settings command

• regimes: replaced by the schedule command

• regime: replaced by the schedule command

• sampling: replaced by the schedule and deployment command

• thresholding: replaced by the deployment gate command

• twisactivation: replaced by the deployment gate command

• readdata: replaced by the download command

• serial: replaced by the link serial command

• streamserial: replaced by the schedule command

• streamusb: replaced by the schedule command

• wifi: not replaced

Improved commands and new parameters

• deployment

• enable

• disable

• verify

• channel

• calibration

• instrument outputformat

• settings

• sensor

New commands

For more information on the function and intention of these new commands see the individual command pages or see General overview:

• config

• dataset

• factory

• group

• instrument

• link

• parameters

• pcba

• poll

• schedule