Pioneer 2 / PeopleBot manual ENCODERpac and Encoder Command, GRIPPERpac and Griprequest

Page 48

Pioneer 2 Operating System

number of bytes you request via the GETAUX command—up to 200 bytes at a time. P2OS waits to collect the requested number of incoming AUX-port serial bytes before sending the GETAUX packet to the client. Use the GETAUX command with a zero argument to flush the P2OS circular buffer and reset its pointers.

In the code example above, a fictitious command gets sent to a serial device attached to the microcontroller's AUX port and retrieves a 10-byte response from that device (note that ellipses mark the many portions of a complete client that have been deleted for brevity).

ENCODERpac and ENCODER Command

Issue the ENCODER command #19 with an argument of 1 for a single or with an argument of 2 or more for a continuous stream of ENCODERpac (type 144; 0x90) SIPs. Discontinue the packets by sending the ENCODER command #19 with the argument 0.

Table 8. P2OS Encoder Server Information Packet Contents

Header

integer

Exactly 0xFA, 0xFB

Byte Count

byte

Number of data bytes + 2 (checksum)

Left Encoder

integer

Least significant, most significant portion of the

 

integer

current 4-byte raw encoder count from the left drive wheel

Right Encoder

integer

Least significant, most significant portion of the

 

integer

current 4-byte raw encoder count from the left drive wheel

Checksum

integer

Checksum for packet integrity

GRIPPERpac and GRIPREQUEST

To ameliorate a few shortcoming when we transferred connection and control of the P2 Gripper accessory from User I/O to the General I/O bus, P2OS 1.E introduced and we improved the new GRIPPERpac (type=224; 0xE0) packet type and related GRIPREQUEST P2OS command #37 in P2OS 1_F.

Table 9. Gripper packet contents (P2OS 1_F and later)

Header

integer

Exactly 0xFA, 0xFB

Byte Count

byte

Number of data bytes + 2 (checksum)

Type

byte

Packet type = 0xE0

HasGripper

byte

Gripper type: 0=none; 1=User; 2=General I/O

Grip_state

byte

See Table 12 and P2 Gripper Manual

Grasp_Time

byte

See P2 Gripper Manual

Checksum

integer

Computed checksum

Normally disabled, your client program must request one (command argument 1) or a continuous stream (command argument > 1) of Gripper packets. Send GRIPREQUEST with the argument value 0 to stop continuous packets.

PLAYLISTpac and PLAYLIST Command

Unlike its Pioneer and PeopleBot cousins, the AmigoBot mobile robot has onboard sound reproduction hardware and software that includes a playlist of contents. To support the ActivMedia Robotics Basic Suite that includes all ActivMedia’s robots, we’ve added the PLAYLISTpac (type = 208; 0xD0) and PLAYLIST request command #91 to P2OS 1.E. We document the command and packet here for completeness, but they have no effect on the operation or performance of your Pioneer 2 or PeopleBot Mobile Robot.

42

