The function returns low byte of param. The function does not interpret bit patterns of param – it merely returns 8 bits as found in register.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• param: input number.

Low byte of param, bits 7..0.

Nothing.

d = 0x12345678; 	
tmp = Lo(d);  // Equals 0x78

Lo(d) = 0xAA; // d equals 0x123456AA

None.

The function returns high byte of param. The function does not interpret bit patterns of param – it merely returns 8 bits as found in register.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• param: input number.

High byte of param, bits 15..8.

Nothing.

d = 0x12345678; 	
tmp = Hi(d);  // Equals 0x56

Hi(d) = 0xAA; // d equals 0x1234AA78

None.

The function returns higher byte of param. The function does not interpret bit patterns of param – it merely returns 8 bits as found in register.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• param: input number.

Higher byte of param, bits 23..16.

Nothing.

d = 0x12345678; 	
tmp = Higher(d);  // Equals 0x34

Higher(d) = 0xAA; // d equals 0x12AA5678

None.

The function returns highest byte of param. The function does not interpret bit patterns of param – it merely returns 8 bits as found in register.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• param: input number.

Highest byte of param, bits 31..24.

Nothing.

d = 0x12345678; 	
tmp = Highest(d);  // Equals 0x12

Highest(d) = 0xAA; // d equals 0xAA345678

None.

The function returns low word of param. The function does not interpret bit patterns of param – it merely returns 16 bits as found in register.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• param: input number.

Low word of param, bits 15..0.

Nothing.

d = 0x12345678; 	
tmp = LoWord(d);  // Equals 0x5678

LoWord(d) = 0xAAAA; // d equals 0x1234AAAA

None.

The function returns high word of param. The function does not interpret bit patterns of param – it merely returns 16 bits as found in register.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• param: input number.

High word of param, bits 31..16.

Nothing.

d = 0x12345678; 	
tmp = HiWord(d);  // Equals 0x1234

HiWord(d) = 0xAAAA; // d equals 0xAAAA5678

None.

The function returns low longword of param. The function does not interpret bit patterns of param – it merely returns 32 bits as found in register.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• param: input number.

Low longword of param, bits 31..0.

Nothing.

d = 0x1122334455667788;
tmp = LoLongWord(d);  // Equals 0x55667788

LoLongWord(d) = 0xAAAAAAAA; // d equals 0x11223344AAAAAAAA

None.

The function returns high longword of param. The function does not interpret bit patterns of param – it merely returns 32 bits as found in register.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• param: input number.

High word of param, bits 63..32.

Nothing.

d = 0x1122334455667788;
tmp = HiLongWord(d);  // Equals 0x11223344

HiLongWord(d) = 0xAAAAAAAA; // d equals 0xAAAAAAAA55667788

None.

Creates a software delay in duration of time_in_us microseconds.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• time_in_us: delay time in microseconds. Valid values: constant values, range of applicable constants depends on the oscillator frequency

Nothing.

Nothing.

Delay_us(10);  /* Ten microseconds pause */

None.

Creates a software delay in duration of time_in_ms milliseconds.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

• time_in_ms: delay time in milliseconds. Valid values: constant values, range of applicable constants depends on the oscillator frequency

Nothing.

Nothing.

Delay_ms(1000);  /* One second pause */

For generating delays with variable as input parameter use the Vdelay_ms routine.

Creates a software delay in duration of Time_ms milliseconds. Generated delay is not as precise as the delay created by Delay_ms.

• Time_ms: delay time in milliseconds

Nothing.

Nothing.

unsignedpause = 1000;
...
Vdelay_ms(pause);  // ~ one second pause

Vdelay_ms is a library function rather than a built-in routine; it is presented in this topic for the sake of convenience.

Creates a software delay in duration of time_in_ms milliseconds (a variable), for a given oscillator frequency. Generated delay is not as precise as the delay created by Delay_ms.

• Time_ms: delay time in milliseconds
• Current_Fosc_kHz: desiredoscillator frequency

Nothing.

Nothing.

pause = 1000;
fosc = 10000;

VDelay_Advanced_ms(pause, fosc);  // Generates approximately one second pause, for a oscillator frequency of 10 MHz

Note that VDelay_Advanced_ms is library function rather than a built-in routine; it is presented in this topic for the sake of convenience.

Creates a delay based on MCU clock.

• cycles_div_by_10: number of cycles divided by 10

Nothing.

Nothing.

Delay_Cyc(10);  // 1 cycles pause

Delay_Cyc is a library function rather than a built-in routine; it is presented in this topic for the sake of convenience.

Creates a delay based on MCU clock. Delay lasts for CycNo MCU clock cycles.

• CycNo: number of cycles

Nothing.

Nothing.

