Skip to content

Tablet Wireless Networks

Wireless Lua cartridges can tether to omni power transmitters on the data network, letting scripts connect as if the tablet were wired in.

Listing Transmitters

lua
local transmitters = ss.tablet.wireless.list()
for i, t in ipairs(transmitters) do
    print(i, t.name, t.id, t.network_id, t.distance .. "m")
end

Connecting

lua
-- Connect by transmitter id (or network_id), with mesh enabled
local ok, err = ss.tablet.wireless.connect(transmitters[1].id, true)
if not ok then
    print("connect failed:", err)
end

Status

lua
local status = ss.tablet.wireless.status()
print("connected:", status.connected, "in range:", status.in_range)

Disconnecting

lua
ss.tablet.wireless.disconnect()

API Reference

FunctionReturnsDescription
ss.tablet.wireless.list()table[]List available omni transmitters in range
ss.tablet.wireless.connect(id, mesh?)ok, errConnect to a transmitter
ss.tablet.wireless.status()tableQuery connection status
ss.tablet.wireless.disconnect()Disconnect from current network

Transmitter Entry Fields

FieldTypeDescription
namestringTransmitter display name
idnumberTransmitter ReferenceId
network_idnumberData network ID
distancenumberDistance in meters

Status Fields

FieldTypeDescription
connectedbooleanCurrently connected
in_rangebooleanTransmitter is in range
transmitter_idnumberConnected transmitter ID
network_idnumberConnected network ID

⚠️ This documentation was AI-generated and may contain inaccuracies. Please submit pull requests with corrections as needed.