ConfigurableFirmata module functions

Question

I'm writing custom modules for ConfigurableFirmata, I see libraries are using callbacks such as:

void Class::handleCapability(byte pin);
boolean Class::handlePinMode(byte pin, int mode);
...
boolean Class::handleSysex(byte command, byte argc, byte *argv);

Question is, I don't quite get why some of functions are boolean and when to return TRUE or FALSE (and what happens when you return TRUE or FALSE?).

score 2 · Accepted Answer · answered Aug 27 '16 at 14:14

2

Answer lays in FirmataExt.cpp. If extension returns FALSE, it just sends a string to firmata, for debugging purposes.

answered Aug 27 '16 at 14:14

Nika

1,864
3
23
44

score 0 · Answer 2 · answered Sep 01 '16 at 17:25

boolean FirmataExt::handleSysex(byte command, byte argc, byte* argv)
{
  switch (command) {

    case PIN_STATE_QUERY:
      if (argc > 0) {
        byte pin = argv[0];
        if (pin < TOTAL_PINS) {
          //...
          return true;
        }
      }
      break;
    case CAPABILITY_QUERY:
      //...
      return true;
    default:
      for (byte i = 0; i < numFeatures; i++) {
        if (features[i]->handleSysex(command, argc, argv)) {
          return true;
        }
      }
      break;
  }
  return false;
}

This function return true, if command is valid.

ConfigurableFirmata module functions

2 Answers2