Delay_Cyc_Long(16394);  // 16394 cycles pause

Delay_Cyc_Long is a library function rather than a built-in routine; it is presented in this topic for the sake of convenience.

Function returns device clock in kHz, rounded to the nearest integer.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

None.

Device clock in kHz, rounded to the nearest integer.

Nothing.

unsigned long clk;
...
clk = Clock_kHz();

None.

Function returns device clock in MHz, rounded to the nearest integer.

This is an “inline” routine; code is generated in the place of the call, so the call doesn’t count against the nested call limit.

None.

Device clock in MHz, rounded to the nearest integer.

Nothing.

unsigned long clk;
...
clk = Clock_Mhz();

None.

Function returns device clock in kHz, rounded to the nearest integer.

Note that Get_Fosc_kHz is library function rather than a built-in routine; it is presented in this topic for the sake of c?nvenience.

None.

Device clock in kHz, rounded to the nearest integer.

Nothing.

unsigned long clk;
...
clk = Get_Fosc_kHz();

None.

Function returns peripheral clock in kHz, rounded to the nearest integer.

Note that Get_Peripheral_Clock_kHz is library function rather than a built-in routine; it is presented in this topic for the sake of convenience.

None.

Periperal clock in kHz, rounded to the nearest integer.

Nothing.

unsigned long clk;
...
clk = Get_Peripheral_Clock_kHz();

None.

Function returns device's clock per cycle, rounded to the nearest integer.

Note that Get_Fosc_Per_Cyc is library function rather than a built-in routine; it is presented in this topic for the sake of convenience.

None.

Device's clock per cycle, rounded to the nearest integer.

Nothing.

unsigned int clk_per_cyc;
...
clk_per_cyc = Get_Fosc_Per_Cyc();

None.

Function copies nn bytes from the object pointed to by s2 into the object pointed to by s1. If copying takes place between objects that overlap, the behavior is undefined.

The behavior of the MEMCPY instruction is exactly the same as the standard C memcpy() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns address of the object pointed to by s1.

Nothing.

Use this function for all object alignments.

Function copies nn bytes from the object pointed to by s2 into the object pointed to by s1. If copying takes place between objects that overlap, the behavior is undefined.

The behavior of the MEMCPY instruction is exactly the same as the standard C memcpy() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns address of the object pointed to by s1.

Function parameters must have alignment 2.

Use this function when function parameters have alignment 2.

Function copies nn bytes from the object pointed to by s2 into the object pointed to by s1. If copying takes place between objects that overlap, the behavior is undefined.

The behavior of the MEMCPY instruction is exactly the same as the standard C memcpy() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns address of the object pointed to by s1.

Function parameters must have alignment 4.

Use this function when function parameters have alignment 4.

Function copies the value of the byte c into each of the first n bytes of the object pointed by s.

The behavior of the MEMSET instruction is exactly the same as the standard C memsety() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns address of the object pointed to by s.

Nothing.

None.

Function copies the value of the byte c into each of the first n bytes of the object pointed by s.

The behavior of the MEMSET instruction is exactly the same as the standard C memset() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns address of the object pointed to by s.

Function parameters must have alignment 2.

Use this function when function parameters have alignment 2.

Function copies the value of the byte c into each of the first n bytes of the object pointed by s.

The behavior of the MEMSET instruction is exactly the same as the standard C memset() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns address of the object pointed to by s.

Function parameters must have alignment 4.

Use this function when function parameters have alignment 4.

Function moves n bytes from an object pointed to by s2 located in I/O, to an object pointed to by s1 located in program memory.

The function returns address of the object pointed to by s1.

Nothing.

None.

Function moves n bytes from an object pointed to by s2 located in I/O, to an object pointed to by s1 located in program memory.

The function returns address of the object pointed to by s1.

Function parameters must have alignment 2.

Use this function when function parameters have alignment 2.

Function moves n bytes from an object pointed to by s2 located in I/O, to an object pointed to by s1 located in program memory.

The function returns address of the object pointed to by s1.

Function parameters must have alignment 4.

Use this function when function parameters have alignment 4.

Function moves n bytes from an object pointed to by s2 located in I/O, to an object pointed to by s1 located in program memory, with incrementing destination program memory address.

The function returns address of the object pointed to by s1.

Nothing.

None.

Function moves n bytes from an object pointed to by s2 located in I/O, to an object pointed to by s1 located in program memory, with incrementing destination program memory address.

The function returns address of the object pointed to by s1.

Function parameters must have alignment 2.

Use this function when function parameters have alignment 2.

Function moves n bytes from an object pointed to by s2 located in I/O, to an object pointed to by s1 located in program memory, with incrementing destination program memory address.

The function returns address of the object pointed to by s1.

