Skip to content

Commit fcf69c2

Browse files
committed
Update Analog Input HW and SW articles for Systemcore
1 parent 6b92a94 commit fcf69c2

File tree

15 files changed

+50
-73
lines changed

15 files changed

+50
-73
lines changed

.github/workflows/inspector.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,6 @@
3939
"source/docs/software/pathplanning/trajectory-tutorial/entering-constants.rst",
4040
"source/docs/software/convenience-features/event-based.rst",
4141
"source/docs/software/dashboards/glass/field2d-widget.rst",
42-
"source/docs/software/hardware-apis/sensors/analog-inputs-software.rst",
4342
"source/docs/software/hardware-apis/sensors/digital-inputs-software.rst",
4443
"source/docs/software/hardware-apis/sensors/encoders-software.rst"
4544
]

source/docs/hardware/sensors/accelerometers-hardware.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ Peripheral multi-axis accelerometers may simply output multiple analog voltages
3131

3232
#### roboRIO built-in accelerometer
3333

34-
.. image:: images/roborio/roborio-accelerometer.svg
34+
.. image:: images/systemcore/roborio-accelerometer.svg
3535
:alt: The details of this accelerometer are printed on the roboRIO to the right of the NI logo.
3636

3737
The roboRIO has a built-in accelerometer, which does not need any external connections. You can find more details about how to use it in the :ref:`Built-in Accelerometer section <docs/software/hardware-apis/sensors/accelerometers-software:BuiltInAccelerometer>` of the software documentation.

source/docs/hardware/sensors/analog-inputs-hardware.rst

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -2,44 +2,46 @@
22

33
.. note:: This section covers analog input hardware. For a software guide to analog inputs, see :ref:`docs/software/hardware-apis/sensors/analog-inputs-software:Analog Inputs - Software`.
44

