Hardware (hardware)#

The commands and events in this class can be used to access and configure the system hardware and peripherals.

hardware commands#

hardware_enable_dcdc#

Deprecated. This command can be used to enable or disable DC/DC.

Command#

• 0: disabled

• 1: enabled

Response#

• 0: success

• Non-zero: an error occurred

For other values refer to the Error codes

API#

/* Function */  
struct gecko_msg_hardware_enable_dcdc_rsp_t *gecko_cmd_hardware_enable_dcdc(uint8 enable);  
  
/* Response id */  
gecko_rsp_hardware_enable_dcdc_id  
  
/* Response structure */  
struct gecko_msg_hardware_enable_dcdc_rsp_t  
{  
  uint16 result  
}  

hardware_get_time#

Deprecated. Get elapsed time since last reset of RTCC

Command#

Response#

API#

/* Function */  
struct gecko_msg_hardware_get_time_rsp_t *gecko_cmd_hardware_get_time();  
  
/* Response id */  
gecko_rsp_hardware_get_time_id  
  
/* Response structure */  
struct gecko_msg_hardware_get_time_rsp_t  
{  
  uint32 seconds,  
  uint16 ticks  
}  

hardware_set_lazy_soft_timer#

This command can be used to start a software timer with some slack. Slack parameter allows stack to optimize wake ups and save power. Timer event is triggered between time and time + slack. See also description of hardware_set_soft_timer command.

Command#

The smallest interval value supported is 328 which is around 10 milliseconds, any parameters between 0 and 328 will be rounded up to 328. The maximum value is 2147483647, which corresponds to about 18.2 hours.

If time is 0, removes the scheduled timer with the same handle.
8-11 | uint32 | slack | Slack time in hardware clock ticks
12 | uint8 | handle | Timer handle to use, is returned in timeout event
13 | uint8 | single_shot | Timer mode. Values:

• 0: false (timer is repeating)

• 1: true (timer runs only once)

Response#

API#

/* Function */  
struct gecko_msg_hardware_set_lazy_soft_timer_rsp_t *gecko_cmd_hardware_set_lazy_soft_timer(uint32 time, uint32 slack, uint8 handle, uint8 single_shot);  
  
/* Response id */  
gecko_rsp_hardware_set_lazy_soft_timer_id  
  
/* Response structure */  
struct gecko_msg_hardware_set_lazy_soft_timer_rsp_t  
{  
  uint16 result  
}  

Events generated#

hardware_set_soft_timer#

This command can be used to start a software timer. Multiple concurrent timers can be running simultaneously. There are 256 unique timer IDs available. The maximum number of concurrent timers is configurable at device initialization. Up to 16 concurrent timers can be configured. The default configuration is 4. As the RAM for storing timer data is pre-allocated at initialization, an application should not configure the amount more than it needs for minimizing RAM usage.

Command#

The smallest interval value supported is 328 which is around 10 milliseconds, any parameters between 0 and 328 will be rounded up to 328. The maximum value is 2147483647, which corresponds to about 18.2 hours.

If time is 0, removes the scheduled timer with the same handle.
8 | uint8 | handle | Timer handle to use, is returned in timeout event
9 | uint8 | single_shot | Timer mode. Values:

• 0: false (timer is repeating)

• 1: true (timer runs only once)

Response#

API#

/* Function */  
struct gecko_msg_hardware_set_soft_timer_rsp_t *gecko_cmd_hardware_set_soft_timer(uint32 time, uint8 handle, uint8 single_shot);  
  
/* Response id */  
gecko_rsp_hardware_set_soft_timer_id  
  
/* Response structure */  
struct gecko_msg_hardware_set_soft_timer_rsp_t  
{  
  uint16 result  
}  

Events generated#

hardware events#

hardware_soft_timer#

This event indicates that the soft timer has lapsed.

Event#

API#

/* event id*/  
gecko_evt_hardware_soft_timer_id  
  
/* event structure*/  
struct gecko_msg_hardware_soft_timer_evt_t  
{  
  uint8 handle  
}