This is the latest (main) BeagleBoard documentation. If you are looking for stable releases, use the drop-down menu on the bottom-left and select the desired version.

IO Functions

  • All Header pins are constant integer variable by default, with its value equal to respective R30/R31 register bit

    • Example: P1_20 is an constant integer variable with value 16, similarly P1_02 is an constant integer variable with value 9

Digital Write

digital_write is a function which enables PRU to write given logic level at specified output pin. It is a function with void return type and it’s parameters are integer and boolean, first parameter is the pin number to write to or PRU R30 register bit and second parameter is boolean value to be written. true for HIGH and false for LOW.

Syntax

digital_write(pin_number, value);

Parameters

  • pin_number is an integer. It must be a header pin name which supports output, or PRU R30 Register bit.

  • value is a boolean. It is used to set logic level of the output pin, true for HIGH and false for LOW.

Return Type

  • void - returns nothing.

Example

int a := 32;

if : a < 32 {
    digital_write(P1_29, true);
}
else {
    digital_write(P1_29, false);
}

If the value of a < 32, then pin P1_29 is set to HIGH or else it is set to LOW.

Digital Read

digital_read is a function which enables PRU to read logic level at specified input pin. It is a function with return type boolean and it’s parameter is a integer whose value must be the pin number to be read or PRU R31 register bit.

Syntax

digital_read(pin_number);

Parameters

  • pin_number is an integer. It must be a header pin name which supports input, or PRU R31 Register bit.

Return Type

  • boolean - returns the logic level of the pin number passed to it. It returns true for HIGH and false for LOW.

Example

if digital_read(P1_20) {
    digital_write(P1_29, false);
}
else {
    digital_write(P1_29, true);
}

Logic level of pin P1_20 is read. If it is HIGH, then pin P1_29 is set to LOW, or else it is set to HIGH.

Delay

delay is a function which makes PRU wait for specified milliseconds. When this is called PRU does absolutely nothing, it just sits there waiting.

Syntax

delay(time_in_ms);

Parameters

  • time_in_ms is an integer. It is the amount of time PRU should wait in milliseconds. (1000 milliseconds = 1 second).

Return Type

  • void - returns nothing.

Example

digital_write(P1_29, true);
delay(2000);
digital_write(P1_29, false);

Logic level of pin P1_29 is set to HIGH, PRU waits for 2000 ms = 2 seconds, and then sets the logic level of pin P1_29 to LOW.

Start counter

start_counter is a function which starts PRU’s internal counter. It counts number of CPU cycles. So it can be used to count time elapsed, as it is known that each cycle takes 5 nanoseconds.

Syntax

start_counter()

Parameters

  • n/a

Return Type

  • void - returns nothing.

Example

start_counter();

Stop counter

stop_counter is a function which stops PRU’s internal counter.

Syntax

stop_counter()

Parameters

  • n/a

Return Type

  • void - returns nothing.

Example

stop_counter();

Read counter

read_counter is a function which reads PRU’s internal counter and returns the value. It counts number of CPU cycles. So it can be used to count time elapsed, as it is known that each cycle takes 5 nanoseconds.

Syntax

read_counter()

Parameters

  • n/a

Return Type

  • integer - returns the number of cycles elapsed since calling start_counter.

Example

start_counter();

while : read_counter < 200000000 {
    digital_write(P1_29, true);
}

digital_write(P1_29, false);
stop_counter();

while the value of hardware counter is less than 200000000, it will set logic level of pin P1_29 to HIGH, after that it will set it to LOW. Here, 200000000 cpu cycles means 1 second of time, as CPU clock is 200 MHz. So, LED will turn on for 1 second, and turn off after.

Init message channel

init_message_channel is a function which is used to initialise communication channel between PRU and the ARM core. It is sets up necessary structures to use RPMSG to communicate, it expects a init message from the ARM core to initialise. It is a necessary to call this function before using any of the message functions.

Syntax

init_message_channel()

Parameters

  • n/a

Return Type

  • void - returns nothing

Example

init_message_channel();

Receive message

receive_message is a function which is used to receive messages from ARM to the PRU, messages can only be integers, as only they are supported as of now. It uses RPMSG channel setup by init_message_channel to receive messages from ARM core.

Syntax

receive_message()

Parameters

  • n/a

Return Type

  • integer - returns integer data received from PRU

Example

init_message_channel();

int temp := receive_message();

if : temp >= 0 {
    digital_write(P1_29, true);
}
else {
    digital_write(P1_29, false);
}

Send message

There are six functions which are used to send messages to ARM core from PRU, messages can be integers, characters, bools, integer arrays, character arrays, and boolean arrays. It uses RPMSG channel setup by init_message_channel to send messages from PRU to the ARM core.

For sending arrays, arrays are automatically converted to a string, for example, [1, 2, 3, 4] would become “1 2 3 4”.

Syntax

  • send_int(expression)

  • send_char(expression)

  • send_bool(expression)

  • send_ints(identifier)

  • send_chars(identifier)

  • send_bools(identifier)

  • send_message is an alias for send_int to preserve backwards compatibility.

Parameters

  • For send_int and send_char, expression would be an arithmetic expression.

  • For send_bool, expression would be a boolean expression

  • For send_ints, identifier should be an identifier for an integer array.

  • For send_chars, identifier should be an identifier for a character array.

  • For send_bools, identifier should be an identifier for a boolean array.

Example

init_message_channel();

if : digital_read(P1_29) {
    send_bool(true);
}
else {
    send_int(0);
}