Raspberry

Raspberry

Provides support for using an ADC device with the GPIO pins on the Raspberry Pi.Splashkit allows you to read and write to the GPIO pins on the Raspberry Pi.

Functions

Adc Device Named

Retrieve an ADC device that has been loaded.

Parameters:

Name	Type	Description
name	String	The name of the ADC device.

Return Type: Adc Device

Returns: The adc_device pointer if found; otherwise, nullptr.

Signatures:

C++

adc_device adc_device_named(const string &name)

C#

public static AdcDevice SplashKit.AdcDeviceNamed(string name);

Python

def adc_device_named(name):

Pascal

function AdcDeviceNamed(const name: String): AdcDevice

---

Close Adc

Note

This function is overloaded. The following versions exist:

• Close Adc (adc: adc_device)
• Close Adc (name: string)

Close Adc

Closes an ADC device given its pointer.

Parameters:

Name	Type	Description
adc	Adc Device	The ADC device to close.

Signatures:

C++

void close_adc(adc_device adc)

C#

public void AdcDevice.Close();
public static void SplashKit.CloseAdc(AdcDevice adc);

Python

def close_adc(adc):

Pascal

procedure CloseAdc(adc: AdcDevice)

---

Close Adc

Closes an ADC device given its name.

Parameters:

Name	Type	Description
name	String	The name of the ADC device to close.

Signatures:

C++

void close_adc(const string &name)

C#

public static void SplashKit.CloseAdc(string name);

Python

def close_adc_named(name):

Pascal

procedure CloseAdc(const name: String)

---

Close All Adc

Closes all ADC devices that have been opened.

Signatures:

C++

void close_all_adc()

C#

public static void SplashKit.CloseAllAdc();

Python

def close_all_adc():

Pascal

procedure CloseAllAdc()

---

Has Adc Device

Checks if an ADC device with the given name has been loaded.

Parameters:

Name	Type	Description
name	String	The name used to identify the ADC device.

Return Type: Boolean

Returns: true if an ADC device with the supplied name exists.

Signatures:

C++

bool has_adc_device(const string &name)

C#

public static bool SplashKit.HasAdcDevice(string name);

Python

def has_adc_device(name):

Pascal

function HasAdcDevice(const name: String): Boolean

---

Open Adc

Note

This function is overloaded. The following versions exist:

• Open Adc (name: string, type: adc_type)
• Open Adc (name: string, bus: int, address: int, type: adc_type)

Open Adc

Opens an ADC device with the specified name and type. Defaults to bus 1 and address 0x48.

Parameters:

Name	Type	Description
name	String	The name of the ADC device to open.
type	Adc Type	The type of ADC device (e.g., ADS7830, PCF8591).

Return Type: Adc Device

Returns: A valid adc_device on success, or nullptr on failure.

Signatures:

C++

adc_device open_adc(const string &name, adc_type type)

C#

public static AdcDevice SplashKit.OpenAdc(string name, AdcType type);
public AdcDevice(string name, AdcType type);

Python

def open_adc(name, type):

Pascal

function OpenAdc(const name: String; type: AdcType): AdcDevice

---

Open Adc

Loads an ADC device on the specified I2C bus at a given address.

Parameters:

Name	Type	Description
name	String	The name to assign this ADC device.
bus	Integer	The I2C bus number.
address	Integer	The I2C address of the ADC device.
type	Adc Type	The type of ADC device (e.g., ADS7830, PCF8591).

Return Type: Adc Device

Returns: A valid adc_device on success, or nullptr on failure.

Signatures:

C++

adc_device open_adc(const string &name, int bus, int address, adc_type type)

C#

public static AdcDevice SplashKit.OpenAdc(string name, int bus, int address, AdcType type);
public AdcDevice(string name, int bus, int address, AdcType type);

Python

def open_adc_with_bus(name, bus, address, type):

Pascal

