No logs found.
';
return;
}
if (entries.length === 0) {
container.innerHTML = 'No logs found.
';
return;
}
const html = entries.map(entry => {
const levelColor = getLevelColor(entry.level);
const timestamp = formatTimestamp(entry.timestamp);
const fields = formatFields(entry.fields);
return ` [${timestamp}] [${entry.level.toUpperCase()}]
${escapeHtml(entry.message)}${escapeHtml(fields)}
`;
}).join('');
container.innerHTML = html;
// Auto-scroll to bottom
container.scrollTop = container.scrollHeight;
}
function escapeHtml(text) {
const div = document.createElement('div');
div.textContent = text;
return div.innerHTML;
}
```
--------------------------------
### Event Listeners for Log Viewer Controls
Source: https://github.com/wimaha/teslablehttpproxy/blob/main/html/logs.html
Sets up event listeners for user interactions with the log viewer controls, including refresh, clear, live mode toggle, interval selection, and filters.
```javascript
// Event listeners
document.getElementById('refreshBtn').addEventListener('click', () => {
loadLogs();
loadStats();
});
document.getElementById('clearBtn').addEventListener('click', () => {
document.getElementById('logContainer').innerHTML = 'Logs cleared.
';
});
document.getElementById('liveModeCheckbox').addEventListener('change', toggleLiveMode);
document.getElementById('intervalSelect').addEventListener('change', function() {
if (!isLiveMode) {
const intervalValue = parseInt(this.value);
if (intervalValue === 0) {
stopAutoRefresh();
} else {
startAutoRefresh();
}
}
});
document.getElementById('levelFilter').addEventListener('change', loadLogs);
document.getElementById('limitFilter').addEventListener('change', loadLogs);
```
--------------------------------
### Docker Compose Configuration
Source: https://github.com/wimaha/teslablehttpproxy/blob/main/docs/installation.md
Configuration for the TeslaBleHttpProxy Docker container using docker-compose.yml. Mounts local directories for keys and D-Bus access.
```yaml
services:
tesla-ble-http-proxy:
image: wimaha/tesla-ble-http-proxy
container_name: tesla-ble-http-proxy
volumes:
- ~/TeslaBleHttpProxy/key:/key
- /var/run/dbus:/var/run/dbus
restart: always
privileged: true
network_mode: host
cap_add:
- NET_ADMIN
- SYS_ADMIN
```
--------------------------------
### POST /api/1/vehicles/{vin}/command/{command} — Send a Vehicle Command
Source: https://context7.com/wimaha/teslablehttpproxy/llms.txt
Sends a command to the Tesla vehicle over BLE. Commands are queued and processed sequentially. The vehicle is automatically woken up before any command (except `wake_up` itself). By default the endpoint returns immediately after queuing; pass `?wait=true` to block until the command completes.
```APIDOC
## POST /api/1/vehicles/{vin}/command/{command}
### Description
Sends a command to the Tesla vehicle over BLE. Commands are queued and processed sequentially. The vehicle is automatically woken up before any command (except `wake_up` itself). By default the endpoint returns immediately after queuing; pass `?wait=true` to block until the command completes.
Supported commands: `wake_up`, `charge_start`, `charge_stop`, `set_charging_amps`, `set_charge_limit`, `auto_conditioning_start`, `auto_conditioning_stop`, `charge_port_door_open`, `charge_port_door_close`, `flash_lights`, `honk_horn`, `door_lock`, `door_unlock`, `set_sentry_mode`.
### Method
POST
### Endpoint
/api/1/vehicles/{vin}/command/{command}
### Parameters
#### Path Parameters
- **vin** (string) - Required - The Vehicle Identification Number.
- **command** (string) - Required - The command to send to the vehicle. See supported commands in the description.
#### Query Parameters
- **wait** (boolean) - Optional - If true, the endpoint will block until the command completes.
#### Request Body
- **charging_amps** (string) - Required for `set_charging_amps` command - The desired charging amperage.
- **percent** (string) - Required for `set_charge_limit` command - The desired charge limit percentage.
- **on** (boolean) - Required for `set_sentry_mode` command - Whether to turn Sentry Mode on or off.
### Request Example
```bash
VIN="5YJ3E1EA1JF123456"
BASE="http://localhost:8080"
# Start charging (fire-and-forget)
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/charge_start"
# Set charging current to 8 A
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/set_charging_amps" \
-H "Content-Type: application/json" \
-d '{"charging_amps": "8"}'
# Enable sentry mode
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/set_sentry_mode" \
-H "Content-Type: application/json" \
-d '{"on": true}'
```
### Response
#### Success Response (200)
- **response** (object) - Contains the result and reason for the command execution.
- **result** (boolean) - True if the command was successfully received or processed.
- **reason** (string) - A message indicating the outcome of the command.
#### Response Example
```json
{
"response": {
"result": true,
"reason": "The command was successfully received and will be processed shortly."
}
}
```
#### Error Response Example
```json
{
"response": {
"result": false,
"reason": "The command \"unknown_cmd\" is not supported."
}
}
```
```
--------------------------------
### Key Management - Web UI Endpoints
Source: https://context7.com/wimaha/teslablehttpproxy/llms.txt
Endpoints for managing vehicle keys via the web UI, including key generation, sending keys to the vehicle, activating key roles, and removing keys.
```APIDOC
## Web UI Key Management Endpoints
### Description
These endpoints are part of the built-in web dashboard and handle key generation, vehicle pairing, and key role switching. While primarily for the web UI, they can be scripted.
### Method
GET / POST
### Endpoints
- **/gen_keys?role={role}** (GET): Generates a new key for the specified role.
- **/send_key** (POST): Sends a generated key to the vehicle. Requires VIN and role in the request body.
- **/activate_key** (POST): Activates a different key role, switching the active BLE identity. Requires the role in the request body.
- **/remove_keys?role={role}** (GET): Removes keys associated with the specified role.
### Parameters
#### Query Parameters (for GET requests)
- **role** (string) - Required - The role for which to generate or remove keys (e.g., 'charging_manager', 'owner').
#### Request Body (for POST requests)
- **VIN** (string) - Required (for send_key) - The Vehicle Identification Number.
- **role** (string) - Required (for send_key, activate_key) - The role of the key to send or activate.
### Request Example (Generate Charging Manager key)
```bash
curl -s -L "http://localhost:8080/gen_keys?role=charging_manager"
```
### Request Example (Send key to vehicle)
```bash
curl -s -X POST "http://localhost:8080/send_key" \
-d "VIN=5YJ3E1EA1JF123456&role=charging_manager"
```
### Request Example (Activate key role)
```bash
curl -s -X POST "http://localhost:8080/activate_key" \
-d "role=owner"
```
### Request Example (Remove keys)
```bash
curl -s -L "http://localhost:8080/remove_keys?role=owner"
```
```
--------------------------------
### Configure evcc with TeslaBleHttpProxy (BLE Proxy)
Source: https://context7.com/wimaha/teslablehttpproxy/llms.txt
Use this configuration in evcc when TeslaBleHttpProxy is running on a local machine and acts as the sole vehicle interface via BLE.
```yaml
vehicles:
- name: tesla
type: template
template: tesla-ble
title: My Tesla
capacity: 75 # battery capacity in kWh
vin: 5YJ3E1EA1JF123456
url: 192.168.1.100 # IP of the machine running TeslaBleHttpProxy
port: 8080
```
--------------------------------
### Toggle Live Mode
Source: https://github.com/wimaha/teslablehttpproxy/blob/main/html/logs.html
Manages the behavior of the log viewer based on the live mode setting. Enables auto-refresh and sets a fixed interval when live mode is active.
```javascript
function toggleLiveMode() {
isLiveMode = document.getElementById('liveModeCheckbox').checked;
if (isLiveMode) {
// Live mode: always use 1s interval and enable auto-refresh
startAutoRefresh();
} else {
// Live mode off: use selected interval
const intervalValue = parseInt(document.getElementById('intervalSelect').value);
if (intervalValue === 0) {
stopAutoRefresh();
} else {
startAutoRefresh();
}
}
}
```
--------------------------------
### Proxy Version
Source: https://context7.com/wimaha/teslablehttpproxy/llms.txt
Retrieves the currently running version of the TeslaBleHttpProxy. This information is set at build time.
```APIDOC
## GET /api/proxy/1/version — Proxy Version
### Description
Returns the currently running version of TeslaBleHttpProxy (set at build time via Go linker flags).
### Method
GET
### Endpoint
/api/proxy/1/version
### Response
#### Success Response (200)
- **response** (object) - Contains the version information.
- **version** (string) - The version string of the proxy.
### Response Example
```json
{
"response": {
"result": true,
"reason": "The request was successfully processed.",
"response": {
"version": "1.4.2"
}
}
}
```
```
--------------------------------
### Send Vehicle Command via HTTP to BLE
Source: https://context7.com/wimaha/teslablehttpproxy/llms.txt
Use this endpoint to send commands to your Tesla vehicle over BLE. Commands are processed sequentially. The vehicle is woken up automatically for most commands. Use `?wait=true` to block until the command completes.
```bash
VIN="5YJ3E1EA1JF123456"
BASE="http://localhost:8080"
# Start charging (fire-and-forget)
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/charge_start"
# {"response":{"result":true,"reason":"The command was successfully received and will be processed shortly."}}
# Start charging and wait for completion
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/charge_start?wait=true"
# {"response":{"result":true,"reason":"The command was successfully processed."}}
# Stop charging
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/charge_stop"
# Set charging current to 8 A
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/set_charging_amps" \
-H "Content-Type: application/json" \
-d '{"charging_amps": "8"}'
# Set charge limit to 80 %
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/set_charge_limit" \
-H "Content-Type: application/json" \
-d '{"percent": "80"}'
# Enable sentry mode
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/set_sentry_mode" \
-H "Content-Type: application/json" \
-d '{"on": true}'
# Lock / unlock doors
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/door_lock"
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/door_unlock"
# Explicit wake-up
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/wake_up"
# Error response (unsupported command)
curl -s -X POST "$BASE/api/1/vehicles/$VIN/command/unknown_cmd"
# {"response":{"result":false,"reason":"The command \"unknown_cmd\" is not supported."}}
```
--------------------------------
### Add User to Docker Group
Source: https://github.com/wimaha/teslablehttpproxy/blob/main/docs/installation.md
Add the current user to the 'docker' group to allow Docker commands without sudo. Log out and log back in for changes to take effect.
```bash
sudo usermod -aG docker $USER
```
--------------------------------
### evcc Configuration for Commands Only
Source: https://github.com/wimaha/teslablehttpproxy/blob/main/README.md
Configure evcc to use the proxy solely for commands, fetching vehicle data via the Tesla API. Requires IP, access token, refresh token, and VIN.
```yaml
- name: model3
type: template
template: tesla
title: Tesla
icon: car
commandProxy: http://YOUR_IP:8080
accessToken: YOUR_ACCESS_TOKEN
refreshToken: YOUR_REFRSH_TOKEN
capacity: 60
vin: YOUR_VIN
```
--------------------------------
### Configure evcc with TeslaBleHttpProxy (Hybrid Mode)
Source: https://context7.com/wimaha/teslablehttpproxy/llms.txt
This configuration is for evcc's hybrid mode, where TeslaBleHttpProxy is used only for commands, and the Tesla Fleet API provides vehicle data. Ensure the proxy is accessible via the specified URL.
```yaml
- name: tesla-hybrid
type: template
template: tesla
title: Tesla (hybrid)
commandProxy: http://192.168.1.100:8080
accessToken: YOUR_ACCESS_TOKEN
refreshToken: YOUR_REFRESH_TOKEN
capacity: 75
vin: 5YJ3E1EA1JF123456
```
--------------------------------
### Update Docker Container
Source: https://github.com/wimaha/teslablehttpproxy/blob/main/docs/installation.md
Update the TeslaBleHttpProxy Docker image and restart the container.
```bash
docker pull wimaha/tesla-ble-http-proxy
docker compose up -d
```
--------------------------------
### Log Fetching and Statistics Functions
Source: https://github.com/wimaha/teslablehttpproxy/blob/main/html/logs.html
Handles fetching logs based on selected filters (level, limit) and retrieving statistics about the logs. Includes error handling for API requests.
```javascript
async function loadLogs() {
const level = document.getElementById('levelFilter').value;
const limit = document.getElementById('limitFilter').value;
const params = new URLSearchParams();
if (level) params.append('level', level);
if (limit) params.append('limit', limit);
try {
const response = await fetch(`/api/logs?${params.toString()}`);
if (!response.ok) {
throw new Error('Failed to load logs');
}
const entries = await response.json();
// Ensure entries is always an array
const entriesArray = Array.isArray(entries) ? entries : [];
renderLogs(entriesArray);
} catch (error) {
document.getElementById('logContainer').innerHTML = `