Skip to content
php-baremetal REGISTRY
Publish a package

php-baremetal/ext-sys

bm-ext MIT

System functions: delay, uptime, restart, deep sleep and wake cause, reset reason, chip info, memory.

ext-sys · PHP API

Timing

sys_delay() and delay() suspend the PHP task; sys_uptime_ms() and sys_micros() read the time since boot, truncated to 32-bit PHP integers.

sys_delay() and delay()

sys_delay(int $ms): void

Public method. Returns void.

delay(int $ms): void

Public method. Returns void.

Parameters

$ms int required

Milliseconds to wait. Negative values count as 0.

Suspends the PHP task for $ms milliseconds (vTaskDelay on ESP32). Other tasks run meanwhile and the watchdog stays fed; it is never a busy-wait. The firmware's scheduler tick is 1 ms, so the wait has 1 ms resolution. delay() is the same function under the Arduino-style name; it is not deprecated.

PHP's own usleep() and sleep() also work. sys_delay() is the one that names milliseconds directly.

With the power-save option on, a delay is idle time in which the board can enter light sleep by itself.

sys_uptime_ms()

sys_uptime_ms(): int

Public method. Returns int.

Milliseconds since boot, from the ESP32 high-resolution timer (esp_timer_get_time()). The value is truncated to a 32-bit PHP integer, so it turns negative after 2^31 ms (about 24.8 days) and keeps counting from there.

sys_micros()

sys_micros(): int

Public method. Returns int.

Microseconds since boot, from the same timer. It turns negative after 2^31 µs (about 35.8 minutes): use it for short intervals only, and always through a wrap-safe difference.

Both clocks restart from 0 after sys_restart() and after a deep sleep, since both boot the board again. A sys_light_sleep() does not reset them: the time asleep is counted.

Example

php time a block
<?php
$t0 = sys_micros();
$hash = md5(str_repeat('x', 4096));
$dt = sys_micros() - $t0;
if ($dt < 0) {
    $dt += 4294967296;   // crossed the wrap: add 2^32
}
printf("md5 of 4 KiB: %d us\n", $dt);

Related