function OpenAdc(const name: String; bus: Integer; address: Integer; type: AdcType): AdcDevice

---

Read Adc

Note

This function is overloaded. The following versions exist:

• Read Adc (adc: adc_device, channel: adc_pin)
• Read Adc (name: string, channel: adc_pin)

Read Adc

Reads an 8-bit value from the specified ADC channel on the device.

Parameters:

Name	Type	Description
adc	Adc Device	The ADC device to read from.
channel	Adc Pin	The channel number to read (range depends on ADC type).

Return Type: Integer

Returns: The ADC conversion value (0–255), or -1 on error.

Signatures:

C++

int read_adc(adc_device adc, adc_pin channel)

C#

public int AdcDevice.Read(AdcPin channel);
public static int SplashKit.ReadAdc(AdcDevice adc, AdcPin channel);

Python

def read_adc(adc, channel):

Pascal

function ReadAdc(adc: AdcDevice; channel: AdcPin): Integer

---

Read Adc

Reads an 8-bit value from the specified ADC channel on the device using its name.

Parameters:

Name	Type	Description
name	String	The ADC name string to close.
channel	Adc Pin	The channel number to read (range depends on ADC type).

Return Type: Integer

Returns: The ADC conversion value (0–255), or -1 on error.

Signatures:

C++

int read_adc(const string &name, adc_pin channel)

C#

public static int SplashKit.ReadAdc(string name, AdcPin channel);

Python

def read_adc_named(name, channel):

Pascal

function ReadAdc(const name: String; channel: AdcPin): Integer

---

Has Gpio

Checks if the system has GPIO capabilities.

Return Type: Boolean

Returns: true if the system has GPIO capabilities, false otherwise.

Signatures:

C++

bool has_gpio()

C#

public static bool SplashKit.HasGpio();

Python

def has_gpio():

Pascal

function HasGpio(): Boolean

---

Raspi Cleanup  {</>}

This function should be called when you are finished using the GPIO library. It sets all pin modes to INPUT and values to LOW.

Signatures:

C++

void raspi_cleanup()

C#

public static void SplashKit.RaspiCleanup();

Python

def raspi_cleanup():

Pascal

procedure RaspiCleanup()

Usage:  {</>}

See Implementations in Guides

• Get Started with SplashKit GPIO
• Reading Button Presses
• Using PWM to control LED brightness
• Modify PWM through button presses

---

Raspi Get Mode

This function retrieves the mode of the specified pin.

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to get the mode for.

Return Type: Gpio Pin Mode

Returns: The mode of the pin.

Signatures:

C++

gpio_pin_mode raspi_get_mode(gpio_pin pin)

C#

public static GpioPinMode SplashKit.RaspiGetMode(GpioPin pin);

Python

def raspi_get_mode(pin):

Pascal

function RaspiGetMode(pin: GpioPin): GpioPinMode

---

Raspi Get Servo Pulsewidth

This function retrieves the pulse width for the specified pin.

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to get the pulse width for.

Return Type: Integer

Returns: The pulse width of the pin.

Signatures:

C++

int raspi_get_servo_pulsewidth(gpio_pin pin)

C#

public static int SplashKit.RaspiGetServoPulsewidth(GpioPin pin);

Python

def raspi_get_servo_pulsewidth(pin):

Pascal

function RaspiGetServoPulsewidth(pin: GpioPin): Integer

---

Raspi Init  {</>}

This function initializes the GPIO library for use. It should be called before any other GPIO functions.

Signatures:

C++

void raspi_init()

C#

public static void SplashKit.RaspiInit();

Python

def raspi_init():

Pascal

procedure RaspiInit()

Usage:  {</>}

See Implementations in Guides

• Get Started with SplashKit GPIO
• Reading Button Presses
• Using PWM to control LED brightness
• Modify PWM through button presses

---

Raspi Read  {</>}

This function reads the value from the specified pin.

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to read the value from.

Return Type: Gpio Pin Value

