CANJaguar

Hello,
I am not new to Java, but I am new to the code for the wpi, so I was looking at the API and was especially looking at CANJaguar. My question is that in order to use CAN, do I make an instance of CANJaguar for each jaguar used, or is it only one instance, and I make an instance of Jaguar for the amount used? Also would I need to use it within the drive train? In the end, I am pretty much asking how to set up CAN withing Java.

The CANJaguar class represents a jaguar. So yes, you need one for each physical jaguar. To set up the drive train, you create all of the jaguars needed and then call the robotDrive constructor with each of the jaguars.

For programming, the only practical difference between CANJaguar and Jaguar is that CANJaguar has more methods (for things like setting PID constants), so if you find a tutorial on how to set things up with normal Jaguars, you just replace the class names with CANJaguar and you should be set.

Awesome, that makes it much simpler, also on the ID, its the id you issue the Jaguar when you update the firmware correct? or is in in order they are setup along the CAN

It’s the one where you set the number and then press the button on the jaguar (the ID). The order makes absolutely no difference (except for the whole “wire can’t be too long” thing)

Ha, how can the wire be too long? on such a short distance with data flying at 1mbs and the Jaguars acting as switches. Also I would like your input on this, for Joystick input, would it be best on Periodic or Continuous?

It possibly has to do with loading down the CAN cable driver. I think the total cable length is something like 20’ if I remember right. One suggestion was to buy a 20’ cable and use it. If you need more, you’ve used too much.

Read joystick should probably go in Periodic. Continuous will read the joystick as fast as possible. Periodic will read the joystick at precise intervals (200Hz I think). Honestly, in reference to the system response time of “Joystick moved -> Joystick value read -> Joystick value interpreted -> Motor value sent -> Motor starts moving”, the moving of the motor is the longest part (by quite a bit).

Running in continuous only makes more requests and sends more control packets (unnecessarily) utilizing more system bandwidth.

  • Bryce

I agree, and I was looking at the code, and its at 50hz, just in case you where curious, and about the CAN, I guess it can be looked at it just like in Networking, but what I think they may mean about being too long is the distance of wire used between one Jaguar to the next and maybe not meant in total distance, which sounds the same but its not, lol.

Bryscus is correct:

It is in fact 20’ total, not the maximum between each Jaguar. The Jaguars aren’t switches or repeaters, the left and right CAN ports are wired directly to each other on the Jaguar circuit board.

This 20’ limitation does have to do with the CAN driver:

When all the Jaguars are responding at the same time to broadcast messages they drive the bus slightly higher than a single Jag would. It takes longer for the bus to return to ‘zero’ and therefor some Jaguars may not read the bit correctly if the bit hasn’t had time to settle.

The time from high to low depends on the termination resistance as well. This is the reason why we also specify a 100 ohm termination resistor. It helps snap the bus back to zero quickly so there aren’t any bit timing errors.

We found that 20’ of cable, 100 ohm termination resistors, and ~16 Jags on a bus is a good limit for reliable operation. It may be possible to get more Jags, but the cable lengths will have to be shorter.

-David

Awesome, great information! thanks for the clarification.

How do we know if we have regular jaguars or CAN jaguars? Also, if we use jaguars does this mean we actually need to declare 4 jaguar instances to drive the robot? Can we do something like


public void robotInit() {
RobotDrive robot = new RobotDrive(1,2,3,4);
Joystick left = new Joystick(1);
Joystick right = new Joystick(2);

}
public void teleopPeriodic() {
robot.tankDrive(left.getThrottle(),(-1*right.getThrottle())); 

}

or do we need to actually need to create jaguar instances and use them to drive the robot. If so, how would we do this?

All jaguars both gray and black can use CAN, it is a diffrent way of sending information to them, instead of using the PWM cables you use a phone like cable. Both get the job done, just more accuracy and additional information about the controller while its running comes with the CAN.

And what I did with the jaguar is create an instance for each jaguar outside of any of the Init’s. Then on the RobotInit(), I initialized them along with the drive train.


public class Team3325 extends IterativeRobot {

    CANJaguar leftCANJaguarTop;
    CANJaguar leftCANJaguarBottom;
    CANJaguar rightCANJaguarTop;
    CANJaguar rightCANJaguarBottom;
    Joystick inputJoystick;
    int leftCanTop = 1;
    int leftCanBot = 2;
    int rightCanTop = 3;
    int rightCanBot = 4;
    RobotDrive mechanumDrive;

    public void robotInit() {

        try {

            leftCANJaguarTop = new CANJaguar(leftCanTop);
            leftCANJaguarBottom = new CANJaguar(leftCanBot);
            rightCANJaguarBottom = new CANJaguar(rightCanBot);
            rightCANJaguarTop = new CANJaguar(rightCanTop);

            inputJoystick = new Joystick(1);

            mechanumDrive = new RobotDrive(leftCANJaguarTop, leftCANJaguarBottom, rightCANJaguarTop, rightCANJaguarBottom);

        } catch (Exception e) {

            System.out.println(e);
        }
    }

    public void teleopPeriodic() {

        try {

            mechanumDrive.mecanumDrive_Cartesian(inputJoystick.getX(), inputJoystick.getY(), inputJoystick.getThrottle(), 0.0); //TODO <-- Fix Gyro to proper Param.


        } catch (Exception e) {

            System.out.println(e);
        }
    }
}