Function parameters must have alignment 4.

Use this function when function parameters have alignment 4.

Function moves n bytes from an object pointed to by s2 located in program memory, to an object pointed to by s1 located in I/O.

The function returns address of the object pointed to by s1.

Nothing.

None.

Function moves n bytes from an object pointed to by s2 located in program memory, to an object pointed to by s1 located in I/O.

The function returns address of the object pointed to by s1.

Function parameters must have alignment 2.

Use this function when function parameters have alignment 2.

Function moves n bytes from an object pointed to by s2 located in program memory, to an object pointed to by s1 located in I/O.

The function returns address of the object pointed to by s1.

Function parameters must have alignment 4.

Use this function when function parameters have alignment 4.

Function moves n bytes from an object pointed to by s2 located in program memory, to an object pointed to by s1 located in I/O, with incrementing source program memory address.

The function returns address of the object pointed to by s1.

Nothing.

None.

Function moves n bytes from an object pointed to by s2 located in program memory, to an object pointed to by s1 located in I/O, with incrementing source program memory address.

The function returns address of the object pointed to by s1.

Function parameters must have alignment 2.

Use this function when function parameters have alignment 2.

Function moves n bytes from an object pointed to by s2 located in program memory, to an object pointed to by s1 located in I/O, with incrementing source program memory address.

The function returns address of the object pointed to by s1.

Function parameters must have alignment 4.

Use this function when function parameters have alignment 4.

Function compares strings s1 and s2 and returns zero if the strings are equal, or returns a difference between the first differing characters (in a left-to-right evaluation).
Accordingly, the result is greater than zero if s1 is greater than s2 and vice versa.

The behavior of the STRCMP_B instruction is exactly the same as the standard C strcmp() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns zero if the strings are equal, or returns a difference between the first differing characters (in a left-to-right evaluation).

Nothing.

None.

Function compares strings s1 and s2 and returns zero if the strings are equal, or returns a difference between the first differing characters (in a left-to-right evaluation).
Accordingly, the result is greater than zero if s1 is greater than s2 and vice versa.

The behavior of the STRCMP_B instruction is exactly the same as the standard C strcmp() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns zero if the strings are equal, or returns a difference between the first differing characters (in a left-to-right evaluation).

Function parameters must have alignment 2.

Use this function when function parameters have alignment 2.

Function compares strings s1 and s2 and returns zero if the strings are equal, or returns a difference between the first differing characters (in a left-to-right evaluation).
Accordingly, the result is greater than zero if s1 is greater than s2 and vice versa.

The behavior of the STRCMP_B instruction is exactly the same as the standard C strcmp() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns zero if the strings are equal, or returns a difference between the first differing characters (in a left-to-right evaluation).

Function parameters must have alignment 4.

Use this function when function parameters have alignment 4.

Function copies the string s2 into the string s1. If copying is successful, the function returns pointer to s1. If copying takes place between objects that overlap, the behavior is undefined.

The behavior of the STPCPY_B instruction is exactly the same as the standard C stpcpy() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns address of the object pointed to by s1.

Nothing.

None.

Function copies the string s2 into the string s1. If copying is successful, the function returns pointer to s1. If copying takes place between objects that overlap, the behavior is undefined.

The behavior of the STPCPY_B instruction is exactly the same as the standard C stpcpy() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns address of the object pointed to by s1.

Function parameters must have alignment 2.

Use this function when function parameters have alignment 2.

Function copies the string s2 into the string s1. If copying is successful, the function returns pointer to s1. If copying takes place between objects that overlap, the behavior is undefined.

The behavior of the STPCPY_L instruction is exactly the same as the standard C stpcpy() function in ISO/IEC 9899:1990 ("ISO C90").

The function returns address of the object pointed to by s1.

Function parameters must have alignment 4.

Use this function when function parameters have alignment 4.

Function returns the length of the string s (the terminating null character does not count against string’s length).

The behavior of the STRLEN_B instruction is exactly the same as the standard C strlen() function in ISO/IEC 9899:1990 ("ISO C90").

Function returns the length of the string.

Nothing.

None.

Function returns the length of the string s (the terminating null character does not count against string’s length).

The behavior of the STRLEN_S instruction is exactly the same as the standard C strlen() function in ISO/IEC 9899:1990 ("ISO C90").

Function returns the length of the string.

Function parameters must have alignment 2.

Use this function when function parameters have alignment 2.

Function returns the length of the string s (the terminating null character does not count against string’s length).

The behavior of the STRLEN_L instruction is exactly the same as the standard C strlen() function in ISO/IEC 9899:1990 ("ISO C90").

Function returns the length of the string.

Function parameters must have alignment 4.

Use this function when function parameters have alignment 4.