I think the most realistic and fast solution is to provide a Segger / Open API spec. As a result you get the best of both worlds: easy consumption and a schema which lets you generate clients.