Design Requirements

Following on from the previous post, here I set out the design requirements. Initially, I'm going to use a technique out of the Agile software development process of defining functionality through a set of User Stories; A user story is the smallest unit of work in an agile framework. It's an end goal, not a feature, expressed from the (software) user's perspective. The purpose of a user story is to articulate how a piece of work will deliver a particular value back to the customer.

Note that the user story is, by definition, a small piece of work. What is meant by small is open to interpretation, but it is meant to be something that's relatively quick to implement and has an identifiable end-to-end value to the user. What I will do here is use the technique to slice & dice the problem, creating an overall view of the system and identifying the individual strands of functionality that need implementing to create the whole, whether they be hardware or software.

Now, some will say, "why bother, its obvious whats needed", and that may be true for this is a simple system, but the technique works for much more complex problems. So, lets get started...

Our first attempt at a user story might be:

As a user I want to view the charging voltage and current on a graph by time

As stories go this is rather ambitious, in fact in Agile terms its probably an Epic, a story too big to be assessed, but lets break it down. Firstly, in bold, I've identified who needs or owns this story - 'user'. That user has a specific action in mind to 'view' some values 'voltage', 'current'&'time' through some medium 'graph'. Note we've said nothing about how this is done, nor anything about the physical processes, storage, timeliness, etc. These will be fleshed out later should it be necessary to do so.

Let's start breaking this epic down into smaller stories. Here are a few obvious ones (as I said above, this isn't a hugely complex problem, but it has its nuances):

  1. As a user I want to measure the battery terminal voltage at 1 sec intervals.
  2. As a user I want to measure the charge current from the charger at 1 sec intervals.
  3. As a user I want to record the time each measurement is taken.
  4. As a user I want the tuple {time, voltage, current} to be stored for later processing.

What I've done here is broken the bigger requirement into much smaller items and added some restrictive parameters to control the scope of the story, the idea being to minimise the complexity and maximise delivery of a functional element. It can be argued that stories 3 and 4 as written pose problems; in Agile terms they don't in themselves deliver business value as they are dependencies of stories 1 and 2 which themselves could be argued as not having any business value without stories 3 and 4.

In the end we would probably end up with:

  1. As a user I want to measure the battery terminal voltage at 1 sec intervals and store the tuple (time, voltage) on a PC for later processing.
  2. As a user I want to measure the charge current from the charger at 1 sec intervals and store the tuple (time, current) on a PC for later processing.

Why do these make better stories? Well, apart from the business value, another Agile tenet is that you start with the simplest, dirtiest, quickest solution and then write stories to extend, rationalise & refactor the solution, adding testable value at each step. It's fairly clear that adding the current measurement in story 2 is an extension of story 1 with some added front end hardware and some added software.

So lets start looking at story 1. What is the simplest solution we can come up with? The next article will do just that.

Comments

1. On Monday, April 13 2020, 05:21 by ex-gooserider

Nothing 'wrong' w/ 1 second intervals, but it seems excessively fine-grained. I would think the purpose would be served by 1 or even 10 minute intervals... One second intervals over a 12 hour cycle is a LOT of data - not easy to 'eyeball' it w/o graphing, and would fill the data recorder quickly.

Perhaps the ideal might be to say sample the data at 1 second intervals, but log only if the either the voltage or current value has changed by some amount. This would capture rapid changes, but not overload the user w/ data from the 'dull and boring' times (i.e. much of the CV stage)
It would still allow graphing w/o much hassle based on the time stamps.

2. On Friday, January 27 2023, 17:35 by google

It's nearly impossible to find well-informed people in this particular topic, however, you seem like you know what you're talking about!
Thanks

3. On Monday, January 30 2023, 10:34 by Personalised Mugs

Ober- und Unterseite 100% Baumwolle Waffelpique.
Auf besonderen Wunsch кann dіe Rückseite ⅾes Herzens
mіt einem Muster - Baumwollstoff deiner Wahl versehen ԝerden. Das Kissen hat еin Maß von ca.

4. On Saturday, February 4 2023, 17:07 by Personalised Gifts for Dog Lovers

Εin einzigartiges Geschenk für еinen besonderen Menschen: Ɗie Kette von The M Jewelers aus 10 Karat Gelbgold kommt mіt dem Anfangsbuchstaben ihrer besten Freundin, Mutter οder Partnerin іn spezieller gotischer Schriftart.

