Skip to content

Commit

Permalink
added troubleshooting serial starter info
Browse files Browse the repository at this point in the history
  • Loading branch information
@mr-manuel
mr-manuel committed Jun 11, 2023
1 parent 627aa74 commit 00562e1
Show file tree
Hide file tree
Showing 2 changed files with 89 additions and 37 deletions.
64 changes: 61 additions & 3 deletions docs/docs/troubleshoot/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -139,18 +139,76 @@ The log file will tell you what the driver did and where it failed.
#### No log file
If there is no log folder under `/data/log/dbus-serialbattery.*` then check:

* Did the install have any error? Reinstall the driver, also trying an alternative method.
* Did the install have any error? Reinstall the driver, also trying an alternative method and version.

* Is the connection picked up by serial-starter? Use the command
* Is the connection picked up by serial-starter?

💡 The `tail` command with the parameter `-F` does not quit automatically, since it waits for new log entries.
You can exit by pressing `CTRL + C`.

Use the command

```bash
tail -F /data/log/serial-starter/current | tai64nlocal
```

to show the last part of the log file as it updates. Plug your USB device in and out to see, if it's picked up and what `tty` port it uses.
to show the last part of the log file as it updates. Plug your USB device in and out to see, if it's picked up and what `ttyUSB` port it uses.

You can also check, which USB port it used by plugging out your USB device, wait some seconds, execute the command below, plug in your USB device, execute the command below again and compare which `ttyUSB` device appeared now.

**Execute**
```bash
ls -l /dev/ttyUSB*
```

**Example output (USB device unplugged)**
```bash
crw-rw---- 1 root dialout 188, 0 Jun 11 17:08 /dev/ttyUSB0
```

**Example output (USB device plugged)**
```bash
crw-rw---- 1 root dialout 188, 0 Jun 11 17:08 /dev/ttyUSB0
crw-rw---- 1 root dialout 188, 1 Jun 11 17:08 /dev/ttyUSB1
```

* Did the serial starter correctly assign the USB port to the correct service?

If the content under `==> /data/var/lib/serial-starter/* <==` shows `sbattery` then this USB port is assigned to the `dbus-serialbattery` driver.

**Execute**
```bash
head /data/var/lib/serial-starter/*
```

**Output**
```bash
==> /data/var/lib/serial-starter/ttyACM0 <==
gps

==> /data/var/lib/serial-starter/ttyUSB0 <==
vedirect

==> /data/var/lib/serial-starter/ttyUSB1 <==
sbattery

==> /data/var/lib/serial-starter/ttyUSB2 <==
vedirect
```

If the assignment is wrong you can reset all executing this command

```bash
rm /data/var/lib/serial-starter/*
```

and then reboot. You can also overwrite an assignment by executing the command below.
Change the `#` with the number of your USB port before executing the command. Reboot after the change.

```bash
echo "sbattery" > /data/var/lib/serial-starter/ttyUSB#
```


* Check, if your BMS type is found (change to the `ttyUSB*` your device use)

Expand Down
62 changes: 28 additions & 34 deletions docs/yarn.lock
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2112,9 +2112,9 @@
integrity sha512-YATxVxgRqNH6nHEIsvg6k2Boc1JHI9ZbH5iWFFv/MTkchz3b1ieGDa5T0a9RznNdI0KhVbdbWSN+KWWrQZRxTw==

"@types/node@*":
version "20.2.5"
resolved "https://registry.yarnpkg.com/@types/node/-/node-20.2.5.tgz#26d295f3570323b2837d322180dfbf1ba156fefb"
integrity sha512-JJulVEQXmiY9Px5axXHeYGLSjhkZEnD+MDPDGbCbIAbMslkKwmygtZFy1X6s/075Yo94sf8GuSlFfPzysQrWZQ==
version "20.3.0"
resolved "https://registry.yarnpkg.com/@types/node/-/node-20.3.0.tgz#719498898d5defab83c3560f45d8498f58d11938"
integrity sha512-cumHmIAf6On83X7yP+LrsEyUOf/YlociZelmpRYaGFydoaPdxdt80MAbu6vWerQT2COCp2nPvHdsbD7tHn/YlQ==

