Repository navigation
Conversation
command.proto describes the envelope, operation and state messages of a signed remote command, and body.proto the lock and unlock payloads. The modules are regenerated with the protoc hook.
encode_command signs an operation the way the Android app does, decode_command_state_message reads the vehicleCommandStatePx messages, and encode_lock and encode_unlock build the lock and unlock payloads. _debug_message is taken out of core.py so the new decoder logs unknown fields like the others.
send_parallax_command posts a signed command, and subscribe_for_parallax_command_state follows it. The keys are keyword-only, and a command id that is not a UUID is refused before anything is sent.
This was referenced Oct 25, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This follows #228, where you suggested two pieces and new
.protofiles. I'm new to this repo, so please tell me if anything should be done differently. I'm happy to change it, or to split it up.Why
The Android app (3.17.0) locks and unlocks with a signed
sendParallaxPayloadand reports progress onvehicleCommandStatePx. The client can do neither yet.What
Rivian.send_parallax_commandsends a signed command, andRivian.subscribe_for_parallax_command_statefollows it.rivian.parallaxgetsencode_command,decode_command_state_message,encode_lock/encode_unlockandLOCK_RVM/UNLOCK_RVM.command.proto, and lock/unlock messages inbody.proto, with regenerated modules.Testing
Things I wasn't sure about
generate_ble_command_hmac, since it is a raw HMAC of some bytes. I can add a separate helper if that reads better.core.pyinto_debug_messageso the new decoder doesn't copy it. I can put it back and duplicate it if you'd rather not touchcore.py.PVS_BD_CMD. I don't know how other vehicles respond, so the docs say so.It is four commits, to read in order: the schema and generated modules;
core.pywithcommand.py; the twoRivianmethods; the README. If it is easier to review in two parts (codec first, then the methods), I'm glad to split it.