The function returns low byte of number. The function does not interpret bit patterns of number – 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.

• number: input number

Low byte of number, bits 7..0.

Nothing.

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

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

None.

The function returns high byte of number. The function does not interpret bit patterns of number – 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.

• number: input number

High byte of number, bits 15..8.

Nothing.

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

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

None.

The function returns higher byte of number. The function does not interpret bit patterns of number – 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.

• number: input number

Higher byte of number, bits 23..16.

Nothing.

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

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

None.

The function returns highest byte of number. The function does not interpret bit patterns of number – 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.

• number: input number

Highest byte of number, bits 31..24.

Nothing.

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

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

None.

The function returns low word of number. The function does not interpret bit patterns of number – 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.

• number: input number

Low word of number, bits 15..0.

Nothing.

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

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

None.

The function returns high word of number. The function does not interpret bit patterns of number – 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.

• number: input number

High word of number, bits 31..16.

Nothing.

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

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

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. Delay lasts for x*16384 + y MCU clock cycles.

• x: NumberOfCycles divided by 16384
• y: remainder of the NumberOfCycles/16384 division

Nothing.

Nothing.

Delay_Cyc(1, 10);  /* 1x16384 + 10 = 16394 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 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.

This function adds a given number to a pointer to a constant allocated in the far program memory space.

• ptr: pointer to a constant allocated in the far program memory space.
• increment: number to increment pointer by.

Nothing.

Nothing.

const code far unsigned char *cpointer;  // pointer to a const array in far program memory space
const code far char const_array[10];     // const array allocated in far program memory space
...
cpointer = &const_array[5] ;
__AddToFarPointer(&cpointer, 1);  // increment pointer by 1; cpointer now points to const_array[6]

None.

This function subtracts pointer to a constant allocated in the far program memory space by a given number.

• ptr: pointer to a constant allocated in the far program memory space.
• decrement: number to decrement pointer by.

Nothing.

Nothing.

const code far unsigned char *cpointer;  // pointer to a const array in far program memory space
const code far char const_array[10];     // const array allocated in far program memory space
...
cpointer = &const_array[5] ;
__SubFromFarPointer(&cpointer, 1);  // decrement pointer by 1; cpointer now points to const_array[4]

None.

This function converts a given Flash memory address to a pointer to a constant allocated in the far program memory space.

• address: address in Flash memory to be converted.

Pointer to a constant allocated in the far program memory space.

Nothing.

None.

This function converts a pointer to a constant (allocated in the far program memory space) to the appropriate Flash memory address.

• ptr: pointer to a constant allocated in the far program memory space.

Appropriate Flash memory address.

Nothing.

None.