"@types/node@^17.0.5":
version "17.0.45"
Expand Down Expand Up @@ -2173,9 +2173,9 @@
"@types/react" "*"

"@types/react@*":
version "18.2.9"
resolved "https://registry.yarnpkg.com/@types/react/-/react-18.2.9.tgz#9207f8571afdc59a9c9c30df50e8ad2591ecefaf"
integrity sha512-pL3JAesUkF7PEQGxh5XOwdXGV907te6m1/Qe1ERJLgomojS6Ne790QiA7GUl434JEkFA2aAaB6qJ5z4e1zJn/w==
version "18.2.11"
resolved "https://registry.yarnpkg.com/@types/react/-/react-18.2.11.tgz#168f7dbb421ed214fcf8c5fe8e587765a3e02fd1"
integrity sha512-+hsJr9hmwyDecSMQAmX7drgbDpyE+EgSF6t7+5QEBAn1tQK7kl1vWZ4iRf6SjQ8lk7dyEULxUmZOIpN0W5baZA==
dependencies:
"@types/prop-types" "*"
"@types/scheduler" "*"
Expand Down Expand Up @@ -2233,7 +2233,7 @@
resolved "https://registry.yarnpkg.com/@types/unist/-/unist-2.0.6.tgz#250a7b16c3b91f672a24552ec64678eeb1d3a08d"
integrity sha512-PBjIUxZHOuj0R15/xuwJYjFi+KZdNFrehocChv4g5hu6aFroHue8m0lBP0POdK2nKzbw0cgV1mws8+V/JAcEkQ==

"@types/ws@^8.5.1":
"@types/ws@^8.5.5":
version "8.5.5"
resolved "https://registry.yarnpkg.com/@types/ws/-/ws-8.5.5.tgz#af587964aa06682702ee6dcbc7be41a80e4b28eb"
integrity sha512-lwhs8hktwxSjf9UaZ9tG5M03PGogvFaH8gUgLNbN9HKIg0dvv6q+gkSuJ8HN4/VbyxkuLzCjlN7GquQ0gUJfIg==
Expand Down Expand Up @@ -2837,9 +2837,9 @@ caniuse-api@^3.0.0:
lodash.uniq "^4.5.0"

caniuse-lite@^1.0.0, caniuse-lite@^1.0.30001464, caniuse-lite@^1.0.30001489:
version "1.0.30001497"
resolved "https://registry.yarnpkg.com/caniuse-lite/-/caniuse-lite-1.0.30001497.tgz#0e5387b98e7dbf9c4f743fb16e92cbf0ca780714"
integrity sha512-I4/duVK4wL6rAK/aKZl3HXB4g+lIZvaT4VLAn2rCgJ38jVLb0lv2Xug6QuqmxXFVRJMF74SPPWPJ/1Sdm3vCzw==
version "1.0.30001499"
resolved "https://registry.yarnpkg.com/caniuse-lite/-/caniuse-lite-1.0.30001499.tgz#0235c127d9795c82aaf0a7f43e24018549dac659"
integrity sha512-IhoQqRrW6WiecFcfZgoJS1YLEN1/HR1vHP5WNgjCARRW7KUNToHHTX3FrwCM+y4zkRa48D9rE90WFYc2IWhDWQ==

ccount@^1.0.0:
version "1.1.0"
Expand Down Expand Up @@ -3199,7 +3199,7 @@ cosmiconfig@^7.0.1:
path-type "^4.0.0"
yaml "^1.10.0"