5-
An [analog signal](https://en.wikipedia.org/wiki/Analog_signal) is a signal whose value can lie anywhere in a continuous interval. This lies in stark contrast to a :doc:`digital signal <digital-inputs-hardware>`, which can take only one of several discrete values. The roboRIO's analog input ports allow the measurement of analog signals with values from 0V to 5V.
5+
An [analog signal](https://en.wikipedia.org/wiki/Analog_signal) is a signal whose value can lie anywhere in a continuous interval. This lies in stark contrast to a :doc:`digital signal <digital-inputs-hardware>`, which can take only one of several discrete values. The roboRIO's analog input ports allow the measurement of analog signals with values from 0V to 3.3V.
6+
7+
.. note:: Systemcore Analog Inputs are 3.3 volts, whereas the roboRIO was 5 volts.
68

79
In practice, there is no way to measure a "true" analog signal with a digital device such as a computer (like the roboRIO). Accordingly, the analog inputs are actually measured as a 12-bit digital signal - however, this is quite a high resolution [1]_.
810

911
Analog inputs are typically (but not always!) used for sensors whose measurements vary continuously over a range, such as :doc:`potentiometers <analog-potentiometers-hardware>`, as they can communicate by outputting a voltage proportional to their measurements.
1012

11-
## Connecting to roboRIO analog input ports
12-
13-
.. note:: An additional four analog inputs are available via the "MXP" expansion port. To use these, a breakout board of some sort that connects to the MXP is needed.
13+
## Connecting to Systemcore analog input ports
1414

1515
.. warning:: Always consult the technical specifications of the sensor you are using *before* wiring the sensor, to ensure that the correct wire is being connected to each pin. Failure to do so can result in damage to the sensor or the RIO.
1616

17-
.. warning:: **Never** directly connect the power pin to the ground pin on any port on the roboRIO! This will trigger protection features on the roboRIO and may result in unexpected behavior.
17+
.. warning:: **Never** directly connect the power pin to the ground pin on any port on the Systemcore! This will trigger protection features on the roboRIO and may result in unexpected behavior.
1818

19-
.. image:: images/roborio/roborio-aio.svg
20-
:alt: The roboRIO, with the location of the Analog Inputs highlighted.
19+
.. image:: images/systemcore/systemcore-smartio.png
20+
:alt: The Systemcore, with the location of the Smart I/O ports highlighted.
2121

22-
The roboRIO has 4 built-in analog input ports (numbered 0-3), as seen in the image above. Each port has three pins - signal ("S"), power ("V"), and ground ("|ground|"). The "power" and "ground" pins are used to power the peripheral sensors that connect to the analog input ports - there is a constant 5V potential difference between the "power" and the "ground" pins [2]_. The signal pin is the pin on which the signal is actually measured.
22+
The roboRIO has 6 Smart I/O ports (numbered 0-5), as seen in the image above. Each port has three pins - signal, power ("3.3V"), and ground ("gnd"). The "power" and "ground" pins are used to power the peripheral sensors that connect to the analog input ports - there is a constant 5V potential difference between the "power" and the "ground" pins [2]_. The signal pin is the pin on which the signal is actually measured.
2323

2424
### Connecting a sensor to a single analog input port
2525

2626
.. note:: Some sensors (such as :doc:`potentiometers <analog-potentiometers-hardware>`) may have interchangeable power and ground connections.
2727

28-
Most sensors that connect to analog input ports will have three wires - signal, power, and ground - corresponding precisely to the three pins of the analog input ports. They should be connected accordingly.
28+
Most analog sensors will have three wires - signal, power, and ground - corresponding precisely to the three pins of the Smart I/O ports. They should be connected accordingly.
2929

3030
.. image:: images/accelerometers-hardware/adxl193-single-axis-accelerometer-to-roborio.svg
3131
:alt: Hooking a ADXL193 single axis accelerometer to an analog input on the roboRIO.
3232

33+
.. todo:: Update above image to use the Systemcore Smart I/O ports.
34+
3335
### Connecting a sensor to multiple analog input ports
3436

3537
Some sensors may need to connect to multiple analog input ports in order to function. In general, these sensors will only ever require a single power and a single ground pin - only the signal pin of the additional port(s) will be needed. The image below is shows an analog accelerometer that requires three analog input ports, but similar wiring can be used for analog sensors requiring two analog input ports.
3638

3739
.. image:: images/analog-inputs-hardware/triple-axis-accelerometer-to-roborio.svg
3840
:alt: Hooking a triple axis accelerometer to three different analog input channels of the roboRIO.
3941

40-
.. |ground| unicode:: 0x23DA
42+
.. todo:: Update above image to use the Systemcore Smart I/O ports.
4143

4244
## Footnotes
4345

44-
.. [1] A 12-bit resolution yields $2^{12}$, or 4096 different values. For a 5V range, that's an effective resolution of approximately 1.2 mV, or .0012V. The actual accuracy specification is plus-or-minus 50mV, so the discretization is not the limiting factor in the measurement accuracy.
46+
.. [1] A 12-bit resolution yields $2^{12}$, or 4096 different values. For a 3.3V range, that's an effective resolution of approximately 0.8 mV, or .0008V. The actual accuracy of the measurement will be less, so the discretization is not the limiting factor in the measurement accuracy.
4547
.. [2] All power pins are actually connected to a single rail, as are all ground pins - there is no need to use the power/ground pins corresponding to a given signal pin.

source/docs/hardware/sensors/digital-inputs-hardware.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ The roboRIO's built-in digital input-output ports (or "DIO") ports function on 5
1414

1515
.. warning:: **Never** directly connect the power pin to the ground pin on any port on the roboRIO! This will trigger protection features on the roboRIO and may result in unexpected behavior.
1616

17-
.. image:: images/roborio/roborio-dio.svg
17+
.. image:: images/systemcore/roborio-dio.svg
1818
:alt: roboRIO showing the DIO pins on the left side.
1919

2020
The roboRIO has 10 built-in DIO ports (numbered 0-9), as seen in the image above. Each port has three pins - signal ("S"), power ("V"), and ground ("|ground|"). The "power" and "ground" pins are used to power the peripheral sensors that connect to the DIO ports - there is a constant 5V potential difference between the "power" and the "ground" pins [3]_ - the "power" pin corresponds to the "high" state (5V), and the "ground" to "low" (0V). The signal pin is the pin on which the signal is actually measured (or, when used as an output, the pin that sends the signal).

source/docs/hardware/sensors/images/roborio/roborio-accelerometer.svg renamed to source/docs/hardware/sensors/images/systemcore/roborio-accelerometer.svg

File renamed without changes.

source/docs/hardware/sensors/images/roborio/roborio-aio.svg renamed to source/docs/hardware/sensors/images/systemcore/roborio-aio.svg

File renamed without changes.

source/docs/hardware/sensors/images/roborio/roborio-can.svg renamed to source/docs/hardware/sensors/images/systemcore/roborio-can.svg

File renamed without changes.

source/docs/hardware/sensors/images/roborio/roborio-dio.svg renamed to source/docs/hardware/sensors/images/systemcore/roborio-dio.svg

File renamed without changes.

source/docs/hardware/sensors/images/roborio/roborio-i2c.svg renamed to source/docs/hardware/sensors/images/systemcore/roborio-i2c.svg

File renamed without changes.

source/docs/hardware/sensors/images/roborio/roborio-mxp.svg renamed to source/docs/hardware/sensors/images/systemcore/roborio-mxp.svg

File renamed without changes.

0 commit comments

Comments
 (0)