ece303

This repository contains teaching material for ECE303. This API is subject to change and expansion!

channelsimulation.py contains a simple API for a mock connection over an unreliable channel. sender.py and receiver.py are mock sender and receivers that use this unreliable channel. These are examples that do not properly handle the bit errors in the channel.

The channel simulator will simulate random bit errors, packet loss, and packet duplication.

Assignment

The goal of this project is to develop a transport layer protocol that can successfully and quickly transmit bits over this unreliable channel. The protocol will be implemented in your versions sender.py and receiver.py. Your implementations should inherit from the Bogo{Receiver,Sender} classes in from this repository and override the receive() and send() methods.

Requirements

The submitted sender and receiver implementations must be able to:

• Sucessfully transfer data over the noisy channel
• Be TCP-fair (multiple sender-receiver pairs should evenly share bandwidth, on average over the long term)

Grading

The grading policy for this project is as follows:

• Protocol design specifications (20%): a written report providing an overview of your specific protocol and design choices. A discussion of your protocol's features, tradeoffs and assumptions.
• Implementation documentation (10%): implementation specific documentation including libraries used and code annotations.
• Minimum functionality (60%): protocol must be able to transmit and acknowledge receipt of data packets through the unreliable channel.
• Competitive performance (10%): protocol performance will be determined relative to a reference implementation and to the class.

Due Date

This project will be due Thursday, May 3rd before noon. This is the day of the final exam. Please submit files in an archive via email, or provide a link to a public repository.

Test Run

The easiest way to run the BogoSender and BogoReceiver is by calling python and passing the .py files.

$ python2 receiver.py > receiver.log & $ python2 sender.py > sender.log &

The sender will complete and stop after the timeout, the receiver will crash. The output will be written to receiver.log and sender.log as indicated. The files may also be run in an IDE such a PyCharm. To do so, right-click anywhere in the open file and select "run" or click the green arrow next to if __name__ == "__main__":.

test.py has a short main function which currently runs the corrupt() function. You may modify it to play around with the API.