www.beck-ipc.com

@CHIP-RTOS C Library - BIOS API


BIOS_Power_SaveEx

Power save.

int BIOS_Power_SaveEx ( unsigned char mode );

SC11/SC13 Parameters

mode
0x01: Restore full speed mode
0x02: Set 1/2 speed mode
0x04: Set 1/4 speed mode (serial baudrates > 57600 will no longer be accurate)
0x80: Enter sleep mode (RTOS 1ms timer and time/date will be affected)
0x81: Wakeup from sleep mode
0x20: Power down Ethernet controller (no Ethernet communication is possible)
0x21: Power up Ethernet controller

SC1x3/SC2x Parameters

mode
0x01: Restore full speed mode
0x02: Set 1/2 speed mode
0x04: Set 1/4 speed mode
0x20: Power down Ethernet controller (no Ethernet communication is possible)
0x21: Power up Ethernet controller
0x22: Disable the Ethernet Energy Detect Power-Down mode
0x23: Enable the Ethernet Energy Detect Power-Down mode

Return Value

0 if successful

Comments

This function slows down the processor clock and puts the CPU in a powersave mode until the original mode is restored.

Note: Power consumption may differ slightly when the date code of the IPC@CHIP® is changed.

SC12 Comments

For SC12 the mode parameter has no affect.   The BIOS_Power_Save API is recommended for SC12.

SC1x3/SC2x Comments

In mode 0x23 the Ethernet PHY is partially powered down.   The PHY powers-up when there is valid energy from the line: 100Base-TX, 10 Base-T or auto negotiation.
If the user calls this function with mode = 4 (Set 1/4 speed mode), the internal ethernet controller doesn't work in the 100 MBit mode. Because of this behaviour, it is recommended to set the ethernet mode at chip.ini fix to 10MBit Halfduplex.

The modes 0x02 and 0x04 influence the USB API. In mode 0x02 the USB API cannot be used at all. The SC1x3/SC2x will crash if you do. In mode 0x04 the USB API can only be used in Device mode, because Host mode needs better performance.

See Also

RTOS API

This library function invokes a RTOS software interrupt.   Refer to this RTOS API function's documentation for more details.

Supported since or modified in @CHIP-RTOS version

    SC12SC13SC11SC1x3SC2x
    n/aV1.00V1.00V0.90V1.00

This API List
List of C Libraries
@CHIP-RTOS Main Index


End of document