Difference between revisions of "Tinkla Buddy Installation"

From Tinkla: Tinkering with Tesla
m (Instrument Cluster Connections)
m (Power)
 
(39 intermediate revisions by the same user not shown)
Line 22: Line 22:
 
! Image
 
! Image
 
! MD5sum
 
! MD5sum
 +
|-
 +
| R2S
 +
| [https://tinkla.us/files/tinklaBuddy-R2S-1.44-11.11.2022.img.gz  v1.44-R2S (built 11/11/2022)]
 +
| 422678aa480ed25058a7dbcbd623748c
 
|-
 
|-
 
| R1S H5
 
| R1S H5
| [https://tinkla.us/files/tinklaBuddy-H5-1.22-2020.03.22.img.gz  v1.22-H5 (built 03/22/2020)]
+
| [https://tinkla.us/files/tinklaBuddy-H5-1.44-09.22.2020.img.gz  v1.44-H5 (built 09/22/2020)]
| 77f1c932262e44b9267dd7a85d87c969
+
| 6a4de9389a17438cbf7c198606eaf8d8
 
|-
 
|-
| R1S H3
+
| R1S H3/R1 H3
| [https://tinkla.us/files/tinklaBuddy-H3-1.22-2020.03.22.img.gz  v1.22-H3 (built 03/22/2020)]
+
| [https://tinkla.us/files/tinklaBuddy-H3-1.44-09.22.2020.img.gz  v1.44-H3 (built 09/22/2020)]
| 38181aa0f508f2e599806e9a94ade3ca
+
| f08619695fef1c88584bd23e3dcd8bc8
 
|}
 
|}
  
Line 39: Line 43:
 
=== Instrument Cluster Connections ===
 
=== Instrument Cluster Connections ===
  
After you have [[Removing the Instrument Cluster|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. Done.
+
After you have [[Removing the Instrument Cluster|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. Remember you will have two use two CAT5e/CAT6 cables to connect the included Fakra-RJ45 adapters to the Tinkla Buddy. I recommend getting some 2ft or 3ft ones from your local store.
  
 
[[File:winter26.jpg|frameless|150px]] [[File:winter27.jpg|frameless|150px]]
 
[[File:winter26.jpg|frameless|150px]] [[File:winter27.jpg|frameless|150px]]
Line 48: Line 52:
  
 
Here is a diagram of the end result:
 
Here is a diagram of the end result:
[[File:Rpanda.png|500px|center]]
+
 
 +
[[File:Rpanda.png|frameless|300px]]
  
 
While the Dash is already open, this is a good time to run [[#Power|power for your Tinkla Buddy]].
 
While the Dash is already open, this is a good time to run [[#Power|power for your Tinkla Buddy]].
  
 
=== Power ===
 
=== 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 is no 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.
+
Tinkla Buddy requires constant 5V/2A to operate. If you have a [[Tinkla OBD-C Adapter]] for preAP Tesla Model S, you can use the specially designed USB-A port to power the Tinkla Buddy. If you do not have an Tinkla OBD-C adapter, you will have to install a power adapter for your Buddy to convert 12V power to 5V power [https://a.co/d/fyuV6Zh like this one].  
 
 
{| class="wikitable"
 
|-
 
| [[#Tesla w/Cold Weather Package or Tesla Model X (Fuse Box in cabin)|Tesla w/Cold Weather Package or Tesla Model X (Fuse Box in cabin)]]
 
|-
 
| ----[[#Step 1 - Remove Console trim and Footwell trim|Step 1 - Remove Console trim and Footwell trim]]
 
|-
 
| ----[[#Step 2 - Remove the trim panel under the steering wheel.|Step 2 - Remove the trim panel under the steering wheel]]
 
|-
 
| ----[[#Step 3 - Now it’s time to get power|Step 3 - Now it’s time to get power]]
 
|-
 
| [[#Tesla S built 2016+ (Fuse Box in cabin)|Tesla S built 2016+ (Fuse Box in cabin)]]
 
|-
 
| [[#Tesla w/o Fuse Box in Cabin|Tesla w/o Fuse Box in Cabin]]
 
|}
 
 
 
==== Tesla w/Cold Weather Package or Tesla Model X (Fuse Box in cabin) ====
 
If you have a Tesla with the Cold Weather package then there is a fuse box near the accelerator which makes this a 30 minute install. <ref>[https://docs.google.com/document/d/1PhfWGHXD_gWPe8UAKInbdS7Ks59dnjsfdIjZZXHjYQg/edit?usp=sharing Installing tinkla buddy with in-car fuses] by @erflesby</ref>
 
 
 
'''Model X''' You will need a new Fuse Holder and a ring terminal for Power.
 
 
 
=====Step 1 - Remove Console trim and Footwell trim=====
 
You need to remove two pieces of trim on the center console and footwell: the soft touch faux leather trim that runs along the side and beside the driver’s seat and the hard plastic that it overlaps slightly. Remove the soft faux leather one first. Start at the very end near the driver seat and pull it away from the center console (see right pic). It’s held on with pegs.
 
 
 
 
 
[[File:winter1.jpg|500px]][[File:winter2.jpg|500px]]
 
 
 
 
 
Removing the plastic bit is a little more complicated. First, grip it from the exposed opening and pull it away from the center console and dash. It makes contact with the airbag and trim under the dash. You’ll need to angle it upwards and rotate it up while also pulling the bottom towards you. Push the accelerator pedal out of the way to pull the trim towards you. This will also be 100% easier if you set your footwell carpet aside. You’ll want to place the soft leather piece somewhere it won’t get scratched like the back seat.
 
 
 
 
 
[[File:winter3.png|500px]][[File:winter4.jpg|500px]]
 
 
 
 
 
Now that you have the side panels off, you can see the exposed fuse box near the accelerator (below).
 
 
 
 
 
[[File:winter5.jpg|500px]]
 
 
 
 
 
 
 
=====Step 2 - Remove the trim panel under the steering wheel. =====
 
You’ll want to remove this screw on the right, and a corresponding one on the left below the dash (red arrows).
 
 
 
[[File:winter6.jpg|500px]][[File:winter7.png|500px]]
 
[[File:winter8.png|500px|right]]
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Note the power adapter for the footwell light (black connector in right pic). You’ll use a flathead screwdriver to remove it. Afterwards your footwell looks like the right pic.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
[[File:winter9.jpg|500px|left]]
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
On the left is a view of the accelerator pedal with the fuse box just to the right of it. Also shown at the top of the pedal is the connector where you plug your comma pedal in. If you haven’t done so yet, this is an opportune time to put the pedal in, too.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
[[File:winter10.jpg|right|500px]][[File:winter11.jpg|500px]]
 
 
 
 
 
 
 
=====Step 3 - Now it’s time to get power=====
 
If your fuse adaptor has a butt connector, you’re half way there. First, cut and strip the end of the wire coming from your USB power supply (if not already stripped). Crimp it into the butt connector. Then, choose a suitable fuse in the fusebox. The 5A brown fuse on right should work. Put the 5A fuse in the free slot of your adaptor. Then, plug the adaptor in as shown (the fuses are pointing down). Finally, route the loop connector to the 10mm screw just below and to the right of the fuse box. Screw it in and you have ground.
 
  
[[File:winter30.jpg|640px]][[File:winter31.jpg|360px]]
+
If you do NOT have a [[Tinkla OBD-C Adapter]], you will have to find a way to power your Tinkla Buddy from another source using a 12V to 5V power adapter [https://a.co/d/fyuV6Zh like this one]. 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|power options for accessories]] depending on the year your Tesla was built and the packages you have installed.
  
[[File:winter32.jpg|500px]]
+
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.  
  
 +
[[File:Fuse tap diagram.png|frameless|300px]]
  
 +
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]].
  
 +
== Powering up the Tinkla Buddy for the first time==
  
Once you're done running power we can move on to [[#Connecting the Tinkla Buddy|connecting the Tinkla Buddy]].
 
 
==== Tesla S built 2016+ (Fuse Box in cabin) ====
 
If you have a 2016 or later Tesla then there should be a fuse box behind the passenger kick panel and you'll need to re-crimp your 12v red wire which will make this about an hour install.
 
 
 
Once you're done running power we can move on to [[#Connecting the Tinkla Buddy|connecting the Tinkla Buddy]].
 
 
==== Tesla w/o Fuse Box in Cabin ====
 
If you don't have a fuse box in the cabin then pull a wire through a gasket on the firewall behind the washer fluid reservoir in the Frunk. Depending on your method of poking a hole in the gasket and your method of pulling your 16-18 gauge wire through your hole, this can take between 1-2 hours if not longer.
 
 
Tools required:
 
* 13mm socket (for the ground)
 
* Plastic pry tool
 
* Fishing tape (or metal hanger)
 
* Sharp tool to poke a hole in a rubber gasket.
 
 
[[File:TB1.JPEG|500px|center]]
 
Above you can see Fuse Box 2 in the Frunk. The red wire from TBuddy is tapped into an empty F36 fuse. (this car doesn't have Air Suspension.)
 
[[File:TB2.JPEG|500px|center]]
 
Above is a zoomed out view of where the red wire runs to get to Fuse Box 2
 
[[File:TB3.JPEG|500px|center]]
 
The picture above is looking behind the washer fluid reservoir, you can see a gasket that will give us access to the cabin.
 
[[File:TB4.JPEG|500px|center]]
 
Above is a closer view of the gasket in the frunk that we can use to route cables into the cabin.
 
[[File:TB5.JPEG|500px|center]]
 
Above is the cabin side of the gasket, hiding low and left when you take off the driver's side kneeboard.
 
[[File:TB6.JPEG|500px|center]]
 
Above is a zoomed out view of the compartment behind the kneeboard. there is a plastic panel on the left which is easy to remove and has two 13mm bolts you can use for ground.
 
 
Once you're done running power we can move on to [[#Connecting the Tinkla Buddy|connecting the Tinkla Buddy]].
 
 
=== Connecting the Tinkla Buddy ===
 
 
Before you're ready to power the Buddy:
 
Before you're ready to power the Buddy:
 
# Make sure you have the RJ-45 barrel on the network cables,  
 
# Make sure you have the RJ-45 barrel on the network cables,  
# the IC and CID are online,  
+
# Make sure the IC and CID are online,  
# and the Tesla is ON. (Press and hold the Brake until you hear/feel the car turn on.)
+
# 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 [[Tinkla_Buddy_Configuration#Registering_your_Tinkla_Buddy|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, insert the RJ-45 cables into the correct jack on the Buddy.  
+
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 CID goes in the WAN port
 
* The IC goes in the LAN port.
 
* The IC goes in the LAN port.
Line 203: Line 88:
 
  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.
 
  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 ===
+
== Install Complete ==
 
  To get IC AutoPilot integration view, update your [[OpenPilot Configuration File]] to look like: <code>enable_das_emulation = True</code> then when the car is "On" showing PRND, the IC will do a soft restart and change to the AutoPilot view.
 
  To get IC AutoPilot integration view, update your [[OpenPilot Configuration File]] to look like: <code>enable_das_emulation = True</code> 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:
 
To see if it is working you have two ways to activate the Tinkla Menu:
Line 209: Line 94:
 
# Press steering wheel menu button 4 times, if this does not work, then go to step 2.
 
# Press steering wheel menu button 4 times, if this does not work, then go to step 2.
 
# Press park button 4 times fast.
 
# Press park button 4 times fast.
 +
 +
== Forcing an update ==
 +
 +
With the changes Tesla make to their software, there might be times when you need to manually force a software update on the Buddy. Such a situation happneed if your car was updated to 2022.8.10.8 but your buddy was still running v1.44 at that time. In order to update to the latest version, you will have to manually ssh into the Buddy and run a few commands.
 +
 +
=== Force SSH into the Tinkla Buddy ===
 +
 +
To force ssh into the Tinkla Buddy (either tunnels are not up because of some fault in the configuration or a certain Tesla software update rendered your code absolete) you will need a laptop that has `ssh` capabilities and a few configuration options all listed below.
 +
 +
* Disconnect the LAN cable from the Buddy (the one that connects the IC to the Buddy) and use the LAN port on the Buddy and an ethernet cable to connect your laptop to that port.
 +
* Manually set the IP address on your laptop to match the IP address of the IC (192.168.90.101 with a net mask of 255.255.255.0)
 +
* Once the IP is set, ssh into the Tinkla Buddy using the following command
 +
 +
<source>ssh pi@192.168.90.69</source>
 +
 +
and use '''''pi''''' as the password, unless you changed it, then use the new password you set.
 +
 +
=== Force Upgrade command sequence ===
 +
 +
<source>
 +
sudo su
 +
cd /opt/tinkla-updater
 +
curl --fail -s "https://tinkla.us/buddy/cksftupd.php?v=1&sv=1.44&c=active&h=H5" -o ./update.sh
 +
bash update.sh
 +
reboot
 +
</source>

Latest revision as of 14:22, 13 March 2023

What is Tinkla Buddy? Tinkla Buddy Install Kit Installing your Tinkla Buddy Configuring your Tinkla Buddy

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 11/11/2022) 422678aa480ed25058a7dbcbd623748c
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.

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. Remember you will have two use two CAT5e/CAT6 cables to connect the included Fakra-RJ45 adapters to the Tinkla Buddy. I recommend getting some 2ft or 3ft ones from your local store.

Winter26.jpg Winter27.jpg

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.

Winter28.jpg Winter29.jpg

Here is a diagram of the end result:

Rpanda.png

While the Dash is already open, this is a good time to run power for your Tinkla Buddy.

Power

Tinkla Buddy requires constant 5V/2A to operate. If you have a Tinkla OBD-C Adapter for preAP Tesla Model S, you can use the specially designed USB-A port to power the Tinkla Buddy. If you do not have an Tinkla OBD-C adapter, you will have to install a power adapter for your Buddy to convert 12V power to 5V power like this one. 

If you do NOT have a Tinkla OBD-C Adapter, you will have to find a way to power your Tinkla Buddy from another source using a 12V to 5V power adapter like this one. 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.

Fuse tap diagram.png

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:

  1. Make sure you have the RJ-45 barrel on the network cables,
  2. Make sure the IC and CID are online,
  3. Make sure the Tesla is ON. (Press and hold the Brake until you hear/feel the car turn on.)
  4. 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:

Menu.png
  1. Press steering wheel menu button 4 times, if this does not work, then go to step 2.
  2. Press park button 4 times fast.

Forcing an update

With the changes Tesla make to their software, there might be times when you need to manually force a software update on the Buddy. Such a situation happneed if your car was updated to 2022.8.10.8 but your buddy was still running v1.44 at that time. In order to update to the latest version, you will have to manually ssh into the Buddy and run a few commands.

Force SSH into the Tinkla Buddy

To force ssh into the Tinkla Buddy (either tunnels are not up because of some fault in the configuration or a certain Tesla software update rendered your code absolete) you will need a laptop that has `ssh` capabilities and a few configuration options all listed below.

  • Disconnect the LAN cable from the Buddy (the one that connects the IC to the Buddy) and use the LAN port on the Buddy and an ethernet cable to connect your laptop to that port.
  • Manually set the IP address on your laptop to match the IP address of the IC (192.168.90.101 with a net mask of 255.255.255.0)
  • Once the IP is set, ssh into the Tinkla Buddy using the following command
ssh pi@192.168.90.69

and use pi as the password, unless you changed it, then use the new password you set.

Force Upgrade command sequence

sudo su
cd /opt/tinkla-updater
curl --fail -s "https://tinkla.us/buddy/cksftupd.php?v=1&sv=1.44&c=active&h=H5" -o ./update.sh
bash update.sh
reboot