terminus returns 404/Invalid device ID when FW-Version includes non semver information....

[LelandSindt]

working with HomePate and Terminus... HomePlate was reporting.. "Download Failed!" --- after considerable troubleshooting and tinkering, I found that Terminus returns a 404 Invalid device ID when FW-Version includes anything other than a semver formatted version.

I have re-created the http call with curl to demonstrate.

failing...

$ curl -i "http://192.168.1.50:2345/api/display" -H "Access-Token: token" -H "FW-Version: Homeplate 1.1.4" -H "Height: 825" -H "ID: 24:62:AB:DA:30:E4" -H "Model: Inkplate 10" -H "Percent-Charged: 89" -H "RSSI: -74" -H "Refresh-Rate: 1200" -H "SENSORS: make=TI;model=TPS65186;kind=temperature;value=23;unit=celsius;created_at=1775251398" -H "Width: 1200" ; echo
HTTP/1.1 404 Not Found
x-frame-options: DENY
x-content-type-options: nosniff
x-xss-protection: 1; mode=block
content-security-policy: base-uri 'self';child-src 'self';connect-src 'self' https://trmnl.com;default-src 'none';font-src 'self' https://trmnl.com;form-action 'self';frame-ancestors 'self';frame-src 'self';img-src 'self' https: data:;media-src 'self';object-src 'none';script-src 'self' 'unsafe-eval' 'unsafe-inline' https://trmnl.com;style-src 'self' 'unsafe-inline' https:;manifest-src 'self'
content-type: application/problem+json; charset=utf-8
vary: Accept-Encoding
set-cookie: terminus.session=AW_QiRkfp1xRUDHOzE4rd7s8cpm2mBfGLDaYpQLSeoWZI5LUMDalio1u8seXxAB_6rqf0TSPLAcAa4MkpnWVe69VmcIsGM_hCSma5FdPJ5dC9kaqZfFpkZQhXDeC7_MNFxcrbaJpufzLyQYt4F0E9xG0ucA8xe44CEY-QcNsNn8V48b_zIrs4qmUgp7VyJ9EqpdlftIpPhNVLfKwu4lWPf5QZ5bUvWBGi83B9yd2rfDt3OPZ46QENdlZpwJch5aSD-3Jv5DQlygqpaAwWKpaAVAXghbUmlDQJ_4lYGA98-wjs7ainrnGTqZs5BdlFA4_Sok2sQyp1Qs2El0mFRUG7PTH6yPyPE7_3tn4ZulAMBLL_nBAcmmk66MdMcOHNM6m6GV1LpMPwQw4kz11ncTyl2ejdtEVsX3GLi5K0eWz7QQsyFQWoaHgDY52Mp-i5H3hGg%3D%3D; path=/; expires=Fri, 03 Apr 2026 23:12:22 GMT; httponly
content-length: 126

{"type":"/problem_details#device_id","title":"Not Found","status":404,"detail":"Invalid device ID.","instance":"/api/display"}

working...

$ curl -i "http://192.168.1.50:2345/api/display" -H "Access-Token: token" -H "FW-Version: 1.1.4" -H "Height: 825" -H "ID: 24:62:AB:DA:30:E4" -H "Model: Inkplate 10" -H "Percent-Charged: 89" -H "RSSI: -74" -H "Refresh-Rate: 1200" -H "SENSORS: make=TI;model=TPS65186;kind=temperature;value=23;unit=celsius;created_at=1775251398" -H "Width: 1200" ; echo
HTTP/1.1 200 OK
x-frame-options: DENY
x-content-type-options: nosniff
x-xss-protection: 1; mode=block
content-security-policy: base-uri 'self';child-src 'self';connect-src 'self' https://trmnl.com;default-src 'none';font-src 'self' https://trmnl.com;form-action 'self';frame-ancestors 'self';frame-src 'self';img-src 'self' https: data:;media-src 'self';object-src 'none';script-src 'self' 'unsafe-eval' 'unsafe-inline' https://trmnl.com;style-src 'self' 'unsafe-inline' https:;manifest-src 'self'
content-type: application/json; charset=utf-8
vary: Accept-Encoding
set-cookie: terminus.session=AXjQQz2QQrqXZHpI-3M-fpPKcnG0VfnjCP7aTZwkKQ_XnC1feUjfwtInGMgxzNP-C0z-0tvDdl631pS5XviQ29N_Q88OnL3SgGhWQW0JcSAaO9MWFf3_2rhqhIAOPqE_VCunW6nrGv33EhuEItEyglSnyG4IP_FXQ3kBed6sW6pqrM6wiGKj2xzZ8ynLa-D3XOX4Shbl-rCnfaSyQyLPtVFcf7Y0rr80Zvep4mQr-ehl5jpbdMyTzgn-NcsiKU3nQwKB7qR1PjQ4fTDlAueIUgapmABGXVHCDCALCbORu5L5xPJCxyJ6k44AVDNXY7-MWWRNDlG0lTVIP6pwOoWH8gHKhAt5t16v0mqDffkIaUqlN5-OlYYKKv-S3UW75G8SZKVP489AY2PrrokJkdqcln6GdS0obT7r8zfMVuP5I12wf80bYgWyhg5AlywBVgXVMQ%3D%3D; path=/; expires=Fri, 03 Apr 2026 23:14:03 GMT; httponly
content-length: 387

{"filename":"terminus_welcome_0f47aa-fb9a021b294a1ca7b787353b3b1d9f45.png","firmware_url":"http://192.168.1.50:2345/uploads/79d186679b71ca64185baf5b9a51735f.bin","firmware_version":"1.7.8","image_url":"http://192.168.1.50:2345/uploads/7e4f10f414c738c2bb10b1e24b61df44.png","image_url_timeout":0,"refresh_rate":900,"reset_firmware":false,"special_function":"sleep","update_firmware":true}

would you consider dropping Homeplate from the FW-Version Header?

Terminus API documentation confirming the expected format for FW-Version
https://github.com/usetrmnl/terminus/blob/main/doc/api.adoc#display:~:text=FW_VERSION%3A%20The%20firmware%20version%20(i.e.%201.2.3).

[LelandSindt]

I have tested this locally and it is working.

LelandSindt@6bf2c38

[lanrat]

would you consider dropping Homeplate from the FW-Version Header?

Yes. Do you want to submit a PR with your change?

[LelandSindt]

Yes. Do you want to submit a PR with your change?

Gladly: #75

[lanrat]

Thanks!

Pushed v1.1.5 with this fix.

[LelandSindt]

... and Thank you.... This Inkplate 10 has been collecting dust for ..... years.