cosmiconfig@^8.1.3:
cosmiconfig@^8.2.0:
version "8.2.0"
resolved "https://registry.yarnpkg.com/cosmiconfig/-/cosmiconfig-8.2.0.tgz#f7d17c56a590856cd1e7cee98734dca272b0d8fd"
integrity sha512-3rTMnFJA1tCOPwRxtgF4wd7Ab2qvDbL8jX+3smjIbS4HlZBagTlpERbdN7iAbWlrfxE3M8c27kTwTawQ7st+OQ==
Expand Down Expand Up @@ -3604,9 +3604,9 @@ ee-first@1.1.1:
integrity sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==

electron-to-chromium@^1.4.411:
version "1.4.425"
resolved "https://registry.yarnpkg.com/electron-to-chromium/-/electron-to-chromium-1.4.425.tgz#399df13091b836d28283a545c25c8e4d9da86da8"
integrity sha512-wv1NufHxu11zfDbY4fglYQApMswleE9FL/DSeyOyauVXDZ+Kco96JK/tPfBUaDqfRarYp2WH2hJ/5UnVywp9Jg==
version "1.4.427"
resolved "https://registry.yarnpkg.com/electron-to-chromium/-/electron-to-chromium-1.4.427.tgz#67e8069f7a864fc092fe2e09f196e68af5cb88a1"
integrity sha512-HK3r9l+Jm8dYAm1ctXEWIC+hV60zfcjS9UA5BDlYvnI5S7PU/yytjpvSrTNrSSRRkuu3tDyZhdkwIczh+0DWaw==

emoji-regex@^8.0.0:
version "8.0.0"
Expand Down Expand Up @@ -3666,9 +3666,9 @@ error-ex@^1.3.1:
is-arrayish "^0.2.1"

es-module-lexer@^1.2.1:
version "1.2.1"
resolved "https://registry.yarnpkg.com/es-module-lexer/-/es-module-lexer-1.2.1.tgz#ba303831f63e6a394983fde2f97ad77b22324527"
integrity sha512-9978wrXM50Y4rTMmW5kXIC09ZdXQZqkE4mxhwkd8VbzsGkXGPgV4zWuqQJgCEzYngdo2dYDa0l8xhX4fkSwJSg==
version "1.3.0"
resolved "https://registry.yarnpkg.com/es-module-lexer/-/es-module-lexer-1.3.0.tgz#6be9c9e0b4543a60cd166ff6f8b4e9dae0b0c16f"
integrity sha512-vZK7T0N2CBmBOixhmjdqx2gWVbFZ4DXZ/NyRMZVlJXPa7CyFS+/a4QQsDGDQy9ZfEzxFuNEsMLeQJnKP2p5/JA==

escalade@^3.1.1:
version "3.1.1"
Expand Down Expand Up @@ -4387,9 +4387,9 @@ html-void-elements@^1.0.0:
integrity sha512-uE/TxKuyNIcx44cIWnjr/rfIATDH7ZaOMmstu0CwhFG1Dunhlp4OC6/NMbhiwoq5BpW0ubi303qnEk/PZj614w==

html-webpack-plugin@^5.5.0:
version "5.5.1"
resolved "https://registry.yarnpkg.com/html-webpack-plugin/-/html-webpack-plugin-5.5.1.tgz#826838e31b427f5f7f30971f8d8fa2422dfa6763"
integrity sha512-cTUzZ1+NqjGEKjmVgZKLMdiFg3m9MdRXkZW2OEe69WYVi5ONLMmlnSZdXzGGMOq0C8jGDrL6EWyEDDUioHO/pA==
version "5.5.3"
resolved "https://registry.yarnpkg.com/html-webpack-plugin/-/html-webpack-plugin-5.5.3.tgz#72270f4a78e222b5825b296e5e3e1328ad525a3e"
integrity sha512-6YrDKTuqaP/TquFH7h4srYWsZx+x6k6+FbsTm0ziCwGHDP78Unr1r9F/H4+sGmMbX08GQcJ+K64x55b+7VM/jg==
dependencies:
"@types/html-minifier-terser" "^6.0.0"
html-minifier-terser "^6.0.2"
Expand Down Expand Up @@ -4916,11 +4916,6 @@ kleur@^3.0.3:
resolved "https://registry.yarnpkg.com/kleur/-/kleur-3.0.3.tgz#a79c9ecc86ee1ce3fa6206d1216c501f147fc07e"
integrity sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==