Returns: The value read from the pin.

Signatures:

C++

gpio_pin_value raspi_read(gpio_pin pin)

C#

public static GpioPinValue SplashKit.RaspiRead(GpioPin pin);

Python

def raspi_read(pin):

Pascal

function RaspiRead(pin: GpioPin): GpioPinValue

Usage:  {</>}

See Implementations in Guides

• Reading Button Presses
• Modify PWM through button presses

---

Raspi Set Mode  {</>}

This function sets the mode of the specified pin to the specified mode.

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to set the mode for.
mode	Gpio Pin Mode	The mode to set for the pin.

Signatures:

C++

void raspi_set_mode(gpio_pin pin, gpio_pin_mode mode)

C#

public static void SplashKit.RaspiSetMode(GpioPin pin, GpioPinMode mode);

Python

def raspi_set_mode(pin, mode):

Pascal

procedure RaspiSetMode(pin: GpioPin; mode: GpioPinMode)

Usage:  {</>}

See Implementations in Guides

• Get Started with SplashKit GPIO
• Reading Button Presses
• Using PWM to control LED brightness
• Modify PWM through button presses

---

Raspi Set Pull Up Down  {</>}

This function sets the pull-up/down mode for the specified pin.

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to set the pull up/down mode for.
pud	Pull Up Down	The pull up/down mode to set for the pin.

Signatures:

C++

void raspi_set_pull_up_down(gpio_pin pin, pull_up_down pud)

C#

public static void SplashKit.RaspiSetPullUpDown(GpioPin pin, PullUpDown pud);

Python

def raspi_set_pull_up_down(pin, pud):

Pascal

procedure RaspiSetPullUpDown(pin: GpioPin; pud: PullUpDown)

Usage:  {</>}

See Implementations in Guides

• Reading Button Presses
• Modify PWM through button presses

---

Raspi Set Pwm Dutycycle  {</>}

This function sets the PWM duty cycle for the specified pin.

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to set the PWM duty cycle for.
dutycycle	Integer	The PWM duty cycle to set for the pin.

Signatures:

C++

void raspi_set_pwm_dutycycle(gpio_pin pin, int dutycycle)

C#

public static void SplashKit.RaspiSetPwmDutycycle(GpioPin pin, int dutycycle);

Python

def raspi_set_pwm_dutycycle(pin, dutycycle):

Pascal

procedure RaspiSetPwmDutycycle(pin: GpioPin; dutycycle: Integer)

Usage:  {</>}

See Implementations in Guides

• Using PWM to control LED brightness
• Modify PWM through button presses

---

Raspi Set Pwm Frequency  {</>}

This function sets the PWM frequency for the specified pin.

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to set the PWM frequency for.
frequency	Integer	The PWM frequency to set for the pin.

Signatures:

C++

void raspi_set_pwm_frequency(gpio_pin pin, int frequency)

C#

public static void SplashKit.RaspiSetPwmFrequency(GpioPin pin, int frequency);

Python

def raspi_set_pwm_frequency(pin, frequency):

Pascal

procedure RaspiSetPwmFrequency(pin: GpioPin; frequency: Integer)

Usage:  {</>}

See Implementations in Guides

• Using PWM to control LED brightness
• Modify PWM through button presses

---

Raspi Set Pwm Range  {</>}

This function sets the PWM range for the specified pin. Valid values for the range are 25 - 40000

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to set the PWM range for.
range	Integer	The PWM range to set for the pin.

Signatures:

C++

void raspi_set_pwm_range(gpio_pin pin, int range)

C#

public static void SplashKit.RaspiSetPwmRange(GpioPin pin, int range);

Python

def raspi_set_pwm_range(pin, range):

Pascal

procedure RaspiSetPwmRange(pin: GpioPin; range: Integer)

Usage:  {</>}

See Implementations in Guides

• Using PWM to control LED brightness

---

Raspi Set Servo Pulsewidth

