Requesting and Downloading Diagnostics from a Charger

Diagnosing charger issues often requires reviewing the device's internal logs. eMabler provides a convenient way to retrieve diagnostics packages directly from chargers via the platform UI. These logs are sent to an FTP server for further analysis.

Prerequisites

Ensure the following before proceeding:

Charger is Online
The charger must be connected and communicating with the eMabler platform.
FTP Server
- A working FTP server that is able to receive logs sent by chargers
FTP Server URL
A destination URL where the charger will upload the diagnostics package.
- Example format: ftp://username:password@host
FTP Client Installed
Required to download the diagnostics package from the FTP server.
- For macOS: Install via Homebrew if not already available.

Sending a Diagnostics Request via eMabler UI

Navigate to the Charger
Open the charger’s page and click "Details".
Open the Actions Menu
Click "Actions" in the top-right corner.
Request Diagnostics
Select "Send Diagnostics" from the dropdown.
Provide FTP URL
Enter the full FTP URL in the format:
```
ftp://username:password@host 
```
Wait for Confirmation
Once the charger completes the upload, a confirmation message appears in "Last Message".

Example confirmation message:
```
[   2,   "35123123-asd23-243x-ba12-0141fc",   "DiagnosticsStatusNotification",   { "status": "Uploaded" } ] 
```

Downloading Diagnostics Using Terminal FTP Client

Open Terminal
Launch your terminal application.
Connect to FTP Server
```
ftp username@host 
```
Enter Password
When prompted, enter the corresponding password.
Enable Binary Mode
```
ftp> binary 
```
List Files
```
ftp> ls 
```
Look for a file named with a pattern containing the charger ID and date.
Download the File
```
ftp> get <filename> 
```
Exit FTP Session
```
ftp> quit 
```
You should now have a .zip diagnostics package on your machine.

Fixing Broken ZIP Packages

Some chargers may generate ZIP archives missing essential directory metadata, leading to extraction errors.
Common error:

pgsql

CopyEdit

End-of-central-directory signature not found.

How to Fix It (macOS Terminal)

Use the zip utility to repair the archive:

zip -FF broken.zip --out fixed.zip

Replace broken.zip with the path to the downloaded file.
fixed.zip will be the rebuilt and usable archive.

You can now extract it using standard ZIP tools.

Additional Tips

For recurring diagnostics, automate FTP uploads with scheduled tasks or support scripts.
Always verify charger status before requesting logs to avoid incomplete uploads.
Contact eMabler support for help with credentials or troubleshooting FTP issues.