Train Thing Development Documentation

serial

socket

sys

threading

 
class Monitor

This class is used to blink each of the 4 traffic monitoring
LEDs in relationship to the traffic Out from the laptop (Orange)
and Back to the laptop (Blue).
Output to the Base Station (Orange) and Back from the
Base Station (Blue).
 
Should be called only be Traffic
 

Methods defined here:

• __init__(self)
• Set up the  IOPi HAT+ pins for traffic monitoring LEDs
  IOPi HAT Bus 2 using pins 9 - 12

• blink_it(self, LED, num)
• Common routine to blink a LED
  number of blinks = 1 + num // DIV (initager divide)
  Arg:
  LED - a variable equal to the output pin on bus2
  num - number of bytes in the message i.e. len(message)

• from_BS(self, num)
• Creates a thread to
  Blink the BLUE LED for traffic from the Base Station
  Arg: length of message received from the Base Station

• from_LT(self, num)
• Creates a thread to
  Blink the ORANGE LED for traffic from the Laptop
  Arg: length of the message received i.e. len(message)

• to_BS(self, num)
• Creates a thread to
  Blink the ORANGE LED for traffic to the Base Station
  Arg: length of message sent to the Base Station

• to_LT(self, num)
• Creates a thread to
  Blink the BLUE LED for traffic to the Laptop
  Arg: length of message sent to the laptop

Data and other attributes defined here:

• DIV = 30

 
class Traffic

This class handles all TrainThing communication wirelessly
to/from the Laptop and wired to/from the Arduino.
read_LT() returns commands from the Laptop NOT intended
for the Arduino Base Station.
Calls to write_LT() are used to return status from the Raspberry Pi
to the Laptop.
 

Methods defined here:

• __init__(self)
• Defines and starts the WiFi socket to the Laptop
  and establishes a connection.
   
  Defines a serial link through a USB port to the Arduino Base Station.

• read_BS(self)
• Reads a string from the Arduino
  and passes it to write_LT()

• read_LT(self)
• Reads a string from the laptop ending with ">"
  If the command is intended for the Arduino
  it is passed directly to write_BS() and a "" is returned
  If the command is intended for the Raspberry Pi only
  it is returned
  If the command is intended for both passed to write_BS()
  and returned.

• stop_servers(self)

• write_BS(self, message)
• Writes to the Arduino the string passed
  as a parameter from read_LT()
  then calls read_BS() and waits for a reply.
  Arg: string to be sent

• write_LT(self, message)
• Writes to the Laptop the string passed as a parameter.
  Arg: string to be sent

Data and other attributes defined here:

• BAUDRATE = 115200

• DEVICE_NAME = '/dev/ttyACM0'

• FORMAT = 'utf-8'

• PORT = 2560

• SERVER_IP = '192.168.1.128'

• clientsocket = None

• ser = None