klona@^2.0.6:
version "2.0.6"
resolved "https://registry.yarnpkg.com/klona/-/klona-2.0.6.tgz#85bffbf819c03b2f53270412420a4555ef882e22"
integrity sha512-dhG34DXATL5hSxJbIexCft8FChFXtmskoZYnoPWjXQuebWYCNkVeV3KkGegCK9CP1oswI/vQibS2GY7Em/sJJA==

latest-version@^5.1.0:
version "5.1.0"
resolved "https://registry.yarnpkg.com/latest-version/-/latest-version-5.1.0.tgz#119dfe908fe38d15dfa43ecd13fa12ec8832face"
Expand Down Expand Up @@ -5677,13 +5672,12 @@ postcss-discard-unused@^5.1.0:
postcss-selector-parser "^6.0.5"

postcss-loader@^7.0.0:
version "7.3.2"
resolved "https://registry.yarnpkg.com/postcss-loader/-/postcss-loader-7.3.2.tgz#ac3344ad1f14bb65df135744b7efae4dbdad4301"
integrity sha512-c7qDlXErX6n0VT+LUsW+nwefVtTu3ORtVvK8EXuUIDcxo+b/euYqpuHlJAvePb0Af5e8uMjR/13e0lTuYifaig==
version "7.3.3"
resolved "https://registry.yarnpkg.com/postcss-loader/-/postcss-loader-7.3.3.tgz#6da03e71a918ef49df1bb4be4c80401df8e249dd"
integrity sha512-YgO/yhtevGO/vJePCQmTxiaEwER94LABZN0ZMT4A0vsak9TpO+RvKRs7EmJ8peIlB9xfXCsS7M8LjqncsUZ5HA==
dependencies:
cosmiconfig "^8.1.3"
cosmiconfig "^8.2.0"
jiti "^1.18.2"
klona "^2.0.6"
semver "^7.3.8"

postcss-merge-idents@^5.1.1:
Expand Down Expand Up @@ -7456,17 +7450,17 @@ webpack-dev-middleware@^5.3.1:
schema-utils "^4.0.0"

webpack-dev-server@^4.9.3:
version "4.15.0"
resolved "https://registry.yarnpkg.com/webpack-dev-server/-/webpack-dev-server-4.15.0.tgz#87ba9006eca53c551607ea0d663f4ae88be7af21"
integrity sha512-HmNB5QeSl1KpulTBQ8UT4FPrByYyaLxpJoQ0+s7EvUrMc16m0ZS1sgb1XGqzmgCPk0c9y+aaXxn11tbLzuM7NQ==
version "4.15.1"
resolved "https://registry.yarnpkg.com/webpack-dev-server/-/webpack-dev-server-4.15.1.tgz#8944b29c12760b3a45bdaa70799b17cb91b03df7"
integrity sha512-5hbAst3h3C3L8w6W4P96L5vaV0PxSmJhxZvWKYIdgxOQm8pNZ5dEOmmSLBVpP85ReeyRt6AS1QJNyo/oFFPeVA==
dependencies:
"@types/bonjour" "^3.5.9"
"@types/connect-history-api-fallback" "^1.3.5"
"@types/express" "^4.17.13"
"@types/serve-index" "^1.9.1"
"@types/serve-static" "^1.13.10"
"@types/sockjs" "^0.3.33"
"@types/ws" "^8.5.1"
"@types/ws" "^8.5.5"
ansi-html-community "^0.0.8"
bonjour-service "^1.0.11"
chokidar "^3.5.3"
Expand Down

0 comments on commit 00562e1

Please sign in to comment.