Component : Tunnel

Description

This component is provided by the linked card.

This card is similar to the network card's component, but as it is only point-to-point, no ports can be configured, and the connection is always open.

Component name: tunnel.

Methods

• send(data...) Sends the specified data to the card this one is linked to.
• maxPacketSize():number Gets the maximum packet size (config setting).
• getChannel():string Gets the tunnel address of the link card. This is also available in linkChannel using an inventory controller and getting the stack from an inventory slot.
• getWakeMessage():string Gets the current wake-up message. When the network card detects the wake message (a string in the first argument of a network packet), on any port and the machine is off, the machine is started. This is the same functionality also provided by robots, cases, servers, drones, and tablets.
• setWakeMessage(message: string, [fuzzy: boolean]):string Sets the wake-up message to the specified string. The message matching can be fuzzy (default is false). A fuzzy match ignores additional trailing arguments in the network packet.

Events

• modem_message(receiverAddress: string, senderAddress: string, port: number, distance: number, ...)

  This signal is queued by network cards (including wireless ones) when they receive a message on an open port.

  • receiverAddress is the address of the network card that received the message.

  • senderAddress is the address from where the message was sent.

  • port is the port on which the message was received.

  • distance is the distance only set when receiving wireless network messages.

  • All further parameters are user defined and correspond to what the sender specified in modem.send() or modem.broadcast() as the message's payload.