mirror of
https://github.com/RobTillaart/Arduino.git
synced 2024-10-03 18:09:02 -04:00
100 lines
3.0 KiB
Markdown
100 lines
3.0 KiB
Markdown
|
|
||
|
|
[](https://github.com/marketplace/actions/arduino_ci)
|
||
|
|
[](https://github.com/RobTillaart/MultiSpeedI2CScanner/blob/master/LICENSE)
|
||
|
|
[](https://github.com/RobTillaart/MultiSpeedI2CScanner/releases)
|
||
|
|
|
||
|
|
|
||
|
|
# Arduino MultiSpeed I2C Scanner
|
||
|
|
|
||
|
|
## Version: 0.1.13
|
||
|
|
|
||
|
|
## Description
|
||
|
|
|
||
|
|
MultiSpeedI2CScanner is a menu driven I2C scanner, see below.
|
||
|
|
The scanner is tested on an UNO and an ESP32.
|
||
|
|
|
||
|
|
The scanner provides an overview of which addresses can be found
|
||
|
|
at which speed. This allows one to optimize the I2C performance of
|
||
|
|
many devices above the standard 100KHz speed.
|
||
|
|
|
||
|
|
## Menu dialog
|
||
|
|
|
||
|
|
```
|
||
|
|
<speeds = 50 100 150 200 250 300 350 400 >
|
||
|
|
|
||
|
|
Arduino MultiSpeed I2C Scanner - 0.1.13
|
||
|
|
|
||
|
|
I2C ports: 1 Current: Wire0
|
||
|
|
@ = toggle Wire - Wire1 - Wire2 [TEENSY 3.5 or Arduino Due]
|
||
|
|
Scan mode:
|
||
|
|
s = single scan
|
||
|
|
c = continuous scan - 1 second delay
|
||
|
|
q = quit continuous scan
|
||
|
|
d = toggle latency delay between successful tests. 0 - 5 ms
|
||
|
|
i = toggle enable/disable interrupts
|
||
|
|
Output:
|
||
|
|
p = toggle printAll - printFound.
|
||
|
|
h = toggle header - noHeader.
|
||
|
|
a = toggle address range, 0..127 - 8..119 (default)
|
||
|
|
Speeds:
|
||
|
|
0 = 100..800 Khz - step 100 (warning - can block!!)
|
||
|
|
1 = 100 KHz
|
||
|
|
2 = 200 KHz
|
||
|
|
4 = 400 KHz
|
||
|
|
9 = 50..400 Khz - step 50 < DEFAULT >
|
||
|
|
|
||
|
|
!! HIGH SPEEDS - WARNING - can block - not applicable for UNO
|
||
|
|
8 = 800 KHz
|
||
|
|
M = 1000 KHz
|
||
|
|
N = 3400 KHz
|
||
|
|
O = 5000 Khz
|
||
|
|
P = 100 400 1000 3400 5000 Khz (standards)
|
||
|
|
|
||
|
|
? = help - this page
|
||
|
|
```
|
||
|
|
|
||
|
|
## Functions
|
||
|
|
|
||
|
|
### I2C ports
|
||
|
|
|
||
|
|
**@** selects through the different Wire ports.
|
||
|
|
Note that the current Wire port is given after I2C ports: count
|
||
|
|
Wire0 is just Wire but it was easier to program.
|
||
|
|
|
||
|
|
### Scan mode
|
||
|
|
|
||
|
|
**s** selects single scan mode, think of it as manual.
|
||
|
|
|
||
|
|
**c** selects continuous scanning, think of it as automatic.
|
||
|
|
|
||
|
|
**q** quits the continuous scan mode.
|
||
|
|
|
||
|
|
**d** toggles the latency between successful scans.
|
||
|
|
Only needed sometimes.
|
||
|
|
|
||
|
|
**i** toggles disable/enable interrupts, use with care.
|
||
|
|
|
||
|
|
### Output selection
|
||
|
|
|
||
|
|
**p** toggles printAll and printFound.
|
||
|
|
PrintAll will print also the addresses where nothing is found.
|
||
|
|
PrintFound will only generate a line if an I2C device is found on that address.
|
||
|
|
|
||
|
|
**h** toggles the printing of a header.
|
||
|
|
|
||
|
|
**a** toggles the range of addresses scanned, default the range 8 .. 119 is scanned,
|
||
|
|
but one can extend this range to 0 .. 127. **Note:** some addresses are reserved.
|
||
|
|
|
||
|
|
### Speeds
|
||
|
|
|
||
|
|
All options here select a single speed or a range of speeds.
|
||
|
|
|
||
|
|
Since 0.1.10 version experimental speeds of 1000, 3400 and 5000 are added as
|
||
|
|
these are part of the I2C standards.
|
||
|
|
http://i2c.info/i2c-bus-specification
|
||
|
|
|
||
|
|
NOTE: not all processors will support these higher speeds.
|
||
|
|
This can show up as blocking or it can even look like it is working.
|
||
|
|
Check your datasheet to see which speeds are applicable for the processor in use.
|
||
|
|
|