Skip to content

Commit 8c2db2d

Browse files
author
=
committed
Updated readme with an extra troubleshooting step
1 parent 028e95b commit 8c2db2d

File tree

2 files changed

+38
-10
lines changed

2 files changed

+38
-10
lines changed

README.md

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -238,7 +238,21 @@ ls -l /data/rc.local
238238
...
239239
chmod +x /data/rc.local
240240
```
241-
3) If the service is running, then next thing to check is the log with the command:
241+
3) Check whether there were any errors whilst setting up dependencies during system startup by checking the boot log file with the command:
242+
243+
```
244+
$ more /var/log/boot
245+
```
246+
It should contain something like this:
247+
```
248+
Wed Apr 9 08:13:53 2025: dbus-mqtt-devices:: Setup-dependencies started
249+
Wed Apr 9 08:13:53 2025: dbus-mqtt-devices: Temporarily enable writing to root partition
250+
...
251+
Wed Apr 9 08:15:56 2025: dbus-mqtt-devices: Setting root partition back to readonly
252+
Wed Apr 9 08:15:58 2025: dbus-mqtt-devices: Setup-dependencies complete
253+
254+
```
255+
4) If the service is running, then the next thing to check is the dbus-mqtt-devices log file with the command:
242256
```
243257
$ more /var/log/dbus-mqtt-devices/current
244258
```
@@ -269,18 +283,18 @@ If you need human readable timestamps you have to pipe the output through tai64n
269283
tail -f /var/log/dbus-mqtt-devices/current | tai64nlocal
270284
```
271285

272-
4) If you have re-installed more than once, make sure there is only one line in your rc.local for dbus-mqtt-devices.
286+
5) If you have re-installed more than once, make sure there is only one line in your rc.local for dbus-mqtt-devices.
273287
```
274288
more /data/rc.local
275289
```
276290

277-
5) I highly recommend using *MQTT-Explorer* (http://mqtt-explorer.com/) to monitor the N/* topics while debugging and if you are doing anything with MQTT.
291+
6) I highly recommend using *MQTT-Explorer* (http://mqtt-explorer.com/) to monitor the N/* topics while debugging and if you are doing anything with MQTT.
278292
There is a keepalive script in the samples directory if you need it.
279293

280-
6) In the unlikely event that the installation fails, and your ccgx device will not boot, follow these instructions to recover it.
294+
7) In the unlikely event that the installation fails, and your ccgx device will not boot, follow these instructions to recover it.
281295
https://community.victronenergy.com/questions/48309/ccgx-firmware-upgrade-problem.html
282296

283-
7) If you are still having a problem feel free to start an Discussion on the Github project here: https://github.com/freakent/dbus-mqtt-devices/discussions
297+
8) If you are still having a problem feel free to start an Discussion on the Github project here: https://github.com/freakent/dbus-mqtt-devices/discussions
284298
I get email alerts from Github which I don't seem to get from the Victron community forum.
285299

286300

README.md.tmpl

Lines changed: 19 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -238,7 +238,21 @@ ls -l /data/rc.local
238238
...
239239
chmod +x /data/rc.local
240240
```
241-
3) If the service is running, then next thing to check is the log with the command:
241+
3) Check whether there were any errors whilst setting up dependencies during system startup by checking the boot log file with the command:
242+
243+
```
244+
$ more /var/log/boot
245+
```
246+
It should contain something like this:
247+
```
248+
Wed Apr 9 08:13:53 2025: dbus-mqtt-devices:: Setup-dependencies started
249+
Wed Apr 9 08:13:53 2025: dbus-mqtt-devices: Temporarily enable writing to root partition
250+
...
251+
Wed Apr 9 08:15:56 2025: dbus-mqtt-devices: Setting root partition back to readonly
252+
Wed Apr 9 08:15:58 2025: dbus-mqtt-devices: Setup-dependencies complete
253+
254+
```
255+
4) If the service is running, then the next thing to check is the dbus-mqtt-devices log file with the command:
242256
```
243257
$ more /var/log/dbus-mqtt-devices/current
244258
```
@@ -269,18 +283,18 @@ If you need human readable timestamps you have to pipe the output through tai64n
269283
tail -f /var/log/dbus-mqtt-devices/current | tai64nlocal
270284
```
271285

272-
4) If you have re-installed more than once, make sure there is only one line in your rc.local for dbus-mqtt-devices.
286+
5) If you have re-installed more than once, make sure there is only one line in your rc.local for dbus-mqtt-devices.
273287
```
274288
more /data/rc.local
275289
```
276290

277-
5) I highly recommend using *MQTT-Explorer* (http://mqtt-explorer.com/) to monitor the N/* topics while debugging and if you are doing anything with MQTT.
291+
6) I highly recommend using *MQTT-Explorer* (http://mqtt-explorer.com/) to monitor the N/* topics while debugging and if you are doing anything with MQTT.
278292
There is a keepalive script in the samples directory if you need it.
279293

280-
6) In the unlikely event that the installation fails, and your ccgx device will not boot, follow these instructions to recover it.
294+
7) In the unlikely event that the installation fails, and your ccgx device will not boot, follow these instructions to recover it.
281295
https://community.victronenergy.com/questions/48309/ccgx-firmware-upgrade-problem.html
282296

283-
7) If you are still having a problem feel free to start an Discussion on the Github project here: https://github.com/freakent/dbus-mqtt-devices/discussions
297+
8) If you are still having a problem feel free to start an Discussion on the Github project here: https://github.com/freakent/dbus-mqtt-devices/discussions
284298
I get email alerts from Github which I don't seem to get from the Victron community forum.
285299

286300

0 commit comments

Comments
 (0)