This function sets the pulse width for the specified pin.

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to set the pulse width for.
pulsewidth	Integer	The pulse width to set for the pin.

Signatures:

C++

void raspi_set_servo_pulsewidth(gpio_pin pin, int pulsewidth)

C#

public static void SplashKit.RaspiSetServoPulsewidth(GpioPin pin, int pulsewidth);

Python

def raspi_set_servo_pulsewidth(pin, pulsewidth):

Pascal

procedure RaspiSetServoPulsewidth(pin: GpioPin; pulsewidth: Integer)

---

Raspi Spi Close

This function closes SPI communication on a particular channel.

Parameters:

Name	Type	Description
handle	Integer	A reference to the specific SPI connection to close.

Return Type: Integer

Returns: A value indicating success or failure.

Signatures:

C++

int raspi_spi_close(int handle)

C#

public static int SplashKit.RaspiSpiClose(int handle);

Python

def raspi_spi_close(handle):

Pascal

function RaspiSpiClose(handle: Integer): Integer

---

Raspi Spi Open

This function opens SPI communication on a particular channel. It will return -1 if not using Raspberry Pi.

Parameters:

Name	Type	Description
channel	Integer	The SPI channel to use.
speed	Integer	The speed of data transfer (in baud).
spi_flags	Integer	Optional flags for the SPI modes and settings.

Return Type: Integer

Returns: The handle referencing this particular connection.

Signatures:

C++

int raspi_spi_open(int channel, int speed, int spi_flags)

C#

public static int SplashKit.RaspiSpiOpen(int channel, int speed, int spiFlags);

Python

def raspi_spi_open(channel, speed, spi_flags):

Pascal

function RaspiSpiOpen(channel: Integer; speed: Integer; spiFlags: Integer): Integer

---

Raspi Spi Transfer

This function transfers data through SPI, it sends data from sendBuf and receives it into recvBuf.

Parameters:

Name	Type	Description
handle	Integer	The reference for a specific SPI connection.
send	String	The data to send.
count	Integer	The number of bytes to be transferred.
bytes_transfered	Integer	The number of bytes transferred (output)

Return Type: String

Returns: The data returned from the spi transfer

Signatures:

C++

string raspi_spi_transfer(int handle, const string &send, int count, int &bytes_transfered)

C#

public static string SplashKit.RaspiSpiTransfer(int handle, string send, int count, ref int bytesTransfered);

Python

def raspi_spi_transfer(handle, send, count, bytes_transfered):

Pascal

function RaspiSpiTransfer(handle: Integer; const send: String; count: Integer; var bytesTransfered: Integer): String

---

Raspi Write  {</>}

This function writes the specified value to the specified pin.

Parameters:

Name	Type	Description
pin	Gpio Pin	The pin to write the value to.
value	Gpio Pin Value	The value to write to the pin.

Signatures:

C++

void raspi_write(gpio_pin pin, gpio_pin_value value)

C#

public static void SplashKit.RaspiWrite(GpioPin pin, GpioPinValue value);

Python

def raspi_write(pin, value):

Pascal

procedure RaspiWrite(pin: GpioPin; value: GpioPinValue)

Usage:  {</>}

See Implementations in Guides

• Get Started with SplashKit GPIO
• Reading Button Presses

---

Remote Raspi Cleanup

This function closes the connection to the remote Raspberry Pi and releases any resources associated with it.

Parameters:

Name	Type	Description
pi	Connection	The connection object to the remote Raspberry Pi.

Return Type: Boolean

Returns: true if the cleanup was successful, false otherwise.

Signatures:

C++

bool remote_raspi_cleanup(connection pi)

C#

public static bool SplashKit.RemoteRaspiCleanup(Connection pi);

Python

def remote_raspi_cleanup(pi):

Pascal

function RemoteRaspiCleanup(pi: Connection): Boolean

---

Remote Raspi Get Mode

This function retrieves the mode of a specific pin on a remote Raspberry Pi.

