Device Configuration

Factory Reset

Factory reset can be useful when reusing Pulse Generators across multiple use cases or end users. Alternatively, to maintain custom device settings while clearing the device history, see Clear History under the History section.

FactoryReset

FactoryReset
(
,
)

Factory Reset will reset the Pulse Generator  to the manufacturer's default settings. All custom settings and device history logs will be erased.

Params
required
required
Return Value

Lock Screen

The Pulse Generator screen locks, just like your phone, to prevent accidental button presses and changes to stimulation while wearing the Pulse Generator in an ambulatory setting. By default, the screen will dim after 15 seconds of inactivity and locks after 30 seconds of inactivity. Use the following commands to modify the screen behavior as needed.

SetDimTimeMs

SetDimTimeMs
(
Milliseconds
,
)

Sets the duration of inactivity required before the Pulse Generator screen will dim.

Params
Milliseconds
integer
required

Input a value from 0 – 24 hours in milliseconds.

required
Return Value

SetLockTimeMs

SetLockTimeMs
(
Milliseconds
,
)

Sets the duration of inactivity required before the Pulse Generator screen will lock.

Note, inputting the value of 0 will disable the lock screen but will not disable the screen from dimming.

Params
Milliseconds
integer
required

Input a value from 0 – 24 hours in milliseconds.

required
Return Value

Stimulation

StartStimulation

StartStimulation
(
Channel
,
)

Toggles ON stimulation for the corresponding channel based on the provided Channel input parameter.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

required
Return Value

StopStimulation

StopStimulation
(
Channel
,
)

Toggles OFF stimulation for the corresponding channel based on the provided Channel input parameter.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

required
Return Value

ReadStimulationState

ReadStimulationState
(
Channel
,
)

Returns the current stimulation for the corresponding channel based on the provided Channel input parameter.

Note: Channels can be toggled ON with an amplitude of 0. Use the ReadAmplitude() call to determine the amplitude delivered.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

required
Return Value
State
integer

Returns State value of 0 or 1.
0 = OFF
1 = ON

Amplitude

SetAmplitude

SetAmplitude
(
Channel
,
Amplitude
)

Sets the amplitude for the given channel. An amplitude input of 0 sets the amplitude to 0.0 mA. An amplitude input of 50 sets the amplitude to 5.0 mA.

Note: Changes to the amplitude while stimulation is ON will be instantaneous and will not ramp.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

Amplitude
integer
required

Integer value from 0-50

Return Value

ReadAmplitude

ReadAmplitude
(
Channel
,
)

Gets the amplitude for the specified channel as shown on the Pulse Generator.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

required
Return Value
Amplitude
integer

Integer value from 0-50

Impedance

ReadImpedanceValue

ReadImpedanceValue
(
Channel
,
)

Returns the current impedance for the specified channel in Ohms.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

required
Return Value
Impedance
integer

Example: 10000

Frequency

SetFrequency

SetFrequency
(
Channel
,
Frequency
)

Sets the frequency for the given channel in Hz.

Note: See the Sparrow Link Instructions for Use for documentation on our frequency combinations that are unsupported or output a nominal value +/-15% of the selected frequencies.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

Frequency
integer
required

Accepted integer values: 1, 5, 10, 15, 20, 25, 30, 40, 50, 75, 100, 125, 150

Return Value

ReadFrequency

ReadFrequency
(
Channel
,
)

Returns the current frequency for the specified channel in Hz.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

required
Return Value
Frequency
integer

Example: 15

Pulse Width

SetPulseWidth

SetPulseWidth
(
Channel
,
PulseWidth
)

Sets the pulse width for the given channel in µS.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

PulseWidth
integer
required

Accepted integer values: 50, 100, 150, 250, 350, 500, 750

Return Value

ReadPulseWidth

ReadPulseWidth
(
Channel
,
)

Returns the pulse width for the specified channel in µS.

Params
Channel
integer
required

Channel value of either 0 or 1
0 = Inner channel
1 = Outer channel

required
Return Value
PulseWidth
integer

Example: 250

Duty Cycle

SetCycleState

SetCycleState
(
CycleState
,
)

Enables or disables the duty cycle or session intervals. The duty cycle is enabled by default.

Note: Use this call to disable the duty cycle prior to using the trigger function. If left enabled, the duty cycle will continue while triggering.

Params
CycleState
integer
required

Value of either 0 or 1
0 = Disable duty cycle
1 = Enable duty cycle

required
Return Value

SetSessionIntervalTimeMs

SetSessionIntervalTimeMs
(
Milliseconds
,
)

Set the ON portion of the duty cycle. Enter the number of milliseconds that stimulation shall be ON while in cycling mode.

Params
Milliseconds
integer
required

102 ms - 24 hours

required
Return Value

SetSessionIntervalBreakMs

SetSessionIntervalBreakMs
(
Milliseconds
,
)

Set the OFF portion of the duty cycle. Enter the number of milliseconds that Stimulation shall be off while in cycling mode.

Params
Milliseconds
integer
required

0 ms - 24 hours

required
Return Value

ReadCycleState

ReadCycleState
(
,
)

Use this call to determine if the Duty Cycle state is enabled/disabled.

