de.weAut

Enum PiGpioDerrs

java.lang.Object

java.lang.Enum<PiGpioDerrs>

de.weAut.PiGpioDerrs

All Implemented Interfaces:

Serializable, Comparable<PiGpioDerrs>

public enum PiGpioDerrs
extends Enum<PiGpioDerrs>

PiGpioD errors' (-1..-144) short explanation.

The definitions are ported from abyz.me.uk/rpi/pigpio/cif.html or the respective .h-files.

The enum objects defined here for the PiGpioD errors -1..-143 hold (as their main purpose) a short English explanation.
Their ordinal numbers 1..143 (respectively 0..145; see below) are the (positive) absolute value of the (negative with Linux and PiGpioD) error codes. That means:
Enum.ordinal() == -errNum() (1)
always holds.

The errors -1..-143 are supplemented by no error (0), a Python error command interrupted (-144) irrelevant here, and a unknown PI_error to be delivered for a wrong (<-144) error number.

Note 1 to equation (1): For good reasons, attaching significance to the ordinal associated with an enum (as we do here) is considered error prone and, hence, bad practice. Re-sorting, deleting or inserting enum definitions, would invalidate the fundamental assumption (i.e. equation (1)) and spoil everything.
Rationale: The good (and only) reason we give the ordinal our (-errnum) significance is getting in O(1) complexity from an error number to the enum object and thus to the short explanation. For a Java program running with real time requirements on a little Pi this O(1) feature may me crucial. We've seen Java code therefore with O(n) as well as with thwow awayy objects).

Note 2 to equation (1): This enum class as application to be started by
java de.weAut.PiGpioDdefs$ErrPI
not only gives a nice listing of all enum'd errors with their short explanation but is, also, the build in test tool to check the basic assumption (1) after doing any changes.
be used after any changes.


Copyright © 2021 Albrecht Weinert

   weinert-automation.de        a-weinert.de

     /         /      /\
    /         /___   /  \      |
    \        /____\ /____\ |  _|__
     \  /\  / \    /      \|   |
      \/  \/   \__/        \__/|_

Version:

60 (15.07.2021)

Author:

Albrecht Weinert

See Also:

ThePi, ClientPigpiod, PiGpioDdefs

Enum Constant Summary

Enum Constants

