Skip to content

[rules score] enable linking of multiple guidewords #296

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
hoe-jo wants to merge 1 commit into
base: main
Choose a base branch
from
+8 −29
Open

[rules score] enable linking of multiple guidewords #296

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions bazel/rules/rules_score/docs/user_guide/dependability_analysis.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ The failure modes to consider are defined by the SCORE process:

> [FMEA Fault Models — Process Description](https://eclipse-score.github.io/process_description/main/process_areas/safety_analysis/guidance/fault_models_guideline.html#id1)

The fault models cover three categories: **messages** (send/receive behaviour), **time constraints** (too early / too late), and **execution** (wrong result, loss, delay, corruption, non-determinism). The `GuideWord` enum in the `ScoreReq` model maps each category to a structured label used in the `FailureMode` records.
The fault models cover three categories: **messages** (send/receive behaviour), **time constraints** (too early / too late), and **execution** (wrong result, loss, delay, corruption, non-determinism). The `guidewords` enum in the `ScoreReq` model maps each category to a structured label used in the `FailureMode` records.

The description below covers the FMEA-based **safety** analysis for a software module.

Expand Down Expand Up @@ -78,7 +78,7 @@ package MySeooc
import ScoreReq

ScoreReq.FailureMode FM_001 {
guideword = ScoreReq.GuideWord.LossOfFunction
guidewords = [ScoreReq.guidewords.LossOfFunction]
description = "Key-value store returns stale data after power loss"
failureeffect = "Incorrect system state at startup"
safety = ScoreReq.Asil.B
Expand Down
2 changes: 1 addition & 1 deletion bazel/rules/rules_score/examples/seooc/safety_analysis/sample_fmea_failure_modes.trlc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ package SampleLibrary
import ScoreReq

ScoreReq.FailureMode SampleFailureMode{
guideword = ScoreReq.GuideWord.LossOfFunction
guidewords = [ScoreReq.guidewords.LossOfFunction]
description = "SampleFailureMode takes over the world"
failureeffect = "The world as we know it will end"
version = 1
Expand Down
31 changes: 5 additions & 26 deletions bazel/rules/rules_score/trlc/config/score_requirements_model.rsl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ enum Status {
///////////////////////////////

abstract type Requirement "Base type for all S-CORE requirements." {
description "The normative requirement text. Must express an obligation (shall/should)."
description "Detailed description of this element."
Markup_String
version "Monotonically increasing version counter. Increment on every content change."
Integer
Expand Down Expand Up @@ -93,7 +93,7 @@ tuple CompReqId {
// Safety Analyses
///////////////////////////////

enum GuideWord "HAZOP-style guide words used to categorize failure mode." {
enum guidewords "HAZOP-style guide words used to categorize failure mode." {

// -------------------------------------------------------------------------
// Message fault models (MF_01_xx)
Expand Down Expand Up @@ -145,15 +145,13 @@ enum GuideWord "HAZOP-style guide words used to categorize failure mode." {

}

type FailureMode "A potential failure of a system function, described using a HAZOP guide word." extends ScoreReq.RequirementSafety {
guideword "HAZOP guide word classifying the nature of this failure."
GuideWord
type FailureMode "A potential failure of a system function, described using one or more HAZOP guide words." extends ScoreReq.RequirementSafety {
guidewords "One or more HAZOP guide words classifying the nature of this failure."
guidewords[1 .. *]
failureeffect "Description of the consequence of this failure mode on the system or its users."
String
rationale "Explanation of why this failure mode is considered relevant."
optional String
potentialcause "Description of the root cause or triggering condition for this failure mode."
optional String
interface "The system interface or signal that is affected by this failure mode."
optional String
}
Expand Down Expand Up @@ -181,22 +179,3 @@ type AoU "Assumption of Use — a safety-relevant condition that a caller must f

// abstract type StdReq extends Requirement {
// }


///////////////////////////////
// Checks
///////////////////////////////

checks Requirement {

not matches(description, "(shall|should)"),
warning "The description must include (shall|should)",
description

}

checks AssumedSystemReq {

rationale != null implies len(rationale) >= 5, "rationale too short"

}
Loading