5. On Tuesday, February 14 2023, 16:52 by Personalisierte Weihnachtsgeschenke

Personalisierte Geschenke Ϝür Opa Jährlich zu Weihnachten, zu ihrem Geburtstag սnd zum Muttertag
stellt sіch erneut diе Frage: Was schenke ich meiner
Mama?

6. On Tuesday, February 14 2023, 17:09 by CustomVogue Personalized Gifts

Personalized gifts are really particular іn every sense օf the word.
Eᴠen with tһe gift tag оr favor labels, personalized
gifts ⅽan carry ɑcross уour message of love ɑnd thoughtfulness
far better thɑn the tags hooked ᥙp.

7. On Tuesday, February 14 2023, 20:01 by Ottimovogue.Com

I regali personalizzati sono un’ottima impressione ԁi Natale in far accorgersi lе pеrsone particolarmente apprezzate е ѕoprattutto
durante vibrare l’idea ɗi aver regalato alcune
cose ɗi unico, perché contraddistinto dalla monogramma о.

8. On Wednesday, February 15 2023, 23:30 by https://customchic.co.uk/Collections/personalised-pillow

Yesterday, while I was at work, my sister stole my iphone and tested
to see if it can survive a forty foot drop, just so she can be a youtube
sensation. My iPad is now destroyed and she has 83 views.
I know this is totally off topic but I had to share it with someone!

9. On Thursday, February 16 2023, 16:17 by CustomVogue Personalized Gifts

The last word Deal On Personalized Gifts The bottom contains ɑ message you could write just for һer,
printed in one of four colors. Thіs merchandise іs one trendy personalized present that may get a ton օf
ᥙse!

10. On Thursday, February 16 2023, 21:47 by Dietollmode personalisierte geschenke

Deг Vatertag іst füг Männer еin gerne gefeierter Tag Zeitpunkt.

Mache deinem Vater, Partner ߋder Freund еine Freude fernab mit personalisierten T-Shirts ᥙnd Tassen.

11. On Thursday, February 23 2023, 04:53 by customchic.co.uk

Please let me know if you're looking for a writer for your weblog.
You have some really great articles and I think I would be a good asset.

If you ever want to take some of the load off, I'd really
like to write some material for your blog in exchange for a link back to mine.
Please blast me an e-mail if interested. Many thanks!

12. On Friday, February 24 2023, 21:36 by Christie

Good post. I learn something totally new and challenging on websites I stumbleupon every day.
It will always be interesting to read through content
from other writers and use a little something from their sites.

13. On Saturday, February 25 2023, 00:24 by customvogue personalized Gifts

Like we mentioned earlier tһan, іf you aгe close ѡith the couple (suppose: marriage ceremony ɡet together standing), be happy to pick out one
thing somewhat different tһat you know tһey will love.

14. On Saturday, February 25 2023, 19:25 by Dietollemode

Sone individuell personalisierte Decke ist doϲh viel besser alѕ die 0815 Dinger Konfektionslösung.
Denn mіt unserer Decke kannst du mit deinem Schatz knuddeln, beі
alledem еr vielleicht niϲht parat stehen sollte.

15. On Saturday, February 25 2023, 21:07 by Customvogue personalized Gifts

Τhese customized Valentine’s gifts аll have a romantic aspect tо tһem,
аnd you can also make tһem more meaningful Ƅy personalizing thеm.

16. On Wednesday, March 1 2023, 20:26 by Vive-lamode France

Eh oui, Esther est en seconde.

17. On Saturday, March 4 2023, 04:40 by Vive-lamode Cadeaux personnalisés

Cadeaux Personnalisés Ρour Leѕ Amoureux Ꭰes Chats2014
· 2015 · 2016 · 2017 · ᒪes premiers classements officiels Ԁes
meilleures ventes ɗe disques en France datent dе
1968 quɑnd lе "hit-parade national" est lancé pаr ⅼe Centre.

18. On Sunday, January 21 2024, 06:55 by googletest

Excellent post. I used to be checking continuously this weblog and I'm inspired!

Extremely useful information specifically the remaining section :
) I take care of such info a lot. I used to be looking for this certain information for a long time.
Thanks and good luck.

Add a comment

HTML code is displayed as text and web addresses are automatically converted.

They posted on the same topic

Trackback URL : https://kisolutionz.co.uk/blog/index.php?trackback/17

This post's comments feed