Strategies

A Strategy its a class containing a set of functions able to physically communicate data through the medium used, abstracting the physical layer from PJON procedure and codebase.

boolean can_start(uint8_t input_pin, uint8_t output_pin)

Should Return true if the medium is free for use and false if the medium is in use by some other device.

void send_byte(uint8_t input_pin, uint8_t output_pin)

Sends a byte on a pin

uint16_t receive_byte(uint8_t input_pin, uint8_t output_pin)

Receives a byte from a pin

void send_response(uint8_t response, uint8_t input_pin, uint8_t output_pin)

Send a response to the packet’s transmitter

uint16_t receive_response(uint8_t input_pin, uint8_t output_pin)

Receives a response from the packet’s receiver

You can define your own set of functions to use PJON with your personal strategy on the medium you prefer. As can see two pins are passed to the methods, enabling twisted pair, serial or radio transceiver physical layer strategies. If you need other functions, variables or constants, those can be defined in your personal Strategy class. Other communication protocols could be used inside those functions to transmit data.

// Simple Serial physical layer example
static inline __attribute__((always_inline))
void send_byte(uint8_t b, uint8_t input_pin, uint8_t output_pin) {
  Serial.print(b);
}

####How to define a new strategy To define your new strategy you have only to create a new folder named for example YourStrategyName in strategies directory and write the necessary file YourStrategyName.h:

class YourStrategyName {
  public:
    boolean can_start() { ... };
    uint16_t receive_byte(uint8_t input_pin, uint8_t output_pin) { ... };
    void send_byte(uint8_t b, uint8_t input_pin, uint8_t output_pin) { ... };
    uint16_t receive_response(uint8_t input_pin, uint8_t output_pin) { ... };
    void send_response(uint8_t response, input_pin, uint8_t output_pin) { ... };
}

Simply add your code in the functions declaration shown above and instantiate PJON using the strategy type you have created: PJON<YourStrategyName> bus();.