Enum Constant and Description
PI_BAD_BUF_MILLIS
PI_BAD_CFG_INTERNAL
PI_BAD_CHAIN_CMD
PI_BAD_CHAIN_DELAY
PI_BAD_CHAIN_LOOP
PI_BAD_CHANNEL
PI_BAD_CLK_MICROS
PI_BAD_CLK_PERIPH
PI_BAD_CLK_SOURCE
PI_BAD_DATABITS
PI_BAD_DUTYCYCLE
PI_BAD_DUTYRANGE
PI_BAD_EDGE
PI_BAD_EVENT_ID
PI_BAD_FIFO_COMMAND
PI_BAD_FILE_FLAG
PI_BAD_FILE_MODE
PI_BAD_FILE_READ
PI_BAD_FILE_SEEK
PI_BAD_FILE_WRITE
PI_BAD_FILTER
PI_BAD_FLAGS
PI_BAD_FOREVER
PI_BAD_GPIO
PI_BAD_HANDLE
PI_BAD_HCLK_FREQ
PI_BAD_HCLK_PASS
PI_BAD_HPWM_DUTY
PI_BAD_HPWM_FREQ
PI_BAD_I2C_ADDR
PI_BAD_I2C_BAUD
PI_BAD_I2C_BUS
PI_BAD_I2C_CMD
PI_BAD_I2C_RLEN
PI_BAD_I2C_SEG
PI_BAD_I2C_WLEN
PI_BAD_IF_FLAGS
PI_BAD_ISR_INIT
PI_BAD_LEVEL
PI_BAD_MALLOC_MODE
PI_BAD_MICROS
PI_BAD_MICS_DELAY
PI_BAD_MILS_DELAY
PI_BAD_MODE
PI_BAD_MS
PI_BAD_PAD
PI_BAD_PARAM
PI_BAD_PARAM_NUM
PI_BAD_PATHNAME
PI_BAD_POINTER
PI_BAD_PUD
PI_BAD_PULSELEN
PI_BAD_PULSEWIDTH
PI_BAD_SCRIPT
PI_BAD_SCRIPT_CMD
PI_BAD_SCRIPT_ID
PI_BAD_SCRIPT_NAME
PI_BAD_SECO_CHANNEL
PI_BAD_SECONDS
PI_BAD_SER_DEVICE
PI_BAD_SER_INVERT
PI_BAD_SER_OFFSET
PI_BAD_SER_SPEED
PI_BAD_SERIAL_BUF
PI_BAD_SERIAL_COUNT
PI_BAD_SERIAL_STRUC
PI_BAD_SHELL_STATUS
PI_BAD_SIGNUM
PI_BAD_SMBUS_CMD
PI_BAD_SOCKET_PORT
PI_BAD_SPI_BAUD
PI_BAD_SPI_CHANNEL
PI_BAD_SPI_COUNT
PI_BAD_SPI_SPEED
PI_BAD_STOPBITS
PI_BAD_STRENGTH
PI_BAD_TAG
PI_BAD_TIMER
PI_BAD_TIMETYPE
PI_BAD_USER_GPIO
PI_BAD_VAR_NUM
PI_BAD_WAVE_BAUD
PI_BAD_WAVE_ID
PI_BAD_WAVE_MODE
PI_BAD_WDOG_TIMEOUT
PI_BAD_WVSC_COMMND
PI_BAD_WVSM_COMMND
PI_BAD_WVSP_COMMND
PI_CHAIN_COUNTER
PI_CHAIN_LOOP_CNT
PI_CHAIN_NESTING
PI_CHAIN_TOO_BIG
PI_CMD_INTERRUPTED Special case: Python error.
PI_DEPRECATED
PI_DUP_TAG
PI_EMPTY_WAVEFORM
PI_FIL_OPEN_FAILED
PI_FILE_IS_A_DIR
PI_FILE_NOT_ROPEN
PI_FILE_NOT_WOPEN
PI_GPIO_IN_USE
PI_HPWM_ILLEGAL
PI_I2C_OPEN_FAILED
PI_I2C_READ_FAILED
PI_I2C_WRITE_FAILED
PI_INIT_FAILED
PI_INITIALISED
PI_MSG_TOOBIG
PI_NO_ALERT_FUNC
PI_NO_AUX_SPI
PI_NO_ERROR Special case: no error.
PI_NO_FILE_ACCESS
PI_NO_FILE_MATCH
PI_NO_HANDLE
PI_NO_MEMORY
PI_NO_SCRIPT_ROOM
PI_NO_WAVEFORM_ID
PI_NOT_HCLK_GPIO
PI_NOT_HPWM_GPIO
PI_NOT_I2C_GPIO
PI_NOT_INITIALISED
PI_NOT_PERMITTED GPIO operation not permitted.
PI_NOT_PWM_GPIO
PI_NOT_SERIAL_GPIO
PI_NOT_SERVO_GPIO
PI_NOT_SPI_GPIO
PI_SCRIPT_NOT_READY
PI_SER_OPEN_FAILED
PI_SER_READ_FAILED
PI_SER_READ_NO_DATA
PI_SER_WRITE_FAILED
PI_SOCK_READ_FAILED
PI_SOCK_WRIT_FAILED
PI_SOME_PERMITTED
PI_SPI_OPEN_FAILED
PI_SPI_XFER_FAILED
PI_TIMER_FAILED
PI_TOO_MANY_CBS
PI_TOO_MANY_CHARS
PI_TOO_MANY_OOL
PI_TOO_MANY_PARAM
PI_TOO_MANY_PULSES
PI_TOO_MANY_SEGS
PI_TOO_MANY_TAGS
PI_UNKNOWN_COMMAND
PI_UNKNOWN_ERROR Special case: wrong error number.

Field Summary

Fields

Modifier and Type	Field and Description
String	expl The pigpiod error's short explanation.

Method Summary

