New plugin: Resistor code calculator

Flyspray: FS#11585
Author: Calvin Walden


git-svn-id: svn://svn.rockbox.org/rockbox/trunk@28191 a1c6a512-1295-4272-9138-f99709370657

15 files changed, 30 insertions, 0 deletions

diff --git a/manual/plugins/images/ss-resistor-112x64x1.png b/manual/plugins/images/ss-resistor-112x64x1.png
new file mode 100644
index 0000000000..45c2f65e41
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-112x64x1.png
diff --git a/manual/plugins/images/ss-resistor-128x64x1-clip.png b/manual/plugins/images/ss-resistor-128x64x1-clip.png
new file mode 100644
index 0000000000..8ce8485a54
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-128x64x1-clip.png
diff --git a/manual/plugins/images/ss-resistor-128x96x1.png b/manual/plugins/images/ss-resistor-128x96x1.png
new file mode 100644
index 0000000000..4c00cc788a
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-128x96x1.png
diff --git a/manual/plugins/images/ss-resistor-132x80x16.png b/manual/plugins/images/ss-resistor-132x80x16.png
new file mode 100644
index 0000000000..d2dbfb4496
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-132x80x16.png
diff --git a/manual/plugins/images/ss-resistor-138x110x1.png b/manual/plugins/images/ss-resistor-138x110x1.png
new file mode 100644
index 0000000000..b8caea6a3b
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-138x110x1.png
diff --git a/manual/plugins/images/ss-resistor-160x128x1.png b/manual/plugins/images/ss-resistor-160x128x1.png
new file mode 100644
index 0000000000..458b4dff73
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-160x128x1.png
diff --git a/manual/plugins/images/ss-resistor-160x128x16.png b/manual/plugins/images/ss-resistor-160x128x16.png
new file mode 100644
index 0000000000..6495f083f1
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-160x128x16.png
diff --git a/manual/plugins/images/ss-resistor-160x128x2.png b/manual/plugins/images/ss-resistor-160x128x2.png
new file mode 100644
index 0000000000..3f20af9fbe
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-160x128x2.png
diff --git a/manual/plugins/images/ss-resistor-176x132x16.png b/manual/plugins/images/ss-resistor-176x132x16.png
new file mode 100644
index 0000000000..8350349169
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-176x132x16.png
diff --git a/manual/plugins/images/ss-resistor-176x220x16.png b/manual/plugins/images/ss-resistor-176x220x16.png
new file mode 100644
index 0000000000..26cd0c953c
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-176x220x16.png
diff --git a/manual/plugins/images/ss-resistor-220x176x16.png b/manual/plugins/images/ss-resistor-220x176x16.png
new file mode 100644
index 0000000000..09225f1982
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-220x176x16.png
diff --git a/manual/plugins/images/ss-resistor-240x400x16.png b/manual/plugins/images/ss-resistor-240x400x16.png
new file mode 100644
index 0000000000..dce4c195a0
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-240x400x16.png
diff --git a/manual/plugins/images/ss-resistor-320x240x16.png b/manual/plugins/images/ss-resistor-320x240x16.png
new file mode 100644
index 0000000000..7310009f88
--- /dev/null
+++ b/manual/plugins/images/ss-resistor-320x240x16.png
diff --git a/manual/plugins/main.tex b/manual/plugins/main.tex
index ce08132588..854f50d138 100644
--- a/manual/plugins/main.tex
+++ b/manual/plugins/main.tex
@@ -253,6 +253,8 @@ option from the \setting{Context Menu} (see \reference{ref:Contextmenu}).}
 
 {\input{plugins/random_folder_advance_config.tex}}
 
+{\input{plugins/resistor.tex}}
+
 \opt{lcd_color}{\input{plugins/rockpaint.tex}}
 
 \opt{archosrecorder,archosfmrecorder,ondio}{\input{plugins/split_editor.tex}}
diff --git a/manual/plugins/resistor.tex b/manual/plugins/resistor.tex
new file mode 100644
index 0000000000..27cc9a3e5e
--- /dev/null
+++ b/manual/plugins/resistor.tex
@@ -0,0 +1,28 @@
+\subsection{Resistor Calculator}
+\screenshot{plugins/images/ss-resistor}{Resistor calculator}{img:resistor}
+
+The resistor calculator is a plugin that works in 3 modes:
+
+\subsubsection{Colour to Resistance}
+
+In Colour to Resistance mode, use the menus to select the colours of the
+bands of a resistor which you would like to know the resistance of.
+   
+\subsubsection{Resistance to Colour}
+
+In Resistance to Colour mode, use the menus to select the unit that you
+would like to use (choose from Ohms, Kiloohms, Megaohms), and use
+the on-screen keyboard to input the value of the resistor that you would
+like to know the colour code of. The colour codes are presented
+\opt{lcd_color}{graphically and} textually.
+
+\subsubsection{LED resistance}
+
+LED resistance calculator is used to determine the resistor necessary to light
+an LED safely at a given voltage. First, select the voltage that the LED will
+use (the first option is the most common and a safe bet), and the current
+that it will draw (likewise with the first option). Then, use the onscreen
+keyboard to type in the supply voltage and, if selected, the custom 
+foreward current. This function produces safe estimates, but use your own
+judgement when using these output values. Power rating and displayed resistance
+are rounded up to the nearest common value.