Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Package/module name as title

Here goes a simple description of of the package/module.

Introduction

This contains a list of the capabilities of the module/package i detail. The reader should be able to understand the basic functionalities of this package/module by reading this text.

Package/module file structure

This section should contain the list of files and a simple description of each

Operation (if applicable)

How does the package/module do what it does? Are there any YAML files? Are there any registers in the YAML files? Which are these registers and what do they represent?

Class(es)/file(es) descriptions

Each file/associated classes will be described here. UML diagrams and text description can be used. A UML cheat sheet can be found here. Instantiation information (if applicable) can be mentioned. Flow diagrams for describing the class operation are also welcome. Everything can be developed in Gliffy. 

Exception handling (if applicable)

Here you can mention if the package/module throws any exceptions, and you can also mention how these exceptions should be handled in upper layers.

Extension (if applicable)

Is the package extendable to add a new function or to modify an existing function? If so, it needs to be mentioned here. 

Exported IOC shell commands, description and parameters (if applicable)

All EPICS shell commands provided should be described here with their input parameters.

PV name list (if applicable)

The PV list goes here. If any other page described some or all PVs, it can be referenced here. The register index can map the PV to the register described in the YAML section above.

bldStream.cpp

Contains functions and structures to read the BLD/BSSS/BSAS stream coming from the firmware and call the registered callback functions with the stream data stored in buffers.

Gliffy Diagram
macroId9c052d24-d800-4055-a84e-d242bf1f5e66
displayNamebsaDriver class
namebsaDriver class
pagePin11

Detailing of the static functions available in the file

Gliffy Diagram
macroId34bcb7f3-77d2-4c82-a82a-e08f9ff9a095
nameinit_drvList
pagePin1
Gliffy Diagram
displayNamefind_drvByNamedRoot
namefind_drvByNamedRoot
pagePin4

...