Modifier and Type	Method and Description
StringBuilder	append(StringBuilder dest, int tab) Description of the enum object.
static PiGpioDerrs	byErrNum(int num) Get explained error by error number (-) or index.
int	errNum() Get the error number (-).
static void	main(String[] args) The enum ErrPi as application.
String	toString() Description of the enum object.
static PiGpioDerrs	valueOf(String name) Returns the enum constant of this type with the specified name.
static PiGpioDerrs[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

PI_NO_ERROR

public static final PiGpioDerrs PI_NO_ERROR

Special case: no error.

Value: 0

PI_INIT_FAILED

public static final PiGpioDerrs PI_INIT_FAILED

PI_BAD_USER_GPIO

public static final PiGpioDerrs PI_BAD_USER_GPIO

PI_BAD_GPIO

public static final PiGpioDerrs PI_BAD_GPIO

PI_BAD_MODE

public static final PiGpioDerrs PI_BAD_MODE

PI_BAD_LEVEL

public static final PiGpioDerrs PI_BAD_LEVEL

PI_BAD_PUD

public static final PiGpioDerrs PI_BAD_PUD

PI_BAD_PULSEWIDTH

public static final PiGpioDerrs PI_BAD_PULSEWIDTH

PI_BAD_DUTYCYCLE

public static final PiGpioDerrs PI_BAD_DUTYCYCLE

PI_BAD_TIMER

public static final PiGpioDerrs PI_BAD_TIMER

PI_BAD_MS

public static final PiGpioDerrs PI_BAD_MS

PI_BAD_TIMETYPE

public static final PiGpioDerrs PI_BAD_TIMETYPE

PI_BAD_SECONDS

public static final PiGpioDerrs PI_BAD_SECONDS

PI_BAD_MICROS

public static final PiGpioDerrs PI_BAD_MICROS

PI_TIMER_FAILED

public static final PiGpioDerrs PI_TIMER_FAILED

PI_BAD_WDOG_TIMEOUT

public static final PiGpioDerrs PI_BAD_WDOG_TIMEOUT

PI_NO_ALERT_FUNC

public static final PiGpioDerrs PI_NO_ALERT_FUNC

PI_BAD_CLK_PERIPH

public static final PiGpioDerrs PI_BAD_CLK_PERIPH

PI_BAD_CLK_SOURCE

public static final PiGpioDerrs PI_BAD_CLK_SOURCE

PI_BAD_CLK_MICROS

public static final PiGpioDerrs PI_BAD_CLK_MICROS

PI_BAD_BUF_MILLIS

public static final PiGpioDerrs PI_BAD_BUF_MILLIS

PI_BAD_DUTYRANGE

public static final PiGpioDerrs PI_BAD_DUTYRANGE

PI_BAD_SIGNUM

public static final PiGpioDerrs PI_BAD_SIGNUM

PI_BAD_PATHNAME

public static final PiGpioDerrs PI_BAD_PATHNAME

PI_NO_HANDLE

public static final PiGpioDerrs PI_NO_HANDLE

PI_BAD_HANDLE

public static final PiGpioDerrs PI_BAD_HANDLE

PI_BAD_IF_FLAGS

public static final PiGpioDerrs PI_BAD_IF_FLAGS

PI_BAD_CHANNEL

public static final PiGpioDerrs PI_BAD_CHANNEL

PI_BAD_SOCKET_PORT

public static final PiGpioDerrs PI_BAD_SOCKET_PORT

PI_BAD_FIFO_COMMAND

public static final PiGpioDerrs PI_BAD_FIFO_COMMAND

PI_BAD_SECO_CHANNEL

public static final PiGpioDerrs PI_BAD_SECO_CHANNEL

PI_NOT_INITIALISED

public static final PiGpioDerrs PI_NOT_INITIALISED

PI_INITIALISED

public static final PiGpioDerrs PI_INITIALISED

PI_BAD_WAVE_MODE

public static final PiGpioDerrs PI_BAD_WAVE_MODE

PI_BAD_CFG_INTERNAL

public static final PiGpioDerrs PI_BAD_CFG_INTERNAL

PI_BAD_WAVE_BAUD

public static final PiGpioDerrs PI_BAD_WAVE_BAUD

PI_TOO_MANY_PULSES

public static final PiGpioDerrs PI_TOO_MANY_PULSES

PI_TOO_MANY_CHARS

public static final PiGpioDerrs PI_TOO_MANY_CHARS

PI_NOT_SERIAL_GPIO

public static final PiGpioDerrs PI_NOT_SERIAL_GPIO

PI_BAD_SERIAL_STRUC

public static final PiGpioDerrs PI_BAD_SERIAL_STRUC

PI_BAD_SERIAL_BUF

public static final PiGpioDerrs PI_BAD_SERIAL_BUF

PI_NOT_PERMITTED

public static final PiGpioDerrs PI_NOT_PERMITTED

GPIO operation not permitted.

This error was observed with IO in GPIO 0 and 1. * GPIO 0 and 1 on pins 27 and 28 on Pis 3, 4 & 0 may be used on some Pi type and Raspbian combinations — sometimes after some configuration file edits. But on some combinations they will not work raising this error.
And, alas, it seems the newer the hardware and software the worse. It is a shame to loose two IO pins for the sake of "HAT EEPROMs" when they are of no use.

PI_SOME_PERMITTED

public static final PiGpioDerrs PI_SOME_PERMITTED

PI_BAD_WVSC_COMMND

public static final PiGpioDerrs PI_BAD_WVSC_COMMND

PI_BAD_WVSM_COMMND

public static final PiGpioDerrs PI_BAD_WVSM_COMMND

PI_BAD_WVSP_COMMND

public static final PiGpioDerrs PI_BAD_WVSP_COMMND

PI_BAD_PULSELEN

public static final PiGpioDerrs PI_BAD_PULSELEN

PI_BAD_SCRIPT

public static final PiGpioDerrs PI_BAD_SCRIPT

PI_BAD_SCRIPT_ID

public static final PiGpioDerrs PI_BAD_SCRIPT_ID

PI_BAD_SER_OFFSET

public static final PiGpioDerrs PI_BAD_SER_OFFSET

PI_GPIO_IN_USE

public static final PiGpioDerrs PI_GPIO_IN_USE

PI_BAD_SERIAL_COUNT

public static final PiGpioDerrs PI_BAD_SERIAL_COUNT

PI_BAD_PARAM_NUM

public static final PiGpioDerrs PI_BAD_PARAM_NUM

PI_DUP_TAG

public static final PiGpioDerrs PI_DUP_TAG

PI_TOO_MANY_TAGS

public static final PiGpioDerrs PI_TOO_MANY_TAGS

PI_BAD_SCRIPT_CMD

public static final PiGpioDerrs PI_BAD_SCRIPT_CMD

PI_BAD_VAR_NUM

public static final PiGpioDerrs PI_BAD_VAR_NUM

PI_NO_SCRIPT_ROOM

public static final PiGpioDerrs PI_NO_SCRIPT_ROOM

PI_NO_MEMORY

public static final PiGpioDerrs PI_NO_MEMORY

PI_SOCK_READ_FAILED

public static final PiGpioDerrs PI_SOCK_READ_FAILED

PI_SOCK_WRIT_FAILED

public static final PiGpioDerrs PI_SOCK_WRIT_FAILED

PI_TOO_MANY_PARAM

public static final PiGpioDerrs PI_TOO_MANY_PARAM

PI_SCRIPT_NOT_READY

public static final PiGpioDerrs PI_SCRIPT_NOT_READY

PI_BAD_TAG

public static final PiGpioDerrs PI_BAD_TAG

PI_BAD_MICS_DELAY

public static final PiGpioDerrs PI_BAD_MICS_DELAY

PI_BAD_MILS_DELAY

public static final PiGpioDerrs PI_BAD_MILS_DELAY

PI_BAD_WAVE_ID

public static final PiGpioDerrs PI_BAD_WAVE_ID

PI_TOO_MANY_CBS

public static final PiGpioDerrs PI_TOO_MANY_CBS

PI_TOO_MANY_OOL

public static final PiGpioDerrs PI_TOO_MANY_OOL

PI_EMPTY_WAVEFORM

public static final PiGpioDerrs PI_EMPTY_WAVEFORM

PI_NO_WAVEFORM_ID

public static final PiGpioDerrs PI_NO_WAVEFORM_ID

PI_I2C_OPEN_FAILED

public static final PiGpioDerrs PI_I2C_OPEN_FAILED

PI_SER_OPEN_FAILED

public static final PiGpioDerrs PI_SER_OPEN_FAILED

PI_SPI_OPEN_FAILED

public static final PiGpioDerrs PI_SPI_OPEN_FAILED

PI_BAD_I2C_BUS

public static final PiGpioDerrs PI_BAD_I2C_BUS

PI_BAD_I2C_ADDR

public static final PiGpioDerrs PI_BAD_I2C_ADDR

PI_BAD_SPI_CHANNEL

public static final PiGpioDerrs PI_BAD_SPI_CHANNEL

PI_BAD_FLAGS

public static final PiGpioDerrs PI_BAD_FLAGS

PI_BAD_SPI_SPEED

public static final PiGpioDerrs PI_BAD_SPI_SPEED

PI_BAD_SER_DEVICE

public static final PiGpioDerrs PI_BAD_SER_DEVICE

PI_BAD_SER_SPEED

public static final PiGpioDerrs PI_BAD_SER_SPEED

PI_BAD_PARAM

public static final PiGpioDerrs PI_BAD_PARAM

PI_I2C_WRITE_FAILED

public static final PiGpioDerrs PI_I2C_WRITE_FAILED

PI_I2C_READ_FAILED

public static final PiGpioDerrs PI_I2C_READ_FAILED

PI_BAD_SPI_COUNT

public static final PiGpioDerrs PI_BAD_SPI_COUNT

PI_SER_WRITE_FAILED

public static final PiGpioDerrs PI_SER_WRITE_FAILED

PI_SER_READ_FAILED

public static final PiGpioDerrs PI_SER_READ_FAILED

PI_SER_READ_NO_DATA

public static final PiGpioDerrs PI_SER_READ_NO_DATA

PI_UNKNOWN_COMMAND

public static final PiGpioDerrs PI_UNKNOWN_COMMAND

PI_SPI_XFER_FAILED

public static final PiGpioDerrs PI_SPI_XFER_FAILED

PI_BAD_POINTER

public static final PiGpioDerrs PI_BAD_POINTER

PI_NO_AUX_SPI

public static final PiGpioDerrs PI_NO_AUX_SPI

PI_NOT_PWM_GPIO

public static final PiGpioDerrs PI_NOT_PWM_GPIO

PI_NOT_SERVO_GPIO

public static final PiGpioDerrs PI_NOT_SERVO_GPIO

PI_NOT_HCLK_GPIO

public static final PiGpioDerrs PI_NOT_HCLK_GPIO

PI_NOT_HPWM_GPIO

public static final PiGpioDerrs PI_NOT_HPWM_GPIO

PI_BAD_HPWM_FREQ

public static final PiGpioDerrs PI_BAD_HPWM_FREQ

PI_BAD_HPWM_DUTY

public static final PiGpioDerrs PI_BAD_HPWM_DUTY

PI_BAD_HCLK_FREQ

public static final PiGpioDerrs PI_BAD_HCLK_FREQ

PI_BAD_HCLK_PASS

public static final PiGpioDerrs PI_BAD_HCLK_PASS

PI_HPWM_ILLEGAL

public static final PiGpioDerrs PI_HPWM_ILLEGAL

PI_BAD_DATABITS

public static final PiGpioDerrs PI_BAD_DATABITS

PI_BAD_STOPBITS

public static final PiGpioDerrs PI_BAD_STOPBITS

PI_MSG_TOOBIG

public static final PiGpioDerrs PI_MSG_TOOBIG

PI_BAD_MALLOC_MODE

public static final PiGpioDerrs PI_BAD_MALLOC_MODE

PI_TOO_MANY_SEGS

public static final PiGpioDerrs PI_TOO_MANY_SEGS

PI_BAD_I2C_SEG

public static final PiGpioDerrs PI_BAD_I2C_SEG

PI_BAD_SMBUS_CMD

public static final PiGpioDerrs PI_BAD_SMBUS_CMD

PI_NOT_I2C_GPIO

public static final PiGpioDerrs PI_NOT_I2C_GPIO

PI_BAD_I2C_WLEN

public static final PiGpioDerrs PI_BAD_I2C_WLEN

PI_BAD_I2C_RLEN

public static final PiGpioDerrs PI_BAD_I2C_RLEN

PI_BAD_I2C_CMD

public static final PiGpioDerrs PI_BAD_I2C_CMD

PI_BAD_I2C_BAUD

public static final PiGpioDerrs PI_BAD_I2C_BAUD

PI_CHAIN_LOOP_CNT

public static final PiGpioDerrs PI_CHAIN_LOOP_CNT

PI_BAD_CHAIN_LOOP

public static final PiGpioDerrs PI_BAD_CHAIN_LOOP

PI_CHAIN_COUNTER

public static final PiGpioDerrs PI_CHAIN_COUNTER

PI_BAD_CHAIN_CMD

public static final PiGpioDerrs PI_BAD_CHAIN_CMD

PI_BAD_CHAIN_DELAY

public static final PiGpioDerrs PI_BAD_CHAIN_DELAY

PI_CHAIN_NESTING

public static final PiGpioDerrs PI_CHAIN_NESTING

PI_CHAIN_TOO_BIG

public static final PiGpioDerrs PI_CHAIN_TOO_BIG

PI_DEPRECATED

public static final PiGpioDerrs PI_DEPRECATED

PI_BAD_SER_INVERT

public static final PiGpioDerrs PI_BAD_SER_INVERT

PI_BAD_EDGE

public static final PiGpioDerrs PI_BAD_EDGE

PI_BAD_ISR_INIT

public static final PiGpioDerrs PI_BAD_ISR_INIT

PI_BAD_FOREVER

public static final PiGpioDerrs PI_BAD_FOREVER

PI_BAD_FILTER

public static final PiGpioDerrs PI_BAD_FILTER

PI_BAD_PAD

public static final PiGpioDerrs PI_BAD_PAD

PI_BAD_STRENGTH

public static final PiGpioDerrs PI_BAD_STRENGTH

PI_FIL_OPEN_FAILED

public static final PiGpioDerrs PI_FIL_OPEN_FAILED

PI_BAD_FILE_MODE

public static final PiGpioDerrs PI_BAD_FILE_MODE

PI_BAD_FILE_FLAG

public static final PiGpioDerrs PI_BAD_FILE_FLAG

PI_BAD_FILE_READ

public static final PiGpioDerrs PI_BAD_FILE_READ

PI_BAD_FILE_WRITE

public static final PiGpioDerrs PI_BAD_FILE_WRITE

PI_FILE_NOT_ROPEN

public static final PiGpioDerrs PI_FILE_NOT_ROPEN

PI_FILE_NOT_WOPEN

public static final PiGpioDerrs PI_FILE_NOT_WOPEN

PI_BAD_FILE_SEEK

public static final PiGpioDerrs PI_BAD_FILE_SEEK

PI_NO_FILE_MATCH

public static final PiGpioDerrs PI_NO_FILE_MATCH

PI_NO_FILE_ACCESS

public static final PiGpioDerrs PI_NO_FILE_ACCESS

PI_FILE_IS_A_DIR

public static final PiGpioDerrs PI_FILE_IS_A_DIR

PI_BAD_SHELL_STATUS

public static final PiGpioDerrs PI_BAD_SHELL_STATUS

PI_BAD_SCRIPT_NAME

public static final PiGpioDerrs PI_BAD_SCRIPT_NAME

PI_BAD_SPI_BAUD

public static final PiGpioDerrs PI_BAD_SPI_BAUD

PI_NOT_SPI_GPIO

public static final PiGpioDerrs PI_NOT_SPI_GPIO

PI_BAD_EVENT_ID

public static final PiGpioDerrs PI_BAD_EVENT_ID

PI_CMD_INTERRUPTED

public static final PiGpioDerrs PI_CMD_INTERRUPTED

Special case: Python error.

This error -144 "command interrupted" is not relevant for Java.

PI_UNKNOWN_ERROR

public static final PiGpioDerrs PI_UNKNOWN_ERROR

Special case: wrong error number.

This error "unknown piGpioD error" will be delivered for pigpiod error number undefined in the three decimal digit range.
The non existing (as said) number of this enum (currently -145) is not relevant and may change in future.

Field Detail

expl

public final String expl

The pigpiod error's short explanation.

To have this text respectively texts by error number -1..-144 is what this enum class was made for.

Method Detail

values

public static PiGpioDerrs[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (PiGpioDerrs c : PiGpioDerrs.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static PiGpioDerrs valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

byErrNum

public static final PiGpioDerrs byErrNum(int num)

Get explained error by error number (-) or index.

Parameters:

num - the negative error number or its absolute (positive) value

Returns:

the error enum object or PI_UNKNOWN_ERROR;
0 yields PI_NO_ERROR

errNum

public final int errNum()

Get the error number (-).

Returns:

the error number; it is negative (-Enum.ordinal())

append

public final StringBuilder append(StringBuilder dest,
                                  int tab)

Description of the enum object.

This method appends a description in the form
ErrPI.NOT_PERMITTED -41: GPIO operation not permitted
(e.g.) to dest.

Parameters:

dest - destination to append to; if null dest is made as StringBuilder with initial capacity of 89

tab - the minimal length of (name + blanks) before the error number (-41 in the example relative to the beginning of the enum (-41 in the example name)
A value of 20 or higher will give all enum objects the same (nice) tabular appearance; maximum value: 40

Returns:

dest

toString

public final String toString()

Description of the enum object.

This method returns a description in the form
ErrPI.NOT_PERMITTED -41: GPIO operation not permitted
by delegating to append(null, 8)

Overrides:

toString in class Enum<PiGpioDerrs>

main

public static void main(String[] args)

The enum ErrPi as application.

This little helper lists all enum (pigpiod error) objects on standard output. Thats a nice list for reference.
Additionally, if something should be changed or added, this is the test output to check the correct error number assignment.
N.b.: for this enum class must hold:
Enum.ordinal() == -errNum()

Hint: Start this application by
java de.weAut.PiGpioDerrs

Parameters:

args - start parameters, first parameter if present ignored will be the tab value

See Also:

append(null, tab)