Introduction and goals

WordClock is a hobby project, aiming to create a nice looking time keeping art work.

The secondary goal is to have a project to experiment with various technologies like Rust, laser cutting, 3d printing, and various engineering skills like software architecture, software requirements, Test-Driven Development and documentation.

This document is not limited to software architecture, but considers all the work realized by the Embedded engineer, include PCB design.

Requirements overview

Essential features:

  • Display current time, using your favorite Swiss-German dialect.
  • Set system time, manually or automatically.
  • Keep time accurately.
  • Disable display during the night, if wanted.

Quality goals

IDQualityMotivation
QG1ReliabilityThe system shall function reliably under any circumstances.
QG2AutonomousThe system shall provide long up-time without human intervention.
QG3TestabilityThe architecture should allow easy testing of all main building blocks.

Stakeholder

StakeholderGoal, Intentions
OwnerWant a nice time keeping device, that display the time in her favorite Swiss-German dialect.
Embedded engineerDevelop the electronic hardware and software that make the WordClock does its things; Learn and apply new software development skills.
Wood engineerManufacture the WordClock physical parts; Provides feedbacks and constraints on the WordClock hardware and software.

Use case

Developer:

  1. Release new version of the firmware.
  2. Install the firmware on the system.
  3. Address User reported issue.

User:

  1. Read time from system.
  2. Configure the time of the system.
  3. Configure the dialect of the system.
  4. Configure Wi-Fi setup for automatic time setting.
  5. Configure Night time, where the clock is not displaying the time.
  6. Report issue to developer.
  7. Update to latest released version of the firmware, without the need of advanced technical knowledge.

extra:

  • Bluetooth configuration? not yet, but can be an upgrade.
  • Chose color of the time? yes!