Trade-offs and warnings
Consult the linked header for this operation’s ownership, lifetime and failure behavior.
EPOK RUNTIME
Method · 1 overload
Declarations are extracted from the pinned headers. Examples and general guidance are generated sketches, not verified complete programs; consult the linked source and guides for the actual contract.
Installs (if needed) and starts an embedded program.
PocketError install_and_launch(const PocketApp& app, uint32_t parameter = 0, unsigned port = 0)Installs (if needed) and starts an embedded program.
| Parameter | Type | Meaning |
|---|---|---|
app | const PocketApp & | Not documented; consult the linked header. |
parameter | uint32_t | Not documented; consult the linked header. |
port | unsigned int | Not documented; consult the linked header. |
Returns: PocketError. Consult the linked header for its meaning.
#include "pocketstation.hpp"
// Assume these named values have been initialized with valid data:
// const PocketApp & app
// uint32_t parameter
// unsigned int port
epok::PocketStationService& object = /* obtain a valid instance */;
auto result = object.install_and_launch(app, parameter, port);Consult the linked header for this operation’s ownership, lifetime and failure behavior.
Declared in runtime/pocketstation.hpp:505
callCalls link function `function` of the running program.MethodconnectedPerforms `connected` as part of the pocketstation module.MethodfindFinds a file by name; `*block` receives its first block.MethodinstallCopies an embedded program to the card (replacing an older copy) and returns its first block.MethodlaunchStarts the program whose first block is `block` (0 = start-up screen).MethodprobeTrue when a PocketStation (not a plain memory card) is in the slot.Methodread_directoryReads the 16 directory frames (block 0) in one batch.Methodread_memoryKernel memory access (RAM, I/O, flash), up to 128 bytes.Methodread_sectorReads sector as part of the pocketstation module.MethodreceivePocket Lua link: the message published with `link.send(n)`; size 0 when none.MethodsendPocket Lua link: a message for `link.received()` / `link.byte(i)`.Methodset_ledThe red LED (through the PocketStation's I/O port).Method