RICM4 2017 2018 - Nucleo/ SRS

The document provides a template of the Software Requirements Specification (SRS). It is inspired of the IEEE/ANSI 830-1998 Standard.

Read first:
 * http://www.cs.st-andrews.ac.uk/~ifs/Books/SE9/Presentations/PPTX/Ch4.pptx
 * http://en.wikipedia.org/wiki/Software_requirements_specification
 * IEEE Recommended Practice for Software Requirements Specifications IEEE Std 830-1998

=1.  Introduction=

1.1 Purpose of the requirements document
This Software Requirements Specification document explains the ins and outs of the Nucleo project, along with the requirements and specifications.

1.2 Scope of the product
This product is dedicated to whoever uses a Nucleo card and needs or want to remotely reprogram it.

As it is redistributable, this product may be used for personal or industrial use.

1.3 Definitions, acronyms and abbreviations
Nucleo : for this project, a STM32F446 Nucleo-64 card will be used

Arduino/Olimexino : for this project, an olimexino-328 will be used

Wifi : for this project, an esp8266ex chipset will be used

SRS : Software Requirements Specification

1.4 References
https://os.mbed.com

https://elmicro.com/files/olimex/olimexino-328-schematic.pdf

http://www.st.com/content/ccc/resource/technical/document/application_note/b9/9b/16/3a/12/1e/40/0c/CD00167594.pdf/files/CD00167594.pdf/jcr:content/translations/en.CD00167594.pdf

1.5 Overview of the remainder of the document
The remainder of this SRS clarifies the requirements of the Nucleo project.

=2.  General description=

2.1 Product perspective
Redistributable software allowing to dynamically remotely reprogram a Nucleo card through Wifi with the use of an Arduino card.

2.2 Product functions
Remotely reprogram a Nucleo card through Wifi with the use of an Arduino card

2.3 User characteristics
Both personal and industrial use.

2.4 General constraints
- Security (not anyone should reprogram the card)

- Reliability (what happens if the connexion stops while sending the new software ?)

2.5 Assumptions and dependencies
Use of an olimexino-328 and a ST32F446 Nucleo

=3.Specific requirements, covering functional, non-functional and interface requirements=
 * document external interfaces,
 * describe system functionality and performance
 * specify logical database requirements,
 * design constraints,
 * emergent system properties and quality characteristics.

3.1 Requirement | Reprogramming
Function: Reprogramming the Nucleo via Wifi

Description: Sending a compiled program to the Nucleo

Inputs: Binary file (compiled program)

Source: User

Outputs: None

Destination: The Nucleo card

Action: Reprograms the Nucleo card

Natural language sentences (with MUST, MAY, SHALL)
 * The file sent MUST be a compiled program
 * The Nucleo card SHALL reprogram itself with the file (implying it has the proper software installed)
 * In case of malfunction, reset or shutdown during the transfer of the file, the Nucleo card MUST ignore the operation

Graphical Notations : UML Sequence w/o collaboration diagrams, Process maps, Task Analysis (HTA, CTT) Mathematical Notations Tabular notations for several (condition --> action) tuples

Non functional requirements:

Pre-condition:

Post-condition:

Side-effects:

=4. Product evolution=

=5. Appendices= =6. Index=