Tinkla Buddy Installation
What is Tinkla Buddy? | Tinkla Buddy Install Kit | Installing your Tinkla Buddy | Configuring your Tinkla Buddy |
Contents
Creating the SD card
- On Windows PCs you can use Win32DiskImager to create to burn the image to the SD card for your Tinkla Buddy.
- On Linux flavors (including Mac OS) you can just use the dd command.
dd if=tinkla_buddy.img of=/dev/dse status=progress
where tinkla_buddy.img is the name of the disk image you downloaded from this site and /dev/sde is the device corresponding to your SD card mounted on Linux.
Writing the image to the SD card can take 30 minutes.
Disk Images
Please select the appropriate image for your device.
Device | Image | MD5sum |
---|---|---|
R2S | v1.44-R2S (built 08/28/2022) | 215b446f56deb769c29bb1f18e9f874f |
R1S H5 | v1.44-H5 (built 09/22/2020) | 6a4de9389a17438cbf7c198606eaf8d8 |
R1S H3/R1 H3 | v1.44-H3 (built 09/22/2020) | f08619695fef1c88584bd23e3dcd8bc8 |
Note: the image file is very large (650+ Mb compressed) and will take some time to download. Also, depending on the speed of your SD card, it may take a long time to burn.
Note: IF you are getting the R2S image, you need to enable the Access Point, ssh into the device and run these commands:
sudo su bash <(curl -s https://tinkla.us/files/nu/fix_r2s_1.44.sh)
Physical Buddy Installation
The hardest part of installing a Tinkla Buddy is finding an always-on power source. The three most viable options are (a) if you have a Tesla with the Cold Weather package there is a fuse box near the accelerator which makes this a 30 minute install, (b) if you have a fuse box behind the passenger kick panel (2016 and later) and you'll need to re-crimp your 12v red wire for an hour install, or (c) if you don't have a fuse box in the cabin pull a wire through a gasket on the firewall behind the washer fluid reservoir in the Frunk which can take 1-2 hours.
Instrument Cluster Connections
After you have removed the Instrument Cluster (IC), and you can access the Fakra cable on the back, you connect your LAN Fakra-RJ45 cable directly on to the back of the IC and then use the WAN Fakra-RJ45 cable and connect it to the cable that was previously connected to the IC.
Note: The fakra connector is coming straight out. Get a flat head and push on the tab. In my case it was taped tightly to the loom bringing power in, so there was no fear of it falling into the dash. If that does happen to you, you can get to it by going under the steering wheel (see pics below for reference). Plug your new cable into the IC and then plug the other into the car’s cable (only one right way to plug them). Route the cables back in the hole behind the IC where the original network cable came from. Push the IC back into place on its alignment pegs. You’ll want to get both cables over to the left “hatch” on the left of the dash; that’s a good place to put the Buddy. In my case I just stuck it next to the pedal so running power was easy.
Here is a diagram of the end result:
While the Dash is already open, this is a good time to run power for your Tinkla Buddy.
Power
Based on your Tesla Model and included packages, you'll want to follow the corresponding installation guide for Power. We'll need a 12v constant power supply. Places like the USB outlets or 12v accessory outlet are not good because those switch off when the car is "off". If you have an AP1 car or have completed the full AP1 retrofit and you aren't using it for OpenPilot power, you can just use the empty OBD port or tap the power line that goes to the OBD port behind it for a permanent install.
There are different power options for accessories depending on the year your Tesla was built and the packages you have installed.
Once you identify the fuse you will tap, remove the original fuse and, using a voltmeter, identify the side of the fuse socket that has the permanent 12V. This is important to know because otherwise you will end up running the circuit through two fuses and create issues. The side without the wire of your fuse tap should go where the 12V constant power was identified. Place the original fuse in the lower fuse socket and use the new fuse for the TB power circuit in the upper socket. See diagram below.
Once you're done running power we can move on to powering up the Tinkla Buddy for the first time.
Powering up the Tinkla Buddy for the first time
Before you're ready to power the Buddy:
- Make sure you have the RJ-45 barrel on the network cables,
- Make sure the IC and CID are online,
- Make sure the Tesla is ON. (Press and hold the Brake until you hear/feel the car turn on.)
- If you have not done it yet, now it's the time to Register your Tinkla Buddy. It will not receive certificates from the server otherwise and thus it will not work.
Then while the Buddy is unplugged from power, remove the RJ-45 barrel and insert the RJ-45 cables into the correct jack on the Buddy.
- The CID goes in the WAN port
- The IC goes in the LAN port.
The SD card with the latest disk image should be inserted into the Tinkla Buddy BEFORE power is connected to the Buddy.
Now you can plug power into the Tinkla Buddy.
At this point the Buddy will reboot 3-4 times, and then attempt to receive the certs from the Tinkla Buddy server. This takes about 4-5 minutes. Image inflation can take a good deal longer. Walk away from your car and give the Buddy about 20 minutes to finish initializing. When you return you should see two flashing green LEDs on the Tinkla Buddy and one red flashing LED.
Install Complete
To get IC AutoPilot integration view, update your OpenPilot Configuration File to look like: enable_das_emulation = True
then when the car is "On" showing PRND, the IC will do a soft restart and change to the AutoPilot view.
To see if it is working you have two ways to activate the Tinkla Menu:
- Press steering wheel menu button 4 times, if this does not work, then go to step 2.
- Press park button 4 times fast.