Parameters:

Name	Type	Description
pi	Connection	The connection object to the remote Raspberry Pi.
pin	Gpio Pin	The pin to get the mode for.

Return Type: Gpio Pin Mode

Returns: The mode of the pin.

Signatures:

C++

gpio_pin_mode remote_raspi_get_mode(connection pi, gpio_pin pin)

C#

public static GpioPinMode SplashKit.RemoteRaspiGetMode(Connection pi, GpioPin pin);

Python

def remote_raspi_get_mode(pi, pin):

Pascal

function RemoteRaspiGetMode(pi: Connection; pin: GpioPin): GpioPinMode

---

Remote Raspi Init

This function initialises a connection to a remote Raspberry Pi using the specified name, host, and port.

Parameters:

Name	Type	Description
name	String	The name of the connection.
host	String	The host address of the Raspberry Pi.
port	unsigned short	The port to use for the connection.

Return Type: Connection

Returns: The connection object used to communicate with the remote Raspberry Pi.

Signatures:

C++

connection remote_raspi_init(const string &name, const string &host, unsigned short port)

C#

public static Connection SplashKit.RemoteRaspiInit(string name, string host, ushort port);

Python

def remote_raspi_init(name, host, port):

Pascal

function RemoteRaspiInit(const name: String; const host: String; port: Word): Connection

---

Remote Raspi Read

This function reads the value from a specific pin on a remote Raspberry Pi.

Parameters:

Name	Type	Description
pi	Connection	The connection object to the remote Raspberry Pi.
pin	Gpio Pin	The pin to read the value from.

Return Type: Gpio Pin Value

Returns: The value read from the pin.

Signatures:

C++

gpio_pin_value remote_raspi_read(connection pi, gpio_pin pin)

C#

public static GpioPinValue SplashKit.RemoteRaspiRead(Connection pi, GpioPin pin);

Python

def remote_raspi_read(pi, pin):

Pascal

function RemoteRaspiRead(pi: Connection; pin: GpioPin): GpioPinValue

---

Remote Raspi Set Mode

This function sets the mode of a specific pin on a remote Raspberry Pi.

Parameters:

Name	Type	Description
pi	Connection	The connection object to the remote Raspberry Pi.
pin	Gpio Pin	The pin to set the mode for.
mode	Gpio Pin Mode	The mode to set for the pin.

Signatures:

C++

void remote_raspi_set_mode(connection pi, gpio_pin pin, gpio_pin_mode mode)

C#

public static void SplashKit.RemoteRaspiSetMode(Connection pi, GpioPin pin, GpioPinMode mode);

Python

def remote_raspi_set_mode(pi, pin, mode):

Pascal

procedure RemoteRaspiSetMode(pi: Connection; pin: GpioPin; mode: GpioPinMode)

---

Remote Raspi Set Pull Up Down

This function sets the pull-up/down mode of a specific pin on a remote Raspberry Pi.

Parameters:

Name	Type	Description
pi	Connection	The connection object to the remote Raspberry Pi.
pin	Gpio Pin	The pin to set the pull up/down mode for.
pud	Pull Up Down	The pull up/down mode to set for the pin.

Signatures:

C++

void remote_raspi_set_pull_up_down(connection pi, gpio_pin pin, pull_up_down pud)

C#

public static void SplashKit.RemoteRaspiSetPullUpDown(Connection pi, GpioPin pin, PullUpDown pud);

Python

def remote_raspi_set_pull_up_down(pi, pin, pud):

Pascal

procedure RemoteRaspiSetPullUpDown(pi: Connection; pin: GpioPin; pud: PullUpDown)

---

Remote Raspi Set Pwm Dutycycle

This function sets the PWM duty cycle for a specific pin on a remote Raspberry Pi.

Parameters:

