Eclipse SUMO - Simulation of Urban MObility
TraCIServerAPI_RouteProbe.cpp
Go to the documentation of this file.
1 /****************************************************************************/
2 // Eclipse SUMO, Simulation of Urban MObility; see https://eclipse.dev/sumo
3 // Copyright (C) 2001-2024 German Aerospace Center (DLR) and others.
4 // This program and the accompanying materials are made available under the
5 // terms of the Eclipse Public License 2.0 which is available at
6 // https://www.eclipse.org/legal/epl-2.0/
7 // This Source Code may also be made available under the following Secondary
8 // Licenses when the conditions for such availability set forth in the Eclipse
9 // Public License 2.0 are satisfied: GNU General Public License, version 2
10 // or later which is available at
11 // https://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html
12 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
13 /****************************************************************************/
18 // APIs for getting/setting RouteProbe values via TraCI
19 /****************************************************************************/
20 #include <config.h>
21 
22 #include <microsim/MSNet.h>
23 #include <microsim/MSEdge.h>
25 #include <libsumo/RouteProbe.h>
26 #include <libsumo/TraCIConstants.h>
28 
29 
30 // ===========================================================================
31 // method definitions
32 // ===========================================================================
33 bool
35  tcpip::Storage& outputStorage) {
36  const int variable = inputStorage.readUnsignedByte();
37  const std::string id = inputStorage.readString();
39  try {
40  if (!libsumo::RouteProbe::handleVariable(id, variable, &server, &inputStorage)) {
41  return server.writeErrorStatusCmd(libsumo::CMD_GET_ROUTEPROBE_VARIABLE, "Get RouteProbe Variable: unsupported variable " + toHex(variable, 2) + " specified", outputStorage);
42  }
43  } catch (libsumo::TraCIException& e) {
44  return server.writeErrorStatusCmd(libsumo::CMD_GET_ROUTEPROBE_VARIABLE, e.what(), outputStorage);
45  }
47  server.writeResponseWithLength(outputStorage, server.getWrapperStorage());
48  return true;
49 }
50 
51 
52 bool
54  tcpip::Storage& outputStorage) {
55  std::string warning = ""; // additional description for response
56  // variable
57  int variable = inputStorage.readUnsignedByte();
58  if (variable != libsumo::VAR_PARAMETER) {
59  return server.writeErrorStatusCmd(libsumo::CMD_SET_ROUTEPROBE_VARIABLE, "Change RouteProbe State: unsupported variable " + toHex(variable, 2) + " specified", outputStorage);
60  }
61  // id
62  std::string id = inputStorage.readString();
63 
64  try {
65  // process
66  switch (variable) {
68  if (inputStorage.readUnsignedByte() != libsumo::TYPE_COMPOUND) {
69  return server.writeErrorStatusCmd(libsumo::CMD_SET_ROUTEPROBE_VARIABLE, "A compound object is needed for setting a parameter.", outputStorage);
70  }
71  //read itemNo
72  inputStorage.readInt();
73  std::string name;
74  if (!server.readTypeCheckingString(inputStorage, name)) {
75  return server.writeErrorStatusCmd(libsumo::CMD_SET_ROUTEPROBE_VARIABLE, "The name of the parameter must be given as a string.", outputStorage);
76  }
77  std::string value;
78  if (!server.readTypeCheckingString(inputStorage, value)) {
79  return server.writeErrorStatusCmd(libsumo::CMD_SET_ROUTEPROBE_VARIABLE, "The value of the parameter must be given as a string.", outputStorage);
80  }
81  libsumo::RouteProbe::setParameter(id, name, value);
82  }
83  break;
84  default:
85  break;
86  }
87  } catch (libsumo::TraCIException& e) {
88  return server.writeErrorStatusCmd(libsumo::CMD_SET_ROUTEPROBE_VARIABLE, e.what(), outputStorage);
89  }
91  return true;
92 }
93 
94 
95 /****************************************************************************/
std::string toHex(const T i, std::streamsize numDigits=0)
Definition: ToString.h:56
static bool processSet(TraCIServer &server, tcpip::Storage &inputStorage, tcpip::Storage &outputStorage)
Processes a set value command (Command 0xc6: Change RouteProbe State)
static bool processGet(TraCIServer &server, tcpip::Storage &inputStorage, tcpip::Storage &outputStorage)
Processes a get value command (Command 0xa6: Get RouteProbe Variable)
TraCI server used to control sumo by a remote TraCI client.
Definition: TraCIServer.h:59
void writeStatusCmd(int commandId, int status, const std::string &description, tcpip::Storage &outputStorage)
Writes a status command to the given storage.
bool readTypeCheckingString(tcpip::Storage &inputStorage, std::string &into)
Reads the value type and a string, verifying the type.
tcpip::Storage & getWrapperStorage()
void initWrapper(const int domainID, const int variable, const std::string &objID)
bool writeErrorStatusCmd(int commandId, const std::string &description, tcpip::Storage &outputStorage)
Writes a status command to the given storage with status = RTYPE_ERR.
void writeResponseWithLength(tcpip::Storage &outputStorage, tcpip::Storage &tempMsg)
An error which allows to continue.
Definition: TraCIDefs.h:144
virtual std::string readString()
Definition: storage.cpp:180
virtual int readUnsignedByte()
Definition: storage.cpp:155
virtual int readInt()
Definition: storage.cpp:311
TRACI_CONST int TYPE_COMPOUND
TRACI_CONST int CMD_GET_ROUTEPROBE_VARIABLE
TRACI_CONST int VAR_PARAMETER
TRACI_CONST int RESPONSE_GET_ROUTEPROBE_VARIABLE
TRACI_CONST int RTYPE_OK
TRACI_CONST int CMD_SET_ROUTEPROBE_VARIABLE