Template:Getting Started

Work in Progress
This page is the first pass at replacing the Main Page "Getting Started" section.

Quick Start
If you are looking to get your EON up and running see the following guides

Installing the Giraffe

There are currently three options concerning Giraffes for your Model S.

OBD

1. Giraffe revC from @AsianTea#7596 on the Comma.ai Discord
   • This solution doesn't need any modification to perform a Radar retrofit.
   • This will work as long as your OBD port pins 1 and 9 like the OBD picture on the right.
2. An EPAS harness from Flyboy222pa on eBay
   • This path doesn't require a Giraffe.
   • But this will require a 120 Ohm resistor if you want to install a Radar retrofit.
     

     TDC
3. Giraffe For cars built before May 31, 2013, will need a "TDC Connector".
   • You'll want this variant if your OBD port is missing pins 1 and 9 like the TDC picture to the right.

Whichever one of these you end up using, install it into the corresponding port under the dash, in the driver's foot well.

Installing the EON

EON installation is pretty simple. Your main objective is to ensure the EON is level with the ground, and pointed as straight as you can get it. If you're uncomfortable "eyeballing it," you may want to use:

• A measuring tape
• A roll of masking tape
• A friend to help

Instructions

1. Find a place at the bottom of the windshield, along the driver's side pillar that has a similar position on the passenger side (such as the place where the corner of the front hood meets the fender).
2. With the tape starting from that point, mark 3 places along the side of the windshield. Use the edge of the masking tape to mark them. I personally used 3" from the bottom, the top of the windshield and then about 1/3 from the bottom, 2/3 from the top. It does not matter what the measuring tape says, as long as it says the SAME distance on driver's and passenger's sides.
3. Repeat the process on the other side of the windshield, ensuring you mark the same spots.
4. measure the distance between one edge of the windshield and the other end, keeping the tape at each pair of marked points from before. use masking tape to mark the middle of the windshield. again, use the EDGE of the tape, not the center.
5. Now use a long piece of masking tape to mark the center of the windshield from top to bottom. This (if you did everything correctly) will cover all 3 of your markers from before and provide a straight line. One edge of the masking tape is now the perfect middle of the windshield. Your mount will have to be aligned with that for a perfect position.
6. Take a small piece of tape and mark the middle of the GoPro mount. use a slightly longer piece than the go-pro (maybe 1/4-1/2" more on each side) and ensure it is straight and down the middle of the GoPro. If, when looking from inside of the car, your tape is to the RIGHT of the center, then put the tape on the LEFT side of the GoPro. Reverse if the other way.
7. Using your EON without the mounting bracket, determine the location along the center of the windshield where you want it placed. Make sure the grove on the support is alongside the center of the windshield. use a small piece of masking tape to mark the upper part of the position where you want your EON to be.
8. Remove the RED protective tape from the back of the 3M adhesive and be ready to place the GoPro on the windshield. Align the masking tape we placed on the GoPro mount on the inside with the masking tape we have on the outside of the windshield. They should not overlap at all AND you should not see light either. when you are confident on the position press hard on the mount.
9. Remove all masking tape. You are done. You now have a perfectly centered, perfectly vertical EON.

Installing the EPAS Cable

• You can follow Deftdawg's EPAS creation video here: https://www.youtube.com/watch?v=TIKGK0Iabtc
  • NOTE: It is not recommended to solder the JST2 plugs prior to fishing the wire into the driver footwell, so pause watching this video around the 34minute mark. The fishing process can easily destroy JST2 solder joints, so it's better to fish the wire first and then strip and solder the connections on when the wire is already into the cabin.
  • SECOND NOTE: There is another way to fish the EPAS cable through the firewall that will take a bit more work, and we don't currently have instructions written. If you'd like to help us document by performing this method and taking pictures, we'd appreciate it.

• Mouser shopping list:
  • Female connector
    
  • Female pins
    
  • Male connector
    
  • Male pins
    
  • Rubber seal plug
    
  • Rubber seal for cable
    

• Use hook-and-loop (velcro) ties to secure the EPAS Cable to the existing harness in the car until you are sure everything works and you won't be needing to remove the EPAS cable to work on it further.

• Fish the unfinished end of the cable under the washer container, then through the first hood metal support piece to the gap and then pull all of the slack through that gap. Reinsert the unfinished end back into the gap while keeping a finger or screw driver under it to keep the cable from falling down flat into the gap, this will help the cable not catch on where the second metal hood support meets the body as you push the cable towards the cabin. Once the cable emerges next to the door seal, pull it through from the cabin side and work it in behind the seal and the diagnostics port.

• Once the cable is in the gap between the driver left side footwell cover and the panel containing the OBD2 port, do your soldering of the JST2 connector.

• Prior to connecting the cabling, it's a good idea to test your EPAS cable for continuity and shorts [this is for your sanity, nothing bad will happen if you skip this]
  • Shorts: with the EPAS cable not plugged into the Car or the giraffe, put spare pins into 2 and 5 and touch your leads to them. If you get continuity make sure that the pins are not in contact, if they are not in contact double check the insulation on your solder connections to your JST2 plug.
  • Continuity: with the spare pins still inserted in 2 and 5, jumper the JST2 plug end. Touch your leads to the 2 and 5 pins, if you get continuity make sure that the pins are not in contact, if they are not, then the cable is good. If you get no continuity, check that your solder connections to the JST2 plug haven't been broken.

• Plug your panda into your giraffe, plug your giraffe into your OBD2 plug... The car may give you some error messages about parking brake, etc... Connect your EON to the panda via the USB cable. Turn on tethering in the EON and connect to the EON hotspot, then ssh to 192.168.43.1 port 8022 using the OpenPilot RSA key and flash your panda. Once flashing is complete, you can disconnect your EON again, remove and reinsert your giraffe, hopefully the car should not complain (if it does let us know, but continue anyway).

• With a good cable, you can remove any testing jumpers and spare pins and connect to to the EPAS servo unit and connect it to the giraffe. Again the car should not complain. If you get an error that "Power Assist is not available", it means that your CAN +/- pins (2 and 5) need to be flipped. You test this by cross wiring a JST2 connector to a JST2 plug and then inserting that between your JST2 connector and EPAS cable... If you do this, you may need to put the car in drive and manually feel if power steering works before the error clears (if steering is normal the error should clear, if not it will feel very heavy). The easiest way to resolve this is to disconnect the JST2 cable from the giraffe and use a small edge to lift the plastic lock tab while depressing the spring clip to release the JST2 connects and then insert black in the red position and vice-versa, the plug the JST2 cable back into the giraffe, put the car in drive and recheck the steering.

Installing OpenPilot for Tesla on the EON

Steps to perform OP install

First OpenPilot Drive

1. Make sure the EON is mounted properly and connected to the Panda by following #Installing the EON
2. Make sure the EON has Internet access (either your wifi at home or a SIM card). Connect to a mobile hotspot if you don't have a SIM card
   1. Reboot your EON before turning your car on for good measure
3. Turn your car on and verify that the Panda LEDs are pulsing red/blue/purple. If they are green, your panda is not flashed, see flashing instructions here Panda Flashing.
4. OpenPilot should switch to "drive mode" and show the camera view with white lane marking
5. Make sure that your EON is connected to the Internet or Calibration will not start
6. Read up and understand the controls from Using adaptive cruise control

IF YOUR CAR IS RECOGNIZED:

1. Calibration will increment at above 15mph. It will take less than 30 seconds to fully calibrate. If you move the mount, it's recommended to reset camera calibration under "device settings".
2. When driving, Double Pull the Cruise Control Stalk to use OpenPilot

IF YOUR CAR IS NOT RECOGNIZED

1. Ask for help on the #tesla channel of the Comma.ai Discord