The code is a little dirty, but it works for testing purposes and can hopefully help you. In your case, if you didn’t use CAN, you would have to replace CANJaguar with Jaguar and fix a few of the params respectively.

Besides variables going out of scope, the code you have posed there would do ok. To answer your question about creating Jaguar instances, you can create a RobotDrive both ways


RobotDrive(int frontLeftMotor, int rearLeftMotor, int frontRightMotor, int rearRightMotor);

/* OR */

RobotDrive(SpeedController frontLeftMotor, SpeedController rearLeftMotor, SpeedController frontRightMotor, SpeedController rearRightMotor);

And whether you have CANJaguars or regular Jaguars all depends on how you have them hooked up. chances are, you have normal Jaguars. If you are using a PWM cable to hook the Jaguars to the digital module/sidecar, then you have regular Jaguars for sure.

EDIT: Also, its more common to use the y axis of each joystick to control motor speeds than it is the throttle, but obviously you can do whatever you wish.

I agree, just threw this code together to please the Electrical crew, I planed to correctly do it being that I have more time :stuck_out_tongue:

Thank you for your replies. No matter what we try we cannot seem to get our robot to move. This is the code I have been trying:


package edu.wpi.first.wpilibj.templates;


import edu.wpi.first.wpilibj.IterativeRobot;
import edu.wpi.first.wpilibj.Joystick;
import edu.wpi.first.wpilibj.RobotDrive;
import edu.wpi.first.wpilibj.Solenoid;
import edu.wpi.first.wpilibj.Timer;
import edu.wpi.first.wpilibj.Watchdog;
import edu.wpi.first.wpilibj.SpeedController;
import edu.wpi.first.wpilibj.Jaguar;

public class RobotTemplate extends IterativeRobot {
    RobotDrive robot;
    Joystick left;
    Joystick right; 
    
    public void robotInit() {
 
  
        robot = new RobotDrive(1,2,3,4);
        left = new Joystick(1);
        right = new Joystick(2);
        System.out.println("RobotInit() completed.");
    }

    public void autonomousPeriodic() {

    }

    public void teleopPeriodic() {
        //robot.tankDrive(left.getThrottle(),(-1*right.getThrottle()));
        //robot.tankDrive(left, right);

        robot.tankDrive(2,2);
        
        //System.out.println("left:"+left.getThrottle());
        //System.out.println("right:"+right.getThrottle());
        //System.out.println("LMAG:"+ left.getMagnitude());
        //System.out.println("RMAG:"+ right.getMagnitude());

    }
    
}

the getThrottle() method always returns a 0 regardless of what we do to the joystick. The getMagnitude() method show change as we move the joystick. However, what worries me is that the robot doesn’t seem to move even if i input doubles into the tankDrive() method. The jaguars lights should stop blinking and become solid when they are receiving a signal right? They never seem to do this and stay blinking no matter what.

The jaguars lights should stop blinking and become solid when they are receiving a signal right?

Yes that is correct. What if you where to make an instance of the Jaguars with their Channel and the location of the module, and place that inside of the drive train, is it the same result?

Yes I tried that as well. I declared 4 of them. Something along the lines of

SpeedController frontLeft = new Jaguar(1,1);
SpeedController rearLeft = new Jaguar(1,2);
SpeedController frontRight = new Jaguar(1,3);
SpeedController rearRight = new Jaguar(1,4);

To be honest, I am not entirely sure what the slot number on the chassis is supposed to signify, so i just used 1 because that seems to be what everyone used in the examples i have seen. For the channel number, I used the PWM slot number i connected each jaguar to on the digital side car.

Then I used the set method, passing in the throttle value from a joystick, to set the speeds. Then I passed the speed controllers into the tankDrive() method.

One more thing that i have noticed is that the the green diagnostic light in the driver station diagnostic console doesnt change color to blue when i move the sticks. It does, however, change color when i press buttons on the stick. Does this have any significance?

If the code isn’t working, try removing the slot number. Instantiate your Jaguars with only the PWM number. Also, I’ve never used “SpeedController x = new Jaguar(etc)”. I believe I always use “Jaguar x = new Jaguar(blah)”… If that makes any difference.
And the dashboard is just like that. No real significance. It changes color only for button-presses.

I do what nick does, works just fine for me, and for Java I think the Digital Side car module is on the second slot and for Labview the 4th one, maybe you have one of the modules wrong?

We had some problems with things getting initiated at the beginning of the year because some standards have changed with regards to the numbering of the modules. Your digital module should be in slot 2, and then you should just remove the slot number from the lines that instantiate the motors. Also, how to OTHER things connected to the sidecar work? I saw a person earlier today that had a faulty ribbon cable.

David,

I have to disagree with you on this. According to CAN spec IS0 11898:1993(E) Table 15, the maximum cable distance for 1Mbit/second is 40 Meters not 20 feet.

We have also tested at distances much greater than 20 feet without issue using 120 Ohm’s of termination on each end of the BUS.

FYI a termination resistor of 100 ohms is outside of the spec. Teams using 120 ohms resistors should have no issues related to signal reflection.