com.iotize.jvm

Interface MainClass

public interface MainClass

This interface describes the mandatory/default methods that must / can be implemented in the main Java class.

Method Summary

Modifier and Type	Method and Description
void	onCheck(int id) Method called each time a TapNLinkVar (and derived classes) are updated.
default void	onEvent(java.lang.Object event) Method called each time a JVM event occurs.
default void	onException(int errcode, int par1, int par2) onException is called by the JVM whenever a running error is encountered.
static void	startTimer(int period) Starts a timer that will call the onEvent method each time a period has passed.
static void	stopTimer() Stops the timer set in the startTimer(int) method, if any.

Method Detail

onException

default void onException(int errcode,
                         int par1,
                         int par2)

onException is called by the JVM whenever a running error is encountered.

Parameters:

errcode - the error code of the exception. Error codes are described in the TapNLinkException class.

par1 - the program counter of the last executed instruction. Can be used for debugging purpose with Ride7.

par2 - the stack pointer of the last executed instruction Can be used for debugging purpose with Ride7.

See Also:

TapNLinkException, Debug JVM with Ride7

onCheck

void onCheck(int id)

Method called each time a TapNLinkVar (and derived classes) are updated.

Parameters:

id - the id of the updated variable

onEvent

default void onEvent(java.lang.Object event)

Method called each time a JVM event occurs. Event objects can be either:

• MqttInput: A MQTT message received on a susbscribed topic
• Pin: An IRQ raised on configured Pin
• MainClass: A timer event

Implementation example:

  public void onEvent(Object event) {
      if (event instance of MainClass) {
          onTimer();
      } else if (event instance of Pin) {
          onInterrupt((Pin) event);
      } else if (event instance of MqttInput) {
          onMqttMessage((MqttInput) event);
      }
  }

Parameters:

event -

See Also:

MqttInput, Pin

startTimer

static void startTimer(int period)

Starts a timer that will call the onEvent method each time a period has passed. Only one timer can be set at the same time.

Parameters:

period - period of the timer, in milliseconds

See Also:

#onEvent}

stopTimer

static void stopTimer()

Stops the timer set in the startTimer(int) method, if any.