Image 48
Contents Pioneer 2 / PeopleBot TM Page Important Safety Instructions Table of Contents Pioneer 2 Operating System Appendix C Introduction Robot PackageBasic Components all shipments Optional Components and Attachments partial listAdditional Resources User-Supplied Components / System RequirementsSoftware NewsgroupsSupport Support@activmedia.comWhat Is Pioneer? Client SoftwareHttp//robots.activmedia.com ActivMedia Robotics Basic SuiteAria SaphiraPioneer Legacy PioneerPioneer 2 and PeopleBot Page Modes of Operation Specifications & Controls Physical CharacteristicsMain Components Decks and Console Pioneer 2-AT Console and hinged DeckBody, Nose, and Accessory Panels Sonar Arrays with Gain Adjustment Batteries and Power ElectronicsMotors and Position Encoders Controls, Ports, and Indicators Liquid-Crystal Display & Contrast Adjustment Reset and MotorsSerial Safety Watchdogs and Configuration Pioneer 2 Arm-related SIPs and CommandsPeopleBot Sensors and Emergency Stop Preparative Assembly Saphira Client InstallationQuick Start Http//robots.activmedia.comSaphira Client Start-Up Robot Cold Start-UpSET SAPHIRA=C\Saphira\ver62 Export DISPLAY=remotecomputer0Starting Client-Server Communications Successful ConnectionOperating the Saphira Demonstration Client ConnectedQuickstart Troubleshooting Quick Start Joydrive and Self-Tests Joystick ConnectionJoydrive Operation Engaging Self-Tests Motors TestPress again to begin tests Left forward 13.2Sonar Test BumpersGripper CompassDigin and Digout Test Analog TestsUser PWMs Digin DigoutPioneer 2 Operating System Communication Packet ProtocolPacket Errors Packet Data TypesPacket Checksum Name Data Type Description Client Commands Server Information PacketsBefore Client Connection Client Command Argument Types PtuposSaphira Client Command Support AutoconfigurationProgramming P2OS Establishing a Client-Server Connection-SYNCMovement Commands Keeping the Beat-PULSEClosing the Connection-CLOSE Pioneer in Motion PID ControlsSonar Position IntegrationEstop and Estall SfRobotComInt44,1CONFIGpac and Config Command Extended PacketsPacket Processing SERAUXpac and Getaux ENCODERpac and Encoder Command PLAYLISTpac and Playlist CommandGRIPPERpac and Griprequest Checksum Integer Computed checksumTCM2pac and TCM2 Command DIGIN, TIMER, and AdselInput / Output I/O SfSMessageDigin is %i,sfRobot.diginDigout and Psupos IOpac and IorequestPerformance PeopleBot IRs Updating & Reconfiguring P2OS Where to Get P2OS SoftwareInstalling the P2OS Utilities Updating P2OSEnable Flash Put Microcontroller into Download ModeDownload Troubleshooting Run p2osdlConfiguring P2OS Operating Parameters Steps 1-3 Preparing for ConfigurationChanging Configuration Parameters Run p2oscfEditing P2OS Parameters Saving and Restoring Arm ParametersSave C\p2os\myP2DX Keyword PID Parameters Encoder and RevcountCalibration Tools revcountcal and compasscal Parameter DXe Performance PBCompasscal /dev/ttyS3 Maintenance & Repair Drive LubricationBatteries Alternative Battery Chargers Getting InsideRemoving the Nose Opening the Deck Remove indicated screws to remove Original Pioneer 2-AT DeckFactory Repairs Support@activmedia.com 603 924-2184 fax 603 924-9100 voiceAppendix a C166 Controller Ports & ConnectionsInternal Serial Connectors User I/O Expansion PortPerformance PeopleBot I/O Pin Label UseGeneral I/O Bus User Power Connections Power Switch J7 and Delayed Shutdown LogicAppendix B Onboard Computer OptionPower-State Logic Computer PowerJoystick Connector Appendix CSpecifications Appendix DControls and Ports Index ControlsSpecifications Warranty & Liabilities Page Concord Street Peterborough, NH 603

2 / PeopleBot specifications

Pioneer 2, also known as PeopleBot, is an advanced mobile robot platform heralded for its versatile design and robust capabilities. Developed by the renowned robotics company Adept Technology, Pioneer 2 has become a staple in the field of mobile robotics, widely utilized for research, education, and practical applications in various industries.

One of the standout features of Pioneer 2 is its exceptional mobility. The robot is equipped with differential steering, allowing it to navigate complex environments with precision. Its compact and sturdy chassis enables it to traverse a variety of terrains, making it suitable for indoor and outdoor exploration. This mobility is further enhanced by an adaptable wheel configuration, allowing for smooth movement even over obstacles.

In terms of technologies, Pioneer 2 is outfitted with an array of sensors that facilitate autonomous navigation and obstacle avoidance. These sensors include laser range finders, infrared sensors, and bumpers, which work in tandem to map the surrounding environment and detect potential hazards. This capability is critical for applications in areas such as warehouse automation or reconnaissance tasks, where safe navigation is paramount.

Pioneer 2 also supports extensive software frameworks, notably the Robot Operating System (ROS). This compatibility allows researchers and developers to leverage a vast library of tools and algorithms, expediting the process of programming and deploying robotic applications. Additionally, the platform can be integrated with various payloads, such as cameras or grippers, expanding its functionality further.

Another significant characteristic of Pioneer 2 is its user-friendly design. The robot comes with an easy-to-use programming interface that empowers users with varying levels of expertise to engage with the technology. Educational institutions often employ Pioneer 2 in robotics courses to provide students with hands-on experience in programming and operating robotic systems.

Powering Pioneer 2 is a rechargeable battery system that ensures extended operation times. This feature is particularly advantageous for fieldwork applications where connectivity to a power source may not be readily available. Importantly, the robot’s modular design facilitates maintenance and upgrades, allowing users to keep their systems current with advances in technology.

Overall, Pioneer 2 (PeopleBot) exemplifies innovation in mobile robotics with its outstanding mobility, advanced sensing technologies, compatibility with leading software frameworks, and a design focused on ease of use and adaptability. It continues to be a preferred choice for researchers, educators, and professionals in the rapidly evolving landscape of robotics.