This guide explains how to change the PULSE imuShort output message period. The imuShort message is used to output PULSE gyroscopes, accelerometers, temperature and status data.

Before we start

The PULSE implements the sbgInsRestApi protocol over a serial interface. All available configurations and commands are detailed in the Digital interfaces page. All the examples use the sbgEComApi command line tool.

In this guide, we consider a PULSE connected to a Windows computer on the serial COM12 and using the default 921600 bps baud rate.

Read imuShort output period

You can query the imuShort output message configuration on the only available comA interface by using the following command:

sbgEComApi.exe -s COM12 -r 921600 /api/v1/settings/output/comA/messages/imuShort -g

The device should answer the default configuration ie 200Hz:

"5ms"

You can also query the whole device configuration using the path /api/v1/settings

Changing imuShort output period

You can change the PULSE output date rate by selecting the output period on the imuShort message. The following settings are available:

FrequencyPeriod Option
2 Khz500us
1 kHz1 ms
500 Hz2 ms
250 Hz4 ms
200 Hz5 ms
100 Hz10 ms
50 Hz20 ms
20 Hz50 ms
10 Hz100 ms

The command below changes the output period for the imuShort message to 1khz on the serial interface comA:

sbgEComApi.exe -s COM12 -r 921600 /api/v1/settings/output/comA/messages/imuShort -p -b \"1ms\"

The device should return the following answer:

{"title":"request successful","needReboot":false}

You don't have to reboot the device for the new output period to be effective.

Tx Saturation

It is user's responsibility to check the coherence between the baud rate and the data output frequency to avoid serial interface saturation.

Save New Settings

Don't forget to save your new settings if you would like to keep them for the next power cycle. Simply send the command below:

sbgEComApi.exe -s COM12 -r 921600 /api/v1/settings/save -p

The device answer should be:

{"title":"request successful","needReboot":false}