https://github.com/sigtot/sanntid

Elevator Project for TTK4145 Real-time Programming
https://github.com/sigtot/sanntid

concurrency distributed-systems elevators golang network

Last synced: 5 months ago
JSON representation

Elevator Project for TTK4145 Real-time Programming

• Host: GitHub
• URL: https://github.com/sigtot/sanntid
• Owner: sigtot
• License: mit
• Created: 2019-01-16T09:06:35.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2020-05-09T07:28:47.000Z (about 6 years ago)
• Last Synced: 2024-06-20T06:22:03.544Z (about 2 years ago)
• Topics: concurrency, distributed-systems, elevators, golang, network
• Language: Go
• Size: 3.44 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Multi-elevator network project

[![Go Report Card](https://goreportcard.com/badge/github.com/sigtot/sanntid)](https://goreportcard.com/report/github.com/sigtot/sanntid)

[![GoDoc](https://godoc.org/github.com/sigtot/sanntid?status.svg)](https://godoc.org/github.com/sigtot/sanntid)

> Elevator Project for TTK4145 Real-time Programming

This repo contains implementation of a system for connecting n elevators and n elevator panels installed on n computers over a network connection in such a way that orders are distributed evenly and efficiently to the elevators. A large effort has been put into fault tolerance due to the requirement that no order is lost after it has been accepted. This requirement applies even in the case of network failure, power outages, program crashes or situations with severe packet loss. 

![simulator](/elev.gif)

## Design

The design for this system is based on the common publish/subscribe pattern which is heavily used distributed systems.

In hte figure below, the modules of the system are shown, with dashed, labeled arrows correspond to a module being

either a subscriber or a publisher to a certain topic.

Solid arrows however, signify more direct forms of communication between modules (channels, function calls, etc.).

![module_overview](https://i.imgur.com/q8aMH2N.png)

## Imported packages

### elevio package

The elevator driver used in the project was provided by the course instructors.

As we were not pleased with some of the implementation done in the driver, the repository was forked, 

and made some changes to. The original elevator driver can be found [here](https://github.com/TTK4145/driver-go).

### bbolt

Bolt is the database used by the order watchers to store not yet delivered calls.

The package used in this project is the bbolt package by etcd, which can be found [here](https://github.com/etcd-io/bbolt)

### logrus

Logging events in the system is done with the logrus package.

The package can be found [here](https://github.com/Sirupsen/logrus)

### Go standard library

A fair few of the packages from the Go standard library are used in this project.

For specific packages see the imports in the files. These packages are used for a lot of different tasks,

from io and os related, to encoding and compressing. For the network related parts of the project the net package 

and net/http package are used.