Skip to content
Merged

Style #2643

Changes from all commits
Commits
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
10 changes: 5 additions & 5 deletions documentation/asciidoc/accessories/iqaudio/digiamp_plus.adoc
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
=== Raspberry Pi DigiAMP{plus}

With Raspberry Pi DigiAMP{plus}, you can connect passive stereo speakers up to 2x35W with variable output, making it ideal for use for Raspberry Pi based Hi-Fi systems.
With Raspberry Pi DigiAMP{plus}, you can connect passive stereo speakers up to 2x35W with variable output, making it ideal for use in Raspberry Pi-based hi-fi systems.

DigiAMP{plus} uses the Texas Instruments TAS5756M PowerDAC and must be powered from an external supply. It requires a 12-24V DC power source (XP Power VEC65US19 power supply is recommended).
DigiAMP{plus} uses the Texas Instruments TAS5756M PowerDAC and must be powered from an external supply. It requires a 12-24V DC power source (the XP Power VEC65US19 power supply is recommended).

image::images/DigiAMP+_Board_Diagram.jpg[width="80%"]

DigiAMP{plus}’s power in barrel connector is 5.5mm x 2.5mm.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is probably the internal and external diameters of the barrel connector, so describing it as "is 5.5mm x 2.5mm." probably isn't right?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it's length of the plug, and diameter of the barrel? Umm. This needs clarifying I guess. @tobybroberts do you have actual hardware here to look at and measure things?


At power-on, the amplifier is muted by default (the mute LED is illuminated). Software is responsible for the mute state and LED control (Raspberry Pi GPIO22).

DigiAMP{plus} is designed to provide power to the Raspberry Pi and DigiAMP{plus} together in parallel, delivering 5.1V at 2.5Amp to the Raspberry Pi through the GPIO header.
DigiAMP{plus} is designed to provide power to the Raspberry Pi and DigiAMP{plus} together in parallel, delivering 5.1V at 2.5amp to the Raspberry Pi through the GPIO header.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2.5amp -> 2.5A ? 🤷

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Liz you can't decapitalise Amps, and Amp is an Amp, it is not an amp. It is (a) the name of the person, and (b) the name of the unit. Units named after people are always uppercased in physics. Should be "2.5 A" or "2.5 Amps"

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You left volts capitalised, so it's "5.1 V" not "5.1 v".

That said engineers have a habit of lowercasing volts, and I will hunt all instances out and fix them. It's V not v, and A not a.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

And the style-guide also says no space between the number and the unit, so "5.1V" not "5.1 V"

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mutters

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Al and I have already had the Slack equivalent of a bar fight over this: I intend to continue it in a real bar tomorrow. Style guide says lower-case a, upper-case V, no space (for historical vernacular reasons as laid out by Hart's Rules - also observed yesterday that the Times' and Economist's style guides concur); it's a standard English usage thing rather than a physics/moral rectitude thing.

Honestly (and this is where things start to go wobbly) I don't really like the inconsistency either, but if we make changes now it means that ALL of our materials for the last ten years are affected. And I'm not going to go through and make retrospective changes for consistency.

In short, I might be persuadable on this, but, @aallan, you're going to have amazingly persuasive.

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Amp and amp are equally wrong - it should be A.


WARNING: DO NOT APPLY POWER TO THE RASPBERRY PI’s OWN POWER INPUT WHEN USING DIGIAMP{plus}.
WARNING: Do not apply power to the Raspberry Pi's own power input when using DigiAMP{plus}.

==== Pinouts
[cols="1,12"]
|===
| *P5* | Alternative power input for hard wired installations (Polarity must be observed).
| *P5* | Alternative power input for hard wired installations (polarity must be observed).
| *P8* | TAS5756m Internal GPIO1/2/3
|===