Params
required
required
Return Value
CycleState
boolean

True = The Cycle state is enabled, and duty cycling will occur as configured.
False = The Cycle state is disabled, and duty cycling will not occur.

ReadSessionIntervalTime

ReadSessionIntervalTime
(
,
)

Gets the ON portion of the duty cycle in milliseconds.

Params
required
required
Return Value
Milliseconds
integer

A value in the range of 100 ms - 24 hours in milliseconds.

Ramping

SetStepType

SetStepType
(
StepType
,
)

Sets the step type to either the default ramping algorithm of 0.1 mA increase per second, or enables the setting of a custom ramp-up time.

Note: You must enable this setting before setting a custom ramp time with the SetFixedTimeMs() call.

Params
StepType
integer
required

Value of either 0 or 1
0 = Use the default ramping algorithm of 0.1 mA increase per second
1 = Enables the setting of a custom ramp-up time.

required
Return Value

SetFixedTimeMs

SetFixedTimeMs
(
Milliseconds
,
)

Sets a custom fixed ramp-up time. When stimulation is toggled ON, stimulation will ramp-up to the target strength in the duration input in milliseconds.

Params
Milliseconds
integer
required

50 mS – 60 seconds

required
Return Value

SetRampDownMs

SetRampDownMs
(
Milliseconds
,
)

Sets a custom fixed ramp-down time. When stimulation is toggled OFF, stimulation will ramp-down to 0 mA in the duration input in milliseconds.

Params
Milliseconds
integer
required

50 mS – 3 seconds

required
Return Value

Sham & Error Notifications

SetSham

SetSham
(
Sham
,
Message
)

Enables or disables the sham state. Shammed stimulation is disabled by default.

Note: Before setting a sham channel state with the SetShameState() call, you must enable this setting.

Params
Sham
integer
required

Value of either 0 or 1
0 = Disable the sham state
1 = Enable the sham state

Message
integer
required

Value of either 0 or 1
0 = Disable error notifications
1 = Enable error notifications

Return Value

SetShamState

SetShamState
(
Value
,
)

Enable or disable sham for specific channels.

Params
Value
integer
required

0 = Disable sham for all channels.
1 = Enable sham for ONLY the Inner channel. The Inner channel will not output stimulation.
2 = Enable sham for ONLY the Outer channel. The Outer channel will not output stimulation.
3 = Enable sham for BOTH the Inner and Outer channels.

required
Return Value

ReadShamMessage

ReadShamMessage
(
,
)

Gets the global Sham state for stimulation and Error Notifications.

Params
required
required
Return Value
ShamState
integer

Integer value of 256, 257, 1 or 0

256 = Sham state is disabled and Error Notifications are ON.
257 = Sham State is Enabled and Error Notifications are ON.
1 = Sham state is Enabled and Error Notifications are OFF.
0 = Sham state is disabled and Error Notifications are OFF.

ReadShamState

ReadShamState
(
,
)

Returns sham state for channels.

Params
required
required
Return Value
Value
integer

0 = Sham is disabled for all channels.
1 = Sham is enabled for ONLY the Inner channel. The Inner channel will not output stimulation.
2 = Sham is enabled for ONLY the Outer channel. The Outer channel will not output stimulation.
3 = Sham is enabled for BOTH the Inner and Outer channels.

Triggering

When the Sparrow Link Pulse Generator is set to Trigger Mode, the screen will lock and read “ Trigger Mode Enabled.” This feature blinds and prevents an end user from viewing or modifying the stimulation.

Always configure the stimulation parameters as desired before entering Trigger Mode. This includes:

  • Cycle times
  • Ramp times
  • Pulse width
  • Frequency
  • Amplitude

Before entering Trigger mode, turn off all stimulation. If the stimulation is ON when entering Trigger mode, it will continue to cycle as set by the cycle ON and OFF times. Changes to stimulation other than Trigger ON and OFF may result in failed commands or dropped connections.

SetTriggerMode

SetTriggerMode
(
Value
,
)

Enable or disable triggering for specific channel(s).

Params
Value
integer
required

0 = Exit the trigger state.
1 = Enable triggering for the Inner channel via Channel A on the Hub.  
2 = Enable triggering for the Outer channel via Channel B on the Hub
3 = Enable triggering for BOTH the Inner and Outer channels via Channel A & B on the Hub.

required
Return Value

SetTrigger

SetTrigger
(
Value
,
)

If you want to run triggering from a console or script, enable trigger mode, then use the SetTrigger() command below to toggle stimulation ON and OFF. You do not need to use the SetTrigger() command when triggering from the BNC connections, channels A or B.

Params
Value
integer
required

0 = Turn the trigger OFF. Stimulation will turn off.
1 = Trigger ON the Inner channel.
2 = Trigger ON the Outer channel.
3 = Trigger ON BOTH the Inner and Outer channels.

required
Return Value

SetTriggerLog

SetTriggerLog
(
Value
,
)

To improve response rates while rapidly triggering, use SetTriggerLog() below to turn OFF the logging of triggering events. By default, logging of trigger events will be ON.

Params
Value
integer
required

0 = Turn OFF the logging of Trigger events.
1 = Turn ON the logging of Trigger events

required
Return Value