:SYSTem:BORDer
Command Syntax
:SYSTem:BORDer {BENDian | LENDian}
Query Syntax
:SYSTem:BORDer?
Description
Specifies the byte order (endianness) of binary data that is returned to a controller due to a SCPI query.
A default setup command (:SYSTem:DEFault) does not reset the endianness setting.
A factory default command (:SYSTem:FACTory) does reset the endianness setting.
- BENDian
- Bytes are sent in big-endian order with the most significant byte sent first and the least significant byte sent last.
- LENDian
- Bytes are sent in little-endian order with the least significant byte sent first and the most significant byte sent last. This is the factory default setting.
Because an incorrect endianness setting can be frustrating to troubleshoot, if you share your oscilloscope with other people, it is a good idea to explicitly set the endianness before transferring binary data and to restore Infiniium's endianness setting upon completion of of your program. Use the following sequence of commands:
endian_setting = :SYSTem:BORDer? :SYSTem:BORDer BENDian … … :WAVeform:XYFormat:FLOat:YDATa? … … :SYSTem:BORDer endian_setting
Be aware that VXI plug-and-play drivers can change the endianness setting. As a result always explicitly set the endianness in your program before transferring any binary data.
This setting applies to queries that return data types larger than 8-bit bytes. For example:
- :HISTogram:INTeger:DATA?
- :MHIStogram:INTeger:DATA?
- :FUNCtion:PARameters:FFT:PEAK:DOUBle:FDATa?
- :FUNCtion:PARameters:FFT:PEAK:DOUBle:MDATa?
- :PNOise:DATA:DOUBle:XDATa?
- :PNOise:DATA:DOUBle:YDATa?
- :PNOise:DATA:FLOat:XDATa?
- :PNOise:DATA:FLOat:YDATa?
- :WAVeform:CGRade:INTeger:DATA?
- :WAVeform:XYFormat:DOUBle:YDATa?
- :WAVeform:XYFormat:DOUBle:XDATa?
- :WAVeform:XYFormat:FLOat:YDATa?
- :WAVeform:XYFormat:FLOat:XDATa?
- :WAVeform:XYFormat:IBLock:DOUBle:YDATa?
- :WAVeform:XYFormat:IBLock:DOUBle:XDATa?
- :WAVeform:XYFormat:IBLock:FLOat:YDATa?
- :WAVeform:XYFormat:IBLock:FLOat:XDATa?
- :WAVeform:YFORmat:DOUBle:YDATa?
- :WAVeform:YFORmat:FLOat:YDATa?
- :WAVeform:YFORmat:IBLock:DOUBle:YDATa?
- :WAVeform:YFORmat:IBLock:FLOat:YDATa?
- :WAVeform:YFORmat:WORD:YDATa?
This setting does not affect data returned as bytes. For example: