HwTqArbn_PeerReviewChecklist

Overview

Summary Sheet
Davinci Files
Source Code
MDD
QAC
Integration Manual

Sheet 1: Summary Sheet

Rev 6.0

28-Oct-14

Peer Review Summary Sheet

Component Name:

kzshz2: Intended Use: Identify which component is being reviewed. This should be the Module Short Name from Synergy Rationale: Required for traceability. It will help to ensure this form is not attaced to the the wrong change request. ES228A_HwTqArbn_Impl

Component Revision:

kzshz2: Intended Use: Identify which Synergy revision of this component is being reviewed Rationale: Required for traceability. It will help to ensure this form is not attaced to the the wrong change request. 1.0.0

Change Owner:

kzshz2: Intended Use: Identify the developer who made the change(s) Rationale: A change request may have more than one resolver, this will help identify who made what change. Change owner identification may be required by indusrty standards. Rijvi Ahmed

Change Request ID:

EA4#431

kzshz2: Intended Use: Intended to identify at a high level to the reviewers which areas of the component have been changed. Rationale: This will be good information to know when ensuring appropriate reviews have been completed. Modified File Types:

kzshz2: Intended Use: Identify who where the reviewers, what they reviewed, and if the reviewed changes have been approved to release the code for testing. Comments here should be at a highlevel, the specific comments should be present on the specific review form sheet. Rationale: Since this Form will be attached to the Change Request it will confirm the approval and provides feedback in case of audits. ADD DR Level Move reviewer and approval to individual checklist form Review Checklist Summary:

Reviewed:

MDD

Source Code

Data Dictionary

QAC

Integration Manual

Davinci Files

Comments:

General Guidelines:
- The reviews shall be performed over the portions of the component that were modified as a result of the Change Request. (Note: If this peer review form was not
completed for pervious versions of this component, the Change Owner should review the entire component and complete the checklist in its entirety prior and check
the form into Syngery. This may be done prior to reviewing the modifications for this Change Result)
- The Change Owner shall responsible for completing the entire checklist (Pre and Group review items) prior holding the initial group review.
- New components should include FDD Owner and Intergator as apart of the Group Review Board (Source Code, Integration Manual, and Davinci Files)
- Select "Yes" and add "N/A" to the comments for checklist items that are not applicable for this change

Sheet 2: Davinci Files

Rev 6.0

28-Oct-14

Peer Review Meeting Log (Davinci Review)

Quality Check Items:

Yes

Rationale is required for all answers of No

Pre-review checklist for change owners

DCF: Latest StdDef imported

Comments:

DCF: Only StdDef Port types are used (if not

Comments:

add justification)

DCF: All unused definitions removed

Comments:

N/A for EA4 component

*Cfg.arxml.TT: Verfied Davinci Configurator imported the

Comments:

N/A

change correctly

kzshz2: Either a generic sandbox or a baselined integration project can be used to verify

*Cfg.h.TT: Verfied Davinci Configurator generates

Comments:

N/A

the configuration header(s) file correctly

kzshz2: Either a generic sandbox or a baselined integration project can be used to verify

Group-review for review board

All changed files have been compared against previous

Comments:

N/A. Initial version

versions (If available)

kzshz2: Intended Use: Identify if previous version was compared and only the expected change(s) was present. This is for text files only, not binary or GUIs Rationale: This is helpful in identifying unapproved (intended or mistaken) changes.

DCF:Automated validation check is performed

Comments:

DCF: Inputs/Outputs match names from requirements

Comments:

See note

DCF: Inputs/Outputs configuration paremeters

Comments:

reviewed

kzshz2: Intended Use: All changed inputs have been reviewed to ensure configuration parameters (i.e. Buffered vs Direct read/writes) are correct. This includes signal grouping when signal consistency is required by the FDD

DCF: Sender/Reciever Ports type and default values

Comments:

See note

match their corresponding ports (internal/external)

kzshz2: Intended Use: Identify if all the Sender/Reciever ports are compatibale with there connecting ports. Rationale: This will help to avoid errors when this component is being integrated into a project.

DCF: Ports prototype and default values

Comments:

match their corresponding ports (internal/external)

kzshz2: Intended Use: Identify if all the Server/Client ports are compatibale with there connecting ports. Rationale: This will help to avoid errors when this component is being integrated into a project.

DCF: Server runnable variables are using direct

Comments:

N/A

read/writes

DCF: Runnable calling frequencies match requirements

Comments:

General Notes / Comments:

Some signals name, data type, init value and range need to be updated in the FDD. Email has been sent to FDD owner for the changes. Check with FDD when updated. Done

LN: Intended Use: Identify who were the reviewers and if the reviewed changes have been approved. Rationale: Since this Form will be attached to the Change Request it will confirm the approval and provides feedback in case of audits. KMC: Group Review Level removed in Rev 4.0 since the design review is not checked in until approved, so it would always be DR4. Review Board:

Change Owner:

Rijvi Ahmed

Review Date :

05/20/15

Lead Peer Reviewer:

Kathleen Creager

Approved by Reviewer(s):

Yes

Other Reviewer(s):

Sheet 3: Source Code

Rev 6.0

28-Oct-14

Peer Review Meeting Log (Source Code Review)

Source File Name:

kzshz2: Intended Use: Identify which .asm, .c, or .h file is being reviewed Rationale: Required for traceability. It will help to ensure this sheet is not attached to the wrong design review form. HwTqArbn.c

Source File Revision:

kzshz2: Intended Use: Identify which version of the source file is being review. Rationale: Required for traceability between source code and review. Auditors will likely require this. 1

Module Design Document Name:

kzshz2: Intended Use: Identify which version of the MDD this source file was written against. Rationale: Needed for traceability between source code and MDD HwTqArbn_MDD.doc

MDD Revision:

kzshz2: Intended Use: Identify which version of the MDD this source file was written against. Rationale: Needed for traceability between source code and MDD 1

Data Dictionary Revision:

kzshz2: Intended Use: Identify which version of the Data Dictionary was referenced for ranges during the source file review. Rationale: Needed for traceability between source code and DD N/A

FDD/SER/CMS

and Revision:

nz63rn: Intended Use: Identify which version of which FDD/CMS/SER this source file was written against. Rationale: Needed for traceability between source code and FDD/CMS/SER ES228A_HwTqArbn_Design_1.1.0

Quality Check Items:

Yes

Rationale is required for all answers of No

Pre-review checklist for change owners

Software Naming Convention V1.2 followed:

for variable names

Comments:

See note

for constant names

Comments:

see note

for function names

Comments:

for other names (component, memory

Comments:

mapping handles, typedefs, etc.)

All buffered outputs written in every path, i.e. no

Comments:

possibility of an uninitialized value being written

Group-review Checklist (review board)

Synergy version matches change history

kzshz2: Intended Use: Indicate that the the versioning was confirmed by the peer reviewer(s). Rationale: There have been many occassions where versions were not updated in files and as a result Unit Test were referencing wrong versions. This often time leads to the need to re-run of batch tests.

Comments:

and Version Control version in file comment block

Change log contains detailed description of changes

Comments:

and CR number

Code accurately implements FDD (Document or Model)

Comments:

See notes

No Compiler Errors or Warnings verified

KMC: Intended Use: To confirm no compiler errors or warnings exist for the code under review (warnings from contract header files may be ignored). Rationale: This is needed to ensure there will be no errors discovered at the time of integration. A Sandox project should be used; QAC can find compiler errors but not warnings.

Comments:

FDD test points exist as display variables: declared

Comments:

static volatile, written once and never used, names

match the FDD

Software Design and Coding Standards V2.0 followed:

Code comments are clear, correct, and adequate

Comments:

and have been updated for the change: [N40] and

all other rules in the same section as rule [N40],

plus [N75], [N12], [N23], [N33], [N37], [N38],

[N48], [N54], [N77], [N79], [N72]

Source file (.c and .h) comment blocks are per

Comments:

standards and contain correct information: [N41], [N42]

Function comment blocks are per standards and

Comments:

contain correct information: [N43]

Code formatting (indentation, placement of

Comments:

braces, etc.) is per standards: [N5], [N55], [N56],

[N57], [N58], [N59]

Embedded constants used per standards; no

Comments:

"magic numbers": [N12]

One magic number is used for averaging which is acceptable.

All variables and constants defined at module

Comments:

level are included in appropriate MemMap

section: [N25] and Naming Conventions

All execution-order-dependent code can be

Comments:

recognized by the compiler: [N80]

No possibility of a non-terminating loop: [N63]

Comments:

No possibility of divide by zero: [N65]

Comments:

All integer division and modulus operations

Comments:

N/A

handle negative numbers correctly: [N76]

All typecasting and fixed point arithmetic,

Comments:

N/A

including all use of fixed point macros and

timer functions, is correct and has no possibility

of unintended overflow or underflow: [N66]

No possibility of converting a negative floating

Comments:

point value to an unsigned type: [N67]

All conversions between signed and unsigned

Comments:

N/A

types handle msb==1 as intended: [N78]

No possibility of dereferencing a null

Comments:

pointer: [N70]

Global outputs (RTE and Non-RTE) Initialized:

Comments:

[N24]

Module outputs are limited to the legal range

Comments:

defined in the FDD Data dictionary: [N53]

All code is mapped with FDD (all FDD

Comments:

subfunctions and/or model blocks identified

with code comments; all code corresponds to

some FDD subfunction and/or model block): [N40]

Struct types used for NvM have

Comments:

N/A

elements declared in decreasing order by size

and are not nested or used in arrays: [N84], [N85]

No violations of other coding standard rules

Comments:

identified during review

General Notes / Comments:

1. A list of changes for FDD has been sent to the FDD author. Verify the scr code with FDD when updated. Done

2. Define constant for 'Max stall cntr' i.e. 255. Done

Change Owner:

Rijvi Ahmed

Review Date :

05/20/15

Lead Peer Reviewer:

Kathleen Creager

Approved by Reviewer(s):

Yes

Other Reviewer(s):

Sheet 4: MDD

Rev 6.0

28-Oct-14

Peer Review Meeting Log (MDD Review)

Module Name:

kzshz2: Intended Use: Identify which file is has been reviewed Rationale: Required for traceability. It will help to ensure this sheet is not attached to the wrong design review form. HwTqArbn

Module

kzshz2: Intended Use: Identify how many source files are being reviewed and trace it to the appropriate MDD. Rationale: Required for traceability between source code and MDD

MDD Revision:

kzshz2: Intended Use: Identify which version of the MDD has been reviewed. Rationale: Required for traceability between the MDD and review. Auditors will likely require this. 1

Source File Revision:

kzshz2: Intended Use: Identify which version of the source file was this MDD written for. Rationale: Needed for traceability between source code and MDD 1

Data Dictionary Revision:

kzshz2: Intended Use: Identify which version of the Data Dictionary was referenced for ranges during the review. Rationale: Needed for traceability between source code and DD. Note: Maybe this should be moved to the Summary sheet since there is only one Data Dictionary Version for all changes N/A

Quality Check Items:

Yes

Rationale is required for all answers of No

Group-review Checklist (review board)

Synergy version matches header

Comments:

Change log contains detailed description of changes

Comments:

Changes Highlighted (for Unit Tester)

Comments:

N/A. initial version

High-level Diagrams have been reviewed (Section 2)

Comments:

All Design Exceptions and Limitations are listed

Comments:

Design rationale given for all module input and output

Comments:

N/A

data not communicated through RTE ports, per

Design and Coding Standards rules [N9] and [N10].

All other Design rationale understood and captured

Comments:

appropriately

General Notes / Comments:

Change Owner:

Rijvi Ahmed

Review Date :

05/20/15

Lead Peer Reviewer:

Kathleen Creager

Approved by Reviewer(s):

Yes

Other Reviewer(s):

Sheet 5: QAC

Rev 6.0

28-Oct-14

Peer Review Meeting Log (QAC Review)

Module Name:

kzshz2: Intended Use: Identify which .c file is being analyzed Rationale: Required for traceability. It will help to ensure this sheet is not attached to the wrong design review form. HwTqArbn

Source File Revision:

Module

Compliance Guidelines Version:

Working EA4 guideline

kzshz2: Intended Use: Identify specific changes in results (new violation present, previous violation corrected, etc.). Changes to the version of the tool or the way the results were gathered should be described here also. This should be filled out prior to the review by the change owner. Rationale: Gives reviewers an what needs to be focused on. Forces the change owner to compare with previous results to catch any differences that may otherwise go unoticed Brief Summary of Changes (In Results or Tool):

Quality Check Items:

Yes

Rationale is required for all answers of No

Pre-review
checklist for change owners

QAC version is correct and did not change (List version)

kzshz2: Intended Use: Identify which version of the QAC Subproject was used and if any of the personalities may have changed. Rationale: Will help ensure this is factored into evaluating the results

Comments:

TL100A_QACSuprt_1.1.0

Contract Folder's header files are appropriate

kzshz2: Intended Use: Identify that the contract folder contains only the information required for this component. All other variables, constants, function prototypes, etc. should be removed. Rationale: This will help avoid unit testers having to considers object not used. It will also avoid having other files required for QAC.

Comments:

Group-review Checklist (review board)

100% Compliance to the MISRA Compliance Guidelines

Comments:

With approved deviations.

Cyclomatic complexity and Static path count ok per

Creager, Kathleen: use Browse Function Metrics, STCYC and STPTH

Comments:

Design and Coding Standards rule [N47]

General Notes / Comments:

Polyspace was also run. Approved deviations are MISAR rules 19.1 and 8.10.

Deviation for MISRA rule 16.10 needs to be added in EA4 MISRA compliance document.

Polyspace code prover orange warnings for uninitialized variable, null pointer and overflow are okay because they are not the real issues. Polyspace doesn't understand RTE structure and range of variables.

Change Owner:

Rijvi Ahmed

Review Date :

05/20/15

Lead Peer Reviewer:

Kathleen Creager

Approved by Reviewer(s):

Yes

Other Reviewer(s):

Sheet 6: Integration Manual

Rev 6.0

28-Oct-14

Peer Review Meeting Log (Integration Manual Review)

Integration Manual Name:

kzshz2: Intended Use: Identify which file is being reviewed Rationale: Required for traceability. It will help to ensure this sheet is not attached to the wrong design review form. HwTqArbn_IntegrationManual.doc

Integration Manual Revision:

kzshz2: Intended Use: Identify which version of the integration manual has been reviewed. Rationale: Required for traceability between the MDD and review. Auditors will likely require this. 1

Quality Check Items:

Yes

Rationale is required for all answers of No

Group-review Checklist (review board)

Synergy version matches header

Comments:

Latest template used

Comments:

Change log contains detailed description of changes

Comments:

Changes Highlighted (for Integrator)

Comments:

N/A. initial version.

General Notes / Comments:

Change Owner:

Rijvi Ahmed

Review Date :

05/20/15

Lead Peer Reviewer:

Kathleen Creager

Approved by Reviewer(s):

Yes

Other Reviewer(s):

Last modified October 12, 2025: Initial commit (1fadfc4)