Name	Type	Description
pi	Connection	The connection object to the remote Raspberry Pi.
pin	Gpio Pin	The pin to set the PWM duty cycle for.
dutycycle	Integer	The PWM duty cycle to set for the pin.

Signatures:

C++

void remote_raspi_set_pwm_dutycycle(connection pi, gpio_pin pin, int dutycycle)

C#

public static void SplashKit.RemoteRaspiSetPwmDutycycle(Connection pi, GpioPin pin, int dutycycle);

Python

def remote_raspi_set_pwm_dutycycle(pi, pin, dutycycle):

Pascal

procedure RemoteRaspiSetPwmDutycycle(pi: Connection; pin: GpioPin; dutycycle: Integer)

---

Remote Raspi Set Pwm Frequency

This function sets the PWM frequency for a specific pin on a remote Raspberry Pi.

Parameters:

Name	Type	Description
pi	Connection	The connection object to the remote Raspberry Pi.
pin	Gpio Pin	The pin to set the PWM frequency for.
frequency	Integer	The PWM frequency to set for the pin.

Signatures:

C++

void remote_raspi_set_pwm_frequency(connection pi, gpio_pin pin, int frequency)

C#

public static void SplashKit.RemoteRaspiSetPwmFrequency(Connection pi, GpioPin pin, int frequency);

Python

def remote_raspi_set_pwm_frequency(pi, pin, frequency):

Pascal

procedure RemoteRaspiSetPwmFrequency(pi: Connection; pin: GpioPin; frequency: Integer)

---

Remote Raspi Set Pwm Range

This function sets the PWM range for a specific pin on a remote Raspberry Pi. Valid values for the range are 25 - 40000

Parameters:

Name	Type	Description
pi	Connection	The connection object to the remote Raspberry Pi.
pin	Gpio Pin	The pin to set the PWM range for.
range	Integer	The PWM range to set for the pin.

Signatures:

C++

void remote_raspi_set_pwm_range(connection pi, gpio_pin pin, int range)

C#

public static void SplashKit.RemoteRaspiSetPwmRange(Connection pi, GpioPin pin, int range);

Python

def remote_raspi_set_pwm_range(pi, pin, range):

Pascal

procedure RemoteRaspiSetPwmRange(pi: Connection; pin: GpioPin; range: Integer)

---

Remote Raspi Write

This function writes a specified value to a specific pin on a remote Raspberry Pi.

Parameters:

Name	Type	Description
pi	Connection	The connection object to the remote Raspberry Pi.
pin	Gpio Pin	The pin to write the value to.
value	Gpio Pin Value	The value to write to the pin.

Signatures:

C++

void remote_raspi_write(connection pi, gpio_pin pin, gpio_pin_value value)

C#

public static void SplashKit.RemoteRaspiWrite(Connection pi, GpioPin pin, GpioPinValue value);

Python

def remote_raspi_write(pi, pin, value):

Pascal

procedure RemoteRaspiWrite(pi: Connection; pin: GpioPin; value: GpioPinValue)

---

To Int

Converts the specified pin value to an integer, to use in calculations.

Parameters:

Name	Type	Description
value	Gpio Pin Value	The pin to read the value from.

Return Type: Integer

Returns: The pin value as an integer.

Signatures:

C++

int to_int(gpio_pin_value value)

C#

public static int SplashKit.ToInt(GpioPinValue value);

Python

def to_int(value):

Pascal

function ToInt(value: GpioPinValue): Integer

---

Types

Adc Device

The Adc Device type is used to refer to ADC (Analog-to-Digital Converter) devices that can be managed by the SplashKit ADC code, such as ADS7830. ADC devices are:

• loaded with Open Adc,
• accessed using Adc Device Named or checked with Has Adc Device,
• read using Read Adc to retrieve analog values from specific channels,
• and must be closed using Close Adc (to release a specific ADC device) or Close All Adc (to release all loaded ADC devices).

ADC devices allow you to interface with external analog sensors or inputs, converting their signals into digital values for processing in your application.

---