If you know what you need built, we can help you draft a technical specification that meets the checklist and that can guide and ensure successful product development. Contact us today to know more.
Tips to Drafting an Effective Electronic Design Project Specification
An Electronic Product Specification Document (also commonly termed as a Requirement Document) identifies and lists all the expected specifications and requirements of the intended product. It also identifies the intended market both geographically and in terms of the user personas for new product. It provides a guideline to the design house/design team working on the system.
In our blog on ‘Best Practices of Requirement Documentation’, we have stressed on the benefits of requirement documentation, types of requirements and best practices for writing requirements. This blog intends to go into more specifics providing a comprehensive guideline on the structure, content and template of the document.
A good electronic product specification should cover and elaborate on the main requirements: i.e., the purpose of the product, block diagram, main Hardware, Firmware and Mechanical features, environmental conditions, manufacturing requirements, etc. The technical specifications should cover the specific requirements for a particular product design. The document should have the following characteristics:
1. Layout
a. The document should have a distinct table of contents for all major and minor sections for ease of reference.
b. Include a clear title of the document, with a version number, date, and the name of the original author.
c. Include a proper Glossary to define unique terms and definitions. This is especially important as there may be key words relevant to your industry which may not be in common usage elsewhere.
d. Include an Acronym section to define a set of acronyms that will appear in the document.
e. Use Reference Document section/table showing applicable company and third-party documents necessary for review.
f. Use a History Table that shall list, versions, dates, author and list in detail all the changes made from one version (revision) to the next
2. Content
a. Use correct sentence structure, spelling and good grammar techniques with well-defined paragraphs with numbering.
b. Use meaningful diagrams, photos and tables to clarify the critical requirements, especially if there a variety of models with different features.
c. State only necessary, essential feature, capability, or quality factor requirements.
e. State appropriate level of detail of the requirement for the end-product.
f. Should be correct and be an accurate representation of the requirements.
g. Show a single requirement per line, not multiple requirements per line (i.e., do not use ‘or’ and ‘and’ in describing a requirement. If you find yourself using one of the two words (‘and’, ‘or’) that should already be an indication for you to split that specific requirement in two lines.
h. Should not be unambiguous, clearly stating the requirements so it can be only interpreted one way by all readers (i.e., refrain to use adjectives and rather use concrete numbers to describe the product performance.)
i. Should be complete, so that there is no need to find other information to understand the requirements.
j. Should state requirements that can be realized with product development constraints (i.e., cost, schedule, technical research, ethical, safety review, etc.) with some acceptable risks.
k. Should show requirements that are verifiable (i.e., able to be verified and validated) by the design engineering firm.
Important Technical Project Details to Highlight
While working on the product specification document it is very important to capture and present well-structured core information about the product, its function, properties, attributes, constraints and intended purpose. The document should be clear, concise and should outline all the information required by the design team and product team to successfully realize a functioning, marketable product.
Here are some pointers to keep in mind while drafting the electronic product specifications:
- Understand and research the applicable Safety (UL/CSA/IEC), EMC/EMI (FCC/ISED/ EC EMC Directive) and Wireless radio operation (FCC/ISED/ EC Radio Equipment Directive) regulatory compliance regulations and Standards for the target countries. If in doubt, research similar competitive products literature to find out what regulations and standards will apply.
- Target BOM cost gives the necessary direction to the design engineer for selecting various components, PCB technology to be used. As an example, a smaller PCB will cost less, mounting components on both sides of the PCB will cost more time and cost in the production but reduces the PCB size, etc. An off- the-shelf enclosure will be easier to source in the supply chain vs. custom enclosure that requires up-front NRE costs. As much as possible, all components, power supplies, wiring, enclosures, and any custom designed parts should be sourced from reputable suppliers and parts distributors, who have visibility of availability (OTS parts) and the necessary materials to provide a guaranteed cost and lead time.
- What will be the operating & storage temperature range (i.e., -20 to +60 Deg. C)
- What is the operating humidity range (i.e., 5 – 95 RH%)
- The expected level of vibration the product will endure during transportation, handling, and installation in the field.
- Will the product be primarily used indoor or an outdoor?
- What is mounting style will be required (i.e., tabletop, wall, floor, etc.)
- Is the environment hazardous (fumes, dust, gases, etc.)?
- Is an IEC 60059 IPXX/NEMA YY water resistance/protection or dust resistant/dust-tight level required?
- Will the product operate in a non-ideal environment (i.e., sea level, at elevated heights, etc.)?
- For high volume production, consider making a design that makes for efficient manufacturing: i.e., use of SMD components, fewer number of system components, fewer number of fasteners that require manual process.
- Specify automated PCB Assembly inspection and functional testing equipment; these features will require additional HW and FW design to accomplish.
- Engineers should know the expected life of the product, as they will pay special attention to the critical component Lifecycle (active, mature, NR/ND or EOL) and alternatives. If the product will be available for 5+ years, it is important to consider long term availability while selecting various critical components. This will allow you to sell the product for 5 or more years and extend this product lifecycle to offer service and/or repairs.
- If possible, think about the product warranty so that all project stakeholders can understand the reliability requirements. The design engineers will carefully select critical components when designing the Hardware circuits. Designing for a warranty of 1 year or 10 years will be entirely different.
- Should be powered by an external AC/DC wall or desktop power source.
- Should be powered by 5V DC input, via USB Type C Power Delivery (PD) source.
- Should be powered with a secondary rechargeable Lithium-Ion/Lithium-Poly battery pack that will charged in X hours and provide Y hours of typical operation.
- Should have Wi-Fi 5 (802.11 b/g/n/ac), Bluetooth / BLE 5.0, LoRa and/or 4G LTE-FDD Cat-4 cellular wireless connectivity.
- Should have a backlit LCD/OLED display visible from a distance (specify).
- Should have a simple User interface to configure via a keypad, or custom pushbutton configuration. (NOTE: If you have a preferred configuration, insert in the specification).
- Should indicate the color and functionality when the operator visible LED(s) are operating.
- Should have one serial (RS-232 or RS-485), one Ethernet (1 Gbps) and one HDMI/DisplayPort connection.
- Should have X number of Analog, and Y number of Digital Inputs, all should be 3.3V/5V/12Vdc compatible.
- Should have X number of electro-mechanical or Solid-State relays to control external equipment.
- Should have suitable 32-bit ARM CORTEX-M33 MCU or 64-bit ARM CORTEX-A53 multi-core CPU that supports the required OS, and support key peripherals (I2S, I2C, SPI, UART, USART, USB 2.0/3.0) and has embedded core circuits (DMA, Flash memory, PWM driver, ADC, DAC, etc.).
- The whole product should not consume more than X watts peak and Y watts typical (state the conditions for both peak and typical functionalities).
- State the I/O, Power supply and other required protections, such as: The DC input voltage should have over-voltage, over current, surge protection. All IO interfaces should have ESD protection and CM chokes.
- Industrial RS232, RS-485, Ethernet I/Os should have Surge protection, voltage clamping and/or isolation based on the end user’s requirement document or industry standard.
- Review possible failure modes in the field, to provide necessary protection to ensure the product functions for a longer period.
- Use suitable EMI components and CSA certified/UL recognized isolation transformers, MOVs and TVS diodes for all input / output power sources and I/Os.
- Note that Hardware design will be dictated by your stated environmental conditions, thermal cooling of higher power parts, and regulatory compliance requirements (Safety and EMC/EMI standards).
- State the I/O, Power supply and other required protections, such as: The DC input voltage should have over-voltage, over current, surge protection. All IO interfaces should have ESD protection and CM chokes.
- Industrial RS232, RS-485, Ethernet I/Os should have Surge protection, voltage clamping and/or isolation based on the end user’s requirement document or industry standard.
- Review possible failure modes in the field, to provide necessary protection to ensure the product functions for a longer period.
- Use suitable EMI components and CSA certified/UL recognized isolation transformers, MOVs and TVS diodes for all input / output power sources and I/Os.
- Note that Hardware design will be dictated by your stated environmental conditions, thermal cooling of higher power parts, and regulatory compliance requirements (Safety and EMC/EMI standards).
- Create a high-level flowchart and discuss with your Firmware team what will be the high-level code execution plan.
- Request proper FW code structure with modularity and reuse in mind, written in a common low-level language (C++, C#).
- For an LCD/OLED displays, define the screen layout/Menus/colors.
- For wired and wireless communication interface, define a clear command packet structure, desired Protocol (MQTT) and data interchange payload type (JSON).
- If required, state if a RTOS will be needed, or if a higher functionality OS (LINUX based) will be needed.
- Is power management critical, ensure that the Power ON, Power Off of various voltage rails is stated.
- If cybersecurity and encryption is required, clearly state the standard version and/or key cryptographic protocol versions that are required for packet based wired and wireless data communications.
- Due to tight design project timelines, it is not practical to test all field conditions for your product; this means you will need to fix a bug or provide a feature update to improve UX or add certain specific features (i.e., enable 3G UMTS-FDD or W-CDMA) frequency band or particular4G LTE-FDD frequency band for a different country), when the product is already in the field.
- Think about the embedded firmware update in the final field installation:
- If the product will have wireless communications, state how OTA firmware updates shall be completed (i.e., Wi-Fi, Bluetooth, 4G LTE Cellular, Zigbee, LoRa, etc.); this will facilitate creation of the firmware upgrade algorithm.
- If wireless connectivity is not present, state that the firmware upgrade mechanism should be done via wired interfaces (USB) or over serial interfaces (RS-232. RS-485), or high-speed interface (Ethernet) .
- The firmware update methodology should be easy to use by your service and support partners. In most cases, the end user should not open the product enclosure to perform the Firmware update.
- State whether configuration software will be needed, how the end user shall be supported.
- If there is a mobile device or tablet application required, state the OS versions that must be used.
- Define functional details and screens for all SW applications.
- It is critical to define the end user experience, and end user interface needs, based on similar products.
- State your expected end user experience requirements and provide a list of features that will provide great user experience during product operation.
- Do some research for the enclosure/case design, what are the maximum dimensions and mounting method. The size should be able to fit all required PCBA modules, PSUs, interconnecting cables, etc.
- You can provide initial sketches of the enclosure and discuss ideas with the design team.
- Determine how the user will interact with the enclosure, if mobile, portable, or handheld, it should be easy to carry and light enough not to require a second person.
- If possible, create preliminary 3D models and fit suggested components/assemblies inside to see how cooling air (if applicable) will flow, and for ease of manufacturing, and servicing in the field.
- Note that Enclosure design will be dictated by your stated environmental conditions, thermal management of higher power parts, and regulatory compliance requirements (Safety and EMC/EMI standards).
- Your specification should state whether this project will be a Proof of Concept (PoC) or prototype/production devices to be manufactured.
- If you have information of the various considerations from the manufacturing point of view from your current/preferred Contract Manufacturer, these requirements, stated these as design inputs for the design engineers.
- Quality Assurance testing by separate, non-design staff is necessary to find issues and improve the reliability of the product.
- Request a proper QA validation test plan should be created for both for the validation during prototyping stages, and for PCBA module and/or System production testing. A detailed plan will help HW designers and FW source code developers ensure that the product is easy to test in all stages of NPI development and production.
- A good plan will state that proper, accessible test points & interfaces, as well as additional firmware code to enable the testing are both required for design validation.
- For production testing, the time required should be of short duration and efficient. For PCBA module, the product design should have all related test points are accessible; if very high volume or small size, use of automated test setup will reduce setup time and test the product with maximum coverage.
1. Purpose of the design/product
a. What is the purpose or idea behind the product? What is the problem is it solving?
b. This information will guide the design team to get a perspective and then, they can start thinking about how to design.
2. Intended User Personas
a. Identify and define the various user personas. Understand how each persona will interact with the product and define the requirements accordingly.
3. Targeted Geographical Markets
a. Identify the geographical markets the product will be marketed and sold in. Each country/region will have a different set of standards and regulations that the design/product will have to comply with.
4. Diagrams and Figures
a. Create a rough block diagram or Figure of the product to define different sub-blocks and keep refining as the discussion progresses. This is important to have a good high-level overview of the project.
5. Prerequisite Design Requirements
a. Regulatory Compliance/Certification requirements:
b. Target BOM cost
c. Environmental Conditions
- Provide the environmental conditions in which the product will operate:
The above points will dictate both the Hardware, wiring, connector, power supply designs, but also the mechanical design of the enclosure.
d. Production Volume
e. Product Lifecyle
f. Warranty:
6. Main Features
a. Hardware Design:
The Hardware design specification should provide detailed requirements related to various features as given in the block diagram, figures, or photos. These include:
b. Hardware Protection Circuits:
c. Firmware:
d. Hardware Protection Circuits:
e. Firmware Field updates:
f. Software (Tablet/Mobile Device, local Server, or cloud-based server)
g. User Experience (UX)/ User Interface (UI):
h. Enclosure
7. Fabrication
a. Manufacturing (DFM)
b. Validation testing & Production testing
8. Field Use Considerations:
a. Most custom designed circuits will likely fail, so research the scenarios where the product could fail, and how you want repairs (if applicable) will be performed.
b. If you’re a specifying low-cost products, consider if you want the user to ship back the failed product(s).
c. If the product is large or costly, a rugged design is critical. If the product failure is a major type, it will impact the user’s confidence, and your company’s brand reputation. The design should be optimized so that turnaround time should be in minutes (not hours) when field repair is required.
d. You should decide if the product/board is going to be repairable or not, as this fact is useful for engineers during product design; the design team will make decisions that will affect the reliability and repairability of the product.
e. Will your product require service personnel for repairs? This will add cost to the product since you need to maintain service centers with their associated costs (parts, repair documentation, resources, training, etc.).
9. Documentation:
a. Product documentation (Specifications, application notes, datasheets, etc.) are particularly important. This provides information to the end user so they can compare the developed product vs their requirements.
b. Professionally written product documentation with easily readable key features will help the potential client make their decision to buy, while poor product documentation will lead to no or very limited sales.
In addition, the end user needs to know how to use the product safely and effectively.
c. Your product’s user interface should be easy and intuitive to your target market user; the ease of use will define how much support may be needed. Depending on the end user feedback, you may need to create additional documents (FAQs, How To articles, videos, etc.) or even online support group web site to help customers.
d. In many cases, good documentation and support is a critical differentiation for complex use cases, especially when your product uses new technologies.
It is not a simple matter to create a detailed technical specification for most innovative electronic/electrical products. This is usually the case when you don’t have much experience in the design, or you are part of a start-up company with no defined procedures or established guidelines. A well-defined, easily readable technical specification provides clarity to the design engineer and reduces the timelines and wasted time communicating back and forth to clarify important requirements.